Bizagi BPM Suite

Gua del Usuario

Table of Contents
0

Part I Bienvenido a Bizagi BPM Suite

1 2 Informacin general

13

................................................................................................................................... 13

Conceptos de Bizagi BPM Suite ................................................................................................................................... 14

Ciclo de vida de .......................................................................................................................................................... los procesos 14 Asistente de Procesos .......................................................................................................................................................... 18

3 Soporte multi idioma 4 Entrenamiento y soporte

................................................................................................................................... 19 ................................................................................................................................... 23

5 Ediciones de Bizagi BPM Suite ................................................................................................................................... 24

Diferencias entre .......................................................................................................................................................... las ediciones de Bizagi BPM Suite 26

Productos relacionados

................................................................................................................................... 27

Part II Comenzando a utilizar Bizagi BPM Suite

1

31

Requerimientos del sistema................................................................................................................................... 31

Enterprise. NET .......................................................................................................................................................... - requerimientos 31 .NET requerimientos ......................................................................................................................................................... para Produccin 31 .NET requerimientos ......................................................................................................................................................... para Pruebas 40 .NET requerimientos ......................................................................................................................................................... para Desarrollo 44 Enterprise JEE .......................................................................................................................................................... - requerimientos 48 JEE requerimientos ......................................................................................................................................................... para Produccin 49 JEE requerimientos ......................................................................................................................................................... para Pruebas 59 JEE requerimientos ......................................................................................................................................................... para Desarrollo 63 Bizagi Xpress .......................................................................................................................................................... - requerimientos 68 Xpress requerimientos ......................................................................................................................................................... para Produccin 68 Xpress requerimientos ......................................................................................................................................................... para Pruebas 71 Xpress requerimientos ......................................................................................................................................................... para Desarrollo 74

Instalacin

................................................................................................................................... 78

Enterprise .NET .......................................................................................................................................................... - instalacin 78 Enterprise JEE .......................................................................................................................................................... - instalacin 94 Bizagi Xpress .......................................................................................................................................................... - instalacin 108

3 Configurar el trabajo en equipo ................................................................................................................................... 123 4 Arquitectura 5 Interfaz de usuario ................................................................................................................................... 127 ................................................................................................................................... 135

Bizagi Studio .......................................................................................................................................................... 136 Crear un......................................................................................................................................................... nuevo proyecto 145 Abrir un ......................................................................................................................................................... proyecto existente 148 Manejo de ......................................................................................................................................................... proyectos existentes 150 Vista del ......................................................................................................................................................... asistente 152 Vista de mdulos ......................................................................................................................................................... 153 Procesos en Vista ......................................................................................................................................... de Mdulos 155 Entidades en Vista ......................................................................................................................................... de Modulos 158 Portal de Trabajo .......................................................................................................................................................... 162 Definiendo la .......................................................................................................................................................... estructura de los proyectos de su compaa 163

6 2

Process Central

................................................................................................................................... 167 Copyright 2013 - Bizagi

Instalacin de .......................................................................................................................................................... servicios web para el Process Central 173

7 Licenciamiento

................................................................................................................................... 180

Licenciamiento .......................................................................................................................................................... de Bizagi explicado 181 Comprar licencias .......................................................................................................................................................... 185 Activar licencias .......................................................................................................................................................... 190 Activar licencias ......................................................................................................................................................... para la Enterprise JEE 194 Activar una ......................................................................................................................................................... llave de licencia sin acceso a Internet 200 Administrar licencias .......................................................................................................................................................... 202

Part III Automatizacin del Proceso

1 2 Mi primer proceso Modelando un Proceso

210

................................................................................................................................... 210 ................................................................................................................................... 210

Crear un proceso .......................................................................................................................................................... 213 Editar un proceso .......................................................................................................................................................... 218 Importar un .......................................................................................................................................................... proceso 224 Modelado para .......................................................................................................................................................... ejecucin 227 Propiedades ......................................................................................................................................................... de las figuras 235 Propiedades ......................................................................................................................................................... de los Procesos 236 Propiedades ......................................................................................................................................................... de las Tareas 237 Propiedades ......................................................................................................................................................... de las Compuertas 241 Propiedades ......................................................................................................................................................... del Evento de Inicio 243 Propiedades ......................................................................................................................................................... del Evento Intermedio 245 Propiedades ......................................................................................................................................................... del Evento de Fin 249 Propiedades ......................................................................................................................................................... de los Carrilles 252 Propiedades ......................................................................................................................................................... de los Conectores 255 Subprocesos ......................................................................................................................................................... 256 Subprocesos Embebidos ......................................................................................................................................... 260 Subprocesos Reusables ......................................................................................................................................... 266 Manejando entidades ................................................................................................................................... de sub-procesos 271 Entendiendo los ......................................................................................................................................... Subprocesos mltiples 274 Conceptos del ................................................................................................................................... mltiple Subproceso 277 Configuracin ................................................................................................................................... bsica para los Subprocesos mltiples 282 Acceso de la informacin del Proceso Padre desde el contexto del Subproceso ................................................................................................................................... 288 Configuracin ................................................................................................................................... avanzada para los Subprocesos mltiples 290 Configuracin ................................................................................................................................... avanzada utilizando agrupar por 291 Configuracin ................................................................................................................................... avanzada utilizando creacin secuencial 302 Entendiendo Procesos ......................................................................................................................................... transaccionales 307 Configuracin ................................................................................................................................... del Subproceso transaccional 313 Entendiendo el ......................................................................................................................................... proceso Ad Hoc 321 Configurar un ................................................................................................................................... sub proceso Ad Hoc 323 BPMN Colaborativo .......................................................................................................................................................... 324 Ejemplo ......................................................................................................................................................... de seal 331 Duracin de.......................................................................................................................................................... Tareas y procesos 333 Duracin ......................................................................................................................................................... dinmica 340

3 Modelo de Datos

................................................................................................................................... 340

Crear el modelo .......................................................................................................................................................... de datos 341 Opciones ......................................................................................................................................................... del Modelo de Datos 347 Tipos de entidades .......................................................................................................................................................... 348 Tipos de atributos .......................................................................................................................................................... 350 Informacin ......................................................................................................................................................... del atributo tipo archivo 353 Tipos de relaciones .......................................................................................................................................................... 357 Conexiones .......................................................................................................................................................... con fuentes de datos externas 362

Copyright 2013 - Bizagi

Replicacin ......................................................................................................................................................... 363 Utilizar el asistente ......................................................................................................................................... de Replicacin 367 Utilizar la configuracin ......................................................................................................................................... avanzada de Replicacin 378 Personalizando ................................................................................................................................... la Replicacin 395 Opciones adicionales ......................................................................................................................................... en la configuracin de Replicacin 433 Virtualizacin ......................................................................................................................................................... 442 Mejores prcticas ......................................................................................................................................... para Virtualizacin 446 Utilizar el asistente ......................................................................................................................................... de Virtualizacin 452 Utilizar la configuracin ......................................................................................................................................... avanzada de Virtualizacin 463 Personalizar la ................................................................................................................................... Virtualizacin 478 Verificar Virtualizacin ......................................................................................................................................... 519 Opciones adicionales ......................................................................................................................................... para la configuracin de Virtualizacin 522 Tipos de......................................................................................................................................................... datos soportados 533 Administracin .......................................................................................................................................................... de las entidades 536 Incluir datos ......................................................................................................................................................... en entidades paramtricas 537 Entidades ......................................................................................................................................................... padre e hijo 541 Donde administrar ......................................................................................................................................................... las entidades paramtricas 546 Atributos Temporales .......................................................................................................................................................... 551 Scopes .......................................................................................................................................................... 557 Llaves de negocio .......................................................................................................................................................... 558 Entidad de proceso .......................................................................................................................................................... 559 Contexto ......................................................................................................................................................... 561

4 Creacin de interfaces de usuario ................................................................................................................................... 563

Creando mi primera .......................................................................................................................................................... forma 564 Componentes .......................................................................................................................................................... de la forma 573 Ribbon ......................................................................................................................................................... 574 Panel Izquierdo ......................................................................................................................................................... 575 Contenedores: ......................................................................................................................................... Grupos y Pestaas 576 Layouts ......................................................................................................................................... 582 rea de Trabajo ......................................................................................................................................................... 585 Propiedades ......................................................................................................................................................... de las Formas 587 Controles .......................................................................................................................................................... 588 Botn ......................................................................................................................................................... 592 Lista desplegable ......................................................................................................................................................... en Cascada 595 Combo ......................................................................................................................................................... 601 Fecha ......................................................................................................................................................... 606 Archivos......................................................................................................................................................... 612 Archivos......................................................................................................................................................... ECM 619 Vnculo a ......................................................................................................................................................... Forma 621 Oculto ......................................................................................................................................................... 625 Imagen ......................................................................................................................................................... 625 Etiqueta......................................................................................................................................................... 628 Vnculo ......................................................................................................................................................... 630 Lista ......................................................................................................................................................... 634 Moneda......................................................................................................................................................... 640 Nmero......................................................................................................................................................... 644 Radio ......................................................................................................................................................... 646 Campo de ......................................................................................................................................................... Bsqueda 653 Forma de Bsqueda ......................................................................................................................................... 660 Forma de Adicin ......................................................................................................................................... de Registros 663 Sugerencia ......................................................................................................................................................... 666 Tabla ......................................................................................................................................................... 673 Editar Columnas ......................................................................................................................................... 677 Totalizadores......................................................................................................................................... 680

Copyright 2013 - Bizagi

Agregar Registros ......................................................................................................................................... 684 Ediar Registros ......................................................................................................................................... 688 Detalle de Registros ......................................................................................................................................... 693 Cuadro ......................................................................................................................................................... de Texto 696 Si/No ......................................................................................................................................................... 701 Propiedades ......................................................................................................................................................... de los Controles 704 Valor por Defecto ......................................................................................................................................... 708 Propiedad de ......................................................................................................................................... Filtro 709 Filtrar Tablas ......................................................................................................................................... 715 Valores Mximo ......................................................................................................................................... y Mnimo 719 Habilitar enviar ......................................................................................................................................... como adjunto 729 Validaciones de ......................................................................................................................................... Tabla 729 Botn de Validaciones ................................................................................................................................... de Tabla 730 Expresiones de ................................................................................................................................... Validacin en Adicin y Edicin 738 Cambiar el Tipo .......................................................................................................................................................... de Control 742 Personalizar .......................................................................................................................................................... comportamientos del Control 744 Ejecutar......................................................................................................................................................... Acciones y Validaciones 745 Ejemplos de Acciones ......................................................................................................................................... y Validaciones 749 Controles personalizados .......................................................................................................................................................... (Widgets) 770 Contexto en .......................................................................................................................................................... Formas 781 Donde crear .......................................................................................................................................................... formas 785 Formas de ......................................................................................................................................................... Entidad 791 Formas Administrables ......................................................................................................................................................... para Entidades Paramtricas 799 Formas de ......................................................................................................................................................... consulta 807 Consultas de Aplicacin ......................................................................................................................................... 813 Campos Internos ................................................................................................................................... 821 Consultas de Entidad ......................................................................................................................................... 828 Formas globales ......................................................................................................................................................... y de resumen 833 Guardar una.......................................................................................................................................................... Forma 839 Usar la opcin .......................................................................................................................................................... Copiar Desde 846

5 Definicin de Reglas de Negocio ................................................................................................................................... 849

Acceso al modelo .......................................................................................................................................................... de datos a travs de XPath 850 Filtros usando ......................................................................................................................................................... XPath 852 Filtros avanzados ......................................................................................................................................................... 854 Funciones ......................................................................................................................................................... XPath 856 Ejemplos de funciones ......................................................................................................................................... bsicas de XPath 858 Ejemplos de funciones ......................................................................................................................................... avanzadas de XPath 864 Acceder a entidades .......................................................................................................................................................... no relacionas con el modelo de datos 866 Donde utilizar .......................................................................................................................................................... reglas de negocio 874 Asignaciones, ......................................................................................................................................................... clculos y validaciones 875 Ruta del......................................................................................................................................................... proceso 889 Script booleano ......................................................................................................................................... 901 Manejo ......................................................................................................................................................... de la interfaz de usuario 909 Visible, editable, ......................................................................................................................................... requerido usando expresions 910 Visibilidad y editabliidad ................................................................................................................................... de celdas 931 Valores por defecto ......................................................................................................................................... usando expresiones 938 Valor mnimo ......................................................................................................................................... usando expresiones 942 Valor mximo......................................................................................................................................... usando expresiones 946 Filtros con expresiones ......................................................................................................................................... 951 Reutilizar ......................................................................................................................................................... reglas de negocio 963 Elementos de .......................................................................................................................................................... las reglas de negocio 977 Elemento ......................................................................................................................................................... de expresiones 979 Elemento ......................................................................................................................................................... Iterate over XPath 984 Elemento ......................................................................................................................................................... de Asignacin 989

Copyright 2013 - Bizagi

Elementos ......................................................................................................................................................... Boolean, While y If 999 Elemento ......................................................................................................................................................... Funcin 1005 Elemento ......................................................................................................................................................... Web service 1010 Elemento ......................................................................................................................................................... For 1022 Elemento ......................................................................................................................................................... Iterate over Fact 1027 Ejemplos de .......................................................................................................................................................... reglas de negocio 1034 Mostrar......................................................................................................................................................... validaciones al usuario final 1035 Validacin ......................................................................................................................................................... de Datos 1037 Definir ......................................................................................................................................................... la duracin de tareas y temporizadores 1040 Adicionar ......................................................................................................................................................... y remover elementos de una relacin 1055 Realizar ......................................................................................................................................................... operaciones con fechas 1063 Realizar ......................................................................................................................................................... operaciones con cadenas de texto 1087 Obtener ......................................................................................................................................................... y utilizar informacin del usuario actual 1096 Obtener ......................................................................................................................................................... y utilizar informacin de los asignados actuales 1099 Obtener ......................................................................................................................................................... y utilizar informacin del caso actual 1109 Obtener ......................................................................................................................................................... y usar valores de la tarea actual 1124 Obtener ......................................................................................................................................................... y utilizar valores de un vocabulario 1128 Obtener ......................................................................................................................................................... y utilizar valores de una entidad 1133 Obtener ......................................................................................................................................................... usuarios basados en componentes de la organizacin 1143 Definir y ......................................................................................................................................................... utilizar secuencias 1158 Ejecutar ......................................................................................................................................................... eventos 1162 Obtener ......................................................................................................................................................... los usuarios que han trabajado en un caso 1166 Usar .id......................................................................................................................................................... con XPath 1169 Adicionar ......................................................................................................................................................... registros a tablas dentro de tablas 1172 Guardar ......................................................................................................................................................... el valor total de una columna 1175 Acceder ......................................................................................................................................................... al isimo registro de una coleccin 1180 Usar Me.Context ......................................................................................................................................................... 1184 Manejo de archivos .......................................................................................................................................................... con expresiones 1190 Cargar un ......................................................................................................................................................... archivo utilizando una expresin 1191 Copiar el ......................................................................................................................................................... contenido de un archivo de un atributo a otro 1192 Contar ......................................................................................................................................................... el nmero de archivos cargados 1194 Obtener ......................................................................................................................................................... el nombre del archivo cargado 1196 Validar ......................................................................................................................................................... el nombre de los archivos 1198 Obtener ......................................................................................................................................................... la ruta del archivo cargado en Bizagi 1201 Cargar un ......................................................................................................................................................... archivo utilizando capa SOA 1202 Validar mi regla .......................................................................................................................................................... de negocio 1205 Polticas .......................................................................................................................................................... 1211 Creando ......................................................................................................................................................... una poltica 1212 Vocabulario ......................................................................................................................................................... 1221 Definicin de......................................................................................................................................... constantes 1224 Definicin de......................................................................................................................................... XPath 1231 Propiedades................................................................................................................................... avanzadas de XPath 1239 Reglas de ......................................................................................................................................................... polticas 1243 Tablas de ......................................................................................................................................................... decisin 1257 Precondiciones ......................................................................................................................................................... o rboles de decisin 1266 Grupo de ......................................................................................................................................................... reglas 1282 Reusabilidad ......................................................................................................................................................... 1285

Definicin de notificaciones ................................................................................................................................... 1291

Correos electrnicos .......................................................................................................................................................... automticos 1292 Notificaciones .......................................................................................................................................................... creadas (no automticas) 1294 Incluir informacin ......................................................................................................................................................... del proceso y del caso 1298 Incluir Tablas ......................................................................................................................................................... o colecciones 1307 Enviar mensajes ......................................................................................................................................................... de acuerdo a condiciones 1318 Incluir informacin ......................................................................................................................................................... de una regla 1323

Copyright 2013 - Bizagi

Enviar a ......................................................................................................................................................... mltiples destinatarios 1326 Cambio de contexto ......................................................................................................................................... 1337 Envo de ......................................................................................................................................................... copias y copias ocultas 1346 Configuracin .......................................................................................................................................................... de servidor de correo 1347 Configuracin ......................................................................................................................................................... avanzada de servidor de correo 1349

7 Plantillas de Documentos ................................................................................................................................... 1357

Crear la plantilla .......................................................................................................................................................... 1359 Crear plantilla ......................................................................................................................................................... de Word 1360 Crear plantilla ......................................................................................................................................................... de excel 1363 Definir cmo .......................................................................................................................................................... generar el documento 1368 Incluir plantilla ......................................................................................................................................................... para generar manualmente 1368 Incluir plantilla ......................................................................................................................................................... para generar automticamente 1372 Configurar .......................................................................................................................................................... plantilla de documento 1374 Configurar ......................................................................................................................................................... una plantilla de word 1376 Configurar ......................................................................................................................................................... una plantilla de excel 1386 Editar y......................................................................................................................................................... eliminar una plantilla 1397 Temas avanzados .......................................................................................................................................................... de plantillas de documentos 1400 Incluir imagenes ......................................................................................................................................................... en plantillas de documentos 1400 Mltiples ......................................................................................................................................................... Plantillas de documentos 1404 Funciones ......................................................................................................................................................... avanzadas de mapeo 1411 Integracin ......................................................................................................................................................... ECM 1420 Configurar el......................................................................................................................................... ECM 1422 Configurar SharePoint ................................................................................................................................... como ECM 1422 Configurar Alfresco ................................................................................................................................... como ECM 1430 Configurar Documentum ................................................................................................................................... como ECM 1432 Definir el ECM ......................................................................................................................................... en Bizagi 1433 Asignar la metadata ................................................................................................................................... a travs de reglas 1453

Integracin con aplicaciones ................................................................................................................................... 1455

Invocar servicios .......................................................................................................................................................... externos desde Bizagi 1458 Invocar......................................................................................................................................................... servicios Web (SOAP) 1461 Invocar......................................................................................................................................................... servicios REST 1470 Consideraciones ......................................................................................................................................... sobre servicios REST 1486 Invocar ......................................................................................................................................................... desde actividades asncronas 1489 Caractersticas ......................................................................................................................................................... y funciones de mapeo 1493 Funciones de......................................................................................................................................... Mapeo 1507 Mapeo con Colecciones ......................................................................................................................................... 1516 Manejo......................................................................................................................................................... de Errores en Interfaces 1522 Integrar APIs .......................................................................................................................................................... o cdigo personalizado 1528 Ejemplo ......................................................................................................................................................... en Enterprise .NET 1530 Ejemplo ......................................................................................................................................................... en Enterprise JEE 1541 Consideraciones ......................................................................................................................................... especiales con componentes 1550 Invocar servicios .......................................................................................................................................................... de Bizagi desde aplicaciones externas 1553 URL de ......................................................................................................................................................... la Capa SOA y consideraciones 1556 Esquemas ......................................................................................................................................................... del modelo de datos de Bizagi XML 1559 Usando......................................................................................................................................................... llaves de negocio en XMLs 1567

Asignacin de trabajo

................................................................................................................................... 1569

Componentes .......................................................................................................................................................... de la asignacin de trabajo 1571 Asignaciones .......................................................................................................................................................... de trabajo bsicas 1575 Asigancin .......................................................................................................................................................... de tareas utilizando pre condiciones 1582 Cuando ningun .......................................................................................................................................................... usuario cumple las condiciones de asignacin 1591 Ignorar las reglas .......................................................................................................................................................... de asignacin 1597 Reasignar trabajo .......................................................................................................................................................... 1599 Organizacin .......................................................................................................................................................... 1605

Copyright 2013 - Bizagi

Crear una ......................................................................................................................................................... organizacin 1608 Asistente de organizacin ......................................................................................................................................... 1623 Propiedades ......................................................................................................................................................... de usuario 1631 Grupos......................................................................................................................................................... de usuarios 1642 Esquema ......................................................................................................................................................... de horarios de trabajo y calendarios 1646 Esquema de horario ......................................................................................................................................... de trabajo 1647 Esquema de festivos ......................................................................................................................................... 1656 Mltiples ......................................................................................................................................................... organizaciones 1659

10 Seguridad en Bizagi Studio ................................................................................................................................... 1665

Configurar .......................................................................................................................................................... la seguridad en Bizagi Studio 1669 Crear grupos .......................................................................................................................................................... en la Seguridad de Bizagi Studio 1673

11

Nmero de caso personalizado ................................................................................................................................... 1676

Part IV Ejecucin del Proceso

1

1687

Portal de Trabajo de Bizagi ................................................................................................................................... 1687

Interfaz del.......................................................................................................................................................... Portal de Trabajo 1689 Men principal ......................................................................................................................................................... 1690 rea de......................................................................................................................................................... casos 1693 rea de......................................................................................................................................................... trabajo 1697 Actividades ......................................................................................................................................................... pendientes 1702 Seguridad del .......................................................................................................................................................... Portal de Trabajo 1720 Inicio de ......................................................................................................................................................... sesin en el Portal de Trabajo 1722 Autenticacin ......................................................................................................................................... 1728 Autenticacin ................................................................................................................................... Bizagi 1730 Autenticacin ................................................................................................................................... Windows 1732 Autenticacin ................................................................................................................................... LDAP 1737 Autenticacin ................................................................................................................................... avanzada 1739 Autenticacin ................................................................................................................................... personalizada 1740 Autenticacin ................................................................................................................................... mixta 1742 Importar usuarios ......................................................................................................................................... LDAP 1745 Atributos LDAP ................................................................................................................................... 1751 Seguridad ......................................................................................................................................................... para mens del Portal 1753 Dar acceso a ......................................................................................................................................... los mens del Portal 1756 Seguridad ......................................................................................................................................................... del caso 1772 Manejar los privilegios ......................................................................................................................................... a travs de la capa SOA 1789 Administracin .......................................................................................................................................................... del Portal de Trabajo 1791 Administracin ......................................................................................................................................................... de Casos 1793 Administracin ......................................................................................................................................................... de usuarios 1803 Manejo de Posiciones, ......................................................................................................................................... Roles y Habilidades 1811 Cuentas bloqueadas ......................................................................................................................................... 1813 Usuario delegado ......................................................................................................................................... 1823 Valores......................................................................................................................................................... de Entidades Paramtricas en el Portal de Trabajo 1827 Administrar ......................................................................................................................................................... Polticas en el Portal de Trabajo 1832 Definicin ......................................................................................................................................................... de alarmas 1835 Consultas .......................................................................................................................................................... 1840 Anlisis......................................................................................................................................................... grafico 1853 Localizar el.......................................................................................................................................................... Portal de Trabajo 1868 Traducir ......................................................................................................................................................... los objetos del Portal de Trabajo 1870 Localizar ......................................................................................................................................................... los procesos y sus componentes 1873 Escoger ......................................................................................................................................................... el idioma del Portal de Trabajo 1878 Comentarios .......................................................................................................................................................... del caso 1879 Personalizar .......................................................................................................................................................... el Portal de Trabajo 1894

Copyright 2013 - Bizagi

Deployment de sus Procesos ................................................................................................................................... 1909

Consideraciones .......................................................................................................................................................... y requerimientos 1914 Deployment ......................................................................................................................................................... de los objetos 1922 Relacionar ......................................................................................................................................................... objetos 1931 Deployment .......................................................................................................................................................... a Pruebas 1936 Release......................................................................................................................................................... Candidate en Deployment a Pruebas 1956 Deployment .......................................................................................................................................................... a Produccin 1959 Mejoramiento ......................................................................................................................................................... continuo 1970 Gua para nueva ......................................................................................................................................... versin de Proceso 1976

3 Movilidad

................................................................................................................................... 1980

4 Integracin de Portales ................................................................................................................................... 1988

Sharepoint .......................................................................................................................................................... 1988 Joomla! .......................................................................................................................................................... 1993

Part V Anlisis del Proceso

1 2 BAM Anlisis

2010

................................................................................................................................... 2011 ................................................................................................................................... 2021 ................................................................................................................................... 2029 ................................................................................................................................... 2040 ................................................................................................................................... 2048

3 Sensores 4 Dimensiones 5 Mis Reportes

Part VI Administracin del Sistema Bizagi

1

2053

Actualizacin de Bizagi ................................................................................................................................... 2053

Actualizacin .......................................................................................................................................................... de versin 2053 Actualizacin ......................................................................................................................................................... de versin en la edicin JEE 2059 Actualizacin .......................................................................................................................................................... de edicin Xpress a Enterprise 2061

Mantenimiento de proyectos ................................................................................................................................... 2079

Backups y su .......................................................................................................................................................... restauracin en SQL Server 2085 Export e Import .......................................................................................................................................................... en Oracle 2101

3 Mover un proyecto de Bizagi ................................................................................................................................... a otro servidor 2083

4 Copiar o reutilizar proyectos ................................................................................................................................... en Bizagi 2115 5 Management Console ................................................................................................................................... 2116
Administracin .......................................................................................................................................................... de trabajos programados 2124 Administracin .......................................................................................................................................................... de Servidores y Clsters 2130 Clsters ......................................................................................................................................................... en la edicin Enterprise JEE 2154

6 8 9

Configuracin de entorno ................................................................................................................................... 2155 Diagnstico y control de................................................................................................................................... errores 2168

Diagnstico .......................................................................................................................................................... y control de errores para servicios Web 2175

7 Configuracin de negocio ................................................................................................................................... 2162

Administracin de sistemas ................................................................................................................................... externos 2181

Administracin .......................................................................................................................................................... de interfaces 2182 Verificar Replicacin .......................................................................................................................................................... 2188

10 Administracin de Actividades ................................................................................................................................... Asncronas 2194 11 Lista de chequeo para la ................................................................................................................................... creacin de proyectos 2199
Lista de verificacin .......................................................................................................................................................... para Bizagi Enterprise .NET 2199 Lista de verificacin .......................................................................................................................................................... para Bizagi Enterprise JEE 2200

Copyright 2013 - Bizagi

Lista de verificacin .......................................................................................................................................................... para Xpress 2201

12

Instalacin de IIS

................................................................................................................................... 2201

13 Instalacin de un SMTP local ................................................................................................................................... 2214 14 Configuracin de SQL Server ................................................................................................................................... 2218 15 Cambiar el login usado en ................................................................................................................................... SQL Server 2228 16 Autorizacin para trabajar ................................................................................................................................... en un servidor remoto 2235
Definicin del .......................................................................................................................................................... ODS en el Servidor de Aplicaciones JEE 2250

17 Configuracin de ODS para ................................................................................................................................... el anlisis de Procesos 2243 18 19 Configuracin de Bizagi para ................................................................................................................................... el acceso seguro desde Internet 2255 Configuracin de Bizagi en ................................................................................................................................... Amazon WS 2261

Part VII Temas Avanzados

1

2263

Servicios Web de la Capa................................................................................................................................... SOA 2263

Mtodos Web .......................................................................................................................................................... de WorkflowEngineSOA 2264 abortCasesAsString ......................................................................................................................................................... 2266 assignActivityAsString ......................................................................................................................................................... 2270 createCasesAsString ......................................................................................................................................................... 2277 getActivitiesAsString ......................................................................................................................................................... 2286 getApplications ......................................................................................................................................................... 2294 getCasesAsString ......................................................................................................................................................... 2296 getCategoriesAsString ......................................................................................................................................................... 2305 getCategoriesLocalized ......................................................................................................................................................... 2308 getClosedActivitiesAsString ......................................................................................................................................................... 2311 getEventsAsString ......................................................................................................................................................... 2318 getWorkflowClassesAsString ......................................................................................................................................................... 2323 getWorkflowClassesFromCategoryName ......................................................................................................................................................... 2327 perfomActivityAsString ......................................................................................................................................................... 2331 saveActivityAsString ......................................................................................................................................................... 2339 setEventAsString ......................................................................................................................................................... 2348 Mtodos Web .......................................................................................................................................................... de EntityManagerSOA 2358 getCaseDataUsingSchemaAsString ......................................................................................................................................................... 2359 getCaseDataUsingXPathsAsString ......................................................................................................................................................... 2361 getEntitiesAsString ......................................................................................................................................................... 2367 getEntitiesUsingSchemaAsString ......................................................................................................................................................... 2371 getEntitySchemaStr ......................................................................................................................................................... 2375 saveEntityAsString ......................................................................................................................................................... 2377 Mtodos Web .......................................................................................................................................................... de QuerySOA 2382 QueryCasesAsString ......................................................................................................................................................... 2383 QueryEntitiesAsString ......................................................................................................................................................... 2391 Mtodos Web .......................................................................................................................................................... de RenderSOA 2398 GetActivityForm ......................................................................................................................................................... 2399 GetFormById ......................................................................................................................................................... 2404 GetQueryForms ......................................................................................................................................................... 2409 GetSummaryForms ......................................................................................................................................................... 2414

Instalacin de Oracle Data ................................................................................................................................... Provider para .NET 2418

3 Crear un proyecto utilizando ................................................................................................................................... Oracle 2421 4 Configuracin del Portal................................................................................................................................... de Trabajo en JEE 2432
Configuracin .......................................................................................................................................................... del Servidor de Aplicacin JEE para trabajar con Bizagi 2434 Configuracin ......................................................................................................................................................... de WebSphere 2434

10

Copyright 2013 - Bizagi

Configuracin ......................................................................................................................................... de WebSphere en clster 2435 Preconfiguracin ................................................................................................................................... de WebSphere para soporte a clster 2436 Configuracin de WebSphere en clster para trabajar con Bizagi ................................................................................................................................... 2455 Configuracin ................................................................................................................................... del Scheduler en WebSphere 2503 Configuracin ......................................................................................................................................... estndar de WebSphere 2505 Configuracin ......................................................................................................................................................... de Weblogic 2557 Configuracin ......................................................................................................................................... de Weblogic para soporte a clster 2557 Preconfiguracin ................................................................................................................................... de Weblogic para soporte a clster 2558 Configuracin de Weblogic en clster para trabajar con Bizagi ................................................................................................................................... 2569 Configuracin ................................................................................................................................... del Scheduler en Weblogic 2604 Configuracin ......................................................................................................................................... estndar de Weblogic 2606 Configuracin ......................................................................................................................................................... de JBoss 2643 Configuracin ......................................................................................................................................... estndar de JBoss 2644 Configuracin .......................................................................................................................................................... de la arquitectura del sistema 2665 Configuracin ......................................................................................................................................................... de la capa de presentacin en el Servidor Web 2669 Configuracin ......................................................................................................................................................... del balanceo de cargas 2675 Balanceo de cargas ......................................................................................................................................... con WebSphere 2675 Balanceo de cargas ......................................................................................................................................... con Weblogic 2681 Despliegue.......................................................................................................................................................... a un Servidor de Aplicacin JEE 2683 Despliegue ......................................................................................................................................................... hacia WebSphere 2683 Despliegue ......................................................................................................................................................... hacia Weblogic 2692 Despliegue ......................................................................................................................................................... hacia JBoss 2697

5 Deployment Avanzado ................................................................................................................................... 2701

Part VIII Cmo....

1 Integracin

2715
................................................................................................................................... 2715

Cmo configurar .......................................................................................................................................................... Replicacin o Virtualizacin en JEE Application Server? 2715 Cmo configurar .......................................................................................................................................................... Virtualizacin para entidades relacionadas? 2721 Cmo iniciar .......................................................................................................................................................... Procesos en Bizagi desde otras aplicaciones 2748 Cmo realizar .......................................................................................................................................................... Actividades Bizagi desde otras aplicaciones 2754 Cmo integrar .......................................................................................................................................................... Bizagi con SAP 2761 Integrar ......................................................................................................................................................... Bizagi con SAP invocando servicios web de SAP 2762 Crear un ......................................................................................................................................................... proveedor en SAP desde Bizagi 2775 Integrar ......................................................................................................................................................... Bizagi con SAP invocando directamente BAPI Wrappers 2786 Cmo ejecutar .......................................................................................................................................................... procedimientos almacenados desde Bizagi 2802

Cmo incluir documentos ................................................................................................................................... en cualquier momento en Bizagi 2818

Part IX FAQ Index

2851 0

Copyright 2013 - Bizagi

11

Parte I
Bienvenido a Bizagi BPM Suite

Bienvenido a Bizagi BPM Suite

Esta ayuda aplica para la Versin 10 o superior de Bizagi BMP Suite. Para encontrar ayuda sobre versiones anteriores por favor visite nuestro Wiki de Bizagi.

1.1

Informacin general
La Gestin de Procesos de Negocio (BPM por sus siglas en ingls Business Process Management) es una filosofa de gestin empresarial. Su objetivo principal es proporcionar a los directores y dueos de procesos la informacin necesaria para la correcta asignacin de los recursos de la compaa. Esto lleva a un aumento en la eficiencia y rentabilidad de la organizacin debido a la gestin sistemtica de los procesos de negocio los cuales debern ser modelados, automatizados, integrados, controlados y optimizados de forma continua. Bizagi BPM Suite es el sistema lder para Gestin de Procesos de Negocio (BPMS), el cual automatiza sus procesos de forma rpida y flexible. En Bizagi, muchos de los requerimientos que comnmente se utilizan en la automatizacin de procesos han sido pre construidos. Es por esto que Bizagi entrega ms rpido. Adems, Bizagi permite a los usuarios de negocios automatizar y modificar procesos de negocios complejos y dinmicos ms rpido y de forma ms flexible que otras soluciones, parte vital para el mejoramiento contino de los procesos crticos de la organizacin. Bizagi BPM Suite se compone de tres herramientas que le ayudarn a gestionar todo el ciclo de vida del proceso: Modelar, Ejecutar y Mejorar.

Copyright 2013 - Bizagi

13

Modelador de Procesos de Bizagi: El modelador permite de forma grafica, diagramar, modelar y documentar sus procesos de negocio utilizando el estndar BPMN (Business Process Model and Notation). BPMN es un formato aceptado mundialmente para el modelado de procesos. Bizagi Studio: El mdulo de construccin soporta la definicin de: el modelo del datos, las interfaces de usuario (conocidas como formas), las reglas de negocio, los participantes o ejecutantes de las actividades y la integracin con sistemas externos, entre otras cosas. Servidor BPM de Bizagi: La suite de Bizagi ejecuta el modelo en el Portal de Trabajo, el cual es accedido a travs de un navegador a travs del servidor BPM de Bizagi logrando una gestin eficaz e inteligente del proceso en tiempo real. Los usuarios finales se utilizan el Portal de Trabajo para llevar a cabo sus actividades diarias y para monitorear la operacin del negocio en tiempo real con un conjunto completo de informes.

Modelador de Procesos y Bizagi BPM Suite

Bizagi BPM Suite ofrece un Modelador de Procesos integrado en Bizagi Studio. Sin embargo lo invitamos a diagramar y documentar sus procesos utilizando nuestro Modelador de Procesos de Bizagi y luego automatizarlos con Bizagi BPM Suite.

Si u sted so lo esta in teresad o en m o d elad o d e p ro ceso s y n o en su au to m atizaci n , p o r fav o r co n su lte n u estra h erram ien ta g ratu ita M o d elad o r d e P ro ceso s B izag i.

1.2
1.2.1

Conceptos de Bizagi BPM Suite

Ciclo de vida de los procesos
Bizagi BPM Suite le permitir a usted y a su organizacin manejar todo el ciclo de vida de sus procesos: Modelar, Ejecutar y Mejorar sus procesos a travs de un ambiente grafico y con la mnima cantidad de programacin. Gestionando todo el ciclo de vida de sus procesos usted podr lograr productividad, eficiencia y crecimiento de utilidades de forma sostenible en el largo plazo. La siguiente figura explica los pasos para construir una solucin en Bizagi.

14

Copyright 2013 - Bizagi

Modelar
El primer paso para crear un solucin Bizagi es disear el flujo del proceso. Esto es una cadena de actividades, la cual es la estructura fundamental del proyecto, en ella se debe incluir las variables y los elementos necesarios para cumplir con los requerimientos de la organizacin. Nosotros le recomendamos utilizar el Modelador de Procesos de Bizagi, sin embargo usted puede crear sus diagramas de procesos utilizando el modelador incluido en el primer paso del asistente. El Modelador de Procesos de Bizagi es una herramienta gratuita la cual se puede descargar de nuestra pgina web. El modelador permite de forma grafica diagramar, modelar y documentar sus procesos de negocio utilizando el estndar BPMN (Business Process Model and Notation). BPMN es un formato aceptado mundialmente para el modelado de procesos. Cuando haya terminado su flujo de proceso seleccione la opcin Ejecu tar W o rkflo w en la pestaa de Inicio del modelador. Esto exportar de forma automtica sus procesos al ambiente de construccin llamado Bizagi Studio.

Copyright 2013 - Bizagi

15

Automatizar y Ejecutar
Luego de disear el proceso, el siguiente paso para construir una solucin Bizagi es automatizar y ejecutar. Automatizar es convertir todas las actividades del proceso en una aplicacin tecnolgica. Bizagi Studio es una herramienta utilizada para la automatizacin de procesos que fueron definidos previamente con el Modelador de Procesos de Bizagi. Un asistente fcil de usar lo guiar a travs de cada uno de los pasos requeridos para crear un proceso completo: definir el modelo de datos, las interfaces de usuarios, las reglas de negocio, la asignacin de trabajo y la integracin con otras aplicaciones, entre otras cosas. El modelo es almacenado en una base de datos y es interpretado y ejecutado por el servidor BPM de Bizagi. El modelo se presenta en el Portal de Trabajo accediendo a este a travs de un navegador. El servidor BPM de Bizagi, basado en el modelo de proceso previamente construido, vigila la correcta ejecucin de las tareas y actividades que intervienen en el proceso de negocio; controlando y verificando que cada una de las tareas sean realizadas en el momento correcto, por la persona correcto y de acuerdo a los lineamientos, objetivos y otras reglas de negocio establecidas por la compaa. El Portal de Trabajo resultante tiene una caracterstica muy importante: Cuando un proceso es modificado (cualquier elemento del modelo) ste se actualizar automticamente y el cambio ser

16

Copyright 2013 - Bizagi

visualizado de forma inmediata.

Mejorar
Bizagi incluye un conjunto de reportes e indicadores de rendimiento los cuales le ayudar a analizar la operacin de sus negocios en tiempo real y analizar informacin sobre el rendimiento histrico de los procesos. Estos indicadores permiten a los dueos de procesos y a los directivos de las empresas obtener una perspectiva de la operacin de sus negocios, logrando identificar cuellos de botella, calcular rendimiento de los recursos, nivel de servicio y tendencias. Esta informacin es la base para el mejoramiento de los procesos. A travs de las observaciones y conclusiones obtenidas del BAM y el Anlisis de reportes en el Portal de Trabajo se identifican las oportunidades de mejoramiento de los procesos. Basado en sus hallazgos, los procesos y las reglas de negocios son ajustados en tiempo real utilizando el Portal de Trabajo. Las mejoras pueden ser realizadas utilizando Bizagi Studio para generar una nueva versin del proceso. La nueva versin pude ser llevada a produccin sin programacin y en un corto periodo de tiempo: tan solo con modificar el modelo de negocio, la aplicacin se adaptar de forma automtica haciendo sencillo el mejoramiento contino de sus procesos e incrementando la productividad de su organizacin. Bizagi soporta mltiples versiones de los procesos. Una vez se ha identificado una oportunidad de mejora, en Bizagi Studio se puede crear una nueva versin de un procesos existente que incluya los cambios que hacen parte de la evolucin del proceso o un cambio en un requerimiento del negocio.

Copyright 2013 - Bizagi

17

1.2.2

Asistente de Procesos
Bizagi Xpress provee un poderoso asistente que lo guiar a travs de todos los pasos necesarios para ejecutar sus procesos de negocio. Usted podr construir y ejecutar en muy corto tiempo. Solo siguiendo cada uno de los siete pasos usted podr transformar los procesos que fueron diseados con el Modelador de Procesos de Bizagi en aplicaciones sin necesidad de programacin.

18

Copyright 2013 - Bizagi

Modelar Procesos: Define el flujo del proceso utilizando el Modelador de Procesos de Bizagi. Modelar Datos: Disea un modelo de datos que organice la informacin del caso que ser utilizada en las diferentes actividades del proceso. Definir Formas: Disea las interfaces de usuario y la informacin que ser mostrada en las actividades del proceso. Reglas de Negocio: Define las condiciones de flujo y las expresiones necesarias para modelar el comportamiento de la situacin de negocio. Participantes: Asigna los usuarios responsables por la ejecucin de las actividades del proceso. Integrar: Configurar conexiones con sistemas externos o entre procesos. Este proceso es opcional. Ejecutar: Lleve sus procesos a ambientes de pruebas y de produccin.

1.3

Soporte multi idioma Mens multi idiomas para el Portal de trabajo

Bizagi posee diez idiomas pre definidos que pueden ser seleccionados para cambiar el idioma del

Copyright 2013 - Bizagi

19

Portal de Trabajo. Todos los mens se traducirn automticamente sin necesidad de realizar personalizaciones adicionales. Usted puede definir ms de un idioma y permitirle al usuario final escoger en cual desea ver el Portal de Trabajo. Estos son los idiomas pre construidos por Bizagi: Ingls Espaol Alemn Francs Portugus Ruso Holands Italiano Japons Chino simplificado

Multi idiomas para procesos y sus componentes

Adems de los mens del Portal de Trabajo, usted tambin podr disear y construir sus procesos en cualquier idioma, por lo que toda la interfaz de usuario ser mostrada al usuario final en el idioma deseado. A medida que usted va construyendo su proceso, usted puede ir traduciendo todo, es decir, el proceso, sus componentes, la informacin que se muestra al usuario final y la informacin de las entidades y las reglas de negocio que van a ser administradas a travs del Portal de Trabajo.

20

Copyright 2013 - Bizagi

Copyright 2013 - Bizagi

21

Idiomas soportados en Bizagi Studio

Bizagi Studio, la herramienta para construir procesos, soporta Ingls y Espaol.

Instalar Bizagi Studio en su idioma preferido

Al inicio de la instalacin de Bizagi Studio, se le pedir que seleccione el idioma de su preferencia. Una vez seleccionado, el proceso de instalacin y posteriormente en uso del producto todo el texto ser mostrado en el idioma escogido.

22

Copyright 2013 - Bizagi

Cambiar el idioma en Bizagi Studio

Una vez Bizagi ha sido instalado, usted podr cambiar el idioma en cualquier momento. Seleccione un idioma de la lista desplegable localizada en la esquina superior derecha de Bizagi. Para que el cambio tenga efecto es necesario reiniciar Bizagi Studio.

1.4

Entrenamiento y soporte
Bizagi ofrece varios tipos de soporte para ayudarle en proceso de modelado, automatizacin y ejecucin de sus procesos.

Soporte y entrenamiento en lnea.

Descubra como capturar y transformar un proceso para beneficio de su negocio. Ofrecemos cursos de entrenamiento gratuitos para realizar a su ritmo. Por favor visite nuestro sitio web de e-learning.

Foros de Soporte
Ofrecemos soporte gratuito a travs de foros donde sus preguntas son resueltas en corto tiempo. Tambin, es posible compartir ideas y opiniones con nuestra comunidad la cual crece da a da. Para acceder a nuestros foros de soporte es necesario registrarse. Por favor visite nuestro sitio de foros.

Process Central gratuito

Acceda y utilice nuestra coleccin de plantillas con las mejores prcticas en varios procesos comnmente usados dentro de las organizaciones. De nuevo, todos sus comentarios y sugerencias son bienvenidos, los cuales podrn ser realizados una vez se ha registrado. Por favor visite nuestro Process Central.

Copyright 2013 - Bizagi

23

Ayuda en lnea
Esta ayuda en lnea contiene el conocimiento que usted necesita para diagrama, automatizar y ejecutar sus procesos. Sintase libre de navegar a travs de toda nuestra documentacin. La gua de usuario puede ser descargada, para uso sin conexin, seleccionado la opcin de Descargar Ayuda, esta opcin guardar el archivo en un documento PDF. La ayuda contiene: Informacin sobre: Cmo hacer?, preguntas frecuentes, la gua de usuario y representa la fuente principal de la documentacin del producto.

1.5

Ediciones de Bizagi BPM Suite

Bizagi esta disponible en diferentes ediciones para soportar las necesidades de las organizaciones:

Edicin Entreprise
La edicin corporativa ha sido diseada para negocios grandes con alto volumen, fiabilidad y disponibilidad de requerimientos. Esta edicin provee todas las caractersticas necesarias para implementar un proyecto grande de BPM, el cual le ayudar en la ejecucin de su negocio de forma ms eficiente, mejorar la productividad de los empleados y reducir costos. Ofrecemos una plataforma de clase empresarial para misiones crticas, de alto rendimiento y procesos de negocios complejos en organizaciones que van desde cientos hasta miles de usuarios.

Enterprise .NET y Entretprise JEE Edition son similares en funcionalidad; la nica diferencia es la plataforma donde son ejecutadas.

CARACTERSTICAS (Ediciones Enterprise .NET y JEE) BPM Suite completa Modelador de Procesos BPMN Arquitectura 100% Model Driven Diseador de Formas "Drag & Drop" Motor de Reglas de Negocio Integracin SOA Motor de Ejecucin Portal de Trabajo Web Indicadores de Procesos BAM Tolerancia a Fallas y Clustering

Deployment a mltiples servidores

Edicin Enterprise .NET

Edicin Enterprise JEE Weblogic / Websphere / JBoss

Sistema Operativo

Windows Server 2008 / 2008 R2 / 2003 Windows 7 / Vista / XP

24

Copyright 2013 - Bizagi

Edicin Enterprise .NET

Edicin Enterprise JEE Weblogic / Websphere / JBoss

Servidor Web / Servidor de aplicaciones

IIS (Microsoft Internet Information Services)

Bizagi XPress Edition

Nuestra edicin de entrada. Esta edicin ha sido diseada para soluciones departamentales o pequeas y medianas empresas. Bizagi Xpress Edition es una edicin subsidiada la cual le permitir experimentar los beneficios BPM en un proyecto inicial (prototipo, proyecto piloto, prueba) antes de empezar con su programa completo de BPM. Bizagi Xpress Edition puede ser usada para un mximo de 50 usuarios nicamente.

CARACTERSTICAS (Ediciones Enterprise .NET y JEE) BPM Suite completa Modelador de Procesos BPMN Arquitectura 100% Model Driven Diseador de Formas "Drag & Drop" Motor de Reglas de Negocio Integracin SOA Motor de Ejecucin Portal de Trabajo Web Indicadores de Procesos BAM

RESTRICCIONES Usuarios Mximos Instalacin Single Server 50 Usuarios No Clustering, No Tolerancia a Fallos

Copyright 2013 - Bizagi

25

1.5.1

Diferencias entre las ediciones de Bizagi BPM Suite

Caractersticas disponibles solamente en la Edicin Enterprise

Soporte 64- bit Soporte para bases de datos de Oracle: La edicin Enterprise soporta tanto Oracle como MS SQL server. La edicin XPress solo soporta MS SQL server. Integracin de la aplicacin: Es frecuente encontrar en proyectos BPM, procesos que necesitan ser integrados con aplicaciones existentes y sistemas heredados. En todas las ediciones, Bizagi ofrece un poderoso asistente para realizar la integracin utilizando servicios web sin necesidad de programacin. Si no es posible utilizar servicios web en el proyecto usted tendr que utilizar la versin Enterprise la cual soporta ms tipos de integracin: DLLs, Remoting, EJB, JMS y clases. Esto es permitido por la Librera de Componentes de Bizagi. Clic para ms informacin sobre Librera de Componentes. Tolerancia a Fallas y Clustering: Con la edicin Enterprise de Bizagi, usted puede configurar clsteres conformados por varios servidores. De esta forma, se garantiza que cualquier proceso contine operando de forma apropiada en el evento de falla de alguno de sus componentes. Clic para ms informacin sobre Clustering. Virtualizacin: Bizagi ofrece la tecnologa para integrar el modelo de datos de los procesos de Bizagi con fuentes de datos externas. Con la virtualizacin (sombra) la informacin est disponible para proceso, pero la informacin solo persiste en la base de datos externa. Bizagi ofrece un asistente para ayudar en la virtualizacin con las bases de datos externas de Oracle y SQL server. Adicionalmente, en el la edicin Enterprise .NET, los usuarios pueden personalizar las clases de virtualizacin para conectarse con cualquier fuente de datos externas (por ejemplo, MySQL, DB2, etc.). Clic para ms informacin sobre virtualizacin Reusabilidad: Reusabilidad provee la posibilidad de modelar cosas una vez y reutilizarla dentro del mismo proceso o dentro de otros procesos. Formas pueden ser reutilizadas en cualquiera de las ediciones. Sin embargo, deber tener la edicin Enterprise para reutilizar Vocabularios, Reglas de Negocio, Expresiones o funciones. La reusabilidad permite modelar ms rpida y eficientemente. Clic para ms informacin sobre reutilizacin de Formas. Clic para ms informacin sobre reutilizacin de Reglas de negocio Trabajos personalizados: Compaas necesitas ejecutar tareas algunas tareas en tiempos especficos. Esto es soportado por todas las ediciones de Bizagi a travs de los Eventos de Inicio de temporizacin. Sin embargo, algunas veces las tareas o procesos necesitan ser programados, no en base a tiempo, sino basado en eventos del negocio o de informacin. Esto solo se soporta en la edicin Enterprise a travs de Trabajos personalizados. Esta funcionalidad permite, por ejemplo, empezar casos basados en una regla de negocio o de una lista de fechas guardadas en una entidad paramtrica.

Numero de usuarios: Bizagi Xpress Edition puede ser utilizado por un mximo de 50 usuarios.

26

Copyright 2013 - Bizagi

Nuestra edicin Enterprise no tiene lmite de usuarios.

1.6

Productos relacionados

El Modelador de Procesos de Bizagi es una herramienta para modelado y documentacin de procesos. El modelador le permitir de forma grafica diagramar, modelar y documentar sus procesos de negocio utilizando el estndar BPMN (Business Process Modela and Notation). BPMN es un estndar mundialmente aceptado para el modelado de procesos. Usted podr publicar documentos de alta calidad en formato Word, PDF, SharePoint o Wiki. Los procesos pueden ser fcilmente importados y exportados desde Visio, XML y otras herramientas. El modelador le permite diagramar y documentar rpida y fcilmente gracias a su sistema de Intellisense (autocompletado de cdigo inteligente) y su exclusiva interfaz grfica, sin la demora de las rutinas de validacin. Procesos son modelados y documentados utilizando el Modelador de Procesos de Bizagi. Bizagi Studio es un ambiente de construccin que transforman los procesos en aplicaciones. Cuando se utiliza Bizagi Studio para la implementacin de los procesos se debe definir: el modelo de datos, las interfaces de usuario (conocidas como formas en Bizagi), las reglas de negocio para representar la lgica que debe existir por detrs y los participantes o ejecutantes de las actividades del proceso con sus cargas de trabajo, entre otras cosas.

Copyright 2013 - Bizagi

27

Cmo se conectan nuestros productos?

1. 2. Descargue e instale el Modelador de Procesos de Bizagi. Modele y documente sus procesos utilizando el Modelador de Procesos de Bizagi. Luego seleccione la opcin ejecutar Workflow en la pestaa de Inicio. Un asististe lo guiar a travs de los pasos necesarios para hacer la transicin a nuestra Suite BPM, donde usted podr automatizar sus proceso.

3.

Por medio de la Suite BPM (a travs de Bizagi Studio), los detalles de los procesos son extendidos a su ejecucin. En Bizagi Studio un asistente lo guiar paso a paso a travs del proceso de automatizacin logrando tener sus procesos ejecutables en muy corto tiempo.

28

Copyright 2013 - Bizagi

Informacin Relacionada
Para ms informacin sobre cmo utilizar esta herramienta y otra valiosa informacin visite nuestro Modelador de Procesos Bizagi de forma gratuita.

Copyright 2013 - Bizagi

29

Parte II
Comenzando a utilizar Bizagi BPM Suite

2
2.1

Comenzando a utilizar Bizagi BPM Suite

Los siguientes captulos le mostrarn cmo empezar su proyecto Bizagi.

Requerimientos del sistema

Los siguientes artculos describen los requerimientos del sistema (hardware y software) necesarios para cada una de las ediciones de Bizagi. Requerimientos por Bizagi Enterprise .NET Requerimientos por Bizagi Enterprise JEE Requerimientos por Bizagi Xpress

2.1.1

Enterprise. NET - requerimientos

Consulte la informacin sobre requerimientos de sistema (hardware y software) para el ambiente correspondiente segn se describe en los artculos a continuacin: Requerimientos para el ambiente de produccin en la edicin Enterprise .NET Requerimientos para el ambiente de pruebas en la edicin Enterprise .NET Requerimientos para el ambiente de desarrollo en la edicin Enterprise .NET

2.1.1.1

.NET requerimientos para Produccin El siguiente artculo enumera los requerimientos de sistema del ambiente operacional en Bizagi, orientado a un ambiente de produccin configurado en la edicin Bizagi Enterprise .NET. Para mayor informacin acerca de los requerimientos para los ambientes de pruebas o de produccin, consulte Requerimientos de Bizagi Enterprise .NET.

Copyright 2013 - Bizagi

31

Ambiente de produccin
En el ambiente de produccin, Bizagi puede ser configurado para dos escenarios principalmente. 1. Misin Crtica: La configuracin del escenario y de su infraestructura utiliza un clster de servidores BPM y un clster para la base de datos (para balanceo de carga y medidas de tolerancia de fallos). Esto es diseado para aquellas aplicaciones de negocios y servicios que requieren una alta disponibilidad (donde se espera que el servicio este disponible todo el tiempo). 2. Escenario Estndar: Este escenario utiliza un solo servidor BPM y un solo servidor de base de datos, donde no se quiere balanceo ni tolerancia de fallos. En cualquiera de los dos escenarios se recomienda que utilice la instalacin de Bizagi Enterprise .NET de 64-bits, que soporte de manera nativa en plataforma de 64-bits.

1. Misin Crtica (Alta Disponibilidad)

Para soportar un alto rendimiento y alta disponibilidad de la solucin Bizagi, este escenario involucra ms de un servidor en cada capa (configuracin en clster), para soportar el balanceo de cargas en el servidor BPM y para un esquema de tolerancia a fallos en el servidor de la Base de datos. Servidor de Base de datos (provisto en la capa de acceso de datos). En aplicaciones de misin crtica y para un esquema de alta disponibilidad de la solucin, se recomienda configurar ms de un nodo para la Base de datos, de manera que se cuente con tolerancia a fallos. Las posibilidad de la tolerancia a fallos y su configuracin (p.e, tener un esquema activo-pasivo) es provista por los diferentes motores de Base de datos. Servidor BPM Bizagi (provisto en la capa BPM).

32

Copyright 2013 - Bizagi

En aplicaciones de misin crtica y para un esquema de alta disponibilidad de la solucin, se recomienda configurar ms de un nodo para el Servidor BPM, de manera que se cuente con capacidades de balanceo de cargas. Para el balanceo de cargas, Bizagi soporta tanto balanceadores en hardware o software, y se recomienda el uso de un balanceador de cargas por hardware (p.e F5). Bizagi soporta cualquier algoritmo que se configure para el balanceo de cargas (esta configuracin se realiza de manera independiente), y se requiere que se habilite el uso de sesiones pegajosas (sticky sessions). Bizagi no provee como tal el balanceador de cargas.

Nmero de servidores BPM: 2 (balance de carga en configuracin de clster) Nmero de procesadores 1

Procesador

4 cores 64-bit Sugerencia: Xeon dualcore of 3GHz 16 GB Dos discos de 80 GB RAID 1 Dos NIC - Dual port 1GB Fuente de alimentacin redundantes

Servidor BPM (para cada nodo del clster)

HARDWARE

RAM Disco Duro (HardDisk)

Dispositivos adicionales

Copyright 2013 - Bizagi

33

Nmero de servidores BPM: 2 (balance de carga en configuracin de clster) Windows Server 2008 R2 64 bits (recomendado) Windows Server 2008 64 bits IIS 5 o superior Oracle Data Provider component (Aplica para proyectos que utilizan bases de datos Oracle). Framework de .NET 4.0 (instalado por Bizagi). Dentro de esta instalacin, tambin se incluyen otros componentes como: Visual C++ 2008 Redistribuble.

Sistema operativo

Servidor web

SOFTWARE

Componentes adicionales

Nmero de servidores de Base de Datos: 2 (con configuracin de Cluster para la tolerancia a fallos) Nmero de procesadores 1

Procesador

4 cores 64-bit Sugerencia: Xeon dualcore of 3GHz 16 GB Dos discos de 80 GB RAID 1 Two NIC - Dual port 1GB Redundant Power Supply Microsoft SQL Server 2012 Microsoft SQL Server 2008 R2 SP1 o

HARDWARE Servidor de base de datos (para cada nodo del clster)

RAM Disco Duro (HardDisk) Dispositivos adicionales

SOFTWARE

Motor de base de datos

34

Copyright 2013 - Bizagi

Nmero de servidores de Base de Datos: 2 (con configuracin de Cluster para la tolerancia a fallos) superior. Microsoft SQL Server 2008 SP1 o superior. Microsoft SQL Server 2005 SP2 o superior. Oracle Database 11g R2 (disponible en el Q4 de 2013) Oracle Database 10g R2 Tenga en cuenta que se requiere que la misma intercalacin (collation) o set de caracteres, la misma versin y service pack del motor de base de datos sea instalado en los 3 ambientes (desarrollo, pruebas y produccin).

Nmero de procesadores Procesador HARDWARE PARA ESCRITORIO U s u a r HARDWARE PARA i EQUIPOS MOVILES o f i n a l RAM Disco Duro (HardDisk) Resolucin de pantalla

1 Pentium IV of 2GHz compatible processor or higher 2 GB 10 GB de espacio libre 1024 x 768 o superior Aplicacin nativa en: iOS (iPad, iPhone) Smartphones y tabletas Android Tabletas Windows 8 En otros dispositivos, el acceso es mediante los navegadores. Internet Explorer 9 o superior Versin recomendada: IE 10. Chrome 9 o superior (especialmente recomendado usar Chrome)

Dispositivos

SOFTWARE

Navegador

Copyright 2013 - Bizagi

35

Safari 5 o superior FireFox 4 o superior Componentes opcionales, usualmente instalados por el navegador mismo: Microsoft Silverlight para la posibilidad de consultas grficas. Plugin de Adobe Flash player para los grficos de los reportes.

Componentes adicionales

Informacin adicional
Tenga en cuenta que los requerimientos del hardware para el ambiente de produccin tambin dependen de otras variables, como por ejemplo: el nmero de usuarios que trabajan de manera concurrente, la demanda de procesamiento, el tamao esperado de los archivos y el crecimiento de la base de datos, entre otras cosas. Por lo tanto, las recomendaciones anteriores corresponden al mnimo hardware necesario, y los requerimientos deben ser complementados con un anlisis ms estricto en torno a las dimensiones de cada proyecto especfico. Por ejemplo, en este anlisis se define el nmero de servidores adicionales que son necesarios para la solucin.

Para ver y obtener una estimacin de las dimensiones de su proyecto usted puede utilizar el Estimador de dimensiones de Bizagi. Descargue casos de estudio con configuraciones de arquitectura del sistema Bizagi, en donde se ilustra la infraestructura utilizada en proyectos corporativos de grande escala.

2. Escenario Estndar
En este escenario un solo servidor BPM y un solo servidor de base de datos es utilizado.

36

Copyright 2013 - Bizagi

Nmero de servidores BPM: 1 Nmero de procesadores Procesador 1

HARDWARE RAM Disco Duro (HardDisk) Servidor BPM Dispositivos adicionales Sistema Operativo

2 cores 64-bit Suggested: Xeon dualcore of 2.66GHz 16 GB Un 80 GB - RAID 1

Un NIC - Dual port 1GB

Windows Server 2008 R2 64 bits (recomendado) Windows Server 2008 64 bits IIS 5 o superior Oracle Data Provider component (Aplica para proyectos que

SOFTWARE

Servidor Web Componentes adicionales

Copyright 2013 - Bizagi

37

Nmero de servidores BPM: 1 utilizan bases de datos Oracle). Framework de .NET 4.0 (instalado por Bizagi). Dentro de esta instalacin, tambin se incluyen otros componentes como: Visual C++ 2008 Redistribuble.

Nmero de servidores de Base de datos: 1 Nmero de procesadores 1

Procesador

2 cores 64-bit Sugerencia: Xeon dualcore of 2.66GHz 16 GB Uno disco de 80 GB RAID 1 uno NIC - Dual port 1GB Backup Unit Microsoft SQL Server 2012 Microsoft SQL Server 2008 R2 SP1 o superior Microsoft SQL Server 2008 SP1 o superior Microsoft SQL Server 2005 SP2 o superior Oracle Database 11g R2 (disponible en el Q4 de 2013) Oracle Database 10g R2 Tenga en cuenta que se requiere que la misma

HARDWARE

RAM Disco Duro (HardDisk) Dispositivos adicionales

Database Server

SOFTWARE

Motor de base de datos

38

Copyright 2013 - Bizagi

Nmero de servidores de Base de datos: 1 intercalacin (collation) o set de caracteres, la misma versin y service pack del motor de base de datos sea instalado en los 3 ambientes (desarrollo, pruebas y produccin).

Nmero de procesadores Procesador HARDWARE PARA ESCRITORIO RAM Disco Duro (HardDisk) Resolucin de pantalla HARDWARE PARA U EQUIPOS MOVILES s u a r i o f i n a l

1 Pentium IV of 2GHz compatible processor or higher 2 GB 10 GB de espacio libre 1024 x 768 o superior Aplicacin nativa en: iOS (iPad, iPhone) Smartphones y tabletas Android Tabletas Windows 8 En otros dispositivos, el acceso es mediante los navegadores. Internet Explorer 9 o superior Versin recomendada: IE 10. Chrome 9 o superior (especialmente recomendado usar Chrome) Safari 5 o superior FireFox 4 o superior Componentes opcionales, usualmente instalados por el navegador mismo: Microsoft Silverlight para la posibilidad de consultas grficas. Plugin de Adobe Flash player para los grficos de los reportes.

Dispositivos

Navegador

SOFTWARE

Componentes Adicionales

Copyright 2013 - Bizagi

39

Ambiente de produccin con acceso a Internet

Para los proyectos donde el usuario final necesita acceso al Portal de Trabajo va Internet, de manera opcional se puede configurar un servidor Apache para que se configure como un proxy (reverse proxy) en una DMZ (Zona desmilitarizada) y asi permitir el acceso seguro a los procesos de Bizagi desde internet.

Vea ms informacin acerca de Cmo configurar Bizagi para su acceso seguro desde Internet (a travs de un proxy inverso en una DMZ). 2.1.1.2 .NET requerimientos para Pruebas El siguiente artculo enumera los requerimientos de sistema, cuando se configura un ambiente de pruebas y se utiliza la edicin Bizagi Enterprise .NET. Para mayor informacin acerca de los requerimientos para los ambientes de pruebas o de produccin, consulte Requerimientos de Bizagi Enterprise .NET.

40

Copyright 2013 - Bizagi

Ambiente de pruebas
Este ambiente se utiliza para emular el ambiente de produccin. Permite llevar a cabo las pruebas de aceptacin de usuario orientados a la funcionalidad de los procesos (para verificar que stos se comporten como se espera). Los procesos en un ambiente de pruebas son administrados a travs de Bizagi Management Console. En el ambiente de pruebas, Bizagi puede ser configurado con los siguientes requerimientos mnimos de hardware:

Nmero de servidores BPM: 1 Nmero de procesadores 1 2 cores 64-bit Suggested: Xeon dual-core of 2.66GHz 8 GB 60 GB de espacio libre Windows Server 2008 R2 32 o 64 bits (recomendado) Windows Server 2008 32 o

Procesador HARDWARE RAM Disco duro (HardDisk)

Servidor BPM

SOFTWARE

Sistema operativo

Copyright 2013 - Bizagi

41

Nmero de servidores BPM: 1 64 bits Servidor web IIS 5 o superior Oracle Data Provider component (Aplica para proyectos que utilizan bases de datos Oracle). Framework de .NET 4.0 (instalado por Bizagi). Dentro de esta instalacin, tambin se incluyen otros componentes como: Visual C++ 2008 Redistribuble.

Componentes adicionales

Nmero de servidores de Base de datos: 1 Nmero de procesadores 1 2 cores 64-bit Sugerencia Xeon dual-core of 2.66GHz 8 GB 80 GB de espacio libre Microsoft SQL Server 2012 Microsoft SQL Server 2008 R2 SP1 o superior Microsoft SQL Server 2008 SP1 o superior Microsoft SQL Server 2005 SP2 o superior Oracle Database 11g R2 (disponible en el Q4 de 2013) Oracle Database 10g R2 Tenga en cuenta que se requiere que la misma intercalacin (collation) o set de caracteres, la misma versin y service pack del motor de base de datos sea

Procesador HARDWARE RAM Disco duro (HardDisk)

Servidor de Base de Datos

SOFTWARE

Motor de base de datos

42

Copyright 2013 - Bizagi

Nmero de servidores de Base de datos: 1 instalado en los 3 ambientes (desarrollo, pruebas y produccin).

Nmero de procesadores Procesador HARDWARE PARA ESCRITORIO RAM Disco Duro (HardDisk) Resolucin de pantalla HARDWARE PARA U EQUIPOS MOVILES s u a r i o f i n a l

1 Pentium IV of 2GHz compatible processor or higher 2 GB 10 GB de espacio libre 1024 x 768 o superior Aplicacin nativa en: iOS (iPad, iPhone) Smartphones y tabletas Android Tabletas Windows 8 En otros dispositivos, el acceso es mediante los navegadores. Internet Explorer 9 o superior Versin recomendada: IE 10. Chrome 9 o superior (especialmente recomendado usar Chrome) Safari 5 o superior FireFox 4 o superior Componentes opcionales, usualmente instalados por el navegador mismo: Microsoft Silverlight para la posibilidad de consultas grficas. Plugin de Adobe Flash player para los grficos de los reportes.

Dispositivos

Navegador

SOFTWARE

Componentes Adicionales

Consideraciones
Tenga en cuenta que los requerimientos de hardware para el ambiente de pruebas deben ser lo ms similar posible a las caractersticas y requerimientos que se utilizan en el ambiente de produccin. Esto es importante para poder probar tanto el comportamiento, como el desempeo de los procesos,

Copyright 2013 - Bizagi

43

especialmente en proyectos que: Tienen un nmero significativo de puntos de integracin e interfaces. Tienen un promedio alto de casos nuevos diarios, o promedio de actvidades procesadas diarias. Tienen una cantidad significativa de usuarios trabajando de manera concurrente en Bizagi. Los procesos deben contar con alta disponibilidad. 2.1.1.3 .NET requerimientos para Desarrollo El siguiente artculo enumera los requerimientos de sistema, cuando se configura un ambiente de desarrollo y se utiliza la edicin Bizagi Enterprise .NET. Para mayor informacin acerca de los requerimientos para los ambientes de pruebas o de produccin, consulte Requerimientos de Bizagi Enterprise .NET.

Ambiente de desarrollo
El ambiente de desarrollo en Bizagi representa el entorno en donde se automatizan los procesos. Es el nico ambiente en el cual la implementacin de los procesos se lleva a cabo (etapas de diseo y construccin), donde: el modelo de datos, las formas y las reglas de negocio se definen, al igual que cualquier definicin posible asociada de participantes y puntos de integracin en el proceso, entre otros. Este ambiente se trabaja por medio de Bizagi Studio.

Para este ambiente, Bizagi puede ser configurado para soportar trabajo en equipo (proyectos en colaboracin):

44

Copyright 2013 - Bizagi

Nmero de servidores BPM: 1 Nmero de procesadores 1

HARDWARE

Procesador

2 cores 64-bit Suggested: Xeon dualcore of 2.66GHz 8 GB

RAM

Disco duro (HardDisk) 40 GB de espacio libre Windows Server 2008 R2 32 o 64 bits (recomendado) Windows Server 2008 32 o 64 bits Windows Server 2003 SP1 - 32 bits Windows 8 Windows 7 Ultimate, Enterprise o Professional Editions - 32 o 64 bits Windows Vista Ultimate, Business o Enterprise Editions -

Servidor BPM

SOFTWARE

Sistema operativo

Copyright 2013 - Bizagi

45

Nmero de servidores BPM: 1 32 o 64 bits Servidor web IIS 5 o superior Oracle Data Provider component (Aplica para proyectos que utilizan bases de datos Oracle). Framework de .NET 4.0 (instalado por Bizagi). Dentro de esta instalacin, tambin se incluyen otros componentes como: Visual C++ 2008 Redistribuble2.

Componentes adicionales

Nmero de servidores de Base de datos: 1 Nmero de procesadores 1

HARDWARE

Procesador

2 cores 64-bit Sugerencia Xeon dualcore of 2.66GHz 8 GB

RAM

Disco duro (HardDisk) 80 GB de espacio libre Microsoft SQL Server 2012 Microsoft SQL Server 2008 R2 SP1 o superior Microsoft SQL Server 2008 SP1 o superior Microsoft SQL Server 2005 SP2 o superior Oracle Database 11g R2 (disponible en el Q4 de 2013) Oracle Database 10g R2 Tenga en cuenta que se requiere que la misma

Servidor de Base de Datos

SOFTWARE

Motor de base de datos

46

Copyright 2013 - Bizagi

Nmero de servidores de Base de datos: 1 intercalacin (collation) o set de caracteres, la misma versin y service pack del motor de base de datos sea instalado en los 3 ambientes (desarrollo, pruebas y produccin).

Procesador HARDWARE

Pentium IV of 2GHz compatible processor o superior 4 GB 10 GB de espacio libre 1024 x 768 o superior Windows Server 2008 R2 32 o 64 bits Windows Server 2008 - 32 o 64 bits Windows Server 2003 SP1 32 bits Windows 8 Windows 7 Ultimate, Enterprise, Professional o Home Premium Editions Windows Vista Ultimate, Business, Enterprise o Home Premium Editions Internet Explorer 9 o superior Versin recomendada: IE 10. Chrome 9 o superior (especialmente recomendado usar Chrome) Safari 5 o superior FireFox 4 o superior Oracle Data Provider component (Aplica para proyectos que utilizan bases de datos Oracle).

RAM Disco duro (HardDisk) Resolucin de pantalla

Sistema Operativo Usuario Bizagi Studio

SOFTWARE

Navegador

Componentes adicionales

Copyright 2013 - Bizagi

47

Framework de .NET 4.0 (instalado por Bizagi). Dentro de esta instalacin, tambin se incluyen otros componentes como: Visual C++ 2008 Redistribuble.

Nota Windows XP Professional SP3 es soportado para los usuarios de Bizagi Studio. Sin embargo, el soporte a Windows XP finaliza en Abril 8 de 2014 (dado que Microsoft ha anunciado oficialmente que no dar ms soporte a este sistema operativo a partir de esa fecha).

Consideraciones
Tenga en cuenta que los requerimientos del hardware para el ambiente de desarrollo tambin dependen de otras variables, como por ejemplo: el nmero de usuarios que trabajan en el equipo, la demanda de procesamiento involucrada, entre otras cosas. Por lo tanto, las recomendaciones anteriores corresponden al mnimo hardware necesario, y los requerimientos deben ser complementados con un anlisis ms estricto en torno a las dimensiones de cada proyecto especfico. Para ms informacin sobre la configuracin del ambiente para un equipo de trabajo, consulte Trabajo en equipo en Bizagi.

2.1.2

Enterprise JEE - requerimientos

Consulte la informacin sobre requerimientos de sistema (hardware y software) para el ambiente correspondiente segn se describe en los artculos a continuacin: Requerimientos para el ambiente de produccin en la edicin Enterprise JEE Requerimientos para el ambiente de pruebas en la edicin Enterprise JEE Requerimientos para el ambiente de desarrollo en la edicin Enterprise JEE

48

Copyright 2013 - Bizagi

2.1.2.1

JEE requerimientos para Produccin El siguiente artculo enumera los requerimientos de sistema del ambiente operacional en Bizagi, orientado a un ambiente de produccin configurado en la edicin Bizagi Enterprise JEE. Para mayor informacin acerca de los requerimientos para los ambientes de pruebas o de desarrollo, consulte Requerimientos de Bizagi Enterprise JEE.

Bizagi cuenta con una arquitectura la cual ofrece los componentes necesarios para instalar la solucin en una arquitectura de sistema multi-capa. Dentro de la configuracin de la infraestructura (arquitectura del sistema), puede optar por desplegar la solucin en una arquitectura de 3 de 2 capas. Ambas opciones estn diseadas para trabajar de acuerdo a mejores prcticas de ambientes corporativos. Esto se debe a que Bizagi provee un set de servicios de renderizacin, los cuales le permiten a las aplicaciones cliente desplegar las interfaces de usuario de una manera ptima y de acuerdo al dispositivo desde donde se accede Bizagi (p.e, sea una tableta o dispositivo mvil, o un pc). La diferencia entre estas 2 opciones se basa en la configuracin de una capa de presentacin adicional. Dicha capa se configura en un servidor Web (Apache HTTP Server) de manera que a sta se delega el almacenamiento del contenido esttico Web que se utiliza por el Portal de trabajo de Bizagi (p.e, archivos css, js, imgenes, etc). El beneficio de configurar esta capa adicional est en la posibilidad de separar estos recursos estticos, de forma que el Servidor BPM se dedique nicamente a atender las solicitudes dinmicas (una configuracin distribuda).

Copyright 2013 - Bizagi

49

Ambiente de produccin con capa de presentacin adicional (3 capas)

Para soportar un alto rendimiento y alta disponibilidad de la solucin Bizagi, este escenario involucra ms de un servidor en cada capa (configuracin en clster), para soportar el balanceo de cargas en el servidor BPM y para un esquema de tolerancia a fallos en el servidor de la Base de datos. Servidor de Base de datos (provisto en la capa de acceso de datos). En aplicaciones de misin crtica y para un esquema de alta disponibilidad de la solucin, se recomienda configurar ms de un nodo para la Base de datos, de manera que se cuente con tolerancia a fallos. Las posibilidad de la tolerancia a fallos y su configuracin (p.e, tener un esquema activo-pasivo) es provista por los diferentes motores de Base de datos. Servidor BPM Bizagi (provisto en la capa BPM). En aplicaciones de misin crtica y para un esquema de alta disponibilidad de la solucin, se recomienda configurar ms de un nodo para el Servidor BPM, de manera que se cuente con capacidades de balanceo de cargas. Para el balanceo de cargas, Bizagi soporta tanto balanceadores en hardware o software, y se recomienda el uso de un balanceador de cargas por hardware (p.e F5). Bizagi soporta cualquier algoritmo que se configure para el balanceo de cargas (esta configuracin se realiza de manera independiente), y se requiere que se habilite el uso de sesiones pegajosas (sticky sessions). Bizagi no provee como tal el balanceador de cargas. Servidor Web (provisto en la capa de Presentacin). El Servidor Web no requiere de gran cantidad de recursos (requerimientos de sistema), y no hay necesidad de configurar ms de un nodo para este propsito. Para configurar un Servidor Web, recomendamos utilizar Apache HTTP Server.

50

Copyright 2013 - Bizagi

Nmero de Servidores BPM: 2 (Configuracin de Cluster para el balanceo de carga) Nmero de procesadores Se rvi do r BP M (p ar a ca da no do de l cl s ter ) Procesador HARDWARE RAM Disco duro (HardDisk) Dispositivos adicionales 1 4 cores Sugerido: Quad-core of 3GHz 24 GB Un disco de 80 GB - RAID 1 Un NIC - Dual port 1GB Fuente de poder redundantes Cualquier sistema operativo segn se soporte por los diferentes Servidores de Aplicacion JEE. Algunos son: Solaris en sus versiones 9 y 10 (SO de tipo Unix) Windows Server 2008 R2 - 32 o 64 bits Windows Server 2008 - 32 o 64 bits Windows Server 2003 SP1 - 32 bits Red Hat Enterprise Linux 4.0 o 5.x Ubuntu Server Edition 9.04 o

SOFTWARE

Sistema operativo

Copyright 2013 - Bizagi

51

Nmero de Servidores BPM: 2 (Configuracin de Cluster para el balanceo de carga) WebSphere Application Server V7 Weblogic 11g Version: 10.3.6.0 JBoss 7.1.1

Servidor de Aplicaciones

Nmero de Servidores BPM: 2 (Configuracin de Cluster para tolerancia de fallos) Nmero de procesadores Procesador 1

4 cores Sugerido: Quad-core of 3GHz 16 GB Tres discos de 72 GB RAID 1 Dos NIC - Puerto Dual 1GB Unidad de Backup Oracle Database 11g R2 (disponible en el Q4 de 2013) Oracle Database 10g R2 Microsoft SQL Server 2012 Microsoft SQL Server 2008 R2 SP1 o superior Microsoft SQL Server 2008 SP1 o superior Microsoft SQL Server 2005 SP2 o superior Tenga en cuenta que se requiere que la misma intercalacin (collation) o set de caracteres, la misma versin y service pack del motor de base de datos sea

HARDWARE

RAM Disco duro (HardDisk)

Dispositivos adicionales

Servidor BPM (para cada nodo del clster)

SOFTWARE

Motor de Base de Datos

52

Copyright 2013 - Bizagi

Nmero de Servidores BPM: 2 (Configuracin de Cluster para tolerancia de fallos) instalado en los 3 ambientes (desarrollo, pruebas y produccin).

Nmero de procesadores

Procesador HARDWARE RAM

Procesador compatible Pentium IV de 2GHz o superior 2 GB

Disco duro (HardDisk) 10 GB espacio libre Resolucin de la pantalla 1024 x 768 o superior

Aplicacin nativa en: iOS (iPad, iPhone) HARDWARE PARA EQUIPOS MOVILES Dispositivos En otros dispositivos, el acceso es mediante los navegadores. Internet Explorer 9 o superior Versin recomendada: IE 10. Chrome 9 o superior (especialmente recomendado usar Chrome). Safari 5 o superior FireFox 4 o superior Componentes opcionales, usualmente instalados por el navegador mismo: Microsoft Silverlight para la posibilidad de consultas grficas. Plugin de Adobe Flash player para los grficos de los reportes.

Usuario final

Navegador

SOFTWARE

Componentes adicionales

Copyright 2013 - Bizagi

53

Capa de presentacin Los requerimientos de sistema de una instancia de Apache HTTP Server son principalmente: Contar con 100 MB de espacio libre en disco. Servidor Web SOFTWARE Apache HTTP Server Ms informacin se puede consultar en la documentacin oficial del proyecto Apache HTTP, de acuerdo a la versin y plataforma especfica. Consulte mas informacin acerca de cmo Configurar la capa de presentacin en el servidor Web.

Ambiente de produccin en 2 capas

Para un esquema de alta disponibilidad de la solucin Bizagi, este escenario involucra ms de un servidor en cada capa (configuracin en clster), para soportar el balanceo de cargas en el servidor BPM y para un esquema de tolerancia a fallos en el servidor de la Base de datos. Servidor de Base de datos (provisto en la capa de acceso de datos). En aplicaciones de misin crtica y para un esquema de alta disponibilidad de la solucin, se recomienda configurar ms de un nodo para la Base de datos, de manera que se cuente con tolerancia a fallos. Las posibilidad de la tolerancia a fallos y su configuracin (p.e, tener un esquema activo-pasivo) es provista por los diferentes motores de Base de datos. Servidor BPM Bizagi (provisto en la capa BPM). En aplicaciones de misin crtica y para un esquema de alta disponibilidad de la solucin, se recomienda configurar ms de un nodo para el Servidor BPM, de manera que se cuente con capacidades de balanceo de cargas. Para el balanceo de cargas, Bizagi soporta tanto balanceadores en hardware o software, y se recomienda el uso de un balanceador de cargas por hardware (p.e F5). Bizagi soporta cualquier algoritmo que se configure para el balanceo de cargas (esta configuracin se realiza de manera independiente), y se requiere que se habilite el uso de sesiones pegajosas (sticky sessions). Bizagi no provee como tal el balanceador de cargas.

54

Copyright 2013 - Bizagi

Nmero de Servidores BPM: 2 (Configuracin de Cluster para el balanceo de carga) Nmero de procesadores Procesador Se rvi do r BP M (p ar a ca da no do de l cl s ter ) HARDWARE RAM Disco duro (HardDisk) Dispositivos adicionales 1 4 cores Sugerido: Quad-core of 3GHz 24 GB Un disco de 80 GB - RAID 1 Un NIC - Dual port 1GB Fuente de poder redundantes Cualquier sistema operativo segn se soporte por los diferentes Servidores de Aplicacion JEE. Algunos son: Solaris en sus versiones 9 y 10 (SO de tipo Unix) Windows Server 2008 R2 - 32 o 64 bits Windows Server 2008 - 32 o 64 bits Windows Server 2003 SP1 - 32 bits Red Hat Enterprise Linux 4.0 o 5.x Ubuntu Server Edition 9.04 o WebSphere Application Server V7

Sistema operativo SOFTWARE

Servidor de Aplicaciones

Copyright 2013 - Bizagi

55

Nmero de Servidores BPM: 2 (Configuracin de Cluster para el balanceo de carga) Weblogic 11g Version: 10.3.6.0 JBoss 7.1.1

Nmero de Servidores BPM: 2 (Configuracin de Cluster para tolerancia de fallos) Nmero de procesadores Procesador 1

4 cores Sugerido: Quad-core of 3GHz 16 GB Tres discos de 72 GB RAID 1 Dos NIC - Puerto Dual 1GB Unidad de Backup Oracle Database 11g R2 (disponible en el Q4 de 2013) Oracle Database 10g R2 Microsoft SQL Server 2012 Microsoft SQL Server 2008 R2 SP1 o superior Microsoft SQL Server 2008 SP1 o superior Microsoft SQL Server 2005 SP2 o superior Tenga en cuenta que se requiere que la misma intercalacin (collation) o set de caracteres, la misma versin y service pack del motor de base de datos sea instalado en los 3

HARDWARE

RAM Disco duro (HardDisk)

Dispositivos adicionales

Servidor BPM (para cada nodo del clster)

SOFTWARE

Motor de Base de Datos

56

Copyright 2013 - Bizagi

Nmero de Servidores BPM: 2 (Configuracin de Cluster para tolerancia de fallos) ambientes (desarrollo, pruebas y produccin).

Nmero de procesadores

Procesador HARDWARE RAM

Procesador compatible Pentium IV de 2GHz o superior 2 GB

Disco duro (HardDisk) 10 GB espacio libre Resolucin de la pantalla 1024 x 768 o superior

Aplicacin nativa en: iOS (iPad, iPhone) HARDWARE PARA EQUIPOS MOVILES Dispositivos En otros dispositivos, el acceso es mediante los navegadores. Internet Explorer 9 o superior Versin recomendada: IE 10. Chrome 9 o superior (especialmente recomendado usar Chrome). Safari 5 o superior FireFox 4 o superior Componentes opcionales, usualmente instalados por el navegador mismo: Microsoft Silverlight para la posibilidad de consultas grficas. Plugin de Adobe Flash player para los grficos de los reportes.

Usuario final

Navegador

SOFTWARE

Componentes adicionales

Copyright 2013 - Bizagi

57

Informacin Adicional
Los requerimientos de hardware y software como tal para el Servidor BPM en la edicin Enterprise JEE, dependern de los requerimientos de los fabricantes de los Servidores de Aplicacin soportados, tal como se referencia a continuacin: Servidor de aplicacin WebSphere Application Server V7 Requerimientos del sistema WebSphere Application Server V7 Requirements Oracle Weblogic Requirements JBoss Requirements

Oracle Weblogic 11g Server JBoss 7.1

Tenga en cuenta que los requerimientos del hardware para el ambiente de produccin tambin dependen de otras variables, como por ejemplo: el nmero de usuarios que trabajan de manera concurrente, la demanda de procesamiento, el tamao esperado de los archivos y el crecimiento de la base de datos, entre otras cosas. Por lo tanto, las recomendaciones anteriores corresponden al mnimo hardware necesario, y los requerimientos deben ser complementados con un anlisis ms estricto en torno a las dimensiones de cada proyecto especfico. Por ejemplo, en este anlisis se define el nmero de servidores adicionales que son necesarios para la solucin.

Para ver y obtener una estimacin de las dimensiones de su proyecto usted puede utilizar el Estimador de dimensiones de Bizagi. Descargue casos de estudio con configuraciones de arquitectura del sistema Bizagi, en donde se ilustra la infraestructura utilizada en proyectos corporativos de grande escala.

Ambiente de produccin con acceso a internet

Para proyectos donde los usuarios finales requieren acceder al portal de trabajo va Internet, de manera opcional se puede instalar un servidor Apache para que se configure como un proxy (reverse proxy) en una DMZ, y as permitir el acceso seguro al proyecto Bizagi desde Internet.

58

Copyright 2013 - Bizagi

Consulte mas informacin acerca de como Configurar Bizagi para acceso seguro a Internet (a travs de un proxy reverso en un DMZ).

2.1.2.2

JEE requerimientos para Pruebas El siguiente artculo enumera los requerimientos de sistema, cuando se configura un ambiente de pruebas y se utiliza la edicin Bizagi Enterprise JEE. Para mayor informacin acerca de los requerimientos para los ambientes de produccin o de desarrollo, consulte Requerimientos de Bizagi Enterprise JEE.

Ambiente de pruebas
Este ambiente se utiliza para emular el ambiente de produccin. Permite llevar a cabo las pruebas de aceptacin de usuario orientados a la funcionalidad de los procesos (para verificar que stos se comporten como se espera). Los procesos en un ambiente de pruebas son administrados a travs de Bizagi Management Console.

Copyright 2013 - Bizagi

59

En el ambiente de pruebas, Bizagi puede ser configurado con los siguientes requerimientos mnimos de hardware:

Nmero de servidores BPM: 1 Nmero de procesadores Procesador HARDWARE RAM Disco duro (HardDisk) Servidor BPM 1

2 cores Sugerencia: Xeon dualcore of 2.66GHz 12 GB 60 GB de espacio disponible Cualquier sistema operativo segn se soporte por los diferentes Servidores de Aplicacion JEE.

SOFTWARE

Sistema operativo

Algunos son: Solaris en sus versiones 9 y 10 (SO de tipo Unix) Windows Server 2008 R2 - 32 o 64 bits

60

Copyright 2013 - Bizagi

Nmero de servidores BPM: 1 Windows Server 2008 - 32 o 64 bits Windows Server 2003 SP1 - 32 bits Red Hat Enterprise Linux 4.0 o 5.x Ubuntu Server Edition 9.04 o WebSphere Application Server V7 Weblogic 11g Version: 10.3.6.0 JBoss 7.1.1

Servidor de Aplicaciones

Nmero de servidores de base de datos: 1 Nmero de procesadores Procesador 1

HARDWARE

2 cores Sugerido: Dual-core of 2.66GHz 8 GB

RAM

Disco duro (HardDisk) 80 GB of free space Oracle Database 11g R2 (disponible en el Q4 de 2013) Oracle Database 10g R2 Microsoft SQL Server 2012 Microsoft SQL Server 2008 R2 SP1 o superior Microsoft SQL Server 2008 SP1 o superior Microsoft SQL Server 2005 SP2 o superior Tenga en cuenta que se requiere que la misma intercalacin (collation) o set de caracteres, la

Servidor de base de datos

SOFTWARE

Motor de base de datos

Copyright 2013 - Bizagi

61

Nmero de servidores de base de datos: 1 misma versin y service pack del motor de base de datos sea instalado en los 3 ambientes (desarrollo, pruebas y produccin).

Procesador

Pentium IV of 2GHz compatible Procesador o superior 2 GB 10 GB de espacio libre 1024 x 768 o superior Aplicacin nativa en: iOS (iPad, iPhone)

HARDWARE

RAM Disco duro (HardDisk)

Resolucin de pantalla

HARDWARE PARA EQUIPOS MOVILES Usuario final

Dispositivos

En otros dispositivos, el acceso es mediante los navegadores. Internet Explorer 9 o superior Versin recomendada: IE 10. Chrome 9 o superior (especialmente recomendado usar Chrome). Safari 5 o superior FireFox 4 o superior

SOFTWARE

Navegador

62

Copyright 2013 - Bizagi

Componentes adicionales

Componentes opcionales, usualmente instalados por el navegador mismo: Microsoft Silverlight para la posibilidad de consultas grficas. Plugin de Adobe Flash player para los grficos de los reportes.

Consideraciones
Tenga en cuenta que los requerimientos de hardware para el ambiente de pruebas deben ser lo ms similar posible a las caractersticas y requerimientos que se utilizan en el ambiente de produccin. Esto es importante para poder probar tanto el comportamiento, como el desempeo de los procesos, especialmente en proyectos que: Tienen un nmero significativo de puntos de integracin e interfaces. Tienen un promedio alto de casos nuevos diarios, o promedio de actvidades procesadas diarias. Tienen una cantidad significativa de usuarios trabajando de manera concurrente en Bizagi. Los procesos deben contar con alta disponibilidad. 2.1.2.3 JEE requerimientos para Desarrollo Para esta edicin, el proyecto en etapas de desarrollo se configura y se lleva a cabo en un entorno basado en Windows (a travs del uso de Bizagi Studio). En este ambiente de desarrollo, Bizagi Studio se instala incluyendo un Servidor de Aplicaciones JBoss 7.1.1, el cual provee una plataforma de JEE directa para probar la ejecucin de los flujos de proceso de una manera gil. Cuando se realiza el paso del proyecto al ambiente de produccin (para la ejecucin de los procesos en el servidor BPM hacia los usuarios finales), Bizagi soporta varias posibilidades de sistemas operativos (de acuerdo a las especificaciones de hardware y software de los mismos Servidores de Aplicacin JEE).

El siguiente artculo enumera los requerimientos de sistema, cuando se configura un ambiente de desarrollo y se utiliza la edicin Bizagi Enterprise JEE. Para mayor informacin acerca de los requerimientos para los ambientes de pruebas o de produccin, consulte Requerimientos de Bizagi Enterprise JEE.

Copyright 2013 - Bizagi

63

Ambiente de desarrollo
El ambiente de desarrollo en Bizagi representa el entorno en donde se automatizan los procesos. Es el nico ambiente en el cual la implementacin de los procesos se lleva a cabo (etapas de diseo y construccin), donde: el modelo de datos, las formas y las reglas de negocio se definen, al igual que cualquier definicin posible asociada de participantes y puntos de integracin en el proceso, entre otros. Este ambiente se trabaja por medio de Bizagi Studio en un ambiente de Windows.

Para este ambiente, Bizagi puede ser configurado para soportar trabajo en equipo (proyectos en colaboracin):

Nmero de servidores BPM: 1 Servidor BPM HARDWARE Nmero de procesadores 1

64

Copyright 2013 - Bizagi

Nmero de servidores BPM: 1 2 cores Sugerido: Dual-core de 2.66GHz 8 GB

Procesador

RAM

Disco duro (HardDisk) 40 GB de espacio libre Windows Server 2008 R2 32 o 64 bits (recomendado) Windows Server 2008 32 o 64 bits Windows Server 2003 SP1 - 32 o 64 bits Windows 8 Windows Vista Ultimate, Business o Enterprise Editions 32 o 64 bits Windows 7 Ultimate, Enterprise o Professional Editions - 32 o 64 bits Esta edicin incluye la instalacin de un JBoss 7.1.1, as como el JDK 6 update 31. Servidor de Aplicaciones Puede optar por montar tambin Servidores: WebSphere Application Server V7 Weblogic 11g (10.3.6.0) Oracle Data Provider component (aplica para proyectos que utilizan bases de datos Oracle). Framework de .NET 4.0 (instalado por Bizagi). Dentro de esta instalacin, tambin se incluyen otros componentes

Sistema operativos

SOFTWARE

Componentes adicionales

Copyright 2013 - Bizagi

65

Nmero de servidores BPM: 1 como: Visual C++ 2008 Redistribuble.

Nmero de servidores de base de datos: 1 Nmero de procesadores 1

HARDWARE

Procesador

2 cores Sugerencia: Dual-core of 2.66GHz 8 GB

RAM

Disco duro (HardDisk) 80 GB de espacio libre Oracle Database 11g R2 (disponible en el Q4 de 2013) Oracle Database 10g R2 Microsoft SQL Server 2012 Microsoft SQL Server 2008 R2 SP1 o superior Microsoft SQL Server 2008 SP1 o superior Microsoft SQL Server 2005 SP2 o superior

Servidor de base de datos

SOFTWARE

Motor de base de datos

Procesador HARDWARE Usuario Bizagi Studio

Pentium IV of 2GHz compatible processor o superior 4 GB 10 GB de espacio libre 1024 x 768 o superior Windows Server 2008 R2 32 o 64 bits Windows Server 2008 - 32 o 64 bits

RAM Disco duro (HardDisk) Resolucin de pantalla

SOFTWARE

Sistema Operativo

66

Copyright 2013 - Bizagi

Windows Server 2003 SP1 32 o 64 bits Windows 8 Windows 7 Ultimate, Enterprise, Professional o Home Premium Editions Windows Vista Ultimate, Business, Enterprise o Home Premium Editions Internet Explorer 9 o superior Versin recomendada: IE 10. Chrome 9 o superior (especialmente recomendado usar Chrome). Safari 5 o superior FireFox 4 o superior Oracle Data Provider component (Aplica para proyectos que utilizan bases de datos Oracle). Framework de .NET 4.0 (instalado por Bizagi). Dentro de esta instalacin, tambin se incluyen otros componentes como: Visual C++ 2008 Redistribuble.

Navegador

Componentes adicionales

Nota Windows XP Professional SP3 es soportado para los usuarios de Bizagi Studio. Sin embargo, el soporte a Windows XP finaliza en Abril 8 de 2014 (dado que Microsoft ha anunciado oficialmente que no dar ms soporte a este sistema operativo a partir de esa fecha).

Consideraciones
Tenga en cuenta que los requerimientos del hardware para el ambiente de desarrollo tambin dependen de otras variables, como por ejemplo: el nmero de usuarios que trabajan en el equipo, la demanda de procesamiento involucrada, entre otras cosas. Por lo tanto, las recomendaciones anteriores corresponden al mnimo hardware necesario, y los requerimientos deben ser complementados con un anlisis ms estricto en torno a las dimensiones de cada proyecto especfico. Para ms informacin sobre la configuracin del ambiente para un equipo de trabajo, consulte Trabajo en equipo en Bizagi.

Copyright 2013 - Bizagi

67

2.1.3

Bizagi Xpress - requerimientos

Consulte la informacin sobre requerimientos de sistema (hardware y software) para el ambiente correspondiente segn se describe en los artculos a continuacin: Requerimientos para el ambiente de produccin en Bizagi Xpress Requerimientos para el ambiente de pruebas en Bizagi Xpress Requerimientos para el ambiente de desarrollo en Bizagi Xpress

2.1.3.1

Xpress requerimientos para Produccin El siguiente artculo enumera los requerimientos de sistema del ambiente operacional en Bizagi, orientado a un ambiente de produccin configurado en la edicin Bizagi Xpress. Para mayor informacin acerca de los requerimientos para los ambientes de pruebas o de desarrollo, consulte Requerimientos de Bizagi Xpress.

68

Copyright 2013 - Bizagi

Ambiente de produccin
En el ambiente de produccin, la configuracin de Bizagi contempla los siguientes requerimientos mnimos:

S e r v i d o r B P M

HARDWARE

SOFTWARE

Nmero de servidores BPM: 1 Nmero de procesadores 1 2 cores Procesador Sugerido: Xeon dual-core of 3GHz RAM 8 GB Disco duro (Disco duro (HardDisk)) 40 GB de espacio libre Windows Server 2008 R2 64 bits Software Operating System (recomendado) Windows Server 2008 64 bits Web Server IIS 5.0 o superior Framework de .NET 4.0 (instalado por Bizagi). Dentro de esta instalacin, Componentes adicionales tambin se incluyen otros componentes como: Visual C++ 2008 Redistribuble. Nmero de servidores de base de datos: 1

Servidor de base

HARDWARE

Nmero de procesadores

Copyright 2013 - Bizagi

69

Nmero de servidores de base de datos: 1 Procesador 2 cores Suggested: Xeon dual-core of 2,66GHz 8 GB 80 GB de espacio libre Microsoft SQL Server Microsoft SQL Server R2 SP1 o superior Microsoft SQL Server SP1 o superior Microsoft SQL Server SP2 o superior SOFTWARE Motor de base de datos 2012 2008 2008 2005

RAM Disco duro (HardDisk)

de datos

Tenga en cuenta que se requiere que la misma intercalacin (collation), la misma versin y service pack del motor de base de datos sea instalado en los 3 ambientes (desarrollo, pruebas y produccin).

Procesador HARDWARE U s u a r i HARDWARE PARA o EQUIPOS MOVILES f i n a l SOFTWARE RAM Disco duro (HardDisk) Resolucin de pantalla

Pentium IV of 2GHz compatible Procesador o superior 2 GB 10 GB de espacio libre 1024 x 768 o superior Aplicacin nativa en: iOS (iPad, iPhone) Smartphones y tabletas Android Tabletas Windows 8 En otros dispositivos, el acceso es mediante los navegadores. Internet Explorer 9 o superior Versin recomendada: IE 10. Chrome 9 o superior (especialmente recomendado usar Chrome) Safari 5 o superior FireFox 4 o superior

Dispositivos

Navegador

70

Copyright 2013 - Bizagi

Componentes adicionales

Componentes opcionales, usualmente instalados por el navegador mismo: Microsoft Silverlight para la posibilidad de consultas grficas. Plugin de Adobe Flash player para los grficos de los reportes.

Informacin adicional
Tenga en cuenta que los requerimientos del hardware para el ambiente de produccin tambin dependen de otras variables, como por ejemplo: el nmero de usuarios que trabajan de manera concurrente, la demanda de procesamiento, el tamao esperado de los archivos y el crecimiento de la base de datos, entre otras cosas. Por lo tanto, las recomendaciones anteriores corresponden al mnimo hardware necesario, y los requerimientos deben ser complementados con un anlisis ms estricto en torno a las dimensiones de cada proyecto especfico.

Ambiente de produccin con acceso a Internet

Para proyectos donde los usuarios finales requieren acceder al portal de trabajo va Internet, de manera opcional se puede instalar un servidor Apache para que se configure como un proxy (reverse proxy) en una DMZ, y as permitir el acceso seguro al proyecto Bizagi desde Internet.

Vea ms informacin acerca de Cmo configurar Bizagi para su acceso seguro desde Internet (a travs de un proxy inverso en una DMZ). 2.1.3.2 Xpress requerimientos para Pruebas El siguiente artculo enumera los requerimientos de sistema, cuando se configura un ambiente de pruebas y se utiliza la edicin Bizagi Xpress. Para mayor informacin acerca de los requerimientos para los ambientes de produccin o de desarrollo, consulte Requerimientos de Bizagi Xpress.

Copyright 2013 - Bizagi

71

Ambiente de pruebas
Este ambiente se utiliza para emular el ambiente de produccin. Permite llevar a cabo las pruebas de aceptacin de usuario orientados a la funcionalidad de los procesos (para verificar que stos se comporten como se espera). Los procesos en un ambiente de pruebas son administrados a travs de Bizagi Management Console. En el ambiente de pruebas, Bizagi puede ser configurado con los siguientes requerimientos mnimos de hardware:

Nmero de servidores BPM: 1 Nmero de procesadores Procesador HARDWARE RAM Servidor BPM Disco duro (HardDisk) 1 2 cores Suggested: Xeon dual-core of 2.66GHz 8 GB 40 GB de espacio libre Windows Server 2008 R2 32 o 64 bits (recomendado) Windows Server 2008 32 o 64 bits IIS 5.0 o superior

Sistema operativo SOFTWARE Servidor web

72

Copyright 2013 - Bizagi

Nmero de servidores de base de datos: 1 Nmero de procesadores 1 2 cores Suggested: Xeon dual-core of 2.66GHz 8 GB 80 GB de espacio libre Microsoft SQL Server Microsoft SQL Server R2 SP1 o superior Microsoft SQL Server SP1 o superior Microsoft SQL Server SP2 o superior SOFTWARE Motor de base de datos 2012 2008 2008 2005

Procesador HARDWARE RAM Disco duro (HardDisk)

Servidor de Base de datos

Tenga en cuenta que se requiere que la misma intercalacin (collation), la misma versin y service pack del motor de base de datos sea instalado en los 3 ambientes (desarrollo, pruebas y produccin).

Procesador HARDW ARE RAM Disco duro (HardDisk) Resolucin de pantalla HARDW ARE PARA Dispositivos EQUIPOS MOVILES

Pentium IV of 2GHz compatible Procesador o superior 2 GB 10 GB de espacio libre 1024 x 768 o superior Aplicacin nativa en: iOS (iPad, iPhone) Smartphones y tabletas Android Tabletas Windows 8 En otros dispositivos, el acceso es mediante los navegadores. Internet Explorer 9 o superior Versin recomendada: IE 10. Chrome 9 o superior (especialmente recomendado usar Chrome)

Usuario final

SOFTWA Navegador RE

Copyright 2013 - Bizagi

73

Safari 5 o superior FireFox 4 o superior Componentes opcionales, usualmente instalados por el navegador mismo: Microsoft Silverlight para la posibilidad de consultas grficas. Plugin de Adobe Flash player para los grficos de los reportes.

Componentes adicionales

Consideraciones
Note que usted podra utilizar el mismo servidor usado en el ambiente de desarrollo para el ambiente de pruebas, ya que no habran restricciones para esto. Sin embargo, esta no es la configuracin recomendada, y adicionalmente, las caractersticas y requerimientos de los servidores del ambiente de pruebas deben ser lo ms similar posible a las caractersticas y requerimientos que se utilizan en el ambiente de produccin. Esto es importante para poder probar tanto el comportamiento, como el desempeo de los procesos, especialmente en proyectos que: Tienen un nmero significativo de puntos de integracin e interfaces. Tienen un promedio alto de casos nuevos diarios, o promedio de actvidades procesadas diarias. 2.1.3.3 Xpress requerimientos para Desarrollo El siguiente artculo enumera los requerimientos de sistema, cuando se configura un ambiente de desarrollo y se utiliza la edicin Bizagi Xpress. Para mayor informacin acerca de los requerimientos para los ambientes de pruebas o de produccin, consulte Requerimientos de Bizagi Xpress.

Ambiente de desarrollo
El ambiente de desarrollo en Bizagi representa el entorno en donde se automatizan los procesos. Es el nico ambiente en el cual la implementacin de los procesos se lleva a cabo (etapas de diseo y construccin), donde: el modelo de datos, las formas y las reglas de negocio se definen, al igual que

74

Copyright 2013 - Bizagi

cualquier definicin posible asociada de participantes y puntos de integracin en el proceso, entre otros. Este ambiente se trabaja por medio de Bizagi Studio.

Para este ambiente, Bizagi puede ser configurado para soportar trabajo en equipo (proyectos en colaboracin):

Nmero de servidores BPM: 1 Nmero de procesadores Procesador HARDWARE B P M S e r v e r RAM Disco duro (HardDisk) 1 2 cores Suggested: Xeon dual-core of 2.66GHz 8 GB 40 GB de espacio libre Windows Server 2008 R2 32 o 64 bits (recomendado) Windows Server 2008 32 o 64 bits Windows Server 2003 SP1 - 32 bits Windows 8 Windows 7 Ultimate, Enterprise, Professional o Home Premium Editions Windows Vista Ultimate, Business, Enterprise o Home Premium Editions

SOFTWARE

Sistema operativo

Copyright 2013 - Bizagi

75

Nmero de servidores BPM: 1 Servidor web IIS 5.0 o superior Framework de .NET 4.0 (instalado por Bizagi). Dentro de esta instalacin, tambin se incluyen otros componentes como: Visual C++ 2008 Redistribuble.

Componentes adicionales

Nmero de servidores de base de datos: 1 Nmero de procesadores 1 2 cores Suggested: Xeon dual-core of 2.66GHz 8 GB 80 GB of free space Microsoft SQL Server Microsoft SQL Server R2 SP1 o superior Microsoft SQL Server SP1 o superior Microsoft SQL Server SP2 o superior 2012 2008 2008 2005

Procesador HARDWARE RAM Disco duro (HardDisk)

Servidor de Base de Datos

SOFTWARE

Motor de base de datos

En caso de no contar con ninguna de estas opciones, Bizagi permite instalar una instancia de SQL Server Express 2008 SP3.

Procesador Usuario Bizagi Studio HARDWARE RAM Disco duro (HardDisk) Resolucin de pantalla

Pentium IV of 2GHz compatible processor o superior 4 GB 10 GB de espacio libre 1024 x 768 o superior

76

Copyright 2013 - Bizagi

Sistema Operativo

Windows Server 2008 R2 - 32 o 64 bits Windows Server 2008 - 32 o 64 bits Windows Server 2003 SP1 - 32 bits Windows 8 Windows 7 Ultimate, Enterprise, Professional o Home Premium Editions Windows Vista Ultimate, Business, Enterprise o Home Premium Editions Internet Explorer 9 o superior Versin recomendada: IE 10. Chrome 9 o superior (especialmente recomendado usar Chrome) Safari 5 o superior FireFox 4 o superior Framework de .NET 4.0 (instalado por Bizagi). Dentro de esta instalacin, tambin se incluyen otros componentes como: Visual C++ 2008 Redistribuble.

SOFTWARE

Navegador

Componentes adicionales

Nota Windows XP Professional SP3 es soportado para los usuarios de Bizagi Studio. Sin embargo, el soporte a Windows XP finaliza en Abril 8 de 2014 (dado que Microsoft ha anunciado oficialmente que no dar ms soporte a este sistema operativo a partir de esa fecha).

Consideraciones
Tenga en cuenta que los requerimientos del hardware para el ambiente de desarrollo tambin dependen de otras variables, como por ejemplo: el nmero de usuarios que trabajan en el equipo, la demanda de procesamiento involucrada, entre otras cosas. Por lo tanto, las recomendaciones anteriores corresponden al mnimo hardware necesario, y los requerimientos deben ser complementados con un anlisis ms estricto en torno a las dimensiones de cada proyecto especfico. Para ms informacin sobre la configuracin del ambiente para un equipo de trabajo, consulte Trabajo en equipo en Bizagi.

Copyright 2013 - Bizagi

77

2.2

Instalacin
Los siguientes artculos presentan la gua de instalacin de Bizagi en las diferentes ediciones. Instalacin de Bizagi Enterprise .NET Instalacin de Bizagi Enterprise JEE Instalacin de Bizagi Xpress

2.2.1

Enterprise .NET - instalacin

Antes de empezar con la instalacin de la edicin Enterprise .NET de Bizagi revise los requerimientos del sistema. El instalador esta disponible para descarga directa desde nuestra web oficial. Note que la Edicin Enterprise .NET de Bizagi tiene instaladores disponibles para las plataformas de 64-bit y 32-bit. Para ambientes corporativos y un mejor rendimiento, recomendamos instalar la versin que trabaja nativamente con 64 bits.

Tenga en cuenta que para poder instalar Bizagi con soporte nativo de 64-bit, usted debe tener instalado el sistema operativo en 64-bit.

Procedimiento
1. Ejecute el instalador
Ejecute B izag iEn terp rise-x 64.ex e (o B izag iEn terp rise.ex e) para comenzar el proceso de instalacin. El instalador debe ser ejecutado con una cuenta con derechos de administrador (miembro del grupo de Administradores del servidor).

78

Copyright 2013 - Bizagi

Seleccione el idioma para la instalacin (ingls o espaol)

El asistente del instalador aparecer:

Copyright 2013 - Bizagi

79

2. Proceda con la instalacin

Cuando la ventana de Bienvenida del instalador se abra, haga clic en Sig u ien te.

80

Copyright 2013 - Bizagi

3. Lea el acuerdo de licencia

Acepte el acuerdo de la licencia de Bizagi y haga clic en Sig u ien te.

Copyright 2013 - Bizagi

81

4. Seleccione la Base de Datos a utilizar

La instalacin deterctar si ya hay una instancia de Servidor SQL instalada. Si este no es el caso, usted puede seleccionar la opcin para incluir una intalacin de SQL Server Express 2008 Service pack 3 (seleccionando " In stalar SQ L Serv er Ex p ress 2008 SP 3"). Nota Cuando se instale el SQL Server Express 2008 SP3 incluido en la instalacin, las credenciales por defecto para acceder el servidor son: LOGIN: sa PASSWORD: B izag i10GO

82

Copyright 2013 - Bizagi

Si usted prefiere no incluir esta instalacin de SQL Server o si usted ya posee una intancia de este, puede seleccionar la opcin " Y a ten g o u n Serv id o r SQ L". Con dicha opcin, es necesario que provea el Nombre de Usuario y contrasea (autenticacin SQL Server) para esta conexin, en la ventana que emerger.

Copyright 2013 - Bizagi

83

Despus de ingresar la informacin, d clic en Lo g in para verificar la conexin. Una ventana se muestra para informar el xito de la misma. D clic en O K para continuar.

Ntese que tambin puede optar por obviar este paso en la instalacin (por ejemplo, si utilizar una Base de datos Oracle). Tenga en cuenta que de igual manera requerir la correcta configuracin de la Base de datos, despus cuando vaya a crear el proyecto en Bizagi.

5. Ingrese la informacin de usuario

Ingrese el nombre de usuario (User Name) y el nombre de la compaa (Company Nace) para la instalacin. Clic en Sig u ien te.

84

Copyright 2013 - Bizagi

6. Seleccione el Ambiente de Instalacin

En el Tip o d e Co n fig u raci n seleccione la instalacion de componentes para Ambiente de desarrollo o Ambiente de pruebas/produccin de acuerdo a sus necesaidades. Seleccione d esarro llo (A m b ien te d e A u to ra) si la instalacin se utilizar para modelar y automatizar Procesos, donde ser necesario utilizar Bizagi Studio. De lo contrario, seleccione A m b ien tes d e p ro d u cci n o p ru eb as para instalar el Servidor BPM de Bizagi y la Consola de Administracin de Bizagi (pero no Bizagi Studio). Luego d clic en Sig u ien te para continuar.

Copyright 2013 - Bizagi

85

7. Seleccione la ruta de instalacin

Haga clic en Sig u ien te si usted desea instalar Bizagi en la carpeta de destino por defecto ("C:\Program Files\..."). De lo contrario, para seleccionar una ubicacin diferente, d clic en Ex am in ar y seleccione el directorio deseado.

86

Copyright 2013 - Bizagi

8. Revise las preferencias

En la siguiente ventana, revise la configuracin si no desea que Bizagi le notifique de manera automtica cuando hay una nueva versin disponible. Para que Bizagi revise si hay nueva versin y le notifique, asegrese de tener marcada la casilla Co m p ro b ar si h ay actu alizacio n es. Haga clic en Sig u ien te.

Copyright 2013 - Bizagi

87

9. Inicie el proceso de instalacin

En la siguiente ventana, haga clic en In stalar para comenzar con la instalacin.

88

Copyright 2013 - Bizagi

Nota Bizagi instalar los componentes requeridos como: Framework 4.0 de .NET y Visual C++ 2008 Redistributable, si no se encuentran instalados previamente.

Copyright 2013 - Bizagi

89

10. Finalice la instalacin

La instalacin de Bizagi comenzar:

90

Copyright 2013 - Bizagi

La siguiente ventana aparecer cuando la instalacin haya terminado.

Copyright 2013 - Bizagi

91

Clic en el botn F in alizar. Nota: Tenga en cuenta que para la creacin de proyecto se requiere tener un motor de base de datos instalado (SQL Server o Oracle) y IIS como servidor web.

Empezar a utilizar la edicin Enterprise .NET de Bizagi

Para empezar la automatizacin de su proceso (crear un nuevo proyecto en Bizagi), utilice Bizagi Studio Enterprise para ambientes de desarrollo. Usted puede empezar a utilizar Bizagi Enterprise .NET dando clic en el cono de Bizagi Studio Enterprise (acceso rpido) como se muestra a continuacin.

92

Copyright 2013 - Bizagi

Tambin se puede ejecutar Bizagi Studio navegando por el men de Inicio.

Para administrar un proyecto de Bizagi Enterprise .NET en un ambiente de pruebas o produccin (si usted instalo Bizagi en ambientes de pruebas o desarrollo), utilice el Bizagi Management Console.

Copyright 2013 - Bizagi

93

Para ms informacin visite Bizagi Management Console.

2.2.2

Enterprise JEE - instalacin

Antes de empezar con la instalacin de la edicin Enterprise JEE de Bizagi revise los requerimientos del sistema. El instalador esta disponible para descarga directa desde nuestra web oficial.

Procedimiento
1. Ejecute el instalador
Para instalar Bizagi se requiere que el instalador sea ejecutado con una cuenta con derechos de administrador (miembro del grupo de Administradores del servidor). Ejecute B izag iEn terp riseJEE.ex e para comenzar el proceso de instalacin.

94

Copyright 2013 - Bizagi

Seleccione el idioma para la instalacin (ingls o espaol)

El asistente del instalador aparecer:

Copyright 2013 - Bizagi

95

2. Proceda con la instalacin

Cuando la ventana de Bienvenida del instalador de Bizagi Enterprise JEE se abra, haga clic

en Sig u ien te.

96

Copyright 2013 - Bizagi

3. Lea el acuerdo de licencia

Acepte el acuerdo de la licencia de Bizagi y haga clic en Sig u ien te.

Copyright 2013 - Bizagi

97

4. Seleccione la Base de Datos a utilizar

La instalacin deterctar si ya hay una instancia de Servidor SQL instalada. Si este no es el caso, usted puede seleccionar la opcin para incluir una intalacin de SQL Server Express 2008 Service pack 3 (seleccionando " In stalar SQ L Serv er Ex p ress 2008 SP 3"). Nota Cuando se instale el SQL Server Express 2008 SP3 incluido en la instalacin, las credenciales por defecto para acceder el servidor son: LOGIN: sa PASSWORD: B izag i10GO

98

Copyright 2013 - Bizagi

Si usted prefiere no incluir esta instalacin de SQL Server o si usted ya posee una intancia de este, puede seleccionar la opcin " Y a ten g o u n Serv id o r SQ L". Con dicha opcin, es necesario que provea el Nombre de Usuario y contrasea (autenticacin SQL Server) para esta conexin, en la ventana que emerger.

Copyright 2013 - Bizagi

99

Despus de ingresar la informacin, d clic en Lo g in para verificar la conexin. Una ventana se muestra para informar el xito de la misma. D clic en O K para continuar.

Ntese que tambin puede optar por obviar este paso en la instalacin (por ejemplo, si utilizar una Base de datos Oracle). Tenga en cuenta que de igual manera requerir la correcta configuracin de la Base de datos, despus cuando vaya a crear el proyecto en Bizagi.

5. Ingrese la informacin de usuario

Ingrese el nombre de usuario (User Name) y el nombre de la compaa (Company Nace) para la

100

Copyright 2013 - Bizagi

instalacin. Clic en siguiente.

5. Escoja el puerto del servicio para JBoss

Ingrese un nmero de puerto en el cual el JBoss 7.1.1 Application server instalado, expondr el servicio (para atender las solicitudes http). Por defecto, el JBoss instalado subir en el puerto 8080. Puede optar por cambiar este puerto, o dejarlo en el puerto por defecto (especialmente si usted no tiene la seguridad sobre esta configuracin).

Copyright 2013 - Bizagi

101

6. Seleccione la ruta de instalacin

Haga clic en Sig u ien te si la carpeta de destino por defecto ("C:\Program Files (x86)\BizAgi\BizAgi Enterprise")., de lo contrario, haga clic en Ex am in ar (Browse) y seleccione el directorio deseado. Luego haga clic en Sig u ien te.

102

Copyright 2013 - Bizagi

7. Inicie el proceso de instalacin

En la siguiente ventana, haga clic en In stalar para comenzar con la instalacin.

Copyright 2013 - Bizagi

103

Nota Bizagi instalar los componentes requeridos tales como: Java SDK 6.31, JBoss 7.1.1 Application Server, el framework 4.0 de .NET y Visual C++ 2008 Redistributable, si no se encuentran instalados previamente. Si lo desea, puede instalar y utilizar otro Servidor de Aplicaciones JEE en su ambiente de desarrollo (diferente al JBoss que viene por defecto), como por ejemplo WebSphere o Weblogic. El progreso de la instalacin se vera de la siguiente forma:

104

Copyright 2013 - Bizagi

8. Finalice la instalacin
La siguiente ventana aparecer cuando la instalacin haya terminado.

Copyright 2013 - Bizagi

105

Clic en el botn F in alizar.

Empezar a utilizar la edicin Enterprise JEE de Bizagi

Para empezar la automatizacin de su proceso (crear un nuevo proyecto en Bizagi), utilice Bizagi Studio Enterprise para ambientes de desarrollo. Usted puede empezar a utilizar Bizagi Enterprise JEE dando clic en el cono de Bizagi Studio Enterprise (acceso rpido) como se muestra a continuacin.

106

Copyright 2013 - Bizagi

Tambin se puede ejecutar Bizagi Studio navegando por el men de Inicio.

Para administrar un proyecto de Bizagi Enterprise en un ambiente de pruebas o produccin (si usted instalo Bizagi en ambientes de pruebas o produccin), utilice el Bizagi Management Console.

Copyright 2013 - Bizagi

107

Para ms informacin visite Bizagi Management Console. Para hacer un deployment del proyecto hacia un servidor de aplicaciones JEE diferente a JBoss (por ejemplo, WebSphere or Weblogic), o para hacer deployment del proyecto en un ambiente diferente (a pruebas o produccin), se debe seguir el procedimiento indicado en Deployment de Bizagi a un servidor de aplicaciones JEE.

2.2.3

Bizagi Xpress - instalacin

Antes de empezar con la instalacin de la edicin Enterprise Xpress de Bizagi revise los requerimientos del sistema. El instalador esta disponible para descarga directa desde nuestra web oficial.

Procedimiento
1. Ejecute el instalador
Ejecute B izag iXp ressex e para comenzar el proceso de instalacin. El instalador debe ser ejecutado con una cuenta con derechos de administrador (miembro del grupo de Administradores del servidor).

108

Copyright 2013 - Bizagi

Seleccione el idioma para la instalacin (ingls o espaol)

El asistente del instalador aparecer:

2. Proceda con la instalacin

Cuando la ventana de Bienvenida del instalador se abra, haga clic en Sig u ien te.

Copyright 2013 - Bizagi

109

3. Lea el acuerdo de licencia

Acepte el acuerdo de la licencia de Bizagi y haga clic en Sig u ien te.

110

Copyright 2013 - Bizagi

4. Seleccione la base de datos a utilizar

La instalacin deterctar si ya hay una instancia de Servidor SQL instalada. Si este no es el caso, usted puede seleccionar la opcin para incluir una intalacin de SQL Server Express 2008 Service pack 3 (seleccionando " In stalar SQ L Serv er Ex p ress 2008 SP 3"). Nota Cuando se instale el SQL Server Express 2008 SP3 incluido en la instalacin, las credenciales por defecto para acceder el servidor son: LOGIN: sa PASSWORD: B izag i10GO

Copyright 2013 - Bizagi

111

Si usted prefiere no incluir esta instalacin de SQL Server o si usted ya posee una intancia de este, puede seleccionar la opcin " Verificar acceso a u n a b ase d e d ato s SQ L Serv er y a in stalad a". Con dicha opcin, es necesario que provea el Nombre de Usuario y contrasea (autenticacin SQL Server) para esta conexin, en la ventana que emerger.

112

Copyright 2013 - Bizagi

Despus de ingresar la informacin, d clic en Lo g in para verificar la conexin. Una ventana se muestra para informar el xito de la misma. D clic en O K para continuar.

5. Ingrese la informacin de usuario

Ingrese el nombre de usuario (User Name) y el nombre de la compaa (Company Nace) para la instalacin. Clic en Sig u ien te.

Copyright 2013 - Bizagi

113

6. Seleccione el Ambiente de Instalacin

En el Tip o d e Co n fig u raci n seleccione la instalacion de componentes para Ambiente de desarrollo o Ambiente de pruebas/produccin de acuerdo a sus necesaidades. Seleccione d esarro llo (A m b ien te d e A u to ra) si la instalacin se utilizar para modelar y automatizar Procesos, donde ser necesario utilizar Bizagi Studio. De lo contrario, seleccione A m b ien tes d e p ro d u cci n o p ru eb as para instalar el Servidor BPM de Bizagi y la Consola de Administracin de Bizagi (pero no Bizagi Studio). Luego d clic en Sig u ien te para continuar.

114

Copyright 2013 - Bizagi

7. Seleccione la ruta de instalacin

Haga clic en Sig u ien te si usted desea instalar Bizagi en la carpeta de destino por defecto ("C:\Program Files\..."). De lo contrario, para seleccionar una ubicacin diferente, d clic en Ex am in ar y seleccione el directorio deseado.

Copyright 2013 - Bizagi

115

8. Revise las preferencias

En la siguiente ventana, revise la configuracin si no desea que Bizagi le notifique de manera automtica cuando hay una nueva versin disponible. Para que Bizagi revise si hay nueva versin y le notifique, asegrese de tener marcada la casilla Co m p ro b ar si h ay actu alizacio n es. Haga clic en Sig u ien te.

116

Copyright 2013 - Bizagi

9. Inicie el proceso de instalacin

En la siguiente ventana, haga clic en In stalar para comenzar con la instalacin.

Copyright 2013 - Bizagi

117

Nota Bizagi instalar los componentes requeridos como: Framework 4.0 de .NET y Visual C++ 2008 Redistributable, si no se encuentran instalados previamente.

118

Copyright 2013 - Bizagi

10. Finalice la instalacin

La instalacin de Bizagi comenzar:

Copyright 2013 - Bizagi

119

La siguiente ventana aparecer cuando la instalacin haya terminado.

120

Copyright 2013 - Bizagi

Clic en el botn F in alizar.

Empezar a utilizar la edicin Xpress de Bizagi

Para empezar la automatizacin de su proceso (crear un nuevo proyecto en Bizagi), utilice Bizagi Studio Enterprise para ambientes de desarrollo. Usted puede empezar a utilizar Bizagi Xpress dando clic en el cono de Bizagi Studio (acceso rpido) como se muestra a continuacin.

Copyright 2013 - Bizagi

121

Tambin se puede ejecutar Bizagi Studio navegando por el men de Inicio.

Para administrar un proyecto de Bizagi en un ambiente de pruebas o produccin (si usted instalo

122

Copyright 2013 - Bizagi

Bizagi en ambientes de pruebas o produccin), utilice el Bizagi Management Console. Para ms informacin visite Bizagi Management Console.

2.3

Configurar el trabajo en equipo Informacin General

Con la Suite BPM de Bizagi usted puede tener un am b ien te co lab o rativ o donde junto con su equipo de trabajo podr trabajar simultneamente en sus procesos. Es muy comn que los usuarios de Bizagi descarguen la Suite BPM y comiencen a construir sus procesos en un computador personal como un laptop o un notebook. Luego, necesitan un grupo de personas para trabajar con l, como equipo, en el mismo modelo. Bizagi le permite crear un ambiente de desarrollo en un servidor, de esta manera varios usuarios pueden trabajar con Bizagi Studio en sus propios computadores accediendo al proyecto montado en el servidor. Todos pueden trabajar en el mismo modelo al mismo tiempo.

Adicionalmente, Bizagi ayuda a los usuarios a ser coordinados y evitar conflictos cuando trabajen en un mismo diagrama de proceso, utilizando los controles Ch eck-in y Ch eck-o u t. Cuando un usuario esta editando un diagrama de procesos, en el primer paso del asistente, est ser checked-out solamente para ese usuario, es decir, solo se permitir la edicin para el usuario actual y los dems sern bloqueados para editar el diagrama. El resto de pasos del asistente de procesos de Bizagi estarn disponibles para realizar cambio al mismo tiempo, sin ninguna restriccin. Nosotros recomendamos estables reglas con su equipo de desarrollo para evitar sobrescribir el trabajo de otros.

Copyright 2013 - Bizagi

123

Los equipos de trabaja pueden tener varios proyectos en un mismo servidor y trabajar en ellos de forma independiente. Tenga en cuenta que con la edicin Enterprise JEE solamente UN proyecto estar disponible para ser mostrado en servidor de aplicacin. Si usted esta trabajando en el mismo servidor con ms de un proyecto, el Portal de trabajo solo mostrar uno a la vez.

Cmo configurar equipos de trabajo?

El primer paso para lograr el desarrollo colaborativo es pasar el proyecto a un servidor de desarrollo que pueda ser accesible por otros usuarios. Recordemos que el ambiente est constituido por: Base de datos (repositorio de proceso) Portal de Trabajo (Aplicacin web utilizando IIS o Servidor de Aplicacin JEE) Servicio Scheduler Toda la informacin relacionada con los proyectos (y procesos) habita en la base de datos (Bizagi es data-driven). Los otros dos componentes (el Portal de Trabajo y el Scheduler) se conectan con la base de datos para que ambas puedan crear y obtener informacin en tiempo real. Para configurar los equipos de trabajo de desarrollo se deben realizar las siguientes actividades: Preparar el servidor y prepara el puesto de trabajo de cada uno de los miembros del equipo.

Preparar el servidor
1. Instale Bizagi Studio en el servidor Visite Instalacin de Bizagi Enterprise 2. Si usted ya tiene un proyecto existente y necesita moverlo al servidor de desarrollo, usted deber realizar una copia de l desde su computador personal y restaurarlo en el servidor. Clic para ms informacin sobre cmo mover un proyecto Bizagi a otro servidor. Como una descripcin general, mover un proyecto implica: Usando Bizagi Studio crear un proyecto en blanco en el servidor (usted puede utilizar el mismo nombre recomendado- o cambiar el nombre actual del proyecto). Restaurar el backup de la base de datos de su computador personal al servidor seleccionado para la base de datos de desarrollo. Por otro lado, si usted no tiene un proyecto existente, simplemente cree un proyecto en blanco. Este ser el proyecto para donde su equipo de desarrollo trabajar. 3. Abra el proyecto en Bizagi Studio e incluya los miembros del equipo de trabajo a travs del men de Seguridad de Bizagi Studio. De esta forma, ellos podrn abrir el proyecto desde sus computadores. Visite Seguridad en Bizagi Studio 4. Para poder acceder a un proyecto en el servidor, el servicio B izag i Stan d ard Serv er O p eratio n Serv ice debe ser iniciado (Started). Nota: Este servicio se llama B izag i Serv er O p eratio n s Serv ice en la edicin Xpress. Para asegurar que el servicio esta en modo iniciado (started mode), dirjase al Panel de Control/ Herramientas Administracin e incielo.

124

Copyright 2013 - Bizagi

Preparar las estaciones de trabajo del equipo

Una vez se ha creado el ambiente de desarrollo, el equipo necesita seguir los siguientes pasos para trabajar en modo colaborativo a travs de Bizagi Studio.

1. 2.

Instale Bizagi Studio en sus computadores (puestos de trabajo). Registre el proyecto en Bizagi Studio. Registrar el proyecto bsicamente es una forma de informarle a Bizagi Studio que usted va a trabajar en un proyecto ubicado en un servidor. Este procedimiento debe ser realizado por todas las personas que trabajen en el proyecto.

Abra Bizagi Studio y seleccione la opcin Abrir Proyecto Existente (Open Existing Project) en la ventana principal.

Copyright 2013 - Bizagi

125

Seleccione el servidor donde el proyecto fue restaurado y luego seleccione el nombre del proyecto. Clic en F in alizar.

3. Una vez los miembros de equipo han registrado el proyecto, ellos pueden comenzar a trabajar juntos en Bizagi. No hay restricciones sobre el nmero de usuarios que pueden trabajar en un proyecto particular al mismo tiempo. 4. Si el proyecto esta en una versin anterior de Bizagi, al primer usuario que lo abra se le solicitar

126

Copyright 2013 - Bizagi

actualizar el proyecto.

Para infomacin completa acerca de este paso (registrar el proyecto), en el cual cada miembro del equipo abre el proyecto remotamente, consulte Abrir un proyecto existente

2.4

Arquitectura Informacin general sobre Arquitectura

La vida de ciclo de un proceso involucra las siguientes fases: Modelar, Ejecutar y Mejorar como se describe en Ciclo de Vida de un Proceso.

Modelar
Los procesos primero son modelados utilizando el estndar BPMN (notacin BPM), y documentados por el analista de procesos utilizando el Modelador de Procesos Bizagi. Luego, por medio de la Suite BPM (Bizagi Studio), los detalles de los procesos son extendidos para su ejecucin.

Ejecutar
Bizagi es una solucin model-driven, es decir, el servidor BPM interpreta el modelo BPMN diseado sin realizar ninguna transformacin. Bizagi directamente ejecuta y controla el flujo del proceso en cualquier plataforma (soporte .NET y JEE) a partir del modelo BPMN como se defini grficamente por los analistas del proceso, sin la necesidad de cdigo intermedio. Una vez que el detalle de la implementacin de los procesos se

Copyright 2013 - Bizagi

127

complete en el ambiente de desarrollo (tambin denotado como "Authoring"), Bizagi proveer a travs de un asistente la posibilidad de publicar los procesos a un ambiente de produccin. Publicar los procesos al ambiente productivo es un paso sencillo dado que Bizagi es una solucin data-driven, lo cual significa que la informacin de los procesos en su completitud se despliega al Servidor BPM. Bizagi presenta a los usuarios finales un portal de trabajo para que se autentiquen a travs de su navegador, y accedan a los pendientes de sus actividades diarias (su "inbox"). La siguiente imagen ilustra y resume lo mencionado anteriormente.

Mejorar
Bizagi ofrece un conjunto de indicadores de rendimiento para un anlisis histrico y de tiempo real los cuales promueven mejoramiento continuo de los proceso. Por medio de las observaciones y de las conclusiones obtenidas de los reportes de las opciones de

128

Copyright 2013 - Bizagi

BAM y anlisis en el Portal de Trabajo, se identifican las oportunidades de mejora a los procesos.

Servidor BPM Bizagi

El flujo del proceso es ejecutado en el servidor BPM. El siguiente diagrama ilustra los componentes princiapales que soportan las funcionalidades orientadas a procesos de Bizagi y las mltiples opciones de integracin con el Enterprise Services Bus (ESB) y otros sistemas existentes en su empresa:

Portal de trabajo
Bizagi presenta un Portal de Trabajo basado en protocolos web para los usuarios finales, donde encontrarn una bandeja de entrada con una lista de actividades por realizar. El Portal de Trabajo es el punto de acceso de los usuarios finales donde podrn interactuar con el

Copyright 2013 - Bizagi

129

sistema (por ejemplo, podrn empezar nuevos procesos, realizar tareas, acceder a reportes, etc.). El acceso al Portal de Trabajo requiere nicamente de un navegador, y ste puede: ser configurado para intranet o para internet, tener soporte multi idiomas y realizar personalizaciones (por ejemplo utilizar el logo de la cooperacin). Clic para ms informacin sobre Portal de Trabaja para usuarios finales.

Motor BPMN
El Motor BPMN es conocido en Bizagi como el 'WorkflowEngine', y controla y ejecuta el flujo de proceso. Este motor interpreta directamente el modelo BPMN como es creado previamente desde el Modelador de Procesos de Bizagi. Esto incluye todas las funcionalidades sofisticadas de la notacin BPM tales como los elementos de colaboracin entre procesos como seales y mensajes, transacciones de larga duracin, diseo de subprocesos, entre otros.

BAM y Anlisis
Las opciones de anlisis y BAM proveen una poderosa opcin de reportes para indicadores de gestin (para monitoreo, control y mejoramiento de los procesos). Ambas opciones tienen la posibilidad de un anlisis grfico, BAM (anlisis en tiempo real) y de anlisis histrico (identificacin de tendencias, cuellos de botella, etc.). Clic para ms informacin sobre opciones de Anlisis. Aplicaciones donde hay un gran volumen de datos y consultas de anlisis de reportes el rendimiento de la aplicacin se puede ver afectado, por lo que se presenta la opcin de utilizar un ODS (Operational Data Store) para el uso de este mdulo, y de esta manera mejorar el rendimiento Clic para ms informacin sobre cmo configurar ODS de Bizagi para BAM y Anlisis de reportes.

Administrador de datos
Bizagi presenta un potente motor de datos que se conoce como el 'EntityManager'. Este motor administra la informacin de manera segura, consiste y sincronizada entre sus diferentes componentes, permitiendo el acceso a los datos desde el proceso. Esto significa que el acceso a datos se realiza de manera transparente para los usuarios, sin importar si la informacin reside en la base de datos del proyecto local de Bizagi, o si reside en una fuente de datos externa (para esto ltimo, se cuenta con mecanismos de integracin importantes como la virtualizacin o replicacin).

Seguridad y Organizacin
El mdulo de seguridad manejar las opciones de autenticacin y autorizacin para los diferentes roles, habilidades, posiciones, reas y ubicaciones definidas en la estructura de la organizacin. Las opciones de Autenticacin incluye la seguridad del Portal de Trabajo por ejemplo con

130

Copyright 2013 - Bizagi

"Autenticacin con Oracle Single-Sign-On", e "Integracin LDAP", entre otras. Dentro de la organizacin, es posible definir y asignar diferentes esquemas de horarios de trabajo para los diferentes usuarios y sus ubicaciones.

Reglas de negocio
Bizagi ofrece un motor para la ejecucin de reglas de negocio o polticas que dan la lgica al proceso de negocio. Este motor se ejecuta en el servidor BPM para permitir las diferentes transiciones en el flujo del proceso, controlar y sincronizar la ejecucin de las actividades, realizar decisiones de forma automatiza y ejecutar reglas sofisticadas (por ejemplo tablas de decisin, rboles de decisin) y realizar clculos, entre otras cosas. Las reglas de negocio se definen en Bizagi de manera asistida, con la posibilidad de un editor grfico que permita su inclusin sin la necesidad de programacin.

Capa de Integracin
La capa de integracin es un mdulo robusto, flexible y poderoso que complementa al proceso en soluciones corporativas. En proyectos donde se requiere integrar los procesos con aplicaciones existentes, la Capa de Integracin de Bizagi permite mltiples maneras de integracin: Servidor de Correos: Los procesos en Bizagi pueden enviar notificaciones automticas usando un servidor de correo que sea SMTP, tal como Lotus Notes y Exchange, entre otros. Clic para ms informacin sobre Configuracin de SMTP para envo de correos. ECM para documentos Bizagi soporta la integracin con los sistemas de gestin de contenidos (Enterprise Contect Management) que sean compatibles con el estndar CMIS. Entre estos se encuentran: SharePoint, Alfresco y Documentum, entre otros. Los archivos adjuntos a los procesos en Bizagi pueden configurarse para una integracin con un repositorio central de documentos. Clic para informacin sobre Integracin ECM. Integracin de Aplicaciones (Enterprise Service Bus, ERP, CRM, Core Applications, Legacy Systems): Bizagi soporta la integracin con ESB corporativas y otros sistemas de ambas formas: Esto significa que es posible invocar un servicio basados en protocolos WEB (SOAP, REST) o realizar una invocacin directa API desde un proceso de Bizagi (invocar .dlls, .jars). Tambin es posible que aplicaciones externas invoquen funcionalidades de Bizagi. Para esto, se presentan tres posibilidades: Invocacin de servicios: Nuestro mtodo preferido de integracin es a travs de servicios basados en protocolos web, donde la configuracin se realiza con la ayuda del asistente de Bizagi (evitando la necesidad de programar o tener un perfil con altos conocimientos tcnicos). Esto presenta la posibilidad de invocar fcilmente servicios SOAP o servicios REST desde Bizagi. Clic para ms informacin sobre cmo invocar servicios SOAP Y REST desde Bizagi

Copyright 2013 - Bizagi

131

Invocacin cdigo externo o personalizado (Conectores, APIs) Es posible utilizar APIs o conectores (Clases EJB, JMS, etc.) debido al diseo de Bizagi para opciones de extensibilidad. A travs de esto es posible incluir cualquier componente personalizado. El concepto detrs de esto, es tener un componente separado en .NET o la tecnologa Java (disponible para la edicin Enterprise), y luego registrar el archivo construido y compilado (.dll or .jar) en Bizagi. De esta manera, los mtodos del componente pueden ser invocados directamente desde las reglas de negocio del proceso. Clic para ms informacin sobre invocaciones API a travs de la Librera de Componentes.

Capa SOA Bizagi sigue una arquitectura orientada al servicio para tener las mejores prcticas de integracin y el diseo. Adicionalmente, el asistente de las interfaces de Bizagi permite invocar un servicio externo basado en protocolos web, es decir es posible invocar los servicios web de los proyectos de Bizagi desde un sistema externo. Todos los proyectos de Bizagi tienen disponibles sus funcionalidades del flujo de proceso y consultas publicadas como mtodos web SOAP. Esto facilita el lanzamiento de eventos de negocio en Bizagi, los cuales son controlados por otro sistema (para cualquier posible integracin se necesita la actualizacin de la informacin enviada desde otro sistema a Bizagi). Los mtodos disponibles en los procesos de Bizagi tiene la posibilidad de: Iniciar un proceso, ejecutar una actividad o lanzar un evento, actualizar u obtener informacin del proceso y abortar una instancia de un proceso, entre otras cosas. Clic para ms informacin sobre servicios web publicado por procesos de Bizagi en la capa SOA. Fuente de datos externa Bizagi presenta dos poderosas funciones para integracin a nivel de datos (data-level), donde las estructuras de datos (tablas) de una fuente de datos externa deben ser sincronizadas con el modelo de datos de Bizagi. Con este enfoque, es posible configurar la Replicacin de Bizagi para que automticamente importe listas con informacin proveniente de cualquier fuente de datos (como una tarea programada). Tambin es posible utilizar el mecanismo de Virtualizacin de Bizagi para tablas de tipo transaccional, de forma que sus valores pueden ser buscados y actualizado en tiempo real. Clic para ms informacin sobre Virtualizacin y Replicacin (para integracin a nivel de datos). Eventos de negocio Bizagi soporta diferentes formas de interaccin entre procesos. Esto se refiere a la forma como se comporta un proceso ante un evento de negocio lanzado por otro proceso dentro de Bizagi o un evento de tipo asincrnico, por ejemplo eventos de temporizacin. Esta poderosa funcin permite modelar procesos que son iniciados mediante mensajes, seales, temporizadores o cualquier evento asincrnico.

132

Copyright 2013 - Bizagi

Administracin de Carga de Trabajo

Bizagi permite definir el balanceo de carga de trabajo en la asignacin de actividades de acuerdo a los algoritmos principales como: colas, round robin y balance por carga. Para la administracin y optimizacin de la carga de trabajo, es importante tener en cuenta algunos criterios como calendario laboral y calendario de vacaciones de los usuarios, y el uso de delegacin de trabajo y reasignaciones.

Manejador de Cach
El manejador de Cach es una implementacin importante especialmente en proyectos de Misin crtica de clientes corporativos grandes, estos procesos involucran generalmente un gran nmero de usuarios finales (de forma simultanea). El manejador de Cach provee una mejora en el rendimiento del Portal de Trabajo mediante la optimizacin al acceso de datos y la persistencia en la base de datos mediante scopes.

Arquitectura del sistema

La arquitectura de Bizagi considera tres ambientes para los proyectos: desarrollo (fase de construccin), pruebas y produccin.

Ambiente de desarrollo
El ambiente de construccin en Bizagi es llamado el Ambiente de desarrollo. En este ambiente Bizagi Studio es utilizado para la construccin e implementacin de los proyectos. Bizagi soporta en el ambiente de desarrollo ser configurado para trabajar en equipos de trabajo (proyectos en colaboracin).

Ambiente de produccin
La configuracin del ambiente de produccin en Bizagi soporta clsteres.

Copyright 2013 - Bizagi

133

Capa de Acceso a datos (Data Access Layer) La Capa de Acceso a datos contiene el Servidor de base de datos y puede configurarse con un nodo para mecanismo de tolerancia a fallos. Los motores de base de datos soportados para el modelo de Bizagi son: Microsoft SQL Server (2008 R2, 2008, 2005) y Oracle 10g R2.

Capa BPM (BPM Layer) La Capa BPM contiene el Servidor BPM y puede configurarse como clster con un nmero adicional de nodos (para balanceo de carga). Bizagi soporta la ejecucin de los procesos en plataformas .Net o JEE. Para la plataforma en .Net (ediciones Bizagi Enterprise .NET y Bizagi Xpress), un entorno Windows es utilizado con Internet Information Services (IIS) como Servidor Web. Para la plataforma JEE (edicin Bizagi Enterprise JEE), los Servidores de Aplicacin ms representativos del mercado son soportados: WebLogic, WebSphere, y JBoss. Un servidor adicional (configuracin opcional) puede ser configurado para tener los procesos de Bizagi disponibles con un acceso seguro va internet. En esta configuracin, el Servidor BPM estar todava en intranet y un proxy ser utilizado en una DMZ para redirigir el acceso desde internet.

134

Copyright 2013 - Bizagi

Informacin detallada acerca de los requerimientos del servidor (hardware y software), as como las posibilidades tcnicas de instalacin de infraestructura para cada una de las ediciones de Bizagi se puede encontrar en los captulos anteriores.

2.5

Interfaz de usuario
La Suite BPM de Bizagi esta compuesta de tres componentes principales que son instalados automticamente cuando usted ejecuta el instalador de Bizagi: Bizagi Studio: Es la herramiento utilizada para automatizar los procesos. Un asistente de interfaz amigable loguiar a travs de cada uno de los pasos requeridos para crear sus modelos de proceso completamente: definiendo el modelo de datos, la interfaz de usuario, las reglas de negocio, la asignacin de trabajo y la integracin con otras aplicaciones, entre otras cosas. Portal de Trabajo de Bizagi: Los procesos automatizados se ejecutarn en el Portal de Trabajo, accesado a travs de un explorador web, para una administracin eficiente e inteligente de los Procesos en tiempo real. Los usuarios finales visualizarn el Portal de Trabajo para llevar a cabo sus actividades diarias y monitorear la operacin de los negocios en tiempo real gracias a un completo set de Reportes. Este Portal de Trabajo posee una caracterstica escencial: cuando el Proceso es modificado (cualquier elemento del modelo) esste se actualizar automaticamente y el cambio se mostrar inmediatamente. Bizagi Management Console: Es la herramienta para realizar actividades de mantenimiento en procesos dentro de los ambientes de Prueba y produccin. La primera herramienta con la que los usuarios interactuarn es con Bizagi Studio. La siguiente ventana se mostrar al abrir Bizagi Studio; esta contiene las principales opciones para iniciar el modelamiento y automatizacin de los procesos.

Copyright 2013 - Bizagi

135

Nuevo: Crea un nuevo proyecto. Un proyecto contiene tantos procesos como usted necesite para completar la iniciativa de trabajo de su compaa. Dentro de un proyecto Bizagi le permite organizar sus procesos en aplicaciones, categorias y subcategorias Para mayor informacin consulte Definir la estructura de sus proyectos. Abrir un proyecto existente: Abre un proyecto existente en el computador local o servidor remoto. Proyectos: Administra proyectos registrados. Iniciar: Redirecciona al sitio web de Bizagi para mayor informacin acerca de la Suite Bizagi. Aprenda mas: Redirecciona a nuestro Centro de Recursos para acceder a mltiples recursos. Central de Procesos: Da acceso gratuito a Plantillas de Proceso listas para utilizar.

2.5.1

Bizagi Studio
Bizagi Studio posee dos vistas principales: El A sisten te y la vista de M d u lo s.

136

Copyright 2013 - Bizagi

Cada proyecto puede ser automatizado utilizando la vista de Asistente; sin embargo, algunas caractersticas avanzadas estan disponibles nicamente en la vista de Mdulos. Para cambiar la vista actual, seleccione la pestada de In icio en la parte superior izquierda de la pantalla y luego de clic el botn M d u lo s/A sisten te en el grupo de Vista, segn corresponda.

Vista de Asistente
De clic aqu para mayor informacin acerca de la vista de Asistente.

Vista de Asistente
De clic aqu para mayor informacin acerca de la vista de Mdulos.

Copyright 2013 - Bizagi

137

Cinta de Opciones
Las vistas de Asitente y Mdulos comparten la misma interfaz de men. Esta seccin de menus es denominada Cin ta d e O p cio n es. La Cinta de Opciones contiene los principales controles para administrar cada vista. Estos estan organizados en diferentes pestaas y son brevemente descritos a continuacin:

Pestaa de Archivo

138

Copyright 2013 - Bizagi

OPCIN DE MEN Nuevo Proyecto Abrir Proyecto Existente Proyectos Recientes Seguridad Bizagi Studio Importar Plantillas Salir

DESCRIPCIN Crea un nuevo proyecto de Bizagi BPM. Abre un proyecto existente de Bizagi BPM. Administra proyectos existentes. Da acceso rpido a los ltimos proyectos que han sido utilizados. Controla permisos de acceso de usuario a elementos de un proyecto de Bizagi. Accede a nuestra Central de Procesos gratuitos para descargar procesos ejecutables listos para utilizar. Cierra Bizagi Studio.

Pestaa de Inicio

Copyright 2013 - Bizagi

139

La pestaa de In icio contiene tres botones principales que siempre se muestran. OPCIN DE MEN Mdulos / Asistente Ejecutar Buscar DESCRIPCIN Cambia la vista de Bizagi Studio entre las vistas de Asistente y Mdulos. Accede al Portal de Trabajo para ejecutar los procesos. Busca objetos Bizagi tales como Entidades, Atributos, Reglas de Negocio y Procesos. Estos son objetos creados por los usuarios en la automatizacin de Procesos.

Este men contextual le dar acceso rpido a las opciones de uso frecuente en cada funcionalidad. Los siguientes dos ejemplos muestran dos diferentes menus contextuales, Procesos y Atributos basados en las selecciones realizadas. La siguiente imagen muestra la distribucin del men de Inicio, con el men contextual de P ro ceso , cuando se accede a un Proceso especfico en el M d u lo d e P ro ceso s.

Esta otra muestra una vista levemente alterada de la distribucin del men de Inicio, con el men

140

Copyright 2013 - Bizagi

contextual A trib u to s, cuando se accede a atributos de una entidad especfica en el M d u lo d e En tid ad es.

Pestaa de Herramientas

OPCIN DE MEN Campos de Usuario

DESCRIPCIN Accede al men de Campos de Usuario, donde usted puede crear y administrar controles HTML personalizados sofisticados los cuales no estan por defecto en los controles del Editor de Formas de Bizagi.

Copyright 2013 - Bizagi

141

OPCIN DE MEN

DESCRIPCIN

Scripting

Scripting le permite a los usuarios la inclusin y uso de cdigo JavaScript en cualquier forma de un Proceso. Las funciones personalizadas declaradas e incluidas en la ventana de scripting podrn ser invocadas desde un Campo de Usuario incluido en cualquier forma.

Funciones

La Funciones son reglas de negocio compartidas por todas las Apliaciones y Procesos creadas en el proyecto. Estas son las Reglas de libreria que pueden se llamadas desde cualquier Proceso, regla o elemento.

Libreria de Componentes

Bizagi ofrece una capa de integracin la cual permite a sistemas existentes integrase con Bizagi. Bizagi ofrece una interfaz de asistente para invocaciones de servicios web y rest asi como una funcionalidad denominada Libreria de Componentes para una integracin a nivel de Proceso (transaccional).

Pestaa de Configuracin

OPCIN DE MEN Entorno

DESCRIPCIN Determina la forma en la cual correos electrnicos, scheduler, archivos cargados y opciones de autenticacin, entre otras, se configuran. La Configuracin de Ambiente Configuracin de Entorno se especifca para cada ambiente de manera individual (desarrollo, pruebas y produccin) Define preferencias especficas de negocio tales como localizacin, plantillas de notificacin y otras opciones globales que aplican a todo el proyecto a lo largo de todos los ambientes. Vea mas informacin acerca de Configuracin de Negocio Configuracin de Negocio Activa traces para dar seguimiento a los diferentes

Negocios

Seguimiento

142

Copyright 2013 - Bizagi

OPCIN DE MEN

DESCRIPCIN comportamientos y valores para Entidades, Reglas de Negocio, Validaciones, Interfaces, Servidor LDAP, Scheduler y Asignaciones.

Servidor Web

Define el tipo de Servidor Web que se utilizar apra el proyecto: ASP.NET o Internet Information Services.

Secuencias y Numeracin de Casos

Personaliza identificadores de caso, los cuales son los nmeros de casos dados por Bizagi en el Protal de Trabajo, para cada instancia de un proceso. Vea mas informacin acerca de crear numeracin de casos personalizada.

Pestaa de Ayuda

OPCIN DE MEN

SUB OPCIN

DESCRIPCIN

Ayuda

Muestra esta Gua de Usuario. El documento puede ser descargado a un archivo PDF para acceso sin conexin ala red. Accede a los foros de Soporte Online. Accede a las plantillas de Proceso de la Central de Procesos de Bizagi y a los foros de discucin. Accede a la pgina de Comentarios y Preguntas para transimitir cometarios, preguntas, sugerencias e ideas de mejoramiento, Link que le ayudar a compartir la Suite de Bizagi con clientes, colegas y amigos.

Ayuda

Foros de Soporte Central de Procesos

Comuni dad

Comentarios

Comentarle a un amigo

Copyright 2013 - Bizagi

143

OPCIN DE MEN Acerca de

SUB OPCIN

DESCRIPCIN

Notas de la Versin

Informacin acerca de la versin actual y anteriores de Bizagi. Abre la ventana de Administracin de Licencias para activar o comprar licencias. Informacin acerca de Bizagi Studio y colaboradores.

Administracin de Licencias

Acerca de

Estilo e Idioma

OPCIN DE MEN Estilo

SUB OPCIN

DESCRIPCIN

Color: Azul, Negro, Plateado, Esquema personalizado. Sin animaciones

Permite cambiar el color de fondo de Bizagi Studio. Desactiva las animaciones del Asistente de Procesos para mejorar la velocidad de la pantalla. Aplica nicamente para la vista de Asistente. Extiende o contrae los iconos en la barra de Mdulos de la vista de Mdulos. Actualiza el Asistente de Procesos. Una funcionalidad muy til cuando se trabaja en equipo en un proyecto. Altera el idioma de Bizagi Studio entre Espaol e Ingles. Minimiza la Cinta de Opciones.

Barra de explorador extendida Refrescar Vista Carrusel.

Idioma

Control de Ocultar/ Mostrar

144

Copyright 2013 - Bizagi

2.5.1.1

Crear un nuevo proyecto

Vista General
Para automatizar sus Procesos organizacionales usted primero necesita crear un proyecto Bizagi. Cada proyecto puede incluir tantos procesos como sea necesario. Cada proyecto crear automticamente el repositorio de Proceso (una base de datos), el Portal de Trabajo (una aplicacin de Bizagi basada en la web), y un servicio de Scheduler (para ejecutar tareas programadas y asincronas), as como muchas otros componentes internos utilizados por las funcionalidades de Bizagi.

Prerequisitos
Revise los Prerequisitos para la creacin de un proyecto en Bizagi antes de intertar crear un nuevo proyecto.

Crear el Proyecto
Para crear un nuevo proyecto se deben llevar a cabo los siguientes pasos:

1. De click en el botn N u ev o en la ventana de bienvenida a Bizagi Studio. Una nueva ventana se mostrar. Aqu usted ingresa el nombre de su proyecto. De clic en Sig u ien te.

Copyright 2013 - Bizagi

145

2. Ingrese la informacin de la Base de Datos donde su proyecto se almacenara. La Base de Datos puede ser almacenada en el computador local o un servidor remoto. Para la versin Xpress, en el caso que usted no tenga un servidor de Base de Datos instalada, el instalador de Bizagi provee una opcin para instalar una instancia de SQL Express 2005 SP2. La conexin se configura con la siguiente informacin por defecto: Nombre de Usuario: sa Contrasea: B izag i10GO Para la versin Enterprise usted necesita tener un servidor de Base de Datos instalado.

146

Copyright 2013 - Bizagi

Para crear un proyecto en un servidor de Base de Datos SQL, ingrese la siguiente informacin: Servidor: El nombre de la Base de Datos que contiene la instancia del Servidor SQL. Base de Datos: El nombre de su proyecto. Bizagi crear una Base de Datos con su nombre. Nombre de Usuario: Una cuenta de usuario para acceder a la instancia del Sevidor SQL. Contrasea: La contrasea para el nombre de usuario especificado. De clic en Sig u ien te. Si usted desea crear un proyecto en una Base de Datos de Oracle, consulte los articulos relacionados al final de esta seccin. Una vez la informacin del Servidor de Base de Datos ha sido ingresada y confirmada, su proyecto se crear. Cuando el Asistente finaliza, Bizagi Sudio se abrir para inciar la automatizacin de sus Procesos.

Artculos Relacionados
Cmo crear un proyecto en Oracle Cambiar el usuario del servidor SQL (Cuando el usuario sa esta restringido)

Copyright 2013 - Bizagi

147

2.5.1.2

Abrir un proyecto existente

Vista General
Esta opcin se utiliza para abrir un proyecto que ha sido previamente creado. El proyecto puede ser local (es decir, el proyecto esta localizado en el mismo computador que esta intentando acceder a abrirlo) o puede ser abierto desde un servidor remoto. De esta manera cada proyecto se puede acceder desde cualquier computador que este conectado a la misma red y dominio, dando a los usuarios la posibilidad de trabajar como equipo. Si usted desea abrir un proyecto almacenado en un servidor remoto, asegrese de tener credenciales autorizadas. Vea mas informacin acerca de de Trabajar con su equipo de desarrollo.

Abrir el Proyecto
Para abrir un proyecto existente se deben realizar los siguientes pasos:

1. De clic en Abrir un proyecto existente en la ventana de bienvenida a Bizagi Studio. Una nueva ventana se mostrar. 2. Seleccione el servidor donde se almacena el proyecto.. La lista de proyectos en el servidor se mostrar en la segunda lista desplegable. Seleccione el nombre del proyecto y de clic en F in alizar.

148

Copyright 2013 - Bizagi

Notas: Para acceder a un proyecto de forma remota, cada miembro del equipo DEBE ESTAR EN LA MISMA RED Y DOMINIO. Para cada miembro del equipo asegurese que tanto el servidor como el computador estan corriendo en la misma versin de Bizagi. Es muy comn para el desarolldador que cre el proyecto en primera instancia en su computador, continuar trabajando localmente en vez de registrar el nuevo desarrollo en el servidor de desarrollo del servidor. Para corregir esta inadvertencia es necesario separar el proyecto local utilizando la opcin Borrar Proyecto y seleccionar Separar. Luego, registre el proyecto almacenado en el servidor como alguien mas. Cuando un proyecto ha sido creado en la versin JEE, este no puede ser abierto en la versin .NET. De manera similar, los proyectos creados en la versin .NET, no pueden ser abiertos en la versin JEE. Para trabajar en un proyecto que esta almacenado en un servidor, usted debe ser incluido como un usuario en la Seguridad de Bizagi Studio. D clic aca para mayor informacin sobre cmo configurar la Seguirdad de Bizagi Studio.

Copyright 2013 - Bizagi

149

2.5.1.3

Manejo de proyectos existentes

Vista General
Esta opcin es utilizada para administrar proyectos existentes previamente registrados (abiertos) en Bizagi Studio. Todos los proyectos que han sido abiertos se listarn. Cada proyecto puede ser eliminado, separado (si esta almacenado en un servidor remoto), actualizado a una nueva versin o abierto (si usted esta en otro proyecto)

Proyectos
Crear un Nuevo Proyecto. El Asistente de nuevos proyectos se abrir. Elimine o separe un proyecto. Los proyectos pueden ser eliminados si estan almacenados en el computador local del usuario. Cuando se da clic en Eliminar un proyecto, un dialogo de confirmacin aparecer para advertir al usuario que la eliminacin se ejecutar. Confirmando esta advertencia se removera permanentemente el proyecto del computador local.

150

Copyright 2013 - Bizagi

Una segunda ventana solocitar al usuario confirmar si la Base de Datos se mantendr. Esta Base de Datos ser til en el futuro si usted necesita restaurarla en un nuevo proyecto. En este punto usted ha eliminado el proyecto y, consecuentmente, este se cerrar.

Si el proyecto es almacenado en un servidor remoto este puede ser separado en este punto. Esto no eliminar el proyecto, solamente lo remover de la lista de entradoa. Un dialogo de confirmacin advertir sobre la ejecucin de la separacin del proyecto.

Actualizar un proyecto. Cuando un usuario actualiza la versin de Bizagi Studio, cada proyecto deber ser actualizado tambin. Usted puede seleccionar un Proceso y actualizarlo a la ltima versi instalada en el computador local. Para mayor referencua, prerequisitos e instrucciones dirjase a Actualizacin de Versin.

Copyright 2013 - Bizagi

151

2.5.1.4

Vista del asistente

La vista de asistente provee acceso al Asistente del Proceso el cual lo guiar paso a paso en la automatizacin de sus procesos. Complete la informacin y de clic en Siguiente para continuar con el siguiente paso.

Acceso rpido a todos los pasos

En la esquina superior derecha del rea de trabajo usted podr encontrar una lista desplegable con un icono en forma de engranaje. El men desplegable provee acceso rpido a cada paso del asistente sin necesidad de navegar a travs de todos los pasos predecesores.

Cambiar de un proceso a otro

Si su proyecto tiene varios Procesos, usted podr de forma rpida cambiar de un proceso a otro dando clic en el men desplegable. La lista desplegable se encuentra al lado izquierdo en men de acceso rpido. Realizando esta accin, el asistente se actualizar y dar acceso al proceso seleccionado.

Remover un Proceso de Asistente

En el botn del men usted encontrar la opcin Remover. Esta opcin remover el proceso que se

152

Copyright 2013 - Bizagi

encuentre activo en el momento del Asistente de procesos. Esta accin no remover o eliminar sus procesos, solamente lo remover del Asistente. Para volver a incluir un proceso dentro del asistente, dirjase a la vista de Mdulos, de clic derecho sobre el nombre del proceso y seleccione Adicionar al asistente.

2.5.1.5

Vista de mdulos La vista de mdulos tiene los siguientes mdulos:

Copyright 2013 - Bizagi

153

Procesos: Provee la funcionalidad de generar una estructura para sus procesos, adems contiene todas las aplicaciones y sus procesos. Usted puede clasificar por aplicacin, categoras y procesos. Entidades: Contiene la lista de todas las entidades del modelo de datos. Usted puede crear, eliminar y manejar todas las entidades: maestras, paramtricas, del sistema y entidades de aplicacin. Las mismas acciones pueden ser ejecutadas con atributos, formas y valores que pertenezcan a cada entidad. Reglas de negocio: Contiene todas las reglas de negocio globales. Las reglas globales pueden ser reutilizadas en una aplicacin especfica o a travs de los proyectos.

Organizacin: Permite definir la estructura organizacional de la compaa y la asociacin entre las personas y las reas. Sistemas: Permite configurar y administrar los sistemas externos de integracin a su solucin BPM. El mdulo maneja la configuracin para: conectores ECM (integracin con sistemas de manejo de documentos), entidades virtualizadas y replicadas (integracin a nivel de datos con un repositorio existente), administrador de interfaces (Servicios WEB o servicios de invocacin REST) de sus procesos. Anlisis: Provee a la organizacin indicadores de gestin que son de fcil entendimiento en tiempo real. La dimensin es el conjunto de valores por los cuales se pude filtrar los reportes.

154

Copyright 2013 - Bizagi

Seguridad: Permite definir el sistema de autenticacin para el Portal de Trabajo y define los permisos para los mens y procesos del Portal de Trabajo basados en roles especficos y grupos de usuario. Programador: Permite la creacin de Trabajos Personalizados. Los trabajos son reglas de negocio que pueden ser ejecutadas de forma peridica. Estos no estn asociados a un proceso especfico, sino que son expresiones generales para todos los procesos.
2.5.1.5.1 Procesos en Vista de Mdulos

Desde la Vista de Mdulos usted tiene acceso a todos sus Proceso con opciones avanzadas disponibles para su configuracin. D clic sobre cualquier nodo (Aplicaciones, Nombre de Aplicacin, Proceso, Versin, etc) para ver sus opciones.

Copyright 2013 - Bizagi

155

ELEMENTO Todas las Aplicaciones

OPCIONES Nuevas Aplicaciones: Habilita la creacin de nuevas Aplicaciones. Personalizar Columnas: Habilita la personalizacin de columnas mostradas en el Portal de Trabajo. Si se configuran, las columnas para los elementos con categora mas baja cambiarn, a menos que estos posean su propia configuracin. Seguridad: Permite la configuracin de la seguridad del elemento. Propiedades: Muestra las propiedades del elemento. Nueva categora: Permite la creacin de nuevas categoras para el elemento seleccionado. Eliminar: Permite la eliminacin de la Aplicacin. Esto se puede hacer siempre y cuando no se encuentren dependencias. Personalizar Columnas: Habilita la personalizacin de las columnas mostradas en el Portal de Trabajo. Se se configuran, las columnas para los elementos con jerarqua mas baja cambiarn, a menos que estos posean su propia configuracin. Seguridad: Permite configurar la seguridad del elemento. Propiedades: Muestra las propiedades del elemento. Nueva categora: Permite la creacin de nuevas categoras para el elemento seleccionado, para un nivel ms bajo de jerarqua. Nuevo Proceso: Permite la creacin de un nuevo Proceso para el elemento seleccionado. Nuevo Proceso con formas V.9: Crea un nuevo Proceso utilizando el antiguo Diseador de Formas. Esto es til cuando usted tiene Procesos en versiones anteriores de Bizagi a desea mantener las formas en ese formato (no recomendado). Eliminar: Permite la eliminacin de la Categora. Esto se puede hacer siempre y cuando no se encuentren dependencias. Personalizar Columnas: Habilita la personalizacin de las columnas mostradas en el Portal de Trabajo. Se se configuran, las columnas para los elementos con jerarqua mas baja cambiarn, a menos que estos posean su propia configuracin. Definir Entidad del Proceso: Cada Proceso en Bizagi posee su Entidad de Proceso Principal. La entidad provee el punto de partida para acceder al resto de los datos del Proceso. Esta opcin permite definir la entidad para el Proceso seleccionado. Mostrar Diagrama: Muestra el diagrama de Modelo de Datos para los Procesos seleccionados. Mostrar Consultas relacionadas: Bizagi permite la definicin y personalizacin de Formas de Consulta para consultar la informacin relacionada a los casos creados. Esta opcin muestra las formas de consulta relacionadas. Seguridad: Permite configurar la seguridad del elemento.

Aplicacin

Procesos (Categora por defecto)

Nombre del Proceso

Versin del Proceso

Propiedades: Muestra las Propiedades del Proceso de la Versin. Localizacin: Abre el Asistente para localizar los elementos del Proceso. Check-out: Abre el Modelo de Proceso y lo bloquea para edicin de otros

156

Copyright 2013 - Bizagi

usuarios. Nueva Versin: Crea una nueva versin del Proceso. Clonar: Permite crear una copia de un Proceso o Procesos y todos sus componentes asociados. Los elementos del Proceso crearn una nueva versin para que amabas sean independientes, Si hay algn error, Bizagi los mostrar para que sean corregidos antes de completar la tarea. Relacionar Objetos: Permite adicionar manualmente objetos adicionales que deban ser incluidos cuando se ejecute el deployment del Proceso. Ejecutar: Abre el Asistente de Deployment Seguridad:Permite configurar la seguridad del elemento.

Elementos de la Versin

Muestra todos los componentes de la versin del Proceso. Cada componente posee sus propias opciones. Atributos: Lista de todos los atributos del Proceso. Usted puede crear y editar estos atributos desde este men. Formas: Lista de todas las Formas del Proceso. Usted puede crearlas y editarlas desde este men. Reglas de Negocio: Muestra la lista de las polticas del Proceso. Usted puede crear y editar las Polticas desde este men. Plantillas Elementos (Actividades, Eventos, Compuertas): Lista las Actividades, Eventos y compuertas del Proceso. Usted puede acceder a las formas de las Actividades y Eventos para editarlas.

Las Actividades incluyen la Forma que se crea desde el Asistente de Procesos. Estas formas pueden ser editadas y duplicadas desde aqu. Si se necesita una nueva forma de la actividad actual, usted puede crearla desde este men y seleccionar Co n fig u rar co m o la fo rm a p rin cip al d e la activ id ad actu al, dando clic derecho sobre ella. Esto cambiar la forma activa actual para la Actividad, en el Portal de Trabajo.

Nota: Un flujo de proceso slo puede ser modificado por una persona a la vez. Si un usuario A pulsa la opcin check-out para modificar un proceso, Bizagi no permitir que un usuario B modifique el proceso hasta que el usuario A haya cerrado el modelador de procesos y haya pulsado la opcin check-in. Si el usuario A ha abierto el diagrama de proceso a travs del Asistente de Proceso, desde el primer paso, el proceso tambin ser bloqueado y el usuario B no podr modificarlo hasta que el usuario A lo cierre. Si el proceso se abri con el Asistente de Proceso, Bizagi automticamente le har check-in cuando se cierre. Cuando un flujo de proceso est abierto, en la vista de Mdulos se mostrar una pequea equis rojas. Haga clic en la versin de proceso y seleccione P ro p ied ad es d e ch eck-o u t saber quin tiene el proceso.

Copyright 2013 - Bizagi

157

2.5.1.5.2 Entidades en Vista de Modulos

En la Vista de Mdulos usted tiene acceso a todas sus entidades con opciones avanzadas disponibles para su configuracin. D clic sobre cualquier nodo (Aplicaciones, Maestras, Paramtricas, Sistema, etc) para ver estas opciones. Usted puede dar clic derecho sobre cada nodo para obtener nuevas opciones avanzadas.

158

Copyright 2013 - Bizagi

ELEMENTO

OPCIONES

DESCRIPCIN Editar lista de atributos: Muestra el Modelo de Datos de la Entidad para agregar, editar o eliminar los atributos de la entidad especfica. Nueva Relacin: Muestra el Asistente de Relaciones, donde usted puede crear relaciones entre cualquier par de entidades del Modelo de Datos (no solo la entidad que se accede). Nueva Forma: Abre el Diseador de Formas para crear una nueva forma con el contexto de la Entidad. Autogenerar: Crea automticamente una forma con todos los atributos de la

SUB-OPCIONES Remover: Elimina el atributo seleccionado. Antes de eliminarlo, Bizagi valida que no haya dependencias. Si las hay, se mostrar un mensaje. Propiedades Bsicas: Muestra el nombre y tipo del atributo. Ver dependencias: Muestra una lista que contiene objetos en el proyecto relacionados al elemento.

Atributos Elementos que aplican a todos los mens

Formas

Editar Formas: Abre el Diseador de Formas para editar la forma seleccionada. Duplicar Formas: Crea una versin duplicada de la forma seleccionada. Esta forma no se relacionar a alguna Tarea

Copyright 2013 - Bizagi

159

entidad. Los layouts y formatos son incluidos por defecto. Nuevo/Autogenerar (V.9): Crea o autogenera una Forma utilizando el antiguo Diseador de Formas. Si usted ha migrado Formas desde versiones previas, usted podr ver ambas versiones (nuevas y viejas) en este men.

o Forma anidada. Ambas formas sern independientes una de la otra. Eliminar Forma: Elimina la forma seleccionada. Antes de eliminarla, Bizagi valida que no existan dependencias. Si las hay, se mostrar un mensaje. Generar Esquema. Crear nueva versin: Crea una nueva versin de la forma actual. Un rbol jerrquico se mostrar con nuevas versiones. Nueva Forma: Abre el Diseador de Formas para crear una nueva forma., con el contexto de la Entidad. Ver dependencias: Muestra una lista que contiene los objetos en el proyecto relacionados al elemento. En las entidades paramtricas usted puede incluir nuevos registros. Todas los dems tipos de entidades mostrar valores en modo de solo lectura. Propiedades: Muestra el Asistente de Consultas con la informacin de la consulta seleccionada. Remover: Elimina la consulta seleccionada. Antes de hacerlo Bizagi valida que no existan dependencias. Si las hay, se mostrar un mensaje. Ver dependencias: Muestra una lista que contiene los objetos en el proyecto relacionados al elemento.

Valores (no disponibles en el Sistema)

Muestra una lista de valores ingresados en la ejecucin del Proceso.

Consultas (no disponibles en el Sistema)

Nueva Consulta: Muestra el Asistente de Consultas. Si se crea una consulta desde un tipo de entidad diferente al de Aplicacin, esta ser una Consulta de Entidad.

Aplicacin

Propiedades Generales

Propiedades: Muestra el Asistente de Modelo de Datos de la Entidad.

160

Copyright 2013 - Bizagi

Propiedades Avanzadas: Habilita la posibilidad de registrar operaciones en el Registro de Bizagi. y establecer una llave de negocio. Esquemas XML Seguridad: Habilita la configuracin de la seguridad del elemento. Ver dependencias: Muestra una lista que contiene objetos en el proyecto relacionados al elemento. Propiedades: Muestra el Asistente de Modelo de Datos de la Entidad. Propiedades Avanzadas: Habilita la posibilidad de registrar operaciones en el Registro de Bizagi. y establecer una llave de negocio. Remover: Elimina la entidad seleccionada. Antes de eliminarla see valida que no existan dependencias. Si las hay, se mostrar un mensaje Esquemas XML Asignar Entidad de Proceso. Seguridad: Habilita la configuracin de la seguridad del elemento. Ver dependencias: Muestra una lista que contiene objetos en el proyecto relacionados al elemento. Muestra una lista de los Diagramas de Modelo de Datos relacionados. Diagramas Editar: Muestra el Asistente de Modelo de Datos. Remover: Elimina el diagrama seleccionado. Antes de hacerlo Bizagi valida que no existan dependencias. Si las hay, se mostrar un mensaje. Propiedades: Abre la expresin para editarla. Eliminar: Elimina la expresin seleccionada. Antes de hacerlo Bizagi valida que no existan dependencias. Si las hay, se mostrar un mensaje.

Propiedades Generales

Maestra

Expresiones

Muestra las Expresiones relacionadas a la entidad. Dichas expresiones tienen la entidad como su contexto y son reusables a lo largodel proyecto.

Paramtrica

Propiedades Generales

Propiedades: Muestra el Asistente de Modelo de Datos de la Entidad. Propiedades Avanzadas: Habilita la posibilidad de registrar operaciones en el Registro de Bizagi, establecer una llave de negocio y controlar donde se administran las entidades. Remover: Elimina la entidad seleccionada. Antes de eliminarla see valida que no existan dependencias. Si las hay, se mostrar un mensaje Esquemas XML Seguridad: Habilita la configuracin de la seguridad del

Copyright 2013 - Bizagi

161

elemento. Ver dependencias: Muestra una lista que contiene objetos en el proyecto relacionados al elemento. Muestra las Expresiones relacionadas a la entidad. Dichas expresiones tienen la entidad como su contexto y son reusables a lo largodel proyecto. Propiedades: Abre la expresin para editarla. Eliminar: Elimina la expresin seleccionada. Antes de hacerlo Bizagi valida que no existan dependencias. Si las hay, se mostrar un mensaje.

Expresiones

Sistema

Propiedades Generales

Esquemas XML Ver dependencias: Muestra una lista que contiene objetos en el proyecto relacionados al elemento.

2.5.2

Portal de Trabajo
Bizagi presenta un Portal de Trabajo donde los usuarios finales pueden interpretar y ejecutar el modelo del proceso, anteriormente diseado y construido. El Portal de Trabajo es el lugar donde los usuarios pueden ejecutar las tareas asignadas a ellos, crear nuevos casos, controlar casos de acuerdo a la lgica del negocio planteada. Para el acceso se requiere un navegador (intranet o internet) y una cuenta registrada. Un caso es una instancia del proceso. Cuando un usuario final crea un nuevo caso, el o ella habr creado una instancia del proceso. Todas las instancias son independientes entre ellas. El Portal de Trabajo, resultado e la automatizacin de Bizagi, tiene una caracterstica muy importante: cuando un proceso es modificado (por ejemplo, un elemento del modelo de negocio) la aplicacin se modifica de forma automatiza. Esto es, en Bizagi, el Proceso ES la aplicacin. Dependiendo del perfil del usuario, el portal permite administrar los procesos, reasignar casos cuando existen problemas operacionales y tomar acciones correctivas para el aumento de la eficiencia organizacional. La pantalla principal del Portal de Trabajo se divide entres secciones; Men principal, rea del caso y rea de trabajo como se muestra en la siguiente imagen.

162

Copyright 2013 - Bizagi

Para

ms informacin visite Portal de Trabajo y sus caractersticas

2.5.3

Definiendo la estructura de los proyectos de su compaa

Informacin general
La organizacin de la estructura de sus proyectos es bastante til cuando se tiene un nmero significativo de Procesos. Una estructura definida permite identificar, administrar y controlar los procesos ms rpido y de forma ms eficiente. Recuerde que un Proyecto puede contener tantos Procesos, como necesite para completar exitosamente la iniciativa de automatizacin de la organizacin. Para organizar sus procesos es necesario cambiar la vista de Bizagi Studio de la vista del Asistente a la vista de Mdulos.

Copyright 2013 - Bizagi

163

Bizagi permite organizar sus procesos utilizando aplicaciones, y categoras con diferentes niveles jerrquicos. Una ap licaci n es el nivel ms alto de la estructura jerrquica la cual agrupa procesos relacionados entre ellos para lograr un objetivo de negocio. Cada aplicacin creada en Bizagi contiene cierta cantidad de procesos, los cuales a su vez, pueden ser organizados siguiendo una estructura jerrquica utilizando Categ o ras.

Ejemplo
Suponga que su compaa tiene un gran nmero de procesos. Bizagi le recomienda crear aplicaciones basadas en las reas que manejan y utilizan los procesos y adems utilizar categoras para establecer una sub clasificacin dependiendo de la naturaleza de cada uno de ellos. En la siguiente imagen se pude observar la forma como los procesos de la compaa pueden ser clasificados. Las aplicaciones pueden ser identificadas con el logo de Bizagi. Para este caso tenemos tres aplicaciones, Comercial, Administrativa, Recursos Humanos y el Departamento de IT.

164

Copyright 2013 - Bizagi

Las categoras son mostradas con un folder azul y cada una contiene una sub categora o varios procesos. En la aplicacin de Recursos Humanos se han incluido dos categoras: Talen to H u m an o y N o m in a. En un nivel ms bajo de Talento humano, hemos creado dos categoras adicionales, A d m in istraci n d e P erso n al y A d m in istraci n d e Talen to , para incluir procesos que aplican a esas reas especficamente.

Copyright 2013 - Bizagi

165

En la aplicacin de IT solamente existe una categora mayor ITIL (Librera de informacin tecnolgica) la cual contiene dos sub categoras las cuales representan dos divisiones: Tran sici n d el Serv icio y O p eraci n d el Serv icio . Cada categora tiene diferentes procesos. Por ejemplo Operacin del Servicio tiene Administracin de incidentes y Gestin de problemas.

166

Copyright 2013 - Bizagi

Usted pude definir varios niveles de categoras (categoras dentro de categoras) si lo considera necesario.

2.6

Process Central

Copyright 2013 - Bizagi

167

El Process Central de Bizagi brinda algunos procesos listos para usar y ejecutar los cuales pueden ser utilizados para potencializar el rendimiento de su organizacin. Usted puede personalizar estos procesos de acuerdo a las necesidades particulares de su compaa. Siga los siguientes pasos para importar las plantillas de los procesos dentro de Bizagi Studio. Aprenda, explore y adptelos de la forma que desee.

168

Copyright 2013 - Bizagi

Antes de empezar asegrese que tiene instalada la LTIMA versin de Bizagi. Tambin es necesario contar con conexin a internet.

1. Para acceder y descargar el Process Central, de clic en Free Process Central Una nueva ventana ser mostrada con la lista de las plantillas existentes.

Copyright 2013 - Bizagi

169

2. Navegu por el Process Central. D clic en cualquier proceso para aprender ms sobre l. 3. Aprenda todo lo que necesita saber sobre cada proceso a travs de los videos y la documentacin.

170

Copyright 2013 - Bizagi

4. Cuando encuentre un proceso de su agrado, usted podr descargarlo y comenzar a utilizarlo de forma inmediata. Clic en el botn Instalar Ahora para descargar la plantilla de forma gratuita.

Copyright 2013 - Bizagi

171

5. Un asistente lo guiar a travs del proceso de instalacin. Usted puede elegir descargar la plantilla dentro de un proyecto existente o dentro de un Nuevo Proyecto. 6. Luego de completar la descarga, la plantilla quedar instalado en Bizagi Studio. Tan pronto el asistente termine, el navegue a travs del Portal de Trabajo para conocer su proceso. Sintase libre de personalizar y utilizar el proceso de acuerdo a las necesidades particulares de su organizacin! Si usted accede al Process Central a travs de la pestaa archivo en Bizagi Studio, la plantilla se instalar en el PROCESO QUE ESTA ABIERTO ACTUALMENE.

Consideraciones Importantes Por favor leerlas

Las plantillas deben ser importadas una por una. SIEMPRE ejecute un iisreset antes de ejecutar sus procesos descargados en el Portal de Trabajo. Las plantillas tiene la opcin de correo electrnico DESHABILITADA. Usted debe configurar su servidor SMTP para permitir el envo de correos y evitar errores en el Portal de Trabajo. Las plantillas no importan usuarios. Usted puede probar la plantilla utilizando el usuario administrador antes de crear usuarios. Para probar las reglas de asignaciones, usted deber crear los usuarios de acuerdo a los roles que cada tarea tiene definidos. De forma alternativa, usted puede crear sus propias reglas se asignacin y luego, crear los usuarios que mejor se ajusten a sus necesidades. Cuando cree usuarios, asegrese que la opcin Notificar por Email este habilitada si se van a enviar correos electrnicos.

172

Copyright 2013 - Bizagi

Una plantilla no puede ser importada dentro de una base de datos existente si hay entidades o procesos con los mismos nombres. Si usted ha importado una Plantilla y ha cambiado el nombre o el tipo de atributo o ha cambiado el nombre o de una entidad, no ser posible importar de nuevo la misma plantilla dentro del proceso. Si desea probar los temporizadores, por favor inicie el Scheduler. Si usted desea utilizar el Portal de Trabajo en espaol, es necesario habilitar el idioma ES y reiniciar el Portal de Trabajo.

Nota: Algunos procesos pueden no estar disponibles. Estamos trabajando para publicarlos todos. Por favor ingrese a nuestro Process Central continuamente para revisar nuestros anuncios ms recientes.

2.6.1

Instalacin de servicios web para el Process Central

Los usuarios de Bizagi utilizan diferentes mecanismos que permiten la conexin de la Suite con los sistemas existentes de la compaa con el fin de utilizar la informacin necesario en la ejecucin de los proceso. Algunas de las Plantillas de procesos descargables desde el Process Central incluyen una preconfiguracin de servicios web que necesitan una conexin a internet para su apropiado funcionamiento. Si no se cuenta con una conexin a internet, es necesario instalar estos servicios de forma local. Los siguientes pasos muestran como realizar la instalacin.

Instalar los servicios Web en Windows 7

1. Dependiendo del proceso a utilizar, descargue y descomprima el archivo correspondiente que encontrara en: ftp://bizagiWSUser:bizagiWSUser@ftp.Bizagi.com/ProcessCentral Para Solicitud de Vacaciones, Solicitud de Compra y Suscripcin de Plizas: ESB.zip Para Solicitud de Crdito: WsCreditRequest.zip 2. Descomprima la carpeta y cpiela en su ruta local del Default Web Site. Normalmente esta ruta es C: \In etp u b \w w w ro o t

Copyright 2013 - Bizagi

173

3. Abra el Administrador del IIS ya sea ejecutando el comando inetmgr o seleccionndolo de Herramientas Administrativas en el Panel de Control. 4. En el administrador IIS, despliegue el Default Web Site y busque la carpeta del servicio web (ESB o WsCreditRequest). Haga clic derecho sobre ella y seleccione Covert to Application.

174

Copyright 2013 - Bizagi

5. En la ventana de Editar Aplicacin, haga clic en OK

Tenga en cuenta que algunos programas como Skype pueden entrar en conflicto con el IIS al momento de iniciar el Sitio Web por Defecto.

Instalar los servicios Web en Windows XP

Copyright 2013 - Bizagi 175

1. Dependiendo del proceso a utilizar, descargue y descomprima el archivo correspondiente que encontrara en: ftp://bizagiWSUser:bizagiWSUser@ftp.Bizagi.com/ProcessCentral Para Solicitud de Vacaciones, Solicitud de Compra y Suscripcin de Plizas: ESB.zip Para Solicitud de Crdito: WsCreditRequest.zip 2. Descomprima la carpeta y cpiela en su ruta local del Default Web Site. Normalmente esta ruta es C: \Inetpub\wwwroot.

3. Abra el Administrador del IIS ya sea ejecutando el comando inetmgr o seleccionndolo de Herramientas Administrativas en el Panel de Control. 4. En el administrador IIS, despliegue el Default Web Site y busque la carpeta del servicio web (ESB o WsCreditRequest). Haga clic derecho sobre ella y seleccione Propiedades.

176

Copyright 2013 - Bizagi

5. En la ventana de propiedades, clic en el botn Crear y luego en el botn OK.

Copyright 2013 - Bizagi

177

Modificar la configuracin de la interfaz

1. Abra Bizagi Studio (o Management Console) y en la Vista de Mdulos seleccione Sistemas. Aqu vera que hay un Sistema por cada Plantilla de Proceso. 2. Despliegue los elementos hasta llegar a las interfaces. Para cada interfaz en el Sistema edite las Propiedades ya sea haciendo clic derecho en la interfaz o seleccionndola y usando el botn en el Men Estndar.

178

Copyright 2013 - Bizagi

3. En la propiedad URL del Servicio Web, cambie www.Bizagi.com por el nombre de su mquina o simplemente escriba localhost.

Copyright 2013 - Bizagi

179

4. Haga clic en Ok para guardar el cambio y contine con la siguiente interfaz.

2.7

Licenciamiento Bizagi BPM Suite

La Suite BPM de Bizagi BPM Suite se utiliza para ejecutar/automatizar Procesos. La Suite BPM de Bizagi requiere de licenciamiento, y le permite transformar sus procesos en ejecucin (workflows). La Suite BPM no ofrece capacidades adicionales de modelamiento: se especializa en la ejecucin de procesos. Si nicamente est buscando documentar y modelar sus procesos, slo necesita el Modelador gratuito. El modelo de licenciamiento de Bizagi BPM Suite es muy sencillo: se basa en usuarios nombrados. Usted necesita una CAL (Licencia de Acceso Cliente) independiente para cada usuario individual. Una CAL no es un producto de software; es una licencia que le da al Usuario el derecho a participar de un proceso en ejecucin y a acceder o utilizar los servicios del Servidor Bizagi BPM. El servidor como tal no requiere de licencias. Slo se requieren licencias para Usuarios (participantes en procesos) en el ambiente de produccin. Esta compra tambin le da el derecho de utilizar Bizagi de manera gratuita en ambientes de desarrollo y pruebas para la misma cantidad de usuarios que haya adquirido en produccin. Estos ambientes solo pueden ser utilizados para propsitos de desarrollo y pruebas, y bajo ninguna circunstancia podrn ser utilizados en produccin para el manejo de requerimientos y transacciones reales.

180

Copyright 2013 - Bizagi

La Suite BPM de Bizagi est disponible en mltiples ediciones para soportar las cambiantes necesidades de las organizaciones. Desde la Edicin Xpress de entry level para soluciones departamentales/proyectos piloto, hasta las ediciones corporativas para procesos de misin crtica y del core del negocio, satisfaciendo las necesidades ms exigentes en organizaciones de mayor tamao. Nuestras ediciones corporativas (Enterprise .NET y Enterprise JEE) son similares en trminos de funcionalidad, la nica diferencia es la plataforma en la que se ejecutan. Para mayor informacin acerca de las diferentes ediciones, por favor visite Compare las ediciones.

Usted tambin puede descargar una copia de evaluacin de la Suite BPM de Bizagi la cual no puede utilizarse para ningn otro propsito que la demostracin o evaluacin. La copia de evaluacin puede ser utilizada de manera gratuita para un mximo de diez (10) Usuarios en el caso de la Xpress Edition, y para un mximo de veinte (20) Usuarios en el caso de la Enterprise Edition. El perodo de evaluacin no est limitado en el tiempo y usted tiene la opcin de convertir sus derechos de evaluacin a derechos perpetuos o de suscripcin adquiriendo las respectivas licencias y activndolas. Para informacin por favor lea nuestro Acuerdo de licencia de usuario final (EULA).

Modelador de Procesos Bizagi

El Modelador de Procesos de Bizagi es utilizado para diagramar y documentar procesos; es un Freeware, y lo seguir siendo. Esto significa que usted puede descargar el software y usarlo gratuitamente sin restricciones de tiempo, para propsitos personales o de negocios. Usted no necesita licencias para diagramar y documentar sus procesos.

2.7.1

Licenciamiento de Bizagi explicado

Licencia Perpetua y Suscripcin

Ofrecemos 2 trminos de licenciamiento. Escoja el que mejor se ajuste a sus necesidades: Licencia perpetua: La licencia se paga una nica vez y el software puede ser utilizado por un periodo de tiempo indefinido. Suscripcin (anual): Usted paga una tarifa anual, y el software puede ser utilizado durante 1 ao. Para continuar utilizando el software, la suscripcin debe ser renovada anualmente. De lo contrario, debe dejar de utilizar el software. En el caso de las licencias perpetuas, al adquirir una nueva licencia perpetua de Bizagi tambin debe adquirir el primer ao de mantenimiento para cada licencia. Al final del primer ao tiene la opcin de renovar su mantenimiento, para que el software permanezca actualizado con la versin ms reciente. El Mantenimiento incluye: nuevas versiones de producto para mantener Bizagi actualizado, service packs, y soporte bsico de producto (sin SLAs). En el caso de la suscripcin, el Mantenimiento ya est incluido en la tarifa anual.

Llaves de Licencia
Despus de adquirir una licencia perpetua o suscripcin por primera vez usted recibir un email con la llave de la licencia, la cual se utiliza para licenciar Usuarios en el ambiente de produccin. Para activar la llave usted necesita ingresarla en Bizagi Studio a travs de la opcin de Administracin de licencia. Cuando una llave de licencia es activada en un servidor de produccin (o computador), usted ha

Copyright 2013 - Bizagi

181

creado lo que llamamos una instalacin.

Mantenimiento
Al adquirir Mantenimiento Bizagi (ya sea en adicin a licencias perpetuas o como parte de su suscripcin) usted recibe 1 ao de mantenimiento. El Mantenimiento incluye: nuevas versiones de producto para mantener Bizagi actualizado, service packs, y soporte bsico de producto (sin niveles de servicio SLAs). Usted recibir un email con detalles de una cuenta online para acceder al portal Bizagi. En la seccin de Soporte del portal Bizagi usted puede abrir tickets de soporte para reportar bugs o problemas, enviar sugerencias para mejora del producto o hacer consultas simples de funcionalidad. En la seccin de Compras del portal Bizagi usted podr ver y administrar la informacin de las licencias, como nmero de Usuarios por instalacin, llaves no utilizadas y fechas de expiracin. Tenga en cuenta que Bizagi ofrece 2 niveles de soporte: el soporte bsico incluido con sus licencias (sin SLAs) y el servicio de soporte Premium (con SLAs) el cual usted puede adquirir de manera independiente de acuerdo a sus requerimientos.

Renovaciones
El mantenimiento (para licencias perpetuas) y las suscripciones, para cualquier instalacin, expirarn un ao despus de la fecha de compra de las licencias. Usted recibir un recordatorio por email 30 das antes de la fecha de expiracin de su mantenimiento/suscripcin para que usted decida si desea renovar o no. Tambin recibir un recordatorio final el mismo da que su mantenimiento/suscripcin expira. Tenga en cuenta que usted puede comprar y activar su renovacin en cualquier momento antes de la fecha de expiracin. El nuevo periodo de mantenimiento/suscripcin anual siempre comenzar desde la expiracin actual, no desde la fecha de compra o de activacin. La renovacin del mantenimiento (para licencias perpetuas) provee 12 meses adicionales de actualizaciones Bizagi y soporte. En caso de no renovar el mantenimiento antes de la fecha de expiracin, perder los derechos de acceso a actualizaciones de producto y soporte tcnico; tambin perder el derecho a renovar el mantenimiento, lo cual significa que si desea tener acceso a actualizaciones Bizagi y servicios de soporte nuevamente, deber comprar licencias completas. Con relacin al producto, ya que usted adquiri una licencia perpetua, usted puede seguir utilizando el producto, pero nicamente en la versin de producto disponible en el momento de expiracin de su periodo de mantenimiento. Subscription renewal provides an additional 12 months of Bizagi usage, including updates and support. In case you decide not to renew, your Bizagi system will automatically stop working on the expiration date, your maintenance will be terminated and you will no longer have access to software upgrades and technical support. La renovacin de la suscripcin le meses, incluyendo actualizaciones sistema Bizagi dejar de funcionar cancelado y no tendr ms acceso permite continuar utilizando Bizagi por un perodo adicional de 12 de producto y soporte. En caso de no renovar la suscripcin, su automticamente en la fecha de expiracin, su mantenimiento ser a actualizaciones del software y soporte tcnico.

La renovacin del mantenimiento o de la suscripcin no genera llaves. Sin embargo, usted necesita actualizar la informacin de la nueva fecha de expiracin en el ambiente de produccin. Slo haga clic

182

Copyright 2013 - Bizagi

en el botn de "Actualizar Licencia en la opcin de Administracin de Licencia. Esta accin se comunica directamente con bizagi.com y actualiza la informacin necesaria para reflejar la compra de la renovacin.

Usuarios Adicionales
Al adquirir licencias de Usuarios adicionales, primero debe decidir si stas son necesarias para una instalacin existente o para una nueva. De esta manera, estarn asociadas a la instalacin correcta. Recuerde que cuando una llave de licencia es activada en un servidor de produccin (o computador) usted ha creado lo que llamamos una instalacin. Para la Xpress Edition exclusivamente, y para facilitar la administracin de usuarios/renovaciones, habr una nica fecha de renovacin por instalacin, y ser posible renovar el Mantenimiento/ suscripcin para la totalidad de los usuarios al mismo tiempo. Esto quiere decir que si usted adquiere Usuarios adicionales para la Xpress Edition durante el ao, se le cobrar el precio completo de un ao, pero la fecha de expiracin del Mantenimiento/suscripcin entonces vigente, permanecer sin modificacin. Para la Enterprise Edition cada compra tiene una fecha de expiracin independiente. Si desea unificar las fechas de renovacin en una sola, por favor contacte a un agente comercial. Al adquirir Usuarios adicionales para una instalacin existente usted debe comprar la misma edicin del producto (Xpress o Enterprise) y el mismo tipo de CALs que adquiri inicialmente, Perpetuas o Suscripcin. Esto ya que las llaves de las licencias son especficas para cada tipo de licencia y no funcionan en uno diferente. Adquirir Usuarios adicionales para una instalacin existente no genera llaves. Sin embargo, usted necesita actualizar la informacin de la compra en el ambiente de produccin. Tan slo siga el simple procedimiento para activar Usuarios adicionales. Usted tambin puede comprar Usuarios para una nueva instalacin. Esto es, si usted necesita comprar licencias para un servidor de produccin diferente al que utiliz para instalar su primera llave de licencia. Este caso se manejar como una primera compra y usted recibir una nueva llave de licencia para su segundo servidor de produccin. Tenga en cuenta que el proceso para comprar Usuarios adicionales para instalaciones existentes es diferente a aquel para comprar Usuarios para instalaciones nuevas. Para instrucciones, lea cmo comprar licencias Bizagi.

Actualizaciones
Bizagi ofrece una licencia especial para cambios de la Xpress Edition a la Enterprise Edition. Los cambios de edicin (Upgrades) son necesarios cuando usted ha alcanzado el lmite de 50 Usuarios o cuando necesita utilizar algunas de las funcionalidades disponibles nicamente en las ediciones Enterprise. Al hacer el cambio de edicin usted solo deber pagar la diferencia en el precio de la licencia (tenemos en cuenta la cantidad completa que usted pag por la edicin Xpress). En caso de que necesite ms licencias de Usuario usted debe comprar un upgrade para sus licencias Xpress existentes, y licencias completas Enterprise para el nmero de Usuarios adicionales. Por ejemplo, si necesita licenciar un total de 90 Usuarios, pero usted ya cuenta con 40 licencias Xpress, deber

Copyright 2013 - Bizagi

183

adquirir 40 upgrades y 50 licencias de Usuario completas de Enterprise.

Multiplexacin
El uso de hardware o software que reduce el nmero de Usuarios accediendo o utilizando el Software de Servidor (comnmente "multiplexando" o "agrupando" (pooling) hardware o software) no reduce el nmero de CALs necesarias para acceder o utilizar el Software de Servidor. La cantidad de CALs necesarias sera igual a la cantidad de entradas independientes al front-end de software o hardware multiplexado o agrupado Un ejemplo de esto es una aplicacin de front-end (portal) donde los usuarios finales completan una forma, y luego un proceso es iniciado en Bizagi a travs de un web service u otra interfaz.

Usuarios Externos (Internet)

Bizagi ofrece un tipo especial de licencias para usuarios externos (por internet). Se denomina Licencia de Iniciador, y le permite a los Usuarios iniciar casos y participar en las actividades subsiguientes (por ejemplo, ingresar informacin adicional, ajustar/actualizar informacin o documentos existentes) de la misma instancia de proceso (caso) que iniciaron. Las Licencias de Iniciador solo aplican para usuarios que NO sean empleados de la empresa que ha licenciado Bizagi. Para usuarios internos (empleados) deben ser adquiridas licencias completas, independientemente de la manera en que utilicen Bizagi. Los Iniciadores son licenciados por franjas de usuarios (1-1.000, 1.001-10.000, etc.), no por usuarios individuales. La Xpress Edition slo ofrece una franja (1-1000). Al igual que en el caso de las licencias completas, se ofrecen 2 trminos de licenciamiento: Perpetua y Suscripcin (anual). Escoja la que mejor se ajuste a sus necesidades.

Licencia Acadmica
Bizagi ofrece una licencia acadmica. Para utilizar Software identificado como "Software Acadmico" usted debe ser una Universidad o una institucin de educacin superior sin nimo de lucro. Usted puede instalar y utilizar el Software Bizagi en forma gratuita para un mximo de diez (10) Usuarios en cada instalacin. Los usuarios deben ser estudiantes, profesores o empleados autorizados. Usted puede usar el Software nicamente con fines educativos y no comerciales, incluyendo realizar investigacin acadmica o proveer servicios educativos. Para obtener una Licencia Acadmica Bizagi, una persona con la autorizacin suficiente para asumir compromisos a nombre de su institucin, debe confirmar que su establecimiento acepta los trminos y condiciones y debe completar el formulario de solicitud. Luego de enviar el formulario, usted ser contactado por email con los siguientes pasos en el proceso de solicitud. Si requiere informacin adicional acerca de cualquiera de nuestros tipos de licencia o trminos, por favor contctenos.

184

Copyright 2013 - Bizagi

2.7.2

Comprar licencias
Con el fin de comprar y administrar las licencias, las fechas de renovacin y periodos de mantenimiento correctamente, los pagos deben hacerse a travs de nuestra Tienda Online Bizagi, donde usted ser podr de seleccionar un mtodo de pago seguro. Le recomendamos primero entender muy bien cmo funcionan las licencias de Bizagi. Luego, siga estos pasos cuidadosamente para adquirir licencias BizAgi.

Notas: Recuerde que cuando una clave de licencia se activa en un servidor de produccin (o computador) se crea lo que llamamos una in stalaci n . El pago con Tarjeta de crdito es el mtodo ms rpido y sencillo ya que las transacciones se registran en tiempo real. Las transferencias bancarias pueden tardar de 3-5 das hbiles y se debe transferir el dinero a una cuenta bancaria en Alemania. Usted est comprando desde Bizagi Limited, una compaa registrada en el Reino Unido. Si usted se encuentra en el Reino Unido siempre se le cobrar el IVA. IVA no se cobra si usted se encuentra en un pas de la UE y se introduce un nmero de IVA vlido, o si usted se encuentra en un pas fuera de la UE. Tenga en cuenta que el procedimiento vara si va a comprar por primera como cliente nuevo, o si usted es un cliente existente.

Clientes existentes
Los clientes que ya han comprado un producto o servicio de Bizagi y desean comprar ms usuarios de una instalacin existente, renovar, comprar licencias para nuevas instalaciones, o comprar otros productos pueden hacerlo a travs del Portal de Bizagi. Para comprar licencias para usuarios adicionales, debe decidir si son necesarias para una instalacin existente o para una nueva instalacin. De esta forma se asociarn a la instalacin apropiada. 1. Entre al Portal de Bizagi con sus credenciales y seleccione Co m p ras en el men principal.

Copyright 2013 - Bizagi

185

2. Vaya a la pestaa M i licen cias, donde podr ver las instalaciones registradas que tenga. Haga clic en la opcin que desee de los siguientes elementos: Para comprar usuarios adicionales de una instalacin existente, haga clic en el botn naranja junto al resumen de la instalacin, Co m p rar u su ario s ad icio n ales (1). La compra ser vinculada a la instalacin seleccionada. En la compra de usuarios adicionales para una instalacin existente, debe comprar la misma edicin del producto (Xpress o Enterprise), y el mismo tipo de CAL (perpetuo, o suscripcin) que adquiri en

186

Copyright 2013 - Bizagi

primer lugar. Esto se debe a las claves de licencia son especficas para cada tipo de licencia y no funcionar en una diferente. Si su licencia ha caducado usted no podr comprar ms licencias. Renueve si la suscripcin o mantenimiento si stos estn cerca de la fecha de vencimiento, por medio del botn de Ren o v ar (2). La compra ser vinculado a la instalacin seleccionada. En la parte inferior de la pantalla hay un botn para Co m p rar licen cias p ara n u ev as in stalacio n es (3). Se le presentar una lista con todos los productos, para que usted pueda seleccionar el que desee.

3. Usted ser llevado a la tienda online. El primer paso es crear la O rd en d e co m p ra. Revise el producto y la cantidad requerida. Haga clic en Co n tin u ar para pasar a la siguiente etapa.

4. Actualice la informacin de cliente de ser necesario. De click en Continuar. IMPORTANTE: asegrese de ingresar la informacin exacta de su cliente incluyendo la direccin de email, ya que esta informacin ser encriptada en la llave de la licencia y utilizada para crear una cuenta online para soporte de producto.

Copyright 2013 - Bizagi

187

5. Seleccione el mtodo de pago entre: Paypal (Tarjeta de crdito): esta opcin le llevar a la pgina de PayPal para completar su compra. Transferencia bancaria: Esta opcin le llevar a una pgina con instrucciones y la informacin para completar la compra.

6. Despus de completar el pago usted ser redirigido a la pgina de confirmacin en la tienda online. Una vez recibido el pago, le enviaremos una confirmacin de pedido por correo electrnico con la informacin del producto y las claves de activacin.

188

Copyright 2013 - Bizagi

Slo para la Edicin Xpress Slo habr una fecha de renovacin por instalacin. Se podr renovar el mantenimiento / suscripcin por el total de los usuarios de la instalacin. Esto significa que si durante el ao usted compra usuarios adicionales para la Edicin Xpress, se le cobrar el precio total para todo el ao, pero la fecha de vencimiento del mantenimiento/suscripcin se mantendr sin cambios.

Clientes nuevos
1. En Bizagi Studio o el Management Console vaya a la pestaa A y u d a y seleccione el men A d m in istraci n d e licen cias. Seleccione el botn Co m p rar ah o ra en la esquina inferior izquierda.

2. El sistema lo llevar a un formulario de contacto donde debe introducir su informacin. Un representante de ventas se comunicar con usted en breve. 3. Usted recibir un enlace que le dar acceso a la tienda online con el producto (s) requerido. Slo

Copyright 2013 - Bizagi

189

debe seguir los pasos para completar la compra. Los pasos son los mismos descritos anteriormente. 4. Despus de completar el pago ser redirigido a una pgina de confirmacin en la tienda online. Una vez recibido el pago, le enviaremos una confirmacin de pedido por correo electrnico con la informacin del producto y claves de activacin. Usted recibir un segundo correo electrnico con los detalles de su cuenta en lnea con las instrucciones para activarla. La cuenta le permitir acceder al portal Bizagi.

2.7.3

Activar licencias

Este artculo aplica para a las Ediciones. NET. Consulte Activar Licencias JEE si esa es su caso. Para activar licencias debe acceder a la opcin A d m in istraci n d e licen cias que se encuentra en la pgina de Bienvenida a Bizagi o en la pestaa A y u d a, de Bizagi Studio o del Management Console.

Notas Recuerde que cuando una clave de licencia se activa en un servidor de produccin (o computadora) se crea lo que llamamos una in stalaci n .

Renovaciones
Despus de un ao de la compra inicial de su licencia, usted debe renovar su mantenimiento (para licencias perpetuas) o renovar su suscripcin anual. Mientras que sus licencias estn activas tambin pueden comprar usuarios adicionales para las instalaciones actuales. Tenga en cuenta que usted NO recibir claves adicionales de licencia de renovaciones o usuarios adicionales. Despus de completar el proceso de compra (ya sea para Xpress, Enterprise NET. O

190

Copyright 2013 - Bizagi

Enterprise JEE) debe activar su renovacin o usuarios adicionales. Vaya a A d m in istraci n d e Licen cias y haga clic en el botn A ctu alizar licen cia.

Una nueva ventana se abrir con lo siguiente: La informacin de la instalacin actual en la parte inferior de la pantalla. El tipo de licencia, el nmero de usuarios con licencia y la fecha de caducidad. Un botn para comprar Licencias: al hacer clic en el botn Co m p rar ah o ra usted ser llevado al sitio Co n tcten o s, donde podr ingresar sus datos y un representante de ventas se comunicar con usted en breve.

Licencia Primera vez

Una CAL (Licencia de Acceso a Cliente) es necesaria para cada persona ("Usuario") que acceda o use el Servidor del Software. Una CAL no es un producto de software; ms bien, es una licencia que le da a un Usuario el derecho para participar en un proceso en ejecucin y para acceder o usar los servicios del Servidor de Bizagi BPM. El servidor por s mismo no necesita de alguna licencia. Tan pronto como su orden es autorizada, usted recibir un mensaje de correo electrnico con una llave de licencia utilizada para licenciar a los usuarios en Ambiente de produccin. Cuando la llave es recibida deben se debe ingresar a travs de Bizagi Studio o Management Console a travs de la opcin Administracin d e Licen cias. Una nueva ventana aparecer. Seleccione la instalacin (servidor) que debe ser licnenciada. Si el servidor no aparece en la lista desplegable, escriba el nombre y haga clic en Co n ectar.

Copyright 2013 - Bizagi

191

La primera vez que introduzca la clave no habr informacin y ver un mensjae: "Servidor licenciado para propsitos de desarrollo y pruebas solamente".

192

Copyright 2013 - Bizagi

Haga clic en el botn In g rese la llav e d e licen cia y digite o pegue la llave de licencia en el espacio suministrado. Haga clic en O K para guardar los cambios.

Se mostrara la informacin de la licencia para el servidor.

Copyright 2013 - Bizagi

193

Note La activacin de la clave y la renovacin de la licencia requieren una conexin a Internet. Si por alguna razn esta no est disponible refirase a Cmo activar una clave de licencia en un servidor sin conectividad a Internet.

2.7.3.1

Activar licencias para la Enterprise JEE

Prerequisitos
Los siguientes son prerequisitos para activar la licencia para el Ambiente de produccin en un servidor de Aplicacin JEE: Tener JRE instalado en el servidor a licenciar. Tener la variable de entorno "JAVA_HOME" configurada apropiadamente. Si su proyecto utiliza WebSphere, asegrese de tener configurada la variable de entorno JAVA_HOME de manera que apunte al Java que se usa por la JVM embebida de WebSphere. Tener instalado el JEEConsoleManager de Bizagi. La instalacin de la consola de administracin JEE se hace descomprimiendo el archivo .rar entregado por Bizagi en una ruta local. Esta ruta local se referenciar a partir de ahora como: <JEECONSOLE_HOME>.

194

Copyright 2013 - Bizagi

Procedimiento
El siguiente procedimiento se debe desarrollar para cada uno de los servidores en su ambiente de produccin.

Ejecute el JEEConsoleManager como ROOT

Ejecute el servicio como el usuario administrador "ROOT", en el servidor a licenciar. Para iniciar el servicio, ejecute la consola administrativo (de acuerdo a su sistema operativo). Para Windows, ejecute el archivo localizado como <JEECONSOLE_HOME>\bin\startconsole.bat Para Linux, ejecute el archivo localizado como <JEECONSOLE_HOME>\bin\startconsole.sh Nota Este servicio utilizado para la activacin de la licencia utilizar el puerto TCP 5680. Se recomienda asegurar que ningn otro servicio utilice este puerto y que no hay un firewall que bloquee la solicitud de este puerto para activaciones remotas.

Ingrese la Licencia
Ejecute Bizagi Studio o Bizagi Management Console desde una mquina que tenga: acceso de red al servidor de Aplicacin JEE a licenciar y conexin a internet, La activacin de la llave y la renovacin de la licencia requiere una conexin a Internet, pero la aplicacin web en si misma no.

Copyright 2013 - Bizagi

195

D clic en la opcin de Administracin de Licencia:

Licencia por primera vez Ingrese el nombre del servidor o la IP y d clic en Co n ectar.

196

Copyright 2013 - Bizagi

La primera vez que ingrese la llave no habr informacin de la licencia disponible, solo dir: "Servidor licenciado nicamente para propsitos de desarrollo y pruebas".

Copyright 2013 - Bizagi

197

D clic en el botn Ingresar llave de Licencia e ingrese o pegue la llave de licencia en el espacio destinado para ello. De clic en OK para guardar los cambios. Se mostrar la informacin de la licencia para la instalacin.

Renovaciones Despus de un ao desde la compra inicial de sus licencias, usted puede renovar su mantenimiento (para licencias perpetuas) o renovar su suscripcin anual. Mientras su licencias estn activas usted tambin puede comprar usuarios adicionales para las instalaciones actuales. Por favor tenga en cuenta que usted no recibir llaves de licencia despus de comprar renovaciones o usuarios adicionales. Despus de completar el proceso de compra (ya sea para edicin Xpress, Enterprise.NET o Enterprise JEE) usted necesita activar su renovacin o usuarios adicionales. Vaya a A d m in istraci n d e Licen cias y d clic en le botn A ctu alizar Licen cia.

198

Copyright 2013 - Bizagi

Detener el servicio JEEConsoleManager

Ahora que la licencia ha sido activada, este servicio iniciado con el usuario administrador ROOT se puede detener. Para deterner el servicio, ejecute "stopconsole.bat" o "stopconsole.sh" (de acuerdo a su sistema operativo). Para Windows, ejecute el archivo localizado como <JEECONSOLE_HOME>\bin\startconsole.bat Para Linux, ejecute el archivo localizado como <JEECONSOLE_HOME>\bin\startconsole.sh Si la aplicacin web ya ha sido iniciada y se esta ejecutando mientras se activaba las licencia, usted deber reiniciar el servidor de aplicacin para actualizar la activacin de la licencia.

Copyright 2013 - Bizagi

199

2.7.3.2

Activar una llave de licencia sin acceso a Internet Para propsitos de desarrollo, Bizagi no requiere una licencia ni acceso a Internet. Toda su funcionalidad esta disponible con excepcin del proceso de Deployment y un lmite de solo 10 usuarios que pueden participar en un proceso. Para utilar Bizagi en un ambiente de produccin esta restricciones deben ser removidas comprando una licencia (CAL perpetua o CAL por suscripcin). Despues de la compra de una licencia, se recibe una llave y se requiere acceso a internet para activarla. Si el servidor del ambiente de produccin se encuentra en una red aislada sin coneccin a Internet, la llave debe ser activada a travs del siguiente procedimiento: 1. Instalar Bizagi en un computador con una conexin a Internet que tiene acceso al servidor sin conexin a Internet (verifique si es posible para hacer un Ping o Telenet). 2. Ejecute Bizagi Studio en este computador y, en la ventana de Bienvenida a Bizagi, d clic en el icono e A d m in istraci n d e Licen cia.

200

Copyright 2013 - Bizagi

3. Desde la lista desplegable seleccione el servidor donde se necesita registrar la llave de licencia, o escribalo si no aparece. Es posible que el nombre no pueda ser resuelto, si este es el caso ingrese la direccin IP del sevidor.

4. D clic en Ingresar llave de licencia y escriba o pegue la llave de licencia. Luego de clic en O K para guardar y activar la llave.

Copyright 2013 - Bizagi

201

2.7.4

Administrar licencias

Mover licencias a un nuevo servidor o en un servidor existente

Usted puede mover sus licencias compradas a un nuevo servidor o en un servidor existenteen su empresa. Tenga en cuenta que para mover licencias es necesario que los servidores tengan EL MISMO PRODUCTO. Para las ediciones Enterprise usted puede mover todos los usuarios de una licencia o un nmero determinado de usuarios, de acuerdo a sus necesidades. Tenga en cuenta que cada compra (licencia) tiene una fecha de vencimiento distinta. Si desea unificar las fechas de renovacin en una sola, por favor pngase en contacto con un representante de ventas. Para el Edicin Xpress usted puede mover todos los usuarios de una licencia. El nmero total de usuarios en un servidor no puede exceder de 50 usuarios. Si intenta mover usuarios y estos suman ms de 50, aparecer un mensaje de error. 1. Entre al Portal de Bizagi con sus credenciales y seleccione Co m p ras en el men principal. A continuacin, seleccione M o v er Licen cias.

2. Identifique la licencia que desea mover y seleccione si ser a un N u ev o serv id o r o un Serv id o r ex isten te. La imagen de arriba muestra una instalacin con los productos Enterprise. Hay dos licencias adquiridas. En este caso, es posible mover un nmero menor al total de los usuarios licenciados para una o ambas licencias. Si las licencias pertenecieran a la Edicin Xpress podran moverse el nmero total de usuarios.

202

Copyright 2013 - Bizagi

Un mensaje de error aparecer si intenta mover ms usuarios de los que tiene la licencia. Cuando se mueven usuarios a un servidor existente, en la lista desplegable se mostrarn los servidores que tienen el mismo producto. 3. Si selecciona un servidor nuevo, una nueva clave de licencia ser generada en pantalla y debe ser activada en Bizagi Studio o el Management Console. 4. Si selecciona un servidor existente, cuando el proceso de mover se termina, un mensaje de xito que aparecer. Puede actualizar la licencia en Bizagi Studio o el Management Console.

Nota Usted no recibir un email de confirmacin. Sin embargo, una vez que el proceso mover las licencias ha terminado, puede comprobar el estado de stas en el men M is licen cias. El movimiento de licencias siempre requiere conexin a Internet.

Mover licencias de llaves sin usar

Es posible mover o asociar licencias sin usar a un servidor en el que ya tenga una compra. 1. Entre al Portal de Bizagi con sus credenciales y seleccione Co m p ras en el men principal. A continuacin, seleccione M o v er Licen cias.

Copyright 2013 - Bizagi

203

2. Identifique la licencia que desee mover de la seccin Llav es sin u sar y seleccione un servidor de la lista desplegable. Haga clic en M o v er esta licen cia.

204

Copyright 2013 - Bizagi

3. Usted no recibir un correo de confirmacin. Si necesita confirmar que la licencia ha sido movida compruebe el estado de sus licencias en el men M is licen cias. 4. Actualice la Licencia de Bizagi Studio o Management Console.

Notas Tenga en cuenta que los movimientos de licencias se realizan entre servidores que tienen el mismo producto. Usted no recibir un email de confirmacin. Sin embargo, una vez que el proceso moverlas ha

Copyright 2013 - Bizagi

205

terminado, puede comprobar el estado de sus licencias en el men M is licen cias. Para todas las ediciones las llaves no utilizadas mueven todos los usuarios de la licencia. Para mover licencias siempre se necesita conexin a Internet. Para la Edicin Xpress el nmero total de usuarios en un servidor no puede exceder de 50 usuarios. Si intenta mover usuarios y suman ms de 50, un mensaje de error aparecer.

Licencias para servidores de prueba

Bizagi le permite generar hasta tres (3) licencias para servidores de prueba, por cada licencia que ha adquirido. Estas licencias para servidores de prueba se pueden activar en el entorno de prueba independiente de la licencia original. Cada licencia de prueba se generar basndose en el producto exacto de la licencia original, y contendr el mismo nmero de usuarios, as como la misma fecha de caducidad. Tenga en cuenta que estas licencias no se pueden mover y por lo tanto se pueden aplicar una vez a un servidor. SI usted tiene varias compras, las licencias se generarn PARA EL TOTAL de licencias compradas. Antes de generar licencias para servidores de prueba analice si realmente las necesita: Bizagi trae 20 usuarios por defecto para el entorno de pruebas con la versin Enterprise, y 10 usuarios para la edicin Xpress. Las licencias para servidores de pruebas son tiles cuando se necesita muchos usuarios para probar en el ambiente de pruebas, de lo contrario no es necesario para generar ms. 1. Entre al Portal de Bizagi con sus credenciales y seleccione Co m p ras en el men principal. A continuacin, seleccione Licen cias p ara serv id o res d e p ru eb a.

2. Haga clic en Gen erar Licen cia. Este procedimiento crear automticamente una licencia de pruebas con el mismo producto, mismo nmero de usuarios y la fecha de expiracin de la original.

206

Copyright 2013 - Bizagi

3. Las Licencias creadas se mostrarn. Recuerde que usted puede crear hasta tres licencias por cada licencia adquirida. Una vez que haya creado tres licencias, el botn Generar desaparecer. 4. Copie y pegue el cdigo de licencia en el Management Console para activarlo.

Ver y descargar facturas

Para ver y descargar sus facturas ingrese al Portal de Bizagi con sus credenciales. Seleccione Co m p ras en el men principal y luego haga clic en F actu ras en el sub-men. Tenga en cuenta que usted est comprando directamente de Bizagi, sin intermediarios involucrados.

Copyright 2013 - Bizagi

207

208

Copyright 2013 - Bizagi

Parte III
Automatizacin del Proceso

3
3.1

Automatizacin del Proceso

Los siguientes captulos lo guirarn a travs del proceso de automatizacin, en una gua paso a paso.

Mi primer proceso
Para realizar una evaluacin rpida de Bizagi BPM Suite hemos creado un ejercicio prctico que muestran cmo funciona Bizagi. Mi primer proceso es una gua paso-a-paso que le mostrar cmo definir y ejecutar un proceso con Bizagi. Este ejercicios lo guiar a travs de los conceptos bsicos de Bizagi . Usted estar ejecutndolo en muy corto tiempo. Para cursos de entrenamiento en lnea visite ENTRENAMIENTO (ELEARNING) donde encontrar varios cursos didcticos (es necesario registrarse).

Mi primer proceso
Una compaa ha iniciado una estrategia de BPM y ha elegido a Bizagi como herramienta para desarrollarla. Usted ha sido seleccionado para implementar el proceso de Solicitud de Vacaciones. La informacin sobre el proceso y los datos a ser controlados y visualizados pueden ser encontrados en las pginas del archivo. Siga paso a paso las instrucciones de este manual y al final usted habr definido y ejecutado el proceso de Solicitud de Vacaciones. Clic para descargar Mi primer proceso (Duracin estimada 3 horas)

Mi segundo proceso
Una vez haya completado Mi Primer Proceso puede continuar con Mi Segundo Proceso para conocer temas ms avanzados con Bizagi. Clic para descargar Mi segundo proceso (Duracin estimada 4 horas)

3.2

Modelando un Proceso
Modelar un proceso es el primer paso en cualquier proceso de automatizacin. Modelar un proceso es una tarea sencilla e iterativa que busca representar unas condiciones de negocio en un diagrama de flujo utilizando formas y smbolos.

Modelar sus procesos utilizando la BPM Suite de Bizagi

Para crear un diagrama en Bizagi vaya al primer paso del asistente. Con solo dar clic en la opcin Nuevo Proceso puede empezar a diagramar. Clic para ver cmo diagramar procesos.

210

Copyright 2013 - Bizagi

Modelar sus procesos utilizando el Modelador de Procesos de Bizagi

Bizagi, como complemento al Modelador de Procesos de la Suite de Bizagi, ofrece otra poderosa herramienta para visualizar sus diagramas, modelar y documentar sus procesos de negocio. El Modelador de Procesos de Bizagi es una herramienta gratuita con una interfaz amigable y con funcionalidades intuitivas que le permitirn modelar procesos fcilmente utilizando el estndar BPMN. De forma alternativa al Modelador incluido dentro de la Suite de Bizagi, usted podr utilizar el Modelador de Procesos de Bizagi por s solo como herramienta para modelamiento de procesos. Presentamos una funcionalidad con la que usted podr, fcilmente exportar procesos nuevos o procesos existentes a la Suite BPM de Bizagi. Una vez su proceso est completo y listo para automatizar, presione el botn Ejecutar Workflow para que rpidamente y sin esfuerzos exporte el diagrama a la Suite BPM de Bizagi. Un asistente lo guiar a travs de los pasos necesarios para transformar sin problemas el modelo en una aplicacin ejecutable (workflow). Si usted no esta familiarizado con el Modelador de Procesos de Bizagi lea el artculo Productos Relacionados.

Copyright 2013 - Bizagi

211

Bizagi tambin permite importar sus procesos diagramados en el Modelador de Procesos de Bizagi a la Suite de BPM de Bizagi. Son de clic en la opcin Importar Proceso y siga las instrucciones descritas en Cmo importar un proceso?

212

Copyright 2013 - Bizagi

3.2.1

Crear un proceso
Es muy fcil y rpido crear un diagrama de procesos en Bizagi. Para demostrar la facilidad con la que se hace vamos usar el proceso de Solicitud de Compras. Los siguientes son los pasos necesarios para crear el proceso: Una Orden de Compras es creada El jefe inmediato del empleado aprueba, rechaza o solicita cambios a la Orden. Se deben solicitar cotizaciones para seleccionar el Proveedor. Se crea una Orden de Compra. La Orden de Compra es enviada al Proveedor. La Orden de Compra es creada en el ERP de la compaa. 1. Para crear un nuevo proceso de clic en la opcin Nuevo Proceso (Paso 1.Modelo de Proceso) en el asistente.

Copyright 2013 - Bizagi

213

2. Nombre su proceso y luego de clic en Ok. En el momento que abra la ventana del modelador, usted estar listo para empezar a diagramar. El primer carril (Lane) del contenedor (Pool) es creado de forma automtica.

3. Adiciones carriles (Lanes) para incluir participantes dentro del proceso. Arrastre y suelte, desde la paleta del lado izquierdo, un carril por cada participante. En nuestro ejemplo, hemos incluido tres carriles: Uno por el Supervisor Inmediato (Jefe), otro por el solicitante y el ltimo para el Departamento de Compras.

214

Copyright 2013 - Bizagi

4. Incluya un punto de inicio dentro del proceso. Arrastre y suelte un Evento de inicio desde la paleta.

5. Contine diagramando su proceso usando el Pie Menu. Seleccione el siguiente elemento y arrstrelo

Copyright 2013 - Bizagi

215

y sultelo donde desea localizarlo.

6. Para conectar dos elementos en el flujo de secuencia, selecciones el objeto desde le Pie Menu y arrstrelo y sultelo sobre el segundo elemento, realizando esta accin se conectaran de forma automtica.

216

Copyright 2013 - Bizagi

7. Contine seleccionado las formas necesarias hasta que su diagrama este completo. 8. Para redimensionar el contenedor, seleccione el borde de la esquina apropiada y arrastre hasta encontrar el tamao deseado.

Copyright 2013 - Bizagi

217

Las siguiente imagen muestran el diagrama del proceso Solicitud de Compra.

3.2.2

Editar un proceso
Una vez haya diagramado su proceso, usted podra necesitar cambiar elementos, por ejemplo, incluir conectores adicionales o agregar ms figuras para mejorar y completar el modelo. Continuemos con nuestro proceso de Solicitud de Compras para ejemplificar como realizar estos cambios de forma sencilla. En el primer paso del asistente, de clic en la opcin Editar Proceso. Esto abrir modelador con el proceso.

218

Copyright 2013 - Bizagi

Moviendo elementos
Si usted necesita mover elementos del diagrama de un lugar a otro, de clic sobre l y arrstrelo hasta la nueva posicin.

Eliminando elementos
Si necesita eliminar un elemento del diagrama, de clic sobre el y presione el botn Delete.

Cambiar / Transformar elementos

La siguiente imagen muestra el proceso inicial de Solicitud de compra que diseamos. Sin embargo, necesitamos hacer algunos ajustes. Ya que existen correos electrnicos que se deben enviar de forma automtica dependiendo de la decisin del jefe inmediato, es necesario cambiar la tarea de Notificacin a una tarea de Script. La tarea Cotizaciones es un Subproceso donde se deben realizar varias actividades para poder escoger un proveedor. La tarea Orden de Compra tambin es un Subproceso donde la Orden de Compra es enviada al proveedor y creada en el sistema ERP.

Copyright 2013 - Bizagi

219

El modelador permite cambiar elementos de la misma categora. Usted no es necesario incluir otro elemento al proceso, solamente debe cambiar el elemento existente. 1. Para cambiar la tarea de Notificacin a una tarea de Script, de clic derecho sobre el elemento del diagrama y seleccione el Tipo de Tarea del men que se ha desplegado. Escoja el tipo apropiado para la tarea de la lista desplegable.

220

Copyright 2013 - Bizagi

2. Realice el mismo procedimiento para las otras dos tareas de Notificacin La siguiente imagen muestra el progreso hasta este momento.

3. Para transformar la tarea Cotizaciones en un Subproceso, de clic derecho sobre la tarea y seleccione la opcin Transformar en Subproceso del men. Repita el procedimiento en la tarea Orden

Copyright 2013 - Bizagi

221

de Compra.

Clic para ms informacin sobre tipos y usos de Subprocesos.

Incluir fases (Milestones)

Las fases (Milestones) son sub divisiones del proceso, las cuales son utilizadas como puntos de referencia. Ellas ayudan a los lectores ha entender las diferentes etapas que conforman el proceso. Vamos a incluir tres fases para determinar el estado de cada actividad dentro del proceso. 1. Para incluir una fase, arrastre el elemento desde la paleta y ubquelo sobre el diagrama. Arrastre y suelte otras dos fases.

222

Copyright 2013 - Bizagi

2. Arrastre y suelte los elementos que pertenecen a la fase.

3. Para renombrar una fase de doble clic sobre ella o presione la tecla F2 o de clic derecho sobre ella y seleccione la opcin editar texto del men.

Copyright 2013 - Bizagi

223

3.2.3

Importar un proceso
Diagramar un proceso requiere de mucha dedicacin, por lo qu es comn que las organizaciones dediquen una gran cantidad de tiempo y recursos para est tarea, tambin es posible que utilicen diferentes herramientas para diagramacin. Importar modelos existentes agiliza el proceso y apoya el mejoramiento continuo de estos. Si su proceso ha sido modelado utilizando el Modelador de Procesos de Bizagi, ste puede ser importado a Bizagi Studio para ser utilizado dentro del proyecto. Para importar sus diagramas siga los pasos mencionados a continuacin.

1. En el primer paso del asistente de clic en la opcin Importar Proceso.

224

Copyright 2013 - Bizagi

2. En la nueva ventana, seleccione el modelo que desea importar al proyecto actual.

Copyright 2013 - Bizagi

225

ASEGRESE QUE EL PROCESO HAYA SIDO GUARDADO EN EL FORMATO EXPORTAR A MODELO DE DIAGRAMAS DE BIZAGI V1.6 ANTES DE IMPORTAR.

226

Copyright 2013 - Bizagi

3. Defina un nombre para su proyecto y seleccione la Aplicacin donde desea crearlo. Luego de clic en OK.

4. Su proceso ser abierto en modo de edicin. Ahora usted esta listo para automatizar.

3.2.4

Modelado para ejecucin

Para asegurar diagramas precisos, es importante familiarizarse con el estndar de notacin para modelado de procesos BPMN. La siguiente es una breve explicacin sobre las figuras que utiliza el estndar BPMN.

Figuras del estndar BPMN

Los aspectos grficos de BPMN se organizan en categoras especificas.

Copyright 2013 - Bizagi

227

Actividades
Las actividades representan trabajos o tareas llevadas a cabo por miembros de la organizacin. Se ejecutan de manera manual o automtica (realizadas por un sistema externo o de usuario) y pueden ser atmicas o no atmicas (compuestas). Las actividades se clasifican en tareas y Subprocesos.

Tareas
Las tareas son actividades atmicas utilizadas cuando el trabajo que se esta realizando no se puede descomponer a un nivel ms detallado. Las tareas son llevadas a cabo por una persona y/o por una aplicacin.

ELEMENTO

DESCRIPCIN Es una actividad atmica dentro de un flujo de proceso. Se utiliza cuando el trabajo en proceso no puede ser desglosado a un nivel ms bajo de detalle.

NOTACIN

Tarea

Tarea de Servicio

Es una tarea que utiliza algn tipo de servicio que puede ser Web o una aplicacin automatizada.

Tarea de Recepcin

Es una tarea diseada para esperar la llegada de un mensaje por parte de un participante externo (relativo al proceso).

Tarea de Envo

Es una tarea diseada para enviar un mensaje a un participante externo (relativo al proceso).

Tarea de Script

Es una tarea que se ejecuta por un motor de procesos de negocio. El usuario define un script en un lenguaje que el motor pueda interpretar.

Tarea Manual

Es una tarea que espera ser ejecutada sin la asistencia de algn motor de ejecucin de procesos de negocio o aplicacin.

Subprocesos
Un Subproceso es una actividad compuesta que se incluye dentro de un proceso. Compuesta significa que puede ser desglosada a niveles ms bajos, esto es, que incluye figuras y elementos dentro de ella.

228

Copyright 2013 - Bizagi

ELEMENTO

DESCRIPCIN Es una actividad cuyos detalles internos han sido modelados utilizando actividades, compuertas, eventos y flujos de secuencia. La forma tiene una borde delgado.

NOTACIN

Subproceso Embebido

Subproceso Reusable

Identifica un punto en el flujo donde se invoca un proceso pre-definido. Los procesos reusables se conocen como Actividades de Llamada en BPMN. La forma tiene un borde grueso. Es un Subproceso cuyo comportamiento es controlado a travs de un protocolo de transaccin. Este incluye los tres resultados bsicos de una transaccin: Terminacin exitosa, terminacin fallida y evento intermedio de cancelacin.

Subproceso transaccional

Subproceso mltiple

Los Subprocesos pueden repetirse secuencialmente comportndose como un ciclo. El ciclo multi-instancia permite la creacin de un nmero deseado de instancias de actividad que pueden ser ejecutadas de forma paralela o secuencial.

Compuertas
Las compuertas se utilizan para controlar la divergencia y convergencia de flujos de secuencia. Determinan ramificaciones, bifurcaciones, combinaciones y uniones en el proceso. El trmino Compuerta implica que hay un mecanismo que permite o limita el paso a travs de la misma.

ELEMENTO

DESCRIPCIN De divergencia: Se utiliza para crear caminos alternativos dentro del proceso, pero solo uno se selecciona. De convergencia: Se utiliza para unir caminos alternativos. Representa un punto de ramificacin en los procesos donde los caminos alternativos que siguen la compuerta estn basados en eventos que ocurren.

NOTACIN

Compuerta Exclusiva

Compuerta Basada en Eventos

Copyright 2013 - Bizagi

229

Cuando el primer evento se dispara, el camino que sigue a ese evento se usar. Los caminos restantes sern deshabilitados. De divergencia: Se utiliza para crear caminos alternativos sin evaluar condicin alguna. Compuerta Paralela De convergencia: Se utiliza para unir caminos alternativos. Las compuertas esperan todos los flujos que concurren en ellas antes de continuar. De divergencia: Se utiliza para controlar puntos de decisin complejos en los procesos. Crea caminos alternativos dentro del proceso utilizando expresiones. De convergencia: Permite continuar al siguiente punto del proceso cuando una condicin de negocio se cumple. De divergencia: Representa un punto de ramificacin en donde las alternativas se basan en expresiones condicionales. La evaluacin VERDADERA de una condicin no excluye la evaluacin de las dems condiciones. Todas las evaluaciones VERDADERAS sern atravesadas por un token. De convergencia: Se utiliza para unir una combinacin de caminos paralelos alternativos. NOTA: Un token representa una unidad de trabajo que es recibida por un proceso y transformada durante la ejecucin de las actividades del flujo del proceso.

Compuerta Compleja

Compuerta Inclusiva

Eventos
Un evento es algo que sucede durante el curso del proceso, afectando el flujo y generando un resultado. Para hacer que un evento sea receptor o el que lanza el mensaje se debe dar clic derecho sobre la figura y seleccionar Lanza el evento. Esta opcin habilita o deshabilita el comportamiento (aplica para algunas figuras de acuerdo a lo que se describe a continuacin).

Eventos de Inicio
ELEMENTO Evento de Inicio Simple DESCRIPCIN Indica dnde se inicia un proceso. No tiene algn comportamiento particular. NOTACIN

230

Copyright 2013 - Bizagi

Evento de Inicio de Mensaje

Se utiliza cuando el inicio de un proceso se da al recibir un mensaje de un participante externo.

Evento de Inicio de Temporizacin

Se utiliza cuando el inicio de un proceso ocurre en una fecha o tiempo de ciclo especfico. (e.g, todos los viernes) El inicio de un proceso se da por la llegada de una seal que ha sido emitida por otro proceso. Tenga en cuenta que la seal no es un mensaje; los mensajes tienen objetivos especficos, la seal no.

Evento de Inicio de Seal

Eventos Intermedios
ELEMENTO Evento Intermedio Simple DESCRIPCIN Indica que algo sucede en algn lugar entre el inicio y el final de un proceso. Esto afectar el flujo del proceso, pero no iniciar (directamente) o finalizar el mismo. Indica que un mensaje puede ser enviado o recibido. Si un proceso est esperando por un mensaje y ste es capturado, el proceso continuar su flujo. El evento que lanza un mensaje se identifica con una figura sombreada. El evento que capta un mensaje se identifica con una figura sin relleno. Indica un retraso dentro del proceso. Este tipo de evento puede ser utilizado dentro de un flujo secuencial para indicar un tiempo de espera entre actividades. Este evento se utiliza para conectar dos secciones del proceso. Los eventos de enlace pueden ser utilizados para crear ciclos o evitar lneas de secuencia de flujo largas. Si en un proceso hay dos enlaces (uno que lanza y otro que recibe) el Modelador entender que estn unidos. Si hay dos que lanzan y uno que recibe el Modelador entender que los que lanzan estn unidos al que recibe. Si hay varios que lanzan y que reciben los nombres de las 'parejas' deben ser iguales para que el Modelador sepa cul NOTACIN

Evento de Mensaje

Evento de Temporizacin

Evento de Enlace

Copyright 2013 - Bizagi

231

corresponde a cul. Estos eventos se utilizan para enviar o recibir seales dentro o a lo largo del proceso. Una seal es similar a una bengala que se dispara al cielo para cualquiera que pueda estar interesado en ella y reaccionar. Evento de Seal El evento que lanza una seal se identifica con un tringulo sombreado. El evento que recibe una seal se identifica con un tringulo sin relleno.

Eventos Intermedios adjuntos a los lmites de una Actividad

ELEMENTO

DESCRIPCIN Si un Evento de Temporizacin se encuentra adjunto a los lmites de una actividad, cambiar el flujo normal a un flujo de excepcin cuando se cumpla un ciclo determinado o se alcance una fecha especfica. Si interrumpe la actividad a la que se encuentra adjunto, los bordes de la figura se mostrarn slidos, de lo contrario se mostrarn discontinuos.

NOTACIN

Evento Temporizador

Un Evento Intermedio de Error solo puede ser utilizado adjunto a los lmites de una actividad. Este evento captura un error especfico (si se le asigna un nombre) o cualquier error (si no se especifica nombre). El Evento de Error siempre interrumpe la actividad a la cual se encuentra adjunto, por lo que no existe una versin "No interruptor" de ste y en consecuencia, los bordes de la figura se muestran siempre slidos. Este evento es utilizado en Subprocesos transaccionales y debe ir adjunto a los lmites de uno. El evento se dispara si se alcanza un Evento de fin de Cancelacin dentro del Subproceso de transaccin o, si se recibe un mensaje de cancelacin de un protocolo de cancelacin

Evento de Error

Evento de Cancelacin

232

Copyright 2013 - Bizagi

mientras la transaccin se encuentra en ejecucin. El Evento de Cancelacin siempre interrumpe el Subproceso al cual se encuentra adjunto, por lo que no existe una versin "No interruptor" de ste y en consecuencia, los bordes de la figura se muestran siempre slidos. Cuando se encuentra adjunto a los lmites de una actividad, este evento se utiliza para capturar la compensacin. Cuando esto ocurre, la actividad de compensacin ser ejecutada. La interrupcin o no interrupcin de la actividad no aplica para el Evento de Compensacin, por lo que los bordes de la figura siempre se mostrarn slidos.

Evento de Compensacin

Eventos de Finalizacin
ELEMENTO Finalizacin simple Finalizacin de Mensaje DESCRIPCIN Indica que el flujo finaliza. Indica que un mensaje se enva una vez finaliza el flujo. Indica que se debe generar un error. Todas las secuencias activas del proceso son finalizadas. El error ser recibido por un evento intermedio de captura de error. Se utiliza dentro de un sub-proceso de transaccin e indica que ste debe ser cancelado. NOTACIN

Finalizacin de Error

Finalizacin de Cancelacin

Finalizacin de Seal Indica que una seal es enviada una vez finaliza el flujo.

Finalizacin Terminal Finaliza el proceso y todas sus actividades de forma inmediata.

Artefactos
ELEMENTO DESCRIPCIN NOTACIN

Copyright 2013 - Bizagi

233

Grupo

Es un artefacto que provee un mecanismo visual para agrupar elementos de un diagrama de manera informal. Son mecanismos para que un modelador provea informacin adicional, al lector de un diagrama BPM. Proveen informacin sobre cmo documentos, datos y otros objetos son utilizados y actualizados durante el proceso.

Anotacin

Objetos de datos

Swimlanes
ELEMENTO DESCRIPCIN Un pool es un contenedor de procesos simples (contiene flujos de secuencia dentro de las actividades). Un proceso est completamente contenido dentro de un pool. Siempre existe por lo menos un pool. Es una sub-particin dentro del proceso. Los lanes se utilizan para diferenciar roles internos, posiciones, departamentos, etc. NOTACIN

Contenedor (Pool)

Carril (Lane)

Fase

Es una sub-particin dentro del proceso. Puede indicar diferentes etapas durante el mismo.

Conectores
ELEMENTO DESCRIPCIN Un flujo de secuencia es utilizado para mostrar el orden en el que las actividades se ejecutarn dentro del proceso. Se utiliza para asociar informacin y artefactos con objetos de flujo. Tambin se utiliza para mostrar las tareas que compensan una actividad. NOTACIN

Flujo de Secuencia

Asociacin

234

Copyright 2013 - Bizagi

Flujo de Mensaje

Se utiliza para mostrar el flujo de mensajes entre dos entidades que estn preparadas para enviarlos y recibirlos.

Usted puede encontrar ms informacin acerca de modelado y automatizacin en nuestra ayuda del Modelador de Procesos de Bizagi. Descargue nuestro Poster de BPMN 2.0 3.2.4.1 Propiedades de las figuras En el Modelador de Procesos, cada forma contenida en el diagrama tiene unas propiedades especficas, las cuales son presentadas en tres pestaas: Bsicas, Extendidas y Acciones de presentacin. Los campos mostrados en cada pestaa varan de acuerdo a la figura seleccionada. Para acceder a la ventana de propiedades de clic derecho sobre la figura y seleccione la opcin Propiedades. Las siguientes secciones describen las propiedades para cada figura.

Copyright 2013 - Bizagi

235

3.2.4.2

Propiedades de los Procesos Para mostrar las Propiedades del Proceso, d clic en el nombre del Proceso y seleccione la opcin P ro p ied ad es. Se mostrar la siguiente tabla:

PROPIEDAD Nombre de Mostrar

DESCRIPCIN El nombre del Proceso que se mostrar en el Portal de Trabajo. Este se puede cambiar a travs de la Vista de Mdulos. El nombre del proceso. No se permiten espacion ni caracteres especiales. No se puede cambiar. Incluya una descripcin para el proceso. Esta descripcin se mostrar cuando se creen nuevos casos. Para propsitos de documentacin, un texto de ayuda para el Proceso. Si usted tiene documentacin para su Proceso, ingrese la URL. Define la ubicacin de su proceso de acuerdo a la estructura de su proyecto.

Nombre

Descripcin

Texto de Ayuda URL de Ayuda Categora

236

Copyright 2013 - Bizagi

Tipo de Acceso

Proceso: Permite a los usuarios finales crear nuevas instancias de casos en el Portal de Trabajo. Mdulo: Directamente relacionado a los Sub-procesos Embebidos. Si un proceso es embedido debera tener este tipo de acceso. Los usuarios finales no pueden crear casos de estos Procesos en el Portal de Trabajo. Solo sub-proceso: Directamente relacionado a los Sub-procesos reusables. Los usuarios finales no pueden crear instancias de estos Procesos en el Portal de Trabajo. Define el orden en el cual los procesos se mostrarn para crear nuevos casos en el Portal de Trabajo. Aplica para cada aplicacin individualmente. Es la forma asociada que se muestra cuando se consulta un caso que ha sido cerrado o cuando el usuario no tiene actividades pendientes. Para mayor informacin vea Forma Global. Es la forma asociada al Proceso y permite al usuario ver la informacin del progreso, cuando se da clic en la opcin Resumen de la actividades pendientes. Para mayor informacin vea Forma Global. Esta opcin permite mostrar un nmero de caso nico tanto para el Proceso padre como para todos sus sub-procesos. Si esta casilla no esta marcada, el sub-proceso mostrar un nmero de caso diferente al del Proceso padre. Habilita las alarmas configuradas para enviar notificaciones de alarma. Si esta opcin est deshabilitada, las alarmas configuradas no enviarn correos electrnicos. Habilita el envo de las notificaciones configuradas. Si esta opcin est deshabilitada, las notificaciones configuradas no enviarn correos electrnicos. Versin del Proceso. El estado del proceso (activo/inactivo). Si esta opcin est habilitada, el proceso se habilitar para su uso (si es un sub-proceso o mdulo) y estar disponible para creacin de casos (si es un proceso). Si se encuentra inactivo, no podr ser utilizado.

Orden

Forma Global

Forma de Resumen

Usar nmero de caso del Padre

Habilitar Alarmas

Habilitar Notificaciones

Versin Estado

3.2.4.3

Propiedades de las Tareas

ELEMENTOS

CONSIDERACIONES

PROPIEDADES

Las actividades de usuario Propiedades bsicas muestran su contenido a los usuarios finales a medida que se Nombre visual: Es el nombre de la avanza en el flujo del proceso. actividad que se muestra en el Portal de Las interfaces de usuario son Trabajo.

Copyright 2013 - Bizagi

237

Nombre: Es el nombre de la actividad en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra adicional sobre la tarea. informacin

Reasignar: Si la propiedad est habilitada, la tarea puede ser reasignada a otro usuario durante el proceso. Por defecto, esta propiedad est deshabilitada. Para ms informacin sobre esta opcin, consulte Reasignar tareas. Costo: Indica el costo de la tarea. Prioridad: Indica el orden en el que Bizagi activar o ejecutar las tareas. Notificar: Cuando se habilita, esta propiedad notifica sobre la asignacin a todos los usuarios que han sido asignados a la tarea. Por defecto, esta propiedad est deshabilitada. Duracin: Determina el tiempo mximo que una tarea puede permanecer activa (sin finalizar) para considerar que su ejecucin esta ha tiempo. Texto de Ayuda: En esta opcin, el usuario puede configurar un texto de ayuda para la actividad. URL de Ayuda: En esta opcin, el usuario puede configurar una URL que contenga un texto de ayuda para la actividad. Es Singleton: Esta propiedad convierte una tarea de usuario a Singleton. Si ms de una transicin o lnea de secuencia entra a la actividad, sta no ser duplicada si ya existe una instancia activa. Duracin evento temporizacin: Esta propiedad es utilizada cuando un Evento Intermedio de Temporizacin es adjunto a la tarea.

diseadas con la ayuda Modelador de Formas.

del

Cada tarea tiene un ejecutante. Para definir quien ejecuta cada actividad se debe definir una Regla de Asignacin.

238

Copyright 2013 - Bizagi

Propiedades bsicas Nombre visual: Es el nombre de la actividad que se muestra en el Portal de Trabajo. Nombre: Es el nombre de la actividad en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra adicional sobre la tarea. informacin

Costo: Indica el costo de la tarea. Prioridad: Indica el orden en el que Bizagi activar o ejecutar las tareas. Es asncrona: Corresponde a una propiedad de las tareas automticas del flujo del proceso, las cuales han sido diseadas para llamar interfaces externas. Estas interfaces son utilizadas para integracin con sistemas propios del cliente. Reintentos: Determina el nmero de veces que la actividad asncrona va a ser ejecutada si un error es lanzado. Intervalo de reintento: Es un intervalo de tiempo (en minutos) que debe ser alcanzado antes de intentar ejecutar la tarea asncrona en caso de error. Mostrar retroalimentacin: Si la opcin esta habilitada, el sistema ejecutara la actividad de inmediato y mostrar en el Portal de Trabajo una pgina de espera; si la opcin esta deshabilitada, la actividad ser ejecutada ms adelante en el Scheduler de Bizagi y el usuario ser enviado a una pgina por defecto dependiendo del caso. Tiempo de Espera: Permite definir el tiempo mximo (en segundo), en que la ejecucin de la tarea es posible; el sistema de forma automtica cancela la operacin

Las tareas de servicio son tareas que son ejecutadas por el sistema sin intervencin alguna del usuario final.

Copyright 2013 - Bizagi

239

cuando se agota el tiempo.

Si el proceso est esperando por un mensaje, ste ser pausado hasta el arribo del mensaje o se va por el camino de manejo de excepciones. Para usar la opcin Lanzar Mensaje, es necesario que exista un Reciba Mensaje que atrape el mensaje. Es posible utiliza un Evento Intermedio de Mensaje, un Mensaje de Inicio de Inicio o una Tarea de Recepcin. Las tareas de envo deben ser configuradas para identificar el proceso objetivo y el elemento objetivo. Los eventos de lanzar y recibir mensajes deben tener el mismo nombre y deben estn de procesos diferentes. Propiedades bsicas Nombre visual: Es el nombre de la actividad que se muestra en el Portal de Trabajo. Nombre: Es el nombre de la actividad en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra adicional sobre la tarea. informacin

Propiedades bsicas Nombre visual: Es el nombre de la actividad que se muestra en el Portal de Trabajo. Nombre: Es el nombre de la actividad en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra adicional sobre la tarea. informacin

Las tareas de script son tareas automticas utilizadas por Bizagi para enviar notificaciones personalizadas (correos electrnicos).

Es es una Tarea que se espera ser realizada sin la ayuda de Propiedades bsicas alguna aplicacin. Un ejemplo de esto puede ser una secretaria Nombre visual: Es el nombre de la archivando documentos fsicos. actividad que se muestra en el Portal de Las actividades de usuario Trabajo. muestran su contenido a los

240

Copyright 2013 - Bizagi

usuarios finales a medida que se avanza en el flujo del proceso. Cada tarea tiene un ejecutante. Para definir quien ejecuta cada actividad se debe definir una Regla de Asignacin.

Nombre: Es el nombre de la actividad en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra adicional sobre la tarea. informacin

3.2.4.4

Propiedades de las Compuertas

ELEMENTO

CONSIDERACIONES

PROPIEDADES

Compuerta Exclusiva

Cuando dos o ms transiciones salen de la figura, al menos uno de Propiedades bsicas los caminos debe ser configurado Nombre visual: Es el nombre de la con la validacin Si no. Las otras compuerta que se muestra en el Portal salidas de secuencia deben tener de Trabajo. condiciones de negocio para que Bizagi evalu y decida que camino Nombre: Es el nombre de la compuerta tomar. Solo se puede escoger uno en la base de datos. Este nombre no de los caminos disponibles. puede ser modificado. Esta figura est asociada a la Descripcin: Muestra informacin sincronizacin de caminos. El adicional sobre la compuerta. primer token que alcance la figura continuar por el flujo.

Propiedades bsicas Una transicin que salga de esta puerta no puede entrar a un Subproceso, a un mltiple Subproceso o a una compuerta exclusiva. Es posible utilizar las siguientes figuras luego de la compuerta basada en eventos: Tareas, Eventos, compuertas paralelas. Nombre visual: Es el nombre de la compuerta que se muestra en el Portal de Trabajo. Nombre: Es el nombre de la compuerta en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra informacin adicional sobre la compuerta.

Compuerta basada en eventos.

Propiedades bsicas Los caminos que salen de la figura no requieren reglas de negocio ya que se deben seguir todos los Nombre visual: Es el nombre de la compuerta que se muestra en el Portal

Compuerta

Copyright 2013 - Bizagi

241

ELEMENTO

CONSIDERACIONES caminos. Cuando la compuerta es utilizada como elemento convergente (sincronizacin) se contina solo por un camino, de forma contrara, cuando de utiliza como elemento divergente existen muchos caminos para continuar.

PROPIEDADES

de Trabajo. Nombre: Es el nombre de la compuerta en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra informacin adicional sobre la compuerta.

Paralela

La compuerta paralela debe ser definida en pares para realizar todos los procesos de sincronizacin que necesite el proceso. Es decir, se debe utilizar una compuerta paralela como elemento divergente (para activar los caminos deseados) y otra como elemento convergente para sincronizar los caminos antes activados.

Cuando un proceso alcanza este elemento, se presenta una interfaz al usuario final donde se muestran Propiedades bsicas el nombre de las actividades que siguen a la figura para seleccionar Nombre visual: Es el nombre de la por donde debe continuar el compuerta que se muestra en el Portal proceso. de Trabajo. Compuerta compleja La interfaz de usuario debe ser configurado como una forma de actividad. Cuando se utiliza la compuerta como elemento divergente, la condicin de negocio ser evaluado cada vez que una transicin alcance la figura. Nombre: Es el nombre de la compuerta en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra informacin adicional sobre la compuerta.

Propiedades bsicas Cuando se utiliza una compuerta inclusiva como elemento divergente se debe asegurar que al menos un camino sea valido. Le Nombre visual: Es el nombre de la compuerta que se muestra en el Portal de Trabajo.

Compuerta inclusiva

242

Copyright 2013 - Bizagi

ELEMENTO

CONSIDERACIONES recomendamos incluir una transicin definida con la condicin Si no para continuar el proceso si ninguna condicin es cumplida. Cuando se utilice como elemento divergente, al menos un camino debe ser activado para continuar con el flujo del proceso.

PROPIEDADES

Nombre: Es el nombre de la compuerta en la base de datos. Este nombre no puede ser modificado.

Cuando se utiliza la compuerta como elemento convergente, ms Descripcin: Muestra informacin de un camino puede llegar a ella, adicional sobre la compuerta. pero solo puede tener un camino Propiedades Extendidas de salida. Las compuertas inclusivas deben ser definidas en pares si se va a realizar alguna sincronizacin. Es decir, una compuerta inclusiva debe ser definida como elemento divergente para activar los caminos salientes y otra como elemento convergente para sincronizar los caminos anteriores. Expresiones o acciones: Se pueden asociar expresiones Al Entrar o Al Salir de la compuerta.

3.2.4.5

Propiedades del Evento de Inicio

ELEMENTO

CONSIDERACIONES

PROPIEDADES

Evento de Inicio

Todos los flujos de procesos deben tener un inicio, independientemente Propiedades bsicas que estn contenidos en un Proceso o en un Subproceso. Nombre visual: Es el nombre del evento que se muestra en el Portal de Solamente un flujo de procesos puede Trabajo. salir de esta forma. Un Evento de Inicio no puede tener flujos de secuencia de Nombre: Es el nombre del evento en entrada. la base de datos. Este nombre no puede ser modificado. Un diagrama de procesos pude tener mltiples eventos de inicio pero solo Descripcin: Muestra informacin uno de cada tipo. Es decir, el Evento de adicional sobre el evento. Inicio solo puede aparecer una vez dentro del proceso.

Copyright 2013 - Bizagi

243

ELEMENTO

CONSIDERACIONES

PROPIEDADES

Evento de Inicio de Mensaje

El Evento de Inicio de Mensaje siempre es una figura que captura. Es decir, para utilizar un Evento de Inicio de Propiedades bsicas Mensaje es necesario que exista un Nombre visual: Es el nombre del Evento de Mensaje que enve el evento que se muestra en el Portal de mensaje. Trabajo. La figura dentro del Proceso que enva Nombre: Es el nombre del evento en el mensaje debe ser configurada para la base de datos. Este nombre no que identifique el Proceso y el puede ser modificado. Elemento objetivo. El Evento Intermedio que lanza el mensaje y el Evento de Inicio de Mensaje que atrapa el mensaje deben tener el mismo nombre. Descripcin: Muestra informacin adicional sobre el evento.

Propiedades bsicas Nombre visual: Es el nombre del evento que se muestra en el Portal de Trabajo. Evento de Inicio de Temporizaci n Un Subproceso no pude tener un Evento de Inicio de Temporizacin. Nombre: Es el nombre del evento en la base de datos. Este nombre no puede ser modificado. Schedule: Es el momento en que el caso ser iniciado.

Evento de Inicio de Seal

El Evento de Inicio de Seal siempre es Propiedades bsicas una figura que captura. Es decir, para poder utilizar un Evento de Inicio Seal Nombre visual: Es el nombre del es necesario que exista un Evento de evento que se muestra en el Portal de Seal que enve la seal. Trabajo. La seal es enviada a todos los procesos que puedan recibirla, es decir, este tipo de seal no tiene un objetivo especfico, cualquier figura de captura que tenga el mismo nombre ser activada con el lanzamiento el la Nombre: Es el nombre del evento en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra informacin adicional sobre el evento.

244

Copyright 2013 - Bizagi

ELEMENTO seal.

CONSIDERACIONES

PROPIEDADES

El Evento Intermedio de Seal que lanza la seal y el Evento de Inicio de Seal que captura la seal deben tener el mismo nombre.

3.2.4.6

Propiedades del Evento Intermedio

ELEMENTO

CONSIDERACIONES

PROPIEDADES

Propiedades bsicas Nombre visual: Es el nombre del evento que se muestra en el Portal de Trabajo. Nombre: Es el nombre del evento en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra informacin adicional sobre el evento. Reasginar: Si la opcin esta habilitada, el Evento puede ser reasignado a otro usuario durante el proceso. Costo: Indica el costo del evento. Prioridad: Indica el orden en el cual Bizagi ejecutar o activar los Eventos. Notificar: Cuando la propiedad est activada, se enviarn notificaciones a todos los usuarios asignados al Evento. Texto de Ayuda: En esta opcin, el usuario puede configurar un texto de ayuda para la actividad. URL de Ayuda: En esta opcin, el

Evento Intermedio

Ninguna.

Copyright 2013 - Bizagi

245

ELEMENTO

CONSIDERACIONES

PROPIEDADES usuario puede configurar una URL que contenga un texto de ayuda para la actividad.

Si el Proceso esta esperando por un mensaje, este quedara pausado hasta que el mensaje llegue o puede cambiar al flujo de manejo de excepcin. Para poder utilizar un Mensaje de envo de captura, es necesario que exista un Propiedades bsicas Evento de Mensaje que enve el mensaje, este puede ser un Evento Intermedio de Nombre visual: Es el nombre del Mensaje o puede ser un Evento evento que se muestra en el Portal Intermedio de Inicio. de Trabajo. La figura en el proceso que enva el mensaje debe ser configurada para identificar el Proceso y el Elemento objetivo. Evento de Mensaje El evento que lanza el mensaje y el evento que atrapa el mensaje deben tener el mismo nombre y deben estar en procesos diferentes. Para ms informacin sobre cmo configurar Evento, visite Intercambio de Mensajes. Nombre: Es el nombre del evento en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra informacin adicional sobre el evento.

Propiedades bsicas La duracin o el tiempo asociado al Evento Intermedio de Temporizacin puede ser fijo o variable y debe ser definido en minutos. Los minutos asignados corresponden al tiempo que debe esperar el evento para su lanzamiento. Por ejemplo, si el flujo del proceso llega a un Evento de Temporizacin, cuya duracin ha sido definida como 120 minutos, a las 17:00 (5:00 p.m.) del viernes y los turnos de trabajo han sido definidos de Lunes a Viernes de 9:00 (9:00 a.m.) a 17:00 (5:00 p.m.), el Proceso espera hasta el Lunes en Nombre visual: Es el nombre del evento que se muestra en el Portal de Trabajo. Nombre: Es el nombre del evento en la base de datos. Este nombre no puede ser modificado. Costo: Indica el costo del evento. Duracin: El tiempo en minutos que debe transcurrir antes del lanzamiento del evento. El

Evento Temporizacin

246

Copyright 2013 - Bizagi

ELEMENTO

CONSIDERACIONES la maana actividades. para continuar con las

PROPIEDADES

Para que la figura pueda funcionar de forma adecuada, el servicio de Scheduler (Scheduler service) de la aplicacin correspondiente debe estar habilitada. Para ms informacin sobre cmo configurar Evento de Temporizacin visite Duracin de Temporizadores.

calendario asociado al Esquema de Tiempo de Trabajo de la organizacin se considera para este clculo.

Evento de enlace

Solo es posible utilizar Eventos de Enlace a nivel de proceso, es decir, solo se puede utilizar estos eventos dentro del Propiedades bsicas mismo proceso. Nombre visual: Es el nombre del El Evento de Captura no debe tener evento que se muestra en el Portal transiciones de salida. El evento de de Trabajo. captura no debe tener transiciones o Nombre: Es el nombre del evento flujos de entrada. Bizagi automticamente en la base de datos. Este nombre convertir un Evento de Enlace en un no puede ser modificado. evento de lanzamiento tan pronto se guarde el diagrama. Descripcin: Muestra informacin adicional sobre el evento. Los Eventos de Enlace de captura y de lanzamiento deben tener el mismo nombre.

La seal es enviada a todas las figuras que puedan recibirla, es decir, este tipo Propiedades bsicas de seal no tiene un objetivo especfico, cualquier figura de captura que tenga el Nombre visual: Es el nombre del mismo nombre ser activada con el evento que se muestra en el Portal lanzamiento el la seal. de Trabajo. El Evento Intermedio de Seal que lanza la seal y el Evento de Inicio de Seal que captura la seal deben tener el mismo nombre. Esta figura tiene las opciones de lanzar y atrapar, es decir, es posible lanzar una Seal o recibir la seal. Cuando se utiliza Nombre: Es el nombre del evento en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra informacin adicional sobre el evento.

Evento de Seal

Copyright 2013 - Bizagi

247

ELEMENTO

CONSIDERACIONES como seal de lanzamiento, la figura es rellena, cuando se utiliza como seal que atrapa la figura va sin rellenar.

PROPIEDADES

Evento intermedio adjuntos a los lmites de una actividad

ELEMENTO CONSIDERACIONES PROPIEDADES

Propiedades bsicas Nombre visual: Es el nombre del evento que se muestra en el Portal de Trabajo. Nombre: Es el nombre del evento en la base de datos. Este nombre no puede ser modificado. Costo: Indica el costo del evento. Duracin: El tiempo en minutos que debe transcurrir antes del lanzamiento del evento. El calendario asociado al Esquema de Tiempo de Trabajo de la organizacin se considera para este clculo.

Si la figura se utiliza para controlar el tiempo de una Actividad Manual, la figura ser diagramada sobre la actividad. Cuando se activa el evento, la actividad al cual esta adjunto ser interrumpida. Para ms informacin sobre cmo configurar Evento de Temporizacin visite Para ms informacin sobre cmo configurar Evento de Temporizacin visite

Evento de Temporizacin

El evento reacciona para atrapar un error especfico, o cualquier error si no se ha especificado ningn nombre para el evento. Un evento de error siempre interrumpe la actividad a la cual est adjunto.

Propiedades bsicas Nombre visual: Es el nombre del evento que se muestra en el Portal de Trabajo. Nombre: Es el nombre del evento en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra informacin adicional sobre el evento.

Evento de Error

Para ms informacin visite Subprocesos Transaccionales

248

Copyright 2013 - Bizagi

ELEMENTO

CONSIDERACIONES Este evento es utilizado en los Subprocesos transaccionales y debe ser adjunto a sus lmites. El evento ser lanzado si un Evento de Fin de Cancelacin en el Subproceso Transaccional es alcanzado. Tambin ser lanzado si el protocolo para Mensajes de Cancelacin de las Transacciones ha sido recibido mientras la transaccin es realizada. Un Evento de Cancelacin siempre interrumpe la actividad a la cual est adjunto. Para ms informacin visite Subprocesos Transaccionales.

PROPIEDADES

Propiedades bsicas Nombre visual: Es el nombre del evento que se muestra en el Portal de Trabajo. Nombre: Es el nombre del evento en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra informacin adicional sobre el evento.

Evento de Cancelacin

Propiedades bsicas Nombre visual: Es el nombre del evento que se muestra en el Portal de Trabajo. Nombre: Es el nombre del evento en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra informacin adicional sobre el evento.

Evento de Compensacin

El evento se utiliza para capturar el Evento de compensacin. Cuando esto ocurre, una Actividad de Compensacin ser ejecutada. Para ms informacin visite Subprocesos Transaccionales.

3.2.4.7

Propiedades del Evento de Fin

ELEMENTO

CONSIDERACIONES

PROPIEDADES Propiedades bsicas

El evento de finalizacin no puede tener flujos de salida. Evento de Fin sin especificar. El Evento de fin verifica si hay o no hay actividades pendientes (tokens) para cada caso. Si no existe ninguna actividad pendiente, el Procesos se

Nombre visual: Es el nombre del evento que se muestra en el Portal de Trabajo. Nombre: Es el nombre del evento en la base de datos. Este

Copyright 2013 - Bizagi

249

ELEMENTO

CONSIDERACIONES cerrara automticamente.

PROPIEDADES

Esta figura es comnmente utilizada en situaciones de negocio donde existen caminos paralelos y es necesario indicar el fin de las actividades de un camino sin que se termine todo el proceso. Este elemento no puede ser sincronizado con ningn punto del proceso. El Evento de fin terminal es una figura opcional para diagramar los procesos. Sin embargo, es recomendable su uso.

nombre no modificado.

puede

ser

Descripcin: Muestra informacin adicional sobre el evento.

Evento Fin de Mensaje

Evento de Fin de Mensaje siempre es Propiedades bsicas una figura de lanzamiento. Es decir, para poder utilizar un Evento de Fin Nombre visual: Es el nombre de Mensaje es necesario que exista del evento que se muestra en el un Evento de Inicio de Mensaje o un Portal de Trabajo. Evento Intermedio de Mensaje que escuche el mensaje. Nombre: Es el nombre del evento en la base de datos. Este El Evento de Fin de Mensaje debe ser nombre no puede ser configurado para identificar el modificado. Proceso y el Elemento objetivo. La figura que captura el mensaje y el Evento de Fin de Mensaje deben tener el mismo nombre. Descripcin: Muestra informacin adicional sobre el evento.

Propiedades bsicas Nombre visual: Es el nombre del evento que se muestra en el Portal de Trabajo. Nombre: Es el nombre del evento en la base de datos. Este nombre no puede ser modificado.

Ninguna. Evento de Error

250

Copyright 2013 - Bizagi

ELEMENTO

CONSIDERACIONES

PROPIEDADES

Descripcin: Muestra informacin adicional sobre el evento.

Propiedades bsicas Nombre visual: Es el nombre del evento que se muestra en el Portal de Trabajo. Ninguna. Nombre: Es el nombre del evento en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra informacin adicional sobre el evento.

Evento de Cancelacin

Evento de seal

El Evento de Fin de Seal es una figura de lanzamiento. Es decir, para poder utilizar un Evento de Fin de Seal es necesario que exista un Evento de Inicio de Seal o un Evento Propiedades bsicas Intermedio de Seal que escuche el mensaje Nombre visual: Es el nombre del evento que se muestra en el La seal es enviada a todos los Portal de Trabajo. procesos que puedan recibirla, es decir, este tipo de seal no tiene un Nombre: Es el nombre del objetivo especfico, cualquier figura evento en la base de datos. Este de captura que tenga el mismo nombre no puede ser nombre ser activada con el modificado. lanzamiento el la seal. El Evento de Fin de Seal debe ser configurado para identificar el Proceso y el Elemento objetivo. La figura que captura la seal y el Evento de Fin de Seal deben tener el mismo nombre. Descripcin: Muestra informacin adicional sobre el evento.

Copyright 2013 - Bizagi

251

ELEMENTO

CONSIDERACIONES

PROPIEDADES

Propiedades bsicas Nombre visual: Es el nombre del evento que se muestra en el Portal de Trabajo. Nombre: Es el nombre del evento en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra informacin adicional sobre el evento.

Cuando un Evento de Fin Terminal es alcanzado por el Proceso, el caso ser cerrado aunque existan actividades pendientes. Evento de Fin Terminal El evento de Fin Terminal es una figura opcional para diagramar. Sin embargo, es recomendable su uso.

3.2.4.8

Propiedades de los Carrilles

ELEMENTO

CONSIDERACIONES

PROPIEDADES

Propiedades bsicas Nombre visual: Es el nombre del contenedor (pool) que se muestra en el Portal de Trabajo. Nombre: Es el nombre del contenedor en la base de datos. Este nombre no puede ser modificado. Un proceso debe estar contenido dentro de un contenedor (todo el proceso). Contenedor (Pool) Descripcin: Muestra informacin adicional sobre el contendor. Texto de Ayuda: En esta opcin, el usuario puede configurar un texto de ayuda para la actividad. URL de Ayuda: En esta opcin, el usuario puede configurar una URL que contenga un texto de ayuda para el contenedor.

252

Copyright 2013 - Bizagi

ELEMENTO

CONSIDERACIONES

PROPIEDADES Categora: Categora a la cual pertenece el proceso. Tipo de Acceso: Indica si el Proceso es accedido como Proceso, Mdulo o solamente como Subproceso. Orden: Determina la secuencia en que el proceso ser mostrado el men de registro. Forma Global: Nombre de la forma global asociada al Proceso. Forma de Resumen: Nombre de la forma resumen asociada al Proceso. Utilizar nmero del caso del proceso padre: Esta opcin habilita solo un nmero de caso para el Proceso padre y sus subprocesos. Si la opcin no esta habilitada, el Subproceso tendr un numero de caso diferente al del proceso padre. Habilitar Alarmas: Activa las alarmas para el proceso. Habilitar Notificaciones: Activa las notificaciones para el proceso. Propiedades de Versin Duracin Estimada: Determina el tiempo mximo que el proceso puede estar activo (sin finalizar) y que se pueda considerar como a tiempo. Lmite Inferior: El tiempo mnimo estimado para la ejecucin del proceso. Se define en das, horas y minutos.

Copyright 2013 - Bizagi

253

ELEMENTO

CONSIDERACIONES

PROPIEDADES

Lmite Superior: El tiempo mximo estimado para la ejecucin del proceso. Se define en das, horas y minutos. Versin: Es la versin del Flujo del Proceso. Estado: Es el estado del proceso (Activo/Inactivo). Si la opcin est seleccionada, el proceso estar disponible para ser utilizado (si es un Proceso, Subproceso o Mdulo) y para la creacin de casos. Si est inactivo, el proceso no puede ser usado.

Propiedades bsicas Nombre visual: Es el nombre del carril (lane) que se muestra en el Portal de Trabajo. Nombre: Es el nombre del carril en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra informacin adicional sobre el carril.

El primero carril del proceso es creado automticamente cuando se crea el proceso. Todas las figuras deben pertenecer a algn carril.

Carril (Lane)

Propiedades bsicas Todas las figuras deben pertenecer a una fase. Por lo que todos los procesos deben tener al menos una Fase. El nmero de fases necesarias y sus nombres dependen de los estados del proceso Fase (Milestone) Existen dos tipos de fases (pueden ser configuradas en las propiedades globales de la figura): Nombre visual: Es el nombre de la fase (Milestone) que se muestra en el Portal de Trabajo. Nombre: Es el nombre de la fase en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra

254

Copyright 2013 - Bizagi

ELEMENTO

CONSIDERACIONES

PROPIEDADES

Tipo 1 Creacin del Caso: Indica que las actividades iniciales del proceso corresponden a la fase de inicio del proceso. Todas las actividades contenidas en este tipo de fase tienen la propiedad de retornar a la actividad anterior. El nmero de caso es asignado al final de la fase. Tipo 2 Proceso: Este tipo de fases, a diferencia de la anterior, no permite retornar a la actividad anterior.

informacin adicional sobre la fase. Texto de Ayuda: En esta opcin, el usuario puede configurar un texto de ayuda para la fase. Tipo: Indica si la fase est relacionada con la creacin del caso o con el Proceso.

3.2.4.9

Propiedades de los Conectores

ELEMENTO

CONSIDERACIONES

PROPIEDADES

Se representan con una flecha que indica el desde y el hasta Flujo Normal: La lnea normal se utiliza para Propiedades bsicas representar el flujo entre dos actividades que no es afectado por condiciones. El Nombre visual: Es el nombre uso ms simple para esta figura es la del flujo de secuencia que se secuencia entre dos actividades. muestra en el Portal de Trabajo. Flujo condicional: Este flujo tiene una condicin asignada que define si el camino es o no es utilizado. Puede ser utilizado para cualquier figura del proceso que necesite evaluar cierta condicin para seguir con cierto camino. Flujo por defecto: Para decisiones basadas en decisiones inclusivas o de datos, se define un camino por defecto. Este tipo de transicin se lleva a cabo cuando todas Nombre: Es el nombre del flujo de secuencia en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra informacin adicional sobre el flujo de secuencia.

Flujo de secuencia

Copyright 2013 - Bizagi

255

ELEMENTO

CONSIDERACIONES las condiciones son falsas al mismo tiempo. Una vez que la condicin Si no (Else) se ha asignado a una transicin, la fecha es mostrada como la figura anterior.

PROPIEDADES

Propiedades bsicas Nombre visual: Es el nombre de la Asociacin que se muestra en el Portal de Trabajo. Nombre: Es el nombre de la Asociacin en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra informacin adicional sobre la Asociacin.

Asociacin

Se utiliza para asociar informacin y Artefactos con los objetos del flujo del proceso. Tambin se utiliza en las actividades de compensacin.

3.2.4.10 Subprocesos Un Subproceso es un conjunto de actividades que tienen una secuencia lgica para cumplir un propsito. Un Subproceso es un Proceso por s mismo, cuya finalidad hace parte de un Proceso ms grande. En Bizagi, la configuracin de un Subproceso se realiza en el momento en que una actividad es convertida a un Subproceso a travs de un asistente. Un Subproceso puede ser representado de forma expandida o colapsada:

Subproceso Expandido
Cuando se expande un Subproceso, todos los detalles sern mostrados dentro de sus lmites. En el siguiente diagrama, el proceso de Solicitud de Viajes muestra el Subproceso Reservar de forma expandida. Las actividades que hacen parte del Subproceso son mostradas como parte del Proceso principal. Este es un solo Proceso representado en un solo diagrama.

256

Copyright 2013 - Bizagi

Subproceso Colapsado
Cuando un Subproceso esta colapsado, los detalles del Subproceso no son mostrados. El signo mas (+) indica que la figura es un Subproceso y es mostrado a su mnimo nivel de detalle. En el siguiente diagrama, el proceso de Solicitud de viajes muestra el Subproceso Reservar de forma colapsada.

Los detalles del Subproceso Reservar son mostrados en otro diagrama.

Todos los diagramas modelados en Bizagi pueden ser Subprocesos.

Copyright 2013 - Bizagi

257

Propiedades de los Subprocesos

Dependiendo el tipo, los Subprocesos tienen diferentes propiedades: ELEMENTO CONSIDERACIONES PROPIEDADES

Propiedades bsicas Nombre visual: Es el nombre de la actividad que se muestra en el Portal de Trabajo. Nombre: Es el nombre de la actividad en la base de datos. Este nombre no puede ser modificado. Descripcin: Muestra adicional sobre la tarea. informacin

Subprocesos Embebidos contienen un conjunto de Actividades que no son independientes del proceso padre; ellos comparten la misma informacin y/o datos. Ellos tienen un objetivo claro y tienen un inicio y un fin determinado. Los Subprocesos embebidos no estn diseados para ser reutilizables. No pueden ser usados como Subprocesos mltiples.

Duracin: Determina el tiempo mximo que el Subproceso puede estar activo (sin finalizar) para ser considerado dentro del tiempo. Costo: Indica el costo de la tarea. Prioridad: Indica el orden en el que Bizagi activar o ejecutar las tareas. Es asncrona: Permite comportamiento Asincrnico para el Subproceso. Reintentos: Determina el nmero de veces que la actividad asncrona va a ser ejecutada si un error es lanzado. Intervalo de reintento: Es un intervalo de tiempo (en minutos) que debe ser alcanzado antes de intentar ejecutar la tarea asncrona en caso de error. Mostrar retroalimentacin: Si la opcin esta habilitada, el sistema ejecutara la actividad de inmediato y mostrar en el Portal de Trabajo una pgina de espera; si la opcin esta deshabilitada, la actividad ser ejecutada ms adelante en el Scheduler de Bizagi y el usuario ser enviado a

Subproceso Embebido

258

Copyright 2013 - Bizagi

ELEMENTO

CONSIDERACIONES

PROPIEDADES una pgina por defecto dependiendo del caso. Tiempo de Espera: Permite definir el tiempo mximo (en segundo), en que la ejecucin de la tarea es posible; el sistema de forma automtica cancela la operacin cuando se agota el tiempo.

Subproceso reusable

Estos Subprocesos pueden ser integrados o pueden trabajar por si mismos (standalone): o Si se escoge la opcin de Propiedades bsicas integrado, el Proceso padre Nombre visual: Es el nombre del contina cuando el Subproceso Subproceso que se muestra en el termina. o Si se selecciona la opcin Portal de Trabajo. standalone, el Proceso padre Nombre: Es el nombre del Subproceso contina con la siguiente actividad en la base de datos. Este nombre no en el momento que inicie el puede ser modificado. Subproceso. Los Subprocesos reusables no pueden ser transaccionales y no pueden ser configurados como un Subprocesos mltiple. Descripcin: Muestra informacin adicional sobre del Subproceso.

Propiedades bsicas Nombre visual: Es el nombre del Subproceso que se muestra en el Portal de Trabajo. Nombre: Es el nombre del Subproceso en la base de datos. Este nombre no puede ser modificado.} Descripcin: Muestra informacin adicional sobre del Subproceso.

Subproceso Transaccional

Se debe asociar eventos de Error, de Cancelacin y de Compensacin al Subproceso Transaccional.

Ellos pueden ser creados de dos formas: de forma Secuencial o en Propiedades bsicas Paralelo. Nombre visual: Es el nombre del

Copyright 2013 - Bizagi

259

ELEMENTO

CONSIDERACIONES Los Subprocesos mltiples paralelos se representan con tres lneas horizontales .

PROPIEDADES Subproceso que se muestra en el Portal de Trabajo. Nombre: Es el nombre del Subproceso en la base de datos. Este nombre no puede ser modificado.} Descripcin: Muestra informacin adicional sobre del Subproceso.

Los Subprocesos mltiples secuenciales se representan con tres Subproceso Mltiple lneas verticales .

3.2.4.10.1 Subprocesos Embebidos

Para mostrar cmo transformar una tarea en un Subproceso Embebido utilizaremos el siguiente diagrama:

El diagrama representa el P ro ceso d e So licitu d d e Co m p ras. Vamos a transformar la tarea Co tizacio n es en un Subproceso Embebido. 1. En el primer paso del Asistente de Procesos de Bizagi, clic en la opcin Ed itar P ro ceso .

260

Copyright 2013 - Bizagi

2. Clic derecho sobre la actividad que desea convertir en el Subproceso embebido, en este caso, la tarea Cotizaciones y seleccione la opcin Tran sfo rm ar en Su b p ro ceso .

Copyright 2013 - Bizagi

261

3. El asistente de la configuracin del Subprocesos aparecer en una nueva ventana y muestra los tipos de Subproceso. Seale la opcin Em b eb id o y de clic en el botn sig u ien te.

262

Copyright 2013 - Bizagi

4. Ingrese el nombre del Nuevo proceso o seleccione un proceso existente desde la lista desplegable, luego de clic en F in alizar.

Copyright 2013 - Bizagi

263

5. Una vez se ha creado el Subproceso, usted podr editarlo. Clic derecho en el recin creado Subproceso ( Co tizacio n es) y seleccione la opcin Ed itar Su b p ro ceso .

6. La ventana mostrar el diagrama del Subproceso. En esta caso, el Subproceso es un nuevo proceso, por lo que se mostrar un contenedor vaco para empezar a modelar el Subproceso.

264

Copyright 2013 - Bizagi

7. Cuando termine, clic en Cerrar. Luego seleccione la opcin Si en la ventana de confirmacin para guardar el modelo.

El Subproceso embebido Co tizacio n es ha sido creado de forma exitosa. Tenga en cuenta que debe utilizar el Asistente de procesos para configurar el modelo de datos y las

Copyright 2013 - Bizagi

265

formas asociadas al Subproceso.

Nota: El tipo de acceso del Subproceso embebido debe ser definido como Mdulo en las propiedades del proceso. Si el Subproceso no se define como Mdulo, el proceso no ser mostrado en la lista de Subprocesos Embebidos del asistente de configuracin, aunque se haya creado. En la vista Mdulos, clic derecho sobre la versin del proceso (1.0, 1.1) y seleccione Propiedades. Asegrese que la opcin Mdulo est seleccionada en la opcin de Tipo de Acceso.

Nota Estos sub-procesos siempre deben tener la misma Entidad de Proceso que el proceso padre con el fin de funcionar correctamente. Cuando un caso entra en un sub-proceso embebido, la informacin del proceso padre estar disponible en la misma navegacin XPath. La navegacin de datos no cambia de un proceso al otro.

3.2.4.10.2 Subprocesos Reusables

Para mostrar cmo transformar una tarea en un Subproceso Reusable utilizaremos el siguiente diagrama:

266

Copyright 2013 - Bizagi

El diagrama representa el P ro ceso d e So licitu d d e Co m p ras. Vamos a transformar la tarea O rd en d e Co m p ra en un Subproceso Reusable. 1. En el primer paso del Asistente de Procesos de Bizagi, clic en la opcin Ed itar P ro ceso .

2. Clic derecho sobre la actividad que desea convertir en el Subproceso Reusable, en este caso, la

Copyright 2013 - Bizagi

267

tarea Cotizaciones y seleccione la opcin Tran sfo rm ar en Su b p ro ceso .

3. El asistente de la configuracin del Subprocesos aparecer en una nueva ventana y muestrar los tipos de Subproceso. Seale la opcin Reu sab le y de clic en el botn sig u ien te.

268

Copyright 2013 - Bizagi

4. El modelo del Proceso que se va asignar como Subproceso Reusable debe existir (Debe crear el proceso a travs del paso 1 del asistente de Procesos de Bizagi). Seleccione O rd en d e Co m p ra de la lista desplegable y clic en Sig u ien te.

5. Seleccione el modo de salida de las siguientes dos opciones: Stand Alone: El proceso padre contina con el flujo del Proceso tan pronto se crea el Subproceso, sin esperar que este sea completado. Si el Proceso padre termina, el Subproceso seguir abierto. Integrado: La ejecucin completa del Subproceso es requerida para continuar con la siguiente actividad del Proceso padre. En este caso el Subproceso O rd en d e Co m p ra debe finalizar antes de que el Proceso So licitu d d e Co m p ra termine, por lo tanto se selecciona el modo Integrado.

Copyright 2013 - Bizagi

269

6. Finalmente de clic en Finalizar. El Subproceso exitosa.

O rd en d e Co m p ra quedo configurado de forma

Nota: El Subproceso Reusable debe tener definido como tipo de acesso Proceso o Solamente Subproceso en la opcin Tipo de Acceso. Si no es as, el proceso no ser mostrado dentro las opciones presentadas por el asistente de configuracin del Subproceso aunque ya haya sido creado. En la vista de Mdulos, clic derecho en sobre la versin del Subproceso y seleccione la opcin Propiedades. Asegrese que la opcin Proceso o Solamente Subproceso este seleccionada.

270

Copyright 2013 - Bizagi

3.2.4.10.2.1 Manejando entidades de sub-procesos

Los Sub-procesos pueden o no tener la misma Entidad de Proceso que su proceso padre. Por lo tanto, para acceder a la informacin desde el sub-proceso a la del padre debe tener en cuenta el contexto de los procesos para evaluar cmo navegar el modelo de datos. Estos procesos pueden o no tener la misma Entidad de Proceso que el proceso padre. Si el sub-proceso tiene la MISMA Entidad de Proceso que el padre, la informacin del proceso padre la informacin del proceso padre estar disponible en la misma navegacin XPath. La navegacin de datos no cambia de un proceso al otro. Si NO tienen la misma Entidad de Proceso: Los datos sern mapeados usando el contexto que el proceso padre. Se recomienda crear una expresin que relacione el proceso padre y el sub-proceso para facilitar la navegacin. Suponga que tiene un proceso padre de Pago de facturas, cuya Entidad de Proceso es la Factura (Invoice). Tambin tiene un Sub-proceso reutilizable de Creacin de Proveedor cuya Entidad de Proceso es Proveedor (Vendor).

Copyright 2013 - Bizagi

271

En las formas de la Sub-proceso, el contexto ser Proveedor. Si necesita acceder a la informacin del proceso padre puede hacer clic en Ver to d as las opciones para mostrar todas las entidades y arrastrar y soltar los atributos del proceso padre.

Sin embargo se recomienda mapear manualmente la entidad del proceso padre en el proceso hijos para poder acceder a todos los datos a travs de atributo del proceso padre. 1. Cree un atributo en la Entidad Proceso del sub-proceso que se relacione con la entidad del proceso padre:

272

Copyright 2013 - Bizagi

2. Cree una expresin al a entrada de la primera actividad del sub-proceso para relacionar el nuevo atributo. 3. Utilice la funcin M e.Case.P aren tP ro cess Id para obtener el id del proceso padre.

4. Use la funcin CH elp er.g etCaseb y Id para obtener un objeto que contiene toda la informacin del proceso. Utilice como parmetro el id del proceso padre que obtuvimos previamente.

Copyright 2013 - Bizagi

273

5. Finalmente utilice el mtodo A p p licatio n En tity para obtener la entidad Invoice del proceso padre y asociela a la entidad Invoice del sub-proceso.

var objParent =CHelper.getCaseById(Me.Case.ParentProcessId); <Vendor.Invoice>=objParent.ApplicationEntity.GetAttribValue("Invoice"); La informacin del proceso padre puede ahora ser accedida desde el sub-proceso.
3.2.4.10.3 Entendiendo los Subprocesos mltiples

Los Subprocesos Mltiples permiten la creacin de varias instancias de un mismo SubProceso. Utilizando el asistente de Bizagi, usted podr configurar los Subprocesos Mltiples de forma muy

274

Copyright 2013 - Bizagi

sencilla. Para ilustrar cmo trabajan los Subprocesos Mltiples piense en un saln de clase: En un colegio, muchos estudiantes necesitan inscribirse para poder asistir a clase. Las solicitudes inscripcin de los estudiantes deben ser recibidas y luego procesadas, por lo que se debe crear un Proceso de matrcula de estudiantes: uno por cada estudiante. La situacin de negocio descrita puede ser modelada como se muestra en el siguiente diagrama:

El diagrama anterior muestra dos procesos: el primer proceso es Inscripcin de Estudiantes, al cual nombraremos proceso padre, donde los estudiantes relizan la solicitud de inscripcin. El segundo procesos ser conocido como el proceso hijo, en este caso, es un proceso mltiple llamado Matrcula de Estudiantes, es necesario crear un proceso por cada estudiante de forma independiente. La siguiente imagen muestra cmo se utiliza el modelo de datos para crear las mltiples instancias del proceso Matrcula de Estudiantes.

Antes de empezar
Para configurar un SubProceso Mltiple es necesario seguir los siguientes pasos:

Copyright 2013 - Bizagi

275

1. Definir y diagramar el proceso padre: Utilice el primer paso del Asistente para diagramar el Proceso Padre. En este caso, el Proceso Padre en el proceso de Inscripcin de Estudiantes.

2. Definir y diagramar el proceso hijo: Utilice el primer paso del Asistente para diagramar el Proceso Hijo. En este caso, el proceso hijo realizar las actividades necesarias para matricular cada uno de los estudiantes que se hayan inscrito.

3. Crear una relacin uno-a-muchos o una coleccin: En el segundo paso del Asistente modifique el modelo de datos del proceso padre. Es necesario crear una coleccin entre Inscripcin de Estudiantes y las mltiples matriculas de los estudiantes. La relacin ser (StudentsApplication.StudentsEnrollment). InscripciondeEstudiantes.MatriculaEstudiante

276

Copyright 2013 - Bizagi

4. Configure la entidad del Subproceso: Cada proceso en Bizagi tiene una actividad principal. La Entidad de Proceso es la entidad principal por la cual se accede al resto de entidades del modelo de datos. Solamente existe una Entidad de Procesos por proceso. Si el proceso (o Sub proceso) es creado a travs de la vista de Mdulos, la Entidad de Proceso no ser definida. Por lo tanto, usted deber configurar la Entidad de Procesos del Sub proceso mltiple de forma manual. Clic para ms informacin sobre cmo definir una Entidad de Proceso.
3.2.4.10.3.1 Conceptos del mltiple Subproceso

Nmero de instancias
El nmero de ocurrencias que el Subproceso Mltiple crear depende de la cantidad de objetos encontrados dentro de la coleccin o el nmero definido en un atributo de tipo entero. tem en la Coleccin: Valor determinado por el nmero de tems en la coleccin (relacin 1-N). Constante Entera: Valor determinado por una constante entera. Valor en Atributo: Valor determinado por un atributo de tipo entero que hace parte del Modelo de Datos.

Contexto del proceso

Cada proceso en Bizagi tiene una actividad principal. La Entidad de Proceso es un punto inicial para acceder al resto de entidades del modelo de datos. El contexto del Proceso esta definido por la Entidad de Proceso. Si el proceso (o Sub proceso) es creado a travs de la vista de Mdulos, la Entidad de Proceso no ser definida. Por lo tanto, usted deber configurar la Entidad de Procesos del Sub proceso mltiple de forma manual.

Copyright 2013 - Bizagi

277

Configuraciones Bsicas y Avanzadas

Usted puede definir las configuraciones bsicas y avanzadas del Subproceso Mltiple. La configuracin bsica ser aplicada por defecto por Bizagi a travs de un asistente muy sencillo. Clic para ms informacin sobre Configuraciones Bsicas. Las configuraciones avanzadas permiten realizar configuraciones especficas, para este tipo de configuraciones se utiliza todas las opciones del asistente. Clic para ms informacin sobre Configuraciones Avanzadas.

Modo de ejecucin
Las instancias del Subproceso Mltiple pueden ser creadas de dos formas: Paralelas o Secuenciales. Las instancias Paralelas se crearn de forma simultnea, mientras que las instancias secuenciales se crearn una despus de otra. La figura del Subproceso depender del modo de ejecucin seleccionado:

Paralelo IMPORTANTE:

Secuencial

Si el modo de ejecucin seleccionado es Secuencial, no se debe configurar el Modo de Salida. Solamente cuando se selecciona el modo Paralelo, esta opcin estar disponible. Si la opcin Agrupar por es seleccionada, solamente se puede seleccionar el modo de ejecucin paralelo.

Coleccin XPath
La coleccin XPath es el XPath que relaciona la entidad del proceso padre con la entidad de la coleccin que crea las instancias del Mltiple Subproceso.

Limpiar instancias previas

Cuando esta opcin es seleccionada, todas las instancias de la coleccin sern creadas de nuevo en caso que el proceso vuelva a entrar al Subproceso Mltiple. Es decir, si por alguna razn un caso en el Proceso entra ms de una vez al mismo Subproceso Mltiple, Bizagi por defecto ignora las instancias de la coleccin que ya fueron creadas en el Subproceso, no son utilizadas de nuevo. La funcionalidad de Limpiar Instancias Previas ignora el comportamiento por defecto, y cuando un caso vuelve a entrar al Subproceso mltiple crea TODAS las instancias de nuevo, sin importar que ya hayan sido abiertas dentro del caso.

Agrupar por
Existen casos donde las instancias del Subproceso Mltiple deben ser creadas agrupando los registros por algn o algunos atributos de la coleccin. El nmero de instancias del Subproceso que

278

Copyright 2013 - Bizagi

sern lanzadas depender de los diferentes valores de estos atributos. En nuestro ejemplo de Ingreso de Estudiantes, si el mltiple Subproceso necesita ser agrupado por nias y nios, solamente se crearn dos instancias del Subproceso: uno para nias y otro para nios. La siguiente imagen muestra cmo el Subproceso relacionado con la coleccin es agrupado en dos, uno para hombres y otro para mujeres. (La coleccin tiene tres registros).

Entidad Relacionada o Agrupar por Coleccin

Normalmente, la entidad Coleccin y la Entidad de Proceso del Mltiple Sub-proceso son la misma entidad. Sin embargo algunas veces no. Cuando la entidad de negocio del sub-proceso difiere de la entidad Coleccin, el asistente mostrara uno de estas opciones. Entidad Relacionada o Agrupar En Coleccin. Entidad Relacionada o Agrupar En Coleccin son relaciones entre una entidad de coleccin y la entidad del Subproceso mltiple. Estas relaciones son necesarias para permitir al usuario navegar la informacin desde el proceso hasta la coleccin. El campo Entidad Relacionada ser mostrado si la Coleccin no esta agrupada (utilizando la opcin Agrupar Por). Si la coleccin esta agrupada, el campo Grupo en la Coleccin ser mostrado, por que se requiere una relacin uno-a-muchos para agrupar los registros de la coleccin en diferentes subcolecciones.

Ejemplo
Imagine un proceso en un colegio que requiere planear el nuevo ao. El proceso, Back to school, tiene su Entidad de Proceso, Back to school. Un caso nuevo se crear para cada curso (grade), pero el sub-proceso, Grade planning, tienen su entidad de proceso llamada Planning. Por lo tanto la coleccin que crear los casos es diferente de la entidad del sub-proceso: Entidad de coleccin: Grades Entidad de Sub-process: Planning. Note en el diagrama presentado a continuacin que no hay una relacin entre la entidad del Subproceso y la entidad de coleccin. Bizagi necesita una relacin para poder saber qu planeacin se est realizando para cada curso

Copyright 2013 - Bizagi

279

Entonces cuando se configura el sub-proceso Bizagi detectar la situacin y le pedir al usuario crear una relacin. La relacin la crea automticamente.

Una nueva relacin es creada entre las dos entidades. Con esta relacin usted podr acceder desde el sub-procesos a los datos del proceso padre y de la coleccin.

280

Copyright 2013 - Bizagi

Modo de salida
Determina el comportamiento de la salida del Subproceso con respecto al Proceso Padre.

StandAlone: El proceso padre contina con la siguiente actividad tan pronto el Subproceso es creado, sin esperar a que ste termine. El patrn de Secuencia no aplica en este caso pues el Subproceso no depende del proceso padre, es decir, si el proceso padre termina, el Subproceso seguir abierto. IMPORTANTE : Esta opcin no ser mostrada si el modo de ejecucin Secuencial ha sido seleccionado. Solamente en el modo de ejecucin Paralelo. Integrado: La ejecucin del Subproceso es requerida antes de que el proceso padre pueda continuar con la siguiente actividad. Este comportamiento puede ser comparado con el patrn de secuencia donde la actividad B no puede ser ejecutada hasta que la actividad A sea completada. El modo Integrado tiene cuatro opciones de acuerdo a las necesidades de cada negocio. o Todos los Tokens: Todas las instancias creadas del Subproceso se sincronizan y solo hasta que TODAS las instancias del Subproceso hayan terminadas, el proceso padre contina. o Cada Token: Al finalizar de cada uno de los casos del Subproceso, el flujo del Proceso padre contina. Si el modo de salida es cada token, la actividad que sigue al Subproceso mltiple en el proceso padre ser ejecutada tantas veces como instancias del Subproceso hayan. Es importante tener un claro entendimiento de esto pues es necesario sincronizar el proceso en algn punto con una Compuerta Exclusiva usada como Convergencia o Un Token: El proceso padre continuar a la siguiente actividad cuando una de las instancia del Subproceso haya finalizado. o Definido por Expresin: El proceso padre continuar de acuerdo a una expresin, o regla de negocio.

Copyright 2013 - Bizagi

281

3.2.4.10.3.2 Configuracin bsica para los Subprocesos mltiples

La configuracin bsica del Subproceso Mltiple utilizando el Asistente le permitir crear fcilmente Subprocesos Mltiples. Muchas situaciones de negocio pueden se pueden modelar apropiadamente utilizando estos elementos. La configuracin bsica crear Subproceso Mltiples con la siguiente configuracin: Determina el nmero de instancias de acuerdo al nmero de tems contenidos en la coleccin. Crea todas las instancias del Subproceso al mismo tiempo, en modo Paralelo. Espera la finalizacin de todas las instancias creadas antes de continuar con el flujo del Proceso padre. Usted puede modificar la configuracin por defecto utilizando las opciones Avanzadas del asistente. Las configuraciones avanzadas permiten configurar diferentes situaciones de negocio. Para ilustrar la configuracin bsica del Subproceso Mltiple continuaremos utilizando el Proceso Ingreso de Estudiante, l cual fue descrito en la seccin anterior. En un colegio, muchos estudiantes necesitan inscribirse para poder asistir a clase. Las solicitudes de los estudiantes deben ser recibidas y luego procesadas, por lo que se debe crear un Proceso de matrcula de estudiantes: uno por cada estudiante. La situacin de negocio descrita puede ser modelada con se muestra en el siguiente diagrama:

En este ejemplo el Proceso Padre se llama Ingreso de Estudiantes y contiene un Subproceso Mltiple llamado Matrcula de Estudiantes. El objetivo del proceso es: Crear tantas instancias del Subproceso Matrcula de Estudiantes como registros existan en la coleccin relacionada con la entidad del Proceso Padre. Crear las instancias del Subproceso de forma paralela para permitir matrculas de forma no secuencial. Terminar el proceso de inscripcin de estudiantes cuando todas las matrculas hayan terminado. Ambos procesos han sido diagramados en el Modelador de Procesos y se han definido sus Entidades de Proceso respectivas.

282

Copyright 2013 - Bizagi

In g reso d e Estu d ian tes es la Entidad de Proceso del proceso In g reso d e Estu d ian tes y M atrcu la d e Estu d ian tes el la Entidad de Proceso del proceso M atrcu la d e Estu d ian tes. Para crear la relacin de las instancias del Subproceso mltiple se debe definir una coleccin: La coleccin llamada M atrcu la d e Estu d ian tes.

Observe que cuando una relacin uno a muchos es creada entre dos entidades, un atributo se crea de forma automtica en la entidad de la coleccin (muchos) relacionndola con la entidad padre (uno). El atributo IngresoEstudiantes.MatriculaEstudiantes (StudentsApplication.StudentsEnrollment) es la llave de acceso a los atributos del proceso padre partiendo desde el contexto del Subproceso. El diagrama muestra el Proceso Padre antes de crear el Subproceso Mltiple. Para crear un Subproceso Mltiple siga los siguientes pasos:

1. Estando en el proceso Padre vaya al primer paso del Asistente de Procesos y seleccione Editar, para editar el proceso padre.

Copyright 2013 - Bizagi

283

2. En el diagrama, de clic derecho en la tarea que desea convertir, en este caso M atrcu la d e Estu d ian tes y seleccione la opcin Tran sfo rm ar en Su b p ro ceso .

3. Se mostrar una nueva ventana con los tipos de Subproceso. Selecciones la opcin Mltiple y clic en Siguiente.

284

Copyright 2013 - Bizagi

4. Seleccione el proceso a ser transformado desde la lista desplegable, seleccione la versin deseada del proceso Matrcula de Estudiantes y clic en Siguiente. Recuerde, el Subproceso debi ser creado anteriormente en el Asistente, y tanto el Proceso Padre como el Subproceso deben tener la Entidad de Proceso definida.

Copyright 2013 - Bizagi

285

5. Para utilizar la configuracin Bsica del Subproceso Mltiple de clic en sig u ien te sin marcar la opcin de Configuracin Avanzada.

286

Copyright 2013 - Bizagi

6. Seleccione la coleccin XPath. Esto es el XPath que relaciona la entidad del Proceso Padre con la coleccin que abre las instancias del Subproceso Mltiple. En este caso, ser IngresoEstudiantes.MatrculaEstudiantes (StudentsApplication.StudentsEnrollment). Habr tantas instancias del Subproceso como objetos existan en la coleccin Matrcula de Estudiantes.

Copyright 2013 - Bizagi

287

7. Clic en F in alizar

El Subproceso M atrcu la d e Estu d ian tes ha sido configurado de forma exitosa.

3.2.4.10.3.3 Acceso de la informacin del Proceso Padre desde el contexto del Subproceso

Es posible navegar desde la Entidad de proceso del Subproceso mltiple al proceso padre. Suponga que tenemos un Proceso Padre y un Subproceso. Cada Proceso tiene su Editad de Proceso como se muestra a continuacin:

Cuando define relaciones entre entidades, un atributo es creado de forma automtica para permitir el acceso a la informacin de una entidad a otra. Hemos definido una relacin uno a muchos entre la entidad del Proceso padre y la entidad del Subproceso. Note que el atributo Inscripcin de Estudiante ha sido creado en la tabla Matrcula de Estudiantes para acceder a la informacin del Proceso padre desde el contexto del Subproceso.

288

Copyright 2013 - Bizagi

Navegando el modelo de datos desde el Subproceso se puede obtener informacin del Proceso padre que puede ser til cuando se crea un expresin o una forma necesita incluir informacin del proceso padre. Por ejemplo, suponga que necesitamos acceder a tres atributos del Proceso padre, N o m b re, A p ellid o y Cu rso para poder incluir estos detalles en la forma del Subproceso. Las formas en el Subproceso tendrn el contexto del Subproceso, por lo que tendr que existir una forma para acceder a la informacin del caso padre desde la entidad del Subproceso. Cuando se disea una forma, es necesario navegar por el modelo de datos utilizando los atributos relacionados. En este caso, necesitamos navegar desde la entidad de Proceso del Subproceso (Matrcula de Estudiantes) a travs de los atributos de la relacin uno a muchos. Vamos a navegar a travs de la llave fornea Ingreso de Estudiantes (la cual corresponde a la llave primaria de los atributos de la entidad padre), desde all, podemos acceder a los atributos deseados.

Cuando se crea y se asocia una expresin con una actividad dentro del Mltiple Subproceso, es sencillo navegar desde la entidad del Subproceso hasta el Proceso padre. En la siguiente imagen se puede observar cmo navegar a travs de los atributos (el proceso de navegacin es similar cuando se esta creando las formas).

Copyright 2013 - Bizagi

289

3.2.4.10.3.4 Configuracin avanzada para los Subprocesos mltiples

Las opciones avanzadas del Asistente de configuracin del Mltiple Subproceso tienen algunas propiedades especiales en algunos escenarios: Los usuarios podrn configurar el nmero de instancias a crear, no solo utilizando la coleccin, sino tambin definiendo un nmero entero guardado en algn atributo. Los usuarios pueden seleccionar cmo ejecutar el Subproceso, creando las instancias al mismo tiempo (Paralelo) o una por una (secuencial). Usuarios pueden configurar el comportamiento del Proceso Padre cuando se finalizan las instancias creadas: Si el proceso espera la finalizacin de todas las instancias para poder continuar, si espera una sola, o decide de acuerdo a una condicin. La opcin de configuracin avanzada se activa en el tercer paso del Asiste marcando el campo Configuracin Avanzada.

290

Copyright 2013 - Bizagi

La siguiente seccin contiene un ejemplo que ilustra las diferentes opciones de configuracin. Para ejemplificar la opcin de Agrupar por vamos a utilizar el proceso Ingreso de Estudiantes descrito en las secciones anteriores. En un colegio, muchos estudiantes necesitan inscribirse para poder asistir a clase. Las solicitudes de los estudiantes deben ser recibidas y luego procesadas, por lo que se debe crear un Proceso de Matrcula de estudiantes: uno por cada estudiante. La situacin de negocio descrita puede ser modelada con se muestra en el siguiente diagrama:

Copyright 2013 - Bizagi

291

En este ejemplo el Proceso Padre se llama In g reso d e Estu d ian tes y un Subproceso Mltiple llamado M atrcu la d e Estu d ian tes. Ambos procesos han sido diagramados en el Modelador de Procesos y se han definido sus Entidades de Proceso respectivas.

In g reso d e Estu d ian tes es la Entidad de Proceso del proceso In g reso d e Estu d ian tes y M atrcu la d e Estu d ian tes el la Entidad de Proceso del proceso M atrcu la d e Estu d ian tes.
Para crear la relacin de las instancias del Subproceso mltiple se debe definir una coleccin: La coleccin llamada M atrcu la d e Estu d ian tes.

Deseamos manejar el ingreso de los estudiantes de cuerdo al gnero, por lo que se crearn una instancia del sub proceso de Matrcula de Estudiantes para los nios y otra instancia para las nias como se muestra en la figura.

292

Copyright 2013 - Bizagi

Para agrupar las instancias del Subproceso siga los siguientes pasos: 1. Vaya al paso 1 (Modelar Proceso) del asistente y de clic en Editar Proceso. Seleccione el Proceso Padre In g reso d e Estu d ian tes. En el diagrama del modelo, de clic derecho sobre la actividad que desea convertir, en este caso Matrcula de Estudiantes y seleccione la opcin Tran sfo rm ar en Su b p ro ceso . Una nueva ventana mostrar los tipos de Subprocesos. Seleccione la opcin Mltiple y luego clic en siguiente.

2. Seleccione el proceso a ser transformado, M atrcu la d e Estu d ian te, de la lista desplegable, seleccione el proceso y de clic en Sig u ien te.

Copyright 2013 - Bizagi

293

Una vez el diagrama ha sido asociado al Subproceso, seleccione la opcin Co n fig u raci n A v an zad a y de clic en Sig u ien te.

3. Seleccione la coleccin para agrupar el Subproceso. En este caso vamos a agrupar la coleccin IngresoEstudiante.MatriculaEstudiantes (StudentsApplication.StudentsEnrollment). Tambin es necesario seleccionar el nmero de instancias. El nmero de instancias a crear ser determinado utilizando la coleccin. Seleccione la opcin tem en la coleccin.

294

Copyright 2013 - Bizagi

4. En la ultima ventana del Asistente, seleccione la opcin Agrupa por. El asistente le pedir definir la coleccin a agrupar, en este caso la coleccin es Matrcula de Estudiantes. Una vez se ha definido la coleccin, el Asistente le indicar que una relacin debe ser definida entre dicha entidad y la entidad actual Subproceso.

Copyright 2013 - Bizagi

295

Clic en Si para establecer la relacin de forma automtica. Luego clic en Sig u ien te.

296

Copyright 2013 - Bizagi

5. Seleccione los atributos por que los que desea realizar la agrupacin. Seleccione el atributo desde la caja del lado izquierdo y luego arrastre el elemento a la caja del lado derecho para adicionarlo (donde apunta la flecha). Para remover un atributo seleccinelo (de la caja del lado derecho) y arrstrelo hasta la caja izquierda (Atributos en Coleccin). Vamos a agrupar por gnero. Clic en Sig u ien te.

Relacin con el proceso Padre

Cuando ejecute el Proceso notar que no es posible accede a la informacin del Proceso padre ya que no se realiza un mapeo automtico de los datos. Esto significa, que no existe una relacin entre la entidad del Subproceso y la entidad del Proceso padre. Existe una relacin entre la Entidad de Proceso del proceso padre y la entidad agrupada y entre la entidad de Proceso del Subproceso y la entidad agrupada.

Copyright 2013 - Bizagi

297

Es necesario definir la relacin faltante para navegar por el modelo de dato y acceder a la informacin de la entidad del Proceso padre.

Para definir la relacin faltante entre la entidad del Proceso padre y la entidad del Subproceso siga los siguientes pasos:

298

Copyright 2013 - Bizagi

1. Estando en el proceso padre, vaya al segundo paso del Asistente y de clic en Modelo de Datos.

2. Una nueva ventana es mostrada. Clic derecho en la entidad del Subproceso (Matrcula de Estudiantes por gnero) y seleccione la opcin Editar lista de atributos.

Copyright 2013 - Bizagi

299

3. Cree un nuevo atributo dando clic en adicionar e incluya el nombre visual. Seleccione la Entidad del Proceso Padre para crear la relacin. En este caso vamos a escribir Inscripcin de Estudiantes y seleccionar la entidad Inscripcin de Estudiantes de la lista de entidades maestras.

4. La relacin faltante se ha establecido y el modelo de datos ha sido actualizado.

300

Copyright 2013 - Bizagi

5. Ahora es necesario crear una expresin que incluya la informacin necesaria para completar la nueva relacin. Defina al entrar una expresin en la primera actividad del Subproceso. La expresin debe tomar el ID de la entidad del Proceso padre y asignarla en la entidad del Subproceso. La expresin para este ejemplo sera:

var idParent=<StudentsEnrollmentbyGender.StudentsEnrollment[1] .StudentsApplication> <StudentsEnrollmentbyGender.StudentApplication>=idParent Con la relacin creada y la expresin para mapear los datos definida, usted podr acceder a la informacin del contexto del proceso padre de forma normal a travs de la relacin Inscripcin de Estudiantes.

Copyright 2013 - Bizagi

301

Nota Tenga en cuenta que para agrupar instancias del Subproceso es necesario que las entidades del Proceso padre y del Subproceso sean diferentes.

Para ejemplificar la opcin de Secuencial vamos a utilizar el proceso Ingreso de Estudiantes descrito en las secciones anteriores. Ahora suponga que el saln de Segundo Grado siempre matrcula a sus estudiantes de acuerdo al Apellido. Por lo que la opcin Secuencial debe ser utilizada para asegurar que cada caso se abra en orden alfabtico. Ambos procesos han sido diagramados utilizando el Modelador de Procesos y las entidades de proceso han sido definidas para cada uno de ellos.

In g reso d e Estu d ian tes es la Entidad de Proceso del proceso In g reso d e Estu d ian tes y M atrcu la d e Estu d ian tes el la Entidad de Proceso del proceso M atrcu la d e Estu d ian tes.
Para crear la relacin de las instancias del Subproceso mltiple se debe definir una coleccin: La coleccin llamada M atrcu la d e Estu d ian tes.

302

Copyright 2013 - Bizagi

Para configurar la creacin de forma secuencial de las instancias del mltiple Subproceso siga los siguientes pasos: 1. Vaya al paso 1 (Modelar Proceso) del asistente y de clic en Editar Proceso. Seleccione el Proceso Padre In g reso d e Estu d ian tes. En el diagrama del modelo, de clic derecho sobre la actividad que desea convertir, en este caso Matrcula de Estudiantes y seleccione la opcin Tran sfo rm ar en Su b p ro ceso . Una nueva ventana mostrar los tipos de Subprocesos. Seleccione la opcin Mltiple y luego clic en siguiente.

Copyright 2013 - Bizagi

303

2. Seleccione el proceso a ser transformado, M atrcu la d e Estu d ian te, de la lista desplegable, seleccione el proceso y de clic en Sig u ien te. Una vez el diagrama ha sido asociado al Subproceso, seleccione la opcin Co n fig u raci n A v an zad a y de clic en Sig u ien te.

304

Copyright 2013 - Bizagi

3. Seleccione la coleccin que contiene el elemento que crear las instancias del Subproceso. En este caso la coleccin es IngresoEstudiante.MatriculaEstudiantes (StudentsApplication.StudentsEnrollment). Seleccione tem en coleccin y la opcin Nmero de instancias, luego de clic en siguiente.

Copyright 2013 - Bizagi

305

4. Seleccione M o d o d e Ejecu ci n Secu en cial.

306

Copyright 2013 - Bizagi

5. Seleccione el atributo para ordenar las instancias. Es decir, el atributo que va a definir el orden en que las instancias sern creadas. Es este caso, se debe escoger Apellido. Esta opcin crea una instancia a la vez del Subproceso, cuando una termina, la siguiente ser creada. Esta creacin ser de forma alfabtica. Clic en siguiente.

Los casos se crean uno a la vez como se muestra en la siguiente imagen.

3.2.4.10.4 Entendiendo Procesos transaccionales

Los procesos transaccionales son ofrecidos para facilitar la implementacin de escenarios de negocio con transacciones cuya ejecucin podra durar das o semanas hasta que el conjunto de actividades se

Copyright 2013 - Bizagi

307

compete. Desde una perspectiva de negocio, una transaccin es un conjunto de actividades que constituyen una unidad lgica de operacin que debe realizarse atmicamente (indivisible). sta es soportada por un protocolo especial que asegura que todas las partes involucradas tengan acuerdo completo: la actividad debera ser completada o cancelada. Una transaccin o Subproceso transaccional es realizado satisfactoriamente cuando los cambios a ser implementados (actualizacin, adicin o eliminacin de registros) son salvados en la base de datos; en otras palabras, la terminacin de los cambios se realiza una vez la transaccin ha terminado. Los eventos de excepciones o cancelaciones son lanzadas sin afectar la informacin o integracin de la base de datos cuando la transaccin no se complet satisfactoriamente. Las transacciones pueden ser cortas o largas dependiendo del tipo de tareas a ser ejecutadas, que pueden ser automticas o manuales. Las transacciones de larga duracin modeladas con BPMN tienen tres posibles salidas: La primera salida se presenta cuando todas las actividades del proceso son ejecutadas satisfactoriamente, en este caso, el proceso contina por el flujo normal. La segunda salida se presenta cuando ocurre una falla y es necesario reversar las actividades que ya fueron completadas dentro del proceso. Esto se realiza a travs de la compensacin de actividades. Cada actividad que necesite compensacin tiene una actividad asociada a ella. La compensacin es ejecutada cuando es necesario retornar al estado inicial de algo y solo es realizada cuando una actividad ha terminado de forma exitosa. La ltima salida ocurre cuando se presenta un error inesperado, las actividades del Subproceso transaccional son interrumpidas sin realizar ninguna compensacin y el Proceso contina con la ejecucin del Evento intermedio de error. Para modelar un Proceso transaccional es necesario adjuntar los eventos de Error y de Cancelacin al Subproceso. Si alguno de los dos eventos ocurre, el flujo del proceso podr continuar. El borde de la figura del Subproceso transaccional se muestra con una doble lnea.

Figura Subproceso transaccional

Modelado de un Subproceso transaccional

Un ejemplo de una transaccin tpico es el traslado de fondos entre cuentas, este traslado puede estar dado por la ejecucin de dos servicios web diferentes, uno que debita y otro que acredita la otra cuenta; si el segundo servicio web tiene algn problema (nmero de cuenta errado, cliente inactivo, etc.) el dbito ya fue realizado por el primero y es necesario reversarlo. Este proceso de reversin, o compensacin, puede consistir en la ejecucin de un nuevo Servicio Web que le avise al sistema externo para que acredite de nuevo la cuenta y esta no se vea afectada.

308

Copyright 2013 - Bizagi

Imagine un Proceso de traslado de fondo entre cuentas, el cual es un ejemplo tpico de transacciones. El dbito se realiza en una cuenta y el crdito se realiza en otra cuenta. Las acciones de debitar y acreditar se realiza a travs de una interfaz que utilizan los dos bancos de forma independiente. El dbito debe ser reversado si ocurre un problema (nmero de cuenta errneo, cliente inactivo, etc.) y la ejecucin de una accin es requerida para reversar o compensar la transaccin. Es este caso la transaccin se termina sin realizar transferencia de fondos. El diagrama del proceso ser:

El proceso de traslado de fondos puede tener tres salidas diferentes: la normal, cancelacin y excepcin.

Normal
En el flujo normal del proceso las operaciones de crdito y dbito se realizan de forma correcta. Bizagi guarda los cambios realizados en la base de datos (se realiza commit) y el proceso contina por el flujo normal, este escenario considera que la transaccin ha sido realizada de forma exitosa. En la imagen de abajo, el proceso realiza las transferencias de fondos utilizando una interfaz implementada con Servicios Web, la cual debita una cantidad y acredita otra. El proceso contina por el flujo normal, es decir, la actividad Activar Crdito se realiza tan pronto el Proceso transaccional termina de forma correcta.

Copyright 2013 - Bizagi

309

Cancelacin
El evento de cancelacin es activado cuando ocurre una falla y se lanza una excepcin (se realiza la cancelacin). En este caso el Proceso ejecuta las actividades de compensacin requeridas y abandona el Subproceso transaccional ejecutando el flujo de cancelacin. Los datos modificados durante la ejecucin del Subproceso no sern guardados en la base de datos; por lo tanto, el proceso ser reversado a la etapa anterior a la ejecucin del Subproceso. Los siguientes flujos de proceso ayudan a entender el evento de cancelacin. 1. Una cuenta se debita de forma exitosa por medio de la ejecucin de una interfaz. 2. El crdito a la cuenta del cliente se intento, pero el nmero de cuenta esta errneo por lo que la operacin fue rechazada. La segunda interfaz genera un error y el Evento de Cancelacin es lanzado. 3. Bizagi ejecuta las actividades de compensacin en orden contrario a como fueron ejecutadas. En este caso solamente la actividad Co m p en sar Db ito es actividad de co m p en saci n y es la encargada de deshacer lo ejecutado en la tarea Dbito, por lo tanto, una interfaz tiene que acreditar la cantidad previamente debitada. 4. La suspensin del crdito se realiza por que la transferencia de fondos no puedo ser completada.

310

Copyright 2013 - Bizagi

Nota: Los eventos de cancelacin solo pueden ser definidos para Subprocesos transaccionales.

Actividades de compensacin
Las actividades de compensacin deben restaurar la informacin que fue cambiada en las actividades que fueron ejecutadas de forma satisfactoria. Usualmente las actividades de compensacin son realizadas a travs de un sistema externo. Las actividades de compensacin son creadas utilizando el Evento Intermedio de compensacin:

Excepcin

Copyright 2013 - Bizagi

311

Un error de excepcin en lanzado cuando existe un error que no puede ser manejado por el Subproceso transaccional el cual no permite que el Subproceso contine; las actividades son interrumpidas sin co m p en saci n . La informacin de la base datos es restaurada a su estado inicial (rolled back) y el Proceso contina por el Evento Intermedio de Error. El manejo de la excepcin se realiza utilizando el Ev en to d e Erro r In term ed io . Los siguientes flujos de proceso ayudan a entender el evento de cancelacin. 1. Se trata de realizar un dbito de la cuenta del cliente, sin embargo el servidor no responde. La interface genera un error y el Evento de Error es lanzado. 2. La transferencia se realiza por telfono y la transaccin es concluida.

Excepcin
Un error de excepcin en lanzado cuando existe un error que no puede ser manejado por el Subproceso transaccional el cual no permite que el Subproceso contine; las actividades son interrumpidas sin co m p en saci n . La informacin de la base datos es restaurada a su estado inicial (rolled back) y el Proceso contina por el Evento Intermedio de Error. El manejo de la excepcin se realiza utilizando el Ev en to d e Erro r In term ed io . Los siguientes flujos de proceso ayudan a entender el evento de cancelacin. 1. Se trata de realizar un dbito de la cuenta del cliente, sin embargo el servidor no responde. La interface genera un error y el Evento de Error es lanzado. 2. La transferencia se realiza por telfono y la transaccin es concluida.

312

Copyright 2013 - Bizagi

Notas: Las interfaces externas deben ser compensadas adecuadamente cuando se ejecutan en un proceso para realizar modificaciones en datos externos a Bizagi a travs de Servicios Web o de Librera de componentes. Se deben evitar actividades que realicen reversiones en muchos casos porque la actividad no sabr cuales fueron satisfactorias y cuales deben ser revertidas de nuvo. Los eventos de error solo pueden ser definidos en Subprocesos transaccionales.
3.2.4.10.4.1 Configuracin del Subproceso transaccional

Para ilustrar cmo se configura un Subproceso transaccional vamos a utilizar el siguiente diagrama:

Copyright 2013 - Bizagi

313

El diagrama hace referencia a un proceso de So licitu d d e Viajes. El proceso de Solicitud de Viajes incluye todas las actividades necesarias para recibir y manejar las solicitudes de viajes realizadas por un empleado de la compaa. Necesitamos transformas la tarea Reserv ar en un Subproceso Transaccional para poder tener en cuenta situaciones que necesitan tratamiento especial. Para configurar un Subproceso transaccional realice los siguientes pasos: 1. Vaya al paso 1 (Modelar Proceso) del Asistente de proceso y clic en Editar Proceso.

2. Clic derecho en la tarea que desea convertir a un Subproceso transaccional, en este caso la tarea Reserv ar, y seleccione la opcin Tran sfo rm ar en Su b P ro ceso .

314

Copyright 2013 - Bizagi

3. El asistente es lanzado. Una nueva ventana ser mostrada con los tipos de Subprocesos. Seleccione la opcin Tran saccio n al y de clic en siguiente .

4. Ingrese un Nuevo nombre o seleccione un proceso existente de la lista desplegable, clic en Finalizar.

Copyright 2013 - Bizagi

315

5. Una vez el Subproceso ha sido creado, usted puede empezar a editarlo. Clic derecho en el Subproceso recin creado Reserv ar y seleccione la opcin Ed itar Su b p ro ceso .

6. La ventana muestra el diagrama del Subproceso. Cuando usted crea un subproceso por primera vez, un diagrama en blanco aparece con un contenedor que incluye una fase. Usted puede modelar el proceso basado en el siguiente diagrama. En el Subproceso Reservar, el Departamento Administrativo maneja las solicitudes de reservas de carro, hotel y vuelos realizadas por el empleado. Cuando las reservas se realizan, el Subproceso

316

Copyright 2013 - Bizagi

termina. El flujo del proceso se muestra en el siguiente diagrama.

En este escenario, muchas situaciones pueden suceder mientras se desarrolla el proceso. Por ejemplo, el Departamento Administrativo puede confirmar de forma satisfactoria la reserva del carro y del hotel. Sin embargo cuando se va a realizar la reserva del vuelo, no hay asientos disponibles en ninguna aerolnea en la fecha solicitada. Ya que las reservas del carro y del hotel fueron realizadas en las fechas dadas se necesita realizar la cancelacin y notificar al empleado sobre ella. Este escenario puede ser modelado de la siguiente forma:

Un evento de compensacin es adjunto a los lmites de cada actividad de reserva. Este evento es utilizado para activar el flujo de cancelacin una vez se ha lanzado. En este caso, el flujo de cancelacin representa las actividades que deben ser realizadas de forma manual para resolver la situacin inesperada.

Copyright 2013 - Bizagi

317

En el siguiente escenario, el Evento de Compensacin adjunto a la actividad Reservar carro y Reservar Hotel es activado. Por lo que las actividades de compensacin de Cancelar Carro y Cancelar Hotel sern ejecutadas, permitiendo al Departamento Administrativo manejar la compensacin en cada una de las actividades. Para asociar un Evento de Compensacin, clic derecho en la actividad a compensar y seleccione la opcin Adjuntar Evento. Seleccione el evento de compensacin.

La tarea de compensacin es creada automticamente. Realice la misma operacin para las otras dos actividades.

318

Copyright 2013 - Bizagi

7. Ahora necesitamos modelar el flujo de cancelacin del proceso Padre. Si las actividades son compensadas, el token del caso no contina a travs del flujo de proceso. Como resultado y el empleado no ser notificado sobre las reservas exitosas ya que fueron canceladas. Teniendo en cuenta lo sucedido necesitamos crear un Evento de Cancelacin para el Subproceso transaccional. En el Proceso padre, de clic derecho en Subproceso Reservar, selecciones la opcin Ajuntar Evento y seleccione el Evento de Cancelacin.

El flujo de cancelacin enviar una notificacin al empleado para informarle que las reservas no

Copyright 2013 - Bizagi

319

pudieron ser realizadas. Por esta razn, hemos agregado una tarea d e Scrip t al flujo.

Un evento de Finalizacin es utilizado para terminar el Proceso. 8. El diagrama todava necesita manejar errores inesperados. Un error es lanzado cuando algo inesperado ocurre y no existe un procedimiento para manejar el error. Vamos ha convertir la actividad Reserv ar Vu elo en una tarea automtica y adicionar una interfaz. Si durante la ejecucin de la tarea automtica Reserv ar Vu elo se presenta un error (error de conexin, etc.), el Subproceso terminar y lanzar el flujo de excepcin en el Proceso principal.

9. Finalmente, vamos a incluir el flujo de excepcin en el Proceso padre para atender errores inesperados en el Subproceso. Para capturar un error, se debe adjuntar un Ev en to d e Erro r a los lmites del Subproceso Reserv ar.

320

Copyright 2013 - Bizagi

Clic sobre el Subproceso, seleccione la opcin A d ju n tar Ev en to y seleccione Erro r.

El flujo de excepcin notificar a la persona asignada, en el Departamento Administrativo sobre el error.

Nuestro Subproceso transaccional ha sido configurado de forma exitosa.

3.2.4.10.5 Entendiendo el proceso Ad Hoc

Es muy comn encontrar dentro de los negocios casos en los cuales es necesario manejar un proceso

Copyright 2013 - Bizagi

321

que no tiene tareas conectadas entre s, ni el orden de ejecucin de estas definido (Proceso Ad Hoc). Un proceso Ad Hoc consiste en una serie de actividades que no tienen un orden o un ejecutante definido. En este tipo de procesos los usuarios deben poder decidir el Qu, el Cundo y el Quien de las actividades que se necesitan crear, adems de asignar trabajo a otras personas, logrando una interaccin entre diferentes usuarios. Aunque Bizagi no soporta directamente los Procesos Ad Hoc, se propone un modelo para implementar procesos Ad Hoc. Est modelo le permitir simular el comportamiento de las actividades del proceso Ad Hoc. Para implementar el proceso existe un patrn especial que permite la creacin de tareas en cualquier momento y pueden ser ejecutadas sin ningn orden particular durante la vida del proceso. Estas tareas pueden ser asignadas a cualquier persona y pueden ser ejecutadas en cualquier momento. Los usuarios que han sido asignados a estas tareas pueden crear tareas adicionales para ellos mismos o para otros participantes del proceso. El modelo utiliza un evento el cual permitir a todos los usuarios en cualquier momento del proceso crear y asignar nuevas tareas a ellos mismos o a otra persona. Le recomendamos visitar nuestro Process Central donde podr descargar y ver el funcionamiento del proceso Ad-Hoc.

Patrn Ad Hoc
El patrn Ad Hoc permite modelar el comportamiento del Proceso Ad Hoc. El flujo del proceso permite definir un conjunto de actividades iniciales, ejecutarlas y crear en otros momentos nuevas actividades. El Proceso puede ser finalizado en cualquier momento, no importa si las actividades programadas no hayan terminado. La siguiente imagen muestra el patrn del proceso Ad Hoc:

322

Copyright 2013 - Bizagi

Las actividades iniciales son definidas en la tarea Configurar Actividades Iniciales adicionndolas (las actividades) a la coleccin. La primera Compuerta Paralela habilita tres caminos: El Subproceso Realizar Actividades ejecuta cada uno de los tems incluidos en la coleccin de forma individual. El Subproceso ejecuta cada tem de la coleccin en paralelo, es decir, no espera la terminacin de ninguna actividad para activar una nueva. El segundo camino habilita el evento Crear ms actividades, es este evento el usuario puede programar nuevas actividades, de nuevo, ingresndolas como registros dentro de la coleccin. El ltimo camino habilitado es el Evento de Final de Proceso el cual permite terminar el Proceso en cualquier momento. La segunda compuerta Paralela garantiza que el Evento Crear ms Actividades este siempre disponible para la creacin y programacin de nuevas actividades. Adicionalmente, el evento tambin habilita el Subproceso Realizar Actividades para ejecutar todas las tareas creadas en el Evento Crear m s activ id ad es.
3.2.4.10.5.1 Configurar un sub proceso Ad Hoc

Con el siguiente ejemplo vamos a ilustrar cmo utilizar el Proceso Ad Hoc. Imagine la reunin de un comit, donde las actividades relacionadas con un proyecto son definidas, asignadas y programadas. Estas actividades sern habilitadas para cada responsable de acuerdo a su programacin. Ya que puede presentarse la necesidad de programar nuevas Actividades durante el desarrollo del proyecto para afrontar a situaciones inesperadas o que no han sido cubiertas, es necesario implementar el patrn Ad Hoc como se muestra a continuacin:

La primera actividad, como resultado de la Reunin de comit, es registrar las tareas iniciales. Cuando

Copyright 2013 - Bizagi

323

la reunin ha terminado, una actividad es creada para el responsable a travs del Proceso Ad Hoc Realizar Actividades. El evento le permitir programar nuevas tareas y mirar el avance de las tareas que fueron creadas previamente. En el evento es necesario incluir la descripcin de la tarea, definir la fecha y el responsable de la ejecucin de ella. Cada una de las nuevas tareas, de nuevo, son ejecutadas por el Proceso Ad Hoc Realizar Actividades. Note que el Evento Crear Tarea permanecer habilitado durante toda la ejecucin del Proceso para permitir la creacin de nuevas tareas. El Evento Finalizar Proceso tambin est disponible desde el inicio del proceso para permitir que este termine en cualquier momento.

Modelo de Datos
El modelo de datos para nuestro patrn de procesos es muy sencillo. La entidad de Proceso es Reu n i n d e co m it donde la informacin de la reunin es archivada. La entidad tiene una relacin uno a muchos con la entidad Tareas, la cual contiene la historia y el estado de todas las tareas creadas. La entidad Tareas es tambin utilizada para especificar el nmero de instancias del Subproceso Realizar Actividades, es decir, las muchas ocurrencias de los tems encontrados en la coleccin Tareas.

Formas
Con el fin de obtener la informacin necesaria para ejecutar con xito el proceso, las formas debern incluir la siguiente informacin: Reunin de Comit: En sta actividad se debe incluir la informacin principal, es decir las actividades que deben ser programadas. La tabla debe ser editable y permitir la adicin de nuevos registros. Informacin adicional de la reunin puede ser incluida. Crear Tareas: En este evento la coleccin de tareas a programar debe permitir adicional nuevos registros, pero los anteriores deben ser no editables. Ejecutar Tareas: En est forma deber incluir toda la informacin relacionada con la tarea con el fi de identificarla y actualizarla.

3.2.5

BPMN Colaborativo
Los Procesos se pueden comunicar entre s a travs de flujos de mensaje. Este tipo de comunicacin se denomina Co lab o raci n . Las Colaboracin es una herramienta que relaciona dos o ms Procesos, permitiendo su comunicacin

324

Copyright 2013 - Bizagi

a travs de enviar y recibir mensajes que contienen informacin que es utilizada para tomar acciones. En Bizagi, la Colaboracin se hace a travs de las figuras de Lan zam ien to y Cap tu ra, las cuales pueden ser configuradas en cada Proceso. Las figuras que permiten la Colaboracin en Bizagi son:

FIGURA

DESCRIPCIN Mensaje de Inicio: Con esta figura, un Proceso activo enva un mensaje a un Proceso especfico para iniciarlo. El Mensaje de Inicio siempre recibe mensajes, nunca los enva.

Mensaje de Fin: Este tipo de Fin indica que un mensaje se enva a un Proceso o caso especfico cuando un flujo concluye. Este evento siempre enva mensajes, nunca los recibe.

Evento Intermedio de Mensaje: Esta figura tiene una opcin de lanzar y atrapar, la cual permite enviar o recibir un mensaje (cuando se utiliza para enviar un mensaje, la figura posee un sobre con relleno slido. Cuando se utiliza para recibir un mensaje, solo se muestra el contorno del sobre).

Seal de Inicio: Con esta figura, un Proceso se inicia al recibir una seal enviada desde otro Proceso activo. Las seales de inicio siempre reciben mensajes, nunca los envan. Seal de Fin: Este tipo de Fin indica que una seal se enva al finalizar un flujo. Las seales de Fin siempre envan mensajes, nunca los reciben. Evento Intermedio de Seal: Las seales se utilizan para enviar o recibir comunicaciones generales dentro y a lo largo de los Procesos. Una seal BPMN es similar a una bengala que se enva al cielo para que cualquiera que pueda estar interesado en ella, la vea y reaccione. Por lo tanto, hay un generador de la Seal, pero no un objetivo especfico. Esta figura tiene una opcin de lanzar y atrapar, la cual permite enviar o recibir seales. Cuando se utiliza para enviar la seal, este evento se muestra con un tringulo con relleno slido en su interior. Cunado se utiliza para recibir la seal, solo se muestra el contorno de dicho tringulo.

Configurar colaboracin
Para configurar la colaboracin, cree eventos en los procesos que colaborarn, desde el primer paso del Asistente de Procesos. Convierta los eventos incluidos a los tipos de evento requeridos, dando clic derecho sobre ellos. Seleccione Tip o d e ev en to y luego de clic sobre el evento deseado.

Copyright 2013 - Bizagi

325

Recuerde definir eventos de lanzamiento y de captura.

Cuando utilice eventos intermedios, deber configurar manualmente el evento de Lanzamiento. Por defecto, Bizagi define todos los eventos como eventos de captura, al momento de su creacin. Una vez que el evento intermedio ha sido convertido, d clic de nuevo sobre l y seleccione Lan za el ev en to .

326

Copyright 2013 - Bizagi

Configurar seales
Las seales son similares a una bengala disparada al cielo, de manera que cualquiera que pueda estar interesado en ella, la note y reaccione. Por lo tanto, la seal posee un origen, pero no un objetivo especfico. Para asegurar que las Seales se lanzan y capturan correctamente, el NOMBRE del evento debe ser exactamente el mismo. No se requieren configuraciones adicionales.

Copyright 2013 - Bizagi

327

Configurar mensajes
Los mensajes son enviados a objetivos especficos. Estos deben ser configurados desde el sexto paso del Asistente de Procesos. En el proceso que contiene el evento de Lanzamiento, dirjase a la opcin Co lab o raci n .

328

Copyright 2013 - Bizagi

Se resaltarn los eventos que necesitan configuracin. D clic en el evento e ingrese la siguiente informacin: Proceso: Nombre del proceso que captura el mensaje. Elemento: Elemento BPMN que captura el mensaje, dentro del proceso definido anteriormente. XPath: Identifica el caso que recibir el mensaje (i.e. el id del caso del proceso que posee el evento de mensaje de captura). El nmero de caso que recibe el mensaje debe ser almacenado en el modelo de datos del proceso. Tenga en cuenta que cuando un evento de mensaje de captura es un Ev en to d e m en saje d e in icio , el campo de XPath donde se mapea el id del caso, no es editable. El id del caso podra guardarse utilizando la funcin CaseId que se encuentra dentro de las funciones de expresin.

Copyright 2013 - Bizagi

329

330

Copyright 2013 - Bizagi

3.2.5.1

Ejemplo de seal En el siguiente ejemplo, una seal ser enviada desde el proceso Invoice payment (Pago de factura), para crear un nuevo caso del proceso Process payment (Procesar factura) una vez que se recibe y aprueba una factura. La informacin contenida en el proceso Invoice Payment debe estar disponible en el proceso Process payment.

Copyright 2013 - Bizagi

331

Cuando el caso llega al Ev en to d e fin d e se al, una seal se enva a cualquier otro evento (catch) que posea el mismo nombre. En este caso, encontramos un evento que cumple con esta condicin, en el proceso Process Payment. Este es un evento de Seal de Inicio, por lo que al ser activado, crear un nuevo caso. Toda la informacin del proceso que enva la seal, estar disponible en el nuevo proceso. No es necesario usar expresiones. Es importante que recuerde que ambos procesos (el que enva y el que recibe la seal) deben tener la misma Entidad de Proceso y pertenecer a la misma Aplicacin. En estos procesos las formas, reglas y dems elementos se construyen partiendo de la misma Entidad de Proceso: In v o ice.

332

Copyright 2013 - Bizagi

3.2.6

Duracin de Tareas y procesos

La duracin de las tareas y procesos es utilizada para calcular los Reportes de Desempeo de Bizagi, los cuales son de fcil interpretacin y se basan en informacin precisa y en tiempo real del negocio. La duracin que aplica para los reportes es la d u raci n estim ad a definida en las propiedades de las tareas.

Copyright 2013 - Bizagi

333

La duracin tambin determina el color de las tareas pendientes mostradas en el Portal de trabajo. Esto ayuda al usuario a identificar rpidamente el estado de las actividades de la siguiente forma: Luz verde cuando la tarea se encuentra a tiem p o . Amarilla cuando la fecha lmite de la actividad es ese da, es decir la actividad se encuentra en Riesg o . Rojo cuando la tarea presenta retraso o ha expirado.

En Bizagi existen varios tipos de formas que necesitan tener la duracin configurada con el fin de permitir al dueo del Proceso realizar ajustes rpidamente en el flujo del proceso, logrando optimizar la toma de decisiones y el rendimiento del negocio. Las siguientes formas necesitan duracin: Tareas de usuario Tareas Manuales

334

Copyright 2013 - Bizagi

Subprocesos Eventos de temporizacin

Duracin de tareas y procesos

La duracin definida par alas tareas, Procesos y Subprocesos es el SLA (Nivel de servicio acordado), es decir, el tiempo mximo para considerar una tarea activa (sin finalizar) a tiempo. La duracin se define durante la etapa de desarrollo, y puede ser ajustada en produccin de ser necesario. Estas duraciones pueden ser estticas o dinmicas. Es decir, pueden ser configuradas con un nmero entero en la propiedad de la figura o puede tener una duracin dinmica configurada utilizando una expresin. Los das especificados en el SLA sern de tantas horas como indique el esquema de tiempo de trabajo de la organizacin (working-time-schema) por defecto de la organizacin. Por ejemplo, si un da tiene 8 horas hbiles segn el esquema de tiempo de trabajo, un SLA ingresado de 3 das se asumir como 24 horas (3 das x 8 horas hbiles), y NO de 72 horas. Es importante recordad que la duracin de una Actividad NO es cuanto tiempo toma un usuario ejecutar la actividad desde el momento que accede a ella hasta que la termina. La duracin es el tiempo mximo que una actividad puede estar abierta sin haber terminado sin alterar el Tiempo del Proceso. La duracin de la actividad es el SLA. Para configurar la duracin de las actividades, abra el Modelador de Procesos (primer paso del Asistente), de clic derecho sobre la actividad y seleccione Propiedades.

Copyright 2013 - Bizagi

335

La duracin informacin es dividida en das, horas y minutos. Ingrese el tiempo para cada tarea. Recuerde grabar cuando haya terminado.

336

Copyright 2013 - Bizagi

Para incluir la duracin del proceso, de clic derecho sobre el nombre del Proceso y seleccione P ro p ied ad es.

Los lmites Superior e Inferior son utilizados para propsitos de documentacin y no afectan el reporte de indicadores. La Du raci n Estim ad a y los lmites Superior e Inferior aparecern en las propiedades de la siguiente forma:

Copyright 2013 - Bizagi

337

Ejemplo
Una tarea tiene una duracin (SLA) de tres das. Tan pronto como la tarea se activa (y se asigna) el tiempo empieza a contar. Cada actividad tiene un ejecutante, o una persona en cargo de ella. Por lo que la actividad ser mostrada en el rea de Trabajo con una luz delante de ella. En este caso tendr una luz verde por dos das, mientras se encuentre a tiempo. La luz cambiar a amarillo el da que vence la actividad, por que en ese momento se encuentra en riesgo. Por ltimo, cuando el tercer da termine la luz de la actividad cambiara a rojo debido a que la fecha termino. Cuando una actividad es roja, significa que el usuario encargado no cumpli el SLA.

Cambiar duracin en el ambiente de produccin

Una vez los procesos estn en produccin, puede ser necesario cambiar y/o ajustar la duracin de actividades de acuerdo a las necesidades del negocio o a las estrategias de la organizacin. Estos valores pueden llegar a necesitar ajustes constantes para permitir un correcto anlisis de desempeo. Para acceder a la duracin de las tareas de los procesos, ingrese al Portal de Trabajo y en la opcin Admin seleccione Procesos.

338

Copyright 2013 - Bizagi

Se mostrar una nueva ventana con la lista de los Procesos. Elija el que desea manejar. De clic en cualquier tarea y luego clic en Editar para cambiar su duracin. Note que el tiempo del proceso est disponible para ser cambiado en el momento en que lo seleccione. Clic en Aplicar cuando haya definido la nueva duracin.

Nota Esta opcin solo est disponible en el ambiente de produccin. En desarrollo se debe utilizar las propiedades de la figura.

Copyright 2013 - Bizagi

339

3.2.6.1

Duracin dinmica Como se explico en la seccin anterior, las tareas Manuales y de Usuario siempre deben tener una duracin especificada. Los eventos Intermedios de Temporizacin requieren de la definicin de una duracin para establecer el tiempo que debe esperar el proceso, antes de continuar con su flujo. La duracin de las tareas Manuales y de Usuario puede ser esttica, como se mencion anteriormente, o dinmica. Duracin dinmica significa que puede variar de acuerdo con las condiciones de negocio. La duracin dinmica es configurada a travs de reglas de negocio A l En trar, de la figura que se esta configurando. La expresin utilizada puede ser definida en minutos o en una fecha especfica. Duracin en minutos: Me.Duration = x (minutos) Duracin con una fecha especifica: Me.EstimatedSolutionDate = Date IMPORTANTE: Si una tarea Manual o de Usuario tiene una duracin dinmica configurada, la duracin esttica ser ignorada. La duracin dinmica ser tenida en cuenta en los colores del Portal de Trabajo y en el Anlisis de Reportes. Visite Definir la duracin de tareas y temporizadores para ver un ejemplo de cmo configurar duraciones dinmicas.

3.3

Modelo de Datos
El segundo paso del Asistente de Bizagi es definir los datos que el proceso requiere para su ejecucin. Bizagi permite estructurar la informacin del negocio utilizando un ambiente grafico y lgico, resultado en un modelo de Dato de Fcil entendimiento. El modelo de datos en Bizagi, define especficamente cmo se debe almacenar y acceder a los datos. Bizagi permite compartir y reusar el Modelo de Datos entre diferentes procesos. Es muy importante que la informacin en su proyecto este organizada correctamente para lograr alcanzar los objetivos del proceso. Para proporcionar una estructura organizada y coherente, Bizagi provee cuatro tipos de Entidades y cuatro tipos de Relaciones para construir su modelo de datos.

Entidades
Entidades son objetos reales o abstractos (personas, lugares, eventos, etc.) que pueden ser identificados de forma nica y tiene informacin de inters para el negocio almacenada en el sistema. Entidades se nombran normalmente con sustantivos. Por ejemplo, cliente, Ciudad, Compaa, Factura, Carro. Las entidades tiene Atributos. Estos son las propiedades que describen cada entidad. Por ejemplo un cliente tiene un nombre, un nmero de seguridad industrial y una edad. Entidades siempre deben tener un atributo o un conjunto de atributos por lo que pueden ser identificado de forma nica. Por ejemplo, un Cliente tiene un nico nmero de seguridad social. Ningn otro registro puede tener el mismo valor. Bizagi genera automticamente para cada fila un nico nmero consecutivo que identifica cada registro de la entidad. Este identificador es llamado Surrogate Key. No tiene ninguna conexin con los datos de los atributos en la fila, simplemente marca cada una de ellas como nica.

340

Copyright 2013 - Bizagi

Entidad Principal del Proceso

Cada proceso en Bizagi tiene su entidad de Proceso principal. Esta entidad provee un punto de inicio para acceder al resto del modelo de datos, es decir, es la entidad principal por la que los usuarios acceden al resto de las entidades del modelo de datos. En el segundo paso del Asistente se crea la primera entidad del proceso. Esta tendr una doble lnea que la distingue del resto de las entidades. En Bizagi usted podr convertir una entidad en una Entidad de Proceso.

Relaciones
Las relaciones capturan cmo las entidades se relacionan entre s a travs de verbos. Por ejemplo: Un Cliente tiene un carro. Una compaa est ubicada en una ciudad. Un cliente tiene un gnero. Con cada relacin, una llave fornea es creada automticamente. Una llave fornea es un atributo que contiene la llave primaria de otra entidad.

3.3.1

Crear el modelo de datos

El segundo paso del Asistente de procesos de Bizagi es definir la informacin que el Proceso requiere para su ejecucin. Vamos a utilizar el Proceso de Solicitud de Comprar para explicar la construccin del modelo de datos. 1. Seleccione la opcin M o d elo d e Dato s en el Segundo paso del Asistente de proceso.

Copyright 2013 - Bizagi

341

2. Una nueva ventana mostrar una lista desplegable para seleccionar una entidad. Ingrese el nombre de la Entidad principal del Proceso o seleccione una entidad existente. Recuerde que la Entidad de Procesos es la entidad principal de su proceso y es el modo de acceso al resto de las entidades del modelo de datos. Clic en O K.

3. Clic derecho sobre la Entidad de Proceso y seleccione Ed itar Lista d e A trib u to s para empezar a incluir atributos.

342

Copyright 2013 - Bizagi

4. El asistente de la entidad ser ejecutado para permitir incluir los atributos que necesite. Clic en el botn A d icio n ar. Un nuevo registro ser incluido a la tabla donde el primer campo contiene el nombre para mostrar del atributo. El Nombre Visual es el nombre que se muestra en la interfaz del usuario en el Portal de Trabajo. El atributo Nombre es un identificador nico para uso interno y es creado automticamente. La ltima columna especifica el tipo de datos del atributo. Por ejemplo el atributo fecha de entrega de una compra debe ser de tipo fecha (es decir, tipo de dato Date-tim e). La direccin de entrega debe ser un texto (Tipo de dato Tex to ).

Copyright 2013 - Bizagi

343

5. Tambin es posible crear atributos que relacionen entidades Maestras con entidades Paramtricas. En este ejemplo vamos a agregar una relacin con la Entidad Paramtrica Ciu d ad. En el N o m b re Visu al incluya el nombre de la Relacin. Digite el nombre de la relacin en el campo de N o m b re Visu al y seleccione la entidad hijo. Para realizar esto, primero extienda los elementos de la En tid ad (dando clic en el signo ms) y luego en el elemento P arm etro . Seleccione N u ev a En tid ad o seleccione una entidad existente de la lista presentada.

344

Copyright 2013 - Bizagi

6. La ventana con la Lista d e A trib u to s aparecer para que pueda ingresar todos los atributos a la nueva Entidad Paramtrica.

Copyright 2013 - Bizagi

345

7. En el ltimo paso, debe definir el Atributo para Mostrar y la entidad pap (Clic en A v an zad o / O cu ltar para ver el campo) si existe uno asociado. El atributo para Mostrar es el atributo visible creado para una entidad que ser mostrada en el Portal de Trabajo cuando se refiere a la entidad. Este campo es obligatorio, sin embargo puede ser seleccionado desde el Modelador de las interfaces de usuario. Cuando termine, de clic en finalizar. El sistema regresa a venta mostrada anteriormente (Lista de atributos) del asistente, donde usted podr continuar agregando atributos a la entidad. Cuando termine de agregar todos los atributos, clic en Finalizar.

346

Copyright 2013 - Bizagi

Nota: Usted puede incluir atributos adicionales en cualquier momento, de la misma forma como se realiz en el ejemplo.

3.3.1.1

Opciones del Modelo de Datos El asistente del modelo de datos tiene varias opciones que pueden ayudar a los usuarios avanzados a modelar ms rpido.

NOMBRE DEL GRUPO

OPCIONES

DESCRIPCIN Abra el asistente de las entidades para crear una nueva entidad directamente en el diagrama. Cuando una entidad es creada, sta es automticamente incluida dentro del diagrama. Abra el asistente de relaciones para crear

Entidad Nueva

Relacin

Copyright 2013 - Bizagi

347

NOMBRE DEL GRUPO

OPCIONES

DESCRIPCIN una nueva relacin entre dos entidades.

Agregar

Entidad

Muestra y permite agregar las entidades creadas anteriormente en el diagrama. Habilita al usuario para modificar el tamao de los elementos mostrados en la pantalla. Controla si la cuadrcula es mostrada al fondo del diagrama. La cuadrcula ayuda a alinear los objetos vertical y horizontalmente dentro del diagrama. Muestra la lista de las entidades por tipo para facilitar la ubicacin de estas dentro del espacio del diagrama (utilizando la funcionalidad de arrastrar y soltar).

Zoom

Opciones Zoom

Mostrar/Ocultar

Mostrar cuadrcula

Maestra/Paramtrica/Sistema

Adicionar entidades relacionadas Editar lista atributos Men de la lista desplegable (clic derecho sobre la entidad) Propiedades

Incluye de forma automtica todas las entidades (Maestras y Paramtricas) que no estn presentes en el diagrama pero que tienen una relacin con alguna ya incluida. de Lanza el asistente para incluir atributos dentro de las entidades. Lanza el asistente para informacin de la entidad. modificar la

Remover del diagrama.

Remueve la entidad del diagrama nicamente, es decir, LA ENTIDAD NO APARECE EN EL DIAGRAMA PERO SIGUE DENTRO DEL MODELO DE DATOS.

Nota Usted no puede borrar una entidad desde el Asistente del Modelo de Datos. Esta accin debe realizarse desde la vista de Mdulos.

3.3.2

Tipos de entidades
Bizagi ofrece cuatro tipos de entidades que ayudan a cada proceso a lograr un acceso fcil al modelo de datos organizado.

Entidades Maestras
Las entidades maestras son entidades de negocio que almacenan informacin que se relaciona de forma directa y exclusiva con cada proceso.

348

Copyright 2013 - Bizagi

La informacin almacenada durante el flujo del proceso. Es decir, la informacin se almacena a medida que los usuarios finales la ingresan en el Portal de Trabajo. La Entidad de Proceso en la entidad Maestra principal y conecta las entidades maestras relacionadas en el modelo de datos. Usted puede incluir tantas entidades Maestras como requiera su proyecto. En cada entidad usted puede incluir mximo 85 atributos (aunque no se comn ni recomendado tener ms de 30). Cuando se excede este nmero, se puede comprometer el desempeo de su proyecto.

Entidades Paramtricas
Estas entidades almacenan valores predefinidos o valores paramtricos, los cuales son independientes de la ejecucin del proceso. Durante el caso sus valores no pueden ser modificados o reescritos. Por ejemplo la entidad Gn ero contiene los valores Masculino y Femenino. Es posible relacionar la informacin de las entidades paramtricas con el caso definiendo una relacin entre la entidad maestra y la entidad paramtrica. Por ejemplo, la entidad Cliente tiene una relacin con la entidad Gnero. De esta manera la entidad Cliente almacenar el valor de la entidad gnero seleccionado en cada caso. Usted puede incluir tantas entidades paramtricas como requiera su proyecto. En cada entidad usted puede incluir mximo 85 atributos. Si se excede el nmero propuesto se puede comprometer el desempeo de su proyecto.

Entidades del Sistema

Estas entidades pertenecen al modelo de datos interno de Bizagi. Este grupo de entidades incluyen informacin referente al usuario final, reas, ubicaciones, roles, habilidades entre otras cosas. Las entidades del sistema son creadas por defecto en cada proyecto. Usted no puede crear entidades del sistema adicionales o adicionar o modificar atributos de ellas. Sin embargo, usted puede crear relaciones desde otras entidades para incluir informacin de las entidades del sistema dentro del modelo de datos.

Copyright 2013 - Bizagi

349

Entidades de Aplicacin
Entidades de aplicacin centralizan la informacin de cada aplicacin. Estas entidades manejan el modelo de datos de todo el proyecto. Las entidades de aplicacin son creadas de forma automtica para permitir la organizacin estructural del proceso cuando se crea la aplicacin, y llevan el nombre de la aplicacin. Los usuarios no pueden acceder o borrar estas entidades.

3.3.3

Tipos de atributos
Bizagi ofrece un conjunto de tipos de atributos para que pueda crear e incluir dentro del modelo de datos todo lo que necesite. Estn separados en cuatro categoras para ayudar a encontrar rpidamente el que usted necesita: Tipos bsicos: los tipos ms comnmente usados. Estos atributos estn listando al inicio de las listas para su fcil acceso. Ms tipos: Otros tipos avanzados.

350

Copyright 2013 - Bizagi

Entidad: Da acceso a todas las entidades de Aplicacin, Maestras, Paramtricas y del Sistema del modelo. Accediendo a las entidades a travs de esta categora se crea un A trib u to Relacio n ad o con la entidad seleccionada. Usted puede crear cualquier tipo de entidad a travs de esta opcin; la relacin se crear de forma automtica. Coleccin: Accediendo a las entidades a travs de esta opcin se crea la relacin Uno a muchos con el hijo (entidad seleccionada). Usted puede crear colecciones con entidades Maestras o de Aplicacin del modelo de datos. Si necesita crear una nueva entidad, la relacin ser creada automticamente.

TIPO DE ATRIBUTO Booleano Moneda Fecha-Hora Entero Texto

DESCRIPCIN Almacena nicamente dos valores booleanos Verdadero y Falso. Almacena un valor entero en el formato de la moneda definida en la configuracin del negocio. Almacena un atributo que puede ser una fecha o una fecha con hora. Almacena un entero del siguiente rango: -2,147,483,648 a 2,147,483,647. Almacena una cadena de texto. La longitud puede ser definida en las propiedades adicionales de las opciones avanzadas del asistente. Por favor observe la imagen en la parte inferior.

Copyright 2013 - Bizagi

351

Entero largo Texto extendido

Almacena un entero del siguiente rango: -9,223,372,036,854,775,808 a 9,223,372,036,854,775,807 Almacena una cadena de texto en formato texto enriquecido. Almacena y adjunta archivos dentro del caso. Configuraciones adicionales (como el lmite de tamao de adjuntos) se realiza en la Configuracin de Entorno, en la pestaa Avanzado, bajo las Opciones de Upload. Tambin permite guardar Plantillas de Documento. Para este atributo, se posibilita la integracin ECM. Almacena los nmeros decimales en formato binario de 8 bytes con 15 dgitos significativos de precisin. Almacena imgenes. Almacena una coleccin de imgenes para crear un lbum. Almacena los nmeros decimales en formato binario de 4 bytes con 7 dgitos significativos de precisin. Almacena un entero del siguiente rango: -32,768 a 32,767. Almacena un entero del siguiente rango: 0 a 255

Archivo

Flotante Imagen Galera de imgenes Real Entero corto Entero muy corto

Todos los tipos de atributos tienen propiedades adicionales (adicionalmente al nombre visual, nombre y tipo) que pueden ser ingresados por el usuario o pueden ser dejados en blanco. Al final de la ventana Lista d e A trib u to s, clic en la opcin Avanzado/Ocultar. Esto mostrar una ventana pequea par incluir la siguiente informacin: PROPIEDAD Descripcin DESCRIPCIN Descripcin del atributo para propsitos de documentacin. El mensaje incluido dentro del campo ser mostrado automticamente en el Portal de Trabajo al usuario final en el asistente de ayuda cuando el usuario de clic sobre el campo. Valor inicial asignado al atributo. El valor por defecto ser mostrado si no se especifica un valor para el atributo. Especifica la longitud mnima y mxima de caracteres que es permitida en el campo. La longitud debe ser un nmero entre 1 y 4000 caracteres. Para los atributos tipo Archivo. De la carpeta configurada en el repositorio ECM seleccione el

Texto de Ayuda

Valor por defecto

Longitud

Carpeta ECM

352

Copyright 2013 - Bizagi

que va a ser utilizado para guardar los archivos adjuntados al atributo. Tipo ECM Para los atributos tipo Archivo. Seleccione el tipo de contenido para el atributo de los tipos existentes en el repositorio ECM de la carpeta ECM.

3.3.3.1

Informacin del atributo tipo archivo

Atributos de tipo archivo

Bizagi permite cargar fcilmente archivos al proceso, por ejemplo archivos de procesadores de texto, hojas de clculo, archivos de video y de audio asocindolos directamente al caso especfico de negocio. Los usuarios pueden acceder y editar los archivos durante la ejecucin del proceso y realizar seguimiento de ellos en cualquier momento. Ya que los archivos son parte del caso, ellos deben pertenecer al modelo de datos como atributos tipo Archivo. Es importante recordar que en un solo atributo es posible cargar varios archivos, y pueden contener informacin adicional relacionada con ellos, por ejemplo, Fecha de recepcin, Fecha de Revisin, si se

Copyright 2013 - Bizagi

353

ha aprobado o no, si se requiere, etc. Por defecto, el tamao mximo de cada uno de los archivos cargados es de 1 MB. Pero realmente depende de la capacidad del servidor (memoria y espacio en el disco duro) de la red en la que se carga el archivo y las necesidades del negocio. Se recomienda un tamao de mximo 10 MB, pero esto puede variar dependiendo de las necesidades y la configuracin necesaria. La configuracin de los archivos aplica para toda la aplicacin y se realiza en la Configuracin de Entorno, en la pestaa Avanzado bajo las Opciones de Upload.

Dnde se guardan los archivos cargados?

Cuando se adjunta un documento al caso, sta es guardada en una de las carpetas creadas en Bizagi para organizar los documentos. Estas carpetas son creadas por defecto en el directorio docs, el cual es encontrado en la carpeta del servidor de la aplicacin web, cuya ruta de acceso por defecto sera: C:\Bizagi\Xpress\Projects\ApplicationName\WebApplication\Docs

N o m b re d e la ap licaci n : Nombre de la aplicacin web del proyecto.

Para cambiar la ruta por defecto, seleccione la pestaa de Co n fig u raci n en Bizagi Studio y abra la opcin En to rn o . 1. Seleccione la opcin Avanzado del lado izquierdo de la ventana mostrada.

354

Copyright 2013 - Bizagi

2. En la o p ci n Up lo ad s incluya la ruta fsica del directorio donde desea guardar los documentos.

Modificar los programas predeterminados para los atributos de tipo archivo

En cada proyecto los usuarios pueden cambiar el tipo de archivos asociados a los programas por defecto. Bizagi incluye una lista de los tipos de archivos ms populares. Para cambiar o adicionar siga los siguientes pasos:

1. En Bizagi Studio, seleccione la pestaa Co n fig u raci n y abra el men de N eg o cio s. Seleccione la opcin A v an zad o .

Copyright 2013 - Bizagi

355

2. Al final de la ventana encontrar el tipo de contenido y las extensiones disponibles para cargar archivos por defecto. Para configurar alguno, de clic en la extensin del archivo o en el tipo decontenido e ingrese el nuevo valor. Para borrar alguno, seleccione el tipo de contenido y de clic en la X que encontrar al lado derecho. Para incluir nuevos registros, clic en el botn MS (+) del lado izquierdo. En la nueva lnea, incluya la nueva extensin y el programa. Nota: Antes del primer Deployment se debe realizar la configuracin de TODOS los ambientes, es decir la configuracin se debe realizar en desarrollo en Bizagi Studio. El primer deployment tomar la configuracin de cada uno de los ambientes. A partir de entonces los cambios en Configuracin del entorno son locales en el entorno de produccin de la consola de administracin. Si usted desea que los cambios sean permanentes y sean parte del diseo del proceso, debe realizarlos tambin en el ambiente de desarrollo.

Artculos Relacionados:
356 Copyright 2013 - Bizagi

Manejo de Archivos con Expresiones

3.3.4

Tipos de relaciones
Bizagi ofrece cuatro tipos de relaciones entre entidades, lo cual provee gran flexibilidad en el modelo de datos.

Atributo Relacionado
sta es la relacin ms comn en donde una instancia de una entidad es asociada con una instancia de otra entidad. Lo que distingue esta relacin de otras es el orden en el cual es creada; principalmente por que se crea un atributo en una entidad que hace referencia a otra, pero NO en ambos sentidos. Se utilizan comnmente para relaciones de entidades maestras y paramtricas (listas desplegables o combos) o entre dos entidades maestras. Esta relacin se crea automticamente a travs del asistente del Modelo de Datos cuando se escoge Entidad como tipo de atributo. Por ejemplo, un Cliente tiene definido un gnero, por lo que existe un atributo de relacin entre las entidades Cliente y Gnero. Sin embargo el gnero ser asignado a muchos clientes. La relacin crea un atributo en la entidad Cliente el cual hace referencia al gnero (no de ambas formas). No se puede hacer referencia a un cliente particular de un gnero.

Relacin Uno a Uno

Las relaciones uno a uno son establecidas cuando existe una correspondencia nica entre dos entidades. Es decir, cada registro de la entidad A est asociado a un solo registro de la entidad B y viceversa. Por ejemplo, imagine dos entidades, Empleado y Computador. Existe una relacin uno a uno entre estas dos entidades por que cada empleado solamente puede tener un computador asociado y un computador solamente puede estar asignado a un empleado.

Para crear una relacin uno a uno abra el segundo paso del Asistente de Proceso: Modelar Datos. Las

Copyright 2013 - Bizagi

357

entidades a ser relacionadas deben ser incluidas en el diagrama. 1. Clic en el botn Relaci n en la pestaa inicio y seleccione las dos entidades ha relacionar.

2. Seleccione el tipo de relacin y clic en F in alizar.

358

Copyright 2013 - Bizagi

Coleccin o relaciones uno a muchos

Las relaciones uno a mucho son establecidas cuando una instancia de una entidad (entidad A) necesita ser asociada con cero, una o muchas instancias de otra entidad (entidad B). Sin embargo por una instancia de la entidad de la entidad B solo existir una instancia de la entidad A. En Bizagi est relacin se llama Coleccin. Por ejemplo, imagine dos entidades: Cliente y Productos solicitados. El cliente (entidad A) puede solicitar muchos productos (entidad B) pero esos productos solicitados solamente pertenecern a un cliente. Este tipo de relacin se crea automticamente a travs del asistente del Modelo de Datos, cuando selecciona el atributo de tipo coleccin. En Bizagi las colecciones se representan con un asterisco (*).

Relaciones muchos a muchos

Las relaciones muchos a muchos son establecidas cuando una instancia de una entidad (entidad A) es asociada con cero, uno o muchas instancias de otra entidad (entidad N), y una instancia de la entidad B es asociada con cero, uno o muchas instancias de la entidad A.

Copyright 2013 - Bizagi

359

Por ejemplo, en el proceso de Solicitud de Crdito personal, una solicitud tiene muchos productos (crditos personales, tarjetas de crdito) y varias garantas para cubrir los productos (codeudor, hipotecas). Cada producto puede tener varias garantas, por lo que se crea una relacin muchos a muchos entre garantas y productos: Un producto puede ser cubierto por varas garantas en la solicitud y una garanta puede cubrir varios productos en la misma solicitud.

Para crear una relacin uno a uno abra el segundo paso del Asistente de Proceso: Modelar Datos. Las entidades a ser relacionadas deben ser incluidas en el diagrama. 1. Clic en el botn Relaci n en la pestaa inicio y seleccione las dos entidades ha relacionar.

360

Copyright 2013 - Bizagi

2. Seleccione el tipo de relacin. Luego ingrese el nombre de los dos lados de la relacin (relacin bidireccional). Para el ejemplo, la relacin entre los productos solicitados y las garantas ser Productos de la Garanta. La relacin entre las garantas y los productos cubiertos ser Garanta de Productos. Luego de clic en F in alizar.

Copyright 2013 - Bizagi

361

3.3.5

Conexiones con fuentes de datos externas

A travs de modelado de datos en Bizagi, definimos y creamos entidades, atributos y relaciones directamente en el modelo de datos del proceso (de forma local en la base de datos de Bizagi). Adicionalmente, Bizagi ofrece 2 poderosos mecanismos de integracin para directamente relacionar fuentes de datos existentes con el modelo de datos de Bizagi. Estos dos mecanismos son conocidos en Bizagi como Replicacin y Virtualizacin (las diferencias entre ellos estn dadas por el tipo de Entidades involucradas). Estos mecanismos ofrecen caractersticas de integracin a nivel de datos que promueven muchos beneficios importantes, como por ejemplo la posibilidad de reutilizar un modelo de datos externo y relacionar fcilmente su informacin.

Estas caractersticas son especialmente tiles en escenarios donde queremos integrar en Bizagi los repositorios existentes de nuestros sistemas corporativos (por ejemplo, utilizando la informacin que ya est en un CRM, ERP, en un sistema legacy, etc.) Para ms informacin sobre Conexin con fuentes de datos externas visite: Replicacin, para slo obtener informacin de una fuente de datos externa a Bizagi (lectura). Virtualizacin, para una comunicacin en los dos sentidos: tanto obtener como actualizar informacin con una fuente de datos externa (lectura y escritura).

362

Copyright 2013 - Bizagi

3.3.5.1

Replicacin

Informacin general
La replicacin de Entidades en Bizagi es un mtodo de integracin a nivel de datos que permite conectar el modelo de datos del proceso con un fuente de datos externa. Asegrese de haber ledo la introduccin en Conexiones con fuentes de datos externas. Con la replicacin, Bizagi sincroniza sus entidades con informacin que reside en otras fuentes de datos externas de forma peridica (una tarea de schedule) actualizando la informacin almacenada desde un sistema externo. La actualizacin de la informacin es almacenada en tablas predefinidas con un conjunto de valores (entidades paramtricas). Esta lista o registros se seleccionan frecuentemente desde listas de valores desplegables (o combos). Algunos ejemplos de informacin manejada a travs de Replicacin: Lista de ciudades y pases, tipos de productos, cdigos de monedas, entre otras cosas (registros de tablas que no son transaccionales) . Para integracin de tablas transaccionales (Entidades Maestras), visite Virtualizacin.

Cmo funciona?
Utilizando Replicacin en Bizagi usted puede lograr: 1. Configurar un sistema externo y su proveedor de datos (conexin con fuentes de datos externa). Bizagi ofrece un asistente grfico para minimizar la cantidad de configuraciones necesarias. 2. Definir un esquema de Replicacin. Bizagi crear y programara un trabajo (job) para actualizar, insertar o deshabilitar informacin en Bizagi, desde una fuente de datos externa. El trabajo puede ser ejecutado todos los das, una vez a la semana o una vez al mes. Como principal ventaja, la fuente de datos externa se mantiene como el nico punto para la administracin de la informacin (dueo de la informacin).

Copyright 2013 - Bizagi

363

Una vez el trabajo ejecuta la sincronizacin, la informacin ser presentada a los usuarios finales que trabajan en el proceso como parte de la informacin del negocio.

Caractersticas importantes
Replicacin aplica para aquellos tipos de entidades de la fuente de datos externa que son vistas en Bizagi como entidades paramtricas (entidades que tienen un conjunto predefinido de valores para seleccionar). Clic para ms informacin sobre Entidades Paramtricas. Si usted desea utilizar este mecanismo de integracin para tablas de tipo transaccional (entidades maestras) visite Virtualizacin. La configuracin de la replicacin se realiza fcilmente con ayuda del asisten grfico. El asistente de Replicacin le ayudar ha establecer el proveedor de datos de conexin, ya sea base de datos de Oracle o SQL Server (se realiza en pocos pasos sin necesidad de programacin). Las versiones de bases de datos soportadas por el asistente de Replicacin (para conexiones nativas de Oracle y SQL) son:

Motor de Base de

Versin

364

Copyright 2013 - Bizagi

Datos Microsoft SQL Server 2012 (aplica para las ediciones Bizagi Enterprise .NET y Bizagi Xpress) 2008 R2 2008 2005 Oracle 9i 10g R1 10g R2 11g R1 11g R2
Versiones soportadas por el asistente de Replicacin (conexiones nativas).

Cuando un proyecto requiere Replicacin contra una fuente de datos diferente a Oracle o SQL Server (por ejemplo, MySQL, archivos XML, Microsoft Acess, etc), se necesita incluir implementacin personalizada y configurar la Replicacin a travs del Estndar de Configuracin (avanzado). Esto significa que cualquier motor de base de datos no nombrado en la tabla anterior es soportado para realizar Replicacin en Bizagi, pero requerir desarrollar algunos componentes adicionales. Para ms informacin visite Replicacin Personalizada. Notas: La caracterstica y la posibilidad de realizar implementaciones personalizadas para replicacin contra bases de datos diferentes a Oracle y SQL Server solamente es soportada en la edicin Bizagi Enterprise .NET. Cuando se replica un entidad contra un base de datos de Oracle y se desea utilizar el Asistente, es necesario tener instalado Oracle Data Provider para .NET. Para ms informacin sobre este requisito, visite Instalacin de Oracle Data Provider para .NET.

Valores eliminados en la fuente de datos nunca se eliminan en Bizagi. Cuando se realiza la sincronizacin de los valores de las entidades replicadas, Bizagi deshabilitar aquellos registros que fueron borrados de la fuente (sern marcados, los datos no se borraran fsicamente). Esto se realiza para conservar la integridad de los datos existentes en Bizagi.

Copyright 2013 - Bizagi

365

Principales Beneficios
La replicacin en una solucin BPM promueve: Reusabilidad ya que permite a los procesos ser integrados con fuentes de datos existentes (aplicaciones) y sistemas heredados (legacy systems). Esto es un requerimiento frecuente cuando se utilizan sistemas heredados que no tienen Arquitectura Orientada al Servicio diseada para integracin a un nivel alto (integracin a nivel de datos es estrictamente requerido). Evitar tener informacin aislada y mantiene el dueo del sistema de informacin. Para la implementacin actual de un proyecto, la Replicacin de Bizagi tiene los siguientes beneficios: La distribucin de trabajo a travs de los miembros del proyecto se deja en claro. El trabajo es separado de acuerdo a los diferentes roles: el analista del negocio disea y modela los procesos y las reglas de negocio, mientras que el personal de IT configura e implementa el modelo de datos e integra la solucin. Ofrece al analista del negocio un modelo de datos claro para el manejo e intercambio de informacin Los analistas del negocio pueden disponer de los datos que utiliza el proceso como si estuvieran almacenados en un repositorio de Bizagi (es decir, como datos locales). De esa manera, ellos no tienen que entender la complejidad asociada con la ubicacin real de los datos. Los flujos de proceso no necesitan incluir ninguna actividad tcnica para realizar la integracin (por ejemplo acceder a datos de otra fuente). Los procesos de la organizacin continan siendo legibles o entendibles para todos los involucrados del negocio. Las reglas de negocio no tienen que tratar con el acceso a datos o configuracin de mapeo de datos avanzadas. Se tiene un nico componente para la gestin del acceso de datos de las actividades E mantenimiento de la solucin se realiza fcilmente, debido a que el nmero de interfaces con sistemas externos se reduce considerablemente.

Configuracin de la Replicacin
Como se menciono anteriormente, usted puede configurar la Replicacin de dos formas. En la mayora de los escenarios el asistente grfico ser suficiente. Para ms informacin sobre el primer mtodo, visite Utilizando el Asistente de replicacin. Sin embargo, para escenarios ms complejos usted podr utilizar la opcin de configuracin Estndar. Estos escenarios se refieren principalmente a: El uso de fuente de datos que no es SQL Server u Oracle (mediante replicacin personalizada). Los requerimientos para configuracin avanzada (por ejemplo, querer utilizar una columna de

366

Copyright 2013 - Bizagi

Oracle que no es soportada). Necesidad de ajustes manuales en la configuracin. Esto puede pasar en escenarios sofisticados donde tiene todo un conjunto de tablas que estn relacionadas entre ellas. Esto puede involucrar relaciones entre entidades virtuales, por lo que la configuracin requiere que todas las tablas sean replicas y virtualizadas teniendo en cuenta algunas consideraciones. Para ms informacin sobre el segundo mtodo, visite Utilizando configuracin avanzada para Replicacin (opcin estndar).
3.3.5.1.1 Utilizar el asistente de Replicacin

Informacin general
Bizagi presenta el asistente de Replicacin el cual le ayudar en la configuracin para conectar un sistema externo como una base de datos SQL Server u Oracle (y crear automticamente los componentes necesarios). Clic para ms informacin sobre Replicacin. La siguiente informacin le ilustrar cmo configurar la Replicacin en Bizagi utilizando el asistente. Si usted requiere conectarse con una fuente de datos externa diferente a una base de dato SQL Server y Oracle, visite Utilizando configuracin avanzada para la Replicacin (opcin estndar).

Utilizando el Asistente
Para lanzar el asistente de la Replicacin, vaya al segundo paso del Asistente de procesos de Bizagi Studio ( M o d elar Dato s).

Copyright 2013 - Bizagi

367

Mientras se disea el modelo de datos del proceso, usted encontrar una opcin para incluir en el diagrama entidades replicadas. Estas entidades sern creadas como entidades de tipo paramtricas.

Antes de utilizar el Asisten para la Replicacin, se recomienda revisar el tipo de datos soportados para las conexiones entre Bizagi y bases de datos SQL Server u Oracle.

Qu se necesita hacer?
Para configurar la Replicacin es necesario realizar: 1. Definir la informacin del sistema donde se encuentra la fuente de datos externa. Esto se realiza para registrar la integracin como sistema utilizado en el proyecto de Bizagi. 2. Ingrese la informacin para el Proveedor de datos. Detalles que requiere la conexin a la fuente de datos externa. 3. Seleccione cuales tablas o vistas ha replicar. 4. Defina filtros adicionales para las tablas o vistas ha replicar. 5. Defina un esquema de Replicacin. Una vez se ha configurado es esquema, podemos correr una importacin inicial para las tablas o vistas seleccionadas, de esta forma, podemos verificar que la configuracin realizada fue exitosa (punto de chequeo).

Ejemplo
Para este ejemplo, replicaremos las tablas "Territories" (Territorios) y "Region" de la base de datos "Northwind" en SQL Server. Estas tablas sern creadas automticamente por Bizagi como entidades de parametrizacin.

368

Copyright 2013 - Bizagi

Para ilustrar esta configuracin, vamos a ejecutar el Asistente de Replicacin de Entidades desde el paso dos del Asistente del Proceso. 1. Defina la informacin del sistema donde se encuentra la fuente de datos externa. En la ventana Sistem a, seleccione N u ev o de la lista desplegable. Ingrese un nombre para el sistema externo (Nombre del sistema), este nombre representar el sistema externo dentro del proyecto Bizagi. En futuras replicaciones, tendr la opcin de escoger un sistema existente (configurado anteriormente) desde la lista desplegable de sistemas. Ingrese le N o m b re Visu al y la Descrip ci n , luego de clic en Sig u ien te.

2. Ingrese los detalles del proveedor de datos. En futuras replicaciones, tendr la opcin de escoger un sistema existente (configurado anteriormente) desde la lista desplegable de sistemas. Incluya el nombre del Proveedor, el cual debe ser un nombre nico el cual ser asignado para el Proveedor de Datos (til especialmente cuando se registra ms de una fuente de datos externa en el proyecto). Seleccione si la fuente de datos externa es SQ L Serv er u O racle.

Copyright 2013 - Bizagi

369

Luego, si la fuente de datos externa es SQL Server ingrese la siguiente informacin: Servidor: Nombre del servidor de base de datos que contiene la instancia SQL Server. Nombre base de datos: Nombre de la base de datos donde las tablas o vistas sern replicadas. Usuario: Nombre del usuario para iniciar sesin en la base de datos. Es importante mencionar que la cuenta debe tener permisos de lectura para acceder a las tablas o vistas de la replicacin. Contrasea: contrasea para el usuario de la base de datos. Por otro lado, si la fuente de datos externa es Oracle ingrese la siguiente informacin: Servicio: El texto de conexin con la instancia del servicio Oracle. Debe ser definido como nombre_del_servidor:puerto/nombre_de_la_instancia. Note que por defecto el puesto para las instancias de Oracle es 1521. Esquema: El nombre del esquema del usuario. Contrasea: Contrasea para el esquema. Clic en Sig u ien te.

370

Copyright 2013 - Bizagi

3. Seleccione las tablas o vistas que van a ser replicadas Una vez ha definido los detalles de la conexin con la fuente de datos externa, Bizagi buscar y mostrar las tablas y vistas disponibles en la fuente. Extienda el nodo TA B LA S para mostrar la lista de tablas en la fuente de datos externa, seleccione la o las tablas que va a replicar. En nuestro ejemplo, vamos a marcar Reg i n y Territo rio s. Clic en Sig u ien te. Nota Cuando seleccione ms de una tabla o vista, Bizagi automticamente crear la relacin (atributo de referencia), si las tablas tienen una relacin explicita definida en la fuente.

Copyright 2013 - Bizagi

371

4. Defina filtros para las tablas y vistas ha replicar (opcional).

Una vez haya seleccionado las tablas o vistas ha replicar, usted puede definir filtros, de forma que Bizagi descarte algunos registros. Por ejemplo, usted puede definir que no quiere traer los registros de la tabla Regin que tienen el campo descripcin en N ULL (filtro en Regin: RegionDescription is not NULL ). Si va a utilizar los filtros, le recomendamos probar el filtro con el botn Test Source Filter. Clic en Sig u ien te.

Nota Tenga en cuenta que esta opcin debe ser usada con precaucin cuando se tiene un nmero muy grande de registros en la fuente, ya que la consulta y la recuperacin de estos valores puede tomar cierto tiempo.

372

Copyright 2013 - Bizagi

Clic en Sig u ien te. 5. Definir el esquema de Replicacin En la nueva ventaba, defina el esquema de la programacin del trabajo que ser ejecutado en la replicacin (sincronizacin de informacin). Seleccione N u ev o desde la lista desplegable de P ro g ram aci n (Schedule), ingrese el N o m b re, N o m b re Visu al y una Descrip ci n . En futuras replicaciones, tendr la opcin de escoger una programacin existente (configurado anteriormente) desde la lista desplegable de programaciones.

Copyright 2013 - Bizagi

373

Clic en la pestaa de P ro p ied ad es d e P ro g ram aci n

374

Copyright 2013 - Bizagi

Especifique el periodo y la frecuencia en que la informacin ser replicada (sincronizacin desde la fuente de datos con Bizagi), dependiendo de las opciones presentadas a continuacin:

Opciones de programacin Habilitar la programacin para la Replicacin. Periodicidad

Descripcin Marque esta opcin para que Bizagi ejecute la replicacin de datos desde la fuente externa. Marque Diario, Semanal, o Mensual para definir con que frecuencia Bizagi ejecutar el esquema de Replicacin.

Copyright 2013 - Bizagi

375

Cada [...] da(s)

Esta opcin cambiar de acuerdo con la seleccin realizada en la opcin anterior. Cuando se marca Diario: Ingrese el nmero de das entre la repeticin de la ejecucin. Cuando se marca semanal: Ingrese el nmero de semanas entre la repeticin de la ejecucin. Tambin seleccione en que fines de semana el esquema ser ejecutado. Cuando se marca Mensual: Ingrese el nmero de meses entre la repeticin de la ejecucin. Adicionalmente, seleccione el da del mes en el cual ser ejecutado el esquema.

Frecuencia diaria

Defina si la ejecucin pasa una vez al da (a que hora), o si se debe ejecutar cada cierto tiempo (minutos u horas). Seleccione una fecha de inicio para el esquema para comenzar la ejecucin.

Comienzo

Descripcin de las propiedades del esquema

Marque la opcin Rep licar A h o ra para ejecutar inmediatamente la Replicacin (sincronizacin de la informacin). Si la opcin Rep licar A h o ra no se encuentra marcada, la Replicacin ser ejecutada en el momento definido en las Propiedades de Programacin y requiere que el Scheduler para el proyecto este activado y corriendo (se recomienda reiniciar el Scheduler). Para ms informacin sobre reiniciar el Scheduler, visite opciones de Bizagi Management Console. Clic en Sig u ien te. Finalmente, clic en F in alizar cuando complete de forma exitosa la configuracin.

376

Copyright 2013 - Bizagi

Verificar la Replicacin (Punto de chequeo)

Una vez la Replicacin ha sido configurada, usted puede verificar la ejecucin de la sincronizacin de las Entidades Paramtricas con las tablas externas. Existen dos maneras de realizar esto: Utilizando las opciones que se encuentran en el modul Sistem as (Vista mdulos) o travs de la informacin mostrada de las entidades ( M o d u l d e En tid ad es). Las opciones representadas en el mdulo de Sistem as son tiles para los ambientes de produccin o pruebas. Las opciones representadas en el mdulo de En tid ad es servirn para realizar la verificacin mientras se esta realizando la configuracin en el Ambiente de desarrollo. Para ms informacin sobre cmo verificar si la Replicacin se ejecuta correctamente, visite Verificar Replicacin.

Copyright 2013 - Bizagi

377

3.3.5.1.2 Utilizar la configuracin avanzada de Replicacin

Informacin general
Bizagi presenta el Asistente de Replicacin en cual le ayudar en la configuracin de la conexin de una base datos externa SQL Server u Oracle (y crear los componentes necesarios). Sin embargo, en escenarios ms sofisticados, usted desear utilizar la opcin de Configuracin Estndar (Avanzado), la cual es otra alternativa para realizar una Replicacin en su proyecto. Estos escenarios se refieren principalmente a: El uso de fuente de datos que no es SQL Server u Oracle (mediante replicacin personalizada). Los requerimientos para configuracin avanzada (por ejemplo, querer utilizar una columna de Oracle que no es soportada). Necesidad de ajustes manuales en la configuracin. Esto puede pasar en escenarios sofisticados donde tiene todo un conjunto de tablas que estn relacionadas entre ellas. Esto puede involucrar relaciones entre entidades virtuales, por lo que la configuracin requiere que todas las tablas sean replicas y virtualizadas teniendo en cuenta algunas consideraciones. El siguiente artculo ilustra cmo configurar un Replicacin en Bizagi utilizando las opciones Standard (Avanzadas) Si desea ms informacin y un ejemplo sobre replicacin a mySQL visite Replicacin Personalizada. Tenga en cuenta que solamente la versin de Bizagi Enterprise .NET soporta cualquier motor de base de datos.

Utilizando las opciones Estndar (Configuracin Avanzada)

Para configurar la Replicacin a travs de la configuracin Avanzada, asegrese que ya ha creado las entidades paramtricas que necesita y sus atributos (para almacenar los valores de las variables entrantes de la base de datos externa). Para ms informacin sobre crear entidades en Bizagi, visite Cmo crear un modelo de datos? Note que las entidades creadas en Bizagi deben tener una estructura similar a la estructura de aquellas en la fuente de datos externa (por ejemplo, los tipos de datos que almacenan los valores de las columnas en las tablas externas). Para utilizar las opciones Avanzadas para replicacin vaya a la vista de mdulos en Bizagi Studio y seleccione la opcin Sistem a.

378

Copyright 2013 - Bizagi

Qu necesita hacer?
Para realizar la configuracin de la Replicacin a travs de las opciones Estndar realice los siguientes pasos: 1. Crear las entidades en Bizagi con sus atributos pata igualar con la informacin de la fuente. La creacin de las entidades se realiza en el segundo paso del asistente Modelar Datos. 2. Definir el sistema Definir la informacin para el sistema donde se encuentra la fuente de datos externa. 3. Definir el Proveedor Especificar detalles por el Proveedor (conexin con la informacin de la fuente de datos externos). 4. Registrar la clase de replicacin (el componente que tiene la implementacin) Este paso es realizado automticamente por Bizagi en la edicin Xpress; sin embargo en la Edicin Enterprise de Bizagi necesitamos definir explcitamente si vamos a utilizar una implementacin personalizada.

Copyright 2013 - Bizagi

379

5. Definir el esquema de Replicacin Especificar la programacin del trabajo el cual ser ejecutado en la sincronizacin de la Replicacin. 6. Incluir Entidades paramtricas para la Replicacin Incluir las entidades paramtricas que van a ser replicadas para esta conexin una por una cada (Proveedor) y de un esquema de Replicacin. 7. Emparejando atributos en Bizagi con las columnas de la fuente. Mapee cada uno de los atributos de la entidad replicada con la columna correspondiente de la fuente. 8. Utilizando las opciones de configuracin adicional Finalmente, existe la posibilidad de utilizar opciones adicionales para la configuracin de cada entidad replicada, por ejemplo, definir filtros para los registros entrantes de la tabla externa, indicando si un atributo (columna) de la entidad debe ser ignorado. Una vez se haya realizado los pasos de la configuracin, tenemos que ejecutar una importacin inicial de las tablas o vistas, de esa forma podemos probar que la integracin se cre correctamente (punto de control).

Ejemplo
En este ejemplo, vamos a replicar las tablas Territorios, Regin y Transportistas desde la base de datos So u th w in d .

Nuestro primer paso es asegurase que las tablas han sido creadas previamente en Bizagi como entidades paramtricas. 1. Crear las entidades en Bizagi con sus atributos pata igualar con la informacin de la fuente. Vamos a crear las entidades paramtricas Regin, Ramas y Transportista en Bizagi. Atributos de la tabla Regin en Bizagi

380

Copyright 2013 - Bizagi

Atributos de la tabla Territorios (Entidad Ramas) en Bizagi:

Atributos de la tabla Transportista en Bizagi:

2. Definir el sistema Para definir el sistema a utilizar en la integracin, de clic derecho en Sistem a y seleccione la opcin N u ev o Sistem a.

Copyright 2013 - Bizagi

381

En la ventana de N u ev o Sistem a, debe definir la informacin del sistema donde se encuentra la fuente de datos externa. Ingrese los detalles para el nuevo sistema: N o m b re, N o m b re Visu al y Descrip ci n .

382

Copyright 2013 - Bizagi

Asegrese de que la opcin P erm itir En tid ad es Virtu ales y Rep licaci n este seleccionada. Clic en O K.

3. Definir proveedor Una vez haya definido y creado el nuevo sistema en Bizagi, vamos a ingresar los detalles del proveedor utilizando en la configuracin para este sistema y para la Replicacin. Para realizar esto, clic derecho en el nodo de P ro v eed o r ubicado en el sistema recin creado, y seleccione la opcin N u ev o P ro v eed o r.

En la pestaa de co n fig u raci n d el P ro v eed o r, ingrese los detalles del nuevo proveedor: Nombre, N o m b re Visu al y Descrip ci n . Asegrese de marcar la opcin P erm itir Rep licaci n p ara el p ro v eed o r.

Copyright 2013 - Bizagi

383

Luego, en la pestaa P ro p ied ad es d e d esarro llo d el P ro v eed o r de clic en el botn O LEDB Co n fig . Note que puede establer diferentes valores para los diferentes ambientes del proyecto (desarrollo, Test y produccin). En el siguiente ejemplo, vamos a establer las propiedades para el ambiente de desarrollo.

Luego, si la fuente de datos externa es SQL Server ingrese la siguiente informacin: Servidor: Nombre del servidor de base de datos que contiene la instancia SQL Server.

384

Copyright 2013 - Bizagi

Nombre base de datos: Nombre de la base de datos donde las tablas o vistas sern replicadas. Usuario: Nombre del usuario para iniciar sesin en la base de datos. Es importante mencionar que la cuenta debe tener permisos de lectura para acceder a las tablas o vistas de la replicacin. Contrasea: contrasea para el usuario de la base de datos.

Por otro lado, si la fuente de datos externa es Oracle ingrese la siguiente informacin: Servicio: El texto de conexin con la instancia del servicio Oracle. Debe ser definido como nombre_del_servidor: puerto/nombre_de_la_instancia. Note que por defecto el puesto para las instancias de Oracle es 1521. Esquema: El nombre del esquema del usuario. Contrasea: Contrasea para el esquema. Para este ejemplo, vamos a ilustrar la configuracin de la replicacin con una fuente de datos externa en Oracle. En la ventana de configuracin virtual de la base de datos, se ingresa el nombre del servicio de red, nombre de usuario y contrasea.

Copyright 2013 - Bizagi

385

Clic en Ok para guardar la coneccin. De nuevo, clic en OK para regresar a la ventana de nuevo proveedor.

Nota Tenga en cuenta que es necesario definir las propiedades y valores de coneccin para la integracin en los diferentes ambientes (desarrollo, Test y produccin). Sin embargo, la definicin de los ambientes de Test y de produccin solo se puede realizar antes de realizar deployment del sistema y del proveedor al ambiente determinado. La edicin de las valores en Test o en produccin debe realizarce luego del primer deployment utilizando el Management Console.

4. Registrar la clase de replicacin El siguiente paso es crear la clase de replicacin en Bizagi, la cual puede ser definida utilizando los componentes que Bizagi trae por defecto (Implementacin de clase), o usar un componente personalizado (por ejemplo, conectar con mySQL, Postgres, DB2, etc). Si se esta utilizando Bizagi Xpress, este paso lo realiza Bizagi de forma automtica y no necesita realizar lo que se menciona acontinuacin. Note que la posibilidad de incluir un componente personalizado est disponible para la edicin de Bizagi, por lo que es necesario definir si vamos a utilizar una implementacin personalizada. En el siguiente ejemplo, vamos a usar los componentes que Bizagi tiene por defecto. Para definir la Clase de Entidad de Replicacin de clic derecho sobre el nodo de Entidades Replicadas y seleccione la opcin Nueva clase de Replicacin. Deje los valores que trae por defecto y de clic en Ok.

386

Copyright 2013 - Bizagi

5. Definir un esquema de replicacin Una vez la clase de Replicacin es creada o registrada, vamos a especificar la repeticin de la replicacin de forma peridica con un trabajo programado. Para definir este esquema, ubique la clase de replicacin (la entidad por defecto se llama Entidad por Defecto de Replicacin, Defau lt Rep licatio n En tity) en la opcin en tid ad es rep licad as y de clic derecho en ella y seleccione la opcin Adicionar esquema de Replicacin.

Copyright 2013 - Bizagi

387

En la ventana de configuracin, digite un N o m b re, N o m b re v isu al y d escrip ci n para el esquema de replicacin.

En la pestaa de propiedades de programacin ( Sch ed u le P ro p erties), especifique la frecuencia en la cual la informacin ser replicada de la base de datos externa (sincronizacin con Bizagi). En el ejemplo, la replicacin ocurre los martes y viernes de cada semana a las 8:00 pm empezando el 22 de Agosto de 2012.

388

Copyright 2013 - Bizagi

Nota: Tenga en cuenta que la replicacin no se ejecuta de inmendiato. Ella comenzar en el da y la hora definida, y requiere que el servicio del programador para el ambiente se encuentre prendido y corriendo. Para ms informacin sobre el servicio del programador y su administracin desde el Management Console. Si usted desea correr la sincronizacin inmediatamente para las entidades replicadas, dirjase a la opcin Rep licar A h o ra descrita en la configuracin de opciones Adicionales. Por la configuracin presentada en esta pestaa, defina la periodicidad y frecuencia de ejecucin de acuerdo a la siguiente tabla:

Opciones del programador Habilitar programador para la replicacin

Descripcin Marque esta opcin en Bizagi para ejecutar los datos de la replicacin desde la fuente de datos externa. Marque, diario, semanal o mensual para definir con que frecuencia Bizagi ejecutar el esquema de Replicacin. Esta opcin cambiara de acuerdo a la opcin

Periodicidad

Cada [...] da(s)

Copyright 2013 - Bizagi

389

seleccionada en Periodicidad. Cuando se selecciona Diario: ingrese el nmero de das para realizar la repeticin. Cuando se selecciona semanal: ingrese el nmero de semanas para realizar la repeticin. Tambin seleccione en que da de la semana se debe ejecutar el esquema. Cuando se selecciona mensual: ingrese el nmero de meses para realizar la repeticin. Tambin seleccione en que da del mes se debe ejecutar el esquema. Frecuencia diaria Defina si la ejecucin ocurre una vez al da (y en que hora), o si se debe ejecutar cada cierto tiempo (horas, minutos). Configure la fecha inicial para que el esquema comience la ejecucin.
Descripcin de las propiedades del programador

Inicio

Clic O K. 6. Incluir entidades paramtricas para la replicacin. Luego de definir el esquema de replicacin, es necesario incluir las tablas paramtricas y marcarlas como tablas de fuente de datos externa. Para realizar esto, incluya una por una las tablas paramtricas que se van a replicar con el proveedor de datos. Por ejemplo, vamos a incluir la tabla de Territo rio s y la vamos a emparejar con la tabla Rama de la fuente de datos. Clic derecho en el nuevo nodo de esquema de Replicacin, seleccione la opcin A d icio n ar En tid ad d e Rep licaci n .

390

Copyright 2013 - Bizagi

En este paso, adems de definir la tabla desde la fuente, tambin puede definir cual de las columnas de la fuente debe ser tomada como llave de negocio para los valores de la entidad. Nota: La llave de negocio debe corresponder a la llave primaria de la tabla de la fuente. Realice esto para cada Entidad Paramtrica (Regin, Rama, Transportista de nuestro ejemplo). La tabla Territo rio s (incluida como Ram a) para la configuracin de replicacin y el esquema:

La tabla Reg i n (incluida como Reg io n ) para la configuracin de replicacin y el esquema:

Copyright 2013 - Bizagi

391

La tabla Tran sp o rtista (incluida como Tran sp o rtista) para la configuracin de replicacin y el esquema:

Esto siginifica que cuando el esquema de replicacin se ejecute, este sincronizar la informacin de las

392

Copyright 2013 - Bizagi

entidades Regin, Rama y Transportista.

7. Emparejando atributos en Bizagi con las columnas de la fuente Una vez se ha incluido el esquema de replicacin, este se encontrar en proveedores. Dando clic en una entidad especifica (en nuestro ejemplo, es necesario realizar esto por cada una de las tres entidades paramtricas), en el panel del lado derecho se presentarn los atributos actuales de las tablas. Enlace cada atributo de la entidad replicada con su correspondiente columna en la fuente dando clic derecho en el atributo y seleccionado la opcin P ro p ied ad es.

Para el cdigo de la entidad Rama, vamos a escribir su pareja de la fuente externa (columna TerritoryID).

Repita este paso para todos los atributos de cada entidad replicada. Al final, la configuracin de los atributos para Territorios (Rama en Bizagi) es:

Copyright 2013 - Bizagi

393

Los atributos configurados para Regin son:

Los atributos configurados para Tranportista son:

Note que todos los atributos nombrados necesitan tener una pareja en la fuente de datos externa. Si necesita que algn atributo no sea considerado en la Replicacin, consulte la siguiente seccin. En este punto, hemos completado la configuracin de la Replicacin a travs de las opciones estndar. Usted puede utilizar opciones de configuracin adicional cmo se muestra en la siguiente seccin y verificar que los valores de las entidades paramtricas se configuren de forma apropiada.

394

Copyright 2013 - Bizagi

8. Opciones adicionales de configuracin Finalmente, existe la posibilidad de utilizar opciones adicionales para configurar cada entidad replicada, por ejemplo: Definir filtros por registro en las tablas que se van a replicar, definir si un atributo (columna) de la entidad no se debe tener en cuenta, etc. Clic para ms informacin sobre configuracin avanzada

Verificar la Replicacin (Punto de chequeo)

Una vez la Replicacin ha sido configurada, usted puede verificar la ejecucin de la sincronizacin de las Entidades Paramtricas con las tablas externas. Existen dos maneras de realizar esto: Utilizando las opciones que se encuentran en el modul Sistem as (Vista mdulos) o travs de la informacin mostrada de las entidades ( M o d u l d e En tid ad es). Las opciones representadas en el mdulo de Sistem as son tiles para los ambientes de produccin o pruebas. Las opciones representadas en el mdulo de En tid ad es servirn para realizar la verificacin mientras se esta realizando la configuracin en el Ambiente de desarrollo. Para ms informacin sobre cmo verificar si la Replicacin se ejecuta correctamente, visite Verificar Replicacin.

3.3.5.1.2.1 Personalizando la Replicacin

Informacin general
Bizagi presenta el Asistente de Replicacin en cual le ayudar en la configuracin de la conexin de una base datos externa SQL Server u Oracle (para integracin a nivel de datos). Para otra fuente de datos diferente a SQL Server y Oracle, se puede sobrescribir los mtodos y clases utilizado por Bizagi en la Replicacin.

Qu se debe hacer?
Para poder utilizar la Replicacin de Bizagi con una fuente de datos externa diferente a SQL Server u Oracle se debe seguir los siguientes pasos: 1. Crear una librera de Replicacin A travs de una librera personalizada, usted podr sobrescribir las clases y mtodos de replicacin de Bizagi (como se describe en la siguiente seccin: So b rescrib ir d e m to d o s y clases).

Copyright 2013 - Bizagi

395

2. Configurar el proveedor de datos de Bizagi para utilizarlo en la librera personalizada de Replicacin. Esta configuracin utiliza la configuracin estndar de Bizagi para replicaciones.

Sobrescribir de Clases y Mtodos

Para personalizar la virtualizacin de Bizagi, es necesario desarrollar un componente que implemente las interfaces: IP ro v id erVirtu alDA 2 IRep licatio n En tDA . IP aram eter IDatab aseCo n stan ts

Bizagi separa la operacin de conectar, desconectar y administracin transaccional de la operacin de la bsqueda de datos desde el proveedor de datos externos y de las interfaces de la entidad. Es decir, cuando se crea una librera de Replicacin personalizada, Bizagi sigue las mejores prcticas para la gestin y diseo de la implementacin. Interfaz del proveedor: IProviderVirtualDA2 La clase que invoca la interfaz debe contener los siguientes mtodos: void Init (HybridDictionary htMetadata): A cargo de tomar la informacin suministrada, como el nombre del servidor, el nombre de la base de datos, usuario, contrasea, etc. La clase recibe el objeto HybridDictionary, el cual contiene los datos configurados como metadata del sistema. void OpenConnection(): Este mtodo es utilizado para realizar la conexin con el sistema externo. En el caso de una base de datos, el mtodo construye los enlaces de la conexin y abre la conexin con el repositorio. void CloseConnection(): A cargo de cerrar la conexin con el sistema de datos externos. void BeginTransaction(): A cargo de iniciar una nueva transaccin para la operacin actual del sistema. void Commit(): Realizar commit de la transaccin actual en el sistema de referencia. void Rollback(): Realizar un rollback (regresar al estado inicial) de la transaccin actual del sistema de referencia. Interfaz de la entidad: IReplicationEntDA La clase que invoca la interfaz debe contener los siguientes mtodos: void Init(IProviderVirtualDA objProvider, HybridDictionary htMetadata): Inicializar la conexin con el sistema. Los parmetros necesarios para establecer la conexin con el sistema son configurados como metadata del sistema. Parmetros obj Provider Descripcin Permite convertir el objeto que invoca la interfaz IProviderVirtualDA. Contiene la informacin requerida en forma de metada para

htMetadata

396

Copyright 2013 - Bizagi

establecer la conexin con el sistema configurado. DataSet GetEntity(string sEntSource, string[] arrsColList): Utilizado como consulta de los valores de la fuente de datos externa. Esto es equivalente a realizar una consulta en los campos del objeto sin tener que aplicar filtros. Parmetros sEntSource arrsColList Descripcin Nombre de la tabla a replicar en la fuente de datos Arreglo que contiene el nombre de las columnas de la consulta en la fuente de datos. Un DataSet con los valores de la entidad.

RETURNED DataSet

Interfaces de constantes: IParameter, IDatabaseConstants Bizagi construye las consultas. Para ello, debe necesariamente definir todas las constantes que se usan en la sintaxis del motor de la Base de datos. Por ejemplo: en private readonly string m_sConcatSymbol, debe definir el smbolo que se utilizar para la concatenacin en las sentencias SQL.

Ejemplo
En el ejemplo, vamos a configurar una replicacin personalizada para un motor de base de datos MySQL. Vamos a presentar un ejemplo de las clases de replicacin que implementan las interfaces "IProviderVirtualDA2" y "IReplicationEntDA". Nota Tenga en cuenta que el siguiente cdigo ilustra la implementacin del mtodo "GetEntity()" (para servir como una gua), sin embargo otros mtodos no son incluidos y podra necesitar otro un mayor desarrollo.

Crear una librera de replicacin

En este ejemplo especfico, para poder implementar las clases de replicacin que conecten la base de datos MySQL, primero se debe descargar e instalar el componente MySQL Connector/NET para realizar la conexin. Para el ejemplo, las siguientes clases fueron desarrolladas utilizando Microsoft Visual Studio. A travs de este proyecto .NET se hace referencia a la librera MySql.Data.dll, la cual debi ser instalado por el componente MySQL Connector/Net ya que es necesario.

Copyright 2013 - Bizagi

397

Tambin es necesario hacer referencia a la libreras: BizAgi.EntityManager.Interfaces.IEntityDA.dll BizAgi.Defs.dll Vision.DA.dll Vision.Defs.dll Estas se encuentran en la carpeta bin dentro de la carpeta de la aplicacin del proyecto (por defecto en "C:\Bizagi\Enterprise\Projects\[PROJECT_NAME]\WebApplication\bin\").

Clase de la Interfaz IProviderVirtualDA2 using System; using System.Data; using System.Collections.Specialized; using MySql.Data.MySqlClient; using BizAgi.EntityManager.Interfaces; using Vision.DA; using System.Collections.Generic; using System.Collections; using System.Data.SqlClient; using System.Text; namespace BizagiMySQL { public class CMySQLProvider : IProviderVirtualDA2 { protected protected protected //--- The procedure protected HybridDictionary m_htMetadata; MySqlConnection MySqlconn; bool bDisposed; array used to store the parameters to a stored List<CMySqlParameter> m_alParams;

public CMySQLProvider()

398

Copyright 2013 - Bizagi

{ bDisposed = false; MySqlconn = null; m_alParams = new List<CMySqlParameter>(); } #region IProviderVirtualDA2 Members void IProviderVirtualDA2.AddParameter(string sParameterName, Vision.Defs.EDataType eDataType, int iSize, byte iPrecision, byte iScale, object oValue, Vision.Defs.EParamDirection eDirection) { throw new NotImplementedException(); } void IProviderVirtualDA2.AddParameter(string sParameterName, Vision.Defs.EDataType eDataType, int iSize, object oValue, Vision.Defs.EParamDirection eDirection) { throw new NotImplementedException(); } void IProviderVirtualDA2.AddParameter(string sParameterName, Vision.Defs.EDataType eDataType, int iSize, bool bNullValue, object oValue) { throw new NotImplementedException(); } void IProviderVirtualDA2.AddParameter(string sParameterName, Vision.Defs.EDataType eDataType, int iSize, object oValue) { m_alParams.Add(new CMySqlParameter(sParameterName, eDataType, iSize, oValue)); } void IProviderVirtualDA2.AddParameter(string sParameterName, object oValue) { throw new NotImplementedException(); } void oParameter) { } void { } Vision.DA.IParameter IProviderVirtualDA2.CreateParameterObject IProviderVirtualDA2.ClearParameters() m_alParams.Clear(); IProviderVirtualDA2.AddParameter(Vision.DA.IParameter

throw new NotImplementedException();

Copyright 2013 - Bizagi

399

(string sParameterName, Vision.Defs.EDataType eDataType, int iSize, byte iPrecision, byte iScale, string sSourceColumn, bool bUseCurrentSourceColumnValue) { throw new NotImplementedException(); } Vision.DA.IParameter IProviderVirtualDA2.CreateParameterObject (string sParameterName, Vision.Defs.EDataType eDataType, int iSize, byte iPrecision, byte iScale, object oValue, Vision.Defs.EParamDirection eDirection) { throw new NotImplementedException(); } Vision.DA.IParameter IProviderVirtualDA2.CreateParameterObject (string sParameterName, Vision.Defs.EDataType eDataType, int iSize, object oValue) { throw new NotImplementedException(); } Vision.DA.IDatabaseConstants IProviderVirtualDA2.DatabaseProperties { get { return CMySqlDatabaseConstants.Instance; } } DataSet IProviderVirtualDA2.RunQuery(string sQuery, string sTableName) { MySqlCommand command = new MySqlCommand(); MySqlDataAdapter adapter = new MySqlDataAdapter(); DataSet ds = new DataSet(); command.Connection = this.getConnection(); command.CommandText = ReplaceQueryParameters(sQuery, m_alParams); command.CommandType = CommandType.Text; getParameters(command); adapter.SelectCommand = command; adapter.Fill(ds, sTableName); return ds; } private void getParameters(MySqlCommand oCmd) { //--- Get an enumerator for the parameter array list IEnumerator oEnumerator = m_alParams.GetEnumerator(); //--- Loop through the Parameters in the ArrayList while (oEnumerator.MoveNext())

400

Copyright 2013 - Bizagi

{ //--- Add the SQLParameter object to the SQLCommand object oCmd.Parameters.Add(ConvertParameterToMySqlParameter ((CMySqlParameter)oEnumerator.Current)); } } private MySqlParameter ConvertParameterToMySqlParameter (CMySqlParameter oP) { MySqlDbType dbType = (oP.DataType.Equals (MySqlDbType.VarChar)) ? MySqlDbType.VarChar : (MySqlDbType)oP.DataType; //--- Instantiate a SqlParameter object MySqlParameter oMySqlParameter = new MySqlParameter (oP.ParameterName, dbType, oP.Size); oMySqlParameter.Value = oP.Value; oMySqlParameter.Direction = (ParameterDirection)oP.Direction; oMySqlParameter.Precision = oP.Precision; oMySqlParameter.Scale = oP.Scale; oMySqlParameter.SourceColumn = oP.SourceColumn; oMySqlParameter.SourceVersion = oP.UseCurrentSourceColumnValue ? DataRowVersion.Current : DataRowVersion.Original; return oMySqlParameter; }

/// <summary> /// Replace parameter in the form '?', by parametes in the form ': ParamName' /// </summary> /// <param name="sQuery"></param> /// <returns></returns> private static string ReplaceQueryParameters(string sQuery, List<CMySqlParameter> alParams) { if (alParams != null && alParams.Count > 0) { char cInter = '?', cQuote = '\'', cAt = '@', cColon = ':'; string sParamToken = ":"; bool bInQuote = false; // indicates if current character is in '' StringBuilder sbResp = new StringBuilder(); int _i = 0, _n = sQuery.Length, nNumParam = 0, nLastStrIndex = 0; while (_i < _n) {

Copyright 2013 - Bizagi

401

if (bInQuote) { if (sQuery[_i] == cQuote) { if ((_i + 1) < _n && sQuery[_i + 1] == cQuote) { // "...''..." case, already in quote _i += 2; } else { // "...'" case bInQuote = false; _i++; } } else { _i++; } } else { if (sQuery[_i] == cInter) { // "...?..." case if (nNumParam >= alParams.Count) { // parameter doesn't exists throw new ProviderException(string.Format ("Parameter {0} doesn't exists in command: '{1}'", nNumParam, sQuery)); } else { // get valid param name string sValidParamName = getValidParamName (((CMySqlParameter)alParams[nNumParam]).ParameterName, alParams, nNumParam - 1); ((CMySqlParameter)alParams[nNumParam]) .ParameterName = sValidParamName; // replace parameter by name sbResp.Append(sQuery.Substring (nLastStrIndex, _i - nLastStrIndex)); sbResp.Append(sParamToken + sValidParamName); nLastStrIndex = _i + 1; nNumParam++; } } else if (sQuery[_i] == cAt) {

402

Copyright 2013 - Bizagi

// replace parameter by name sbResp.Append(sQuery.Substring(nLastStrIndex, _i - nLastStrIndex)); sbResp.Append(cInter); nLastStrIndex = _i + 1; nNumParam++; } else if (sQuery[_i] == cQuote) { // "'..." case bInQuote = true; } _i++; } } sbResp.Append(sQuery.Substring(nLastStrIndex, _n nLastStrIndex)); return sbResp.ToString(); } return sQuery; }

/// <summary> /// Gets a valid parameter name, unique for first iMaxParamIndex parameters /// </summary> /// <param name="sParamName"></param> /// <param name="alParams"></param> /// <param name="iMaxParamIndex"></param> /// <returns></returns> private static string getValidParamName(string sParamName, List<CMySqlParameter> alParams, int iMaxParamIndex) { int _iMaxDbIdLength = CMySqlDatabaseConstants.Instance.MaxDbIdLength; string sResp = (_iMaxDbIdLength < sParamName.Length) ? sParamName.Substring(0, _iMaxDbIdLength) : sParamName; int iSuffix = 1; while (IndexOfParam(sResp, alParams, iMaxParamIndex) != -1) { // find an unique name string sSuffix = iSuffix.ToString(); sResp = (_iMaxDbIdLength - sSuffix.Length < sParamName.Length) ? sParamName.Substring(0, _iMaxDbIdLength sSuffix.Length) : sParamName; sResp += sSuffix; iSuffix++; } return sResp; }

Copyright 2013 - Bizagi

403

private static int IndexOfParam(string sParamName, List<CMySqlParameter> alParams, int iMaxParamIndex) { int _i = 0, _n = iMaxParamIndex; while (_i < _n) { if (((CMySqlParameter)alParams[_i]).ParameterName == sParamName) { _n = _i; } else { _i++; } } return (_n == iMaxParamIndex) ? -1 : _n; }

#endregion #region IProviderVirtualDA Members void { } void { IProviderVirtualDA.CloseConnection() if (MySqlconn != null) MySqlconn.Close(); MySqlconn = null; } void { } void { } void { IProviderVirtualDA.OpenConnection() IProviderVirtualDA.Init(HybridDictionary htMetadata) m_htMetadata = htMetadata; IProviderVirtualDA.Commit() IProviderVirtualDA.BeginTransaction() throw new NotImplementedException();

if (MySqlconn == null) { // Verificar que los campos de la metadata esten correctamente diligenciados

404

Copyright 2013 - Bizagi

if (!m_htMetadata.Contains("Server") || !m_htMetadata.Contains("Database") || !m_htMetadata.Contains("Username") || !m_htMetadata.Contains("Password")) { throw new CEntityClassInterfaceException("Incomplete metadata: connection parameters missing"); } else { // construir la cadena de conexion con los datos que se reciben string sConn; string sServer = m_htMetadata["Server"].ToString(); string sDatabase = m_htMetadata["Database"].ToString(); string sUsername = m_htMetadata["Username"].ToString(); string sPassword = m_htMetadata["Password"].ToString(); sConn = "Server=" + sServer + ";Database=" + sDatabase + ";Uid=" + sUsername + ";Pwd=" + sPassword + ";"; MySqlconn = new MySqlConnection(sConn); MySqlconn.Open(); } } } void { } #endregion #region IDisposable Members void { IDisposable.Dispose() if (!bDisposed) { // nunca se debe cerrar la conexin dentro de este mtodo!! bDisposed = true; } } #endregion public MySqlConnection getConnection() { return this.MySqlconn; } public DataSet executeMySQLQuery(string sSQL) { IProviderVirtualDA.Rollback()

Copyright 2013 - Bizagi

405

MySqlCommand command; MySqlDataAdapter adapter; DataSet ds = new DataSet(); command = new MySqlCommand(sSQL, this.getConnection()); adapter = new MySqlDataAdapter(command); adapter.Fill(ds); return ds; } public void executeNonQueryMySQL(string sSQL) { MySqlCommand command; command = new MySqlCommand(sSQL, this.getConnection()); command.ExecuteNonQuery(); } } }

Clase de la interfaz IReplicationEntDA using System; using System.Data; using System.Data.OleDb; using System.Collections; using System.Collections.Specialized; using System.Text; using System.Xml; using BizAgi.EntityManager.Interfaces; using MySql.Data.MySqlClient; using BizAgi.Defs; namespace BizagiMySQL { public class CMySQLReplication : IReplicationEntDA { /// <summary> /// Flag to show if object has been disposed /// </summary> protected bool m_bDisposed; /// <summary> /// Connection with the virtual System /// </summary> protected CMySQLProvider m_objSystem; /// <summary> /// Metadata used to initialize object, as collection of name-value

406

Copyright 2013 - Bizagi

pairs /// </summary> protected HybridDictionary m_htMetadata;

public CMySQLReplication() { m_bDisposed = false; } #region IReplicationEntDA Members public void Init(IProviderVirtualDA objProvider, HybridDictionary htMetadata) { m_objSystem = (CMySQLProvider)objProvider; m_htMetadata = htMetadata; } public DataSet GetEntity(string sEntSource, string[] arrsColList) { try { StringBuilder sbSQL = new StringBuilder(); sbSQL.Append(" SELECT "); sbSQL.Append(string.Join(",", arrsColList)); sbSQL.Append(" FROM "); sbSQL.Append(sEntSource); DataSet ds = m_objSystem.executeMySQLQuery(sbSQL.ToString ()); /*DataTable dtAttribValues = ds.Tables[0]; XmlDataDocument xmlDoc = new XmlDataDocument(ds); string sAux = xmlDoc.InnerXml; sAux = sAux.Replace("Table", "ENTITYINSTANCES"); return sAux;*/ return ds; } catch (Exception e) { throw new ApplicationException(e.Message); } } #endregion #region IDisposable Members public void Dispose() { if (!m_bDisposed) {

Copyright 2013 - Bizagi

407

m_bDisposed = true; } } #endregion #region IReplicationEntDA Members DataSet IReplicationEntDA.GetEntity(string sEntSource, string[] arrsColList, string optionalSourceFilter) { throw new NotImplementedException(); } void IReplicationEntDA.Init(IProviderVirtualDA objProvider, HybridDictionary htMetadata) { m_objSystem = (CMySQLProvider)objProvider; m_htMetadata = htMetadata; } #endregion #region IDisposable Members void IDisposable.Dispose() { if (!m_bDisposed) { // nunca se debe cerrar la conexin dentro de este mtodo!! m_bDisposed = true; } } #endregion } }

Clase de la Interfaz IParameter namespace BizagiMySQL { using using using using System; System.Data; Vision.Defs; Vision.DA;

public class CMySqlParameter : IParameter { private EDataType dataType; //--- Provider-independent data type private SqlDbType dbDataType; //--- Provider-specific datatype of the parameter

408

Copyright 2013 - Bizagi

private ParameterDirection direction; //--- The direction of the parameter private string paramName; //--- The Internal name of the parameter private int size; //--- The size of the parameter private byte precision; //--- The precision of the parameter (for decimal values) private byte scale; //--- The scale of the parameter (for decimal values) private object paramValue; //--- The value of the parameter private string sourceColumn; //--- Column associated with parameter private bool useCurrentSourceColumnValue; //--- True if associated column's value is the current, false if it's the original private string originalParamName; //--- The Original o External name of the parameter

public CMySqlParameter(string sParameterName, EDataType eDataType, int iSize, object oValue) { ParameterName = sParameterName; dataType = eDataType; dbDataType = getSqlDataType(eDataType); size = iSize; paramValue = oValue; direction = (ParameterDirection) EParamDirection.In; } public CMySqlParameter (string sParameterName, EDataType eDataType, int iSize, object oValue, EParamDirection eDirection) { ParameterName = sParameterName; dataType = eDataType; dbDataType = getSqlDataType(eDataType); size = iSize; paramValue = oValue; direction = (ParameterDirection) eDirection; } public CMySqlParameter (string sParameterName, EDataType eDataType, int iSize, byte iPrecision, byte iScale, object oValue, EParamDirection eDirection) { ParameterName = sParameterName; dataType = eDataType; dbDataType = getSqlDataType(eDataType); size = iSize; precision = iPrecision; scale = iScale; paramValue = oValue;

Copyright 2013 - Bizagi

409

direction = (ParameterDirection) eDirection; } public CMySqlParameter (string sParameterName, EDataType eDataType, int iSize, byte iPrecision, byte iScale, object oValue, EParamDirection eDirection, string sSourceColumn, bool bUseCurrentSourceColumnValue) { ParameterName = sParameterName; dataType = eDataType; dbDataType = getSqlDataType(eDataType); size = iSize; precision = iPrecision; scale = iScale; paramValue = oValue; direction = (ParameterDirection) eDirection; sourceColumn = sSourceColumn; useCurrentSourceColumnValue = bUseCurrentSourceColumnValue; } // --// IParameter implementation // The property set the originalname and the correct internal name that must have the parameter // --public string ParameterName { get { return paramName; } set { string sResult = value; originalParamName = value; paramName = sResult.Replace ("@","?"); } } //-// Only for this IParameter implementation // ReadOnly -- Return the original name of the parameter //-public string OriginalName { get { return originalParamName; } }

410

Copyright 2013 - Bizagi

public EDataType Type { get { return dataType; } set { dataType = value; dbDataType = getSqlDataType(dataType); } } public int Size { get { return size; } set { size = value; } } public byte Precision { get { return precision; } set { precision = value; } } public byte Scale { get { return scale; } set { scale = value; } } public object Value { get {

Copyright 2013 - Bizagi

411

return paramValue; } set { paramValue = value; } } public EParamDirection Direction { get { return (EParamDirection)direction; } set { direction = (ParameterDirection)value; } } public string SourceColumn { get { return sourceColumn; } set { sourceColumn = value; } } public bool UseCurrentSourceColumnValue { get { return useCurrentSourceColumnValue; } set { useCurrentSourceColumnValue = value; } }

public SqlDbType DataType { get { return dbDataType; } }

412

Copyright 2013 - Bizagi

private static SqlDbType getSqlDataType(EDataType eDataType) { SqlDbType oDbType = SqlDbType.Int; switch (eDataType) { case EDataType.BigInt: oDbType = SqlDbType.BigInt; break; case EDataType.Int: oDbType = SqlDbType.Int; break; case EDataType.SmallInt: oDbType = SqlDbType.SmallInt; break; case EDataType.TinyInt: oDbType = SqlDbType.TinyInt; break; case EDataType.Boolean: oDbType = SqlDbType.Bit; break; case EDataType.Decimal: oDbType = SqlDbType.Decimal; break; case EDataType.Numeric: oDbType = SqlDbType.Float; break; case EDataType.Money: oDbType = SqlDbType.Money; break; case EDataType.Float: oDbType = SqlDbType.Float; break; case EDataType.Real: oDbType = SqlDbType.Real; break; case EDataType.DateTime: oDbType = SqlDbType.DateTime; break; case EDataType.SmallDateTime: oDbType = SqlDbType.SmallDateTime; break;

Copyright 2013 - Bizagi

413

case EDataType.Char: oDbType = SqlDbType.Char; break; case EDataType.VarChar: oDbType = SqlDbType.VarChar; break; case EDataType.Text: oDbType = SqlDbType.Text; break; case EDataType.Binary: oDbType = SqlDbType.Binary; break; case EDataType.VarBinary: oDbType = SqlDbType.VarBinary; break; case EDataType.Image: oDbType = SqlDbType.Image; break; case EDataType.Guid: oDbType = SqlDbType.UniqueIdentifier; break; case EDataType.NChar: oDbType = SqlDbType.NChar; break; case EDataType.NVarChar: oDbType = SqlDbType.NVarChar; break; case EDataType.NText: oDbType = SqlDbType.NText; break; default: break; } return oDbType; } } }

Clase de la Interfaz IDatabaseConstants using System;

414

Copyright 2013 - Bizagi

using using using using using using using using using using using using using using using

System.Data; System.Data.Common; System.Collections; System.Collections.Generic; System.Diagnostics; System.IO; System.Text; System.Text.RegularExpressions; System.Data.SqlClient; BizAgi.Commons; Vision.DA.AppTablesSchema; Vision.Defs; Vision.DA.Exceptions; System.Threading; Vision.DA;

namespace BizagiMySQL { /// <summary> /// Specific database constants /// </summary> public class CMySqlDatabaseConstants : IDatabaseConstants { #region Singleton private static CMySqlDatabaseConstants m_oSqlInstance = new CMySqlDatabaseConstants(); public static CMySqlDatabaseConstants Instance { get { return m_oSqlInstance; } } protected CMySqlDatabaseConstants() { } #endregion #region Fields / Properties /// <summary> /// Database keyword for a identity type /// </summary> private readonly string m_sIdentityTypeModifier = "IDENTITY(1,1)"; public string IdentityTypeModifier { get { return m_sIdentityTypeModifier; } }

Copyright 2013 - Bizagi

415

/// <summary> /// Enable fixed id insert on identity column /// </summary> private readonly string m_sSetIdentiyInsertOn = "SET IDENTITY_INSERT {0} ON"; public string SetIdentiyInsertOn { get { return m_sSetIdentiyInsertOn; } } /// <summary> /// Disable fixed id insert on identity column /// </summary> private readonly string m_sSetIdentiyInsertOff = "SET IDENTITY_INSERT {0} OFF"; public string SetIdentiyInsertOff { get { return m_sSetIdentiyInsertOff; } } /// <summary> /// Database assignment syntax ({0}: Variable to assign, {1): Value to assign) /// </summary> private readonly string m_sAssignTemplate = "SET {0} = {1} "; public string AssignTemplate { get { return m_sAssignTemplate; } } /// <summary> /// Default template for connection string ({0}: Server, {1}: Database, {2}: User, {3}: Password) /// </summary> protected string m_sDefaultConnString = "Persist Security Info=True;User ID={2};Password={3};Data Source={0};Initial Catalog={1};"; public string DefaultConnString { get { return m_sDefaultConnString; } } /// <summary> /// Keyword to start statements blocks /// </summary> private readonly string m_sBeginStatementBlock = string.Empty; public string BeginStatementBlock { get { return m_sBeginStatementBlock; } } /// <summary> /// Keyword to end statements blocks /// </summary> private readonly string m_sEndStatementBlock = string.Empty; public string EndStatementBlock { get { return m_sEndStatementBlock; } } /// <summary> /// Keyword to call stored procedure in statement block /// </summary> private readonly string m_sExecSPStatement = "EXEC "; public string ExecSPStatement { get { return m_sExecSPStatement; } }

416

Copyright 2013 - Bizagi

/// <summary> /// Symbol to start parameter list in stored procedure call /// </summary> private readonly string m_sBeginSPParams = string.Empty; public string BeginSPParams { get { return m_sBeginSPParams; } } /// <summary> /// Symbol to end parameter list in stored procedure call /// </summary> private readonly string m_sEndSPParams = string.Empty; public string EndSPParams { get { return m_sEndSPParams; } } /// <summary> /// Flag to indicate if default values are between () /// </summary> private readonly bool m_bDefaultValuesEnclosed = true; public bool DefaultValuesEnclosed { get { return m_bDefaultValuesEnclosed; } } /// <summary> /// String concatenation operator /// </summary> private readonly string m_sConcatSymbol = "+"; public string ConcatSymbol { get { return m_sConcatSymbol; } } /// <summary> /// Provider support automatically retrieve data changes /// </summary> private readonly bool m_bEnabledSelectAfterChange = true; public bool EnabledSelectAfterChange { get { return m_bEnabledSelectAfterChange; } } /// <summary> /// Indicates if an empty string is equivalen to null /// </summary> private readonly bool m_bEmptyStringIsNull; public bool EmptyStringIsNull { get { return m_bEmptyStringIsNull; } } /// <summary> /// Empty string for database /// </summary> private readonly string m_sEmptyString = string.Empty; public string EmptyString { get { return m_sEmptyString; } } /// <summary> /// Format for retrieve constant single query /// </summary> private readonly string m_sConstantQueryTemplate = "SELECT {0}"; public string ConstantQueryTemplate { get { return m_sConstantQueryTemplate; } }

Copyright 2013 - Bizagi

417

/// <summary> /// Maximum lenght for a database object id /// </summary> private readonly int m_iMaxDbIdLength = 128; public int MaxDbIdLength { get { return m_iMaxDbIdLength; } } /// <summary> /// Open character for enclose a name that is reserverd word or has special characters /// </summary> private readonly string m_sQuotedNameOpenChar = ""; public string QuotedNameOpenChar { get { return m_sQuotedNameOpenChar; } } /// <summary> /// Close character for enclose a name that is reserverd word or has special characters /// </summary> private readonly string m_sQuotedNameCloseChar = ""; public string QuotedNameCloseChar { get { return m_sQuotedNameCloseChar; } } /// <summary> /// Default Precision for decimals /// </summary> private readonly byte m_iDecimalDefaultPrecision = 18; public byte DecimalDefaultPrecision { get { return m_iDecimalDefaultPrecision; } } /// <summary> /// Default Scale for decimals /// </summary> private readonly byte m_iDecimalDefaultScale = 0; public byte DecimalDefaultScale { get { return m_iDecimalDefaultScale; } } /// <summary> /// Default Precision for numerics /// </summary> private readonly byte m_iNumericDefaultPrecision = 18; public byte NumericDefaultPrecision { get { return m_iNumericDefaultPrecision; } } /// <summary> /// Default Scale for numerics /// </summary> private readonly byte m_iNumericDefaultScale = 0; public byte NumericDefaultScale { get { return m_iNumericDefaultScale; } } /// <summary> /// Indicates if by default comparisons between strings are case sensitive

418

Copyright 2013 - Bizagi

/// </summary> private readonly bool m_bCaseSensitive; public bool CaseSensitive { get { return m_bCaseSensitive; } } /// <summary> /// Keyword to specify storage for a table creation /// </summary> private readonly string m_sKeywordStorageTable = string.Empty; // TODO: [on Primary] public string KeywordStorageTable { get { return m_sKeywordStorageTable; } } /// <summary> /// Keyword to specify storage for an index creation /// </summary> private readonly string m_sKeywordStorageIndex = string.Empty; // TODO: [on Primary] public string KeywordStorageIndex { get { return m_sKeywordStorageIndex; } } /// <summary> /// Order by template for linguistic order /// </summary> private readonly string m_sOrderByStringTemplate = "{0}"; public string OrderByStringTemplate { get { return m_sOrderByStringTemplate; } } /// <summary> /// Max lenght for strings /// </summary> private readonly int m_iVarcharMaxLength = 7800; public int VarcharMaxLength { get { return m_iVarcharMaxLength; } } /// <summary> /// String representation for an empty blob /// </summary> private readonly string m_sEmptyBlobValue = "0x"; public string EmptyBlobValue { get { return m_sEmptyBlobValue; } } /// <summary> /// Keyword to made dirty reads /// </summary> private readonly string m_sSelectWithNoLock = " WITH (NOLOCK) "; public string SelectWithNoLock { get { return m_sSelectWithNoLock; } } /// <summary> /// Keyword to force locks at row level in updates /// </summary> private readonly string m_sUpdateWithRowLock = " WITH (ROWLOCK) "; public string UpdateWithRowLock { get { return m_sUpdateWithRowLock; } }

Copyright 2013 - Bizagi

419

/// <summary> /// key word to drop indexes /// </summary> private readonly string m_sKeywordDropPKIndex = string.Empty; public string KeywordDropPKIndex { get { return m_sKeywordDropPKIndex; } } /// <summary> /// String lenght function /// </summary> private readonly string m_sStringLenghtFunction = "len"; public string StringLenghtFunction { get { return m_sStringLenghtFunction; } } /// <summary> /// Current Date function /// </summary> private readonly string _currentDateFunction = "GETDATE()"; public string CurrentDate { get { return _currentDateFunction; } } #endregion #region Methods /// <summary> /// Prefix to call a function /// </summary> private readonly string m_sFunctionPrefix = "dbo."; public string GetFunctionPrefix(CConfiguration oDBConf) { return m_sFunctionPrefix; } /// <summary> /// Creates a new SQL expression with the "TOP X" included in the sentence based on the provider type /// </summary> /// <param name="sql">"Simple" SQL Sentence to be parsed and replaced, subqueries are not allowed</param> /// <param name="top">number of rows to return</param> /// <returns>Parsed SQL Sentence</returns> public string replaceTopSentence(string sql, int top) { int pos = sql.ToLower().IndexOf("select"); StringBuilder result = new StringBuilder(); string suffix; if (pos > 0) { result.Append(sql.Substring(0, pos)); suffix = sql.Substring(6 + pos); } else { suffix = sql.Substring(6); }

420

Copyright 2013 - Bizagi

result.AppendFormat("SELECT TOP {0} ", top); result.Append(suffix); return result.ToString(); } #endregion } }

Configurar el proveedor en Bizagi

En este paso, vamos a configurar el Sistema y el proveedor de datos de la Replicacin especificando que librera debe ser usada (el componente personalizado creado anteriormente). Nota: Tenga en cuenta que la configuracin es hecha a travs del mtodo de configuracin estndar de replicacin, el cual requiere que las entidades a ser replicadas hayan sido creadas en el modelo de datos de Bizagi. 1. Clic en Sistema, en la vista de Mdulos de Bizagi. Puede dar clic derecho sobre el elemento sistema y seleccionar N u ev o Sistem a del men desplegable o dar clic en N u ev o sistem a de la barra del men.

Copyright 2013 - Bizagi

421

2. Ingrese el Nombre, Nombre Visual y Descripcin para el nuevo sistema y seleccione el checkbox de P erm itir En tid ad es Virtu ales p ara rep licaci n p ara este sistem a. Clic en Ok para guardar cambios.

3. Clic en el signo (+) al lado del sistema recin creado. Clic derecho en el elemento N u ev o P ro v eed o r.

422

Copyright 2013 - Bizagi

4. En la ventana del Nuevo Proveedor ingrese N o m b re, N o m b re Visu al y Descrip ci n en la pestaa de configuracin del proveedor. Marque la opcin Permitir Replicacin para este proveedor. Tambin marque la opcin P erm itir en tid ad es v irtu ales p ara este p ro v eed o r (si aplica).

5. Seleccione la pestaa de proveedor y la librera de la entidad y clic en Nueva librera ( N ew A ssem b ly).

Copyright 2013 - Bizagi

423

6. Ingrese N o m b re, N o m b re Visu al y Descrip ci n . Luego haga clic Seleccionar Librera para seleccionar el .dll de la librera de replicacin personalizada previamente. De clic en Ok en la ventana de Nueva Librera.

424

Copyright 2013 - Bizagi

7. De clic en el botn Nueva Clase y dentro de la ventana Nueva Clase para Librera, ingrese el nombre de la clase que implementa la interfaz IProviderVirtualDA. De clic en Ok. .

Copyright 2013 - Bizagi

425

8. Ahora, en la pestaa Propiedades desarrollo de Proveedor, incluya las propiedades de la conexin haciendo clic en el botn Metadata para crear una nueva fila Propiedad-Valor. De clic en Ok en la ventana Nuevo Proveedor.

9. Expanda el elemento nuevo proveedor, seleccione el elemento Entidades Replicadas y cree una Nueva Clase de Replicacin.

426

Copyright 2013 - Bizagi

10. Seleccione la librera de la lista desplegable en la ventana Nueva Clase para Librera (si la clase de la Entidad esta en la misma librera que la Clase del Proveedor) o incluya una nueva dando clic en Nueva Librera..

De clic en Nueva Clase y complete los campos necesarios en la nueva ventana. Haga clic en Ok para completar la Configuracin de la Clase de la Entidad.

Copyright 2013 - Bizagi

427

11. De clic derecho sobre el nuevo elemento de la clase de la entidad y seleccione la opcin Nuevo Esquema de Replicacin.

12. En la ventana de Configuracin de Replicacin, ingrese un Nombre, Nombre una Descripcin significativa para el esquema de replicacin.

Visual y

428

Copyright 2013 - Bizagi

Seleccione la pestaa propiedades del programador y configure la frecuencia con que la informacin ser replicada desde la fuente de datos. .

Copyright 2013 - Bizagi

429

Defina la periodicidad y frecuencia de ejecucin de acuerdo a la informacin de la siguiente tabla;

Opciones del programador Habilitar programador para la replicacin

Descripcin Marque esta opcin en Bizagi para ejecutar los datos de la replicacin desde la fuente de datos externa. Marque, diario, semanal o mensual para definir con que frecuencia Bizagi ejecutar el esquema de Replicacin. Esta opcin cambiara de acuerdo a la opcin seleccionada en Periodicidad. Cuando se selecciona Diario: ingrese el nmero de das para realizar la repeticin. Cuando se selecciona semanal: ingrese el nmero de semanas para realizar la repeticin. Tambin seleccione en que da de la semana se debe ejecutar el esquema. Cuando se selecciona mensual: ingrese el nmero de meses para realizar la repeticin. Tambin seleccione en que da del mes se debe ejecutar el esquema. Defina si la ejecucin ocurre una vez al da (y en que hora), o si se debe ejecutar cada cierto tiempo (horas, minutos). Configure la fecha inicial para que el esquema comience la ejecucin.

Periodicidad

Cada [...] da(s)

Frecuencia diaria

Inicio

Descripcin de las propiedades del programador

Luego de configurar la fecha de inicio de ejecucin, haga clic en Ok. 13. Haga clic derecho sobre el esquema y seleccione A d icio n ar En tid ad a Rep licaci n .

430

Copyright 2013 - Bizagi

14. En la ventana Agregar Entidad a Replicacin, seleccione la entidad deseada de la lista desplegable de Entidades Paramtricas. Luego, digite el nombre de la entidad externa dentro del campo Fuente Externa. Posteriormente, de la lista de atributos de la entidad de Bizagi, seleccione uno (o ms) que ser la llave del negocio (un atributo que tiene un valor nico de tal modo que este puede ser usado para diferenciar un registro de otro).

Copyright 2013 - Bizagi

431

De clic en Ok para guardar estos cambios. 15. Seleccione la entidad replicada y para cada atributo seleccione el atributo correspondiente externo. Esto se hace, haciendo clic derecho sobre el atributo y seleccionando P ro p ied ad es.

En la ventana Ed itar A trib u to , escriba el nombre del atributo externo y haga clic en Ok.

432

Copyright 2013 - Bizagi

Haga esto para todos los atributos de la entidad replicada.

Nota Si su librera de replicacin personalizada tiene referencias a otras libreras, es necesario copiarlas a la carpeta del Programador, usualmente es: "C:\B izag i\Stan d ard \P ro jects\[P RO JECT_N A M E] \Sch ed u ler". Ya hemos terminado la configuracin de la Replicacin utilizando un componente personalizado para una base de datos mySQL.

Verificar la Replicacin (Punto de chequeo)

Una vez la Replicacin ha sido configurada, usted puede verificar la ejecucin de la sincronizacin de las Entidades Paramtricas con las tablas externas. Existen dos maneras de realizar esto: Utilizando las opciones que se encuentran en el modul Sistem as (Vista mdulos) o travs de la informacin mostrada de las entidades ( M o d u l d e En tid ad es). Las opciones representadas en el mdulo de Sistem as son tiles para los ambientes de produccin o pruebas. Las opciones representadas en el mdulo de En tid ad es servirn para realizar la verificacin mientras se esta realizando la configuracin en el Ambiente de desarrollo. Para ms informacin sobre cmo verificar si la Replicacin se ejecuta correctamente, visite Verificar Replicacin.
3.3.5.1.3 Opciones adicionales en la configuracin de Replicacin

Informacin general
Las siguientes opciones de configuracin avanzadas son presentadas a travs del mdulo sistemas, para lograr definir otro tipo de ajustes para las entidades replicadas por ejemplo, definir filtros en los registros de la tabla de la fuente de datos externa, definir si una columna no debe ser replicada, etc.

Copyright 2013 - Bizagi

433

Ubique el sistema para la replicacin haciendo clic en el mdulo Sistemas en la parte izquierda.

Probar el proveedor

Para verificar que el proveedor fue configurado de forma correcta y asegurar una conexin exitosa, se puede probar el proveedor desde Bizagi Studio. La prueba necesita utilizar IIS, y puede ser realizada antes de configurar la virtualizacin o replicacin de las entidades. Esto har un diagnostico de si la conexin con la fuente de datos externa es exitosa. Para realizar la prueba, seleccione el proveedor y de clic derecho sobre la opcin Probar proveedor (o de clic en el botn en el men como se muestra).

434

Copyright 2013 - Bizagi

En la ventana que se abri, seleccione el botn Iniciar test. Un proveedor que ha sido configurado de forma apropiado, mostrar todas las operaciones con un OK como estado.

Nota: La caracterstica Probar proveedor necesita tener IIS (Internet Information Services), ya que es usado como servidor web para el proyecto de Bizagi.

Copyright 2013 - Bizagi

435

El IIS debe estar encendido y corriendo (Instalacin del IIS), y la configuracin de la seguridad de la carpeta de la aplicacin web del proyecto debe permitir autenticacin annima. Si las anterior condiciones (sobre el IIS) alertadas no se cumplen, la verificacin del proveedor tendr como mensaje de error: "La aplicacin web no est disponible".

Remover entidad de la replicacin

Las entidades replicadas tiene la opcin de detener la sincronizacin con la fuente de datos externa. La entidad removida de la replicacin no se elimina del modelo de datos, solamente elimina la entidad de la replicacin e integracin (es decir el mecanismo no se sigue utilizando).

Nota: Esta caracterstica solamente esta disponible en el ambiente de desarrollo cuando el Esquema y la entidad no han sido deployed al ambiente de produccin.

Aunque la entidad haya sido removida del esquema de replicacin, esta puede ser utilizada, y los valores que se encontraban seguirn siendo los mismos.

436

Copyright 2013 - Bizagi

Adicionar una entidad a la Replicacin

Usted puede escoger incluir una entidad paramtrica creada luego de configurar la replicacin de Bizagi. Para incluir una nueva entidad paramtrica en el esquema de replicacin, utilice la opcin Adicionar entidad a la Replicacin.

A travs de esta opcin, usted podr incluir una entidad como lo hizo con las opciones estndar de configuracin (avanzado). Recuerde mapear todos los atributos de su entidad con las columnas de la fuente.

Replicar ahora
Las entidades replicadas presentan una opcin para forzar la sincronizacin de forma inmediata (en vez de esperar por la programacin del trabajo). Esto es til para un importe inicial o para probar la configuracin de la replicacin. Esta opcin se encuentra dando clic derecho en la entidad replicada.

Copyright 2013 - Bizagi

437

Remover un atributo de la Replicacin

Los atributos de las entidades replicadas tambin tienen la opcin de ser removidos de la esquema de replicacin (esto usualmente es til cuando se ha incluido la totalidad de los atributos en la configuracin, por medio de la replicacin que realiza automticamente el asistente). El atributo retirado de la replicacin an existir en la entidad y podr ser usado en el proceso, aunque la informacin de ste no contine siendo sincronizada con la fuente de datos externa.

La opcin Remover atributo de la replicacin es til para asegurar que la informacin que se esta replicando y sincronizando a travs del esquema de replicacin, es la informacin apropiada y necesaria (y que la informacin innecesaria no esta siendo actualizada). Esta ayuda a mantener un buen desempeo de la integracin a nivel de datos La opcin se utiliza para

438

Copyright 2013 - Bizagi

columnas que hacen referencia a tablas externas que no estn siendo usadas en Bizagi. Una ventaja adicional es que, una vez la entidad Paramtrica tiene un atributo excluido del esquema de replicacin, la entidad aparecer como administrable desde las opciones de administrador Portal de Trabajo, presentando solamente los valores de los atributos excluidos como no editable.

Adicionar atributos a la Replicacin

Entidades replicadas tienen una opcin para incluir atributos adicionales en su configuracin (usualmente cuando la estructura de la tabla de la fuente de datos externos ha tenido cambios luego de la configuracin inicial y la replicacin ya esta funcionando).

Esta opcin requiere lo siguiente: 1. Primero se debe crear el nuevo atributo en la entidad paramtrica en Bizagi. 2. Luego se debe agregar el atributo a la Replicacin, y mapearlo con la columna de la fuente externa. A travs de est opcin, usted incluir una entidad como se realiz en la opcin de configuracin

Copyright 2013 - Bizagi

439

estndar (avanzada).

Establecer un filtro por una entidad replicada

Cuando se configura un Replicacin a travs del Asistente, inicialmente se define un filtro por cada una de las entidades replicadas. Usar filtros es una opcin de negocio orientada a evitar la integracin con registros de los que no se tienen inters en Bizagi, por ejemplo, realizar a sincronizacin con solo un conjunto de valores de la fuente Tipo de cliente. Para revisar o editar el filtro, o cuando se estable la Replicacin a travs de las opciones avanzadas (es decir, cuando se realiza configuracin de forma manual utilizando la opcin Estndar en el modulo Sistem as) se puede hacer a travs del modulo En tid ad es.

Clic derecho en la entidad paramtrica replicada y seleccione Propiedades Avanzadas. En la pestaa Fuente de Filtro ( So u rce F ilter) revise o realice cambios en el filtro.

440

Copyright 2013 - Bizagi

Usted puede probar el filtro utilizando la opcin Probar Filtro de la fuente para obtener los valores de la fuente:

Eliminar esquema de Replicacin

Para borrar un objeto en Bizagi, es necesario revisar, previamente, que no este siendo utilizado

Copyright 2013 - Bizagi

441

(referencia) por otros objetos. Esto significa que para borrar un esquema de replicacin, primero debe asegurarse que no se ha incluido ninguna entidad replicada dentro de su definicin. De lo contrario, Bizagi correr de forma automtica validaciones para evitar eliminar esos objetos.

Proveedor de datos en produccin

Para garantizar el correcto funcionamiento de todos los ambientes en un proyecto de Bizagi, la configuracin de la integracin que est trabajando actualmente en el ambiente de produccin debe tener las siguientes consideraciones:

Para garantizar el correcto desempeo de todos los ambientes una vez se ha hecho deployment para un proyecto, no ser posible eliminar los proveedores configurados que se usen en las versiones de proceso que ya estn en el ambiente productivo. La administracin de estos proveedores (y sus valores de configuracin) para los ambientes de pruebas y produccin, se har directamente a travs de la Consola de Administracin de Bizagi (para cada ambiente de manera separada). Para ms informacin sobre administracin en diferentes ambientes, visite Bizagi Management Console. 3.3.5.2 Virtualizacin

Informacin general
La virtualizacin de entidades en Bizagi es un mecanismo de integracin, que permite a los procesos de Bizagi acceder a diferentes fuentes de Datos. Asegrese de haber ledo la introduccin en Conexiones con fuentes de datos externas. Con la virtualizacin, los procesos de Bizagi pueden acceder a informacin almacenada en mltiples fuentes de datos (RDBMS, XMLs etc.) y presentar la informacin como parte del proceso de negocio. La integracin se realiza transparentemente de los usuarios finales en el tiempo de ejecucin (sincronizacin de informacin). La informacin de la entidad virtualizada es vista y actualizada en el transcurso de una actividad o un

442

Copyright 2013 - Bizagi

proceso de negocios modelado. Ejemplo de informacin manejada a travs de Virtualizacin son: informes de clientes o vendedores, facturas, rdenes de compra, entre otras cosas (registros de tablas que son vistas como transaccionales). Para integracin de tablas e datos donde la actualizacin de la informacin es almacenada como valores predefinidos (entidades paramtricas), visite Replicacin.

Cmo funciona?
Para utilizar la virtualizacin en Bizagi, usted debe primero asegurar que la fuente de datos externa cumpla las mejores prcticas y los requerimientos necesarios, como tener acceso de lectura y escritura (un inicio de sesin con permisos otorgados). Para configurar la virtualizacin se debe definir un sistema externo y el proveedor de datos (conexin con la fuente externa de datos). Bizagi ofrece un asistente grfico para minimizar las configuraciones necesarias.

Una vez la sincronizacin ocurre, la informacin ser presentada a los usuarios finales como parte del proceso de negocio en Bizagi.

Prerrequisitos
La fuente de datos externa debe cumplir los siguientes requerimientos:

Copyright 2013 - Bizagi

443

1. El acceso al sistema de informacin externo debe estar disponible en tiempo real (para sincronizacin en lnea); si este no es el caso, debera ser implementada replicacin de datos en lotes. Este tipo de acceso requiere permiso de lectura y escritura en la fuente de datos. 2. Si la virtualizacin va a acceder una base de datos, esta debera estar normalizada. Esto es requerido para identificar claramente las llaves de negocio en cada entidad de tal manera que Bizagi pueda identificar sin equivocaciones una instancia. Adicionalmente, debe existir una relacin entre las entidades de Bizagi (virtualizadas) y las entidades de la fuente externa.

Caractersticas Importantes
1. La virtualizacin solo aplica para entidades de tipo Maestras en Bizagi (datos transaccionales; y cuando nuevas lneas son creadas en una nueva instancia del proceso). Clic para ms informacin sobre Entidades Maestras. Si usted desea utilizar esta caracterstica de integracin para tabla con lista de valores, es decir, entidades paramtricas, visite Replicacin. 2. La configuracin de la Virtualizacin se realiza fcilmente a travs de un asistente grfico. El asistente ayuda en la definicin de la conexin con el proveedor de datos, ya sea Oracle o SQL Server (la configuracin se realiza en pocos pasos sin necesidad de programacin). Las versiones de base de datos soportadas por el asistente de virtualizacin son (para conexiones de Oracle y SQL Server):

Motor de base de datos Microsoft SQL Server

Versin

2012 (aplica para las ediciones Bizagi Enterprise .NET y Bizagi Xpress) 2008 R2 2008 2005

Oracle

9i 10g R1 10g R2 11g R1

444

Copyright 2013 - Bizagi

11g R2
Versiones soportadas para el asistente de virtualizacin (conexin nativa)

Cuando un proyecto requiere virtualizacin de una fuente de datos diferente a Oracle o SQL Server (por ejemplo MySQL, XML files, Microsoft Access, etc.), se puede incluir una implementacin personalizada y configurar la virtualizacin a travs de la configuracin Estndar (avanzada). Esto significa, que cualquier otro motor de base de datos no mencionado en la anterior tabla es soportado por la Virtualizacin de Bizagi, pero requiere de desarrollos adicionales. Para ms informacin visite Virtualizacin Personalizada.

Notas: o La funcionalidad para incluir una implementacin personalizada, para utilizar la virtualizacin contra cualquier otra fuente de datos (diferente a Oracle y SQL Server), est soportada por la edicin Bizagi Enterprise .Net. o Cuando se virtualizan entidades contra una fuente de datos Oracle, para utilizar el asistente grfico de Bizagi, se requiere instalar Oracle Data Provider para .Net. 3. Bizagi soporta un amplio conjunto de tipos de datos de origen (en fuentes de datos Oracle o SQL Server). Para ver ms informacin sobre los tipos de datos soportados por defecto, visite tipos de datos soportados. Otro tipo de datos no nombrado en la tabla del link anterior es soportado por la virtualizacin pero con un desarrollo de un componente adicional (a travs de Virtualizacin Personalizada). 4. Atributos borrados en la fuente nunca se borran en Bizagi. Cuando se sincronizan valores de entidades virtualizadas, Bizagi deshabilitar aquellos registros que fueron borrados de la fuente (sern marcados utilizando un borrado lgico en vez de un borrado fsico). Esto se realiza para conservar la integridad de los casos existente en Bizagi. Para ver mayor informacin acerca de los lineamientos y temas avanzados relacionados a la caracterstica de Virtualizacin en Bizagi y sus opciones, consulte Mejores prcticas para Virtualizacin.

Beneficios
La capacidad de Bizagi para virtualizar cualquier entidad definida en Bizagi provee los siguientes beneficios: Reusabilidad ya que permite a los procesos integrarse con fuente de datos existentes (aplicaciones) y sistemas heredados. Esto es un requerimiento frecuente cuando los sistema heredados no tienen un diseo de Servicio Orientado a Arquitectura para integracin en alto nivel (integracin a nivel de datos es requerida). La distribucin de trabajo a travs de miembros del equipo de proyecto BPM se realiza de forma

Copyright 2013 - Bizagi

445

clara. El trabajo se separa de acuerdo a diferentes roles: el analista de diseo del negocio crea el modelo del proceso y reglas de negocio; mientras la persona de IT disea, configura e implementa el modelo de datos e integra la solucin. Ofrece a los analistas del negocio un modelo de datos limpio para el manejo y el intercambio de informacin del proceso. Los analistas del negocio tienen acceso a la informacin del proceso como si estuviera disponible directamente en el repositorio de procesos de Bizagi (como datos locales). De esta manera, no tienen que entender la complejidad asociada con la ubicacin real de la informacin. El diagrama de flujo del proceso no deber incluir actividades tcnicas (como por ejemplo de acceso a datos). Por esta razn los procesos organizacionales permanecen fciles de leer y entendibles por la audiencia de negocio. Las reglas de negocio no tienen que lidiar con acceso de datos o realizar mapeos. Tener un solo componente para proveer todas las actividades de acceso a datos externos simplifica notablemente el mantenimiento de la solucin. El nmero de interfaces con sistemas externos se reduce significantemente.

Configurar la Virtualizacin
Como se mencion anteriormente, la configuracin de la Virtualizacin se puede hacer de dos formas: En la mayora de los escenarios el asistente grfico ser suficiente. Para ms informacin sobre el primer mtodo, visite Utilizando el asistente de Virtualizacin. Sin embargo, para escenarios ms complejos usted podr utilizar la opcin de configuracin Estndar. Estos escenarios se refieren principalmente a: El uso de fuente de datos que no es SQL Server u Oracle (mediante replicacin personalizada). Los requerimientos para configuracin avanzada (por ejemplo, querer utilizar una columna de Oracle que no es soportada). Necesidad de ajustes manuales en la configuracin. Esto puede pasar en escenarios sofisticados donde tiene todo un conjunto de tablas que estn relacionadas entre ellas. Esto puede involucrar relaciones entre entidades virtuales, por lo que la configuracin requiere que todas las tablas sean replicas y virtualizadas teniendo en cuenta algunas consideraciones. Para ms informacin sobre el segundo mtodo, visite Utilizando configuracin avanzada para Virtualizacin (opcin estndar).
3.3.5.2.1 Mejores prcticas para Virtualizacin

Lineamientos generales
El siguiente articulo enumera las mejores practicas que se deben utilizar (o planear usar) con la

446

Copyright 2013 - Bizagi

Virtualizacin de Bizagi.

1. Diseo y anlisis apropiado en etapas tempranas

Se recomienda tener en cuenta todas las restricciones, posibilidades de integracin y diseo apropiado para el modelado de datos (en fases de anlisis y diseo de la implementacin del proyecto). De esta manera, considerar cuales entidades se virtualizarn es una buena practica antes de empezar a crear todas las entidades y el modelo de datos en Bizagi. Esto involucra: Definir el Modelo de datos de las relaciones de la entidad para Virtualizacin as como cuales Entidades y Atributos sern virtuales. Tener en cuenta que el diseo de la Base de Datos debera utilizar la tercera forma normal (normalizacin).

2. Todos los atributos de una Entidad virtual deben ser virtuales (tener una columna
a la fuente origen). Es importante tener en cuenta que TODOS los atributos de entidades virtuales en el modelo de datos de Bizagi, deberan ser mapeados a sus correspondientes orgenes (significa que no debera haber atributos en una entidad virtual sin un mapeo a una columna externa). En caso que usted considere que los requerimientos del Modelo de datos del Proceso necesitaran atributos adicionales para una entidad virtual, entonces estos atributos deberan ser creados en una entidad separada (que tiene una referencia de atributo de entidad a la entidad virtual). En el siguiente ejemplo de modelo de datos de un Proceso Bizagi, los atributos adicionales O b serv acio n es y Cu en tas To tales para un cliente, son creados en otra entidad (Customer_AdditionalInfo) que referencia a la entidad virtual RCustomer:

Copyright 2013 - Bizagi

447

3. Puertos externos explcitos (aplica cuando se realiza integracin a una fuente de datos SQL Server)
Cuando se utiliza una fuente de datos externa SQL Server, es recomendable que la instancia de la base de datos tenga una configuracin explicita del puerto TCP.

448

Copyright 2013 - Bizagi

Cuando se utiliza un puerto TCP explicito es necesario seguir las mejores prcticas (En vez de la opcin puerto dinmico TCP).

Cuando se configura la Virtualizacin utilizando la edicin Bizagi Enterprise JEE, si el puerto TCP (en el cual la instancia de SQL Server inicia, como se menciono anteriormente) es diferente a 1433 (por defecto), es necesario especificar de forma explicita en las propiedades del proveedor de datos. Para incluir esta configuracin usted debe incluir una propiedad llamada "SQLServerDBPort" con el valor del puerto de la instancia SQL Server.

Copyright 2013 - Bizagi

449

La ltima configuracin de SQ LServ erDB P o rt solo es necesaria para la edicin Bizagi Enterprise JEE en el ambiente de desarrollo.

Configuracin de JEE en el ambiente de produccin

Para configurar la Virtualizacin en los ambientes de produccin o Test cuando se utiliza JEE Application Server es necesario un paso adicional. El requerimiento adicional es configurar la fuente de datos externa con las especificaciones de JEE

450

Copyright 2013 - Bizagi

Application Server. Para llevar a cabo este paso, su JEE Application server ya debe estar configurado para trabajar con Bizagi. Tenga en cuenta que este paso solamente se necesita en los ambientes diferentes al de desarrollo (para los otros ambientes no se necesitan pasos adicionales porque Bizagi Studio configura automticamente la fuente externa con JBoss 7.1.1 Application Server). Para ms informacin sobre la configuracin de requerimientos en los ambientes de pruebas o produccin, visite Cmo configurar Virtualizacin y Replicacin en JEE Application server?

4. Virtualizacin trabajando en produccin

Tenga en cuenta que una vez la fuente de datos externa (registrada como sistema en Bizagi) ha sido pasado al ambiente de produccin, no ser posible convertir el modelo virtualizado en un modelo no virtualizado. Esto trata de garantizar la definicin de cuales son las tablas que deben ser virtualizadas y cuales no; esta definicin se debe realizar antes de pasar el proceso y utilizarlo en produccin. En caso en que necesite parar de usar la Virtualizacin en su proyecto, deber crear una nueva versin del proceso y asegurarse que el modelo de datos del proceso utilice una entidad alternativa (la cual no es la virtual). De forma similar, no se recomienda cuando existen entidades no virtualizadas en un proceso ya en produccin (tiene valores almacenados), y luego es deseado virtualizarlas con una fuente de datos externa. Si definitivamente es necesario, se deben tener algunas precauciones para los valores existentes y llaves de negocio.

5. Nomenclatura de las entidades

Los nombres en Bizagi de las entidades a virtualizar deben ser ms pequeos que 22 caracteres (obligatorio). Es necesario considerar esto para la definicin de los nombres de las entidades locales, dado esto, Bizagi, de forma automtica incluir algunos prefijos a los nombres de las entidades.

6. Replicar primero si las Entidades virtuales tienen relacin con las replicadas
Cuando se tiene un modelo mixto donde se tiene tanto Virtualizacin como Replicacin, y se han configurado Entidades virtuales con atributos de referencia a Entidades replicadas, se recomienda revisar que los registros replicados (aquellos de las Entidades replicadas) hayan sido sincronizados. Para esto, puede optar por tener ejecuciones de Replicacin de una manera peridica que se adapte a las necesidades de negocio.

Lineamientos avanzados
Los siguientes lineamientos aplican cuando se utiliza Virtualizacin personalizada (sobreescribir los mtodos que Bizagi por mtodos implementados por usted).

1. Acceso a datos y evitar bloqueos

Es posible acceder a diferentes fuentes de datos a travs de la Virtualizacin personalizada utilizando

Copyright 2013 - Bizagi

451

cualquier conexin y mecanismo de transporte (ODBC, OLEDB, Client Access, HTTP, Sockets, etc.). Lo que es importante es seguir las buenas prcticas de conexin a su fuente (y otras consideraciones especiales) en orden de manejar adecuadamente las conexiones y evitar bloqueos.

2. Desempeo
Cuando se realiza un desarrollo de una implementacin para una fuente de datos diferente a Oracle o SQL Server se debe tener en cuenta variables de desempeo. No es posible acceder a la base de datos de Bizagi desde la clase de virtualizacin, y el nmero de conexiones a la base de datos al mnimo es una buena estrategia para alcanzar el mximo de eficiencia.

3. La implementacin CRUD considera tipo de datos

Cuando se utiliza la virtualizacin personalizada, la fuente de datos externa debe tener mecanismos para: seleccionar, insertar, actualizar y eliminar instancias de la entidad (utilizando funciones, procedimientos, Web Services, etc.). El tipo de datos en la fuente de datos externo deben ser lo ms parecido (ideal que sean el mismo) al tipo de datos de Bizagi. Si el tipo de datos no puede ser mapeado de forma natural con los tipos de datos de Bizagi, se debe implementar una interfaz para realizar este mapeo. Esto significa, que de ser necesario, el mapeo de datos y las validaciones de tipo de datos se deben realizar de forma manual y con la interfaz de virtualizacin. Esto se realiza para evaluar las posibles transformaciones de Bizagi a la fuente de datos externa.
3.3.5.2.2 Utilizar el asistente de Virtualizacin

Informacin general
Bizagi presenta el asistente de Virtualizacin para ayudarlo en la conexin con una base de datos externa SQL Server o base de datos Oracle (y los componentes necesarios para la conexin son creados por defecto). Clic para ms informacin sobre virtualizacin. El siguiente artculo ilustra cmo configurar la Virtualizacin en Bizagi utilizando el asistente. Si usted necesita conectar con una base de datos externa que no sea SQL Server u Oracle, visite Configuracin avanzada de virtualizacin (opcin estndar).

Utilizando el asistente
Para lanzar el asistente de virtualizacin, vaya al segundo paso del Asisten de Procesos de Bizagi Studio ( M o d elo d e d ato s)

452

Copyright 2013 - Bizagi

Mientras se realiza el diseo del modelo de datos del proceso, usted tiene la opcin de incluir entidades virtualizadas en el diagrama. Estas entidades sern creadas como entidades de tipo paramtricas.

Antes de utilizar el Asisten para la Virtualizacin, se recomienda revisar el tipo de datos soportados para las conexiones entre Bizagi y bases de datos SQL Server u Oracle.

Qu se necesita hacer?
Para configurar la virtualizacin es necesario realizar: 1. Definir la informacin del sistema donde se encuentra la fuente de datos externa. Esto se realiza para registrar la integracin como sistema utilizado en el proyecto de Bizagi. 2. Ingrese la informacin para el Proveedor de datos.

Copyright 2013 - Bizagi

453

Detalles que requiere la conexin a la fuente de datos externa. 3. Seleccione cuales tablas o vistas ha virtualizar. 4. Defina filtros adicionales para las tablas o vistas ha virtualizar. 5. Defina un esquema de Replicacin. Una vez se ha terminado la configuracin, podemos correr una importacin inicial para las tablas o vistas seleccionadas, de esta forma, podemos verificar que la configuracin realizada fue exitosa (punto de chequeo).

Ejemplo
En el siguiente ejemplo, vamos a virtualizar las siguientes tablas desde una base de datos SQL Server: Clien te y P ro d u cto . Ambas tablas sern creadas automticamente en Bizagi como Entidades Maestras. Para ilustrar esta configuracin, vamos a ejecutar el Asistente de Virtualizacin de Entidades desde el paso dos del Asistente del Proceso.

1. Defina la informacin del sistema donde se encuentra la fuente de datos externa. En la ventana Sistem a, seleccione N u ev o de la lista desplegable. Ingrese un nombre para el sistema externo ( N o m b re d el sistem a), este nombre representar el sistema externo dentro del proyecto Bizagi. En futuras virtualizaciones, tendr la opcin de escoger un sistema existente (configurado anteriormente) desde la lista desplegable de sistemas. Ingrese le N o m b re Visu al y la Descrip ci n , luego de clic en Sig u ien te.

454

Copyright 2013 - Bizagi

Observe que usted tambin debera ingresar detalles para este nuevo sistema tales como: N o m b re d el Sistem a, N o m b re d e m o strar y Descrip ci n . En posteriores configuraciones de Virtualizacin, usted podr seleccionar en una lista deplegable, un sistema existente (configurado previamente) D clic en Sig u ien te. 2. Ingrese los detalles para el Proveedor de Datos En la ventada de P ro v eed o r, seleccione N u ev o desde la lista desplegable de Seleccionar Proveedor. En posteriores configuraciones de Virtualizacin, usted tendr la opcin de seleccionar sistemas existentes (configurados previamente) desde esta lista. Ingrese el N o m b re d el P ro v eed o r, el cul debe ser un nombre nico que identifique a este Proveedor de Datos especfico (necesario cuando usted registra mas de una fuente externa en su proyecto) Defina su fuente de datos externa: SQ L Serv er u O racle.

Copyright 2013 - Bizagi

455

Luego, si la fuente de datos externa es SQL Server ingrese la siguiente informacin: Servidor: Nombre del servidor de base de datos que contiene la instancia SQL Server. Nombre base de datos: Nombre de la base de datos donde las tablas o vistas sern replicadas. Usuario: Nombre del usuario para iniciar sesin en la base de datos. Es importante mencionar que la cuenta debe tener permisos de lectura para acceder a las tablas o vistas de la replicacin. Contrasea: Contrasea para el usuario de la base de datos. De lo contrario, si la fuente de datos externa es Oracle ingrese la siguiente informacin: Servicio: El texto de conexin con la instancia del servicio Oracle. Debe ser definido como nombre_del_servidor:puerto/nombre_de_la_instancia. Note que por defecto el puerto para las instancias de Oracle es 1521. Esquema: El nombre del esquema del usuario. Contrasea: Contrasea para el esquema. Clic en Sig u ien te.

456

Copyright 2013 - Bizagi

3. Seleccione las tablas o vistas que van a ser virtualizadas. Una vez ha definido los detalles de la conexin con la fuente de datos externa, Bizagi buscar y mostrar las tablas y vistas disponibles en la fuente. Extienda el nodo TA B LA S para mostrar la lista de tablas en la fuente de datos externa. Seleccione la o las tablas que va a virtualizar. En nuestro ejemplo, vamos a marcar Clien te y P ro d u cto . Clic en Sig u ien te. Nota: Cuando seleccione ms de una tabla o vista, Bizagi automticamente crear la relacin (atributo de referencia), si las tablas tienen una relacin explicita definida en la fuente.

Copyright 2013 - Bizagi

457

4. Defina filtros para las tablas o vistas (opcional).

Una vez haya seleccionado las tablas o vistas a virtualizar, usted puede definir filtros, de forma que Bizagi descarte algunos registros. Por ejemplo, usted puede definir que no quiere traer registros de Clien tes con un cierto tipo de C d ig o d e clasificaci n .

458

Copyright 2013 - Bizagi

Si usted define un filtro, este debera ser probado utilizando el botn P ro b ar F iltro d e F u en te Nota: Tenga en cuenta que esta opcin debera ser utilizada cuidadosamente cuando se tiene un gran nmero de registros en la fuente, ya que consultar y retornar esto valores podra tomar algn tiempo. El mnimo nmero de conexiones activas para la fuente de Base de datos, es la mejor estrategia para asegurar un desempeo ptimo.

Copyright 2013 - Bizagi

459

D clic en Sig u ien te. Bizagi crear las entidades y las componentes de configuracin necesarios.

460

Copyright 2013 - Bizagi

D clic en F in alizar cuando termine la configuracin.

Copyright 2013 - Bizagi

461

Verificar virtualizacin (Punto de chequeo)

Una vez la virtualizacin ha sido configurada, usted puede verificar si se han sincronizado de forma apropiada las entidades maestras con las tablas externas. Tenga en cuenta que con la Virtualizacin, los procesos en Bizagi acceden a informacin almacenada en diferentes fuentes de datos en tiempo de ejecucin. Esta funcionalidad es transparente para los usuarios del Portal de Trabajo; por lo que usted necesita verificar que la virtualizacin funcione de forma adecuada. Esto se realiza verificando en la forma de la actividad donde se utiliza la informacin de las entidades virtualizadas. Adicionalmente, verifique de forma explicita los valores que se estn sincronizando con la fuente. Usted puede ver los valores en la entidad especifica a travs del modulo entidades (disponible para el ambiente de desarrollo).

Consideraciones para la edicin Enterprise JEE

Para configurar la Virtualizacin en los ambientes de produccin o Test cuando se utiliza JEE Application Server (aplica para la versin Enterprise JEE de Bizagi), es necesario un paso adicional. El requerimiento adicional es configurar la fuente de datos externa con las especificaciones de JEE

462

Copyright 2013 - Bizagi

Application Server. Para llevar a cabo este paso, su JEE Application server ya debe estar configurado para trabajar con Bizagi. Tenga en cuenta que este paso solamente se necesita en los ambientes diferentes al de desarrollo (para los otros ambientes no se necesitan pasos adicionales porque Bizagi Studio configura automticamente la fuente externa con JBoss 7.1.1 Application Server). Para ms informacin sobre la configuracin de requerimientos en los ambientes de pruebas o produccin, visite Cmo configurar Virtualizacin y Replicacin en JEE Application server? Nota Adicionalmente, si usted configura una Replicacin o Virtualizacin con una instancia de SQL server la cual no est configurada para iniciar en el puerto por defecto (1433), es necesario realizar algunos pasos adicionales. Los requerimientos adicionales es realizar la configuracin de "SQLServerDBPort" de forma apropiada para el proveedor.

3.3.5.2.3 Utilizar la configuracin avanzada de Virtualizacin

Informacin general
Bizagi presenta el Asistente de Virtualizacin en cual le ayudar en la configuracin de la conexin de una base datos externa SQL Server u Oracle (y crear los componentes necesarios). Sin embargo, en escenarios ms sofisticados, usted desear utilizar la opcin de Configuracin Estndar (Avanzado), la cual es otra alternativa para realizar una Virtualizacin en su proyecto. Estos escenarios se refieren principalmente a: El uso de fuente de datos que no es SQL Server u Oracle (mediante replicacin personalizada). Los requerimientos para configuracin avanzada (por ejemplo, querer utilizar una columna de Oracle que no es soportada). Necesidad de ajustes manuales en la configuracin. Esto puede pasar en escenarios sofisticados donde tiene todo un conjunto de tablas que estn relacionadas entre ellas. Esto puede involucrar relaciones entre entidades virtuales, por lo que la configuracin requiere que todas las tablas sean replicadas y virtualizadas teniendo en cuenta algunas consideraciones. El siguiente artculo ilustra cmo configurar un Virtualizacin en Bizagi utilizando las opciones Standard (Avanzadas) Si desea ms informacin y un ejemplo sobre virtualizacin a mySQL visite Virtualizacin Personalizada.

Tenga en cuenta que solamente la versin de Bizagi Enterprise .NET soporta cualquier motor de base de datos.

Copyright 2013 - Bizagi

463

Utilizando las opciones Estndar (Configuracin Avanzada)

Para configurar la Virtualizacin a travs de la configuracin Avanzada, asegrese que ya ha creado las entidades maestras que necesita y sus atributos (para almacenar los valores de las variables entrantes de la base de datos externa). Para ms informacin sobre crear entidades en Bizagi, visite Cmo crear un modelo de datos? Note que las entidades creadas en Bizagi deben tener una estructura similar a la estructura de aquellas en la fuente de datos externa (por ejemplo, los tipos de datos que almacenan los valores de las columnas en las tablas externas). Para utilizar las opciones Avanzadas para virtualizacin vaya a la vista de mdulos en Bizagi Studio y seleccione la opcin Sistem a.

Qu necesita hacer?

464

Copyright 2013 - Bizagi

Para realizar la configuracin de la Virtualizacin a travs de las opciones Estndar realice los siguientes pasos: 1. Crear las entidades en Bizagi con sus atributos pata igualar con la informacin de la fuente. La creacin de las entidades se realiza en el segundo paso del asistente Modelar Datos. 2. Definir el sistema. Definir la informacin para el sistema donde se encuentra la fuente de datos externa. 3. Definir el Proveedor. Especificar detalles por el Proveedor (conexin con la informacin de la fuente de datos externos). 4. Registrar la clase de virtualizacin (el componente que tiene la implementacin) Este paso es realizado automticamente por Bizagi en la edicin Xpress; sin embargo en la Edicin Enterprise de Bizagi necesitamos definir explcitamente si vamos a utilizar una implementacin personalizada. 5. Incluir Entidades maestras para la Virtualizacin Incluir las entidades maestras que van a ser virtualizadas para esta conexin una por una cada (Proveedor) y de un esquema de Replicacin. 6. Emparejando atributos en Bizagi con las columnas de la fuente. Mapee cada uno de los atributos de la entidad replicada con la columna correspondiente de la fuente. 7. Utilizando las opciones de configuracin adicional Finalmente, existe la posibilidad de utilizar opciones adicionales para la configuracin de cada entidad virtualizada, por ejemplo, definir filtros para los registros entrantes de la tabla externa, indicando si un atributo (columna) de la entidad debe ser ignorado. Una vez se haya realizado los pasos de la configuracin, tenemos que ejecutar una importacin inicial de las tablas o vistas, de esa forma podemos probar que la integracin se cre correctamente (punto de control).

Ejemplo
En este ejemplo, vamos a virtualizar las tablas Em p lead o y O rd en d e Co m p ra de la base de datos So u th w in d de Oracle

Copyright 2013 - Bizagi

465

Our first step is to ensure that these tables have been previously created in Bizagi as Master Entities.

1. Crear las entidades en Bizagi con sus atributos pata igualar con la informacin de la fuente. Vamos a crear las entidades maestras Em p lead o s y O rd en d e Co m p ra en Bizagi. Entidad Em p lead o s y sus atributos en Bizagi:

Entidad O rd en d e co m p ra y sus atributos en Bizagi:

466

Copyright 2013 - Bizagi

2. Definir el sistema Para definir el sistema a utilizar en la integracin, de clic derecho en Sistem a y seleccione la opcin N u ev o Sistem a.

En la ventana de N u ev o Sistem a, debe definir la informacin del sistema donde se encuentra la fuente de datos externa. Ingrese los detalles para el nuevo sistema: N o m b re, N o m b re Visu al y Descrip ci n .

Copyright 2013 - Bizagi

467

Asegrese de que la opcin P erm itir En tid ad es Virtu ales y Rep licaci n este seleccionada. Clic en O K.

3. Definir proveedor Una vez haya definido y creado el nuevo sistema en Bizagi, vamos a ingresar los detalles del proveedor utilizando en la configuracin para este sistema y para la Virtualizacin. Para realizar esto, clic derecho en el nodo de P ro v eed o r ubicado en el sistema recin creado, y seleccione la opcin N u ev o P ro v eed o r.

468

Copyright 2013 - Bizagi

En la pestaa de co n fig u raci n d el P ro v eed o r, ingrese los detalles del nuevo proveedor: Nombre, N o m b re Visu al y Descrip ci n . Asegrese de marcar la opcin P erm itir Rep licaci n p ara el p ro v eed o r.

Copyright 2013 - Bizagi

469

Luego, en la pestaa P ro p ied ad es d e d esarro llo d el P ro v eed o r de clic en el botn O LEDB Co n fig . Note que puede establer diferentes valores para los diferentes ambientes del proyecto (desarrollo, Test y produccin). En el siguiente ejemplo, vamos a establer las propiedades para el ambiente de desarrollo.

Luego, si la fuente de datos externa es SQL Server ingrese la siguiente informacin:

470

Copyright 2013 - Bizagi

Servidor: Nombre del servidor de base de datos que contiene la instancia SQL Server. Nombre base de datos: Nombre de la base de datos donde las tablas o vistas sern replicadas. Usuario: Nombre del usuario para iniciar sesin en la base de datos. Es importante mencionar que la cuenta debe tener permisos de lectura para acceder a las tablas o vistas de la replicacin. Contrasea: contrasea para el usuario de la base de datos.

Por otro lado, si la fuente de datos externa es Oracle ingrese la siguiente informacin: Servicio: El texto de conexin con la instancia del servicio Oracle. Debe ser definido como nombre_del_servidor: puerto/nombre_de_la_instancia. Note que por defecto el puerto para las instancias de Oracle es 1521. Esquema: El nombre del esquema del usuario. Contrasea: Contrasea para el esquema. Para este ejemplo, vamos a ilustrar la configuracin de la virtualizacin con una fuente de datos externa en Oracle. En la ventana de configuracin virtual de la base de datos, se ingresa el nombre del servicio de red, nombre de usuario y contrasea.

Copyright 2013 - Bizagi

471

Clic en O K para guardar la coneccin. De nuevo, clic en O K para regresar a la ventana de Nuevo proveedor. Nota: Tenga en cuenta que es necesario definir las propiedades y valores de coneccin para la integracin en los diferentes ambientes (desarrollo, Test y produccin). Sin embargo, la definicin de los ambientes de Test y de produccin solo se puede realizar antes de realizar deployment del sistema y del proveedor al ambiente determinado. La edicin de las valores en Test o en produccin debe realizarce luego del primer deployment utilizando el Management Console. 4. Registrar la clase de virtualizacin El siguiente paso es crear la clase de virtualizacin en Bizagi, la cual puede ser definida utilizando los componentes que Bizagi trae por defecto (Implementacin de clase), o usar un componente personalizado (por ejemplo, conectar con mySQL, Postgres, DB2, etc). Si se esta utilizando Bizagi Xpress, este paso lo realiza Bizagi de forma automtica y no necesita realizar lo que se menciona a continuacin. Note que la posibilidad de incluir un componente personalizado est disponible para la edicin de Bizagi, por lo que es necesario definir si vamos a utilizar una implementacin personalizada. En el siguiente ejemplo, vamos a usar los componentes que Bizagi tiene por defecto. Para definir la Clase de Entidad de Virtualizacin de clic derecho sobre el nodo de Entidades Virtualizadas y seleccione la opcin N u ev a clase d e Virtu alizaci n . Deje los valores que trae por defecto y de clic en O k.

472

Copyright 2013 - Bizagi

5. Incluir entidades maestras para la virtualizacin. Ahora vamos a incluir las entidades maestras de Bizagi para emparejarlas con las tablas de la base de datos externa. Para realizar esto, incluya una por una las tablas maestras que se van a virtualizar con el proveedor de datos. Por ejemplo, agregu la entidad Orden de Compra y emparjela con la tabla Orden de la fuente. De clic derecho en la nueva clase virtualizada y seleccione la opcin A d icio n ar En tid ad a v irtu alizaci n .

Copyright 2013 - Bizagi

473

En este paso, adems de definir la tabla desde la fuente, tambin puede definir cual de las columnas de la fuente debe ser tomada como llave de negocio para los valores de la entidad. Nota: La llave de negocio debe corresponder a la llave primaria de la tabla de la fuente. Realice esto para cada Entidad Maestra (Empleado y Orden de Compra de nuestro ejemplo). La tabla O rd en se debe mapear para la Virtualizacin (Adicionada como la entidad O rd en d e co m p ra )

474

Copyright 2013 - Bizagi

La tabla Em p lead o se debe mapear para la Virtualizacin (Adicionada como la entidad Em p lead o ):

Copyright 2013 - Bizagi

475

En la misma ventana donde se adicionan entidades para la Virtualizacin, usted puede definir ajustes adicionales del cach: Entidad: Entidad a virtualizar. Fuente externa: Tabla o vista en la fuente a ser virtualizado. Llave de negocio: Atributo o atributos que forman la llave primaria para la tabla o vista. Utilizando el botn >>, seleccione de la lista a mano derecha la definicin de los valores de la llave de negocio.

6. Emparejando atributos en Bizagi con las columnas de la fuente Una vez se ha incluido entidades a la Virtualizacin, estas se encontrarn nombradas en la opcin proveedores. Dando clic en una entidad especifica (en nuestro ejemplo, es necesario realizar esto por cada una de las dos entidades maestras), en el panel del lado derecho se presentarn los atributos actuales de las tablas. Enlace cada atributo de la entidad replicada con su correspondiente columna en la fuente dando clic derecho en el atributo y seleccionado la opcin P ro p ied ad es.

En la ventana de Editar Atributo, ingrese el nombre de la columna de la Fuente Externa que ser pareja de un atributo de Bizagi. Por el c d ig o del empleado, ingresamos IDEm p lead o .

Repita este paso para todos los atributos de cada entidad virtualizada. Atributos configurados para Em p lead o s:

476

Copyright 2013 - Bizagi

Atributos configurados para O rd en d e co m p ra:

Si existe algn atributo que no debe ser considerado en la Virtualizacin, lea la siguiente seccin articulo. Note que todos los atributos que necesitan informacin sobre su pareja han sido listados en la propiedad F u en te Ex tern a. En este punto, hemos completado la configuracin de la Virtualizacin a travs de las opciones estndar (para administracin avanzadas). Usted puede utilizar opciones de configuracin adicional cmo se muestra en la siguiente seccin y verificar que los valores de las entidades maestras se sincronicen de forma adecuada. 7. Opciones adicionales de configuracin Finalmente, existe la posibilidad de utilizar opciones adicionales para configurar cada entidad virtualizada, por ejemplo: Definir filtros por registro en las tablas que se van a replicar, definir si un atributo (columna) de la entidad no se debe tener en cuenta, etc. Clic para ms informacin sobre configuracin avanzada

Verificar virtualizacin (Punto de chequeo)

Una vez la virtualizacin ha sido configurada, usted puede verificar si se ha sincronizado de forma apropiada las entidades maestras con las tablas externas. Tenga en cuenta que con la Virtualizacin, los procesos en Bizagi acceden a informacin almacenada en diferentes fuentes de datos en tiempo de ejecucin.

Copyright 2013 - Bizagi

477

Esta funcionalidad es transparente para los usuarios del Portal de Trabajo; por lo que usted necesita verificar que la virtualizacin funcione de forma adecuada. Esto se realiza verificando en la forma de la actividad donde se utiliza la informacin de las entidades virtualizadas. Adicionalmente, verifique de forma explicita los valores que se estn sincronizando con la fuente. Usted puede ver los valores en la entidad especifica a travs del modulo entidades (disponible para el ambiente de desarrollo).

3.3.5.2.3.1 Personalizar la Virtualizacin

Bizagi presenta el Asistente el cual le ayudar en la configuracin de la conexin de una base datos externa SQL Server u Oracle (para integracin a nivel de datos). Para otra fuente de datos diferente a SQL Server y Oracle, se puede sobrescribir los mtodos y clases utilizado por Bizagi en la virtualizacin.

Qu se debe hacer?
Para poder utilizar la Virtualizacin de Bizagi con una fuente de datos externa diferente a SQL Server u Oracle se debe seguir los siguientes pasos: 1. Crear una librera de Virtualizacin A travs de una librera personalizada, usted podr sobrescribir las clases y mtodos de la virtualizacin de Bizagi (como se describe en la siguiente seccin: So b rescrib ir d e m to d o s y clases). 2. Configurar el proveedor de datos de Bizagi para utilizarlo en la librera personalizada de Virtualizacin. Esta configuracin utiliza la configuracin estndar de Bizagi para virtualizaciones.

Sobrescribir de Clases y Mtodos

Para personalizar la virtualizacin de Bizagi, es necesario desarrollar un componente que implemente las interfaces: IP ro v id erVirtu alDA 2 IEn tity Virtu alDA IP aram eter IDatab aseCo n stan ts

Bizagi separa la operacin de conectar, desconectar y administracin transaccional de la operacin de la bsqueda de datos desde el proveedor de datos externos y de las interfaces de la entidad. Es

478

Copyright 2013 - Bizagi

decir, cuando se crea una librera de virtualizacin personalizada, Bizagi sigue las mejores prcticas para la gestin y diseo de la implementacin.

Interfaz del proveedor: IProviderVirtualDA2 La clase que invoca la interfaz debe contener los siguientes mtodos: void Init (HybridDictionary htMetadata): A cargo de tomar la informacin suministrada, como el nombre del servidor, el nombre de la base de datos, usuario, contrasea, etc. La clase recibe el objeto HybridDictionary, el cual contiene los datos configurados como metadata del sistema. void OpenConnection(): Este mtodo es utilizado para realizar la conexin con el sistema externo. En el caso de una base de datos, el mtodo construye los enlaces de la conexin y abre la conexin con el repositorio. void CloseConnection(): A cargo de cerrar la conexin con el sistema de datos externos. void BeginTransaction(): A cargo de iniciar una nueva transaccin para la operacin actual del sistema. void Commit(): Realizar commit de la transaccin actual en el sistema de referencia. void Rollback(): Realizar un rollback (regresar al estado inicial) de la transaccin actual del sistema de referencia. DataSet RunQuery(string sQuery, string sTableName): Este mtodo se utiliza desde las formas para ejecutar la consultar en la fuente. void ClearParameters(): A cargo de limpiar el arreglo que contenga parmetros de una anterior invocacin. void AddParameter(Vision.DA.IParameter oParameter ): A cargo de cargar un parmetro para la invocacin. Vision.DA.IParameter CreateParameterObject (string sParameterName, Vision.Defs.EDataType eDataType, int iSize, object oValue): A cargo de crear el objeto que contiene los parmetros.

Interfaz de la entidad: IEntityVirtualDA Bizagi construye las consultas. Para ello, debe necesariamente definir todas las constantes que se usan en la sintaxis del motor de la Base de datos. Por ejemplo: en private readonly string m_sConcatSymbol, debe definir el smbolo que se utilizar para la concatenacin en las sentencias SQL.

void Init(IProviderVirtualDA objProvider, HybridDictionary htMetadata): Inicializar la conexin con el sistema. Los parmetros necesarios para establecer la conexin con el sistema son configurados como metadata del sistema. Parmetros obj Provider Descripcin Permite convertir el objeto que invoca la interfaz IProviderVirtualDA. Contiene la informacin requerida en forma de metada para

htMetadata

Copyright 2013 - Bizagi

479

establecer la conexin con el sistema configurado.

DataSet GetEntity(string sEntSource, string[] arrsColList): Utilizado como consulta de los valores de la fuente de datos externa. Esto es equivalente a realizar una consulta en los campos del objeto sin tener que aplicar filtros. Parmetros sEntSource arrsColList Descripcin Nombre de la tabla a replicar en la fuente de datos Arreglo que contiene el nombre de las columnas de la consulta en la fuente de datos. Un DataSet con los valores de la entidad.

RETURNED DataSet

DataSet GetEntityInstance(string sEntSource, string[] arrsKeyColumns, object[] arroKeyValues, string [] arrsColList): Toma datos de una instancia de la entidad (valores) de la tabla correspondiente a un ID especificado. Parmetros sEntSource arrsKeyColumns Descripcin Tabla donde la entidad es implementada. Arreglo que contiene los nombres de la columna a ser utilizada para filtrar los registros. Arreglo que contiene los valores a ser utilizados como filtros para la bsqueda de un registro. Arreglo que contiene el nombre de las columnas a ser consultadas. Un conjunto de datos con valores para la entidad.

arroKeyValues

arrsColList

RETURNED DataSet

DataSet GetEntityInstancesTable(string sEntSource, string[] arrsKeyColumns, string[] arrsColList, string sFilterText, bool bFillSchema, int iTopReturnRows) Parmetros sEntSource arrsKeyColumns arrsColList sFilterText Descripcin Tabla donde se localiza la entidad. Arreglo de columnas utilizadas como llaves. Columnas a ser incluida en la lista. Filtros para ser aplicados en bsqueda de entidades con la clausula o condicin WHERE (donde) Verdadero si la informacin del esquema debe ser

bFillSchema

480

Copyright 2013 - Bizagi

retornada de la base, falso de lo contrario. iTopReturnRows RETURNED DataSet Nmero de registros a ser regresados. Un conjunto de datos con valores para la entidad

Object GetAttributeValue(string sEntSource, string[] arrsKeyColumns, object[] arroKeyValues, string sAttrSource) Parmetros sEntSource arrsKeyColumns arroKeyValues sAttrSource RETURNED Object Descripcin Tabla donde se implementa la entidad. Arreglo de columnas utilizadas como llaves. Valores de las columnas utilizados como llaves. Columna de variables a regresar. Los valores de los atributos.

bool ExistsEntityInstance(string sEntSource, string[] arrsKeyColumns, object[] arroKeyValues) Parmetros sEntSource arrsKeyColumns arroKeyValues arrsColList Descripcin Tabla donde se implementa la entidad. Arreglo de columnas utilizadas como llaves. Valores de las columnas utilizados como llaves. Arreglo que contiene le nombre de las columnas a ser consultadas. Verdadero si la instancia fue encontrada, falso de lo contrario.

RETURNED bool

int ExistsEntityInstance(string sEntSource, string sColumn, object oValue, string[] arrsKeyColumns, object[] arroKeyValues) Parmetros sEntSource sColumn oValue arrsKeyColumns arroKeyValues Descripcin Tabla donde se implementa la entidad. Columna utilizada para encontrar la instancia. Valores utilizados para encontrar una instancia. Arreglo de columnas utilizadas como llave. Arreglo de los valores de las columnas utilizadas como llave.

Copyright 2013 - Bizagi

481

RETURNED int

Debe retornar, 1 si la instancia fue encontrada 0 sino.

Hashtable AddEntity(string sEntSource, Hashtable htAddCols, string[] arrsKeyColumns, object[] arroKeyValues, string[] arrsAutoColumns): Adiciona una nueva instancia (valores). Parmetros sEntSource htAddCols arrsKeyColumns arroKeyValues arrsAutoColumns RETURNED Hashtable Descripcin Tabla donde se implementa la entidad Lista de columnas para incluir valores. Arreglo de columnas utilizadas como llave. Arreglo de los valores de las columnas utilizadas como llave. Arreglo de columnas auto-numeric Debe regresar a HashTable que contiene el nombre de la columna emparejada con el valor incluido.

Hashtable UpdateEntity(string sEntSource, string[] arrsKeyColumns, object[] arroKeyValues, Hashtable htUpdateCols, string[] arrsAutoColumns): Actualiza la informacin de una instancia de la entidad (valores) en la base de datos y registra la actualizacin. Parmetros sEntSource arrsKeyColumns arroKeyValues htUpdateCols Descripcin Tabla donde se implementa la entidad Arreglo de columnas utilizadas como llave. Arreglo de los valores de las columnas utilizadas como llave. Hastable que contiene las columnas a ser actualizadas, con los valores de sus parejas. Arreglo de columnas auto-numeric Debe regresar a HashTable que contiene el nombre de la columna y el valor que fue incluido.

arrsAutoColumns RETURNED Hashtable

bool DeleteEntity(string sEntSource, string[] arrsKeyColumns, object[] arroKeyValues): Elimina un registro de la base de datos. Parmetros sEntSource arrsKeyColumns arroKeyValues Descripcin Tabla donde se implementa la entidad Arreglo de columnas utilizadas como llave. Arreglo de los valores de las columnas utilizadas como llave.

482

Copyright 2013 - Bizagi

RETURNED bool

Debe regresar verdadero si el registro fue borrado, y Falso de lo contrario.

Interfaces de constantes: IParameter, IDatabaseConstants Bizagi construye las consultas. Para ello, defina constantes para las consultas en el motor de la Base de datos especfica en estas interfaces. Por ejemplo: private readonly string m_sConcatSymbol, como el smbolo que se utilizar para la concatenacin en las sentencias SQL.

Ejemplo
En el ejemplo, vamos a configurar una virtualizacin personalizada para un motor de base de datos MySQL. Vamos a presentar un ejemplo de las clases de virtualizacin que implementan las interfaces "IProviderVirtualDA2" y "IEntityVirtualDA". Nota Tenga en cuenta que el siguiente cdigo ilustra la implementacin del mtodo "GetEntity()" (para servir como una gua), sin embargo otros mtodos no son incluidos y podra necesitar otro un mayor desarrollo.

Crear una librera de replicacin

En este ejemplo especfico, para poder implementar las clases de replicacin que conecten la base de datos MySQL, primero se debe descargar e instalar el componente MySQL Connector/NET para realizar la conexin. Para el ejemplo, las siguientes clases fueron desarrolladas utilizando Microsoft Visual Studio. A travs de este proyecto .NET se hace referencia a la librera MySql.Data.dll, la cual debi ser instalado por el componente MySQL Connector/Net ya que es necesario. Tambin es necesario hacer referencia a la libreras: BizAgi.EntityManager.Interfaces.IEntityDA.dll BizAgi.Defs.dll Vision.DA.dll Vision.Defs.dll Estas se encuentran en la carpeta bin dentro de la carpeta de la aplicacin del proyecto (por defecto en "C:\Bizagi\Enterprise\Projects\[PROJECT_NAME]\WebApplication\bin\").

Copyright 2013 - Bizagi

483

Class Interface IProviderVirtualDA2 using System; using System.Data; using System.Collections.Specialized; using MySql.Data.MySqlClient; using BizAgi.EntityManager.Interfaces; using Vision.DA; using System.Collections.Generic; using System.Collections; using System.Data.SqlClient; using System.Text; namespace BizagiMySQL { public class CMySQLProvider : IProviderVirtualDA2 { protected protected protected //--- The procedure protected HybridDictionary m_htMetadata; MySqlConnection MySqlconn; bool bDisposed; array used to store the parameters to a stored List<CMySqlParameter> m_alParams;

public CMySQLProvider() { bDisposed = false; MySqlconn = null; m_alParams = new List<CMySqlParameter>(); } #region IProviderVirtualDA2 Members void IProviderVirtualDA2.AddParameter(string sParameterName,

484

Copyright 2013 - Bizagi

Vision.Defs.EDataType eDataType, int iSize, byte iPrecision, byte iScale, object oValue, Vision.Defs.EParamDirection eDirection) { throw new NotImplementedException(); } void IProviderVirtualDA2.AddParameter(string sParameterName, Vision.Defs.EDataType eDataType, int iSize, object oValue, Vision.Defs.EParamDirection eDirection) { throw new NotImplementedException(); } void IProviderVirtualDA2.AddParameter(string sParameterName, Vision.Defs.EDataType eDataType, int iSize, bool bNullValue, object oValue) { throw new NotImplementedException(); } void IProviderVirtualDA2.AddParameter(string sParameterName, Vision.Defs.EDataType eDataType, int iSize, object oValue) { m_alParams.Add(new CMySqlParameter(sParameterName, eDataType, iSize, oValue)); } void IProviderVirtualDA2.AddParameter(string sParameterName, object oValue) { throw new NotImplementedException(); } void oParameter) { } void { } Vision.DA.IParameter IProviderVirtualDA2.CreateParameterObject (string sParameterName, Vision.Defs.EDataType eDataType, int iSize, byte iPrecision, byte iScale, string sSourceColumn, bool bUseCurrentSourceColumnValue) { throw new NotImplementedException(); } Vision.DA.IParameter IProviderVirtualDA2.CreateParameterObject (string sParameterName, Vision.Defs.EDataType eDataType, int iSize, byte IProviderVirtualDA2.ClearParameters() m_alParams.Clear(); IProviderVirtualDA2.AddParameter(Vision.DA.IParameter

throw new NotImplementedException();

Copyright 2013 - Bizagi

485

iPrecision, byte iScale, object oValue, Vision.Defs.EParamDirection eDirection) { throw new NotImplementedException(); } Vision.DA.IParameter IProviderVirtualDA2.CreateParameterObject (string sParameterName, Vision.Defs.EDataType eDataType, int iSize, object oValue) { throw new NotImplementedException(); } Vision.DA.IDatabaseConstants IProviderVirtualDA2.DatabaseProperties { get { return CMySqlDatabaseConstants.Instance; } } DataSet IProviderVirtualDA2.RunQuery(string sQuery, string sTableName) { MySqlCommand command = new MySqlCommand(); MySqlDataAdapter adapter = new MySqlDataAdapter(); DataSet ds = new DataSet(); command.Connection = this.getConnection(); command.CommandText = ReplaceQueryParameters(sQuery, m_alParams); command.CommandType = CommandType.Text; getParameters(command); adapter.SelectCommand = command; adapter.Fill(ds, sTableName); return ds; } private void getParameters(MySqlCommand oCmd) { //--- Get an enumerator for the parameter array list IEnumerator oEnumerator = m_alParams.GetEnumerator(); //--- Loop through the Parameters in the ArrayList while (oEnumerator.MoveNext()) { //--- Add the SQLParameter object to the SQLCommand object oCmd.Parameters.Add(ConvertParameterToMySqlParameter ((CMySqlParameter)oEnumerator.Current)); } }

486

Copyright 2013 - Bizagi

private MySqlParameter ConvertParameterToMySqlParameter (CMySqlParameter oP) { MySqlDbType dbType = (oP.DataType.Equals (MySqlDbType.VarChar)) ? MySqlDbType.VarChar : (MySqlDbType)oP.DataType; //--- Instantiate a SqlParameter object MySqlParameter oMySqlParameter = new MySqlParameter (oP.ParameterName, dbType, oP.Size); oMySqlParameter.Value = oP.Value; oMySqlParameter.Direction = (ParameterDirection)oP.Direction; oMySqlParameter.Precision = oP.Precision; oMySqlParameter.Scale = oP.Scale; oMySqlParameter.SourceColumn = oP.SourceColumn; oMySqlParameter.SourceVersion = oP.UseCurrentSourceColumnValue ? DataRowVersion.Current : DataRowVersion.Original; return oMySqlParameter; }

/// <summary> /// Replace parameter in the form '?', by parametes in the form ': ParamName' /// </summary> /// <param name="sQuery"></param> /// <returns></returns> private static string ReplaceQueryParameters(string sQuery, List<CMySqlParameter> alParams) { if (alParams != null && alParams.Count > 0) { char cInter = '?', cQuote = '\'', cAt = '@', cColon = ':'; string sParamToken = ":"; bool bInQuote = false; // indicates if current character is in '' StringBuilder sbResp = new StringBuilder(); int _i = 0, _n = sQuery.Length, nNumParam = 0, nLastStrIndex = 0; while (_i < _n) { if (bInQuote) { if (sQuery[_i] == cQuote) { if ((_i + 1) < _n && sQuery[_i + 1] == cQuote) { // "...''..." case, already in quote _i += 2; }

Copyright 2013 - Bizagi

487

else { // "...'" case bInQuote = false; _i++; } } else { _i++; } } else { if (sQuery[_i] == cInter) { // "...?..." case if (nNumParam >= alParams.Count) { // parameter doesn't exists throw new ProviderException(string.Format ("Parameter {0} doesn't exists in command: '{1}'", nNumParam, sQuery)); } else { // get valid param name string sValidParamName = getValidParamName (((CMySqlParameter)alParams[nNumParam]).ParameterName, alParams, nNumParam - 1); ((CMySqlParameter)alParams[nNumParam]) .ParameterName = sValidParamName; // replace parameter by name sbResp.Append(sQuery.Substring (nLastStrIndex, _i - nLastStrIndex)); sbResp.Append(sParamToken + sValidParamName); nLastStrIndex = _i + 1; nNumParam++; } } else if (sQuery[_i] == cAt) { // replace parameter by name sbResp.Append(sQuery.Substring(nLastStrIndex, _i - nLastStrIndex)); sbResp.Append(cInter); nLastStrIndex = _i + 1; nNumParam++; } else if (sQuery[_i] == cQuote)

488

Copyright 2013 - Bizagi

{ // "'..." case bInQuote = true; } _i++; } } sbResp.Append(sQuery.Substring(nLastStrIndex, _n nLastStrIndex)); return sbResp.ToString(); } return sQuery; }

/// <summary> /// Gets a valid parameter name, unique for first iMaxParamIndex parameters /// </summary> /// <param name="sParamName"></param> /// <param name="alParams"></param> /// <param name="iMaxParamIndex"></param> /// <returns></returns> private static string getValidParamName(string sParamName, List<CMySqlParameter> alParams, int iMaxParamIndex) { int _iMaxDbIdLength = CMySqlDatabaseConstants.Instance.MaxDbIdLength; string sResp = (_iMaxDbIdLength < sParamName.Length) ? sParamName.Substring(0, _iMaxDbIdLength) : sParamName; int iSuffix = 1; while (IndexOfParam(sResp, alParams, iMaxParamIndex) != -1) { // find an unique name string sSuffix = iSuffix.ToString(); sResp = (_iMaxDbIdLength - sSuffix.Length < sParamName.Length) ? sParamName.Substring(0, _iMaxDbIdLength sSuffix.Length) : sParamName; sResp += sSuffix; iSuffix++; } return sResp; } private static int IndexOfParam(string sParamName, List<CMySqlParameter> alParams, int iMaxParamIndex) { int _i = 0, _n = iMaxParamIndex; while (_i < _n) { if (((CMySqlParameter)alParams[_i]).ParameterName == sParamName) {

Copyright 2013 - Bizagi

489

_n = _i; } else { _i++; } } return (_n == iMaxParamIndex) ? -1 : _n; }

#endregion #region IProviderVirtualDA Members void { } void { IProviderVirtualDA.CloseConnection() if (MySqlconn != null) MySqlconn.Close(); MySqlconn = null; } void { } void { } void { IProviderVirtualDA.OpenConnection() IProviderVirtualDA.Init(HybridDictionary htMetadata) m_htMetadata = htMetadata; IProviderVirtualDA.Commit() IProviderVirtualDA.BeginTransaction() throw new NotImplementedException();

if (MySqlconn == null) { // Verificar que los campos de la metadata esten correctamente diligenciados if (!m_htMetadata.Contains("Server") || !m_htMetadata.Contains("Database") || !m_htMetadata.Contains("Username") || !m_htMetadata.Contains("Password")) { throw new CEntityClassInterfaceException("Incomplete metadata: connection parameters missing"); } else

490

Copyright 2013 - Bizagi

{ // construir la cadena de conexion con los datos que se reciben string sConn; string sServer = m_htMetadata["Server"].ToString(); string sDatabase = m_htMetadata["Database"].ToString(); string sUsername = m_htMetadata["Username"].ToString(); string sPassword = m_htMetadata["Password"].ToString(); sConn = "Server=" + sServer + ";Database=" + sDatabase + ";Uid=" + sUsername + ";Pwd=" + sPassword + ";"; MySqlconn = new MySqlConnection(sConn); MySqlconn.Open(); } } } void { } #endregion #region IDisposable Members void { IDisposable.Dispose() if (!bDisposed) { // nunca se debe cerrar la conexin dentro de este mtodo!! bDisposed = true; } } #endregion public MySqlConnection getConnection() { return this.MySqlconn; } public DataSet executeMySQLQuery(string sSQL) { MySqlCommand command; MySqlDataAdapter adapter; DataSet ds = new DataSet(); command = new MySqlCommand(sSQL, this.getConnection()); adapter = new MySqlDataAdapter(command); adapter.Fill(ds); return ds; IProviderVirtualDA.Rollback()

Copyright 2013 - Bizagi

491

} public void executeNonQueryMySQL(string sSQL) { MySqlCommand command; command = new MySqlCommand(sSQL, this.getConnection()); command.ExecuteNonQuery(); } } }

Clase de la interfaz IEntityVirtualDA using System; using System.Data; using System.Data.OleDb; using System.Collections; using System.Collections.Specialized; using System.Text; using System.Xml; using MySql.Data.MySqlClient; using BizAgi.EntityManager.Interfaces; using BizAgi.Defs; namespace BizagiMySQL { public class CMySQLEntity : IEntityVirtualDA { /// <summary> /// Flag to show if object has been disposed /// </summary> protected bool m_bDisposed; /// <summary> /// Metadata used to initialize object, as collection of name-value pairs /// </summary> protected HybridDictionary m_htMetadata;

/// <summary> /// Connection with the virtual System /// </summary> protected CMySQLProvider m_objSystem;

public CMySQLEntity() { m_bDisposed = false;

492

Copyright 2013 - Bizagi

} #region IEntityVirtualDA Members public Hashtable AddEntity(string sEntSource, Hashtable htAddCols, string[] arrsKeyColumns, object[] arroKeyValues, string[] arrsAutoColumns) { Hashtable htResult = new Hashtable(); DataTable dtAutoAttribValues = new DataTable(); try { StringBuilder sbIntoList = new StringBuilder (htAddCols.Count * 10); StringBuilder sbValuesList = new StringBuilder (htAddCols.Count * 10);

// Columns to add foreach (DictionaryEntry oEntry in htAddCols) { // Builds INTO clause and VALUES clauses separately sbIntoList.Append(oEntry.Key); sbIntoList.Append(","); // Adds values as parameters sbValuesList.Append(","); sbIntoList.Append(oEntry.Value); } if (sbIntoList.Length == 0 || sbValuesList.Length == 0) { throw new CEntityClassInterfaceException("Nothing to insert."); } StringBuilder sbSQL = new StringBuilder(); StringBuilder sbSQLSelectCols = new StringBuilder(); // Inserts values in entity table sbSQL.Append("INSERT INTO "); sbSQL.Append(sEntSource); sbSQL.Append(" ( "); sbSQL.Append(sbIntoList.Remove(sbIntoList.Length - 1, 1) .ToString()); sbSQL.Append(" ) VALUES ( "); sbSQL.Append(sbValuesList.Remove(sbValuesList.Length - 1, 1).ToString()); sbSQL.Append(" ) ");

m_objSystem.executeNonQueryMySQL(sbSQL.ToString());

Copyright 2013 - Bizagi

493

return htResult; } catch (Exception e) { throw new ApplicationException(e.Message); } } public void Init(IProviderVirtualDA objProvider, HybridDictionary htMetadata) { m_objSystem = (CMySQLProvider)objProvider; m_htMetadata = htMetadata; } public bool DeleteEntity(string sEntSource, string[] arrsKeyColumns, object[] arroKeyValues) { return false; } public int ExistsEntityInstance(string sEntSource, string sColumn, object oValue, string[] arrsKeyColumns, object[] arroKeyValues) { try { StringBuilder sbSQL = new StringBuilder(); sbSQL.Append(" SELECT "); sbSQL.Append(string.Join(",", arrsKeyColumns)); sbSQL.Append(" FROM "); sbSQL.Append(sEntSource); sbSQL.Append(" WHERE "); sbSQL.Append(buildWhereClause(arrsKeyColumns, arroKeyValues)); DataSet ds = m_objSystem.executeMySQLQuery(sbSQL.ToString ()); return ds.Tables[0].Rows.Count; } catch (Exception e) { throw new ApplicationException(e.Message); } } bool BizAgi.EntityManager.Interfaces.IEntityVirtualDA.ExistsEntityInstance (string sEntSource, string[] arrsKeyColumns, object[] arroKeyValues) {

494

Copyright 2013 - Bizagi

return true; } public Hashtable UpdateEntity(string sEntSource, string[] arrsKeyColumns, object[] arroKeyValues, Hashtable htUpdateCols, string[] arrsAutoColumns) { return null; } public DataSet GetEntityInstance(string sEntSource, string[] arrsKeyColumns, object[] arroKeyValues, string[] arrsColList) { try { StringBuilder sbSQL = new StringBuilder(); sbSQL.Append(" SELECT "); sbSQL.Append(string.Join(",", arrsColList)); sbSQL.Append(" FROM "); sbSQL.Append(sEntSource); sbSQL.Append(" WHERE "); sbSQL.Append(buildWhereClause(arrsKeyColumns, arroKeyValues)); DataSet ds = m_objSystem.executeMySQLQuery(sbSQL.ToString ()); //DataTable dtAttribValues = ds.Tables[0]; //nueva version retorna DataTable !! return ds; } catch (Exception e) { throw new ApplicationException(e.Message); } } public object GetAttributeValue(string sEntSource, string[] arrsKeyColumns, object[] arroKeyValues, string sAttrSource) { try { StringBuilder sbSQL = new StringBuilder(); // Column to be retrieved sbSQL.Append("SELECT "); sbSQL.Append(sAttrSource); // FROM clause sbSQL.Append(" FROM ");

Copyright 2013 - Bizagi

495

sbSQL.Append(sEntSource); // Uses surrogate key value to find instance sbSQL.Append(" WHERE "); sbSQL.Append(buildWhereClause(arrsKeyColumns, arroKeyValues)); DataSet ds = m_objSystem.executeMySQLQuery(sbSQL.ToString ()); DataTable dtAttribValues = ds.Tables[0]; return dtAttribValues; } catch (Exception e) { throw new ApplicationException(e.Message); } } public DataSet GetEntityInstancesTable(string sEntSource, string[] arrsKeyColumns, string[] arrsColList, string sFilterText, bool bFillSchema, int iTopReturnRows) { try { StringBuilder sbSQL = new StringBuilder(); sbSQL.Append(" SELECT "); sbSQL.Append(string.Join(",", arrsColList)); // FROM clause sbSQL.Append(" FROM "); sbSQL.Append(sEntSource); // WHERE clause if (sFilterText.Length > 0) { // Filter text must be formatted in OleDb syntax sbSQL.Append(" WHERE "); sbSQL.Append(sFilterText); } sbSQL.Append(" ORDER BY "); sbSQL.Append(string.Join(",", arrsKeyColumns)); DataSet ds = m_objSystem.executeMySQLQuery(sbSQL.ToString ()); ds.Tables[0].TableName = "ENTITYINSTANCES"; // Data table with values //DataTable dtAttribValues = ds.Tables[0]; /*XmlDataDocument xmlDoc = new XmlDataDocument(ds); string sAux = xmlDoc.InnerXml; sAux = sAux.Replace("Table", "ENTITYINSTANCES"); return sAux;*/ return ds; }

496

Copyright 2013 - Bizagi

catch (Exception e) { throw new ApplicationException(e.Message); }

} #endregion #region IDisposable Members public void Dispose() { if (!m_bDisposed) { m_bDisposed = true; } } #endregion public string buildWhereClause(string[] keyColumns, object[] keyValues) { StringBuilder sbSQL = new StringBuilder(); string[] arrsKeyValues = new string[keyValues.Length]; string sAnd = " AND "; for (int iKeyIndex = 0; iKeyIndex < keyColumns.Length; iKeyIndex++) { // se asocian las parejas columnas con valores.... sbSQL.Append(keyColumns[iKeyIndex]); sbSQL.Append(" = "); sbSQL.Append(keyValues[iKeyIndex].ToString()); sbSQL.Append(sAnd); } return sbSQL.Remove(sbSQL.Length - 4, 3).ToString(); } #region IEntityVirtualDA Members

public DataSet GetEntityInstancesTable(string sEntSource, string[] arrsKeyColumns, string[] arrsColList, string sFilterText, bool bFillSchema, int iTopReturnRows, System.Collections.Generic.Dictionary<string, object> htParameters) { throw new Exception("The method or operation is not implemented."); }

Copyright 2013 - Bizagi

497

#endregion } }

Clase de la Interfaz IParameter namespace BizagiMySQL { using using using using System; System.Data; Vision.Defs; Vision.DA;

public class CMySqlParameter : IParameter { private EDataType dataType; //--- Provider-independent data type private SqlDbType dbDataType; //--- Provider-specific datatype of the parameter private ParameterDirection direction; //--- The direction of the parameter private string paramName; //--- The Internal name of the parameter private int size; //--- The size of the parameter private byte precision; //--- The precision of the parameter (for decimal values) private byte scale; //--- The scale of the parameter (for decimal values) private object paramValue; //--- The value of the parameter private string sourceColumn; //--- Column associated with parameter private bool useCurrentSourceColumnValue; //--- True if associated column's value is the current, false if it's the original private string originalParamName; //--- The Original o External name of the parameter

public CMySqlParameter(string sParameterName, EDataType eDataType, int iSize, object oValue) { ParameterName = sParameterName; dataType = eDataType; dbDataType = getSqlDataType(eDataType); size = iSize; paramValue = oValue; direction = (ParameterDirection) EParamDirection.In; } public CMySqlParameter (string sParameterName, EDataType

498

Copyright 2013 - Bizagi

eDataType, int iSize, object oValue, EParamDirection eDirection) { ParameterName = sParameterName; dataType = eDataType; dbDataType = getSqlDataType(eDataType); size = iSize; paramValue = oValue; direction = (ParameterDirection) eDirection; } public CMySqlParameter (string sParameterName, EDataType eDataType, int iSize, byte iPrecision, byte iScale, object oValue, EParamDirection eDirection) { ParameterName = sParameterName; dataType = eDataType; dbDataType = getSqlDataType(eDataType); size = iSize; precision = iPrecision; scale = iScale; paramValue = oValue; direction = (ParameterDirection) eDirection; } public CMySqlParameter (string sParameterName, EDataType eDataType, int iSize, byte iPrecision, byte iScale, object oValue, EParamDirection eDirection, string sSourceColumn, bool bUseCurrentSourceColumnValue) { ParameterName = sParameterName; dataType = eDataType; dbDataType = getSqlDataType(eDataType); size = iSize; precision = iPrecision; scale = iScale; paramValue = oValue; direction = (ParameterDirection) eDirection; sourceColumn = sSourceColumn; useCurrentSourceColumnValue = bUseCurrentSourceColumnValue; } // --// IParameter implementation // The property set the originalname and the correct internal name that must have the parameter // --public string ParameterName { get { return paramName; } set

Copyright 2013 - Bizagi

499

{ string sResult = value; originalParamName = value; paramName = sResult.Replace ("@","?"); } } //-// Only for this IParameter implementation // ReadOnly -- Return the original name of the parameter //-public string OriginalName { get { return originalParamName; } } public EDataType Type { get { return dataType; } set { dataType = value; dbDataType = getSqlDataType(dataType); } } public int Size { get { return size; } set { size = value; } } public byte Precision { get { return precision; } set {

500

Copyright 2013 - Bizagi

precision = value; } } public byte Scale { get { return scale; } set { scale = value; } } public object Value { get { return paramValue; } set { paramValue = value; } } public EParamDirection Direction { get { return (EParamDirection)direction; } set { direction = (ParameterDirection)value; } } public string SourceColumn { get { return sourceColumn; } set { sourceColumn = value; } } public bool UseCurrentSourceColumnValue

Copyright 2013 - Bizagi

501

{ get { return useCurrentSourceColumnValue; } set { useCurrentSourceColumnValue = value; } }

public SqlDbType DataType { get { return dbDataType; } } private static SqlDbType getSqlDataType(EDataType eDataType) { SqlDbType oDbType = SqlDbType.Int; switch (eDataType) { case EDataType.BigInt: oDbType = SqlDbType.BigInt; break; case EDataType.Int: oDbType = SqlDbType.Int; break; case EDataType.SmallInt: oDbType = SqlDbType.SmallInt; break; case EDataType.TinyInt: oDbType = SqlDbType.TinyInt; break; case EDataType.Boolean: oDbType = SqlDbType.Bit; break; case EDataType.Decimal: oDbType = SqlDbType.Decimal; break; case EDataType.Numeric: oDbType = SqlDbType.Float; break;

502

Copyright 2013 - Bizagi

case EDataType.Money: oDbType = SqlDbType.Money; break; case EDataType.Float: oDbType = SqlDbType.Float; break; case EDataType.Real: oDbType = SqlDbType.Real; break; case EDataType.DateTime: oDbType = SqlDbType.DateTime; break; case EDataType.SmallDateTime: oDbType = SqlDbType.SmallDateTime; break; case EDataType.Char: oDbType = SqlDbType.Char; break; case EDataType.VarChar: oDbType = SqlDbType.VarChar; break; case EDataType.Text: oDbType = SqlDbType.Text; break; case EDataType.Binary: oDbType = SqlDbType.Binary; break; case EDataType.VarBinary: oDbType = SqlDbType.VarBinary; break; case EDataType.Image: oDbType = SqlDbType.Image; break; case EDataType.Guid: oDbType = SqlDbType.UniqueIdentifier; break; case EDataType.NChar: oDbType = SqlDbType.NChar; break; case EDataType.NVarChar:

Copyright 2013 - Bizagi

503

oDbType = SqlDbType.NVarChar; break; case EDataType.NText: oDbType = SqlDbType.NText; break; default: break; } return oDbType; } } }

Clase de la Interfaz IDatabaseConstants using System; using System.Data; using System.Data.Common; using System.Collections; using System.Collections.Generic; using System.Diagnostics; using System.IO; using System.Text; using System.Text.RegularExpressions; using using using using using using using System.Data.SqlClient; BizAgi.Commons; Vision.DA.AppTablesSchema; Vision.Defs; Vision.DA.Exceptions; System.Threading; Vision.DA;

namespace BizagiMySQL { /// <summary> /// Specific database constants /// </summary> public class CMySqlDatabaseConstants : IDatabaseConstants { #region Singleton private static CMySqlDatabaseConstants m_oSqlInstance = new CMySqlDatabaseConstants(); public static CMySqlDatabaseConstants Instance {

504

Copyright 2013 - Bizagi

get { return m_oSqlInstance; } } protected CMySqlDatabaseConstants() { } #endregion #region Fields / Properties /// <summary> /// Database keyword for a identity type /// </summary> private readonly string m_sIdentityTypeModifier = "IDENTITY(1,1)"; public string IdentityTypeModifier { get { return m_sIdentityTypeModifier; } } /// <summary> /// Enable fixed id insert on identity column /// </summary> private readonly string m_sSetIdentiyInsertOn = "SET IDENTITY_INSERT {0} ON"; public string SetIdentiyInsertOn { get { return m_sSetIdentiyInsertOn; } } /// <summary> /// Disable fixed id insert on identity column /// </summary> private readonly string m_sSetIdentiyInsertOff = "SET IDENTITY_INSERT {0} OFF"; public string SetIdentiyInsertOff { get { return m_sSetIdentiyInsertOff; } } /// <summary> /// Database assignment syntax ({0}: Variable to assign, {1): Value to assign) /// </summary> private readonly string m_sAssignTemplate = "SET {0} = {1} "; public string AssignTemplate { get { return m_sAssignTemplate; } } /// <summary> /// Default template for connection string ({0}: Server, {1}: Database, {2}: User, {3}: Password) /// </summary> protected string m_sDefaultConnString = "Persist Security Info=True;User ID={2};Password={3};Data Source={0};Initial Catalog={1};"; public string DefaultConnString { get { return m_sDefaultConnString; } }

Copyright 2013 - Bizagi

505

/// <summary> /// Keyword to start statements blocks /// </summary> private readonly string m_sBeginStatementBlock = string.Empty; public string BeginStatementBlock { get { return m_sBeginStatementBlock; } } /// <summary> /// Keyword to end statements blocks /// </summary> private readonly string m_sEndStatementBlock = string.Empty; public string EndStatementBlock { get { return m_sEndStatementBlock; } } /// <summary> /// Keyword to call stored procedure in statement block /// </summary> private readonly string m_sExecSPStatement = "EXEC "; public string ExecSPStatement { get { return m_sExecSPStatement; } } /// <summary> /// Symbol to start parameter list in stored procedure call /// </summary> private readonly string m_sBeginSPParams = string.Empty; public string BeginSPParams { get { return m_sBeginSPParams; } } /// <summary> /// Symbol to end parameter list in stored procedure call /// </summary> private readonly string m_sEndSPParams = string.Empty; public string EndSPParams { get { return m_sEndSPParams; } } /// <summary> /// Flag to indicate if default values are between () /// </summary> private readonly bool m_bDefaultValuesEnclosed = true; public bool DefaultValuesEnclosed { get { return m_bDefaultValuesEnclosed; } } /// <summary> /// String concatenation operator /// </summary> private readonly string m_sConcatSymbol = "+"; public string ConcatSymbol { get { return m_sConcatSymbol; } } /// <summary> /// Provider support automatically retrieve data changes /// </summary> private readonly bool m_bEnabledSelectAfterChange = true; public bool EnabledSelectAfterChange { get { return m_bEnabledSelectAfterChange; } }

506

Copyright 2013 - Bizagi

/// <summary> /// Indicates if an empty string is equivalen to null /// </summary> private readonly bool m_bEmptyStringIsNull; public bool EmptyStringIsNull { get { return m_bEmptyStringIsNull; } } /// <summary> /// Empty string for database /// </summary> private readonly string m_sEmptyString = string.Empty; public string EmptyString { get { return m_sEmptyString; } } /// <summary> /// Format for retrieve constant single query /// </summary> private readonly string m_sConstantQueryTemplate = "SELECT {0}"; public string ConstantQueryTemplate { get { return m_sConstantQueryTemplate; } } /// <summary> /// Maximum lenght for a database object id /// </summary> private readonly int m_iMaxDbIdLength = 128; public int MaxDbIdLength { get { return m_iMaxDbIdLength; } } /// <summary> /// Open character for enclose a name that is reserverd word or has special characters /// </summary> private readonly string m_sQuotedNameOpenChar = ""; public string QuotedNameOpenChar { get { return m_sQuotedNameOpenChar; } } /// <summary> /// Close character for enclose a name that is reserverd word or has special characters /// </summary> private readonly string m_sQuotedNameCloseChar = ""; public string QuotedNameCloseChar { get { return m_sQuotedNameCloseChar; } } /// <summary> /// Default Precision for decimals /// </summary> private readonly byte m_iDecimalDefaultPrecision = 18; public byte DecimalDefaultPrecision { get { return m_iDecimalDefaultPrecision; } } /// <summary> /// Default Scale for decimals /// </summary> private readonly byte m_iDecimalDefaultScale = 0;

Copyright 2013 - Bizagi

507

public byte DecimalDefaultScale { get { return m_iDecimalDefaultScale; } } /// <summary> /// Default Precision for numerics /// </summary> private readonly byte m_iNumericDefaultPrecision = 18; public byte NumericDefaultPrecision { get { return m_iNumericDefaultPrecision; } } /// <summary> /// Default Scale for numerics /// </summary> private readonly byte m_iNumericDefaultScale = 0; public byte NumericDefaultScale { get { return m_iNumericDefaultScale; } } /// <summary> /// Indicates if by default comparisons between strings are case sensitive /// </summary> private readonly bool m_bCaseSensitive; public bool CaseSensitive { get { return m_bCaseSensitive; } } /// <summary> /// Keyword to specify storage for a table creation /// </summary> private readonly string m_sKeywordStorageTable = string.Empty; // TODO: [on Primary] public string KeywordStorageTable { get { return m_sKeywordStorageTable; } } /// <summary> /// Keyword to specify storage for an index creation /// </summary> private readonly string m_sKeywordStorageIndex = string.Empty; // TODO: [on Primary] public string KeywordStorageIndex { get { return m_sKeywordStorageIndex; } } /// <summary> /// Order by template for linguistic order /// </summary> private readonly string m_sOrderByStringTemplate = "{0}"; public string OrderByStringTemplate { get { return m_sOrderByStringTemplate; } } /// <summary> /// Max lenght for strings /// </summary> private readonly int m_iVarcharMaxLength = 7800; public int VarcharMaxLength { get { return m_iVarcharMaxLength; } }

508

Copyright 2013 - Bizagi

/// <summary> /// String representation for an empty blob /// </summary> private readonly string m_sEmptyBlobValue = "0x"; public string EmptyBlobValue { get { return m_sEmptyBlobValue; } } /// <summary> /// Keyword to made dirty reads /// </summary> private readonly string m_sSelectWithNoLock = " WITH (NOLOCK) "; public string SelectWithNoLock { get { return m_sSelectWithNoLock; } } /// <summary> /// Keyword to force locks at row level in updates /// </summary> private readonly string m_sUpdateWithRowLock = " WITH (ROWLOCK) "; public string UpdateWithRowLock { get { return m_sUpdateWithRowLock; } } /// <summary> /// key word to drop indexes /// </summary> private readonly string m_sKeywordDropPKIndex = string.Empty; public string KeywordDropPKIndex { get { return m_sKeywordDropPKIndex; } } /// <summary> /// String lenght function /// </summary> private readonly string m_sStringLenghtFunction = "len"; public string StringLenghtFunction { get { return m_sStringLenghtFunction; } } /// <summary> /// Current Date function /// </summary> private readonly string _currentDateFunction = "GETDATE()"; public string CurrentDate { get { return _currentDateFunction; } } #endregion #region Methods /// <summary> /// Prefix to call a function /// </summary> private readonly string m_sFunctionPrefix = "dbo."; public string GetFunctionPrefix(CConfiguration oDBConf) { return m_sFunctionPrefix; } /// <summary> /// Creates a new SQL expression with the "TOP X" included in the

Copyright 2013 - Bizagi

509

sentence based on the provider type /// </summary> /// <param name="sql">"Simple" SQL Sentence to be parsed and replaced, subqueries are not allowed</param> /// <param name="top">number of rows to return</param> /// <returns>Parsed SQL Sentence</returns> public string replaceTopSentence(string sql, int top) { int pos = sql.ToLower().IndexOf("select"); StringBuilder result = new StringBuilder(); string suffix; if (pos > 0) { result.Append(sql.Substring(0, pos)); suffix = sql.Substring(6 + pos); } else { suffix = sql.Substring(6); } result.AppendFormat("SELECT TOP {0} ", top); result.Append(suffix); return result.ToString(); } #endregion } } Una vez haya terminado la implementacin de las clases, debe construir el componente como una librera (para este ejemplo una librera dll).

Configurar el proveedor en Bizagi

En este paso, vamos a configurar el Sistema y el proveedor de datos de la virtualizacin especificando que librera debe ser usada (el componente personalizado creado anteriormente). Nota: Tenga en cuenta que la configuracin es hecha a travs del mtodo de configuracin estndar de virtualizacin, el cual requiere que las entidades a ser virtualizadas hayan sido creadas en el modelo de datos de Bizagi. 1. Clic en Sistema, en la vista de Mdulos de Bizagi. Puede dar clic derecho sobre el elemento sistema y seleccionar N u ev o Sistem a del men desplegable o dar clic en N u ev o sistem a de la barra del men.

510

Copyright 2013 - Bizagi

2. Ingrese el Nombre, Nombre Visual y Descripcin para el nuevo sistema y seleccione el checkbox de P erm itir En tid ad es Virtu ales p ara rep licaci n p ara este sistem a. Clic en Ok para guardar cambios.

3. Clic en el signo (+) al lado del sistema recin creado. Clic derecho en el elemento N u ev o P ro v eed o r.

Copyright 2013 - Bizagi

511

4. En la ventana del Nuevo Proveedor ingrese N o m b re, N o m b re Visu al y Descrip ci n en la pestaa de configuracin del proveedor. Marque la opcin Permitir Entidades Virtuales para este proveedor. Tambin marque la opcin Permitir Replicacin para este proveedor (si aplica).

5. Seleccione la pestaa de proveedor y la librera de la entidad y clic en Nueva librera ( N ew A ssem b ly).

512

Copyright 2013 - Bizagi

6. Ingrese N o m b re, N o m b re Visu al y Descrip ci n . Luego haga clic Seleccionar Librera para seleccionar el .dll de la librera de virtualizacin personalizada creada previamente. De clic en Ok en la ventana de Nueva Librera.

Copyright 2013 - Bizagi

513

7. De clic en el botn Nueva Clase y dentro de la ventana Nueva Clase para Librera, ingrese el nombre de la clase que implementa la interfaz IProviderVirtualDA. De clic en Ok. .

514

Copyright 2013 - Bizagi

8. Ahora, en la pestaa Propiedades desarrollo de Proveedor, incluya las propiedades de la conexin haciendo clic en el botn Metadata para crear una nueva fila Propiedad-Valor. De clic en Ok en la ventana Nuevo Proveedor.

9.Expanda el elemento nuevo proveedor, seleccione el elemento entidades Virtuales y cree una Nueva Clase de Replicacin.

Copyright 2013 - Bizagi

515

10. Seleccione la librera de la lista desplegable en la ventana Nueva Clase para Librera (si la clase de la Entidad esta en la misma librera que la Clase del Proveedor) o incluya una nueva dando clic en Nueva Librera..

D clic en Nueva Clase y complete los campos necesarios en la nueva ventana. Haga clic en Ok para completar la Configuracin de la Clase de la Entidad.

516

Copyright 2013 - Bizagi

11.D clic derecho sobre el nuevo elemento de la clase de la entidad y seleccione la opcin Adicionar entidar a Virtualizar.

12. En la ventana A d icio n ar En tid ad, seleccione una entidad maestra de la lista desplegable. Luego, en el campo de fuente externa, ingrese el nombre de la tabla o vista de la fuente. Despus seleccione uno (o ms de un) atributo de la lista de atributos de la entidad de Bizagi, para que sean la llave de negocio (un atributo que tendr un nico valor, el cual puede ser utilizad para diferenciar un registro de otro). Clic O K para guardar los cambios.

Copyright 2013 - Bizagi

517

13. Seleccione la entidad virtualizada y para cada atributo seleccione el atributo externo correspondiente. Esto se realiza dando clic derecho sobre el atributo y seleccionando la opcin Propiedades.

En la ventana Ed itar A trib u to , escriba el nombre del atributo externo y haga clic en Ok.

518

Copyright 2013 - Bizagi

Nota Si su librera de Virtualizacin personalizada tiene referencias a otras libreras, es necesario copiarlas a una carpeta de Bizagi Studio, (por defecto en " C:\P ro g ram F iles\B izag i\B izag i Stan d ard \Stu d io "), y en la carpeta bin de la carpeta aplicacin web (por defecto en "C: \B izag i\Stan d ard \P ro jects\[P RO JECT_N A M E]\W eb A p p licatio n \b in "). Esto ltimo se hace para que la virtualizacin funciona en tiempo de ejecucin. Ya hemos terminado la configuracin de la Virtualizacin utilizando un componente personalizado para una base de datos mySQL.

Verificar Virtualizacin (Punto de chequeo)

Una vez la Virtualizacin ha sido configurada, usted puede verificar si se ha sincronizado de forma apropiada las entidades maestras con las tablas externas. Tenga en cuenta que con la Virtualizacin, los procesos en Bizagi acceden a informacin almacenada en diferentes fuentes de datos en tiempo de ejecucin. Esta funcionalidad es transparente para los usuarios del Portal de Trabajo; por lo que usted necesita verificar que la virtualizacin funcione de forma adecuada. Esto se realiza verificando en la forma de la actividad donde se utiliza la informacin de las entidades virtualizadas. Adicionalmente, verifque de forma explicita los valores que se estn sincronizando con la fuente. Usted puede ver los valores en la entidad especifica a travs del modulo entidades (disponible para el ambiente de desarrollo). Clic para ms informacin sobre cmo verificar que la virtualizacin se ha configurado de forma adecuada o se ejecuta correctamente.
3.3.5.2.4 Verificar Virtualizacin

Informacin general
Una vez la virtualizacin ha sido configurada, usted puede verificar si las entidades maestras fueron sincronizadas apropiadamente con las tablas externas. Clic para ms informacin sobre la Virtualizacin y su configuracin.

Copyright 2013 - Bizagi

519

Para esto, usted puede utilizar la opcin presentada en el modulo de Entidades para correr una importacin inicial (como punto de verificacin mientras se configura la Virtualizacin en el ambiente de desarrollo). Adems de lo anterior, si usted virtualiza un set de Entidades relacionadas (aquellas que tienen relaciones o llaves forneas entre ellas) entonces deber revisar que las relaciones estn configuradas adecuadamente. Ms informacin sobre esto, en el ejemplo de Cmo virtualizar Entidades relacionadas.

Usando el modulo de Entidades (Punto de chequeo en desarrollo)

Esta opcin permite sincronizar los valores de las Entidades Maestras configuradas en la virtualizacin. Esto solo aplica en el Ambiente de desarrollo. Vaya al mdulo de Entidades y ubique la entidad maestra (Clientes de nuestro ejemplo) en la clasificacin de maestras. Usted podra necesitar Refrescar esta vista en caso que ya se encuentre en esta opcin.

520

Copyright 2013 - Bizagi

En las entidades maestras creadas, de clic en Valores para consultar sus registros. El rea de trabajo de Bizagi mostrar los valores sincronizados. Nota: Tenga en cuenta que esta opcin debe ser usada con precaucin cuando se tiene un nmero muy grande de registros en la fuente, ya que la consulta y la recuperacin de estos valores puede tomar cierto tiempo. El menor nmero de conexiones activas a la fuente es la mejor estrategia para asegurar un desempeo ptimo. Valores de Clien tes, incluidos desde la fuente de datos externa:

Valores de P ro v eed o res, incluidos desde la fuente de datos externa:

Cmo accede a la informacin de las entidades virtuales en el Proceso?

Una vez la virtualizacin ha sido configurada y probada en el proyecto, los procesos que se

Copyright 2013 - Bizagi

521

encuentren en Bizagi podr obtener y actualizar informacin de las entidades virtuales por demanda (a travs de la conexin a la fuente de datos externa). Esto se realiza transparentemente para ambos: El usuario final (mientras trabaja en el Portal de Trabajo), y para los usuarios que implementan la solucin BPM en Bizagi Studio. Esto significa: 1. En la ejecucin del proceso (tiempo de ejecucin), cada vez que se aade un nuevo registro, o uno ya existente se busca en las entidades virtuales, Bizagi consulta la informacin en el origen de datos y actualiza la informacin cuando sea necesario. 2. En el ambiente de desarrollo (Bizagi Studio), los usuarios no necesitan preocuparse por que la informacin. Las interfaces de usuario (formas), reglas de negocio, y en general, todos los objetos en Bizagi han sido diseadas como si estas entidades estuvieran localizadas en una base de datos local (en el Modelo de datos de Bizagi). No se necesitan consideraciones adicionales.

Para buscar registros existentes, usted puede utilizar ya sea los Controles de Bsqueda y Sugerencia dentro de sus formas (para permitir a los usuarios finales bscar ciertos registros) los mtodos CEn tity M an ag er de Bizagi dentro de reglas de negocio (para permitir al sistema ejecutar la bsqueda) . Ambas opciones se manejarn automticamente por Bizagi para consultar los registros en la fuente adecuada. Para ms informacin acerca de los controles de Bsqueda y Sugerencia, consulte Controles de Interfaz de Usuario. Para ms informacin acerca de cmo acceder a la informacin de Entidades Virtuales desde reglas de negocio, consulte Acceder a entidades no relacionadas al Modelo de datos.
3.3.5.2.5 Opciones adicionales para la configuracin de Virtualizacin

Informacin general
Las siguientes opciones de configuracin avanzadas son presentadas a travs del mdulo sistemas, para lograr definir otro tipo de ajustes para las entidades virtualizadas por ejemplo, definir filtros en los registros de la tabla de la fuente de datos externa, definir si una columna no debe ser tenida en cuenta, etc.

522

Copyright 2013 - Bizagi

Ubique el sistema para la virtualizacin haciendo clic en el mdulo Sistemas en la parte izquierda.

Probar el proveedor

Para verificar que el proveedor fue configurado de forma correcta y asegurar una conexin exitosa, se puede probar el proveedor desde Bizagi Studio. La prueba necesita utilizar IIS, y puede ser realizada antes de configurar la virtualizacin o replicacin de las entidades. Esto har un diagnostico de si la conexin con la fuente de datos externa es exitosa. Para realizar la prueba, seleccione el proveedor y de clic derecho sobre la opcin Probar proveedor (o de clic en el botn en el men como se muestra).

Copyright 2013 - Bizagi

523

En la ventana que se abri, seleccione el botn Iniciar test. Un proveedor que ha sido configurado de forma apropiado, mostrar todas las operaciones con un OK como resultado.

524

Copyright 2013 - Bizagi

Nota: La caracterstica Probar proveedor necesita tener IIS (Internet Information Services), ya que es usado como servidor web para el proyecto de Bizagi. El IIS debe estar encendido y corriendo (Instalacin del IIS), y la configuracin de la seguridad de la carpeta de la aplicacin web del proyecto debe permitir autenticacin annima. Si las anterior condiciones (sobre el IIS) alertadas no se cumplen, la verificacin del proveedor tendr como mensaje de error: "La aplicacin web no est disponible".

Probar una entidad virtual

Para verificar una entidad virtual ha sido configurada apropiadamente y que los permisos a la fuente de datos externa son validos (leer y escribir desde la fuente), se puede probar cada entidad virtual desde Bizagi Studio. Para hacer esto, de clic en la entidad virtual y seleccione la opcin Probar entidad Virtual.

En la ventana que se abre, de clic en Comenzar test.

Copyright 2013 - Bizagi

525

Una entidad que ha sido configurada apropiadamente, mostrar OK en cada operacin de verificacin.

Remover entidad de la Virtualizacin

Las entidades virtuales tiene la opcin de detener la sincronizacin con la fuente de datos externa. La entidad removida de la virtualizacin no elimina la entidad del modelo de datos, solamente la elimina de la virtualizacin (es decir el mecanismo no se sigue utilizando sobre esa entidad).

Nota: Esta caracterstica solamente esta disponible en el ambiente de desarrollo cuando el Esquema y la entidad no han sido deployed al ambiente de produccin.

526

Copyright 2013 - Bizagi

Aunque la entidad haya sido removida de la virtualizacin, esta puede ser utilizada, y los valores que se encontraban seguirn siendo los mismos.

Adicionar una entidad a la Virtualizacin

Usted puede escoger incluir una entidad maestra creada luego de configurar la virtualizacin de Bizagi. Para incluir una nueva entidad maestra, utilice la opcin A d icio n ar en tid ad a la Virtu alizaci n .

Copyright 2013 - Bizagi

527

A travs de esta opcin, usted podr incluir una entidad como lo hizo con las opciones estndar de configuracin (avanzado). Recuerde mapear todos los atributos de su entidad con las columnas de la fuente.

Remover un atributo de la replicacin

Las entidades virtualizadas presenta la opcin de remover atributos desde la configuracin de la Virtualizacin (esto usualmente es til cuando se ha incluido la totalidad de los atributos en la configuracin). El atributo no virtualizado an existir en la entidad y podr ser usado en el proceso, aunque la informacin de ste no contine siendo sincronizada con la fuente de datos externa.

528

Copyright 2013 - Bizagi

Esta opcin es til para asegurar que la informacin que se esta mapeando y sincronizando en tiempo de ejecucin, es la informacin apropiada y necesaria (y que la informacin innecesaria no esta siendo actualizada). Esta ayuda a mantener un buen desempeo de la integracin a nivel de datos La opcin se utiliza para columnas que hacen referencia a tablas externas que no estn siendo usadas en Bizagi.

Adicionar atributos a la virtualizacin

Entidades virtualizadas tienen una opcin para incluir atributos adicionales en su configuracin (usualmente cuando la estructura de la tabla de la fuente de datos externos ha tenido cambios luego de la configuracin inicial y la virtualizacin ya esta funcionando).

Copyright 2013 - Bizagi

529

Esta opcin requiere lo siguiente: 1. Primero se debe crear el nuevo atributo en la entidad maestra en Bizagi. 2. Luego se debe agregar el atributo a la Virtualizacin, y mapearlo con la columna de la fuente externa. A travs de est opcin, usted incluir una entidad como se realiz en la opcin de configuracin estndar (avanzada).

Establecer un filtro por una entidad replicada

Cuando se configura un Virtualizacin a travs del Asistente, inicialmente se define un filtro por cada una de las entidades virtualizadas. Usar filtros es una opcin de negocio orientada a evitar la integracin con registros de los que no se tienen inters en Bizagi, por ejemplo, realizar a sincronizacin con solo un conjunto de valores de la fuente Tipo de cliente. Para revisar o editar el filtro, o cuando se estable la virtualizacin a travs de las opciones avanzadas

530

Copyright 2013 - Bizagi

(es decir, cuando se realiza configuracin de forma manual utilizando la opcin Estndar en el modulo Sistem as) se puede hacer a travs del modulo En tid ad es.

Clic derecho en la entidad maestra que ha sido virtualizada y seleccione Propiedades Avanzadas. En la pestaa Fuente de Filtro ( So u rce F ilter) revise o realice cambios en el filtro.

Copyright 2013 - Bizagi

531

Usted puede probar el filtro utilizando la opcin Probar Filtro de la fuente para obtener los valores de la fuente:

Note: Tenga en cuenta que esta opcin debe ser usada con precaucin cuando se tiene un nmero muy grande de registros en la fuente, ya que la consulta y la recuperacin de estos valores puede tomar cierto tiempo. Tener el menor nmero de conexiones activas a la fuente de base de datos es la mejor estrategia para asegurar un desempeo ptimo.

532

Copyright 2013 - Bizagi

Proveedor de datos en produccin

Para garantizar el correcto funcionamiento de todos los ambientes en un proyecto de Bizagi, la configuracin de la integracin que est trabajando actualmente en el ambiente de produccin debe tener las siguientes consideraciones: Una vez un proyecto que utiliza Virtualizacin ha sido deployed a produccin, no ser posible eliminar la informacin del proveedor utilizada en el proceso.

La administracin de estos proveedores de datps (y sus valores de configuracin) para los ambientes de pruebas y produccin, se har directamente a travs de la Consola de Administracin de Bizagi (para cada ambiente de manera separada). Para ms informacin sobre administracin en diferentes ambientes, consulte Bizagi Management Console. 3.3.5.3 Tipos de datos soportados

Informacin General
Cuando se configura una virtualizacin o Replicacin a travs del asistente (es decir, cuando se utiliza los componentes y las clases por defecto que Bizagi ofrece para la Virtualizacin), Bizagi soporta el mapeo de atributos de diferentes tipos. La siguiente informacin describe los tipos de datos soportados cuando se utiliza la integracin nativa

Copyright 2013 - Bizagi

533

de Bizagi con base de datos externas SQL Server u Oracle. Las siguientes tablas muestras las asignaciones de las columnas de Bizagi cuando se utiliza Replicacin o Virtualizacin. La primera columna muestra el tipo de datos de la fuente, y la segunda columna presenta el dato equivalente en Bizagi, si es soportado. En caso que el tipo de datos de alguna columna no sea soportado o que false, se podra utilizar la replicacin o la virtualizacin con algunos ajustes personalizados (utilizando Virtualizacin o replicacin personalizada).

Tipo de datos SQL Server

Caracteres de Texto CHAR VARCHAR TEXT Nmeros Exactos BIGINT INT SMALLINT TINYINT DECIMAL NUMERIC Big Integer Integer Small Integer Tiny Integer Currency Integer (Si el nmero es muy grande, luego de realizar la configuracin de la replicacin o virtualizacin, es necesario cambiar manualmente el tipo de campo a un Big Integer) Currency Currency (soporte limitado) Boolean String String No soportado

MONEY SMALLMONEY BIT Nmeros Aproximados FLOAT REAL Fecha y Hora DATETIME SMALLDATETIME Textos Binarios BINARY

Float Real

Date-time No soportado

No soportado

534

Copyright 2013 - Bizagi

Tipo de datos SQL Server

VARBINARY IMAGE Caracteres de Texto Unicode NCHAR NVARCHAR NTEXT Otros Tipos de Dato UNIQUEIDENTIFIER TIMESTAMP CURSOR SQL_VARIANT TABLE XML No soportado No soportado No soportado No soportado No soportado No soportado String (Soporte total para unicode) String (Soporte total para unicode) No soportado No soportado No soportado

Tipos de Datos Oracle

Caracteres de Texto CHAR NCHAR NVARCHAR LONG RAW LONG RAW Numricos NUMBER(1) NUMBER (3) NUMBER (6) NUMBER(10) NUMBER (19) NUMBER (17,4) Tiny Integer Tiny Integer Small Integer Integer Big Integer Float String String (soporte limitado) String (soporte limitado) No soportado No soportado No soportado

Copyright 2013 - Bizagi

535

Tipos de Datos Oracle

NUMBER(18,4) NUMBER (19,4) NUMERIC FLOAT DEC DECIMAL Fecha y Hora DATE TIMESTAMP INTERVAL YEAR INTERVAL DAY Objeto Extenso (LOB) BFILE BLOB CLOB NCLOB Rowid ROWID UROWID XML XMLTYPE No soportado No soportado No soportado No soportado No soportado No soportado No soportado Date-time No soportado No soportado No soportado Float Float Float Float Tiny Integer Tiny Integer

3.3.6

Administracin de las entidades

En los siguientes links podr encontrar informacin sobre com administrar entidades:

Crear y editar las formas para las entidades paramtricas: estas formas son utilizadas en el portal de trabajo por los usuarios finales para agregar, remover o modificar informacin de las entidades paramtricas. Incluir registros en las entidades paramtricas desde Bizagi Studio: los usuarios desarrolladores pueden incluir registros en las entidades paramtricas desde varios sitios en Bizagi Studio.

536

Copyright 2013 - Bizagi

Incluir registros en entidades paramtricas desde el Portal de Trabajo: los usuarios finales pueden administrar los registros de las entidades paramtricas desde el Portal de Trabajo.

Definir si las entidades paramtricas son administrables en los ambientes de produccin o desarrollo: para todas las entidades paramtricas es necesario definir cmo los usuarios (desarrolladores y usuarios finales) pueden interactuar con ellos.

Crear entidades paramtricas con relaciones padre/hijo a travs de combos dinmicos: la configuracin de padre/hijo de los combos dinmicos se debe hacer entre entidades paramtricas. 3.3.6.1 Incluir datos en entidades paramtricas Registros o valores pueden ser incluidos, eliminados y modificados a travs de Bizagi Studio (Ambiente de desarrollo) o en el Portal de Trabajo en el men Admin. Esta seccin describe cmo interactuar de cuatro formas diferente con este tipo de registros en Bizagi Studio. Para ms informacin sobre cmo los usuarios finales interactan con los registros visite Entidades Paramtricas en el Portal de Trabajo. Cualquiera de las siguientes opciones abrir una ventana donde puede incluir, editar o remover registros.

Clic en el botn Agregar en la esquina inferior derecha para incluir un nuevo registro. Para eliminar un registro, seleccione la fila dando clic sobre el registro, luego presione la tecla Suprimir del teclado. Para cambiar un valor solo debe escribir en el campo que se quiere modificar.

Paso 2: Modelo de datos

Incluir registros en una entidad paramtrica a travs del segundo paso del asistente.

Copyright 2013 - Bizagi

537

Una vez haya incluido una entidad paramtrica en el diagrama de clic derecho sobre ella y seleccione la opcin Valores.

Paso 3: Interfaz de usuario del modelador (Modelador de formas)

Incluya registros en las entidades paramtricas a travs del tercer paso del asistente. D clic derecho sobre la entidad paramtrica que desea modificar y seleccione la opcin Ed itar Valo res.

538

Copyright 2013 - Bizagi

Paso 4: Reglas de negocio

Al lado izquierdo, en la ventana de expresin Booleana, se muestra el Modelo de Datos. D clic derecho sobre la entidad a modificar y seleccione la opcin Editar Valores- Nombre de la entidad.

Copyright 2013 - Bizagi

539

En el editor de expresiones de clic en la opcin Modelo de Datos. D clic derecho sobre la entidad paramtrica que desea modificar y seleccione la opcin Modificar Valores.

Para cada entidad desde la vista de Mdulos

Cada entidad creada ser mostrada en el mdulo de Entidades. Vaya a entidades Paramtricas y seleccione la entidad cuyos valores deben ser editados. Luego seleccione Valo res. Para incluir nuevos registros, clic en el botn A g reg ar. Para borrar registros, seleccione una fila dando clic sobre el registro, luego oprima el botn Su p rim ir en su teclado. Para cambiar un valor solo debe escribir en el campo que se quiere modificar.

540

Copyright 2013 - Bizagi

Nota: Tan pronto como el proyecto ha sido doployed, los usuarios podrn agregar registros en las entidades paramtrica a travs del Portal de trabajo solamente si la entidad es administrable en produccin. De lo contrario, los valores debern ser agregados utilizando Bizagi Studio y luego realizar deployment a produccin. 3.3.6.2 Entidades padre e hijo El combo dinmico se utiliza cuando se desea desplegar una lista de los valores de una Entidad Paramtrica (Entidad Hija) filtrados automticamente, siempre y cuando los valores dependan de otra Entidad Paramtrica (Entidad Padre). Es decir, los valores de la entidad hija dependen del valor seleccionado de la entidad Padre. Normalmente, usted puede querer llegar hasta un tercer nivel de dependencia entre entidades. Un buen ejemplo de esta situacin es Ciudad Estado Pas donde se quiere mostrar las ciudades que pertenecen a un estado y a su vez los estados que corresponden a un pas especifico. Dos entidades paramtricas deben ser creadas para establecer la relacin padre-hijo para lograr este comportamiento. La entidad hija debe tener la relacin con la entidad maestra que contiene la informacin.

Configurar una relacin padre- hijo

Imagine que tiene una solicitud de compra donde debe seleccionar un pas, estado y una ciudad para la informacin de entrega.

Copyright 2013 - Bizagi

541

La entidad maestra principal del proceso se llama Solicitud de Compra. Las entidades Ciudad, Estado y Pas deben ser creadas previamente. 1. Incluya en la entidad principal del proceso la relacin con la entidad hija: Ciu d ad .

2. Abra el modelo de datos en el segundo paso del asistente. D clic derecho en la entidad Ciudad y seleccione la opcin P ro p ied ad es. En el ultimo paso del asistente de clic en el link Avanzado. Un nuevo campo ser mostrado para incluir la entidad padre.

542

Copyright 2013 - Bizagi

3. Clic en F in alizar Si no existe la relacin entre estas dos entidades (el padre y el hijo), se le pedir que la cree.

4. Seleccione Si y de clic en Finalizar. La relacin ha sido creada.

5. Siga los pasos 2 y 3 para configurar la entidad Estado como padre.

Copyright 2013 - Bizagi

543

6. Primero agregue los valores de Pas. Luego incluya los valores de los Estado y relacinelos con Pas. Finalmente incluya los valores de las ciudades y relacinelos con Estado.

544

Copyright 2013 - Bizagi

Copyright 2013 - Bizagi

545

7. Cuando se incluye la entidad hija Ciudad, en la interfaz de usuario del combo dinmico, los usuarios finales podrn ver tres entidades: Pas, Estado y Ciudad. Estos campos sern filtrados automticamente para cumplir con la opcin seleccionada.

3.3.6.3

Donde administrar las entidades paramtricas Los valores o registros de las entidades paramtricas pueden ser manejadas en dos formas de acuerdo a cmo los desarrolladores y los usuarios finales interactan con ellas. Ellas pueden ser administradas en desarrollo, cuando sus valores son ingresados, en este momento, estos valores no pueden ser vistos o modificados por los usuarios finales. De forma alternativa, los valores pueden ser administrados por los usuarios finales en el Portal de Trabajo, donde los usuarios deciden que se debe incluir. Por esta razn es necesario definir como los usuarios podr interactuar con todas las entidades paramtricas de acuerdo al uso que tendr cada una de ellas, es posible definirlas:

Administrables en el ambiente de produccin

Una entidad administrable en produccin significa que sus valores pueden ser modificados por los usuarios finales. Si la entidad NO es administrable en el ambiente de produccin significa que sus valores solo se pueden modificar en el ambiente de desarrollo. La entidad paramtrica Documentos Solicitados contienen los documentos que se deben solicitar para que un cliente abra una cuenta en el banco. Estos documentos pueden ser eliminados o ser necesario incluir nuevos documentos de acuerdo a las regulaciones, por lo que la lista puede variar en el tiempo. Por este motivo es importante que esta tabla pueda ser modificada por los usuarios finales, es decir

546

Copyright 2013 - Bizagi

que sea administrable en el ambiente de produccin.

Administrable en el ambiente de desarrollo

Las entidades paramtricas que sean administrables en desarrollo no sern mostradas para edicin en el ambiente de produccin. Es decir, los usuarios finales podrn trabajar con la informacin contenida en ellas, pero no podrn realizar ningn cambio. Esto es muy til para las entidades paramtricas que definen el flujo del proceso o tienen una lista finita de posibles valores. Un ejemplo de una entidad paramtrica que debera ser administrable en el ambiente de desarrollo es Gnero. Esta tabla tiene dos y solamente dos posibles valores: Femenino y masculino. Por lo que no debera ser modificada por los usuarios finales.

IMPORTANTE: Si los usuarios no definen el comportamiento de una tabla est quedar por defecto como administrable en desarrollo. La propiedad Administrar valores en el ambiente de produccin nicamente es definido cuando la entidad es creada.

Definir donde administrar una entidad paramtrica

Esta propiedad se define en desarrollo en el primer paso del asistente de creacin de entidades paramtricas. La opcin A d m in istrar v alo res en el am b ien te d e p ro d u cci n se encuentra en la parte inferior de la ventana. Por defecto, la opcin se encuentra sin marcar por lo que la entidad ser administrable en el ambiente de desarrollo. Seleccione la opcin para permitir que la entidad sea administrable en el ambiente de produccin.

Copyright 2013 - Bizagi

547

Para una entidad paramtrica existente, la propiedad puede ser modificada en la vista de Mdulos. Seleccione el mdulo Entidades, de clic derecho sobre la entidad deseada y seleccione la opcin Propiedades Avanzadas. En la pestaa Instancia, usted podr marcar la opcin mencionada.

548

Copyright 2013 - Bizagi

En Bizagi Studio las entidades paramtricas se vern diferentes dependiendo de la propiedad como se muestra a continuacin.

Consideraciones Importantes
Si usted tiene problemas para determinar si una entidad se debe administrar en produccin o en desarrollo considere las siguientes recomendaciones.

1. Si los valores de la entidad son utilizados en cualquier tipo de regla, por ejemplo una expresin, una asignacin o en validaciones de las formas, acciones o comportamientos, la entidad NO debe ser administrable en el ambiente de produccin. 2. Si los valores de la entidad son utilizados para definir el flujo del proceso, la entidad NO debe ser administrable en el ambiente de produccin.

Copyright 2013 - Bizagi

549

3. Si la entidad necesita de actualizaciones constantes por que sus valores cambias seguido, la entidad debe ser administrable en el ambiente de produccin. 4. Si la entidad tiene una relacin con la tabla del sistema WFUser, la entidad debe ser administrable en el ambiente de produccin. 5. Una entidad paramtrica debe ser administrable en produccin si se tiene planeado la inclusin de nuevos valores de forma frecuente. Sin embargo, es recomendable tener en cuenta el concepto del cliente o del dueo del proceso, ya que ellos tienen una mejor idea del desempeo que se quiere obtener. Es necesario tener en cuenta algunas consideraciones cuando se definen entidades paramtricas: 1. Los valores de todas las entidades administrables en produccin estarn disponibles para modificar en cada ambiente de forma independiente. Estos valores solo se llevarn al ambiente de produccin solamente en el PRIMER deployment. 2. Los valores de las entidades administrables en desarrollo siempre sern llevados al ambiente de produccin y sobrescribirn los registros existentes e incluirn los nuevos. 3. Las entidades administrables en produccin no deben tener administrables en desarrollo. conexiones con entidades

4. Entidades administrables en produccin no deben tener ninguna relacin con entidades administrables en desarrollo. 5. Es posible convertir una entidad que sea administrable desde desarrollo para que sea administrable desde produccin si se cumplen con las condiciones mencionadas anteriormente. 6. Es posible convertir una entidad que sea administrable desde el ambiente de produccin para que sea administrable desde el ambiente de desarrollo si la entidad no tiene formas asociadas, si no est replicada o virtualizada, si no tiene colecciones, si an no ha sido desplegada y si cumple con las condiciones mencionadas previamente en este artculo. La imagen a continuacin describe cmo las entidades paramtricas se pueden relacionar entre s.

550

Copyright 2013 - Bizagi

Artculos Relacionados
Incluir registros en una entidad Paramtrica a travs de Bizagi Studio Incluir registros en una entidad Paramtrica a travs del Portal de Trabajo

3.3.7

Atributos Temporales
Bizagi ofrece la posibilidad de crear atributos temporales para almacenar informacin por un corto tiempo, estos atributos no son parte del modelo de datos. Su acceso y manipulacin estar limitado a la vida del contenedor de la variable. La informacin almacenada en el atributo temporal no ser almacenada en la base de datos. Esto es

Copyright 2013 - Bizagi

551

la razn por la que es temporal, los valores duran tanto como dure la variable sin afectar el modelo de datos. Si se desea mantener persistente la informacin contenida en uno de estos atributos, se deber asociar su contenido a algn atributo del modelo de datos del negocio, mientras la actividad o proceso involucrados estn activos. El modelo de datos del proceso ser guardado en la base de datos de Bizagi y puede ser consultado en cualquier momento, si un caso es abierto o cerrado. Nos referiremos a esto como el Scope. Atributos Temporales. Los atributos temporales (atributos del proceso) son utilizados en expresiones y en reglase de negocio y pueden verse en la interfaz del usuario (forma) de la actividad o proceso. Los atributos temporales son utilizados para prevenir que los usuarios creen otros que tienen algn tipo de control en el proceso pero no agregan ningn valor en el modelo de datos. Ellos pueden ser necesarios como parte de un clculo o una validacin pero no tienen ninguna relevancia en la informacin del caso. Es ms, una vez que se han utilizado pueden ser considerados como basura en el modelo de datos. Imagine una solicitud de compra dentro de su compaa donde se solicitan dos computadores. El costo de la compra excede las polticas de la compaa por lo que la compra debe ser aprobada por el jefe inmediato. En este caso, la ruta del proceso ser definida por el valor de un atributo booleano que determina si se debe o no continuar con la aprobacin del jefe. El atributo booleano puede ser temporal ya que su nica funcin es determinar el flujo del proceso en determinado punto. Solamente es necesario guardar la evaluacin Falso/Verdadero por un corto periodo de tiempo. Una vez que el atributo es evaluado y el flujo del proceso continua, el atributo se convierte en redundante y no se necesita mas. Estos atributos temporales pueden:

Guardar informacin durante el tiempo que dure la actividad Guardar informacin durante el tiempo que dure el proceso
La informacin que se debe mantener permanentemente no puede ser guardada en atributos temporales. Se debe asociar el contenido con un atributo del modelo de datos.

Crear atributos temporales

Primero que todo, determine si el dato debe estar disponible durante el tiempo de vida de una actividad o durante el tiempo de vida del proceso. Una vez que el alcance del atributo ha sido definido se puede crear. Los atributos temporales que han sido declarados como locales en una actividad no son visibles fuera de la actividad por lo que su informacin solo es valida en la actividad y no en todo el proceso.

Atributos temporales de una actividad

1. Seleccione la opcin Procesos en la vista de Mdulos. Navegue a travs de los procesos hasta que encuentre el proceso donde se va a crear en atributo temporal. Seleccione la opcin Elem en to y luego la opcin A ctiv id ad es, seleccione la actividad donde se va

552

Copyright 2013 - Bizagi

agregar el atributo.

2. Se abrir una nueva ventana con la lista de atributos temporales de la actividad. Cree un nuevo atributo dando clic en el botn del signo ms en la esquina superior izquierda.

Copyright 2013 - Bizagi

553

3. Incluir un nombre (sin espacios o caracteres especiales), un nombre visual (el cual ser mostrado en el Portal de Trabajo, si se usa en una interfaz de usuario) y el tipo de atributo. Tambin es posible incluir una descripcin para propsitos de documentacin, y un texto de ayuda, el cul ser mostrado, dando clic sobre el atributo en el Portal de Trabajo. 4. Los atributos temporales pueden ser relacionados con una entidad. Para crear relaciones de atributos, seleccione el tipo de datos, en este caso Entero (valido para crear relaciones con atributos) y luego seleccione la entidad relacionada de la lista desplegable del final de la pestaa de propiedades.

554

Copyright 2013 - Bizagi

Atributos temporales del proceso

1. Seleccione la opcin Procesos en la vista de Mdulos. Ubique el proceso donde se crearn los atributos temporales dentro de la opcin de Aplicaciones. Para identificar los atributos creados, de clic derecho sobre la entidad y seleccione la opcin Editar lista de atributos.

Copyright 2013 - Bizagi

555

2. Siga los pasos 2,3 y 4 descritos en la seccin Atributos temporales de actividad.

Utilizar un atributo temporal

Los atributos temporales del proceso pueden ser arrastrados y soltados en una forma o en una regla de negocio como cualquier otro atributo del modelo de datos. De forma similar, los atributos temporales de actividad pueden ser arrastrados y soltados en una forma, pero en las reglas de negocio, es necesario incluir su NOMBRE dentro de los smbolos < y >. En el diseado de forma, arrastre y suelte el atributo desde le Modelo de Datos, el cual se encuentra en el panel al lado izquierdo de la ventana. Tenga en cuenta que en este punto los atributos temporales no tienen contexto por lo que pueden ser

556

Copyright 2013 - Bizagi

utilizados en cualquier actividad que los necesite. Los atributos temporales del proceso son asignados a nivel de proyecto. Para utilizar estos atributos temporales, seleccione la opcin Procesos de la vista de Mdulos y seleccione Expresiones para habilitar el editor. En el editor de Reglas de Negocio (Editar Expresiones), de clic en el icono del Modelo de Datos y seleccione el proyecto Compras. En atributo temporal ser mostrado al final del nodo del proyecto de Compras.

3.3.8

Scopes
Bizagi es una herramienta colaborativa que permite que varios usuarios estn trabajando sobre un mismo proceso al mismo tiempo, en actividades paralelas. Para garantizar la integridad de la informacin, Bizagi maneja un concepto llamado Tran saccio n es d e larg a d u raci n . Esta es una tecnologa esencial varias personas trabajan simultneamente en un proyecto impidiendo que los distintos usuarios editen los mismos datos. En Bizagi se conoce como Sco p es. Para ello, la informacin de todas las actividades es guardada en el Scope y slo van a la base de datos cuando los usuarios finales dan clic en Siguiente. Cuando un usuario est ingresando informacin en una actividad pendiente en el Portal de Trabajo, la informacin se puede guardar dando clic en el botn Guardar, para continuar ms tarde. Sin embargo, esta informacin no se valida hasta que el usuario hace clic en Siguiente, momento en el cual las reglas que garantizan la integridad de los datos se ejecutan, es decir, cuando el usuario est seguro de que quiere terminar esta actividad.

Copyright 2013 - Bizagi

557

Piense en el Scope como una memoria de almacenamiento temporal que garantiza que la informacin se guarda y se mantiene como el usuario final la ingresa en su actividad, pero no se refleja en otras actividades abiertas de un mismo proceso, hasta que se hace clic en Siguiente, que es cuando finalmente se persiste. En el caso de que el usuario haga clic en Guardar, la informacin se mantendr en el Scope de la actividad y no en la base de datos. Cuando se hace clic en Siguiente, la informacin introducida se guarda en la base de datos y, por tanto, estar disponible para todas las dems actividades abiertas y para las siguientes actividades en el flujo del proceso. La navegacin XPath utiliza la informacin en el Scope no la de la base de datos. Esta navegacin siempre se debe utilizar en Expresiones, Plantillas de documentos, Polticas, Interfaces, etc. Cuando es necesario que un sistema externo se comunique enviando o recibiendo informacin de Bizagi se deben utilizar los mtodos de la capa SOA de Bizagi para garantizar que la informacin se enva del Scope y no a la base de datos.

3.3.9

Llaves de negocio

Informacin general
Una llave de negocio es la columna que contiene un identificar nico para cada registro de la entidad y es definido por el usuario. Este concepto garantiza que la informacin guardada en la llave de cada registro diferencie cada uno de ellos de otros registros de una misma entidad. Por ejemplo, la llave de negocio de la entidad Cliente tendr el nmero del Seguridad Social de cada persona. No debern existir dos personas (registros) con el mismo ID en la entidad Cliente. La definicin de la llave de negocio es una buena practica para la definicin del modelo de datos del proyecto, pero es opcional. El uso de llaves de negocio permite a Bizagi validar la informacin ingresada por el usuario y evitar informacin repetida. Estas llaves son muy tiles cuando se utilizan ciertos mtodos de la capa SOA de Bizagi, por lo que permite, con un XML sencillo, actualizar o insertar informacin.

Cmo crear una llave de negocio?

Para definir una llave de negocio en Bizagi, vaya a la vista de Mdulos. En la opcin de Entidades, ubique la entidad donde se definir la llave de negocio, de clic derecho en ella y seleccione la opcin P ro p ied ad es A v an zad as. Seleccione la pestaa Llave de Negocio en la nueva ventana, seleccione la opcin Habilitar llave de negocio y defina desde la lista de atributos aquellos que sern las llaves de negocio.

558

Copyright 2013 - Bizagi

En la siguiente imagen Tip o d eDo cu m en to y N m ero Do cu m en to sern las llaves de negocio para la entidad Cliente.

3.3.10 Entidad de proceso

Todo proceso en Bizagi tiene una Entidad de Proceso principal. La entidad provee un punto de acceso al resto de la informacin del proceso. Solamente existe UNA Entidad de Proceso por proceso y siempre debe ser una entidad maestra. La Entidad de Proceso es la primera entidad creada por el proceso y es definida en el segundo paso del Asistente. Bizagi configura de forma automtica la Entidad de Proceso. Cuando el modelo de datos es creado, Bizagi pregunta el nombre de la entidad principal. Cuando se abre el diagrama, solamente se mostrara la Entidad de proceso. Esta entidad se mostrar en el diagrama con una doble lnea para distinguirla del resto de entidades. Sin embargo, la Entidad de Proceso no existir si usted no ha creado el modelo de datos o si fue creado a travs de la vista de Mdulos, por lo que deber configurar la Entidad de Proceso de forma manual. Existen dos formas de configurar la Entidad de Proceso.

Copyright 2013 - Bizagi

559

1. La primera forma es a travs del men Entidades. Vaya a la vista de Mdulos y seleccione la opcin En tid ad es. Busque la entidad escogida para se la Entidad del Proceso. Clic derecho sobre la entidad maestra y seleccione la opcin Asignar entidad de Proceso. Si el proceso ya tiene una Entidad de Proceso asignada, Bizagi le mostrar un mensaje de advertencia para asegurar que se desea realizar el cambio.

2. La segunda opcin es a travs del men de procesos. Vaya a la vista de Mdulos y seleccione la opcin Procesos y de clic derecho sobre el proceso deseado, luego seleccione la opcin A sig n ar en tid ad d e P ro ceso . Una nueva ventana ser mostrada con una lista desplegable para seleccionar la entidad. Si el proceso ya tiene una Entidad de Proceso asignada, Bizagi le mostrar un mensaje de advertencia para asegurar que se desea realizar el cambio.

560

Copyright 2013 - Bizagi

3.3.10.1 Contexto El contexto es el punto de inicio del modelo de dato el cual determina cmo es usuario navegar a travs de los atributos y cmo se construye la informacin. Por lo cual, es muy importante observar el contexto del Proceso y los elementos que se han creado para la elaboracin de las interfaces de usuario, reglas de negocio y notificaciones. Una de las entidades del modelo de datos es el contexto y de acuerdo a l, el usuario podr moverse de una entidad a otra para obtener informacin. El contexto del proceso es definido por la Entidad del Proceso principal, recuerde que la Entidad de Proceso es la entidad principal, y es el punto de inicio a travs del cual los usuarios acceden al resto del modelo de datos. El contexto depende del proceso, por lo que la informacin ser guardada y presentada de forma diferente para cada proceso. Por ejemplo, en el proceso de Solicitud de Compras, el contexto es Solicitud de Compras, ya que esta es su entidad de proceso principal y a travs de ella se puede alcanzar el resto del modelo de datos.

Copyright 2013 - Bizagi

561

Contexto en las Formas

Las formas que son construidas desde el tercer paso del asistente tendrn la Entidad de Proceso como contexto. Las formas que son construidas desde una entidad especfica, tendrn como contexto la entidad. Este tema ser mostrado en ms detalle en la seccin de Contexto en formas.

Contexto en Reglas de Negocio y Expresiones

Las reglas de Negocio que se crean desde el cuarto paso del asistente tendrn como contexto la entidad de proceso principal. Si usted esta construyendo una regla de visibilidad, el contexto ser donde se evale la regla, es decir, la entidad de la forma. Este tema se discute en mayor detalle en la seccin Administracin de las interfaces de usuario. Cuando se construye una expresin para validar la informacin de la tabla, el contexto de la regla ser la entidad de la coleccin o la entidad que tiene la relacin de muchos en una relacin uno a muchos. Recuerde que usted necesita una relacin uno a muchos para definir una coleccin y crear una tabla en la forma.

Contexto en Correos electrnicos

El campo P ara define el contexto del correo. El contexto cambia en correos enviados en relaciones uno a muchos, cuando el campo P ara tiene direcciones que corresponden a una coleccin.

562

Copyright 2013 - Bizagi

Cuando el campo P ara contiene una direccin de correo fija, o no se toma de una campo del modelo de datos, el contexto ser siempre la Entidad de proceso. Cuando el campo P ara contiene una coleccin, usted podr elegir entre la entidad del proceso o la entidad del muchos de la relacin para definirla como contexto.

3.4

Creacin de interfaces de usuario

Los usuarios finales interactan con los procesos automatizados a travs de un portal diseado para ser ejecutado por cualquier buscador. Los usuarios acceden a este portal, llamado Portal de Trabajo, donde pueden ver sus actividades pendientes del proceso. Cada actividad pendiente tiene una Forma asociada, la cual muestra informacin del proceso de acuerdo a sus necesidades particulares. El tercer paso del asistente, Defin ir fo rm as, permite crear cada una de las interfaces de las actividades que tienen actividad humana. El diseador de formas provee una forma fcil e intuitiva para crear el diseo de la forma, no es necesario programar, solo debe arrastrar y soltar los campos (conocido como Control en Bizagi) dentro de la forma para organizarlos de la forma que su proceso lo requiera. El diseador de formas tiene la funcionalidad Lo que ve es lo que obtiene, por lo que usted puede saber como se ver la forma en el portal a medida que la construye en el diseador. Adicionalmente, usted podr definir validaciones complejas y ejecutar acciones sobre la informacin para asegurarse que el usuario final ingrese la informacin toda la informacin correctamente en su proceso.

Copyright 2013 - Bizagi

563

3.4.1

Creando mi primera forma

Las formas son creadas utilizando el Modelo de datos definido en el paso anterior del Asistente. La entidad de contexto del proceso es el punto de inicio desde el cual se puede acceder al modelo de datos, en otras palabras, a cada uno de los atributos que constituirn la forma. En el paso tres de asistente, de clic en Defin ir F o rm as. El flujo del proceso se mostrar. Todas las tareas que involucran trabajo humano necesitan una forma, usted podr dar clic sobre cualquiera de estas actividades. Los elementos en el proceso que no necesitan formas sern mostrados en modo lectura. Las actividades que no tengan una forma tendrn una imagen asociada para que resalten dentro del diagrama tal cmo se muestra en la siguiente figura.

Ejemplo
Imagine un proceso de Solicitud de Compras donde sus empleados solicitan la compra de bienes y servicios. El modelo del proceso se muestra en la siguiente imagen. La primera actividad del proceso es donde el solicitante ingresa toda la informacin relacionada a su necesidad. Para crear esta primera forma es necesario enumerar la informacin que se quiere mostrar. Informacin de la solicitud contiene: la fecha de la solicitud, el nombre del solicitante y la justificacin de la compra. tems solicitados: tabla con los servicios o bienes solicitados. Informacin de entrega: direccin de entrega, fecha de entrega, ciudad de entrega. La forma ser creada basndonos en el siguiente modelo de datos.

564

Copyright 2013 - Bizagi

1. Vaya al tercer paso del asistente. Cuando se muestre el diagrama del proceso, de clic en la tarea donde se va a crear o modificar la forma. El diseador de formas ser mostrado. Si no se ha construido una forma anteriormente, el diseador ser mostrado en blanco.

Copyright 2013 - Bizagi

565

2. Vamos a incluir tres contenedores para organizar la informacin dentro de la forma. En la pestaa controles del panel del lado izquierdo, seleccione Grupo dentro de las opciones de los contenedores, arrastre y suelte tres grupos sobre el rea de trabajo. Note que cuando arrastra un elemento desde le panel un mensaje de DROP HERE se muestra y una seccin de la forma se resalta, esto le ayudar a seleccionar el sitio donde quiere incluir el nuevo elemento. Tambin puede dar doble clic sobre el elemento y este se incluir automticamente al final de la forma.

566

Copyright 2013 - Bizagi

3. D doble clic sobre el nombre del grupo para cambiar el nombre: Informacin de la solicitud, Productos solicitados, Informacin de entrega.

4. Regrese a la pestaa de Datos. Tan pronto como un atributo es incluido en la Forma, este se presenta en Bizagi y se convierte como un Control. Control tiene un tipo: texto, fecha, combo (lista desplegable), Si/No, nmero, etc. Dependiendo del tipo de atributo. Para el primer grupo, arrastre y suelte los siguientes atributos: Fecha de la solicitud, Solicitado Por:

Copyright 2013 - Bizagi

567

Informacin de la compra. Asegrese de incluir los atributos en el primer grupo. Sultelos cuando el mensaje DROP HERE del primer grupo este resaltado. Note que cada atributo es creado en la forma con un Mostrar como, el cual corresponde al tipo de atributo. Es decir, la Fecha de solitud se incluye como un campo de control de fecha, el Solicitante se incluye como un control de combo (una lista desplegable) y la Justificacin de la compra como un campo de control de texto. Bizagi ayuda a identificar los tipos de control que necesita por los atributos incluidos.

5. Para el segundo grupo, arrastre y suelte la coleccin de Productos solicitados. La coleccin ser mostrada como una tabla de control. Las tablas necesitan la definicin de las columnas que sern mostradas.

568

Copyright 2013 - Bizagi

6. Cuando se muestre la tabla de control, de clic en Editar Columnas, arrastre y suelte las columnas que desee que se muestren. Dando doble clic, usted podr incluir automticamente los controles en el editor de la columna. Clic en O K cuando termine.

Copyright 2013 - Bizagi

569

7. Arrastre y suelte los controles para el ltimo grupo: Direccin de entrega, Ciudad de entrega y Fecha de Entrega.

570

Copyright 2013 - Bizagi

8. Los dos primeros controles (Fecha de solicitud y Solicitante) deben tener modo lectura. Estos campos sern asignados utilizando una expresin, de forma que el usuario final tendr cargada esta informacin tan pronto entre a la actividad en el Portal de Trabajo. D clic en el control. Sus propiedades sern mostradas en el panel izquierdo. Tambin se puede modificar las propiedades del control, dando clic en el engrane del lado derecho.

Copyright 2013 - Bizagi

571

9. Cambie la configuracin de la propiedad Editable. Para hacer el control como no editable, seleccione el icono X. Note que se ha cambiado la forma en que se muestra el control, ahora aparece como solo lectura. Repita el procedimiento para el control de Solicitante.

572

Copyright 2013 - Bizagi

10. Cuando termine, clic en Gu ard ar, para guardar todos los cambios.

3.4.2

Componentes de la forma
El Diseador de Formas se divide en tres partes: Ribbon: Presenta un conjunto de comandos que son relevantes para la Forma, as como comandos contextuales relacionados al control seleccionado en un momento determinado. Panel Izquierdo: Contiene tres pestaas: o La pestaa de Datos provee acceso al modelo de datos. o Pestaa de Controles: Muestra todos los controles disponibles para incluir en la Forma. o Pestaa de Layout: Permite manipular el diseo de la forma, especficamente la separacin de contenido en diferentes secciones. rea de Trabajo: Es el rea en el cual se disea la forma.

Copyright 2013 - Bizagi

573

3.4.2.1

Ribbon El Ribbon presenta un conjunto de comandos que son relevantes para la Forma, por ejemplo, Gu ard ar, Co p iar Desd e , P ro p ied ad es d e la F o rm a entre otras. Tambin muestra comandos contextuales, los cuales estn relacionados al control seleccionado en un determinado momento, tales como Ed itab le, Visib le y Req u erid o .

OPCIN DEL MEN

SUB OPCIN Deshacer Rehacer

DESCRIPCIN Deshace la ltima accin realizada en la forma. Rehace la ultima accin anulada. Guarda los cambios realizados en la forma. Provee acceso a formas creadas previamente para

Forma

Guardar Copiar Desde

574

Copyright 2013 - Bizagi

OPCIN DEL MEN

SUB OPCIN

DESCRIPCIN copiar su contenido exacto.

Copiar Formato Propiedades

Copia el formato dado a un Control para configurarlo en otro. Provee acceso a las Propiedades de las formas tales como Nombre de Mostrar, Descripcin, Es Administrable. Resalta los errores y advertencias para toda la forma o para controles especficos. Provee acceso al asistente de Acciones y Validaciones. Muestra una lista de los posibles controles a los cuales un control seleccionado puede ser convertido. Elimina el control seleccionado. Cambia el nombre de mostrar del control seleccionado. Administra la Visibilidad del control seleccionado. Administra la Editabilidad del control seleccionado. Determina su el control seleccionado es Obligatorio o no. Cambia el idioma por defecto entre los idiomas disponibles.

Mostrar Validacin

Alertas Acciones y Validaciones Convertir a Eliminar Renombrar

Controles Visible Editable Requerido Idiomas Seleccionar Idioma

3.4.2.2

Panel Izquierdo El panel izquierdo contiene tres pestaas: Pestaa de Datos: Provee acceso al Modelo de Datos. Desde aqu usted puede incluir los atributos requeridos en la forma. La Entidad Principal de Proceso es el punto de partida para acceder al resto de las entidades del Modelo de Datos. Pestaa de Controles: Muestra todos los controles que se pueden incluir en la forma. Contiene dos secciones denominadas Controles de Bizagi y Contenedores. El primero incluye todos los controles que usted puede utilizar en la forma, por ejemplo Tex to , Si/N o , F ech a, entre otros. El ltimo funciona como un contenedor para otros controles, por ejemplo, Gru p o s o P esta as. Pestaa de Layout: Le permite manipular el diseo de la forma, especficamente la separacin de contenido en diferentes secciones.

Copyright 2013 - Bizagi

575

3.4.2.2.1 Contenedores: Grupos y Pestaas

Los Contenedores le permiten organizar el rea de Trabajo para distribuir la informacin en P esta as o Gru p o s. Las P esta as funcionan como en los navegadores web. Cuando usted da clic sobre ellas, muestran su contenido y ocultan el de otras pestaas. Los Gru p o s contienen controles en bloques, visualmente organizados en pequeos conjuntos de informacin relacionada.

576

Copyright 2013 - Bizagi

Las pestaas y grupos tienen las siguientes propiedades. N o m b re d e m o strar, Visib le y Ed itab le. Las dos ltimas propiedades Booleanas se pueden configurar en Verdadero ( ) o Falso ( ).

Adicionalmente, los grupos poseen una propiedad especial denominada Colapsado, la cual define si el grupo se mostrar inicialmente expandido o colapsado.

Copyright 2013 - Bizagi

577

Cada control en el contenedor heredar los valores de propiedad asignados al Gru p o o P esta a. Por ejemplo, si un grupo se configura como de solo lectura, cada control dentro del grupo se podr acceder nicamente para lectura. Esto es, el Contenedor posee sonoridad sobre los controles en la jerarqua visual.

Para cambiar el nombre de una P esta a o Gru p o , d doble clic sobre su nombre e ingrese el deseado. D clic sobre el icono de marcacin verde ( ) para finalizar la edicin.

578

Copyright 2013 - Bizagi

Para eliminar una P esta a o Gru p o , seleccinela y d clic en icono eliminar ( control.

) adjunto al borde del

Incluir un control dentro de un Grupo

Para incluir un control dentro de un grupo, simplemente arrstrelo y ubquelo dentro de el. Espere a que la seccin SOLTAR AQU se encienda para indicar donde se localizar el control. Suelte el mouse cuando la seccin correcta se resalte.

Copyright 2013 - Bizagi

579

Incluir un Grupo dentro de un Grupo

Usted puede incluir Grupos dentro de Grupos. Para hacerlo, cree ambos grupos y luego inserte uno de ellos dentro del otro, tal como se muestra en la siguiente imagen.

Incluir una Pestaa dentro de una Pestaa

580 Copyright 2013 - Bizagi

Usted puede incluir Pestaas dentro de Pestaas. Para hacerlo, cree una Pestaa y luego incluya la nueva dentro de esta, tal como se muestra en la siguiente imagen.

Crear una nueva Pestaa

Cuando usted incluye una Pestaa en una forma, el icono de adicin verde ( ) siempre estar disponible en la parte derecha. Este icono permite incluir nuevas pestaas, una al lado de la otra. Si usted incluye una nueva Pestaa desde los Contenedores, esta no se ubicar al lado de la ya existente, sino que se incluir como un nuevo panel.

Copyright 2013 - Bizagi

581

3.4.2.2.2 Layouts

Un layout permite dividir verticalmente el rea de trabajo para organizar la informacin en columnas o secciones. Si se seleccion la Pestaa de Layout, solo podemos realizar acciones pertinentes al diseo del layout, adicin, eliminacin, movimiento o distribucin de columnas. Para agregar ms controles a la forma o moverlos al Layout, usted puede seleccionarlos desde las pestaas de Dato s o Co n tro les. Para incluir un Layout en una forma, seleccione la pestaa de Layout e incluya el Layput deseado a la seccin requerida. Usted puede escoger entre 5 layouts predefinidos que distribuyen la informacin de acuerdo al porcentaje seleccionado. Panel Completo

582

Copyright 2013 - Bizagi

70% 33% 30% 50%

- 30% - 34% - 33% - 70% - 50%

Cuando se incluye un layout, regrese a la pestaa de Datos o Control para poder arrastrar controles dentro de l.

Copyright 2013 - Bizagi

583

As es como los Layouts de arriba se vern el el Diseador de Formas y en el Portal de Trabajo.

Si usted incluye un Layout y el resultado en el Work Portal no es el esperado, usted puede cambiar la distribucin. Seleccione la pestaa de Layout y d clic dentro del Layout a cambiar. En las propiedades del Layout de la izquierda, defina la distribucin que mejor se ajuste a sus controles. D clic en OK y guarde la forma para mantener los cambios.

584

Copyright 2013 - Bizagi

3.4.2.3

rea de Trabajo El rea de trabajo a la derecha es donde usted disea la forma. Usted puede construir la forma requerida incluyendo los atributos desde el Modelo de Datos (que se encuentra en la pestaa de Datos), Controls ( en la pestaa de Controles) y Layouts. Cuando un atributo o control se incluye en el rea de Trabajo, se har referencia a l como control. Cuando usted incluye un atributo o control, los lugares de la forma donde usted puede ubicarlos se resaltarn con una seccin SOLTAR AQU. Simplemente suelte el control deseado cuando la seccin en la que lo desee incluir se active.

Copyright 2013 - Bizagi

585

Los usuarios finales vern la forma en el Portal de Trabajo tal como usted la ve en el rea de Trabajo. Todos los controles obligatorios se resaltarn con una barra vertical roja. Cuando un control es obligartorio, el usuario final no podr avanzar la actividad sin brindar la informacin necesaria. Los Controles de solo lectura no tendrn rea editable. Los Controles se pueden agrupar en Pestaas o Grupos para ayudarle a organizar la informacin.

586

Copyright 2013 - Bizagi

Usted podr fcilmente identificar cada tipo de Control incluido por la forma en que se muestra. En la imagen previa hay tres tipos de control: Un control de texto representado con una etiqueta abc Un combo representado como una lista desplegable. Una fecha representada con una etiqueta de 1/1/1900. 3.4.2.4 Propiedades de las Formas Cada forma en Bizagi tiene propiedades. Estas pueden ser administradas desde una seccin independiente sobre el panel izquierdo, que se accede desde el botn de Propiedades dentro del Ribbon. Para formas reusables, el n o m b re d e m o strar es obligatorio. Para Formas de Proceso, el n o m b re d e m o strar se crea automticamente con el nombre de la Tarea a la cual estn asociadas. El Tex to d e A y u d a y Descrip ci n no son campos obligatorios y se encuentran disponibles nicamente para propsitos de documentacin. La propiedad Es A d m in istrab le se utiliza para convertir la forma a una forma que contiene informacin para administrar entidades paramtricas. La propiedad N ecesita co n firm aci n d e Usu ario se utiliza para mostrar un mensaje al usuario final cuando se da clic en Siguiente, para asegurarse de que el usuario desea continuar el Proceso actual.

Copyright 2013 - Bizagi

587

Esto es muy til debido a que las acciones realizadas una vez se de Sig u ien te, NO SE PUEDEN DESHACER.

3.4.3

Controles
Cada elemento incluido en la Forma es un Control. Hay dos formas de incluir controles dentro de una forma. Los elementos se adicionan de manera individual agregnsolos hacia el Panel Izquierdo. Usted puede arrastrar un atributo desde el modelo de datos y soltarlo dentro de la Forma. Usted puede arrastrar un Control desde la pestaa de Controles y soltarlo dentro de la Forma. Tan pronto como un atributo se inserta en una Forma, este es interpretado por Bizagi como un Control. Cada control tiene un tipo: texto, fecha, combo (lista desplegable), Si/No, nmero, etc, dependiendo del tipo de atributo relacionado. Para eliminar un control, seleccinelo y d clic sobre el icono de cruz roja adjunto al borde del mismo. Para borrar un Control seleccinelo y de clic en el icono de borrado ( Nota Usted puede seleccionar mltiples controles seleccionndolos mientras oprime la tecla Ctrl key, Las ).

588

Copyright 2013 - Bizagi

propiedades disponibles para aplicarle a varios controles al mismo tiempo se mostrarn en el panel izquierdo. Para borrar varios controles seleccinelos y luego presione la tecla Su p r . Por defecto, cada control es visible, editable y no requierdo en Bizagi.

Incluir un atributo a la Forma

Bizagi establece un control especfico para cada tipo de atributo al momento en que este se agrega al rea de trabajo. El tipo de control escogido por Bizagi es el que mejor se ajusta para ser mostrado, en el formato correcto, a los usuarios finales. Usted puede cambiar los tipos de control para ajustarse a sus necesidades. De esta manera cada cada atributo incluido en la forma se convertir en un Control de un tipo especfico. Esto automticamente mantendr la referencia al atributo seleccionado. Por ejemplo, el atributo F ech a d e So licitu d es del tipo Fecha-Hora. Este se incluye como un Control tipo Fecha en la forma. El atributo Ju stificaci n d e la Co m p ra es del tipo Texto. Este se incluye como un Control tipo Texto en la forma. Cuando usted arrastra un atributo relacionado como Clien te, este se incluir como un Control de Bsqueda para permitir a los usuarios finales buscar el cliente deseado.

Incluir un control a la forma

Usted tambin puede insertar un Control desde la pestaa de Controles (en el panel izquierdo). De esta manera, el Control tendr el tipo especificado, pero NO TENDR UNA REFERENCIA AL MODELO DE DATOS. Los controles en la forma deben tener una referencia al modelo de datos. Esta referencia se denomina Fuente de Datos.

Copyright 2013 - Bizagi

589

Cuando un control es insertado en la Forma, sus propiedades se abrirn. Asigne un Nombre de Mostrar adecuado y seleccione la Fuente de Datos que referencia el atributo correcto del modelo de datos.

Tipos de Control
Bizagi ofrece un conjunto de controles predeterminados que usted puede utilizar para crear casi cualquier tipo de forma deseada. Si usted necesita un control ms complejo, usted puede construir uno propio y extender la funcionalidad de las formas utilizando Widgets. CONTROL Botn DESCRIPCIN Se muestra en el Portal de Trabajo como un botn. Cuando se da clic sobre l, la expresin o interfaz asociada se ejecutar. Presenta dos o ms listas desplegables dependientes permitiendo al usuario visualizar nicamente la informacin relevante Una vez se selecciona un valor de la primer lista desplegable, la segunda se llenar automticamente. El ejemplo ms comn es pas y ciudades. Cuando se selecciona un pas, solo las ciudades pertenecientes a l se mostrarn. Presenta una lista desplegable que muestra un conjunto de valores. Solo uno de ellos puede ser seleccionado. Presenta un calendario. La hora se muestra si es necesario.

Lista desplegable en Cascada

Combo

Fecha

Plantillas de Documentos

Define y genera documentos en formato PDF que contienen informacin del Proceso.

590

Copyright 2013 - Bizagi

CONTROL

DESCRIPCIN Se basan en una Plantilla de Word que contiene y muestra diferentes tipos de contenido como imgenes, marcas de agua, formato de caracteres, tablas, etc. Permite cargar archivos a los usuarios finales. Cada uno se maneja como una coleccin de manera que se pueden cargar varios archivos en un mismo atributo. Presenta un vnculo que redirecciona a otra forma. Permite que un atributo se presente en la forma pero no se muestre al usuario final. Esto es til para crear Acciones y Validaciones que incluyen controles que podran no ser necesarios en la forma. Permite cargar y mostrar imgenes. Presenta un texto fijo sin relacin al modelo de datos. Presenta un vnculo que redirecciona a una URL. Este puede estar localizado en intranet o internet. Presenta una lista de valores para una entidad especfica. Solo un valor puede ser seleccionado. Muestra montos monetarios. Muestra datos numricos. Muestra una liste de valores acompaados por un cuadro seleccin donde solo uno de ellos puede ser escogido. Se utiliza para mostrar un nmero pequeo de opciones. Permite ejecutar bsquedas sobre entidades basadas en uno o ms atributos. Una ventana adicional se muestra a los usuarios finales para ingresar los criterios de bsqueda y retornar resultados. Solo un registro se puede seleccionar.

Archivos

Vnculo a Forma

Oculto

Image Etiqueta

Vnculo

Lista

Moneda Nmero

Radio

Campo de Bsqueda

Sugerencia

Busca registros de una entidad y propone datos de entrada a medida que el usuario ingresa el texto. Estas sugerencias se

Copyright 2013 - Bizagi

591

CONTROL

DESCRIPCIN basan en la Fuente de Datos asociada al control. Presenta una tabla que debe ser relacionada a la Coleccin. La tabla debe contener columnas para mostrar. Muestra atributos de tipo texto. Muestra un atributo booleano a los usuarios finales para seleccionar entre las opciones Si o No.

Tabla

Cuadro de Texto

Si/No

3.4.3.1

Botn

Uso
Se muestra en el Portal de Trabajo como un Botn. Cuando se da clic sobre l, la expresin o interfaz asociada se ejecutar.

Consideraciones
Los botones tienen el contexto de la forma donde son creados. En una Forma de Proceso el botn tendr la Entidad de Proceso como contexto. Si usted inserta un botn en una forma reusable anidada, la expresion o interfaz creada tendr el contexto de la entidad de la Forma.

Atributos Relacionados
Este control no se asocia a atributos del modelo de datos. Para utilizarlo usted debe arrastrarlo desde la pestaa de Controles hasta el lugar de la forma donde desee ubicarlo. Luego usted debe configurarlo.

Propiedades
Las siguientes propiedades son exclusivas para el Control Botn:

Pestaa Bsico
PROPIEDAD Etiqueta del Botn DESCRIPCIN El texto ingresado en la Etiqueta del Botn se mostrar dentro del botn.

Regla: Expresin de script asociada al botn. Cuando el usuario final da clic sobre el botn, la expresin ser ejecutada. Ejecucin del Botn

Interfaz: Interfaz asociada al botn. Cuando el usuario final da clic en el botn, la interfaz ser ejecutada.

592

Copyright 2013 - Bizagi

Ejemplo
La fecha de solicitud de una Solicitud de Compra se calcula utilizando un botn. Cuando se da clic en l, la fecha se llenar automticamente. En la forma incluimos un botn. Ingrese la etiqueta del Botn y asocie una expresin que asigne la fecha de hoy a un atributo dentro de la forma.

La expresin tiene el contexto de la Entidad de Proceso.

Copyright 2013 - Bizagi

593

En el Portal de Trabajo el botn se mostrar con la etiqueta dada. Cuando se d clic sobre l, la expresin asociada llenar la fecha de solicitud.

594

Copyright 2013 - Bizagi

3.4.3.2

Lista desplegable en Cascada

Uso
Presenta dos o ms listas desplegables dependientes permitiendo al usuario visualizar nicamente la informacin relevante. Una vez se selecciona un valor de la primer lista desplegable, la segunda se llenar automticamente. El ejemplo ms comn es pas y ciudades. Cuando se selecciona un pas, solo las ciudades pertenecientes a l se mostrarn. Inserte el atributo en la Forma. Luego, d clic sobre l y utilice la opcin Convertir a para convertirlo a una Lista desplegable en Cascada. Bizagi insertar automticamente la entidad(es) padre. Usted tambin puede insertar una Lista desplegable en Cascada desde la pestaa de controle y luego asociarla a una Fuente de Datos.

Consideraciones
Las Listas desplegables en Cascada aplican exclusivamente para entidades Paramtricas. El atributo que debe ser relacionado al modelo de datos es el hijo de la relacin. Por ejemplo, si se desea mostrar el combo Pas-Ciudad, el atributo Ciudad es el que debe ser relacionado en el modelo de datos. El atributo hijo DEBE tener una Entidad Padre. Siempre asigne un atributo de mostrar a la Lista desplegable en Cascada.

Atributos Relacionados
Este control es asociado a Entidades Paramtricas.

Copyright 2013 - Bizagi

595

Propiedades
Las siguientes son propiedades exclusivas para el control de Lista desplegable en Cascada:

Pestaa Bsico
PROPIEDAD Atributo de Mostrar DESCRIPCIN Define el atributo de la entidad que ser mostrada en el Portal de Trabajo. Por ejemplo, si Ciudad tiene tres atributos: Nombre de la Ciudad, Cdigo del rea de la Ciudad e Iniciales de la Ciudad, el atributo de mostrar puede ser el nombre de la ciudad de manera que el usuario pueda identificar fcilmente la ciudad.

Atributo Adicional

Define un atributo adicional para mostrar en el combo. Este sigue al atributo de mostrar y esta separado con un guion. El atributo adicional aplica para la entidad hija nicamente.

Ejemplo de Atributo de Mostrar y Atributo Adicional

596

Copyright 2013 - Bizagi

Pestaa Avanzado
PROPIEDAD Actualizar al Cambio DESCRIPCIN Cuando se selecciona, una vez el usuario final seleccione un valor del control, la forma se refrescar y ejecutar todas las Acciones, validaciones y reglas de visibilidad guardando lo que ha sido ingresado. Esta propiedad aplica para el atributo hijo nicamente.

Ordenar por Atributo

Muestra una lista de todos los atributos de la Entidad Paramtrica. El atributo escogido ordenar ascendentemente la lista mostrada en el atributo hijo.

Nota: Al dar clic en el icono Valo r P red eterm in ad o se reiniciarn las propiedades. Ejemplo Ordenar por

Copyright 2013 - Bizagi

597

Ejemplo
Una lista desplegable en Casada es necesaria para mostrar el Pas, Estado y Ciudad de entrega de una compra. 1. Debido a que esta es una lista desplegable en Cascada de tres niveles, tanto Ciudad como Estado requieren la configuracin de una Entidad Padre. Asegrese de que la Entidad padre de Estados es Pas y que la de Ciudad, Estados.

598

Copyright 2013 - Bizagi

2. Ingrese los valores (o registros) de las entidades Ciudad, Estado y Pas. 3. Asegrese de que el atributo relacionado al modelo de datos es el ltimo atributo de la lista desplegable en cascada. Para esta caso es Ciudad. Inserte la Ciudad en la forma. Bizagi automticamente incluir los atributos Estado y Pas.

Copyright 2013 - Bizagi

599

4. Asigne un Nombre de mostrar al control. Se lo desea, usted puede definir un atributo adicional y configurar las propiedades de la pestaa Avanzado.

5. Vaya al Portal de Trabajo para probar la Lista desplegable en cascada.

600

Copyright 2013 - Bizagi

3.4.3.3

Combo

Uso
Presenta una lista desplegable que muestra un conjunto de valores. Solo uno de ellos puede ser seleccionado.

Consideraciones
Configure siempre un Atributo de Mostrar para el Combo.

Atributos Relacionados
Los combos se relacionan usualmente a entidades paramtricas, como atributos relacionados, para mostrar una lista de valores contenidos en ella. Sin embargo, los combos tambin pueden ser relacionados a Entidades Maestras y del Sistema. Sea cuidadoso al relacionar combos a Entidades Maestras; recuerde que estas contienen informacin de casos y por lo tanto tienden a crecer mucho. Mostrar una lista muy grande se puede volver poco amigable para los usuarios finales.

Propiedades
Las siguientes son propiedades exclusivas del control Combo:

Pestaa Bsico

Copyright 2013 - Bizagi

601

PROPIEDAD Atributo de Mostrar

DESCRIPCIN Define el atributo de la entidad que ser mostrada en el Portal de Trabajo. Por ejemplo, si Ciudad tiene tres atributos: Nombre de la Ciudad, Cdigo del rea de la Ciudad e Iniciales de la Ciudad, el atributo de mostrar puede ser el nombre de la ciudad de manera que el usuario pueda identificar fcilmente la ciudad.

Atributo Adicional

Define un atributo adicional para mostrar en el combo. Este sigue al atributo de mostrar y esta separado con un guion.

Ejemplo de Atributo de Mostrar y Atributo Adicional

Pestaa Avanzado

602

Copyright 2013 - Bizagi

PROPIEDAD Valor por Defecto

DESCRIPCIN Asigna un valor por defecto de manera que el usuario no tenga que seleccionarlo tan pronto como se abra la forma por primera vez. Apenas se selecciona un valor, el valor por defecto se remplazar. Si el atributo tiene un valor que ha sido calculado utilizando un expresin, el valor por defecto se ignorar. En los combos usted puede asignar un valor por defecto utilizando una expresin.

Actualizar al Cambio

Cuando se selecciona, una vez el usuario final seleccione un valor del control, la forma se refrescar y ejecutar todas las Acciones, validaciones y reglas de visibilidad guardando lo que ha sido ingresado.

Ordenar por Atributo

Muestra una lista de todos los atributos de la Entidad Paramtrica. El atributo escogido ordenar ascendentemente la lista mostrada en el atributo hijo.

Filtro

Permite definir un subconjunto de valores, de la lista de todos los valores posibles en la entidad relacionada, para ser mostrados en el combo. Una expresin booleana define una condicin que Bizagi evala para decidir cuales registros cumplen con las condiciones para ser mostrados u ocultos.

Nota: Al dar clic en el icono Valo r P red eterm in ad o se reiniciarn las propiedades. Ejemplo de Ordenar por

Copyright 2013 - Bizagi

603

Ejemplo
En un proceso de Solicitud de Compra es necesario seleccionar una Centro de costo de la compaa, para identificar a cual se cargar la compra. Un Combo de Centro de costo se requiere para que el usuario final seleccione un valor, en la actividad de Solicitar Compra. 1. Usted necesita una entidad paramtrica que contenga los valores de los Centros de Costo disponibles en la compaa. Debe haber un atributo en la Entidad de Proceso apuntando a la Entidad Paramtrica: esto se har utilizando una relacin de atributo relacionado entre la Solicitud de Compra (Entidad de Proceso) y Centro de Costo (Entidad paramtrica).

604

Copyright 2013 - Bizagi

2. Ingrese los valores (o registros) de la entidad Centro de Costo. 3. En el diseador de formas identifique el atributo Centro de Costo. Insertelo en el rea de trabajo. Cuando usted inserta un atributo con una entidad relacionada, Bizagi lo interpretar, por defecto, como un combo.

Copyright 2013 - Bizagi

605

3. Si usted necesita mas controles, agrguelos a la forma. Vaya al Portal de Trabajo y pruebe el control.

3.4.3.4

Fecha

Uso
Presenta un calendario a los usuarios finales para seleccionar una fecha fija. El tiempo en horas y

606

Copyright 2013 - Bizagi

minutos se puede mostrar en caso de ser definido.

Atributos Relacionados
El control tipo Fecha aplica exclusivamente para atributos tipo Fecha-Hora.

Propiedades
Las siguientes son propiedades exclusivas para el control Fecha.

Pestaa de Formato
PROPIEDAD Formato de Fecha DESCRIPCIN Define el formato en el cual el control en cuanto a fechas y horas. Los formatos de Fecha pueden ser: Fecha Corta: Los das, meses y aos se presentan en nmeros (por ejemplo 01/12/2012). Fecha Larga: Los das, meses y aos se presentan en texto (por ejemplo Martes, Diciembre 2012) Mostrar Hora Define si la hora se muestra o no.

Ejemplo de Formato de Fecha Por defecto los controles se muestran en formato de fecha corta. Usted puede cambiar esta configuracin en la propiedad F o rm ato d e F ech a.

Copyright 2013 - Bizagi

607

Note que usted puede seleccionar diferentes configuraciones predefinidas para los formatos de hora y fecha ya sea en formato corto o largo.

Ejemplo Mostrar Hora Cuando se habilita la propiedad Mostrar Hora, el tiempo en horas y minutos se mostraral lado de la fecha en el control Fecha.

608

Copyright 2013 - Bizagi

Pestaa Avanzado
PROPIEDAD Valor por Defecto DESCRIPCIN Asigna un valor por defecto de manera que el usuario no tenga que seleccionarlo tan pronto como se abra la forma por primera vez. Apenas se selecciona un valor, el valor por defecto se remplazar. Si el atributo tiene un valor que ha sido calculado utilizando un expresin, el valor por defecto se ignorar. En los combos usted puede asignar un valor por defecto utilizando una expresin.

Valor Mnimo

Define el valor mnimo que puede ser ingresado.

Valor Mximo

Define el valor mximo que puede ser ingresado.

Nota: Al dar clic en el icono Valo r P red eterm in ad o se reiniciarn las propiedades.

Ejemplo
Se necesita un control Fecha para mostrar la fecha y hora de apertura de una queja en un Proceso de Gestin de quejas y reclamos. Esta fecha se asignar automticamente cuando se cree la queja y no podr ser modificada. 1. Inserte el atributo tipo fecha en la forma arrastrndolo desde el modelo de datos. Este atributo se interpretar en la forma con un control Fecha.

Copyright 2013 - Bizagi

609

2. Como la hora se debe mostrar, vaya a la pestaa de F o rm ato en las propiedades del control y habilite la propiedad M o strar H o ra.

3. Para definir la fecha por defecto de este control (la fecha en la que se crea la queja), vaya a la pestaa A v an zad o , en las propiedades del control, y defina una expresin en la propiedad Valo r p o r d efecto .

610

Copyright 2013 - Bizagi

4. En un mdulo de expresin utilice la sentencia DateTim e.N o w para asignar la fecha en la cual se abre la forma por primera vez, como el valor por defecto de este control.

5. Como la fecha de apertura de la queja no puede ser modificada, vaya a la pestaa B sico y configure la propiedad Ed itab le en N o .

5. Vaya al Portal de Trabajo para probar el control.

Copyright 2013 - Bizagi

611

3.4.3.5

Archivos

Uso
Este control se utiliza para cargar y adjuntar archivos a la aplicacin.

Consideraciones
Un atributo puede almacenar varios archivos El tamao de archivo mximo permitido se define el la Configuracin de Entorno Configuracin de Entorno. Sin embargo, usted puede definir un tamao mximo de archivo personalizado. Usted puede definir el mximo nmero de archivos que pueden ser cargados en un atributo, as como si los archivos pueden ser eliminados o no. Usted puede definir las extensiones vlidas de archivos. Usted puede optar por habilitar el cono para enviar como adjunto para proveer a los usuarios una opcin rpida de envo del archivo por correo electrnico. Los archivos cargados se relacionan al caso donde se adjuntan. Estos no pueden ser vistos ni compartidos entre casos.

Atributos Relacionados
Este control se relaciona exclusivamente a atributos tipo Archivo.

Propiedades
Las siguientes son propiedades exclusivas para el control Archivo.

Pestaa Avanzado

612

Copyright 2013 - Bizagi

PROPIEDAD Permitir Borrar

DESCRIPCIN Esta propiedad habilita/deshabilita una opcin para eliminar archivos cargados.

Mximo de Archivos

Define el nmero mximo de archivos que pueden ser cargados en un control.

Extensiones Vlidas

Define las extensiones de archivo permitidas. Separe las diferentes extensiones utilizando punto y coma (doc; xls; png).

Mximo Tamao (bytes) Habilitar cono de "enviar como adjunto"

Define el tamao mximo (en bytes) permitido para un archivo.

Muestra un cono que permite a los usuarios enviar rpidamente el archivo como adjunto en un correo electrnico.

Nota: Al dar clic en el icono Valo r P red eterm in ad o se reiniciarn las propiedades.

Ejemplo
En un Proceso de Solicitud de Compra, los usuarios finales necesitan cargar una Orden de compra una vez que la solicitud ha sido aprobada. Un control Archivo se requiere en la forma para permitir adjuntar el archivo. El control Archivo debe cumplir con las siguientes condiciones: Para evitar duplicados y errores, solo se puede cargar un archivo Para asegurar la integridad del documento, las ordenes de compra solo pueden ser cargadas en formato PDF El tamao mximo permitido para el documento es de 2.000 bytes. Es deseable que el usuario final pueda eliminar una archivo cargado en caso de haber cometido un error. 1. Usted necesita un atributo tipo Archivo relacionado a la Entidad de Proceso. En este ejemplo crearemos uno denominado Orden de Compra.

Copyright 2013 - Bizagi

613

2. En la forma donde se adjunta la Orden de compra, inserte el atributo tipo Archivo Orden de Compra. Para esto arrstrelo desde el modelo de datos. Esto ser interpretado por Bizagi como un control Archivo en la forma.

2. Solo un archivo podr ser cargado en este control. Para configurar esta condicin, vaya a la pestaa A v an zad o e ingrese "1" en la propiedad M x im o d e A rch iv o s.

614

Copyright 2013 - Bizagi

3. En la propiedad de Ex ten sio n es Vlid as escriba pdf para restringir los archivos adjuntos a formato p d f.

Copyright 2013 - Bizagi

615

4. Defina el tamao mximo permitido escribiendo 2.000 en la propiedad Tam a o M x im o .

5. Finalmente habilite la propiedad P erm itir Elim in ar para activar la opcin Elim in ar.

616

Copyright 2013 - Bizagi

6. Vaya al Portal de Trabajo para probar el control Archivo. D clic sobre el icono de A d ju n tar para cargar un archivo. Una nueva ventana de exploracin se mostrar para buscar y seleccionar el archivo deseado.

Copyright 2013 - Bizagi

617

Cuando el usuario alcanza el nmero mximo de archivos cargados, el icono de adjuntar desaparecer.

Cuando usted esta adjuntando un documento, solo archivos en formato P DF podrn ser seleccionados.

Si usted intenta adjuntar un archivo de mas de 2.000 bytes, la siguiente validacin se mostrar.

Finalmente observe que usted puede eliminar el archivo adjunto dando clic en el icono X que se muestra cuando se ubica el cursor sobre el archivo.

618

Copyright 2013 - Bizagi

3.4.3.6

Archivos ECM

Uso
Este control se utiliza para cargar y adjuntar archivos a la aplicacin, que sern almacenados directamente en un repositorio de ECM (Gestor documental). Para ms informacin acerca de esta posibilidad, consulte Integracin con ECMs.

Consideraciones
Este control maneja atributos tipo Archivo (de manera similar al control Archivos). Esto implica que el control Archivos ECM utiliza el mismo tipo de dato y su funcionalidad es similar a la del control Archivos. La nica diferencia es que Archivos ECM se usa para la integracin con un sistema ECM. Un atributo puede almacenar varios archivos. El tamao de archivo mximo permitido se define el la Configuracin de Entorno Configuracin de Entorno. Sin embargo, usted puede definir un tamao mximo de archivo personalizado. Usted puede definir el mximo nmero de archivos que pueden ser cargados en un atributo, y estos archivos podrn eliminarse (siempre y cuando el control sea definido como editable en la forma). Usted puede definir las extensiones vlidas de archivos. Usted puede optar por habilitar el cono para enviar como adjunto para proveer a los usuarios una opcin rpida de envo del archivo por correo electrnico. Los archivos cargados se relacionan al caso donde se adjuntan. Estos no pueden ser vistos ni compartidos entre casos.

Atributos Relacionados
Este control se relaciona exclusivamente a atributos tipo Archivo.

Propiedades
Las siguientes son propiedades exclusivas para el control A rch iv o s ECM .

Copyright 2013 - Bizagi

619

Pestaa Avanzado
PROPIEDAD Mximo de Archivos DESCRIPCIN Define el nmero mximo de archivos que pueden ser cargados en un control.

Extensiones Vlidas

Define las extensiones de archivo permitidas. Separe las diferentes extensiones utilizando punto y coma (doc; xls; png).

Mximo Tamao (bytes) Habilitar cono de "enviar como adjunto"

Define el tamao mximo (en bytes) permitido para un archivo.

Muestra un cono que permite a los usuarios enviar rpidamente el archivo como adjunto en un correo electrnico.

Ejemplo
El uso de este control requiere de previa configuracin en el mdulo de Sistemas Externos. Esto se hace para registrar el sistema ECM como repositorio de documentos en la solucin. Para ver un ejemplo y mayor informacin, consulte Integracin con ECMs.

620

Copyright 2013 - Bizagi

3.4.3.7

Vnculo a Forma

Uso
Muestra un vnculo en el Portal de Trabajo. Cuando los usuarios dan clic sobre l, una Forma definida se mostrar.

Consideraciones
Este control muestra un vnculo que abre formas creadas en Bizagi. Si usted desea crear vnculos a direcciones URL, consulte Vnculo. Las formas asociadas al vnculo debe ser formas reusables.

Atributos Relacionados
Este control no se relaciona a atributos. Se relaciona directamente a una forma especfica.

Propiedades
Las siguientes son propiedades exclusivas del control Vnculo a Forma:

Pestaa Bsico
PROPIEDAD Abrir maximizado Forma de Adicin DESCRIPCIN Cuando se habilita, la forma asociada se abrir en modo pantalla completa. Define la forma que se abrir cuando los usuarios den clic sobre el vnculo. Usted puede crear una nueva forma o asociar una existente.

Ejemplo
Un Proceso de Gestin de Oportunidades de Venta administra las actiidades necesarias para convertir oportunidades de negocio en negocios reales. Para mostrar solo la informacin relevante a los agentes de ventas que trabajan en un caso, la informacin detallada de los clientes potenciaes se muestra en una forma adicional. Para acceder a esta informacin es necesario incluir un vnculo a esta forma, en las formas de las actividades del Proceso. 1. Abra el diseador de formas e incluya un control Vn cu lo a F o rm a.

Copyright 2013 - Bizagi

621

2. Vaya a la pestaa B asico en las propiedades del control y abra la lista desplegable bajo la propiedad F o rm a A d ici n .

3. Crearemos una nueva forma. Si su forma ha sido creada previamente, seleccinela en la lista. D clic en la opcin N u ev a F o rm a.

622

Copyright 2013 - Bizagi

4. En la nueva forma incluya toda la informacin necesaria desde el modelo de datos. Abra la opcin P ro p ied ad es d e la fo rm a (ubicada en el Ribbon) y asigne un nombre de mostrar a la forma. Guarde la forma y cierre la ventana..

5. Regrese a la forma principal y asigne al Vnculo a Forma, un nombre de mostrar. Guarde la forma.

Copyright 2013 - Bizagi

623

6. Vaya al Portal de Trabajo para probar el control. D clic en el Vnculo a Forma. Note que la forma que configuramos previamente se mostrar en una nueva ventana.

624

Copyright 2013 - Bizagi

3.4.3.8

Oculto

Uso
Permite que un atributo sea incluido en una forma pero sin ser mostrado al usuario final.

Atributos Relacionados
Este control puede ser relacionado a cualquier tipo de atributo. 3.4.3.9 Imagen

Uso
Permite cargar y mostrar imgenes en las formas.

Consideraciones
El propsito de este control es mostrar archivos en formato de imagen (bmp, jpg, png, gif). Sin embargo, usted debe definir las extensiones vlidas en las propiedades del control para validar que los archivos que se adjunten sean imgenes nicamente. Las imgenes deben ser Ed itab les para poder cargar un archivo en el Portal de Trabajo. Si el control no es editable, el usuario final podr ver el control pero no podr cargar o modificar el contenido existente. Los controles de imagen no pueden ser enviados en mensajes de correo electrnico.

Atributos Relacionados
Este control se relaciona exclusivamente a atributos tipo imagen.

Propiedades
Las siguientes son propiedades exclusivas de un control Imagen:

Pestaa de Formato
PROPIEDAD Miniatura de Imagen DESCRIPCIN Define las dimensiones en las cuales se mostrar la imagen. Estas son predefinidas pueden ser 128x128, 64x64 y 32x32 mpx.

Pestaa Avanzado
PROPIEDAD Extensiones Vlidas DESCRIPCIN Define las extensiones de archivo permitidas para imgenes. Separe las diferentes extensiones utilizando punto y coma (png; jpg; gif).

Mximo Tamao (bytes)

Define el tamao mximo (en bytes) permitido para una imagen.

Copyright 2013 - Bizagi

625

Nota: Al dar clic en el icono Valo r P red eterm in ad o se reiniciarn las propiedades.

Ejemplo
En un Proceso de Ingreso de personal, la informacin de un nuevo empleado es ingresada en la primera actividad. Una foto del nuevo empleado es necesaria para crear el perfil de Bizagi, cuenta de correo electrnico, afiliaciones de seguridad social, entre otras. Para cargar una foto, se debe insertar un control de imagen.

1. Usted necesita un atributo tipo imagen en su modelo de datos. Crearemos un atributo denominado F o to d el Em p lead o en la entidad del Proceso.

2. En la forma incluya el atributo F o to d el Em p lead o . Este ser interpretado automticamente por Bizagi como un control Im ag en . Guarde la Forma.

626

Copyright 2013 - Bizagi

3. Vaya al Portal de Trabajo para probar el control. D clic sobre el control y adjunte una imagen.

Observe como se muestra.

Copyright 2013 - Bizagi

627

3.4.3.10 Etiqueta

Uso
Presenta un texto fijo sin relacin al modelo de datos.

Atributos Relacionados
Este control no se relaciona a atributos.

Propiedades
Las siguientes son propiedades exclusivas del control Etiqueta:

Pestaa Bsico
PROPIEDAD Etiqueta DESCRIPCIN Define el texto que se mostrar en la etiqueta. El texto de etiqueta puede ser tan largo como usted lo requiera.

Ejemplo
Un colegio ha implementado un proceso en Bizagi para realizar las pruebas de matemticas. Para mostrar las instrucciones de la prueba, un control Etiqueta se debe insertar en la forma. 1. En la forma inserte un control Etiqueta, el cual se encuentra en la pestaa de Co n tro les.

628

Copyright 2013 - Bizagi

2. En la pestaa B sico de las propiedades del control, identifique la propiedad Etiq u eta.

3. Ingrese el texto deseado en la propiedad. Guarde la forma.

Copyright 2013 - Bizagi

629

4. Vaya al Portal de Trabajo para probar el control.

3.4.3.11 Vnculo

Uso
Muestra un Vnculo en el Portal de Trabajo. Cuando los usuarios finales dan clic sobre l, se abrir una direccin de URL definida.

630

Copyright 2013 - Bizagi

Consideraciones
Este control muestra un Vnculo que dirige a una URL que puede ser de intranet o internet. Si usted desea abrir una forma con un vnculo, consulte Vnculo a Forma. Cuando cree una URL a internet, asegrese de ingresar http:// Si la URL es almacenada en un atributo, asegrese de que la informacin almacenada es correcta de manera que Biazgi pueda resolverla.

Atributos Relacionados
Este control se relaciona a atributos tipo texto.

Propiedades
Las siguientes son propiedades exclusivas del control Vnculo:

Pestaa Bsico
PROPIEDAD Ejecucin DESCRIPCIN Define si la URL del vnculo ser definida por la informacin almacenada en un atributo (fuente de datos) o por una URL fija.

Nota: Al dar clic en el icono Valo r P red eterm in ad o se reiniciarn las propiedades.

Ejemplo
Una compaa almacena los documentos de sus polticas en un servidor interno que puede accederse a travs de intranet desde la siguiente ruta: \\lServer\Policies\Vacation_Policies.pdf Cuando un empleado solicita vacaciones debe leer y aceptar las polticas de vacaciones de la compaa. Para permitir a los usuarios finales acceder a estas polticas, un control Vnculo debe ser insertado en la forma de la solicitud. 1. En la forma inserte un control Vnculo, el cual puede encontrar en la pestaa Co n tro les.

Copyright 2013 - Bizagi

631

2. Vaya a la pestaa Bsico en las propiedades del control y seleccione URL en las propiedades de Ejecucin.

3. Ingrese la ruta fija.

632

Copyright 2013 - Bizagi

4. Asigne un nombre de mostrar al vnculo. Guarde la forma.

4. Vaya al Portal de Trabajo para probar el control.

Copyright 2013 - Bizagi

633

3.4.3.12 Lista

Uso
Presenta una lista de valores para una entidad especfica. Solo un valor puede ser seleccionado.

Consideraciones
Asigne siempre un atributo de mostrar a la lista.

Atributos Relacionados
Las listas se relacionan usualmente a entidades paramtricas, como atributos relacionados, para mostrar una lista de valores contenidos en ella. Sin embargo, las listas tambin pueden ser relacionadas a Entidades Maestras y del Sistema. Sea cuidadoso al relacionar listas a Entidades Maestras; recuerde que estas contienen informacin de casos y por lo tanto tienden a crecer mucho. Mostrar una lista muy grande se puede volver poco amigable para los usuarios finales.

Propiedades
Las siguientes son propiedades exclusivas para el control Lista:

Pestaa Bsico
PROPIEDAD Atributo de Mostrar DESCRIPCIN Define el atributo de la entidad que ser mostrada en el Portal de Trabajo. Por ejemplo, si Ciudad tiene tres atributos: Nombre de la Ciudad, Cdigo del rea de la Ciudad e Iniciales de la Ciudad, el atributo de mostrar puede ser el nombre de la ciudad de manera que el usuario pueda identificar fcilmente la ciudad.

Atributo Adicional

Define un atributo adicional para mostrar en la lista. Este sigue al atributo de mostrar y esta separado con un guion.

634

Copyright 2013 - Bizagi

Ejemplo de Atributo de Mostrar y Atributo Adicional

Pestaa Avanzado

PROPIEDAD Valor por Defecto

DESCRIPCIN Asigna un valor por defecto de manera que el usuario no tenga que seleccionarlo tan pronto como se abra la forma por primera vez. Apenas se selecciona un valor, el valor por defecto se remplazar. Si el atributo tiene un valor que ha sido calculado utilizando un expresin, el valor por defecto se ignorar. En las listas usted puede asignar un valor por defecto utilizando una expresin.

Actualizar al Cambio

Cuando se selecciona, una vez el usuario final seleccione un valor del control, la forma se refrescar y ejecutar todas las Acciones, validaciones y reglas de visibilidad guardando lo que ha sido ingresado.

Ordenar por Atributo

Muestra una lista de todos los atributos de la Entidad Paramtrica. El atributo escogido ordenar ascendentemente la lista mostrada en el atributo hijo.

Filtro

Permite definir un subconjunto de valores, de la lista de todos los valores posibles en la entidad relacionada, para ser mostrados en la lista. Una expresin booleana define una condicin que Bizagi evala para decidir cuales registros cumplen con las condiciones para ser mostrados u ocultos.

Nota: Al dar clic en el icono Valo r P red eterm in ad o se reiniciarn las propiedades.

Copyright 2013 - Bizagi

635

Ejemplo Ordenar por

Ejemplo
En un proceso de Solicitud de Compra es necesario seleccionar una Centro de costo de la compaa, para identificar a cual se cargar la compra. Una lista de Centros de costo se requiere para que el usuario final seleccione un valor, en la actividad de Solicitar Compra. 1. Usted necesita una entidad paramtrica que contenga los valores de los Centros de Costo disponibles en la compaa. Debe haber un atributo en la Entidad de Proceso apuntando a la Entidad Paramtrica; esto se har utilizando una relacin de atributo relacionado entre la Solicitud de Compra (Entidad de Proceso) y Centro de Costo (Entidad paramtrica).

636

Copyright 2013 - Bizagi

2. Ingrese los valores (o registros) de la entidad Centro de Costo. 3. En la forma inserte un control Lista, el cual puede encontrar en la pestaa de Controles.

Copyright 2013 - Bizagi

637

4. En la pestaa B sico de las propiedades del control, identifique la propiedad F u en te d e Dato s.

5. Selecciona la ruta del atributo, esto es, la entidad desde la cual los valores de la lista se referenciarn. En este caso ser la entidad Cen tro d e Co sto .

638

Copyright 2013 - Bizagi

6. Seleccione el atributo de mostrar. En este aso ser el Cen tro d e Co sto .

7. Asigne un nombre de mostrar a la lista.

Copyright 2013 - Bizagi

639

5. Si usted necesita mas controles, agrguelos a la forma luego y gurdelos. Vaya al Portal de Trabajo y pruebe el control.

3.4.3.13 Moneda

Uso
Muestra montos monetarios en la forma.

640

Copyright 2013 - Bizagi

Consideraciones
El smbolo de moneda mostrado, as como los separadores de decimales y miles, se configuran desde la Configuracin de Negocios Configuracin de Negocio. Estas configuraciones se interpretarn como las propiedades por defecto para los controles tipo moneda, a menos que sean cambiadas en cada control individualmente.

Atributos Relacionados
Este control se relaciona a atributos tipo moneda. Este control tambin se relaciona a atributos de tipo numrico. Recuerde que de acuerdo a las caractersticas especficas, los atributos numricos se pueden clasificar en: o o o o o o Entero: Almacena nmeros enteros de hasta 10 dgitos. Entero corto: Almacena nmeros enteros de hasta 5 dgitos. Entero largo: Almacena nmeros enteros de hasta 19 dgitos. Real: Almacena nmeros reales de hasta 38 dgitos decimales. Entero muy corto: Almacena nmeros enteros entre 0 y 255. Flotante: Almacena nmeros reales de hasta 308 dgitos decimales.

Propiedades
Las siguientes son propiedades exclusivas para el control Moneda:

Pestaa de Formato
PROPIEDAD Permitir Decimales Posiciones Decimales DESCRIPCIN Define si el control mostrar dgitos decimales o no. De permitirse decimales, esta propiedad define cuantos decimales se mostrarn en el control.

Pestaa Avanzado

Copyright 2013 - Bizagi

641

PROPIEDAD Valor por Defecto

DESCRIPCIN Asigna un valor por defecto de manera que el usuario no tenga que seleccionarlo tan pronto como se abra la forma por primera vez. Apenas se selecciona un valor, el valor por defecto se remplazar. Si el atributo tiene un valor que ha sido calculado utilizando un expresin, el valor por defecto se ignorar.

Valor Mnimo

Define el valor mnimo que puede ser ingresado.

Valor Mximo

Define el valor mximo que puede ser ingresado.

Nota: Al dar clic en el icono Valo r P red eterm in ad o se reiniciarn las propiedades.

Ejemplo
Una compaa de Transportes y Logstica ha definido un Proceso denominado Proceso de Entrega, para administrar y moniorear envos internacionales de paquetes. La primera tarea de este Proceso le permite a los clientes ingresar le informacin del envo y calcular el costo estimado de los mismos. El costo de envo se calcula con base en las dimensiones, pesos y contenido del pauqete, por loq eu una vez la informacin se ingresa, el cliente da clic en un botn y el costo se mostrar. Para mostrar el costo calculado, un control Moneda se debe insertar en la forma.form. 1. Usted necesita una atributo tipo Moneda en su modelo de datos. Crearemos uno en la Entidad de Proceso y lo llamaremos Co sto Estim ad o .

642

Copyright 2013 - Bizagi

2. En la forma incluya el atributo Co sto . Este se interpretar automticamente en la forma como un control tipo Moneda.

3. Vaya al Portal de Trabajo para probar el control.

Copyright 2013 - Bizagi

643

3.4.3.14 Nmero

Uso
Muestra datos numricos en la forma.

Atributos Relacionados
Este control tambin se relaciona a atributos de tipo numrico. Recuerde que de acuerdo a las caractersticas especficas, los atributos numricos se pueden clasificar en: o o o o o o Entero: Almacena nmeros enteros de hasta 10 dgitos. Entero corto: Almacena nmeros enteros de hasta 5 dgitos. Entero largo: Almacena nmeros enteros de hasta 19 dgitos. Real: Almacena nmeros reales de hasta 38 dgitos decimales. Entero muy corto: Almacena nmeros enteros entre 0 y 255. Flotante: Almacena nmeros reales de hasta 308 dgitos decimales.

Este control tambin puede ser relacionado a atributos tipo moneda. De ser utilizado con monedas, e control se mostrar sin smbolo monetario.

Propiedades
Las siguientes son propiedades exclusivas del control Nmero:

Pestaa de Formato

644

Copyright 2013 - Bizagi

PROPIEDAD Permitir Decimales

DESCRIPCIN Define si el control mostrar dgitos decimales o no. Se recomienda utilizar atributos tipo Real o Flotantes. De permitirse decimales, esta propiedad define cuantos decimales se mostrarn en el control.

Posiciones Decimales

Pestaa Avanzado

PROPIEDAD

DESCRIPCIN

Vuelva a escribir Solicita al usuario a ingresar el valor en el control dos veces. En caso de que estos valores no coincidan al momento de dar clic en Sig u ien te, el valor deber ser reingresado. El valor de verificacin puede ser configurado para ser ingresado de dos formas: Duplicado: Muestra dos controles. Ambos controles deben contener exactamente la misma informacin para continuar. Doble: Solicita al usuario final ingresar el mismo nmero dos veces en el mismo campo. Valor por Defecto Asigna un valor por defecto de manera que el usuario no tenga que seleccionarlo tan pronto como se abra la forma por primera vez. Apenas se selecciona un valor, el valor por defecto se remplazar. Si el atributo tiene un valor que ha sido calculado utilizando un expresin, el valor por defecto se ignorar.

Valor Mnimo

Define el valor mnimo que puede ser ingresado.

Valor Mximo

Define el valor mximo que puede ser ingresado.

Ejemplo propiedad Vuelva a Escribir

Copyright 2013 - Bizagi

645

Ejemplo
En un Proceso de solicitud de Compras es necesario establecer cuantas cotizaciones se necesitan antes de seleccionar un proveedor. El nmero de cotizaciones es un entero. Defina un atributo entero en el modelo de datos e insertelo en la forma.

3.4.3.15 Radio

Uso
Muestra una liste de valores acompaados por un cuadro seleccin donde solo uno de ellos puede ser escogido. Se utiliza para mostrar un nmero pequeo de opciones.

646

Copyright 2013 - Bizagi

Consideraciones
Asigne siempre un Atributo de Mostrar al control Radio.

Atributos Relacionados
Los Radios se relacionan a entidades paramtricas, como atributos relacionados, para mostrar una lista de valores contenidos en ella.

Propiedades
Las siguientes son propiedades exclusivas del control Radio:

Pestaa Bsico
PROPIEDAD Display attribute DESCRIPCIN Defines the attribute of the entity that will display in the Work Portal. For example, if City has three attributes: City name, City Area code, City initials, the Display Attribute can be City name so the end user will easily identify the City. Defines an additional attribute to be shown in the options. It will follow the Display attribute with a dash.

Additional attribute

PROPIEDAD Atributo de Mostrar

DESCRIPCIN Define el atributo de la entidad que ser mostrada en el Portal de Trabajo. Por ejemplo, si Ciudad tiene tres atributos: Nombre de la Ciudad, Cdigo del rea de la Ciudad e Iniciales de la Ciudad, el atributo de mostrar puede ser el nombre de la ciudad de manera que el usuario pueda identificar fcilmente la ciudad.

Atributo Adicional

Define un atributo adicional para mostrar en las opciones. Este sigue al atributo de mostrar y esta separado con un guion.

Ejemplo de Atributo de Mostrar y Atributo Adicional

Copyright 2013 - Bizagi

647

Pestaa Avanzado
PROPIEDAD Valor por Defecto DESCRIPCIN Asigna un valor por defecto de manera que el usuario no tenga que seleccionarlo tan pronto como se abra la forma por primera vez. Apenas se selecciona un valor, el valor por defecto se remplazar. Si el atributo tiene un valor que ha sido calculado utilizando un expresin, el valor por defecto se ignorar. En los combos usted puede asignar un valor por defecto utilizando una expresin.

Actualizar al Cambio

Cuando se selecciona, una vez el usuario final seleccione un valor del control, la forma se refrescar y ejecutar todas las Acciones, validaciones y reglas de visibilidad guardando lo que ha sido ingresado.

Ordenar por Atributo

Muestra una lista de todos los atributos de la Entidad Paramtrica. El atributo escogido ordenar ascendentemente las opciones mostradas.

Filtro

Permite definir un subconjunto de valores, de la lista de todos los valores posibles en la entidad relacionada, para ser mostrados como opciones. Una expresin booleana define una condicin que Bizagi evala para decidir cuales registros cumplen con las condiciones para ser mostrados u ocultos.

Ejemplo
Un colegio ha implementado un proceso en Bizagi para realizar las pruebas de matemticas. Las opciones de respuestas a las preguntas de la prueba se almacenan en entidades paramtricas. Suponga que la prueba tiene 3 preguntas por lo que, se deben crear 3 entidades paramtricas.

648

Copyright 2013 - Bizagi

Cada entidad Respuesta contiene los siguientes atributos: Opciones, Respuesta correcta? y Respuesta.

Para mostrar y habilitar la seleccin de respuestas para las diferentes preguntas, se deben insertar controles tipo Radio en la forma. 1. En la forma inserte un control tipo Radio.

Copyright 2013 - Bizagi

649

2. En la pestaa Bsico de las propiedades del control, identifique la propiedad F u en te d e Dato s.

3. Seleccione la ruta del atributo, es decir, la entidad desde la cual se tomarn los valores para las opciones de radio. Para el caso de la primera pregunta, esta ser la entidad Resp u esta1.

4. Seleccione el atributo de mostrar. En este caso ser O p cio n es.

650

Copyright 2013 - Bizagi

5. Seleccione el atributo adicional para el radio. En esta caso ser Resp u estas.

6. Asigne un nombre de mostrar al control.

Copyright 2013 - Bizagi

651

7. Repita los pasos anteriores para configurar los dems controles de Radio relacionados a las preguntas dos y tres. Cambie la fuente de datos para cada respuesta a Resp u esta2 y Resp u esta3 respectivamente.

8. Vaya al Portal de Trabajo para probar los controles.

652

Copyright 2013 - Bizagi

3.4.3.16 Campo de Bsqueda

Uso
Permite ejecutar bsquedas sobre informacin almacenada en Bizagi.

Consideraciones
Se utiliza una ventana adicional para ingresar los criterios de bsqueda y presentar los resultados de manera que el usuario final pueda seleccionar el deseado. Cuando se selecciona un resultado, Bizagi mostrar todas su informacin relacionada. Las bsquedas son aproximadas. Bizagi buscar sobre todos los registros que contengan las primeras letras ingresadas en los cuadros de texto. Cuando el control es no editable, el usuario final no podr realizar bsqueda alguna.

Atributos Relacionados
Los controles de bsqueda estn relacionados a atributos con relacin a entidades Maestras, Paramtricas o del Sistema. Cuando una Entidad Maestra se inserta en el rea de trabajo, Bizagi la interpretar automticamente como un control de Bsqueda. Para utilizar el control de Bsqueda en una entidad paramtrica o del sistema, d clic derecho sobre el control y luego seleccione Co n tro l d e B sq u ed a dentro de las opciones de Co n v ertir a.

Propiedades
Las siguientes son propiedades exclusivas del control de Bsqueda:

Pestaa Bsico

Copyright 2013 - Bizagi

653

PROPIEDAD Forma de Bsqueda

DESCRIPCIN Define la forma utilizada para realizar bsquedas. Esta forma se divide en dos secciones; los criterios de bsqueda, que incluyen atributos de la entidad donde el usuario final ingresar los datos para buscar, y los resultados de bsqueda, que incluyen los atributos que mostrarn la informacin de los registros encontrados.

Atributo de Mostrar

Define el atributo de la entidad que se mostrar en el Portal de Trabajo cuando se selecciona un resultado.

Pestaa Avanzado

PROPERTY Actualizar al Cambio

DESCRIPTION Cuando se selecciona, una vez el usuario final seleccione un valor del control, la forma se refrescar y ejecutar todas las Acciones, validaciones y reglas de visibilidad guardando lo que ha sido ingresado. Habilita a los usuarios finales la opcin de limpiar la informacin cargada en una bsqueda previa. Habilita a los usuarios finales la opcin de ingresar datos, cuando hay certeza de que un registro existe, sin tener que buscarlo. Define el nmero mximo de resultados para mostrar en la seccin de resultados. Por defecto, Bizagi muestra 20 registros. Permite definir un subconjunto de valores, de la lista de todos los valores posibles en la entidad relacionada. Una expresin booleana define una condicin que Bizagi evala para decidir cuales registros cumplen con las condiciones para ser mostrados u ocultos.

Permitir Limpiar

Permitir Digitar

Mximo de Registros Filtro

Permitir crear registros Forma para creacin

Habilita la posibilidad de agregar nuevos registros a la entidad donde se realiza la bsqueda. Muestra la forma donde se ingresan todos los datos de un nuevo registro de la entidad. cuando se permiten nuevos registros, esta propiedad es requerida.

Ejemplo Permitir Limpiar

654

Copyright 2013 - Bizagi

Ejemplo
En un Proceso de Solicitud de Compras es necesario buscar el Cliente. Por lo tanto, se necesita un control de Bsqueda. 1. Usted necesita una entidad Maestra donde se almacene la informacin de todos los clientes. Debe haber un atributo en la Entidad de Proceso apuntando a la entidad Maestra; esto se hace asociando un atributo que este relacionado a la entidad Maestra.

Copyright 2013 - Bizagi

655

2. En el Diseador de Formas identifique e atributo creado (Cliente). Insertelo en el rea de trabajo. Cuando usted inserta un atributo que posee una relacin con una entidad Maestra, este ser interpretado automticamente por Bizagi, por defecto, como un control de Bsqueda.

3. Seleccione una Forma de Bsqueda y un Atributo de mostrar. En este caso, la forma de bsqueda se cre previamente y el Atributo de mostrar ser el nombre del cliente.

656

Copyright 2013 - Bizagi

4. Habilite la opcin de Nuevos Registros y seleccione una Forma de Adicin de Registros.

Copyright 2013 - Bizagi

657

5. Incluya en la forma los atributos de la entidad Maestra (Cliente) que desee mostrar. Incluiremos el gnero del cliente y su nmero telefnico. Estos no sern editables debido a que no queremos que sean modificados una vez se carguen.

658

Copyright 2013 - Bizagi

6. En el Portal de Trabajo, el control de Cliente ser un control de bsqueda, donde los usuarios finales pueden bscar por criterios dados y seleccionar el registro que coincida con sus requerimientos.

7. En caso de que se deba crear un nuevo registro, este estar disponible dentro de la forma de bsqueda.

Copyright 2013 - Bizagi

659

3.4.3.16.1 Forma de Bsqueda

Las forma de Bsqueda de un control de Bsqueda es una propiedad requerida donde se disean los criterios de bsqueda y los resultados de la misma.. D clic en la lista desplegable y seleccione: Nueva Forma: Esta opcin abrir una nueva ventana de Diseador de Formas, donde usted puede ingresar todos los controles requeridos. El contexto de esta nueva forma es la entidad donde se ejecuta la bsqueda. Cuando se guarda, se almacenar como una forma reusable, es decir, podr ser utilizada como Forma de Bsqueda para otro control, en otra forma. Asigne siempre a esta nueva forma un nombre de mostrar dando clic en la opcin P ro p ied ad es que se encuentra en el Ribbon. Una Forma existente: Si la Forma ha sido creada previamente, seleccinela de la lista.

660

Copyright 2013 - Bizagi

La forma se divide en dos secciones, los criterios de bsqueda y los resultados. Usted puede utilizar los mismos atributos de la entidad en ambas secciones o utilizar unos diferentes. Estos son independientes. Incluyalos en cada seccin. Asigne a esta nueva forma un nombre de mostrar dando clic en la opcin P ro p ied ad es, que se encuentra en el Ribbon. Guarde la forma y luego cirrela para regresar a la forma principal.

Copyright 2013 - Bizagi

661

Cuando el usuario final da clic sobre el icono de bsqueda en el Portal de Trabajo, la forma de Bsqueda se mostrar. Ingrese la informacin y selecione el registro deseado.

662

Copyright 2013 - Bizagi

3.4.3.16.2 Forma de Adicin de Registros

Se pueden crear nuevos registros para la entidad donde la bsqueda se realiza, a travs de una Forma de creacin de registros.

En la pestaa Avanzado del control de Bsqueda habilite la propiedad Permitir crear registros. Esto habilitar la propiedad F o rm a d e creaci n . D clic en la lista desplegable y seleccione: Nueva Forma: Esta opcin abrir una nueva ventana de Diseador de Formas, donde usted puede ingresar todos los controles requeridos. El contexto de esta nueva forma es la entidad donde se ejecuta la bsqueda. Cuando se guarda, se almacenar como una forma reusable, es decir, podr ser utilizada como Forma de creacin para otro control, en otra forma. Asigne siempre a esta nueva forma un nombre de mostrar dando clic en la opcin P ro p ied ad es que se encuentra en el Ribbon. Una Forma existente: Si la Forma ha sido creada previamente, seleccinela de la lista.

Copyright 2013 - Bizagi

663

Inserte todos los atributos requeridos para el nuevo registro. Asigne a esta nueva forma un nombre de mostrar, dando clic sobre la opcin P ro p ied ad es que se encuentra en el Ribbon. Guarde la forma y luego cirrela para regresar a la fomra principal.

664

Copyright 2013 - Bizagi

Cuando se permiten nuevos registros, el usuario encontrar un botn de A g reg ar dentro de la Forma de Bsqueda. Este abrir una ventana emergente donde el usuario final deber ingresar toda la informacin requerida para el nuevo registro. Cuando la informacin del nuevo registro ha sido ingresada, usted puede realizar la bsqueda con el criterio que recin ingres.

Copyright 2013 - Bizagi

665

Nota La propiedad Habilitar "enviar como adjunto" del control Archivo no est soportada dentro de la forma de adicin de registros. 3.4.3.17 Sugerencia

Uso
Con este control Bizagi predice la palabra que el usuario final desea ingresar, sin necesidad de que la ingrese completamente.

Consideraciones
Funciona para usuarios finales que conocen el inicio de la palabra que estan buscando (escribiendo las primeras letras). Si usted necesita mostrar informacin acerca del registro encontrado, el control debe tener la Propiedad A ctu alizar al Cam b io habilitada.

Atributos Relacionados
Los controles de Sugerencia estn relacionados a atributos con relacin a entidades Maestras,

666

Copyright 2013 - Bizagi

Paramtricas o del Sistema. Para utilizar el control Sugerencia, inserte el atributo relacionado en el rea de trabajo y luego d clic derecho sobre el control. Seleccione la opcin Co n v ertir a y luego d clic sobre la opcin Su g eren cia.

Propiedades
Las siguientes son propiedades exclusivas para el control Sugerencia:

Pestaa Bsico
PROPIEDAD Atributo de Mostrar DESCRIPCIN Define el atributo de la entidad donde el control buscar un resultado.

Pestaa Avanzado
PROPIEDAD Actualizar al Cambio DESCRIPCIN Cuando se selecciona, una vez el usuario final seleccione un valor del control, la forma se refrescar y ejecutar todas las Acciones, validaciones y reglas de visibilidad guardando lo que ha sido ingresado. Cuando se habilita, la bsqueda se realizar para coincidir con CUALQUIER parte del contenido del Atributo de Mostrar. Por ejemplo, buscar sobre la entidad Cliente en el atributo Nombre. Hay un cliente llamado Julie Jackson. Si el usuario final escribe acks, Biagi encontrar un registro debido a que ese texto se encuentra dentro del nombre. Si la propiedad es deshabilitada, Bizagi NO encontrar un registro.

Permitir Bsqueda Completa

Permitir Limpiar

Habilita a los usuarios finales la opcin de limpiar la informacin cargada en una bsqueda previa. Define el nmero mximo de resultados para mostrar en la seccin de resultados. Permite definir un subconjunto de valores, de la lista de todos los valores posibles en la entidad relacionada. Una expresin booleana define una condicin que Bizagi evala para decidir cuales registros cumplen con las condiciones para ser mostrados u ocultos.

Mximo de Registros Filtro

Ejemplo de Permitir Limpiar

Copyright 2013 - Bizagi

667

Ejemplo
En un Proceso de Solicitud de Compras es necesario buscar el Cliente. Por lo tanto, se necesita un control de Sugerencia. 1. Usted necesita una entidad Maestra donde se almacene la informacin de todos los clientes. Debe haber un atributo en la Entidad de Proceso apuntando a la entidad Maestra; esto se hace asociando un atributo que este relacionado a la entidad Maestra

668

Copyright 2013 - Bizagi

2. En el Diseador de Formas identifique e atributo creado (Cliente). Insertelo en el rea de trabajo. Cuando usted inserta un atributo que posee una relacin con una entidad Maestra, este ser interpretado automticamente por Bizagi, por defecto, como un control de Bsqueda.

3. D clic derecho sobre el control y seleccione Co n v ertir a. Luego seleccione la opcin Su g eren cia.

Copyright 2013 - Bizagi

669

4. En las propiedades Bsicas del control Sugerencia, seleccione el atributo de mostrar deseado. En esta caso ser el nombre del Cliente.

670

Copyright 2013 - Bizagi

5. Incluya en la forma los atributos de la entidad Maestra (Cliente) que desee mostrar. Incluiremos el gnero del cliente y su nmero telefnico. Estos no sern editables debido a que no queremos que sean modificados una vez se carguen.

6. En las propiedades Avanzadas del control habilite las propiedades A ctu alizar al Cam b io , P erm itir

Copyright 2013 - Bizagi

671

b sq u ed a co m p leta y P erm itir b o rrar.

7. En el Portal de Trabajo, el control de Cliente ser un control de Sugerencia, donde los usuarios finales pueden buscar, ingresando un par de letras, y Bizagi mostrar los registros que cumplan con lo que ha sido ingresado.

672

Copyright 2013 - Bizagi

8. Observe que utilizando la propiedad de A ctu alizar al Cam b io , los atributos gnero y telfono se cargan tan pronto como el usuario selecciona un registro.

3.4.3.18 Tabla

Uso
Presenta una tabla con columnas definidas en el Diseador de Formas y filas con registros de acuerdo a cada Caso. Arrastre una Coleccin desde la pestaa de Dato s hasta el rea de Trabajo para crear una tabla. D clic en Ed itar Co lu m n as para crear las columnas de la tabla. Inserte los atributos deseados en la tabla de la nueva ventana. Podemos navegar en el modelo de datos desde la entidad-muchos de la coleccin.

Consideraciones
Por defecto las tablas tienen la habilidad de agregar nuevos registros y eliminar existentes. Si la propiedad Editable es deshabilitada, los usuarios finales NO podrn agregar, aadir o eliminar registros.

Copyright 2013 - Bizagi

673

Las validaciones de la tabla son independientes desde la opcin de Acciones y Validaciones de las formas.

Agregar registros
Los registros se pueden aadir En ln ea, la cual es una manera rpida de crear y llenar un nuevo registro. Los registros se pueden aadir con una F o rm a d e A d ici n independiente. Esta lleva al usuario a una nueva ventana, para llenar una gran cantidad de informacin o informacin compleja que debe ser validada. Las opciones de creacin de registros En ln ea o con F o rm a d e A d ici n son excluyentes.

Editar registros
Los registros se pueden editar En ln ea, la cual es una manera rpida de editar registros existentes. Los registros se pueden editar con una F o rm a d e Ed ici n independiente. Esta lleva al usuario a una nueva ventana, para llenar una gran cantidad de informacin o informacin compleja que debe ser validada. Las opciones de edicin de registros En ln ea o con F o rm a d e Ed ici n son excluyentes.

Opciones de Detalle
Usted puede crear una F o rm a d e Detalle para mostrar informacin de solo lectura en una forma separada.

Atributos Relacionados
Las tablas estn relacionadas a Colecciones que requieren una relacin uno a muchos.

Propiedades
Las siguientes son propiedades exclusivas para el control Tabla:

Pestaa Bsico
PROPIEDAD Editable DESCRIPCIN La propiedad Editable puede ser habilitada, deshabilitada o definida en una expresin. Si esta deshabilitada, el usuario no podr agregar, editar o eliminar registros, solo podr acceder a Forma de Detalle donde se muestran atributos de solo lectura.

Pestaa de Formato
PROPIEDAD Filas por pgina DESCRIPCIN Configura el nmero de filas visualizadas por pgina. Por defecto Bizagi mostrar 20 filas por pgina.

Ejemplo Filas por pgina

674

Copyright 2013 - Bizagi

La siguiente tabla tiene cuatro registros o filas creadas. Cuando la Propiedad Filas por pgina se cambia a 3, Bizagi pagina la tabla, cada pgina conteniendo de 1 a 3 registros.

Pestaa Avanzado

Copyright 2013 - Bizagi

675

PROPIEDAD Ordenar por atributo

DESCRIPCIN Ordena las filas de la tabla de acuerdo al valor de los atributos seleccionados de la entidad de coleccin, de forma ascendente.

Filtro

Permite definir un subconjunto de valores, de la lista de todos los registros de la tabla, para ser mostrados. Una expresin booleana define una condicin que Bizagi evala para decidir cuales registros cumplen con las condiciones para ser mostrados u ocultos. Le permite crear reglas de validacin para este control, que sern verificadas en tiempo de ejecucin. La eliminacin de registros se administra en las opciones de borrado. Por defecto, se permite eliminacin de registros. Tambin se puede definir un tooltip personalizado que se muestra cuando el usuario final ubica el cursor sobre el icono de eliminacin en el Portal de Trabajo.

Validaciones de tabla Opciones de Borrado

Opciones de Adicin

Habilita la adicin de registros a la tabla. Por defecto, la adicin En lnea esta habilitada. Si la adicin no es En lnea, se requerir de una forma emergente, denominada F o rm a d e A d ici n para mostrar en el Portal de Trabajo. Las Validaciones pueden ser ejecutadas cuando se adicionan registros con una Forma de Adicin. Estas se ejecutan cuando el usuario da clic en el botn Gu ard ar en la ventana emergente.

Opciones de Fila

El grupo se divide en dos secciones, denominadas Ed itar y Detalles. Permitir la edicin de filas implica que usted no puede modificar la informacin relacionada a un registro. Editar Por defecto, las ediciones no se permiten. Usted puede editar registros En lnea o con una ventana emergente ( F o rm a d e Ed ici n ). Las Validaciones pueden ser ejecutadas cuando se editan registros con una Forma de Edicin. Estas se ejecutan cuando el usuario da clic en el botn Gu ard ar en la ventana emergente. Detalle Usted puede especificar una vista de solo lectura de las filas. Si esta propiedad esta habilitada, usted puede crear o seleccionar una forma emergente para mostrar.

Ejemplo Ordenar por

676

Copyright 2013 - Bizagi

3.4.3.18.1 Editar Columnas

Para crear una tabla en una Forma, incluya un atributo de coleccin en el rea de trabajo. Bizagi interpretar este tipo de atributo como un control de Tabla. Luego, usted tendr que agregar las columnas a su tabla, para esto d clic en la opcin Ed itar Co lu m n as.

Copyright 2013 - Bizagi

677

Una nueva ventana se mostrar. En esta los atributos de la coleccin estarn disponibles en el panel izquierdo. Para aadirlos como columnas, usted puede arrastrarlos desde el panel izquierdo hasta el rea de trabajo o hacer doble clic sobre ellos. Cuando todas las columnas han sido aadidas, d clic en O K.

678

Copyright 2013 - Bizagi

Propiedades de columna
Las columnas poseen las mismas propiedades relacionadas al tipo de control (datos) que muestran. Adicional a estas, las siguientes propiedades son exclusivas de las columnas.

Pestaa Bsico
PROPIEDAD Visible Editable Requerido Celda editable DESCRIPCIN Define si toda la columna es visible o no. Define si toda la columna es de solo lectura o no. Define si toda la columna es requerida o no. Define una expresin para evaluar condiciones a nivel de fila y establecer si una celda especfica es editable o no. Para mayor informacin consulte Configurar visibilidad y editabilidad de celdas Define una expresin para evaluar condiciones a nivel de fila y establecer si una celda especfica se muestra o no. Para mayor informacin consulte Configurar visibilidad y editabilidad de celdas

Celda visible

Pestaa Avanzado

Copyright 2013 - Bizagi

679

PROPIEDAD Totalizador

DESCRIPCIN Permite definir funciones de agregacin a la columna, con el fin de obtener un valor nico que se mostrar al final de la columnas. Para mayor informacin consulte Totalizadores

3.4.3.18.2 Totalizadores

Los To talizad o res son funciones de agregacin que pueden ser aplicadas a columnas incluidas en una tabla, con el fin de obtener un valor nico, que se mostrar en la parte inferior de la columna a la cual se aplica. Las funciones agregadas disponibles son: Cuenta: Devuelve el nmero total de registros de una columna. Max: Devuelve el valor mximo de los registros de una columna. Min: Devuelve el valor mnimo de los registros de una columna. Promedio: Devuelve el promedio de los registros de una columna. Suma: Devuelve el valor total de los registros de una columna. Los Totalizadores estn disponibles en las propiedades avanzadas de las columnas, dentro del men de edicin de tablas.

Para totalizar una columna de una tabla, seleccione la tabla que contiene la columna a totalizar y d clic en el botn Ed itar Co lu m n as. En la ventana de Ed ici n d e Co lu m n as, seleccione la columna a totalizar y vaya a la P esta a A v an zad a de las propiedades de la columna. Seleccione la funcin de agregacin deseada, bajo la opcin To talizad o r.

680

Copyright 2013 - Bizagi

Nota Los Totalizadores estn disponibles para los atributos nmericos como: enteros o moneda.

Ejemplo de uso de Totalizadores

En un Proceso de Solicitud de Compras es deseable que se muestre el valor total de los productos solicitados en la parte inferior de la tabla P ro d u cto s so licitad o s. Configuraremos entonces un Totalizador para la columna P recio de la grilla mencionada anteriormente. 1. Vaya a la forma de la actividad y seleccione la tabla P ro d u cto s So licitad o s, luego d clic en el botn Ed itar Co lu m n as.

2. En la nueva ventana, seleccione la columna P recio To tal y vaya a las P ro p ied ad es A v an zad as.

Copyright 2013 - Bizagi

681

3. En la lista desplegable de O p erad o r seleccione la funcin Su m a.

682

Copyright 2013 - Bizagi

4. Opcionalmente puede dar formato al valor totalizado. Cambie su tamao de fuente, color y fondo segn lo desee.

5. Ahora vaya al Portal de Trabajo para probar el Totalizador. Observe como se muestra.

Copyright 2013 - Bizagi

683

3.4.3.18.3 Agregar Registros

Agregar registros a una tabla requiere que: La propiedad Editable en la pestaa Bsico, este habilitada. La propiedad Permitir Adicin en la pestaa Avanzado, esta habilitada. Escoger entre adicin En lnea o adicin con Forma. Estas son propiedades excluyentes. Cuando la adicin En lnea esta deshabilitada se debe configurar una Forma de Adicin.

Adicin En lnea
La adicin En lnea permite al usuario final agregar un registro directamente en la tabla, sin ingresar valores en una ventana diferente. Estas opcin no permite validaciones

684

Copyright 2013 - Bizagi

Cuando la propiedad En ln ea esta habilitada, la tabla mostrar un icono de Adicin (+) en el Portal de Trabajo.

D clic en el icono de Adicin. Se crear un nuevo registro con todas las columnas vacias.

Ingrese la informacin de las columnas. Para guardar esta informacin d clic en el icono de Gu ard ar. Para descartar los cambios, d clic en Can celar. Si usted no da clic en Gu ard ar y abandona la pgina, perder sus cambios.

Adicin con Forma

La adicin con forma permite al usuario final agregar un registro ingresando la informacin relacionada en una ventana emergente. Esto es muy til cuando la informacin a ingresar en el nuevo registro es compleja, larga o requiere validaciones.

Copyright 2013 - Bizagi

685

D clic en la lista desplegable y seleccione:

Nueva Forma: Esta opcin abrir una nueva ventana de Diseador de Formas, donde usted puede ingresar todos los controles requeridos. El contexto de esta nueva forma es la entidad Coleccin. Cuando se guarda, se almacenar como una forma reusable, en la entidad de coleccin,es decir, podr ser utilizada como Forma de adicin para otra Tabla, en otra forma. Asigne siempre a esta nueva forma un nombre de mostrar dando clic en la opcin P ro p ied ad es que se encuentra en el Ribbon. Una Forma existente: Si la Forma ha sido creada previamente, seleccinela de la lista.

686

Copyright 2013 - Bizagi

Una vez definida la F o rm a d e A d ici n , guarde la Forma Padre. En el Portal de Trabajo, la tabla mostrar un icono de Adicin (+)

D clic en el icono de Adicin. Una nueva ventana se abrir para ingresar la informacin del nuevo registro.

Ingrese la informacin y d clic en Gu ard ar para mantener los cambios.

Copyright 2013 - Bizagi

687

3.4.3.18.4 Ediar Registros

Editar registros de una tabla requiere que: La propiedad Editable en la pestaa Bsico, este habilitada. La propiedad Permitir Edicin en la pestaa Avanzado, esta habilitada. Escoger entre edicin En lnea o adicin con Forma. Estas son propiedades excluyentes. Cuando la edicin En lnea esta deshabilitada, se debe configurar una Forma de Edicin. Cuando la edicin En lnea esta habilitada, las columnas de la tabla deben estar configuradas como editables para poder modificarlas.

688

Copyright 2013 - Bizagi

Copyright 2013 - Bizagi

689

Edicin En lnea
La edicin En lnea permite al usuario final editar un registro directamente en la tabla, sin ingresar valores en una ventana diferente. Estas opcin no permite validaciones Cuando la propiedad En ln ea esta habilitada, la tabla mostrar un icono de Edicin (lpiz) en el Portal de Trabajo. Seleccione un registro y d clic en el icono de Edicin. Las columnas editables estarn disponibles para ser modificadas.

Edicin con Forma

La edicin con forma permite al usuario final editar un registro existente ingresando la informacin

690

Copyright 2013 - Bizagi

relacionada en una ventana emergente. Esto es muy til cuando la informacin a ingresar en el nuevo registro es compleja, larga o requiere validaciones.

D clic en la lista desplegable y seleccione: Nueva Forma: Esta opcin abrir una nueva ventana de Diseador de Formas, donde usted puede ingresar todos los controles requeridos para la edicin de registros. El contexto de esta nueva forma es la entidad Coleccin. Cuando se guarda, se almacenar como una forma reusable, en la entidad de coleccin,es decir, podr ser utilizada como Forma de edicin para otra Tabla, en otra forma. Asigne siempre a esta nueva forma un nombre de mostrar, dando clic en la opcin P ro p ied ad es que se encuentra en el Ribbon. Una Forma existente: Si la Forma ha sido creada previamente, seleccinela de la lista.

Copyright 2013 - Bizagi

691

Una vez definida la F o rm a d e Ed ici n , guarde la Forma Padre. En el Portal de Trabajo, la tabla mostrar un icono de Edicin (lpiz)

Seleccione el registro a editar y luego d clic en el icono de Edicin. Una nueva ventana se abrir para editar la informacin deseada.

692

Copyright 2013 - Bizagi

Edite la informacin y d clic en Gu ard ar para mantener los cambios.

3.4.3.18.5 Detalle de Registros

Usted puede configurar una Forma de Detalles para permitir a los usuarios finaliza la visualizacin de informacin adicional de cada registro de una tabla, en modo de solo lectura. De esta manera podrn tener acceso a la informacin, pero no podrn modificarla. Tenga en cuenta que usted puede configurar la Forma de Detalle y la Forma de Edicin. De esta manera los usuarios tendrn acceso a la informacin en modo de solo lectura y de ser necesario, tambin podrn modificarla. Estas formas son independientes. La forma de detalles requiere que: Las opciones de Detalle estn habilitadas. Se defina una Forma de Detalle.

Copyright 2013 - Bizagi

693

Habilite la opcin Detalle, d clic en la lista desplegable y seleccione: Nueva Forma: Esta opcin abrir una nueva ventana de Diseador de Formas, donde usted puede ingresar todos los controles requeridos para la Forma de detalle. El contexto de esta nueva forma es la entidad Coleccin. Cuando se guarda, se almacenar como una forma reusable, en la entidad de coleccin,es decir, podr ser utilizada como Forma de Detalle para otra Tabla, en otra forma. Asigne siempre a esta nueva forma un nombre de mostrar, dando clic en la opcin P ro p ied ad es que se encuentra en el Ribbon. Una Forma existente: Si la Forma ha sido creada previamente, seleccinela de la lista.

694

Copyright 2013 - Bizagi

Una vez definida la F o rm a d e Detalle, guarde la Forma Padre. En el Portal de Trabajo, la tabla mostrar un icono de Detalle (pgina)

Seleccione el registro que desea consultar y luego d clic en el icono de Detalle. Una nueva ventana se abrir para ver la informacin relacionada en modo de solo lectura.

Copyright 2013 - Bizagi

695

3.4.3.19 Cuadro de Texto

Uso
Muestra atributos de tipo texto en la forma.

Consideraciones
Por defecto, la longitud mxima permitida para el texto ingresado ser la mxima longitud del atributo tipo texto relacionado. Si se define una longitud mxima en las propiedades de un control especfico, la longitud real permitida ser la mnima entre la del atributo y la de la configuracin del control.

Atributos Relacionados
Este control esta relacionado a atributos tipo texto o texto extendido. Los textos extendidos pueden contener un nmero ilimitado de caracteres.

Propiedades
Las siguientes son propiedades exclusivas para el control tipo cuadro de texto:

Pestaa Bsico

696

Copyright 2013 - Bizagi

PROPIEDAD Es extendido

DESCRIPCIN Cuando se habilita esta propiedad, el tamao del rea de texto se expandir y mostrar una barra de desplazamiento vertical. Define el nmero mximo de caracteres de texto que pueden ser ingresados en el control.

Longitud Mxima

Ejemplo de propiedad Es extendido

Pestaa Avanzado

Copyright 2013 - Bizagi

697

PROPIEDAD

DESCRIPCIN

Vuelva a escribir Solicita al usuario a ingresar el valor en el control dos veces. En caso de que estos valores no coincidan al momento de dar clic en Sig u ien te, el valor deber ser reingresado. El valor de verificacin puede ser configurado para ser ingresado de dos formas: Duplicado: Muestra dos controles. Ambos controles deben contener exactamente la misma informacin para continuar. Doble: Solicita al usuario final ingresar el mismo nmero dos veces en el mismo campo. Valor por Defecto Asigna un valor por defecto de manera que el usuario no tenga que seleccionarlo tan pronto como se abra la forma por primera vez. Apenas se selecciona un valor, el valor por defecto se remplazar. Si el atributo tiene un valor que ha sido calculado utilizando un expresin, el valor por defecto se ignorar.

Expresin Regular

Una expresin regular es un texto especial (con una sintaxis definida) utilizado para identificar un patrn de caracteres o un caracter particular y validar el contenido ingresado en un control de cuadro de texto. Esta funcionalidad no pretende reemplazar el texto ingresado. Si el texto no cumple con la expresin regular, el control se dejar en blanco. Expresin: Define la expresin que valida el contenido ingresado en el control de cuadro de texto. Mensaje de Validacin: Define el mensaje de validacin que se mostrar en caso de que el texto ingresado no cumpla con las condiciones de la expresin.

Ejemplo propiedad Vuelva a escribir

698

Copyright 2013 - Bizagi

Ejemplo
Un colegio ha implementado un proceso en Bizagi para realizar las pruenas de historia. Los estudiantes deben responder diferentes preguntas relacionadas a eventos y personajes relevantes de la historia mundial. Para permitir que los estudiantes respondan las preguntas de la prueba, se deben insertar controles de cuadro de texto en la forma. Suponga que la prueba tiene 3 preguntas por lo que tres atributos deben ser creados.

1. En la forma arrastre el atributo Resp u esta1 desde el modelo de datos hasta el rea de trabajo. Este atributo ser interpretado automticamente por Bizagi como un control de cuadro de texto.

2. En la pestaa Bsico de las propiedades del control, habilite la propiedad Es ex ten d id o .

Copyright 2013 - Bizagi

699

3. Repita los pasos previos para configurar los dems controles de cuadro de texto relacionados a las preguntas dos y tres. Guarde la forma.

4. Vaya al Portal de Trabajo para probar los controles.

700

Copyright 2013 - Bizagi

3.4.3.20 Si/No

Uso
Muestra atributos booleanos a los usuarios finales para escoger entre las opciones Si/No.

Atributos Relacionados
Este control se relaciona a atributos booleanos.

Propiedades
Las siguientes son propiedades exclusivas del control Si/No:

Pestaa Bsico
PROPIEDAD Mostrar como DESCRIPCIN Define cmo mostrar el control: Opcin: Muestra dos opciones: Si y No. El usuario debe seleccionar una de ellas. Casilla de Verificacin: Muestra un cuadro de verificacin. Si esta activado, el control tomar el valor de Si. De lo contrario, tomar el valor de No.

Ejemplo propiedad Mostrar como

Copyright 2013 - Bizagi

701

Pestaa Avanzado
PROPIEDAD Valor por Defecto DESCRIPCIN Asigna un valor por defecto de manera que el usuario no tenga que seleccionarlo tan pronto como se abra la forma por primera vez. Apenas se selecciona un valor, el valor por defecto se remplazar. Si el atributo tiene un valor que ha sido calculado utilizando un expresin, el valor por defecto se ignorar.

Actualizar al Cambio

Cuando se selecciona, una vez el usuario final seleccione un valor del control, la forma se refrescar y ejecutar todas las Acciones, validaciones y reglas de visibilidad guardando lo que ha sido ingresado.

Ejemplo
En un Proceso de Solicitud de Vacaciones, cuando un empleado solicita una licencia debe leer y aceptar las polticas de vacaciones de la compaa. Para permitir al usuario aceptar o rechazar dichas polticas, un control Si/No debe ser insertado en la forma. 1. Usted necesita un atributo booleano en su modelo de datos. Crearemos un atributo denominado A cep tar p o lticas en la Entidad de Proceso.

702

Copyright 2013 - Bizagi

2. En la forma inserte el atributo A cep tar P o lticas. Bizagi interpretar este atributo como un control Si/ No en la forma.

3. Guarde la forma y vaya al Portal de Trabajo para probar el control.

Copyright 2013 - Bizagi

703

3.4.3.21 Propiedades de los Controles Cada control posee un conjunto de propiedades que permiten manejar su comportamiento y presentacin en el Portal de Trabajo. Para mostrar las propiedades de un control, d clic sobre l o seleccione el icono de engranaje ubicado en su esquina superior derecha. Las propiedades se mostrarn la parte baja del Panel Izquierdo.

704

Copyright 2013 - Bizagi

Para cada control existen tres grupos de propiedades organizadas en pestaas:

PESTAA BSICO Nombre de Mostrar: Define el nombre que el atributo llevar en el Portal de Trabajo. Texto de Ayuda: Define el texto de ayuda que se mostrar en el Portal de Trabajo. Se encuentra en un pequeo icono ubicado a la derecha del control. Fuente de Datos: Relaciona el control a un atributo del Modelo de Datos. Visible: Define la visibilidad del control, ya sea visible, no visible o determinado por una expresin. Editable: Define la editabilidad del control, ya sea editable, solo lectura o determinado por una expresin. Requerido: Define si el control es obligatorio o no o si es determinado por una expresin.

Muestra una lista de las propiedades mas importantes del control. Las propiedades resaltadas con un asterisco rojo son obligatorias. Si usted solo configura las propiedades bsicas, el control tendr el comportamiento por defecto en el Portal de Trabajo.

Las propiedades Visible, Editable y Requerido le permiten definir si un control tiene siempre el mismo comportamiento o evala una expresin (o regla de negocio) para determinar el comportamiento. Para aprender mas acerca de como evaluar expresiones para estas propiedades, consulte Administrar propiedades con expresiones IMPORTANTE: Usted puede cambiar algunas propiedades de varios controles al mismo tiempo, seleccionndolos mientras oprime la tecla Crtl. Esto habilitar la pestaa Bsico con las propiedades que pueden cambiarse.

Copyright 2013 - Bizagi

705

PESTAA FORMATO Aplica a la mayora de los controles de la forma y le permite personalizar la apariencia del control en la forma. Tipo de Visualizacin: Habilita diferentes formatos de visualizacin respecto al texto (etiqueta) y el control (valor). Esto incluye esconder la etiqueta o valor. Etiqueta y alineacin horizontal del valor: Alinea la etiqueta y el valor del control dentro del espacio disponible en la forma. Orientacin: Define si el texto debera ser escrito de izquierda a derecha o vice versa. La opcin Heredado indica que la propiedad se establecer de acuerdo al idioma seleccionado en el Portal de Trabajo. Formato: Cambia la apariencia del texto personalizando el tamao y formato. Por ejemplo usted puede configurar el tipo de fuente y el color de fondo. Layout: Define el porcentaje en el cual se distribuir el espacio disponible en el rea de trabajo. En esencia divide el espacio en diferentes columnas con un ancho basado en un radio de porcentaje. Por defecto, el layout es de dos columnas con una distribucin de ancho de 50/50.

706

Copyright 2013 - Bizagi

IMPORTANTE: Usted puede cambiar algunas propiedades de varios controles al mismo tiempo, seleccionndolos mientras oprime la tecla Crtl. Esto habilitar la pestaa Formato con las propiedades que pueden cambiarse.

Ejemplo Tipo de Visualizacin

Ejemplo Layout

Copyright 2013 - Bizagi

707

PESTAA AVANZADO Aplica a cada control individualmente y permitir la configuracin de comportamientos avanzados para cada uno.
3.4.3.21.1 Valor por Defecto

Un valor por defecto asigna un valor predefinido a un campo sin que el usuario tenga que seleccionar uno, en el momento en que una forma se abre por primera vez en el Portal de Trabajo. Esto es til

708

Copyright 2013 - Bizagi

cuando un control usualmente toma un valor especfico y el desarrollador desea ahorrarle algunos clics al usuario final. Tan pronto como se ingresa o selecciona un valor en el control, diferente al valor por defecto, este ltimo se reemplazar y se mantendr el nuevo valor de ah en adelante. Si el control tiene un valor que ha sido establecido utilizando una expresin, el valor por defecto se ignorar. La propiedad de Valor por Defecto se muestra para los siguientes controles, en la pestaa Avanzado de sus propiedades: Combo: Asigna un valor por defecto utilizando una expresin. Fecha: Asigna un valor por defecto utilizando una fecha fija o una expresin. Lista: Asigna un valor por defecto utilizando una expresin. Moneda: Asigna un valor por defecto ingresando un valor fijo o utilizando una expresin. Nmero: Asigna un valor por defecto ingresando un valor fijo o utilizando una expresin. Radio: Asigna un valor por defecto utilizando una expresin. Cuadro de texto: Asigna un valor por defecto ingresando un texto fijo o utilizando una expresin. Si/No: Asigna un valor por defecto seleccionando si o no, o utilizando una expresin. El control de Valor por Defecto le permitir ingresar o seleccionar un valor, as como utilizar una expresin para definirlo, de acuerdo al tipo de control. Cuando un valor o expresin se selecciona, ser mostrado en el campo de la propiedad. Para editar un valor o expresin seleccionada, d clic en el icono de edicin (lpiz) Para borrarlo, d clic en el icono rojo de eliminacin. Tenga cuidado ya que Bizagi no solicita confirmacin para eliminar un valor por defecto. De todas formas usted puede dar clic en Deshacer en caso de que haya borrado el valor por defecto por equivocacin. Si usted ha seleccionado una expresin, usted puede abrir el editor de expresiones para modificarla al dar clic en el icono de edicin(lpiz).

3.4.3.21.2 Propiedad de Filtro

La definicin de un filtro en un Control le permite definir un subconjunto de valores para mostrar, de la lista de todos los posibles, en una entidad relacionada. Las condiciones Booleanas se evalan para decidir cuales registros se mostrarn u ocultaran. La propiedad de filtro se muestra en los siguientes Controles, en la pestaa Avanzado de las propiedades: Combo

Copyright 2013 - Bizagi

709

Lista Bsqueda Sugerencia Radio Cuando la propiedad de filtro no tiene filtros definidos, se mostrar vaca. De lo contrario, mostrar la condicin. Para Agregar un filtro d clic en el icono de filtro. Una nueva ventana se mostrar. D clic en el botn A g reg ar filtro , para incluir una nueva condicin.

Observe que usted puede ingresar tantas condiciones como necesite. Asegrese de definir la forma como se relacionan las condiciones con el botn de radio en la parte superior de la ventana, esto es, definir si los registros a mostrar debern cumplir con todas las condiciones o con al menos una de ellas (Y/O) Usted tambin puede definir filtros usando expresiones complejas. Para ms informacin refirase a Filtros Avanzados.

Ejemplo

710

Copyright 2013 - Bizagi

En un Proceso de Solicitud de compra, el usuario solicitante pertenece a un Centro de costo determinado. El Centro de costo de la solicitud debe ser filtrado de manera que el usuario solo pueda seleccionar entre su centro de costo y el centro de costo de Administracin. Todos los dems registros de Centro de costo debern ocultarse. El siguiente es el modelo de datos del ejemplo.

De no haber filtro definido, el combo de Centro de costo mostrar los cuatro centros de costo registrados en la entidad paramtrica. Cuando creamos el filtro, solo dos Centros de costo se mostrarn; el del usuario y el de Administracin. En este caso suponga que el solicitante pertenece al Centro de costo de Servicio al Cliente. 1. Revise que, en el Portal de Trabajo, el combo del Centro de costo muestre todos los registros en la entidad.

Copyright 2013 - Bizagi

711

2. En el diseador de formas, defina un filtro para el control de Centro de costo.

3. D clic en el icono de filtro e ingrese la primera condicin: el Centro de costo a mostrar debe ser el mismo Centro de costo del usuario solicitante.

712

Copyright 2013 - Bizagi

4. Cree una nueva condicin donde el Centro de costo a mostrar sea Administracin.

Copyright 2013 - Bizagi

713

5. Asegrese de que en la parte superior, la opcin CUALQUIERA de las siguientes condiciones, este seleccionada. 6. El Portal de Trabajo mostrar ahora solo dos Centro de costo en el combo.

714

Copyright 2013 - Bizagi

3.4.3.21.3 Filtrar Tablas

Filtrar la tabla como un todo

La definicin de un filtro en una tabla le permite definir un subconjunto de valores para mostrar, de la todos los que contiene la misma. Una expresin Booleanas define una condicin que Bizagi evala para decidir cuales registros se mostrarn u ocultaran. Cuando la propiedad de filtro no tiene filtros definidos, se mostrar vaca. De lo contrario, mostrar la condicin. Para Agregar un filtro d clic en el icono de filtro en la pestaa Avanzado. Una nueva ventana se mostrar.

Copyright 2013 - Bizagi

715

D clic en el botn A g reg ar filtro , para incluir una nueva condicin. Observe que usted puede ingresar tantas condiciones como necesite. Asegrese de definir la forma como se relacionan las condiciones con el botn de radio en la parte superior de la ventana, esto es, definir si los registros a mostrar debern cumplir con todas las condiciones o con al menos una de ellas (Y/O).

Filtrar las columnas de una tabla

Los filtros se pueden aadir especficamente a las columnas de la tabla, para mostrar informacin filtrada de estos controles. Sin embargo, hay una condicin que deben considerarse al filtrar una columna: hay que decidir si el filtro se aplica a la columna total o se aplica a cada fila en particular. Es decir, si el filtro se evala a todos los registros de la columna como un todo o si cada fila evala el filtro de forma independiente. El filtro de columna de la tabla se encuentra en la opcin Ed itar co lu m n as, para cada control. Active o desactive la opcin A p licar filtro a cad a fila de acuerdo a sus necesidades.

716

Copyright 2013 - Bizagi

Ejemplo
En un Proceso de Solicitud de compra, el Supervisor del solicitante debe aprobar los productos cuyo precio unitario sea superior a $500. Necesitamos mostrar los Productos solicitados filtrando solo aquellos cuyo precio unitario sea mayor a $500, de manera que el supervisor pueda enfocarse especficamente en los registros de su inters. El siguiente es el modelo de datos del ejemplo.

Si no hay filtros definidos, la Tabla mostrar cuatro productos solicitados. Cuando creamos el filtro, solo un producto se mostrar ya que posee un precio unitario de $1000. 1. Revise en el Portal de Trabajo que la Tabla de Productos muestre todos los registros en la entidad.

Copyright 2013 - Bizagi

717

2. En el diseador de formas, defina un filtro para la Tabla y luego guarde la forma.

718

Copyright 2013 - Bizagi

3. El Portal de Trabajo mostrar ahora un producto en la Tabla.

3.4.3.21.4 Valores Mximo y Mnimo

Usted podria requerir la validacin de los valores mnimos y mximos permitidos para controles tipo Nmero, Moneda o Fecha. Para hacerlo, dichos controles cuentan con las propiedades M x im o y M n im o . Las propiedades de valor M x im o y M n im o se encuentran en la pestaa Avanzado de las propiedades del Control.

Copyright 2013 - Bizagi

719

En estas propiedades usted podr ingresar o seleccionar un valor o utilizar una expresin para definirlo. Cuando un valor o expresin se selecciona, este se mostrar en el campo de la propiedad.

De esta manera cuando el usuario final intenta ingresar en el campo un valor menor que el definido en la propiedad Mnimo, o mayor que el definido en la propiedad Mximo, se mostrar una validacin.

Ejemplo: Definir el valor mnimo y mximo para un control tipo Nmero o Moneda.
En un Proceso de Solicitud de Crdito, el monto solicitado debe ser de al menos 100 US. As mismo, el monto mximo permitido es de hasta 10 veces el ingreso mensual del solicitante. Los valores del In g reso M en su al y el M o n to So licitad o se almacenan en los atributos con el mismo nombre, dentro de la Entidad de Proceso So licitu d d e Crd ito .

1. En la forma, inserte el atributo M o n to So licitad o y abra la pestaa Avanzado de las propiedades del control.

720

Copyright 2013 - Bizagi

2. En la propiedad de Valor M n im o ingrese 100.

3. Ahora vaya a la propiedad valor M x im o y d clic en el icono de expresin para definir el valor

Copyright 2013 - Bizagi

721

mximo permitido de acuerdo al ingreso mensual del solicitante.

4. Defina un mdulo de expresin e ingrese la siguiente sentencia:

722

Copyright 2013 - Bizagi

Guarde la expresin y luego cierre la forma. 5. Vaya al Portal de Trabajo para probar las validaciones. Ingrese un valor menor que 100. Cuando intente avanzar la actividad, el siguiente mensaje se mostrar.

Copyright 2013 - Bizagi

723

Ahora ingrese un valor mayor a 10 veces el ingreso mensual del solicitante. Al intentar avanzar la actividad, el siguiente mensaje se mostrar.

724

Copyright 2013 - Bizagi

Ejemplo: Definir el valor mnimo y mximo de un control tipo Fecha.

En un Proceso de Solicitud de Licencia de Vacaciones, un empleado debe solicitar sus vacaciones con al menos 15 das de anticipacin. As mismo, las solicitudes de vacaciones cuyo inicio sea posterior al 30 de diciembre de 2012, no se procesarn an. La fecha solicitada de inicio de vacaciones se almacena en el atributo F ech a d e Salid a, dentro de la entidad de Proceso So licitu d d e Vacacio n es.

1. En la forma, vaya a las propiedades del control F ech a d e Salid a y abra la pestaa Avanzado.

Copyright 2013 - Bizagi

725

2. En la propiedad de valor M x im o seleccione diciembre 30 de 2012.

3. Ahora vaya a la propiedad Valor M n im o y d clic en el icono de expresin para definir el mnimo valor permitido para el control (15 das despus de la fecha actual) de acuerdo con la fecha actual.

726

Copyright 2013 - Bizagi

4. Defina un mdulo de expresin e ingrese la siguiente sentencia:

Guarde la expresin y luego guarde la forma.

Copyright 2013 - Bizagi

727

5. Vaya al Portal de Trabajo para probar las validaciones. Intente ingresar una fecha posterior al 30 de Diciembre de 2012. Observe que no es posible.

Ahora intente ingresar una fecha de salida anterior a 15 das despus de la fecha actual (suponga que la fecha actual es 2/12/2012). Observe que no es posible.

Artculos Relacionados.
Valor mnimo usando expresiones Valor mximo usando expresiones

728

Copyright 2013 - Bizagi

3.4.3.21.5 Habilitar enviar como adjunto

La propiedad Enviar como adjunto muestra un cono para que los usuarios finales puedan enviar los adjuntos fcilmente en un correo electrnico. Esta propiedad aplica para Archivos, Plantilla de Documentos y Archivos ECM, los cuales relacionan archivos en el Portal de Trabajo. Cuando esta opcin est habilitada se muestra un cono en forma de sobre en el Portal de trabajo, junto al Control. Cuando el usuario final da clic sobre el cono se abre una ventana que muestra la infomacin requerida para el correo electrnico: Para quin va dirigido, asunto y un mensaje.

3.4.3.21.6 Validaciones de Tabla

Las validaciones de tablas se utilizan para verificar que las condiciones de negocio requeridas se cumplan. Cuando no se cumplen dichas condiciones, los usuarios finales vern un mensaje de alerta, informando que algo debe ser corregido. Cuando las condiciones se cumplen, los usuarios podrn continuar el Proceso. Hay tres tipos de Validaciones de tabla:

Copyright 2013 - Bizagi

729

Botn de validaciones de Tabla: Se ejecutan cuando los usuarios finales dan clic en el botn Sig u ien te en una actividad: Validan la integridad de la tabla y la coherencia entre registros. Expresin de Validacin (Opciones de Adicin): Se ejecutan cuando los usuarios finales dan clic en el botn Gu ard ar, dentro de una Forma de adicin. Validan la informacin del nuevo registro ingresado en ella. Expresin de Validacin (Opciones de Edicin):Se ejecutan cuando los usuarios finales dan clic en el botn Gu ard ar, dentro de una Forma de edicin. Validan la informacin del registro editado en ella.
3.4.3.21.6.1 Botn de Validaciones de Tabla

El botn de Valid acio n es de Tabla se encuentra en la pestaa Avanzado de las propiedades de la Tabla. Al dar clic en l, se mostrar una nueva ventana en donde podr crear las validaciones necesarias. En esta ventana usted puede evaluar varias condiciones para asegurar que los registros de la tabla y la estructura de los datos son correctos.

730

Copyright 2013 - Bizagi

Las validaciones pueden evaluar contadores, que contarn el nmero de registros que cumplen con una condicin en la tabla, o evaluar atributos directamente.

Contadores
Los contadores son variables utilizadas para obtener las dilas que cumplen con condiciones dadas. Estos se definen en la primera seccin de la ventana de validaciones de tabla. En la siguiente imagen utilizamos tres contadores para validar diferentes condiciones, en una tabla que contiene cotizaciones de productos:

El primer contador almacena en la variable N ew Co u n ter, el nmero de filas en la Tabla. El segundo contador almacena el la variable N ew Co u n ter2, el nmero de registros cuyo Precio total es menor al precio unitario. Esto se hace comparando estos atributos para cada registro y contabilizando aquellos que cumplan la anterior condicin. El ltimo contador almacena en la variable N ew Co u n ter3 el nmero de registros cuyo precio unitario es menor a 1000. Esto se hace evaluando el valor de este atributo en cada registro y contabilizando aquellos que cumplan la anterior condicin. Usted tambin puede crear mltiples condiciones utilizando operadores Y/O. El siguiente contador tiene en cuenta los registros cuyos precios totales son menores al precio unitario O aquellos cuyo precio total es mayor a 50.000.

Copyright 2013 - Bizagi

731

Adicionalmente usted puede crear grupos de condiciones vinculndolas a travs del uso de la opcin Vin cu lar ( ). El siguiente contador solo tiene en cuenta aquellos registros cuyos precios totales son menores al precio unitario O aquellas cuyo precio total es mayor a 50.000 y menor a 100.000.

Nota: Tenga en cuenta que las condiciones definidas para los contadores, se evalan sobre todos los registros existentes en la tabla. Si usted ejecuta validaciones de tabla sobre tablas filtradas, deber incluir las condiciones de filtro dentro de las condiciones de los contadores.

Validaciones

732

Copyright 2013 - Bizagi

En la seccin inferior de la ventana de Validaciones, definimos las validaciones que se ejecutarn. Como se mencion anteriormente estas pueden ser definidas sobre atributos directamente o utilizando los contadores definidos en la seccin superior. Cuando se definen sobre atributos, las validaciones evaluarn la columna entera relacionada al atributo evaluado, y mostrarn un mensaje de error si al menos uno de sus registros no cumple con la condicin dada. Nota: Las validaciones directas aplican sobre la columna entera y no deberan ser utilizadas cuando se requiera evaluar una condicin que involucre mas de una columna. En este caso, todas las filas y todas las columnas sern evaluadas. Por este motivo se deben utilizar contadores. Las validaciones tambin pueden evaluar mltiples condiciones y grupos de ellas, de la misma manera que los contadores. En la siguiente imagen una validacin de tabla consiste en cuatro validaciones: tres evaluando contadores y una evaluando atributos directamente.

Dado que las cuatro validaciones se definen con un operador I, solo una de ellas deber cumplirse para que se muestre un mensaje de error. Adicionalmente, usted puede crear mltiples validaciones (validaciones individuales) dando clic en la opcin M o strar m ltip les v alid acio n es que se encuentra en la parte inferior de la ventana. Esto mostrar el botn N u ev o que permite crear nuevas validaciones.

Copyright 2013 - Bizagi

733

Ejemplo
En un Proceso de Solicitud de compra, la tabla de P ro d u cto s So licitad o s debe cumplir con las siguientes condiciones: Contener al menos un registro. Para todos los registros, el precio unitario debe ser menor que el Precio total (ya que Precio Total= Precio unitario x Cantidad) Para todos los registros, el precio unitario debe ser menor a 1.000 y el precio total debe ser menor a 20.000. Crearemos tres validaciones individuales, una para cada condicin. Ejemplo utilizando contadores La primera validacin contendr un nuevo contador de fila. Luego la validacin evaluar cuantos registros se contaron y retornar un mensaje de error si no hay por lo menos uno:

734

Copyright 2013 - Bizagi

Ejemplo con validaciones directas La segunda validacin contendr una validacin directa. Bizagi evaluar si existen registros donde el precio unitario es mayor que el precio total. Si hay al menos uno, se mostrar un mensaje de error.

Copyright 2013 - Bizagi

735

Ejemplo utilizando contadores compuestos La tercera validacin contendr un contador de fila que evala dos condiciones. Entonces, se evaluar cuantas filas se contaron y se mostrar un mensaje de error si hay por lo menos una.

736

Copyright 2013 - Bizagi

Copyright 2013 - Bizagi

737

3.4.3.21.6.2 Expresiones de Validacin en Adicin y Edicin

Las expresiones de validacin al agregar o editar registros se encuentran el la pestaa Avanzado de las propiedades de la Tabla, cuando la propiedad Aadir o Editar esta habilitada utilizando una Forma, esto es: Cuando la propiedad permitir creacin esta habilitada y creacin en lnea deshabilitada Cuando la propiedad Permitir edicin esta habilitada y edicin en lnea deshabilitada Estas son expresiones de scripting que evalan la coherencia de la informacin ingresada al momento de crear o editar un registro de la Tabla. Estas validaciones se ejecutan en el Portal de Trabajo cuando los usuarios crean o editan un registro, a travs de una ventana emergente, y dan clic en el botn Gu ard ar. Si una expresin de validacin se lanza, EL REGISTRO NO SE GUARDAR. Estas validaciones se construyen en el contexto de la Entidad de Coleccin. Debido a que el nuevo registro se llena en el contexto de la coleccin, las validaciones mantendrn este contexto. Por lo tanto, la navegacin de XPath iniciar desde la entidad de coleccin.

738

Copyright 2013 - Bizagi

Para incluir una expresin de validacin de Clic en el icono de expresin(Ex) Esto mostrar el editor de expresiones. Elimine una validacin relacionada dando clic en el icono de cruz ("x"). Edite una validacin relacionada dando clic en el Nombre de la expresin o el icono de expresin (Ex).

Ejemplo
En un Proceso de Solicitud de compra es necesario validar que cada producto incluido posea informacin coherente. Los nuevos registros se agregan utilizando una F o rm a d e A d ici n , por lo que podemos utilizar expresiones de validacin. Validaremos que el Precio total del producto incluido sea el producto del precio unitario por la cantidad solicitada. De lo contrario, se debera mostrar un mensaje de error. 1. En la forma vaya a las pestaa Avanzado de las propiedades de la Tabla. Habilite la opcin Adicin y deshabilite la adicin En lnea. De esta manera la forma de adicin y la expresin de validacin se mostrarn. 2. Asocie una Forma de Adicin.

Copyright 2013 - Bizagi

739

3. Cree una nueva Expresin de Validacin dando clic en el icono de expresin (Ex). El editor de Expresin se mostrar.

4. Incluya el siguiente cdigo: //Validates if the Total price entered is the same as the Unit price times the Quantity entered. if(<Totalprice>!= (<Unitprice>*<Quantity>)) { CHelper.ThrowValidationError("Total price must be Unit price times quantity") } 5. En el Portal de Trabajo de clic en el icono de adicin. Esto mostrar una nueva ventana donde la informacin del nuevo registro debe ser ingresada.

740

Copyright 2013 - Bizagi

6. Cuando se ingresa la informacin y el usuario da clic en Gu ard ar, la expresin de validacin se ejecutar. En la siguiente imagen se muestra el error que aparece.

Copyright 2013 - Bizagi

741

3.4.4

Cambiar el Tipo de Control

Cuando se insertan atributos del modelo de datos en la forma, usted ver que estos son interpretados automticamente por Bizagi como un control por defecto. Este control por defecto se define dependiendo del tipo de atributo insertado. En la seccin de Controles aprendimos como configurar diferentes tipos de controles. Sin embargo, usted podria querer cambiar el tipo de control asociado a un control especfico ya incluido en el rea de trabajo. Bizagi permite hacerlo sin necesidad de eliminar el control actual. Bizagi permite contertir un control a otro de una manera rpida utilizando la opcin Co n v ertir a. Para acceder a la opcin de Convertir a, d clic derecho sobre el control a convertir.

Se mostrar la lista de controles a los cuales el control actual puede ser convertido. Simplemente seleccione el control deseado para convertirlo.

742

Copyright 2013 - Bizagi

La siguiente tabla muestra los controles por defecto para cada tipo de atributo as como los controles disponibles a los cuales pueden ser convertidos: Tipo de Atributo Booleano Nmero (Entero, Real, corto, etc) FechaHora Moneda Control por Defecto Si/No Controles Disponibles

Oculot Si/No Oculto Moneda Nmero Oculto Fecha Nmero Moneda Cuadro de Texto Archivo Imagen Lista Sugerencia

Nmero

Fecha

Moneda Cuadro d Texto Archivo Imagen Combo

Texto Archivo Imagen Entidad Paramtri

Copyright 2013 - Bizagi

743

ca

Radio Bsqueda Lista desplegable en cascada Vnculo a Forma Combo Lista Sugerencia Radio Combo Lista desplegable en cascada Vnculo a Forma Bsqueda Tabla

Entidad Maestra

Bsqueda

Coleccin

Tabla

Nota: Para un tipo de atributo especfico, usted siempre puede convertir su control asociado entre cualquiera de los disponibles. Por ejemplo, si usted convirti un control de Bsqueda, relacionado a una Entidad Maestra, a una lista, usted puede convertir esta lista al control de Bsqueda de nuevo o a cualquier otro control de los disponibles (sugerencia, combo, radio, etc)

3.4.5

Personalizar comportamientos del Control

Usted puede personalizar el comportamiento de sus controles en el Portal de Trabajo de acuerdo a sus necesidades de negocio. Bizagi provee un asistente amigable denominado Acciones y Validaciones, para administrar los controles en cada forma. Las Acciones y Validaciones evalan condiciones sobre los controles incluidos en su forma para: Cambiar el color de los controles. Cambiar el color de fondo de los controles. Mostrar u ocultar controles. Cambiar la configuracin de editabilidad. Hacer obligatorios los controles. Asignar un valor a un control. Asignar un valor mnimo o mximo permitido a un control. Colapsar un grupo. Activar una Pestaa. Mostrar mensajes de validacin a los usuarios finales.

Recuerde que: En la pestaa Bsico de las propiedades de cada control, usted encontrar las propiedades Visible, Editable y Requerido. Estas opciones le permiten definir si un control tiene SIEMPRE el mismo comportamiento o evala una expresin (o regla de negocio) para determinar el comportamiento.

744

Copyright 2013 - Bizagi

Sin embargo, usted solo necesita utilizar expresiones para evaluar situaciones complejas e negocio reales. Recomendamos utilizar las Acciones y Validaciones sobre expresiones cuando aplique.

3.4.5.1

Ejecutar Acciones y Validaciones El Asistente de A ccio n es y Valid acio n es se encuentra en el Ribbon del Diseador de Formas. Este controla el comportamiento de todos los controles INCLUIDOS en la forma. Basado en condiciones, el asistente evaluar cuales acciones tomar o que validaciones mostrar.

Las A ccio n es & Valid acio n es tambin se pueden definir sobre tablas. En este caso estas se evaluarn y ejecutarn para cada registro incluido en ellas.

Acciones
Las Acciones definen un conjunto de condiciones que se deben cumplir para ejecutar un comportamiento. Para definir una accin vaya al asistente de A ccio n es y Valid acio n es y de clic en el botn A g reg ar, dentro de la P esta a d e A ccio n es:

Copyright 2013 - Bizagi

745

Las Acciones se definen completamente por tres componentes:

Condiciones (Cundo)
Estas son las condiciones que se deben cumplir para ejecutar una accin. Estas condiciones se construyen con: Control: Define el control a evaluar. Este control DEBE ser incluido en la forma donde se configuran las acciones. Operador: Define el operador de comparacin para la condicin. Argumento: Define el valor a ser comparado con el control. Este valor puede ser una constante o un XPath. Conector: Este componente solo aplica cuando se evala mas de una condicin. Se utiliza para vincular condiciones con un comportamiento incluyente (Y) o excluyente (O).

Acciones Principales (Entonces)

Estas son las acciones que se ejecutan cuando se cumplen las condiciones definidas. Estas acciones estn constituidas por:

746

Copyright 2013 - Bizagi

Comando: Define el tipo de comportamiento a aplicar. Dentro de los comandos usted encontrar:

Comando Definir fondo Definir color de primer plano

Comportamiento Cambia el color de un control. Cambia el color de la fuente de un control. Muestra u oculta un control. Cambiar la configuracin de editabilidad de un control. Define un control como obligatorio u opcional. Asigna un valor a un control. Asigna un valor mnimo permitido para un control. Asigna un valor mximo permitido para un control. Contrae/Expande un grupo. Activa una pestaa.

Cambia visibilidad para Cambia editabilidad para

Definir como obligatorio

Definir valor para Definir valor mnimo para

Definir valor mximo para

Contraer Definir como activo

Nota Cuando se aplican acciones sobre colecciones, solo los siguientes comandos pueden ser utilizados: Definir fondo, cambiar visibilidad y cambiar editabilidad. Control: Define el control al que se aplicar el comportamiento. Argumento: Define el valor del comando a ser aplicado.

Acciones Alternativas (Si no)

Estas son las acciones a ejecutar cuando las condiciones definidas no se cumplen. Usted puede definir tipos de acciones alternativas: Realice las siguientes acciones: Permite definir un conjunto de acciones a ejecutar cuando no se cumplan las condiciones definidas. Estas se definen de la misma manera que las acciones principales. No hacer nada: No ejecuta ninguna accin cuando no se cumplan las condiciones definidas. Deshacer las acciones: Realiza las acciones opuestas a las definidas en las acciones principales para regresar los controles a su estado original.

Copyright 2013 - Bizagi

747

Validaciones
Las validaciones definen un conjunto de condiciones a evaluar. Una evaluacin verdadera de estas condiciones mostrar (lanzar) un mensaje de validacin a los usuarios finales. Para definir una validacin, vaya al Asistente de A ccio n es & Valid acio n es y d clic en el botn A g reg ar dentro de la P esta a d e Valid acio n es:

Las Validaciones se definen completamente por dos componentes:

Condiciones (Si)
Estas son las condiciones que se deben cumplir para que se lance un mensaje de validacin. Estas condiciones estn constituidas por: Control: Define el control a evaluar. Este control DEBE ser incluido en la forma donde se configuran las validaciones. Operador: Define el operador de comparacin para la condicin. Argumento: Define el valor a ser comparado con el control. Este valor puede ser una constante o un XPath.

748

Copyright 2013 - Bizagi

Mensaje de Validacin (Entonces)

Define el mensaje que se mostrar a los usuarios finales cuando se cumplen las condiciones establecidas. Este mensaje puede ser localizado para ser mostrado en el idioma adecuado de acuerdo a las configuraciones del usuario final.

3.4.5.1.1 Ejemplos de Acciones y Validaciones

Ejemplo de Acciones
Suponga que se encuentra trabajando en la definicin de una forma relacionada a la actividad de Reg istrar So licitu d en un P ro ceso d e So licitu d d e Crd ito . En esta actividad, un analista de crdito ingresa la informacin relacionada a una solicitud presentada por un Cliente. Para validar la informacin ingresada y ofrecer una interfaz amigable al usuario final, usted desea definir algunas acciones:

Copyright 2013 - Bizagi

749

Configurar Acciones bsicas

Vamos a asumir que un Cliente solo puede solicitar un producto crediticio en cada solicitud y, basado en su capacidad de pago y un anlisis de riesgo, se define un valor mximo permitido para solicitar. Si el monto solicitado supera el monto mximo permitido, el monto solicitado debera mostrarse en color verde, de lo contrario, debera mostrarse en rojo. El valor mximo permitido se almacena en el control M o n to M x im o y el monto solicitado en el control M o n to So licitad o . Para definir este comportamiento siga los pasos descritos a continuacin: 1. Vaya a la forma de la actividad y agregue los controles necesarios incluyendo el M o n to M x im o y el M o n to So licitad o .

2. D clic en el icono A ccio n es & Valid acio n es ubicado en el Ribbon.

750

Copyright 2013 - Bizagi

3. En la pestaa de A ccio n es d clic en el botn A g reg ar.

4. En el cuadro Cundo d clic en A g reg ar u n a co n d ici n :

Copyright 2013 - Bizagi

751

5. Defina la siguiente condicin:

752

Copyright 2013 - Bizagi

6. En el cuadro Entonces d clic en A g reg ar u n a acci n y defina la siguiente accin:

Copyright 2013 - Bizagi

753

Esto configurar en verde el color de la fuente del control M o n to So licitad o , cuando este sea menor o igual al M o n to M x im o . 7. En el cuadro Sino seleccione Realice las sig u ien tes accio n es bajo las opciones de la lista desplegable.

8. Defina la siguiente expresin para configurar la fuente del control M o n to So licitad o en rojo, cuando este sea mayor al M o n to M x im o .

9. Finalmente vaya al Portal de Trabajo para probar el comportamiento.

754

Copyright 2013 - Bizagi

Configurar acciones sobre tablas

Ahora suponga que un Cliente puede solicitar varios productos en la misma solicitud. Cada uno de ellos posee un Monto Solicitado y, de acuerdo a la capacidad de pago del cliente y un anlisis de riesgo, se define un Monto mximo permitido. Si el Monto solicitado de un producto es menor al Monto mximo permitido para ese producto, el monto solicitado debera mostrarse con fondo verde, de lo contrario, debera mostrarse con fondo rojo. Para definir este comportamiento siga los pasos descritos a continuacin: 1. Vaya a la forma de la actividad e incluya los controles necesarios. Observe que los productos solicitados se incluyen en una tabla denominada P ro d u cto s. Incluya el N o m b re d el p ro d u cto , M o n to So licitad o y M o n to m x im o como columnas de la tabla.

Copyright 2013 - Bizagi

755

2. D clic en el icono A ccio n es & Valid acio n es ubicado en el Ribbon. En la pestaa de A ccio n es d clic en el botn A g reg ar.

756

Copyright 2013 - Bizagi

3. En el cuadro Cundo d clic en A g reg ar u n a co n d ici n y defina la siguiente condicin:

Observe que cuando se definen acciones a nivel de coleccin, las columnas en la coleccin se identifican por su nombre precedido del nombre de la coleccin.

4. En el cuadro Entonces d clic en A g reg ar u n a A cci n y defina la siguiente accin:

Observe de nuevo que estamos haciendo referencia a las columnas de la coleccin P ro d u cto s.

Copyright 2013 - Bizagi

757

5. En el cuadro Si no seleccione la opcin Realizar las sig u ien tes accio n es bajo la lista desplegable.

6. Defina la siguiente accin para configurar el color de la fuente del control M o n to So licitad o en rojo, cuando este sea mayor al M o n to M x im o .

7. Vaya al Portal de Trabajo para probar el comportamiento.

758

Copyright 2013 - Bizagi

Validaciones
Acabamos de configurar acciones en nuestra forma con el fin de ayudar visualmente al usuario a identificar cundo un monto solicitado no es permitido. Sin embargo, el usuario final puede continuar con el proceso incluso si el monto no es vlido. Para evitar esta situacin configuraremos una validacin. En este caso si cualquiera de los productos posee un monto solicitado mayor que su monto mximo permitido, se mostrar un mensaje de validacin al usuario final y el Proceso no podr continuar, a menos que este valor se corrija. Para definir este comportamiento siga los pasos descritos a continuacin: 1. Vaya a la forma de la actividad, incluya los controles necesarios y d clic en el icono A ccio n es & Valid acio n es ubicado en el Ribbon.

Copyright 2013 - Bizagi

759

2. En la P esta a d e Valid acio n es d clic en el botn A g reg ar.

3. En el cuadro Si d clic en A g reg ar u n a co n d ici n y defina la siguiente condicin:

760

Copyright 2013 - Bizagi

Observe que cuando se definen validaciones a nivel de coleccin, las columnas de la tabla se identifican por su nombre precedido por el nombre de la coleccin. 4. En el cuadro Entonces escriba el siguiente mensaje:

5. Vaya al Portal de Trabajo para probar el comportamiento.

Usar condiciones anidadas en Acciones y Validaciones

En muchas situaciones es deseable establecer condiciones ms complejas con el fin de realizar una condicin o lanzar una validacin. En los ejemplos previos aprendimos cmo definir condiciones sencillas. Ahora definiremos mltiples condiciones conectadas por operadores Y/O y a establecer g ru p o s d e co n d icio n es.

Usar conectores Y/O para mltiples condiciones

Los conectores Y /O se utilizan para vincular condiciones y definirlas como inclusivas (se deben cumplir todas) o exclusivas (solo basta con que se cumpla una de ellas). Estos conectores estn disponibles en la definicin de A ccio n es y Valid acio n es cuando se define ms de una condicin.

Copyright 2013 - Bizagi

761

Ejemplo Suponga que en nuestro Proceso de Solicitud de Crdito, la Entidad Financiera ha definido algunas polticas para la aprobacin de crditos con el fin de reducir tiempos de aprobacin y ofrecer un mejor y ms atractivo servicio a sus potenciales clientes. Inicialmente se defini una poltica para clientes jvenes: si el solicitante tiene 25 aos o menos y el monto que solicita es menor a US 3000, el crdito se aprobar de manera inmediata, de lo contrario se requerirn anlisis posteriores. Para lo anterior: La edad del solicitante se almacena en el atributo Ed ad d el So licitan te. La decisin de aprobacin inmediata se almacena en un atributo booleano llamado Crd ito A p ro b ad o . Necesitamos entonces definir una accin que establezca el valor apropiado para el atributo Crd ito A p ro b ad o (verdadero o falso) de acuerdo a las condiciones descritas: 1. Vaya a la forma de la actividad, agregue los controles necesarios y d clic en el icono de A ccio n es & Valid acio n es ubicado en el Ribbon. Agregue una nueva condicin dando clic en el botn A g reg ar.

762

Copyright 2013 - Bizagi

2. D clic en el botn A g reg ar Co n d ici n y defina la primera condicin relacionada a la edad del solicitante:

3. D clic de nuevo en el botn A g reg ar u n a co n d ici n y defina la segunda condicin relacionada al valor del monto solicitado:

Copyright 2013 - Bizagi

763

4. Cambie el conector a Y para definir la inclusin de las dos condiciones:

5. En el cuadro Entonces defina una accin para asignar VERDADERO al control Crd ito A p ro b ad o .

6. En el cuadro Si no seleccione Realizar las sig u ien tes accio n es en las opciones de la lista desplegable.

764

Copyright 2013 - Bizagi

7. Defina una accin para asignar FALSO al control Crd ito A p ro b ad o .

8. D clic en O k para conservar los cambios y luego guarde la forma.

Usar grupos de condiciones

Usted podra requerir de la definicin de grupos de condiciones para construir evaluaciones de condiciones ms complejas. Cada grupo de condiciones posee una o ms condiciones vinculadas por conectores Y/O. A su vez, los grupos se interconectan por estos mismos conectores para definir su inclusin (todos los grupos de condiciones se deben cumplir) o exclusin (solo uno de los grupos de condiciones se debe cumplir). Los Grupos de condiciones se definen dando clic en el botn A g reg ar u n a g ru p o d e co n d icio n es (que se encuentra en el cuadro Cundo para acciones y el cuadro Si para validaciones).

Copyright 2013 - Bizagi

765

Una vez se da clic se insertar un bloque de condiciones dentro del cuadro de condiciones.

Ejemplo Retomando el ejemplo expuesto en la seccin previa, ahora suponga que dentro de las polticas definidas por la Entidad Financiera, para aprobacin de crditos, se ha agregado una excepcin para personas mayores. La nueva poltica establece: Si el solicitante tiene 25 aos o menos y el monto que solicita es menor a US 3000, el crdito ser aprobado de forma inmediata, de lo contrario se requerirn anlisis posteriores. Si el solicitante tiene 60 aos o ms y el monto solicitado es menor a US 6000, el crdito ser aprobado de forma inmediata, de lo contrario se requerirn anlisis posteriores. Recuerde que la decisin de aprobacin inmediata se almacena en un atributo booleano denominado Crdito Aprobado. Necesitamos entonces definir una Accin para asignar el valor apropiado a este atributo de acuerdo a las condiciones descritas.

1. Vaya a la forma de la actividad, agregue los controles necesarios y d clic en el icono A ccio n es & Valid acio n es cubicado en el Ribbon. Agregue una nueva accin dando clic en el botn A g reg ar.

766

Copyright 2013 - Bizagi

2. D clic en el botn A g reg ar u n a co n d ici n y luego d clic en A g reg ar u n g ru p o d e co n d icio n es.

3. Dentro del bloque defina las dos condiciones relacionadas a la poltica para solicitantes jvenes:

Copyright 2013 - Bizagi

767

4. Ahora d clic en el botn A g reg ar u n g ru p o d e co n d icio n es para aadir un nuevo bloque de condiciones.

5. En el nuevo bloque d clic en el botn A g reg ar u n a co n d ici n y defina la primera condicin relacionada a la edad del solicitante mayor:

6. De nuevo d clic en el botn A g reg ar u n a co n d ici n y defina la segunda condicin relacionada al valor del monto solicitado para solicitantes mayores:

768

Copyright 2013 - Bizagi

7. Cambie el conector de bloque a O para definir la exclusin de los dos bloques de condiciones.

8. En el cuadro Entonces defina una accin para asignar VERDADERO al control Crd ito A p ro b ad o .

9. En el cuadro Si no seleccione Realizar las sig u ien tes accio n es bajo las opciones de la lista desplegable.

Copyright 2013 - Bizagi

769

10. En el cuadro Entonces defina una accin para asignar FALSO al control Crd ito A p ro b ad o .

11. D clic en O k para conservar los cambios y luego guarde la forma.

3.4.6

Controles personalizados (Widgets)

Informacin General
Bizagi ofrece un exhaustivo conjunto de controles para incluir en sus Formas de Actividad (como una funcionalidad incluida en el Diseador de Formas). Estos controles son los ms usados y requeridos por un Proceso, tales como un control tipo Archivo para adjuntos, listas desplegables, botones de radio y principalmente todas las entradas comunes (texto, nmero), entre otras. Para escenarios ms sofisticados en los cuales usted requiere funcionalidad extendida para las interfaces de usuario (mostrar un grfico de estadsticas, utilizar un mapa de google o cualquier cosa no considerada en los controles incluido) usted tiene la posibilidad de incluir Widgets en sus formas de Bizagi.

770

Copyright 2013 - Bizagi

Widgets de Bizagi
Los Widgets son controles personalizados o especializados que tienen propiedades predefinidas orientadas a requerimientos especficos de negocio. Estas propiedades promueven la reusabilidad, de manera que los Widgets pueden ser fcilmente incluidos y configurados (mapeados) en cualquier modelo de negocio. Los Widgets reemplazan la funcionalidad de Campos de Usuario disponible en versiones anteriores de Bizagi (a travs de los Widgets usted puede mostrar dilogos, invocar cualquier servicio REST y utilizar complementos Jquery). Usted puede fcilmente incluir en su proyecto cualquier nmero de Widgets disponibles en la Tienda de Widgets de Bizagi. Este artculo ilustrar como incluir y utilizar Widgets desde la Tienda de Widgets de Bizagi.

Nota Usted tambin puede definir sus propios Widgets e incluirlos en su proyecto. La creacin de estos controles personalizados requiere desarrollo y habilidades tcnicas abarcando: Jquery y javascript, Json, html y css (preferiblemente html 5 y css 3).

Tienda de Widgets Bizagi

Para acceder a la Tienda de Widgets de Bizagi, cargue su proyecto utilizando Bizagi Studio y abra el Diseador de Formas.

Copyright 2013 - Bizagi

771

En la pestaa de Controles del Diseador de Formas encontrar una opcin de banner que lo llevar a la Tienda de Widgets.

De clic sobre ella para ir a la Tienda de Widgets de Bizagi (se requiere conexin a Internet):

772

Copyright 2013 - Bizagi

Dentro dela Tienda de Widgets usted encontrar los Widgets disponibles listados en categoras (en la parte izquierda de la ventana). Usted puede ingresar palabras clave para buscar Widgets y ver el sumario al posicionarse sobre uno en especfico.

Copyright 2013 - Bizagi

773

Mientras observa el sumario usted puede dar clic sobre el botn Detalles para acceder a ms informacin e instalar el Widget.

Detalle de Widget
Para ver detalles y ms informacin sobre un Widget, qu hace y cmo usarlo, d clic sobre el botn Detalles cuando se posicione sobre un Widget dado. Dentro de los detalles, usted ver una Vista general describiendo las caractersticas del Widget (pestaa de General) y una gua de como usar y configurar el Widget en sus formas (pestaa de Detalles). Usted tambin puede navegar en la revisin de nuestros usuarios y calificaciones.

774

Copyright 2013 - Bizagi

Instalar un Widget
Para instalar un Widget en sus proyectos Bizagi, asegrese de estar en los detalles del Widget. En estos detalles usted encontrar el botn In stalar en la esquina superior derecha. Al dar clic en este botn se mostrar el EULA (Acuerdo de licencia del usuario final) para la Tienda de Widgets de Bizagi y sus Widgets. Una vez que usted lo lee, asegrese de aceptar los trminos y d clic en el botn Descarg ar.

Copyright 2013 - Bizagi

775

Bizagi descargar e instalar el Widget es su proyecto en menos de un minuto. Una vez finalizada la instalacin, su forma se refrescar automticamente y el Widget instalado aparecer listado bajo su categora la pestaa de Controles del panel izquierdo.

776

Copyright 2013 - Bizagi

Opcin de Instalacin Alternativa

Si su estacin de trabajo de Bizagi Studio no tiene una conexin de Internet y usted desea instalar los Widgets desde la Tienda de Widgets de Bizagi, usted puede hacerlo de la siguiente manera: 1. Visite la Tienda de Widgets de Bizagi desde cualquier navegado. Esto se hace ingresando la siguiente URL: h ttp ://w w w .b izag i.co m /W id g etSto re/Defau lt.asp x

Copyright 2013 - Bizagi

777

Cuando acceda a la Tienda de Widgets de Bizagi desde un navegador (no directamente desde Bizagi Studio), usted debe seguir los mismos pasos descritos en la seccin previa. Esta vez, desde la tienda de Widgets de Bizagi usted descargar cualquier Widget (como un archivo .bwg) 2. Una vez que ha guardado el Widget localmente, usted puede llevar este archivo .bmg a su estacin de trabajo de Bizagi Studio (por ejemplo, utilizando una memoria extraible) y cargar el Widget desde la opcin de administracin de Widgets que se encuentra en Bizagi Studio.

778

Copyright 2013 - Bizagi

A partir de este momento, sus formas tendrn este Widget disponible para ser utilizado en su proyecto de Bizagi. Usted puede acceder a l desde el panel izquierdo en la pestaa de Controles, bajo el grupo de Contenedores.

Copyright 2013 - Bizagi

779

Configurar un Widget
Para utilizar un Widget instalado, primero localicelo en la categoria especfica de Controles. 1. Arrastre el Widget y sueltelo en el rea de trabajo:

2. D clic en el Widget para ver sus propiedades (de la misma manera que se hace para los dems controles). Nota: Para los Widgets tipo grfico, asegrese de dar clic en el rea gris del grfico. La configuracin de las propiedades se hace tanto para la vista previa como para asignar las configuraciones de ejecucin de los Widgets. Observe que hay algunas propiedades (principalmente etiquetas) que pueden ser localizadas para los diferentes idiomas soportados en el Portal de Trabajo.

780

Copyright 2013 - Bizagi

Nota: Cada Widget tiene diferentes propiedades y restricciones. Por lo tanto,su configuracin, vista previa y uso tambin ser diferente. La vista previa de un Widget en el Diseador de Formas se muestra con datos de muestra (no se carga informacin hasta el momento de la ejecucin). Asegrese de configurar las propiedades requeridas (marcadas con un asterisco). Las propiedades como Visible o Editable sern probablemente las ms comunes para todos los Widgets, de manera que usted puede definir dinmicamente (a travs de una regla de negocio) el momento en el cual un Widget se muestra o cuando podr actualizar informacin del modelo de datos. 3. Guarde su forma y proceda a probar los Widgets en el Portal de Trabajo.

3.4.7

Contexto en Formas
Recordemos que el contexto es el punto de partida del modelo de datos que determina cmo el usuario navega a travs de un conjunto de atributos y cmo se construye la informacin.

Contexto en Formas de Actividad

Cuando usted abre el Diseador de Formas (desde el tercer paso del Asistente de Procesos) usted ver, en la pestaa de Datos, su entidad de proceso como la base del modelo, desde donde usted podr incluir todos los atributos utilizados en la forma. Por lo tanto, el contexto de las formas creadas desde el Asistente de Procesos, es siempre la entidad de Proceso.

Copyright 2013 - Bizagi

781

Sin embargo hay escenarios donde el contexto de las formas NO es la entidad de Proceso. En estos casos usted navegar el modelo de datos desde otra entidad. Estos escenarios son: Agregar y Editar formas en un control tipo Tabla. Buscar desde en un control de Bsqueda. Formas anidadas.

Contexto utilizando un control de Tablas

Las tablas son una poderosa funcionalidad que permite al usuario final incluir (o editar) registros en una ventana independiente, donde se puede utilizar cualquier tipo de control. Recuerde que para utilizar una tabla, debe haber una coleccin definida. Gracias a las Formas de Adicin y Edicin de registros, el desarrollador puede solicitar cualquier informacin que el negocio necesite, para asegurar que cada registro se completa de la manera deseada. Incluso puede incluir una Tabla dentro de la forma de Adicin o Edicin de la primera Tabla. Cuando el usuario final da clic en el icono de Agregar o Editar en el Portal de Trabajo, se abrir una nueva ventana donde se presenta la informacin. Esta nueva ventana tiene un cam b io d e co n tex to . En las Formas de Adicin y Edicin estamos accediendo a informacin especfica de la coleccin y utilizando Controles que aplican solo a esa coleccin. Por lo tanto, en las Formas de Adicin y Edicin de una tabla, el contexto es la entidad

782

Copyright 2013 - Bizagi

de coleccin.

Nota: Esto tambin aplica para las reglas de validacin relacionadas a las Formas de Adicin o Editar de la tabla. Estas tambin tendrn al entidad de coleccin como contexto. Por lo tanto, cuando se utiliza un XPath, la primera entidad para navegar el modelo de datos, es la coleccin.

Contexto utilizando el control de Bsqueda

El control de Bsqueda requiere de una Forma de Bsqueda para que el usuario final pueda realizar la bsqueda en el Portal de Trabajo. La Forma de Bsqueda es un tipo especial de Forma que coniten dos secciones: una que muestra el criterio de bsqueda y una que muestra los resultados. Cuando se utilizan Controles de Bsqueda, es importante saber que el contexto de la Forma de Bsqueda es la entidad donde se realiza la bsqueda.

Copyright 2013 - Bizagi

783

Contexto en Formas Anidadas

Las Formas Anidadas son formas creadas para ser reutilizadas a travs de un proyecto. Usted puede crear una Forma con los atributos y propiedades necesarios y utilizarla varias veces cuando desee mostrar exactamente la misma informacin en varias actividades. Cuando estas formas reusables se incluyen dentro de una Forma, se muestran resaltadas con una F o rm a A n id ad a. Usted puede crear estas Formas en una entidad para obtener la informacin requerida. Luego, usted puede incluirlas dentro de otra forma de la misma manera que incluye un control. Debido a que estas formas se construyen dentro de cualquier entidad, la entidad donde se construyen las Formas Anidadas es la entidad de contexto.

784

Copyright 2013 - Bizagi

3.4.8

Donde crear formas

Dependiendo de donde se cree una Forma, esta puede ser utilizada en diferentes lugares y por lo tanto, ser mostrada en el Portal de Trabajo bajo diferentes situaciones. Adicionalmente, estarn disponibles o no, para ser reutilizadas en otras formas. Las Formas creadas desde el tercer paso del Asistente de Proceso se denominan Formas de Actividad. Estas son las responsables de mostrar, al usuario final, la informacin necesaria para cada actividad. Estas formas no pueden ser reutilizadas.

Copyright 2013 - Bizagi

785

Formas Anidadas: Las Formas Anidadas se crean desde una Forma de Actividad o desde una entidad. Estas pueden ser reutilizadas en otras Formas a lo largo del proyecto, de manera que solo se construyen una vez y en caso de requerirse algn cambio, solo deben ser modificadas en un lugar.

786

Copyright 2013 - Bizagi

Las Formas creadas como Formas de Adicin y Edicin en una tabla, se pueden crear desde una Forma de Actividad o desde la entidad de coleccin. Estas pueden ser reutilizadas como Formas de Adicin y Edicin en cualquier lugar donde se utilice una tabla de esa coleccin.

Copyright 2013 - Bizagi

787

Las Formas creadas como Formas de Bsqueda asociadas a un control de Bsqueda, son creadas desde una Forma de Actividad o desde la entidad donde se ejecutar la Bsqueda. Estas pueden ser reutilizadas como Formas de Bsqueda.

788

Copyright 2013 - Bizagi

Las Formas para Administrar registros de Entidades Paramtricas desde el Portal de Trabajo, se crean desde la Entidad Paramtrica a administrar. Estas formas no pueden ser reutilizadas y se construyen utilizando el Modelador de Formas.

Copyright 2013 - Bizagi

789

790

Copyright 2013 - Bizagi

Las Formas de Consulta son formas especiales que no se muestran en las Tareas pendientes, sino que se utilizan para ingresar criterios de bsquedas Avanzadas, para encontrar casos o registros de entidad. Estas formas tienen un men independiente en el Portal de Trabajo, donde los usuarios pueden acceder a ellas y realizar bsquedas de acuerdo a los criterios definidos. Las Formas de consulta se crean en la entidad especfica sobre la cul se ejecutar la bsqueda. No pueden ser reutilizadas. Las Formas Globales y de Resumen son las formas que se muestran a los usuarios finales cuando buscan un caso donde no tienen tareas pendientes. Tambin se muestran antes de que los usuarios den clic en el botn Trab ajar en el caso cuando si las tienen. Estas formas pueden ser reutilizadas a lo largo del proyecto. Nota Tenga en cuenta como buena prctica, dar un nombre claro a las Formas para indicar la informacin que contiene, as como su objetivo. De lo contrario, ser difcil reutilizarlas sin tener que abrirlas primero para ver su contenido. 3.4.8.1 Formas de Entidad Bizagi le permite reutilizar una forma que contenga la informacin que se mostrar, de la misma manera, en varias formas de un proceso o entre distintos procesos que utilizan la misma entidad de proceso.

Copyright 2013 - Bizagi

791

Estas formas son Formas de Entidad, tambin conocidas como Formas Reusables, debido a que no son creadas directamente en el Proceso sino en la entidad que contiene su informacin, es decir, en la entidad de contexto. Notas Las formas de entidad pueden ser utilizadas como Formas Anidadas, Formas para adicionar y editar registros en tablas, formas de bsqueda o Vnculos a Forma. Para configurar una forma como reusable, tenga en cuenta que usted tiene que crearla en la opcin F o rm as de una entidad. Por lo tanto, el contexto de la forma ser la entidad donde es creada. Es importante saber que cuando las Formas de Entidad se utilizan como Formas Anidadas, tendrn una jerarqua. Por ejemplo, si una Forma Anidada es definida como no editable, todos los controles de la forma se mostrarn como no editables, a pesar de su propia configuracin. Si usted necesita crear una forma reusable, hay dos maneras de hacerlo: Directamente desde la primera forma donde usted desea utilizarla. Desde la entidad.

Crear una Forma de Entidad (o Forma Reusable) desde una Forma

Suponga que usted disear las formas de un Proceso de Solicitud de compra. Usted sabe que la informacin de la solicitud se mostrar en todas las formas del Proceso por lo que, la forma ideal de incluirla, sera creando una forma reusable. De esta manera usted crear una forma con la informacin necesaria solamente una vez y la reutilizar en cualquier lugar que se requiera. Adicionalmente, si usted quiere cambiar algo en la forma, usted puede hacerlo desde un solo lugar sin necesidad de repetir el cambio en todas las formas donde aparezca la informacin. Los atributos relacionados a la informacin que ser parte de la forma reusable estn almacenados en la Entidad de Proceso. 1. Ubique el icono F o rm as Reu sab les en el diseador de Formas, bajo la entidad. D clic en N u ev a fo rm a

792

Copyright 2013 - Bizagi

2. Se abrir un nuevo Diseador de Formas. Esta forma tendr el contexto de la entidad donde se almacenar para usos futuros. 3. Cree la forma incluyendo la informacin requerida. Vaya a las Propiedades de la Forma y asigne un nombre que le ayude a identificarla. Guarde y cierre la forma.

Copyright 2013 - Bizagi

793

4. Regrese a la forma de la actividad e inserte la Forma que acab de crear arrastrndola desde el panel izquierdo hasta el rea de trabajo.

794

Copyright 2013 - Bizagi

5. La Forma de la entidad tendr un borde resaltado para identificarla como una Forma Anidada. Si usted necesita editar la Forma, d clic sobre ella y seleccione el icono de Ed itar en la parte inferior.

Copyright 2013 - Bizagi

795

Crear una Forma de entidad (o Forma Reusable) desde una entidad

Suponga que usted disear las formas de un Proceso de Solicitud de compra. Usted sabe que la informacin de la solicitud se mostrar en todas las formas del Proceso por lo que, la forma ideal de incluirla, sera creando una forma reusable. De esta manera usted crear una forma con la informacin necesaria solamente una vez y la reutilizar en cualquier lugar que se requiera. Adicionalmente, si usted quiere cambiar algo en la forma, usted puede hacerlo desde un solo lugar sin necesidad de repetir el cambio en todas las formas donde aparezca la informacin. Los atributos relacionados a la informacin que ser parte de la forma reusable estn almacenados en la Entidad de Proceso. 1. Vaya a la vista de Mdulos y abra el mdulo de En tid ad es. Ubique la entidad de contexto y d clic derecho sobre la opcin F o rm as. D clic en N u ev a fo rm a

796

Copyright 2013 - Bizagi

2. Se abrir un nuevo Diseador de Formas. Esta forma tendr el contexto de la entidad donde se almacenar para usos futuros. 3. Cree la forma incluyendo la informacin requerida. Vaya a las Propiedades de la Forma y asigne un nombre que le ayude a identificarla. Guarde y cierre la forma.

Copyright 2013 - Bizagi

797

4. Regrese a la forma de la actividad e inserte la Forma que acab de crear arrastrndola desde el panel izquierdo hasta el rea de trabajo. La Forma de la entidad tendr un borde resaltado para identificarla como una Forma Anidada. Si usted necesita editar la Forma, d clic sobre ella y seleccione el icono de Ed itar en la parte inferior.

798

Copyright 2013 - Bizagi

3.4.8.2

Formas Administrables para Entidades Paramtricas Bizagi define formas por defecto para la administracin de entidades Paramtricas en el Portal de Trabajo. Estas formas mostrarn todos los atributos definidos para la entidad. Sin embargo, usted puede personalizar estas formas para poder mostrar, adicionar y editar registros de las forma requerida as como realizar validaciones sobre la informacin ingresada. Las tres formas por defecto que pueden ser relacionadas a una entidad son: Forma de Mostrar: Esta forma define las columnas que se mostrarn para todos los registros de la entidad, cuando usted ingrese al Men de administracin de entidades. Estos registros se muestran siempre en modo de solo lectura. Forma de Adicin: Esta forma se mostrar cuando se agregue un nuevo registro a una entidad paramtrica especfica. Forma de Edicin: Esta forma se mostrar cuando se modifique un registro existente de una entidad paramtrica especifica. Nota

Copyright 2013 - Bizagi

799

Las Formas administrables estarn disponibles en el modelador de formas V.9.

Nota Las Formas Administrables, por defecto, se crean con todos los atributos que contiene la entidad al momento de su creacin. Si usted crea mas atributos despus, tendr que incluirlos manualmente en las formas.

1. Para disear Formas Administrabes, vaya el mdulo En tid ad es en Bizagi Studio. D clic derecho sobre la entidad paramtrica de inters y seleccione la opcin P ro p ied ad es A v an zad as.

800

Copyright 2013 - Bizagi

2. Modifique cualquiera de las formas (Forma de Mostrar, Adicin o Edicin) dando clic sobre el botn correspondiente de edicin.

3. En la nueva ventana, incluya los atributos requeridos. Note que la opcin Es A d m in istrab le debe estar habilitada. Tenga cuidado de no alterar esta configuracin despus de que su forma ha sido configurada.

Copyright 2013 - Bizagi

801

Una vez que la forma por defecto se personaliza, se habilitar el botn de Desv in cu lar para permitir la restauracin de la configuracin inicial.

Ejemplo
Suponga que usted tiene una Entidad Paramtrica denominada Ciudad. En esta usted almacena los nombres de diferentes ciudades del mundo para permitir a los usuarios utilizarlos como informacin del Proceso. Los atributos de la entidad son los siguientes:

Atributo Nombre Estado

Descripcin Nombre de la Ciudad. Entidad Paramtrica que contiene el nombre del Estado al cual pertenece la ciudad.

802

Copyright 2013 - Bizagi

Atributo Pas

Descripcin Entidad Paramtrica que contiene el nombre del Pas al cual pertenece la ciudad.

El modelo de datos para este ejemplo se muestra a continuacin. Observe la relacin existente entre las entidades de Estado y Pas. Esta es til para filtrar los valores de los Estados de acuerdo a un Pas especfico.

Cuando usted crea la Entidad, las formas de adicin, edicin y visualizacin de registros de la entidad se definen, por defecto, conteniendo todos sus atributos ( N o m b re, Estad o , P as). Suponga que usted desea mostrar una interfaz amigable al usuario final y asegurar la integridad de la informacin ingresada. Usted necesita filtrar los Estados de acuerdo al Pas seleccionado, al momento de ingresar y editar la informacin en la Entidad. Este comportamiento no se incluye en la forma por defecto, por lo que usted tiene que configurarlo. Para hacerlo, siga los pasos que se describen a continuacin:

1. Vaya al mdulo de Entidades en Bizagi Studio. D clic derecho en la entidad paramtrica Ciu d ad y seleccione la opcin de P ro p ied ad es A v an zad as.

Copyright 2013 - Bizagi

803

2. Para configurar el comportamiento deseado en la F o rm a d e A d ici n , d clic en el botn Ed itar que se encuentra al lado de la etiqueta correspondiente.

3. En la nueva ventana agregue o remueva los atributos que desee. Usted tambin puede definir los comportamientos requeridos para cada control de la forma.

804

Copyright 2013 - Bizagi

Para este caso configure un filtro para el control Estad o . D clic en el control, vaya a las opciones de En tid ad Relacio n ad a dentro de sus propiedades y luego d clic en el campo filtro.

Configure la condicin de filtro. Los Estados mostrados deben ser aquellos relacionados al Pas seleccionado en la forma. Para establecer esta comparacin, utilice el atributo cdigo de la entidad P as.

Copyright 2013 - Bizagi

805

D clic en O K para mantener los cambios y luego cerrar la forma. 4. Repita el mismo procedimiento para la F o rm a d e Ed ici n . 5. Vaya al Portal de Trabajo y pruebe los controles.

806

Copyright 2013 - Bizagi

Artculos relacionados
Valores de Entidades paramtricas en el Portal de Trabajo 3.4.8.3 Formas de consulta

Informacin General
Bizagi permite la definicin y personalizacin de Formas especiales para consultar la informacin relacionada a los casos. Estas formas se denominan Co n su ltas. Usted puede definir consultas muy poderosas para buscar casos por rango de fecha o utilizar la informacin del caso y definir coincidencias exactas o similares, etc. Usted tambin puede construir Consultas para buscar informacin relacionada a Entidades especficas (Maestras o Paramtricas). Estas Consultas a nivel de Entidad permiten a los usuarios finales ver la informacin, por ejemplo, acerca de Clientes, productos o cualquier entidad principal. Dicha informacin no esta relacionada a casos en particular sino directamente a valores de la entidad. Para definir una Consulta usted debe utilizar las F o rm as d e Co n su lta. Estas Formas se utilizan para especificar los datos, que forman parte de casos de negocio o Procesos, que se utilizarn como criterio para realizar las consultas. Consulte el siguiente tema para aprender Cmo ejecutar Consultas.

Tipos de Consultas
Una consulta siempre tiene una forma en la cual los campos incluidos sern lso criterios de bsqueda. Se pueden disear dos tipos de consultas en Bizagi Studio: Consultas de Aplicacin (Proceso) Permiten consultar casos en Bizagi. Para esto, la consulta utiliza la Entidad de Proceso como la Entidad

Copyright 2013 - Bizagi

807

de Contexto. En una Forma de Consulta de Aplicacin, usted puede incluir dos tipos de control: Modelo de Datos: Controles asociados a atributos del modelo de datos de negocio. Internos: Controles referentes a informacin relacionada a un caso, que no esta almacenada en el modelo de datos (creador del caso, nmero de caso, proceso etc.) Consultas de Entidad Permite consultar informacin asociada a Entidades. Para esto, la consulta utiliza la Entidad definida como la Entidad de Contexto. El Formas de Consulta de entidad pueden incluir controles asociados a la entidad especfica. Por lo tanto, la informacin retornada por las consultas de entidad es informacin de negocio y no de casos directamente. Los controles internos no se pueden utilizar en las Consultas de Entidad (debido a que no traen informacin de casos).

Propiedades de la Forma de Consulta

Una Forma puede ser utilizada como Forma de de Consulta cuando la propiedad de Es F o rm a d e Co n su lta se activa. Esto habilitar todas las propiedades especiales y comportamientos de una Forma de Consulta. Nota Las Formas de Consulta estarn disponibles en el Modelador de Formas de la V.9.

808

Copyright 2013 - Bizagi

Usuarios incluidos en Consultas

Usted puede definir consultas para buscar todos los casos existentes que cumplan criterios definidos o solo aquellos en los cuales usted posee actividades pendientes. Para definir este comportamiento, las Formas de Consulta cuentan con la propiedad Usu ario s a in clu ir. Esta propiedad tiene dos valores posibles: Todos los Usuarios: Define si al bsqueda se realizar sobre todos los casos para todos los usuarios. Usuario Actual: Define si la bsqueda se realizar solamente para los casos pendientes del usuario autenticado.

Propiedades de control en las Formas de Consulta

Algunas caractersticas especiales para algunos controles se habiltarn, cuando la forma se define como Forma de Consulta. Esto permitir que consultas se realicen de una mejor manera. A continuacin usted encontrar una breve descripcin de estas caractersticas especiales de acuerdo al Control: Control de Texto: Para este control usted podr definir si la bsqueda debe ser aproximada o exacta: Exacta: El texto debe ser escrito exactamente como es guardada.

Copyright 2013 - Bizagi

809

Aproximada: Usted puede utilizar un signo de porcentaje para la bsqueda. Por ejemplo, para buscar todos los casos de un cliente de apellido Wilson, la bsqueda se puede realizar como % W ilso n

Controles numricos o de Fecha: Para este control usted podr definir un rango de valores para un atributo a buscar. Defina si el control es el lmite inferior (Desd e) o superior ( H asta). En este caso, el mismo campo se incluye dos veces en la misma forma y el nombre de mostrar se cambia para indicar el inicio y fin del rango, respectivamente.

810

Copyright 2013 - Bizagi

Nota: Hay algunos tipos de dato que no se permiten en la Forma de Consulta. Por lo tanto estos no se mostrarn al momento de seleccionar un control para incluir en la forma. Por ejemplo: Campo de Bsqueda, sugerencia, imagen entre otros.

Cmo crear Formas de Consulta

Las Formas de Consulta se crean desde el Asistente de Formas de Consulta. De acuerdo al tipo de Consulta, este asistente se puede acceder desde distintas opciones. En la ventana del Asistente de Consultas usted encontrar los siguientes campos: Nombre: Es el nombre de la Forma de Consulta. Este nombre debe ser claro e indicar sus componentes de una manera sencilla. Debe comenzar con una letra mayscula y no contener tildes ni espacios. Nombre de Mostrar: Es el nombre de mostrar de la Forma de Consulta. Debe comenzar con una letra mayscula y puede contener tildes y espacios. Descripcin: Describe la Forma para brindar ms claridad sobre ella.

Copyright 2013 - Bizagi

811

Texto de Ayuda: El texto de ayuda aparece cuando usted da clic en un control de la forma en el Portal de Trabajo. Forma: En este campo se define la forma que se utilizar como Forma de Consulta. Si usted desea definir una Forma ya creada como Forma de Consulta, seleccinela en la lista desplegable.

Si usted desea crear una nueva Forma de Consulta, d clic en el icono (+) para abrir el Modelador de Formas.

812

Copyright 2013 - Bizagi

La Entidad de Contexto de la Forma ser la Entidad de Aplicacin o Entidad especfica dependiendo del tipo de Consulta que se esta creando.

Consultas en produccin
Para garantizar el correcto desempeo de todos los ambientes, una vez hecho deployment las Consultas no se podrn editar o eliminar. Si se necesitan nuevas consultas, usted pude crearlas y asociarlas.
3.4.8.3.1 Consultas de Aplicacin

Este tipo de Consultas permiten consultar casos en Bizagi. Para esto, las consultas utilizan la Entidad de Proceso como la Entidad de Contexto. En una Forma de Consulta de Aplicacin, usted puede incluir dos tipos de control: Modelo de Datos: Controles asociados a atributos del modelo de datos de negocio. Internos: Controles referentes a informacin relacionada a un caso, que no esta almacenada en el modelo de datos (creador del caso, nmero de caso, proceso etc.) Consulte el siguiente tema para aprender Cmo ejecutar Consultas.

Cmo crear Formas de Consulta de Aplicacin

Como vimos en la seccin previa, las Formas de Consulta se crean desde el Asistente de Formas de Consulta. Para las Consultas de Aplicacin, este asistente puede accederse desde diferentes opciones de acuerdo a la forma en que se asociarn a un proceso. Las Formas de Consulta de Aplicacin se pueden asociar a Procesos de dos maneras:

Copyright 2013 - Bizagi

813

Asociar una Forma de Consulta especfica a uno o mas Procesos de una Aplicacin
Para asociar Formas de Consulta a mltiples Procesos pertenecientes a la misma aplicacin siga los pasos que se describen a continuacin: 1. Vaya a la En tid ad d e A p licaci n , d clic derecho en la opcin Co n su ltas y luego seleccione N u ev a Co n su lta. Alternativamente, esta opcin se encuentra en el M en co n tex tu al.

2. El asistente de Formas de Consulta se abrir. Llene lo campos requeridos. En el campo Forma, asocie una forma existente o cree una nueva, segn lo requiera.

814

Copyright 2013 - Bizagi

Observe, al momento de crear una Nueva Forma, que la Entidad de Contexto es la Entidad de Aplicacin.

3. Despus de definir la forma, d clic en Siguiente. Se mostrarn los procesos y subprocesos a los que puede ser asociada la forma. Selecciones los

Copyright 2013 - Bizagi

815

necesarios. Esta seleccin es necesaria para efectos de Deployment nicamente. Bizagi necesita saber a qu proceso pertenece. Esta seleccin no afecta en nada los resultados de la consutla.

Finalmente d clic en F in alizar.

Asociar una o mas Formas de Consulta al Proceso.

Para asociar Formas de Consulta mltiples a un Proceso especfico, siga los pasos descritos a continuacin: 1. En el Mdulo de P ro ceso s, vaya a el Proceso al cual se asociarn las Consultas. D clic derecho sobre l y seleccione la opcin M o strar Co n su ltas Relacio n ad as.

816

Copyright 2013 - Bizagi

2. En la nueva ventana cree las formas requeridas o edite las existentes que desee, dando clic en el botn correspondiente. Se abrir el asistente de Formas de Consulta donde deber seguir el procedimiento mostrado en la seccin anterior.

Copyright 2013 - Bizagi

817

3. Una vez definidas, seleccione las consultas que se asociarn al Proceso y luego d clic en O K.

818

Copyright 2013 - Bizagi

Cmo Editar una Forma de Consulta de Aplicacin

1. En el men de Bizagi, d clic en el mdulo de En tid ad es y seleccione la Entidad de Aplicacin donde se cre la consulta. D clic en la opcin Co n su ltas. Las lista de Formas de Consulta se mostrar en el rea de trabajo correspondiente. D clic derecho sobre la consulta que desea editar y seleccione la opcin P ro p ied ad es (tambin puede dar doble clic sobre ella). El asistente de Formas de Consulta se mostrar.

D clic en el botn Ed itar para abrir el Modelador de Formas y modificar los controles y propiedades necesarias de la forma.

Copyright 2013 - Bizagi

819

Cmo eliminar una Forma de Consulta de Aplicacin

1. En el men de Bizagi, d clic en el mdulo de En tid ad es y seleccione la Entidad de Aplicacin donde se cre la consulta. D clic en la opcin Co n su ltas. Las lista de Formas de Consulta se mostrar en el rea de trabajo correspondiente. D clic derecho sobre la consulta que desea eliminar y seleccione la opcin B o rrar.

820

Copyright 2013 - Bizagi

2. Seleccione Si en la ventana de confirmacin de eliminacin. Usted podr llevar a cabo un anlisis de dependencias si lo desea. Si la forma de consulta no posee dependencias podr eliminarla efectivamente.
3.4.8.3.1.1 Campos Internos

Las Formas de Consulta de Aplicacin pueden incluir informacin adicional, relacionada a los casos, que no forma parte del modelo de datos. Esta sirve como criterio de bsqueda. Dicha informacin se incluye en controles conocidos como Internos, los cuales solo se habilitarn cuando la propiedad de Es F o rm a d e Co n su lta esta activada. Por ejemplo, los campos internos pueden ser: Estado del caso (abierto, cerrado, abortado), Usuario actual, Id del caso, nombre completo de los creadores, etc. Los casos internos se pueden filtran seleccionado un valor por defecto en el men de Render. Nota: El atributo Estado del Caso permite que la bsqueda se lleve a cabo por el usuario, sobre todos los casos (pendientes, cerrados o abortados). Un control de tipo radio aparecer automticamente en la forma, donde se podr seleccionar el estado. Cuando el usuario no agrega este campo Bizagi lo har automticamente.

Cmo incluir un Campo Interno

1. En la Forma de Consulta inserte un control de cuadro de texto.

2. Seleccione In tern o en el Tip o d e Cam p o dentro de las propiedades de In fo rm aci n B sica del cuadro de texto .

Copyright 2013 - Bizagi

821

3. Seleccione el tipo de campo interno en la propiedad de Cam p o In tern o .

4. Finalmente asigne un nombre de mostrar al cuadro de texto.

822

Copyright 2013 - Bizagi

Nota: Si las consultas de entidad requieren incluir datos desde tablas, es decir, informacin de relaciones 1:N (uno a muchos), la informacin de la entidad muchos se mostrar de la misma manera que la informacin en la entidad uno. No habr una tabla en la Forma de Consulta. Esta informacin no puede ser incluida como resultado de una consulta; solo como criterio de bsqueda.

Los campos internos disponibles son:

Nombre de campo Interno

Descripcin

Incluir el resultado de las consultas

Aplicacin (Application)

Este campo permite seleccionar sobre que aplicacin se desean consultar los casos. Se presenta un combo con la lista de las aplicaciones que se encuentran en Bizagi.

SI

Nmero del caso (Case ID)

Este campo permite buscar por el nmero de caso. Debe incluirse exactamente el nmero de caso que se requiere consultar. (Es el mismo nmero de creacin en caso de que no se haya especificado lo

SI

Copyright 2013 - Bizagi

823

Nombre de campo Interno

Descripcin

Incluir el resultado de las consultas

contrario).

Nmero de Radicacin (Case Rad Number)

Este campo permite buscar por nmero de creacin. La consulta por este criterio puede ser exacta o aproximada, esto se configura en las Propiedades del Diseador de Formas.

SI

Este atributo permite seleccionar el estado de los casos a consultar, en la forma de consulta se presenta una atributo tipo radio con las siguientes opciones: abiertos, cerrados, anulados o todos. Cuando se consultan por todos los estados, en el resultado de las consultas se visualiza en la columna estado el icono que identifica el estado de cada una de las actividades del caso: Casos Cerrados Casos Anulados Casos con actividades pendientes, estado de la actividad Verde: A tiempo. Amarillo: En Riesgo. Rojo: Vencido.

Estado del Caso (Case State)

NO

Fecha de Creacin del Caso (Case Radication Para incluir la consulta por los criterios Desde y Date) hasta, se debe incluir en la forma de consulta dos veces el mismo campo y a uno seleccionar la opcin desde y al otro la opcin hasta.

Este atributo permite buscar por la fecha de creacin del caso. La consulta por este criterio puede ser desde, hasta o Ninguna (exacta), esto se configura en la pestaa Forma de Consulta (Query Form).

SI

Este atributo permite buscar por la fecha de solucin del caso. La consulta por este criterio Fecha de puede ser desde, hasta o Ninguna (exacta), esto se Solucin del Caso configura en la pestaa Forma de Consulta (Query (Case Solution Form). Date) Para incluir la consulta por los criterios Desde y

SI

824

Copyright 2013 - Bizagi

Nombre de campo Interno

Descripcin

Incluir el resultado de las consultas

hasta, se debe incluir en la forma de consulta dos veces el mismo campo y a uno seleccionar la opcin desde y al otro la opcin hasta.

Creador del Caso (Creator)

Permite hacer una bsqueda por el Nombre Completo Usuario que cre el caso. En la forma de consulta se presenta un atributo tipo Buscador Ventana que permite realizar una bsqueda aproximada del usuario por el Nombre completo.

SI

Creador del Caso (Creator Full Name)

Este atributo permite buscar por el Nombre completo del usuario que cre el caso. La consulta por este criterio puede ser exacta o aproximada, esto se configura en la pestaa Forma de Consulta (Query Form). En la forma de consulta se presenta un atributo tipo texto.

SI

Creador del Caso (Creator Username)

Este atributo permite buscar por el nombre del usuario que cre el caso. La consulta por este criterio puede ser exacta o aproximada, esto se configura en la pestaa Forma de Consulta (Query Form). En la forma de consulta se presenta un atributo tipo texto. Este atributo permite buscar por el nombre de la posicin del usuario que cre el caso. La consulta por este criterio puede ser exacta o aproximada, esto se configura en la pestaa Forma de Consulta (Query Form). En la forma de consulta se presenta un atributo tipo texto. Permite buscar todos los casos que actualmente se encuentran en una actividad determinada.

SI

Cargo del Creador (Creator - Position)

SI

Tarea Actual (Current Task)

En la forma de consulta se presenta un atributo tipo combo con un listado de todas las actividades manuales, eventos, singletons, subprocesos.

SI

Copyright 2013 - Bizagi

825

Nombre de campo Interno

Descripcin

Incluir el resultado de las consultas

Identificado del Usuario Encargado (Current User)

Permite hacer una bsqueda por el Nombre Completo del Usuario que actualmente est trabajando en el caso. En la forma de consulta se presenta un atributo tipo Buscador Ventana que permite realizar una bsqueda aproximada del usuario por el Nombre completo.

SI

Nombre de campo Interno Nombre completo del usuario encargado (Current User Full Name)

Descripcin

Incluir el resultado de las consultas

Este atributo permite buscar por el Nombre completo del usuario que actualmente est trabajando en el caso. La consulta por este criterio puede ser exacta o aproximada, esto se configura en la pestaa Forma de Consulta (Query Form). En la forma de consulta se presenta un atributo tipo texto.

SI

Nombre de usuario del usuario encargado (Current User Username)

Este atributo permite buscar por el nombre del usuario que actualmente est trabajando en el caso. La consulta por este criterio puede ser exacta o aproximada, esto se configura en la pestaa Forma de Consulta (Query Form). En la forma de consulta se presenta un atributo tipo texto. Este atributo permite buscar por el nombre de la posicin del usuario que actualmente est trabajando en el caso. La consulta por este criterio puede ser exacta o aproximada, esto se configura en la pestaa Forma de Consulta (Query Form). En la forma de consulta se presenta un atributo tipo texto. Permite buscar todos los casos cuya actividad anterior a la actual fue una actividad determinada. En la forma de consulta se presenta un atributo tipo combo con un listado de todas las actividades manuales, eventos, singletons, y subprocesos.

SI

Cargo del usuario encargado (Current User Position)

SI

Actividad realizada (Previous Task)

NO

826

Copyright 2013 - Bizagi

Nombre de campo Interno

Descripcin

Incluir el resultado de las consultas

Identificador de encargado anterior (Previous User)

Permite hacer una bsqueda por el Nombre Completo del Usuario que trabajo en una instancia anterior en el caso. En la forma de consulta se presenta un atributo tipo Buscador Ventana que permite realizar una bsqueda aproximada del usuario por el Nombre completo. este atributo permite buscar por el Nombre completo del usuario que trabajo en una instancia anterior en el caso. La consulta por este criterio puede ser exacta o aproximada, esto se configura en la pestaa Forma de Consulta (Query Form). En la forma de consulta se presenta un atributo tipo texto. Este atributo permite buscar por el Nombre del usuario que trabajo en una instancia anterior en el caso. La consulta por este criterio puede ser exacta o aproximada, esto se configura en la pestaa Forma de Consulta (Query Form). En la forma de consulta se presenta un atributo tipo texto. Este atributo permite buscar por el nombre de la posicin del usuario que trabajo en una instancia anterior en el caso. La consulta por este criterio puede ser exacta o aproximada, esto se configura en la pestaa Forma de Consulta (Query Form). En la forma de consulta se presenta un atributo tipo texto. Permite buscar todos los casos que pertenecen a un proceso determinado.

NO

Nombre completo de encargado anterior (Previous User Full Name)

NO

Nombre de usuario de encargado anterior (Previous User Username)

NO

Cargo de encargado anterior (Previous User Position)

NO

Proceso (Process)

En la forma de consulta se presenta un atributo tipo combo con un listado de todos los procesos del proyecto. Este atributo permite buscar por la fecha de creacin de las actividades. La consulta por este criterio puede ser desde, hasta o Ninguna (exacta), esto se configura en la pestaa Forma de Consulta (Query Form).

SI

Fecha de creacin de la actividad (Task Entry Date)

SI

Copyright 2013 - Bizagi

827

Nombre de campo Interno Para incluir la hasta, se debe veces el mismo desde y al otro

Descripcin

Incluir el resultado de las consultas

consulta por los criterios Desde y incluir en la forma de consulta dos campo y a uno seleccionar la opcin la opcin hasta.

Fecha de vencimiento de la actividad (Task Expiry Date)

Este atributo permite buscar por la fecha de expiracin de las actividades. La consulta por este criterio puede ser desde, hasta o Ninguna (exacta), esto se configura en la pestaa Forma de Consulta (Query Form). Para incluir la hasta, se debe veces el mismo desde y al otro consulta por los criterios Desde y incluir en la forma de consulta dos campo y a uno seleccionar la opcin la opcin hasta.

SI

Estado de la tarea (Task State)

Este atributo permite seleccionar el estado de las actividades pendientes de los casos a consultar, en la forma de consulta se presenta una atributo tipo radio con las siguientes opciones: Vencido, Vence Hoy, Vence en el futuro o todos. Cuando se consultan por todos los estados, se consultan todos los casos as no se tengan actividades pendientes, en el resultado de las consultas se visualiza en la columna estado (state).

NO

3.4.8.3.2 Consultas de Entidad

En este tipo de Consultas, los resultados se asociarn a la entidad en que se busca. Adicionalmente, no hay campos Internos asociados a este tipo de Formas de Consulta. Estas Consultas se utilizan para acceder a la informacin de Entidades especficamente, sin importar su desempeo respecto a los casos. Por ejemplo, en un proceso de venta al por menor, la compaa quisiera realizar bsquedas relacionadas a sus clientes. Se podran realizar bsquedas sobre los clientes existentes para obtener estadsticas por genero y edad. Otro ejemplo es cuando un banco necesita buscar en sus Productos vendidos. Se creara una Forma de Consulta de Entidad sobre los producto que les permitira conocer el monto solicitado para tarjetas de crdito, o cuantas fueron Visa y cuantas Master Card. Consulte el siguiente tema para aprender Cmo ejecutar Consultas.

Cmo crear y asociar una Forma de Consulta de Entidad

1. Vaya al mdulo de En tid ad es e identifique la Entidad para la cul se definir la consulta . D clic

828

Copyright 2013 - Bizagi

derecho en la opcin Co n su ltas y luego seleccione N u ev a Co n su lta.

2. El asistente de Formas de Consulta se abrir. Llene lo campos requeridos. En el campo Forma, asocie una forma existente o cree una nueva, segn lo requiera.

Copyright 2013 - Bizagi

829

Observe, al momento de crear una Nueva Forma, que la Entidad de Contexto es la Entidad especfica.

Finalmente d clic en F in alizar.

Cmo Editar una Forma de Consulta de Entidad

1. En el men de Bizagi, d clic en el mdulo de En tid ad es y seleccione la Entidad donde se cre la consulta. D clic en la opcin Co n su ltas.

830

Copyright 2013 - Bizagi

Las lista de Formas de Consulta se mostrar en el rea de trabajo correspondiente. D clic derecho sobre la consulta que desea editar y seleccione la opcin P ro p ied ad es (tambin puede dar doble clic sobre ella). El asistente de Formas de Consulta se mostrar.

D clic en el botn Ed itar para abrir el Modelador de Formas y modificar los controles y propiedades necesarias de la forma.

Copyright 2013 - Bizagi

831

Cmo eliminar una Forma de Consulta de Entidad

1. En el men de Bizagi, d clic en el mdulo de En tid ad es y seleccione la Entidad donde se cre la consulta. D clic en la opcin Co n su ltas. Las lista de Formas de Consulta se mostrar en el rea de trabajo correspondiente. D clic derecho sobre la consulta que desea eliminar y seleccione la opcin B o rrar.

832

Copyright 2013 - Bizagi

2. Seleccione Si en la ventana de confirmacin de eliminacin. Usted podr llevar a cabo un anlisis de dependencias si lo desea. Si la forma de consulta no posee dependencias podr eliminarla efectivamente. 3.4.8.4 Formas globales y de resumen

Informacin General
Las formas Globales y de Resumen son aquellas relacionadas a un Proceso con el fin de mostrar informacin resumida. Estas formas se utilizan exclusivamente para mostrar informacin, de manera que los registros en las tablas y valores en ellas, no pueden ser modificados.

Forma de Global
Revisa la informacin general de un caso en el cual no se tienen actividades pendientes. Revisa la informacin principal de un caso que ha sido cerrado. La Forma Global se puede acceder dando clic en el vnculo del nmero de creacin de un caso retornado a travs de una bsqueda (casos cerrados o aquellos donde no hay actividades pendientes) . Las Formas Globales se relacionan a versiones especficas de Proceso. Si un Proceso tiene varias versiones, cada una de ellas debera tener una Forma Global asociada.

Copyright 2013 - Bizagi

833

Crear y Asociar una Forma Global

1. En la vista de mdulos vaya a En tid ad es y d clic en la Entidad de Aplicacin a la cual pertenece el Proceso, D clic derecho en la opcin F o rm as y seleccione N u ev a F o rm a. Usted tambin puede copiar una que ya haya sido creada.

2. Asegrese de que la forma contiene toda la informacin relevante del Proceso (en modo solo lectura). 3. En el mdulo de P ro ceso s identifique el Proceso y versin a la cual se configurar la Forma Global. D clic derecho sobre la opcin Versi n y luego en P ro p ied ad es.

834

Copyright 2013 - Bizagi

4. En la nueva ventana, habilite la opcin Utilizar F o rm a Glo b al y seleccione la forma creada anteriormente en la lista desplegable.

Copyright 2013 - Bizagi

835

Nota Tenga en cuanta que la creacin de Formas Globales y de Resumen se debe hacer iniciando desde el nivel de Entidad de Aplicacin y no desde el nivel de una Entidad Maestra.

Forma de Resumen
Permite al usuario visualizar la informacin de casos asignados sin necesidad de ingresar en l. La Forma se puede acceder dando clic en el icono de lupa que se encuentra al lado de un caso especfico desde el Portal de Trabajo.

836

Copyright 2013 - Bizagi

La Forma de Resumen tambin aparece cuando los usuarios avanzan un caso y no poseen ms actividades pendientes en l.

Crear y Asociar una Forma de Resumen

1. En la vista de mdulos vaya a En tid ad es y d clic en la Entidad de Aplicacin a la cual pertenece el Proceso, D clic derecho en la opcin F o rm as y seleccione N u ev a F o rm a. Usted tambin puede copiar una que ya haya sido creada.

Copyright 2013 - Bizagi

837

2. En el mdulo de P ro ceso s identifique el Proceso y versin a la cual se configurar la Forma de Resumen. D clic derecho sobre la opcin Versi n y luego en P ro p ied ad es.

3. En la nueva ventana, habilite la opcin Utilizar F o rm a d e Resu m en y seleccione la forma creada anteriormente en la lista desplegable.

838

Copyright 2013 - Bizagi

Nota: Tenga en cuanta que la creacin de Formas Globales y de Resumen se debe hacer iniciando desde el nivel de Entidad de Aplicacin y no desde el nivel de una Entidad Maestra.

3.4.9

Guardar una Forma

Cuando se realizan cambios a una forma, estos pueden guardarse de dos maneras: Dando clic en el icono Gu ard ar que se encuentra en el Ribbon del Diseador de Formas.

Copyright 2013 - Bizagi

839

Cerrando la Forma.

Sin importar la forma en que guarde su Forma, si existen errores en la construccin, usted ser notificado. En caso de que la Forma se guarde utilizando el icono de Gu ard ar, se mostrar el siguiente mensaje:

Si usted da clic en Si, la forma e guardar ignorando los errores existentes. Si usted da clic en N o , la forma no se guardar y todos los errores se resaltarn de manera que usted pueda identificarlos y corregirlos.

840

Copyright 2013 - Bizagi

En caso de que la Forma se guarde cerrndola, se mostrar el siguiente mensaje:

Si usted da clic en Si, la forma e guardar ignorando los errores existentes. Si usted da clic en N o , la forma no se cerrar sin guardar los cambios. Si usted da clic en Can celar, la forma no se guardar y todos los errores se resaltarn de manera que usted pueda identificarlos y corregirlos.

Manejar errores en Formas

Los errores ms comunes que pueden surgir cuando se disea una Forma y la via para resolverlos, se describen a continuacin: Hay ms de un atributo con XPath {NombredelXpath}. Usted puede tener solo un atributo editable por XPath, por favor ajustelo. Este error aparece cuando dos o ms atributos editables, con el mismo mapeo al modelo de datos, se han incluido en la forma.

Copyright 2013 - Bizagi

841

Para resolver este error usted puede remover el atributo duplicado o solo dejar uno de ellos como editable. El contenedor no posee elementos. Incluya al menos una. Este error aparece cuando usted ha insertado un grupo o pestaa dentro de la Forma pero no ha incluido elementos dentro de l.

Para resolver este error, inserte al menos un Control en el contenedor.

La tabla no posee columnas. Incluya al menos una. Este error aparece cuando usted ha insertado una Tabla en la forma perno no ha definido columna alguna en ella.

842

Copyright 2013 - Bizagi

Para resolver este error, d clic en el botn Ed itar Co lu m n as e incluya al menos una columna (atributo de la tabla) para mostrar.

La propiedad de Forma de Adicin es requerida. Este error aparece cuando usted ha insertado una Tabla en la forma, las propiedad P erm itir A d ici n esta habilitada, Ed ici n En ln ea deshabilitada y no se ha definido una nueva F o rm a d e A d ici n .

Copyright 2013 - Bizagi

843

Para resolver este error usted puede: Asociar una Forma de Adicin . Desactivar la propiedad de Permitir Adicin y activar la Edicin En lnea. Para asociar una Forma de Adicin, d clic en la tabla y vaya a la pestaa A v an zad o de las P ro p ied ad es d e la Tab la. Seleccione la propiedad Forma de Adicin. Cree una nueva forma o seleccione una existente.

Para desactivar la propiedad P erm itir A d ici n o activar la propiedad A d ici n En ln ea, vaya a la pestaa Avanzado y d clic en la propiedad para cambiar su valor a Si o N o segn corresponda.

844

Copyright 2013 - Bizagi

Revise las propiedades Este error aparece cuando usted cre una Forma pero no asigno un Nombre de Mostrar.

Para resolver este error, vaya a las Propiedades de la Forma y escriba un nombre en el campo M o strar N o m b re.

Usted no puede incluir este Control. No tiene una entidad Padre. Para configurar uno, configure la entidad Padre en el ltimo paso del Asistente de Atributos. Este error aparece cuando usted inserta un control de lista desplegable en cascada en la forma y

Copyright 2013 - Bizagi

845

asocia a l una entidad paramtrica que no tiene una entidad padre configurada. Para mayor informacin acerca de como configurar este control, consulte Lista desplegable en cascada.

Para resolver este error, asegrese de que la entidad que esta intentando asociar tenga una entidad padre configurada, de lo contrario, usted puede asociar una siguiendo los pasos que se describen en entidades padre e hijo. Usted no puede convertir este Control. No tiene una entidad Padre. Para configurar uno, configure la entidad Padre en el ltimo paso del Asistente de Atributos.

Este error aparece cuando uste trata de convertir un control existente (cuya Fuente de datos es una entidad que no posee una entidad padre) a un control de lista desplegable en cascada.

Para resolver este error, asegrese de que la entidad que esta intentando convertir tenga una entidad padre configurada, de lo contrario, usted puede asociar una siguiendo los pasos que se describen en entidades padre e hijo.

3.4.10 Usar la opcin Copiar Desde

Bizagi provee una herramienta muy til para ayudarle a desarrollar sus formas de manera rpida. La funcionalidad Copiar desde le permite copiar una forma que ha sido diseada, para crear una nueva.

846

Copyright 2013 - Bizagi

Usted podr copiar desde el contexto donde est ubicado. Por lo tanto, cuando utilice esta opcin en una Forma de Proceso, usted podr copiar formas presentes en el Proceso. Cuando lo haga en una Entidad, usted podr copiar desde formas en esa entidad. Tenga en cuenta que la funcin Copiar Desde ANEXAR la informacin a la forma donde este copiando. Si usted ya tiene controles creados y utiliza esta opcin, la informacin copiada aparecer en la parte inferior de la forma.

Ejemplo
En un Proceso de Solicitud de Vacaciones, la primera actividad, Reg istrar so licitu d d e licen cia (donde el usuario solicita su licencia), ha sido diseada en el Diseador de Formas,

La segunda actividad, A p ro b ar so licitu d d e licen cia (donde el jefe del empleado aprueba o rechaza la solicitud), tendr la misma informacin (pero alguna ser de solo lectura) y adicionalmente se incluirn otros controles.

Copyright 2013 - Bizagi

847

Seleccione la opcin Co p iar Desd e en el Diseador de Formas. Una nueva venrana mostrar el flujo de Proceso. Seleccione la actividad Registrar Solicitud de Vacaciones dando clic sobre ella. Luego d clic en O K. La informacin se copia exactamente como la forma original. Uno a uno, usted puede configurar cada uno de los controles en la forma como de solo lectura, configurando las propiedad Ed itab le en Falso.

Ahora agregue los nuevos controles.

848

Copyright 2013 - Bizagi

Cuando la forma este completa, gurdela y cirrela.

3.5

Definicin de Reglas de Negocio

Las reglas de negocio son condiciones, estndar o reglas que deben ser cumplidas y controladas por la organizacin durante el flujo del proceso. Bizagi ofrece un ambiente grfico donde usted podr definir y administrar sus reglas de negocio fcilmente. Con un poderoso motor de Reglas de Negocio usted puede disear desde un flujo de control bastante simple hasta funciones o clculos complejos. Los siguientes enlaces muestran el uso de las expresiones: Flujo de secuencia (direccin del proceso) Realizar acciones en Actividades (por ejemplo, validaciones y clculos) Definir campos en las interfaces de usuarios como visibles o invisibles, requeridos o no requeridos, editables o de solo lectura. Asignacin de usuarios Otros

Copyright 2013 - Bizagi

849

Todas las expresiones utilizan el concepto de navegacin XPath. El estndar XPath en un lenguaje de navegacin de fcil uso para encontrar informacin dentro de un documento XML y es muy til para llevar a cabo tareas complejas. Bizagi ha adoptado e incorporado el XPath para seleccionar datos, permitiendo a los usuarios navegar fcilmente a travs de modelo de datos.

3.5.1

Acceso al modelo de datos a travs de XPath

Todas las reglas de negocio utilizan la navegacin de XPath para ayudar al usuario a moverse dentro del modelo de datos en una forma intuitiva. El estndar XPath en un lenguaje de fcil uso para encontrar informacin en un documento XML y es muy til para llevar a cabo tareas complejas. Bizagi ha adoptado e incorporado el XPath para seleccionar datos, permitiendo a los usuarios navegar fcilmente a travs de modelo de datos. La navegacin XPath es una herramienta que permite a los usuarios navegar a travs del modelo de datos, accediendo a atributos y a relaciones. La ubicacin del elemento dentro del modelo de datos siempre se escribe entre corchetes de diamante: < xpath route > Podemos acceder a una entidad y sus atributos, siempre que sigamos la estructura creada en el modelo de datos. Las expresiones XPath siempre comienzan con la entidad del proceso, ya que esta es el punto de inicio de navegacin al resto del modelo de datos. La navegacin del modelo de datos se define por las relaciones entre las entidades presentadas en forma de flechas. El siguiente diagrama ser utilizado para mostrar cmo trabajan los XPath. El proceso de Solicitud de compra tiene una entidad de proceso llamada Solicitud de Compra. Por ende, el contexto del proceso es la entidad Solicitud de compra, por la cual se accede al resto del modelo de datos, y es el punto de inicio para la navegacin XPath. Utilizando XPath es posible obtener los valores almacenados en un atributo o puede asignar un valor a este. Para obtener la direccin de entrega de la solicitud de compra usted debe utilizar la expresin: <PurchaseRequest.DeliveryAdress> Para obtener la direccin de entrega de la solicitud de compra usted debe utilizar la expresin: <PurchaseRequest.DeliveryAdress> Para obtener la fecha de entrega de la solicitud de compra usted debe utilizar la expresin: <PurchaseRequest.RequiredDeliveryDate> Para obtener la ciudad de entrega de la solicitud de compra usted debe utilizar la expresin: <PurchaseRequest.City.Name> Tambin es posible navegar por las colecciones mediante el nombre de la relacin. Este nombre es mostrado en la flecha que conecta las dos entidades en el diagrama y adems tienen un asterisco como marca (si no hay un asterisco entre las entidades, significa que las entidades solo tienen relacin

850

Copyright 2013 - Bizagi

entre atributos). Para obtener la coleccin de productos de la solicitud debe se debe utilizar la siguiente expresin: <PurchaseRequest.ProductsRequested> Para obtener el nombre de todos los productos de la solicitud de compras se debe utilizar la siguiente expresin: <PurchaseRequest.ProductsRequested.ProductName.Product>

Asignar y obtener valores con XPath

La forma sencilla de asignar un valor a un elemento es utilizando el operador =. <PurchaseRequest.DeliveryAdress> = "101 Bizagi Road" Esta expresin asigna la direccin al atributo direccin de entrega. <PurchaseRequest.RequiresApprovalForProduct> = true Esta expresin asigna el atributo booleano en verdadero. var date =<PurchaseRequest.RequiredDeliveryDate> La expresin almacena la fecha de entrega requerida en una variable. Tambin es posible asignar valores a colecciones. <PurchaseRequest.ProductsRequested.UnitPrice> = 1000 La expresin asigna a TODOS los productos de la solicitud un precio unitario de 1000. var quantity = <PurchaseRequest.ProductsRequested.Quantity> Esta expresin retorna una coleccin de una columna que contiene el nmero de cotizaciones

Copyright 2013 - Bizagi

851

solicitadas (cantidad) para cada producto relacionado con cada compra. La coleccin de variables guardar la cantidad de cada producto solicitado para cada compra.

Nota: Asegrese que el tipo de los atributos sean compatibles con los valores que van a ser almacenados. Por ejemplo, usted no puede asignar una cadena de texto (por ejemplo "101 Bizagi Road") a un atributo de tipo entero, o asignar el nmero 1000 a un atributo booleano. 3.5.1.1 Filtros usando XPath Las colecciones pueden ser filtradas para obtener un nmero menor de valores. Los filtros son una herramienta muy poderosa que restringen el nmero de elementos que se representan en una expresin XPath. Un filtro indica una o ms condiciones que deben ser cumplidas en la relacin uno a muchos (1-N). Los filtros son utilizados en expresiones para evaluar el registro de una coleccin. Estas condiciones se establecen dentro de corchetes luego del nombre que identifica la relacin 1:N.

<xpath[filter condition]>
El siguiente diagrama ser utilizado para mostrar cmo es la estructura de los filtros en un XPath. Imagine un proceso de solicitud de compras, cuyo modelo de datos es mostrado a continuacin. El proceso de Solicitud de compra tiene una entidad de proceso llamada Solicitud de Compra. La entidad del proceso tiene una relacin uno a muchos con la entidad Productos de la solicitud de compra. Para obtener de la coleccin aquellos productos solicitados que tienen un precio unitario mayor de 1000 utilice la siguiente expresin: <PurchaseRequest.ProductsRequestedforPurchase[UnitPrice > 1000]> Cada solicitud de compras tiene varias cotizaciones para seleccionar el mejor proveedor. Por esta razn se tiene una relacin uno a muchos llamada Cotizaciones entre las entidades Solicitud de Compra y Cotizaciones. Para obtener la cotizacin seleccionada utilice la siguiente expresin: <PurchaseRequest.Quotation[Selected = true]> Para obtener la direccin de correo electrnico del proveedor para cada cotizacin seleccionada utilice la siguiente expresin: <PurchaseRequest.Quotation[Selected = true].Supplier.Email> Cuando navega a travs de una coleccin, cmo en el ejemplo anterior, la expresin XPath puede retornar una coleccin o simplemente un nmero en funcin de los registros que cumplan con las condiciones del filtro. Por lo que, la expresin anterior, devolver una coleccin de correos electrnicos cuando se haya seleccionado ms de un proveedor. Usted puede crear un filtro con varias condiciones utilizando los operadores lgicos AND y OR.

852

Copyright 2013 - Bizagi

Para obtener los productos solicitados que estn relacionados en una cotizacin y adems la cotizacin es de ms de 1000 por unidad se debe incluir operador AND. <PurchaseRequest.ProductsRequestedforPurchase[QuotationsRequested = true AND UnitPrice > 1000]>

Usted puede utilizar los siguientes operadores dentro de un filtro.

Operado r = != >

Descripcin

Ejemplo

Igual No igual Mayor que

<PurchaseRequest.Quotation[Selected = true]> <PurchaseRequest.Quotation[Selected != true]> <PurchaseRequest.ProductsRequestedforPurchase[TotalPrice 1000]> <PurchaseRequest.ProductsRequestedforPurchase[UnitPrice 1000]> <PurchaseRequest.Quotation[QuotationDiscount >= true]> >

<

Menor que

<

>=

Mayor o igual que

Copyright 2013 - Bizagi

853

<= AND

Menor o igual que Y

<PurchaseRequest.Quotation[DiscountPercentaje <= 0,1]> <PurchaseRequest.Quotation[QuotationDiscount >= 1000 AND DiscountPercentaje <= 0.1]> <PurchaseRequest.Quotation[QuotationDiscount >= 1000 OR DiscountPercentaje <= 0.1]>

OR

Es verdadero defecto) ! Es falso

(por <PurchaseRequest.ProductsRequestedforPurchase [QuotationsRequested]> <PurchaseRequest.ProductsRequestedforPurchase [!QuotationsRequested]>

Asignar y obtener valores utilizando colecciones filtradas con XPath

La forma ms fcil de asignar un valor a una coleccin es utilizar el operador =. var quantity = <PurchaseRequest.ProductsRequested[QuotationRequested=true].Quantity> En la variable, se guarda a travs de la expresin XPath una coleccin que contiene la cantidad de cada cotizacin seleccionada por cada producto de la solicitud de compra. <PurchaseRequest.Quotation[QuotationDiscount >= true].Selected> = true Esta expresin asigna al atributo booleano seleccionado el valor de verdadero para todas las cotizaciones que tienen un descuento. 3.5.1.2 Filtros avanzados Cuando las colecciones tienen que ser filtradas utilizando variables es necesario utilizar las funciones setXPath y getXPath y no los corchetes de diamante <>. La siguiente es la sintaxis correcta para las expresiones XPath cuando se utilizan variables. Para obtener valores use esta sintaxis:

Me.getXPath("xpath[filter " + variable +"]") Me.setXPath("xpath[filter " +

Para asignar valores, utilice la siguiente sintaxis:

variable +"]", value)

Me.setXPath
Suponga que necesita calcular el porcentaje mnimo de descuento en el proceso de seleccin de cotizaciones. Solamente cotizaciones que ofrecen un descuento superior al 10% del costo total de la compra son seleccionadas.

854

Copyright 2013 - Bizagi

Se debe declarar una variable para guardar el clculo y luego filtrar la coleccin para seleccionar solo las cotizaciones que cumplen con la condicin. La expresin debe lucir de la siguiente forma: var MinimumPercentage = <PurchaseRequest.TotalCost>* 0.1 Me.setXPath("PurchaseRequest.Quotations[QuotationDiscount > "+ MinimumPercentage +" ] .Selected", true)

Me.getXPath
Seleccionar todos los proveedores que no tienen descuento o que es menor al 10%del costo total de la compra. Primero se debe declarar una variable para guardar el clculo y luego filtrar la coleccin para seleccionar solo las cotizaciones que cumplen con la condicin. La expresin debe lucir de la siguiente forma var MinimumPercentage = <PurchaseRequest.TotalCost>* 0.1 var BadSuppliers = Me.geXPath("PurchaseRequest.Quotation[Discount QuotationDiscount < "+ MinimumPercentage +"]") != true OR

Copyright 2013 - Bizagi

855

3.5.1.3

Funciones XPath XPath provee una serie de funciones que ayudan al rendimiento de clculos a travs de las colecciones en una forma fcil e intuitiva.

Funciones bsicas
FUNCIN And DESCRIPCIN SINTAXIS

Compara dos booleanos que pueden ser XPath o el <and(XPath,XPath)> resultado de una funcin XPath. La funcin devuelve verdadero si las dos condiciones son verdaderas, de lo contrario retorna falso. Obtiene el promedio de los elementos de la <avg(XPath)> coleccin. El atributo para realizar el clculo debe ser un numrico o moneda. Cuenta el nmero de elementos de una coleccin. <count(XPath)>

Avg

Count Empty

Regresa verdadero cuando una coleccin no tiene <empty(XPath)> elementos, falso de lo contrario. Compara dos argumentos XPath y regresa true si <equals(XPath,XPath)> son equivalentes. Los parmetros pueden ser expresiones XPath o funciones XPath. Retorna verdadero si la coleccin tiene al menos un <exists(XPath)> elemento, de lo contrario retorna falso. Compara dos argumentos XPath y retorna <greater-than(XPath,XPath)> verdadero si el primero es mayor que el segundo, retorna falso de lo contrario. Los parmetros pueden ser expresiones XPath o funciones XPath que retornen enteros, decimales, moneda o fechas.

Equals

Exist

Greater than

Greater than Compara dos argumentos XPath y retorna <greater-equals-than(XPath, or equals to verdadero si el primero es mayor o igual que el XPath)> segundo, retorna falso de lo contrario. Los parmetros pueden ser expresiones XPath o funciones XPath que retornen enteros, decimales, moneda o fechas. Is Empty Retorna verdadero si el atributo de tipo string es <is-empty(XPath)> nulo o esta vaco. Retorna falso de lo contrario. Evala una expresin XPath o el resultado de un <is-false(XPath)> funcin Xpath Retorna verdadero si el parmetro es falso, de lo contario retorna falso. Retorna verdadero si el atributo de tipo string esta <is-not-empty(XPath)> lleno. Retorna falso de lo contrario.

Is False

Is not Empty

856

Copyright 2013 - Bizagi

Is not Null

Retorna verdadero si algn atributo esta lleno (no <is-not-null(XPath)> es nulo), de lo contrario retorna falso. Retorna verdadero si un atributo es nulo (no lleno), <is-null(XPath)> de lo contrario retorna falso. Evala si el resultado de una expresin XPath o el <is-true(XPath)> resultado de una funcin Xpath. Regresa verdadero si el parmetro es verdadero, falso de lo contrario. Compara dos argumentos XPath y retorna <less-than(XPath,XPath)> verdadero si el primero es menor que el segundo, retorna falso de lo contrario. Los parmetros pueden ser expresiones XPath o funciones XPath que retornen enteros, decimales, moneda o fechas.

Is Null

Is True

Less than

Less than or Compara dos argumentos XPath y retorna <less-equals-than(XPath, equals to verdadero si el primero es menor o igual que el XPath)> segundo, retorna falso de lo contrario. Los parmetros pueden ser expresiones XPath o funciones XPath que retornen enteros, decimales, moneda o fechas. Like Compara dos parmetros y retorna verdadero si el <like(XPath,XPath)> segundo esta incluido dentro del primero. Los parmetros pueden ser XPath string o string. Cuando se utiliza un texto fijo utilice las comillas sencillas ('). Si alguno de los parmetros est vaco la funcin retornar Verdadero. Obtiene el valor mximo de una coleccin de <max(XPath)> elementos. El atributo deber ser numrico o moneda. Obtiene el valor mnimo de una coleccin de <min(XPath)> elementos. El atributo deber ser numrico o moneda. Compara dos argumentos XPath y regresa <not-equals(XPath,XPath)> verdadero si NO son equivalentes. Los parmetros pueden ser expresiones o funciones XPath. Compara dos booleanas que pueden ser una <or(XPath,XPath)> expresin XPath o el resultado de una funcin XPath. Regresa falso cuando ambos parmetros son falsos, verdadero de lo contrario. Suma el valor de un atributo de una coleccin. El <sum(XPath)> atributo debe ser numrico o moneda.

Max

Min

Not equals

Or

Sum

Copyright 2013 - Bizagi

857

Funciones Avanzadas
FUNCIN Add relation DESCRIPCIN SINTAXIS

Permite incluir nuevos registros dentro de la Me.addRelation("XPath") coleccin. Los registros se incluyen inicialmente como una entrada vaca. Usted puede utilizar El XPath debe ser una XPath o variables para asignar los valores del coleccin nuevo registro. Retorna una (no una coleccin) con valores no repetidos de un atributo especfico, de una coleccin. Es necesario indicar el atributo con el cul se encontrarn los valores no repetidos. La lista con los valores no repetidos sern entradas de este atributo. as <distinct-values(XPath)> El XPath debe ser una coleccin que navegue hasta un atributo por el que se pueda hacer un filtro de valores distintos.

Distinct-values

Get value collection

CHelper.GetValueAsCollecti Transforma una lista de valores almacenados en on(<XPath>) cadenas de texto en un arrayList. En algunos casos es necesario manejar las colecciones El XPath debe ser una utilizando expresiones y no a travs de la coleccin funcionalidad Iterate over XPath para permitir una completa manipulacin del cdigo. Permite borrar elementos de una coleccin. Es Me.removeRelation posible especificar si se quiere o no eliminar los ("XPath",remove registros de la base de datos en el Segundo database) parmetro.

Remove relation

from

Sort

Ordenar registros de una coleccin en orden <sort(XPath,'attribute')>; ascendente de acuerdo a un atributo. Solo es posible ordenar utilizando un entero, real, fecha El XPath debe ser una o un atributo string. El mtodo recibe una coleccin coleccin y regresa la coleccin ordenada de acuerdo a los valores del atributo.

3.5.1.3.1 Ejemplos de funciones bsicas de XPath

El modelo de datos del siguiente diagrama ser utilizado como gua para explicar las funciones bsicas XPath. Suponga que usted es un empleado del departamento de crdito de un Banco. Cada prstamo en el proceso de Solicitud de crdito tiene un cliente asociado, el cual puede solicitar uno o ms productos.

858

Copyright 2013 - Bizagi

And: Compara dos booleanos que pueden ser XPath o el resultado de una funcin XPath. La funcin devuelve verdadero si las dos condiciones son verdaderas, de lo contrario retorna falso. Ejemplo: La solicitud necesitar de una autorizacin si el cliente no es VIP y es viable. <Request.RequestAuthorization> = <and(is-false(Request.Client.VIP),is-true(Request.Client.Viable))>

Avg: Obtiene el promedio de los elementos de la coleccin. Solo se puede utilizar en colecciones que retornen valores de atributos numricos (todos los nmeros, decimales o moneda). Ejemplo: Obtener el promedio del valor de todos los productos. var average= <avg(Request.Products.ValueRequested)>;

Count : Cuenta el nmero de elementos de una coleccin. Ejemplo: Retornar el nmero de productos aprobados en la solicitud. var ProductNumber = <count(Request.Products[Approved= true])>;

Empty: Regresa verdadero cuando una coleccin no tiene elementos, falso de lo contrario.. Ejemplo: Validar si existe al menos un producto aprobado. if (<empty(Request.Products[Approved= true])>) { CHelper.ThrowValidationError("There are no approved products");

Copyright 2013 - Bizagi

859

Equals: Compara dos argumentos XPath y regresa true si son equivalentes. Los parmetros pueden ser expresiones XPath o funciones XPath. Ejemplo: La solicitud necesitar de una autorizacin si el cliente no es VIP y es viable. <Request.RequestAuthorization> = <and(equals(Request.Client.VIP, false),equals(Request.Client.Viable, true))>

Exist: Retorna verdadero si la coleccin tiene al menos un elemento, de lo contrario retorna falso.

Ejemplo: Revisar si algn producto falta por legalizar. if (<exists(Request.Products[LegalizationComplete = false])>) { CHelper.ThrowValidationError("There are products that have not been checked"); }

Greater than: Compara dos argumentos XPath y retorna verdadero si el primero es mayor que el segundo, retorna falso de lo contrario. Los parmetros pueden ser expresiones XPath o funciones XPath que retornen enteros, decimales, moneda o fechas. Ejemplo: Se debe realizar una validacin cuando los ingresos del cliente son menores al valor solicitado. if(<greater-than(Request.TotalValueRequested,Request.Client.Income)>) { CHelper.ThrowValidationError("The value requested exceeds the client's income") }

Greater than or equals to: Compara dos argumentos XPath y retorna verdadero si el primero es mayor o igual que el segundo, retorna falso de lo contrario. Los parmetros pueden ser expresiones XPath o funciones XPath que retornen enteros, decimales, moneda o fechas Ejemplo: Si el cliente es mayor de 65 aos se debe realizar una validacin para incluir un seguro adicional. if(<greater-equals-than(Request.Client.Age,65)>) { CHelper.ThrowValidationError("The client needs additional insurance due to the age") }

860

Copyright 2013 - Bizagi

Is Empty: Retorna verdadero si el atributo de tipo string es nulo o esta vaco. Retorna falso de lo contrario. Ejemplo: Si la solicitud necesita una autorizacin y la descripcin de la oferta no ha sido ingresada se debe mostrar un mensaje de validacin. if(<and(is-true(Request.RequestAuthorization), is-empty(Request.OfferDescription))>){ CHelper.ThrowValidationError("The request requires authorization and the description has not been entered"); }

Is False: Evala una expresin XPath o el resultado de un funcin Xpath Retorna verdadero si el parmetro es falso, de lo contario retorna falso. Ejemplo: Si el cliente no es viable, la solicitud no puede continuar. if(<is-false(Request.Client.Viable)>){ CHelper.ThrowValidationError("The client is not viable. You may not continue"); }

Is not Empty: Retorna verdadero si el atributo de tipo string esta lleno. Retorna falso de lo contrario. Ejemplo: Si la solicitud no necesita ser autorizada la descripcin de la oferta debe estar en blanco. if(<and(is-false(Request.RequestAuthorization), is-not-empty(Request.OfferDescription))>){ CHelper.ThrowValidationError("The description has to be left blank"); }

Is not Null: Retorna verdadero si algn atributo esta lleno (no es nulo), de lo contrario retorna falso. Ejemplo: Si la fecha de penalizacin para el cliente est en blanco, la solicitud necesita ser autorizada. if(<is-not-null(Request.DatePenalized)>){ <Request.RequestAuthorization>= true; }

Is Null: Retorna verdadero si un atributo es nulo (no lleno), de lo contrario retorna falso.

Copyright 2013 - Bizagi

861

Ejemplo: Si el atributo de penalizacin para el cliente est en blanco, la solicitud no necesita ser autorizada. if(<is-null(Request.Client.Penalized)>){ <Request.RequestAuthorization>= false; }

Is True: Evala si el resultado de una expresin XPath o el resultado de una funcin Xpath. Regresa verdadero si el parmetro es verdadero, falso de lo contrario. Ejemplo: La solicitud necesita ser autorizada si el cliente no es VIP o est reportado en alguna lista de negra crdito. <Request.RequestAuthorization> = <or(is-false(Request.Client.VIP),is-true (Request.Client.ReportedOnCreditBureau))>

Less than: Compara dos argumentos XPath y retorna verdadero si el primero es menor que el segundo, retorna falso de lo contrario. Los parmetros pueden ser expresiones XPath o funciones XPath que retornen enteros, decimales, moneda o fechas. Ejemplo: Se debe realizar una validacin cuando el ingreso del cliente es menor que el valor total aprobado de la solicitud. if(<less-than(Request.Client.Income, Request.TotalValueRequested)>) { CHelper.ThrowValidationError("The value requested exceeds the client's income") }

Less than or equals to: Compara dos argumentos XPath y retorna verdadero si el primero es menor o igual que el segundo, retorna falso de lo contrario. Los parmetros pueden ser expresiones XPath o funciones XPath que retornen enteros, decimales, moneda o fechas. Ejemplo: Si la fecha solicitada es menor o igual que la fecha de penalizacin, la solicitud no puede continuar. if(<less-equals-than(Request.DateRequested,Request.Client.DatePenalized)>) { CHelper.ThrowValidationError("The request cannot continue") }

Like: Compara dos parmetros y retorna verdadero si el segundo esta incluido dentro del primero.

862

Copyright 2013 - Bizagi

Los parmetros pueden ser XPath string o string. Cuando se utiliza un texto fijo utilice las comillas sencillas ('). Ejemplo: El nombre de la persona que viaja debe ser el mismo en el vuelo de ida y en el vuelo de regreso. <Request.SamePerson> = <like(Request.DepartingUserName,Request.ReturningUserName)>

Max: Obtiene el valor mximo de una coleccin de elementos. El atributo deber ser numrico o moneda. Ejemplo: Se necesita guardar en una variable el valor ms grande de los productos de la solicitud que han sido aprobados. var maxValue = <max(Request.Products[Approved= true].ValueRequested)>;

Min: Obtiene el valor mnimo de una coleccin de elementos. El atributo deber ser numrico o moneda. Ejemplo: Se necesita guardar en una variable el valor ms pequeo de los productos de la solicitud que han sido aprobados. var maxValue = <min(Request.Products[Approved= true].ValueApproved)>;

Not equals: Compara dos argumentos XPath y regresa verdadero si NO son equivalentes. Los parmetros pueden ser expresiones o funciones XPath. Ejemplo: La solicitud necesita ser aprobada si el cliente no es VIP o no es viable. <Request.RequestAuthorization> = <and(not-equals(Request.Client.VIP, true),equals (Request.Client.Viable,true))>

Or: Compara dos booleanas que pueden ser una expresin XPath o el resultado de una funcin XPath. Regresa falso cuando ambos parmetros son falsos, verdadero de lo contrario. Ejemplo: la solicitud debe ser autorizada si el cliente no es VIP o si ha sido reportado en alguna lista negra de crdito. Example: The request will need authorization if the client is Not VIP or has been reported to the Credit Bureau. <Request.RequestAuthorization> = <or(is-false(Request.Client.VIP),is-true (Request.Client.ReportedOnCreditBureau))>

Copyright 2013 - Bizagi

863

Sum: Suma el valor de un atributo de una coleccin. Solo se puede utilizar en colecciones que retornen valores de atributos numricos (todos los nmeros, decimales o moneda). Ejemplo: Guardar en una variable la suma de los valores de los productos que fueron aprobados en la solicitud. var Result= <sum(Request.Products[Approved= true].ValueRequested)>;

3.5.1.3.2 Ejemplos de funciones avanzadas de XPath

El modelo de datos del siguiente diagrama ser utilizado como gua para explicar las funciones avanzadas XPath. Imagine que trabaja en una compaa de telfonos y esta a cargo de la Mesa de ayuda para atender las quejas y reclamos que se presenten. Cada queja debe estar relacionada con un cliente. Para resolver cada caso, su equipo de trabajo debe contactar al cliente por telfono varias veces. Un Historial del proceso lleva todo el registro de las llamadas realizadas.

AddRelation: Permite incluir nuevos registros dentro de la coleccin. Los registros se incluyen inicialmente como una entrada vaca. Usted puede utilizar XPath o variables para asignar los valores del nuevo registro. Ejemplo: Cada comentario se debe registrar el la coleccin Historia. var User = Me.Case.WorkingCredential.UserId; CommentRecord=Me.addRelation("ClaimsAndComplaints.History") CommentRecord.setXPath("Actions",<ClaimsAndComplaints.Response>);

864

Copyright 2013 - Bizagi

CommentRecord.setXPath("PostedBy",User); CommentRecord.setXPath("Dates", DateTime.Now);

Distinct-values: Regresa una coleccin filtrada que no contiene valores repetidos de un atributo. Es necesario indicar el atributo por el cual se va a realizar la discriminacin. Ejemplo: Se necesita saber cuantos nmeros telefnicos han sido marcados para contactar al cliente. DiffPhone = <distinct-values(ClaimsAndComplaints.Calls.TelephoneNumber)>; <ClaimsAndComplaints.DiffPhoneNumbers> = DiffPhone.size();

Get value as collection: Transforma una lista de valores almacenados en cadenas de texto en un arrayList. En algunos casos es necesario manejar las colecciones utilizando expresiones y no a travs de la funcionalidad Iterate over XPath para permitir una completa manipulacin del cdigo. Ejemplo: Es necesario que todas las llamadas tengas observaciones. La funcin transforma la lista de llamadas en una cadena de texto dentro del ArrayList AllCalls. El siguiente ejemplo fue realizado para ilustrar la funcionalidad, esto tambin puede ser realizado utilizando un Iterate over XPath. var AllCalls = CHelper.GetValueAsCollection(<ClaimsAndComplaints.Calls>); for (var i = 0; i< AllCalls.size(); i++) { var CallRecord = AllCalls.get(i); if(BAIsNull(CallRecord.getXPath("Observations"))) CHelper.ThrowValidationError("The Call "+CallRecord.getXPath("TelephoneNumber")+" has not observations"); }

RemoveRelation: Permite borrar elementos de una coleccin. Es posible especificar si se quiere o no eliminar los registros de la base de datos en el Segundo parmetro. Ejemplo: Todas las llamadas que no han sido marcadas deben ser removidas. Me.removeRelation("ClaimsAndComplaints.Calls[Mark = false]",true);

Sort: Ordenar registros de una coleccin en orden ascendente de acuerdo a un atributo. Solo es posible ordenar utilizando un entero, real, fecha o un atributo string. El mtodo recibe una coleccin y regresa la coleccin ordenada de acuerdo a los valores del atributo.

Copyright 2013 - Bizagi

865

Ejemplo: Se quiere ordenar los registros de las llamas por fecha y guardarlos en una nueva variable. var CallsChecked=<sort(ClaimsAndComplaints.Calls[Mark = false],'DateAndTime')>;

3.5.2

Acceder a entidades no relacionas con el modelo de datos

Informacin General
Es muy comn tener que acceder a tablas paramtricas o del sistema que no estn relacionadas con el modelo de datos. Para utilizar su informacin en expresiones XPath. En esos casos, donde las entidades no se puedan acceder directamente a travs de navegacin Xpath se debe utilizar la funcin En tity M an ag er. La funcin retorna una coleccin de items. Tendr que iterar sobre la coleccin para acceder a informacin especfica. Nota Es muy importante entender que EntityManager solamente debe ser utilizado para tomar y trabajar con informacin que no esta relacionada con el caso y que no puede ser accedida directamente a travs de la navegacin XPath. Para utilizar la funcin En tity M an ag er tenga en cuenta la siguiente sintaxis .

CEntityManager.GetEntity("Entity").GetEntityList ("Attribute","Filter","Search","Order");
El primer parmetro de la funcin en obligatorio, el cual es el nombre de la entidad a la cual se va a acceder. Los dems parmetros son opcionales y se utilizan a discrecin del usuario. Attribute: El nombre del atributo (columna de la tabla) a filtrar (se utiliza con el parmetro Filter). Filter: El valor del atributo a ser filtrado (se utiliza con el parmetro Attribute). Order: Atributo utilizado para ordenar la bsqueda. Los siguientes son operadores que se pueden utilizar durante la bsqueda, OPERADOR = <> > >= NOMBRE Igual a Diferente Mayor que/ Mayor o igual que Menor que/ Menor o igual que Y EJEMPLO "Client =" +<Request.Client> "ClientName <>" +'John' "Balance >= 600"

<

<=

"Balance <= 600"

AND

"Minumum <= " + <Request.BorrowingCapacity> + " and Maximum >= " + <Request.BorrowingCapacity> "Minimum <= " + <Request.BorrowingCapacity> + " or Maximum >= 1000"

OR

866

Copyright 2013 - Bizagi

BETWEEN IN () IS NULL IS NOT NULL

Entre En Igual a nulo Diferente de nulo

"Balance BETWEEN 200 AND 500" "Balance in (500, 600, 700)" "CityName IS NULL" "CityName IS NOT NULL"

La function En tity M an ag er se encuentra en la categora Data n av ig atio n .

Com acceder a la informacin de la entidad?

Recordemos que la entidad es retornada como una coleccin de items. La coleccin de la entidad debe ser guardada dentro de una variable para poder recorrerla.

Copyright 2013 - Bizagi

867

Para identificar cuantos elementos tiene la coleccin se debe utilizar el comando Len g th . Recorra la coleccin utilizando un ciclo fo r de la siguiente manera:

//Get the identifier of the record

var Entity = CEntityManager.GetEntity("Entity").GetEntityList ("Attribute","Filter","",""); for(var i=0; i< Entity.Length;i++) {

//Get the attribute value of the record

var Surrogate= Entity[Counter].SurrogateKeyValue; var Value= Entity[Counter].Attributes["AttributeOfTheEntity"] .Value; }

Ejemplo sin filtros

El proceso de Ingreso de Personal requiere que el solicitante se realice algunos exmenes mdicos antes de firmar el contrato. Los nombres de los exmenes son guardados en una entidad paramtrica y posteriormente cargados a una coleccin cuando lo requiera el proceso. El siguiente es el Modelo de Datos del proceso de Ingreso de Personal.

La siguiente imagen muestra la lista de exmenes mdicos que deben ser cargados dentro de la coleccin.

1. En el paso cuatro del Asistente, agregue una expresin al entrar de la tarea donde se cargan los exmenes.

868

Copyright 2013 - Bizagi

2. Escriba el cdigo de la regla de negocio para incluir los exmenes dentro de la coleccin. Seleccione la funcin Get en tity w ith En tity M an ag er del Data N av ig atio n en la categora Acceso a entidades paramtricas.

//Evaluate if the collection has items if(<count(Request.Applicant.ApplicantTests)> == 0) { //Use the EntityManager function to get all the Tests that will be added to the collection Test = CEntityManager.GetEntity("MedicalTest").GetEntityList ("","","",""); //Iterate the variable in which the Tests are stored for(var Counter=0; Counter < Test.Length; Counter++) { //Add each Test to the collection Test = Me.addRelation("Request.Applicant.ApplicantTests"); Test.setXPath("MedicalTest",Test[Counter].SurrogateKeyValue); } }

Ejemplo con filtro sencillo

Vamos a continuar utilizando el Proceso de Ingreso de Personal, donde un nuevo empleado debe practicarse algunos exmenes mdicos antes de firmar el contrato. Los nombres de los exmenes son guardados en una entidad paramtrica y posteriormente cargados a una coleccin cuando lo requiera el proceso. Solamente los exmenes obligatorios deben ser incluidos dentro de la coleccin y el atributo Requerido debe ser marcado como verdadero. El siguiente es el Modelo de Datos del proceso de Ingreso de Personal.

Copyright 2013 - Bizagi

869

La siguiente imagen muestra la lista de exmenes mdicos que deben ser cargados dentro de la coleccin, aquellos marcados como requeridos.

1. En el paso cuatro del Asistente cree una accin al Entrar de la actividad donde se cargan los exmenes. 2. Escriba el cdigo de la regla de negocio para incluir los exmenes dentro de la coleccin. Seleccione la funcin Get en tity w ith En tity M an ag er del Data N av ig atio n en la categora Acceso a entidades paramtricas.

870

Copyright 2013 - Bizagi

//Evaluate if the collection has items. if(<count(Request.Applicant.ApplicantTests)> == 0) { //Use the EntityManager function to get all the Tests to be added to the collection. Filter the records by the required status . Tests = CEntityManager.GetEntity("MedicalTest").GetEntityList ("Required",true,"",""); //Iterate the variable in which the Tests are stored. for(Counter=0; Counter < Tests.Length; Counter++) { //Add each Test to the collection. Test = Me.addRelation("idRequest.idApplicant.ApplicantTests"); Test.setXPath("MedicalTest",Tests[Counter].SurrogateKeyValue); Test.setXPath("Required",Tests[Counter].Attributes["Required"] .Value); } }

Ejemplo con un filtro complejo

Un banco solicita ciertos documentos durante el estudio de un crdito, de acuerdo a los ingresos del solicitante y su trabajo. Los documentos que aplican para cada caso se guardan en una entidad llamada Documentos para el solicitantes. En cada caso, una regla debe analizar las propiedades del solicitante e incluir dentro de la coleccin los documentos que apliquen. La entidad Documentos para el solicitante no hace parte del modelo de datos del proceso. Por lo que es necesario utilizar la funcin EntityManager para acceder a la informacin de la tabla y agregas los registros dentro de una entidad del Modelo de Datos. A continuacin se encuentra el Modelo de Datos para el caso.

Copyright 2013 - Bizagi

871

La siguiente es la entidad paramtrica que contiene la informacin a ser cargada.

872

Copyright 2013 - Bizagi

1. En el paso cuatro del Asistente cree una accin al Entrar de la actividad donde se cargan los exmenes. 2. Escriba el cdigo de la regla de negocio para incluir los exmenes dentro de la coleccin. Seleccione la funcin Get en tity w ith En tity M an ag er del Data N av ig atio n en la categora Acceso a entidades paramtricas.

Copyright 2013 - Bizagi

873

//Create a filter to identify the role and the income source of the Applicant FilterDocs = "ApplicantRole = " + <Applicant.ApplicantRole.id> + " and IncomeSource = " + <Applicant.IncomeSource.id>; //Use the EntityManager function to get all the Documents to be added to the collection. Filter by the required status. DocsXApplicant = CEntityManager.GetEntity("DocumentXApplicant") .GetEntityList("","",FilterDocs,""); //Iterate the variable in which the Documents are stored. for(Count =0; Count < DocsXApplicant.Length; Count++) { //Add each Document to the collection IdDocument = DocsXApplicant[Count].Attributes["Document"].Value; AppicantDocument = Me.addRelation("Applicant.Documents"); AppicantDocument.setXPath("Document",IdDocument); AppicantDocument.setXPath("Required",DocsXApplicant[Count].Attributes ["Required"].Value); }

3.5.3

Donde utilizar reglas de negocio

Bizagi ofrece Reglas de Negocio que pueden ser utilizadas en diferentes lugares del proceso para definir condiciones, validaciones, efectuar clculos, entre otras cosas. Los siguientes puntos ilustran mejor el uso de las expresiones: Ejecutar acciones como asignar, calcular o validar en las Actividades : Es muy comn ejecutar validaciones para controlar los valores ingresados por los usuarios en los campos. Bizagi tambin permite realizar clculos para manejar el modelo de daos y asignar o borrar valores de cualquier atributo. Dirigir el proceso Ruta de secuencia: Las reglas de negocio son implementadas como condiciones de transicin dentro del proceso para definir el flujo de secuencia de este. Las expresiones utilizadas para esto, siempre retornar el valor de verdadero o falso (Booleano) para

874

Copyright 2013 - Bizagi

decirle al proceso por donde se debe seguir. Administrar la interfaz de usuario: Es muy importante poder controlar que campos se muestran o se ocultan en el Portal de Trabajo para los usuarios finales, tambin cmo controlar los campos que son obligatorios o que son editables o de solo lectura. Las reglas de negocio tambin se aplican para realizar filtros en los campos, relacionar expresiones con botones y hacer validaciones sobre tablas. Asignacin de usuarios: Las reglas de negocio se pueden utilizar para control que usuario debe ser responsable de realizar una tarea de acuerdo a las condiciones del negocio. 3.5.3.1 Asignaciones, clculos y validaciones

Informacin general
Es posible realizar clculos y validaciones en cada actividad del proceso con la opcin de A ccio n es d e la A ctiv id ad la cual se encuentra en el cuarto pas del Asistente de Procesos (Reglas de negocio). Estas actividades pueden ser ejecutadas cuando el caso entre a la actividad, cuando el usuario final de clic en el botn guardar o cuando el caso sale de la actividad. Las acciones pueden ser creadas en los siguientes momentos: Al entrar: Solo una vez, tan pronto como la actividad es creada. Al salvar: Cada vez que el usuario final de clic en el botn guardar, o cuando se refresca la tarea. (Aplica para tareas donde un usuario final interacta con el proceso: Tareas y eventos intermedios. Al salir: Solo una vez, tan pronto como la actividad finaliza. Acciones relacionadas con Reglas de Negocio se conocen como Ex p resio n es.

Lo que necesita hacer en Bizagi

Copyright 2013 - Bizagi

875

Tan pronto como la opcin Acciones es seleccionada, se muestra el Flujo del Proceso. Las tareas que tengan acciones tendrn una marca especial, dependiendo del tipo de accin que ha sido asociada a ella. De clic sobre cualquier tarea para incluir una Accin.

876

Copyright 2013 - Bizagi

Crear Acciones (Reglas de Negocio)

Ejemplo 1
Imagine que tiene un Proceso de Solicitud de Compras. Lo primero que necesita hacer es asignar la fecha y el solicitante de la compra. Esto puede ser realizado a travs de una Accin. Se tienen dos atributos creados cuyos XPath son: <PurchaseRequest.RequestDate> y <PurchaseRequest.RequestedBy> 1. Para configurar la regla de negocio que incluye la informacin a estos atributos vaya al paso cuatro del Asistente y seleccione Acciones de la Actividad. Cuando se abra el flujo del proceso de clic sobre la primera actividad de este. En la ventana Acciones de la Actividad, seleccione la opcin Al entrar y de clic en el signo ms. Una nueva ventana se abre, donde se puede seleccin entre acciones Al Entrar, Al Salvar o Al Salir. Vamos a incluir una Expresin.

Copyright 2013 - Bizagi

877

2. Se abrir el administrado de expresiones. De clic en Nuevo para crear una expresin o seleccione una y de clic en Editar para editarla.

Al dar clc en Nuevo La ventana de la Expresin se debe abrir. Asigne un nombre, un nombre visual y una descripcin a la expresin. Le recomendamos que sea muy claro en el nombre visual y en la descripcin. Esto es muy til, especialmente cuando su proyecto crece ya que el nmero de expresiones tambin lo hace.

878

Copyright 2013 - Bizagi

3. Clic derecho sobre la flecha negra para incluir una expresin. Las expresiones son el elemento ms completo, ya que proveen el mximo de flexibilidad. De al elemento un nombre y de clic en Ok. Tenga en cuenta que reglas complejas podran incluir varias expresiones, por lo que nombre dado a cada una de ellas le ayudar a recordad que hace cada una de ellas.

4. De doble clic sobre la nueva expresin para abrirla. Vamos a asignarle a los dos atributos mencionados anteriormente sus valores iniciales. Cada atributo de selecciona desde el modelo de datos (UNO A UNO). Clic en la opcin de Modelo de Datos en la esquina superior izquierda. Esto mostrar el Modelo de

Copyright 2013 - Bizagi

879

Datos de su proceso para poder construir los XPaths que necesite. Para agregar un atributo de clic sobre este y luego en Ok.

5. Para asignar la fecha de hoy en el atributo RequestDate utilizaremos una funcin de nuestra lista de Funciones. Clic en el men Funciones, luego seleccione la categora F ech as y Tiem p o y seleccione la funcin To d ay .

880

Copyright 2013 - Bizagi

6. Para el atributo RequestedBy vamos a utilizar la funcin User Id, la cual se encuentra en la categora In fo rm aci n d el u su ario actu al.

7. Clic en Ok para guardar el elemento Expresin, y de nuevo, clic en ok, para guarda toda la

Copyright 2013 - Bizagi

881

expresin. Cuando se crea un nuevo caso, la informacin de los dos atributos ser incluida de forma automtica con los valores del caso.

Ejemplo 2
En el mismo ejemplo del Proceso de Solicitud de Compras. Luego de crear la solicitud, el Jefe de aprobarla. Por lo que es necesario, al final de la actividad, crear un registro en la tabla que tiene las observaciones del Jefe. La tabla debe incluir la fecha, el usuario que da el veredicto, la decisin (si se aprueba o se rechaza) y las observaciones. Tenemos una coleccin que almacena la informacin de la aprobacin cuyo XPath es: <PurchaseRequest.PurchaseApproval> 1. Para configurar la regla de negocio que incluye la informacin sobre la aprobacin se debe crear una expresin en el cuarto paso de Asistente, en la opcin Acciones de la Actividad. Clic derecho sobre la segunda actividad del proceso. En la ventana de Acciones de la actividad seleccione Al Salir y de clic en el signo ms para incluir una expresin.

2. Asigne un nombre, un nombre visual y una descripcin a la expresin. Clic derecho sobre la flecha negra para incluir una expresin. De al elemento un nombre y luego doble clic sobre l para abrir la ventana de la expresin.

882

Copyright 2013 - Bizagi

3. Es necesario declarar una variable para manipular la adicin de nuevos registros a una coleccin. De clic en el botn Variables y seleccione Nuevo. En la nueva ventana de clic en el signo ms y cree una nueva variable de tipo objeto. Recuerde siempre inicializar sus variables, en este caso asigne el valor null.

4. Para utilizar la variable creada, de clic en el botn Variables y luego clic en la variable. Esta ser incluida dentro de la expresin de forma automtica donde este parado el cursor.

Copyright 2013 - Bizagi

883

5. Para asignar un nuevo registro a la coleccin vamos a utilizar una funcin de la lista de Funciones. Clic en el men Funciones y seleccione la categora Navegacin de datos, luego seleccione la funcin Add record.

884

Copyright 2013 - Bizagi

6. Esto incluir la expresin de la funcin. Sin embargo se debe remplazar el XPath que trae por defecto con el XPath de la coleccin. Para hacer esto, de clic en el botn del Modelo de datos y seleccione el XPath de la coleccin.

Copyright 2013 - Bizagi

885

7. Elimine los corchetes de diamante <>. Cambie la expresin: NewApproval = Me.addRelation("<PurchaseRequest.PurchaseApproval>") por NewApproval = Me.addRelation("PurchaseRequest.PurchaseApproval") 8. Utilizando el botn Funciones incluya la funcin M e.setXP ath , la podr encontrar en la categora Navegacin de datos. Ya que hemos agregado cuatro XPath, Como vamos a configurar cuatro Xpath, es necesario incluir cuatro funciones. Remplace en cada una de las frases, el XPath por el atributo de la coleccin donde se incluir el valor, y el value to set por el valor que tendr el atributo. Para remplazar el XPath, abra el Modelo de datos y navegue por el hasta encontrar el atributo deseado. Cpielo y pguelo en la expresin.

886

Copyright 2013 - Bizagi

El valor puede ser tomado desde el Modelo de Datos. La fecha ser tomada del men de funciones. Seleccione la categora Fechas y Tiempos y seleccione la funcin To d ay. El campo ap p ro v al User ser tomado del men de funciones. Seleccione la categora Informacin del Usuario Actual y luego la funcin User Id. El campo approved state ser tomado del modelo de datos, el cual es el estado seleccionado por el Jefe. Las observaciones sern tomadas del modelo de datos, las cuales fueron incluidas por el Jefe.

Copyright 2013 - Bizagi

887

9. Clic en Ok para guardar el elemento Expresin, y de nuevo, clic en ok, para guarda toda la expresin. Cuando el caso salga de la tarea Aprobar, un nuevo registro ser incluido dentro de la coleccin Aprobaciones.

Relacionar una Accin a un sub proceso

Para incluir una accin a la figura sub proceso mantenga sostenida la tecla y luego de clic en la figura. Esto abrir una ventana con las acciones de la figura. Si usted da clic sobre a figura del sub sin tener oprimida la tecla shift, el flujo del sub proceso ser mostrado.

888

Copyright 2013 - Bizagi

3.5.3.2

Ruta del proceso

Informacin general
Cuando se modela un proceso es necesario incluir Reglas de Negocio que ayudarn a determinar la ruta que debe seguir el flujo del proceso cuando se llega a una compuerta divergente que requiere una expresin, aplica para compuertas exclusivas e inclusivas. Cuando estas formas tienen ms flujos de secuencia de salida que de entradas se consideran como un elemento divergente. Cada uno de los flujos de salida debe tener una regla de negocio asociado una regla de negocio la cual ser evaluada por Bizagi para determinar cual es el camino a seguir.

Compuerta Exclusiva : Cuando se utiliza una compuerta Exclusivo solamente UNA de las reglas de negocio debe ser valida (verdadera). Solamente un camino debe ser seguido

Compuerta Inclusiva: Cuando se utiliza una compuerta Inclusiva uno o ms caminos pueden ser validos, por lo que el proceso continuar por ellos. Las reglas de negocio asociadas a los flujos de secuencia se conocen como expresiones Booleanas ya

Copyright 2013 - Bizagi

889

que siempre retornar Verdadero o Falso

Qu se debe hacer en Bizagi?

En el cuarto paso del Asistente seleccione la opcin Defin ir Ex p resio n es.

El flujo del proceso ser mostrado resaltando los flujos de secuencia que necesitan la definicin de una regla de negocio. Cuando un flujo de secuencia tiene configurado una regla de negocio, este ser mostrado en color negro. Cuando un flujo de secuencia no tiene configurado una regla de negocio, este ser resaltado en color amarillo.

890

Copyright 2013 - Bizagi

Clic en cualquier flujo de secuencia para asociar una regla de negocio.

Crear reglas de negocio para flujos de secuencia

Ejemplo 1: Asignar una condicin
En el proceso de Solicitud de Compras un usuario crea una solicitud. Luego es necesario que el jefe inmediato evalu la solicitud. Dependiendo de la decisin, el proceso puede continuar por diferentes caminos: Si la solicitud se aprueba, el proceso enva un correo y contina con el Sub proceso Cotizaciones. Si la solicitud es rechazada, se enva un correo informando el rechazo y termina el proceso. Si la solicitud requiere cambios, se enva un correo al solicitante y el proceso regresa a la primera actividad. Note que el Proceso solo puede tomar uno de los caminos, razn por la cual se esta usando una compuerta Exclusiva. El jefe inmediato debe tomar una decisin respecto a la solicitud, en su interfaz de usuario se mostrar una lista desplegable para que escoja la accin a seguir. Por lo cual existe una relacin entre la entidad del Proceso So licitu d d e Co m p ra y la entidad paramtrica Estad o d e la So licitu d.

Copyright 2013 - Bizagi

891

Clic en el flujo de secuencia de Rechazo. Una nueva ventana ser mostrada para incluir la ex p resi n B o o lean a. En el lado izquierdo de la ventana se encuentra el Modelo de Datos. Al lado derecho esta el espacio para crear la condicin que se evaluar. Arrastre y suelte del modelo de datos el atributo a evaluar. El XPath se crear automticamente, en este caso: PurchaseRequest.RequestState. Luego seleccione la condicin de la evaluacin desde la lista desplegable. Cuando se utilizan condiciones que evala contra una entidad paramtrica, como en este caso, la lista de posibles valores se mostrar automticamente para que el usuario seleccione el valor deseado. Finalmente seleccione el ltimo elemento a evaluar en la condicin. Clic en Finalizar para guardar la regla de negocio.

892

Copyright 2013 - Bizagi

Defina las dems reglas de negocio siguiendo el procedimiento anterior. IMPORTANTE: El importante asegurarse al utilizar un compuerta Exclusiva que al menos una condicin regrese Verdadero, si no, un mensaje de error ser mostrado al usuario final indicando que no hay una tarea con cual continuar. LE RECOMENDAMOS DEFINIR UN FLUJO DE SECUENCIA COMO SI NO (ELSE) En este caso, la condicin Si no es definida en el flujo de Aprobado. Clic sobre el flujo de secuencia, luego, cuando se muestre la ventana para incluir la expresin Booleana de clic en Cancelar.

Copyright 2013 - Bizagi

893

Una nueva ventana es mostrada. Seleccione la condicin Is Else y luego de clic en O k.

Ejemplo 2: Definir mltiples condiciones

894

Copyright 2013 - Bizagi

Suponga que el ejemplo anterior la decisin que define si el proceso contina por cierto camino tiene dos condiciones: el jefe inmediato rechaza la solicitud O solicita cambios. En este caso, es necesario incluir una segunda condicin y especificar que cualquiera de las dos opciones en valida, es decir es una operacin OR. El usuario puede incluir tantas condiciones como necesite dando clic en el botn Nueva Condicin al final de la ventada. Es muy importante que en la parte superior de la ventana, la opcin A lg u n a d e las sig u ien tes co n d icio n es este seleccionada para poder incluir el operador OR entre los argumentos. Por defecto el operador AND (Todas las siguientes condiciones) esta seleccionada.

Ejemplo 3: Definir la condicin siempre.

En el proceso de Solicitud de Viajes, un usuario crea una solicitud. Cuando la solicitud ha sido aprobada por el Jefe, el proceso pude continuar por algunos de los caminos disponibles dependiendo de las necesidades del solicitante. Siempre se debe realizar una reserva de Hotel y de vuelo. De ser necesario, se debe ejecutar las actividades relacionadas con el manejo y pago del desembolso de viajes.

Copyright 2013 - Bizagi

895

Ya que el proceso puede continuar por uno o dos caminos, vamos a utilizar una compuerta Inclusiva. La primera condicin ser definida con el valor por defecto, ya que siempre debe retornar Verdadero. La segunda condicin evaluar si el XPath TravelRequest.AdvanceRequired es verdadero. Esto indica que el solicitante solicit una Adelanto.

896

Copyright 2013 - Bizagi

Ejemplo 4: Definir condiciones utilizando colecciones

Cuando una expresin Booleana necesita evaluar una condicin utilizando una coleccin (una relacin uno a muchos) es necesario utilizar la opcin de XPath personalizado. Esta opcin se encuentra en la parte inferior de la caja del Modelo de Datos. Considere el Proceso de Solicitud de Crdito. Un solicitante puede pedir varios productos, por ejemplo, tarjetas de crdito, crdito de libre consumo, una cuenta de ahorros, etc. Algunos de estos productos necesitan garantas para respaldar la deuda (por ejemplo en crditos de libre consumo) y otros no. Cuando la solicitud ha sido aprobada por el departamento de Riesgos, los productos pueden ser entregados (o desembolsados) al cliente. Existen algunos productos que requieren de bienes como garanta, estas garantas deben ser registradas antes de la entrega de los productos. Los productos que no necesitan garantas o que las garantas no necesitan ser registradas continan con el sub proceso Garantas, los dems siguen directamente a la Entrega. Una compuerta inclusiva evala cuales productos van directamente a Entrega (no se necita garantas o

Copyright 2013 - Bizagi

897

no se deben registrar las garantas) y cuales productos deben registrar la garanta antes de continuar con el sub proceso. En este caso, la compuerta tiene tres flujos de salida: Uno para los productos que tienen garantas que necesitan registrarse, este camino conduce al sub proceso Garantas. Otro por los productos que van directamente a Entrega y un ltimo con la condicin Is Else, en este caso la evaluacin no puede definir a donde debe ir el producto.

La regla de negocio que vamos a construir contar el nmero de productos que necesitan registro de las garantas en el sub proceso Garantas. Si existe al menos un producto que cumpla la condicin, la regla debe retornar Verdadero, de lo contrario retornar falso. Seleccione el flujo de secuencia, y luego en la ventana la opcin XP ath . De clic en el botn Adicionar XP ath p erso n alizad o .

898

Copyright 2013 - Bizagi

Seleccione la coleccin a evaluar. En este caso vamos a seleccionar la funcin XPath contar la cual retorna el nmero de productos que necesitan una garanta registrada. Tan pronto como una coleccin es seleccionada se habilitarn las funciones XPath, estas se encuentran en la esquina superior derecha de la ventana.

Es necesario incluir un filtro para poder seleccionar solo aquellos productos que requieres pasar por el sub proceso, es decir, aquellos donde las garantas deben ser registradas. Para incluir un filtro, clic en el botn A d icio n ar co n d ici n d e filtro . Esto crear una nueva lnea para

Copyright 2013 - Bizagi

899

incluir la condicin del filtro. En la primera columna seleccione un atributo del Modelo de Datos. Luego seleccione el valor de la condicin (Ig u al o Es d iferen te q u e). Finalmente seleccione un argumento. En este caso, el argumento es de tipo Booleano por lo que el valor ser Verd ad ero .

Cuando termine de construir la condicin de clic en A sig n ar F iltro . Es posible incluir tantas condiciones como sea necesario. Luego indique si todas las condiciones deben ser cumplidas o si solo es necesario el cumplimiento de algunas de las condiciones. Para esto, seleccione los condicionales Y O, est opcin se encuentra al lado de la lista desplegable de las funciones XPath. Cuando termine, verifique que el XPath este construido correctamente, la sentencia completa se muestra en la parte inferior de la ventana, luego clic en O K.

900

Copyright 2013 - Bizagi

Arrastre y suelte el XPath personalizado que acaba de construir. Complete la condicin y los argumentos. En este caso vamos a incluir: es mayor que, y el valor 0. Clic en F in alizar.

3.5.3.2.1 Script booleano

Informacin General

Copyright 2013 - Bizagi

901

Expresiones booleanas son expresiones condicionales que retornan un valor booleano cuando se evalan, es decir o falso o verdadero. Estas expresiones evalan condiciones simples para determinar el comportamiento o la decisin que se debe tomar dependiendo del resultado. Algunas de las condiciones que se evalan son complejas por lo que no se pueden construir solo utilizando la funcionalidad de arrastrar y soltar de la interfaz de Reglas de Negocio. En estos casos es necesario utilizar un Scrip t B o o lean o . Como las expresiones Scrip t B o o lean as son expresiones booleanas , estas pueden ser utilizadas en: Expresiones asociadas con flujos de secuencia (Condiciones de transicin). Expresiones utilizadas como condiciones para atributos (campos en las formas) para que sean visibles, editables o requeridos. Expresiones utilizadas para determinar la condicin de asignacin en una actividad. Como expresiones booleanas, las expresiones Scrip t B o o lean as se construyen utilizando la interfaz de Reglas de negocio pero con acceso a funcionalidades adicionales.

IMPORTANTE: Tenga en cuenta que debido a que las Scrip t B o o lean as aceptan cualquier configuracin podra darse el caso en que no se retorne ni verdadero ni falso. Esto NUNCA debe pasar, las expresiones Scrip t B o o lean as SIEMPRE deber retornar el valor verdadero o falso.

902

Copyright 2013 - Bizagi

Ejemplo
Suponga que en el proceso de Solicitud de Tarjeta de Crdito, un analista ingresa la informacin de una solicitud realizada por un cliente y verifica los documentos y referencias de este. El sistema automticamente define si la tarjeta se aprueba o no en base en los ingresos mensuales y en la veracidad de los documentos entregados. La compaa que ofrece la tarjeta de crdito tiene definidos que los productos sern aprobados en dos situaciones: Si el cliente tiene 25 aos o menos, los ingresos mensuales de sus padres o tutor legal deben ser mayores de $3000. Si el cliente es mayor de 25 aos, sus ingresos deben ser superiores a $2000. Adicionalmente a estas condiciones, todos los documentos entregados y las referencias dadas deben ser verificados. Para qu el sistema de forma automtica determine si la tarjeta de crdito ha sido aprobada vamos a utilizar una compuerta divergente. Si la condicin de aprobacin se cumple, la compuerta guiar el proceso por el flujo de entregar Tarjeta de Crdito, de los contrario se enviar un correo notificando el rechazo de la solicitud.

Para configurar la condicin de divergencia, siga los siguientes pasos: 1. En el cuarto paso del Asistente, clic en Defin ir Ex p resio n es.

Copyright 2013 - Bizagi

903

2. Seleccione el camino donde se debe evaluar la regla.

3. En la ventana de Expresin Booleana de clic en Can celar.

904

Copyright 2013 - Bizagi

4. Se muestra una lista con las expresiones por defecto y las expresiones reusables creadas anteriormente. Seleccione el campo A v an zad o de la esquina inferior izquierda y de clic en N u ev a Scrip tin g .

5. La ventana de expresin se abrir. Incluya un nuevo modulo de expresin dando clic derecho sobre la flecha negra, luego seleccione la opcin Adicionar Expresin.

Copyright 2013 - Bizagi

905

6. Escriba el cdigo que define la condicin. Asegrese que cada sentencia retorne verdadero o falso escribiendo de forma explicita la palabra true para verdadero y false para falso seguido de un punto y coma.

906

Copyright 2013 - Bizagi

//Set false as default false; //Evaluate first condition if ((<Request.CustomerAge> <= 25) && (<Requester.ParentsIncome>>3000)) { //If fulfilled returns true true; } if ((<Request.CustomerAge> > 25) && (<Requester.Income>>2000)) { //If fulfilled returns true true; } La expresin anterior asegura que el valor falso es retornado por defecto, es decir, si ninguna de las condiciones se cumple. Luego cada condicin es evaluada dependiendo de las polticas financieras de la compaa. Si alguna de estas condiciones se cumple, la expresin devuelve verdadero.

7. Incluir las condiciones para seleccionar una ruta alternativa. Clic en la ruta alternativa.

Copyright 2013 - Bizagi

907

En la ventana de expresin booleana de clic en Can celar.

Se muestrar una lista con las expresiones por defecto y las expresiones reusables creadas anteriormente. Seleccione la expresin Si no (Is else). La expresin Si no permitir habilitar el camino alternativo cuando la condicin del camino principal retorne falso.

908

Copyright 2013 - Bizagi

Para terminar de clic en O k. 3.5.3.3 Manejo de la interfaz de usuario

Informacin general
Bizagi le permite manejar la informacin que se muestra en las formas y realizar validaciones sobre los controles para asegurarse de que stos se comportan como su compaa requiere: que la informacin que se ingrese sea correcta y completa. En algunos casos estas validaciones y el comportamiento de los controles son bsicos y no necesitan de lgica compleja para ser evaluados. Usted puede simplemente configurar un control como requerido, editable o visibile en las Propiedades Bsicas de los Controles. Cuando necesite validaciones dinmicas y comportamientos que dependan de la informacin del caso, es necesario crear una expresin para configurarlas. Estas expresiones pueden ser tan complejas como se necesite y as poder reflejar hasta las situaciones ms complicadas.

Qu puede configrar usando expresiones

Visible: Este comportamiento define si el control se muestra o se oculta. Editable: Este comportamiento define si el valor del control es de slo lectura o se puede cambiar. Requerido: Este comportamiento define si el control es obligatorio. Si lo es y no se ingresa un valor se lanzar una validacin. Por defecto las expresiones de las tres propiedades anteriores son expresiones booleanas. De acuerdo a la definicin ingresada retornar verdadero o falso. Si la condicin retorna verdadero, el control ser visible, editable o requerido de consecuentemente. Si retorna falso, no lo ser. Si necesita una expresin compleja en alguna de estas propiedades por favor refirase a Script booleano. Asegrese de que sus expresiones SIEMPRE retornen verdadero o falso. Valor por defecto: Asigna un valor por defecto sin que el usuario final tenga que seleccionarlo, tan pronto como se carga la forma por primera vez en el Portal de Trabajo. Esta propiedad aplica a los

Copyright 2013 - Bizagi

909

siguinetes controles: Combo, Fecha, Lista, Moneda, Nmero, Radio, Cuadro de texto, Si/No. Valor mnimo: Define y valida un valor mnimo que puede ingresarse en el control Esta propiedad aplica para los controles: Fecha, Moneda, Nmero. Valor mximo: Define y valida un valor mximo que puede ingresarse en el control Esta propiedad aplica para los controles: Fecha, Moneda, Nmero. Valor por defecto, mnimo y mximo pueden ser configuradas usando expresiones o valores constantes.
3.5.3.3.1 Visible, editable, requerido usando expresions

Los siguientes son ejemplos de cmo configurar si un control es visible, editable o requerido usando expresiones. Suponga que una empresa de Transporte y Logstica tiene un proceso llamado Proceso de Envo para manejar y monitorear los envos internacionales. La primera tarea de este proceso permite al cliente ingresar la informacin y estimar el costo del cargamento. La compaa cubre envos desde y hacia Brasil, Irlanda y Estados Unidos. Tambin tiene tres medios de transporte: aire, mar y tierra. Si es transporte elegido es aire, se debe ofrecer servido express para que el paquete sea entregado el mismo da que se enva. La forma usada para obtener esta informacin es:

910

Copyright 2013 - Bizagi

Si el pas destino es Brasil o Estados Unidos el Cdigo ZIP debe ser editable y requerido. De lo contrario no aplica. La compaia ofrece servico express slo para transporte areo. Esta opcin debe mostrarse cuando ese medio es elegido.

Configurar editabilidad
El Cdigo ZIP no aplica para pases fuera de Brasil y Estadios Unidos. Por lo tanto se debe evaluar si es o no editable tan pronto se elige un pas. Crearemos una expresin en la propiedad Ed itab le: 1. En la forma d clic sobre el control Z ip Co d e. Sus propiedades se desplegarn en el Panel izquierdo.

Copyright 2013 - Bizagi

911

2. En la pestaa de Propiedades Bsicas encontrar la propiedad Ed itab le. De clic en el combo para mostrar las opciones disponibles.

3. Seleccione la ltima opcin: Ex p resi n . Una nueva ventana se desplegar. Para crear una nueva expresin de clic en N u ev o .

912

Copyright 2013 - Bizagi

El editor de expresiones booleanas se desplegar.

4. Configure las condiciones. En este caso nuestra condicin se relaciona con el atributo de pas destino..

Copyright 2013 - Bizagi

913

Recuerde que una expresin booleana siempre retorna Verdadero o Falso. En este caso retornar verdadero si el pas es Brasil o Estados Unidos. En este caso el control ser editable. De lo contrario ser de slo lectura. 5. Para evaluar esta expresin la forma debe refrescar cuando un pas es seleccionado. Por ello se debe habilitar la propiedad de A ctu alizar al cam b io en la pestaa de propiedades A v an zad as.

6. Pruebe la expresin en el Portal de Trabajo. Seleccione Irlanda como pas destino y note que el control Cdigo ZIP es de slo lectura.

914

Copyright 2013 - Bizagi

7. Seleccione Brasil y observe cmo el control queda disponible para edicin.

Configurar un control requerido

Siguendo el mismo ejemplo anteiror, si al paquete se le deben aplicar impuestos, se debe ingresar un valor en Declared v alu e. Para asegurarse de que este control tiene un valor es necesario configurar que sea requerido cuando se necesite. Si el usuario final no inglresa un valor se debe desplegar un mensaje. (El mensaje es automtico de Bizagi). Para saber que un paquete aplica impuestos usaremos el atributo booleano Du itab le. El control Declared Valu e debe ser requerido de acuerdo a si Duitable est o no seleccionado.:

Copyright 2013 - Bizagi

915

1. En la forma de clic sobre Declared Valu e. Sus propiedades se desplegarn en el Panel izquierdo.

2. En la pestaa de propiedades B sicas ubique la propiedad Requerido. De clic en el combo para mostrar la lista de opciones.

916

Copyright 2013 - Bizagi

Seleccione la ltima opcin: Ex p resi n . Una nueva ventana se desplegar. Para crear una nueva expresin de clic en N u ev o .

3. Seleccione la opcin Expresin. El editor de expresiones booleanas se desplegar.

Copyright 2013 - Bizagi

917

4. Configure las condiciones de requerido. En este caso nuestra condicin se relaciona con el atributo Du itab le.

5. Para evaluar el cambio en el control debe habilitar la propiedad de A ctu alizar al cam b io en la pestaa de propiedades A v an zad as.

918

Copyright 2013 - Bizagi

6. Pruebe la expresin en el Portal de Trabajo. Cuando el usuario final seleccione Du itab le el campo Declared Valu e ser requerido. Esto puede identificarse por la pequea raya roja que aparece al lado izquierdo del control.

Si el control Du itab le no est seleccionado, el control Declared Valu e no ser requerido.

Copyright 2013 - Bizagi

919

Mostrar u ocultar un control

Siguiendo el ejemplo anterior, el servicio express ofrecido por la empresa slo est disponible para envos por aire. El cliente debe decidir si tomar o no este servicio adicional.

Para evitar seleccionar el servicio express si el transporte no aplica, se debe mostrar u ocultar de acuerdo a lo seleccionado:

1. En la forma de clic sobre el control Ex p ress Serv ice. Sus propiedades se mostrarn en el Panel izquierdo.

920

Copyright 2013 - Bizagi

2. En la pestaa de propiedades Bsicas encontrar la propiedad Visible. Despliegue la lista de opciones de la propiedad.

Seleccione la ltima opcin: Ex p resi n . Una nueva ventana se desplegar. Para crear una nueva expresin de clic en N u ev o .

Copyright 2013 - Bizagi

921

3. Seleccione la opcin Expresin. Se desplegar el editor de expresiones booleanas.

4. Configure las condicione. En este caso relacionado con el medio de transporte.

922

Copyright 2013 - Bizagi

5. Para evaluar este comportamiento cuando cambie el valor del medio de transporte, la forma debe refrescarse cuando se seleccione una opcin. Se debe habilitar la propiedad de A ctu alizar al cam b io en la pestaa de propiedades A v an zad as.

6. Pruebe la expresin en el Portal de Trabajo. Seleccione Aire como medio de transporte. Note cmo el servicio express se muestra.

Copyright 2013 - Bizagi

923

7. Seleccione transporte por mar. Note que el control del servicio express se oculta.

Mostrar u ocultar controles usando expresiones de script.

924

Copyright 2013 - Bizagi

Algunas condiciones que deben ser evaluadas para retornar verdadero o falso con ms complejas que las descritas anteriormente. Por ello es necesario usar Script booleano Por ejemplo, suponga que la empresa de transporte ha decidido ofrecer el servicio express de acuerdo a la combinacin de pas origen-destino. La tabla muestra las combinaciones para las que aplica el servicio: Origen Brasil Brasil USA USA Irlanda Irlanda Destino Irlanda USA Irlanda Brasil USA Brasil Servicio express No Yes Yes Yes No No

Para poder seleccionar el servicio express slo cuando la combinacin aplica, es necesario utilizar Script booleano pues las reglas Booleanas por defecto no seran suficientes. 1. En la forma d clic sobre el control Ex p ress Serv ice. Sus propiedades se mostrarn en el Panel izquierdo.

2. En la pestaa de propiedades B sicas encontrar la propiedad Visib le. Despliegue la lista de posibles opciones.

Copyright 2013 - Bizagi

925

Seleccione la ltima opcin: Ex p resi n . Una nueva ventana se desplegar. Para crear una nueva expresin de clic en N u ev o .

3. Seleccione la opcin Ex p resi n . Se desplegar el editor de expresiones booleanas.

926

Copyright 2013 - Bizagi

5. Seleccione la opcin A v an zad o y luego N u ev a scrip tin g.

6. En el editor de expresiones incluya un mdulo de Expresin.

Copyright 2013 - Bizagi

927

7. Para configurar la expresin debemos haber creado una definicin Constante para ser usada dentro de la regla. Estas definiciones contendrn el cdigo (atributo creado dentro de las entidades) de los pases.

8. Escribe el siguiente cdigo y guarde la expresin:

928

Copyright 2013 - Bizagi

//Se inicia asumiendo falso. false; //Obtenga el cdigo de transporte areo del vocabulario var AirCode=CHelper.resolveVocabulary(Me,"Air"); //Obtenga el cdigo de Brasil del vocabulario var BrazilCode=CHelper.resolveVocabulary(Me,"Brazil"); //Obtenga el cdigo de USA del vocabulario var USACode=CHelper.resolveVocabulary(Me,"USA"); //Obtenga el cdigo de Irlanda del vocabulario var IrelandCode=CHelper.resolveVocabulary(Me,"Ireland");

//Evaluar si es aire if (<Shipping.TransportationMean.Code>==AirCode) { //Evaluar origen destino if (<Shipping.CountryFrom.Code>==BrazilCode && <Shipping.CountryTo.Code>==USACode) { //Return true true;

Copyright 2013 - Bizagi

929

} if (<Shipping.CountryFrom.Code>==USACode && <Shipping.CountryTo.Code>==IrelandCode) { //Retorna true true; } //Evaluar origen destino if (<Shipping.CountryFrom.Code>==USACode && <Shipping.CountryTo.Code>==BrazilCode) { //Retorna true true; } } 9. Es necesario evaluar esta propiedad cada vez que se selecciona un origen o destino. Por ello se debe habilitar la propiedad de A ctu alizar al cam b io en las propiedades A v an zad as.

10. Pruebe la propiedad en el Portal de Trabajo. Seleccione un origen-destino que ofrezca Servicio express y luego seleccione Aire como medio de transporte. Note que el servicio se muestra.

930

Copyright 2013 - Bizagi

11. Seleccione una combinacin de origen-destino que no ofrezca servicio express y seleccione Aire como medio de transporte. Note que el control no es mostrado.

Nota Cuando se aplican estos comportamientos sobre las columnas de una tabla, sern aplicados a la columna entera. Si usted desea saber cmo configurar visibilidad y editabilidad a nivel de celda consulte Configurar visibilidad y editabilidad de celdas

3.5.3.3.1.1 Visibilidad y editabliidad de celdas

En muchas ocasiones es necesario evaluar condiciones con el fin de definir si una celd a esp ecfica de una tabla es editable o visible. Bizagi permite definir expresiones para evaluar las condiciones necesarias y configurar los comportamientos deseados para las filas o columnas independientemente. Suponga que una compaa ha implementado un proceso en Bizagi para gestionar las tareas de los proyectos. En la primera actividad de este proceso, el gerente de proyecto planea todas las actividades necesarias, sus fechas lmite y sus responsables. Una vez planeado el proyecto, se habilita una actividad para cada responsable con el fin de que puedan reportar los avances de las tareas.

Copyright 2013 - Bizagi

931

Desde la tercera actividad del proceso, el gerente de proyecto puede ver el estado actual de cada tarea, tal como se muestra en la siguiente imagen:

Los estados posibles para las tareas son: En p ro g reso , co m p leta, can celad a o v en cid a.

Configurar una celda como de solo lectura

Suponga que si el estado de una tarea es En progreso o vencida, el gerente de proyecto puede ampliar la fecha lmite, de otra manera, la celda de fecha limite debera permanecer como de solo lectura. Debemos entonces definir una expresin para evaluar cada fila y establecer el comportamiento correspondiente. Para configurar lo anterior siga los pasos que se describen a continuacin: 1. Desde el tercer paso del Asistente de Procesos vaya a la forma donde se configurar el comportamiento. 2. D clic en la tabla que contiene las celdas de inters y luego d clic en el botn Ed itar Co lu m n as.

932

Copyright 2013 - Bizagi

3. D clic en la celda F ech a lm ite. Aparecer un nuevo men contextual en la parte izquierda de la pantalla.

4. En la opcin Celd a ed itab le d clic en el icono de expresin.

Copyright 2013 - Bizagi

933

5. En la nueva ventana cree una expresin estndar.

6. Incluya las precondiciones relacionadas al valor del estado de la tarea que habilitarn la celda para su edicin.

934

Copyright 2013 - Bizagi

D clic en O K para guardar los cambios. 7. Vaya al Portal de Trabajo para probar el comportamiento. Note que si el estado de la tarea es Co m p letad a o Can celad a, la celda de fecha lmite ser de solo lectura.

Esconder el valor de una celda especfica

Suponga que si el estado de una tarea es Co m p letad a o can celad a, los comentarios hechos en la tarea ya no sern relevantes y no deberan mostrarse ms. Debemos entonces definir una expresin para evaluar cada fila y establecer el comportamiento correspondiente. Para configurar esto siga los pasos descritos a continuacin:

Copyright 2013 - Bizagi

935

1. Desde el tercer paso del Asistente de Procesos vaya a la forma donde se configurar el comportamiento. 2. D clic en la tabla que contiene las celdas de inters y luego d clic en el botn Ed itar Co lu m n as.

3. D clic en la celda F ech a lm ite. Aparecer un nuevo men contextual en la parte izquierda de la pantalla.

4. En la opcin Celd a Visib le d clic en el icono de expresin.

936

Copyright 2013 - Bizagi

5. En la nueva ventana cree una expresin estndar.

6. Incluya las precondiciones relacionadas al valor del estado de la tarea, que habilitarn la visualizacin de la celda.

Copyright 2013 - Bizagi

937

D clic en O K para guardar los cambios. 7. Vaya al Portal de Trabajo para probar el comportamiento. Note que si el estado de la tarea es Co m p letad a o Can celad a, la celda de comentarios no mostrar el valor contenido.

3.5.3.3.2 Valores por defecto usando expresiones

El siguiente ejemplo muestra cmo configurar un valor por defecto a un control. Suponga que una empresa de Transporte y Logstica tiene un proceso llamado Proceso de Envo para manejar y monitorear los envos internacionales. La primera tarea de este proceso permite al cliente

938

Copyright 2013 - Bizagi

ingresar la informacin y estimar el costo del cargamento. La compaa cubre envos desde y hacia Brasil, Irlanda y Estados Unidos. Tambin tiene tres medios de transporte: aire, mar y tierra. Si es transporte elegido es aire, se debe ofrecer servido express para que el paquete sea entregado el mismo da que se enva. La forma usada para obtener esta informacin es:

La compaa quiere que el pas de origen sea el que est configurado en el usuario de la persona ingresando la informacin. Este valor puede ser cambiado en cualquier momento si el usuario final solicita un envo desde otro pas. Para configurar esto se debe usar una expresin, para identificar el pas del cliente y asignarlo como pas origen: 1. En la forma de clic al control O rig in Co u n try. Las propiedades se desplegarn en el Panel Izquierdo.

Copyright 2013 - Bizagi

939

2. En la pestaa A v an zad o ubique la propiedad Valo r p o r d efecto y d clic en el cono..

De clic en Nuevo para crear una expresin.

940

Copyright 2013 - Bizagi

3. Se desplegar el editor de expresiones. Adicione un mdulo de expresin.

4. Escriba el siguiente cdigo y guarde la regla:

Copyright 2013 - Bizagi

941

//Retorna el ID del pas del usuario logueado. Me.Case.WorkingCredential.UserProperties["idcountry"]; 5. Pruebe el valor por defecto en el Portal de Trabajo. Cree un nuevo caso y vea cmo el control est diligenciado automticamente. Para este ejemplo especfico es necesario que Pas est configurado dentro de las propiedades del usuario. Entre al Portal de Trabajo como usuario de Brasil y cree un nuevo caso. Note cmo ese es el pas diligenciado.

3.5.3.3.3 Valor mnimo usando expresiones

El siguiente ejemplo muestra cmo configurar el valor mnimo para un control. Suponga que una empresa de Transporte y Logstica tiene un proceso llamado Proceso de Envo para

942

Copyright 2013 - Bizagi

manejar y monitorear los envos internacionales. La primera tarea de este proceso permite al cliente ingresar la informacin y estimar el costo del cargamento. La compaa cubre envos desde y hacia Brasil, Irlanda y Estados Unidos. Tambin tiene tres medios de transporte: aire, mar y tierra. Si es transporte elegido es aire, se debe ofrecer servido express para que el paquete sea entregado el mismo da que se enva. La forma usada para obtener esta informacin es:

El valor mnimo que un cliente puede ingresar como fecha de envo es la fecha actual. Para configurar esta validacin es necesario usar una expresin. 1. En la forma d clic sobre el control Sh ip p in g Date. Sus propiedades se mostrarn en el Panel izquierdo.

Copyright 2013 - Bizagi

943

2. En la pestaa A v an zad o encontrar la propiedad M n im o . De clic en el icono de expresin.

De clic en Nuevo para crear una expresin.

944

Copyright 2013 - Bizagi

3. Se desplegar el editor de expresiones. Agregue un mdulo de expresin.

4. Escriba el siguiente cdigo y guarde la expresin. Esto retornar la fecha de hoy y lo configurar como en mnimo valor a ingresar.

Copyright 2013 - Bizagi

945

//Retorna la fecha de hoy DateTime.Today; 5. En el Portal de Trabajo note que las fechas anteriores a hoy estarn deshabilitadas.

3.5.3.3.4 Valor mximo usando expresiones

El siguiente ejemplo muestra cmo configurar el valor mximo para un control. Suponga que una empresa de Transporte y Logstica tiene un proceso llamado Proceso de Envo para manejar y monitorear los envos internacionales. La primera tarea de este proceso permite al cliente ingresar la informacin y estimar el costo del cargamento. La compaa cubre envos desde y hacia Brasil, Irlanda y Estados Unidos. Tambin tiene tres medios de transporte: aire, mar y tierra. Si es transporte elegido es aire, se debe ofrecer servido express para que el paquete sea entregado el mismo da que se enva. La forma usada para obtener esta informacin es:

946

Copyright 2013 - Bizagi

Las dimensiones mximas (en altura) para un paquete varan de acuerdo al medio de transporte seleccionado: Medio de Transporte Aire Mar Tierra Para configurar esta validacin es necesario crear una expresin. 1. En la forma vaya al control H eig h t. Sus propiedades se mostrarn en el Panel izquierdo. Altura mxima permitida (ft) 70 94 100

Copyright 2013 - Bizagi

947

2. En la pestaa A v an zad o encontrar la propiedad M x im o . D clic en el icono.

De clic en Nuevo para crear una expresin.

948

Copyright 2013 - Bizagi

3. El editor de expresiones se desplegar. Incluya un mdulo de expresin.

4. Para configurar la expresin debemos haber creado una definicin Constante para ser usada dentro de la regla. Estas definiciones contendrn en cdigo del medio de transporte.

Copyright 2013 - Bizagi

949

5.Escriba el siguiente cdigo y guarde la expresin.

//Obtener el cdigo de Aire del vocabulario var AirCode=CHelper.resolveVocabulary(Me,"Air"); //Obtener el cdigo martimo del vocabulario var MaritimeCode=CHelper.resolveVocabulary(Me,"Maritime"); //Obtener el cdigo de transporte del vocabulario var LandCode=CHelper.resolveVocabulary(Me,"Land");

if (<Shipping.TransportationMean>==AirCode) { 70; } if (<Shipping.TransportationMean>==MaritimeCode) {

950

Copyright 2013 - Bizagi

94; } if (<Shipping.TransportationMean>==LandCode) { 100; } 6. En el Portal de Trabajo note que Bizagi muestra un mensaje al ingresar un valor mayor al permitido por un medio de transporte. Si da clic en Siguiente se desplegar una validacin.

3.5.3.3.5 Filtros con expresiones

En algunas situaciones puede ser necesaria la definicin de filtros complejos que no pueden ser configurados directamente desde el editor de expresiones booleanas. Para estos casos, Bizagi permite definir F iltro s A v an zad o s usando expresiones. Los filtros avanzados se pueden definir para los siguientes controles: Combo Radio Lista Bsqueda Sugerencia Las expresiones utilizadas para definir estos filtros utilizan sentencias de base datos, por esta razn, estas siempre deben retornar un valor del tipo string. En los siguientes ejemplos utilizaremoss sentencias de SQL (AND, OR, LIKE, <>, IN, etc).

Copyright 2013 - Bizagi

951

Nota: Esta funcionalidad esta soportada a partir de las versiones 10.1.X de Bizagi.

Ejemplos de Filtros Avanzados

Definir un filtro combinando AND/OR
Cuando usted necesita definir filtros cuyas condiciones se enlazan nicamente con un operador (AND/ OR) usted puede utilizar el editor de expresiones booleanas. Sin embargo, cuando usted necesita que estas condiciones estn enlazadas por combinaciones de operadores AND/OR, usted debe utilizar Filtros avanzados. Consideremos una situacin donde usted requiere evaluar condiciones enlazadas por operadores AND/OR simultneamente con el fin de definir los valores que se mostrarn en una lista desplegable. En un Proceso de solicitud de compra, el administrador de compras debe seleccionar el proveedor para los productos solicitados de un control tipo combo. Los proveedores entre los cuales este puede ser seleccionado (valores mostrados en el combo), deben cumplir con los siguientes requerimientos. - Si el proveedor es un proveedor frecuente entonces su reputacin debe ser mayor al 85%. - Si el proveedor es un proveedor no frecuente entonces su reputacin debe ser mayor al 95%. Observe que estos requerimientos se pueden expresar como dos condiciones diferentes enlazadas por un operador OR. Asi mismo, cada condicin esta compuesta por dos sub-condiciones enlazadas por un operador AND. Para identificar si un proveedor es frecuente y para determinar su reputacin, la entidad maestra Proveedor posee, entre otros, los siguientes atributos:

Para definir este filtro sobre el combo de P ro v eed o r seleccio n ad o , siga los pasos que se describen a continuacin: 1. Abra el Diseador de Formas desde el Asistente de Procesos, en la actividad donde se encuentra el control a ser filtrado. Seleccione el control deseado (en este caso Proveedor seleccionado) y acceda a la p esta a

A v an zad o . D clic en el icono expresin (

) dentro del campo F iltro .

952

Copyright 2013 - Bizagi

De clic en Nuevo para crear una expresin.

2. Una nueva ventana mostrar el editor de expresiones. Cree un mdulo de expresin.

Copyright 2013 - Bizagi

953

3. Declare las siguientes variables: Condition1: almacena el texto relacionado al filtro de la primera condicin (Proveedor frecuente Y reputacin > 0,85). Condition2: almacena el texto relacionado al filtro de la segunda condicin (Proveedor no frecuente Y reputacin > 0,95). Filterstring: es el texto del filtro que se aplicar a los valores del control.

954

Copyright 2013 - Bizagi

4. Defina el texto para cada condicin. Observe que en este caso utilizamos sentencias AND para enlazar las sub-condiciones de cada una.

Condition1="FrequentSupplier=TRUE AND Rating > 0,85" Condition2="FrequentSupplier=FALSE AND Rating > 0,95" 5. Construya el texto del filtro a aplicar. Observe que este enlaza las dos condiciones construidas previamente utilizando un operador OR.

Copyright 2013 - Bizagi

955

Filterstring=Condition1 + " OR "+ Condition2; 6. Finalmente retorne el filtro de la siguiente manera:

Filterstring; D clic en O K para guardar los cambios.

Filtrar por Rol un combo relacionado a una entidad WFUSER

Los Filtros avanzados tambin son tiles para filtrar valores relacionados a atributos W F User, de acuerdo a propiedades de usuario como Roles, Posiciones o Habilidades. Suponga que en un Proceso de Mesa de ayuda la persona de soporte que recibe un reporte (ticket), debe asignarlo a uno de los tcnicos calificados. Para hacerlo, esta persona selecciona un tcnico de una lista desplegable (control tipo combo) denominado A sig n ar a, por lo que este control debera mostrar nicamente los usuarios que posean el rol de Tcn ico d e So p o rte. Para filtrar los valores mostrados en este control, necesitamos establecer un Filtro avanzado que muestre los tcnicos calificados de la entidad WFUser, basado en su rol. Este filtro debe seguir la siguiente estructura:

956

Copyright 2013 - Bizagi

idUser IN (idTech1,idTech2,idTech3....idTechN) Donde id User es la llave fornea de la entidad WFUser en base de datos, e IN es una sentencia SQL. En consecuencia, la expresin utilizada para definir este filtro debe obtener, de alguna manera, un texto que contenga la sentencia bsica (idUser in) seguida por los identificadores de los usuarios que posean el rol especifico, separados por comas y entre parntesis (idTech1,idTech2, idTech3....idTechN). Para hacerlo, siga los pasos que se describen a continuacin: 1. Abra el Diseador de Formas desde el Asistente de Procesos, en la actividad donde se encuentra el control a filtrar. En la pestaa Avanzado d clic en el icono de expresin (
) , dentro del campo F iltro .

De clic en Nuevo para crear una expresin.

Copyright 2013 - Bizagi

957

2. En la expresin principal, cree tres m d u lo s d e ex p resi n y un m d u lo F o r como se muestra a continuacin. En el primer mdulo de expresin declare las variables y obtenida la lista de usuarios con el Rol especfico. Utilice el mdulo For para iterar sobre cada registro de la lista. En el segundo mdulo de expresin obtenga el texto de los identificadores de los usuarios que poseen el Rol. En el ltimo mdulo de expresin, construya el texto del filtro y aplquelo.

958

Copyright 2013 - Bizagi

3. En el primer mdulo de expresin declare las siguientes variables: UserArray: Guarda la lista de usuarios que pertenecen a un Rol especfico. IterationIndex: Contador para el ciclo FOR. TempIdUser: Guarda temporalmente un registro especfico de la lista de usuarios. newRow: Crea un nuevo registro en la relacin donde se incluir el usuario.

Copyright 2013 - Bizagi

959

4. Obtenga la lista de usuarios que poseen el Rol buscado utilizando la funcin Get u sers in Ro le que se encuentra en la categora Usu ario s de la lista de funciones. Nota Recuerde que usted puede obtener el identificador del Rol deseado utilizando la opcin B u scar en Bizagi Studio. Esta opcin se encuentra en la pestaa de Inicio. Seleccione la opcin de Organizacin e ingrese el nombre de la propiedad. La bsqueda retornar el identificador, como se muestra a continuacin.

960

Copyright 2013 - Bizagi

En este caso, el Id del Rol Tcn ico d e So p o rte es 2.

//Obtenga la lista de usuarios con el Rol especfico y gurdelo en la variable UsersArray=CHelper.getUsersForRole(2); 5. Itere la lista utilizando un elemento FOR. El ciclo comienza en Cero (0) y termina en el ltimo ndice de la lista. La sentencia UsersArray.Count regresar el nmero total de usuarios encontrados (es decir, cuenta los elementos del arreglo). El ciclo ser ejecutado mientras que el ndice de la coleccin sea menor que el nmero total de

Copyright 2013 - Bizagi

961

elementos del arreglo.

6. Incluya el siguiente cdigo en el segundo mdulo de expresin para obtener el texto de los identificadores de los usuarios con el rol especfico, en el formato requerido. Observe que esta es solo una manera de hacerlo.

Obtenga el identificador del usuario actual de la iteracin CurrentUserid=UsersArray(IterationIndex); Construya el texto utilizado para filtrar el combo Si el usuario actual no es el primer usuario de la lista

962

Copyright 2013 - Bizagi

if (UsersIds!="null") { Si el usuario actual no es el ltimo usuario de la lista if (IterationIndex!=(UsersArray.Count-1)) { UsersIds=UsersIds+CurrentUserid+","; } Si el usuario actual es el ltimo usuario de la lista else { UsersIds=UsersIds+CurrentUserid+")"; } } Si el usuario actual es el primer usuario de la lista if (UsersIds=="null") { UsersIds="("+CurrentUserid+","; } 7. En el ltimo mdulo de expresin construya el texto del filtro y aplquelo tal como se muestra a continuacin.

Concatenar la sentencia del filtro con los identificadores de los usuarios que poseen el rol especificado Filterstring="idUser in "+UsersIds; Aplque el filtro Filterstring; D clic en O K para guardar los cambios. 3.5.3.4 Reutilizar reglas de negocio

Informacin General
En Bizagi es posible reutilizar reglas de negocio para hacer la automatizacin del proceso ms eficiente. Reglas de Negocio que son utilizadas frecuentemente en el proyecto solo se crean una vez, luego solo se deben asociar a los nuevos elementos cuando se necesite. Es muy importante saber donde crear estas reglas de negocio para poder reutilizarlas.

Copyright 2013 - Bizagi

963

Tipos de reglas de negocio

Existen dos tipos de reglas de negocio: Reglas booleanas y reglas de Scripting. Cada tipo provee cierta flexibilidad y facilidad de uso. Depende de donde se utilicen reglas de negocio, Bizagi permitir la creacin de unas u otras. Reglas de negocio Estas reglas solamente deben retornar Verdadero o Falso. Como vimos en la seccin anterior, las reglas booleanas son utilizadas para: Reglas asociadas al flujo de secuencia (ruta del proceso) Reglas utilizadas para condiciones de atributos (campos en formas) para que sean visibles, editables o requeridos. Note la opcin Reusable en la esquina superior derecha. Si la regla es reusable, seleccione el campo.

Scripting rules Son reglas que realizan clculos y validaciones. En este tipo de reglas usted puede incluir cdigo para llevar a cabo cualquier tipo de tarea, estas reglas no tienen que retornar un tipo de datos en particular. Este tipo de reglas son utilizadas en: Acciones al Entrar, al Salvar y al Salir. Validaciones de tablas de la forma. Botones y formas. Estas reglas siempre son reusables. Dependiendo de donde se han creado, ests pueden se usadas por cualquier proceso dentro del proyecto, o por un proceso dentro de la misma aplicacin, o solamente en el proceso donde fueron creadas.

964

Copyright 2013 - Bizagi

Bizagi tiene cuatro niveles donde las Reglas de Negocio son guardadas dependiendo del sitio desde el cual pueden ser accedidas. Los niveles son:

Reglas Globales / Librera reglas Aplica para el edicin Enterprise:

estas pueden ser reglas Booleanas o Scripting. Son reglas generales que pueden ser accedidas y reutilizadas por todos los procesos de todas las aplicaciones, generalmente realizan clculos que aplican a varios procesos, sin ningn contexto. Es posible crear familias de reglas para organizarlas. Si la regla es creada como una Funcin est ser como librera de reglas. De esta forma podr ser llamada por otras reglas para realizar clculos. Reglas de aplicacin Aplica para la edicin Enterprse:

estas pueden ser reglas Booleanas o Scripting. Pueden ser accedidas y reutilizadas por todos los procesos de una aplicacin. Usualmente realizan clculos que aplica para los procesos que comparten el contexto. Es posible crear familias de reglas para ordenarlas. Reglas de entidad: estas pueden ser reglas Booleanas o Scripting. Pueden ser accedidas por

Copyright 2013 - Bizagi

965

cualquier proceso en cualquier aplicacin siempre y cuando la entidad donde se encuentra la regla sea parte del modelo de datos. Las reglas booleanas en entidades manejan, por ejemplo, si un campo es visible, editable o requerido. Las reglas de scripting se utilizan en botones y en validaciones de tabla. Reglas de proceso: estas pueden ser reglas Booleanas o Scripting. Estas reglas solo se pueden reutilizar en el proceso: ningn otro proceso podr verlas o utilizarlas. Las reglas booleanas son las relacionadas con la ruta del proceso. Las reglas de Scripting son aquellas que se utilizan en las acciones Al Entrar, Al Salvar y Al Salir. Cuando se crea una regla en el paso cuatro del Asistente para definir la ruta del proceso o una accin, esta quedar guardada automticamente como Reglas de Proceso.

966

Copyright 2013 - Bizagi

Ejemplo de una Regla Global/ Librera de reglas Aplica para el

Copyright 2013 - Bizagi 967

edicin Enterprise
Suponga que usted trabaja en un banco. Se desea que cuando se realic una solicitud para un crdito, la fecha de la solicitud quede definida por defecto. De esta forma se asegura que cuando se cree un nuevo caso, se asigne a la fecha de la solicitud la fecha de Hoy. Otro ejemplo, en el Proceso de Solicitud de Compras es necesario configurar un valor de fecha mnima para realizar la entrega de los productos: Es necesario que la fecha sea despus de hoy debido a que la entrega se hace al menos un da despus. Ya que pueden existir muchos escenario que necesitan verificar la fecha actual (hoy), tiene mucho sentido crear una sola regla y utilizarla varias veces a travs de los procesos. Note que esta regla no necesita un contexto. No hay ninguna manipulacin del modelo de datos, solo se necesita la fecha de hoy. Por lo cual, hemos creado una regla Global que devuelve la fecha de Hoy utilizando una funcin de la categora de Fechas y Tiempos. En la vista de M d u lo s, seleccione la opcin Reglas de negocio. Luego seleccione la opcin Expresiones de la clasificacin de las Reglas de Negocio y de clic sobre Nueva Expresin de Script. Cuando se crea una nueva regla es posible ubicarla dentro de una familia de reglas, seleccione la familia de la lista desplegable si aplica, de lo contrario deje el espacio en blanco.

968

Copyright 2013 - Bizagi

Vamos a utilizar esta regla en el Modelador de Formas de un proceso para definir el valor por defecto o una fecha mnima. Abra el modelador de formas y seleccione el atributo donde se quiere incluir la regla. Seleccione la propiedad valor por defecto y luego asigne la regla.

Copyright 2013 - Bizagi

969

Ejemplo de una Regla de aplicacin -Aplica para el edicin Enterprise

Para la solicitud de un crdito, es necesario facilitar cierta informacin inicial sobre la solicitud. Antes de que el solicitante sea aceptado como cliente, las formas debern mostrar u ocultar cierta informacin (renders o campos). Por lo que se necesitan de reglas de visibilidad en varias formas del proceso para obtener el comportamiento deseado. Note que esta regla tiene un contexto por que est relacionada con el solicitante. El contexto de la regla ser la entidad del Proceso principal del proceso padre. Por lo tanto, creamos una regla de aplicacin que devuelve Verdadero o Falso segn el cliente evaluado. En la vista de M d u lo s, seleccione la opcin Reglas de negocio. Luego seleccione la opcin Expresiones en la Aplicacin donde quiere crear la regla. Seleccione Nueva expresin. Bizagi le preguntar si desea una rebla Booleana o de Script. En este caso seleccionamos Booleana. Arrastre y suelte los datos para evaluar, adems establezca la condicin. Finalmente de un nombre a la regla. Cuando se crea una nueva regla es posible ubicarla dentro de una familia de reglas, seleccione la familia de la lista desplegable si aplica, de lo contrario deje el espacio en blanco.

970

Copyright 2013 - Bizagi

Ahora se pude utilizar la regla en el Modelador de Formas de cualquier proceso de la aplicacin. Abra el Modelador de Formas y seleccione el atributo que se quiere ocultar con la regla.

Copyright 2013 - Bizagi

971

Ejemplo de una regla de Entidad

En el Proceso de Solicitud de Compras existe una coleccin de productos, donde el usuario final ingresa todos los productos que necesita. Existe una relacin uno a muchos entre la entidad de proceso Solicitud de compras y Productos de la Solicitud. El usuario final ingresa cada producto especificando el precio unitario y la cantidad. Luego, cuando el registro se guarda, se debe calcular y mostrar el precio total de los productos, es decir, el precio unitario por la cantidad. Vamos a calcular esta cantidad utilizando una Ex p resi n d e Valid aci n al Ed itar. Estas reglas estn relacionadas con las formas del modelador donde se han guardado la entidad de la coleccin. Es decir, pueden ser reutilizadas por cualquier proceso que tenga la entidad de la coleccin dentro de su modelo de datos. En el modelador de formas, seleccione la tabla donde se va a utilizar la regla.

972

Copyright 2013 - Bizagi

Seleccione Ex p resi n d e Valid aci n al Ed itar. Esto abrir un regla de script para escribir el cdigo. Debido a que estamos trabajando sobre una coleccin, el contexto de la regla ser la entidad Productos Solicitados. Cuando el usuario final guarde un nuevo proceso, el precio total ser calculado.

Copyright 2013 - Bizagi

973

Ejemplo de una regla de proceso

Bizagi guarda como reglas de proceso las acciones creadas Al Entrar, Al Salir y Al guardar y las reglas de ruteo del proceso. La siguiente regla en una regla de proceso booleana que orienta el proceso cuando el jefe ha solicitado cambios, antes de continuar con el sub proceso Cotizaciones.

974

Copyright 2013 - Bizagi

Cmo reusar una relga

Cuando una regla es creada y usted quiere volverla a utilizar, vaya al flujo de secuencia donde quiere asociar la regla y abra el editor de reglas. Luego de clic en Can celar.

Copyright 2013 - Bizagi

975

Esto mostrar todas las reglas disponibles para ser reutilizadas. Seleccione la que quiera y de clic en O k.

976

Copyright 2013 - Bizagi

3.5.4

Elementos de las reglas de negocio

La escritura de reglas tiene diferentes elementos, los cuales proveen una estructura y facilitan la escritura del cdigo utilizando un asistente. Una regla puede estar compuesta por varios elementos. Le recomendamos utilizarlos para darle estructura a su cdigo. Sin embargo, entre ms elementos tenga la regla, ms compleja ser, lo cual puede llegar a generar errores difciles de rastrear. Para incluir un elemento de clic derecho sobre la lnea vertical (flecha negra). Un men con una lista desplegable con todos los posibles elementos ser mostrado. Seleccione el elemento deseado y asigne un nombre en el panel de Propiedades del lado izquierdo. De doble clic en el elemento creado y seleccione la opcin Propiedades para estables las caractersticas de la evaluacin en una nueva ventana. Cuando se trabaja con elementos, el cdigo asociado con la lgica expresada en el diseo es creado automticamente en el Code View.

Copyright 2013 - Bizagi

977

Expresiones: Este elemento ofrece la posibilidad de escribir cualquier cdigo. IF: Ofrece la posibilidad de seleccionar un camino de varios disponibles de acuerdo a una condicin. El camino else (si no) se establecer siempre. While: Ejecuta un ciclo tan largo como la condicin lo indique. For: Ejecuta un ciclo un nmero finito de veces, inicia con un valor inicial e incrementa la variable de control en una cantidad especificada en cada iteracin. Funcin: Permite al usuario usar funciones que han sido creadas como libreras de funciones en el proyecto. Web service: Incluye el llamado de un servicio web. Asignacin: Permite asignar valores a atributos del modelo de datos utilizando un interfaz. Expresiones booleanas: Manejan expresiones booleanas. Cuando una condicin s cumple, la expresin devuelve verdadero, de lo contrario retorna falso. Iterate over fact: Se utiliza para llevar a cabo iteraciones (ciclos) sobre relaciones uno a muchos UNICAMENTE cuando la relacin no puede ser accedida de forma directa utilizando el XPath del modelo de datos. Iterate over XPath: Se utiliza para llevar a cabo iteraciones (ciclos) sobre colecciones Xpath, es decir en relaciones uno a muchos.

978

Copyright 2013 - Bizagi

3.5.4.1

Elemento de expresiones

Informacin General
Los elementos de expresin permiten incluir instrucciones como cdigo para llevar a cabo cualquier tipo de tarea. Las expresiones pueden realizar clculos y validaciones utilizando funciones XPath. La interfaz de las expresiones tiene varias opciones que permiten escribir fcilmente una regla.

OPCIN Modelo de datos

USO Permite construir un XPath que utilice expresiones. Adicionalmente, usted puede modificar el modelo de datos e incluir valores a las entidades paramtricas. Incluye una lista de funciones, que combinadas los XPath construidas en el modelo de datos. Las funciones estn organizadas en categoras, cada opcin incluye una descripcin y un ejemplo. Muestra una lista de vocabularios que pueden ser incluidos dentro de una expresin. Si la regla es creada como una expresin global, nicamente el vocabulario global estar disponible. Si la expresin fue creada como expresin de aplicacin, solamente el vocabulario de aplicacin estar disponible. Permite acceso rpido para administrar variables, crear, modificar o

Funciones

Vocabulario

Variables

Copyright 2013 - Bizagi

979

borrarlas. Una vez ha creado una variable, es posible utilizarla dentro de una expresin, seleccinela de la lista desplegable. Formato Permite varias opciones de formato: guardar, cortar, copiar, pegar, deshacer, rehacer, aumentar o disminuir la sangra.

Nota: Las funciones XPath, vocabularios y variables que sean seleccionadas sern incluidas donde se encuentre el cursor.

Bizagi utiliza la funcionalidad In tellisen se para mostrar las funciones y Xpaths, y de esta manera facilitar y agilizar la creacin de expresiones.

Vamos a utilizar el elemento de expresin del ejemplo anterior.

Ejemplo
En un proceso de Solicitud de compras, luego de que la solicitud sea aprobada, es necesario solicitar cotizaciones y luego seleccionar el mejor proveedor. Sin embargo, es necesario incluir un nmero especfico de cotizaciones para el proceso de seleccin del proveedor. El usuario no podr continuar hasta que el nmero de cotizaciones requerido sea alcanzado. Vamos a utilizar un elemento de expresin para evaluar si el nmero de cotizaciones requeridas han

980

Copyright 2013 - Bizagi

sido incluidas. Si no, se mostrar un mensaje de validacin para que el usuario final corrija la situacin. Incluya un elemento de expresin en la regla de negocio y asgnele un nombre.

Cree una funcin If para evaluar el nmero de cotizaciones requeridas versus el nmero de cotizaciones incluidas. Como primer parmetro incluya el nmero de cotizaciones requeridas utilizando la opcin del M o d elo d e Dato s.

Copyright 2013 - Bizagi

981

Incluya el nmero de cotizaciones ingresadas utilizando la funcin Co n tar. La funcin la encuentra en la categora N av eg aci n d e Dato s, en la opcin funciones, luego incluya el XPath en la opcin M o d elo d e Dato s.

982

Copyright 2013 - Bizagi

Nota: Cuando se incluye un XPath utilizando la opcin de Modelo de Datos, se incluyen corchetes de diamante <>. RECUERDE BORRAR LOS CORCHETE CUANDO UTILICE UNA FUNCIN XPath. Agregue un mensaje de validacin utilizando la funcin Th ro w Valid atio n erro r de la categora Valid aci n d e Data.

Copyright 2013 - Bizagi

983

El cdigo final ser: if (<PurchaseRequest.NumberOfQuotationsRequir> > <count (PurchaseRequest.Quotation)>) CHelper.ThrowValidationError("You need at least "+ <PurchaseRequest.NumberOfQuotationsRequir> +"quotations"); 3.5.4.2 Elemento Iterate over XPath

Informacin General
Iterate over XPath permite realizar iteraciones (o ciclos) sobre una expresin XPath que tiene una coleccin, es decir, una relacin uno-a-muchos. Es posible acceder a cada una de los registros en la relacin de forma individual para realizar operaciones tales como modificar registros de la relacin, o realizar clculos y validaciones. Tambin es posible realizar filtros sobre la coleccin para solo trabajar sobre algunos registros.

Qu se debe hacer en Bizagi?

1. Crear una expresin de Scritp 2. Declarar una variable para almacenar los elementos de la coleccin. 3. Incluir un elemento Iterate over XPath donde se define la coleccin XPath a iterar y se incluyen los filtros si se necesitan.

984

Copyright 2013 - Bizagi

4. Durante la iteracin del ciclo incluya una elemento de expresin para realizar los clculos requeridos. 5. Guarde la regla.

Ejemplo
En el siguiente escenario usted trabaja en el departamento de crdito de un banco. Dos solicitantes solicitan el anlisis de su capacidad de crdito para comprobar si califican para un crdito. El banco realiza el anlisis financiero y evala la capacidad de pago de cada uno de los solicitantes. La entidad de proceso es Solicitud. Cada solicitud puede tener varios solicitantes, por lo que es necesario definir una relacin uno a muchos entre la entidad Solicitud y Solicitantes. Adicionalmente cada solicitante tiene una descripcin de la capacidad financiera del momento en que se realiza la solicitud. Una regla debe evaluar cada solicitante en cuanto a sus ingresos, salario fijo y salario variable. La regla calcula los ingresos totales.

1. Cree una regla Al Salir de la actividad. 2. Declare las siguientes variables: Applicant (object) para guardar la coleccin de registros. MonthlyBaseIncome (int) para guardar el valor del ingreso base para futuros clculos. MonthlyVarIncome (int) para guardar el valor del ingreso variable para futuros clculos. TotalIncome (int) para guardar el ingreso total.

Copyright 2013 - Bizagi

985

3.Incluya el elemento Iterate over XPath. Seleccione la variable Applicant para guardar la coleccin de registros. Seleccione la coleccin XPath. En este caso seleccione Req u est.A p p lican ts.

986

Copyright 2013 - Bizagi

4. Incluya un elemento de expresin para calcular el ingreso total.

Copyright 2013 - Bizagi

987

Ingrese el siguiente cdigo en la ventada de edicin de la expresin: MonthlyBaseIncome = Applicant.getXPath ("CustomerSnapshot.MonthlyBaseIncome"); MonthlyVarIncome = Applicant.getXPath ("CustomerSnapshot.MonthlyVariableIncome"); TotalIncome=0; if(!BAIsBlank(MonthlyBaseIncome)) TotalIncome = TotalIncome + MonthlyBaseIncome if (!BAIsBlank(MonthlyVarIncome)) TotalIncome = TotalIncome + MonthlyVarIncome Applicant.setXPath("CustomerSnapshot.MonthlyTotalIncome", TotalIncome); Note que la variable Applicant se utiliza para consultar y para asignar registros de forma individual Variable.getXPath("attribute within the collection"); Variable.setXPath("attribute within the collection", value to set); Si la coleccin XPath tiene filtros, la iteracin, y la modificacin de los registros solamente se realizar

988

Copyright 2013 - Bizagi

sobre los registros que cumplen la condicin del filtro. 3.5.4.3 Elemento de Asignacin

Informacin general
El elemento Asignacin permite asignar valores en atributos del modelo de datos o en una variable utilizando una interfaz muy sencilla. Los siguientes valores pueden ser asignados: Un valor fijo: El valor ser ajustado para que coincida con el tipo del atributo, por ejemplo Si/No ser mostrado para los atributos de tipo Booleano. El valor de un XPath: Es posible navegar a travs del modelo de datos, incluyendo colecciones. Una expresin (cdigo abierto) Un vocabulario: seleccione cualquier vocabulario (Constante o XPath) que pertenezca al proceso o su aplicacin. Un valor de una entidad (maestra o paramtrica) Para ms informacin sobre asignacin de variables visite el ejemplo de Elemento de asignacin.

Ejemplo: Asignar un Xpath

Para mostrar cmo utilizar el elemento de asignacin considere el proceso de Solicitud de Compras. Cuando el usuario final ha ingresado los productos de la solicitud, incluyendo cantidades y precios unitarios, se puede realizar el clculo y guardar el precio total de cada producto en el atributo To talP rice (p recio u n itario p o r can tid ad ). Luego se puede calcular el precio total de toda la compra y guardarlo en el atributo To talCo stEstim ate.

Copyright 2013 - Bizagi

989

Vamos a utilizar un elemento de Asignacin para realizar el clculo del precio y su asignacin. Incluya una accin Al guardar en la primera Actividad del proceso. Cuando un usuario de clic en el botn Guardar en el Portal de Trabajo, se realizar el clculo. Incluya un elemento de asignacin y nmbrelo cmo To talCo stEstim ate.

990

Copyright 2013 - Bizagi

De clic en el botn para incluir una asignacin. Para asignar el valor de la variable en el lado izquierdo, seleccione el atributo relevante del modelo del dato. Clic de la lista desplegable seleccione el atributo.

Copyright 2013 - Bizagi

991

Navegue el modelo de datos hasta que se alcance el atributo deseado, en este caso To tal Co st Estim ate. Clic en Ok .

992

Copyright 2013 - Bizagi

Note que el atributo ha sido ubicado en el campo de la variable en el lado derecho izquierdo de la sentencia de asignacin. Para asignar el valor en el lado derecho de la declaracin de asignacin, seleccione el dato que se va asignar. Vamos a seleccionar una expresin XPath, debido a que el clculo es la suma del precio total de todos los productos. Note que es posible ver la expresin XPath al final de la ventana a medida que se construye. Clic en Ok cuando la expresin XPath este completa.

Copyright 2013 - Bizagi

993

Usted puede agregar tantas asignaciones como necesite. Si desea remover una asignacin asociada a un elemento de clic en el botn Elim in ar.

994

Copyright 2013 - Bizagi

Ejemplo: Asignar un valor a una Entidad.

En la siguiente imagen se tiene el proceso de Mesa de Ayuda, el cual maneja los reportes de incidentes (o tickets) en orden de minimizar las interrupciones en los servicios tecnolgicos de la empresa. De acuerdo a cmo el reporte evolucione en el proceso, su estado cambiar. Existe una relacin de entidad entre la entidad de Proceso llamada Ticket y la entidad paramtrica llamada Estado. Los valores se muestran a continuacin.

Copyright 2013 - Bizagi

995

Vamos a utilizar un elemento de asignacin para cambiar el estado del ticket. En el momento que la Mesa de ayuda reciba el reporte o ticket, su estado ser A b ierto . Incluya un elemento de Asignacin y seleccione el XPath a ser asignado: Ticket.Status. Luego seleccione la opcin Entidad.

996

Copyright 2013 - Bizagi

Una nueva ventana mostrar las entidades maestras y paramtricas del proyecto.

En este caso vamos a seleccionar la entidad paramtrica H elp Desk Case Statu s y su atributo C d ig o . Si el identificar de cada registro de la entidad se conoce (el id), est ser seleccionado con la opcin de Validacin Simpe. La validacin Compleja (cuando no esta directamente asociado), permite utilizar filtros dentro de la

Copyright 2013 - Bizagi

997

entidad y devolver un valor que complemente la condicin. En este caso la entidad Estado tiene el atributo Cdigo, el cual da un cdigo para cada registro de la entidad. El cdigo del estado deseado se conoce, por lo que es posible construir la condicin como se muestra a continuacin. Clic en Ok. .

La asignacin ha sido finalizada. Clic en Ok para guardar la regla.

Nota Le recomendamos siempre utilizar el atributo cdigo en las entidades paramtricas para que pueda identificar y manejar fcilmente sus valores, en vez de utilizar los Id ya que estos pueden cambiar cuando se realizan deployments o cambios en produccin.

998

Copyright 2013 - Bizagi

3.5.4.4

Elementos Boolean, While y If

Informacin General
Los elementos Booleano, While e If estn destinados a realizar diferentes tareas, sin embargo comparten una interfaz de usuario similar ya que todos estos elementos evalan una condicin donde se debe realizar una accin dependiendo del resultado de la evaluacin. La condicin es ingresa en la ventana de expresin, se deben ingresar tres datos: Para asignar una variable al lado izquierdo del condicional, seleccione el atributo del modelo de dato, escriba una expresin o seleccione un valor del vocabulario existente. Luego de seleccionar el elemento a evaluar, ingrese el operador que se va a utilizar. Dependiendo del tipo del atributo a ser evaluado, el sistema le mostrar una lista de operadores:

ATRIBUTO

OPERADOR

Numrico (entero), moneda y fechas (aplica para Igual a, Diferente de, Menor que, Menor o igual relaciones de entidad) que, Mayor que, Mayor o igual que, es vaco, est lleno. Texto Igual a, Diferente de, Es vaco, Est lleno, Contiene, No contiene, Empieza con, No empieza con. Igual a, Diferente de, Es blanco, Est lleno, Es verdadero, Es falso.

Booleano

En el lado derecho del condicional, ingrese el valor contra el cual se va a hacer la comparacin. Si la seleccin necesita otro argumento, se debe incluir una nueva lnea para incluir la nueva expresin. Es posible combinar varias condiciones. Si necesita otra condicin de clic en el botn Y, este botn permite incluir la condicin utilizando el operador lgico Y O.

Elemento Booleano
El elemento regresa Verdadero o Falso de acuerdo a la condicin necesitada. La siguiente imagen muestra una expresin Booleana que retorna verdadero si el estado de la Solicitud es 3 (cdigo=3), de lo contrario retorna falso.

Copyright 2013 - Bizagi

999

Elemento While
Este elemento ejecuta un ciclo mientras que una condicin sea verdadera. Asegrese que la condicin que se evala tome el valor de FALSO en algn punto, si no puede generar un ciclo sin fin. En el proceso de Solicitud de Compras, luego de que la solicitud ha sido aprobada, es necesario incluir un cierto nmero de cotizaciones. Este nmero ha sido definido anteriormente. Vamos a utilizar una regla para crear los registros de las cotizaciones automticamente, de forma que el usuario final solamente necesite incluir la informacin de la cotizacin sin tener que preocuparse sobre cuantas cotizaciones debe ingresar. Utilizando el elemento While vamos a incluir los registros hasta que el nmero se haya alcanzado. 1. Cree una expresin Al Salir en la actividad de aprobacin. 2. Cree una variable para guardar el nmero de registros que han sido incluidos.

1000

Copyright 2013 - Bizagi

3. Cree el elemento While. La condicin ser la siguiente: mientras que el nmero de cotizaciones requeridas sea menor al nmero de cotizaciones incluidas, incluya un nuevo registro:

4. Cree un elemento de expresin para incluir los elementos de la coleccin. Adicionalmente, aumente

Copyright 2013 - Bizagi

1001

en UNO la variable que contrala el nmero de registros incluidos. Cuando el nmero alcance el nmero de cotizaciones requeridas, el ciclo terminar y la regla finalizar (para aumentar la variable en UNO puede escribir ++ al frente del atributo).

Elemento If
Ofrece la posibilidad de seleccionar un camino de varios disponibles dependiendo de una condicin. El camino Si no (else) siempre se debe establecer. Imagine que trabaja en una compaa de seguros de Vehculos. Como subscriptor de plizas de la compaa, debe analizar las polticas, y de acuerdo al anlisis de riesgo establecer, si el vehculo puede ser cubierto o no. Basndose en la decisin, el estado del vehculo debe ser actualizado a Rechazado o Autorizado por Riesgo. El siguiente es el modelo de datos del ejemplo:

1002

Copyright 2013 - Bizagi

1. Cree una regla al Salir de la actividad donde se evala el riesgo. 2. Incluya un elemento If y seleccione la condicin. En este caso seleccione el camino donde el atributo Aprobar riesgo es igual a verdadero.

Copyright 2013 - Bizagi

1003

3. Adicione un elemento de asignacin para fijar el estado del vehculo. Note que esto se realiza utilizando la opcin de entidad, el cdigo se fija utilizando el cdigo definido en la entidad paramtrica. El la opcin Sino el estado de la solicitud debe ser Rechazado por riesgo, cdigo=5.

1004

Copyright 2013 - Bizagi

3.5.4.5

Elemento Funcin

Informacin General
Este elemento permite el uso de funciones creadas como libreras de reglas para cada proyecto. Libreras de reglas y Funciones estn muy relacionadas: Las libreras de reglas reciben ciertos parmetros y retornar una respuesta. Las funciones proveen los parmetros y guardan el resultado para poder utilizarlo dentro de una regla. En el elemento Funciones, podr encontrar una lista de funciones de Bizagi, funciones generales y Mis funciones. Los primeros dos grupos estn incluidos dentro del Elem en to Ex p resi n , por lo que recomendamos su uso desde all. M is fu n cio n es muestra una lista de todas las reglas de la librera que han sido creadas para su proyecto. Cuando da clic en Funciones podr incluir el valor de los parmetros en la parte superior de la ventana al lado derecho y guardar el resultado en una variable del lado inferior del lado derecho de la pantalla.

Copyright 2013 - Bizagi

1005

Qu se debe hacer en Bizagi?

1. Cree una regla: Cree el cdigo, seleccione los parmetros de entrada y configure el valor que retorna la funcin. 2. Cree la regla donde se va a llamar la funcin, incluya un elemento funcin. 3. En el elemento funcin configure los parmetros de salida y el resultado. 4. Utilice el resultado retornado en un elemento de la expresin.

Ejemplo
Hemos creado una funcin que recibe dos fechas y retorna la diferencia de aos. Vamos a utilizar una regla de la librera para guardar la fecha de nacimiento del cliente. 1. Cree una regla en la librera en el elemento Funciones en la opcin Reglas de Negocio (Reglas Globales). Hay dos parmetros asignados: Me (siempre se incluye para especificar el contexto) y la

1006

Copyright 2013 - Bizagi

fecha para realizar el clculo. Incluya el valor de retorno como ultima lnea del cdigo.

2. Cree una regla Al Salir de la actividad donde el cliente ingresa la fecha de nacimiento. Declare la variable que guarda el resultado de la funcin y cree el elemento funcin.

Copyright 2013 - Bizagi

1007

3. Expanda la opcin Mis funciones y seleccione la funcin creada en el paso 1, Get_YearDifference. Tambin debe asignar el valor de retorno a la variable creada en el paso 2. En este ejemplo, la regla creada se encuentra en la carpeta Solicitud de Crdito, estas reglas pertenecen a una familia de reglas creadas anteriormente para ayudar a organizar la librera de reglas.

1008

Copyright 2013 - Bizagi

4. Finalmente utilice el resultado de la variable para asignar la edad del cliente en el modelo de datos.

Copyright 2013 - Bizagi

1009

3.5.4.6

Elemento Web service

Informacin General
Preferiblemente un servicio Web debe ser modelado como un Tarea de Servicio y con las opciones bsicas del asistente de Interfaz. En algunos casos excepcionales, cuando esto no es posible, Bizagi le permitir el uso del elemento Servicio Web para incluir el llamado de un servicio web dentro de una regla. 1. Un caso excepcional puede presentarse cuando desea manipular la respuesta que retorna la invocacin del servicio externo antes de actualizar la informacin dentro del modelo de datos del proceso: por ejemplo, utilice el servicio UDDI para configurar la invocacin del servicio Web. En esta situacin usted puede invocar el servicio Web SOAP desde cualquier regla de negocio y optar por incluir cdigo script para preparar la solicitud y la respuesta. 2. Otro ejemplo de un caso excepcional es cuando necesita llamar un servicio Web durante la iteracin de una coleccin o una condicin. El asistente de la Interfaz no cubre este escenario por lo que es necesario construir la regla con el ciclo e incluir dentro de l el servicio Web (Iterate over XPath o For). 3. El asistente del wizard que sea abre desde un botn en la forma de la actividad. Para llamar un servicio web desde una regla de negocio debe incluir el elemento Servicio Web y configure la invocacin.

1010

Copyright 2013 - Bizagi

Ejemplo
En el siguiente ejemplo, un servicio web tiene un mtodo que recibe y retorna tipos de datos simples (por ejemplo enteros, strings, Booleanos, etc.): Vamos a utilizar el proceso de Solicitud de Vacaciones. Este proceso invoca el servicio web SOAP al principio del proceso para verificar (consultar) el nmero de das de vacaciones disponibles del empleado que hace la solicitud.

Copyright 2013 - Bizagi

1011

El servicio web retornar un nmero para esta solicitud (entero). Mientras se invoca la regla de negocio, es posible manipular la respuesta antes de actualizar el modelo de datos. Siga los siguientes pasos para realizar la configuracin del ejemplo: 1. Cree una nueva regla de negocio para invocar el Servicio Web. En el paso cuatro del asistente, Reg las d e n eg o cio , seleccione la opcin A ccio n es d e la activ id ad (Ev en to s).

2. Clic en la actividad donde se va ha incluir la expresin. Cree o modifique la regla. Luego de definir el Nombre, Nombre Visual y la Descripcin, cree una variable para la invocacin (guarda la respuesta del servicio) dando clic derecho sobre el botn verde In icio y seleccionando la opcin Declaraci n d e v ariab les.

1012

Copyright 2013 - Bizagi

3. Clic en A d icio n ar para crear una nueva variable asgnele un nombre, seleccione entero, como tipo de variable (int) y de clic en ok. Es posible asignar un valor por defecto como valor inicial de la variable.

4. Clic derecho sobre la lnea vertical de la regla y seleccione Adicionar Servicio Web.

Copyright 2013 - Bizagi

1013

5.Clic derecho sobre el elemento Servicio web, luego seleccione la opcin Propiedades: Esto lanzar un asistente que lo guiar a travs de la configuracin de la invocacin del Servicio web.

1014

Copyright 2013 - Bizagi

6. Ingrese el URL de la ubicacin del servicio Web. El primer paso en el asistente es ubicar el servicio Web. En nuestro ejemplo vamos a ingresar: http://www.bizagi.com/ESB/ESBServices.asmx

Usted puede utilizar UDDI para la resolucin de la ubicacin.

Copyright 2013 - Bizagi

1015

Clic en Sig u ien te. 7. Seleccione el mtodo Web de los mtodos proporcionados por el servicio Web. Clic en Sig u ien te.

8. Defina los valores de los parmetros de entrada. Note que Bizagi, de forma automtica, detecta si el mtodo escogido espera parmetros de entrada y tambin el tipo de estos datos. En la siguiente ventana, seleccione el parmetro para definir su valor y de clic en el botn establecer v alo res.

En el ejemplo, el mtodo recibe como parmetro de entregada un nico parmetro de tipo string.

1016

Copyright 2013 - Bizagi

Usted puede incluir el valor para el parmetro o puede escoger una variable antes creada. En el ejemplo se va a utilizar una expresin XPath para asignar el valor, dado que se necesita el solicitante de la solicitud (la informacin del caso puede ser encontrada de forma directa).

Clic en O k y luego en Sig u ien te.

9. Seleccione la variable en la cual se va a guarda el resultado de la respuesta. En el ejemplo, la variable se llama tem p Resp o n se, la cual fue creada en el paso 3.

Clic en Sig u ien te para terminar la configuracin. 10. Incluya cualquier manipulacin adicional del resultado.

Copyright 2013 - Bizagi

1017

Vamos a continuar modificando la regla, lo cual indica que cualquier otra manipulacin se realiza directamente sobre la variable tem p Resp o n se la cual est guardando el resultado del servicio web. Por ejemplo, podemos optar por incluir un elemento de expresin interno para sumar, restar o redondear la informacin.

Doble clic sobre la expresin para realizar cambios.

1018

Copyright 2013 - Bizagi

11. Finalmente asigne la informacin calculada al modelo de datos. Para realizar esto, vamos a incluir un elemento de asignacin.

Copyright 2013 - Bizagi

1019

Clic derecho sobre el elemento Asignacin y seleccione la opcin P ro p ied ad es.

1020

Copyright 2013 - Bizagi

12. Asigne la variable a un atributo del modelo de datos. En el ejemplo, vamos a asignar Tem p Resp o n se al atributo Day sA v ailab le: del modelo de datos.

Copyright 2013 - Bizagi

1021

Note que el atributo pertenece a la entidad Vacatio n Req u est. Para asignar tem p Resp o n se seleccionamos la opcin Ex p resi n y escribimos directamente el nombre de las variables.

Clic en Ok para guardar la regla de negocio. 3.5.4.7 Elemento For

Informacin general

1022

Copyright 2013 - Bizagi

El elemento For ofrece la posibilidad de incluir la lgica de un ciclo ejecutado un nmero de veces. El valor inicial de la variable se incremente en un nmero fijo cada iteracin. El ciclo se ejecuta hasta que una condicin de salida es cumplida. Es necesario incluir cuatro parmetros dentro del For. La in icializaci n d el ciclo indica la variable de control utilizada para regular el nmero de veces que el ciclo es ejecutado. El v alo r in icial d e la v ariab le d e co n tro l, est se fija con una constante. El valor inicial puede ser cualquier nmero que cumpla sus necesidades, por defecto es cero (0). El In crem en to /Decrem en to del ciclo, indica la cantidad es que la variable a incrementar//disminuir en cada iteracin. La variable se pude modificar en cualquier cantidad. La cantidad por defecto en uno (1). La co n d ici n d el ciclo es evaluada al final de cada iteracin. El ciclo contina iterando mientras la condicin sea verdadera. Si la condicin No se cumple (es falso), el ciclo termina y la regla contina con el siguiente elemento del diagrama de actividad.

Qu se debe hacer en Bizagi?

1. 2. 3. 4. 5. Cree una expresin de Script. Declare una variable para guardar los elementos de la coleccin. Cree un elemento For e incluya la lgica del ciclo. Defina las operaciones o clculos que se deben realizar dentro del ciclo. Guarde la regla.

Copyright 2013 - Bizagi

1023

Ejemplo
Suponga que trabaja en un banco donde realiza el anlisis inicial del solicitante para verificar si era elegible para otorgarle los productos financieros solicitados. Si el solicitante pasa la primera evaluacin, el banco solicitar diferentes documentos al cliente como soporte de la informacin presentada. Existe una entidad paramtrica, Documentos del Solicitante, que contiene una lista de todos los documentos que el banco necesita solicitar de acuerdo a los productos solicitados. Por lo que es necesario examinar la lista y extraer solo los documentos que aplican para cada caso. Los documentos sern relacionados con la tabla del Caso. El siguiente es el Modelo de Datos del ejemplo, las tablas paramtricas se muestran en color verde y las maestras en azul.

1. Cree una regla Al Entrar de la actividad donde se mostrar la lista de documentos. 2. Declare las variables que se van a utilizar. FilterDocsXApplicant (object): El filtro para encontrar los documentos dentro de tabla paramtrica que aplican al caso. DocsXApplicant (object): La variable de iteracin que guarda los documentos seleccionados de la tabla paramtrica. Esta variable ser filtrada utilizando FilterDocsXApplicant. Count (int): La variable contador. Est comienza en cero e incrementa en uno en cada iteracin. IdDocument (int): Variable que guarda el identificador nico del documento. El identificador es el punto de acceso al registro actual en la coleccin DocsXApplicant. ApplicantDocument (object): La variable resultado que guarda los documentos seleccionados que posteriormente se adicionaran uno a uno en la coleccin del caso.

1024

Copyright 2013 - Bizagi

3. Adicione un elemento de expresin para obtener los registros de la entidad paramtrica Documentos por solicitante que apliquen para el caso.

4. Incluya el elemento For. Seleccione la variable contador e inicie en cero, esto indicar el punto de inicio para guardar el primer registro. Es decir, el ciclo empieza en el primer registro de la variable Do csx A p p lican t La variable se incrementar en uno para incluir cada registro de Do csXA p p lican t en A p p lican tDo cu m en t. Cree una condicin: el ciclo se ejecutar hasta que la variable Do csXA p p lican t tenga registros a incluir

Copyright 2013 - Bizagi

1025

dentro de la coleccin. Count < DocsXApplicant.Length

5. Agregue un elemento de asignacin para incluir los registros a la coleccin de documentos. // Guarda el identificador del documento del registro actual de la coleccin DocsXApplicant (variable de iteracin). IdDocument = DocsXApplicant[Count].Attributes["idDocument"].Value; // Agrega un elemento (nuevo registro) en la entidad Documentos del aplicante (relacin uno a muchos) ApplicantDocument = Me.addRelation("idApplicant.Documents"); //Asigna el identificador del documento al nuevo registro. ApplicantDocument.setXPath("idDocument",IdDocument); //Asigna el atributo requerido (Verdadero o Falso) del nuevo registros ApplicantDocument.setXPath("Required",DocsXApplicant[Count].Attributes ["Required"].Value);

1026

Copyright 2013 - Bizagi

Note que la variable ApplicantDocument se utiliza para copiar los valores desde la entidad paramtrica Do cu m en t p er A p p lican t a la entidad A p p lican t Do cu m en t. La expresin agrega cada registro de manera individual, iterando la entidad paramtrica. Variable.setXPath("atributo en la coleccin", valor a setear); 3.5.4.8 Elemento Iterate over Fact

Informacin general
Iterate over Fact permite realizar iteraciones (o ciclos) sobre una expresin XPath que tiene una coleccin, es decir, una relacin uno-a-muchos SOLAMENTE cuando la relacin no puede ser accedida directamente a travs del modelo de datos utilizando un XPath. Es posible acceder a cada registro de la coleccin de forma individual para llevar a cabo operaciones, por ejemplo modificar sus valores, tomar los valores para realizar clculo, validaciones, etc. La coleccin que se recorre puede ser filtrada para solo tener acceso a registros especficos.

Qu se debe hacer en Bizagi?

Copyright 2013 - Bizagi

1027

1. Cree una expresin de script. 2. Declare las siguientes variables: - Una variable para guardar la coleccin - Una variable para guardar cada registro individualmente a medida que se recorre la coleccin. - Una variable contador para controlar el ciclo. 3. Utilizando un elemento de expresin asigne la coleccin deseada a la primera variable. 4. Incluya el elemento Iterate over Fact: Defina una entidad, la relacin (es la relacin entre la entidad y la relacin de los muchos) y la llave (es el identificador que toma el registro de la entidad para identificar los registros de la coleccin). 5. Dentro del ciclo de la iteracin incluya un elemento de expresin para realizar los clculos. 6. Guarde la regla.

Ejemplo
Imagine un colegio que est organizado todas las actividades del inicio del nuevo ao escolar. Bizagi permite al departamento administrativo incluir como entidades paramtricas la informacin para el nuevo ao, por ejemplo lista de tiles escolares, los curso que tiene el colegio, los profesores con sus respectivas materias y cursos que dictan, etc. El siguiente es el modelo de datos del proceso. Note que cada profesor es creado en la entidad WFUser. Se asume que cada profesor solamente dicta una materia pero puede dictar en varios cursos.

El objetivo principal del proceso Regresar al Colegio es tener a la mano toda la informacin necesaria de un curso de modo que pueda ser entregada fcilmente a los padres y estudiantes. El proceso tiene dos actividades: una para ingresar la informacin del curso y otra para mostrar e imprimir la informacin. Vamos a utilizar el elemento Iterate over Fact para recorrer los profesores y asignarlos a un curso determinado. Recuerde que esta informacin est guardada en la entidad del sistema WFUser., por lo

1028

Copyright 2013 - Bizagi

cual no se tiene un XPath especfico al comienzo del caso para conocer cuales profesores deben ser asignados. La informacin debe ser buscada y almacenada en el modelo de datos del caso.

1. Cree una regla Al Entrar de la actividad donde se muestra la informacin. 2. Declare las siguientes variables: Grade: El curso solicitado. AddTeacher: Variable para incluir cada profesor al XPath del caso. Teachers: Variable que guarda la informacin de todos los profesores en la WFUser. Counter: Variable para controlar el ciclo. TeachersLength: El tamao de la coleccin Teachers. IdUser: variable para guardar la llave de acceso a la WFUser. GradesToIterate: Variable que accede a cada registro individualmente.

3. Utilizando un elemento de expresin para recuperar la coleccin y almacenarlo en la variable de

Copyright 2013 - Bizagi

1029

coleccin Teachers. Guarde el tamao de la coleccin y el grado en las variables respectivas.

//Elimine todos los elementos de la coleccin para iniciar de cero. Me.removeRelation("Backtoschool.Teachers",true); //Guarde los profesores encontrados de la WFUser en la variable Teachers. Teachers = CEntityManager.GetEntity("WFUser").GetEntityList ("","","IsTeacher=true",""); //Guarde el tamao de la coleccin Teachers en la variable TeachersLength TeachersLength = Teachers.Length //Guarde el curso del caso en una variable. Grade=<Backtoschool.Grade.Id>; 4. Agregue un elemento For para recorrer la entidad WFUser y obtener el idUser (llave) que ser utilizado en el elemento Iterate over Fact.

1030

Copyright 2013 - Bizagi

5. En el elemento For se obtiene el idUser.

Copyright 2013 - Bizagi

1031

6. Defina los siguientes elementos en el elemento Iterate over Fact. - La variable para la iteracin: Grad esTo Iterate - La entidad : W F u ser - La relacin : Grades - La llave: id User (es el identificador que toma el registro de la entidad para identificar los registros de la coleccin)

1032

Copyright 2013 - Bizagi

5. Incluya en el ciclo un elemento de expresin para realizar algunos clculos.

Copyright 2013 - Bizagi

1033

//Compare el curso de cada profesor con el curso del caso. var idGrade = GradesToIterate.SurrogateKeyValue; if(idGrade==Grade) { //Agregue un nuevo elemento (registro) a la coleccin BacktoschoolTeacher collection. (relacin uno a muchos). AddTeacher = Me.addRelation("Backtoschool.Teachers"); //Asigne el valor del Id de la WFuser al nuevo registro. AddTeacher.setXPath("Teacher",idUser); } En la regla se compara el curso de cada profesor con el curso del caso. Si el curso coincide, el profesor dicta en el curso seleccionado por lo que se debe agregar a la coleccin del caso Teachers. 6. Guarde la regla.

3.5.5

Ejemplos de reglas de negocio

Mostrar validaciones al usuario final Definir la duracin de tareas y temporizadores Adicionar y remover elementos de una relacin Acceder al isimo registro de una coleccin

1034

Copyright 2013 - Bizagi

Realizar operaciones con fechas Realizar operaciones con cadenas de texto Obtener y utilizar informacin del usuario actual Obtener y utilizar informacin del caso actual Obtener y utilizar valores de un vocabulario Obtener y utilizar valores de una entidad Obtener usuarios basados en componentes de la organizacin Definir y utilizar secuencias Ejecutar Eventos 3.5.5.1 Mostrar validaciones al usuario final

Informacin general
Las validaciones son mensajes de error personalizados que se muestran en el portal de Trabajo para informar al usuario final que falta alguna informacin o que un error ha ocurrido en una actividad. Los mensajes de validacin generalmente se definen en las acciones Al Salir o en una validacin de tabla. Si no se cumple una validacin luego de dar clic en Siguiente en la actividad, el proceso quedar detenido y se mostrar el mensaje de error. Si no se cumple una validacin al momento de guardar un nuevo registro de una tabla, el registro no se guardar y se mostrar un mensaje de error. Las validaciones se configuran utilizando la funcin Th ro w Valid atio n Erro r. La sintaxis de la funcin es la siguiente:

CHelper.ThrowValidationError("sMessage")
El parmetro de la funcin es el mensaje de error que se muestra cuando se lanza la validacin. La funcin Th ro w Valid atio n Erro r se encuentra en la categora Valid aci n d e d ata.

Copyright 2013 - Bizagi

1035

Ejemplo
En el proceso de Solicitud de viajes es necesario verificar que la fecha de regreso sea mayor a la fecha de salida, esto para poder calcular el nmero de das de la solicitud. Si las fechas no cumplen esta condicin se debe mostrar un mensaje al usuario final informado del error. Para mostrar el mensaje de validacin utilice la funcin Th ro w Valid atio n Erro r. 1. En el cuarto paso del Asistente seleccione la opcin Acciones de la actividad. Luego agregue una expresin Al Salir de la tarea Registrar solicitud de viajes.

2. En un elemento de expresin compra le fecha de salida con la fecha de regreso. 3. Escriba el mensaje de error en la funcin Th ro w Valid atio n Erro r, La fecha de regreso debe ser mayor que la fecha de salida.

1036

Copyright 2013 - Bizagi

if (<VacationRequest.LeavingDate>>=<VacationsRequest.ReturningDate>) { CHelper.ThrowValidationError("Returning Date cannot be less than the Leaving Date"); } 4. Clic en Ok para guardar la regla. 5. En el Portal de Trabajo, ingrese una fecha de regreso menor que la fecha de salida. El mensaje de error ser mostrado.

3.5.5.2

Validacin de Datos

Validar si un atributo o variable esta vaco

Usted puede validar si un atributo o variable esta vaco utilizando la funcin CH elp er.IsEm p ty . Esta funcin devuelve Verdadero si el objeto especificado como parmetro ( Variab le) esta vaco; de lo

Copyright 2013 - Bizagi

1037

contrario devuelve Falso. La sintaxis de la funcin es:

CHelper.IsEmpty(Variable) ;
En un Proceso de Solicitud de Compra, si una solicitud es rechazada se enva una notificacin al solicitante. El mensaje incluido en la notificacin depende de los comentarios de rechazo. Si no se ingresan comentarios de rechazo, se asume que la solicitud fue aprobada. De otra manera la solicitud fue rechazada y los comentarios de rechazo se incluyen en el mensaje. Para validar si se han ingresado comentarios de rechazo usted puede utilizar la funcin CH elp er.IsEm p ty. Cree una expresin como una accin a la entrada de la actividad A u to rizar Co m p ra.

Utilice la funcin CH elp er.IsEm p ty para evaluar si se ingresaron comentarios de rechazo. Defina el mensaje a enviar de acuerdo al resultado de la evaluacin anterior.

if CHelper.IsEmpty(<PurchaseRequest.RejectionComments>) { <PurchaseRequest.Message>="Your request has been approved" } else { <PurchaseRequest.Message>="Your request has been rejected. The reasons are:" + <PurchaseRequest.RejectionComments>; }

Validar si un atributo o variable es nulo

1038

Copyright 2013 - Bizagi

Usted puede validar si un atributo o variable es nula utilizando la funcin CH elp er.IsN u ll. Esta funcin devuelve Verdadero si el objeto especificado como parmetro ( Variab le) es nulo; de lo contrario devuelve Falso. La sintaxis de la funcin es:

CHelper.IsNull(Variable) ;
En un Proceso de Solicitud de Compra, si una solicitud es rechazada se enva una notificacin al solicitante. El mensaje incluido en la notificacin depende de los comentarios de rechazo. Si no se ingresan comentarios de rechazo, se asume que la solicitud fue aprobada. De otra manera la solicitud fue rechazada y los comentarios de rechazo se incluyen en el mensaje. Para validar si se han ingresado comentarios de rechazo usted puede utilizar la funcin CH elp er.IsN u ll.

Cree una expresin como una accin a la entrada de la actividad A u to rizar Co m p ra.

Utilice la funcin CH elp er.IsN u llpara evaluar si se ingresaron comentarios de rechazo. Defina el mensaje a enviar de acuerdo al resultado de la evaluacin anterior.

Copyright 2013 - Bizagi

1039

//Evaluate if rejection comments were entered if CHelper.IsNull(<PurchaseRequest.RejectionComments>) { <PurchaseRequest.Message>="Your request has been approved" } else { <PurchaseRequest.Message>="Your request has been rejected. The reasons are:" + <PurchaseRequest.RejectionComments>; } Note: DO NOT USE the following statements: < id Req u est.Valu eTo Co m p are> = = n u ll < id Req u est.Valu eTo Co m p are> != n u ll You can also use the B A IsB lan k function: BAIsBlank(<Request.ValueToCompare>)

or

3.5.5.3

Definir la duracin de tareas y temporizadores La duracin de las tareas se utiliza para calcular los indicadores de eficiencia y para definir el estado de las actividades pendientes en el Portal de Trabajo. La duracin puede se esttica, definida en las propiedades del proceso en el Modelador, o puede ser dinmica, evaluada por una expresin en la tarea. IMPORTANTE: La duracin dinmica se debe definir en minutos o en una fecha especfica. La duracin DEBE ser configurada en las acciones Al Entrar para que pueda ser considerada. Si la duracin no se configura AL Entrar, Bizagi tomar el valor definido en las propiedades de la actividad.

Definir la duracin Con un tiempo

Suponga que su compaa tiene un Proceso de Solicitud de viajes donde el Departamento Administrativo registra las reservas del viaje a su nombre. Es posible solicitar un vuelo nacional o internacional, dependiendo del destino el administrador tendr dos o tres das para reservar el vuelo y el hotel. 1040 Copyright 2013 - Bizagi

Ya que la duracin de la tarea no es fija, necesitamos una expresin para definir este tiempo. Los destinos Nacionales e Internacionales son guardados en una entidad paramtrica, cada registro tiene un cdigo. 1 para nacional y 2 para internacional.

1. En el cuarto paso del Asistente seleccione la opcin Acciones de la actividad. Luego agregue una expresin Al Entrar de la tarea donde se debe cambiar la duracin.

2. Cree una expresin para asignar la duracin. Le recomendamos utilizar un vocabulario para guardar el tiempo de las tareas como constantes, de esta forma, si se necesita modificar el valor se puede realizar fcilmente en el Portal de Trabajo. Para utilizar un vocabulario, este debe ser creado con anticipacin (antes de crear la expresin). Vamos a utilizar dos vocabularios. De ser necesario, estos pueden ser modificados en cualquier

Copyright 2013 - Bizagi

1041

momento por los usuarios finales en el Portal de Trabajo.

3. Determine si la solicitud es nacional o internacional Asigne la duracin del elemento utilizando el vocabulario. Utilice la funcin Case Du ratio n categora F ech as y Tiem p o s. de la

1042

Copyright 2013 - Bizagi

La siguiente imagen muestra el cdigo de la expresin.

//Identificar si el destino es nacional

Copyright 2013 - Bizagi

1043

if (<TravelRequest.Destination.Code> == '1') { //Asignar la duracin para viajes nacionales Me.Duration = CHelper.resolveVocabulary("NationalBookingDuration"); } else { //Si no es nacional, se asigna la duracin de viajes internacionales Me.Duration = CHelper.resolveVocabulary ("InternationalBookingDurati"); }

Definir la duracin Con una fecha determinada

Suponga que su compaa tiene un Proceso de Solicitud de viajes donde el Departamento Administrativo registra las reservas del viaje a su nombre. Es posible solicitar un vuelo nacional o internacional, dependiendo del destino el administrador tendr cierto tiempo para realizar la reserva del vuelo y del hotel.

1. En el cuarto paso del Asistente seleccione la opcin Acciones de la actividad. Luego agregue una expresin Al Entrar de la tarea donde se debe cambiar la duracin.

1044

Copyright 2013 - Bizagi

2. Declare las variables necesarias: En el ejemplo necesitamos dos variables de tipo d ate tim e. LeavingDate: Guarda el atributo Fecha de salida. FixedDate: Guarda la fecha lmite derivada, se utilizar para definir la duracin de la tarea.

3. Cree una expresin para asignar la duracin. Lo primero que debemos hacer es guardar la fecha de salida navegando a travs del Modelo de Datos. El valor se guardar en la variable que hemos declarado anteriormente.

Copyright 2013 - Bizagi

1045

La duracin de la tarea ser definida cmo un da antes de la fecha de salida. Para calcular la fecha, se debe restar un da de la fecha guardada en la variable. Luego se debe guardar el resultado en la variable F ix ed Date.

4. Para definir la duracin de la tarea vamos a utilizar la funcin Case estim ated so lu tio n d ate la cual se encuentra en la categora F ech as y Tiem p o s.

1046

Copyright 2013 - Bizagi

La siguiente imagen muestra el cdigo de la expresin.

//Guardar el valor del atributo en la variable de tipo date time. LeavingDate=<TravelRequest.LeavingDate>; //Calcular la fecha lmite y guardarla en la variable de tipo date time. FixedDate=LeavingDate.AddDays(-1); //Asignar la duracin de acurdo al clculo anterior. Me.EstimatedSolutionDate=FixedDate;

Copyright 2013 - Bizagi

1047

Asignar duracin de los temporizadores

En el Proceso de solicitud de viajes suponga que una vez el tiempo destinado para realizar la reserva del vuelo a expirado (un da antes del viajes), el jefe del encargado de hacer la reserva debe buscar ofertas de vuelos a ultima hora. Es posible utilizar una compuerta basada en Eventos para evaluar si la tarea Reservar se realiz antes de la fecha lmite. Si la fecha lmite se alcanza antes, la tarea reservar ser deshabilitada y la tarea Realizar tareas de ltima hora ser habilitada para el jefe.

Para configurar la duracin del temporizador siga los siguientes pasos: 1. En el cuarto paso del Asistente seleccione la opcin Acciones de la actividad. Luego agregue una expresin Al Entrar del evento donde se va a fijar la duracin.

1048

Copyright 2013 - Bizagi

2. Declare las variables necesarias: LeavingDate: Guarda el atributo Fecha de salida. FixedDate: Guarda la fecha lmite derivada, se utilizar para definir la duracin de la tarea.

3. Cree una expresin para asignar la duracin. Lo primero que debemos hacer es guardar la fecha de salida navegando a travs del Modelo de Datos. El valor se guardar en la variable que hemos declarado anteriormente.

Copyright 2013 - Bizagi

1049

La duracin del temporizador ser asignado como un da antes de la fecha de salida. Para obtener esta fecha, restamos un da de la fecha guardada en la variable Leav in g Date. Luego se debe guardar el resultado en la variable F ix ed Date.

4. Para definir la duracin del temporizador vamos a utilizar la funcin Case estim ated so lu tio n d ate la cual se encuentra en la categora F ech as y Tiem p o s.

1050

Copyright 2013 - Bizagi

La siguiente imagen muestra el cdigo de la expresin.

//Guardar el valor del atributo en la variable de tipo date time. LeavingDate=<TravelRequest.LeavingDate>; //Calcular la fecha lmite y guardarla en la variable de tipo date time. FixedDate=LeavingDate.AddDays(-1); //Asignar la duracin de acurdo al clculo anterior. Me.EstimatedSolutionDate=FixedDate;

Copyright 2013 - Bizagi

1051

Nota: La duracin de los temporizadores se definen de la misma forma que la duracin de las tareas. En ambos casos se utiliza la expresin M e.Du ratio n (x minutos) o M e.Estim ated So lu tio n Date (fecha determinada) dependiendo de las condiciones del negocio.

Definir la duracin de temporizadores adjuntos a una actividad

Suponga que su compaa tiene un Proceso de Solicitud de viajes, el administrador debe reservar un hotel y un vuelo durante los siguientes tres das de realizar la solicitud. Si la fecha lmite se alcanza, y las reservas no se han hecho, el jefe debe realizar algunas tareas de ltimo minuto. Esta situacin puede ser modelada utilizando un evento temporizador adjunto a la tarea reservar. Eventos adjuntos a los lmites de una actividad son utilizados para activar flujos de excepcin de acuerdo a condiciones del negocio. Cuando se utiliza un evento adjunto a la actividad, el flujo de excepcin se habilita cuando el tiempo o fecha definida se alcanza. En el ejemplo, si las reservas no se realizan antes de tres das, el flujo de excepcin se activa, y la tarea Realizar tareas de ltimo minuto es habilitada para el jefe. Es necesario definir la duracin del temporizador para modelar esta situacin de negocio.

Para configurar la duracin del temporizador siga los siguientes pasos:

1052

Copyright 2013 - Bizagi

1. En el cuarto paso del Asistente seleccione la opcin Acciones de la actividad. Luego agregue una expresin Al Entrar del evento donde se va a fijar la duracin.

2. Cree una expresin para asignar la duracin. Le recomendamos utilizar un vocabulario para guardar el tiempo de las tareas como constantes, de esta forma, si se necesita modificar el valor se puede realizar fcilmente en el Portal de Trabajo. Para utilizar un vocabulario, este debe ser creado con anticipacin (antes de crear la expresin). Una constante ha sido definida anteriormente para este caso ( B o o kin g Du ratio n ). Esta constante puede ser modificada en el Portal de Trabajo en cualquier momento.

Copyright 2013 - Bizagi

1053

3. Para definir la duracin utilice la funcin Tim er Ev en t Du ratio n .

Obtenga el valor del vocabulario constante utilizando la funcin Reso lv eVo cab u lary de la categora Miscelneo.

1054

Copyright 2013 - Bizagi

La siguiente imagen muestra el cdigo de la expresin.

//Definir la duracin en base a la definicin de la constante Me.TimerEventDuration= CHelper.resolveVocabulary(Me,"BookingDuration"); 3.5.5.4 Adicionar y remover elementos de una relacin

Incluir un nuevo registro en una coleccin

Para crear registros dentro de una coleccin utilizando una regla de negocio, se debe utilizar la funcin ad d Relatio n .

Copyright 2013 - Bizagi

1055

Visualice su coleccin como una tabla. Crear un nuevo registro se comprara a incluir una nueva fila a la tabla. Primero usted necesita crear una nueva fila y luego asignar los valores a cada columna. El nuevo registro (fila) se crea utilizando la funcin A d d reco rd de la categora N av eg aci n d e d ato s.

La siguiente es la sintaxis de la funcin:

Me.addRelation ("ProcessEntity.RelationshipToTheCollection")
Para manipular un nuevo registro (fila), este se debe asignar a una variable.

var Newrecord = Me.addRelation ("ProcessEntity.RelationshipToTheCollection")

Para asignar valores a una columna (campos) del nuevo registro es necesario aplicar la funcin setXPath a la variable creada. La funcin tiene la siguiente sintaxis.

Newrecord.setXPath ("Column",Value)
Los parmetros de la funcin son: La co lu m n a, el cual es el nombre del atributo de la coleccin y Valo r, el cual es la informacin que se va a asignar al atributo. Para ilustrar cmo agregar nuevos registros a la coleccin, suponga un proceso de Administracin de Proyectos donde las actividades que se deben realizar para completar el proyecto son planeadas y ejecutadas. Cada proyecto tiene varias actividades a realizar: Para incluir nuevas actividades al proyecto se tiene el evento Crear n u ev a activ id ad. En el evento se ingresa la informacin de la nueva tarea. Cuando se de clic en Siguiente, la informacin ingresada quedar incluida automticamente en la coleccin A ctiv id ad es. El sub proceso Realizar Actividades

1056

Copyright 2013 - Bizagi

ser ejecutado para cada registro de la coleccin A ctiv id ad es.

Siga los siguientes pasos: 1. En el cuarto paso del Asistente seleccione la opcin Acciones de la actividad. Luego agregue una expresin Al Salir del evento donde se agrega la nueva actividad

Copyright 2013 - Bizagi

1057

2. Declare una variable de tipo objeto.

3. Construya la expresin para incluir un nuevo elemento (nuevo registro) a la coleccin (relacin uno a muchos) y asigne los valores a la coleccin.

1058

Copyright 2013 - Bizagi

NewActivity=Me.addRelation("ProjectAdministration.Activities"); La anterior lnea crea una nueva fila de A ctiv id ad es. Luego de crear la fila, los valores de los atributos pueden ser asignados: NewActivity.setXPath("Description", <ProjectAdministration.NewActivityDescription>); NewActivity.setXPath("Responsible", <ProjectAdministration.NewActivityReponsible>); NewActivity.setXPath("DueDate",<ProjectAdministration.NewActivityDueDate;); La siguiente imagen muestra la representacin grafica de la representacin de la expresin.

Copyright 2013 - Bizagi

1059

Remover un elemento de una coleccin

Para eliminar un elemento de una coleccin se utiliza la funcin Rem o v e reco rd de la categora N av eg aci n d e d ato s.

La sintaxis de la funcin se muestra a continuacin.

Me.removeRelation ("ProcessEntity.RelationshipToTheCollection",del)
El ltimo parmetro de la funcin especifica si el elemento debe ser eliminado de la base de datos. Es posible que se desee dejar el registro para llegar a otra relacin o para mantener la historia. Usualmente no se guarda ninguna historia de la coleccin. A menos que el elemento se utilice en otra

1060

Copyright 2013 - Bizagi

relacin, usted podr borrar completamente el registro. Ingreso VERDADERO o FALSO en el ltimo parmetro: si selecciona Verdadero, el elemento ser eliminado de la relacin y de la base de datos, si selecciona falso, el registro se elimina de la relacin pero se conserva en la base de datos. Veamos un proceso de Administracin de proyectos para ilustrar cmo borrar un elemento de la coleccin. Suponga que tiene una tabla con las actividades del proyecto y quiere remover algunas actividades de acuerdo con algunas condiciones del negocio. Siga los siguientes pasos: 1. En el cuarto paso del Asistente seleccione la opcin Acciones de la actividad. Luego agregue una expresin Al Entrar a la actividad donde se quiere eliminar los registros.

2. Cree una expresin e ingrese el siguiente cdigo para remover la relacin:

Copyright 2013 - Bizagi

1061

Clic en Ok para guardar cambios. A continuacin encontrar diferentes formas para remover elementos dependiendo de los requerimientos del negocio.

Ejemplo Me.removeRelation(ProjectAdministration.Activities, true);

Resultado Elimina todos los elementos de la relacin y de la base de datos. Elimina todas las actividades que han sido completadas de la relacin y de la base de datos. Elimina todas las actividades que no han sido completas de la relacin, pero deja los registros en la base de datos. Esto permitir asociar las actividades borradas a otro proyecto.

Me.removeRelation(ProjectAdministration.Activities. [Completed=true], true);

Me.removeRelation(ProjectAdministration.Activities. [Completed=false], false);

1062

Copyright 2013 - Bizagi

3.5.5.5

Realizar operaciones con fechas Muchas situaciones de negocio necesitan comparar fechas y realizar clculos con ellas. Esta seccin presenta varios ejemplos de cmo realizar operaciones comunes entre fechas. Asignar hoy a un atributo de tipo fecha. Comparar fechas Restar fechas Agregar fechas Agregar fechas de acuerdo al esquema de trabajo Verificar si una fecha es un da de trabajo Verificar si una fecha es un da de trabajo para un usuario especfico Verificar si una hora es una hora de trabajo Calcular la edad Para ilustrar cmo funcionan las operaciones entre fechas lea el siguiente ejemplo: El administrador del proceso Solicitud de Vacaciones maneja las actividades necesarias para aprobar las vacaciones de un empleado. Cuando un empleado crea una solicitud, este debe ingresar la fecha de salida y la fecha de regreso. Utilizando estos valores, el sistema calcula el nmero de das solicitados. En el ejemplo vamos a utilizar operaciones entre fechas para: Asignar la fecha de hoy como fecha de la solicitud (atributo Req u estDate) Definir la duracin de las actividades Verificar que la fecha de regreso de vacaciones sea mayor a la fecha de salida, si no, se debe mostrar un mensaje de validacin. Calcular el nmero de das solicitados. El siguiente es el modelo de datos del proceso.

Asignar la fecha de hoy a un atributo

Para asignar la fecha de hoy al atributo Req u est Date, seleccione la opcin Acciones de la actividad del paso cuatro del asistente. De clic en la actividad donde desea agregar la expresin.

Copyright 2013 - Bizagi

1063

Incluya un elemento de expresin y seleccione el atributo sobre el cual se va a hacer la asignacin. Use la opcin Modelo de datos para navegar a travs del Modelo de datos.

Asigne la fecha de hoy ala atributo utilizando la funcin To d ay de la categora F ech as y tiem p o s.

1064

Copyright 2013 - Bizagi

La expresin debe lucir de la siguiente forma:

<VacationRequest.RequestDate>=DateTime.Today; Clic en Ok para guardar los cambios.

Comparar Fechas (aplica para la edicin .NET)

En este punto es necesario validar que la fecha de regreso de las vacaciones sea mayor a la fecha de

Copyright 2013 - Bizagi

1065

salida. Si no, se debe mostrar un mensaje al usuario final. Para hacer esto es necesario realizar una comparacin entre las fechas.

1. En el cuarto paso del Asistente seleccione la opcin Acciones de la actividad. Luego agregue una expresin Al Entrar a la actividad donde se quiere crear la expresin.

2. En el elemento de expresin, cree la comparacin utilizando los operadores menor que, mayor que o igual que (<,> o =).

3. Cree la condicin If para comparar los atributos.

1066

Copyright 2013 - Bizagi

Se debe mostrar un mensaje de error al usuario final cuando la fecha de regreso es menor que la fecha de salida. Use la funcin Th ro w v alid atio n erro r de la categora Valid aci n d e d ata.

Copyright 2013 - Bizagi

1067

La expresin debe lucir de la siguiente forma:

// Si la fecha de salida es mayor o igual a la fecha de regreso muestre el mensaje de error.

1068

Copyright 2013 - Bizagi

if (<VacationRequest.LeavingDate>>=<VacationsRequest.ReturningDate>) { CHelper.ThrowValidationError("Returning Date cannot be less than the Leaving Date"); } 4. Guarde la regla dando clic en Ok. Ahora puede probar la regla, si ingresa una fecha de regreso menor que la fecha de salida se muestra el siguiente mensaje:

Verificar si la fecha es un da laboral

Suponga que se quiere verificar la fecha de regreso del viaje es un da laboral. Si no es un da laboral se debe mostrar un mensaje de error, de lo contrario la aplicacin contina con la siguiente actividad. 1. En el cuarto paso del Asistente seleccione la opcin Acciones de la actividad. Luego agregue una expresin Al Entrar de la actividad donde se quiere crear la expresin.

2. En un mdulo de expresin cree un condicional if. Evalu si la fecha de regreso es un da laboral utilizando la funcin IsW o rkin g Day de la categora Valid aci n d e d ata.

Copyright 2013 - Bizagi

1069

Utilice como parmetro de entrada la fecha de regreso ( Retu rn in g Date) del modelo de datos.

La funcin regresar verdadero si la fecha es un da laboral, de lo contrario regresa falso.

1070

Copyright 2013 - Bizagi

//Evalua si el da es laboral if (CHelper.IsWorkingDay(Me,<TravelRequest.ReturningDate>)==false) { CHelper.ThrowValidationError("Returning day is non working."); } Guarde la regla dando clic en Ok.

Verificar si una fecha es un da laborar para un usuario especfico

En un Proceso de Solicitud de Viaje usted inicia un caso en la actividad de Registro de Solicitud. Usted deben ingresar la fecha de partida. Si la fecha de partida no es un da laboral para el solicitante, se debe mostrar una validacin para evidenciar esta situacin. Para saber si la fecha de partida es un da laboral para el solicitante, usted puede utilizar la funcion CH elp er. IsW o rkin g Day F o rUser. Este mtodo devuelve Verdadero si un da especfico es un da laboral de acuerdo al esquema de trabajo del usuairo. En otro caso devuelve Falso. Esta funcin utiliza dos parmetros: idUser: Id del usuario para el cual se evala el da laboral. dtDate: Fecha a evaluar. La sintaxis de esta funcin es:

CHelper.IsWorkingDayForUser(idUser,dtDate)
Cree una expresin como una accin a la salida de la actividad Reg istrar so licitu d.

Copyright 2013 - Bizagi

1071

Use la funcin IsW o rkin g Day F o rUser utilizando como parmetro la fecha de partida y el identificador del creador del caso.

//Obtenga el identificador del creador del caso var Creator=Me.Case.Creator.Id; //Evale si la fecha de partida es un da laboral para el solicitante

1072

Copyright 2013 - Bizagi

if (CHelper.IsWorkingDayForUser(Creator,<TravelRequest.LeavingDate>) ==false) { CHelper.ThrowValidationError("Depart day is non working."); }

Verificar si una hora es una hora laboral

Suponga que usted tiene un proceso en el cual se debe programar una reunin (una fecha y hora especfica). Usted desea validar si la fecha seleccionada por el usuario final es una hora laboral bajo el esquema laboral de la organizacin. Para saber si la hora tentativa de la reunin es una hora laboral, usted puede hacer uso de la funcin CH elp er. IsW o rkin g M in u te . Este mtodo devuelve Verdadero si una fecha especfica cae bajo el esquema de trabajo de la organizacin. De lo contrario, devuelve Falso. Esta funcin utiliza dos parmetros: Me dtDate: Fecha a evaluar. Esta considera el da calendario as como la hora definida para este. La sintaxis de esta funcin es:

CHelper.IsWorkingMinute(Me,dtDate)
Cree una expresin como una accin a la salida de la tarea donde se programa la reunin.

Utilice la funcin IsW o rkin g M in u te usando como parmetro de entrada la fecha de la reunin. As mismo, utilice una validacin para notificar al usuario final que la fecha seleccionada no es una opcin vlida (si ese es el caso).

Copyright 2013 - Bizagi

1073

//Evale si la fecha de la reunin es una hora laboral if (CHelper.IsWorkingMinute(Me,<TravelRequest.LeavingDate>)==false) { CHelper.ThrowValidationError("Meeting hour is non working."); }

Resta de fechas (diferencia entre fechas)

El siguiente ejemplo ilustra cmo encontrar la diferencia entre dos fechas: en das, aos, horas o minutos. La funcin utilizada para el ejemplo retorna la diferencia de tiempo considerando solamente das laborales. El nmero de das laborales de su solicitud sern calculados utilizando la fecha de salida y de regreso de sus vacaciones. 1. En el cuarto paso del Asistente seleccione la opcin Acciones de la actividad. Luego agregue una expresin Al Guardar en la actividad donde se quiere crear la expresin.

1074

Copyright 2013 - Bizagi

2. Declare las variables fecha de inicio y fecha final dando clic en la opcin Variables y luego seleccione la opcin Nuevo.

3. Inicialice las variables con los valores de los atributos correspondientes.

Copyright 2013 - Bizagi

1075

4. La diferencia de fechas se guardar en un atributo del modelo de datos N u m b ero fB u sin essDay sReq . Utilice la opcin modelo de datos para incluir el atributo.

llamado

5. Utilice la funcin GetEffectiv eDu ratio n de la categora F ech as y tiem p o s para calcular la diferencia de fechas.

1076

Copyright 2013 - Bizagi

Los parmetros de la funcin son: una fecha de inicio ( Start d ate) y una fecha de fin ( En d d ate).

//Inicializar variables Start=<VacationRequest.LeavingDate>; End=<VacationsRequest.ReturningDate>; //Calcular los das de la solicitud y guardarlos en un atributo <VacationRequest.NumberofBusinessDaysReques>=CHelper.getEffectiveDuration (Me,Start,End)/480; Note que la expresin previa es dividida por 480. Esto es hecho por dos razones: la primera es que el resultado es retornado en minutos, pero la respuesta debe necesita estar en das y el tiempo de trabajo (laboral) para esta aplicacin tiene 8 horas diarias (60 min.* 8 horas = 480 min) por lo que la respuesta se divide en 480 valor que corresponde a un da laboral. Si el resultado es requerido en minutos, la divisin puede ser omitida. IMPORTANTE: El calculo se realiza considerando el esquema laboral organizacional. Es decir, la diferencia de fechas (desde la fecha de inicio hasta la fecha de fin) excluir los periodos de tiempo no laborales.

Luego de que la expresin ejecute el clculo, el valor podr observarse en el campo N u m b er o f b u sin ess d ay s req u ested .

Copyright 2013 - Bizagi

1077

Agregar fechas
Suponga que la ltima actividad del proceso de Solicitud de Vacaciones debe realizarse en los cinco das posteriores al regreso del empleado de sus vacaciones. Para calcular esa fecha, es necesario agregar cinco das al atributo. Para realizar esta accin vamos a utiliza una funcin .NET que permite agregar das a un atributo o variable.

Resu ltin g Date= Date.A d d Day s(Valu e);

Otras funcione .Net que permiten la adicin de horas, meses o aos:

Resu ltin g Date= Date.A d d H o u rs(Valu e); Resu ltin g Date= Date.A d d M o n th s(Valu e); Resu ltin g Date= Date.A d d Y ears(Valu e);
Si quiere restar horas, das, meses o aos, utilice la misma funcin pero con valores negativos: Resu ltin g Date= Date.A d d Day s(-Valu e); Para establecer la duracin de una tarea utilice la function Estim ated So lu tio n d ate. 1. En el cuarto paso del Asistente seleccione la opcin Acciones de la actividad. Luego agregue una expresin Al Guardar en la actividad donde se quiere crear la expresin.

2. Declare dos variables de tipo d ate tim e. LeavingDate: Guarda el atributo Fecha de regreso de vacaciones del empleado. FixedDate: Guarda la fecha lmite derivada de la funcin, se utilizar para definir la duracin de la tarea.

1078

Copyright 2013 - Bizagi

3. La duracin de la tarea se calcula en base del atributo Fecha de regreso del modelo de datos. El valor del atributo ser guardado en la variable Retu rn in g Date.

4. La fecha lmite de la tarea. Se debe agregar cinco das a la fecha guardada en la variable Retu rn in g Date. El resultado ser asignado a la variable F ix ed Date.

Copyright 2013 - Bizagi

1079

5. Asigne la duracin de la tarea utilizando la funcin Estim ated so lu tio n d ate de la categora F ech as y tiem p o s. A siguiente imagen muestra la expresin:

//Obtener el valor de un atributo y guardarlo en una variable de tipo date time. ReturningDate=<VacationRequest.ReturningDate>; //Calcular la fecha lmite y guardarlo en una variable de tipo date time FixedDate=ReturningDate.AddDays(5); //Asignar la duracin de la actividad en base del clculo realizado. Me.EstimatedSolutionDate=FixedDate; Clic en Ok para guardar cambios.

Calcular una fecha en base al esquema de trabajo

1080 Copyright 2013 - Bizagi

Suponga que necesita calcular una fecha en base a una fecha ms cierto periodo de tiempo. Esto se debe hacer teniendo en cuenta el esquema de trabajo de la organizacin, de modo que no se incluyan periodos de tiempo no laborales. La ltima actividad del proceso de Solicitud de Vacaciones debe ser completada en un mximo de cinco das laborales luego de que el empleado regrese de sus vacaciones. Vamos a utilizar la funcin g etEstim ated Date, la cual retorna una fecha, dada una fecha inicial (guardada en la variable dtFromDate) y un periodo de tiempo (5 das guardados en la variable iDuration), la funcin considera el esquema de trabajo. La duracin de la funcin siempre se debe dar en minutos. 1. Siga los pasos 1-4 del ejemplo anterior. 2. Para calcular la nueva fecha utilice la funcin g etEstim ated Date de la categora F ech as y tiem p o s.

Copyright 2013 - Bizagi

1081

La sintaxis para la funcin es:

CHelper.getEstimatedDate(Me,dtFromDate,iDuration)
Note que la expresin anterior convierte das en minutos. La conversin del parmetro iDuration es necesaria, ya que la funcin espera el valor en minutos. Por defecto, el esquema de trabajo tiene definido un da laboral de 8 horas. El total de minutos de los cinco das se calcula con la siguiente formula: 60 minutos de una hora por 8 horas por da y de nuevo por 5 das (5*8*60). Finalmente asigne la duracin de la tarea.

///Obtener el valor de un atributo y guardarlo en una variable de tipo date time. ReturningDate=<VacationRequest.ReturningDate>; //Calcular la fecha lmite y guardarlo en una variable de tipo date time FixedDate=CHelper.getEstimatedDate(Me,ReturningDate,5*8*60); //Asignar la duracin de la actividad en base del clculo realizad. Me.EstimatedSolutionDate=FixedDate;

1082

Copyright 2013 - Bizagi

Calcular una edad

Es posible obtener el da, mes o ao especifico de una fecha guardad en un atributo. Esto es muy til en situaciones donde se necesita realizar clculos en base a esa informacin, por ejemplo el clculo de la edad de una persona basndose en la fecha de nacimiento. Suponga que necesita calcular la edad de un empleado, en base a la fecha de nacimiento almacenada en la entidad Em p lead o .

1. Defina una expresin en la actividad donde se quiere calcular la edad del empleado.

2. En el editor de expresiones, agregue cuatro variables como se muestra a continuacin.

Copyright 2013 - Bizagi

1083

3. Asigne el valor del atributo Dateo fB irth a la variable B irth Date. Del mismo modo se asignar la fecha actual a la variable TodayDate

4. El clculo de la edad necesita la porcin del ao, tanto del ao de nacimiento como la del ao actual en el formato nmero. Separe cada fecha en tres segmentos diferentes: ao, mes y das. Respectivamente asigne la porcin del ao de cada ao a las variables Y earTo d ay (ao de la fecha de hoy), Y earB irth (ao de la fecha de nacimiento)

1084

Copyright 2013 - Bizagi

Reste los dos aos como se muestra a continuacin:

Copyright 2013 - Bizagi

1085

//Inicializar variables BirthDate=<VacationRequest.Employee.DateofBirth>; Todaydate=DateTime.Today; //Separar componentes BirthDate=new DateTime(BirthDate.Year,BirthDate.Month,BirthDate.Day); TodayDate=new DateTime(TodayDate.Year,TodayDate.Month,TodayDate.Day); //Asignar aos YearBirth=BirthDate.Year; YearToday=TodayDate.Year; //Calcular edad <VacationRequest.Employee.Age>=YearToday-YearBirth;

Clic en Ok para guardar cambios. 6. Si desea validar si la fecha de hoy cae despus del cumpleaos, puede agregar la siguiente validacin:

1086

Copyright 2013 - Bizagi

//Validacin de cumpleaos if (BirthDate<TodayDate) { //Calculo de la edad <VacationRequest.Employee.Age>=YearToday-YearBirth; } 3.5.5.6 Realizar operaciones con cadenas de texto Esta seccin muestra varios ejemplos de cmo realizar operaciones con cadenas de texto. Concatenar Convertir letras a maysculas Crear una cadena de texto ms pequea Calcular la longitud de la cadena de texto

Concatenar cadenas de texto

Un proceso automatizado necesita asignar un valor a un atributo que contiene el resultado de concatenar dos o ms cadenas de texto. Suponga que la primera tarea el proceso de Solicitud de compra (Crear solicitud de compra), tenga en cuenta estos tres atributos (primer nombre, apellido y nombre completo). El atributo nombre completo debe ser de solo lectura y debe contener el resultado de concatenar el primer nombre con el apellido del solicitante

Copyright 2013 - Bizagi

1087

1. En el cuarto paso del Asistente seleccione la opcin Acciones de la actividad. Luego agregue una expresin donde se quiere crear la expresin.

2. Ingrese el Nombre, Nombre visual y una descripcin de la expresin.

1088

Copyright 2013 - Bizagi

3. En el editor de expresiones, incluya las variables F irstStrin g y Seco n d Strin g, las cuales sern utilizadas en la siguiente expresin.

4. Cree una expresin para concatenar primer nombre con el apellido y asignar el resultado en la variable nombre completo. La concatenacin se realiza de forma muy sencilla utilizando el operador (+) como se muestra en la siguiente imagen.

Copyright 2013 - Bizagi

1089

//Asignar los valores a las variables FirstString=<PurchaseRequest.Requester.FirstName>; SecondString=<PurchaseRequest.Requester.LastName>; //Asignar el texto concatenado al atributo <PurchaseRequest.Requester.Fullname>=FirstString+" "+ SecondString; Clic O k. Una vez la expresin ha sido asociada con el proceso, el usuario puede probar su funcionalidad. En las siguientes imgenes se muestran tres atributos antes y despus de ejecutar la expresin. Una vez la expresin realiza la concatenacin se puede ver el resultado en el campo Nombre completo.

Convertir a letras maysculas

Para el ejemplo es necesario realizar los mismos pasos del ejemplo de concatenacin para poder crear y asociar la expresin al proceso de solicitud de compras. Sin embargo, en este ejemplo, se deben realizar las siguientes modificaciones utilizando una expresin.

1090

Copyright 2013 - Bizagi

1. Cree las siguientes variables en la expresin.

2. Aplique el mtodo . To Up p er para concatenar la cadena de texto y asignar el resultado en el atributo objetivo.

// Asignar los valores a las variables FirstString=<PurchaseRequest.Requester.FirstName>; SecondString=<PurchaseRequest.Requester.LastName>; //Construir el texto concatenado en el atributo ConcatenatedString=FirstString+" "+ SecondString; //Convertir a maysculas UpperString=ConcatenatedString.ToUpper(); //Asignar el texto concatenado al atributo <PurchaseRequest.Requester.Fullname>=UpperString; Ahora podemos probar la expresin en el Portal de Trabajo. El ejemplo se lleva a cabo en la primera

Copyright 2013 - Bizagi

1091

actividad del proceso. El resultado se muestra en las siguientes imgenes.

Note que la expresin es asociada en la opcin A l Salv ar. Una vez de clic en Guardar, en la tarea correspondiente, la expresin ser ejecutada, y el campo de nombre completo ser presentado, por un lado con la concatenacin de los campos primer nombre y apellido y en letras maysculas.

Crear una cadena de texto ms pequea

La funcin Substring permite obtener un subconjunto de la cadena de texto, donde el orden de los elementos es conservado. Suponga que desea obtener las iniciales del solicitante. En el ejemplo, es necesario realizar los mismo ejemplos explicados en el ejemplo concatenar cadenas de texto para poder crear y asociar la expresin al proceso de solicitud de compras. Sin embargo, en este ejemplo, se deben realizar las siguientes modificaciones utilizando una expresin. 1. Cree las siguientes variables.

2. Agregue la sentencia Su b strin g dentro de la expresin.

1092

Copyright 2013 - Bizagi

El mtodo Substring tiene la siguiente sintaxis. Strin g .Su b strin g (fro m p o sitio n , to p o sitio n );

Su b strin g retorna los caracteres desde hasta, pero no incluyendo el carcter del final. Por ejemplo, si aplica la funcin al texto Bizagi con los parmetros 2,4 ( Strin g .Su b strin g (2, 4)), la funcin devolver za.

La siguiente imagen muestra la expresin para obtener las iniciales del solicitante.

// Asignar los valores a las variables FirstString=<PurchaseRequest.Requester.FirstName>; SecondString=<PurchaseRequest.Requester.LastName>; //Construir el texto concatenado con el mtodo Substring Initials=FirstString.Substring(0,1)+" "+ SecondString.Substring(0,1);

Copyright 2013 - Bizagi

1093

//Asignar el texto concatenado al atributo <PurchaseRequest.Requester.Fullname>=Initials; Ahora podemos probar la expresin en el Portal de Trabajo. El ejemplo se lleva a cado en la primera actividad del proceso. El resultado se muestra en las siguientes imgenes.

La expresin se asocia a los eventos Al Guardar de la actividad. Una vez el usuario presione el botn Guardar, la expresin ser ejecutada. El campo del nombre completo ser actualizado con las iniciales del primer nombre y del apellido.

Calcular la longitud de la cadena de texto

Suponga que desea validar que la cadena concatenada de texto obtenida en el ejemplo de la seccin anterior tiene como mximo 10 caracteres. Si la cadena concatenada tiene ms de 10 caracteres, se debe aplicar la funcin substring para redefinir el tamao de la cadena al deseado. Para obtener la longitud de la cadena de texto utilizamos el mtodo .Len g th el cual retorna un entero: Para nuestro ejemplo vamos a utilizar la siguiente validacin:

1094

Copyright 2013 - Bizagi

// Asignar los valores a las variables FirstString=<PurchaseRequest.Requester.FirstName>; SecondString=<PurchaseRequest.Requester.LastName>; //Construir el texto concatenado ConcatenatedString=FirstString+" "+ SecondString; if (ConcatenatedString.length<10) { //Asignar el texto concatenado al atributo <PurchaseRequest.Requester.FullName>=ConcatenatedString; } else { //Aplicar el mtodo substring ConcatenatedString=ConcatenatedString.Substring(0,10); <PurchaseRequest.Requester.FullName>=ConcatenatedString; } Ahora podemos probar la expresin en el Portal de Trabajo. El ejemplo se lleva a cabo en la primera actividad del proceso. Ingrese entre el primer nombre y el apellido ms de 10 caracteres. El resultado en el atributo nombre completo ser solamente los primeros 10 caracteres (incluido el espacio entre el nombre y el apellido), como se muestra en la siguiente imagen.

Copyright 2013 - Bizagi

1095

3.5.5.7

Obtener y utilizar informacin del usuario actual Bizagi proporciona varias funciones que permiten encontrar y manipular la informacin del usuario que est asignado actualmente. Todo este grupo de funciones empiezan con la sentencia M e.W o rkin g Cred en tial . Estas funciones se encuentran en la categora de In fo rm aci n d el u su ario actu al.

Los siguientes son los mtodos disponibles para el usuario actual asignado:

1096

Copyright 2013 - Bizagi

Propiedades AreaName FullName IsInPosition

Descripcin Retorna el nombre del rea del usuario actual. Retorna el nombre completo del usuario. Retorna Verdadero si el usuario tiene una determinada posicin, falso de lo contrario. Retorna verdadero si el usuario tiene un role especifico, falso de lo contrario. Retorna Verdadero si el usuario tiene una habilidad especifica, falso de lo contrario. Regresa el id del usuario. Regresa el valor de una propiedad de usuario especificada.

IsInRole

IsInSkill

UserId UserProperties

Ejemplo
El siguiente ejemplo ilustra cmo utilizar las funciones anteriores: Suponga un banco que tiene como misin hacer que el proceso de crdito sea ms eficiente: cuando la solicitud es creada por uta persona que tiene el rol de P ag ad o r, el proceso no necesita pasar por la actividad de Anlisis de Crdito. Para evitar la actividad, el atributo booleano, Requiere Estudio debe ser creado. Si el valor del atributo es verdadero, el caso ir a la tarea Anlisis de crdito, de lo contrari, la tarea ser pasada de largo.

La siguiente regla evala si el usuario actual tiene el rol de pagador. Si la condicin se cumple, el caso no necesita ms estudio. La regla se ejecuta Al Salir de la actividad del proceso de Solicitud de Crdito.

Copyright 2013 - Bizagi

1097

1098

Copyright 2013 - Bizagi

//Evala si el usuario actual tiene el role de Pagador. if(Me.Case.WorkingCredential.IsInRole("Disburser")==true) { //Si la condicin se cumple es atributo requiere estudio se define en falso y la actividad no se ejecuta. <CreditRequest.RequiresStudy>=false; } else { // Si la condicin no se cumple, el atributo requiere estudio se define en verdadero e ingresa a la tarea de anlisis de crdito. <CreditRequest.RequiresStudy>=true; } 3.5.5.8 Obtener y utilizar informacin de los asignados actuales Bizagi brinda varias funciones que le permiten encontrar y manipular informacin acerca de los asignados a la tarea actual. Todas las funciones de este grupo inician con la sentencia:

Me.Assignees[]
Cuando se utiliza esta funcin, se devuelve un arreglo de usuarios. Para utilizar esta funcin es necesario utilizar llaves [ ] para especificar el ndice del usuario. La primera posicin del arreglo es 0 (cero).

Copyright 2013 - Bizagi

1099

Si solo hay un usuario asignado, la sentencia ser M e.A ssig n ees[0].attrib u te Este grupo de funciones se encuentran disponibles bajo la categora In fo rm aci n d e lo s asig n ad o s actu ales.

La informacin disponible para los asignados actuales es: Propiedad Id Descripcin Devuelve una coleccin que contiene los ids de todos los asignados a una actividad. Devuelve una coleccin que contiene el id de los jefes de todos los asignados a una actividad. Devuelve una coleccin que contiene el nombre completo de todos los asignados a una actividad. Devuelve una coleccin que contiene la

BossId

FullName

Location

1100

Copyright 2013 - Bizagi

ubicacin de todos los asignados a una actividad. Positions Devuelve una coleccin que contiene las posiciones de un asignado especifico a una actividad. Devuelve una coleccin que contiene los roles de un asignado especifico a una actividad. Devuelve una coleccin que contiene los skills de un asignado especifico a una actividad. Devuelve una coleccin que contiene el nombre de usuario de un asignado especifico a una actividad. Devuelve una coleccin que contiene una propiedad de usuario especfica de todos los asignados a una actividad.

Roles

Skills

UserName

getUserProperties()

Ejemplos
Los siguientes ejemplos ilustrarn cmo utilizar estas funciones:: Obtener el nombre completo de los asignados actuales Obtener los roles de los asignados actuales Obtener propiedades de usuario

Obtener el nombre completo de los asignados actuales

La funcin M e.A ssig n ees[].F u lln am e devuelve el nombre completo de todos los asignados a una actividad. Para utilizar esta funcin es necesario usar llaves [] con el fin de especificar el ndice del usuario. La sintaxis de la funcin es a siguiente:

Me.Assignees[index].FullName
Suponga que en un P ro ceso d e Serv icio al Clien te usted desea obtener la lista de usuarios asignados a una tarea especfica. Esta lista se mostrar a los usuarios finales a travs de una coleccin denominada A ssig n eesList. Para construir esta lista cree una expresin como una accin a la entrada, en la actividad donde se requiera. Utilice la funcin M e.A ssig n ees para navegar la lista de asignados.

Copyright 2013 - Bizagi

1101

Para cada asignado cree un nuevo registro en la coleccin A ssig n eesList, utilizando la funcin M e.A d d Relatio n .

Finalmente utilice M e.A ssig n ees[].F u llN am e para obtener el nombre completo de cada asignado e incluirlo como el nuevo registro de la coleccin.

1102

Copyright 2013 - Bizagi

//Navegue la lista de asignados for (var i=0; i<Me.Assignees.Count; i++) { //Por cada asignado cree un nuevo registro en la coleccin var NewAssignee=Me.addRelation("CustomerServiceRequest.AssigneesList"); NewAssignee.setXPath("Name",Me.Assignees[i].FullName); } La lista se mostrar a los usuarios finales de la siguiente manera:

Obtener los Roles de los asignados actuales

La funcin M e.A ssig n ees[].Ro les devuelve una coleccin que contiene los todos los roles de un asignado especifico de una actividad. Para utilizar la funcin es necesario utilizar llaves [] con el fin de especificar el ndice del usuario. La funcin posee la siguiente sintaxis:

Me.Assignees[index].Roles
Suponga que en un P ro ceso d e Serv icio al Clien te usted desea obtener la lista de usuarios asignados a una tarea especfica, as como los roles que poseen. Esta lista se mostrar a los usuarios finales a travs de una coleccin denominada A ssig n eesList.

Copyright 2013 - Bizagi

1103

Para construir esta lista cree una expresin como una accin a la entrada, en la actividad donde se requiera. Utilice la funcin M e.A ssig n ees para navegar la lista de asignados.

Para cada asignado cree un nuevo registro en la coleccin A ssig n eesList utilizando la funcin M e.A d d Relatio n . Utilice M e.A ssig n ees[].F u llN am e para obtener el nombre completo de cada asignado e incluirlo como nuevo registro en la coleccin.

1104

Copyright 2013 - Bizagi

Ahora construya una cadena de texto con los roles de cada asignado. Utilice la funcin M e.A ssig n ees[] .Ro les para obtener la lista de roles.

Navegue la lista de roles y concantene sus nombres para obtener un texto nico por usuario.

Finalmente utilice el texto obtenido como el valor de la columna Ro les del nuevo registro de la coleccin. Posteriormente reinicie el texto.

Copyright 2013 - Bizagi

1105

//Navegue la lista de asignados for (var i=0; i<Me.Assignees.Count; i++) { //Por cada asignado cree un registro en la coleccin var NewAssignee=Me.addRelation("CustomerServiceRequest.AssigneesList"); NewAssignee.setXPath("Name",Me.Assignees[i].FullName); //Obtenga los Roles var RolesList=Me.Assignees[i].Roles; for (var j=0; i<RolesList.Count; i++) { //Construya el texto var UserRoles=UserRoles+ "," + RolesList[j].Name; } NewAssignee.setXPath("Roles",UserRoles); //Reinicie el texto de los roles UserRoles="" } La lista se mostrar a los usuarios finales de la siguiente manera:

1106

Copyright 2013 - Bizagi

Obtener propiedades de usuario

La funcin M e.A ssig n ees[].g etUserP ro p erties devuelve una propiedad de usuario de un asignado especifico de una actividad. Para usar la funcin es necesario utilizar llaves [] con el fin de especificar el ndice del usuario. La funcin posee la siguiente sintaxis:

Me.Assignees[index].getUserProperties["Property"]
Suponga que en un P ro ceso d e Serv icio al Clien te usted desea obtener la lista de usuarios asignados a una tarea especfica, as como una propiedad de usuario denominada Career. Esta lista se mostrar a los usuarios finales a travs de una coleccin denominada A ssig n eesList. Para construir esta lista cree una expresin como una accin a la entrada, en la actividad donde se requiera. Utilice la funcin M e.A ssig n ees para navegar la lista de asignados.

Para cada asignado cree un nuevo registro en la coleccin A ssig n eesList utilizando la funcin M e.A d d Relatio n . Utilice M e.A ssig n ees[].F u llN am e para obtener el nombre completo de cada asignado e incluirlo como nuevo registro en la coleccin.

Copyright 2013 - Bizagi

1107

Ahora obtenga la propiedad Career utilizando M e.A ssig n ees[].g etUserP ro p erties() y asigne este valor a la columna Career del nuevo registro.

//Navegue la lista de asignados for (var i=0; i<Me.Assignees.Count; i++)

1108

Copyright 2013 - Bizagi

{ //Por cada asignado cree un registro en la coleccin NewAssignee=Me.addRelation("Process.AssigneesList"); NewAssignee.setXPath("UserName",Me.Assignees[i].UserName); NewAssignee.setXPath("Location",Me.Assignees[i].getUserProperties ["Career"]); } Esta lista se mostrar a los usuarios finales de la siguiente manera:

3.5.5.9

Obtener y utilizar informacin del caso actual Bizagi brinda varias funciones que le permiten encontrar y manipular informacin acerca de la tarea actual. La mayora de las funciones de este grupo inician con la sentencia:

Me.Case
Este grupo de funciones se encuentran disponibles bajo la categora In fo rm aci n d el caso actu al.

La informacin disponible para el caso actual es:

Copyright 2013 - Bizagi

1109

Propiedad CaseId CaseNumber

Descripcin Devuelve el id del caso actual. Devuelve el nmero de caso del caso actual. Devuelve la fecha de creacin del caso actual. Devuelve el id del proceso padre del Subproceso actual. Devuelve el estado del proceso del caso actual. Este puede ser: A b o rtad o , Co m p leto , In iciad o , N o in iciad o , En ejecu ci n , Su sp en d id o . Devuelve o asigna la fecha de solucin para el caso actual. Devuelve una coleccin con todos los Subprocesos del caso actual. Devuelve el Work Item relacionado a una tarea dada del caso actual.

Creationdate

ParentProcessId

ProcessState

SolutionDate

getChildProcesses

getWorkItem()

Ejemplos
Los siguientes ejemplos ilustrarn como usar estas funciones: Obtenerel id del proceso padre Obtener el id de los procesos hijos (Subprocesos) de un proceso. Obtener el Id de los procesos hermano de un proceso Evaluar si hay procesos abiertos Obtener el WorkItem de una tarea especfica

Obtener el Id del Proceso Padre

Es posible obtener el identificador del proceso padre de un Subproceso especfico utilizando la funcin P aren tP ro cessId. La sintaxis de la funcin es la siguiente:

Me.Case.ParentProcessId
Considere un proceso de Seleccin de Personal. El Subproceso Realizar pruebas es un Subproceso mltiple que ejecuta diferentes pruebas para evaluar las habilidades del candidato y verificar si el o ella cumple con los requerimientos de la posicin.

1110

Copyright 2013 - Bizagi

Todas las pruebas deben ser aprobadas para continuar con el proceso. De lo contrario, es decir, si el candidato falla alguna de ellas, est debe ser rechazado. Debido al rechazo, se ejecutar un evento llamado Can celar Selecci n en el proceso padre, desde el la actividad P ro ceso d e Selecci n .

Para configurar el evento de cancelacin siga los siguientes pasos: 1. En el cuarto paso del asistente, seleccione A ccio n es d e la activ id ad. Luego de clic sobre la actividad Cancelar proceso de seleccin encontrada en el Subproceso Realizar Test. Cree una expresin A l En trar.

Copyright 2013 - Bizagi

1111

2. Cree un elemento de expresin. Incluya la funcin setEvent para ejecutar el Evento de Cancelacin de Seleccin. El primer parmetro de la funcin es el identificador del proceso padre. Para encontrarlo, agregue la funcin P aren tP ro cessId de la categora In fo rm aci n d el caso actu al.

CHelper.setEvent(Me,Me.Case.ParentProcessId,"CloseSelection",null); Finalmente guarde la expresin.

Obtener el id de los procesos hijos (Subprocesos) de un proceso.

1112 Copyright 2013 - Bizagi

Es posible obtener el identificador de un Subproceso relacionado a un proceso especfico utilizando la funcin g etSu b P ro cessesId . Esta funcin devuelve una lista con los identificadores de los sub-procesos de todos los casos relacionados. La sintaxis de esta funcin es la siguiente. Se toma la entidad de contexto como parmetro de entrada.

CHelper.getSubProcessesId(Me)
Imagine la Administracin de Proyectos. Las actividades necesarias para terminar le proyecto se planean en la tarea Planear Proyecto. El Subproceso Realizar activ id ad es es lanzado por cada actividad planeada. Simultneamente la tarea permite al Gerente del Proyecto monitorear el progreso de cada actividad.

Los casos relacionados a cada instancias del Subproceso Realizar actividades son privados (visit la seccin Seguridad del Caso), es decir que solo las personas que han ejecutar cualquier tarea en el Subproceso tienen acceso a la informacin del caso. Sin embargo, el desarrollo de cada una de las actividades debe se monitoreado por un auditor que necesito acceso tambin. Para otorgar el acceso al auditor es necesario crea una expresin. La expresin obtiene los identificadores de cada instancia del Subproceso y otorga los permisos necesarios al auditor para acceder a cada uno de ellos. Siga los siguientes pasos: 1. En el cuarto paso del asistente, seleccione A ccio n es d e la activ id ad. Luego de clic sobre la actividad Monitorear Actividades y cree una expresin A l En trar. Esto ejecutar la expresin en el mismo momento en que la instancia del Subproceso es creada.

Copyright 2013 - Bizagi

1113

2. Cree un elemento de expresin. Obtener la lista de Subprocesos asociados en una variable utilizando la funcin g etSu b P ro cessesid de la categora In fo rm aci n d el caso actu al.

1114

Copyright 2013 - Bizagi

3. Obtener el UserId del auditor. Utilice la funcin CHelper.GetUsersforRole para obtener una lista de id de los usuarios que tienen el Rol. Ya que para el ejemplo, solamente una persona tiene le Role de Auditor podemos extraer el id de la posicin 0 de la lista.

4. Agregue el operador FOR para recorrer la lista de los Subproceso.

Copyright 2013 - Bizagi

1115

5. Obtenga el id de cada Subproceso y utilcelo como primer parmetro en la funcin CH elp er.Gran tCaseA ccess. El segundo parmetro de la funcin ser siempre el UserId del auditor. Esto otorgar permisos al auditor para acceder a la informacin de cada Subproceso.

var ChildProcesses=CHelper.getSubProcessesId(Me); var ListofAuditors=CHelper.getUsersForRole(1003); var UserId=ListofAuditors[0]; for(var Records=0; Records < ChildProcesses.Count; Records++) { var Case=ChildProcesses[Records]; CHelper.GrantCaseAccess(Case,UserId); } Por ltimo guarde la expresin.

1116

Copyright 2013 - Bizagi

Obtener el Id de los procesos hermano de un proceso

Es posible obtener los identificadores de procesos hermanos (Subprocesos con el mismo proceso padre) de un proceso especfico utilizando la funcin g etSib lin g P ro cessesId . La funcin retorna una lista de identificadores de los casos hermanos de dada una clase de flujo. La sintaxis de la funcin:

CHelper.getSiblingProcessesId(Me,iWfClassId)
Un departamento de polica decide automatizar el proceso de Manejo de Casos de Homicidio utilizando Bizagi. En la primera actividad el proceso se ingresa toda la informacin del homicidio. Tambin se crea una lista de sospechosos para realizar las investigaciones correspondientes. Se abre un caso del Subproceso de In v estig aci n d e So sp ech o so s por cada sospechoso. Tan pronto como un sospechoso es encontrado culpable del homicidio, las otras investigaciones deben ser canceladas y el proceso contina con la generacin de la orden de captura y la captura del individuo.

Una compuerta divergente se utiliza para evaluar si el sospechoso es encontrado responsable cuando la investigacin termina, si est es el caso, una expresin se ejecuta para cancelar las otras investigaciones, de los contrario el Subproceso finaliza.

Copyright 2013 - Bizagi

1117

Para configurar la expresin que cancela las dems investigaciones siga los siguientes pasos: 1. En el cuarto paso del Asistente, seleccione la opcin (Acciones de la Actividad). Luego de clic en La tarea Can celar activ id ad es d e la In v estig aci n en el Subproceso In v estig aci n d e so sp ech o so s, cree una expresin Al entrar.

2. Cree un elemento de expresin. Obtenga la lista de los Subprocesos hermanos (otras investigaciones) y guarde la variable utilizando la funcin g etSib lin g sP ro cessesId de la categora Informacin del caso Actual.

1118

Copyright 2013 - Bizagi

El parmetro de la funcin es WfClassId del proceso. Este puede ser encontrado en la base de datos de Bizagi en la tabla WFClass. Le recomendamos que la persona que va a obtener el Id tenga un perfil tecnolgico alto. No intente abrir la base de datos si nunca ha trabajado con SQL u Oracle.

3. Agregue el operador FOR para recorrer la lista de los Subprocesos.

Copyright 2013 - Bizagi

1119

4. Obtener el Id de cada Subproceso y utilizarlo como primer parmetro de la funcin CH elp er.A b o rtP ro cess. El segundo parmetro tiene tres posibilidades. Digite 1 si solamente es necesario abortar el proceso (est es el caso del presente ejemplo) Digite 2 si el proceso y su proceso padre deben ser abortados. Digite 3 si solamente el proceso padre debe ser abortado y No el proceso en s.

//Obtener el id de los procesos hermanos. var SiblingProcesses=CHelper.getSiblingProcessesId(Me,57); //Recorra la lista for(var Records=0; Records < SiblingProcesses.Count; Records++) {

1120

Copyright 2013 - Bizagi

//Obtener el id del subproceso var Case=SiblingProcesses[Records]; //Abortar el proceso hermano CHelper.abortProcess(Case,1); } Finalmente guarde la expresin

Evaluar si hay procesos abiertos

Es posible evaluar si hay procesos abiertos que tengan relacin a un proceso especfico utilizando la funcin th ereA reO p en P ro cesses. La funcin retorna verdadero cuando hay casos abiertos de un nmero de creacin de caso especfico, (de lo contrario retorna falso). La sintaxis de la funcin es:

CHelper.thereAreOpenProcesses(CaseNumber)
Imagine el administrador de proyectos. Las actividades necesarias para completar el proyecto son planeadas en la tarea Planear proyecto. El Subproceso Realizar Actividades es lanzada por cada actividad planeada. Simultneamente, una actividad habilita al Gerente del Proyecto monitorear el proceso de cada actividad. Si el Gerente de Proyecto trata de cerrar el proyecto cuando todava hay actividades pendientes, es decir, instancias abiertas del Subproceso Ejecutar Actividad, se lanza una validacin para asegurar que todas las actividades estn completas antes de cerrar el caso.

Para validar que todas las actividades han terminado usaremos la funcin th ereA reO p en P ro cesses. 1. Vaya al cuarto paso del Asistente de Proceso y seleccione A ccio n es d e la A ctiv id ad. D clic en el monitor de actividades y cree una Expresin a la salida.

Copyright 2013 - Bizagi

1121

2. Cree un mdulo de expresin. Evale si hay actividades pendientes utilizando la funcin th ereA reO p en P ro cesses la cual se encuentra en la categora de In fo rm aci n d el caso actu al. A sig n e M e.Case.Id como parmetro. 3. Cuando hay actividades pendientes, la funcin th ereA reO p en P ro cesses retorna verdadero. Por lo que una validacin debe ser lanzada. Incluya el mensaje a mostrar. var var var for { casenumber=CostCenters.getXPath("CreateCostCenter.IdCase"); caseInfo = CHelper.getCaseById(casenumber); workItems = caseInfo.getCurrentWorkItems(); (var i = 0; i< workItems.Count; i++)

if (workItems[i].Task.Name == "GenerateSAPFile") { CHelper.setEvent(Me, casenumber,"GenerateSAPFile",null); } } Finalmente, guarde la expresin.

Obtener el WorkItem de una tarea especfica

Usted puede obtener el WorkItem relacionado a una tarea especfica utilizando la funcin M e.Case.g etW o rkItem . La obtencin de un WorkItem es especialmente til para obtener o definir informacin de una tarea, desde cualquier otra en el proceso. Esta funcin devuelve un objeto del tipo WorkItem. La sintaxis es:

Me.Case.getWorkItem[idTask]
En un Proceso de Servicio al Cliente se utiliza un evento de temporizacin para recordar el vencimiento de una solicitud. De acuerdo a la naturaleza y acciones necesarias para atender la solicitud, un agente de servicio al cliente puede modificar la fecha de vencimiento inicial. Esta actualizacin puede hacerse desde cualquier tarea del proceso cambiando el valor de un atributo del modelo de datos denominado Du eDate.

1122

Copyright 2013 - Bizagi

Para actualizar la duracin del temporizador usted puede hacer uso de la funcin M e.Case.g etW o rkItem . Cree una expresin como una accin a la salida de la tarea desde donde pueda ser actualizada la duracin del temportizador. Utilice la funcin M e.Case.g etW o rkItem ingresando el id del evento de temporizacin como parmetro. Para este ejemplo este id es 1289

Ahora aplique el mtodo .Estim ated So lu tio n sobre el objeto de tipo WorkItem para definir la nueva duracin del temporizador.

Copyright 2013 - Bizagi

1123

//Actualice la duracin del temporizador Me.Case.getWorkItem[1289] .EstimatedSolutionDate=<CustomerServiceRequest.DueDate>; 3.5.5.10 Obtener y usar valores de la tarea actual Bizagi brinda varias funciones que le permiten encontrar y manipular informacin acerca de la tarea actual. Todas las funciones de este grupo inician con la sentencia:

Me.Task
Este grupo de funciones se encuentran disponibles bajo la categora In fo rm aci n d e la tarea actu al.

1124

Copyright 2013 - Bizagi

La informacin disponible para la tarea actual es: Propiedad Id Descripcin Devuelve el identificador de la tarea actual. Devuelve un string con el nombre de la tarea actual. Devuelve un string con el nombre visual de la tarea actual. Devuelve la duracin ,en minutos, de la tarea actual.

Name

DisplayName

EstimatedDuration

Ejemplo
El siguiente ejemplo ilustrar cmo utilizar estas funciones.

Obtener el nombre de la tarea actual

La funcin N o m b re devuelve un string con el nombre de la tarea actual.

Copyright 2013 - Bizagi

1125

Esta funcin no requiere argumentos y posee la siguiente sintaxis:

Me.Task.Name
En un Proceso de Solicitud de Compra, el solicitante debera poder conocer el estado de su solicitud en cualquier momento. Para brindar esta informacin, la forma de resumen del proceso incluye un atributo denominado Estad o . Este atributo debe ser actualizada cada vez que el proceso se mueva a una actividad diferente. Por ejemplo, si la solicitud se encuentra en la actividad A u to rizar So licitu d, el estado debera ser En ap ro b aci n . As mismo, si la solicitud se encuentra en el sub-proceso de Co tizacio n es, el estado sera Co tizan d o p ro d u cto s.

Para actualizar este estado usted necesita configurar una expresin en cada actividad. Sin embargo, usted puede definir una nica expresin reusable (que se invoque en cada actividad necesaria) y evale la tarea actual para definir el estado correspondiente. Con el fin de evaluar en que tarea se encuentra el Proceso, usted puede utilizar la funcin M e.Task.N am e. Cree una expresin como una accin a la entrada de la actividad A u to rizar So licitu d.

1126

Copyright 2013 - Bizagi

Utilice la funcin M e.Task.N am e para obtener el nombre de la tarea actual y de acuerdo a este valor defina el estado correspondiente.

if (Me.Task.Name=="AuthorizeRequest") { <Process.Status>="In approval" } if (Me.Task.Name=="Quotations")

Copyright 2013 - Bizagi

1127

{ <Process.Status>="Quoting products" } Ahora invoque esta misma expresin desde el sub-proceso de Co tizacio n es. 3.5.5.11 Obtener y utilizar valores de un vocabulario

Informacin general
Bizagi permite crear vocabularios o Secuencias que pueden ser configuradas para acceder desde uno o ms procesos o aplicaciones. Secuencias y Vocabularios pueden ser involucrados en reglas de negocio utilizando un conjunto de funciones de la categora M isceln eo s.

Obtener la definicin de un vocabulario

Para obtener el valor guardado de un vocabulario especfico utilice la funcin reso lv eVo cab u lary . La siguiente es la sintaxis de la funcin:

CHelper.resolveVocabulary(Me,"VocabularyName")
En un proceso de Quejas y Reclamos un caso se debe resolver en un tiempo especfico de tiempo. El tiempo se establece dependiendo del N iv el d e Serv icio A co rd ad o o SLA , esto es el mximo de tiempo permitido para resolver el caso. La duracin de la tarea Resolver debe ser asignado de acuerdo al SLA, y es utilizado para recoger estadsticas y analizar el desempeo del proceso. Ya que SLA puede

1128

Copyright 2013 - Bizagi

cambiar de acurdo a las polticas de la compaa, est se define como una Constante en Vocabularios. Para asignar la duracin de la tarea Resolver, cree una expresin al Entrar de la tarea.

En un elemento de expresin, use la funcin Me.Duration para asignar la duracin de la tarea.

Copyright 2013 - Bizagi

1129

Para asignar un valor a la Duracin, llame la funcin reso lv eVo cab u lary y asigne como parmetro de entrada la definicin del SLA. Solamente seleccione la constante desde la lista de vocabularios del proceso y complete la funcin que ser incluida automticamente.

La siguiente imagen muestra la expresin completa:

Me.Duration=CHelper.resolveVocabulary(Me,"SLA"); Finalmente de clic en Ok para guardar los cambios.

1130

Copyright 2013 - Bizagi

Obtener el siguiente valor de una secuencia

Para autogenerar nmeros en base a la definicin de una secuencia, usted debe utilizar la funcin GetN ex tSeq Valu eStr. La sintaxis de la funcin es:

CHelper.GetNextSeqValueStr("SequenceName")
Suponga que tiene un proceso de M atrcu la d e estu d ian tes donde el departamento Administrativo de una universidad registra y matrcula estudiantes. Una vez que los estudiantes son matriculados, se debe generar un nmero consecutivo para identificar al estudiante dentro de la universidad. Este nmero aparecer en el carnet de identificacin del estudiante. Para asignar el siguiente nmero de la secuencia a los estudiantes matriculados defina una secuencia particular en Bizagi Studio. (En el mdulo vista, seleccione la pestaa de Co n fig u raci n y luego la opcin Secu en cia)

En el cuarto paso del asistente, seleccione Acciones de la Actividad. Luego de clic en la tarea donde se va ha agregar la secuencia y cree una expresin.

Copyright 2013 - Bizagi

1131

Debemos asignar el valor de la secuencia en el atributo N m ero d e Id en tificaci n In tern a, este atributo pertenece a la entidad A p licaci n d e Estu d ian te.

Llame la funcin GetN ex tSeq Valu eStr para obtener el valor. Pase el nombre de la secuencia como parmetro de entrada. La siguiente imagen muestra la expresin completa.

//Asigne el siguiente nmero de la secuencia al atributo.

1132

Copyright 2013 - Bizagi

<StudentApplication.InternalIdentificationNumber>=CHelper.GetNextSeqValueSt r("InternalIdentificationNumber"); Finalmente, guarde la expresin. 3.5.5.12 Obtener y utilizar valores de una entidad

Obtener un valor de una entidad no relacionada en el Modelo de Datos

Suponga un proceso de Solicitud de crdito donde la cantidad mxima solicitada se basa en un estudio de riesgos. Cuando un Analista ingresa el puntaje de riesgo calculado en la tarea Capacidad de Pago y da clic en el botn guardar, el lmite superior de la cantidad aprobada ser mostrado. La estimacin de riesgo se guarda en una Entidad paramtrica donde cada rango tiene un monto mximo relacionado:

Ya que la entidad paramtrica no se relaciona directamente con el modelo de datos necesitamos utilizad una funcin que busque el valor mencionado dependiendo del nivel de riesgo. Vamos a utilizar la funcin g etEn tity A ttrib. La funcin se encuentra en la categora N av eg aci n d e Data. Esto pasar el puntaje de riesgo ingresado por el analista para determinar en que rango se encuentra y devolver la cantidad mxima que puede ser solicitada.

Copyright 2013 - Bizagi

1133

La sintaxis de la funcin es:

CHelper.getEntityAttrib("Entity","ValueToReturn","filter","")
La entidad ser la entidad paramtrica Riesg o . El valor retorna la cantidad mxima aprobada. El filtro ser el rango del riesgo ingresado. En el cuarto paso del asistente, seleccione Acciones de la Actividad. Luego de clic en la tarea donde se va ha mostrar el lmite superior aprobado. Cree una expresin Al Guardar.

1134

Copyright 2013 - Bizagi

El puntaje del riesgo ingresado por el analista est guardado en el atributo Riesg o . La cantidad mxima ser asignada al atributo Can tid ad M x im a.

La expresin deber lucir de la siguiente forma:

Copyright 2013 - Bizagi

1135

// Obtener el puntaje del riesgo. var RiskValue=<CreditRequest.Risk>; // Itere sobre los atributos lmite inferior y lmite superior de la entidad paramtrica riesgo, para determinar el registro valido. //Guarde el valor en el atributo MaximumApprovedAmount. <CreditRequest.MaximumAmount>=CHelper.getEntityAttrib ("Risk","MaximumApprovedAmount", "(LowerBound <="+RiskValue+") AND (UpperBound > "+RiskValue+")",""); Clic en ok para guardar los cambios. Cuando un Analista ingrese el puntaje de riesgo y de clic en Guardar, la cantidad mxima correspondiente ser mostrada.

Obtener valores de una coleccin

Suponga un proceso de Solicitud de compras donde tiene una coleccin de productos, donde cada producto tiene un nico precio y una cantidad. El requerimiento es obtener el costo total de los productos de la orden. Necesitamos iterar sobre los productos de la coleccin regresados por la consulta XPath. Por cada producto que vamos a obtener el precio total y sumarlo al costo total de la compra. Para iterar sobre la coleccin, es necesario guardar el resultado de la consulta XPath en una variable y luego llamar la funcin GetValu eA sCo llectio n , pasando la variable de la consulta como parmetro. Una vez los valores han sido convertidos a un Array List, es posible navegar los valores de la coleccin utilizando la funcin FOR. Nota Usted puede ejecutar este ejemplo utilizando la funcin Over XPath. El ejemplo solo tiene como proposito brindar un ejemplo.

1136

Copyright 2013 - Bizagi

La funcin GetValu eA sCo llectio n se encuentra en la categora N av eg aci n d e Data.

La sintaxis de la funcin es:

CHelper.GetValueAsCollection("Collection")
Los parmetros de la funcin son: el XPath de la coleccin obtenido, en este caso ser la coleccin

Copyright 2013 - Bizagi

1137

Productos Solicitados. Cree una expresin Al guardar de la tarea donde se va a realizar el clculo.

Agregue una expresin con el siguiente cdigo.

var Collection=<PurchaseRequest.Products>;

1138

Copyright 2013 - Bizagi

//Convierta el objeto de la coleccin en una coleccin para ser iterado. var Array=CHelper.GetValueAsCollection(Collection); //Inicialice la variable guardada en el Costo Total. var Total=0 //Itere sobre la coleccin para obtener el precio de cada uno de los productos for (var I=0; I < Array.size(); I++) { //Obtener cada elemento, luego guardar le precio y la cantidad. var Element= Array.get(I); var ElementPrice=Element.getXPath("Price") ; var ElementQuantity=Element.getXPath("Quantity"); //Acumular el precio total en la variable Costo Total. Total=Total+(ElementPrice*ElementQuantity); } // Asignar el costo total en el atributo mostrado. <PurchaseRequest.TotalCost>=Total; La coleccin se debe ver en el Portal de Trabajo de la siguiente manera.

Una vez la expresin es ejecutada, el costo total es mostrado.

Obtener valores de atributos especficos de una entidad

En un P ro ceso d e So licitu d d e Crd ito una notificacin debe enviarse al jefe de la persona que trabaja en una solicitud, en caso de que el tiempo para atenderlo se exceda. Usted necesita entonces conocer

Copyright 2013 - Bizagi

1139

la direccin de correo electrnico del jefe. Para obtenerlo, usted puede utilizar la funcin CH elp er.g etA ttrib. Esta funcin devuelve el valor de un atributo dado de un registro especfico en una entidad. Los parmetros de esta funcin son: sEntityName: Nombre de la entidad. oEntitYKey: Id del registro especfico dentro de la entidad. sAttribName: Nombre del atributo de la entidad. Y la sintaxis es:

CHelper.getAttrib(sEntityName, oEntityKey, sAttribName);

Incluya una expresin como una accin de actividad. Obtenga el id del jefe del asignado actual utilizando la funcin M e.Case.W o rkin g Cred en tial.UserP ro p erties().

Utilice la funcin CH elp er.g etattrib () para obtener la direccin de correo electrnico del usuario deseado, desde la entidad W F User. En este caso almacene este valor en un atributo del modelo de datos ( B o ssEm ail).

1140

Copyright 2013 - Bizagi

//Obtain the identifier of the current assignee user //var BossId=Me.Case.WorkingCredential.UserProperties["idbossuser"]; //Obtain the email of the user from the WFUser entity <ContactCenter.BossEmail> = CHelper.getAttrib("WFUser",BossId,"Email");

Modificar valores de atributos especficos de una entidad

Un banco ofrece mltiples productos crediticios a sus clientes. Una vez que se aprueba y entrega un producto, se realizar un seguimiento mensual con el fin de evaluar si el cliente cumple con los pagos pactados a tiempo. Si el cliente cae en mora en repetidas ocasiones, todas sus solicitudes en progreso se penalizan y por lo tanto difcilmente sern aprobados. Para identificar si una solicitud ha sido penalizada, se utiliza un atributo booleano en el modelo de datos. Este atributo debe actualizarse en todas las solicitudes en progreso del cliente cuando este caiga en mora. Para actualizar este valor usted puede hacer uso de la funcin CH elp er.setA ttrib. Esta funcin asigna un valor a un atributo dado de un registro especfico de una entidad. Los parmetros de esta funcin son: sEntityName: Nombre de la entidad. oEntitYKey: Id del registro especfico dentro de la entidad. sAttribName: Nombre del atributo de la entidad. oAttribValue: Valor a asignar. Y la sintaxis es:

CHelper.setAttrib(sEntityName ,oEntityKey, sAttribName, oAttribValue);

Incluya una expresin como una accin de actividad. Primero obtenga la lista de casos en progreso del cliente que ser penalizado.

Copyright 2013 - Bizagi

1141

Luego, en cada solicitud actualice el atributo que identifica si una solicitud ha sido penalizada. Para hacerlo navegue la lista de solicitudes y utilice la funcin CH elp er.setA ttrib .

//Obtenga la lista de solicitudes del usuario evaluado var IdCustomerEvaluated=<CustomersFollowUp.CustomerEvaluated.id> var ListOfRequests = CEntityManager.GetEntity("CreditRequest") .GetEntityList("", "","idRequester="+IdCustomerEvaluated, ""); //Actualice cada caso for (var i=0;i<ListOfRequests.Count;i++) { CHelper.setAttrib("CreditRequest",ListOfRequests[i] .SurrogateKeyValue,"RequestPenalized",true); }

1142

Copyright 2013 - Bizagi

3.5.5.13 Obtener usuarios basados en componentes de la organizacin

Informacin general
En una organizacin es una prctica comn utilizar la clasificacin de un empleado para realizar asignaciones o configurar permisos. Bizagi permite obtener una lista de usuarios clasificados por las categoras: Posicin, Rol, Habilidades. Usuarios en una posicin especifica. Es posible obtener una lista de los usuarios que tienen cierta posicin dentro de la organizacin utilizando la funcin g etUsersF o rP o sitio n . La funcin retorna una lista con el identificador de los usuarios que tienen la posicin indicada. La sintaxis de la funcin es:

CHelper.getUsersForPosition(idPosition)
El parmetro es el identificador de la posicin. Usuarios con un rol especfico. Es posible obtener una lista de los usuarios que tienen cierto rol dentro de la organizacin utilizando la funcin g etUsersF o rRo le. La funcin retorna una lista con el identificador de los usuarios que tienen el rol indicado. La sintaxis de la funcin es:

CHelper.getUsersForRole(idRole)
El parmetro es el identificador del rol. Usuarios con un rol especfico. Es posible obtener una lista de los usuarios que tienen cierta habilidad dentro de la organizacin utilizando la funcin g etUsersF o rSkill. La funcin retorna una lista con el identificador de los usuarios que tienen la habilidad indicada. La sintaxis de la funcin es:

CHelper.getUsersForSkill(idSkill)
El parmetro es el identificador de la habilidad. En las anteriores funciones CHelper, el identificador del usuario (userid) se refiere al Id que el usuario tiene en la entidad del sistema WFUser. Para obtener el identificador de la posicin, habilidad o rol deseado, busque el nombre de la propiedad utilizando la opcin de Buscar de Bizagi Studio. Esta opcin se encuentra en la pestaa Inicio. Seleccione la opcin Organizacin y luego escriba el nombre de la propiedad. La bsqueda retornar el identificador, como se muestra en la siguiente imagen.

Copyright 2013 - Bizagi

1143

Para utilizar alguna de las funciones mencionadas, debe estar en el editor de expresiones, luego, en la opcin Funciones seleccionar la categora Usuarios (funciones generales). Clic en la funcin deseada para incluirla dentro del cdigo.

1144

Copyright 2013 - Bizagi

Ejemplo de como obtener un usuario con cierta posicin

Imagine un proceso de Mesa de Ayuda, la persona de soporte recibe los casos, los cuales deben ser asignados a un tcnico que este disponible. El caso hace referencia a una coleccin llamada Tcn ico s d isp o n ib les, la cual contiene los usuarios que tienen la posicin Tcn ico d e so p o rte. Para llenar la coleccin es necesario obtener los tcnicos calificados de la entidad WFUser, basndose en sus posiciones.

1. En el cuarto paso del asistente, seleccione Acciones de la Actividad. Luego de clic en la primera tarea del proceso y cree una expresin Al entrar.

2. Cree dos elementos de expresin un elemento FOR como se muestra a continuacin. En el primer elemento expresin, declare las variables y obtenga la lista de usuarios con la posicin

Copyright 2013 - Bizagi

1145

especfica. Utilice el mdulo FOR para iterar sobre cada registro e la lista. En el otro elemento expresin, incluya cada registro a la coleccin A v ailab leTech n itian s.

3. En el mdulo de la primera expresin declare las siguientes variables: UserArray: Guarda la lista de usuarios que pertenecen a una posicin especfica. IterationIndex: Contador para el ciclo FOR. TempIdUser: Guarda temporalmente un registro especfico de la lista de usuarios. newRow: Crea un nuevo registro en la relacin donde se incluir el usuario.

1146

Copyright 2013 - Bizagi

4. Obtenga una lista de usuarios con la posicin deseada utilizando la funcin Get u sers in P o sitio n de la categora Usu ario s. Recuerde que el parmetro de la funcin es el identificador de la posicin, realice la bsqueda antes de realizar la expresin.

//Obtener la lista de usuarios con una posicin especfica y guardarla en una variable. UsersArray=CHelper.getUsersForPosition(2); 5. Itere la lista utilizando un elemento FOR. El ciclo comienza en Cero (0) y termina en el ltimo ndice de la lista. La sentencia UsersArray.Count regresar el nmero total de usuarios encontrados (es decir, cuenta los elementos del arreglo). El ciclo ser ejecutado mientras que el ndice de la coleccin sea menor que el nmero total de elementos del arreglo.

Copyright 2013 - Bizagi

1147

6. Incluya el siguiente cdigo en el segundo elemento de expresin para obtener el identificador del usuario. Luego, cree una nueva fila en la coleccin A v ailab le Tech n ician s. Agregar del id del tcnico en la nueva lnea.

//Obtener la identificacin del usuario de la iteracin actual del arreglo. TempIdUser=UsersArray(IterationIndex); //Agregar un nuevo registro a la coleccin AvailableTechnicians newRow=Me.addRelation("Ticket.AvailableTechnicians"); //Asigne a la columna Technician el userid obtenido previamente. newRow.setXPath("Technician",TempIdUser"); La coleccin se mostrar en el Portal de Trabajo de la siguiente forma:

1148

Copyright 2013 - Bizagi

Ejemplo de como obtener un usuario con cierto rol

Imagine un proceso de Mesa de Ayuda, la persona de soporte recibe los casos, los cuales deben ser asignados a un tcnico que este disponible. El caso hace referencia a una coleccin llamada Tcn ico s d isp o n ib les, la cual contiene los usuarios que tienen el rol Tcn ico IT. Para llenar la coleccin es necesario obtener los tcnicos calificados de la entidad WFUser, basndose en sus roles.

1. En el cuarto paso del asistente, seleccione Acciones de la Actividad. Luego de clic en la primera tarea del proceso y cree una expresin Al entrar.

Copyright 2013 - Bizagi

1149

2. Cree dos elementos de expresin un elemento FOR como se muestra a continuacin. En el primer elemento expresin, declare las variables y obtenga la lista de usuarios con el rol especfico. Utilice el mdulo FOR para iterar sobre cada registro e la lista. En el otro elemento expresin, incluya cada registro a la coleccin A v ailab leTech n itian s.

1150

Copyright 2013 - Bizagi

3. En el mdulo de la primera expresin declare las siguientes variables: UserArray: Guarda la lista de usuarios que pertenecen al rol especfico. IterationIndex: Contador para el ciclo FOR. TempIdUser: Guarda temporalmente un registro especfico de la lista de usuarios. newRow: Crea un nuevo registro en la relacin donde se incluir el usuario.

Copyright 2013 - Bizagi

1151

4. Obtenga una lista de usuarios con el rol deseado utilizando la funcin Get u sers in Ro le de la categora Usu ario s.

//Obtener la lista de usuarios con un rol especfico y guardarla en una variable UsersArray=CHelper.getUsersForRole(10000); 5. Itere la lista utilizando un elemento FOR. El ciclo comienza en Cero (0) y termina en el ltimo ndice de la lista. La sentencia UsersArray.Count regresar el nmero total de usuarios encontrados (es decir, cuenta los elementos del arreglo). El ciclo ser ejecutado mientras que el ndice de la coleccin sea menor que el nmero total de elementos del arreglo.

1152

Copyright 2013 - Bizagi

6. Incluya el siguiente cdigo en el segundo elemento de expresin para obtener el identificador del usuario. Luego, cree una nueva fila en la coleccin A v ailab le Tech n ician s. Agregar del id del tcnico en la nueva lnea.

//Obtener la identificacin del usuario de la iteracin actual del arreglo. TempIdUser=UsersArray(IterationIndex); //Agregar un nuevo registro a la coleccin AvailableTechnicians newRow=Me.addRelation("Ticket.AvailableTechnicians"); //Asigne a la columna Technician el userid obtenido previamente. newRow.setXPath("Technician",TempIdUser"); Clic en Ok para guardar. La coleccin se mostrar en el Portal de Trabajo de la siguiente forma:

Copyright 2013 - Bizagi

1153

Ejemplo de como obtener un usuario con cierta habilidad

Imagine un proceso de Mesa de Ayuda, la persona de soporte recibe los casos, los cuales deben ser asignados a un tcnico que este disponible. El caso hace referencia a una coleccin llamada Tcn ico s d isp o n ib les, la cual contiene los usuarios que tienen la habilidad IT y co n o cim ien to d e red es. Para llenar la coleccin es necesario obtener los tcnicos calificados de la entidad WFUser, basndose en sus habilidades.

1. En el cuarto paso del asistente, seleccione Acciones de la Actividad. Luego de clic en la primera

1154

Copyright 2013 - Bizagi

tarea del proceso y cree una expresin Al entrar.

2. Cree dos elementos de expresin un elemento FOR como se muestra a continuacin. En el primer elemento expresin, declare las variables y obtenga la lista de usuarios con la habilidad especfica. Utilice el mdulo FOR para iterar sobre cada registro e la lista. En el otro elemento expresin, incluya cada registro a la coleccin A v ailab leTech n itian s.

Copyright 2013 - Bizagi

1155

3. En el mdulo de la primera expresin declare las siguientes variables: UserArray: Guarda la lista de usuarios que pertenecen a la habilidad especfica. IterationIndex: Contador para el ciclo FOR. TempIdUser: Guarda temporalmente un registro especfico de la lista de usuarios. newRow: Crea un nuevo registro en la relacin donde se incluir el usuario.

4. Obtenga una lista de usuarios con la posicin deseada utilizando la funcin Get u sers in Skill de la categora Usu ario s.

//Obtener la lista de usuarios con un rol especfico y guardarla en una variable UsersArray=CHelper.getUsersForSkill(1); 5. Itere la lista utilizando un elemento FOR. El ciclo comienza en Cero (0) y termina en el ltimo ndice de la lista. La sentencia UsersArray.Count regresar el nmero total de usuarios encontrados (es decir, cuenta los elementos del arreglo).

1156

Copyright 2013 - Bizagi

El ciclo ser ejecutado mientras que el ndice de la coleccin sea menor que el nmero total de elementos del arreglo.

6. Incluya el siguiente cdigo en el segundo elemento de expresin para obtener el identificador del usuario. Luego, cree una nueva fila en la coleccin A v ailab le Tech n ician s. Agregar del id del tcnico en la nueva lnea.

//Obtener la identificacin del usuario de la iteracin actual del arreglo. TempIdUser=UsersArray(IterationIndex); //Agregar un nuevo registro a la coleccin AvailableTechnicians newRow=Me.addRelation("Ticket.AvailableTechnicians"); //Asigne a la columna Technician el userid obtenido previamente. newRow.setXPath("Technician",TempIdUser"); La coleccin se mostrar en el Portal de Trabajo de la siguiente forma:

Copyright 2013 - Bizagi

1157

3.5.5.14 Definir y utilizar secuencias Las secuencias son contadores que se incrementan de acuerdo a un valor definido en cada invocacin. Las secuencias pueden ser usadas en ms de un proceso y son globales en el proyecto. Las secuencias se utilizan normalmente para garantizar un valor nico para los atributos asociados a un caso especfico o para utilizar nmeros de casos personalizados.

Utilizando una secuencia para guardar un nmeros consecutivos en atributos.

Suponga que tiene un proceso de Matrcula de estudiantes donde el departamento administrativo de la universidad registra y matrcula estudiantes. Una vez, un estudiante ha sido matriculado, se genera un nmero consecutivo para identificar al estudiante en la universidad. Este nmero aparecer en el carnet de identificacin del estudiante. Est es el Modelo de datos del proceso.

Para crear una secuencia siga los siguientes pasos:

1158

Copyright 2013 - Bizagi

1. Vaya a la vista de Mdulos y abra la pestaa de Configuracin, luego de clic en Secuencia.

2. En la nueva ventada de clic en Adicionar para incluir una nueva secuencia.

El primer campo es Id, el cual ser evaluado automticamente por Bizagi. Asigne un nombre a la secuencia. El nombre no debe contener caracteres especiales como espacios, tildes o smbolos. Especifique el valor de la semilla el cual es el valor inicial de la secuencia, este debe ser un valor numrico.

Copyright 2013 - Bizagi

1159

Asigne el valor del incremento el cual corresponde a la cantidad en que se incrementar la semilla. Debe ser un valor numrico. En nuestro ejemplo, el valor inicial es 0 (semilla) y ser incrementado en 1 (Incremento) cada vez que un estudiante se matricule. Clic en Ok para guardar los cambios.

3. En el paso cuatro del Asistente seleccione la opcin A ccio n es d e la A ctiv id ad. Clic en la tarea donde se asignar la secuencia a un atributo, luego cree una expresin.

1160

Copyright 2013 - Bizagi

4. Cree una expresin para asignar el nmero de identificacin. Vamos a asignar el valor del nmero de secuencia al atributo N m ero d e Id en tificaci n In tern a. Utilice la funcin Get n ex t seq u en ce v alu e de la categora M isceln eo s para obtener el siguiente nmero de la secuencia.

La expresin debe quedar as:

//Asignar el siguiente nmero de la secuencia en un atributo.

Copyright 2013 - Bizagi

1161

<StudentApplication.InternalIdentificationNumber>=CHelper.GetNextSeqValueSt r("InternalIdentificationNumber");

Utilice una secuencia para personalizar el nmero del caso

Por defecto Bizagi asigna un Nmero de caso para cada instancia de un proceso utilizando una secuencia interna que evita duplicidad y conflictos. Usted querr personalizar los nmeros de identificacin para todos sus procesos o para algunos de ellos. En tal caso, Bizagi permite definir sus propios nmeros de casos utilizando una secuencia personalizada y utilizando prefijos y sufijos. Clic para ms informacin sobre cmo personalizar el nmero de caso utilizando secuencias. 3.5.5.15 Ejecutar eventos

Informacin General
La funcin setEv en t se utiliza para ejecutar un evento disponible en Bizagi. Por ejemplo, se puede utilizar para activar un evento dando clic en el botn siguiente utilizando una expresin. La funcin se puede ejecutar en eventos de un proceso activo o de un proceso externo. La sintaxis de la funcin es:

CHelper.setEvent(Me,Caseid,"Event name",null)
Los parmetros de la funcin son: El Caseid: el nmero de identificacin del caso del en que el evento ser lanzado. El nombre del ev en to : El nombre del evento que ser ejecutado. El primero y el ltimo de los parmetros sern fijos (M e an d n u ll). La funcin setEvent se encuentra en la categora P ro ceso .

1162

Copyright 2013 - Bizagi

Ejemplo
Tomemos el proceso de Mesa de Ayuda para el ejemplo. Una vez el caso es creado, se habilita un evento que permite cerrar el caso en cualquier momento, tal como se muestra en el siguiente flujo de proceso

Copyright 2013 - Bizagi

1163

La tarea A n alizar y Reso lv er tiene un botn que cierra automticamente el caso cuando se da clic sobre l. El botn llama al evento Cerrar caso , el proceso contina hasta el evento de Fin y el caso quedar cerrado. Para configurar el cierre del caso a travs del evento, siga el siguiente procedimiento: 1. En la forma de la tarea Analizar y Resolver incluya un botn, nmbrelo Cerrar Caso. Asocie una expresin cmo se muestra en la siguiente imagen.

2. En la expresin, incluya en elemento de expresin. Seleccione la funcin setEv en t.

1164

Copyright 2013 - Bizagi

3. Valores de los parmetros de la funcin setEv en t. El Caseid se obtiene utilizando la funcin M e.Case.Id, la cual retorna el ID del caso actual.

El nombre del evento es Cerrar Caso . Usted puede verificar el nombre en las propiedades del evento en el primer paso del asistente.

Copyright 2013 - Bizagi

1165

CHelper.setEvent(Me,Me.Case.Id,"CloseCase",null); Guarde la expresin. Luego cuando de clic en el botn Cerrar Caso desde el Portal de Trabajo para probar la regla.

3.5.5.16 Obtener los usuarios que han trabajado en un caso

Obtener la lista de usuarios que han trabajado en un caso

Usted puede obtener los usuarios que han trabajando en un caso utilizando la funcin CH elp er.g etCaseUsers(). Esta funcin retorna una lista con los ids de los usuarios que han trabajado en un caso particular. El N m ero d e Caso debe ingresarse como parmetro de entrada.

1166

Copyright 2013 - Bizagi

La sintaxis de la funcin es:

CHelper.getCaseUsers(CaseNumber) ;
En un proceso de Mesa de Ayuda varias personas pueden atender un Ticket. Es posible que se requiera llevar un registro de los usuarios que han trabajado en un caso especfico para propsitos de anlisis y trazabilidad. Para obtener este log usted debe almacenar la lista de usuarios que han trabajado en un Ticket en una coleccin denominada UsersLo g (que se muestra en el siguiente modelo de datos).

Para obtener esta lista de usuarios usted puede utilizar la funcin CH elp er.g etCaseUsers . Incluya una expresin como una accin a la entrada de una actividad y utilice esta funcin (junto con otras) para obtener y almacenar la lista de usuarios deseados en la coleccin UsersLo g .

Copyright 2013 - Bizagi

1167

//Obtenga los usuarios var CaseUsers=CHelper.getCaseUsers(Me.Case.CaseNumber); //Navegue la lista de usuarios for (var i=0; i<CaseUsers.Count; i++) { //Por cada usuario cree un registro en la coleccin Users Log var NewRow=Me.addRelation("Ticket.UsersLog"); NewRow.setXPath("Users",CaseUsers[i]); } La tabla resultante se muestra en el Protal de Trabajo de la siguiente manera:

1168

Copyright 2013 - Bizagi

3.5.5.17 Usar .id con XPath La sentencia .id despus de un XPath podra requerirse o no dependiendo de lo que usted desee hacer.

Cuando se agregan elementos a una coleccin

Imangine un Processo de Solicitud de Crdito Personal donde hay varios productos en cada solicitud. Hay una relacin uno a muchos entre la Entidad de Proceso So licitu d y la Entidad de coleccin P ro d u cto s. La entidad uno se denomina So licitu d. La entidad coleccin se denomina P ro d u cto s. La relacin es So licitu d _P ro d u cto s. Productos tiene un atributo llamado Valo r. Usted necesita agregar un nuevo producto a la coleccin con US$10.000 como valor. Utilice las siguientes declaraciones: USE: var NuevoProducto = Me.addRelation(idSolicitud.Solicitud_Productos); NuevoProducto.setXPath(Valor, 10000); NO USE: NuevoProducto.setXPath(idSolicitud,<idSolicitud.id>); Esta ltima declaracin perjudica la relacin debido a que la funcin addRelation llena el id del atributo automticamente..

Cuando utilice un setXPath con asignacin directa

Copyright 2013 - Bizagi

1169

Cuando usted utiliza la declaracin serXPath, asigne el objeto y no el entero de la relacin. Utilizando la imagen que se muestra a continuacin, imagine que usted tiene un Proceso de Mesa de Ayuda que gestiona reportes de incidentes (o tickets) con el fin de minimizar interrupciones en los servicios de tecnologa de la informacin. De acuerdo a cmo evoluciona el ticket en el proceso cambiar su estado. Hay una relacin de entidad-relacionada entre la Entidad de Proceso denominada Ticket y la entidad paramtrica denominada Estado. Los valores se muestran a continuacin:

Utilizamos un elemento de asignacin para establecer el estado del Ticket. Como el Ticket es recibido por el departamento de Mesa de Ayuda, su estado ser A b ierto . USE var Estado = CHelper.getEntityAttrib("HelpDeskCaseStatus","idStatus","Code = 1",""); <Ticket.Status> = Estado; NO USE: var Estado = CHelper.getEntityAttrib("HelpDeskCaseStatus","idStatus","Code = 1",""); <Ticket.Status.id> = Estado; NO USE: var Estado = CHelper.getEntityAttrib("HelpDeskCaseStatus","idStatus","Code = 1",""); <Ticket.Status> = Status.id;

1170

Copyright 2013 - Bizagi

Cuando se utilice setXPath en la funcin addRelation

Cuando utilice la funcin addRelation usted necesita asignar los XPaths a los atributos del nuevo registro de la coleccin. Hay un caso especial donde usted debe utilizar .id: Cuando la sentencia setXPath incluya una sentencia getXPath para asignar un valor. Imagine que usted tiene un Proceso de Solicitud de Compras que puede incluir muchos clientes. Por lo tanto, hay una relacin uno a muchos entre la Entidad de Proceso SolicituddeProductos y Clientes. Tambin hay una relacin de atributo relacionado entre SolicituddeProductos y Clientes que almacena el cliente principal de la solicitud. Usted necesita agregar a la coleccin de clientes el nombre del cliente principal y su estado. La entidad de Proceso se denomina So licitu d d eP ro d u cto s. La entidad coleccin se denomina Clien tes. La relacin de entidad relacionada es Clien teP rin cip al La relacin es So licitu d d eP ro d u cto s_Clien tes Clientes tiene un atributo llamado N o m b re var AgregarCliente=Me.addRelation("SolicituddeProductos.SolicituddeProductos_Clientes"); AgregarCliente.setXPath("NombreCliente",Me.getXPath("ClientePrincipal.Nombre")); AgregarCliente.setXPath("Estado",Me.getXPath("ClientePrincipal.Estado.id"));

Cuando se utilice getXPath con una coleccin filtrada

Cuando utilice la funcin getXPath en colecciones y necesite un filtro en una tabla con una variable, usted necesita utilizar .id. Imagina que usted tiene una Poltica de Suscripcin Colectiva donde hay muchos vehculo para cada solicitud. Usted necesita saber cuantos vehculos hay de un cierto tipo en una solicitud. Hay una relacin uno a muchos entre la Entidad de Proceso So licitu d y la entidad coleccin Veh cu lo s. La entidad uno se denomina So licitu d. La entidad coleccin se denomina Veh icu lo s. La relacin es So licitu d _Veh icu lo s Los Productos tienen un atributo denominado Tip o d eVeh icu lo que esta relacionado a la entidad paramtrica. USE var idTipodeVehiculo = CHelper.getEntityAttrib("TipodeVehiculo","idTipo","Code = 1",""); var CuentadeVehiculos = Me.getXPath("count(Solicutud.Solicitud_Vehiculos["TipodeVehiculo.id = "+idTipodeVehiculo+"])"); NO USE var idTipodeVehiculo = CHelper.getEntityAttrib("TipodeVehiculo","idTipo","Code = 1",""); var CuentadeVehiculos = Me.getXPath("count(Solicutud.Solicitud_Vehiculos["TipodeVehiculo.id = "+idVehicleType.id+"])");

Copyright 2013 - Bizagi

1171

3.5.5.18 Adicionar registros a tablas dentro de tablas Imagine un proceso de solicitud de compra donde de forma predeterminada un producto se aade a la solicitud cuando se inicia un caso y algunos proveedores se aaden al producto. Por lo tanto, se crea un registro en una coleccin de productos y luego se agrega un registro a una coleccin interna, de Proveedores, dentro de dicho producto. Hay una relacin uno-a-muchos entre la Entidad de Proceso de Solicitud y la coleccin ProductsRequested. Hay una relacin uno-a-muchos entre la Entidad ProductsRequested y la entidad de coleccin PossibleSuppliers. La un entidad de Proceso se se llama PurchaseRequest. La entidad coleccin se llama ProductsRequested. La segunda coleccin se llama PossibleSuppliers

Se crea una expresin al Entrar en el proceso Solicitud de Compra para adicionar productos y proveedores. La siguiente es la lista de variables creadas en la expresin.

1172

Copyright 2013 - Bizagi

Lo primero que se debe hacer es crear los registros de la coleccin producto, que es la primera tabla.

ProdType = CHelper.getEntityAttrib("Producttype","idProducttype","Code = '1'","") Product = Me.addRelation("PurchaseRequest.ProductsRequested") Product.setXPath("Producttype",ProdType); Product.setXPath("Quantity",10); Una vez adicionados los producto (en este caso slo se adicion uno) se realiza un Iterate Over Xpath para recorrer la coleccin de productos y adicionar proveedores dentro de dicha coleccin.

Copyright 2013 - Bizagi

1173

Finalmente se adicionan los registros de la tabka paramtrica Proveedor a cada registro de la coleccin de Productos. La sentencia Me.addRelation cambia, para que Me tome el valor de la variable que recorre los productos en el Iterate.

1174

Copyright 2013 - Bizagi

Supplier = CEntityManager.GetEntity("Supplier").GetEntityList("","","",""); for(var i=0;i<Supplier.Length;i++) { NewSupplier= NewProducts.addRelation("Possiblesuppliers"); NewSupplier.setXPath("Supplier",Supplier[i].SurrogateKeyValue); } 3.5.5.19 Guardar el valor total de una columna Imagine un proceso de solicitud de compra en la que desea conocer el precio total de su compra, mientras se agregan los productos. Este valor se utilizar luego para calcular descuentos y se enviar al centro de costo del solicitante. Por ello el total debe ser mostrado en el Portal de Trabajo al crear la compra, y tambin tiene que ser almacenado en un atributo. Nota: Para visualizar el valor total de una columna sin necesidad de almacenarla consulte: totalizadores. Por lo tanto, se crea un atributo para almacenar dicho valor: Estimacin del costo total ( To tal Co st Estim ate). La siguiente imagen muestra el modelo de datos para este ejemplo: Hay una relacin uno-a-muchos entre la Entidad de Proceso, So licitu d y la coleccin P ro d u ctsReq u ested. La una de proceso se llama So licitu d (Request). La entidad coleccin se llama P ro d u ctsReq u ested.

Copyright 2013 - Bizagi

1175

1. Cree una expresin Al Guardar para calcular el costo total cada vez que un producto se aada a la tabla. Incluya un mdulo de asignacin.

1176

Copyright 2013 - Bizagi

2. Haga doble clic en el mdulo de asignacin de editar su contenido. Haga clic en A g reg ar para incluir una nueva lnea (asignacin de la informacin):

Copyright 2013 - Bizagi

1177

3. En el combo de seleccin de variable elija el atributo de su modelo de datos que almacenar el total.

1178

Copyright 2013 - Bizagi

4. A continuacin, asegrese de asignar a su atributo de un XPath. Seleccionar XP ath y haga clic en el botn Xpath. Para la definicin XPath, vaya a la coleccin de su modelo de datos y seleccione el atributo especfico que desea sumar. A continuacin, seleccione de la lista desplegable de la esquina superior derecha, la funcin de Suma:

Copyright 2013 - Bizagi

1179

5. Haga clic en A cep tar y guarde toda la expresin. 6. En la Forma ingrese el atributo que guarda el total y djelo No editable. Cuando se agregue un producto a la tabla, el Total se calcular de acuerdo a la expresin anterior.

3.5.5.20 Acceder al isimo registro de una coleccin En algunas situaciones es necesario obtener o manipular la informacin de un registro especfico en una coleccin. Para ello no es necesario iterar sobre toda la coleccin y detenerse cuando se encuentre el registro deseado. Al conocer la posicin del registro de la coleccin, se puede acceder fcilmente a l a travs de una expresin. La sintaxis que se utiliza para acceder a esta informacin es la siguiente: Para obtener informacin

1180

Copyright 2013 - Bizagi

Collection.get(index of the record). getXPath("Attribute")

Para asignar un valor

Collection.get(index of the record). setXPath("Attribute",value)

Supongamos que una empresa utiliza Bizagi para sortear diferentes premios entre sus clientes. Un servicio externo genera un nmero aleatorio que representa la posicin del cliente, dentro de la coleccin de clientes. Como el nmero de clientes puede ser muy grande, el nombre del ganador se almacena en un atributo de tipo de string. Una vez obtenida esta informacin, el cliente se identifica como ganador en la base de datos, con el fin de que excluirlo en futuros sorteos. El siguiente es el modelo de datos asociado al proceso:

Para obtener la informacin del ganador, desde la coleccin del clientes, siga los pasos descritos a continuacin: 1. Vaya a la actividad en la que se realiza el sorteo y cree una expresin a la entrada. A continuacin, cree un mdulo de expresin.

Copyright 2013 - Bizagi

1181

2. El nmero aleatorio generado por el servicio externo se almacena en el atributo W in n erIn d ex . Escriba la siguiente expresin para obtener el nombre del ganador de la coleccin de los clientes. Este se almacena en el atributo W in n erN am e.

1182

Copyright 2013 - Bizagi

//Obtenga el indicie del ganador dentro de la coleccin de clientes WinnerIndex=<Raffles.WinnerIndex> //Obtenga la coleccin de clientes Clients=Me.getXPath("Raffles.Clients"); //Obtenga el nombre del ganador utilizando el indice del cliente dentro de la coleccin de clientes <Raffles.WinnerName>=Clients.get(WinnerIndex).getXPath("Name"); 3. Ahora, para identificar al cliente como un ganador use la siguiente lnea. Esto asignar al atributo W in n er del ganador, el valor true.

//Actualice la informacin del ganador utilizando el indice del cliente dentro de la coleccin de clientes Clients.get(WinnerIndex).setXPath("Winner",true); 4. Finalmente vaya al Portal de Trabajo para probar la expresin.

Copyright 2013 - Bizagi

1183

3.5.5.21 Usar Me.Context Esta funcin es til en reglas que manejan contextos diferentes a los de la Entidad de Proceso. Otros usos de M e.Co n tex t son: Cuando las reglas van a ser usadas como reglas de visibilidad, de edicin o de naturaleza obligatoria de atributos, el contexto de la regla es la entidad de la forma. Cuando las reglas van a ser usadas en un botn que est en una Forma para editar o agregar a entradas en una tabla. En estos casos, el contexto de la regla debe ser la entidad Muchos de la relacin (N). Es decir, la entidad de la tabla. Cuando las reglas van a ser usadas en botones que estn en Formas, el contexto es la entidad en donde el botn est siendo llamado. Cuando las reglas van a ser usadas como reglas para filtrar informacin desde un combo o una ventana de bsqueda. En estos casos, el contexto de la regla debe ser la entidad en donde el combo, o la ventana de bsqueda, est localizado.

Ejemplo
En un P ro ceso d e so licitu d d e crd ito el ingreso de los clientes es una variable importante. De acuerdo con las polticas del banco, un prstamo no puede ser concedido a un cliente que tiene un ingreso anual menor a U$15,000 y todo cliente con un ingreso anual mayor a U$90,000 ha de ser

1184

Copyright 2013 - Bizagi

verificado. Las validaciones que son requeridas sern controladas desde la actividad de A n lisis d e so licitan tes, con el fin de dar retroalimentacin inmediata al cliente y asegurar que solo casos vlidos llegan a la actividad Verificar in fo rm aci n d e so licitan tes.

La informacin en la actividad de A n lsis d e so licitan tes se muestra de la siguiente manera:

Si el cliente posee un ingreso menor a $15,000, se debera mostrar un mensaje al usuario al momento de editar la informacin del cliente, tal como se muestra:

Copyright 2013 - Bizagi

1185

Para configurar esta validacin usted debe utilizar una Valid aci n d e fo rm a. Como el contexto de la forma donde se edita la informacin del cliente es diferente al de la En tid ad d e P ro ceso , se utiliza M e.Co n tex t para comprobar que cada cliente cumple con las polticas de ingresos. Estas validaciones se realizan teniendo en cuenta el siguiente modelo de datos.

Note que una solicitud puede tener ms de un cliente y un cliente puede estar en ms de una solicitud (relacin de muchos a muchos).

1186

Copyright 2013 - Bizagi

1. Vaya al tercer paso del asistente de procesos y d clic en la actividad A n lisis d e so licitan tes. 2. Vaya a la pestaa A v an zad o de la coleccin de Clien tes. Asuma que ya hemos configurado una forma de edicin para esta coleccin.

3. D clic en el icono de expresin de la propiedad Ex p resi n d e v alid aci n , bajo las opciones de edicin, y cree una expresin de scripting.

Copyright 2013 - Bizagi

1187

4. En un elemento de expresin obtenga los valores a comparar (ingreso mximo, ingreso mnimo e ingreso del cliente).

1188

Copyright 2013 - Bizagi

Valide si el ingreso del cliente es menor al ingreso mnimo. En este caso ser necesario mostrar un mensaje de validacin.

Ahora valide si el ingreso del cliente es mayor al ingreso mximo. Utilice M e.Co n tex t para asignar el indicador de los clientes cuyo ingreso debe ser verificado.

Copyright 2013 - Bizagi

1189

//Obtenga los valores a comparar HighIncome=90000; LowIncome=15000; CustomerIncome=Me.Context.getXPath("Customer.Income"); //Evale si el ingreso del cliente es menor al ingreso mnimo if (CustomerIncome<LowIncome) { CHelper.ThrowValidationError("The income is too low to apply for this loan") } //Evale si el ingreso del cliente es mayor al ingreso mximo if (CustomerIncome>HighIncome) { Me.Context.setXPath("VerifyIncome",true); }

3.5.6

Manejo de archivos con expresiones

Informacin general
Esta seccin muestra cmo ejecutar acciones avanzadas con atributos de tipo archivo. Algunas acciones avanzadas para este tipo de atributo son: Cargar un archivo utilizando una expresin Copiar el contenido de un archivo a otro Contar el nmero de archivos cargados Obtener el nombre de un archivo cargado Validar los nombres de los archivos Cargar un archivo utilizando la capa SOA

1190

Copyright 2013 - Bizagi

Nota Atributos de tipo archivo son manejados como colecciones de archivos. Es decir, es posible adjuntar varios archivos en un solo atributo.

Artculos relacionados
Atributos tipo archivo 3.5.6.1 Cargar un archivo utilizando una expresin En Bizagi es posible adjuntar cualquier archivo en un atributo de tipo Archivo sin ser necesario utilizar una expresin para adjuntar el contenido del archivo (cmo arreglos estticos de tipo SB y te) Por ejemplo, en el proceso de Solicitud de crdito la entidad de proceso se llama Solicitud. Asuma que en esa entidad existe un atributo de tipo archivo llamado H isto ry F ile el cual guarda una carta subida desde un servicio Web.

El servicio Web retorna un Bytes Array que contiene la informacin del archivo. Asuma que el arreglo se guarda en la variable F ileData. Para adjuntar un archivo utilizando una expresin debe incluir el siguiente cdigo: var FileToUpload = Me.addRelation("Request.HistoryFile"); FileToUpload.setXPath("FileName", "DisplayNameOfTheFile.txt"); FileToUpload.setXPath("Data", FileData)

F ileN am e y Data (se muestran en rojo) NO deben cambiar. Son parte del cdigo.
Note que los parmetros son componentes de un atributo de tipo archivo. El nombre visual del archivo, Data contiene la informacin del archivo.

Copyright 2013 - Bizagi

1191

Note que la expresin es similar a las utilizadas para incluir registros dentro de una coleccin. Esto es porque los atributos de tipo archivo son tratados como coleccin de archivos, por lo cual es posible adjuntar varios archivos en un solo atributo. El archivo adjunto se ver de la siguiente forma:

Clic para saber cmo obtener la ruta de un archivo adjunto en Bizagi. 3.5.6.2 Copiar el contenido de un archivo de un atributo a otro Es posible copiar el contenido de un atributo tipo archivo a otro atributo del mismo tipo. Recuerde que un atributo tipo archivo puede contener varios archivos. En el siguiente ejemplo, los archivos adjuntos en el atributo Do cu m en ts sern copiados en el atributo Do cu m en tsB acku p para crear una copia de seguridad de los archivos subidos durante el proceso. Estos atributos estn en la entidad de proceso (llamado B u sin ess O p p o rtu n ity).

1192

Copyright 2013 - Bizagi

La expresin lucir de la siguiente manera:

//Tomar el arreglo de los archivos var OriginalFile = Me.getXPath("BusinessOpportunity.Documents"); //Navegue a travs del arreglo for(var i=0; i < OriginalFile.size(); i++) { //Obtenga el archivo original var FileCopy = OriginalFile.get(i); var Name = FileCopy.getXPath("FileName"); var Data = FileCopy.getXPath("Data"); //Copie el archivo en la copia

Copyright 2013 - Bizagi

1193

var NewFile = Me.addRelation ("BusinessOpportunity.DocumentsBackup"); NewFile.setXPath("FileName", Name); NewFile.setXPath("Data", Data); } La siguiente expresin contiene el arreglo de archivos guardados en el atributo de tipo archivo Do cu m en ts. Luego navegue a travs del arreglo para obtener el nombre y la informacin del archivo original. Finalmente cada archivo (nombre y su contenido) es copiado en el atributo Do cu m en tsB acku p . 3.5.6.3 Contar el nmero de archivos cargados Cada atributo de tipo archivo puede guardar una coleccin de archivos. Si desea saber cuantos archivos se han subido a un atributo se debe utilizar la p ro p ied ad tam a o (size). En la siguiente imagen, se ha creado una expresin para contar el nmero de archivos adjuntos en el atributo Do cu m en ts de la entidad B u sin essO p p o rtu n ity. La propiedad tamao del objeto se utiliza para retornar el resultado a travs de un error de validacin ThrowValidationError. La expresin se ejecuta cuando se da clic en el botn Guardar en la forma donde se esta probando la regla.

//Tomar el arreglo de los archivos var OFiles=Me.getXPath("BusinessOpportunity.Documentos"); //Mostrar el mensaje CHelper.ThrowValidationError("Number of Files Uploaded = " + OFiles.size ());

1194

Copyright 2013 - Bizagi

Primero, la expresin obtiene un arreglo de los archivos guardados en el atributo Documents. Un mensaje se muestra al usuario final utilizando una validacin. En este caso el nmero de archivos adjuntos es obtenido utilizando la propiedad .size. Cuando el atributo no tiene archivos adjuntos, el mensaje debe regresar 0.

Por otro lado, cuando hay dos o n archivos adjuntos, este nmero debe ser mostrado en el mensaje de retorno. Este comportamiento se muestra en la siguiente imagen.

Copyright 2013 - Bizagi

1195

3.5.6.4

Obtener el nombre del archivo cargado En muchas situaciones es desea obtener el nombre de un archivo cargado previamente para ejecutar diferentes acciones, por ejemplo, validar si el archivo tiene una extensin especfica, el nmero de caracteres, etc. Para obtener el nombre del archivo cargado es necesario crear una expresin. En ella se obtiene una lista de los archivos cargados en el atributo, y luego es posible recorrer el arreglo para extraer el nombre de cada uno de ellos. La siguiente expresin muestra cmo el nombre del archivo almacenado en el atributo Do cu m en ts (de la entidad Business Opportunity) es obtenido, suponga que solamente se ha cargado un archivo en el atributo. El nombre obtenido se muestra al usuario a travs de un mensaje de validacin utilizando la funcin CHelper.ThrowValidationError. La expresin se ejecuta cuando se da clic en el botn guardar en la forma donde se est probando la regla.

1196

Copyright 2013 - Bizagi

//Obtener el arreglo de archivos var UploadedFile = Me.getXPath("BusinessOpportunity.Documents"); //Validar que el arreglo contenga algn registro if(UploadedFile.size() > 0){ //Obtener el archivo. Recuerde, estamos asumiendo que solamente hay un archivo, por lo que la posicin del arreglo es 0. var Filename = UploadedFile.get(0).getXPath("FileName"); // Mostrar el nombre del archivo CHelper.ThrowValidationError("File name =" + Filename); } En el Portal de Trabajo puede probar desde la forma donde configur la expresin, que el nombre del archivo es retornado correctamente.

Copyright 2013 - Bizagi

1197

3.5.6.5

Validar el nombre de los archivos Es posible que se requiera validar el nombre de un archivo cuando se est cargando. Suponga que una compaa est siendo auditada. Cada rea de la organizacin debe enviar varios reportes a la compaa auditora. Para poder mantener orden en la recepcin y consulta de la informacin recibida los nombres de los archivos deben cumplir ciertos criterios establecidos. Por ejemplo, el rea financiera de la compaa debe incluir el balance financiero en un archivo de Excel con el nombre Co m p an y B alan ce.x ls. Para predefinir los nombres de los archivos adjuntos vamos a utilizar vocabularios. Clic para ms informacin sobre vocabularios. En este caso vamos a definir un vocabulario de tipo string. Llmelo B A LA N CE e incluya como valor Co m p an y B alan ce.x ls (el nombre deseado).

1198

Copyright 2013 - Bizagi

En la forma de la actividad donde se carga el archivo se debe definir las propiedades deseadas para el archivo. Clic en el atributo archivo y dirjase al men Propiedades. Defina el mximo nmero de archivos permitidos y la extensin valida. En est caso solamente tenemos un archivo cargado. Solamente se pueden cargar archivos de Microsoft Excel con extensin .x ls dentro del campo.

Se debe crear una regla de negocio para validar el nombre del archivo. La expresin se crea Al Salir de la actividad.

Copyright 2013 - Bizagi

1199

// Guarde el vocabulario var DesiredFileName=CHelper.resolveVocabulary(Me,"BALANCE") var UploadedFile = Me.getXPath("Process.Attribute"); // Guarde el nombre del archivo var TargetFile = UploadedFile.get(0); var FileName = TargetFile.getXPath("FileName"); // Valide el nombre real contra el deseado if (FileName!=DesiredFileName) { //Lance la validacin CHelper.ThrowValidationError("The file must have the same name of the vocabulary") } En el ejemplo anterior hemos guardado la definicin del vocabulario (nombre predefinido del archivo) en la variable Desired F ileN am e. Luego obtenemos el nombre del archivo cargado en la actividad y lo guardamos en la variable F ileN am e. Finalmente comparamos los dos valores, si no coinciden, se muestra un mensaje de error. De esta forma, si usted carga un archivo con otro nombre, se mostrar un mensaje de validacin solicitado ingresar el archivo con el nombre correcto.

1200

Copyright 2013 - Bizagi

3.5.6.6

Obtener la ruta del archivo cargado en Bizagi Este artculo describe el procedimiento correcto para obtener el camino para cargar un archivo, a travs de una expresin. Lo siguiente aplica para aquellos archivos cargados en un atributo de tipo archivo en Bizagi. Archivos cargados en proyectos de Bizagi se guardan en un servicio web definido en la ruta de las opciones de configuracin avanzadas del Entorno. Sin embargo, dentro de la carpeta, la estructura de las sub carpetas es organizada como se muestra a continuacin:

\IdEntity\WholePart\SurrogateKey\IdAttribute\
IdEntity: Es el Id de la entidad en la cual se encuentra el atributo tipo archivo. Para conocer el id de la entidad es necesario realizar una consulta sobre la tabla ENTITY de su proyecto. Est es informacin esttica que se mantendr igual desde la creacin de la entidad en Bizagi Studio. SurrogateKey: Es el valor de la llave de la instancia de la entidad, donde se encuentra el atributo de tipo archivo. Para conocer este valor, es necesario obtener la entidad deseada y realizar checkout del .SurrogateKeyValue. Esto es informacin dinmica, por lo que la informacin se conoce en tiempo de ejecucin ya que cada caso del proceso tendr un valor diferente. WholePart: Se define como el nmero completo de dividir SurrogateKeyValue por 1000. Tambin se puede obtener realizando el siguiente clculo: WholePart = (SurrogateKey - (SurrogateKey Module 1000)) / 1000 De nuevo, esta informacin es dinmica y se deriva de SurrogateKeyValue. IdAttribute: Es el id del atributo tipo archivo que contiene el archivo cargado. Para conocer el id del atributo, es necesario realizar una consulta sobre la tabla ATTRIB del proyecto. Est es informacin

Copyright 2013 - Bizagi

1201

esttica que se mantendr igual desde la creacin de la entidad en Bizagi Studio.

Ejemplo
Un archivo es cargado en la entidad P ro d u cts (id 10043 en ENTITY). El nombre del atributo en Products que guarda el archivo se llama Do cu m en t (id 10010 en ATTRIB) Tambin se necesita la siguiente informacin del caso: IdEntity: 10043. IdAttribute: 10010. SurrogateKey: 205 (obtenido del caso creado) Whole part: 0 (Whole part = (205 - 205) / 1000) Asuma que la ruta de carga configurada en Bizagi Studio para el proyecto es: C:\B izA g i\Xp ress\P ro jects\P ro ject01\Do cs\. La ruta completa para acceder al archivo ser: C:\B izA g i\Xp ress\P ro jects\P ro ject01\Do cs\10043\0\205\10010\. Si el archivo cargado se llama: OctoberBalances.xls , su archivo estar disponible en: C :\B izA g i\Xp ress\P ro jects\P ro ject01\Do cs\10043\0\205\10010\O cto b erB alan ces.x ls. Para conocer cmo obtener el fileName del proyecto dinmicamente, utilice una expresin getXPath similar a la descrita en la seccin Cargar archivos utilizando expresiones. Nota En el ejemplo anterior hemos asumido que el proyecto fue creado en la edicin Bizagi Xpress Edition, por lo cual la parte inicial de la ruta es: C:\B izA g i\Xp ress\P ro jects. Si est utilizando Bizagi Entrerprise Edition la ruta ser: C:\B izA g i\En terp rise\P ro jects

3.5.6.7

Cargar un archivo utilizando capa SOA A menudo, es necesario enviar archivos desde un sistema externo a Procesos de Bizagi (como archivos adjuntos). Esto se realiza a travs de la capa SOA de Bizagi mediante el envo de la informacin a travs de mtodos Web de la capa de SOA en el estndar XMLs. Para enviar archivos a Bizagi travs de sus servicios web, tenga en cuenta lo siguiente: Especifiqu el nombre del archivo (para un atributo de tipo archivo del modelo de datos de Bizagi), a travs de un atributo XML llamado nombre de archivo del atributo archivo. Enve el contenido del archivo en una cadena como base-64, como el valor en el interior del elemento del archivo. El siguiente ejemplo de un XML enviado a Bizagi ilustra la idea:

1202

Copyright 2013 - Bizagi

El siguiente ejemplo de un XML enviado a Bizagi ilustra la idea: En este caso, la entidad llamada In cid en t, se relaciona con la entidad de aplicacin con una relacin de atributo llamada Incidente. La entidad Incident tiene un atributo de tipo archivo llamado M y F ile. Por lo tanto, para el atributo M y F ile, es necesario incluir en el XML un elemento obligatorio llamado Archivo. El siguiente cdigo es un ejemplo de un XML que enva un archivo adjunto. El ejemplo llama un sistema externo que crea un nuevo caso en Bizagi; el nuevo caso tendr el archivo cargado. Este XML sirve como plantilla para enviar el archivo en la creacin del caso.

A continuacin tenemos un cdigo sencillo en C#, en el cual se selecciona el archivo y se adjunta al XML. El cdigo contiene comentarios con la explicacin. private void button2_Click(object sender, System.EventArgs er) { //Abra el archivo a enviar

Copyright 2013 - Bizagi

1203

if(openFileDialog1.ShowDialog() == System.Windows.Forms.DialogResult.OK) { //Obtenga el nombre del archivo string file_name = openFileDialog1.FileName.Substring (openFileDialog1.FileName.LastIndexOf("\\") + 1); //Cargue el archivo dentro de un Stream Stream fileStream = openFileDialog1.OpenFile(); //El fileStream se carga en un BinaryReader BinaryReader binaryReader = new BinaryReader(fileStream); //Lea los bytes y gurdelos en un arreglo. byte[] oBytes = binaryReader.ReadBytes(Convert.ToInt32 (fileStream.Length)); //Cargue el StringBuilder vaco en un XmlWriter. System.Text.StringBuilder sb = new System.Text.StringBuilder (); TextWriter tw = new StringWriter(sb); XmlTextWriter m_XmlWriter = new XmlTextWriter(tw); //Transforme los bytes del StringBuilder en Base64. m_XmlWriter.WriteBase64(oBytes, 0, oBytes.Length); //Obtenga (o genere) el XML a ser enviado a la capa SOA. XmlDocument xml = new XmlDocument(); xml.Load(@"D:\dv\testXmls\createCases1.xml"); //Cree un elemento con el mismo nombre del atributo tipo archivo en Bizagi, y el atributo Nombre de archivo del XML. XmlElement newElement = xml.CreateElement("File"); XmlAttribute newAttribute = xml.CreateAttribute("fileName"); newAttribute.Value = file_name; newElement.Attributes.Append(newAttribute); //Incluya el contenido del archivo del XML. newElement.InnerXml = sb.ToString(); XmlNode refNode = xml.SelectSingleNode("/BizAgiWSParam/Cases/ Case/Entities/Incident/MyFile"); refNode.AppendChild(newElement); // Invoque la capa SOA de Bizagi. wfsoa.WorkflowEngineSOA wf = new WorkflowEngineSOA(); XmlNode resp = wf.createCases(xml); textBox1.Text = resp.OuterXml; binaryReader.Close(); fileStream.Close(); m_XmlWriter.Close(); }

1204

Copyright 2013 - Bizagi

3.5.7

Validar mi regla de negocio

Informacin general
Durante las etapas de desarrollo de un proyecto o en ambientes de produccin existen situaciones donde es necesario rastrear o depurar errores. Bizagi ofrece la posibilidad de rastrear errores del flujo del proceso (para controlar y diagnosticar errores potenciales) de forma que los administradores puedan comprobar si las reglas de negocio, validaciones, invocacin de interfaces o el proceso mismo necesitan ser modificado. Esto es una herramienta muy poderosa para las Reglas de Negocio, en particular para ayudar al detectar aquellos comportamientos que requieren ajustes. Para permitir la opcin de depuracin y rastreo visite Diagnstico y Control del Error.

Trazas en reglas de negocio

En las reglas de negocio, adems de seleccionar el nivel y las opciones de las trazas, para las Expresiones es necesario incluir una sentencia en el cdigo de la regla y as identificar qu es exactamente lo que se quiere rastrear. Esta lnea de comandos grabar en un registro independiente (un archivo .tx t), toda la informacin personalizada que el usuario quiere rastrear dentro de la regla. Las trazas son construidas utilizando la funcin trace. La siguiente es la sintaxis de la funcin:

CHelper.trace("FileName","Trace text" + Attribute/Variable)

Los parmetros de la funcin son: File Name: Nombre del archivo .tx t donde se guardarn las trazas. Object to be traced: El texto de la traza identifica el objeto (atributo o variable) en el archivo (archivo .txt) El objeto puede ser un atributo seleccionado utilizando una expresin de navegacin XPath o una funcin o una variable. El texto dentro de las comillas puede ser cualquier texto, no es necesario que sea el nombre del atributo dentro del modelo de datos. Usted podr encontrar est funcin en la categora de Trazas.

Copyright 2013 - Bizagi

1205

Ejemplo
Suponga una compaa de Logstica y Transporte que tiene definido un proceso llamado Sh ip p in g P ro cess, para manejar y monitorear las entregas internacionales. La primera tarea del proceso permite a los clientes calcular el costo de su envo. El cliente debe dar las dimensiones y el peso del paquete a enviar. El costo estimado del envo se calcula automticamente en base a un peso volumtrico real y el costo por libra, el cual vara dependiendo de la ciudad destino.

1206

Copyright 2013 - Bizagi

El peso volumtrico refleja la densidad del paquete. Un tem menos compacto generalmente utiliza ms espacio en comparacin de su peso actual. El peso volumtrico o dimensional se calcula y se compara con el peso actual del envo para determinar cual es ms grande; el mayor peso se utiliza para calcular el costo de envo. El peso volumtrico es calculado utilizando un factor de conversin (para que pueda ser comparado con el peso real) el cual asumiremos siempre como 4000. Utilizando el peso volumtrico se obtiene utilizando la siguiente formula. Length*Width*Height/4000 Usted quiere verificar cada paso del calculo del costo para asegurar su correcto funcionamiento. Para configurar las trazas de las Reglas de Negocio siga los siguientes pasos: 1. Cree una expresin. En el ejemplo vamos a definir una expresin asociada con un botn en la forma de la tarea Q u o te Sh ip m en t. Incluya un botn y asocie la expresin a l.

2. Incluya el cdigo en un mdulo de expresin como se muestra en la siguiente imagen: Obtenga el costo por libra de la entidad RateTab le de acuerdo al pas destino. Luego calcule el peso volumtrico y comprelo con el peso real para obtener el peso mayor. Finalmente obtenga el costo total multiplicando el Costo por Libra y el Peso Mayor.

Copyright 2013 - Bizagi

1207

3.Para incluir varias trazas utilice la funcin Trace de la categora Trazas. Define Co stCalcu latio n como el nombre del archivo donde se van a guardar las trazas. Vamos a definir las trazas para Costo por libra, Peso volumtrico, Peso real, Peso Mayor y Costo de envo. Tambin vamos a utilizar variables y expresiones XPath en las trazas para asegurarnos que los valores se recuperan correctamente.

Las trazas que utilizan variables se escriben de la siguiente forma: CHelper.trace("CostCalculation", "Volumetric Weight ="+VolumetricWeight); Las trazas que utilizan expresiones XPath se escriben de la siguiente forma: CHelper.trace("CostCalculation", "Cost ="+<ShippingProcess.Costs>); Las trazas que utilizan variables y expresiones XPath se escriben de la siguiente forma: CHelper.trace("CostCalculation","Cost per Pound to "+<ShippingProcess.DestinationCountry.Name>+" = "+CostperLb); Note que el signo (+) concatena varios tems dentro de la sentencia.

1208

Copyright 2013 - Bizagi

//Obtener el costo por kilo basado en el pas destino var CostperLb=CHelper.getEntityAttrib("RateTable","CostperKg","Country ="+<ShippingProcess.DestinationCountry.Id>,""); CHelper.trace("CostCalculation","Cost per Pound to "+<ShippingProcess.DestinationCountry.Name>+" = "+CostperLb); //Calcular peso volumtrico var VolumetricWeight=<ShippingProcess.Lenght>*<ShippingProcess.Widht>*<Shipping Process.Height>/4000; CHelper.trace("CostCalculation", "Volumetric Weight ="+VolumetricWeight); //Determinar mayor peso CHelper.trace("CostCalculation", "Real Weight ="+<ShippingProcess.Weight>); if (VolumetricWeight > <ShippingProcess.Weight>) { var HigherWeight=VolumetricWeight; CHelper.trace("CostCalculation", "Higher Weight ="+HigherWeight); }else { var HigherWeight=<ShippingProcess.Weight>; CHelper.trace("CostCalculation", "Higher Weight ="+HigherWeight); } //Calcular costo <ShippingProcess.Cost>=HigherWeight*CostperLb; CHelper.trace("CostCalculation", "Cost ="+<ShippingProcess.Costs>); Guarde la expresin

Copyright 2013 - Bizagi

1209

4. Ejecute el proceso y escriba los valores en los campos requeridos. Clic en el botn para ejecutar la expresin.

5. En la carpeta de las trazas de su proyecto, abra el archivo .txt con el nombre definido en el parmetro en la funcin CH elp er.trace. Por defecto, la ruta de la carpeta de trazas es: C:\Bizagi\[bizagi_edition]\Projects\[project_name]\Trace\

6. Observe cmo se muestran las trazas.

1210

Copyright 2013 - Bizagi

3.5.8

Polticas
Polticas son una variacin de las reglas de negocio que permiten a las organizaciones adaptarse a cambios en tiempo real. Las polticas promueven la autonoma de los propietarios del negocio, para que ellos puedan estar involucrados en el control de las reglas definidas por la organizacin. Las reglas son aplicadas de acuerdo a los negocios y las condiciones de los mercados, y stas definen los casos que deben ser manipulados. Por esta razn, las Reglas de Negocio pueden ser modificadas en cualquier momento desde el Portal de Usuarios. Se pueden realizar cambios en valores o lgica, de acuerdo a la situacin actual del proceso. Los vocabularios son definiciones que obtienen o asignan informacin que se utiliza en las Polticas. La operacin de las polticas se basa en la definicin de vocabularios. Por lo cual, polticas pueden definidas luego de crear los vocabularios. Una poltica puede tener varios tems, de acuerdo con su naturaleza se pueden agrupar en: Reglas de polticas: Las reglas de polticas son utilizadas para evaluar condiciones simples del negocio: una accin es ejecutada cuando se cumple una condicin Estas reglas se basan en If y Else. Tabla de decisin: Las tablas de decisin son combinaciones de condiciones de negocio que ejecuta una accin de acuerdo a la intercesin de varias condiciones. Grupo de reglas: Los grupos de reglas organizan las reglas de las polticas que tienen propsitos similares para mantenerlas juntas. Precondiciones: Las precondiciones son componente que permiten crear rboles de decisin en la poltica a travs de una interfaz sencilla. Este componente la jerarqua y la lgica para la ejecucin de los elementos.

Las polticas pueden ser utilizadas en un solo proceso, pero tambin pueden ser reutilizadas y compartidas entre procesos.

Copyright 2013 - Bizagi

1211

Las reglas se estructuran de forma que una accin o un camino alternativo sea ejecutado una vez se ha cumplido una condicin. Polticas de negocio, Grupo de reglas, Precondiciones y Tablas de decisin pueden ser administradas y modificadas desde el Portal de Trabajo por el usuario final cuando sea necesario. Clic para ms informacin sobre Administracin de Polticas en el Portal de Trabajo. 3.5.8.1 Creando una poltica Las polticas se pueden crear de dos formas: Desde el Asistente de Procesos de Bizagi. Desde el men de procesos de la vista de mdulos.

Crear una poltica desde el Asistente de Procesos

1. Vaya al paso Reglas de Negocio (Business Rules) (paso 4) y seleccione Acciones de Actividad.

2. Haga clic sobre la figura donde la poltica ser creada y seleccione Al Entrar, Al Guardar o Al Salir para crear la poltica. Luego seleccione el tem P o ltica.

1212

Copyright 2013 - Bizagi

3. Clic en el botn nuevo en la esquina inferior izquierda. En la nueva ventana, ingrese el nombre, el nombre visual y la descripcin de la poltica.

4. La pestaa de Documentacin puede ser utilizada para incluir informacin relacionada con la poltica. Esta documentacin ser utilizada cuando cualquier usuario necesite realizar cambios en la poltica. La explicacin y los documentos pueden ser consultados. El usuario puede adjuntar archivos dando clic en el botn A d ju n tar A rch iv o en la esquina inferior derecha. Para eliminar un archivo de clic en el botn Q u itar Elem en to .

Copyright 2013 - Bizagi

1213

Nota Aunque la documentacin de la poltica es opcional. Es una buena prctica incluirla. Los archivos de soporte ayudan al usuario final a entender el propsito de la poltica. 5. Una nueva ventana mostrar el A d m in istrad o r d e la P o ltica donde usted podr crear, editar o eliminar polticas. Seleccione la poltica a desarrollar, es posible crear Reglas de Polticas, Tablas de Decisin, Grupo de Reglas, Precondiciones.

1214

Copyright 2013 - Bizagi

Crear una poltica desde el men de Procesos

1. En la vista de Mdulos, vaya a al men Procesos. Seleccione el proceso donde la poltica ser creada. Luego, seleccione Reg las d e N eg o cio y de clic derecho sobre P o lticas. Seleccione N u ev a P o ltica.

Copyright 2013 - Bizagi

1215

2. En la nueva ventana ingrese el nombre, el nombre visual, la descripcin y la documentacin requerida.

3. Una nueva ventana mostrar el Administrador de Polticas donde podr crear, editar o modificar polticas. Clic en el tem de la poltica que desea crear. El administrador de polticas ser mostrado.

IMPORTANTE: Cuando cree polticas desde el men de procesos, ests no estarn asociadas a

1216

Copyright 2013 - Bizagi

ninguna tarea del proceso. Para asociar una poltica existente a una tarea especifica, vaya en el cuarto paso del Asistente de Bizagi y seleccione Acciones de la Actividad. Clic en la figura donde se crear la poltica, seleccione Al Entrar, Al Guardar o Al Salir para crear la poltica. Luego seleccione el tem P o ltica.

Las polticas existentes sern mostradas. Seleccione la que desea asociar, luego de clic en O k.

Copyright 2013 - Bizagi

1217

Administrador de polticas
El administrador de polticas permite al usuario crear, editar y borrar tems de la poltica. Estas son administradas de acuerdo a su tipo: Precondiciones, Reglas, Tablas de Decisin, Grupo de reglas.

Clic en el icono del tem deseado en la parte superior de la ventana.

1218

Copyright 2013 - Bizagi

Cada tipo de tem debe ser definido de diferentes maneras. El procedimiento necesario para crear cada tipo de tem se describe en la siguiente seccin. Reglas de polticas Tablas de decisin Grupo de reglas Precondiciones y rboles de decisin

Editar y eliminar tems de una poltica

Seleccione la poltica y luego de clic en el cono Ed itar. Para borrar un tem de una poltica seleccione el tem y de clic en el cono Eliminar.

Copyright 2013 - Bizagi

1219

Informacin de la poltica
Para ver ms informacin de la poltica (nombre, descripcin y documentacin), clic en el icono Info Poltica ubicado en la esquina superior derecha del Administrador de Polticas

Una nueva ventana ser mostrada con la informacin de la poltica, permitiendo modificarla.

1220

Copyright 2013 - Bizagi

3.5.8.2

Vocabulario

Informacin general
Los Vo cab u lario s son definiciones que obtiene o asignan informacin para ser utilizada en expresiones y polticas. La ventaja principal de los Vocabularios es que sus valores pueden ser utilizados y cambiados fcilmente por los usuarios finales en el Portal de Trabajo, permitiendo flexibilidad y adaptabilidad para cambiar las condiciones del negocio. La operacin de las polticas se basa en la definicin de los vocabularios. Son obligatorios para crear un tem de una poltica. Los vocabularios pueden ser definiciones de constantes o definiciones XPath (valores del modelo de datos):

De acuerdo a la naturaleza de la informacin guardada, el vocabulario se puede clasificar en: Definicin de constante: Guarda los valores que no dependen del modelo de datos y son definidos directamente como valores constantes. Definicin XPath: Guarda valores que dependen del modelo de datos. Siempre estn relacionados con un atributo o funcin de una entidad. La definicin es utilizada, tanto como para obtener informacin (de una constante y de un XPath) o para asignar informacin (a un XPath), y puede ser clasificado con dos tipos: SET: Recibe un valor resultante de una accin de una poltica. Un Vocabulario Set siempre se muestra en azul. GET: Es un valor que puede ser evaluado en Expresiones o Polticas. Los Vocabularios Get siempre se muestran en verde.

Copyright 2013 - Bizagi

1221

Cuando se crea una poltica las definiciones SET siempre se relacionan con acciones y las definiciones GET se relacionan con condiciones a ser evaluadas. En la siguiente seccin, vamos a aprender cmo utilizar estas definiciones.

Crear Vocabularios
Vocabularios pueden ser creados de dos formas: desde el mdulo de Procesos o cuando se crea una poltica.

Crea un vocabulario desde el Mdulo de procesos

1. Vaya al mdulo de procesos de la vista Mdulos. Seleccione el proceso donde se va a crear el vocabulario. Luego, seleccione la opcin Vo cab u lario delas Reglas de Negocio, clic derecho en el tipo de definicin que desea crear. Clic en n u ev a d efin ici n .

Se abrir el asistente para configurar la nueva definicin.

Crear un Vocabulario cuando se crea una poltica

1. Abra o cree una Regla de poltica, una Tabla de decisin, Grupo de reglas o Precondiciones,

1222

Copyright 2013 - Bizagi

2. En cualquier tem de la poltica, podr acceder a los vocabularios desde el panel del lado izquierdo.

3. Clic derecho en el tipo de definicin que desea crear y luego de clic en N u ev a Defin ici n .

Copyright 2013 - Bizagi

1223

Un asistente aparecer para ayudarlo en la configuracin de la nueva definicin.

3.5.8.2.1 Definicin de constantes

Las Definiciones Constantes adquieren valores que no dependen del modelo de datos y se definen por los usuarios con un valor fijo. Estos valores pueden ser modificados en Bizagi Studio (en el ambiente de desarrollo) o en el Portal de Trabajo (para ambiente de produccin). Suponga que en un proceso de Solicitud de Crdito el Gerente define las tasas de inters basado en polticas econmicas del pas. Los clculos realizados en el proceso utilizan dichas tasas. Las tasas dependen entonces de cambios econmicos y deben ser modificadas constantemente. En consecuencia deben ser definidas como Definicin de Constantes. Definicin de Constantes pueden tener los siguientes tipos de dato: booleano, fecha, entero, moneda y texto. Los siguientes son ejemplos de Definicin de Constantes con sus tipos de dato. Ejemplo Disponibilidad de un producto o servicio Fecha de entrega de un proyecto Tasas de inters Tiempo para setear en un evento temporizador Booleano Fecha Decimal Entero Tipo

1224

Copyright 2013 - Bizagi

Mximo valor permitido para solicitar en un Crdio Texto a enviar en un correo electrnico

Moneda Texto

Cmo crear Definicin de Constantes

1. Cuando se selecciona Nueva Definicin una nueva ventana se despliega para dar nombre a la constante.El nombre debe ser entendible pues estas definiciones se usan en Expresiones y polticas y pueden ser manipuladas por usuarios finales.

2. D clic en el botn Siguiente y seleccione el tipo de dato deseado:

Copyright 2013 - Bizagi

1225

El editor correspondiente se desplegar para cada tipo. Ingrese el valor de la constante.

Para una fecha selecciona el da del valor de la constante del calendario:

1226

Copyright 2013 - Bizagi

4. Una vez se haya ingresado el valor de clic en F in alizar.

Editar Definiciones de constante

Es posible modificar los valores de las definiciones en el ambiente de desarrollo por medio de Bizagi Studio. 1. En la vista de Mdulos seleccione Reglas de Negocio. Identifique dnde est guardada la constante (puede ser de Proceso, de Aplicacin o Global). D clic derecho en Defin icio n es d e co n stan tes y seleccione Ed itar lista d e co n stan tes...

Copyright 2013 - Bizagi

1227

2. La lista de definiciones se desplegar. Es posible editar la lista o adicionar un nuevo registro oprimiendo Adicionar definicin de constate. Esto habilitar un nuevo registro en la tabla.

1228

Copyright 2013 - Bizagi

3. D clic en O K para guardar cambios.

Editar Definiciones de constante en el Portal de Trabajo

Las Definiciones de Constante tienen valores fijos que no dependen del modelo de datos y por ello sus valores pueden ser modificados por usuarios finales en el ambiente de produccin a travs de Portal de Trabajo. 1. En el Portal vaya a la opcin Admin y seleccione P o lticas d e N eg o cio .

2. Seleccione el proceso donde la definicin fue creada y de doble clic sobre esta para modificarla.

Copyright 2013 - Bizagi

1229

La ventana de edicin se desplegar de acuerdo al tipo de dato seleccionado.

1230

Copyright 2013 - Bizagi

Cambie el valor a lo que desea y presiones A ctu alizar para guardar los cambios. Nota: Cuando un proyecto es llevado a produccin, todas las definiciones se llevarn en el primer Deployment. En adelante, los ambientes deben ser manejados individualmente. Si quiere que sus definiciones estn sincronizadas le recomendamos realizar los cambios en produccin y luego realizarlos en desarrollo.
3.5.8.2.2 Definicin de XPath

Las Defin icio n es XP ath representan expresiones que obtienen valores del modelo de datos o las actualizan. En contraste con las definiciones constantes, las de XPath deben ser asociadas a un proceso o Aplicacin Se pretende que estas definiciones sean usadas en Expresiones y Polticas; por lo tanto cuando se crean sus nombres deben ser lo ms claro posible para que sean entendidas fcilmente. Las Definiciones XPath pueden estar relacionadas con un atributo simple o con una coleccin. Cuando

Copyright 2013 - Bizagi

1231

se relacionan con atributos simples, las definiciones pueden ser usadas para OBTENER o SETEAR valores. Las definiciones de coleccin se usan para OBTENER valores usando funciones. Las funciones disponibles son: Sum: Devuelve la suma de nmeros o monedas de una coleccin. Count: Devuelve el nmero de registros de una coleccin. Minimum value: Devuelve el menor valor de nmeros, monedas o fechas de una coleccin. Maximum value: Devuelve el mayor valor de nmeros, monedas o fechas de una coleccin. Average: Devuelve el promedio de nmeros o monedas de una coleccin.. Empty: Devuelve Verdadero si la coleccin est vaca. Falso si no. Exists: Devuelve Verdadero si un se encuentra un atributo con cierta condicin dentro de la coleccin. Falso si no. Para mayor informacin favor referirse a Funciones XPath

Cmo crear Definiciones XPath

1. Cuando N u ev a Defin ici n es seleccionada, se despliega una ventana para nombrar el definicin. El nombre debe ser claro pues stas se usan en expresiones y polticas.

2. La nueva ventana se despliega para seleccionar el XPath. D clic en Sig u ien te cuando se ha seleccionado el atributo.

1232

Copyright 2013 - Bizagi

3. En la nueva ventana seleccione el destino. Si la definicin ser usada para asignar valores al atributo, escoja A sig n ar u n v alo r. Si la definicin se usar para obtener un valor ingresado o calculado seleccione O b ten er u n v alo r. D clic en F in alizar cuando seleccione la opcin.

Copyright 2013 - Bizagi

1233

Cmo crear Definiciones XPath relacionadas a colecciones

1. Cuando N u ev a Defin ici n es seleccionada, se despliega una ventana para nombrar el definicin. El nombre debe ser claro pues stas se usan en expresiones y polticas.

2. La nueva ventana se despliega para seleccionar el XPath.

1234

Copyright 2013 - Bizagi

3. Seleccione un atributo de la coleccin (si aplica) o directamente la funcin. D clic en Sig u ien te.

Copyright 2013 - Bizagi

1235

4. En la siguiente ventana podr seleccionas si esta definicin ser usada para obtener o asignar un valor. Sin embargo como se seleccion una coleccin stas slo estn disponibles para obtener valores por ello estar seleccionada por defecto. De clic en Finalizar cuando haya completado la definicin.

Cmo filtrar definiciones XPath de coleccin

Los registros de coleccin en las definiciones pueden ser filtrados para cumplir con condiciones. Estas condiciones se especifican cuando se selecciona el XPath. Usted puede definir si Bizagi selecciona los registros que cumplan con TODAS las condiciones o que cumplan al MENOS CON UNA.

1236

Copyright 2013 - Bizagi

Para incluir condiciones mltiples d clic en A d icio n ar co n d icio n es d e filtro . Una nueva fila de condicin se agregar. La siguiente informacin debe ingresarse en la condicin: Operador izquierdo: el atributo para ser evaluado. Operador: operador que evala la condicin. Operador derecho: constante o atributo que termina la condicin. La siguiente table muestra los diferentes operadores disponibles de acuerdo al operador izquierdo. Atributos Atributos numricos Operadores Igual, Diferente, Menor que, Menor o igual que, Mayor que, mayor o igual que Igual, Diferente

Atributos de texto

De clic en el icono 'X' en la derecha de la condicin si desea eliminarla. Una ventana de confirmacin se desplegar.

Copyright 2013 - Bizagi

1237

Todos los registros de la relacin sern retornados si no se especifica un filtro.

Editar / Borrar Definiciones XPath

1. Acceda al vocabulario desde la vista de Mdulos. Identifique la definicin y de clic derecho. Seleccione Ed itar d efin ici n B o rrar d efin ici n de acuerdo a lo que se desee.

Si selecciona Editar definicin, se abrir el editor de definiciones. Siga los mismos pasos explicados para crear una definicin.

1238

Copyright 2013 - Bizagi

Si selecciona la opcin de eliminar una ventana de confirmacin se mostrar. De clic en SI para borrar.

Definiciones usadas dentro de Polticas NO pueden ser borradas.

3.5.8.2.2.1 Propiedades avanzadas de XPath

Crear vocabularios masivamente

Las Definiciones XPath pueden ser creadas masivamente por medio de la opcin N u ev o v o cab u lario m asiv o . Este men le permite crear mltiples definiciones de una entidad de una manera rpida. Para crear vocabulario masivo siga los siguientes pasos: 1. Acceda a la opcin de Vocabulario desde la vista de Mdulos en Procesos o Aplicaciones. De clic derecho en Definiciones Xpath y seleccione N u ev o v o cab u lario m asiv o .

2. Seleccione la entidad del modelo de datos para obtener sus atributos.

Copyright 2013 - Bizagi

1239

3. Una tabla conteniendo todos los atributos de la entidad se mostrar.

Cada registro se puede modificar dando clic en ste. Si un atributo no desea incluirse des-seleccione la ltima columna. Todos los atributos por defecto se definirn como opciones para OBTENER valores. Esto puede

1240

Copyright 2013 - Bizagi

cambiarse. De clic en Finalizar cuando est listo con los atributos a crear.

Contexto de Vocabulario
Usted puede crear definiciones para acceder a informacin dentro de colecciones. El mtodo de adicin explicado anteriormente le permite la creacin masiva para relaciones uno-a-uno. Cuando se usen dichas definiciones se manipular directamente la informacin del atributo. Usted tambin puede referenciar colecciones pero no es posible manipular los atributos dentro de stas. Para acceder a colecciones Bizagi provee una funcionalidad conocida como Co n tex to d e Vo cab u lario . Contexto se refiere a la posibilidad de navegacin del XPath en el modelo de datos. Con Contexto de Vocabulario podr acceder a atributos dentro e la coleccin para ser usados en Polticas navegando desde la entidad a la que estn asociados. 1. Para crear un Contexto de Vocabulario seleccione el proceso donde se crear. D clic derecho en Defin icio n es XP ath y seleccione la opcin Co n tex to d e Vo cab u lario .

2. Le recomendamos nombrar el contexto con el nombre de la coleccin. En el presente ejemplo el vocabulario ser P ro d u cto s. De esta manera puede ser creada una poltica que evale todos los procesos del caso.

Copyright 2013 - Bizagi

1241

3. El Contexto de Vocabulario puede ser filtrado para obtener, por ejemplo, todos los productos que deben ser entregados. Cuando se crea vocabulario dentro de Contexto de Vocabulario, la ruta para navegar el modelo de datos comenzar desde la entidad de contexto, en este caso P ro d u cto s.

1242

Copyright 2013 - Bizagi

3.5.8.3

Reglas de polticas

Informacin general
Las Reglas de Polticas son usadas para evaluar condiciones de negocio. Se ejecuta una accin cuando una condicin se cumple. Estas reglas se basan en los generadores lgicos Si, Si n o , En to n ces.

Si contiene condiciones que pueden ser combinadas con mas de una condicin usando operadores Y / O. Si n o contiene acciones para ser ejecutadas cuando la condicin Si no se cumple. En to n ces contiene la accin a ser ejecutada cuando Si no se cumple y Si no est vaco.

Nota: Las condiciones y las ejecuciones de acciones dependen completamente de la definicin de vocabularios.

Para crear una Regla de Poltica siga las instrucciones: 1. En el cuarto paso del Asistente de Procesos seleccione A ccio n es d e la A ctiv id ad.

Copyright 2013 - Bizagi

1243

2. Seleccione el elemento en el flujo donde se crear la Poltica. Seleccione A l En trar, A l Salir, A l Salv ar. Seleccione el elemento P o ltica.

3. D clic en Nueva en la esquina superior izquierda. En la nueva ventana ingrese el nombre, el nombre visual y la descripcin de la poltica que crear. De clic en O K.

1244

Copyright 2013 - Bizagi

4. En el Administrador de Polticas seleccione N u ev a reg la d e p o lticas.

5. Una nueva ventana se abrir donde puede crear su poltica.

Copyright 2013 - Bizagi

1245

6. Incluya la condicin a ser evaluada. Arrastre la definicin de vocabulario a la caja de Si en la izquierda. D clic en A g reg ar co n d ici n para incluir tantas condiciones como desee.

Nota: Las definiciones de vocabulario usadas para el Si deben ser creadas como Definiciones Constantes

1246

Copyright 2013 - Bizagi

o XPath que O B TIEN EN un valor. 7. Ingrese las acciones para ser llevadas acabo arrastrando el vocabulario a la caja Entonces y asigne los valores requeridos.

Nota: Las acciones en En to n ces y Si n o deben ser creadas como Definiciones Constantes o XPath que A SIGN A N un valor. Actions can only be defined by Vocabulary created as Co n stan t or XP ath d efin itio n s configured to SET a value. Por defecto la caja Si n o est oculta. Puede ser habilitada seleccionando la opcin Use Si n o en la esquina superior derecha. Arrastre el vocabulario que aplique para su caso.

Copyright 2013 - Bizagi

1247

8. Cuando termine su Regla de Poltica oprima F in alizar. Se le pedir que incluya la siguiente informacin Nombre: Nombre de la Poltica en la base de datos. Una vez ingresado no es posible modificar. Nombre visual: Este es el nombre para mostrar, puede cambiarse en cualquier momento. Descripcin: Inluya informacin que explique qu hace la poltica. Prioridad: Establece relevancia para ejecutar la poltica cuando se usa en grupo de polticas. Permitir: Habilita y deshabilita la poltica. Habilitado a partir de la fecha: Habilita la poltica por un periodo fijo de tiempo. Habilitado hasta la fecha: Habilita la poltica por un periodo fijo de tiempo.

1248

Copyright 2013 - Bizagi

Ejemplo
Imagine que trabaja en un banco y necesita crear una poltica que maneje el escenario en el que un cliente inicia una solicitud pero no selecciona ningn producto financiero. Si el cliente finaliza la solicitud deber ser penalizado y no podr registrar una solicitud en un tiempo determinado. Se crea una poltica para penalizar el cliente, que se evala cuando se finaliza la actividad de registro.

El siguiente es el modelo de datos del ejemplo.

Copyright 2013 - Bizagi

1249

Se necesitan dos vocabularios. Para evaluar si algn producto fue seleccionado debemos saber qu informacin se tiene en una coleccin de Productos. Para penalizar al cliente cuando no se seleccionan productos debemos asignar un valor a un atributo de penalizacin 1.En el cuarto paso del Asistente de Procesos seleccione A ccio n es d e la A ctiv id ad. D clic en la figura donde se va a crear la poltica y seleccione A l Salir, luego seleccione P o ltica.

2. En el Administrador de Polticas seleccione Nueva Regla de Poltica.

1250

Copyright 2013 - Bizagi

3. La Regla de Poltica se abrir ara editarse.

4. Incluya lo siguiente para poder evaluar: Un vocabulario conteniendo una Definicin XPath que obtena el nmero de registros en la coleccin Productos. D clic derecho en Defin icio n es XP ath y seleccione N u ev a d efin ici n .

Copyright 2013 - Bizagi

1251

Ingrese un nombre, nombre para mostrar y descripcin para el vocabulario.

D clic en la coleccin de Productos en el modelo de datos y luego seleccione la funcin Co n tar del listado ubicado en la esquina superior derecha. Luego d clic en Sig u ien te.

1252

Copyright 2013 - Bizagi

El nuevo XPath ha sido creado y usted puede arrastrarlo del men. Hgalo como primera condicin de Si.

Compararemos si el conteo de productos es igual a cero. De ser as el cliente ser penalizado. Esto se har comparando la definicin XPath contra un nmero (0) y as sabremos si hay o no

Copyright 2013 - Bizagi

1253

productos seleccionados.

5. Para penalizar al cliente debemos crear una Definicin XPath que asigne un valor al atributo Penalizar. Repita el procedimiento descrito y al finalizar seleccione la opcin para ASIGNAR un valor.

1254

Copyright 2013 - Bizagi

Arrastre la definicin a la caja de En to n ces y asigne valor Verdadero.

Copyright 2013 - Bizagi

1255

D clic en Finalizar. 6. Defina un nombre, nombre visual y descripcin para la nueva poltica

1256

Copyright 2013 - Bizagi

3.5.8.4

Tablas de decisin Las tablas de decisin permiten combinar condiciones de negocio para ejecutar una accin basada en las intersecciones de las condiciones. Una gran ventaja de este concepto es que las tablas de decisin son altamente parametrizadas, lo que permite agilidad a la hora de enfrentarse con condiciones de negocio cambiantes. Los tipos de definiciones O b ten er y A sig n ar (Vocabulario) son arrastrados al encabezado de la tabla una vez todo el vocabulario que ser usado est disponible en el men de la izquierda.

Copyright 2013 - Bizagi

1257

1. En el cuarto paso del Asistente de Procesos seleccione A ccio n es d e la A ctiv id ad.

2. Seleccione el elemento en el flujo donde se crear la Poltica. Seleccione A l En trar, A l Salir, A l Salv ar. Seleccione el elemento P o ltica.

1258

Copyright 2013 - Bizagi

3. D clic en Nueva en la esquina superior izquierda. En la nueva ventana ingrese el nombre, el nombre visual y la descripcin de la poltica que crear. De clic en O K.

4. En el Administrador de Polticas seleccione N u ev a tab la d e d ecisi n .

Copyright 2013 - Bizagi

1259

5. Una ventana se abrir donde el usuario puede crear y editar las tablas de decisin.

6. Arrastre las definiciones, definiciones de contexto y funciones de libreras que sern evaluadas desde la lista hacia el rea de trabajo. Las columnas de la tabla que sern evaluadas se forman; las condiciones O b ten er (verdes) estarn sobre las condiciones A sig n ar (azules) y las Funciones siempre sern usadas para ejecutar acciones.

1260

Copyright 2013 - Bizagi

7. D clic en A g reg ar Reg istro para incluir los valores de cada columna. D doble clic en una celda para ingresar un valor. Los valores ingresados para A sig n ar resultarn de la accin Verd ad era al evaluar una condicin. Incluya tantas filas como sea necesario.

Nota: Los valores que se utilizan para crear la condicin (en verde) se ajustarn automticamente al tipo de vocabulario, por ejemplo, los valores permitidos sern nmeros enteros cuando la definicin se ha generado a partir de un campo entero. Los valores permitidos sern de texto cuando la definicin se ha generado a partir de un campo de texto. Se puede cambiar el operador de una condicin haciendo clic en l. Una lista de los operadores se desplegar.

Copyright 2013 - Bizagi

1261

Si desea definir un operador "Entre" deber definir la misma columna dos veces e introduzca los operadores necesarios para cada valor.

Cuando todas las filas necesarias se han incluido d clic en F in alizar.

1262

Copyright 2013 - Bizagi

8. Se le pedir que incluya la siguiente informacin Nombre: Nombre de la Poltica en la base de datos. Una vez ingresado no es posible modificar. Nombre visual: Este es el nombre para mostrar, puede cambiarse en cualquier momento. Descripcin: Inluya informacin que explique qu hace la poltica. Prioridad: Establece relevancia para ejecutar la poltica cuando se usa en grupo de polticas. Permitir: Habilita y deshabilita la poltica. Habilitado a partir de la fecha: Habilita la poltica por un periodo fijo de tiempo. Habilitado hasta la fecha: Habilita la poltica por un periodo fijo de tiempo.

Ejemplo
Imagine que trabaja en un banco. El banco ha establecido polticas sobre la cantidad que el cliente puede solicitar en productos de crdito sobre la base de sus ingresos y la condicin de asalariado. Las condiciones se enumeran a continuacin. Si sus ingresos son menos de 500 dlares EE.UU. el cliente no ser elegible. Si sus ingresos son entre EE.UU. $ 500 y $ EE.UU. 3.000, la elegibilidad depende de la condicin de asalariado. Si el ingreso es superior a 3.000 dlares EE.UU. al cliente es siempre elegible. La tabla de decisin se representa como sigue: Ingreso < 500 > 500 and < 3000 > 500 and < 3000 Empleado? SI/NO SI NO Eligible? NO SI NO

Copyright 2013 - Bizagi

1263

> 3000

SI/NO

SI

Para configurar esta Tabla de Decisin en Bizagi siga los siguientes pasos: 1. En el cuarto paso del Asistente de Procesos seleccione A ccio n es d e la A ctiv id ad.. Haga clic en la forma en que la poltica se va a crear y seleccione A l Salir. Seleccione el elemento Poltica.

2. En el Administrador de Polticas seleccione N u ev a tab la d e d ecisi n .

3. Una ventana se abrir donde el usuario puede crear y editar las tablas de decisin.

1264

Copyright 2013 - Bizagi

4. Arrastre y suelte las definiciones que deben ser evaluados a partir de la lista en el rea de trabajo para crear las columnas de la tabla.

5. Incluya los valores de cada fila.

Copyright 2013 - Bizagi

1265

6. Cuando termine de clic en Finalizar. Se le pedir que incluya nombre, nombre visual y descripcin para su tabla.

3.5.8.5

Precondiciones o rboles de decisin

Informacin general
Las P reco n d icio n es contientn condiciones lgicas que permiten o restringen la ejecucin de los elementos que se encuentran en una jerarqua inferior. Le permiten definir una jerarqua de condiciones para organizar la ejecucin de las acciones basadas en una lgica simple. En otras palabras, las Precondiciones le permiten construir rboles de decisin. Cada Precondicin crea una rama del rbol y los nodos ejecutan acciones. As, cada Precondicin es ejecutada por la evaluacin de una condicin padre. El rbol de decisin se inicia mediante la revisin de las condiciones y de acuerdo con el resultado que va a tomar cada

1266

Copyright 2013 - Bizagi

decisin. Las Precondiciones en Bizagi puede tener muchos niveles de anidamiento, segn sea necesario. La siguiente imagen presenta un rbol de decisin que de acuerdo con ciertas condiciones, una persona va a decidir qu hacer en fin de semana: Si los padres estn de visita, el plan ser definitivamente para ir al cine. Si los padres no asisten se evala una nueva condicin, para evaluar las condiciones meteorolgicas. Si hace sol van a jugar al tenis, de lo contrario la opcin alternativa es ir al cine.

Cada rama del rbol es una Precondicin que se puede establecer por pasos mltiples. Una precondicin sola no determina una accin, pues no es ms que un evaluador que conduce a una accin. Por lo tanto, al final de cada ruta o rama, una regla de poltica, una tabla de decisiones o un grupo Reglas debe ser creado, que ser responsable de la ltima validacin y ejecucin de la accin requerida de acuerdo con el resultado de la validacin.

Copyright 2013 - Bizagi

1267

1. En el cuarto paso del Asistente de Procesos seleccione A ccio n es d e la A ctiv id ad.

2. Seleccione el elemento en el flujo donde se crear la Poltica. Seleccione A l En trar, A l Salir, A l Salv ar. Seleccione el elemento P o ltica.

1268

Copyright 2013 - Bizagi

3. D clic en Nueva en la esquina superior izquierda. En la nueva ventana ingrese el nombre, el nombre visual y la descripcin de la poltica que crear. De clic en O K.

4. En el Administrador de Polticas seleccione N u ev a p reco n d ici n .

Copyright 2013 - Bizagi

1269

5. La siguiente ventana se visualizar. A diferencia del editor de Reglas de Poltica, esta interfaz no tiene la seccin Entonces y Si no.

6. Incluya la condicin a ser evaluada. Arrastre las definiciones del vocabulario a la caja Si. Haga clic en el botn A g reg ar co n d ici n para incluir las opciones que sean necesarios para evaluar la regla.

1270

Copyright 2013 - Bizagi

7. Una vez que se han incluido las condiciones requeridas guarde los cambios haciendo clic en el botn F in alizar. La precondicin se muestra ahora en el Administrador de polticas.

Cuando el cursor lleve sobre la precondicin se mostrar una vista rpida del contenido de la misma.

Copyright 2013 - Bizagi

1271

8. Haga clic en la precondicin para crear las ramas que sern evaluadas cuando la condicin se cumpla. De esta manera, una jerarqua de ramas (precondiciones) y elementos de accin (reglas de poltica, tablas de decisin, o grupos de reglas) se pueden crear.

Recordemos, que una precondicin sola no determina una accin. As, al final de cada ruta o rama, una regla de poltica, una tabla de decisin o un grupo de reglas deben ser definidos para determinar la accin. Una vez que la jerarqua de las precondiciones y las acciones se han creado, la poltica puede ser ilustrada como sigue:

1272

Copyright 2013 - Bizagi

Ejemplo
Imagine que trabaja en un banco. El banco ha establecido polticas sobre la cantidad que el cliente puede solicitar en productos de crdito sobre la base de sus ingresos y la condicin de asalariado. Las condiciones se enumeran a continuacin. Si sus ingresos son menos de 500 dlares EE.UU. el cliente no ser elegible. Si sus ingresos son entre EE.UU. $ 500 y $ EE.UU. 3.000, la elegibilidad depende de la condicin de asalariado. Si el ingreso es superior a 3.000 dlares EE.UU. al cliente es siempre elegible. La tabla de decisin se representa como sigue: Ingreso < 500 > 500 and < 3000 > 500 and < 3000 > 3000 Empleado? SI/NO SI NO SI/NO Eligible? NO SI NO SI

Copyright 2013 - Bizagi

1273

Esta situacin puede representarse en un rbol de decisin:

1. En el cuarto paso del Asistente de Procesos seleccione A ccio n es d e la A ctiv id ad.. Haga clic en la forma en que la poltica se va a crear y seleccione A l Salir. Seleccione el elemento P o ltica.

2. En el Administrador de Polticas seleccione N u ev a p reco n d ici n .

1274

Copyright 2013 - Bizagi

3. Cree las condiciones relacionadas con la primera condicin. En este caso se define el primer rango para el ingreso del cliente. Haga clic en F in alizar.

4. D nombre, nombre visual y descripcin. D clic en F in alizar.

Copyright 2013 - Bizagi

1275

5. Repita los pasos anteriores para crear la precondicin, para los siguientes escenarios.

Hasta este punto hemos creado la primera parte del rbol de decisin.

1276

Copyright 2013 - Bizagi

6. Haga clic en una precondicin y, para este ejemplo, seleccione la opcin Nueva Regla de Poltica para definir un nivel de jerarqua inferior.

Copyright 2013 - Bizagi

1277

7. Incluya las condiciones necesarias y la accin final. Escriba un nombre, nombre para mostrar y una descripcin y haga clic en F in alizar.

1278

Copyright 2013 - Bizagi

La nueva poltica se muestra como un nodo secundario de la precondicin en la que se cre.

8. Repita los pasos anteriores para todas las Reglas de poltica. En este ejemplo tenemos dos reglas ms:

Copyright 2013 - Bizagi

1279

A este punto ste es nuestro rbol de decisin.

9. Repita los pasos para todas las precondiciones.

1280

Copyright 2013 - Bizagi

. Una vez que todos los elementos han sido creados, el rbol completo aparecer como a continuacin:

Copyright 2013 - Bizagi

1281

3.5.8.6

Grupo de reglas Los Gru p o s d e reg las organizan las Polticas que tienen propsitos similares para mantenerlas juntas, y permite ejecutarlas en conjunto. Cuando un grupo de reglas tiene que ver con una accin de la actividad, todas las polticas incluidas en el grupo sern evaluadas.

1. En el cuarto paso del Asistente de Procesos seleccione A ccio n es d e la A ctiv id ad.

1282

Copyright 2013 - Bizagi

2. Seleccione el elemento en el flujo donde se crear la Poltica. Seleccione A l En trar, A l Salir, A l Salv ar. Seleccione el elemento P o ltica.

3. D clic en N u ev a en la esquina superior izquierda. En la nueva ventana ingrese el nombre, el nombre visual y la descripcin de la poltica que crear. De clic en O K.

Copyright 2013 - Bizagi

1283

4. En el Administrador de Polticas seleccione N u ev o g ru p o d e reg las.

5. El editor de Polticas se desplegar para crear la primera Poltica del grupo. Encontrar dos botones: Descartar, que descarta los cambios y A p licar que guarda los cambios

6.Una vez que la primera regla se crea, se mostrar el Grupo de reglas. Aqu puede ver todas las reglas del grupo y podr crear, editar y borrarlas. Puede insertar tantas reglas como sea necesario mediante el botn A g reg ar co n d ici n .

1284

Copyright 2013 - Bizagi

7. Una vez que se han incluido todas las reglas requeridas, los cambios se pueden guardar haciendo clic en el botn F in alizar. 3.5.8.7 Reusabilidad Bizagi ofrece al usuario la posibilidad de reutilizar las Polticas de Negocio y el vocabulario segn como fueron creadas. En funcin uso las polticas se clasifican en tres tipos: Vocabulario Global (Aplica para Enterprise Edition): el vocabulario puede ser reutilizado en todas las aplicaciones que forman parte del proyecto en el que fueron creados. Slo definiciones de constantes se puede definir ya que no hay contexto de este nivel. Vocabulario Global se crea slo desde la vista de Mdulos.

Polticas de Aplicacin (Aplica para Enterprise Edition): Estas polticas se pueden reutilizar en todos los procesos que forman parte de la aplicacin en la que se crearon. Se crean slo desde la vista de Mdulos.

Polticas de Proceso: estas polticas pueden reusarse en cualquiera de los elementos del proceso en el que fueron creados. Se crean a partir de la cuarta etapa del Asistente de Procesos. La siguiente imagen muestra donde las polticas de aplicacin se crean y se almacenan.

Copyright 2013 - Bizagi

1285

La siguiente imagen muestra dnde se almacenan las Polticas de Proceso.

Es as como la clasificacin de las polticas se ver cuando una poltica se asocia a una accin de una actividad. Las polticas se organizan en familias.

1286

Copyright 2013 - Bizagi

Ejemplo de reusabilidad de Polticas

Para ilustrar cmo las polticas pueden ser reutilizadas, considere el siguiente proyecto que contiene cuatro aplicaciones diferentes: A d m in istraci n , F in an zas, M arketin g y O p eracio n es.

Copyright 2013 - Bizagi

1287

Las Polticas de Aplicacin creadas en Administrativa, se pueden reutilizar en cualquiera de los diferentes procesos que forman parte de la Aplicacin Administrativa (por ejemplo, pago de facturas, solicitudes de compra, etc.)

En la siguiente imagen podemos ver a la poltica Valid A p p ro v al en el proceso de solicitud de compra:

La Poltica Valid A p p ro v al puede ser llamada tambin en el proceso Pago de Facturas:

1288

Copyright 2013 - Bizagi

Esta poltica no estara disponible en un proceso que forma parte de otra Aplicacin, como por ejemplo, Prospect Follow-up en la aplicacin Marketing.

Cuando el usuario asocia una poltica para una accin de una actividad, la poltica Valid Approval no estar incluida en las Polticas de esta aplicacin.

Copyright 2013 - Bizagi

1289

En las Polticas de proceso, podemos ver que la Poltica Su g g ested N u m b er o f Q u o tes creada en el proceso de Cotizaciones estar disponible para cualquiera de las diferentes actividades del proceso.

El alcance de la reutilizacin es limitada a nivel de proceso. Por consiguiente, estn disponibles como acciones a cualquiera de los elementos del proceso de Cotizacin.

1290

Copyright 2013 - Bizagi

Sin embargo, si vamos al proceso de Pago de Factura, la Poltica Suggested Number of Quotes no estar disponible para su reutilizacin.

3.6

Definicin de notificaciones
Las Notificaciones son mensajes enviados por correo electrnico que proveen informacin del estado de un caso o de informacin de negocio. Hay dos tipos de correo electrnico: Notificaciones automticas : estas son notificaciones predefinidas que se envan al usuario bajo

Copyright 2013 - Bizagi

1291

ciertas circunstancias para informar acerca de casos abortados, retrasados y asignados. Notificaciones creadas (personalizadas): estas son notificaciones en donde el contenido es definido totalmente por el usuario de acuerdo a condiciones de su negocio. Bizagi enva notificaciones cuando los correos estn habilitados y se ha configurado un servidor de correo en la Configuracin de Entorno. Si usted no tiene un servidor configurado vaya a Cmo configurar un servidor de correo.

3.6.1

Correos electrnicos automticos

Informacin general
Las Notificaciones automticas son mensajes predefinidos enviados por correo electrnico sin intervencin del usuario. Cada mensaje tiene una plantilla predeterminada que se puede personalizar. Hay tres tipos de notificaciones automticas: Notificacin de tareas: Estos mensajes son enviados tan pronto como una tarea ha sido asignada. Dado que una tarea se puede asignar a varias personas, la notificacin se enva a todos los asignados a la actividad. Las Notificaciones de tareas contienen informacin bsica acerca de la tarea asignada. Para activar el mensaje, abra el modelo de proceso en el primer paso del Asistente de Proceso. Haga clic en la actividad que requiere un mensaje y seleccione P ro p ied ad es. Marque la opcin N o tificar, para enviar un mensaje automticamente a todos los usuarios asignados a la actividad o evento. Repita el procedimiento para todas las actividades que requieren esta configuracin y guarde el modelo.

1292

Copyright 2013 - Bizagi

Notificacin de Abortar: estas notificaciones se enviarn tan pronto como un caso se ha abortado, a todos los que estn asignados actualmente a una actividad del caso. Abortar contienen informacin bsica sobre el caso abortado. Esta notificacin estn habilitadas de forma predeterminada y no se puede desactivar. Alarmas de tarea: estas notificaciones se envan cuando una Alarma se ha configurado para una tarea especfica del Proceso. Cuando se cumple la duracin de una tarea y se cumplen con las condiciones de la alarma, se enva al usuario asignado y su jefe un correo. Es importante definir la duracin de cada tarea para que las alarmas funcionan correctamente. Si no se ha configurado duracin Bizagi no ser capaz de determinar cuando una alarma se va a enviar.

Modificar plantilla de notificaciones automticas

Las Notificaciones automticas tienen una plantilla predeterminada que se puede personalizar. Tenga en cuenta que ninguna informacin de negocio se puede incluir en la plantilla pues se aplica a todas las tareas de todos los procesos de un proyecto. 1. En Bizagi Studio, vaya a la pestaa Configuracin y haga clic en N eg o cio s. Seleccione la opcin de N o tificacio n es en la parte izquierda de la nueva ventana.

2. De clic en Editar para abrir el mensaje predeterminado.

Copyright 2013 - Bizagi

1293

3. Puede editar el Nombre visual y el cuerpo del mensaje. Puede escribir entre rombo abierto "<" para acceder a una lista de opciones que se pueden incluir en la plantilla como: un vnculo con el caso, la fecha de hoy, el nombre del creador caso, entre otros. Si utiliza una de estas variables se acuerda de cerrar el diamante ">". Se recomienda no cambiar el nombre de la plantilla. El nombre visual es el que el usuario final recibir cuando reciben una notificacin automtica. Cuando haya terminado, haga clic en O k.

3.6.2

Notificaciones creadas (no automticas)

Las Notificaciones creadas por los usuarios son mensajes enviados por correo electrnico a cualquier direccin de correo electrnico vlida. Estas Notificaciones aplican a un proceso particular, y especficamente, a una actividad particular y puede incluir informacin de negocio del caso. El contenido del mensaje y los requisitos de envo son definidos completamente durante el desarrollo del proceso. Estas Notificaciones se crean en el men Acciones de la actividad en la cuarta etapa del Asistente de Proceso y se llaman Co rreo Electr n ico .

Cmo crear un correo electrnico

1. En el cuarto paso del Asistente de Proceso seleccione A ccio n es d e A ctiv id ad. Una nueva ventana mostrar el diagrama del proceso.

1294

Copyright 2013 - Bizagi

2. Seleccione la actividad donde se configurar el correo electrnico. En la ventana haga clic en el smbolo de adicionar en la esquina inferior izquierda y seleccionar la opcin de Correo Electrnico.

3. La siguiente ventana se mostrar con el fin de introducir la informacin requerida.

Copyright 2013 - Bizagi

1295

4. Seleccione los destinatarios: Haga clic en el botn P ara. Usted puede enviar el correo electrnico a una cuenta fija o puede seleccionar un atributo en el modelo de datos donde se guarda una direccin de correo electrnico. Para enviar a una o ms cuentas fijas, seleccione la opcin En v iar co rreo electr n ico a u n a cu en ta fija y escriba cada direccin separada por un punto y coma. De lo contrario, marque la opcin Enviar correo electrnico a partir de una seleccin de modelo de datos y seleccione el atributo del modelo de datos que se muestran a la izquierda.

1296

Copyright 2013 - Bizagi

5. Escriba un asunto y el contenido. Cuando haya terminado, haga clic en Gu ard ar.

Copyright 2013 - Bizagi

1297

3.6.2.1

Incluir informacin del proceso y del caso Las diferentes caractersticas de la configuracin de correo electrnico le permiten incluir fcilmente la informacin de negocio que se utiliza en los procesos y se almacenan en el modelo de datos. La informacin del modelo de datos y alguna informacin especial se incluye en el cuerpo del correo electrnico entre parntesis diamante "<>" como variables que cambian su valor de un caso a otro. Cuando el correo electrnico llegue a los destinatarios la informacin entre parntesis ser interpretada, resuelta y se muestran los valores reales.

Incluir informacin almacenada en el modelo de datos

Puede incluir toda la informacin de negocio en los mensajes de correo electrnico, si los datos se han guardado en los atributos del modelo de datos. Para incluir cualquier atributo es necesario para ingresar su XPath por medio de una de las dos opciones disponibles: la navegacin por el modelo de datos o el uso de la opcin de Cam p o XP ath . Construir el XPath navegando por el modelo de datos: Para incluir valores de atributos, se debe indicar el camino para llegar al atributo entre parntesis diamante: '<' y '>'. Tan pronto como '<' se escribe, aparece una lista desplegable con todos los atributos de la Entidad de Proceso. Escriba el parntesis abierto '<' y seleccione el primer atributo. A continuacin, escriba un punto (.) para seguir navegando hasta alcanzar el atributo deseado. Una vez haya seleccionado el atributo, recuerde aadir el corchete de cierre (>).

1298

Copyright 2013 - Bizagi

Seleccione el atributo mediante la opcin Cam p o XP ath Haga clic en el botn de la barra de Cam p o XP ath y navegue por el modelo de datos hasta que llegue el atributo deseado. Haga doble clic para seleccionar e incluir el atributo en el cuerpo del correo.

Incluir informacin especial

Puede incluir informacin especial en los correos electrnicos sin ningn tipo de reglas o de programacin:

Copyright 2013 - Bizagi

1299

<CaseNumber>: Incluye el nmero de caso del caso en el que se enva el correo. <TodayDate>: Incluye la fecha de hoy. <CaseLink>: Inserta un vnculo con el caso. El enlace abrir el caso en el Portal de Trabajo de Bizagi. Con el fin de incluir este tipo de informacin, escriba parntesis abierto "<". Un men desplegable aparecer, seleccione la informacin que desea incluir haciendo doble clic sobre ella.

Incluir hipervnculos
Para agregar un enlace externo seleccione H ip erv n cu lo en la parte superior de la ventana. Escriba un nombre para mostrar en el campo de texto, y la referencia a la fuente de Internet en el campo URL. Cuando un destinatario recibe este correo electrnico el texto aparecer como un hipervnculo y ser capaz de hacer referencia a los datos haciendo clic en el enlace

1300

Copyright 2013 - Bizagi

Incluir archivos subidos y las Letras

Para enviar archivos cargados o Documentos en el correo, introduzca el XPath del atributo que contiene el archivo. Seleccione el atributo, usando los parntesis de diamante: <FileToUpload>. Una forma alternativa de obtener el atributo directamente es usnado el botn Cam p o d e XP ath . El XPath puede estar en cualquier parte del cuerpo del correo electrnico. El archivo ser enviado como un archivo adjunto.

Copyright 2013 - Bizagi

1301

Ejemplo para incluir informacin en un correo electrnico

Un proceso de solicitud de viaje se encarga de las actividades necesarias para hacer frente a las solicitudes de viajes realizadas por los empleados de una empresa. El Departamento Administrativo est a cargo de la reserva del hotel, vuelos y un coche. Varias notificaciones se envan al empleado durante el curso del proceso para informar el estado de las reservas. Cuando los tiquetes de avin han sido reservado, un correo se enva al solicitante con toda la informacin de la reserva incluyendo informacin de aerolneas y los detalles del vuelo en el archivo adjunto de e-ticket. Siga los siguientes pasos para crear este E-mail: 1. Vaya a la opcin A ccio n es d e la A ctiv id ad en el cuarto paso del Asistente de Procesos. Seleccione la actividad que debe enviar el correo y defina una accin Al Entrar, Al Salir, Al Guardar. Haga clic en Agregar y seleccione Co rreo Electr n ico .

1302

Copyright 2013 - Bizagi

2. Seleccione los destinatarios. Haga clic en P ara e inluya la direccin de correo electrnico. En la nueva ventana, navegue el modelo de datos hasta el atributo que guarda la direccin de correo electrnico. En este ejemplo, seleccionamos el correo del usuario solicitante.

3. Escriba un asunto y el cuerpo del mensaje. Utilice la propiedad < Case N u m b er> que incluya el identificador de caso en el Asunto.

Copyright 2013 - Bizagi

1303

Utilice los parntesis de diamante "<>" para incluir la informacin almacenada en el modelo de datos. Por ejemplo, el nombre del solicitante.

1304

Copyright 2013 - Bizagi

Utilice la propiedad < Case Lin k> para incluir un enlace al caso en el cuerpo del mensaje.

Proporcione informacin de la aerolnea mediante la insercin de un hipervnculo a la pgina web. Coloque el cursor en el lugar donde debera estar el hipervnculo y haga clic en el botn H ip erv n cu lo . Escriba el texto del hipervnculo y la direccin URL asociada.

Copyright 2013 - Bizagi

1305

Enve el tiquete electrnico como un archivo adjunto. Seleccione el atributo donde se almacena el tiquete electrnico utilizando el mtodo de parntesis.

1306

Copyright 2013 - Bizagi

4. D clic en Gu ard ar. As se vera el correo recibido:

3.6.2.2

Incluir Tablas o colecciones

Informacin general
Hay dos tipos de tablas que se pueden incluir en correos: estticas y dinmicas. Las tablas estticas: estas tablas tienen un nmero fijo de columnas y filas, que las define el usuario en tiempo de desarrollo. La informacin incluida en la tabla es fija texto o los atributos del modelo de datos sin relaciones uno-a-muchos, de manera similar a las tablas que se muestran en la siguiente imagen:

Copyright 2013 - Bizagi

1307

Al enviar esta informacin por correo electrnico se ver as:

Tablas dinmicas: Estas tablas muestran la informacin almacenada en las colecciones, o las relaciones de uno a muchos, que se muestran en el Portal de Trabajo como Tablas. La siguiente imagen muestra cmo una coleccin se muestra en el Portal de Trabajo

La siguiente imagen muestra cmo la coleccin aparecern en el correo.

Ejemplo para incluir una tabla esttica

Suponga que desea enviar un correo electrnico para confirmar los productos y la informacin de

1308

Copyright 2013 - Bizagi

la entrega de una solicitud de compra, una vez que haya sido aprobada. Es necesario incluir tres atributos del modelo de datos en el correo electrnico: la justificacin compra, la fecha de entrega y la direccin de entrega. Estos atributos se incluiran en una tabla para lograr un aspecto estructurado en el correo. La siguiente imagen muestra cmo la informacin se captura en el Portal de Trabajo y se presenta en el correo.

1. Haga clic en el botn Tab la esttica en la parte superior de la ventana y seleccione el nmero de filas y columnas que la tabla va a tener. Seleccione tres columnas y dos filas.

Copyright 2013 - Bizagi

1309

2. Cree la fila de encabezado de las columnas en la primera fila de la tabla.

3. Incluya la informacin del modelo de datos en la segunda fila de la tabla. Coloque el cursor en el campo de la tabla correspondiente y utilice los parntesis de diamante "<>" o el botn Campo XPath para insertar atributos. Expanda la longitud columnas para ajustarse a la definicin XPath, de lo contrario, el valor se truncar y aparecer cortada en la pantalla.

1310

Copyright 2013 - Bizagi

4. Haga clic en Guardar cuando el correo electrnico se ha completado.

Copyright 2013 - Bizagi

1311

Ejemplo para incluir una tabla dinmica

Supongamos que desea enviar un correo electrnico al cliente cuando su solicitud haya sido aprobada en un proceso de solicitud de crdito. El correo contendr la informacin de los prstamos (productos) que fueron aprobados. El siguiente es el modelo de datos del proceso. Note que hay una relacin de uno a muchos entre la Entidad de Proceso, So licitu d, y la entidad P ro d u cto s.

El correo recibido contiene una tabla como la qur se muestra a continuacin:

1. Coloque el cursor donde desea incluir su tabla dinmica.

1312

Copyright 2013 - Bizagi

Haga clic en Tab la d in m ica en la cinta de opciones.

3. Una nueva ventana mostrar las opciones para construir la tabla requerida. Hay cuatro pestaas que definen la tabla: Dato s d e la tab la, En cab ezad o , Estilo d el co n ten id o , y Estilo d e tab la. La informacin contenida Datos de la Tabla es obligatorio; las otras pestaas contienen valores predeterminados que se pueden personalizar, si lo desea.

Datos de la tabla Esta pestaa contiene la informacin de la coleccin XPath, as como el nombre de la forma que armar las columnas. El primer elemento es el N o m b re d el F act (nombre de la relacin) que el XPath de la Coleccin. Haga clic en el botn Seleccio n ar para navegar por el modelo de datos y seleccionar la coleccin. El XPath en este caso ser Req u est.P ro d u cts.

Copyright 2013 - Bizagi

1313

Puede aadir filtros a la coleccin para incluir slo los registros relevantes en el correo electrnico.

El segundo elemento es el Nombre de la forma. Se trata de un Forma creada en la entidad de coleccin que incluye las columnas que se mostrarn en el correo. Cada atributo de la entidad muchos estar representada en la columna tabla. Si la Forma ya ha sido creada, seleccinela haciendo doble clic en su nombre. Si la Forma requiere edicin, seleccione el nombre para resaltarlo y, a continuacin, haga clic en el botn Ed itar. Una nueva ventana mostrar el diseador de Formas para su edicin. Si la Forma no se ha creado, haga clic en el botn A g reg ar. Una nueva ventana aparecer para construirla.

1314

Copyright 2013 - Bizagi

Nota Las formas que definen las columnas de la tabla dinmica utilizarn el diseador de Formas V9. Estilo del encabezado En esta pestaa, puede configurar el aspecto de la cabecera de la tabla. Estos valores se tomarn en consideracin slo si se selecciona Utiliza en cab ezad o en la pestaa Estilo d e tab la.

Estilo del contenido En esta pestaa puede configurar los estilos del cuerpo del mensaje:

Copyright 2013 - Bizagi

1315

Estilo de tabla En esta pestaa puede configurar: o Alineacin: Indica que la tabla estar alineada a la derecha, al centro o a la izquierda. o Utiliza encabezado: Determina si la tabla tendr ttulos en su encabezado.

4. Cuando termine de seleccionar y definir estilos d clic en O k.

5. La tabla dinmica se incluir en el cuerpo del mensaje. Si necesita editarla, d doble clic sobre sta y se abrirn sus propiedades. Para borrarla borre su icono usando la tecla Borrar del teclado.

1316

Copyright 2013 - Bizagi

5. D clic en Gu ard ar.

IMPORTANTE: Cuando cree la forma de la tabla dinmica, el campo Es Reu sab le debe estar habilitado para poder seleccionarla.

Copyright 2013 - Bizagi

1317

3.6.2.3

Enviar mensajes de acuerdo a condiciones Puede configurar el envo de varios mensajes en un solo correo, con contenidos diferentes dependiendo de una serie de condiciones. Es decir, en un solo correo electrnico que puede incluir varias plantillas con las condiciones vinculadas a cada uno. Bizagi evala cada condicin y enva las plantillas que cumplen las condiciones. Para incluir varias plantillas de correo electrnico marque la casilla de M ltip les M en sajes. Esto crear una nueva pestaa sobre el campo A su n to , donde puede agregar cada plantilla. Puede agregar tantos mensajes como desee haciendo clic en la ltima pestaa (marcada con una estrella).

Cada mensaje tiene su propio Asunto, as como su propia plantilla. Las condiciones asociadas con cada mensaje se encuentra en la opcin Co n d icio n es d e En v o (en la esquina superior derecha). Cuando se hace clic, una nueva ventana aparecer para definir las diferentes condiciones. Estas deben devolver un valor booleano, verdadero o falso, para que Bizagi puede identificar qu mensajes de correo electrnico enviar.

1318

Copyright 2013 - Bizagi

Ejemplo
Imagnese que usted trabaja en una tienda de artculos electrnicos. Cuando un cliente compra un producto su informacin se almacena en la base de datos de la tienda. El Departamento de Marketing le enviar a l / ella un correo electrnico un tiempo despus para ofrecer promociones y descuentos. El Departamento de Marketing entiende que los hombres y las mujeres difieren en su inters en los productos. De acuerdo con el gnero del cliente un mensaje se enviar ofreciendo productos seleccionados. 1. Vaya a la opcin A ccio n es d e A ctiv id ad en la cuarta etapa del Asistente de Procesos. Seleccione la Actividad en la que se debe crear el correo, haga clic en el icono de agregar y seleccione la opcin de Co rreo Electr n ico .

Copyright 2013 - Bizagi

1319

2. D clic en P ara e incluya la direccin de correo electrnico. En este caso, seleccione el correo del cliente.

3. Escriba un Asunto y el cuerpo del mensaje.

1320

Copyright 2013 - Bizagi

3. Marque la casilla de M ltip les M en sajes y haga clic en la ltima pestaa (la que tiene una estrella) con el fin de crear otra plantilla.

4. Incluya el destinatario, Asunto y el cuerpo de la segunda plantilla. A continuacin, haga clic en

Copyright 2013 - Bizagi

1321

Co n d icio n es d e en v o .

5. Haga clic en el enlace Condicin de la primera plantilla de correo electrnico. Una nueva ventana aparecer para crear la condicin. La condicin en la primera plantilla evaluar si el cliente es un hombre.

6. Repita el procedimiento anterior para la segunda plantilla de correo electrnico, evaluando de si el gnero es femenino.

1322

Copyright 2013 - Bizagi

7. D clic en Gu ard ar.

Mensajes mltiples en ambiente de produccin

Cuando un proyecto ha hecho deployment algunos elementos como las notificaciones seguirn siendo editables en el ambiente de desarrollo. Sin embargo, para evitar posibles problemas con los deployments posteriores, Bizagi restringe los cambios en algunos de estos elementos. Por esta razn, cuando una notificacin con mensajes mltiples ya est en produccin, no ser posible eliminar o cambiar las condiciones. La plantilla y el campo Para seguirn siendo editable. 3.6.2.4 Incluir informacin de una regla Usted puede incluir valores que retorna una regla de negocio en los mensajes de correo electrnico. Para incluir una regla ingrese un parntesis de diamante '<', y seleccione Reg la:

Copyright 2013 - Bizagi

1323

Los nombres de todas las reglas de scripting que se han creado para el proceso se mostrar en una nueva ventana. Haga clic en la regla que desee relacionar en el mensaje. Recuerde que debe poner el cierre del parntesis de diamante: '>'.

1324

Copyright 2013 - Bizagi

Las reglas tambin pueden ser incluidos en la plantilla haciendo clic en el botn Cam p o Ex p resi n . Una ventana se abrir de manera que usted puede crear una regla.

Si la regla ha sido creada previamente, haga clic en Cancelar y seleccione la expresin deseada.

Copyright 2013 - Bizagi

1325

3.6.2.5

Enviar a mltiples destinatarios Bizagi le permite enviar correos electrnicos a mltiples direcciones. Esto se puede hacer de cuatro maneras: Escribir cada una de las direcciones deseadas. Seleccionando varios atributos del modelo de datos que contengan direcciones de correo electrnico. Incluyendo una coleccin que contenga varias direcciones de correo electrnico. Una combinacin de las tres opciones anteriores. A continuacin encontrar ms informacin sobre las posibles formas de configurar varios destinatarios.

Escribir varias direcciones

En muchas ocasiones los mensajes de correo electrnico enviados a travs del flujo de proceso no se depende de la informacin del caso, pero siempre se envan a la misma gente. Para esos casos puede escribir las direcciones necesarias en el campo P ara. Para agregar una direccin fija, haga clic en el botn Para, seleccione En v iar co rreo a u n a cu en ta fija y escriba las direcciones.

1326

Copyright 2013 - Bizagi

Repita este procedimiento para cada direccin, separadas por punto y coma.

Seleccin de varios destinatarios desde el modelo de datos

Las direcciones de correo electrnico pueden ser almacenados en los atributos de su modelo de datos, y estos valores se puede incluir en el campo Para.

Copyright 2013 - Bizagi

1327

Para agregar un atributo que contiene una direccin de correo electrnico, haga clic en el botn Para. Seleccione la opcin En v iar co rreo a p artir d e u n a selecci n d el m o d elo d e d ato s y seleccione el atributo en el lado izquierdo de la ventana.

Repita este procedimiento para cada direccin tiene que incluir. Note que las direcciones quedan separadas por punto y coma.

1328

Copyright 2013 - Bizagi

Seleccin de varios destinatarios desde Colecciones

Cuando la informacin de los destinatarios de un correo electrnico se almacenan en una coleccin (relacin uno a muchos), se puede enviar un correo electrnico a todos ellos. Para estos casos se puede incluir el atributo de la coleccin (entidad muchos) donde se almacenan las direcciones de correo electrnico. Para agregar un atributo de una coleccin que contiene direcciones de correo electrnico, haga clic en el botn Para. Marque la opcin En v iar co rreo a p artir d e u n a selecci n d el m o d elo d e d ato s y seleccione el atributo de la coleccin.

Copyright 2013 - Bizagi

1329

Nota Cuando las direcciones en el campo Para pertenecen a una coleccin el contexto del mensaje y el contexto de las condiciones pueden ser elegidos. Para ms informacin por favor referirse a Cambios de contexto. Cuando las direcciones se obtienen a travs de los atributos relacionados con el modelo de datos (relacin uno a uno), el contexto del mensaje y Condiciones ser la Entidad de Proceso.

Filtrado de la coleccin
Si no desea enviar el correo a todos las direcciones de correo incluidas en la coleccin, puede filtrar la coleccin y slo enviar a los destinatarios que cumplen una condicin especificada. Para establecer un filtro, seleccione la coleccin. Las opciones de filtro se activan como se muestra a continuacin.

1330

Copyright 2013 - Bizagi

Haga clic en A d icio n ar co n d ici n .

Copyright 2013 - Bizagi

1331

Seleccione el atributo de la coleccin en el argumento de la izquierda, especifique el operador y el comparador. Haga clic en O k cuando las condiciones estn ingresadas. El correo slo ser enviado a los destinatarios dentro de la coleccin que cumplan con las condiciones establecidas.

Ejemplo de mltiples destinatarios desde Colecciones

Imagine que usted es un planificador de bodas. Una pareja se va a casar y va a utilizar Bizagi para planear su boda. El proceso que ha creado gestiona las actividades necesarias para coordinar este evento. La siguiente imagen muestra el modelo de datos para este proceso.

La Entidad de Proceso es B o d a que tiene una relacin de uno a muchos con la entidad In v itad o s, donde la pareja registra la informacin de cada persona que va a asistir a la ceremonia. En un tiempo establecido antes de la boda las invitaciones se envan por correo electrnico a todas las personas incluidas en la coleccin Invitados. Para configurar las invitaciones por correo electrnico, siga los pasos siguientes: 1. Ir a la cuarta etapa del Asistente de Procesos Bizagi y seleccione la opcin Acciones de Actividad. Seleccione la Actividad donde los correos electrnicos se enviarn e incluya un Correo Electrnico.

1332

Copyright 2013 - Bizagi

2. Haga clic en el botn Para y marque la opcin En v iar co rreo a p artir d e u n a selecci n d el m o d elo d e d ato s. Seleccione el atributo de la coleccin donde estn las direcciones de correo electrnico de los invitados.

3. Cree el asunto y el cuerpo de la plantilla de correo electrnico.

Copyright 2013 - Bizagi

1333

4. Ahora bien, supongamos que despus de la boda la pareja desea expresar su agradecimiento a los invitados que asistieron a la ceremonia. Un correo debe ser enviado a las personas que asistieron. Abra la ventana de definicin de correo en la actividad donde se realizar envo y repita el procedimiento anterior, pero incluyendo un filtro en el men de P ara. Seleccione la Coleccin de invitados y luego haga clic en el botn A g reg ar co n d ici n d e filtro .

1334

Copyright 2013 - Bizagi

5. Incluya la condicin de filtro. En este caso, el correo electrnico ser enviado a los invitados que confirmaron su asistencia a la boda. En este ejemplo hay un atributo que indica si el invitado confirm o no. El atributo se llama Co n firm a y se selecciona nicamente los que estn con el campo en Verdadero.

Copyright 2013 - Bizagi

1335

6. Escriba un asunto y el cuerpo de la plantilla de mensaje para completar la configuracin de correo. Nte cmo el filtro se visualiza en el campo Para.

1336

Copyright 2013 - Bizagi

3.6.2.5.1 Cambio de contexto

Informacin general
En los mensajes de correo electrnico se puede cambiar el contexto de la plantilla de acuerdo con el campo P ara. Tenga en cuenta que los cambios en el contexto en el correo electrnico se aplican a las relaciones de uno a muchos, cuando el Para contiene una coleccin de direcciones. Recuerde que cuando se tiene una relacin de uno a muchos entre dos entidades, un atributo se crea automticamente en la Entidad de la coleccin (muchos) relacionando la entidad Padre (uno). Este atributo est disponible para el acceso a los atributos de la entidad Padre a partir del contexto de la entidad muchos. As que cuando se cambia el contexto de un correo a la Entidad Muchos, usted ser capaz de acceder a la informacin de la entidad Padre. Cuando el campo P ara contiene una determinada direccin de correo electrnico que se ha tomado de una relacin uno a uno, el contexto siempre ser la Entidad de Proceso. Cuando el P ara contiene una coleccin, se puede elegir el contexto entre la Entidad de Proceso o la Entidad Padre.

Ejemplo
Refirindose al ejemplo de la seccin anterior, imagine que usted es un planificador de bodas y utiliza Bizagi. La siguiente imagen muestra el modelo de datos para este proceso. La Entidad de Proceso es B o d a que tiene una relacin de uno a muchos con la entidad In v itad o s donde la pareja registra la informacin de cada persona que va a asistir a la ceremonia. Un tiempo antes de la boda se envan invitaciones por correo electrnico a todas las personas incluidas.

Copyright 2013 - Bizagi

1337

Cuando los destinatarios en el campo Para se obtienen a travs atributos uno a uno el mensaje y las condiciones de mltiples mensajes tendrn todos el mismo contexto. Es decir, los datos se acceden de la misma manera, a partir de la Entidad de Proceso. Cuando los destinatarios pertenecen a una coleccin, como en nuestro ejemplo, una coleccin de personas, el contexto del cuerpo del mensaje y el contexto de las condiciones pueden ser elegidos. Puede escribir el mensaje del correo navegando el modelo de datos, como de costumbre, desde la Entidad de Proceso B o d a, pero tambin puede navegar el modelo de datos desde la entidad muchos In v itad o s. Si la navegacin se haces desde la entidad muchos, hay un cambio de contexto. La entidad de B o d a ya no es la entidad de contexto. Cuando se ha seleccionado In v itad o s en el campo P ara se puede escribir el contenido desde la entidad B o d a como contexto, o se puede escribir con la entidad In v itad o s como contexto. Sea cual sea la ser el punto de partida para la navegacin por el modelo de datos en su correo.

1338

Copyright 2013 - Bizagi

Contexto en el cuerpo del correo

Continuando con el ejemplo mencionado anteriormente, tenga en cuenta que no se incluy el nombre del invitado en el cuerpo del mensaje. Si necesita acceder a esta informacin es necesario cambiar el contexto del cuerpo del mensaje. <Nombre del invitado> Usted est cordialmente invitado a la boda de <Nombre Novio> y <Nombre Novia> el sbado 2 de Mayo a las cuatro seguido de una recepcin Treinta y cinco oeste Leicester Avenida

Usted desea incluir el nombre del invitado, el nombre del novio y el nombre de la novia. Esta informacin se obtiene a partir de los atributos del modelo de datos. Si necesita acceder a esta informacin es necesario cambiar el contexto del cuerpo del mensaje a la Entidad muchos In v itad o s. Si utiliza la Entidad de Proceso como contexto (Boda) se puede acceder al nombre del novio y el nombre de la novia incluyendo el XPath como hemos visto en los ejemplos anteriores. Sin embargo, no se puede acceder al nombre del invitado porque el atributo se encuentra en la coleccin.

Copyright 2013 - Bizagi

1339

En este escenario es necesario cambiar el contexto del cuerpo en la lista desplegable situada en la parte superior derecha del men de configuracin. La opcin de Co n tex to se activa cuando el campo P ara contiene una coleccin.

Elija el contexto In v itad o s. Ahora puede acceder al nombre del invitado directamente de la entidad Invitados. Para acceder a los nombres del novio y de la novia debe seleccionar el XPath utilizando la relacin de la entidad a muchos a la Entidad de Proceso como se muestra a continuacin.

1340

Copyright 2013 - Bizagi

De esta manera usted puede completar el mensaje deseado.

As es como se vern los correos:

Copyright 2013 - Bizagi

1341

Contexto en las Condiciones

Suponga que desea diferenciar entre hombres y mujeres en la invitacin, para incluir la palabra "Seor" o "Sra." delante del nombre del invitado. Con el fin de hacer esto se incluyen varias plantillas con sus condiciones especficas en funcin del gnero de los invitados. En el men de configuracin de correo electrnico, seleccione la casilla de M ltip les M en sajes e incluya una nueva plantilla haciendo clic en la ltima pestaa.

1342

Copyright 2013 - Bizagi

Haga clic en la opcin Co n d icio n es d e En v o . Una nueva ventana aparecer. Como el campo P ara tiene una coleccin, las condiciones pueden elegir el contexto en la parte inferior del men. Si desea acceder a la informacin de los clientes de forma individual y no como una coleccin, hay que cambiar el contexto. Como es necesario acceder al genero de cada invitado, es necesario seleccionar el contexto In v itad o s.

Copyright 2013 - Bizagi

1343

Las condiciones se establecern desde la entidad Invitados.

1344

Copyright 2013 - Bizagi

Escriba el asunto y el cuerpo para el segundo correo, dirigido a invitadas femeninas.

D clic en Gu ard ar. As se vern sus correos:

Copyright 2013 - Bizagi

1345

3.6.2.6

Envo de copias y copias ocultas Los correos electrnicos enviarse con copia a mltiples destinatarios utilizando el CC (con copia) y CCO (los campos con copia oculta). Los campos CC y BCC pueden contener cualquier conjunto de direcciones de colecciones, varios atributos relacionados y direcciones fijas. No hay restricciones en esos campos. Para obtener ms informacin sobre cmo incluir varias direcciones, consulte EnviarEnviar a mltiples destinatarios.

El correo electrnico tambin se pueden enviar a los asignados actuales de la actividad. Para ello, marque el cuadro Co p iar al asig n ad o actu al. El mensaje se enviar a la direccin en el campo P ara y

1346

Copyright 2013 - Bizagi

una copia ser enviada al asignado actual.

3.6.3

Configuracin de servidor de correo

Informacin general
Los procesos en Bizagi pueden enviar notificaciones (automticas y configuradas por el usuario) mediante el uso de un servidor de correo electrnico que es compatible con SMTP, como Lotus Notes y Exchange, entre otros. Para utilizar esta opcin, slo necesita especificar la ubicacin que servidor de correo electrnico (junto con otros parmetros), para que este servidor se utilice en su proyecto Bizagi. Dentro de esta configuracin, puede configurar servidores SMTP diferentes para cada uno de los ambientes de su proyecto (desarrollo, pruebas o produccin).

Configuracin de un servidor de correo electrnico

Establecer que servidor de correo electrnico ser utilizado por los procesos se hace especificando los parmetros SMTP en su proyecto Bizagi (como el nombre del servidor de correo electrnico, la cuenta de envo, etc.) Para ello, vaya la pestaa Co n fig u raci n de Bizagi Studio, y haga clic en el botn En tro n o .

Copyright 2013 - Bizagi

1347

A continuacin, introduzca los datos de los parmetros SMTP que se presentan en la seccin de P o p u lar, de acuerdo con las descripciones en la tabla siguiente.

Opciones de notificacin Habilitar Email Servidor SMTP Marque esta casilla si desea habilitar el envo de notificaciones Introduzca el nombre o la direccin IP de su servidor de correo electrnico. Tenga en cuenta que este servidor debe ser compatible con SMTP. Introduzca la cuenta de correo electrnico que ser el remitente de las notificaciones. Especifique una direccin de correo para enviar copia de cada una de las notificaciones enviadas.

Cuenta STMP

Enviar copia a:

1348

Copyright 2013 - Bizagi

Enviar copia oculta a:

Especifique una direccin de correo para enviar copia oculta de cada una de las notificaciones enviadas.

Nota Observe que en la ventana tambin puede definir inicialmente los parmetros SMTP para sus ambientes de pruebas y de produccin. Los valores de los parmetros para pruebas y produccin, tambin pueden ser editados y gestionados directamente en cada ambiente determinado mediante el uso de las opciones presentadas en el Management Console. Para ver ms informacin acerca de la configuracin a travs de esta opcin, consulte la configuracin del entorno.

Una vez que el servidor de correo electrnico se especifica en la configuracin SMTP, las notificaciones en los procesos sern automticamente enviados a travs de este servidor. Usted tambin tendr que asegurarse de que el servidor de BPM permite el acceso al servidor de correo electrnico especificado (se recomienda que consulte con su equipo de TI que las solicitudes de la direccin IP del Bizagi BPM Server, a travs del puerto SMTP nmero 25, no son rechazadas).

Configuracin avanzada (recomendado)

En caso de que usted requiera incluir de manera explcita o cambiar algunos ajustes adicionales (que no se presentan en la ventana de configuracin que se muestra arriba), usted puede optar por utilizar una conexin puente a un servidor IIS SMTP. Dicho servidor SMTP es un servicio proporcionado por IIS que pueden ser instalado localmente, y permite la posibilidad de definir opciones adicionales tales como: Uso de la autenticacin para acceder al servidor SMTP, cambiar el nmero de puerto SMTP por defecto, entre otros. Este enfoque es una prctica recomendada, porque permitir la continuidad de su negocio en un eventual caso en el que el servidor SMTP est temporalmente fuera de servicio, por encolamientos en el IIS. Esto proporciona una trazabilidad y para las notificaciones. Para obtener ms informacin sobre esta opcin, consulte Configuracin avanzada para el servidor de correo electrnico. 3.6.3.1 Configuracin avanzada de servidor de correo

Informacin general
Bizagi ofrece la posibilidad de utilizar un servidor de correo electrnico para enviar notificaciones definidas en sus procesos. Esta es una prctica recomendada, fcilmente configurable mediante la especificacin de la ubicacin del servidor de correo electrnico en las opciones de En to rn o de su proyecto Bizagi. Adems de esto, hay algunos escenarios sofisticados en los que se requiere establecer parmetros adicionales que no se encuentran en la configuracin del entorno (vea ms informacin acerca de las

Copyright 2013 - Bizagi

1349

opciones por defecto presentados en Configuracin de correo electrnico). Los ejemplos de tales parmetros adicionales y escenarios que requieren ajustes avanzados son: La necesidad de utilizar la autenticacin para acceder al servidor SMTP El requisito de utilizar un nmero de puerto SMTP diferente al predeterminado La posibilidad de contar con la continuidad del negocio en sus procesos (en un caso eventual en que el servidor SMTP est temporalmente fuera de servicio), y un mejor seguimiento de las notificaciones. La necesidad de una conexin puente cuando el servidor BPM no tiene acceso directo al servidor SMTP. La posibilidad de usar un mecanismo de store and forward. Para cualquiera de estas opciones, usted est obligado a utilizar una conexin de puente con un servicio local de SMTP. En entornos Windows (aplica para Bizagi Enterprise. NET y Xpress), dicho servicio es proporcionado por IIS (un servicio de servidor SMTP), que puede ser instalado directamente en el servidor de BPM.

Para entornos Linux OS (aplica para Bizagi JEE), puede utilizar los servicios de terceros, tales como Postfix (en lugar del IIS). Tenga en cuenta que al establecer estos servicios, la administracin depende de herramientas (por ejemplo postfixadmon) para configurar el SMTP y sus reglas (con el fin de evitar el envo de spam).

Los pasos siguientes describen cmo configurar dicha prctica a travs de las caractersticas de IIS.

Prerequisitos
Para usar y configurar el servicio de servidor SMTP de IIS, debe asegurarse primero de que tiene los componentes necesarios instalados. La instalacin del componente Servidor SMTP puede ser verificada referenciando los componentes del servicio. Este servicio debe estar configurado e inicializado.

1350

Copyright 2013 - Bizagi

Adems, al configurar el servidor SMTP en sistemas operativos que tienen IIS versin 7 (es decir, Windows Server 2008, Windows Server 2008 R2), debe asegurarse de que la consola de administracin de IIS 6 est incluida en las caractersticas de IIS instaladas.

Copyright 2013 - Bizagi

1351

Utilizando el servidor IIS SMTP

El siguiente procedimiento se ilustra para los sistemas operativos que tienen IIS 6 o 7. Para utilizar el servicio de servidor SMTP en IIS, como una conexin puente de Bizagi a un servidor SMTP corporativo o la nube, los siguientes pasos se llevan a cabo: 1. Inicio del Administrador de IIS 6,0 Para ello, vaya a In icio -> H erram ien tas ad m in istrativ as -> Serv icio s d e In tern et In fo rm atio n Serv er 6.0. Tenga en cuenta que en el Administrador de IIS 6.0 tambin aplica para los sistemas operativos que tienen IIS 7.

1352

Copyright 2013 - Bizagi

2. Asegurarse de que el servidor virtual SMTP se ha iniciado. A continuacin, asegrese de que el servidor virtual SMTP (Servidor SMTP por defecto) est en marcha. Si no lo est, haga clic derecho y seleccionar la opcin de Inicio (smbolo tringulo apuntando a la derecha).

Copyright 2013 - Bizagi

1353

3. Creando un nuevo dominio. Examinar en el panel izquierdo de la consola de administracin de IIS. Expanda la estructura de rbol bajo el nombre del servidor virtual y d clic derecho para seleccionar N u ev o -> Do m in io .

4. Configuracin del dominio con el Asistente. En la ventana N ew SM TP Do m ain W izard, primero seleccione la opcin Rem o to y haga clic en Sig u ien te.

1354

Copyright 2013 - Bizagi

Para el campo N o m b re, escriba el nombre DNS del dominio al que desea volver a enviar notificaciones de correo electrnico.

Copyright 2013 - Bizagi

1355

D clic en F in alizar. 5. Configuracin de las opciones adicionales para ese dominio. Una vez que el dominio se crea puede encontrar propiedades avanzadas, haciendo clic en ese dominio. En el cuadro Ro u te Do m ain de la ventana de propiedades, seleccione F o rw ard all m ail to Sm art H o st (Reenviar todo el correo al host inteligente.) Introduzca la direccin IP del servidor SMTP entre corchetes "[]". Este servidor SMTP debe ser el nico autorizado para volver a enviar notificaciones de correo electrnico para el dominio especificado (asegrese de que est habilitado A llo w in co m in g m ail to b e relay ed to th is d o m ain ). D click en O k.

1356

Copyright 2013 - Bizagi

Tenga en cuenta que hay opciones adicionales presentadas en este punto. Por ejemplo, dentro de O u tb o u n d Secu rity .. es posible especificar las credenciales de salida para una autorizacin especfica utilizada en ese servidor SMTP. Se requiere que usted tambin se asegure de que el servidor configurado como Smart Hostigente est autorizado a volver a enviar notificaciones por correo electrnico (soporta relay).

3.7

Plantillas de Documentos Informacin general

Plantillas de documentos es una funcionalidad que le permite definir y generar fcilmente documentos en formato PDF con informacin del proceso. Se basan en plantillas construidas en Microsoft Word, que pueden almacenar y mostrar tipos diferentes de contenido, como imgenes de diversos tipos, marcas de agua, formato de caracteres, tablas, etc. Esta funcionalidad le permitir producir documentos funcionales que cumplan con su imagen corporativa y el estndar deseado. A travs de un asistente intuitivo estas plantillas se pueden asociar y configurar para obtener y mostrar informacin especfica del modelo de datos de proceso. Las Plantillas de documentos se almacenan como atributos de tipos de A rch iv o que se pueden descargar en cualquier momento durante el ciclo de vida del proceso. Tenga en cuenta que las Plantillas de documentos no se pueden enviar como adjuntos en mensajes de correo electrnico. Tampoco es posible asociarlas como columnas de una Tabla.

Copyright 2013 - Bizagi

1357

Tenga en cuenta que las Plantillas de documentos se pueden generar de dos maneras. Generadas manualmente por el usuario final oprimiendo un botn Generar Generadas automticamente a travs de una expression.

Lo que hay que hacer en Bizagi

Para crear una plantilla slo tiene que seguir los siguientes pasos:

1. Crear una o varias plantillas de Word en el formato requerido para que sea entendido por Bizagi. 2. Incluir en la Forma el Control. Para generar el documento manualmente por el usuario final, oprimiendo el botn de Gen erar. Para generar el documento automticamente por medio de una Expressin. 3. Configure el control con la plantilla deseada y el mapeo de la informacin de la plantilla del modelo de datos. Configure la Plantilla para ser generada por el usuario final en el Co n tro l d e P lan tilla en la forma de la actividad Configure el control para generar la Plantilla automticamente a la Entrada, Salida o al Guardar de la actividad. IMPORTANTE Si va a configurar varias plantillas de documentos, asegrese de establecer las condiciones con las que cada documento se va a generar. Para ilustrar cmo realizar estos pasos vamos a configurar la generacin de una factura simple en los siguientes captulos. Esta contendr la informacin del cliente y los productos adquiridos.

Nota: Si usted est usando un tipo de letra especial (font) para ser mostrada en sus documentos, le recomendamos embeberla dentro de su plantilla Para ms informacin refirase a Embed fonts in Office documents (Microsoft)

1358

Copyright 2013 - Bizagi

Cmo manejar la informacin editable?

Por defecto, los documentos que se generan a partir de las Plantillas de documento no son editables (son un documento final para propsitos de lectura). Esto quiere decir que si se requiere hacer cambios o actualizaciones en el contenido dinmico del documento (y que ste quede actualizado en Bizagi), se debe contemplar desde una etapa de diseo de la solucin la siguiente medida: 1. Identificar en qu Actividades del Proceso se puede editar la informacin contenida en los documentos. 2. Para las formas de esas Actividades, incluir los controles editables asociados a la informacin sujeta a ser modificada. 3. Incluir igualmente en esas formas, la posibilidad de volver a generar el documento. De esta manera, el usuario podr editar la informacin relevante directamente en la forma, y generar el documento nuevamente.

3.7.1

Crear la plantilla
Lo primero que necesita es una plantilla que contenga toda la informacin requerida, en el formato deseado. Bizagi es compatible actualmente con Microsoft Word formato .docx y Microsoft Excel formato .xlsx. Cree una o ms plantillas de Word (el formato del archivo debe ser. docx or .xlsx), incluyendo su logotipo corporativo y el formato por defecto (por ejemplo, esquema de color particular, fecha de actualizacin del documento, nmero de pginas, frmulas). Adicionalmente, incluya la informacin dinmica que se requiere para ser tomada del modelo de datos. Esta informacin debe estar contenida dentro de corchetes cuadrados y sin espacios. Esto se conoce como Tag de plantilla.

Solicitante: [Nombredelsolicitante]
Cada Tag de plantilla se mapea a un atributo en el modelo de datos. El texto entre corchetes puede ser cualquier texto, no tiene qu ser el nombre real del atributo en el modelo de datos. (El atributo del modelo de datos se relacionar con la referencia del Tag.) Se recomienda dar al Tag un nombre auto-explicativo que describa lo que se quiere mapear, as el proceso de mapeo ser simple y directo. Para obtener informacin de una coleccin debe utilizar Tags especiales: [Foreach:NombredelaColeccin]: Indica el punto de partida de una coleccin, es decir el nombre de la coleccin.. [NombredelAtributodentrodelaColeccin]: Referencia un atributo especfico de la coleccin. Puede relacionar tantos atributos como desee. [End]: Indica el punto final de la coleccin. Desde este punto en adelante Bizagi asumir que los siguientes Tags no pertenecen a la coleccin.

Copyright 2013 - Bizagi

1359

[Foreach:PrescripcinMdica][NombreMedicamento] [Cantidad][End]

[Dsis]

Para mayor informacin acerca de cmo crear templates en diferentes formatos, por favor consulte los siguientes artculos: Crear una plantilla de word Crear una plantilla de excel

3.7.1.1

Crear plantilla de Word Para crear una plantilla de Word siga estos pasos: 1. Cree un documento de Word como una plantilla. Incluya el cuerpo del texto y ajuste el tipo de letra, tamao de letra, mrgenes, encabezados, etc, de acuerdo al diseo deseado.

El cuerpo de su documento puede incluir ttulos, subttulos, tablas, textos, imgenes, etc Por ejemplo, para crear una plantilla de una factura necesitamos informacin del cliente y una tabla de los productos adquiridos.

1360

Copyright 2013 - Bizagi

2. Referencie la informacin que se obtendr de forma dinmica del modelo de datos de Bizagi. Recuerde que la informacin que se va a obtener debe ser especificada como Tags de plantilla, por ejemplo, [NombredeAtributo]. Esto permitir la obtencin de la informacin desde el modelo de datos del proceso. Por ejemplo, el nombre del cliente se referencia con el Tag [NombredelCliente].

Para hacer referencia a una coleccin debe utilizar las siguientes etiquetas:

Copyright 2013 - Bizagi

1361

[Foreach:NombreColeccion]: Indica el punto de partida de la tabla de productos. [NombreAtributo]: Todos los atributos entre la Foreach y la etiqueta final debe pertenecer a la coleccin. [End]: Indica el final de la recoleccin de los productos.

Note en la imagen de arriba cmo en la coleccin de productos se hace referencia mediante los Tags [Foreach:Products]. Todos los Tags escritos a partir de ste hasta el [End] son atributos de esta coleccin. ([Producto], [Cantidad], [Precio])

Notas Los nombres de los de Tags a atributos y colecciones pueden ser diferentes a los nombres dados en el modelo de datos. Esta es slo una referencia para ser utilizado cuando el mapeo de la informacin. Los Tags no pueden contener espacios. 3. Guarde su plantilla. Una vez que haya definido el formato cuerpo del documento, guarde el documento como un documento estndar de Word .docx.

1362

Copyright 2013 - Bizagi

3.7.1.2

Crear plantilla de excel Para crear una plantilla de Excel siga estos pasos: 1. Cree un nuevo Libro de excel. Defina el formato deseado ajustando el tipo de letra, tamao, formato de celda, formulas etc, de acuerdo a sus necesidades.

Copyright 2013 - Bizagi

1363

El formato de su hoja de clculo puede incluir ttulos, subttulos, tablas, textos, imgenes, etc. Adicionalmente usted puede incluir tantas hojas como sean necesarias. Por ejemplo, para crear una plantilla de una factura en Excel, necesitamos informacin del cliente y una tabla para mostrar los productos adquiridos.

1364

Copyright 2013 - Bizagi

2. Referencie la informacin que se obtendr de forma dinmica del modelo de datos de Bizagi. Recuerde que la informacin que se va a obtener debe ser especificada como Tags de plantilla, por ejemplo, [NombredeAtributo]. Esto permitir la obtencin de la informacin desde el modelo de datos del proceso. Por ejemplo, el nombre del cliente se referencia con el Tag [NombredelCliente].

Copyright 2013 - Bizagi

1365

Para hacer referencia a una coleccin debe utilizar las siguientes etiquetas: [Foreach:NombreColeccion]: Indica el punto de partida de la tabla de productos. [NombreAtributo]: Todos los atributos entre la Foreach y la etiqueta final debe pertenecer a la coleccin. [End]: Indica el final de la recoleccin de los productos.

Note en la imagen de arriba cmo en la coleccin de productos se hace referencia mediante los Tags [Foreach:Products]. Todos los Tags escritos a partir de ste hasta el [End] son atributos de esta coleccin. ([Producto], [Cantidad], [Precio])

Notas Los nombres de los de Tags a atributos y colecciones pueden ser diferentes a los nombres dados en el modelo de datos. Esta es slo una referencia para ser utilizado cuando el mapeo de la informacin. Los Tags no pueden contener espacios.

3. Incluya las frmulas requeridas. Suponga que en nuestra Factura se desea calcular el precio total de cada producto. Este se calcular como el producto de la cantidad por el precio unitario en cada fila, por lo que se utiliza una frmula en la celda de precio total para este propsito.

1366

Copyright 2013 - Bizagi

Nota Todas las frmulas incluidas en la plantilla se recalcularn al momento de generar el documento.

4. Guarde su plantilla. Una vez que haya definido el formato y cuerpo del libro, gurdelo como un libro estndar de Excel .xlsx.

Copyright 2013 - Bizagi

1367

3.7.2

Definir cmo generar el documento

El segundo paso es definir cmo se generar la plantilla de documento en el proceso. Las plantillas de documento se pueden generar de dos maneras: Manualmente: por los usuarios finales, dando click en un botn Gen erar que se muestra en una actividad especfica. Automaticamente, via expresiones, sin intervencin de los usuarios finales.

3.7.2.1

Incluir plantilla para generar manualmente 1. Cree un atributo de tipo de Archivo en el modelo de datos.

1368

Copyright 2013 - Bizagi

2. Inserte un control de Plantillas de documentos. En la pestaa de Controles arrastre y suelte un Control de P lan tilla d e d o cu m en to en el lugar donde usted lo desee.

Copyright 2013 - Bizagi

1369

3. Identifique la fuente de datos: relacione el atributo de tipo de archivo al control. En las Propiedades bsicas del Control Plantilla de documento,s haga clic en el icono de F u en te d e d ato s y seleccione el atributo creado previamente.

4. Por defecto, la etiqueta del botn que genera los documentos es Generar documentos. Si desea cambiarla escriba el texto que desee en la propiedad Etiq u eta d el b o t n .

1370

Copyright 2013 - Bizagi

5. Configure las propiedades avanzadas del control. Mostrar botn generar: Esta opcin permite mostrar y ocultar el botn en el Portal de Trabajo para los usuarios finales. Cuando el documento ya est generado y slo necesita ser mostrado, esta propiedad debe estar apagada. Cuando el documento se genera dinmicamente por el usuario final esta propiedad debe estar encendida. Validar formulario antes de generar: Tan pronto como el usuario final de clic en el botn Generar, esta opcin valida que todos los campos obligatorios de la Forma estn diligenciados y ejecuta las Acciones y Validaciones. Esta caracterstica ayudar al usuario final a tener toda la informacin completada antes de generar el documento. Reemplazar documentos existentes: Si se selecciona, el documento se sobrescribir cada vez que se genere. De lo contrario, el documento se duplicar cada vez que se genera. Abrir automticamente: Si esta activado, una ventana mostrar automticamente una previsualizacin del documento cuando el usuario final lo gener. Descargar todos los documentos: Si se selecciona, todos los documentos se descargarn automticamente cada vez que el usuario final haga clic en el botn de generar. Habilitar "enviar como adjunto": Muestra un cono que permite a los usuarios enviar rpidamente el archivo como adjunto en un correo electrnico.

Copyright 2013 - Bizagi

1371

3.7.2.2

Incluir plantilla para generar automticamente 1. Cree un atributo de tipo de Archivo en el modelo de datos.

1372

Copyright 2013 - Bizagi

2. Inserte en la forma un control A rch iv o . Vaya a la pestaa Data en el Modelador de Formas. Arrastre un control Archivo al lugar donde lo desea en la forma.

3. Vaya al cuarto paso del Asistente de Proceso y seleccione A ccio n es d e A ctiv id ad . Seleccione la tarea donde el documento ser generado y escoja Tem p late al Entrar, Guardar o al Salir.

Copyright 2013 - Bizagi

1373

4. El Asistente de Documentos se desplegar. Ingrese el nombre del Documento a ser generado y seleccione el XPath o navegacin de datos.

Reemplazar documentos existentes: Si est seleccionado, el documento sobre escribir los documentos hasta ahora creados con el mismo nombre.De lo contrario se crear un nuevo documento.

3.7.3

Configurar plantilla de documento

El paso final consiste en establecer la configuracin de la Plantilla de documentos: Elegir la plantilla que se utilizar Relacionar la informacin del modelo de datos con los Tags de la plantilla. Seleccionar el formato de exportacin.

1374

Copyright 2013 - Bizagi

Esto se hace fcilmente mediante el asistente de configuracin.

Para documentos generados manualmente

El asistente de configuracin est en la pestaa de propiedades Bsicas del control, tan pronto como la Fuente de datos se ha definido. Haga clic en el botn A sisten te d e co n fig u raci n .

Para documentos generados automticamente

El asistente de configuracin se despliega en las propiedades de la Plantilla a la derecha.

En adelante la configuracin es igual: El asistente de configuracin se mostrar con las siguientes opciones: Condicin: Esta opcin le permite establecer las condiciones de generacin para cada plantilla

Copyright 2013 - Bizagi

1375

incluida. Recuerde que usted puede incluir tantas plantillas como necesite. Las condiciones sern evaluadas cuando el usuario haga clic en el botn de generar. Las plantillas que cumplan con las condiciones generarn documento, las dems sern ignoradas. Esto funciona de manera similar a las condiciones de las notificaciones. Para ms informacin, consulte Mltiples Plantillas de documentos. Plantilla: En esta opcin se carga, actualiza, genera vista previa y elimina plantillas. Nombre del documento: En este campo se debe escribir el nombre visual que se le dar a los documentos generados. Mapeo: Esta opcin permite relacionar los Tags de plantilla con el modelo de datos del proceso. Exportar a: Esta opcin permite seleccionar el formato en el que se exportar el documento generado.

3.7.3.1

Configurar una plantilla de word Desde el Asistente de Configuracin siga estos pasos: 1. Cargue una plantilla de Word. Para cargar una plantilla haga clic en el icono de Adicin.

1376

Copyright 2013 - Bizagi

En la nueva ventana, haga clic en el botn B u scar, seleccione la plantilla y haga clic en Sig u ien te. Asegrese de que la plantilla no est abierta en otro lugar para subirla con xito.

Si lo desea, cambie el nombre de la plantilla. Haga clic en Sig u ien te.

Copyright 2013 - Bizagi

1377

Una nueva ventana mostrar una vista previa de la plantilla junto con la lista de Tags que se encuentran en la plantilla. Haga clic en F in alizar.

1378

Copyright 2013 - Bizagi

2. Defina el nombre del documento Este campo contiene el nombre visual del documento que se genera en el Portal de Trabajo.

Si la propiedad Reem p lazar lo s d o cu m en to s ex isten tes est deshabilitada y el usuario final hace clic

Copyright 2013 - Bizagi

1379

en Gen erar varias veces, se generarn varias versiones del mismo documento. Cada copia se nombrar con el nombre del documento seguido de un nmero secuencial. Por ejemplo, si F actu ra es el nombre del documento, cuando se crea un segundo documento de la misma plantilla que se llamar Factura1 como se muestra a continuacin.

3. Mapee la informacin desde el modelo de datos del Proceso. Esta opcin permite relacionar los Tags de plantilla con el modelo de datos del proceso. Haga clic en el botn A ad ir m ap eo para abrir el asistente.

1380

Copyright 2013 - Bizagi

Aparecer una nueva ventana. En esta ventana se encuentran los atributos del modelo de datos de proceso de la izquierda y de los Tags de plantilla de la derecha. Usted debe relacionar los atributos a los Tags mediante una lnea entre los elementos deseados. Para ello, haga clic en un elemento del modelo de datos y, a continuacin, haga clic en el Tag correspondiente. Tambin puede arrastrar y soltar la relacin. Este procedimiento se debe repetir para cada Tag.

Copyright 2013 - Bizagi

1381

Para la plantilla de Factura este sera el mapeo completo. Tenga en cuenta que en la tabla de Tags en la coleccin de Productos se tienen los atributos de la coleccin

1382

Copyright 2013 - Bizagi

Nota Usted puede incluir colecciones filtradas, la fecha actual y alguna informacin del caso en sus documentos. Para mayor informacin consulte Funciones avanzadas de mapeo

4. Defina el formato de Exportacin Seleccione el formato en el que se generar el documento. Los formatos disponibles son: PDF: Exporta el documento en formato PDF para garantizar que el aspecto y la estructura del documento original no se modifique. Igual que la plantilla: Exporta el documento en el mismo formato de la plantilla. Actualmente solo se soporta .docx PDF/A-1a: Exporta el documento en PDF / A-1a para garantizar que el contenido del documento se pueden buscar y reproducir. PDF/A-1b: Exporta el documento en PDF / A-1b para asegurar una reproduccin fiable de la apariencia visual del documento.

Copyright 2013 - Bizagi

1383

Generacin de un documento de Word

Una vez configurada la plantilla, est lista para generar en el Portal de Trabajo. Vaya al Portal de Trabajo y abra la actividad en donde se generar el documento. Si su documento se genera con una expresin asegrese de que esta se ejecute. Incluya la informacin necesaria en los campos de la Forma. Cuando termine, haga clic en el botn Gen erar d o cu m en to .

1384

Copyright 2013 - Bizagi

Una vez generado, haga clic en el enlace del documento para abrirlo.

As luce el documento. Observe cmo se incluye la informacin introducida en la Forma.

Copyright 2013 - Bizagi

1385

Si se hubiera seleccionado PDF como formato de exportacin, el documento lucira asi:

3.7.3.2

Configurar una plantilla de excel Desde el Asistente de Configuracin siga estos pasos: 1. Cargue una plantilla de Excel. Para cargar una plantilla haga clic en el icono de Adicin.

1386

Copyright 2013 - Bizagi

En la nueva ventana, haga clic en el botn B u scar, seleccione la plantilla y haga clic en Sig u ien te. Asegrese de que la plantilla no est abierta en otro lugar para subirla con xito.

Si lo desea, cambie el nombre de la plantilla. Haga clic en Sig u ien te.

Copyright 2013 - Bizagi

1387

Una nueva ventana mostrar una vista previa de la plantilla junto con la lista de Tags que se encuentran en la plantilla. Haga clic en F in alizar.

1388

Copyright 2013 - Bizagi

2. Defina el nombre del documento Este campo contiene el nombre visual del documento que se genera en el Portal de Trabajo.

Si la propiedad Reem p lazar lo s d o cu m en to s ex isten tes est deshabilitada y el usuario final hace clic

Copyright 2013 - Bizagi

1389

en Gen erar varias veces, se generarn varias versiones del mismo documento. Cada copia se nombrar con el nombre del documento seguido de un nmero secuencial. Por ejemplo, si F actu ra es el nombre del documento, cuando se crea un segundo documento de la misma plantilla que se llamar Factura1 como se muestra a continuacin.

3. Mapee la informacin desde el modelo de datos del Proceso. Esta opcin permite relacionar los Tags de plantilla con el modelo de datos del proceso. Haga clic en el botn A ad ir m ap eo para abrir el asistente.

1390

Copyright 2013 - Bizagi

Aparecer una nueva ventana. En esta ventana se encuentran los atributos del modelo de datos de proceso de la izquierda y de los Tags de plantilla de la derecha. Usted debe relacionar los atributos a los Tags mediante una lnea entre los elementos deseados. Para ello, haga clic en un elemento del modelo de datos y, a continuacin, haga clic en el Tag correspondiente. Tambin puede arrastrar y soltar la relacin. Este procedimiento se debe repetir para cada Tag. Tenga en cuenta que la informacin mapeada mantendr el formato definido en el template.

Copyright 2013 - Bizagi

1391

Note que para hojas de clculo de excel, se crean nodos hijos para el documento. Estos nodos representan las hojas de la plantilla de excel. NO MAPEE ESTOS ELEMENTOS.

1392

Copyright 2013 - Bizagi

Para la plantilla de Factura este sera el mapeo completo. Tenga en cuenta que en la tabla de Tags en la coleccin de Productos se tienen los atributos de la coleccin

Copyright 2013 - Bizagi

1393

Nota Usted puede incluir colecciones filtradas, la fecha actual y alguna informacin del caso en sus documentos. Para mayor informacin consulte Funciones avanzadas de mapeo 4. Defina el formato de Exportacin Seleccione el formato en el que se generar el documento. Los formatos disponibles son: PDF: Exporta el documento en formato PDF para garantizar que el aspecto y la estructura del documento original no se modifique. Igual que la plantilla: Exporta el documento en el mismo formato de la plantilla. Actualmente solo se soporta .xlsx PDF/A-1a: Exporta el documento en PDF / A-1a para garantizar que el contenido del documento se pueden buscar y reproducir. PDF/A-1b: Exporta el documento en PDF / A-1b para asegurar una reproduccin fiable de la apariencia visual del documento.

1394

Copyright 2013 - Bizagi

Generacin de un documento de Excel

Una vez configurada la plantilla, est lista para generar en el Portal de Trabajo. Vaya al Portal de Trabajo y abra la actividad en donde se generar el documento. Si su documento se genera con una expresin asegrese de que esta se ejecute. Incluya la informacin necesaria en los campos de la Forma. Cuando termine, haga clic en el botn Gen erar d o cu m en to .

Copyright 2013 - Bizagi

1395

Una vez generado, haga clic en el enlace del documento para abrirlo.

As luce el documento. Observe cmo se incluye la informacin introducida en la Forma y cmo se calcul la columna de precio total.

1396

Copyright 2013 - Bizagi

Si se hubiera seleccionado PDF como formato de exportacin, el documento lucira asi:

Nota Tenga en cuenta que cuando se genera un documento de excel en formato pdf, usted debe configurar las mrgenes de la pgina, de no hacerlo, el documento podra mostrar la informacin en forma desordenada.

3.7.3.3

Editar y eliminar una plantilla

Actualizar una plantilla

Una vez que haya cargado una plantilla, es posible cambiar algunos datos de la misma, por ejemplo una imagen o una palabra, sin el inconveniente de tener que volver a configurarla. Bizagi le permite modificar una plantilla y retener el resto de la configuracin. Haga clic en el botn A ctu alizar para seleccionar la plantilla ajustada.

Copyright 2013 - Bizagi

1397

Seleccione el archivo y, si es necesario, cambie el nombre de la plantilla. Si hace clic en el vnculo Gu ard ar u n a co p ia lo cal usted podr guardar la versin original (antes de la modificacin) de la plantilla actualizada, en su ordenador.

Cuando termine, haga clic en Sig u ien te y, a continuacin, haga clic en F in alizar.

1398

Copyright 2013 - Bizagi

Nota: Cuando se actualiza una plantilla el mapeo no se perder si la plantilla es similar a la original. Le recomendamos que una vez actualizado, compruebe el mapeo

Vista previa de una plantilla

Para ver la vista previa de una plantilla haga clic en el botn de Vista P rev ia. Esta opcin le permite identificar visualmente la plantilla.

Eliminar una plantilla

Para eliminar una plantilla, seleccione la plantilla que desee en la lista de plantillas y haga clic en el botn Elim in ar.

Copyright 2013 - Bizagi

1399

3.7.4

Temas avanzados de plantillas de documentos

Esta seccin presenta caractersticas avanzadas para las plantillas de documentos. Entre estas encontramos: Incluir imagenes en plantillas de documento Funciones avanzadas de mapeo Mltiples plantillas de documento Integracin ECM

3.7.4.1

Incluir imagenes en plantillas de documentos En muchas situaciones usted puede necesitar incluir fotos, grficos, cdigos de barras, logos, firmas etc, como objetos de imagen en documentos generados a lo largo de la ejecucin de un Proceso. Bizagi permite incluir imgenes en sus Plantillas de Documento. Esto permitir que sus documentos contengan informacin ms completa y sean ms llamativos.

Consideraciones
Las imgenes incluidas en plantillas de documentos deben ser parte de la informacin del Proceso, es decir, deben ser cargadas durante la ejecucin del Proceso en un atributo de tipo imagen. Las imgenes en una Plantilla de Documento se muestran en su tamao original.

Cmo incluir imgenes en Plantillas de Documentos

Las imgenes en Plantillas de Documentos se incluyen de la misma manera que otros tipos de informacin. Todo lo que usted necesita es definir un atributo de tipo imagen en el modelo de datos del Proceso, disear su plantilla de Word incluyendo el tag correspondiente y relacionando el atributo a dicho tag en el Mapeo de la Plantilla de Documento. Lo anterior se clarificar en el siguiente ejemplo:

1400

Copyright 2013 - Bizagi

En la primera actividad de un P ro ceso d e In g reso d e P erso n al, el Asistente de Recursos Humanos incluye la informacin de un nuevo empleado. Para mantener registros fsicos de la informacin de los empleados, se genera e imprime un documento que contiene toda la informacin del nuevo empleado. Este documento incluye una foto del empleado. Para incluir la foto del empleado y toda su informacin en una Plantilla de Documento, siga los pasos que se describen a continuacin: 1. Cree una plantilla de Word con los tags necesarios. Observe que hemos incluido un tag para mostrar la foto del empleado, de la misma forma en que lo hicimos para el resto de la informacin.

2. Vaya a la forma de la actividad e incluya los controles necesarios. Observe que hemos incluido un control de tipo imagen para cargar la foto del empleado.

Copyright 2013 - Bizagi

1401

3. Inserte un control de Plantilla de Documento y configure la plantilla de Word asociada.

4. En las opciones de mapeo, relacione cada control con su correspondiente tag en el documento. Observe que relacionamos el control de tipo imagen con el tag correspondiente en el documento, de la misma manera que lo hicimos para los dems controles. Cierre el Asistente de Configuracin y guarde la forma.

1402

Copyright 2013 - Bizagi

5. Vaya al Portal de Trabajo, incluya la informacin necesaria en la actividad (incluyendo la foto del empleado) y genere el documento dando clic en el botn Gen erar Do cu m en to .

Observe como luce el documento.

Copyright 2013 - Bizagi

1403

3.7.4.2

Mltiples Plantillas de documentos

Informacin general
En una sola Plantilla de documentos se pueden relacionar varias plantillas con contenido diferente. Para cada plantilla se puede definir las condiciones que se evaluarn en el Portal de Trabajo, y si se cumple Bizagi generar el documento relacionado, de lo contrario se ignorar. Para relacionar varias plantillas a un Control de Plantilla de documentos nico, abra el asistente de configuracin haciendo situado en la pestaa de propiedades Bsicas del control.

1404

Copyright 2013 - Bizagi

El asistente de configuracin se abrir. Para crear una nueva Plantilla de documentos, haga clic en el icono de signo M s situado en la esquina superior derecha.

Esto crear una nueva pestaa donde se puede crear una nueva plantilla. Puede aadir tantas plantillas con diferente contenido como desee.

Copyright 2013 - Bizagi

1405

Ejemplo
Para el documento de Factura creada en la seccin anterior, vamos a configurar dos plantillas: una para un cliente de tipo persona natural y otro para persona jurdica. Habr dos plantillas .docx , con informacin diferente, una para cada clasificacin de los clientes.

Defina cada plantilla indicando el nombre del documento, mapeo y formato de exportacin.

1406

Copyright 2013 - Bizagi

Establezca las condiciones para generar cada documento. Si no hay ninguna condicin, los documentos siempre se generarn. Para establecer una condicin d clic en el botn M s. Un editor de Expresin booleana se mostrar.

Cree la condicin y haga clic en F in alizar. Para nuestro documento de Factura se identifica el tipo de cliente con un atributo relacionado a una en una entidad paramtrica llamada Ty p eo fCu sto m er.

Copyright 2013 - Bizagi

1407

Establecer las condiciones para la otra plantilla y haga clic en Aceptar para guardar los cambios.

Para probar la configuracin, vaya al Portal de Trabajo y abra la tarea en la que se genera el documento. Incluya la informacin necesaria en los campos de la Forma. Seleccione Persona Natural en el tipo de cliente en la lista desplegable.

1408

Copyright 2013 - Bizagi

Haga clic en el botn Generar documento. La siguiente imagen muestra el documento generado para persona natural.

Copyright 2013 - Bizagi

1409

Ahora seleccione Persona Jurdica en el tipo de cliente en la lista desplegable.

Haga clic en el botn Generar documento. La siguiente imagen muestra el documento generado para persona jurdica.

1410

Copyright 2013 - Bizagi

Tenga en cuenta que los documentos se generan con base a las plantillas definidas para cada tipo de cliente. 3.7.4.3 Funciones avanzadas de mapeo Es muy comn desear incluir en una plantilla de una coleccin que debe ser filtrada, as como un campo que requiere desplegar la fecha de hoy o una referencia a la informacin de un caso. Puede incluir esta informacin utilizando Bizagi presenta las funciones avanzadas que se encuentran en el Co n tro l d e M ap eo en el A sisten te d e Co n fig u raci n . Para acceder a las funciones avanzadas expanda el Co n tro l d e M ap eo como se muestra en la imagen de abajo.

Copyright 2013 - Bizagi

1411

Las funciones avanzadas se encuentran en el icono de herramientas a la derecha, como se muestra a continuacin. Hay tres funciones disponibles para usar junto con el mapeo de los atributos hacia los Tags de la plantilla: Informacin caso: incluye la identificacin de caso y el nmero de caso. Fecha de hoy: retorna la fecha de hoy. Filtro Colecciones: abre la funcin de filtro de coleccin para filtrar los registros que sean necesarios en el documento. Para restaurar la ventana a su tamao original, haga clic en el icono en la esquina superior derecha.

1412

Copyright 2013 - Bizagi

Incluir la fecha de hoy

1. Despliegue las funciones avanzadas y arrastre la funcin F ech a d e h o y . Sultela entre las dos tablas.

Copyright 2013 - Bizagi

1413

2. Una nueva ventana aparecer donde usted puede seleccionar el formato como desea que la fecha que aparezca en el documento. Haga clic en O k cuando haya seleccionado un formato.

3. Mapee la funcin hacia el Tag de la plantilla que se debe guardar la fecha.

1414

Copyright 2013 - Bizagi

4. Restaure la ventana a su tamao original haciendo clic en el icono en la esquina superior derecha y haga clic en F in alizar.

Incluya un filtro a una coleccin

1. Despliegue las funciones avanzadas y arrastre la funcin F iltro Co leccio n es. Sultela entre las dos tablas.

Copyright 2013 - Bizagi

1415

2. Mapee la funcin con el atributo del modelo de datos, donde se guarda la coleccin. Esto abrir la funcionalidad de filtros de coleccin en la que pueden incluir las condiciones para filtrar los registros. Haga clic en Ok cuando el filtro est incluido.

1416

Copyright 2013 - Bizagi

3. Mapee la funcin hacia a el Tag de la plantilla, donde se encuentra la coleccin. Observe que la coleccin se mapea desde el modelo de datos hacia la etiqueta pero con una funcin en el medio que va a filtrar los registros existentes de la tabla.

Copyright 2013 - Bizagi

1417

4. Restaure la ventana a su tamao original haciendo clic en el icono en la esquina superior derecha y haga clic en F in alizar.

Cinluya informacin del caso

1. Despliegue las funciones avanzadas y arrastre la funcin In fo rm aci n caso . Sultela entre las dos tablas.

1418

Copyright 2013 - Bizagi

2. Mapee la funcin hacia el Tag de la plantilla donde se debe guardar la informacin del caso.

Copyright 2013 - Bizagi

1419

3. Restaure la ventana a su tamao original haciendo clic en el icono en la esquina superior derecha y haga clic en F in alizar.

Borrar una funcin

Para eliminar una funcin avanzada, haga clic sobre sta y oprima la tecla Supr en el teclado. Todos los mapeos se perdern. 3.7.4.4 Integracin ECM

(10.1.X and higher)

Introduccin
Bizagi soporta nativamente la integracin con sistemas ECM. Los documentos cargados en una actividad de Proceso se almacenan, por defecto, en el servidor BPM (o un servidor de archivos en red). Con esta opcin usted puede definir cual es su repositorio central de documentos (sistema ECM) en Bizagi, de manera que los archivos cargados se almacenen directamente all.

1420

Copyright 2013 - Bizagi

En ejecucin, los usuarios finales slo adjuntaran documentos en instancias de Procesos y Bizagi los enviar automticamente al ECM. Las posibilidades en la integracin ECM son: Subir un documento o actualizar su contenido. Definir la informacin de su metadata (indexacin). Hacer check-out al documento o deshacer el check-out. Hacer check-in al documento. Eliminar el documento. Nota: Esta funcionalidad esta soportada a partir de las versiones 10.1.X .Net de Bizagi.

Prerequisitos
Para la integracin ECM se requiere que el sistema ECM cumpla con el estndar CMIS 1.0(Content Management Interoperability Services). Este estndar consiste en un conjunto genrico de servicios web que exponen las capacidades del ECM y manipulan metadata. Los expositores ms importantes en la industria ECM soportan el estndar CMIS. Bizagi puede integrarse fcilmente con estos productos lderes en el mercado, tales como: SharePoint, Alfresco, Documentum o Filenet.

Lo que necesita en Bizagi

Dentro de la integracin ECM se llevan a cabo los siguientes pasos: 1. Configurar el ECM.

Copyright 2013 - Bizagi

1421

Este paso se realiza para asegurar que su sistema ECM ofrece y cumple con los servicios web CMIS 1.0 Para mayor informacin consulte Configurar el ECM. 2. Asignar el ECM en Bizagi. Este paso implica: Registrar el ECM en Bizagi. Es decir, especificar su URL, repositorio especfico (carpeta) y cualquier otra informacin adicional para conectarse al ECM. Definir cules atributos tipo archivo de su modelo de datos de Proceso, se almacenarn directamente en el ECM Dentro de esta definicin usted configura la carpeta especfica en la cual se almacenarn los archivos cargados. Considerar en su interfaz de usuario (formas de actividad) el control y configuracin apropiados para los atributos tipo archivo. En este punto usted tambin puede definir como asociar la metadata al repositorio ECM. Para mayor informacin sobre este paso consulte Definir el ECM en Bizagi.
3.7.4.4.1 Configurar el ECM

Para configurar el sistema ECM de manera que se garantice compatibilidad con el estndar CMIS 1.0, consulte los artculos a continuacin, de acuerdo a su Sistema de Gestin Documental: Configurar SharePoint Configurar Alfresco Configurar Documentum Tenga presente que la configuracin del ECM es prerequisito para la configuracin de la integracin en Bizagi, como se describe en Integracin con ECM.
3.7.4.4.1.1 Configurar SharePoint como ECM

Introduccin
Bizagi soporta SharePoint como sistema ECM (Gestor documental) integrado a la solucin para el almacenamiento de documentos adjuntos en los Procesos. Ms informacin sobre esta funcionalidad en Integracin con ECM. Para configurar SharePoint como el sistema ECM integrado a Bizagi, primero asegrese que su versin de SharePoint sea compatible con el estndar CMIS 1.0. Por ejemplo, SharePoint 2007 y 2010 soportan CMIS 1.0 a travs de un add-on. Los siguientes pasos aplican para una instalacin de SharePoint 2007 o de SharePoint 2010 (estos pasos no son necesarios en SharePoint 2013).

Prerequisitos
Los siguientes son prerequisitos para la configuracin de CMIS y de integracin ECM con Bizagi: Tener una cuenta de servicio que sea privilegios de administracin sobre la granja (FarmAdministrator). Los servicios de SharePoint Timer y SharePoint Administrator (p.e SharePoint 2010 Timer, SharePoint 2010 Administrator) deben estar iniciados.

1422

Copyright 2013 - Bizagi

El SharePoint Store Service Application debe estar configurado y con al menos una llave de cifrado creada.

Configuracin
Ntese que una instalacin de SharePoint 2010 por defecto, puede no incluir el mdulo de CMIS 1.0. Para asegurarse de que se incluya dicho mdulo de CMIS 1.0, siga estos pasos:

1. Descargue e instale el kit SharePoint Administration Toolkit el cual contiene el conector de servicios CMIS. Para SharePoint 2010, disponible en: http://www.microsoft.com/en-us/download/details.aspx? id=20022 Para SharePoint 2007, disponible en: http://technet.microsoft.com/en-us/library/cc508851% 28v=office.12%29.aspx 2. Active y despliegue el conector ejecutando la siguiente linea dentro del shell de Administracin de SharePoint 2010 (en el Servidor donde est Sharepoint, bajo In icio To d o s lo s P ro g ram as- M icro so ft Sh areP o in t 2010 P ro d u cts): Add-SPSolution LiteralPath 'C:\Program Files\Microsoft\SharePoint 2010 Administration Tookit\Content Management Interoperability Services (CMIS) Connectors\spcmis.wsp' 3. Seleccione la opcin de Gestionar soluciones de la granja ( M an ag e F arm So lu tio n s). Esta opcin se accede usualmente desde SharePoint Central Administrator, y desde el men de Configuracin del sistema ( Sy stem Settin g s). 4. Seleccione spscmis.wsp y de clic sobre desplegar soluciones ( Dep lo y So lu tio n s).

IMPORTANTE: Desde este punto en adelante, la siguiente configuracin se realiza desde el Sitio designado como p ro d u cto r. 5. Vaya a la Configuracin del sitio ( Site Settin g s) y desde la opcin Acciones del sitio ( Site A ctio n s) seleccione Administrar funciones del sitio (M an ag e Site F eatu res). Active el Productor CMIS (clic sobre el botn A ctiv ate del CMIS Producer).

Copyright 2013 - Bizagi

1423

6. Cree los tipos de contenido (content types) en Configuracin del Sitio ( Site Settin g s) -> Galeras ( Galleries) -> Tipos de Contenido del Sitio ( Site Co n ten t Ty p es).

1424

Copyright 2013 - Bizagi

7. Vaya a la Configuracin de la Librera ( Lib rary Settin g s). Dentro de la Configuracin General ( Gen eral Settin g s), vaya a Configuracin Avanzada ( A d v an ced Settin g s). Aqu es muy importante definir que permitiremos administracin de tipos de contenidos. Es decir, definir " Si" (Yes) a la pregunta: "Permitir administracin de tipos de contenido? ( A llo w m an ag em en t o f co n ten t ty p es?)". El resto de la configuracin debe ser como se muestra en la imagen:

Copyright 2013 - Bizagi

1425

Nota

1426

Copyright 2013 - Bizagi

Cuando se trabaja con la edicin Bizagi Enterprise JEE, se debe habilitar la autenticacin de tipo bsica ( B asic A u th en ticatio n ) para su SharePoint directamente en el IIS. Para Bizagi Enterprise .NET, no se debe habilitar esta autenticacin bsica. 8. En la misma Configuracin de la Librera ( Lib rary Settin g s), en la seccin Configuracin General ( Gen eral Settin g s) seleccione Configuracin de Versionamiento ( Versio n in g Settin g s) y modifquelo tal como se muestra en la imagen:

9. Finalmente, cree un repositorio de documentos (aqu se muestra uno llamado Bizagi Files) o use uno existente como Documentos Compartidos ( Sh ared Do cu m en ts). Ingrese al repositorio y seleccione la pestaa Librera ( Lib rary). Nuevamente en Configuracin de la Librera ( Lib rary Settin g s), en la seccin Tipos de Contenido ( Co n ten t Ty p es), adiciones los que se quieran usar en el repositorio hacienda clic en Aadir tipo de contenido existente en el sitio ( A d d fro m ex istin g site co n ten t ty p e).

Copyright 2013 - Bizagi

1427

Ntese que en nuestros ejemplos e imgenes, utilizamos una carpeta llamada "Bizagi Files":

En este punto ya hemos configurado SharePoint con los prerequisitos de la integracin. El paso siguiente es la configuracin del ECM en Bizagi como se describe en Definir el ECM en Bizagi.

1428

Copyright 2013 - Bizagi

Si desea verificar que el conector de CMIS est listo para operar en su instalacin de SharePoint, puede seguir los pasos de la siguiente seccin.

Verificar la configuracin
Para verificar el soporte de CMIS en su instalacin de SharePoint, puede navegar hacia los servicios Web de su sitio. Para ello, ingrese la siguiente URL desde un navegador: http://[your_server]/[sites]/[your_site]/_vti_bin/cmis/soap/ RepositoryService.svc?wsdl Una vez que se autentique, podr ver los servicios Web de CMIS disponibles como se ilustra:

Nota El conector CMIS de SharePoint tiene algunos inconvenientes conocidos por parte del fabricante (Microsoft), en donde pueden presentarse inconvenientes cuando se configura la conexin a un sitio de SharePoint que no est operando sobre el puerto por defecto (80). Para mayor detall y gua oficial del fabricante, consulte la documentacin de Microsoft sobre Instalar y configurar el conector CMIS.

Copyright 2013 - Bizagi

1429

3.7.4.4.1.2 Configurar Alfresco como ECM

Bizagi soporta Alfresco como sistema ECM (Gestor documental) integrado a la solucin para el almacenamiento de documentos adjuntos en los Procesos.

Para configurar Alfresco como el sistema ECM integrado a Bizagi, primero asegrese que su versin de Alfresco sea compatible con el estndar CMIS 1.0. Por ejemplo, la versin de Alfresco 3.4a (esto incluye la edicin community) cuenta con soporte a CMIS 1.0. Puede revisar y confirmar el soporte a CMIS 1.0 consultando la publicacin de sus servicios Web CMIS, ingresando esta URL en un navegador http://localhost:[alfresco_port]/alfresco/cmis:

1430

Copyright 2013 - Bizagi

Una vez que haya revisado que se cuentan con estos servicios, asegrese de crear un espacio designado al proyecto, y de crear los content types necesarios para su repositorio ECM. Ntese que esta tarea puede involucrar el administrador del ECM. Al final, deber tener un repositorio en Alfresco que tiene una carpeta para almacenar los adjuntos, donde se tiene metadata especfica al contenido que contendr la carpeta:

Copyright 2013 - Bizagi

1431

Notas y Consideraciones
Algunos repositorios de sistemas como Alfresco, soportan diferentes content types. Por ejemplo D: B P M :Task, el cual es propietario de este ECM en particular. Por este motivo, estos no se deben utilizar en Bizagi (aunque puedan ser mostrados cuando se configure la carpeta y content type en Bizagi). Se recomienda entonces, utilizar solo content types que hayan sido creados por el administrator.

En este punto ya hemos configurado Alfresco con los prerequisitos de la integracin. El paso siguiente es la configuracin del ECM en Bizagi como se describe en Definir el ECM en Bizagi.
3.7.4.4.1.3 Configurar Documentum como ECM

Bizagi soporta Documentum como sistema ECM (Gestor documental) integrado a la solucin para el almacenamiento de documentos adjuntos en los Procesos. Para configurar Documentum como el sistema ECM integrado a Bizagi, primero asegrese que su versin de Documentum sea compatible con el estndar CMIS 1.0. Por ejemplo, las versiones 6.6 o 6.7 de Documentum ya soportan por defecto CMIS 1.0.

1432

Copyright 2013 - Bizagi

Una vez que haya revisado que se cuentan con estos servicios, asegrese de crear un espacio designado al proyecto, y de crear los content types necesarios para su repositorio ECM. Ntese que esta tarea puede involucrar el administrador del ECM.

En este punto ya hemos configurado Documentum con los prerequisitos de la integracin. El paso siguiente es la configuracin del ECM en Bizagi como se describe en Definir el ECM en Bizagi.
3.7.4.4.2 Definir el ECM en Bizagi

Introduccin
Una vez tenga definido su ECM, con la carpeta del repositorio y sus tipos de contenido (contenttypes), podr configurarlo en Bizagi. Para ms informacin sobre los prerequisitos de configuracin del ECM, consulte Configurar el ECM.

Configuracin
Para definir el Sistema ECM que se utilizar como repositorio central integrado a los Procesos Bizagi (para almacenar los adjuntos), se deben realizar los pasos descritos a continuacin: 1. Registrar el ECM en Bizagi. Esto significa, definir la URL del ECM y el repositorio especfico (con la carpeta), y la dems informacin para la conexin con ese ECM. 2. Definir los atributos del modelo de datos que se almacenarn directamente en el ECM. En esta definicin, se establecer cuales atributos del modelo de datos tendrn sus documentos almacenados directamente al ECM. 3. Considerar en las interfaces de usuario, el control y configuracin para los atributos tipo archivo.

Copyright 2013 - Bizagi

1433

Ac tambin se debe planear cmo se manejar la metadata de los adjuntos.

1. Registrar el ECM en Bizagi

El primer paso es definir y registrar el detalle de su sistema ECM. Para hacerlo, vaya a la Vista d e M d u lo s y seleccione Sistem as Ex tern o s Usted puede crear un nuevo sistema externo o utilizar uno existente que an no posea configuracin ECM. Para crear el ECM, d clic en la opcin Sistem as Ex tern o s y luego en N u ev o sistem a ex tern o ....

Ingrese su N o m b re, N o m b re v isu al y una breve Descrip ci n . D clic en O K D clic en el sistema que se acabo de crear y seleccione la opcin N u ev o rep o sito rio .

1434

Copyright 2013 - Bizagi

Ingrese un N o m b re (Nombre del conector), N o m b re d e v isu al y una breve Descrip ci n para registrar este repositorio. Para sus Parmetros de conexin asegrese de especificar: URL: La URL de sus servicios web ECM's compatibles con CMIS. Note Para Sharepoint, la URL corresponde a: http://[your_server]/[sites]/[your_site]/ _vti_bin/cmis/soap Para Alfresco, la URL corresponde a: http://[your_server]:[port_number]/alfresco/ cmis Para Documentum, la URL corresponde to: http://[your_server]:[port_number]/emccmis-ea/services Nombre de usuario: Una cuenta de servicio autorizada para la conexin con el ECM, ingresada como: dominio\usuario.

Copyright 2013 - Bizagi

1435

Este cuenta necesitar tener acceso (permisos de escritura) a la carpeta de su repositorio. Contrasea: La contrasea para la cuenta de servicio del ECM autorizada. Nombre del repositorio: D clic en el botn a la derecha para seleccionar un repositorio.

Este botn probar la conexin a su ECM.

1436

Copyright 2013 - Bizagi

Observe que tambin puede especificar los diferentes parmetros de conexin involucrados en sus diferentes ambientes de proyecto (desarrollo, pruebas y produccin). Por defecto, usted llenar los parmetros de conexin de desarrollo, y en caso de no ingresar definiciones explicitas para los ambientes de pruebas y produccin, estos tomar la configuracin especificada para desarrollo. Una vez configurado su repositorio ECM, proceda a definir la carpeta que desea utilizar. Para hacerlo, ubique el repositorio que acab de crear, d clic derecho sobre l y seleccione N u ev a carp eta.

Copyright 2013 - Bizagi

1437

Asigne un nombre a su carpeta y d clic en el botn a la derecha para seleccionar la carpeta del ECM.

1438

Copyright 2013 - Bizagi

En este ejemplo, seleccionamos la carpeta Clien tDo cu m en t dentro de la carpeta B izag i de un repositorio principal de Alfresco's:

La configuracin final debera ser similar a la que se muestra en la siguiente imagen:

Copyright 2013 - Bizagi

1439

2. Definir los atributos del modelo de datos que se almacenarn directamente en el ECM.
Una vez que usted ha registrado y definido el sistema ECM en Bizagi, usted puede especificar los documentos que se almacenarn en el ECM. Usted puede especificar esto para cada atributo tipo archivo en su modelo de datos. Para hacerlo, ubique las entidades especificas que poseen los atributos tipo archivo, de los documentos que desea almacenar directamente en el ECM. Vaya al M d u lo d e en tid ad es y edite la lista de atributos de estas entidades:

1440

Copyright 2013 - Bizagi

En nuestro ejemplo crearemos un nuevo atributo de tipo archivo en la entidad Client:

Copyright 2013 - Bizagi

1441

Observe que una vez usted define que un atributo tipo archivo, usted puede seleccionar la Carpeta en la que se almacenarn los documentos de este atributo. Por defecto, se selecciona (B izag i) en esta propiedad, lo cual significa que no se utiliza ECM. D clic en la lista desplegable para ubicar su ECM y repositorios registrados, y seleccione la carpeta especfica:

1442

Copyright 2013 - Bizagi

Una vez se especifica la carpeta, asegrese de seleccionar un tipo de contenido vlido para sus documentos. Para hacerlo, d clic en la lista desplegable Tip o d e ECM . Usted tambin puede dar clic en Ver M etad ata para revisar la informacin esperada del contenido. Nota Cuando trabaje con diferentes ECMs tenga en cuenta: Sharepoint listar esos tipos de contenidos registrados en el repositorio. Alfresco listar todos los tipos de contenido, incluso aquellos que puedan no ser vlidos para los documentos dados. Se recomienda seleccionar los tipos de contenido personalizados creados en Alfresco. En Documentum, es muy recomendado revisar la metadata para asegurar que se seleccione el tipo de contenido adecuado.

Copyright 2013 - Bizagi

1443

D clic en F in alizar para guardar los cambios. El atributo Clien t d o cu m en t ha sido configurado para almacenar informacin en el ECM.

3. Considerar en las interfaces de usuario el control y configuracin para los atributos tipo archivo.
Una vez definidos los atributos tipo archivo que deberan tener los documentos almacenados directamente en el ECM, el ltimo paso es definir y configurar sus formas para incluir dichos atributos en un control tipo ECM. Para hacerlo, vaya al paso tres del Asistente de Procesos (Definir formas) y edite la forma de la actividad en la cual los usuarios finales cargarn los documentos.

1444

Copyright 2013 - Bizagi

En nuestro ejemplo, nuestra forma editada incluir ahora el atributo Clien t d o cu m en t, el cual se configura automticamente con el control correspondiente en Bizagi:

Copyright 2013 - Bizagi

1445

Observe que este atributo utiliza el control iCarg a d e arch iv o s ECM :

En este punto finalizamos la configuracin. Dando clic en el atributo se mostrarn ms configuraciones opcionales (como: especificar el nmero mximo de archivos- documentos- que pueden ser cargados en este atributo, especificar extensiones vlidas para ellos o habilitar el icono Enviar como adjunto, por nombrar algunas)

1446

Copyright 2013 - Bizagi

Ejecucin
Por defecto, la metadata involucrada en la carpeta del repositorio ECM se mostrar a los usuarios finales para que ellos puedan editar esta informacin en cada una de sus cargas. Si usted desea llenar la metadata de manera automtica, puede crear una regla de negocio para mapear la informacin de la instancia del Proceso en la metadata. Para mayor informacin acerca de esta opcin, consulte Asignar la metadata a travs de una regla. En nuestro ejemplo, nuestra forma de actividad permitir a los usuarios cargar documentos que se almacenarn directamente en el ECM.

Copyright 2013 - Bizagi

1447

Dando clic en el icono de carga podr incluir su documento adjunto.

Observe que una vez cargado, el archivo no se enviar al ECM inmediatamente. Cuando d clic en en botn Sig u ien te (al finalizar la actividad) Bizagi finalizar la transaccin (har

1448

Copyright 2013 - Bizagi

commit a la base de datos) y almacenar el documento en el ECM.

Opciones Adicionales
En esta misma actividad, usted ver que hay opciones adicionales para el documento tales como: Ver el documento, borrarlo o actualizar su metadata. Bizagi cargar una vista previa en miniatura (cuando se cargue un archivo de tipo imagen) o un icono representando el tipo de documento, tal como se muestra a continuacin:

Copyright 2013 - Bizagi

1449

Ver el documento D clic en el nombre del archivo para visualizar el documento (usted tambin puede guardar una copia local, de acuerdo al tipo de archivo). Con esta opcin si el documento se modifica, los cambios solo se guardarn localmente (y no en el ECM). Borrar el documento. D clic en el icono a la derecha del documento y luego en Borrar (para eliminarlo) Se le solicitar confirmacin. Actualizar su metadata D clic en el icono a la derecha del archivo, y luego en Ed itar para ingresar o modificar la metadata del documento.

1450

Copyright 2013 - Bizagi

Tenga en cuenta que esta es una edicin manual, la cual tambin se puede complementar asignando la metadata a travs de una regla Una vez el documento se ha cargado en el ECM, si se muestra el documento en las formas de la actividad se podrn realizar acciones adicionales (esto es, si el documento ECM se configura como editable), tales como: Actualizar el documento, bloquearlo (check out) o desbloquearlo. Si el documento se configura como no editable, solo se habilitar la opcin para verlo.

Copyright 2013 - Bizagi

1451

Actualizar el document D clic en A ctu alizar para cargar un remplazo para este documento (de manera similar como se adjunto el documento inicialmente). Bloquear / Desbloquear el documento D clic en B lo q u ear para hacer check out del documento, de manera que no se puedan realizar modificaciones directamente en el ECM por otro usuario o actividad. D clic en Desb lo q u ear para liberar un documento previamente bloqueado.

1452

Copyright 2013 - Bizagi

ECMs en produccin
Cuando se cree un nuevo repositorio, usted puede configurar y definir los valores de sus propiedades para cada ambiente (esto incluye las carpetas para el repositorio). Una vez que la configuracin ECM se ha llevado a ambiente de produccin, los valores para ese ambiente no podrn ser editados directamente en el ambiente de desarrollo (de manera similar, Bizagi no permitir borrar un ECM en el ambiente de desarrllos que esta trabajando actualmente en ambiente de produccin). Para el ambiente de pruebas, los valores pueden ser redefinidos en el ambiente de desarrollo (a travs de Bizagi Studio) de manera que un nuevo deployment sobrescriba esos valores. En resumen, para una configuracin de ECM que ya ha sido llevada a produccin, cualquier edicin a los valores de sus propiedades debe realizarse directamente en ese ambiente (utilizando el Management Console). Este mismo concepto aplica para la definicin de las carpetas en la integracin ECM.
3.7.4.4.2.1 Asignar la metadata a travs de reglas

Por defecto, un documento adjunto mediante la funcionalidad del control Archivos ECM le permitir editar la metadata (de manera manual). Sin embargo y cuando se utiliza la integracin ECM, hay escenarios en los que se puede necesitar mapear la informacin de negocio del caso a la metadata del documento (la cual ser indexada en el ECM). Esto significa que puede optar por usar una regla de negocio que asigne esta informacin del caso

Copyright 2013 - Bizagi

1453

hacia la metadata de la carpeta del repositorio. Los ejemplos a continuacin, ilustran los mtodos a utilizarse cuando se desea usar una regla para mapear automticamente la metadata.

Ejemplo 1
En este ejemplo, mapeamos la informacin del caso hacia la metadata: Ttulo y Descripcin. Nuestro archivo ECM est contenido en el atributo M iEn tid ad DeP ro ceso .M iA trib u to Tip o A rch iv o . var xPath = "MiEntidadDeProceso.MiAtributoTipoArchivo"; //este XPath corresponde al atributo de tipo archivo del modelo de datos var metadataHash = new Hashtable(); //crea una estructura temporal para almacenar la metadata metadataHash.Add("Titulo", <MiEntidadDeProceso.AtributoConNombre>); metadataHash.Add("Descripcin", <MiEntidadDeProceso.AtributoConDescripcion>); //realice esto para cada dato de la metadata var tmpFileAttribute = Me.getXPath(xPath); //obtiene toda la informacin del atributo de tipo archivo for(var i=0; i < tmpFileAttribute.size(); i++) //se itera, dado que un atributo de tipo archivo puede contener ms de 1 documento { var tmpFile = tmpFileAttribute.get(i); //obtiene el documento para cada registro var idFileUpload = tmpFile.getXPath("id"); //obtiene el id del documento var completeXpath = xPath + "[id=" + idFileUpload + "]"; //constuye el XPath completo para referenciar cada documento CHelper.UpdateECMMetadata(Me, metadataHash, completeXpath); //mtodo para mapear la metadata }

Ejemplo 2
En este ejemplo,nuestra regla se ejecuta en una forma donde hay una tabla, pero se mapea la metadata para los archivos adjuntos que estn como columnas de la tabla (dentro de la misma). Esto significa que mapeamos el Ttulo y la Descripcin (metadata), la cual es informacin que ya est contenida en el caso. Lo realizamos para archivos ECM que estn dentro de una coleccin: M y P ro cessEn tity .M y Co llectio n .M y F ileA ttrib u te. var xPath = "MyFileAttribute"; //este XPath corresponde al atributo de tipo archivo del modelo de datos var xPathContext = "MyProcessEntity.MyCollection"; //este XPath corresponde al contexto de la tabla var metadataHash = new Hashtable(); //crea una estructura temporal para almacenar la metadata metadataHash.Add("Title", <MyProcessEntity.CustomerNameAttribute>);

1454

Copyright 2013 - Bizagi

metadataHash.Add("Description", <MyProcessEntity.SomeDescriptionAttribute>); //realice esto para cada dato de la metadata var List = Me.getXPath(xPathContext); //obtiene la informacin de la tabla var Array = CHelper.GetValueAsCollection(List); for (var j=0; j < Array.size(); j++) //se itera dado que se realiza para cada registro de la tabla { var tmpRecord = Array.get(j); //obtiene el registro var FileAttrib = tmpRecord.getXPath(xPath); //obtiene la informacin del atributo tipo archivo var idRecord = tmpRecord.getXPath("id"); //obtiene el id de ese registro for(var i=0; i < FileAttrib.size(); i++) //se itera, dado que un atributo de tipo archivo puede contener ms de 1 documento { var SubFile = FileAttrib.get(i); //obtiene el documento var idFileUpload = SubFile.getXPath("id"); //obtiene el id del documento var completeXpath = xPathContext + "[id=" + idRecord + "]." + xPath + "[id=" + idFileUpload + "]"; //constuye el XPath completo para referenciar cada documento CHelper.UpdateECMMetadata(Me, metadataHash, completeXpath); // method to map metadata } }

3.8

Integracin con aplicaciones Informacin General

Bizagi provee una poderosa capa de integracin que sigue una arquitectura orientada a servicios que soporta diferentes posibilidades de integracin para toda la solucin corporativa BPM. En proyectos donde existe la necesidad de integrar Procesos con aplicaciones existentes (por ejemplo sistemas ESB), la capa de integracin de Bizagi presenta mltiples opciones de integracin.

Configurar una Integracin de Aplicacin

Bizagi soporta la integracin con el Bus (ESB) y cualquier otro sistema en ambas direcciones (ERP,CRM, Aplicaciones Core, Sistemas Legacy).

Invocar servicios externos desde Bizagi

Es posible invocar servicios basados en Web (como SOAP,REST) o APIs directamente dentro de Procesos Bizagi (como dlls,jars) como se describe a continuacin. Para invocar servicios externos dentro de Procesos en Bizagi, se recomienda definir estos puntos de integracin como Tareas de Servicio BPMN.

Copyright 2013 - Bizagi

1455

Utilizando Tareas de Servicio para configurar puntos de integracin, usted puede especificar si la invocacin a servicios externos se hace de manera sncrona o asncrona. Para ver ms informacin acerca de configuracin de esos puntos de integracin para ejecucin asncrona, consulte Actividades Asncronas. Invocacion de servicios basados en Web Nuestro mtodo preferido de integracin es a travs de servicios basados en Web, en los cuales la configuracin es asistida en Bizagi (evitando la necesidad de programar una solucin o requerir un perfil con alto nivel de conocimiento tcnico) Este mtodo presenta la posibilidad de invocar fcilmente un servicio web SOAP o REST desde Bizagi. Vea ms informacin acerca de cmo invocar servicios web SOAP o REST en Bizagi (integracin a nivel de Proceso). Integrar APIs o cdigo personalizado (conectores) Bizagi brinda la posibilidad de utilizar APIs especficos y conectores a sistemas externos (Clases EJB, JMS, etc). Esto se provee por una caracterstica en Bizagi denominada Librera de Componentes, que presenta opciones de extensibilidad para registrar cualquier componente desarrollado a medida. El concepto detrs de esta integracin es tener un componente separado en tecnologa .Net o Java (disponible para ediciones Bizagi Enterprise) y luego entregar el archivo de construccin (compilado), es decir un archivo .dll o .jar, a Bizagi por medio de un proceso de registro. De esta manera, este mtodo de componentes puede ser invocado directamente dentro de las reglas de negocio de los Procesos. Vea ms informacin acerca de invocaciones API en la funcionalidad de Librera de Componentes.

Invocar servicios Bizagi desde aplicaciones externas Aplicaciones externas pueden invocar fcilmente las funcionalidades de Bizagi a travs de la capa SOA de Bizagi. Bizagi sigue una arquitectura orientada a servicios para mejores prcticas hacia capacidades de integracin y diseo, y a travs de su capa SOA, cada proyecto en Bizagi presenta su funcionalidad de workflow y consultas, ya publicadas como mtodos web SOA disponibles. Esto hace ms fcil ejecutar un evento de negocio en Bizagi que es controlado en otro sistema, especficamente para integraciones que requieren Dichos mtodos disponibles en Procesos Bizagi incluyen la funcionalidad de : Iniciar Procesos, realizar

1456

Copyright 2013 - Bizagi

una actividad o disparar un evento, actualizar u obtener informacin actualizada de Procesos y abortar instancias de Proceso, entre otras. Vea ms informacin acerca de la Capa SOA y los servicios Web funcionalidad de los Procesos de Bizagi. publicados que exponen la

Opciones adicionales de integracin

Bizagi ofrece otras funcionalidades de integracin para la solucin BPM corportativa. Estas funcionalidades involucran opciones tales como la posibilidad de conectar a fuentes de datos externas, almacenar documentos en un repositorio ECM e integracin LDAP, entre otros.

Conectar a fuentes de datos externos

Bizagi presenta dos poderosas funcionalidades para integracin a nivel de datos, en las cuales la estructura de datos (tablas) desde una fuente de datos externa, se puede sincronizar con el modelo de datos en Bizagi. En este enfoque, es posible configurar la replicacin de Bizagi para importar automticamente listas de informacin desde cualquier fuente de datos (como una tarea programada). Tambin es posible utilizar el mecanismo de virtualizacin de Bizagi para tablas de tipo transaccional, de manera que estos valores son buscados y actualizados en tiempo real. Para mayor informacin acerca de integracin con fuentes de datos externos a travs de replicacin y virtualizacin consulte el artculo de Integracin de datos.

Usar un ECM como repositorio de documentos

Bizagi soporta integracin con sistemas ECM (Enterprise Content Management) que cumplan con el estndar CMIS, tales como Sharepoint, Alfresco y Documentum, entre otros. Los documentos cargados en Procesos Bizagi se pueden configurar para ser almacenados en un repositorio central. Para mayor informacin acerca de integracin ECM, consulte el artculo ECM.

Enviar notificaciones a travs de un servidor de correo electrnico

Los Procesos de Bizagi pueden enviar notificaciones de correo electrnico automticamente, utilizando un servidor de correo electrnico que sea compatible con SMTP, tales como Lotus Notes y Exchange, entre otros. Para mayor informacin acerca de configuracin de servidores de correo electrnico, consulte Definir Notificaciones.

Usar opciones de seguridad avanzadas

Para la autenticacin en el Portal de Trabajo de Bizagi, un proyecto puede usar cualquiera de las opciones avanzadas: Windows, Personalizado, LDAP o autenticaciones mixtas. Cuando se utiliza una autenticacin de Windows, es posible esconder la pgina de autenticacin de

Copyright 2013 - Bizagi

1457

Bizagi y en vez de esto, utilizar un mecansmo de autenticacin integrado, permitiendo a Bizagi validar automticamente las credenciales de sesin de Windows. La autenticacin personalizada permite autenticar contra cualquier otra fuente de datos no cubierta por los mtodos comunes (un archivo, una base de datos especfica o cualquier otro desarrollo). Para la integracin LDAP, los usuarios finales se autentican frente a un servidor LDAP. Tambin se soporta la importacin de usuarios (sincronizando peridicamente) desde un servidor LDAP. Para mayor informacin acerca de las funcionalidades y opciones, consulte Inicio de sesin en el Portal de Trabajo.

Disparar Eventos de Negocio en Bizagi

Bizagi soporta las diferentes posibilidades de Colaboracin en BPMN (coreografa) en sus Procesos. Esto se refiere a la posibilidad de reaccionar a eventos de negocio que son disparados desde otro Proceso en Bizagi, o reaccionar a eventos de tipo asncrono tales como Eventos temporizadores. Esta poderosa funcionalidad permite el modelado de Procesos que son iniciados o disparados por mensajes, seales, temporizadores u otros disparadores asncronos. Aunque este es un concepto que involucre colaboracin entre Procesos, los eventos de negocio tambin soportan Trabajos Personalizados. Para los Trabajos Personalizados se puede utilizar programacin, en reglas avanzadas de negocio, para especificar procesamiento por lotes u otras tareas especficas. Estas implementaciones personalizadas son tiles para propsitos de integracin; por ejemplo, buscar en una ruta fsica nuevos archivos y crear casos en Bizagi con estos como adjuntos.

3.8.1

Invocar servicios externos desde Bizagi

Informacin General
Bizagi presenta una capa de integracin que permite una fcil configuracin para la integracin con aplicaciones externas. A travs de esta capa de integracin, los Procesos en Bizagi pueden establecer una comunicacin con sistemas externos para obtener informacin de ellos o actualizar su informacin. Por ejemplo, un Proceso de Solicitud de crdito tendr dentro de sus requerimientos poder consultar en un bur de crdito (o cualquier otro sistema) si el solicitante se encuentra en la Lista Negra, o la capacidad de endeudamiento. Como se ensea en la imgen siguiente, los Procesos pueden tener varios puntos de integracin donde deben invocar servicios externos:

1458

Copyright 2013 - Bizagi

En Bizagi, la configuracin de este tipo de integracin se realiza por medio de un conector genrico llamado W eb serv ice co n n ecto r, el cual soporta la integracin con Servicios Web SOAP o con servicios de tipo REST (en aplicaciones en la intranet o en internet).

La siguiente imagen ilustra este concepto:

Cmo se hace?
La invocacin de servicios externos desde Bizagi permite el envo de informacin de negocio desde las instancias de los Procesos como datos de entrada para el servicio. De vuelta, la respuesta del servicio externo se almacenar automticamente en Bizagi (en el Modelo de datos del Proceso).

Copyright 2013 - Bizagi

1459

El intercambio de informacin entre Bizagi y el sistema externo se realiza por medio de XMLs. De esta manera, la integracin es independiente de las plataformas o tecnologas involucradas, y del lenguaje de programacin de la implementacin del servicio. Para configurar la invocacin a un servicio Web (sea SOAP o de tipo REST), el conector de servicios Web ( W eb serv ice co n n ecto r) presenta una serie de pasos grficos en los cuales no se requiere de programacin.

Acerca del Asistente de Interfaces

Los puntos donde hay integracin en un Proceso, se definen en el paso #6 del Asistente ed Procesos en Bizagi Studio ( Defin ir in terfaces d e in teg raci n ). En este paso, se configuran las invocacioones de servicios externos a travs del conector de servicios Web:

Una vez que se seleccione la tarea de servicio que representa el punto de integracin, Bizagi presentar el conector de servicios Web para una configuracin guiada en 4 pasos. Tenga en cuenta que las opciones presentadas podrn diferir ligeramente de acuerdo a las opciones seleccionadas (por ejemplo, el tipo de servicio: SOAP o REST).

Estndares soportados por el conector de servicios Web

En servicios Web de tipo SOAP, se soporta lo siguiente: Servicios Web construdos en SOAP 1.1 Servicios Web construdos en SOAP 1.2

1460

Copyright 2013 - Bizagi

El mtodo Web para invocar servicios Web de tipo SOAP debe ser POST. Adicionalmente, las siguientes extensiones a los servicios Web (WS-*) tambin se soportan:

WS-Addressing WS-Policy WS-Trust WS-SecureConversation WS-Security: Autenticacin por tokens de usuario (Username tokens), y por tokens de seguridad binaria (Binary security token, por ejemplo el uso de certificados X.509). En la autenticacin por authentication por tokens de seguridad binaria, la proteccin del mensaje (encripcin) requiere que el servicio exponga la llave pblica en el WSDL. Si desea invocar un servicio Web SOAP con algn estndar que no se encuentre en la lista anterior (p.e WS-Discovery), deber hacerlo mediante la funcionalidad de Librera de componente. Lo mismo aplica para invocacin a servicios REST que utilicen OAuth dentro de su autenticacin. Para ms informacin, consulte Integrar APIs o cdigo personalizado.

Ejemplos
Consulte el artculo correspondiente presentado para cada uno de los escenarios de integracin: Invocar un servicio Web desde Bizagi. Invocar un servicio REST desde Bizagi. 3.8.1.1 Invocar servicios Web (SOAP)

Informacin general
Bizagi ofrece un conector de servicios Web (el cual hace parte de su capa de integracin) que promueve una configuracin sencilla para la invocacin de servicios Web externos. Este conector soporta tanto la invocacin de servicios Web SOAP estndar, como la de servicios REST. En este artculo describiremos la integracin con servicios Web SOAP. Para la integracin con servicios REST externos, consulte Invocacin de servicios REST. La siguiente imagen ilustra este concepto:

Copyright 2013 - Bizagi

1461

El intercambio de informacin entre Bizagi y el sistema externo se realiza por medio de XMLs. De esta manera, la integracin es independiente de las plataformas o tecnologas involucradas, y del lenguaje de programacin de la implementacin del servicio.

Qu se necesita hacer en Bizagi

Para establecer la configuracin de un servicio web SOAP, se deben seguir los pasos a continuacin: 1. Resolver la URL del servicio Web. 2. Definir los parmetros de entrada. 3. Definir los parmetros de salida. 4. Configurar manejo de errores. En el primer paso, Resolver URL del servicio Web, usted puede escoger: Si el servicio a invocar es un servicio Web SOAP o un servicio REST. Si usted utilizar el asistente grfico o las opciones avanzadas.

1462

Copyright 2013 - Bizagi

En este artculo ilustraremos como utilizar el asistente de interfaces de Bizagi con sus opciones de mapeo grfico, para invocar un servicio Web SOAP.

Ejemplo
En el siguiente ejemplo referenciaremos el Proceso de Soicitud de Licencia de Vacacioes en el cual un empleado ingresa una solicitud de vacaciones y consulta el nmero de dias disponibles para sus vacaciones. Este Proceso puede puede ser descargado desde las Plantillas gratuitas de Proceso en la Central de Procesos.

Para esta configuracin, vaya al sexto paso del Asistente de Procesos y d clic en la opcin Defin ir In terfaces.

Copyright 2013 - Bizagi

1463

En la vista del Proceso para definicin de interfaces, d clic en la tarea automtica donde se invocar el servicio web externo. Observe que cuando un Proceso se abre en esta vista (a travs del paso de Integracin), solo las tareas automticas se resaltarn (y estarn disponibles). En la siguiente imagen, la tarea automtica escogida para nuestro ejemplo es Verificar d as d isp o n ib les d e v acacio n es en la cual Bizagi obtendr, desde otro sistema, el nmero de das de vacaciones disponibles para ese empleado.

1464

Copyright 2013 - Bizagi

Cuando se da clic en la tarea automtica, el asistente de interfaces se lanzar y presentar los pasos para configurar la invocacin (como se describe a continuacin.

Resolver la URL del Servicio Web

En este primer paso, seleccione SO A P como el Tip o d e serv icio para esta invocacin. Luego ingrese la URL del servicio Web, y d clic en el botn Go . En este ejemplo utilizamos la URL: h ttp ://w w w .b izag i.co m /ESB /ESB Serv ices.asm x ?w sd l El sistema buscar y refrescar una lista de mtodos Web disponibles para ese servicio Web (desde el archivo descriptor de lectura WSDL). Nota Para mejores prcticas orientadas a interoperabilidad, la URL de los servicios Web tipo SOAP debe ser definida explcitamente con la terminacin ?wsdl (p.e h ttp ://w w w .b izag i.co m /ESB / ESB Serv ices.asm x ?w sd l). De esta manera se asegura una correcta referencia al descriptor, cuando se tengan servicios no contruidos bajo la tecnologa de .NET. Seleccione el mtodo Web a ser usado y asigne un N o m b re d e In terfaz para esta configuracin.

Copyright 2013 - Bizagi

1465

Observe que no seleccionamos las opciones avanzadas (no esta activada la opcin Use mapeo complejo). D clic en Sig u ien te.

Defina los Parmetros de Entrada

En el paso Dato s a En v iar, el asistente de interfaces presentar el modelo de datos perteneciente al Proceso actual ( como una tabla de Datos de Bizagi en la izquierda), y la informacin estructurada esperada por ese mtodo de servicio Web (como otra tabla a la derecha). Para cada uno de los parmetros de entrada necesarios para establecer la comunicacin con los sistemas externos, el asistente mostrar las opciones para mapear el atributo del modelo de datos utilizando XPath. De esta manera, la informacin requerida desde el modelo de datos se configurar en los parmetros del mtodo web. Para este ejemplo, mapearemos el n o m b red eu su ario del Solicitante al parmetro esperado de n o m b red eu su ario del servicio Web.

1466

Copyright 2013 - Bizagi

D clic en Sig u ien te. Note Puede en cualquier momento utilizar las caractersticas y funciones especiales para mapear fcilmente los parmetros de entrada, a partir de una vista grfica, al maximizar esta ventana.

Para mayor informacin consulte Caractersticas y funciones de mapeo.

Definir Parmetros de Salida

En el paso de Dato s d e Resp u esta, el mapeo del resultado que retorna el servicio web, se configura de forma similar al mapeo de las entradas.

Copyright 2013 - Bizagi

1467

Con esta configuracin, Bizagi actualizar automticamente la respuesta recibida, en el modelo de datos del Proceso. En este ejemplo, mapeamos el resultado n m ero d e d as d e v acacio n es d isp o n ib les al atributo N u m b erO fDay sA v ailab le.

D clci en Sig u ien te.

Note Puede en cualquier momento utilizar las caractersticas y funciones especiales para mapear fcilmente los parmetros de salida, a partir de una vista grfica, al maximizar esta ventana.

1468

Copyright 2013 - Bizagi

Para mayor informacin consulte Caractersticas y funciones de mapeo.

Configure el manejo de Errores

Bizagi presenta una opcin para configurar manejo de errores de negocio. Esto es especiamente til en los siguientes escenarios: Cuando el XML de la respuesta contiene un error de negocio de servicio Web (por ejemplo, mensajes como "El ID del Cliente no existe"). Cuando el Proceso modelado considera una transicin diferente del flujo de trabajo si ocurre un error. Para utilizar el manejo de errores, se debe especificar el mensaje de error que se lanza basado en los posibles escenarios de la invocacin. Para el segundo escenario, se requiere que la Tarea de Servicio utilizada posea un Evento de Error adjunto a sus lmites.

En este ejemplo no se especifica manejo de errores personalizado. Para ver ms informacin acerca de las opciones de manejo de errores, consulte Manejo de Errores en Interfaces.

D clic en F in alizar.

Copyright 2013 - Bizagi

1469

En este punto, la Tarea de Servicio Verificar Das Disp o n ib les d e Vacacio n es en el Proceso de So licitu d d e Vacacio n es, ha sido configurado para invocar un servicio Web externo SOAP. Observe que cuando usted da clic en el botn F in alizar, la interfaz se crear (o actualizar) automticamente en el mdulo de Sistem as (vista de Mdulos) de su proyecto Bizagi. Esto quiere decir que la configuracin de los parmetros y opciones de autenticacin de la interfaz, pueden ser revisados o editados desde el mdulo de Sistem as (vea la siguiente seccin Consideraciones Adicionales).

Consideraciones Adicionales
1. Bizagi guardar de manera precisa la configuracin para su invocacin y mapeo, incluso si despus se cambia el mtodo de servicio Web. Esto significa que si su servicio Web externo cambia (por ejemplo, su definicin tiene parmetros nuevos o diferentes), usted necesitar considerar si es necesario reconfigurar la invocacin en Bizagi Studio. Sera recomendable examinar la invocacin de sus servicios Web y navegar por su configuracin para revisar el mapeo de parmetros nuevos o alterados. Observe que usted tambin puede administrar sus interfaces en ambientes de pruebas o produccin (si hay cambios futuros a los sistemas externos tales como una migracin eventual del alojador de servicios web externos). Para mayor informacin, consulte Administracin de Interfaces. 2. En caso de que la configuracin a un servicio Web no se pueda realizar mediante el Conector de servicios Web de Bizagi y el mapeo grfico, entonces podr optar por estas opciones: Realizar la invocacin al servicio Web mediante una regla de negocio donde se utilicen los mtodos del objeto ayudante CEntityXmlHelper. Desarrollar un componente para la invocacin al servicio Web. Este componente debe crearlo como una librera de clase que se registra en Bizagi a travs de la funcionalidad de la Librera de componentes (aplica para las ediciones Enterprise). Para mayor informacin, consulte Librera de componentes.

3.8.1.2

Invocar servicios REST

Informacin General
Bizagi ofrece un conector de servicios Web (el cual hace parte de su capa de integracin) que promueve una configuracin sencilla para la invocacin de servicios Web externos. Este conector soporta tanto la invocacin de servicios Web SOAP estndar, como la de servicios REST. En este artculo describiremos la integracin con servicios REST basados en protocolos Web.

1470

Copyright 2013 - Bizagi

Para la integracin con servicios Web de tipo SOAP, consulte Invocacin de servicios SOAP. La siguiente imagen ilustra este concepto:

El intercambio de informacin entre Bizagi y el sistema externo se realiza por medio de XMLs. De esta manera, la integracin es independiente de las plataformas o tecnologas involucradas, y del lenguaje de programacin de la implementacin del servicio. Antes de continuar revisando este artculo, listaremos brevemente algunos servicios REST, sus caractersticas, y mencionaremos algunas diferencias entre servicios REST y servicios Web tradicionales (SOAP); principalmente porque ambos son importantes y utilizados frecuentemente en aplicaciones (el empleo de uno no pretende reemplazar el otro).

Servicios REST comparados con servicios web SOAP

Primero que todo, es importante entender los servicios REST como un concepto, fueron reforzados como la mejor alternativa para consultar informacin desde dispositivos mviles.

Copyright 2013 - Bizagi

1471

De acuerdo a esta idea, a travs de los dispositivos mviles es frecuente querer consultar informacin en lnea contenida en sitios Web de una manera gil (como mapas geogrficos, informacin general de la Web, actualizaciones de redes sociales, tasas de cambio actuales, reporte del clima, precio de productos comerciales, etc.). Esto es porque los servicios REST exponen informacin como "recursos" a ser consumidos via HTTP (o HTTPS) Dicho esto, los servicios REST disean y utilizan diferentes mtodos a los presentados por los servicios web SOAP. Los servicios web SOAP estn destinados para un diseo SOA en sistemas corporativos internos, con la posibilidad de medidas adicionales y ms fuertes de seguridad para su acceso. Cuando se consumen SOAP o REST, la configuracin de la invocacin difiere en lo siguiente: Cuando se invoca un servicio web SOAP, el sistema puede interpretar y utilizar definiciones previas del sistema Web (su estructura esperada de entrada y salida). Esto se describe a travs de W SDL publicados en el diseo y construccin de los servicios SOAP. Cuando se invoca un servicio REST, por defecto, no hay definicin disponible para los parmetros de entrada y estructura de salida de este servicio, que un sistema pueda interpretar. Esta tarea se delega al usuario que hace la invocacin.

Acerca de servicios REST

Los servicios REST presentan cuatro mtodos posibles (los cuales son los cuatro mtodos HTTP) para consumir sus recursos expuestos: Get, Post, Put y Delete. Cada mtodo para servir cada posible accin para la materia del recurso (leer, crear actualizar o eliminar). La tabla a continuacin clarifica el mtodo para estas posibilidades: Accin Crear Leer Actualizar Eliminar Mtodo HTTP PUT GET POST DELETE

Tenga en cuenta que los pasos varian ligeramente de acuerdo al mtodo de interfaz escogida en el asistente de interfaces de Bizagi (de acuerdo al mtodo HTTP escogido para el servicio REST). Mientras se utilicen los mtodos POST o PUT (esos mtodos en los cuales la informacin persiste hasta el recurso), esa informacin extra involucrada (para crear o actualizar), se enva estableciendo una configuracin en un paso adicional.

Prerequisitos
Tenga en cuenta que debido a su naturaleza, se espera que los servicios REST sean provedos sobre Internet, y por sitios Web que publiquen informacin en todo el mundo.

1472

Copyright 2013 - Bizagi

Por lo tanto se requiere consultar primero la documentacin del servicio REST publicado que se invocar, con el fin de comprobar los parmetros esperados por el servicio (entrada), y cmo se estructura la respuesta retornada por el servicio (salida). Los APIs de los servicios REST presentan la estructura de informacin (Entrada y Salida) y sus correspondientes ejemplos para consumir los recursos de acuerdo a los cuatro mtodos HTTP: Get, P o st, P u t and Delete. D clic para ver ms informacin acerca de las consideraciones de invocacin de servicios REST.

Qu necesita en Bizagi
Usted puede invocar un servicio REST de sistema externo desde cualquier Actividad en su Proceso Bizagi. Para configurar este tipo de invocacin, se utiliza el asistente de interfaces Bizagi: se define que informacin se enva desde Bizagi y cmo se actualiza la informacin recibida en el Proceso. En resumen, la configuracin de la invocacin de un servicio REST en Bizagi se hace: 1. Creando una invocacin de interfaz. 2. Especificando el tipo de servicio, URL y mtodo. 3. Mapeando todos los parmetros del entrada del servicio. 4. Mapeando la respuesta del servicio externo. 5. Configurando el manejo de errores (opcional).

Ejemplo
En el siguiente ejemplo, ilustraremos como invocar un servicio REST desde el API de Google Maps directamente en nuestro Proceso Bizagi Como se describi previamente en este artculo, como un prerequisito necesitamos entender primero la estructura de la invocacin del servicio REST de Google Maps. Esta informacin se puede consultar en el sitio web: developers.google.com/maps/documentation/ geocoding/.

Copyright 2013 - Bizagi

1473

En este ejemplo especfico, usaremos la Geo co d ificaci n A P I expuesta por un servicio Web para enviar una direccin, y obtener las coordenadas correspondientes de latitud y longitud. Tambin usaremos un servicio REST disponible que devuelva la informacin de respuesta en una estructura de XML (note que a menudo estos servicios se proveen tanto en XML como en formatos de JSON). La versin 9.1.9 del asistente de interfaces de Bizagi soporta respuestas en formato XML, pero no respuestas en formato JSON. Ilustraremos como invocar un servicio de REST, usando el Proceso de Crear Ven d ed o r en Bizagi:

1474

Copyright 2013 - Bizagi

En este ejemplo, nuestro modelo de datos es:

Note que este ejemplo usa la invocacin de servicio de REST de Google (un servicio externo de Web). Por esta razn el Servidor BPM debe tener acceso a Internet. Se pueden requerir configuraciones adicionales para permitir que el navegador muestre el mapa (incluir a Google maps como un sitio seguro).

Creando una invocacin de interfaz

Nuestro primer paso es crear una invocacin de interfaz en nuestra Tarea de Servicio Co n su ltar p o sici n d e g eo c d ig o . Esto se hace desde el paso 6 del asistente de Proceso (Integracin) en la opcin Defin ir in terfaces d e in teg raci n :

Copyright 2013 - Bizagi

1475

En esta vista, demos clic en la Tarea de Servicio Co n su ltar p o sici n d e g eo c d ig o para crear la invocacin de la interfaz.

Especificar el tipo de servicio, URL y mtodo

Ahora debemos especificar que esta configuracin invoca un tipo de servicio REST, as como su URL, mtodo y parmetros. En la ventana de interfaz que aparece, seleccionamos REST como el tipo de servicio:

1476

Copyright 2013 - Bizagi

Desde la informacin presentada en la pgina de API de Google Maps, especificamos su ubicacin URL separada en: la URL Base y la URL de Servicio. Nota: La URL Base y la URL de servicio tambin se especifican en la documentacin del servicio REST. Note que la URL Base es el prefijo en el cual no se especifica invocacin de parmetros aun. La URL de servicio usualmente contiene parmetros de consulta, cuyos valores varan por invocacin. La URL Base de este ejemplo es: http://maps.googleapis.com/maps/api/geocode/xml? La URL de sevicio de este ejemplo es : address=1600+Amphitheatre+Parkway,+Mountain+View, +CA&sensor=true Note que la URL de servicio anterior ya incluye una direccin esttica de muestra ("1600 +Amphitheatre+Parkway,+Mountain+View,+CA"). En nuestro procceso enviaremos dinmicamente esta informacin desde el atributo "Street Address" en el modelo de datos. Por lo tanto y con el fin de definir que el parmetro de direccin ser mapeado automticamente, definimos tantas variables como sean necesarias, dentro de la URL de servicio, "{", "}". Nuestra URL de Servicio final es: address={Value1}&sensor=true

Copyright 2013 - Bizagi

1477

Observe que el mtodo que estamos invocando es un mtodo GET (solo para consultar informacin), y que tambin devuelve la informacin en una estructura XML. Damos un nombre a nuestra interfaz y damos clic en Sig u ien te.

Mapear toda la informacin de entrada para el servicio.

A continuacin mapearemos la informacin a ser enviada a travs de las variables definidas previamente. Para hacerlo, localizamos nuestro atributo en el modelo de datos de Bizagi (la tabla a la izquierda) y damos clic sobre l. Una vez seleccionada, demos clic en la variable Value1 en la tabla Query_Params a la derecha. De esta manera, mapeamos y especificamos la informacin que va a ser enviada a esta invocacin:

1478

Copyright 2013 - Bizagi

Damos clic en Sig u ien te.

Utilizando la consideracin POST o PUT Observe que hemos finalizado la configuracin de la informacin de entrada para la invocacin REST en este ejemplo, debido a que estamos utilizando un mtodo GET HTTP. Cuando se utiliza un mtodo P O ST o P UT, se muestra una ventana de configuracin adicional ( Dato s a En v iar), para crear o actualizar un recurso. La configuracin para este paso se hace de manera similar a lo descrito en la siguiente seccin (Mapear la informacin de respuesta retornada por el servicio).

Copyright 2013 - Bizagi

1479

Si usted requiere enviar esta informacin con un tipo de contenido diferente al "texto/xml" por defecto, usted puede especificar esta configuracin editando las propiedades de interfaz desde la vista de Mdulos. Para ver ms informacin acerca de esta opcin, consulte Consideraciones sobre servicios REST. En este ejemplo no configuraremos nada adicional.

Mapear la informacin de respuesta retornada por el servicio

Ahora especificaremos cmo almacenar la informacin de respuesta en los atributos de nuestro modelo de datos de Proceso en Bizagi. Para esto necesitaremos incluir la estructura de la respuesta del servicio REST en los Datos de Respuesta. Recuerde que esta invocacin espera un respuesta en formato XML, y que esta estructura de respuesta se consulta en los APIs de la pgina web del servicio REST. Basado en esto, vamos a developers.google.com/maps/documentation/geocoding/?hl=en#XML, y copiamos el texto de muestra XML presentado en un archivo .XML.

1480

Copyright 2013 - Bizagi

Damos clic derecho en la tabla de la izquierda e ingresamos la estructura de la respuesta. Esto debe hacerse manualmente (agregando nodos) o de manera automtica cargando la estructura desde un archivo fsico XSD o XML. D clic aca para ms informacin acerca de opciones de configuracin de servicios REST. En este ejemplo seleccionamos Carg ar XM L d e m u estra en las opciones de importacin, para cargar la estructura XML del archivo .XML (localizando la estructura XML que guardamos previamente):

Copyright 2013 - Bizagi

1481

Una vez que tenemos la estructura XML en nuestra Tabla de Respuestas de Google Maps, procedemos a mapear los valores entrantes de latitud ("lat") y longitud ("lng") a nuestros atributos en Bizagi. Para mapear estos valores, recuerde que usted puede dar clic primero sobre el atributo fuente (Datos de Respuesta) y luego en el atributo destino (Datos de Bizagi) o tambin arrastrar una conexin desde la fuente y soltarla en el destino. Al final, la informacin mapeada de respuesta para nuestro ejemplo se mostrar de la siguiente manera:

1482

Copyright 2013 - Bizagi

D clic en Sig u ien te.

Configurar manejo de errores (opcional)

Finalmente, no necesitamos validacin de manejo de errores para este ejemplo. Para ver ms informacin acerca de las opciones de manejo de errores, consulte Manejo de Errores de Interfaz.

Copyright 2013 - Bizagi

1483

D clic en Sig u ien te.

Resultado
Ahora podemos ejecutar nuestro Proceso de Creacin de Vendedor y probar el resultado de la invocacin en el Portal de Trabajo. Para hacerlo, ejecute el Proceso desde el botn ejecutar en las opciones de acceso rpido del Asistente de Proceso:

1484

Copyright 2013 - Bizagi

En el Portal de Trabajo, creamos un nuevo caso del Proceso de Crear Ven d ed o r e ingresamos la direccin del vendedor en el campo de la tarea Reg istrar In fo rm aci n d el Ven d ed o r. Para este ejemplo de servicio REST, todo el texto que compone la direccin esta separado por el caracter "+".

Despus de la invocacin del servicio REST de Google Maps, obtendremos las coordenadas de latitud

Copyright 2013 - Bizagi

1485

y longitud para la direccin del Vendedor:

En este punto hemos invocado un servicio REST desde Bizagi.

Consideraciones Adicionales
Bizagi guardar de manera precisa la informacin para su invocacin y mapeo, incluso si hay un cambio posterior en el mtodo de servicio Web externo. Esto significa que si su servicio Web externo cambia (por ejemplo, su definicin posee parmetros nuevos o diferentes), usted necesitar considerar si es necesario reconfigurar la invocacin en Bizagi Studio. Sera recomendable examinar la invocacin de sus servicios Web y navegar por su configuracin para revisar el mapeo de parmetros nuevos o alterados. Observe que usted tambin puede administrar sus interfaces en ambientes de pruebas o produccin (si hay cambios futuros a los sistemas externos tales como una migracin eventual del alojador de servicios web externos). Para mayor informacin, consulte Administracin de Interfaces.
3.8.1.2.1 Consideraciones sobre servicios REST

Las siguientes son las caractersticas soportadas al momento de configurar invocaciones de servicios REST en sus Procesos Bizagi.

1. Utilizar autenticacin bsica HTTP

Usted puede incluir credenciales de usuario si el servicio REST requiere autenticacin. Estas credenciales involucran: Nombre de Usuario, contrasea y dominio (opcional) para autenticacin bsica HTTP. Esta informacin se ingresa para la configuracin de interfaz presentada en el Mdulo de Sistemas.

1486

Copyright 2013 - Bizagi

2. Valores de Interfaz por ambiente

Usted puede actualizar su configuracin de interfaz de servicio REST en cualquier momento. La administracin de interfaz le permite editar las credenciales de dominio de URL Base o las credenciales utilizadas para autenticacin (dominio, nombre de usuario y contrasea). Esto se puede hacer desde la Consola de Administracin (Bizagi Management Console) directamente para cada uno de los ambientes de sus proyectos (pruebas o produccin).

3. Administracin de Interfaces
Cuando se edite la URL Base de una invocacin de servicio REST desde el Asistente de Interfaces (ambiente de desarrollo), Bizagi tratar esta alteracin de la siguiente manera: Si la parte de dominio de la URL Base se edita, esto se manejar como un cambio menor que involucra el servidor que provee este servicio y no como una nueva interfaz (eso significa que no se requiere una configuracin diferente de mapeo). Si la parte que sigue el dominio de la URL Base se edita, esto se manejar como una nueva configuracin de interfaz (a diferencia de la anterior). Esto requiere ir al mapeo y revisar que los parmetros correspondientes estn configurados. Cualquier edicin en el servicio URL, se manejar como una nueva configuracin de interfaz. Esto sigue la regla de validacin en el mdulo de Sistemas en la cual usted no puede editar la URL de servicio para una interfaz de servicio REST, y similar a lo anteriormente mencionado, requiere ir a la configuracin de mapeo.

4. Enviar informacin (tipo de contenido)

Cuando el servidor de Bizagi enva informacin al Servicio Web, tambin enva informacin en el campo de tipo de contenido del encabezado HTTP que lo acompaa, acerca del tipo de formato en el que estn los datos. Bizagi enva el tipo de contenido por defecto como "texto/xml" (aplica para mtodos HTTP POST y PUT). Usted puede editar esta configuracin desde las propiedades de interfaz, especificando un tipo diferente de contenido:

Copyright 2013 - Bizagi

1487

5. Mxima longitud de URL

Las solicitudes de servicios REST estn frecuentemente restringidas por lmite de caracteres de URL soportados por los navegadores (http://www.boutell.com/newfaq/misc/urllength.html). El lmite mas bajo de caracteres en los navegadores es definido por Internet Explorer con una longitud aproximada de 2000 caracteres, a lo cual Bizagi se adhiere. Esto significa que la longitud combinada de URL Base y URL de servicio no puede exceder los 2000 caracteres.

6. Formato de Respuesta (XML)

La mayora de los sitios publican recursos como servicios REST y ofrecen las respuestas de servicios Web tanto en formatos XML como JSON. Como Bizagi solo soporta XML, asegrese de que usted

1488

Copyright 2013 - Bizagi

selecciona y consume la respuestas en formato XML. 3.8.1.3 Invocar desde actividades asncronas

Informacin General
Dentro de un flujo de Proceso, Bizagi permite ejecutar Tareas de Servicio de manera asncrona. Las Tareas de este tipo se conocen como Actividades Asncronas. Estas Actividades Asncronas han sido diseadas especialmente para llamar interfaces externas, las cuales se utilizan principalmente para integracin con servicios existentes en otros sistemas.

Por qu usar Actividades Asncronas?

Bizagi administra el acceso de datos al repositorio de Procesos a travs de us componente de Administrador de Entidades. El Administrador de Entidades permite a Bizagi realizar transacciones en la base de datos directamente para persistir informacin cuando se avancen actividades dentro del flujo de Proceso. Se espera que estas transacciones se completen de una manera rpida, y usualmente cuando se invocan servicios en aplicaciones o sistemas externos, el tiempo empleado para estos puntos de integracin puede variar (incrementarse) debido a variables externas (conexin, la respuesta de otras aplicaciones, etc). Por lo tanto, si el tiempo involucrado en la transaccin de un punto de integracin es extendido de manera significativa, podra haber algunas entidades y registros bloqueados temporalmente (a nivel de base de datos), los cuales podran causar trabas o demoras en otras actividades, realizadas simultneamente, por otros usuarios finales en el Portal de Trabajo (el desempeo puede ser afectado).

Cmo funcionan las Actividades Asncronas?

Las Actividades Asncronas son una variante a las Tareas de Servicio, en las cuales Bizagi realizar la ejecucin de una manera distinta. Esta funcionalidad funciona de la siguiente manera: Cuando una Actividad Asncrona se ejecuta, las acciones (reglas de negocio e invocaciones de servicio) localizadas a la entrada, se procesan inmediatamente y la actividad se muestra como Pendiente. Cuando la transaccin asociada con las acciones a la entrada finaliza, las actividades asncronas pendientes se ejecutan una a una en una nueva transaccin donde no se generan bloqueos y el Proceso puede avanzar. En caso de que la actividad asncrona falle, se marcar para un reintento. Ms tarde, la transaccin se reintentar por el Scheduler hasta que se complete de manera exitosa o el nmero mximo de intentos se haya alcanzado. Si el reintento fue exitoso, el Schedule notificar al Portal de Trabajo para que se muestre y habilite la siguiente actividad. Por otro lado, si falla continuamente y se alcanza el nmero mximo de reintentos, se mostrar en las

Copyright 2013 - Bizagi

1489

administracin de Actividades Asncronas con un log correspondiente (para diagnosticar y revisar los mensajes de error).

Cmo crear una Actividad Asncrona?

Las Actividades Asncronas se definen al momento de crear un modelo de Proceso (en el primer paso del Asistente de Proceso). Despus de que el flujo de proceso se crea con la notacin BPMN, solo las Tareas de Servicio (siendo automatizadas) pueden ser transformadas a una Actividad Asncrona. Los siguientes pasos muestran cmo crear y definir Actividades Asncronas: 1. En el flujo de Proceso modelado en el Modelador de Procesos de Bizagi, seleccione una Tarea de Servicio y d clic derecho sobre ella. Seleccione la opcin P ro p ied ad es.

1490

Copyright 2013 - Bizagi

2. En las propiedades de la Actividad, identifique las propiedades asncronas en la pestaa Bsicas de la pantalla de propiedades de Elemento (parte inferior de la ventana).

Copyright 2013 - Bizagi

1491

3. Habilite la propiedad Es A sn cro n a e ingrese los detalles para los parmetros de la ejecucin asncrona. Tales parmetros consideran principalmente cmo manejar errores que pueden ocurrir durante su ejecucin. Reintentos: Determina el nmero de veces que la ejecucin asncrona intentar sus acciones automticamente, en caso de falla. Intervalo de Reintento: Un intervalo de tiempo en minutos que la Actividad espera antes de reintentar su ejecucin (en caso de falla). Mostrar Retroalimentacin: Cuando esta propiedad esta activa, Bizagi ejecutar inmediatemente la Actividad a travs de su Portal de Trabajo; una pgina de espera se mostrar mientras la solicitud

1492

Copyright 2013 - Bizagi

se procesa, notificando la realizacin o falla de su ejecucin. Cuando esta propiedad se deshabilita, la Actividad Asncrona es ejecutada por el servicio de Scheduler posteriormente. El Portal de Trabajo notificar al usuario final que esta ejecucin est programada. Tiempo de Espera: Permite definir un intervalo mximo de tiempo en segundos como umbral, en el cual debe responder la ejecucin de la Actividad Asncrona. Si las acciones de la Actividad Asncrona no se completan durante ese intervalo, Bizagi cancelar la operacin pendiente.

Administracin de Actividades Asnconas y reintentos

Observe que se puede configurar un nmero de reintentos de manera que, en caso de que una Actividad Asncrona falle, Bizagi pueda reintentarla automticamente sin intervencin del usuario. La actividad dejar de ser reintentada automticamente cuando el nmero mximo de ejecuciones se alcance. En estos casos, se requerir de la intervencin de un administrador, quien podr utilizar las opciones de la Consola de Actividades Asncronas en el Portal de Trabajo )para revisar y reintentar estos casos excepcionales). Para ver ms informacin acerca de estas opciones de Administracin, consulte la Administracin de Actividades Asncronas. 3.8.1.4 Caractersticas y funciones de mapeo

Informacin General
Para la integracin a nivel de Proceso en la cual los Procesos de Bizagi invocan servicios externos Web (o servicios REST), Bizagi ofrece la posibilidad de utilizar funciones comunes de mapeo y caractersticas en su Asistente de configuracin de interfaces. Tales funciones incluyen: concatenacin de campos o asignacin de valores constantes (defecto). Las caractersticas de Mapeo involucran comandos de acceso rpido para una configuracin amigable y guiada. Estas funciones permiten y facilitan la comparacin de datos en la integracin, haciedo que Bizagi aplique una transformacin para garantizar que ambos sistemas (Bizagi y sistemas externos), tengan un "entendimiento" de los datos intercambiados. Adicional a esto, Bizagi soporta integracin con servicios Web utilizando encabezados SOAP en sus ediciones Xpress y Entreprise .NET.

Funciones y caractersticas de Mapeo

Mientras la ventana de mapeo esta maximizada, es posible utilizar nuevos botones y funciones desde la pestaa de Inicio tal como se muestra a continuacin:

Copyright 2013 - Bizagi

1493

Opciones de Mapeo Rpido

Usar el botn "Mapear todo" Esta caracterstica configurar un mapeo automtico de manera que los campos de la tabla de la izquierda son conectados con sus campos de la tabla de la derecha. Este mapeo se hace de acuerdo a los nombres de los campos (se relacionan aquellos que tengan igual nombre). Usar el botn "Desmapear todo" Al presionar este botn se remover el mapeo configurado en todos los campos. Usar el botn "Deshacer" Al presionar este botn se deshar la ltima accin realizada. Usar el botn "Rehacer" Al presionar este botn se restablecer la ltima accin anulada.

Opciones adicionales del Mouse

Redimensionar tablas A lo largo de las opciones de configuracin rpida (Mapear todo, desmapear todo, deshacer y rehacer), tambin es posible cambiar el tamao de las tablas dando clic en el nombre del sistema

1494

Copyright 2013 - Bizagi

externo (el cual se ve como la etiqueta del encabezado de la tabla). Mientras esta seleccionada la tabla, diversos puntos verdes aparecern para habilitar la edicin de su tamao (utilizando estos puntos verdes para ampliar o reducir la tabla):

Atributos de Mapeo Para mapear manualmente un atributo o parmetro de la tabla de la izquierda (datos Bizagi), a un atributo o parmetro de la derecha (sistema externo), usted puede utilizar cualquiera de estas dos opciones: usando clics o usando la funcionalidad arrastrar y soltar.

Usar clics Usted puede crear la conexin de mapeo dando clic primero en el atributo o parmetro de la tabla de la derecha. El atributo se resaltar.

Copyright 2013 - Bizagi

1495

Luego, d clic sobre el atributo o parmetro de la tabla derecha para dibujar una conexin que representa el mapeo entre estos dos atributos o parmetros. Usar la funcionalidad arrastre y suelte Usted puede arrastrar una conexin manteniendo el botn izquierdo del mouse pulsado sobre el triangulo saliente del atributo o parmetro de la tabla derecha:

Al soltar esta conexin en el tringulo entrante del atributo o parmetro de la tabla derecha, se crear el mapeo.

Opciones REST
Estas opciones adicionales estn disponibles nicamente para tablas en las cuales se ha seleccionado REST como el tipo de servicio para la invocacin. Estas opciones REST se brindan para ayudar a la definicin y construccin de estructura de las entradas o salidas del servicio.

1496

Copyright 2013 - Bizagi

Las opciones REST presentada en las secciones posteriores se encuentran dando clic en la tabla del servicio REST. Note que la versin 9.1.9 del asistente de interfaces de Bizagi soporta respuestas en formato XML (y no en formatos JSON).

Para definicin manual de la estructura

Cuando se elige crear la definicin de la estructura en una forma manual, el primer item listado para seleccionar es el de A g reg ar N o d o Raz. Esta opcin permite iniciar la definicin del XML. Agregar Nodo Raz Esta opcin agrega el nodo raz a la estructura XML. Para usar esta opcin, d clic en Agregar N o d o Raz y luego clic derecho en cualquier lugar de la tabla:

Copyright 2013 - Bizagi

1497

D clic derecho sobre el nodo raz para mostrar una lista de caractersticas asociadas.

1498

Copyright 2013 - Bizagi

Agregar Nodo de Elemento Esta caracterstica agregar un elemento como elemento hijo del nodo seleccionado. El elemento aadido se representa inicialmente como un atributo tipo texto con su valor en fuente negra. Una vez este elemento contiene nodos hijos, se representar automticamente como un nodo. La imagen a continuacin muestra los elementos aadidos in fo 1 e in fo 2:

Copyright 2013 - Bizagi

1499

Agregar Nodo de Atributo Esta caracterstica agregar un atributo directamente bajo el nodo seleccionado. El atributo hijo aadido se representa como un atributo tipo texto con su valor en fuente azul.

1500

Copyright 2013 - Bizagi

Renombrar Nodo Esta caracterstica permitir renombrar el nodo seleccionado:

Eliminar Nodo Esta caracterstica eliminar el nodo seleccionado as como a sus elementos y atributos hijo. Usted necesitar confirmar la eliminacin:

Copyright 2013 - Bizagi

1501

Importar (Para cargar estructura automtica)

Cuando se elige proveer la definicin de la estructura de manera automtica, usted puede importar la definicin XML desde un archivo de esquema XSD o un XML de muestra.

Nota: Cualquier estructura definida previamente se eliminar cuando se importa una nueva definicin de estructura. Cargar desde XSD Esta opcin cargar la estructura XML entera desde el archivo .XSD seleccionado:

1502

Copyright 2013 - Bizagi

Cargar XML de muestra Esta opcin cargar toda la estructura XML desde un archivo de muestra .XML:

Copyright 2013 - Bizagi

1503

Nota: Cuando se cargue desde un XML de muestra, usted necesitar asegurar que el archivo de muestra no contenga algun caracter XML reservado (como el ampersand "&"). Si estos caracteres reservados se representan como un valor en algn nodo dentro de este archivo, asegrese que esta contenido dentro de la seccin CDATA (de otra manera usted obtendr el error "A n erro r o ccu rred w h ile p arsin g ... ")

Exportar
Una vez cargada la estructura XML, usted puede guardar esta definicin para usos futuros:

1504

Copyright 2013 - Bizagi

Exportar a XSD Esta opcin guardar la estructura XML actual como un archivo .XSD:

Copyright 2013 - Bizagi

1505

Encabezados SOAP

Mientras se invocan servicios web, frecuentemente se requiere enviar informacin que no esta relacionada a datos del proceso por si mismos, tales como informacin de autenticacin para validar que el usuario invocando el servicio posea la autorizacion adecuada. Para estos casos, es til enviar esta informacin dentro de un encabezado SOAP (en el protocolo de mensaje SOAP).

Es necesario que la definicin y creacin de ese servicio web cubra especficamente los datos esperados en el encabezado del mensaje. Bizagi soporta el envo de datos en el encabezado SOAP, as como la recepcin desde este encabezado con un manejo descomplicado. Para hacer esto, simplemente mapee las conexiones requeridas (entrantes o salientes segn aplique) desde los campos correspondientes en Bizagi. Por lo tanto, Bizagi reconoce si un servicio Web espera cierta informacin en el encabezado. El Mapeo de los datos involucrados para esta integracin se especifica de la misma manera que con los datos desde un mtodo de servicio Web.

1506

Copyright 2013 - Bizagi

3.8.1.4.1 Funciones de Mapeo

Bizagi ofrece un conjunto de funciones exhaustivas para el mapeo de parmetros en invocaciones de servicios basados en Web (tanto parmetros de entrada como de salida). Dichas funciones son de gran ayuda para interpretar y realizar manipulacin de informacin, especialmente de uso comn en transformaciones XML.

Funciones Especiales
El uso de funciones especiales requiere que los campos mapeados esten dentro de un nodo de Elemento. Nota: Los nodos de Elemento pueden verse como elementos de tipo complejo. Las funciones especiales requieren que sus entradas y salidas estn contenidas en nodos de Elemento.

Copyright 2013 - Bizagi

1507

Concatenar
Esta funcin concatena dos o mas entradas de tipo texto) en una salida (de tipo texto). Un ejemplo comn considerando la concatenacin de los nombres y apellidos de un contacto ilustra el uso y alcance de esta funcin:

1508

Copyright 2013 - Bizagi

Para usar esta funcin, seleccione desde la barra de funciones (fx), la opcin Concat ubicada en el men de funciones de la categora texto. Luego, arrastre y suelte esta opcin dentro de la ventana principal de mapeo donde se encuentran sus tablas. Ahora, usted puede arrastrar el tringulo de conexin saliente una entrada y soltarlo en la caja de Concat como un parmetro ( p aram 1).

Repita este paso para la entrada que usted ha escogido como p aram 2. Finalmente, seleccione la lnea de Salid a en la caja de Concat para definir la salida de la funcin de concatenacin. En este ejemplo, el atributo VENDOR_NAME tendr la informacin almacenada en la entidad Vendor de Bizagi, en el atributo FirstName, seguido por la informacin almacenada en LastName.

Observe que usted podra concatenar ms campos incluyendo ms cajas de Concatenacin (en

Copyright 2013 - Bizagi

1509

cascada). De esta manera, la salida de una funcin de Concatenacin podr ser utilizada como la entrada para otra y as anexar un tercer parmetro (en este caso).

Substring
Esta funcin obtiene un texto que es un subtexto del texto principal. Tenga en cuenta que esta funcin especial en Bizagi no requiere que su entrada sea un campo de texto. Bizagi convertir automticamente a texto otros tipos de informacin como enteros o campos de Fecha-Hora. Por lo tanto, esto permite utilizar la funcin substring con cualquier otro tipo de dato diferente a un texto. Para utilizar esta funcin, selecciones desde la barra de funciones (fx), la funcin Substring que se encuentra en el men de funciones de la categora texto. Luego, arrastre y suelte esta opcin dentro de la ventana principal de mapeo donde se encuentran sus tablas.

1510

Copyright 2013 - Bizagi

Ahora, usted puede arrastrar el tringulo de conexin saliente una entrada y soltarlo en la caja de Substring como un parmetro de texto (este es el texto original de entrada el cual es obligatorio).

Copyright 2013 - Bizagi

1511

Para los otros dos parmetros, la funcin espera un nmero que indica: Parmetro de In icio : La posicin inicial en el texto original desde el cual se obtendr el subtexto .Este parmetro es obligatorio. Esto significa que la funcin har que el caracter en esta posicin sea el inicio de la salida del substring. El primer caracter y la posicin del texto original es siempre "1".

1512

Copyright 2013 - Bizagi

Parmetro de Lo n g itu d: El nmero de caracteres incluidos desde la posicin de inicio. El parmetro de longitud es opcional (si no se especifica una longitud se incluirn todos los caracteres siguientes al caracter de inicio). Observe que para definir los valores de estos dos parmetros se utiliza comnmente la funcin Co n stan te. Un ejemplo comn es utilizar la funcin especial Subtexto para obtener informacin especfica de una Fecha. En este ejemplo, obtendremos el ao, mes y da de un atributo de tipo Fecha Hora en Bizagi que originalmente contiene tambin la hora:

Constante
Esta funcin inserta una definicin de un valor constante (texto o nmero) dentro de un esquema de mapeo, de manera que puede ser utilizando para asignar un valor a un campo. Para este ejemplo, supondremos que siempre se actualizan cinco das como das de vacaciones disponibles, cuando se registra un nuevo empleado. Para utilizar esta funcin, seleccione desde la barra de funciones (fx), la funcin Constante que se

Copyright 2013 - Bizagi

1513

encuentra en el men de funciones de la categora XSLT (Extensible Stylesheet Language Transformations). Luego, arrastre y suelte esta opcin dentro de la ventana principal de mapeo donde se encuentran sus tablas.

Usted puede arrastrar el tringulo de conexin saliente de la caja Constante y soltarlo en el atributo deseado.

Instancia Vaca

1514

Copyright 2013 - Bizagi

Esta funcin permite enviar una instancia vaca a un objeto. Por defecto, el mapeo en Bizagi enviar un valor NULO para aquellos objetos que no estn mapeados. Por lo tanto, si usted requiere que los objetos sin detalle explicito se enven como "vaco" (inicializados pero sin valor alguno) en vez de enviarlos como "NULO", utilice esta funcin. Para utilizar esta funcin, seleccione desde la barra de funciones (fx), la funcin In stan cia Vaca que se encuentra en el men de funciones de la categora XSLT (Extensible Stylesheet Language Transformations). Luego, arrastre y suelte esta opcin dentro de la ventana principal de mapeo donde se encuentran sus tablas.

Ahora, usted puede arrastrar el tringulo de conexin saliente de la caja Vaca y soltarlo en el atributo deseado. En ejecucin, Bizagi pasar un objeto vaco al parmetro de entrada (RequestedDetail en nuestro ejemplo).

Copyright 2013 - Bizagi

1515

Xpath
Esta funcin se utiliza solamente cuando una respuesta de servicio posee una estructura XML que no cumple con el modelo de datos de Bizagi y usted desea almacenar en l informacin proveniente de mltiples colecciones.
3.8.1.4.2 Mapeo con Colecciones

Un escenario comn cuando se integra Bizagi con un servicio Web o REST, es manejar respuestas que provienen como un arreglo de items. Esto significa que usted puede necesitar almacenar uno o ms registros dentro del modelo de datos de su Proceso. Para este escenario en Bizagi, usted puede utilizar el asistente de interfaces y su funcionalidad de mapeo grfico para especificar que esos resultados se guardarn en una coleccin.

1516

Copyright 2013 - Bizagi

Anexar y Reemplazar
Cuando se mapea dentro de una coleccin, usted puede establecer si desea Anexar (A) o Reemplazar (R) los items dentro de la coleccin. Por defecto, Bizagi anexar items, lo que quiere decir que los registros entrantes se almacenarn junto a los existentes. Cuando el mapeo a una coleccin se configura como de Anexar, usted notar una etiqueta (A) en el

Copyright 2013 - Bizagi

1517

nombre de la coleccin. Cuando elige reemplazarlos, Bizagi borrar primero los registros existentes en la coleccin. Cuando el mapeo a una coleccin se configura como de Reemplazar, usted notar una etiqueta (R) n el nombre de la coleccin.

Ejemplo
En el siguiente ejemplo, invocaremos un servicio Web que retorna un arreglo de Productos disponibles para un cliente dado. Primero, utilice el asistente de interfaces para configurar el Tip o d e serv icio , su URL y m to d o .

D clic en Sig u ien te y especifique cualquier informacin de entrada para la invocacin:

1518

Copyright 2013 - Bizagi

Ahora para sus parmetros de salida, asegrese de identificar tanto la coleccin en su modelo de datos como los arreglos de items provenientes. Usted necesitar mapear: 1. La representacin del arreglo de salida de su servicio, dentro de la coleccin en su modelo de datos del Proceso. 2. Cualquier informacin adicional contenida dentro del arreglo en los atributos correspondientes dentro de la coleccin. En nuestro ejemplo, mapeamos el ArrayOfProducts en nuestra coleccion,y especificamenos que el p n am e se almacenar dentro de in fo 1.

Copyright 2013 - Bizagi

1519

Observe que por defecto, Bizagi Anexar estos registros. Si usted desea editar esta configuracin (aplica para Bizagi Enterprise .NET y Bizagi Xpress) y especificar que los registros se reemplazarn (use Reemplazar), d doble clic en el nombre de su coleccin:

Cuando cambie esta configuracin y de clic en O K. Usted notar que la etiqueta mostrar automticamente la nueva configuracin.

1520

Copyright 2013 - Bizagi

Finalmente, configure el manejo de errores en caso de haber alguno (en este ejemplo saltaremos este paso por lo que damos clic en F in alizar).

Copyright 2013 - Bizagi

1521

Nota En algunos escenarios, el servicio Web puede no necesariamente incluir una entidad dentro de la coleccin (como elementos del XML), y tener en cambio los 1-n elementos internos (atributos) a lo largo de la coleccin. En estos escenarios es importante que se mapee explcitamente en Bizagi, la entidad del elemento en cambio (para nuestro ejemplo anterior, eso sera mapear la entidad Products a la coleccin returnedcollection). 3.8.1.5 Manejo de Errores en Interfaces

Informacin General
Bizagi provee un asistente de interfaces para configurar fcilmente la invocacin de servicios externos en integracin a nivel de Proceso (sin necesidad de programar). Este Asistente brinda pasos asistidos para configurar el mapeo de parmetros involucrados en la invocacin de esos servicios (servicios Web o REST), y cmo manejar posibles errores de negocio en tales invocaciones. Cuando se aplica la integracin de aplicacin en Procesos (por ejemplo, verificando alguna informacin en un servicio externo, consultar informacin de clientes, actualizar el sistema de nmina, etc), la integracin aplicada puede responder con un error de negocio.

1522

Copyright 2013 - Bizagi

Los errores de negocio hacen referencia a mensajes tales como "No se encontr el cliente", "La operacin no se pudo completar debido a razones internas", entre otros. El Asistente de interfaz gua al usuario paso a paso para evaluar y manejar errores de negocio potenciales en flujos de Proceso e implementarlos acordemente. Usted puede mostrar distintos mensajes de error especficos o lanzar un Evento de Error para causar una transicin a un estado diferente del flujo.

Configuracin de manejo de errores

El manejo de errores se implementa en el ltimo paso ( M an ejo d e Erro res) del Asistente de Interfaces. Adicionalmente, para convertir las respuesta de la invocacin, la cual se enva por una aplicacin externa en formato XML, tambin se puede definir cierta informacin contenida en esta respuesta. Esto se hace de la siguiente manera: 1. Decidir la accin correctiva del error. Esto implica especificar si se enva un mensaje de error o se lanza un evento de error para disparar una transicin. 2.Definir la respuesta de error. Esto implica crear una tabla de decisin para asignar la informacin encontrada en el XML de salida, cuando se lanza un error o excepcin durante el servicio.

Ejemplo
En el siguiente ejemplo, consideraremos el Proceso de Crdito que invoca un servicio Web externo, para verificar si un cliente est en la lista negra. Bizagi debera mostrar mensajes de error generados por el servicio externo, si se plantean (por ejemplo, cuando el resultado del Cdigo de Error tiene un valor diferente a "001"). En el paso de Dato s d e Resp u esta, consultamos la respuesta estructurada en XML del servicio Web externo, Resp o n seB lackList, el cul se presenta como una tabla a la izquierda. El encabezado de la tabla, B lackList915, referencia el nombre de los servicios Web externos.

Copyright 2013 - Bizagi

1523

1. Decidir la accin para el error

Primero, decidimos la accin correctiva a seguir en respuesta a un error potencial. La lista desplegable de los campos de A cci n presenta las dos opciones: Mostrar un mensaje de error o lanzar una transicin desde un evento BPMN.

1524

Copyright 2013 - Bizagi

La segunda opcin, Realizar A ju stes (lanzar una transicin), solo se habilitar si el diseo del diagrama de Proceso permite el manejo de errores; especificamente, un Evento de captura de error debe estar adjunto a los lmites de la actividad relevante. Cuando se selecciona la segunda opcin, note que el camino de la transicin posee el mismo nombre por defecto y se llamar Realizar A ju stes (como se muestra en la siguiente imagen).

Copyright 2013 - Bizagi

1525

Para este ejemplo, seleccionaremos la opcin Lan zar ex cep ci n .

2. Definir los errores de respuesta

El mensahe de la excepcin generada se encontrar en el XML de salida cuando se lancen errores o excepciones durante el servicio. Guardaremos la respuesta de error en un XPath dado como se encuentra en el parmetro de salida del mtodo de servicio Web. Usted puede escribir la definicin del XPath directamente en el campo de fondo blanco, para navegar al campo del XPath de respuesta. Observe cuando navegue (profundice) en la estructura del XML de respuesta, que el caracter slash (/) precede los datos contenidos en el XML retornado. El esquema del XML de retorno se mostrar en el paso previo, Dato s d e Resp u esta, del asistente de interfaces, cuando se importe la definicin de la estructura del XML. En nuestro ejemplo, el esquema contiene los siguientes dos elementos de manejo de errores:

C d ig o d e Erro r (Erro rCo d e): Cdigo del error que ocurri, de otra manera estar vaco. Descrip ci n d el Erro r (Erro r Descrip tio n ): Mensaje del error que ocurri, de otra manera estar vaco.
En nuestro ejemplo, el XPath se especificar como el nombre de la respuesta XML, Resp o n seB lackList, seguido por el caracter slash (/) y por ltimo el nombre del elemento, Erro rCo d e, en la salida XML: ResponseBlackList/ErrorCode En este ejemplo, el cdigo de error desde la respuesta se enva como ResponseBlackList/ErrorCode (como se ve en la estructura de la respuesta en la imagen previa de las configuraciones de salida).

1526

Copyright 2013 - Bizagi

D clic en A g reg ar v alid aci n d e Erro r para validar la informacin retornada por el elemento Erro rCo d e. Cuando el valor del elemento Erro rCo d e difiere de "001", Bizagi debera mostrar el elemento Erro rDescrip tio n contenido en esa misma estructura de respuesta (como ResponseBlackList/ ErrorDescription).

Copyright 2013 - Bizagi

1527

Usted tambin puede ingresar un texto fijo como mensaje de error en contraposicin a la descripcin retornada por el servicio.

Informacin Adicional
Si el manejo de errores se especifica como la accin Lan zar Ex cep ci n , las invocaciones fallidas que se configuraron como Actividades Asncronas se pueden revisar y monitorear en las opciones de Administracin en el Portal de Trabajo. Para mayor informacin, consulte la Administracin de Actividades Asncronas.

3.8.2

Integrar APIs o cdigo personalizado

Informacin General
Bizagi ofrece una capa de integracin que permite a sistemas existentes (tales como ERP, CRM, aplicaciones Core y el ESB en general), ser integrados dentro de Bizagi como una solucin corporativa BPMS. Los Procesos Organizacionales en Bizagi tienen la opcin de utilizar fcilmente: un asistente de interfaz para invocaciones de servicios web y rest (sistemas en internet o intranet), y una funcionalidad denominada Librera de Componentes para una integracin a nivel de Proceso (transaccional).

1528

Copyright 2013 - Bizagi

A travs de la Librera de Componentes, Bizagi provee poderosas opciones de extensibilidad tanto para la lgica de negocio en los Procesos y para la capa de arquitectura de integracin (esto es, la posibilidad de incluir APIs y conectores especficos a sistemas externos, aplicaciones o bases de datos). Un ejemplo de uso de Librera de Componentes orientado a mejorar la lgica de negocio, es cuando necesitamos considerar lgicas de Proceso que implementa clculos sofisticados u operaciones, por ejemplo cuando se realizan simulaciones de pagos de amortizacin o manipulacin de archivos. Estas operaciones pueden ser muy complejas y pueden involucrar el uso de componentes existentes y APIs. Con respecto al uso de la librera de componentes para propsitos de integracin, una solucin corporativa puede requerir confiabilidad en los componentes que conectan a los sistemas, principalmente legacy o aquellos que no tienen una arquitectura orientada a servicios.

Cmo funciona?
La Librera de Componentes acta como un repositorio middleware de componentes personalizadosdesarrollados (los cuales pueden utilizar APIs o conectores externos). Este componente se registra en Bizagi incluyendo su archivo de compilacin ( ya sea un .dll o .jar construido de acuerdo a la tecnologa de plataforma en la cual los Procesos de Bizagi se ejecutarn). Para ambientes basados en .Net (Bizagi Enterprise edicin .Net), los componentes en la Librera de

Copyright 2013 - Bizagi

1529

Componentes tendrn un montaje dll correspondiente, mientras que para ambientes basados en JAVA (Bizagi JEE edition), un componente tendr un archivo jar correspondiente. Una vez registrado en la Librera de Componentes de un proyecto Bizagi, los mtodos publicos de los componentes pueden ser invocados directamente desde las reglas de negocio de los Procesos (desde tareas sncronas o asncronas).

Componentes en produccin
Una vez que un proyecto ha sido pasado a ambiente de produccin, no ser posible eliminar sus componentes (registrados en la Librera de Componentes). Por lo tanto, en el ambiente de desarrollo (a travs de Bizagi Studio) la edicin de la informacin de los componentes esta restringido de acuerdo a si este componente ya ha sido desplegado a un ambiente de produccin o no. La edicin de la informacin de un componente que ha sido desplegado a otro ambiente considera que: Usted puede editar su archivo de compilacin registrado (montaje dll o archivo jar). Usted no puede editar el nombre de los componentes o su nombre de espacio definido en la Librera de Componentes. 3.8.2.1 Ejemplo en Enterprise .NET En el siguiente ejemplo, utilizaremos la funcionalidad de Librera de Componentes para incluir un componente desarrollado que utiliza un API externo. Para ms informacin sobre esta opcin en Bizagi, consulte el artculo principal.

Qu se necesita en Bizagi?
Para utilizar una funcionalidad de Librera de Componentes, se llevan a cabo los siguientes pasos: 1. Construir su componente (una salida compilada). 2. Registrar el componente en Bizagi. 3. Crear las reglas de negocio que invocan el componente.

Consideraciones relacionadas al servidor

Cuando se desarrolla un componente para usarlo directamente en Bizagi Enterprise .NET, debe asegurarse de que el componente se compile con el framework soportado por la aplicacin Bizagi (la misma versin de framework o uno anterior). En Bizagi Go, el framework soportado de la aplicacin es .NET 4.0.

Ejemplo
Ilustraremos esto a travs de un Proceso de Solicitud de Crdito.

1530

Copyright 2013 - Bizagi

Observe que este es un ejemplo simplificado, en el cual validaremos que el solicitante no este reportado en la central de riesgo, desde la tarea de servicio Verificar Lista N eg ra. En esta tarea de servicio, crearemos un regla de negocio que acceda a nuestro componente desarrollado para hacer usos de ese API. A travs de este API, invocaremos un mtodo que devuelva si el solicitantes esta o no listando en la lista negra (verdadero o falso).

En esta seccin ilustraremos como usar la funcionalidad de Librera de Componentes para un proyecto Enterprise.NET.

Construir su componente (una salida compilada)

Nuestro primer paso es desarrollar el componente como un proyecto de librera de clase. En nuestro componente ejemplo llamado MyCreditBureauComponent, hacemos uso de un CreditBureau.dll, el cual representa un API de ejemplo.

Copyright 2013 - Bizagi

1531

Observe que incluimos la referencia en nuestro componente.

1532

Copyright 2013 - Bizagi

Para la edicin Enteprise .Net construimos el proyecto de librera de clase como un montaje dll.

Copyright 2013 - Bizagi

1533

Note que el nombre del espacio de nuesto componente es MyCreditBureauComponent, y que nuestra clase es pblica (llamada Class1). El mtodo que utilizaremos en este ejemplo se denomina "IsCustomerInBlackList.

Registrando el componente en Bizagi

Habiendo construido el montaje del componente en nuestro paso previo, utilizaremos la salida MyCreditBureauComponent.dll para registrar el componente en la Librera de Componentes de Bizagi. Para hacerlo, vamos a las Herramientas de Bizagi Studio y agregamos un nuevo componente:

Damos un nombre, nombre de mostrar y una descripcin para registrar el componente:

1534

Copyright 2013 - Bizagi

Luego, cargamos el montaje MyCreditBureauComponent.dll y especificamos el nombre para el espacio del componente.

Clic en F in alizar.

Copyright 2013 - Bizagi

1535

Dado que este componente referencia y utiliza otra librera de clase (el API), necesitamos registrar e incluir este API en nuestra libreria de componentes tambin. Por lo tanto, repetimos los pasos para agregar un componente, pero esta vez para el montaje CreditBureau.dll.

Para nuestro API de CreditBureau, no es relevante el nombre del espacio que demos, principalmente porque no lo vamos a invocar directamente desde las reglas de negocio de Bizagi. Cargamos el montaje correspondiente y especificamos el nombre del espacio:

1536

Copyright 2013 - Bizagi

Al final, necesitamos tener registrados nuestros dos montajes como dos componentes separados.

Crear las reglas de negocio que invocan el componente

Ahora que hemos registrado nuestra Librera de Componentes, procedemos a crear una regla de negocio que invoque el mtodo del componente. Para hacerlo, vamos a la vista de Acciones de la Actividad desde nuestro Asistente de Procesos, y seleccionamos la tarea de servicio Verificar Lista N eg ra. Incluimos una regla de negocio en este punto del Proceso:

Copyright 2013 - Bizagi

1537

En la expresin, invocamos nuestro mtodo de MyCreditBureauComponent con la siguiente sintaxis: Namespace.Class.Method Note que nuestra clase no se define como una clase esttica, y por lo tanto podemos crear previamente una instancia de este, para invocar sus mtodos. En nuestro ejemplo, la expresin completa invoca el metodo IsCustomerInBlackList por: Enviar el id del Solicitante. Almacenar el resultado del mtodo en el atributo de tipo booleano CreditRequest.InBlackList.

1538

Copyright 2013 - Bizagi

Este es el contenido de la expresin: var temp = new MyCreditBureauComponent.Class1(); Me.setXPath("CreditRequest.InBlackList", temp.IsCustomerInBlackList (Me.getXPath("CreditRequest.ApplicantId")));

En este punto, hemos configurado un componente desarrollado con la funcionalidad de Librera de Componentes en Bizagi.

Ejecucin
Para ver este ejemplo funcionando, ejecutaremos nuestro Proceso en el Portal de Trabajo de Bizagi, dando clic en la opcin Ejecu tar P ro ceso :

Copyright 2013 - Bizagi

1539

Podemos ver que despus de la tarea de servicio Verificar Lista N eg ra, nuestra prxima Actividad ser mostrar el resultado de la invocacin de los mtodos de nuestro componente:

1540

Copyright 2013 - Bizagi

3.8.2.2

Ejemplo en Enterprise JEE En el siguiente ejemplo, utilizaremos la funcionalidad de Librera de Componentes para incluir un componente desarrollado que utiliza un API externo. Para ms informacin sobre esta opcin en Bizagi, consulte el artculo principal.

Qu se necesita en Bizagi?
Para utilizar una funcionalidad de Librera de Componentes, se llevan a cabo los siguientes pasos: 1. Construir su componente (una salida compilada). 2. Registrar el componente en Bizagi. 3. Crear las reglas de negocio que invocan el componente.

Consideraciones relacionadas al servidor

Cuando se desarrolla un componente para usarlo directamente en Bizagi Enterprise JEE, debe asegurarse de que el componente se compile con el framework soportado por la aplicacin Bizagi (la misma versin de framework o uno anterior). En Bizagi Go, el framework soportado de la aplicacin es el JDK 6 update 31. Adems de lo anterior, si su componente invoca un servicio Web SOAP, debe asegurarse de que el Servidor de Aplicaciones JEE soporte el estndar bajo el cual el servicio Web fue construido. De lo contrario (por ejemplo, si se usa JBoss 7 para invocar un servicio Web que sea SOAP1.2,) se requerir de configuracin adicional en el Servidor JEE y el proxy que se genera.

Ejemplo
Ilustraremos esto a travs de un Proceso de Solicitud de Crdito.

Copyright 2013 - Bizagi

1541

Observe que este es un ejemplo simplificado, en el cual validaremos que el solicitante no este reportado en la central de riesgo, desde la tarea de servicio Verificar Lista N eg ra. En esta tarea de servicio, crearemos un regla de negocio que acceda a nuestro componente desarrollado para hacer usos de ese API. A travs de este API, invocaremos un mtodo que devuelva si el solicitantes esta o no listando en la lista negra (verdadero o falso).

En esta seccin ilustraremos como usar la funcionalidad de Librera de Componentes para un proyecto Enterprise JEE.

Construir su componente (compilarlo como librera)

Nuestro primer paso es desarrollar el componente como un proyecto de librera de clase Java. En nuestro componente de muestra denominado MyCreditBureauComponent, hacemos uso de CreditBureau.jar, que representa un API de ejemplo.

1542

Copyright 2013 - Bizagi

Incluimos el .jar dentro de la librera de nuestro proyecto. Para la edicin Enterprise JEE, construimos el proyecto de librera de clase como un archivo .jar.

Copyright 2013 - Bizagi

1543

Ntese que el nombre de nuestro paquete es co m .cred itb co m p o n en t, y observe que nuestra Clase es pblica (denominada "Class1"). El mtodo que utilizaremos en este ejemplo se denomina IsCustomerInBlackList. Nota Tenga en cuenta que es muy importante que el ensamblado del componente desarrollado no incluya el API como tal. Aunque este componente haga referencia al API, no se debe incluirlo en el archivo de salida.

Registrar el componente en Bizagi

Habiendo construido el montaje del componente en nuestro paso previo, utilizaremos esta salida (MyCreditBureauComponent.dll) para registrar el componente en la Librera de Componentes de Bizagi. Para hacerlo, vamos a las Herramientas de Bizagi Studio y agregamos un nuevo componente:

Ingresamos la siguiente informacin: N o m b re p ara m o strar (Display name): El nombre que se despliega para este componente en la Librera. N o m b re (Name): El nombre nico del componente. Descrip ci n : Una descripcin opcional. Co m p o n en te (archivo jar): El ensamblado del componente como tal. Cargamos el archivo MyCreditBureauComponent.jar.

1544

Copyright 2013 - Bizagi

P ackag e (paquete): El nombre del package definido para la clase. Esta informacin debe ser acertada para los componentes cuyos mtodos sean directamente invocados desde Bizagi (componentes que sean punto de entrada desde reglas de negocio).

Clic en F in alizar. Dado que este componente referencia y utiliza otra librera de clase jar (el API), necesitamos registrar e incluir este API en nuestra librera de componentes tambin. Por lo tanto, repetimos los pasos para agregar un componente, pero esta vez para la referencia CreditBureau.dll. Para nuestro API de CreditBureau, definimos la siguiente informacin:

Copyright 2013 - Bizagi

1545

Clic en F in alizar.

Nota En este ejemplo no se requiere de informacin adicional principalmente porque nuestra API llamada Cred itB u reau .jar no utiliza otros archivos .jar adicionales y porque esta API en particular no viene incluida ya en JBoss. Existen algunas consideraciones especiales en la configuracin de componentes (especialmente en JBoss), cuando cualquiera de las 2 anteriores variables estn presentes, como se describe en Consideraciones especiales con componentes.

Al final, necesitamos tener nuestros dos jars como dos componentes separados:

1546

Copyright 2013 - Bizagi

Crear la regla de negocio que invoca el componente

Ahora que hemos registrado nuestra Librera de Componentes, procedemos a crear una regla de negocio que invoque el mtodo del componente. Para hacerlo, vamos a la vista de Acciones de la Actividad desde nuestro Asistente de Procesos, y seleccionamos la tarea de servicio Verificar Lista N eg ra. Incluimos una regla de negocio en este punto del Proceso:

En la expresin, invocamos nuestro mtodo de MyCreditBureauComponent con la siguiente sintaxis: Class.Method Note que nuestra clase no se define como una clase esttica, y por lo tanto podemos crear previamente una instancia de este, para invocar sus mtodos. En nuestro ejemplo, la expresin completa invoca el metodo IsCustomerInBlackList por: Enviar el id del Solicitante.

Copyright 2013 - Bizagi

1547

Almacenar el resultado del mtodo en el atributo de tipo booleano CreditRequest.InBlackList.

Este es el contenido de la expresin: var temp = new Class1(); Me.setXPath("CreditRequest.InBlackList", temp.IsCustomerInBlackList (Me.getXPath("CreditRequest.ApplicantId")));

Nota Cuando se guarde la regla de negocio invocando un metodo de Componente (como en este ejemplo), la regla se guadrar con advertencias y errores en la compilacin de Bizagi. Para este caso, estos mensajes se pueden ignorar (trabajar correctamente en ejecucin). En este punto, hemos configurado un componente desarrollado con la funcionalidad de Librera de Componentes en Bizagi.

Ejecucin
Para ver este ejemplo funcionando, ejecutaremos nuestro Proceso en el Portal de Trabajo de Bizagi, dando clic en la opcin Ejecu tar P ro ceso :

1548

Copyright 2013 - Bizagi

Podemos ver que despus de la tarea de servicio Verificar Lista N eg ra, nuestra prxima Actividad ser mostrar el resultado de la invocacin de los mtodos de nuestro componente:

Copyright 2013 - Bizagi

1549

3.8.2.2.1 Consideraciones especiales con componentes

Cuando se utiliza la funcionalidad de la librera de componentes en Bizagi, existen algunos escenarios para los cuales se debe realizar configuracin adicional en el Servidor de Aplicaciones JEE. Esto escenarios se dan cuando se utilizan APIs de terceros (el uso de libreras externas o archivos jar comunes), y se pueden describir como: Cuando mi componente hace referencia a archivos jar que ya estn contenidos en el servidor de Aplicaciones JEE. Si este es el caso, entonces lo importante ac es garantizar que no hayan conflictos con este jar, dado que el componente utilizar este archivo o uno de una versin similar. Cuando mi componente hace referencia a un API, que a su vez utiliza otras APIs. Si este es el caso, ntese que deber incluir esas otras APIs en el Servidor de aplicaciones e incluir una referenciacin manualmente. Este artculo describe cmo registrar componentes donde se tienen cualquiera de los 2 escenarios descritos anteriormente, al utilizar la funcionalidad de librera de componentes de Bizagi y la edicin Enterprise JEE. Ntese que estos pasos no aplicarn a escenarios ms simples, donde se desarrolla un componente y ste no utiliza APIs adicionales. Para ms informacin y un ejemplo bsico del uso de la librera de componentes en la edicin JEE, consulte Ejemplo en Enterprise JEE.

Consideracin especial
Para utilizar correctamente la funcionalidad de librera de componentes en estos escenarios, realice: 1. Asegrese de compilar su componente como una librera que no incluya en el jar final las referencias que utiliza. 2. nicamente registre este componente en la librera de componentes (solo su componente que es el punto de entrada para la lgica de las reglas de negocio). 3. Incluya los archivos jar adicionales en la carpeta de librera del Servidor de Aplicaciones JEE. Si usted utiliza WebSphere o Weblogic, deber solamente incluir estos jars en esta ruta: Para WebSphere: Incluirlas en <WEBSPHERE_HOME>\lib\ext\. Si ya existe esa versin o una similar, deber asegurarse de que no hayan conflictos, lo cul se puede revisar usualmente al momento de subir el servicio del servidor. Para Weblogic: Incluirlas en <WEBLOGIC_HOME>\wlserver_10.3\server\lib\. Si ya existe esa versin o una similar, deber asegurarse de que no hayan conflictos, lo cul se puede revisar usualmente al momento de subir el servicio del servidor.

1550

Copyright 2013 - Bizagi

Si usted utiliza JBoss, deber realizar un paso adicional, el cual consiste en registrar manualmente estas referencias en un archivo de configuracin. Para mayor detalle sobre esto, consulte la siguiente seccin con el ejemplo en JBoss.

Ejemplo para JBoss

Un ejemplo tpico para ilustrar de mejor manera la configuracin adicional, es cuando desarrollamos un componente que se usa en la conexin a unos servicios Web, y dicho componente es un cliente de servicio Web que se basa en AXIS. Este cliente entonces se apoya en las siguientes libreras externas:

Este escenario nos representa una configuracin adicional porque las invocaciones a servicios Web en JBoss se manejan a travs del utilitario que provee java, llamado w sim p o rt.jar. Por lo tanto, nuestro primer paso es asegurarnos que compilemos el componente sin incluir estas 6 libreras referenciadas, y que registremos nicamente este componente en la librera de componentes de Bizagi. En seguida, copiamos las 6 libreras en el repositorio de libreras del proyecto en: <BIZAGI_HOME>\BizagiConsoleManagerJEE\projects\[NOMBRE_PROYECTO]\lib\ Considere: <BIZAGI_HOME>: Es la ruta de instalacin donde se encuentra la Consola administrativa JEE. En un ambiente de desarrollo, esta ruta representa el directorio de instalacin de la edicin Bizagi JEE Enterprise el cual por defecto es C:/B izag iJEE/. [NOMBRE_PROYECTO]: El nombre del proyecto. De esta manera y para el registro de las libreras, un primer paso se realiza por Bizagi a travs de su consola de administracin JEE, cuando se usan los comandos de publicacin (publish) o el de predeploy, donde se crea la estructura base para la configuracin manual. Sea cuando se realiza el despliegue de la aplicacin en JBoss (generacin del Portal de trabajo para ambientes de pruebas o produccin), o cuando se trabaja con Bizagi Studio, Bizagi generar el archivo para configurar manualmente los mdulos. Antes de ejecutar los comandos publish o predeploy, se recomienda asegurarse que haya borrado manualmente cualquier contenido previo en <JBOSS_HOME>\modules\com\bizagi\. Esto significa, que el folder clibrary no deber existir antes de ejecutar los comandos.

Copyright 2013 - Bizagi

1551

Una vez que haya realizado la publicacin o usado el comando predeploy, deber editar el archivo m o d u les.x m l que se encuentra en: <JBOSS_HOME>\modules\com\bizagi\clibrary\main\

Para editar este archivo considere lo siguiente: Incluya el elemento module para las referencias a las libreras usadas directamente o indirectamente por su componente, al adiciona lo siguiente: <?xml version="1.0" encoding="UTF-8"?> <module xmlns="urn:jboss:module:1.1" name="[PACKAGE_MI_COMPONENTE]"> <resources> <resource-root path="[MI_COMPONENTE].jar"/> <resource-root path="[REF_LIBRERIA1].jar"/> <resource-root path="[REF_LIBRERIA2].jar"/> </resources> <dependencies> <module name="[PACKAGE_REF_LIBRERIAS]"/> </dependencies> </module> En nuestro ejemplo del cliente con AXIS, el archivo de configuracin finalmente se ver como: <?xml version="1.0" encoding="UTF-8"?> <module xmlns="urn:jboss:module:1.1" name="com.bizagi.clibrary"> <resources> <resource-root path="axis.jar"/> <resource-root path="jaxrpc.jar"/> <resource-root path="commons-discovery-0.2.jar"/> <resource-root path="commons-logging.jar"/> <resource-root path="saaj.jar"/>

1552

Copyright 2013 - Bizagi

<resource-root path="wsdl4j.jar"/> <resource-root path="activation-1.1.jar"/> <resource-root path="log4j-1.2.17.jar"/> <resource-root path="MiComponente.jar"/> </resources> <dependencies> <module name="javax.api"/> </dependencies> </module> Ntese que co m .b izag i.clib rary es el paquete (package) definido para nuestro componente. Nuestro componente se llama M iCo m p o n en te.jar y las libreras de AXIS que referenciamos se encuentran en el package jav ax .ap i. Una vez que haya editado el archivo, guarde los cambios y cirrelo. Para mayor detalle sobre la creacin de mdulos en JBoss 7, se recomienda revisar la siguiente documentacin del fabricante: http://middlewaremagic.com/jboss/?p=1933 https://docs.jboss.org/author/display/AS71/Class+Loading+in+AS7

3.8.3

Invocar servicios de Bizagi desde aplicaciones externas

Informacin General
Cada proyecto en Bizagi esta disponible automticamente para ser invocado a travs de servicios Web, por una aplicacin externa. Estos servicios Web son construidos y publicados dentro de la Capa SOA de Bizagi. Dentro de su opcin de integracin en Bizagi, cualquier aplicacin o sistema externo tiene la posibilidad de crear nuevas instancias de Procesos de Bizagi, ejecutar una Actividad de Proceso, lanzar un Evento o consultar y actualizar informacin de negocio para los Procesos, entre otros. Tales mtodos web disponibles obedecen al estndar SOAP con entradas y salidas estructuradas en XML (solicitudes y respuestas).

Capa SOA Bizagi

La Capa SOA es una capa implementada en Bizagi para brindar a los procesos funcionalidad para el ESB (Enterprise Server Bus) en una solucin corporativa BPM. Desde un punto de vista de arquitectura de sistema, Bizagi cumple con las Arquitecturas Orientadas a Servicio, en la cuales, las aplicaciones exponen sus principales funcionalidades como servicios (para asegurar las mejores prcticas para integracin entre sistemas ejecutndose en plataformas heterogneas).

Modelo de datos Bizagi

Para utilizar la Capa SOA de Bizagi efectivamente, es aconsejable mirar y entender la estructura del modelo de datos de sus proyectos Bizagi, antes que todo.

Copyright 2013 - Bizagi

1553

Esto asegura que la informacin enviada dentro de la estructura XML es consistente con cualquier mtodo web de Bizagi. A travs de las opciones de esquemas XML de Bizagi, usted puede generar y ver el XSD (Definicin de esquema XML) de cualquier entidad o estructura de modelo de datos de Proceso (como se espera por Bizagi). Adicional a esto, tenga en cuenta que para enviar informacin a Bizagi via XML, usted puede utilizar la definicin de llaves de negocio para actualizar o referenciar registros existentes.

Acceder estos servicios web publicados

Para acceder a los servicios Web de un proyecto Bizagi, y para detalles adicionales acerca de este componente en Bizagi, consulte el artculo URL de Capa SOA y consideraciones. Los servicios Web de Bizagi estn divididos principalmente en las siguientes categoras: 1. Servicios SOA de motor de Workflow. Estos servicios brindan acceso la motor BPMN de Bizagi para administrar los flujos de Proceso. Ejemplos de su uso son: Iniciar Procesos (Crear nuevos casos). Avanzar el flujo de trabajo (realizar actividades pendientes). Ejecutar eventos de negocio (configurar y lanzar eventos en el flujo). Abortar casos abiertos. 2. Servicios SOA de Administracin de Entidades. Estos servicios brindan acceso al modelo de datos de los Procesos. Ejemplos de su uso son: Consultar informacin almacenada en entidades de Bizagi. Agregar o modificar datos almacenados en entidades Bizagi. Obtener informacin de negocio de casos Bizagi. 3. Servicios SOA de Consulta. Estos servicios proveen acceso a los reportes de consulta de Bizagi. Ejemplos de su uso son: Obtener informacin de todos los casos desde la invocacin de una Forma de consulta. Obtener informacin de entidades Bizagi desde la invocacin de una Consulta de entidad. 4. Servicios SOA de Render. Estos servicios proveen acceso la metadata de las formas. Ejemplos de su uso son: Obtener y utilizar informacin de campos en las formas de la Actividad. Obtener y utilizar informacin de campos en una Forma de consulta o de resumen. A continuacin se describen mayores detalles acerca de estos cuatro servicios web.

Mtodos para manejar el Motor de Procesos BPMN (Motor de Workflow)

El servicio Web W o rkflo w En g in eSO A .asm x ?w sd l ofrece los siguientes mtodos: abortCasesAsString: Cancela uno o mas casos basado en el nmero de caso recibido en un XML con formato string. createCasesAsString: Crea uno o mas casos de un proceso Bizagi. Es posible crear un caso vaco o con informacin requerida por el caso. Este mtodo enva y recibe un string XML.

1554

Copyright 2013 - Bizagi

getActivitiesAsString: Puede ser usada para obtener un listado de todas las actividades sin completar (pendientes, suspendidas o inactivas). Enva y recibe un string XML. getApplications: Obtiene todas las aplicaciones disponibles en Bizagi; no tiene parmetros de entrada. getCasesAsString: Obtiene informacin de los casos basado en algunos filtros incluidos en un XmlDocument con formato string, la respuesta tambin tiene este mimo tipo de dato. getCategoriesAsString: Retorna las categoras dentro de una aplicacin dada. Enva y recibe un XML con formato string. getCategoriesFromApplicationName: Retorna las categoras dentro de una aplicacin dada. Este mtodo enva un string y recibe un XML con formato XmlDocument. getClosedActivitiesAsString: Obtiene un listado de todas las actividades completadas. El XML de envo y recepcin se encuentra en formato string XML. getEventsAsString: Retorna todos los eventos intermedios disponibles en un proceso, usando XMLs con formato string. getWorkflowClassesAsString: Obtiene informacin acerca de los procesos dentro de una categora. Este mtodo enva y recibe un string XML. getWorkflowClassesFromCategoryName: Este mtodo retorna los procesos dentro de una categora dada. Este mtodo enva un string y recibe un XML con formato XmlDocument. perfomActivityAsString: Este mtodo se utiliza para avanzar o continuar una actividad manual (como si se presionara el botn siguiente). Los parmetros de entrada y salida para este mtodo son del tipo string XML. resumeCasesAsString: Cuando uno o varios casos han sido suspendidos, este mtodo se usa para continuarlos. Enva y recibe un XML con formato string. saveActivityAsString: Este mtodo se usa para simular el evento salvar o guardar en actividades manuales. Enva y recibe un string XML. setEventAsString: Use este mtodo para avanzar un evento intermedio, usando XMLs con formato string. assignActivityAsString: Asigna/reasigna la actividad de un caso a un usuario especfico. Este mtodo enva y recibe un string con formato XML.

Nota: En los servicios web SOAP, usted puede encontrar algunos mtodos que no estn documentados aqu. Estos mtodos web son obsoletos. Los mtodos obsoletos son sustituidos por otra funcionalidad y se debe evitar su uso (usted solo debera continuar usndolos para compatibilidad hacia atrs).

Mtodos para Manejar el Modelo de Datos (Entity Manager)

El Servicio Web En tity M an ag erSO A .asm x ?w sd l ofrece los siguientes mtodos: getCaseDataUsingSchemaAsString: Obtiene toda la informacin del caso. Los parmetros de este mtodo son el idCase y un XSD con formato string XML. getCaseDataUsingSchemaLiteAsString: Obtiene toda la informacin del caso. Los parmetros de este mtodo son el idCase y un XSD con formato string XML. La respuesta a este mtodo no incluye el contenido de los atributos tipo of archivo. getCaseDataUsingXPathsAsString: Obtiene toda la informacin del caso. El parmetro de este mtodo es un String Xml con los XPaths de Bizagi deseados. getEntitiesAsString: Obtiene la informacin de una entidad en formato string XML. getEntitiesUsingSchemaAsString: Obtiene la Informacin de una entidad (o entidades), especificando la informacin requerida en un XSD, en formato string XML.

Copyright 2013 - Bizagi

1555

getEntitySchemaStr: Extrae el esquema de una entidad en un string Xml usando el nombre de la entidad. saveEntityAsString: Este mtodo se utiliza para almacenar y actualizar informacin en Bizagi usando un string Xml. saveEntityWithKeyAsString: Mtodo utilizado para actualizar una entidad. Los parmetros de este mtodo son: un XML en formato string con la informacin y la llave de la entidad.

Nota: En los servicios web SOAP, usted puede encontrar algunos mtodos que no estn documentados aqu. Estos mtodos web son obsoletos. Los mtodos obsoletos son sustituidos por otra funcionalidad y se debe evitar su uso (usted solo debera continuar usndolos para compatibilidad hacia atrs).

Mtodos para Ejecutar Reportes

El servicio web QuerySOA.asmx?wsdl ofrece los siguiente mtodos: QueryCasesAsString: Ejecuta una bsqueda usando una forma de consulta de aplicacin para obtener informacin de casos. Este mtodo enva y recibe una cadena con formato XML (string). QueryEntitiesAsString: Ejecuta una bsqueda usando una forma de consulta de entidad para obtener informacin al nivel de dicha entidad. Este mtodo enva y recibe una cadena con formato XML (string).

Mtodos para manejar la Metadata de las Formas

El servicio web Ren d erSO A .asm x ?w sd l ofrece los siguientes mtodos: GetActivityForm: Retorna las formas de una actividad o evento (pendiente) en un caso. GetFormById: Obtiene una forma particular dado su nmero de identificacin. GetQueryForms: Este mtodo se usa para obtener las formas de Consulta asociadas a un proceso. GetSummaryForms: Con este mtodo es posible obtener la Forma de Resumen de un caso. 3.8.3.1 URL de la Capa SOA y consideraciones

Informacin General
Cada proyecto en Bizagi posee servicios web SOAP construidos para exponer la funcionalidad de los Procesos a integracin con aplicaciones externas. La Capa SOA de Bizagi cumple con el estndar SOAP. Estos servicios Web en la Capa SOA de Bizagi ya estn publicados en el Portal de Trabajo (accesible a travs de un browser). Su URL puede variar ligeramente de acuerdo al Servidor utilizado en el proyecto. Este artculo lista mayores detalles acerca de esto y algunas consideraciones para interoperabilidad de servicios web entre diferentes plataformas de tecnologa.

1. URL de la Capa SOA

Los servicios Web en la capa SOA de Bizagi estan publicados bajo la URL htto dscrita en las siguientes

1556

Copyright 2013 - Bizagi

secciones.

Para Bizagi Enterprise .NET y Bizagi Xpress

En los proyectos Bizagi que utilicen Microsoft IIS (en soluciones .Net desde Bizagi Entreprise .NET o Bizagi Xpress), los servicios web de la Capa SOA se encuentran en: http://[nombre_servidor]/[proyecto]/WebServices/[componente_interno].asmx? wsdl Observe que: [nombre_servidor] es el nombre del servidor de su proyecto. [proyecto] es el nombre de su proyecto Bizagi. [componente_interno] es el nombre del componente interno de Bizagi. Hay cuatro servicios web posibles: EntityManagerSOA, WorkflowEngineSOA, QuerySOA and RenderSOA. Ejemplo: h ttp ://lo calh o st/Cred itA p p licatio n /W eb Serv ices/En tity M an ag erSO A .asm x ?w sd l

Para Bizagi Enterprise JEE

En proyectos Bizagi que utilicen Bizagi Enterprise JEE, los servicios web de la Capa SOA se encuentran como se indica a continuacin: En Servidores de Aplicaciones Weblogic y JBoss: http://[nombre_servidor]:[puerto]/Bizagi-war/WebServices/ [componente_interno]?wsdl En WebSphere: http://[nombre_servidor]:[puerto]/Bizagi-war/[componente_interno] ImplService/[componente_interno]ImplService.wsdl Observe que: [nombre_servidor] es el nombre del servidor de su proyecto. [puerto] es el nmero de puerto donde sube la aplicacin en el Servidor de Aplicaciones JEE. [componente_interno] es el nombre del componente interno de Bizagi. Hay cuatro servicios web posibles: EntityManagerSOA, WorkflowEngineSOA, QuerySOA and RenderSOA. Ejemplo: h ttp ://lo calh o st:8080/B izag i-w ar/W eb Serv ices/En tity M an ag erSO A ?w sd l

2. Mtodos web disponibles

Los mtodos web disponibles para los Proceso Bizagi reciben un string en formato XML como parmetro de entrada. Estos mtodos son los mismos para todas las ediciones de Bizagi. Esto significa que en la edicin Biagi Enterprise JEE, Bizagi Enterprise.NET y Bizzagi Xpress, lo mtodos de Capa SOA son aquellos que poseen la terminacin " A sStrin g" en su nombre (tales como createCasesAsString, getEntitiesAsString, queryCasesAsString, performActivityAsString,

Copyright 2013 - Bizagi

1557

saveEntityAsString, etc). Adicionalmente, para Procesos Bizagi en plataformas .NET (Bizagi Enterprise .NET and Bizagi Xpress) los mtodos web de la Capa SOA de Bizagi tambin estn disponibles recibiendo un documento XML como parmetro de entrada (tales como createCases, getEntities, queryCases, performActivity, saveEntity, etc). Este parmetro de entrada es del tipo clase XMLDocument (nartivo en .NET)

3. Incluir un nodo raz

Cuando se enva una informacin XML a Bizagi via servicios web (ya sea invocando mtodos web de Bizagi SOA, o recibiendo informacin de respuesta actualizada desde una invocacin), el XML resultante y su transformacin siempre deberan considerar un nodo raz. Lo mismo es vlido para las mejores prcticas, en las cuales los archivos XML correctamente estructurados contienen un nodo raz. En Bizagi, los ms frecuentes son < En tities> o < B izA g iW SResp o n se>, o la Entidad de Aplicacin.

4. Usar CDATA
Mientras se utilizan los mtodos web de Bizagi (aquellos que reciben parmetros de entrada de tipo String o aquellos que reciben un XMLDocument), se recomienda utilizar el elemento CDA TA para cualquier string contenido en el XML. Esto aplica para todas las ediciones de Bizagi y asegura que cualquier caracter especial XML (como apstrofe, comilla doble, ampersand, menor y mayor que, etc) se reciben de manera correcta por un servicio Web de acuerdo a las mejores prcticas del estndar XML. El siguiente ejemplo muestra el uso del elemento CDATA en una invocacin g etA ctiv itiesA sStrin g: <![CDATA[<BizAgiWSParam><domain>domain</domain><userName>admon</ userName><BizAgiWSParam>]]> El siguiente ejemplo muestra el uso del elemento CDATA en una invocacin g etEn tities : <BizAgiWSParam><EntityData><EntityName>Customer</EntityName><Filters><! [CDATA[ Active=1 ]]></Filters> </EntityData><BizAgiWSParam> Nota Tenga en cuenta que hay clientes de SOAP que requieren el uso de CDATA u otros tratamientos especiales en la manera de enviar la informacin, como por ejemplo, SOAP UI. Por lo tanto, consulte la documentacin de esos clientes en particular si requieren un manejo especial.

6. Manejar archivos adjuntos

Cuando se enven archivos adjuntos a un mtodo Web de Capa SOA de Bizagi o se reciban archivos desde una respuesta de un mtodoweb de Capa SOA de Bizagi, tenga en cuenta que el adjunto se enva y recibe como un String codificado en base64.

1558

Copyright 2013 - Bizagi

Para ver un ejemplo de cmo envar adjunos a Procesos Bizagi desde una aplicacin externa, consulte Cargar archivos utilizando capa SOA.

5. Usar Fechas
Cuando se enven e incluyan fechas en un XML, se requiere utilizar el formato de fecha estndar para informacin XML, el cual es: YYYY-MM-DDTHH:mm:ss

7. Usar clientes basados en Java para invocar la Capa SOA en un ambiente .NET
En cualquier momento que se utilice un cliente Java para consumir servicios web de Bizagi, se requiere estrictamente que su URL referenciada tenga la terminacin ?w sd l. Por ejemplo, si los Procesos Bizagi se ejecutan en una plataforma .NET (Utilizando Bizagi Enterprise .NET o ediciones Bizagi Xpress), los servicios web de esos Procesos see acceden a travs del navegador como: http://[Server_name]/[Bizagi_project]/webservices/WorkflowEngineSOA.asmx Cuando utilice un cliente Java para invocar estos mtodos, se deberia referenciar explicitamente la terminacin ?w sd l: http://[Server_name]/[Bizagi_project]/webservices/WorkflowEngineSOA.asmx? wsdl

8. Seguridad y autenticacin
La Capa SOA de Bizagi y sus servicios web se publican por defecto sin restricciones. Como una buena prctica y dentro de la administracin de su ambiente de produccin, usted debera configurar seguridad adecuada para invocar estos servicios web (de manera que las cuentas autenticadas en realidad puedan acceder a los servicios web). Por ejemplo, usted necesitara configurar una autenticacin HTTP a nivel del servidor BPM. Esto se hara en el IIS (para ediciones Bizagi Enterprise .NET y Bizagi Xpress), o en el mismo servidor de Aplicacin JEE (para ediciones Bizagi Enterprise JEE ). 3.8.3.2 Esquemas del modelo de datos de Bizagi XML

Informacin General
En todo proyecto Bizagi es posible generar definiciones de esquema XML (XSDs) para una entidad. Esta funcionalidad que genera esquemas XML o transformaciones es especialmente poderosa para propsitos de integracin.

Copyright 2013 - Bizagi

1559

El esquema XML describe la estructura de un documento XML. En si resulta valiosa cuando se esta aprendiendo acerca de la estructura XML esperada por los Procesos, mientras se invoca la Capa SOA de Bizagi desde una aplicacin externa, o cuando se utiliza su definicin (junto con archivos de transformacin) desde reglas de negocio para obtener o actualizar informacin de los Procesos.

Generar XSD
La generacin de esquemas XML para un modelo de datos de Bizagi (cualquier entidad o modelo de datos de Proceso) tambin es beneficioso cuando se invoca la Capa SOA de Bizagi, para conocer la estructura esperada del modelo de datos en la configuracin de la invocacin (por ejemplo, cuando se crea un caso desde una aplicacin externa). Para generar un XSD siga los pasos que se describen a continuacin: 1. En la vista de Mdulos, seleccione Entidades en el men Bizagi y d clic derecho en la entidad para la cual desea generar un esquema. Observe que para utilizar la Capa SOA usted debera seleccionar una entidad de Aplicacin en vez de una entidad Maestra. Seleccionar Esq u em as XM L.

1560

Copyright 2013 - Bizagi

2. En la ventana de esquemas XML de la entidad, d clic en el botn Gen erar para abir la ventana de Selecci n d e Dato s d el Esq u em a.

Copyright 2013 - Bizagi

1561

3. En esta ventana, seleccione toda la informacin que deba ser recuperada para insertar, actualizar o seleccionar. Observe que es posible seleccionar informacin en entidades relacionadas utilizando la navegacin de XPath, expandiendo los nodos asociados a las relaciones de entidad de nivel superior.

1562

Copyright 2013 - Bizagi

4. Una vez finalizado, d clic en O K. El XSD generado se mostrar. Este esquema representar la estructura del modelo de datos, tal como Bizagi lo espera, cuando se utilice la Capa SOA. Por defecto, el nombre del XSD ser el mismo de la entidad, pero se puede cambiar dando clic en el botn Ed itar ( o doble clic en el XSD).

Copyright 2013 - Bizagi

1563

Asociar XSL/XSLT
Las transformaciones (XSL/XSLT) pueden ser asociadas con XSDs para obtener una salida en un formato diferente al dado por Bizagi. La generacin de XSD y asociacin de XSLT se utilizan mas que todo en la configuracin de interfaces avanzadas (aquellas que no utilizan el asistente de interfaces sin que se configuran explicitamente en expresiones Bizagi). Para hacerlo, partimos de los pasos descritos en la seccin anterior (Generar un XSD). Tenga en cuenta que el archivo de transformacin necesita ser creado previamente y guardado en una carpeta locacl (crear un archivo de transformacin requiere un perfil tcnico, y hay muchas herramientas externas para asistir la creacin de este archivo). Para asociar una transformacin existente, se deben llevar a cabo los siguientes pasos: 1. Despus de generar un XSD, seleccionales y d clic en el botn A g reg ar.

1564

Copyright 2013 - Bizagi

2. Una nueva ventana se abrir para brinda la informacin bsica. Ingrese un nombre y descripcin. Para la Direccin, seleccione "Entrada" o "Salida" dependiendo del uso de la transformacin: Salida: Si va a transformar informacin obtenida desde el modelo de datos de Bizagi, de manera que pueda ser enviada a otra aplicacin o sistema. Entrada: Si va a transformar informacin obtenida desde otro sistema, la cual serpa actualizada en Bizagi. Luego, navegue en sus carpetas para seleccionar su archivo de transformacin (dando clic en Seleccio n ar A rch iv o ).

Copyright 2013 - Bizagi

1565

3. Finalmente d clic en O K para guardar. El archivo de transformacin asociado se mostrar:

1566

Copyright 2013 - Bizagi

Usar los XSDs y XSLTs generados

Como mencionamos anteriormente, los archivos de esquema XL so tiles para propsitos de integracin en los cuales una aplicacin externa invocar los mtodos de la Capa SOA de Bizagi. De esta manera, podemos reconocer cual es la estructura XML esperada por Bizagi. Los esquemas y transformaciones generadas a travs de esta funcionalidad en Bizagi, tambin se pude utilizar dentro de reglas de negocio. 3.8.3.3 Usando llaves de negocio en XMLs

Informacin General
La invocacin de mtodos web de la Capa SOA de Bizagi (para crear casos, avanzar actividades, actualizar informacin en el modelo de datos, etc) se hace tipicamente con el fin de encontrar registros para referenciar o actualizar sus valores. Para referecniar estos registros, utilizamos definiciones de llave de negocio para ciertas columnas de entidades (aquellas que identificn de manera nica los registros de la entidad). La llaves de negocio brindan a Bizagi mayor informacin acerca de los datos, dndole ms control sobre la informacin de negocio para validaciones y actualizaciones. Se pueden utilizar llaves de negocio de dos maneras: Definiendo en nuestro modelo de datos (en ambiente de desarrollo) los atributos que harn parte de las llaves de negocio en una entidad, o incluyendo una referencia explicita del atributo "businessKey" en el XML Para la primera forma de utilizacin de llaves de negocio, se requiere tener llaves de negocio ya definidas en sus entidades. Para mayor informacin acerca de llaves de negocio en entidades, consulte Llaves de negocio Para la segunda forma (cuando no hay definicin de llaves de negocio en las entidades), usted puede enviar la informacin de la llave de negocio directamente en el XML.

Utilizar las llaves predefinidas

Teniendo las llaves de negocio ya definidas en una entidad, no ser necesario preocuparnos de si el registro existe o no, cuando se enva un XML con informacin.

Ejemplo
En el siguiente ejemplo, partimos de llaves de negocio definidas para la entidad Cliente. Los datos se actualizarn para un cliente en respuesta a ciertas solicitudes hechas por un sistema externo. Si el cliente no existe, entonces se crear uno nuevo con la informacin suministrada por el sistema externo.

Copyright 2013 - Bizagi

1567

El XML inicia desde la entidad de aplicacin y va a travs de las relaciones hasta alcanzar la entidad a actualizar. Bizagi lee y entiende desde este XML, que debe actualizar un cliente con tipo de ID 01 y nmero de ID 1223334444. Si el registro existe, entonces se actualiza. De lo contrario, se crea. Es importante observar que los datos desde entidades relacionadas para las que se han definido llaves de negocio, deben existir nicamente en aquellas entidades. De lo contrario se lanzar un error. En este caso, el atributo Ty p eO fID relaciona al cliente con Id en tificatio n Ty p e, de manera qe se entiende que en la entidad Id en tificatio n Ty p e solo existe un registro con un cdigo = 01.

Especificar explicitamente las rllaves de negocio en el XML

Cuando no se han configurado llaves de negocio en las propiedades avanzadas de las entidades, usted puede incluir el atributo llave de negocio explicitamente en el XML enviado. Las llaves de negocio predefinidas sobre entidades surgen desde la necesidad de trabajar con informacin controlada dentro del negocio, como: cdigos, nmeros de serie, nmeros de identificacin, etc (y no con las llaves sustitutas o IDs generados de las entidades Bizagi). Si esta definicin no se incluye en las entidades, deber ser especificada dentro del XML.

Ejemplo
Por ejemplo, si un cliente fuera buscado nicamente por su Id N u m b er , se utilizara el siguiente XML:

1568

Copyright 2013 - Bizagi

La llave de negocio y su valor debe ser especificado en el atributo b u sin essKey de manera que Bizagi filtre y encuentre el registro dado. Tambin es necesario incluirlo como un nodo hijo en el Cliente, si se requiere una actualizacin de su informacin.

3.9

Asignacin de trabajo
La asignacin de trabajo es el quinto paso del Asistente de Procesos, donde se definen los participantes para cada actividad del proceso. Los participantes son los usuarios que cumplen con las cualidades para ser asignados a las actividades. Cada tarea creada para la interaccin con usuarios finales requiere una definicin que permita a Bizagi asignar los usuarios correctos. Bizagi evala automticamente las reglas de asignacin definidas para cada tarea y selecciona uno o ms usuarios que cumplan con las condiciones dadas de la lista del usuario. Slo los usuarios elegidos tendrn acceso a trabajar sobre la actividad asignada. Para asignar los participantes es necesario tener una cuenta de usuario creada para todos los aquellos que deban trabajar con Bizagi. Es importante que cada cuenta de usuario est configurada correctamente para garantizar que Bizagi seleccione adecuadamente. Tenga en cuenta que si no hay reglas de asignacin en una tarea sta ser ejecutada por el usuario que realiz la ltima tarea. Puede configurar esta potente caracterstica basndose en diferentes criterios, como la posicin, la ubicacin geogrfica, los roles, entre otros. Bizagi equilibra la carga de trabajo entre los recursos disponibles para aumentar an ms la productividad. Tambin puede definir mtodos de distribucin para adaptarse a sus necesidades particulares

Copyright 2013 - Bizagi

1569

En el Asistente de Procesos, haga clic en la opcin de Participantes. El flujo del proceso se abrir. Las diferentes actividades que se encuentran disponibles para asignacin se resaltarn. Las actividades en las que los participantes no se han definidos tienen un signo de exclamacin. Slo las Actividades y Eventos que interactan con los usuarios finales estarn disponibles para asignacin. Esto significa que las actividades automticas como las tareas de Script, las Compuertas o Eventos de fin no se pueden seleccionar para definir reglas de asignacin. Las asignaciones deben definirse por separado para cada actividad y evento.

1570

Copyright 2013 - Bizagi

3.9.1

Componentes de la asignacin de trabajo

Una vez que la Actividad o Evento es seleccionado, la ventana Asignacin se mostrar en pantalla. En esta ventana se puede configurar la asignacin de acuerdo a tres tipos de condiciones: reg las d e asig n aci n , m to d o d e asig n aci n y las p reco n d icio n es.

Reglas de asignacin
Determina el usuario especfico o usuarios que deben llevar a cabo la actividad. Para definir las reglas de asignacin, haga clic en A d icio n ar co n d ici n .

Las reglas de asignacin son construidas por operandos y operadores como se muestra en la siguiente imagen:

Copyright 2013 - Bizagi

1571

Propiedades de usuario
Las propiedades de usuario son un conjunto de caractersticas de los usuarios, como nombre, e-mail, jefe, etc Algunas propiedades del usuario se define por defecto, pero se pueden crear propiedades de usuario adicionales de acuerdo a las necesidades de su negocio. Haga clic para obtener ms informacin acerca de las propiedades del usuario. Las propiedades definidas por defecto son: Id de Usuario: identificacin en la base de datos de un usuario especfico. rea: rea del usuario en una organizacin Lugar: ubicacin geogrfica. Define oficinas o sucursales. En Bizagi, un usuario slo puede pertenecer a un solo lugar. Rol: Rol llevado a cabo por una persona en la organizacin. En Bizagi, un usuario puede tener uno o ms roles. Habilidad: Habilidad o aptitud para una accin. En Bizagi, un usuario puede tener una o ms habilidades. Cargo: estructura organizativa. Indica las posiciones y su cadena de mando.

Operador de Comparacin
El Operador de Comparacin permite comparar la propiedad de usuario con un valor especfico. Puede seleccionar entre Ig u al a o Diferen te a.

Tipo de Valor
Especifica la fuente de donde se obtendr el valor de la condicin: Expresin: permite definir una regla de negocio. Se puede crear una expresin o seleccionar una existente. Entre las existentes se encuentra el conjunto de las expresiones por defecto definidas por Bizagi. Expresin est disponible para Propiedades de Usuario, tales como Id de Usuario. Las Expresiones por defecto para Id de Usuario son: o Asignado acutal: Devuelve el usuario que se encuentra trabajando en el caso. o Jefe del asignado: Devuelve el jefe del usuario que actualmente trabajan en el caso. Esta expresin tiene variaciones como CurrentAssigneeBoss_Level2, etc CurrentAssigneeBoss_Level3 para acceder a los diferentes niveles jerrquicos. o Creador de caso: Devuelve el usuario que cre el caso.

1572

Copyright 2013 - Bizagi

Datos: Permite seleccionar un atributo en el modelo de datos de proceso. Valor de entidad: Permite seleccionar el valor de una lista de valores que se muestran para la Entidad de parmetros.

Valor
Es el valor de la condicin de asignacin. Este valor se establece de acuerdo con el Tipo de Valor seleccionado. Puede definir una o ms condiciones por medio de los operadores y / o.

Mtodo de Asignacin
Proporciona un conjunto de funciones para seleccionar el modo en el que Bizagi asigna una tarea a los usuarios disponibles. Las cuatro opciones son: Por Carga: La tarea se asigna al usuario con menor carga de trabajo en su Inbox. Sin embargo, el sistema verifica primero si alguien en el grupo del usuario ya ha trabajado en el caso. Si es as, se asignar a l / ella independientemente de la carga de trabajo del usuario en comparacin con el resto del grupo. Todos: Las asignaciones se otorgan a todos los usuarios que cumplen con las caractersticas indicadas. La primera persona que acceda al caso desde su Onboxo (es decir, haga clic sobre el caso) llevar a cabo la tarea. En consecuencia, ya no se mostrar a los dems asignados. Secuencial: cada tarea se le asigna equitativamente y de forma secuencial entre los usuarios que cumplan los criterios de asignacin, independientemente de su carga de trabajo. Sin embargo, si se crea una instancia de una tarea varias veces, esta tarea se le asignar al mismo usuario que la realiz por primera vez, y el mtodo de asignacin no aplicara en este caso.

Copyright 2013 - Bizagi

1573

Primer disponible: Con este mtodo, las tareas se asignan al usuario que primero esta disponible de acuerdo con la zona horaria asociada. Puede haber ms de un usuario disponible. En tales casos, Bizagi determinar la tarea ejecutante mediante la evaluacin de la carga de trabajo de cada usuario disponible.

Mtodo de Asignacin en Eventos

El evento no tiene un mtodo de Asignacin. El mtodo ser, por defecto, a To d o s.

Precondiciones
Permite la realizacin de asignaciones basada en reglas de negocio que evalan una condicin y retornan verdadero o falso, indicando si la condicin aplica al perfil definido, o no. En otras palabras, una precondicin permite a un usuario establecer reglas con el fin de decidir qu regla de asignacin de seguir. Las precondiciones se activan marcando la casilla Usar p reco n d icio n es. Cada pestaa representa una precondicin y contiene su propia regla de asignacin y mtodo de asignacin. De esta manera una asignacin se puede realizar mediante una combinacin de reglas de asignacin y los mtodos de asignacin de acuerdo con las condiciones del negocio.

1574

Copyright 2013 - Bizagi

Las precondiciones son definidas por las expresiones que se configuran haciendo clic en la opcin Seleccio n ar ex p resi n . Puede definir expresiones booleanas o de scripting de acuerdo a sus necesidades.

3.9.2

Asignaciones de trabajo bsicas

En esta seccin se ilustra cmo establecer reglas bsicas de asignacin (sin usar precondiciones). Haremos uso del proceso de Solicitud de Vacaciones. En este proceso el empleado ingresa una solicitud de vacaciones que debe ser aprobada por su jefe. una vez aprobada, debe ser registrada en el sistema de nmina de la empresa. La siguiente imagen muestra el flujo del proceso:

Copyright 2013 - Bizagi

1575

Vamos a establecer las siguientes configuraciones: Asigne la el Registro de solicitud a la persona que cre el caso. Asigne la Aprobacin de la solicitud al Jefe de la persona que cre el caso. Asigne la actividad de actualizacin del sistema de nmina a un auxiliar administrativo Para ello, siga los siguientes pasos: 1. Vaya al paso quinto del Asistente de Procesos, Participantes, y haga clic en Defin ir P articip an tes.

2. Seleccione la actividad deseada para definir sus participantes.

1576

Copyright 2013 - Bizagi

3. Una vez que la actividad se ha seleccionado, la ventana de asignacin se abrir. Haga clic en A g reg ar co n d ici n para incluir una condicin donde seleccionaremos las propiedades que el usuario debe cumplir para ser asignado.

La actividad Registrar solicitud de licencia se va a asignar al creador caso. Seleccione Id Usu ario de la lista de propiedades del usuario.

Copyright 2013 - Bizagi

1577

La propiedad del usuario se comparar con una expresin que establece el ID de creador caso. Seleccione Es ig u al en el campo del comparador y de Ex p resi n como Valor.

Haga clic en seleccionar Expresin. El editor de expresiones se abrir, aqu se puede crear una regla de negocio.

1578

Copyright 2013 - Bizagi

Usaremos una de las reglas de negocio que Bizagi provee por defecto. Haga clic en Cancelar en el editor de expresiones. Una nueva ventana aparecer para elegir las reglas de negocio predefinidas y reutilizables. Seleccione la expresin Case Creato r y haga clic en A cep tar.

Copyright 2013 - Bizagi

1579

4. Para la Aprobacin de la solicitd repita el mismo procedimiento estipulado anteriormente pero en este caso, seleccione la regla Cu rren tA ssig n eeB o ss.

Nota: Las reglas Cu rren tA ssig n eB o ss y sus similares slo funcionar si el usuario Jefe ha sido configurado para los usuarios en la Administracin de Usuarios en el Portal de Trabajo. De lo contrario, las actividades que utilizan estas expresiones se asignarn al usuario previamente asignado. 5. Para la actividad de actualizacin del sistema de nmina vamos a asignar esta tarea basados en la posicin del participante. Seleccione Carg o de la lista de propiedades de usuario.

1580

Copyright 2013 - Bizagi

Seleccione Es ig u al en el campo de comparador y Valo r d e la En tid ad en el campo de Valo r. Aqu el valor de la entidad es una posicin dentro de la organizacin. Seleccione A sisten te A d m in istrativ a de los valores de posicin de la entidad Organizacin.

En el caso de que los valores de la entidad no se han definido, se puede asignar un nuevo valor haciendo clic en el enlace N u ev o . Sin embargo es muy recomendable definir su estructura organizacional en primer lugar. Para obtener ms informacin acerca de cmo administrar las organizaciones consulte Organizaciones.

Copyright 2013 - Bizagi

1581

6. Seleccione el Mtodo de Asignacin. Para el Registro, y la aprobacin el mtodo de asignacin no es pertinente, porque slo habr un usuario que cumpla con las reglas de asignacin. Para la actividad de Actualizacin del sistema de nmina seleccione P o r carg a. Esto significa que la actividad se le asignar el auxiliar administrativo con la menor carga de trabajo. Por ltimo, haga clic en A cep tar.

Las actividades han sido configuradas. Tenga en cuenta que ninguna tiene el signo de exclamacin.

3.9.3

Asigancin de tareas utilizando pre condiciones

Usaremos el proceso de Mesa de Ayuda para demostrar cmo utilizar precondiciones para asignar participantes al proceso.

1582

Copyright 2013 - Bizagi

Tenga en cuenta que las condiciones DEBEN SER mutuamente excluyentes El proceso de Mesa de Ayuda maneja informes de incidentes a fin de reducir al mnimo las interrupciones en los servicios de Tecnologa de una organizacin. Un reporte de incidente tiene un tipo y una prioridad. El tipo clasifica el informe de acuerdo con el componente afectado y la prioridad mide el grado de importancia con la que debe ser tratado. La actividad A ssist Rep o rt se asigna con base a estos atributos.

Dependiendo de la prioridad, la tarea A ssist Rep o rt ser realizada por un miembro de un grupo especfico: Nivel 1 el grupo de apoyo resuelve incidentes con prioridad media o baja Nivel 2 el grupo de apoyo resuelve incidentes de alta prioridad. La prioridad ser la precondicin para identificar qu grupo de apoyo se debe asignar. Para configurar la asignacin anterior descrito seguir los siguientes pasos: 1. Vaya al paso quinto del Asistente de Proceso y haga clic en Defin ir P articip an tes.

Copyright 2013 - Bizagi

1583

2. Seleccione la actividad deseada para definir sus participantes. En este caso, seleccione A ssist Rep o rt.

3. Una vez ha seleccionado la actividad, la ventana de participantes se desplegar. Marque la casilla Usar p reco n d icio n es con el fin de activar el botn A d icio n ar P reco n d ici n .

1584

Copyright 2013 - Bizagi

4. Haga clic en el enlace Seleccio n ar Ex p resi n . El Administrador de Expresiones se abrir.

5. Seleccione la opcin: Siempre para asegurar que esta opcin se tome siempre y se ejecute la regla de asignacin. Sino, para tener una asignacin por defecto en caso de que ninguna precondicin se cumpla. Basado en el resultado de una expresin, para usar una expresin. 6. Seleccione Basado en el resultado de una expresin. El editor de expresiones Booleanas se abrir.

Copyright 2013 - Bizagi

1585

5. Configure la precondicin. En este caso, la condicin est relacionada con los valores de la entidad paramtrica de Prioridad. Para la primera condicin se evaluar si la prioridad tiene un valor bajo o medio. Arrastre y suelte el XPath que navega a la prioridad del incidente. A continuacin, seleccione los valores de baja y media. Por ltimo, seleccione el operador O R para que, si cualquiera de las dos condiciones se cumple, la regla booleana retornar verdadero..

6. Haga clic en F in alizar. Ingrese un nombre para la expresin, en este caso ser P rio rid ad M ed ia y B aja.

1586

Copyright 2013 - Bizagi

7. Defina la regla de asignacin. Podemos identificar a qu grupo pertenece un usuario de apoyo a travs de una funcin. Haga clic en A g reg ar co n d ici n . Una nueva ventana aparecer.

La asignacin de esta tarea se basa en el rol del participante. Seleccione Rol de la lista de propiedades de usuario.

Copyright 2013 - Bizagi

1587

Seleccione Es ig u al en el campo de comparacin y Valo r d e En tid ad en el campo Valor. Aqu el valor de la entidad es un Rol dentro de la organizacin. Seleccione M iem b ro N iv el 1 de la lista del campo Valor.

Si el Rol no se ha creado, puede crearlo haciendo clic en el enlace N u ev o . Sin embargo es muy recomendable definir su estructura organizacional ANTES. Para obtener ms informacin acerca de cmo administrar su Organizacin consulte a las Organizaciones.

8. Seleccione P o r Carg a de la lista Mtodo de Asignacin. Esto significa que la actividad se le asignar al Miembro Nivel 1 que tenga la menor carga de trabajo. Por ltimo, haga clic en Aceptar.

1588

Copyright 2013 - Bizagi

9. Para la segunda condicin se evaluar si la prioridad es alta. Tenga en cuenta que las condiciones DEBEN SER mutuamente excluyentes. Para este caso la prioridad es alta o es baja/media. Asegrese de que sus condiciones sean siempre mutuamente excluyentes y que siempre alguna de ellas retorne Verdadero. Haga clic en el botn A ad ir p reco n d ici n . Una nueva pestaa, se crear.

10. Repita el procedimiento seguido para la primera condicin. Defina la condicin de la comparacin con la entidad Prioridad, escogiendo nivel alto. Esta expresin se llamar A lta p rio rid ad.

Copyright 2013 - Bizagi

1589

11. La regla de asignacin para esta condicin es similar a la anterior. La nica diferencia es que ahora seleccionamos el M iem b ro N iv el 2 como Rol.

12. Por ltimo, seleccione P o r Carg a de la lista Mtodo de Asignacin. Note cmo las precondiciones estn creadas, son mutuamente excluyentes y tienen sus reglas de asignacin..

1590

Copyright 2013 - Bizagi

Nota: Es necesario que al menos un usuario final tenga la propiedad de usuario (en este caso el Rol) escogido en las reglas de asignacin. Si Si no hay usuarios que cumplan las condicioens, las actividades que utilizan estas asignaciones sern asignadas a el usuario predeterminado. Asegurese que los roles se asignan a los usuarios correctos en el men Administracin de usuarios en el Portal de Trabajo.

3.9.4

Cuando ningun usuario cumple las condiciones de asignacin

Hay momentos en que las condiciones establecidas en las reglas de asignacin no se cumplen para ningn usuario. Por ejemplo, todos los usuarios con un determinado rol o posicin no estn habilitados para la asignacin o no hay usuarios asignados a una propiedad especfica. Cuando los usuarios habilitados no cumplen con las condiciones de asignacin, Bizagi realiza lo siguiente: En primer lugar, evala si existe un Usuario predeterminado definido, y asigna la tarea o evento a este usuario. Si no se ha establecido un Usuario predeterminado, la tarea o evento ser asignada a todos los usuarios definidos en el grupo Default A ssig n atio n User, en el m+odulo de Organizacin de Bizagi Studio. Si no hay usuarios en el grupo A ssig n atio n User la tarea ser realizada por el usuario que realiz la ltima actividad. Es muy recomendable configurar un Usuario predeterminado y un Grupo de Asignacin de usuario () Default assignation users).

Configurar el usuario predeterminado

Copyright 2013 - Bizagi 1591

En el Portal de Trabajo haga clic en A d m in . A continuacin, seleccione A d m in istrar asig n aci n d e u su ario p red eterm in ad o .

El usuario predeterminado se pueden definir para un nico proceso, para varios procesos o para toda la aplicacin. 1. Haga clic sobre el proceso de seleccin. A continuacin, seleccione To d as las A p licacio n es para seleccionar un usuario por defecto para todas las aplicaciones creadas.

1592

Copyright 2013 - Bizagi

2. Para seleccionar un usuario para una Aplicacin en particular, haga clic en Seleccio n ar ap licaci n (1) y luego seleccione la aplicacin especfica (2).

3. Para elegir un usuario predeterminado por proceso, haga clic en el nombre de la aplicacin y seleccionar el proceso deseado (3, 4). .

Copyright 2013 - Bizagi

1593

4. Cuando la aplicacin o proceso est seleccionado, haga clic en el botn N u ev o Usu ario , y busque el usuario que se establecer como el usuario predeterminado. Haga clic en Gu ard ar cuando haya terminado.

Configurar el Grupo Assignation Group)

de

Asignacin

por

defecto

(Default

El Grupo de Asignacin por defecto es un grupo de personas que han sido designados como participantes de las actividades donde las reglas de asignacin no se cumplen y por lo tanto no hay nadie para ejecutarlas. 1. Para definir el Grupo de Asignacin por defecto, vaya a Bizagi Studio y seleccione O rg an izaci n . A continuacin, seleccione los Gru p o s d e u su ario s.

1594

Copyright 2013 - Bizagi

2. Haga clic derecho sobre Grupo de Asignacin por defecto y seleccione P ro p ied ad es. Este grupo se crea de forma predeterminada. Haga clic aqu para obtener informacin sobre cmo crear grupos de usuarios.

3. La posicin del Administrador est seleccionada por defecto en este grupo. Haga clic en el botn A g reg ar o Q u itar para modificar los usuarios incluidos.

Copyright 2013 - Bizagi

1595

4. Agregue propiedades de usuario adicionales para incluir a los nuevos usuarios que cumplan con las condiciones. Especifique rol, habilidad, posicin, ubicacin de los nuevos miembros.

5. Seleccione la opcin de N eg o cio s de la pestaa de Co n fig u raci n .

1596

Copyright 2013 - Bizagi

6. Seleccione la seccin A v an zad o y luego asignar al Gru p o d e Usu ario s p o r d efecto , el grupo creado. Puede asignar este grupo o cualquier grupo creado previamente.

3.9.5

Ignorar las reglas de asignacin

Con el fin de llevar a cabo pruebas unitarias en el entorno de desarrollo, usualmente existe la necesidad de concentrarse en el flujo, sin necesidad de utilizar las reglas de asignacin. Para ello, Bizagi tiene una propiedad que se puede activar para que un usuario inicie sesin y cree casos que

Copyright 2013 - Bizagi

1597

ignoren las reglas de asignacin. El usuario Administrador tiene esta opcin habilitada por defecto. Se recomienda mantener el valor por defecto para este usuario. Para configurar los usuarios que pueden ignorar las reglas de asignacin, en el Portal de Trabajo, vaya a la Administracin de Usuarios (Admin - Usuarios).

En la tercera pestaa, habilite la opcin: O m itir reg las d e asig n aci n en lo s caso s cread o s p o r este u su ario . Por ltimo, haga clic en A ctu alizar.

1598

Copyright 2013 - Bizagi

3.9.6

Reasignar trabajo

Vista General
En muchas situaciones puede ser necesario que usuarios, que no son administradores Bizagi o de Proceso, estn en capacidad de reasignar una tarea especfica con el fin de cumplir con requerimientos de negocio. Por ejemplo, en un proceso de Mesa de ayuda donde se reciben, analizan y resuelven tickets de soporte, el tcnico encargado de la resolucin de este podra considerar, despus de analizar la situacin, que debe ser atendido por otra persona con habilidades, nivel de conocimiento o nivel o la autoridad diferentes a las de l. Estas condiciones de negocio se conocen como reasig n aci n (asignacin a otra persona con nivel de autoridad igual o inferior) y escalam ien to (asignacin a una persona con un nivel ms alto de autoridad) y son muy comunes en este tipo de procesos. Un administrador de Bizagi o de Proceso puede fcilmente reasignar un caso a travs de las opciones de Administracin del Portal de Trabajo. Sin embargo, debido a que los tcnicos no son necesariamente administradores de Bizagi o de Proceso, podemos utilizar la opcin de Reasig n aci n a nivel de tareas, la cul ofrece una manera gil de reasignar o escalar el trabajo. Una vez configurada esta opcin, el usuario que trabaja en una tarea habilitada para reasignacin ver un nuevo icono en la esquina inferior izquierda del Portal de Trabajo.

Copyright 2013 - Bizagi

1599

Una vez damos clic sobre l, se abrir una nueva ventana que permitir buscar al usuario a asignar, entre todos los usuarios de Bizagi.

Habilitar una tarea para reasignacin

Para activar la posibilidad de reasignacin para una tarea todo lo debe hacer es habilitar la propiedad Reasig n ar que se encuentra en las propiedades de la tareas. 1. En Bizagi Studio, vaya al primer paso del Asistente de Procesos y d clic en la opcin de Ed itar P ro ceso .

1600

Copyright 2013 - Bizagi

2. D clic derecho sobre la actividad a la cual se habilitar la reasignacin y seleccione la opcin P ro p ied ad es.

Copyright 2013 - Bizagi

1601

3. En las propiedades bsicas, busque y active la propiedad Reasig n ar.

1602

Copyright 2013 - Bizagi

4. Cierre el diagrama para guardar los cambios.

Reasignar una tarea

Una vez habilitada la propiedad Reasig n ar, el usuario asignado a la tarea podr reasignarla desde el Portal de Trabajo. 1. Vaya a la actividad habilitada para reasignacin y d clic en el icono Reasignar situado en la esquina inferior izquierda.

Copyright 2013 - Bizagi

1603

2. En la nueva ventana, busque el usuario al que se asignar la tarea mediante el uso de los criterios disponibles.

3. Una vez lo encuentre, d clic en el vnculo Reasig n ar que se encuentra a la izquierda del nombre del usuario.

1604

Copyright 2013 - Bizagi

4. Se mostrar un mensaje de confirmacin.

3.9.7

Organizacin
La Organizacin en Bizagi es una caracterstica donde usted puede definir la estructura jerrquica de su compaa y la asociacin entre las distintas personas o areas que la componen. Una Organizacin en Bizagi almacena la informacin relacionada, no solamente con la estructura organizacional de los miembros de una compaa y la definicin de sus caractersticas (posiciones, areas, grupos), sino tambin las caractersticas que los hacen nicos en un equipo y que les permiten ser miembros activos en los Procesos de una aplicacin o en aplicaciones (roles, habilidades, ubicacin geogrfica).

Copyright 2013 - Bizagi

1605

La definicin de una estructura organizacional es vital para la asignacin de tareas y la gestin de la seguridad. Como vimos en secciones previas, las asignaciones se hacen basadas en propiedades de usuario, que se definen en el mdulo de Organizacin. De igual manera, los permisos para crear y administrar un Proceso y sus componentes se conceden de acuerdo a dichas propiedades. En esta seccin mostraremos cmo configurar Organizaciones.

Componentes de la Organizacin
La definicin de la Organizacin se hace a travs de la configuracin de algunos componentes. Estos componentes definen las caractersticas para toda la Organizacin y los usuarios individuales.

Componentes de la estructura Organizacional

Estos componentes definen los principales atributos de su organizacin, permitiendole ubicar a los usuarios dentro de ella. reas: Departamentos de una organizacin. En Bizagi, un usuario puede pertenecer a un rea. Cargos: Indica las posiciones y su cadena de comando. En Bizagi, un usuario puede tener una o ms posiciones. Lugar: Ubicacin geogrfica. Esta seccin tambin define las oficinas o sucursales si aplica. En Bizagi, un usuario pertenece a un Lugar. Esquema de das no laborales: Contiene los calendarios de das laborales y no laborales que aplican a la Organizacin. Usted puede definir diferentes esquemas para ajustarse al hecho de que cada pas, regin o ciudad posee diferentes das no laborales. En Bizagi, una ubicacin geogrfica posee un Esquema de das no laborales.

1606

Copyright 2013 - Bizagi

Esquema de Horario de Trabajo: El Esquema de Horario de Trabajo hace referencia al horario de trabajo (de 8AM a 6PM y as sucesivamente). El vencimiento de los Procesos y tareas depende de este esquema. Este se denota con luces de semforo en el Portal de Trabajo y se utiliza para el clculo de los reportes de BAM y Anlisis. En BIzagi, es posible definir un Esquema de horario de trabajo para cada organizacin.

Componentes individuales del usuario

Estos componentes definen los principales atributos utilizados para describir caractersticas particulares de los usuarios. Roles: Conducta o papel que desempea una persona en la organizacin. En Bizagi, un usuario puede tener uno o ms roles. Habilidades: Capacidad o aptitud para una accin. Destrezas especiales de una persona que le permiten llevar a cabo una actividad. En Bizagi, un usuario puede tener una o ms habilidades. Propiedades de Usuario: Son un conjunto de caractersticas como Nombre, correo, jefe inmediato, etc. Es posible definir propiedades adicionales de los usuarios, que se requieran para los procesos, las asignaciones o simplemente como informacin adicional de los usuarios. Uso Horario (Time Zone): Se refiere a las 24 regiones principales del mundo que le permiten al usuario definir su HORA LOCAL de acuerdo a la posicin de la ciudad o pas donde ste se encuentre. Grupos de Usuario: perfiles de usuarios o un conjunto de caractersticas de un empleado de la organizacin que permiten definir niveles de acceso a aplicaciones y funcionalidades.

Configuracin de Usuario
Cuando los componentes de una Organizacin han sido definidos, usted debe asignar a cada usuario final sus caractersticas especficas. Estas configuraciones se ajustan a travs del Portal de Trabajo en la pestaas de O rg an izacio n es y Co n fig u raci n d e Usu ario del M en d e Usu ario s.

Copyright 2013 - Bizagi

1607

Para mayor informacin acerca de cmo crear usuarios en Bizagi y cmo asignar componentes de organizacin a usaurios, consulte Administracin de Usuarios. 3.9.7.1 Crear una organizacin Esta seccin brinda la informacin necesaria para crear y modificar cada uno de los elementos que componen la Organizacin y la asociacin de su relacin en las Actividades del Proceso. Para mostrarle cmo crear una Organizacin en Bizagi, utilizaremos la siguiente estructura organizacional:

Esta estructura se compone de cuatro reas y nueve cargos. Las reas se representan con cuadrados azules y los cargos con cuadrados plateados.

Crear reas
1. Vaya al mdulo de O rg an izacio n es en la vista de M d u lo s.

1608

Copyright 2013 - Bizagi

2. D clic derecho en reas y seleccione la opcin N u ev a rea

Copyright 2013 - Bizagi

1609

3. Se abrir una nueva ventana. Ingrese el nombre, nombre de mostrar y descripcin de la nueva rea. En esta caso escribimos Dep artam en to d e Ven tas. D clic en O K.

Se ha creado la nueva rea. Haga lo mismo para las dems.

Crear Cargos
El procedimiento para crear posiciones es muy similar al descrito anteriormente. La diferencia es que las posiciones poseen dependencias con el fin de representar la jerarqua dentro de la organizacin. En nuestro ejemplo el Gerente de Ventas se encuentra en un nivel superior de autoridad al del Agente de Ventas y en el mismo nivel de autoridad de los gerentes de Operaciones, Recursos Humanos y Contabilidad. En Bizagi estos niveles de autoridad se tienen en cuenta al momento de crear posiciones. 1. Vaya al mdulo de O rg an izacio n es en la vista de M d u lo s y d clic en O rg an izaci n .

1610

Copyright 2013 - Bizagi

2. D clic derecho en Carg o s y seleccione la opcin N u ev o Carg o .

Copyright 2013 - Bizagi

1611

3. Se abrir una nueva ventana. Escriba el nombre, nombre de mostrar, descripcion y costo del nuevo cargo. En este ejemplo escribimos Geren te d e Ven tas. D clic en O K.

4. Despus de crear un cargo dentro de la Organizacin, usted puede crear nuevas dependencias para l. Seleccione el elemento sobre el cual desea crear la dependencia, d clic derecho y seleccione la opcin N u ev o Carg o .

1612

Copyright 2013 - Bizagi

Crearemos una dependencia para el Gerente de Ventas: El Agente de Ventas. D clic derecho en el cargo Geren te d e Ven tas y seleccione la opcin N u ev o Carg o .

5.Escriba el nombre, nombre de mostrar, descripcin y costo del nuevo cargo. En este ejemplo escribimos A g en te d e Ven tas. D clic en O K.

Copyright 2013 - Bizagi

1613

Observe cmo se representa la jerarqua

La vista final de la jerarqua sera:

Crear Lugares
Los lugares funcionan de la misma manera que los Cargos. En este caso, la jerarqua representa el nivel de importancia de una oficina o sucursal en relacin con las demas. Suponga que nuestra Organizacin tiene su oficina principal en Nueva York y otras dos sucursales: una ubicada en Miami y otra en Los Angeles. Para crear Lugares y representar su nivel relativo de importancia, siga los pasos que se describen a continuacin: 1. Vaya al modulo de O rg an izacio n es en la vista de M d u lo s y d clic en O rg an izaci n .

1614

Copyright 2013 - Bizagi

2. D clic en Lu g ares y seleccione la opcin N u ev o Lu g ar.

Copyright 2013 - Bizagi

1615

3. Se abrir una nueva ventana. Llene los campos requeridos. El nombre del lugar ser N u ev a Y o rk.

1616

Copyright 2013 - Bizagi

Observe que el esquema de das no laborales, esquema de horario de trabajo y uso horario son campos requeridos para la configuracin del lugar. El uso horario es importante si la compaa posee oficinas ubicadas en varios paises con diferentes horas locales. Para ms informacion acerca de estas configuraciones, consulte Horario de Trabajo y Calendarios. 4. Cree las sucursales. Seleccione el elemento al cual desea crear la dependencia, d clic derecho y seleccione la opcin N u ev o Lu g ar. Crearemos las dependencias para la oficina de Nueva York: las sucursales de Miami y los Angeles. D clic derecho en el lugar N u ev a Y o rk, seleccione la opcin N u ev o Lu g ar y llene los campos requeridos.

La vista final de los lugares se muestra en la siguiente imagen:

Copyright 2013 - Bizagi

1617

Crear Roles
Suponga que nuestro Departamento de Ventas lleva a cabo un Proceso denominado Gestin de Oportunidades de Venta con el fin de manejar y promocionar negocios potenciales. Hemos creado el cargo de Agente de Ventas para las personas que trabajan en el Departamento de Ventas, sin embargo solo algunos de ellos pueden crear oportunidades de negocio. Para identificar que Agentes de Ventas pueden crear Oportunidades de negoci utilizaremos los Roles. Recuerde que un role es una conducta llevada a cabo por una persona en la organizacin. En este caso dicha conducta es la creacin de Oportunidades de negocio. 1. Vaya al mdulo de O rg an izacio n es en la vista de M d u lo s.

2. D clic derecho en Ro les y seleccione la opcin N u ev o Ro l

1618

Copyright 2013 - Bizagi

3. Se abrir una nueva ventana. Llene los campos requeridos. En esta caso el nombre del rol ser Cread o r d e O p o rtu n id ad es d e n eg o cio . D clic en O K.

Se crear el nuevo rol.

Copyright 2013 - Bizagi

1619

Crear Habilidades
Ahora suponga que toda la organizacin realiza un Proceso llamado Planeacin de contingecia de emergencias donde las situaciones potenciales de emergencia que pueden surgir en la organizacin se identifican y se asignan recursos con el fin de afrontarlas. Estos recursos se asignan de acuerdo a habilidades particulares que poseen los empleados. El grupo de primeros auxilios estar conformado por todos los empleados que tienen conocimiento de primeros auxilos por lo que deben ser identificados a travs de una Habilidad.

1. Vaya al mdulo de O rg an izacio n es en la vista de M d u lo s.

1620

Copyright 2013 - Bizagi

2. D clic derecho en H ab ilid ad es y seleccione la opcin N u ev a H ab ilid ad .

Copyright 2013 - Bizagi

1621

3. Se abrir una nueva ventana. Llene los campos requeridos. En esta caso el nombre de la habilidad ser Co n o cim ien to en p rim ero s au x ilio s. D clic en O K.

Se crear a nueva habilidad.

1622

Copyright 2013 - Bizagi

3.9.7.1.1 Asistente de organizacin

El asistente de Organizacin permite todos realizar todos los cambios requeridos a la organizacin desde un solo sitio, en vez de crear las caractersticas una por una como se describi en el artculo anterior. Para acceder al A sisten te d e O rg an izaci n , vaya a la vista de M d u lo s, seleccione el m d u lo d e O rg an izacio n es y d clic derecho en O rg an izacio n es. Luego seleccione Ed itar O rg an izaci n .

Copyright 2013 - Bizagi

1623

El A sisten te d e O rg an izacio n es se mostrar. En el primer paso del asistente, edite el nombre de la organizacin y configuraciones de esquema de horario. En esta ventana usted tambin puede escoger qu componentes ajustar en esta configuracin. Una vez seleccionados los componentes a configurar, d clic en Sig u ien te.

1624

Copyright 2013 - Bizagi

El segundo paso permite administrar los Cargos. Utilice los botones para agregar, editar o remover cargos. Adicionalmente usted puede cambiar el orden de jerarqua utilizando los botones arriba y abajo.

Copyright 2013 - Bizagi

1625

Para agregar un registro, d clic en el botn N u ev o y e ingrese la informacin requerida.

1626

Copyright 2013 - Bizagi

Para editar un registro, seleccinelo y d clic en el botn Ed itar. Cambie la informacin.

Copyright 2013 - Bizagi

1627

Para eliminar un registro, seleccinelo y de clic en Eliminar, luego d clic en Si para confirmar.

1628

Copyright 2013 - Bizagi

Los lugares, reas, roles, habilidades y propiedades de usuario se configuran en los pasos posteriores utilizando la misma estructura mencionada anteriormente. En los roles, habilidades y propiedades de usuario solo estn habilitadas las opciones de Nuevo, Editar y Eliminar. No son necesarios los botones arriba/abajo debido a que no existe jerarqua para estos componentes.

Copyright 2013 - Bizagi

1629

1630

Copyright 2013 - Bizagi

Finalmente d clic en F in alizar para guardar los cambios. 3.9.7.2 Propiedades de usuario

Informacin General
Bizagi brinda un conjunto de informacin, denominado Propiedades de Usuario, que es relevante para cada usuario individualmente. Estos incluyen el nombre completo, correo electrnico, direccin, dominio, roles, cargo, usuario delegado, entre otros. Estas propiedades se pueden ver en el mdulo de Organizaciones. Usted puede crear propiedades adicionales para sus usuarios tales como fecha de nacimiento, nmero de seguridad social, estado civil, o cualquier otra propiedad requerida para sus Procesos que no este incluida entre las propiedades por defecto que trae Bizagi. Las propiedades de usuario se pueden crear directamente desde el M d u lo d e O rg an izacio n es o a travs del A sisten te d e O rg an izacio n es.

Cmo crear propiedades de usuario

Para crear una propiedad de usuario desde el M d u lo d e O rg an izacio n es, d clic derecho sobre las

Copyright 2013 - Bizagi

1631

P ro p ied ad es d e Usu ario y seleccione la opcin N u ev a P ro p ied ad d e Usu ario .

Si usted prefiere utilizar el Asistente de Organizaciones, seleccione la opcin de Propiedades de usuario en el primer paso. Cuando llegue a la configuracin de Propiedades de usuario, d clic en el botn A g reg ar.

1632

Copyright 2013 - Bizagi

Para crear una propiedad de usuario, se debe ingresar la siguiente informacin:

Copyright 2013 - Bizagi

1633

Nombre (Name): Asigne un nombre a la propiedad de usuario. Su longitud es de mximo 25 caracteres y no debe tener espacios ni caracteres especiales como tildes, comas y otros (#!&%$()/ *+:). Como estndar se utilizan maysculas para iniciar las palabras que nombran la propiedad de usuario y como letra inicial del atributo se indica el tipo de dato ejemplo iNumeroIdentificacion. Nombre Visual (Display Name): Las propiedades de usuario deben nombrarse de forma clara y entendible. Este se mostrar al usuario final. Se permiten espacios y tildes. El mximo permitido es de 40 caracteres. Descripcin: Ingrese una descripcin corta para propsitos de documentacin. Orden Visual (Display Order): Indica en qu posicin se mostrar esta propiedad en la forma de administracin de usuarios del Portal de Trabajo. Este campo recibe un nmero positivo o negativo. Si incluye la posicin nmero 1 la propiedad de usuario creada se mostrar justo despus de la ultima propiedad de usuario que viene por defecto creada. Texto de Ayuda (Help Text): El texto de ayuda aparecer cuando se haga clic sobre el campo en la forma de administracin de usuarios del Portal de Trabajo. Tipo de Relacin (Relation Type): Indica el tipo de relacin de la propiedad de usuario. Usted puederelaciones simples tales como edad, fecha de nacimiento, nmero de hijos etc, o relaciones Uno a muchos o Muchos a Muchos con entidades paramtricas o de sistema. Tipo de Dato (Data Type): Aplica nicamente para las propiedades de usuario que no representan

1634

Copyright 2013 - Bizagi

una relacin: el tipo de datos indica el tipo de atributo. Para mayor inforamcin acerca de Tipos de Atributo, consulte Modelar Datos. Longitud Mxima (Max Length): La longitud es indicada nicamente para campos tipo string (texto). La longitud debe estar entre 1 y 4000 caracteres. Entidad Paramtrica/Sistema (Parameter/System Entity): Si la propiedad de usuario est relacionada con otra entidad con una relacin uno a muchos o muchos a muchos, en este campo se debe indicar la entidad con que se asocia el atributo. Visible (Visible): Indica si esta propiedad debe ser visible o no en la administracin de usuarios del Portal de Trabajo. Editable (Editable): Indica si esta propiedad debe ser Editable o no en la administracin de usuarios del Portal de Trabajo. Requerido (Required): Indica si esta propiedad debe ser Obligatoria o no en la administracin de usuarios del Portal de Trabajo. Disponible para Asignaciones (Available for Assignation): Indica si esta propiedad se encuentra habilitada para realizar las asignaciones de una actividad. Si se habilita esta propiedad se despliega en el combo de propiedad de usuarios en el editor de Asignaciones. Administrada por el Usuario (Manageable by the User): Cuando una propiedad de usuario se selecciona para que sea administrable, esta propiedad aparecer en la pgina de Preferencias del Portal de Trabajo. Esta propiedad puede ser cambiada para cada usuario independientemente. Si no se selecciona, solamente los Administradores podrn administrar la informacin de los usuarios. La propiedades de usuario se configuran individualmente para cada usuario en las Opciones de Administracin en el Portal de Trabajo. Las propiedades de usuario definidas como Requeridas se encuentran en la primera pestaa (Informacin Bsica) de la configuracin de usuario. Las propiedades de usuario definidas como No requeridas, se encuentran en la ltima pestaa (Informacin Adicional).

Copyright 2013 - Bizagi

1635

Ejemplo
Suponga que una compaa gestiona muchos de sus Procesos internos que tienen en cuenta el tipo de contrato de un empleado y su salario. Como esta informacin es conocida para los empleados activos, se puede crear una Propiedad de Usuario que almacene estos valores. Crearemos las propiedades de tipo de contrato y salario como Propiedades de Usuario: 1. Para crear cada propiedad, vaya al M en d e co n fig u raci n d e n u ev a p ro p ied ad d e u su ario en el M d u lo d e O rg an izacio n es. Tambin puede crearlas desde el A sisten te d e O rg an izacio n es, como mencionamos anteriormente, si lo prefiere.

2. Ingrese la informacin requerida. Para la primera propiedad, salario , cree una propiedad de tipo moneda. Seleccione Tip o d e Dato Sim p le en la lista desplegable de Tip o d e Relaci n y luego seleccione M o n ed a en la lista de Tip o d e Dato s.

1636

Copyright 2013 - Bizagi

3. Esta propiedad de usuario ser visible, editable y requerida por lo que activamos estas opciones. D clic en F in alizar.

Copyright 2013 - Bizagi

1637

4. Para crear la propiedad de Tip o d e Co n trato abra el M en d e co n fig u raci n d e n u ev a p ro p ied ad d e u su ario . 5. La propiedad de Tip o d e Co n trato tendr una relacin de uno a muchos con la entidad paramtrica Tip o d e Co n trato . La entidad paramtrica que contiene la informacin debe ser creada previamente. Seleccione la opcin Un o a m u ch o s en la lista desplegable de Tip o d e Relaci n y despus seleccione Tip o d e Co n trato en la lista de En tid ad P aram trica/Sistem a.

1638

Copyright 2013 - Bizagi

6. Esta propiedad de usuario ser visible, editable y requerida por lo que activamos estas opciones. D clic en F in alizar.

Copyright 2013 - Bizagi

1639

La dos propiedades que acabamos de crear se muestran bajo el nodo de P ro p ied ad es d e Usu ario .

1640

Copyright 2013 - Bizagi

Si usted accede al Portal de Trabajo y va al men de Administracin de Usuarios ver las nuevas propiedades disponibles para cada usuario.

Copyright 2013 - Bizagi

1641

3.9.7.3

Grupos de usuarios

Informacin General
Los Grupos de Usuario son grupos de combinan propiedades de usuario para encontrar usuarios finales que cumplan con todas ellas. Los grupos de usuario se utilizan para conceder o restringir acceso a mens en el Portal de Trabajo. Tenga en cuenta que para conceder o restringir accesos en el Portal de Trabajo usted tambin podra utilizar Roles. Si un rol especfico restringe o concede acceso a u men del Portal de Trabajo de manera adecuadda, entonces no ser necesario crear un grupo de usuarios para este fin. Los Grupos de Usuario se necesitan cuando la concesin o restriccin de permisos es ms compleja y requiere de ms de un componente de usuario definido como habilidades, cargos, etc. Los siguientes son ejemplos para ilustrar las posibilidades de combinar propiedades de usuario en un grupo: 1. Cargo: Gerente de Sucursal + Rol: Comercial 2. Cargo: Analista de Crdito 3. Rol: Supervisor

+ Habilidad: Anlisis de hipotecas

+ rea: Presidencia

D clic aqui para ms informacin acerca de cmo conceder permisos a Grupos de usuarios.

Qu necesita en hacer en Bizagi?

1. En la vista de M d u lo s, d clic en el mdulo de O rg an izaci n y luego d clic derecho en Gru p o s d e Usu ario . Seleccione la opcin N u ev o Gru p o d e Usu ario .

1642

Copyright 2013 - Bizagi

2. Se abrir la ventana de Grupos de Usuarios. Usted debe ingresar la siguiente informacin:

Nombre: Nombre del grupo de usuario a crear. Nombre de Mostrar: Nombre que se mostrar para el grupo. Descripcin: Informacin detallada del objetivo y uso del grupo para propsitos de documentacin. Condiciones del Grupo: Condiciones que deben cumplir los usuarios finales para pertenecer al grupo. Las condiciones del grupo incluyen una serie de columnas que contienen cada una de las

Copyright 2013 - Bizagi

1643

caractersticas requeridas. Usted puede incluir varias columnas de Condiciones del Grupo. La informacin en la columnas representa conectores Y y las filas representan los conectores O.

Cmo crear un Grupo de Usuarios

Suponga que usted necesita crear un Grupo de Usuarios para los Gerentes que reciban comisiones de ventas. Las comisiones solo se conceden a alguien con perfil comercial por lo que las condiciones del grupo seran: Cargo = Gerente de Sucursal Y Rol = Comercial D clic en el botn A g reg ar que se encuentra en el medio de la ventana para crear una condicin.

Sin embargo usted se di cuenta que los Gerentes de Cuenta tambin reciben comisiones por lo que el grupo debe incluirlos tambin. La nueva condicin del grupo sera: [Cargo = Gerente de Sucursal Y Rol = Comercial] O [Cargo = Gerente de Cuenta]

1644

Copyright 2013 - Bizagi

Adicionalmente in el mismo grupo de usuarios, algunos empleados pueden ser excluidos utilizando la opcin Ex clu ir. Suponga en nuestro ejemplo que la oficina de Nueva York no maneja compensaciones monetarias sino otro tipo de beneficios, por lo que la nueva condicin del grupo sera: {[Cargo = Gerente de Sucursal Y Rol = Comercial] O [Cargo = Gerente de Cuenta]} Y [Lugar<>New York]

Copyright 2013 - Bizagi

1645

3.9.7.4

Esquema de horarios de trabajo y calendarios

Informacin general
Dentro de las organizaciones tanto usuarios como sucursales pueden utilizar diferentes horarios de trabajo. Las oficinas en diferentes pases tambin tienen festivos diferentes. Estas consideraciones deben tenerse en cuenta a fin de permitir Bizagi realizar clculos apropiados de fechas de vencimiento de actividades, asignaciones basadas en la disponibilidad y el ejecucin de alarmas. Bizagi permite definir horarios de trabajo y esquemas de festivos para cada organizacin y sus regiones.

Ejemplo
Supongamos que tenemos un proceso que tiene una actividad con una duracin de 60 minutos. Su empresa trabaja de 09 a.m.-1:00 PM y 14:00-18:00, de Lunes a Viernes. Debe definir este esquema de trabajo en Bizagi. Las siguientes sern las condiciones que Bizagi controlar: Si la actividad se crea a las 10:00 AM, la fecha esperada solucin ser el mismo da a las 11:00 AM. Si la actividad se crea a las 12:30 PM, la fecha esperada solucin es el mismo da a las 2:30 PM (por la hora de del almuerzo de 1:00 PM 2:00 PM) Si la actividad es creada a las 5:30 PM de lunes a jueves, la fecha esperada solucin ser el da siguiente a las 9:30 AM. Si la actividad es creada a las 5:30 PM en un viernes, la fecha esperada solucin es el lunes a las 9:30 AM.

1646

Copyright 2013 - Bizagi

3.9.7.4.1 Esquema de horario de trabajo

El esquema horario de trabajo se define para cada organizacin y cada usuario. La duracin de las actividades depende de este esquema y por tanto, el manejo del vencimiento de las Actividades y sus colores en el Portal de Trabajo. En Bizagi hay 3 tipos de esquemas de horario de trabajo por defecto: Standard: 8:00 AM-12: 00 PM y 2:00 PM 6: 00 PM de lunes a viernes 24 horas: 24 horas de domingo a domingo Turno de noche: de 12:00 AM-3: 00 AM y 4:00 AM 8-: 00AM, de lunes a viernes. Los esquemas de horario de trabajo deben ser configurados cuando se necesita un tiempo de trabajo diferentes de los valores predeterminados.

Configuracin de un esquema de horario de trabajo

1. En la vista de Mdulos, vaya al mdulo de O rg an izacio n es y haga clic en la opcin Esq u em a d e h o rario d e trab ajo situado en la parte superior de la pantalla.

2. Se desplegar la ventana de P ro p ied ad es d e h o ras d e trab ajo . Seleccione el esquema deseado de la lista de esquemas de trabajo.

Copyright 2013 - Bizagi

1647

Cuando una organizacin requiere de un esquema de tiempo personalizado, puede crear uno nuevo o editar los existentes.

Crear un esquema de horario de trabajo

1. En las P ro p ied ad es d e h o ras d e trab ajo , haga clic en N u ev o .

1648

Copyright 2013 - Bizagi

2. Escriba un nombre para el nuevo esquema. Usted tiene dos opciones para el calendario relacionado con el esquema: Crear nuevo calendario base: Crea un calendario con el horario de lunes a viernes de 8:00 AM a 12:00 PM y 14:00-18:00. Hacer una copia de un calendario existente: Crea una copia de la configuracin de un calendario existente

Copyright 2013 - Bizagi

1649

3. Por ltimo, haga clic en A cep tar para guardar los cambios.

Editar un esquema de horario de trabajo existente

1. En las P ro p ied ad es d e h o ras d e trab ajo seleccione el esquema que desea editar y luego seleccionar el da o das de la semana para modificar. Usted puede seleccionar un da particular del ao o un grupo de das. Puede seleccionar varios das a la vez por oprimiendo la tecla Ctrl mientras hace clic sobre los das. Los das seleccionados se resaltarn.

1650

Copyright 2013 - Bizagi

2. Haga clic en el botn Ed itar H o rario . Las siguientes opciones estarn habilitadas: Horario laboral por defecto: le permite asignar el tiempo de trabajo de los das regulares. Horario no laboral: permite definir un da especfico como da no laboral. Horario laboral personalizado: permite modificar el tiempo de trabajo en los campos Desde y Hasta, para redefinir los horarios segn sea necesario.

Copyright 2013 - Bizagi

1651

3. Modifique el esquema de tiempo de acuerdo a sus necesidades, a continuacin, haga clic en el botn A sig n ar y finalmente haga clic en A cep tar.

1652

Copyright 2013 - Bizagi

Cambiar el esquema de horario de trabajo en una organizacin

Cada organizacin debe estar asociada a un esquema de horario de trabajo. Por defecto, el esquema para las organizaciones en Bizagi es el Standars descrito al principio de esta seccin. Cuando hay mltiples organizaciones, puede seleccionar un esquema especfico de horario de trabajo para cada una. Para asignar o cambiar el esquema de horario de trabajo asociado a una organizacin siga los siguientes pasos: 1. Vaya a la vista de Mdulos, haga clic en O rg an izaci n y seleccione la opcin Ed itar O rg an izaci n .

2. Seleccione el Esquema de horario de trabajo que desea asociar a la Organizacin. Haga clic en Sig u ien te hasta llegar al ltimo paso del asistente. Por ltimo, haga clic en F in alizar.

Copyright 2013 - Bizagi

1653

Cambiar el esquema de horario de trabajo de un usuario

Usted puede asociar diferentes esquemas de horario de trabajo diferentes, a diferentes usuarios a travs del Portal de Trabajo. Esto debe que ser realizado por un administrador. Los esquemas de horario de trabajo deben ser previamente definidos. 1. Vaya al men A d m in en el Portal de Trabajo y seleccione Usu ario s.

2. Busque el usuario especfico y haga clic en Ed itar.

1654

Copyright 2013 - Bizagi

3. Vaya a la pestaa Co n fig u racio n u su ario . Usted encontrar la opcin Esq u em a d e trab ajo . Seleccione el esquema que se desea aplicar al usuario y haga clic en Actualizar.

Copyright 2013 - Bizagi

1655

3.9.7.4.2 Esquema de festivos

Usted puede definir los das festivos o das de descanso que se aplican para cada esquema de horario de trabajo a travs de la opcin de Esq u em a d e d as n o lab o rales. Esta opcin le permite definir uno o ms esquemas de das no laborales que ms tarde se pueden asignar a las organizaciones y regiones, cuando sea necesario.

Configuracin de un esquema de das no laborales

En algunos pases, los trabajadores no laboran durante la temporada de carnaval. En la ciudad de Barranquilla, Colombia, los empleados toman como descanso los das de carnaval. Supongamos que dichos carnavales tienen lugar 27 y 28 de Febrero. Es necesario incluir esta informacin solamente para la ciudad de Barranquilla, porque el resto de la organizacin trabaja sobre una base regular. 1. En la vista de Mdulos, vaya al mdulo de O rg an izacio n es, y haga clic derecho en Esq u em a d e d as n o lab o rales y seleccione N u ev o esq u em a d e d as n o lab o rales.

2. Una nueva ventana aparecer. En esta ventana se pueden seleccionar uno o ms das festivos que luego pueden ser asignados a la ubicacin geogrfica de la organizacin.

1656

Copyright 2013 - Bizagi

3. Escriba un nombre para el esquema y haga clic en A d icio n ar para introducir la informacin de cada da de fiesta. Puede incluir tantos das como sea necesario.

Copyright 2013 - Bizagi

1657

Nota: Para garantizar el correcto funcionamiento de todos los ambientes, despus del primer deployment las fechas configuradas en el Esquema de de das no laborales no se pueden eliminar. Es posible agregar fechas y luego hacer un deployment para llevarlas a produccin.

4. Asigne el esquema de das no laborales a los lugares donde aplica. Vaya al men Lugares y de clic derecho en la ubicacin deseada. Seleccione p ro p ied ad es y escoja el esquema correspondiente en la lista de Esq u em as d e d as n o lab o rales.

IMPORTANTE El Esquema de das no laborales es complementario al Esquema de horario de trabajo. En el caso anterior, si el cambio de esquema se aplica a Barranquilla, los das no laborales correspondientes al esquema estndar se agregarn al esquema definido CarnivalDays:

1658

Copyright 2013 - Bizagi

Nota: La hora que aparece en el Portal de Trabajo de cada usuario final corresponde a la hora del equipo local y no a la hora del servidor. 3.9.7.5 Mltiples organizaciones

Informacin general
Bizagi soporta la configuracin de proyectos con ms de una organizacin. Los procesos del proyecto pueden ser utilizados por todas las organizaciones definidas. Cada organizacin tiene su propia estructura organizacional y lugares. Al crear una nueva organizacin, Bizagi Studio crea posiciones y lugares independientes para cada una. El resto de los componentes de la organizacin sern compartidos: Areas, Roles, Habilidades, Propiedades del usuario, Grupos de usuarios y Esquemas de das no laborales. Nota: Es muy importante aclarar que con mltiples organizaciones, cada caso creado (es decir, cada instancia de Process) va a estar relacionado con una y slo una Organizacin al comienzo de cada caso. De forma predeterminada, la Organizacin relacionada ser la primera a la que el usuario creador caso pertenezca. Slo los usuarios que pertenecen a la Organizacin se tendrn en cuenta en las reglas de Participacin en todo el caso.

Crear una nueva organizacin

1. Para crear una nueva Organizacin d clic derecho en el nodo de O rg an izaci n y seleccione N u ev a Copyright 2013 - Bizagi 1659

O rg an izaci n .

2. Un nuevo asistente aparecer para ayudar a introducir toda la informacin de la Organizacin.

Como las posiciones y lugares son independientes para cada organizacin, stas deben definirse por

1660

Copyright 2013 - Bizagi

separado. Siga el asistente para completar la informacin de la Organizacin.

Organizaciones y Usuarios
Si se han definido varias Organizaciones cada usuario final debe pertenecer al menos a una de ellas. Un usuario puede pertenecer a varias organizaciones. l / ella ser asignado a los casos creados en las organizaciones a las que l / ella pertenece. Cuando una nueva organizacin ha sido creada, una propiedad de usuario nueva se mostrar en el men Administracin de Usuarios en el Portal de Trabajo. Para cada usuario, seleccione las organizaciones a las que l o ella pertenece. Las posiciones estn disponibles de acuerdo a la organizacin seleccionada. Tenga en cuenta que un usuario puede pertenecer a un solo lugar, a pesar de que el usuario pertenezca a varias organizaciones.

Tan pronto como ms de una Organizacin est disponible para un proyecto, en el men Administracin de usuarios se mostrar una nueva lista desplegable. Esta lista permite identificar fcilmente a los usuarios de una organizacin especfica.

Copyright 2013 - Bizagi

1661

Las reglas de asignacin en proyectos con mltiples organizaciones distinguirn entre los usuarios. Cuando un caso es creado, el usuario final debe definir la organizacin que la instancia de proceso pertenece. Las reglas de asignacin slo asignarn Actividades a los usuarios que pertenecen a la Organizacin elegida. Las reglas de asignacin que se construyen eligiendo una Posicin o un Lugar se filtrarn de modo que los participantes pertenezcan exclusivamente a esa organizacin. Los Roles, Habilidades, reas, etc, que son comunes a todas las organizaciones continuarn operando sin filtros.

1662

Copyright 2013 - Bizagi

Restringir un proceso a una organizacin

Los procesos no puede definirse exclusivamente para una sola organizacin. Sin embargo, es posible definir permisos para que los usuarios que pueden crear casos pertenecen a una determinada organizacin, utilizando la funcionalidad de Grupos de usuarios. Esta caracterstica, aadida al hecho de que cada caso creado est unido a una organizacin, restringe los procesos para ser creados a partir de una organizacin especfica. 1. Defina un Grupo de usuarios para una organizacin. En el mdulo de O rg an izacio n es, haga clic en el nodo Gru p o d e Usu ario s y seleccione la opcin N u ev o g ru p o d e u su ario s.

2. Asigne un nombre al grupo y asigne una condicin. En este caso seleccione de la Organizacin correspondiente en la columna de la Organizacin. Haga clic en A cep tar.

Copyright 2013 - Bizagi

1663

3. Otorgue permisos para creacin de casos al grupo de usuarios. Vaya al mdulo de Seguridad y despliegue el men de A u to rizaci n . Despliegue N u ev o s caso s y seleccione el proceso que se restringir a una sola organizacin. Agregue el grupo de usuarios y asigne los permisos necesarios.

1664

Copyright 2013 - Bizagi

Con esta configuracin los usuarios que no pertenecen al Grupo de usuarios, es decir a otra organizacin, no podrn crear un caso de este proceso.

3.10

Seguridad en Bizagi Studio Informacin general

Bizagi ofrece un entorno de colaboracin donde usted y sus compaeros de trabajo pueden trabajar simultneamente en el mismo proyecto. Si usted tiene varios procesos en su proyecto puede ser necesario restringir los accesos a algunos recursos para evitar que los usuarios modifiquen un proceso, que afectarn a otros procesos a su vez.

Por defecto, todos los proyectos de Bizagi se crean sin seguridad, es decir, no hay derechos de acceso. Habilite la Seguridad de Bizagi Studio para garantizar que las personas adecuadas tengan acceso a los recursos correctos. Los recursos para los cuales la seguridad se pueden gestionar son: Aplicaciones Procesos Entidades Reglas globales de negocio Tan pronto como un recurso tiene algn tipo de seguridad (ya sea para restringir o permitir), Bizagi su pone que el recurso est restringido y slo los usuarios con permisos de crear, modificar o control total podrn acceder. El acceso a otros usuarios ser restringido.

Recursos con Seguridad

La seguridad puede ser manejada para ciertos elementos o recursos en Bizagi Studio. La seguridad puede ser asignada a un usuario especfico o a un grupo de usuarios.

Copyright 2013 - Bizagi

1665

La accin especfica de seguridad varan en funcin del tipo de recurso. Hay tres tipos de acciones: Crear: Permite crear un recurso. Modificar: Permite modificar un recurso, pero no crear uno nuevo. Control total: Permite ejecutar todas las acciones posibles sobre un recurso (Crear, Modificar, Eliminar) y asignar seguridad. Los derechos de acceso se heredan. Si el recurso con una jerarqua superior tiene ciertos permisos, del Recurso hijo adquirir el permiso tambin. Esto, a menos de que el recurso hijo tenga permisos especficos. La siguiente lista describe los recursos y las acciones relativas a cada uno de ellos.

Seguridad de Aplicaciones y Procesos

Recurso Nodo principal de Aplicaciones Aplicaciones Crear Crear nuevas aplicaciones Crear nuevos procesos y sub-procesos n/a Es visible y modificable Modificar Control total n/a Crear, modificar y gestionar la seguridad Crear, modificar y gestionar la seguridad Crear, modificar y gestionar la seguridad

Procesos

n/a

Es visible y modificable

Versiones de proceso

n/a

Es visible y modificable

Los derechos de acceso se heredan. Si tiene permisos de M o d ificar sobre una aplicacin, entonces usted tambin tendr permisos sobre todo el proceso relacionado con esa Aplicacin y todos sus elementos: Formas, reglas de negocio, expresiones, etc.; todo lo contenido en el rbol jerrquico. La creacin de nuevos procesos heredar la configuracin de seguridad dada a su Aplicacin relacionada.

1666

Copyright 2013 - Bizagi

Seguridad de Entidades
Recurso Nodo principal de entidades Entidades de Aplicacin Entidades Maestras Crear Crear nuevas entidades n/a Modificar n/a Control total

n/a

Es visible y modificable

Crear, modificar y gestionar la seguridad Crear, modificar y gestionar la seguridad Crear, modificar y gestionar la seguridad

n/a

Es visible y modificable

Entidades Paramtricas

n/a

Es visible y modificable

La mayora de los proyectos tienen entidades que son cruciales para el buen funcionamiento de un proceso, y los cambios no controlados pueden afectar su desarrollo. Puede restringir los permisos de acceso a esas entidades para limitar modificaciones. Los derechos de acceso se heredan. Si tiene permisos de Modificar sobre una entidad, entonces tambin tendr permisos sobre todos sus elementos relacionados: Atributos, formas, valores, consultas, expresiones. Todos los elementos jerrquicos de la entidad dada. Cuando se le ha negado los permisos de Modificar de una entidad, no se podr modificar ninguno de sus elementos. Tenga en cuenta los elementos de la Entidad estarn disponibles para su uso (en las formas, expresiones), pero no para su modificacin.

Seguridad de Reglas de Negocio globales

Copyright 2013 - Bizagi

1667

Recurso Aplicaciones n/a

Crear

Modificar Es visible y modificable

Control Total Crear, modificar y gestionar la seguridad Crear, modificar y gestionar la seguridad Crear, modificar y gestionar la seguridad

Funciones globales

n/a

Es visible y modificable

Expresiones globales

n/a

Es visible y modificable

Cuando se le ha negado los permisos Modificar de una Expresin o de una Funcin, no podr modificarse. La expresin o funcin estar disponible para su uso, pero no se puede modificar.

Los administradores y no administradores

Slo los administradores tienen el derecho a agregar nuevos usuarios y Grupos en la opcin Seg u rid ad d e B izag i Stu d io . Los administradores podrn conceder derechos de todos los elementos que tienen seguridad (es decir, autenticacin, autorizacin y LDAP) en Bizagi Studio. Los administradores siempre tendr derechos de acceso sobre todos los elementos que tienen seguridad en Bizagi Studio. Los usuarios que no son administradores no podrn conceder derechos para los elementos que tienen seguridad en Bizagi Studio, a menos que tengan permisos de Co n tro l to tal sobre un recurso determinado. Los usuarios que no sean administradores podrn crear o modificar los elementos que se encargan de la seguridad en Bizagi Studio, de acuerdo con los derechos otorgados por los administradores.

Consideraciones adicionales
Al configurar Seguridad en Bizagi Studio los usuarios y grupos de usuarios se llenarn automticamente con los usuarios que ya forman parte del Grupo Administrador de Bizagi. Este grupo se configura a travs de Herramientas de Gestin del servidor. Cuando se agregan usuarios a cualquier elemento de Seguridad en Bizagi Studio sern incluidos automticamente en el Grupo de Administradores Bizagi. Si elimina cualquier usuario de la Seguridad de Bizagi Studio NO se eliminar del Grupo de Administradores Bizagi. Cuando un usuario se ha restringido (negado) para modificar un elemento, pero es capaz de acceder a l (al igual que las formas o reglas de negocio), en caso de intentar editar el o ella recibir un mensaje:

1668

Copyright 2013 - Bizagi

Lo mismo aplica para los resultados de los de la opcin de bsqueda. La bsqueda devolver todos los elementos que cumplen una condicin, pero si un usuario no tiene permisos en alguno de los elementos del resultado, una ventana le informar al usuario de esta restriccin.

3.10.1 Configurar la seguridad en Bizagi Studio

Lo que debe hacer en Bizagi

Para conceder derechos de acceso en Bizagi Studio necesita habilitar la caracterstica de seguridad y definir para cada elemento los permisos necesarios. 1. Active la funcin de Seguridad mediante la asignacin de administradores del proyecto (usuarios y grupos de usuarios). 2. Conceda o restrinja el acceso a los recursos (aplicaciones, procesos, entidades y reglas de negocio).

Habilitar la Seguridad de Bizagi Studio

Para habilitar los derechos de acceso en Bizagi Studio debe definir uno o ms administradores del proyecto. Tan pronto como los administradores se definen todos los dems usuarios perdern acceso a la configuracin de Seguridad de Bizagi Studio. Para incluir un Administrador vaya a la vista de Mdulos, abra la pestaa A rch iv o . Seccione la opcin Seg u rid ad d e B izag i Stu d io . Haga clic en Co n fig u rar.

Copyright 2013 - Bizagi

1669

Agregue un usuario al Grupo de administradores. En la nueva ventana, haga clic en Agregar usuario y seleccione el usuario. Slo los usuarios que pertenecen al dominio donde se encuentra el proyecto podrn ser incluidos en la configuracin de seguridad de Bizagi Studio.

La ventana que aparece al agregar un usuario trabaja de la misma manera como cuando concede permisos de las carpetas de Windows. Puede incluir varios usuarios al grupo de administradores. Asegrese de que est marcada In clu ir

1670

Copyright 2013 - Bizagi

slo para los usuarios que van a ser los administradores

Conceder acceso a los recursos

Todos los recursos se habilitan o limitan de la misma manera como se describe a continuacin. Tenga en cuenta que los derechos de acceso se conceden a cada recurso por separado, por lo que debe especificar quin tiene derechos de acceso. Para conceder derechos de acceso debe ser un administrador o tener permisos de Co n tro l to tal sobre un elemento. Daremos permiso de acceso a un proceso llamado Q u ejas y Reclam o s. 1. Haga clic en el recurso que desea gestionar y seleccione Seg u rid ad.

Copyright 2013 - Bizagi

1671

2. Una nueva ventana aparecer donde usted debe agregar un usuario o un grupo y seleccionar los permisos o restricciones deseadas.

1672

Copyright 2013 - Bizagi

3. D a cada usuario o grupo de los derechos de acceso que desee. Cuando haya terminado, haga clic en Cerrar. Los permisos se establecern.

Cuando a un usuario le ha Negado el acceso, no podr ver el Recurso en Bizagi Studio en la vista de M d u lo s. Las entidades y sus elementos (formularios, reglas de negocio, atributos) sern visibles en el Diseador de Formas y se pueden utilizar, pero no modificar. Las reglas globales de negocio y funciones se pueden ver a travs del cuarto paso del Asistente de Proceso, pero no estarn disponible para ser modificadas.

3.10.2 Crear grupos en la Seguridad de Bizagi Studio

Bizagi ofrece la posibilidad de crear grupos de usuarios para agilizar y simplificar la concesin de derechos de acceso y organizar sus proyectos con mayor facilidad. En general, el uso de grupos es preferible, ya que toma menos tiempo y esfuerzo para administrar la seguridad. Si aade a alguien como miembro de un grupo, l / ella tendr automticamente los mismos derechos de acceso que el resto de los usuarios en el grupo. 1. En la ventana de Seguridad de Bizagi Studio, haga clic en el botn A g reg ar situado en la esquina inferior izquierda. Esto abrir una ventana para introducir el nombre del grupo y una descripcin. Cuando termine, haga clic en A cep tar.

Copyright 2013 - Bizagi

1673

2. Seleccione el grupo creado para agregar miembros. Los usuarios que pertenecen al grupo de administradores, si se define, se agregarn automticamente. Marque la casilla de In clu ir junto a los usuarios que deben pertenecer al grupo.

1674

Copyright 2013 - Bizagi

IMPORTANTE: Los usuarios que se Ex clu y an sern considerados como no pertenecientes al grupo.

Agregar un usuario o un grupo a un grupo

Para agregar un usuario o un grupo a un grupo existente, haga clic en el nombre del grupo y luego haga clic en A ad ir u su ario / A ad ir g ru p o . Busque y seleccione el usuario o grupo que desea aadir y haga clic en A cep tar. Asegrese de que In clu ir est seleccionado para todos los miembros (usuarios y / o grupos) que deben aadirse al grupo objetivo.

Copyright 2013 - Bizagi

1675

IMPORTANTE: El grupo de administradores no se puede aadir a cualquier otro grupo.

3.11

Nmero de caso personalizado

Bizagi por defecto, mantiene una secuencia interna de nmeros de caso y asigna el N m ero d e caso a cada nueva instancia, con el fin de evitar duplicidad y conflictos entre los casos. Es posible que desee personalizar estos identificadores para todos o algunos de sus procesos, en cuyo caso Bizagi le permite definir sus propios nmeros de casos mediante el establecimiento de una secuencia personalizada. Tambin se permite el uso de prefijos y sufijos. Para personalizar los Nmeros de caso Bizagi ofrece dos opciones: Por Secuencias: Puede definir una secuencia y personalizar un prefijo y un sufijo. Una secuencia es un contador incrementa en un valor definido cada vez que se crea un caso. Por Reglas: Se puede definir el nmero de caso a travs de una expresin, donde se pueden realizar clculos o validaciones y as proporcionar una definicin ms sofisticada. Not El Nmero de casos es el nmero que se muestra al usuario final en el Portal de Trabajo. Sin embargo Bizagi asigna un identificador independiente y genera uno automticamente para cada caso, internamente. La numeracin interna se conoce como el Id de Caso. La numeracin personalizada es el Nmero de caso.

Definir el nmero de casos por secuencia

Para definir el nmero de casos por secuencia debe crear una secuencia y luego asignarla a una Aplicacin especfica o Proceso.

1676

Copyright 2013 - Bizagi

Para ilustrar cmo se hace esto, utilizaremos el siguiente ejemplo: una empresa industrial decide implementar Bizagi a mediados de Junio. Un total de 1.651 facturas se han generado durante el ao anterior a la automatizacin para el proceso de Generacin de facturas. En Bizagi cada caso se identificar con un nmero consecutivo que es el Nmero de factura. Para crear una secuencia debe seguir los siguientes pasos: 1. En la vista de Mdulos vaya a la pestaa de Co n fig u raci n y haga clic en Secu en cias.

2. En la nueva ventana, haga clic en A d icio n ar para incluir una nueva secuencia.

Copyright 2013 - Bizagi

1677

La columna Id contiene el consecutivo interno y se crea de forma automtica (cuando se hace clic en OK). Introduzca un nombre que describa la secuencia. No debe contener caracteres especiales como espacios, tildes o smbolos. Defina una semilla, que corresponde al valor inicial de la secuencia. Debe ser un valor numrico. Defina el incremento, que ser el encargada de incrementar la semilla. Debe ser un valor numrico. En nuestro ejemplo, el valor inicial es 1,652 (Semilla) y se incrementa en uno cada vez que se crea un caso. Por lo tanto, el incremento es de 1. Haga clic en OK para guardar los cambios.

1678

Copyright 2013 - Bizagi

Una vez la secuencia se ha creado el siguiente paso es asignarlo como nmero de caso al Proceso. Para hacerlo siga el procedimiento siguiente: 1. En la vista de Mdulos vaya a la pestaa de Co n fig u raci n . Haga clic en N u m eraci n d e caso s.

Copyright 2013 - Bizagi

1679

2. Una nueva ventana mostrar la siguiente informacin: Nivel: Define si el nmero de caso personalizado se aplica a todas las aplicaciones: se aplica a todo el proyecto, o para una aplicacin especfica. Aplicacin: Este campo estar disponible cuando la aplicacin est seleccionada para el nivel de configuracin. Se define la aplicacin afectada por el nmero de caso. Utilizar: Define la forma en que se establece el nmero de caso. Puede ser O m isi n (definido por Bizagi), p o r Secu en cia (que se obtiene a partir de una secuencia definida por el usuario) o P o r reg la (que se obtiene una expresin). Asignar nmero de caso en: Define el momento de los casos cuando se establece el nmero de caso. Puede ser en la Creacin del Caso o al final de la fase de creacin. Esto es til cuando la fase de creacin consta de ms de una actividad. Configuracin del Nmero: Este campo slo se aplica cuando P o r secu en cia o P o r reg la se selecciona en el campo de Uso . Le permite definir un prefijo, la secuencia relacionada y un sufijo para el nmero de casos.

Para nuestro ejemplo vamos a asignar los siguientes valores para cada campo: Nivel: - Aplicaciones. El nmero de caso se aplica slo a una aplicacin. Aplicacin - Generacin de facturas. El nmero de caso se aplica nicamente a la aplicacin de Generacin de facturas. Uso - Por secuencia. El nmero de caso se obtendr de la secuencia creada. Asignar nmero de caso en - Fin de la fase de creacin. El nmero de caso ser asignado cuando una venta se confirme. Configuracin del Nmero: No vamos a utilizar un prefijo o sufijo, lo dejamos en blanco.

1680

Copyright 2013 - Bizagi

Seleccionamos Secuencia factura (secuencia previamente creada) en la lista desplegable.

Haga clic en A cep tar para guardar los cambios. El nmero de caso para el proceso de Generacin de factura ha sido creado. As se vern el nmero de caso en el Portal de Trabajo.

Definir el nmero de casos por Regla

Copyright 2013 - Bizagi 1681

Cuando el nmero de caso personalizado no se puede configurar por secuencia, ya que requiere un procedimiento ms complejo, puede usar expresiones. Por ejemplo, usted desear secuencias independientes para diferentes procesos que pertenecen a la misma aplicacin. Tambin puede ser desear un nmero de caso obtenido a partir de un vocabulario o la inclusin de la fecha actual. Para ilustrar cmo se hace, utilizaremos el siguiente ejemplo: Supongamos que su empresa gestiona tres procesos diferentes en la misma aplicacin: In cid en tes, Q u ejas y reclam o s y la Gesti n d e o p o rtu n id ad es d e v en ta. Usted desea identificar cada proceso con un nmero de caso que muestre el proceso al que pertenece y el ao en que fue creado:

In cid en tes: IM - "Secuencia" - "Ao" Q u ejas y reclam o s: CCM - "Secuencia" - "Ao" Gesti n d e o p o rtu n id ad es d e v en ta: OPM - "Secuencia" - "Ao"
Con el fin de personalizar el nmero de caso, siga los siguientes pasos: 1. Defina las tres secuencias en el men Secuencias comenzando en uno e incrementando en uno:

2. Vaya al men N u m eraci n d e caso s para crear el nmero de caso personalizado. En la ventana incluya: Nivel - Bizagi. Uso - Por regla. El nmero de caso se obtendr a partir de una expresin.

1682

Copyright 2013 - Bizagi

Asignar nmero de caso en - Creacin de Caso. El nmero de caso se asignar tan pronto como el caso se crea.

3. En la configuracin cree la regla para evaluar cada proceso.

Copyright 2013 - Bizagi

1683

Haga clic en el cuadrado de la derecha para definir una nueva expresin.

En el editor de expresin incluye el siguiente cdigo:

//Obtener el ao actual en una variable

1684

Copyright 2013 - Bizagi

year=DateTime.Today.Year //Identificar el proceso de acuerdo con su ID if(Me.Case.ProcessDefinition.Id == IdWorkFlow Incident Manager) { //Construir el texto del identificador de caso "IM - "+CHelper.GetNextSeqValueStr("IMNumber")+ " - "+year; } if(Me.Case.ProcessDefinition.Id == IdWorkFlow Claims and Complaints) { "CCM - "+CHelper.GetNextSeqValueStr("CCMNumber")+" - "+year; } if(Me.Case.ProcessDefinition.Id == IdWorkFlow Opportunity Management") { "OPM - "+CHelper.GetNextSeqValueStr("OPMNumber")+" - "+year; } La regla anterior obtiene el ao en curso, a continuacin, identifica el proceso que se est creando, y de acuerdo a esto define el nmero de caso en el formato deseado. Los identificadores de caso se mostrar en el Portal de Trabajo.

Copyright 2013 - Bizagi

1685

Parte IV
Ejecucin del Proceso

Ejecucin del Proceso

Los siguientes captulos explican el Portal de Trabajo de Biagi, cmo hacer deployment a sus procesos y cmo integrar el portal de trabajo.

4.1

Portal de Trabajo de Bizagi Informacin general

Bizagi presenta un Portal de Trabajo donde los procesos que han sido previamente diseados y construidos se interpretan y se presentan para los usuarios finales. El portal de trabajo es donde los usuarios finales crean nuevos casos y tienen acceso a los que les han sido asignados, para llevar a cabo las actividades de acuerdo con lo que se ha diseado. Su acceso requiere de un navegador (intranet o internet) y una cuenta registrada. El Portal de Trabajo permite a los participantes ver sus actividades pendientes, o In b o x , as como informacin en tiempo real relacionada con la ejecucin de procesos. A travs de indicadores de colores, alarmas y un til conjunto de caractersticas usted ser capaz de realizar, gestionar y controlar sus procesos. El Portal de Trabajo resultante de la automatizacin Bizagi tiene una caracterstica muy importante: cuando se modifica el proceso (es decir, cualquier elemento del modelo de proceso, nuevas formas, nuevas expresiones) la aplicacin se adapta automticamente. Dependiendo del perfil del usuario, este portal tambin permite la gestin de los procesos, la reasignacin de los casos y tomar acciones correctivas para lograr la eficiencia de la organizacin.

Copyright 2013 - Bizagi

1687

Para acceder al Portal de Trabajo de clic en el botn Ejecu tar en la Cinta de Opciones de Bizagi Studio o en el paso nmero siete del Asistente de Procesos.

Nota Para la Edicin Enterprise JEE Edition se tiene la opcin de dar clic sobre Ejecutar para visualizar cambios inmediatos (a nivel de formas, reglas) en el Portal de Trabajo. Para algunos otros escenarios (cambios en el modelo de datos, cambios en la configuracin de Seguridad y Autorizacin), se debe optar por volver a publicar la aplicacin. Tanto la ejecucin como la publicacin, lanzarn un navegador con el Portal de Trabajo configurado en la instalacin de JBoss por defecto.

1688

Copyright 2013 - Bizagi

Si usted desea utilizar un Servidor de Aplicaciones JEE diferente a JBoss en su ambiente de desarrollo (p.e. WebSphere, Weblogic), consulte los pasos descritos en la Configuracin del Portal para la edicin JEE.

4.1.1

Interfaz del Portal de Trabajo

El Portal de Trabajo se compone de diferentes reas que le ayudarn a realizar, gestionar y controlar sus procesos. La pantalla principal se divide en tres secciones: M en p rin cip al, rea d e trab ajo y la rea d e caso s.

El rea de trabajo se puede visualizar de dos maneras que pueden cambiar en cualquier momento haciendo clic en los iconos que se encuentran debajo de la opcin Lo g o u t. Estas dos vistas son Detalles y Cuadricula. Por defecto, la vista de Detalles se mostrar.

La vista Cuadrcula se muestra a continuacin.

Copyright 2013 - Bizagi

1689

4.1.1.1

Men principal El Men principal permite el acceso a diferentes opciones para crear los casos, gestionar el rendimiento de los Procesos, administrar el portal, entre otros. Los mens se muestran segn la configuracin de cada usuario y la autorizacin de seguridad. Como resultado, no todos los mens estarn disponibles para todos los usuarios.

Nuevo
OPCIN DESCRIPCIN Crea un nuevo caso o instancia de proceso, del proceso seleccionado. Los procesos se muestran de acuerdo con la estructura del proyecto: Aplicacin, Categora, Subcategora y Proceso.

Crear

Inbox
OPCIN DESCRIPCIN Muestra las actividades pendientes del usuario y el estado de cada una. Los diferentes estados (a tiempo, en riesgo y expriado) se representan con

Inbox

1690

Copyright 2013 - Bizagi

OPCIN

DESCRIPCIN diferentes colores para una fcil identificacin.

Reportes
Este men le da acceso a los informes de rendimiento de los procesos. Le recomendamos configurar la seguridad de este men para garantizar que slo los usuarios adecuados tengan acceso a ella. OPCIN BAM SUB-OPTION Procesos DESCRIPCIN El BAM de procesos le permite analizar el estado de casos activos. El BAM de tareas le permite analizar el estado de actividades pendientes. El Monitor de Recursos le permite analizar la carga y desempeo de usuarios y grupos de trabajo. El Anlisis de Procesos presenta un resumen de casos y actividades cerrados. El Anlisis de Tareas presenta informacin de Actividades que pertenecen a casos cerrados. Los Sensores le proporcionan informacin de los caminos y contadores definidos por el usuario. Mis reportes le dan acceso a los reportes guardados por usted.

Tareas

Monitor de recursos

Anlisis

Procesos

Tareas

Sensores

Sensores

Mis Reportes

Mis Reportes

Consultas
OPCIN DESCRIPCIN Permite acceder a la data de los casos por medio de consultas personalizadas. Estas consultas se usan para lleva a cabo bsquedas que cumplan con ciertos criterios de negocio o de proceso. Estos reportes permiten realizar anlisis grfico.

Consultas

Admin
Las siguientes opciones tienen deben ser manejadas por un administrador. Le recomendamos revisar

Copyright 2013 - Bizagi

1691

las opciones de seguridad para restringir el acceso basado en el perfil de sus usuarios. OPCIN DESCRIPCIN Permite la administracin de los usuarios: creacin o actualizacin. Para ms informacin por favor referirse a Administracin de Usuarios. Permite la administracin de Licencias. Permite la administracin de Entidades Paramtricas para modificar, aadir o des habilitar registros. Para ms informacin refirase a valores de paramtricas en el Portal de Trabajo. Permite reasignar las Actividades o abortar casos. Permite generar alertas o alarmas cuando una actividad va a expirar o ha expirado. Encripta las contraseas usadas en la base datos para incrementar la seguridad del acceso a la informacin. Maneja las actividades asncronas que han fallado.

Usuarios

Licencias

Entidades

Casos Alarmas

Cifrado de clave

Consola de actividades asncronas Solicitudes pendientes de usuarios Bsqueda en el registro de autenticacin Polticas del negocio

Despliega las solicitudes pendientes de las cuentas de usuarios bloqueadas. Para ms informacin refirase a Manejo cuentas bloqueadas. Permite revisar el log de las autenticaciones hechas por usuarios.

Administra las Polticas de negocio, Grupos de polticas, precondiciones, Tablas de decisin y Vocabularios, en tiempo real. Permite la inclusin o borrado de los usuarios de: Posiciones, roles, habilidades, grupos de usuario y Organizacin. Para ms informacin refirase a Perfiles. Permite la definicin o modificacin de los usuarios para la asignacin predeterminada de los procesos. Recuerde que un usuario predeterminado se utiliza para asignar los casos en que los criterios de asignacin no se cumple. Para obtener ms informacin acerca de asignacin de usuario por defecto, por favor referirse Asignacin de trabajo.

Perfiles

Administrar asignacin de usuario predeterminado

1692

Copyright 2013 - Bizagi

OPCIN Dimensiones

DESCRIPCIN Permite al usuario crear, editar y eliminar Dimensiones

Preferencias
OPCIN Preferencias DESCRIPCIN Permite al usuario actualizar la informacin en su perfil. La informacin modificable est dada por las propiedades definidas por el usuario en Bizagi Studio.

Salir
OPCIN Salir DESCRIPCIN Cierra la sesin actual en el Portal de Trabajo

Tamao de letra
OPCIN Tamao DESCRIPCIN Permite al usuario cambiar el tamao de fuente del Portal de Trabajo.

Buscar
OPCIN Buscar 4.1.1.2 rea de casos El rea de casos permite al usuario final ver la distribucin de los casos en su Bandeja de entrada ordenados segn su estado: a tiempo, en riesgo y expirados. Esta zona es muy til para identificar qu procesos y actividades que requieren ser priorizados y permite un fcil acceso a ellos. El rea de casos se divide en dos secciones: In fo rm aci n d e P ro ceso s y Estad o d e caso s. DESCRIPCIN Permite buscar casos por su nmero de creacin.

Copyright 2013 - Bizagi

1693

Informacin de procesos
Esta seccin muestra el nmero total de casos pendientes clasificados por Procesos.

Al hacer clic en un proceso particular se muestran los casos correspondientes en el rea de trabajo. Al hace clic en To d o s lo s caso s, todos las actividades pendientes se mostrarn.

1694

Copyright 2013 - Bizagi

Puede marcar un caso como favorito haciendo clic en el icono de estrella. Esto agregar el caso a su lista de favoritos para un acceso rpido.

Estado de casos
Esta seccin muestra el nmero total de casos pendientes clasificados por el estado actual.

Copyright 2013 - Bizagi

1695

Al hacer clic en un estado particular, se mostrarn los casos correspondientes en el rea de trabajo.

Puede filtrar su Inbox para mostrar los casos marcados como favoritos haciendo clic en el icono de estrella.

Si hace clic en la opcin de todos los casos, todas las actividades pendientes se mostrarn.

1696

Copyright 2013 - Bizagi

4.1.1.3

rea de trabajo En esta seccin usted, como usuario final, puede administrar todos los casos a los que se le ha asignado. Por defecto se encuentran las siguientes columnas que contienen la informacin principal:

Nmero de caso Proceso Fecha de creacin de proceso Fecha solucin

Identificador del caso Proceso al que pertenece la actividad Fecha de creacin del caso

Fecha de solucin de la actividad Nombre de la actividad y su estado. Los estados se muestran por colores determinados por el tiempo de duracin de cada una.

Actividad

Verde: Indica que la actividad est a tiempo. Amarillo: Indica que la actividad expira el da de hoy. Rojo: Indica que la actividad ya ha expriado.

Actividad vence en

Fecha de expiracin de la actividad.

La informacin de los casos en el rea de trabajo se puede visualizar de dos maneras diferentes, que se pueden cambiar en cualquier momento seleccionando el icono de vista situado debajo de la opcin Salir. Las vistas son Detalles y Cu ad rcu la.

Copyright 2013 - Bizagi

1697

Vista Detaller
En la vista Detalles puede ver informacin detallada sobre un caso en particular. Puede navegar por los casos pendientes a la izquierda de la pantalla. Haga clic en un caso para mostrar la informacin del resumen y al log de asignados en las pestaas.

Para acceder al caso de clic en Trab ajar aq u .

1698

Copyright 2013 - Bizagi

Para marcar un caso como Favorito de clic en la estrella en la esquina superior izquierda de la caja del caso.

Para ver la consulta grfica, de clic en el icono de la esquina superior izquierda de la vista resumen. En esta vista puede ver el camino que ha seguido el caso al igual que su estado actual, de manera grfica.

Copyright 2013 - Bizagi

1699

Para ver ms actividades muvase a travs de las pginas haciendo clic en los nmeros de pgina al final de la pantalla.

Vista Cuadrcula
La vista de Cuadrcula muestra la informacin principal del Inbox. Cada fila de la tabla es una actividad pendiente. Puede hacer clic en el icono para obtener ms informacin sobre un asunto determinado, sin tener que acceder al caso.

1700

Copyright 2013 - Bizagi

Para acceder y trabajar en un caso de clic en el enlace de la tarea.

Usted puede marcar un caso como Favorito dando clic en la estrella en la primera columna del caso en cuestin.

Usted puede acceder a la consulta grfica dando clic en el icono junto a la estrella.

Copyright 2013 - Bizagi

1701

Para ver ms actividades de clic en las pginas al final de la pantalla.

4.1.1.4

Actividades pendientes El Portal de Trabajo proporciona una interfaz fcil de usar para trabajar en las actividades pendientes. Al entrar en cualquier actividad pendiente en el Inbox desplegando la construccin de la Forma que contiene toda la informacin relevante y necesaria para que pueda cumplir la tarea. Si est trabajando con la vista Detalles, puede trabajar en un caso especfico haciendo clic en el botn de Trab ajar aq u .

1702

Copyright 2013 - Bizagi

Si est trabajando con la vista de Cuadrcula, se puede trabajar en un caso especfico haciendo clic en el enlace de actividad deseada.

Cuando el caso se abre, se distinguen los siguientes elementos:

Copyright 2013 - Bizagi

1703

Detalle de la actividad: Shows information about the current activity. Detalles del caso: Shows information about the current Case. Forma: Allows you to see and enter the required information of the Case. Botones de accin: Allows saving the information entered and moving on in the Case. Log de estado: Displays the case history. Opciones de impresin: Allows printing the information displayed in the activity. Consulta grfica: Shows the status and development of the Case in a graphical way.

Detalles de la actividad
En esta rea puede ver la informacin relacionada con la actividad como la fecha de creacin, la fecha de expiracin y la desripin. Tambin es posible saber el estado de la misma por el color a su lado (verde, a tiempo; amarillo, en riesgo; rojo, expirado).

Process Details
1704 Copyright 2013 - Bizagi

En esta rea encontrar las pestaas bsicas: Detalles En esta pestaa puede ver informacin relacionada con el caso en cuestin como la fecha de creacin, el usuario creador, el nmero de caso, el proceso relacionado.

Comentarios En esta pestaa puede ingresar informacin adicional relevante a los usuarios que trabajan en el caso, y que puede ser objeto de discusin. Esta NO estar incluida dentro de la informacin del casos en las Formas, pero es importante para para el desarrollo y entendimiento de cada uno. Para ms informacin refirase a Comentarios.

Copyright 2013 - Bizagi

1705

Asignados En esta pestaa puede ver los usuarios asignados a las diferentes actividades del caso.

Cuando hay Subprocesos relacionados se mostrar la siguiente pestaa: Subprocesos En esta pestaa se encuentran los enlaces a los Subprocesos relacionados con el caso actual. Si el Subproceso est cerrado, un candado se muestra a la izquierda de su enlace.

Eventos

1706

Copyright 2013 - Bizagi

En esta pestaa se encuentran los enlaces a los Eventos relacionados con el presente caso.

Forma de Actividad
En el rea de la Forma el usuario final trabajar sobre los campos que se han definido en el tercer paso del proceso de automatizacin. En cada actividad se deben diligenciar los campos requeridos. Cuando se termina se da Siguiente.

La informacin de la actividad se pueden agrupar mediante el uso de contenedores (Tabs o grupos). Esto le permite dar orden y mostrar / ocultar informacin de acuerdo con lo que se desea.

Copyright 2013 - Bizagi

1707

Adems, un asistente se proporciona con el fin de mostrar las advertencias sobre los campos requeridos o condiciones de negocio que se deben cumplir antes de llevar a cabo una actividad completa.

Botones de accin
Estos botones permiten realizar diferentes acciones para la actividad actual.

1708

Copyright 2013 - Bizagi

Botn Guardar: Este botn se utiliza para almacenar la informacin que se ha introducido para la actividad. Tambin puede lanzar o ejecutar validaciones de reglas de negocio cuando se han creado Al Guardar de una tarea. Este botn no est disponible en las pantallas correspondientes a la fase de registro de un proceso. Botn Siguiente: Este botn finaliza la actividad actual. Una vez se da clic no se puede deshacer. La actividad siguiente se convertir en pendiente para el usuario correspondiente. Botn Anterior: Este botn aparece slo en las actividades que pertenecen a la fase de registro de un proceso. El botn le permite volver a la actividad anterior.

Opciones de impresin
Esta opcin le permite imprimir la informacin que aparece en la Forma actual.

Al hacer clic en este icono, una ventana de vista previa mostrar.

Copyright 2013 - Bizagi

1709

1710

Copyright 2013 - Bizagi

Haga clic en el botn para imprimir el documento.

Log de estado
El Log de estado se refiere a la historia del caso. Se muestra la informacin de acuerdo a cuatro criterios: Actividades Entidades Usuarios administracin En funcin del criterio seleccionado, el usuario final puede ver lo que sucedi en el caso hasta el momento de la consulta: La secuencia de las actividades, los datos modificados por las entidades, los Usuarios involucrados en el caso, la informacin modificada y las actividades que han ejecutado.

El Lo g d e estad o p o r activ id ad es muestra la secuencia de actividades realizadas durante el flujo hasta el momento de la consulta. Se muestra como una tabla y tambin se puede ver grficamente.

Copyright 2013 - Bizagi

1711

Haga clic en el vnculo Detalles, en el registro de actividad, para ver los datos modificados durante la ejecucin. En este registro, se encuentra el nombre de visualizacin de cada atributo que cambi, su valor final y la fecha de modificacin.

1712

Copyright 2013 - Bizagi

El Log de estado por entidades muestra registro de las entidades que han sido modificados durante el proceso.

Al entrar en el vnculo Detalles en este registro, podr ver cada uno de los atributos que se ha modificado. En este registro, se encuentra el nombre para mostrar del atributo, el valor final, el

Copyright 2013 - Bizagi

1713

nombre de la actividad en la que se modific el atributo, el nombre y la posicin del usuario que modific el atributo y la fecha de modificacin. En esta vista, tambin puede filtrar la informacin por atributos o por el usuario, ingresando todo o parte del nombre del atributo o el usuario.

Puede configurar qu entidades requieren un registro en Bizagi Studio. Para ello, vaya a las Propiedades avanzadas de la entidad, haga clic derecho en la entidad y haga clic en P ro p ied ad es av an zad as.

1714

Copyright 2013 - Bizagi

El Log de estado por Usuario muestra los usuarios que han participado en el proceso. Al hacer clic en el enlace de datos en este registro, se puede ver cada una de las entidades y los atributos modificados por el usuario. Dentro de cada registro se puede ver el nombre de la entidad, el nombre para mostrar del atributo, su valor final, la actividad en la que se modific y la fecha.

En este reporte, la informacin tambin se pueden filtrar por entidad o atributo, incluyendo el atributo

Copyright 2013 - Bizagi

1715

o el nombre de usuario completa o parcialmente.

La Administracin muestra el historial de las acciones realizadas por los administradores de Bizagi durante el caso. Este reporte slo se muestra a los administradores.

Es posible realizar dos acciones en este reporte:

1716

Copyright 2013 - Bizagi

Reasignacin de actividades identificadas por el icono . Cuando se despliega esta accin, la informacin adicional mostrar el usuario inicial y el nuevo asignado. Abortar casosidentificado por el icono . Cuando se despliega esta accin, la informacin adicional muestra las razones de abortarlo ingresadas por el administrador.

Consulta grfica
La consulta grfica muestra de forma grfica la trayectoria que el caso se ha seguido, los usuarios implicados y su estado. Esta consulta se puede acceder desde el Inbox, haciendo clic en el icono de co n su lta g rfica. Sin embargo, usted podr acceder desde otros mens donde se encuentra ese icono; como la ventana de resumen del caso o el men de estado de registro, entre otros.

Al hacer clic en el icono de consulta grfica, una nueva ventana se abrir. Aqu se puede ver lo siguiente: Los usuarios que participaron en cada una de las actividades se muestran haciendo clic.

Copyright 2013 - Bizagi

1717

Si hace clic en el botn Estad o actu al, la actividad en la que actualmente es el caso se resalta mediante un recuadro verde alrededor de la figura.

Cuando el caso tiene Subprocesos, puede tener acceso al anlisis grfico haciendo clic en el icono de la lupa.

1718

Copyright 2013 - Bizagi

Si hace clic en el botn Ru ta muestra la ruta completa del proceso se mostrar con una lnea naranja. .

El asignado actual, la fecha de creacin y de solucin del caso se muestran en la esquina inferior izquierda.

Copyright 2013 - Bizagi

1719

Nota La consulta grfico utiliza Silverlight. Este debe ser instalado en cada estacin de trabajo de los usuarios finales (por lo general la primera vez que se usa el navegador muestra la opcin de instalar). Adems, es necesario habilitar el Silv erlig h t M im e Ty p e en el servidor web.

4.1.2

Seguridad del Portal de Trabajo

Bizagi permite restringir el acceso a las diferentes reas de los procesos durante la ejecucin para asegurar que las personas correctas tienen los privilegios necesarios y evitar acciones no autorizadas. Bizagi ofrece el mdulo de seguridad que le permite definir un esquema de permisos en algunos de los elementos. Dos consideraciones de seguridad principales se abordan: El portal como punto de acceso para los usuarios finales. El componente de Autenticacin gestiona y valida el acceso de usuarios al Portal de Trabajo. Bizagi ofrece varios tipos de Autenticacin para satisfacer sus necesidades de negocio. El esquema de permisos en los mens del Portal. El componente de Autorizacin controla el acceso a todas las pginas del Portal de Trabajo. Estos permisos y restricciones se definen por los roles y grupos de usuarios. Los usuarios, asignados a los diferentes roles y grupos de usuarios, pueden se creados directamente desde Bizagi o importados de Windows, por Lightweight Directory Access Protocol (LDAP), entre otros.

1720

Copyright 2013 - Bizagi

Al mdulo de seguridad se accede exclusivamente desde la vista de M d u lo s, seleccionando el Mdulo de Seg u rid ad .

Copyright 2013 - Bizagi

1721

4.1.2.1

Inicio de sesin en el Portal de Trabajo Un usuario debe estar autenticado para acceder al Portal de Trabajo. Bizagi requiere un nombre de usuario y una contrasea para autenticar a un usuario vlido. La Autenticacin le permitir acceder a su Inbox y al resto de mens para los que tiene permisos de acceso. Por defecto los proyectos Bizagi incluirn automticamente al usuario admon. Tenga en cuenta que para poder acceder al Portal de Trabajo usted debe ser creado como un usuario Bizagi. Para probar rpidamente en el Portal, en el ambiente de desarrollo, la pgina de inicio de sesin no se mostrar a menos que haya ms de un usuario creado. Abra el Portal de Trabajo. En la pgina de inicio de sesin, ingrese su nombre de usuario, contrasea y dominio. Haga clic en el botn In iciar sesi n para validar las credenciales introducidas. Si es correcto, el navegador mostrar el Inbox en la pgina principal de Bizagi. Si no, un mensaje de error mostrar por qu no pudo ingresar.

1722

Copyright 2013 - Bizagi

Si todos los usuarios asignados pertenecen al mismo dominio, entonces el campo Do m in io se ocultar.

Copyright 2013 - Bizagi

1723

La pgina de inicio de sesin contiene tres botones: Cambiar contrasea: Permite cambiar la contrasea de la cuenta. Le pedir un nombre de usuario, el dominio y la contrasea actual. A continuacin, escriba una contrasea nueva. Si la opcin pregunta secreta est activada una pregunta y una respuesta debe ser dada. Al hacer clic en el botn Cam b iar co n trase a, el sistema la cambiar o mostrar un mensaje en letras rojas, si hay algn problema. Ha olvidado la contrasea: enva la contrasea a su direccin de e-mail. Si la opcin de la pregunta secreta ha sido habilitada, el sistema requerir la respuesta exacta a la pregunta secreta con el fin de enviar la contrasea. Desbloquear cuenta: Si su cuenta ha sido bloqueada por alguna razn, esta opcin enva una solicitud al administrador del sistema para desbloquearlo. Para llevar a cabo esta tarea, el administrador puede acceder a la opcin So licitu d es P en d ien tes d e u su ario en el Portal de Trabajo. El sistema requiere el nombre de usuario, contrasea, dominio, y un comentario u observacin con el fin de activar la cuenta.

1724

Copyright 2013 - Bizagi

Adicionalmente, hay tres opciones en la parte inferior de esta pantalla: Recordar mi cuenta y la contrasea: Si se selecciona esta opcin, usted tendr acceso al Portal de Trabajo de forma automtica la prxima vez que acceda. Recordar mi cuenta: slo el nombre de usuario se mostrar y la contrasea correspondiente se debe introducir. Siempre pida cuenta y contrasea: Tanto el nombre de usuario y la contrasea tendrn que introducidos cada vez que se conecte.

Copyright 2013 - Bizagi

1725

La visualizacin de estas opciones depende del tipo de Autenticacin y las opciones de Autenticacin. Nota: Cuando se utiliza la autenticacin de Windows o Bizagi se debe habilitar la Sobrescritura automtica de cookies en el Internet Explorer para Recordar cuenta y contrasea. Vaya a:

In tern et Ex p lo rer \ H erram ien tas \ O p cio n es d e In tern et \ P riv acid ad \ O p cio n es A v an zad as \ Co n fig u raci n av an zad a d e p riv acid ad
Si ningn usuario se ha creado, el Portal de Trabajo pedir que ingrese con el usuario por defecto: admon. Este usuario no requiere Autenticacin y se ignoran las reglas de asignacin. En el momento en que se crea el primer usuario, la aplicacin preguntar por las credenciales de Autenticacin.

Ingresar con usuario admon (salta las reglas de asignacin)

Por defecto la contrasea de usuario admon est en blanco. Con el fin de iniciar la sesin como usuario admon siga los siguientes pasos: 1. Abra el Portal de Trabajo y de clic de Lo g in d e A d m in istrad o r.

1726

Copyright 2013 - Bizagi

2. Deje todos los campos tal y como estn incluyendo la contrasea (en blanco). Haga clic en Login. Si la contrasea de admon se cambia, usted tendr que escribir la contrasea elegida. PARA AMBIENTE DE DESARROLLO SOLAMENTE: Si la contrasea de admon se olvida, habilite la opcin H ab ilitar lo g in rp id o en las opciones de A u ten ticaci n en Bizagi Studio. Cambie la contrasea a travs de la Administracin del usuarios.

Copyright 2013 - Bizagi

1727

4.1.2.1.1 Autenticacin

El mdulo de Seguridad en Bizagi incluye un componente de Autenticacin que tiene una gran versatilidad en la gestin y validacin de usuarios. Usted puede elegir el tipo de Autenticacin de una serie de posibilidades para ser ejecutados por el Portal de Trabajo, de acuerdo con las necesidades de su empresa. La Autenticacin necesita que los usuarios hayan sido creados en la base de datos de Bizagi (aunque con ciertos tipos de Autenticacin, informacin como la contrasea no se almacena en Bizagi). Nota Con cualquier tipo de Autenticacin, el superusuario domain/admon debe mantenerse. Cuando este usuario no se asignaa a ningn usuario final especfico (recomendado), usted debe crear y definir un usuario con los mismos privilegios para la administracin de su solucin, manteniendo el domain\admon habilitado.

De forma predeterminada, un proyecto en Bizagi iniciar con la Autenticacin Bizagi. Para ver o cambiar esta configuracin, siga los pasos descritos a continuacin: 1. Vaya a la vista de Mdulos en Bizagi Studio y localice el mdulo de Seg u rid ad. 2. En este mdulo, haga clic en el elemento de A u ten ticaci n .

1728

Copyright 2013 - Bizagi

Observe que el panel de la derecha muestra los diferentes tipos de Autenticacin disponibles. Seleccione uno de la lista desplegable y haga clic en el botn A ctu alizar. La siguiente lista describe brevemente los tipos de Autenticacin en Bizagi. Para obtener ms informacin, consulte los enlaces a los artculos especficos. Autenticacin Bizagi: Permite a Bizagi manejar la autenticacin (dominio, usuarios y sus contraseas se almacenan en Bizagi). Autenticacin Windows: Permite a Bizagi validar los usuarios contra dominios y mquinas de Windows automticamente. Esto se logra delegando la autenticacin a la mquina de Windows del lado del cliente (las contraseas no se almacenan en Bizagi). Usted tambin puede permitir que Bizagi tome las credenciales de sesin de Windows de forma automtica y evitar la pgina de inicio.

LDAP: utiliza un servidor LDAP (Directorio Activo) para verificar la informacin introducida en la pgina de inicio de sesin (nombre de usuario, contrasea y dominio). Durante el uso de la autenticacin con un servidor LDAP, las contraseas no se almacenan en Bizagi. Autenticacin mixta: permite el uso de dos diferentes tipos de autenticacin para usuarios de dominios diferentes. Uno de los tipos de autenticacin debe ser Bizagi, y el otro tipo puede ser Windows o Autenticacin personalizada (ver el siguiente punto).

Autenticacin personalizada: Permite que la autenticacin sea manejada por una aplicacin externa.

Copyright 2013 - Bizagi

1729

Con la autenticacin personalizada, puede desarrollar su propio componente que reemplaza los mtodos utilizados por el componente de autenticacin interna. De esta manera, el propio componente puede utilizar las API de terceros o conexiones para verificar las credenciales (por ejemplo, validar con una base de datos MySQL, archivos XML, bases de datos de un sistema de legado, etc).

3. Un mensaje de confirmacin le indicar que el cambio ha sido guardado. A continuacin, y de acuerdo con el tipo de autenticacin seleccionada, ver opciones adicionales en los puntos de autenticacin interna. Estas pueden variar de acuerdo con el tipo de autenticacin.
4.1.2.1.1.1 Autenticacin Bizagi

La Autenticacin Bizagi est configurada por defecto para todos los proyectos.

Con la autenticacin de Bizagi, hay opciones y parmetros que se despliegan para permitir la configuracin y comportamiento de las sesiones de los usuarios y su administracin, tales como

1730

Copyright 2013 - Bizagi

tiempos de sesin, el nmero de sesiones simultneas, el tiempo de caducidad de la contrasea, entre otros. La siguiente tabla muestra las opciones para configurar, optimizar y personalizar los parmetros para la administracin y autenticacin de usuarios en el Portal de Trabajo:

Opcin Sesiones concurrentes Habilitar bloqueo de cuentas

Descripcin Si est activada, limita el nmero de sesiones abiertas para una cuenta. Define si el mdulo de autenticacin debe bloquear las cuentas cuando el usuario accede a un determinado nmero de intentos de conexin (ver intentos de inicio de sesin mx). Esta configuracin se aplica slo para el desarrollo y medio ambiente de prueba. Cuando se activa, muestra los usuarios creados en una lista desplegable. De esta manera, la contrasea no ser necesaria para iniciar sesin (ptimo para la rpida prueba). Estas listas desplegables soporta 100 usuarios activos. Desde el usuario 101th habr un campo de texto disponible para escribir el nombre. Define si la contrasea debe ser cambiada despus del primer inicio de sesin. Define el nmero de contraseas nicas de una cuenta debe tener antes de utilizar uno antigua. Define si el Portal de Trabajo debe crear un registro de auditora que tienen todos los eventos de autenticacin. Establece un nmero mximo de intentos antes de que la cuenta est bloqueada. Defines the number of days before an account is locked (an account which is not logged on).

Habilitar Login rpido

Forzar cambio de contrasea Validar historial de contrasea Registrar eventos de autenticacin Numero mximo de intentos de ingreso Tiempo de bloqueo de contraseas

Tiempo de expiracin de Define el nmero de das antes de que una cuenta sea bloqueada. la cuenta Mximo tamao de clave Mnimo tamao de clave La clave necesita contener letras La clave necesita contener nmeros Define el nmero mximo de caracteres para la contrasea sea vlida (cero si la longitud mxima no es necesario). Define el nmero mnimo de caracteres para que la contrasea sea vlida. Define si validar o no si la contrasea debe al menos una letra para ser vlida. Define si validar o no si la contrasea debe al menos un nmero para ser vlida.

Copyright 2013 - Bizagi

1731

Mensaje de correo de recordatorio de clave Asunto de recordatorio de clave Tiempo de servicio para solicitudes pendientes Enviar correo cuando se cree una solicitud pendiente Mensaje de correo cuando se enva la clave Asunto del correo cuando se enva la clave

Define el cuerpo del correo que se enva cuando el usuario solicita recordatorio. Define el asunto del correo que se enva cuando el usuario solicita recordatorio. Define el tiempo de servicio para procesar una solicitud pendiente.

Determina si se debe o no enviar una notificacin cuando un usuario solicita el desbloqueo de una cuenta. Define el cuerpo del correo que se enva cuando una cuenta de usuario se crea y la contrasea se enva al usuario. Define el asunto del correo electrnico que se enva cuando una cuenta de correo es creada y la contrasea se enva al usuario. Define el tiempo en minutos, en el que una sesin inactiva expira. En caso de que desee aumentar el tiempo de la sesin ms de 60 minutos (no ideal), entonces usted necesita editar la configuracin en el archivo de configuracin de la aplicacin Web. Esto se hace directamente en el servidor Web (por ejemplo, IIS). Define el cuerpo del correo que se enva al administrador cuando un usuario solicita el desbloqueo de una cuenta. Define el asunto del correo electrnico que se enva al administrador cuando un usuario solicita el desbloqueo de una cuenta. Si esta opcin est activada, la pregunta secreta y campos de respuesta son requieridos. Define el correo electrnico utilizado para enviar notificaciones automticas. Este es tambin el e-mail donde el administrador ser notificado sobre las solicitudes de desbloqueo de cuentas. Si est activado Bizagi valida secuencias en contrasea.

Tiempo de sesin

Mensaje de correo de recordatorio de clave Asunto de correo de recordatorio de clave Usar pregunta secreta

Cuenta de correo del administrador Validar secuencia de contrasear

4.1.2.1.1.2 Autenticacin Windows

El uso de la Autenticacin de Windows en Bizagi, necesita que el usuario ya est creado en Bizagi, y que sea un usuario en el dominio. Cuando no todos los usuarios entran dentro de esta categora, se recomienda utilizar la Autenticacin Mixto que tiene tanto Autenticacin Windows como Autenticacin Bizagi. A travs de la Autenticacin de Windows, el Portal de Trabajo delega el trabajo de autenticacin a la

1732

Copyright 2013 - Bizagi

mquina de Windows en el lado del cliente (ya sea usando un dominio corporativo o un dominio local en la mquina). Si Windows permite el acceso y el usuario existe en Bizagi, el acceso ser exitoso (las contraseas no se almacenan en Bizagi). Adems, puede utilizar una opcin mejorada para esta autenticacin que es que Bizagi tome automticamente las credenciales de sesin de Windows y evitar que una pgina de inicio de sesin para los usuarios finales (por defecto, la configuracin del sitio de IIS para un portal de trabajo Bizagi mostrar la pgina de inicio de sesin) .

Configuracin de la autenticacin de Windows

Para configurar la Autenticacin Windows, seleccione W in d o w s de la lista desplegable:

Haga clic en el botn A ctu alizar. No hay ninguna configuracin adicional en este punto (la Autenticacin Windows no muestra opciones internas). Para que tome Bizagi automticamente las credenciales de sesin de Windows y ocultar la pgina de inicio de sesin se debe configurar el servidor Web, en el propio servidor (IIS).

Evitar la pgina de inicio de sesin

Con el fin de evitar la pgina de inicio de sesin cuando se utiliza la Autenticacin de Windows, los siguientes 2 pasos son necesarios: En primer lugar, desactivar el acceso annimo y habilitar la autenticacin de Windows en la configuracin del sitio Web de IIS.

Copyright 2013 - Bizagi

1733

Por ltimo, permitirle a la configuracin de seguridad en el navegador el envo de las credenciales (ajuste intranet). Este ltimo paso se requiere en cada una de las estaciones de trabajo de los usuarios finales debido al que es probable que la configuracin por defecto del navegador requiera una confirmacin en cuanto se enven las estaciones. 1. Deshabilitar el acceso annimo y habilitar la autenticacin de Windows en el IIS. Para ello, abra el Administrador de IIS, y vaya al Web site en el que corre el Portal de Trabajo Bizagi. Para su sitio web especfico, haga doble clic en Autenticacin:

Asegrese de deshabilitar la autenticacin annima y habilitar la autenticacin de Windows en su lugar:

1734

Copyright 2013 - Bizagi

2. Editar la configuracin en el navegador para enviar las credenciales. Esta configuracin es externa a Bizagi y por lo tanto es probable que se requiera en cada una de las estaciones de trabajo de los usuarios finales. Para modificar estos valores, abra las opciones del navegador de Internet y busque los ajustes de seguridad. En primer lugar, asegrese de que el Portal de Trabajo est como un sitio seguro (lo ms probable es en la intranet). Para ello, haga clic en la zona In tran et lo cal y en el botn Sitio s. A continuacin, haga clic en O p cio n es av an zad as:

En esta ventana, agregue la direccin URL del Bizagi Portal (especifique la ubicacin y haga clic en A g reg ar). El navegador tomar este lugar como un sitio seguro (para poder trabajar con la configuracin de inicio de sesin automtico).

Copyright 2013 - Bizagi

1735

Cierre el cuadro de dilogo. De vuelta a la zona de intranet local, haga clic en N iv el p erso n alizad o :

1736

Copyright 2013 - Bizagi

Busque la opcin A u ten ticaci n d e u su ario , para definir el inicio de sesin automtico se activar A u to m atic lo g o n is en ab led o n ly in In tran et zo n e. Guarde los cambios y haga clic en Aceptar en todas las ventanas. Tenga en cuenta que esto funciona para los sitios de Intranet (como se defini anteriormente para que el Portal Bizagi trabajo est incluido en esta lista), debido a que la configuracin de seguridad predeterminada para Internet Explorer tienen esta configuracin por defecto, y se debe mantener ms restringido. Para otros navegadores como Mozilla Firefox, la configuracin adicional puede ser requerida. Para obtener ms informacin, consulte los enlaces externos, tales como: http:// markmonica.com/2007/11/20/firefox-and-integrated-windows-authentication/.

Importacin de usuarios de LDAP

Sin tener en cuenta el tipo de autenticacin seleccionado para el inicio de sesin Portal de Trabajo, usted puede optar por configurar una programacin en Bizagi para importar y sincronizar los usuarios de su servidor LDAP en Bizagi. Para obtener ms informacin sobre esta opcin, consulte Importacin de usuarios de LDAP.
4.1.2.1.1.3 Autenticacin LDAP

Con la autenticacin LDAP, las credenciales especificadas en la pgina de inicio de sesin (nombre de usuario, contrasea y dominio) se envan a un servidor LDAP para la verificacin. Si el servidor permite el acceso y el usuario existe en Bizagi, el acceso ser exitoso (las contraseas no

Copyright 2013 - Bizagi

1737

se almacenan en Bizagi).

Configuracin de la autenticacin LDAP

Para configurar LDAP como tipo de autenticacin, seleccione LDA P de la lista desplegable:

Haga clic en el botn

Actualizar.

Las siguientes opciones se presentan como elementos internos, que deben ser configuradas: AUTHOPTIONS_LDAP_Path: Corresponde a la ruta de acceso al servidor LDAP (utilizando el formato de URL LDAP).

AUTHOPTIONS_LDAP_UseIntegration: Se aplica si usted ya ha configurado Bizagi para sincronizar los

1738

Copyright 2013 - Bizagi

usuarios del Directorio Activo en Bizagi. Si este es el caso, active esta opcin, para utilizar la misma URL LDAP y la configuracin de los ajustes de sincronizacin de LDAP. Cuando esta opcin est activada, el valor de la primera opcin ser ignorada.

Nota El Directorio Activo de Windows se soporta como para la autenticacin LDAP. Tenga en cuenta que es necesario que la configuracin del sitio Web en el servidor (es decir, IIS), use la autenticacin annima para el Portal de Trabajo.

Importacin de usuarios de LDAP

Sin tener en cuenta el tipo de autenticacin seleccionado para el inicio de sesin Portal de Trabajo, usted puede optar por configurar una programacin en Bizagi para importar y sincronizar los usuarios de su servidor LDAP en Bizagi. Para obtener ms informacin sobre esta opcin, consulte Importacin de usuarios de LDAP.
4.1.2.1.1.4 Autenticacin avanzada

Bizagi ofrece los siguientes tipos de autenticacin de fcil configuracin para sus proyectos: Autenticacin de Windows, Autenticacin Bizagi, y la Autenticacin LDAP. En escenarios complejos en los que los proyectos de Bizagi requieren diferentes tipos de autenticacin o una combinacin de ms de un tipo, existe la posibilidad de utilizar los tipos de Autenticacin Personalizada o Mixta.

Copyright 2013 - Bizagi

1739

Para ms informacin, consulte los temas: Autenticacin personalizada. Autenticacin mixta.

La Autenticacin personalizada le permite definir su propio componente para ser utilizado por la autenticacin del Portal de Trabajo. Esto significa que a travs de esta opcin, puede reemplazar los mtodos utilizados por Bizagi para permitir el acceso a los usuarios finales (aplica a la Edicin Enterprise). La clase de la Autenticacin de su componente personalizado debe tener los siguientes mtodos: public bool authenticate(string sDomain, string sUsername, string sPassword, ref string sErrorMessage) Este mtodo se utiliza para autenticar el usuario en el sistema. El dominio, el usuario y la contrasea se envan como parmetros de entrada y retorna un valor booleano que indica si la autenticacin se es correcta o no. En el ltimo caso, el parmetro sErrorMessage debe ser llenado con el error correspondiente. public void logOff(string sDomain, string sUsername) Este mtodo se utiliza para enviar al sistema remoto una notificacin de que el usuario abandon el sistema, o su sesin ha sido inactivada. public bool changePassword(string sDomain, string sUsername, string sOldPassword, string sNewPassword, ref string sErrorMessage) Este mtodo se utiliza para permitir el cambio de contrasea para las cuentas de usuarios finales (enva al sistema remoto una solicitud de un cambio de contrasea). public bool changePassword(string sDomain, string sUsername, string sOldPassword, string sNewPassword, string sSecretQuestion, string sSecretAnswer, ref string sErrorMessage) Este mtodo se utiliza para permitir el cambio de contrasea para las cuentas de usuarios finales (enva al sistema remoto una solicitud de un cambio de contrasea). A diferencia del mtodo anterior, ste tiene una sobrecarga de informacin de la pregunta secreta y su respuesta.

Nota La configuracin descrita en este artculo no se aplica a la Edicin Enterprise JEE. En Enterprise JEE, la autenticacin se establece en Bizagi Studio como Autenticacin Bizagi. Configuraciones adicionales o diferentes son compatibles, pero es necesario establecerlas directamente en el servidor de aplicaciones JEE (ajustes e implementaciones para el mdulo JAAS).

Configuracin de la Autenticacin personalizada

Para configurar A u ten ticaci n P erso n alizad a como el tipo de autenticacin, seleccinela de lista desplegable:

1740

Copyright 2013 - Bizagi

Haga clic en el botn A ctu alizar. Cuando esta opcin est seleccionada, Bizagi es informado de que la autenticacin ser manejada por un componente externo (desarrollado por un tercero). Por lo tanto, esta opcin requiere que usted: especifique detalles del assembly y de la clase a ser utilizadas por el mdulo de autenticacin, e incluir el assembly en la solucin Bizagi (en el bin de la aplicacin Web). En resumen, la Autenticacin Personalizada tiene las siguientes opciones de configuracin: Componente de Autenticacin Personalizada: Define el nombre del assembly que llevar a cabo la autenticacin. Este assembly debe estar presente en el bin de la aplicacin Web o en el GAC.

Clase de autenticacin personalizada: Define el nombre de la clase que realizar la autenticacin

Copyright 2013 - Bizagi

1741

personalizada dentro del componente especificado.

Una vez que haya definido los parmetros mencionados, en la ejecucin sus usuarios finales introducirn sus credenciales en la pgina de inicio de sesin. Bizagi invocar la clase y el mtodo como se especifica en la configuracin y enviar estas credenciales. Si el usuario no existe en Bizagi y el mtodo personalizado devuelve Verd ad ero , Bizagi permitir el acceso.

Con la Autenticacin Mixta, usted puede utilizar dos tipos de autenticacin diferentes en su solucin Bizagi. La Autenticacin Mixta es la opcin ms comn en los proyectos que tienen los usuarios en ms de un dominio, sobre todo porque en esos escenarios hay usuarios que no pertenecen al mismo dominio corporativo como empleados de back-end (por ejemplo, abogados que participan en los procesos de solicitud de crdito en un banco ). Por ejemplo, si su proyecto es accesible desde la Intranet por cierto tipo de usuarios, y desde Internet por otro conjunto de usuarios, es posible configurar la autenticacin mixta utilizando la Autenticacin de Windows y Autenticacin Bizagi. A travs de este enfoque, los usuarios de la intranet se pueden autenticar mediante la Autenticacin de Windows, y los usuarios de Internet pueden autenticar por el tipo de Autenticacin de Bizagi. Con la Autenticacin Mixto, usted tendr que configurar la Autenticacin Bizagi como uno de los dos tipos de autenticacin. Para ms informacin, consulte Autenticacin Bizagi. El otro tipo de autenticacin se puede configurar como: Autenticacin Windows o Autenticacin Personalizada (aplica para Edidicn Enterprise .NET). Para obtener ms informacin, consulte Autenticacin de Windows. Para obtener ms informacin, consulte Autenticacin personalizada.

1742

Copyright 2013 - Bizagi

Nota La configuracin descrita en este artculo no se aplica a la Edicin Enterprise JEE. En Enterprise JEE, la autenticacin se establece en Bizagi Studio como Autenticacin Bizagi. Configuraciones adicionales o diferentes son compatibles, pero es necesario establecerlas directamente en el servidor de aplicaciones JEE (ajustes e implementaciones para el mdulo JAAS).

Configuracin de Autenticacin Mixta

Para configurar la Autenticacin Mixta, seleccinela de lista desplegable:

Haga clic en el botn A ctu alizar. Las siguientes opciones se presentan como elementos que deben ser configuradas: Autenticacin Bizagi: estas opciones pueden ser configuradas de la misma manera como cuando se utiliza la autenticacin de Bizagi. Bizagi Domain: Especifique el nombre del dominio para los usuarios que van a ser autenticados mediante la autenticacin de Bizagi.

Copyright 2013 - Bizagi

1743

Otro tipo de autenticacin: Seleccione el tipo de autenticacin que utilizar (Windows o Personalizada). La Autenticacin personalizada no est disponible parala Edicin Bizagi Xpress.

La configuracin adicional se presenta de acuerdo con el segundo tipo de autenticacin que se utilizar junto con la Autenticacin Bizagi. Por lo tanto, cuando se actualiza el otro tipo de autenticacin, tendr que configurar ya sea las opciones de Windows o las opciones de Autenticacin Personalizada (de la misma manera como lo hara cuando se elige la autenticacin de Windows o autenticacin personalizada).

1744

Copyright 2013 - Bizagi

4.1.2.1.2 Importar usuarios LDAP

Informacin general
Sin tener en cuenta el tipo de autenticacin seleccionado para el inicio de sesin Portal de Trabajo, usted puede optar por configurar una programacin en Bizagi para importar y sincronizar los usuarios de su servidor LDAP en Bizagi. Con esta opcin, Bizagi ejecutar diariamente un trabajo para mantener al da la informacin de las cuentas '(que residen en un servidor LDAP en su organizacin). Tenga en cuenta que las contraseas se consultarn en funcin del tipo de autenticacin seleccionado (es decir, que si usted elige LDAP o la autenticacin de Windows, Bizagi no almacenar ninguna contrasea).

Lo que hay que hacer en Bizagi

Para configurar y probar la sincronizacin de LDAP en el proyecto, es necesario introducir los detalles de configuracin en su servidor LDAP, como por ejemplo: las credenciales de conexin de la URL, y la configuracin de importacin o mapeos. Esto se hace fcilmente a travs de las pestaas de la configuracin de LDAP en Bizagi Studio, siguiendo los siguientes pasos: 1. Introducir la conexin y la configuracin de importacin. La sincronizacin se lleva a cabo con una cuenta de dominio autenticado. 2. Especificar de mapeo de atributos. La informacin de cuentas LDAP se sincroniza en la entidad de WFUSER. Al especificar el mapeo de los atributos usted define en qu atributos de WFUSER se debe guardar la informacin entrante. 3. Definir valores por defecto (si los hay). Este paso es opcional y se recomienda para definir valores por defecto para los atributos de WFUSER.

Copyright 2013 - Bizagi

1745

4. Probar y guardar la configuracin. Usted puede probar inmediatamente su sincronizacin con el fin de revisar y asegurarse de que la configuracin es correcta. Esto no va a actualizar ninguna informacin en el proyecto (slo para propsitos de prueba). 5. Reiniciar el servicio de Programador. Como se ha sealado antes, hay que tener en cuenta que la sincronizacin de LDAP se pueden probar directamente en Bizagi Studio. Sin embargo, la sincronizacin real de las cuentas de LDAP (objetos) lo lleva a cabo el servicio de Programador en su proyecto. Por lo tanto, para inicializar la sincronizacin y ver realmente sus usuarios en su Portal de Trabajo, tendr que reiniciar el servicio Programador. Nota Tambin puede optar por modificar posteriormente estos valores para un ambiente especfico del proyecto (ambiente de pruebas o de produccin). Para revisar o modificar la sincronizacin LDAP en un ambiente determinado, utilice la Consola de Administracin de Bizagi.

Configurar la sincronizacin LDAP

Vamos a ilustrar cmo configurar la sincronizacin LDAP en Bizagi. En el siguiente ejemplo, vamos a configurar la sincronizacin con el Directorio Activo de Microsoft. 1. Introducir la conexin y la configuracin de importacin. Esta configuracin inicial se realiza en la primera pestaa llamada Co n fig u raci n B sica. Para ello, primero active la sincronizacin del LDAP marcando la casilla H ab ilitad o . A continuacin, asegrese de llenar la conexin y la configuracin de importacin como se describe a continuacin:

Configuracin Comexin LDAP URL

Descripcin Especifique la ruta o URL para acceder al servidor LDAP (formato de URL LDAP). Especifique un nombre de usuario y su dominio, para ser utilizado como el usuario autenticado que realiza la sincronizacin. Especifique la contrasea de usuario del dominio utilizado como el usuario autenticado que realiza la sincronizacin. Defiar una hora del da para que el Programador realice la sincronizacin LDAP. Los valores permitidos para este campo son de 0 a 23. Introduzca un filtro para importar slo las cuentas

Dominio\usuario

Clave

Hora de sincronizacin

Configuraci

FIltro

1746

Copyright 2013 - Bizagi

n de importacin

correspondientes al proyecto (de acuerdo con un criterio de atributos LDAP). Se recomienda usar y configurar una condicin de filtrado con el fin de importar el conjunto adecuado de los usuarios (especialmente al probar la configuracin). Dominio Especifique el nombre del dominio al que los usuarios sern registrados en la entidad de usuario de Bizagi (WFUSER). Seleccione el atributo LDAP que identifica de forma nica cada cuenta. Por ejemplo, sAMAccountName es el atributo LDAP correspondiente al nombre de la cuenta de un usuario.

Identificador de cuenta de usuario

En este ejemplo, hemos creado todos estos valores:

2. Especificar de mapeo de atributos. Pase a la siguiente pestaa llamada M ap eo d e LDA P y asegrese de agregar las asignaciones necesarias para los atributos de la WFUSER. Para hacer esto, primero haga clic en el botn A g reg ar M ap eo .

Copyright 2013 - Bizagi

1747

Seleccione los atributos de la Entidad WFUSER y hgalas coincidir con un atributo LDAP, que tiene la informacin entrante:

Note que en este ejemplo se ilustra el mapeo del correo y el nombre (recomendado). 3. Definir valores por defecto (si los hay). Pase a la siguiente pestaa llamada Valo res p o r d efecto y aada todos los valores predeterminados de los atributos necesarios para su WFUSER. Para hacer esto, primero haga clic en el botn A g reg ar Valo r p o r d efecto . Seleccione los atributos de la Entidad WFUSER y asignarles un valor:

1748

Copyright 2013 - Bizagi

Nota No especifique que el atributo H ab ilitad o (en ab led ) se establezca en Verdadero, a menos que est completamente seguro de que su licencia actual admitir el nmero de usuarios importados. Tenga en cuenta que si el nmero total de usuarios activos es mayor que el nmero de usuarios con licencia, el Portal de Trabajo dejar de funcionar. 4. Probar y guardar la configuracin. Una vez que haya terminado la configuracin, puede hacer clic en el botn Test LDA P para ver los resultados de sincronizacin. Observe que esto puede tomar un tiempo si tiene un gran nmero de usuarios y, por tanto, se recomienda utilizar un criterio de filtrado. Se mostrarn los registros encontrados en la ltima pestaa llamada Resu ltad o s d e la p ru eb a:

Copyright 2013 - Bizagi

1749

Por ltimo, guarde la configuracin:

5. Reiniciar el servicio de Programador. Para iniciar la importacin y sincronizacin real, tenga en cuenta que es necesario reiniciar el servicio Programador. Para ello, puede utilizar la Consola de Administracin de Bizagi. El trabajo del Programador iniciar la ejecucin de la sincronizacin en la hora definida. Cuando se ha completado, los usuarios de LDAP se crearn automticamente como usuarios de Bizagi. Para revisar la informacin de la sincronizacin ejecutada (valores incluidos y actualizados), puede consultar los detalles que Bizagi guarda en los traces del Programador. El archivo de registro del Programador se iniciara con la lnea como INFO_LDAP . Para obtener ms informacin sobre cmo habilitar las trazas, se refieren al control de errores y diagnsticos. Nota Al sincronizar sus usuarios, Bizagi slo importar como "Activo", el nmero de usuarios soportados por su licencia activa.

1750

Copyright 2013 - Bizagi

4.1.2.1.2.1 Atributos LDAP

El siguiente artculo presenta una breve descripcin de atributos LDAP comunes. Dichos atributos pueden ser mapeados directamente en los atributos de la Entidad de Sistema WFUser de Bizagi a travs de la funcionalidad de sincronizacin LDAP. Para mayor informacin acerca de esta funcionalidad, consulte Importar usuarios LDAP. La siguiente tabla muestra cmo referenciar atributos en su servidor LDAP con informacin que puede ser til en sus usuarios finales de Bizagi. Atributo LDAP Ejemplo Se refiere al pas o regin. Muy probablemente contendr un cdigo ISO de dos letras del pas. Ejemplo: c=DE CN=Guy Thomas. En realidad, este atributo LDAP est conformado por givenName unido con SN. Se refiere a la Compaa (o nombre de la organizacin). Lo que se ve en el Directorio Activo de Usuarios y Computadores. No se debe confundir con displayName en la hoja de propiedades de Usuarios. displayName = Guy Thomas. Si se crea un script en esta propiedad, asegrese de entender cul campo est configurando. DisplayName puede confundirse con CN o description. Se refiere al componente del dominio, ya sea un componente, una etiqueta o un nombre de dominio DNS. Ejemplo: DC=cp, DC=com DN es sencillamente el atributo LDAP ms importante. CN=Jay Jamieson, OU= Newport,DC=cp,DC=com Primer nombre. name = Guy Thomas. Exactamente el mismo que CN. Define la categora de esquema del directorio activo. Por ejemplo, objectClass = Person objectClass = User. Tambin usado para Computador (Computer), organizationalUnit, y hasta container (contenedor). Contenedor de alto nivel importante. Define la unidad Organizacional. Ejemplo: OU=Newport Oficina! en la hoja de propiedad general del usuario.

cn company description

displayName

dc

DN - also distinguishedName givenName name (nombre) objectCategory

objectClass

ou physicalDeliveryOffice Name

Copyright 2013 - Bizagi

1751

Atributo LDAP sAMAccountName SN st

Ejemplo sAMAccountName = guyt. Antiguo nombre de inicio de sesin de NT 4.0, debe ser nico en el dominio. Puede confundirse con CN. SN = Thomas. Esto ser referido como apellido. Contiene el Estado o provincia. Ejemplo: ST=California. Contiene la direccin (primera linea). Ejemplo: street=15 Main St. Contiene nmeros telefnicos. Ejemplo: telephoneNumber=+1 234 567 8901 Usado para deshabilitar una cuenta. Un valor de 514 deshabilita la cuenta, mientras 512 alista la cuenta para inicio de sesin. userPrincipalName = guyt@CP.com Casi siempre abreviado UPN, y luce como una direccin de correo electrnica. Muy til para inicio de sesin especialmente en un gran bosque. Note que el UPN debe ser nico en el bosque.

street

telephone number

userAccountControl

userPrincipalName

La siguiente tabla muestra otros atributos que se encuentran en el intercambio: Atributo de Intercambio homeMDB legacyExchangeDN Descripcin

Aqu es donde se pone el MailStore Nombre distinguido de legado para crear contactos. En el siguiente ejemplo, Guy Thomas es un contacto en el primer grupo administrativo de GUYDOMAIN: /o=GUYDOMAIN/ou=first administrative group/ cn=Recipients/cn=Guy Thomas Un atributo fcil pero importante. Una simple direccin SMTP es todo lo que se requiere billyn@ourdom.com Normalmente es el mismo valor como en sAMAccountName, pero puede ser diferente si as se desea. Requerido para contactos de correo habilitados. Otro campo directo, slo use el valor: Verdadero (True) Intercambia necesidades para saber cul servidor enva el correo. Ejemplo: /o=YourOrg/ou=First Administrative Group/cn=Configuration/ cn=Servers/cn=MailSrv Como el nombre 'proxy' sugiere, es posible que un destinatario tenga ms de una direccin de correo electrnico. Ntese la escritura en

mail

mailNickname

mDBUseDefaults msExchHomeServerNa me

proxyAddresses

1752

Copyright 2013 - Bizagi

Atributo de Intercambio plural de proxyAddresses. targetAddress

Descripcin

SMTP:@ e-mail address. Note que SMTP es sensible a escritura en maysculas o minsculas. Todo en letra mayscula significa la direccin por defecto. Muestra el contacto en la lista de direcciones global.

showInAddressBook 4.1.2.2

Seguridad para mens del Portal En Bizagi usted puede configurar permisos de acceso a los diferentes elementos del Portal de Trabajo, para restringir a los usuarios finales la modificacin o consulta de cierta informacin relevante al desempeo y administracin de los proyectos. Cuando se restringe un elemento a un usuario, este no podr ver el elemento en el Portal de Trabajo. Tan pronto como se asigna alguna restriccin a un elemento (ya sea permitir o denegar), Bizagi asumir que el elemento esta restringido. El elemento restringido solo ser visible para los usuarios con permisos de acceso a ese elemento. Los permisos de acceso a los diferentes elementos del Portal de Trabajo se administran a travs de la definicin de Roles y Grupos de Usuarios.

En el componente de A u to rizaci n usted puede administrar los accesos de los siguientes items:

Copyright 2013 - Bizagi

1753

MEN Anlisis

DESCRIPCIN Permite o restringe acceso a informacin de Procesos especficos en las Herramientas de Anlisis. Si el acceso se restringe para un Proceso especfico, usted podr acceder el men de Reportes, pero usted no podr ver ese Proceso en el Monitoreo de Actividades de Negocio BAM, Sensores ni en el Anlisis de Tareas y Procesos.

Aplicaciones

Permite o restringe acceso a Aplicaciones. Estos permisos se configuran para cada aplicacin individualmente. Si el acceso se restringe para una aplicacin especfica, usted no podr crear nuevos casos de procesos que pertenezcan a esa aplicacin; tampoco podr ver casos relacionados a esos Procesos en su Inbox. Usted debe saber que un usuario, pese a ser restringido a una Aplicacin, podr seguir siendo asignado a Procesos relacionados a ella pero no podr acceder a sus tareas. Por esta razn sea cuidadoso al implementar esta restriccin.

Notas de Caso Entidades

Permite o restringe acceso a las Notas del Caso. Permite o restringe privilegios de administracin a Entidades Paramtricas en el Portal de Trabajo. Estos permisos se configuran para cada entidad individualmente. Los privilegios de administracin que se pueden configurar son: Control Total: Permite administracin total de una entidad, es decir, si se concede, el usuario podr crear nuevos registros de la entidad as como ver, modificar o eliminar los existentes. Ver Datos: Si se concede, el usuario nicamente podr ver los registros de la entidad. Estos registros no podrn ser modificados.

1754

Copyright 2013 - Bizagi

Modificar: Si se concede, el usuario podr ver y modificar los registros de la entidad, pero no podr crear nuevos registros. Crear: Si se concede, el usuario podr crear nuevos registros en la entidad pero no podr modificar los registros existentes. Administracin Permite o restringe la administracin de Alarmas, Items de trabajo de actividades asncronas, casos, usuarios por defecto y perfiles. Permite o restringe la creacin de nuevos casos. Estos permisos se conceden para cada Proceso individualmente. Si se restringe para un Proceso especfico, usted no podr crear nuevos casos de ese Proceso; sin embargo, usted podr ser asignado a las actividades de ese Proceso. Pginas Controla el acceso a las pginas de mens y sub-mens del Portal de Trabajo. Estos permisos se conceden para cada pgina individualmente. IMPORTANTE: En el men de Analysis, los permisos aplicados al men To d o s lo s Rep o rtes se heredan para los sub-mens. Esto quiere decir que si se restringe el acceso a To d o s lo s rep o rtes usted no podr acceder a ninguno de sus directorios de nivel ms bajo (sub-mes). Polticas Permite o restringe acceso a Polticas. Estos permisos se conceden para cada poltica individualmente. Si se restringe el acceso a una poltica especfica, esta no ser visible en el men de Polticas de negocio del Portal de Trabajo; consecuentemente, usted no podr acceder a ella. Consultas Permite o restringe acceso a Consultas de Caso. Estos permisos se conceden para cada consulta individualmente. Si se restringe el acceso a una Consulta especfica, esta no ser visible en el men de Consultas del Portal de Trabajo; consecuentemente, usted no podr acceder a ella.

Creacin de Casos

Copyright 2013 - Bizagi

1755

Vocabularios

Permite o restringe acceso a la Administracin de Vocabularios. Estos permisos se conceden para cada definicin individualmente. Si se restringe el acceso a una Definicin especfica, esta no ser visible en el men de Polticas de negocio del Portal de Trabajo; consecuentemente, usted no podr acceder a ella.

4.1.2.2.1 Dar acceso a los mens del Portal

Para ilustrar como conceder y restringir acceso a los mens del Portal de Trabajo utilizaremos el siguiente ejemplo: Asuma que en un Proceso de Solicitud de Vacaciones se han definido cuatro Roles: A n aly sis (A n lisis), M an ag em en t (Gesti n ), Directo r (Directo r) y Vacatio n Req u ester(So licitan te d e Vacacio n es). Los siguientes permisos se seleccionan para estos roles:

Conceder Permisos de Acceso para Creacin de Casos

En el Proceso de Solicitud de Vacaciones, solo ciertos empleados pueden solicitar vacaciones. Por esta razn se cre el Rol de Solicitante de Vacaciones (Vacation Requester). Este rol se asigna a cada empleado que aplique. Solo los empleado que posean el Rol de Solicitante de Vacaciones (Vacation Requester) podrn crear casos del Proceso de Solicitud de Vacaciones. Para conceder permisos de acceso para la creacin de casos, siga el procedimiento que se describe a continuacin: 1. Vaya al modulo de Seg u rid ad en la vista de mdulos.

1756

Copyright 2013 - Bizagi

2. Expanda las O p cio n es d e A u to rizaci n . Luego vaya a la opcin N u ev o s caso s, seleccione la aplicacin y Proceso donde se configurarn los permisos de acceso. Para este caso, la aplicacin es So licitu d d e Vacacio n es y el Proceso es So licitu d d e Licen cia d e Vacacio n es.

Copyright 2013 - Bizagi

1757

3. Observe que se muestran nuevas opciones en el panel de la derecha. D clic en A g reg ar Ro l d e Usu ario para definir los roles autorizados para creacin de casos. La misma configuracin aplica si se seleccionan Grupos de Usuarios dando clic en A g reg ar Gru p o d e Usu ario s.

1758

Copyright 2013 - Bizagi

4. En la nueva ventana seleccione el Rol a incluir, en la lista desplegable, y d clic en O K.

Copyright 2013 - Bizagi

1759

5. Como el Rol seleccionado debera estar habilitado para la creacin de casos, d clic en el Rol y seleccione la opcin P erm itir para N u ev o Caso . D clic en O K.

1760

Copyright 2013 - Bizagi

El Rol Solicitante de Vacaciones (Vacation Requester) ha sido habilitado para crear casos de Solicitud de Vacaciones. Cualquier usuario que no posea este Rol, no podr crear nuevos casos en este Proceso.

Funcionamiento general de la Autorizacin

Lo siguiente aplica a nivel general para los items bajo configuracin de Autorizacin: 1. Cuando no existe una configuracin explcita de Autorizacin (p.e para iniciar nuevos casos), entonces y por defecto, todos los usuarios (los roles y grupos de usuarios) sern autorizados (p.e, todos podran iniciar un nuevo caso). 2. Cuando slo hay una definicin de cierto role o grupo de usuarios autorizado (explcitamente permitido), entonces los otros usuarios que no estn contenidos en dicha definicin, por defecto no estarn autorizados (denegados). Lo mismo aplica en sentido contrario; donde al tener slo una definicin de un rol o grupo de usuarios denegados, se resultar en conceder la Autorizacin a los dems usuarios no contenidos en esta definicin (quedan permitidos). Si se tienen definiciones de: un rol o grupo de usuarios con acceso denegado, y adems otro rol o grupo de usuarios con acceso permitido, entonces los dems usuarios no contenidos en estas definiciones no tendrn acceso por defecto (sern denegados). Esto quiere decir, que cuando haya por lo menos una definicin explcita de un rol o grupo de usuarios autorizados, entonces los usuarios que no estn explcitamente autorizados quedarn como

Copyright 2013 - Bizagi

1761

denegados. 3. Si se tienen definiciones donde: un rol o grupo de usuarios con acceso denegado, y adems otro rol o grupo de usuarios con acceso permitido, y ante un eventual caso donde haya un usuario que pertenezca a ambas definiciones, entonces este usuario no tendr acceso. Esto quiere decir, que prima siempre la defincin de denegacin de autorizacin sobre el permiso, dado caso de ambigedad.

Conceder Permisos de Acceso a Entidades

Asuma que el Proceso de Solicitud de Vacaciones tiene una entidad paramtrica llamada Razn de Rechazo ( Rejectio n Reaso n ) donde se definen las posibles razones para el rechazo de una solicitud. Se deben definir los siguientes permisos de acceso para la entidad de acuerdo a los Roles en la Organizacin. El Rol de Director ( Directo r) puede ver y modificar los valores de la entidad Razn de Rechazo ( Rejectio n Reaso n ) , es decir, debe poseer privilegios de Control Total sobre la entidad. El Rol de Gestin ( M an ag em en t) puede ver los valores de la entidad Razn de Rechazo ( Rejectio n Reaso n ) pero no podr editarlos. El Rol de Anlisis (Analysis) no podr ver ningn dato de la entidad Razn de Rechazo ( Rejectio n Reaso n ) en absoluto. Para configurar los permisos de acceso para entidades, siga el procedimiento descrito a continuacin: 1. Vaya al modulo de Seg u rid ad en la vista de mdulos.

1762

Copyright 2013 - Bizagi

2. Expanda las O p cio n es d e A u to rizaci n . Luego vaya a la opcin En tid ad es, seleccione la entidad a la cual se configurarn los permisos de acceso. Para este caso, la entidad es Razn de Rechazo ( Rejectio n Reaso n ).

3. Observe que se muestran nuevas opciones en el panel de la derecha. D clic en A g reg ar Ro l d e Usu ario para definir los roles. La misma configuracin aplica si se seleccionan Grupos de Usuarios dando clic en A g reg ar Gru p o d e Usu ario s.

Copyright 2013 - Bizagi

1763

4. Incluya los Roles para definir los privilegios de acceso a la entidad. Para este caso incluya Director ( Directo r), Gestin (M an ag em en t) y Anlisis (A n aly sis).

1764

Copyright 2013 - Bizagi

5. Para cada Rol o Grupo de Usuarios, permita o restrinja los permisos de acceso segn corresponda: Para el Rol Director ( Directo r) marque la opcin P erm itir en la opcin Co n tro l To tal. Esto conceder control total de la entidad Razn de Rechazo ( Rejectio n Reaso n ) a los usuarios con Rol Director (Directo r). Observe que las opciones Ver Dato s, M o d ificar y Crear se activarn automticamente.

Copyright 2013 - Bizagi

1765

Para el Rol Gestin ( M an ag em en t) marque la opcin P erm itir en la opcin Ver Dato s. Esto permitir consultar los valores de la entidad Razn de Rechazo ( Rejectio n Reaso n ) a los usuarios con Rol Gestin ( M an ag em en t), pero no les permitir crear nuevos registros.

1766

Copyright 2013 - Bizagi

Para el Rol Anlisis ( A n aly sis) marque la opcin Den eg ar en la opcin Co n tro l To tal. Esto restringir a los a los usuarios con Rol Anlisis ( A n aly sis) el acceso a la entidad. Observe que las dems opciones se deshabilitarn.

Copyright 2013 - Bizagi

1767

Cuando finalice d clic en O K para guardar los cambios.

Conceder Permisos de Acceso a Consultas

Debido a que las consultas se utilizan para buscar casos que cumplan con criterios definidos y realizar anlisis, solo las personas encargadas del anlisis del desempeo de los Procesos deberan poder acceder a ellas. Creamos el grupo de Usuarios Grupo de Anlisis de Procesos ( P ro cess A n aly sis g ro u p ) donde incluimos los Roles de Anlisis ( A n aly sis) y ( Gesti n ) .

1768

Copyright 2013 - Bizagi

Para configurar los permisos de acceso a las consultas para roles o grupos de usuario, siga el procedimiento descrito a continuacin: 1. Vaya al modulo de Seg u rid ad en la vista de mdulos.

2. Expanda las O p cio n es d e A u to rizaci n . Luego vaya a la opcin Co n su ltas y seleccione la consulta a la cual se configurarn los permisos de acceso. Para este caso, la consulta es Consulta de Vacaciones

Copyright 2013 - Bizagi

1769

( Vacatio n s Q u ery ).

3. Observe que se muestran nuevas opciones en el panel de la derecha. D clic en A g reg ar Gru p o d e Usu ario s para administrar los permisos de acceso.

1770

Copyright 2013 - Bizagi

4. Incluya los Grupos de Usuario para los cuales configurar los permisos de acceso a la Consulta. En este caso incluya el Grupo de Anlsis de Procesos ( P ro cess A n aly sis Gro u p ).

5. Al grupo se le concedern permisos para Ver Datos, Exportar y Analizar la Consulta. D clic en el grupo y seleccione P erm itir en todas las opciones disponibles. Finalmente d clic en O K.

Copyright 2013 - Bizagi

1771

Nota: El procedimiento que acabamos de describir es similar para todos loe elementos en este Mdulo.

4.1.2.3

Seguridad del caso Existen compaas en las cuales el manejo de la informacin es un tema delicado que requiere de un control especial para limitar la exposicin de la informacin a ciertos usuarios. Por ello se requiere poder definir la autorizacin del acceso a la informacin en el portal de trabajo, indicando qu usuarios tienen permisos sobre un caso y cules no estn autorizados para ver informacin privilegiada. En un escenario sin personalizacin de la seguridad, cualquier usuario puede buscar un caso y en la tabla de resultados puede acceder a toda su informacin relacionada. Sin embargo esta informacin puede ser confidencial y requerira ser restringida para que slo algunos usuarios pudiesen verla y estudiarla. De acuerdo a las necesidades de cada proyecto, se pueden definir dos tipos de usuario en Bizagi para un caso: Usuarios sin privilegios no pueden ver informacin alguna del caso. Usuarios con privilegios pueden ver toda la informacin de un caso.

1772

Copyright 2013 - Bizagi

Los usuarios con privilegios sern: Aquellos que hayan trabajado en el caso El creador del caso. Los usuarios que hayan estado asignados. El mtodo de asignacin a Todos har que todos los usuarios que puedan tomar un caso queden automticamente incluidos en la lista de usuarios privilegiados. Usuarios adicionados por medio de una expresin que les permita el acceso.

La seguridad debe ser definida a nivel de Proceso desde la vista de Mdulos. Los procesos pueden tener tres posibles niveles de seguridad que se aplicar a cada uno de los casos creados. Pblico: cualquier usuario puede buscarlo y ver toda su informacin. Privado: slo tienen acceso a l los usuarios privilegiados. Como el padre (aplica para los sub-procesos): la seguridad ser compartida entre el caso padre y el hijo (o subproceso). Si el caso padre tiene seguridad Privada todas las personas que tengan privilegios sobre el caso padre podrn observar el caso hijo y al contrario. Si el caso padre tiene seguridad pblica, todos los casos del padre y del hijo podrn ser vistos por todos los usuarios.

Copyright 2013 - Bizagi

1773

Caso Privado

Seguridad Como el Padre

1774

Copyright 2013 - Bizagi

Los usuarios delegados podrn ver los casos que se han asignado a ellos en su lista de pendientes. Sin embargo si no hacen parte de la lista de Usuarios con privilegios, no podrn buscarlos a travs del motor de consultas.

Escenarios de Seguridad del Caso

En el portal de trabajo de Bizagi es posible acceder a los casos por varios lugares:
Bsqueda por nmero de caso. Carpetas inteligentes. Consultas. Lista de Casos pendientes. Para los tres primeros escenarios aplicar la seguridad por caso. Es decir, si un usuario hace parte de los usuarios privilegiados tendr acceso a la informacin de caso que se encuentre por cualquiera de esos medios. La lista de pendientes NO TIENE seguridad por caso. Si un usuario tiene asignado un caso o ha sido delegado, el caso SIEMPRE aparecer en su lista de pendientes y podr acceder a l y a toda su informacin. La seguridad debe ser definida en el desarrollo del proyecto. No es posible configurarlo en produccin porque la seguridad est atada a toda la vida del caso por lo tanto no es posible incluirla en la mitad de un caso existente. Si se requiere hacer cambios a la seguridad de los casos en produccin, se deben hacer en ambiente de desarrollo y luego hacer un deployment.

Administrador de Negocio o sper usuario

La seguridad por caso tiene un rol que est siempre por defecto disponible para todos los usuarios, llamado B A B u sin ess A d m in istrato r. Cualquier usuario que est vinculado a este rol podr buscar cualquier caso sin restricciones. Es decir siempre ser Privilegiado en todos los Procesos.

Expresiones para permitir o restringir acceso

Copyright 2013 - Bizagi

1775

Bizagi proporciona un conjunto de funciones que permiten adicionar o remover usuarios de la lista de personas con acceso a un caso abierto determinado, por medio de Expresiones. Las funciones permiten: Adicionar un usuario Adicionar una lista de usuarios Remover un usuario Remover una lista usuarios

Funciones de Seguridad de Casos

CHelper.GrantCaseAccess(int idCase, int idUser): Agrega el usuario a la lista de usuarios privilegiados. CHelper.GrantCaseAccessToUsers (int idCase, Arry Users): Agrega varios usuarios a la lista de privilegiados. CHelper.RevokeCaseAccess(int idCase, int idUser): Elimina un usuario de la lista de privilegiados. CHelper.RevokeCaseAccessToUsers (int idCase, Array Users): Elimina varios usuarios de la lista de privilegiados. Las funciones utilizan dos parmetros: el identificador nico del caso y el identificador de los usuarios. Cuando es un solo usuario se recibe el entero del identificador del usuario. Cuando son varios usuarios se recibe un arreglo de identificadores de usuarios. Los identificadores son enteros que se crean automticamente en Bizagi en cada registro. Por lo tanto cada caso tiene su identificador nico, al igual que cada usuario. NUNCA Y POR NINGN MOTIVO se debe escribir en una expresin el identificador del usuario dejndolo fijo. Para conseguir los identificadores Bizagi proporciona una serie de mtodos que permiten consultarlos. Por ejemplo, el mtodo CH elp er.g etUsersF o rRo le retorna un arreglo con los ids de los usuarios que pertenecen a un role determinado. Para acceder al identificador de los casos se recomiendan estas funciones: Me.Case.Id: Retorna el id del caso en el que se est actualmente. CHelper.getSiblingProcessesId (Me, iWfClassId): Devuelve un arreglo de id de casos, de subprocesos creados desde el mismo caso padre. CHelper.getSubProcessesId (Me): Devuelve un arreglo de casos, de sub-procesos del caso padre actual.

Ejemplo de seguridad de Caso usando expresiones

En un proceso de Solicitud de Compras se desea restringir la informacin de forma que slo puedan acceder a los casos creados el usuario creador y su jefe. De acuerdo a lo explicado anteriormente, los usuarios que sean asignados durante el proceso del caso tendrn acceso. El usuario creador, por definicin, automticamente ser adicionado a la lista de usuarios con privilegios. Sin embargo, el jefe del usuario debe ser agregado por medio de una regla para que tambin pueda tener acceso al caso desde la primera actividad. Para lograr lo anterior se debe configurar el proceso para que tenga seguridad de caso Privado, y luego agregar una expresin que incluya al jefe del creador como usuario privilegiado.

1776

Copyright 2013 - Bizagi

1. En la vista de Mdulos ingrese a las propiedades del Proceso dando clic sobre su versin.

2. Seleccione la opcin Caso s p riv ad o s (Private cases) para restringir el acceso de los casos y de clic en O K.

Copyright 2013 - Bizagi

1777

3. En el paso nmero 4 (cuatro) del Asistente de Procesos, vaya a Acciones de la Actividad para crear una expresin al entrar en la actividad de registro. La regla debe agregar a la lista de usuarios privilegiados al jefe del usuario que crea la solicitud.

1778

Copyright 2013 - Bizagi

//Obtain the direct supervisor Boss=Me.Case.WorkingCredential.UserProperties['idbossuser']; //Grant Access to the supervisor CHelper.GrantCaseAccess(Me.Case.Id,Boss); Ahora probemos si la expresin funciona. Suponga que tenemos tres usuarios:

Copyright 2013 - Bizagi

1779

Usuario Creador (CreatorUser): Ser el usuario que crea el caso. Jefe (Boss): El supervisor del creador del caso. Usuario Restringido (RestrictedUser): El usuario al cual se debe restringir el acceso.

Ingrese con el usuario creador del caso (CreatorUser) y cree un nuevo caso de Solicitud de Compras.

El Usuario creador se incluir automticamente como usuario privilegiado y por lo tanto podr consultar el caso en cualquier momento. Ingrese el nmero de casos en el campo de bsqueda. Para este ejemplo ser 204.

1780

Copyright 2013 - Bizagi

Si da clic en el N m ero d e Caso usted podr ver su informacin.

Similarmente el usuario jefe (Boss), a quien se concedieron permisos previamente como es supervisor del credor del caso, tambin tendr acceso.

Si ingresamos con el usuario restringido (RestrictedUSer), no podremos acceder al caso.

Seguridad compartida con Sub-Procesos

Los sub-procesos se pueden crear con Seguridad Co m o el P ad re para que los usuarios que tengan

Copyright 2013 - Bizagi

1781

privilegios sobre el caso padre tengan tambin sobre el hijo (sub-proceso) y viceversa. En el proceso de Solicitud de Compras utilizado anteriormente, una vez el jefe aprueba la solicitud se abre un subproceso de Co tizacio n es.

La persona encargada de hacer las cotizaciones, (un usuario llamado Q u o tatio n s) ser asignada. Dado que es un usuario asignado, podr ver el caso del sub-proceso y su informacin en su bandeja de Pendientes. El usuario Q u o tatio n s podr ver su actividad pendiente en la lista de pendientes Y ADEMS tendr privilegios sobre el caso padre. 1. En la vista de Mdulos ingrese a las propiedades del proceso dando clic sobre su versin.

1782

Copyright 2013 - Bizagi

2. En la ventana de Propiedades seleccione la seguridad Co m o el P ad re.

Copyright 2013 - Bizagi

1783

Con esta informacin los usuarios privilegiados del sub-proceso podrn tener acceso a toda su informacin y a la informacin del caso padre.

1784

Copyright 2013 - Bizagi

Private security with Sub-Processes

Los sub-procesos que no tengan seguridad Como el Padre se comportan como los dems procesos. Pblicos o Privados. En el caso de que sean privados los usuarios con privilegios sobre el subproceso NO tendrn privilegios sobre el caso padre. De la misma manera los usuarios con privilegios sobre el padre no tendrn privilegios sobre el sub-proceso. En el proceso de Solicitud de Compras utilizado anteriormente, una vez el jefe aprueba la solicitud se abre un sub-proceso de Cotizaciones. La persona encargada de hacer las cotizaciones (usuario Quotations), ser asignada. Dado que es un usuario asignado podr ver el caso del sub-proceso y su informacin en su bandeja de Pendientes. Como el sub-proceso NO tiene seguridad Co m o el p ad re, el usuario Q u o tatio n s podr ver su actividad pendiente en la lista de pendientes. Sin embargo NO tendr privilegios sobre el caso padre.

El usuario Q u o tatio n s NO es parte de los usuarios privilegiado y NO podr acceder a la informacin del caso padre a travs del motor de bsqueda. Por esta razn Bizagi mostrar un mensaje informando que no tiene permisos, cuando intente accederlo.

Agregar un usuario privilegiado usando una expresin

En un proceso de Solicitud de Compras se desea restringir la informacin de forma que slo puedan acceder a los casos creados los usuarios privilegiados (creador y asignados) y adicionalmente el Vicepresidente Comercial, quien no tiene asignaciones en dichos casos.

Copyright 2013 - Bizagi

1785

Por lo anterior es necesario aadir al usuario vicepresidente a los usuarios privilegiados utilizando una expresin. Para ello, creamos una tabla paramtrica en donde guardaremos el Usuario Vicepresidente Comercial, de forma que podamos acceder fcilmente al identificador del usuario y que ste pueda ser administrado en caso de que cambie. Esta entidad paramtrica esta asociada con el Proceso de Solicitud de Compras.

En el paso nmero cuatro del asistente de procesos, vaya a Acciones de la Actividad para crear una expresin al entrar en la actividad de registro.

La expresin agrega a la lista de usuarios privilegiados al Vicepresidente. Se encuentra el registro del Vicepresidente en la tabla paramtrica creada, y se guarda su id en una variable. Luego, esta variable es registrada en la funcin que adiciona a los usuarios privilegiados.

1786

Copyright 2013 - Bizagi

//Obtain VicePresident User var ViceId=CHelper.getEntityAttrib ("Userwithaccess","Usertograntaccess","Code ='CVP'",""); //Grant access to VicePresident CHelper.GrantCaseAccess(Me.Case.Id,ViceId);

Agregar mltiples usuarios privilegiados usando una expresin

En un proceso de Solicitud de Compras se desea restringir la informacin de forma que slo puedan acceder a los casos creados los usuarios privilegiados (creador y asignados) y adicionalmente el Vicepresidente Comercial y el Presidente. Estos dos usuarios no tienen asignaciones en dichos casos. Por lo anterior es necesario aadirlos e a los usuarios privilegiados utilizando una expresin. Para ello, creamos una tabla paramtrica en donde guardaremos los dos usuarios: Vicepresidente Comercial y Presidente, de forma que podamos acceder fcilmente a sus identificadores y puedan ser administrados en caso de que cambien.

Copyright 2013 - Bizagi

1787

En el paso nmero cuatro del asistente de procesos, vaya a Acciones de la Actividad para crear una expresin al entrar en la actividad de registro.

La siguiente expresin agrega a la lista de usuarios privilegiados al Vicepresidente y al Presidente. Se encuentran todos los registros de la tabla paramtrica y se guardan los identificadores en una variable. Luego, esta variable es registrada en la funcin que adiciona a los usuarios privilegiados.

1788

Copyright 2013 - Bizagi

//Obtain list of all users in the 'Users with access' table UserstoAdd=CHelper.CEntityManager.GetEntity("Userswithaccess") .GetEntityList("","","",""); //Go through the list for (Counter=0; UserstoAdd.Lenght>Counter;Counter++) { IdUser=UserstoAdd[Counter].Attributes["Usertograntaccess"].Value; //Validate there are no duplicities if(!MyArray.Contains(IdUser)) { //Store users MyArray.Add(IdUser); } //Grant Access to users CHelper.GrantAccessToUsers(Me.Case.Id,MyArray); }
4.1.2.3.1 Manejar los privilegios a travs de la capa SOA

Usted puede restringir el acceso a casos y asignar usuarios privilegiados dinmicamente utilizando la Capa SOA.Para ello, se enviar el dato del nombre de usuario y el dominio a travs de una interfaz, y sta adicionar automticamente el usuario a la lista de privilegiados. Los nombres de usuario y dominios deben ser conocidos de antemano y deben ser enviados desde un sistema externo.

Copyright 2013 - Bizagi

1789

Ejemplo para adicionar usuarios privilegiados por SOA

Para el proceso de Solicitud de Compras se desea permitir el acceso al usuario Vicepresidente Comercial para que pueda ver la informacin de un caso. Asumiendo que ste caso se encuentra cerrado y se sabe que es el nmero 300, se opta por otorgar el privilegio desde una aplicacin externa, invocando servicios web a travs de la capa SOA de Bizagi. El mtodo de los servicios web que debe ser invocado para otorgar acceso a usuarios es g ran tCaseA ccess disponible en W o rkflo w En g in eSO A .asm x , este utiliza la siguiente sintaxis: Para agregar un usuario a la lista de usuarios privilegiados:

CHelper.GrantCaseAccess (int

idCase, int idUser)

Para agregar mltiples usuarios a la lista de usuarios privilegiados:

CHelper.GrantCaseAccessToUsers (int idCase, Arry Users)

Los privilegios pueden ser para ms de un usuario y para ms de un caso si se invoca un servicio web. El XML de entrada, para la invocacin de este mtodo se muestra a continuacin:

Restringir usuarios usando la Capa SOA

Para el proceso de Solicitud de Compras se desea restringir los accesos de la siguiente manera: El usuario El usuario El usuario El usuario OperadorComercial2 no debe tener acceso al caso 300. OperadorComercial1 no debe tener acceso al caso 301. OperadorComercial1 no debe tener acceso al caso 302. VicepresidenteComercial no debe tener acceso al caso 302.

Asumiendo que ste caso se encuentra cerrado, se opta por otorgar el privilegio desde una aplicacin externa, invocando servicios web a travs de la capa SOA de Bizagi. El mtodo de los servicios web que debe ser invocado para otorgar acceso a usuarios es rev o keCaseA ccess disponible en W o rkflo w En g in eSO A .asm x . Para remover un usuario de la lista de usuarios privilegiados:

CHelper.RevokeCaseAccess (int

idCase, int idUser)

1790

Copyright 2013 - Bizagi

Para remover mltiples usuarios de la lista de usuarios privilegiados:

CHelper.RevokeCaseAccessToUsers (int idCase, Array Users)

El XML de entrada, para la invocacin de este mtodo se muestra a continuacin:

4.1.3

Administracin del Portal de Trabajo

En el Portal de Trabajo se encuentra el men de A d m in istraci n . Este men le permite acceder a varias opciones para administrar los siguientes elementos Bizagi.

OPCIN Usuarios

DESCRIPCIN Permite la administracin de los usuarios: creacin o actualizacin. Para ms informacin por favor

Copyright 2013 - Bizagi

1791

OPCIN

DESCRIPCIN referirse a Administracin de Usuarios.

Licencias

Permite la administracin de Licencias. Permite la administracin de Entidades Paramtricas para modificar, aadir o des habilitar registros. Para ms informacin refirase a valores de paramtricas en el Portal de Trabajo. Permite reasignar las Actividades o abortar casos. Permite generar alertas o alarmas cuando una actividad va a expirar o ha expirado. Encripta las contraseas usadas en la base datos para incrementar la seguridad del acceso a la informacin. Maneja las actividades asncronas que han fallado.

Entidades

Casos Alarmas

Cifrado de clave

Consola de actividades asncronas Solicitudes pendientes de usuarios Bsqueda en el registro de autenticacin Polticas del negocio

Despliega las solicitudes pendientes de las cuentas de usuarios bloqueadas. Para ms informacin refirase a Manejo cuentas bloqueadas. Permite revisar el log de las autenticaciones hechas por usuarios.

Administra las Polticas de negocio, Grupos de polticas, precondiciones, Tablas de decisin y Vocabularios, en tiempo real. Permite la inclusin o borrado de los usuarios de: Posiciones, roles, habilidades, grupos de usuario y Organizacin. Para ms informacin refirase a Perfiles. Permite la definicin o modificacin de los usuarios para la asignacin predeterminada de los procesos. Recuerde que un usuario predeterminado se utiliza para asignar los casos en que los criterios de asignacin no se cumple. Para obtener ms informacin acerca de asignacin de usuario por defecto, por favor referirse Asignacin de trabajo. Permite al usuario crear, editar y eliminar Dimensiones

Perfiles

Administrar asignacin de usuario predeterminado

Dimensiones

Este men permite modificar diferentes elementos que afectan a la funcionalidad y la ejecucin de los

1792

Copyright 2013 - Bizagi

procesos, se recomienda revisar las opciones de seguridad para restringir el acceso de acuerdo con los perfiles de los usuarios. 4.1.3.1 Administracin de Casos Los usuarios con privilegios de administracin pueden administrar los casos con el fin de balancear la carga de trabajo, reducir tiempos de ciclo y eliminar informacin innecesaria. En el men A d m in del Portal de Trabajo encontrar la opcin Caso s. Esta opcin le permite a los usuarios administradores reasignar actividades o abortar casos.

Cmo abortar un caso

1. Vaya al men de ad m in istraci n d e caso s y busque el caso que desea abortar o invalidar. Usted puede utilizar distintos criterios de bsqueda como el nmero de creacin, asignado actual, fecha de creacin o proceso.

Copyright 2013 - Bizagi

1793

2. Una vez ingresados los criterios, d clic en el botn B u scar.

3. Una nueva ventana mostrar los resultados de la bsqueda:

1794

Copyright 2013 - Bizagi

Si no se encontraron registros, un mensaje informar al usuario que la bsqueda no retorno resultados.

Si se encuentran registros que cumplan con los criterios se mostrar una lista con todos los casos, tal como se muestra a continuacin:

Copyright 2013 - Bizagi

1795

4. Seleccione el caso de la lista habilitando la primera columna de la tabla:

1796

Copyright 2013 - Bizagi

5. Una vez seleccionado el caso, ingrese las razones de invalidacin, en el cuadro que aparece en la parte inferior de la pantalla. Una vez ingresadas, d clic en el botn In v alid ar.

Copyright 2013 - Bizagi

1797

Un correo electrnico se enviar a todos los usuarios que posean actividades pendientes en el caso abortado.

Cmo reasignar una tarea

1. Vaya al men de ad m in istraci n d e caso s y busque el caso relacionado a la tarea que desea reasignar. Usted puede utilizar distintos criterios de bsqueda como el nmero de creacin, asignado actual, fecha de creacin o proceso.

1798

Copyright 2013 - Bizagi

2. Una vez ingresados los criterios, d clic en el botn B u scar.

3. Una nueva ventana mostrar los resultados de la bsqueda: Si no se encontraron registros, un mensaje informar al usuario que la bsqueda no retorno

Copyright 2013 - Bizagi

1799

resultados.

Si se encuentran registros que cumplan con los criterios se mostrar una lista con todos los casos, tal como se muestra a continuacin:

4. Seleccione la actividad o actividades que necesitan ser reasignadas:

1800

Copyright 2013 - Bizagi

4. D clic en el botn Reasig n ar que aparece en la parte inferior de la pantalla.

Copyright 2013 - Bizagi

1801

5. Se muestra una nueva ventana de bsqueda para encontrar el nuevo encargado de la actividad. Ingrese la informacin y de clic en B u scar.

6. Se mostrar una lista de usuarios que cumplen con los criterios definidos. Identifique el usuario que ser asignado dando clic en el botn Reasig n ar.

1802

Copyright 2013 - Bizagi

El caso estar asignado ahora al usuario seleccionado.

4.1.3.2

Administracin de usuarios

Informacin general
Un usuario se define como una persona que interacta con Bizagi en el Portal de Trabajo en la realizacin de las actividades de los procesos, o en la gestin de la informacin proporcionada por Bizagi. Cada usuario tiene una cuenta a travs de la cual l o ella est identificado en Bizagi. Todas las propiedades definidas en la cuenta permiten o restringen la interaccin con la aplicacin. En las opciones de A d m in del Portal de Trabajo se encuentra la opcin Usu ario s. Esta opcin permite la administracin de usuarios, ya sea actualizando existentes o creando nuevos.

Copyright 2013 - Bizagi

1803

Tenga en cuenta que los usuarios no se pueden eliminar una vez que se ha creado. Sin embargo, se pueden deshabilitar si ya no son necesarios.

Cmo crear un usuario en Bizagi

1. En la seccin A d m in del Portal de Trabajo seleccione la opcin Usu ario s. En la nueva pantalla, haga clic en N u ev o u su ario .

2. Se mostrar la ventana de administracin de usuarios. Incluya la informacin requerida en las cuatro pestaas:: Informacin Bsica Organizaciones Configuracin usuario Informacin Adicional.

1804

Copyright 2013 - Bizagi

En la pestaa de In fo rm aci n B sica incluya: Nombre: Nombre visible del usuario. Nombre de usuario: nombre de usuario del usuario. Este campo no puede contener caracteres especiales ni espacios. Dominio: dominio de la red a la que pertenece a la aplicacin. Notificar por email: Esta casilla de verificacin determina si el usuario ser notificado por correo. E-mail de contacto: Direccin de correo electrnico donde se enviarn las notificaciones. Clave: Define la contrasea. En el entorno de desarrollo, cuando el usuario se crea, la contrasea es el nombre de usuario. En el entorno de produccin, cuando el usuario se crea, la contrasea es un nmero aleatorio. Puede ser cambiado inmediatamente, o se enva al usuario a travs de correo electrnico. Contrasea expirada: Opcin de vencimiento de la cuenta. Por defecto esta casilla est marcada. se debe desactivar para que el usuario pueda trabajar. Cuenta bloqueada: opcin de bloqueo al Portal de Trabajo. Por defecto esta casilla est marcada. Se debe desactivar para permitir al usuario empezar a trabajar. Enviar correo al usuarios con la clave: opcin para enviar un correo electrnico al nuevo usuario informando su contrasea. Propiedades de usuario requeridas: Cuando se han definido propiedades de usuario nuevas, en Bizagi Studio, y estas son requeridas, se muestran en esta pestaa con el fin de incluir la informacin relacionada.

Copyright 2013 - Bizagi

1805

En la pestaa de O rg an izacio n es incluya: Organizaciones: Organizacin a la que pertenece el usuario. Localizacin: la ubicacin geogrfica del usuario. Cargos: Posiciones del usuario. Un usuario puede tener una o ms posiciones. Seleccione la posicin de la lista desplegable y haga clic en >>.

1806

Copyright 2013 - Bizagi

En la pestaa de Co n fig u raci n Usu ario incluya: Activo: Indica si el usuario est activo o no para trabajar en el Portal de Trabajo. Omitir reglas de asignacin en los casos creados por este usuario: define si los casos creados por el usuario evaluarn las reglas de asignacin. Si se selecciona, cada actividad de los casos creados por el usuario se le asignar al usuario conectado. rea: Departamento o rea a la que pertenece el usuario en la organizacin. Jefe: Define el superior inmediato del usuario. Roles: Roles asignados al usuario en la organizacin. En Bizagi, un usuario puede tener uno o ms roles. Una vez que haya creado el usuario, seleccione el rol y haga clic en Agregar. Habilidades: Habilidad para llevar a cabo una accin. En Bizagi, un usuario puede tener una o ms habilidades. Una vez que haya creado el usuario, seleccione la habilidad y haga clic en el botn Agregar. Esquema de trabajo: El administrador puede definir si el nuevo usuario va a trabajar con el esquema predeterminado del tiempo de trabajo, o con una diferente. Usuario Delegado: Usuario que toma las funciones para recibir los casos asignados desde el momento en el que se activa. Las ya asignadas sern ignoradas. Activar Delegacin: esta seleccin permite la delegacin de las tareas de usuario a un usuario delegado. El usuario delegado puede ver la informacin de delegacin de las tareas en el men de herramientas, en la opcin Preferencias.

Copyright 2013 - Bizagi

1807

El usuario delegado tambin puede ver los casos delegadas a la parte superior de la pantalla de actividades. Habilitado para Asignacin: Cuando un usuario est habilitado para la asignacin, l / ella se le puede asignar actividades dentro de un proceso, si l / ella llena un perfil especfico. Zona horaria: Define la zona horaria del usuario Idioma: Define el idioma en el que ser el Portal de Trabajo se muestra al usuario.

La pestaa de In fo rm aci n ad icio n al slo se muestra cuando hay propiedades del usuario personalizadas no requeridas..

1808

Copyright 2013 - Bizagi

3. Cuando haya terminado de introducir la informacin, haga clic en A g reg ar para guardar la informacin del nuevo usuario.

Nota: La informacin del usuario ser llevada a produccin en el primer deployment. En adelante la administracin de los usuarios debe ser efectuada directamente en el entorno de produccin.

Cmo editar un usuario

1. En la seccin A d m in del Portal de Trabajo seleccione la opcin Usuarios y busque el usuario que ser editado por dominio, nombre de usuario o el nombre completo como criterios de bsqueda. Si estos campos se dejan en blanco, todos los usuarios se mostrarn.

2. Haga clic en B u scar. Una lista de los usuarios que cumplen los criterios de bsqueda se mostrar, incluyendo algunos datos de usuario para ayudar a la identificacin (ID de usuario, el dominio, el nombre y el correo electrnico) Adems, los dos enlaces estarn habilitados para cada registro:

Ed itar: Muestra la pantalla de administracin de usuarios con el fin de modificar la informacin del usuario.

Copyright 2013 - Bizagi

1809

Lo g: presenta informacin sobre las modificaciones introducidas en los atributos de usuario. El tipo de cambio indica si la propiedad fue aadida, modificada o eliminada.
Haga clic en el enlace Ed itar del usuario cuya informacin ser modificada.

4. La ventana de Administracin de usuarios se mostrar para hacer los cambios necesarios. Cuando haya terminado, haga clic en A ctu alizar para salvarlos.

1810

Copyright 2013 - Bizagi

4.1.3.2.1 Manejo de Posiciones, Roles y Habilidades

Un administrador puede administrar los componentes de propiedades de usuario para agregar o eliminar usuarios, para: Posicin Rol Habilidad Grupo de usuarios organizacin 1. Para administrar una propiedad especfica, haga clic en la opcin de men A d m in en el men Portal de Trabajo. A continuacin, seleccione la opcin P erfiles.

Copyright 2013 - Bizagi

1811

2. Seleccione el componente a administrar en la lista Tipo de perfil.

Si lo desea, puede buscar la propiedad: escriba el nombre del perfil directamente en el combo. Si el nombre de perfil se deja en blanco, la bsqueda devolver todos los registros que coinciden con el tipo de perfil. Una tabla muestra los resultados que coinciden con los criterios de bsqueda. Haga clic en A d m in istrar para administrar usuarios.

1812

Copyright 2013 - Bizagi

3. Una nueva ventana mostrar todos los usuarios del perfil seleccionado. Seleccione B o rrar o N u ev o u su ario , dependiendo de la accin requerida.

4.1.3.2.2 Cuentas bloqueadas

Cuando su cuenta de usuario est bloqueada, puede solicitar al administrador desbloquearla y as poder iniciar sesin en el Portal de Trabajo. Esto se realiza haciendo clic en el icono de Desb lo q u ear cu en ta.

Copyright 2013 - Bizagi

1813

El administrador (por lo general el usuario admon) recibir una notificacin acerca de su solicitud. Si usted es el administrador puede acceder a todas las solicitudes enviadas por los usuarios. Haga clic en la opcin A d m in en el men principal del Portal de Trabajo y seleccione So licitu d es p en d ien tes d e u su ario s para verlas.

1814

Copyright 2013 - Bizagi

Al lado de cada solicitud hay un semforo que indica si el tiempo de servicio predeterminado ha expirado o no.

Cuando una solicitud es seleccionada, una nueva ventana muestra el proceso pendiente. En esta pantalla el administrador puede cambiar las opciones de autenticacin de usuario y el estado de la cuenta, ya sea bloqueada, caducado o desactivado, as como cambiar la contrasea.

Copyright 2013 - Bizagi

1815

Puede generar contraseas de la cuenta de usuario haciendo clic Co n trase a aleato ria.

Configuracin de Solicitudes pendientes

Las solicitudes pendientes se utilizan cuando la cuenta de los usuarios est bloqueada. Las dos posibles razones para el bloqueo de una cuenta son: Mximo intentos fallidos de inicio de sesin. Tiempo de bloqueo de contrasea. Usted puede ajustar la configuracin en las opciones de Autenticacin.

1816

Copyright 2013 - Bizagi

1. Habilitar bloqueo de cuenta. En la vista de Mdulos, en el mdulo de Seguridad usted puede configurar el bloqueo de las cuentas cuando los intentos de inicio de sesin mximos se alcanzan. Por defecto esta opcin est desactivada. Vaya a la opcin H ab ilitar b lo q u eo d e cu en tas y compruebe el encendido / apagado para activarla. Haga clic en A ctu alizar para guardar los cambios.

Copyright 2013 - Bizagi

1817

2. Defina los intentos de inicio de sesin mximos. Vaya a la opcin N m ero m x im o d e in ten to s d e in g reso y escriba el nmero de intentos permitidos antes de que la cuenta se bloquea. Haga clic en A ctu alizar para guardar los cambios.

1818

Copyright 2013 - Bizagi

3. Defina el tiempo de bloqueo de contrasea. Vaya a la opcin Tiem p o d e b lo q u eo d e co n trase as y escriba el nmero de das que una cuenta puede estar inactiva antes de que se bloquee. Haga clic en A ctu alizar para guardar los cambios.

4. Definir el tiempo de servicio. Se puede definir un tiempo de servicio mximo para responder solicitudes. Ir a la opcin Tiem p o d e serv icio p ara so licitu d es p en d ien tes y escriba el nmero mximo de horas en las que el administrador debe responder a las solicitudes. Haga clic en A ctu alizar para guardar los cambios.

Copyright 2013 - Bizagi

1819

5. Habilitar las notificaciones al administrador. El administrador puede ser notificado por correo electrnico cuando una peticin de usuario de desbloquear una cuenta es recibida. Por defecto esta opcin est desactivada. Vaya a la opcin En v iar co rreo cu an d o se cree so licitu d p en d ien te y compruebe el activado / desactivado para activarla. Haga clic en A ctu alizar para guardar los cambios.

1820

Copyright 2013 - Bizagi

6. Camvbie la cuenta de correo electrnico del administrador. Las notificaciones sobre las solicitudes de usuario ser enviadas a una cuenta de correo electrnico. Por defecto, esta cuenta es admin@domain.com. Vaya a la opcin Cu en ta d e co rreo d el ad m in istrad o r cuenta de correo y cambiae la direccin de correo electrnico. Haga clic en A ctu alizar para guardar los cambios.

7. Configure el asunto y el cuerpo de las notificaciones. Usted puede personalizar el cuerpo y el asunto de las notificaciones que se envan al administrador, cuando un usuario enva una solicitud de desbloqueo. Personalice el mensaje en la opcin M en saje d el co rreo en caso d e u n a n u ev a so licitu d .

Copyright 2013 - Bizagi

1821

1822

Copyright 2013 - Bizagi

4.1.3.2.3 Usuario delegado

Esta opcin permite definir una persona que estar encargada de asistir los casos asignados a un usuario especfico, cuando este no se encuentre disponible. Por ejemplo, si un usuario se va de vacaciones, su usuario delegado ser la persona que reciba los nuevos casos que le seran asignados al usuario ausente. Cuando se habilita el usuario delegado: Los nuevos casos se asignarn tanto el usuario ausente o no disponible, como a su usuario delegado. Los casos ya asignados al usuario ausente no se resignarn al usuario delegado. nicamente los casos nuevos, a partir del momento que se habilita la delegacin, estarn disponibles para el usuario delegado.

Cmo definir un usuario delegado

1. Desde el Portal de Trabajo vaya a la opcin Usuarios, que se encuentra bajo el men de A d m in .

2. Busque el usuario para el cual se definir un usuario delegado. Ingrese los criterios necesarios y luego d clic en B u scar.

Copyright 2013 - Bizagi

1823

3. D clic en la opcin Ed itar que se encuentra a lado del usuario especfico.

4. En la ventana de administracin de usuarios, vaya a la pestaa de Configuracin de usuario y busque la opcin Usu ario Deleg ad o .

1824

Copyright 2013 - Bizagi

5. D clic en O b ten er Usu ario para buscar el usuario delegado. Ingrese los criterios necesarios y d clic en B u scar.

6. Seleccione el usuario delegado.

Copyright 2013 - Bizagi

1825

7. Finalmente habilite la opcin H ab ilitar d eleg aci n para activar la delegacin.

1826

Copyright 2013 - Bizagi

4.1.3.3

Valores de Entidades Paramtricas en el Portal de Trabajo Los usuarios finales pueden administrar las Entidades Paramtricas desde el Portal de Trabajo con el fin de modificar, aadir o deshabilitar registros. Una vez que el proyecto ha sido llevado a produccin slo las Entidades Paramtricas configuradas como Administrables en produccin estarn disponibles.

Agregar un registro a una Entidad Paramtrica

1. En el men A d m n in seleccione la opcin En tid ad es. Una nueva ventana mostrar la lista de las Entidades Paramtricas.

2. Seleccione la Entidad Paramtrica que se modificar. Recuerde que en produccin (y pruebas) slo las Entidades Paramtricas Administrables en produccin se muestran en la lista.

Copyright 2013 - Bizagi

1827

3. Seleccione una Entidad Paramtrica. Una ventana mostrar la informacin detallada de la entidad. Puede agregar un nuevo registro a la entidad a travs del enlace A g reg ar.

4. Otra ventana aparecer para incluir la informacin de los atributos.

1828

Copyright 2013 - Bizagi

Los registros de las Entidades Paramtricas no se pueden eliminar. Por esta razn, tienen una propiedad para Desh ab ilitar. Los registros deshabilitados slo se mostrarn en los casos existentes (pendientes o cerrados) que los referencien.

Llene la Forma con la informacin requerida y haga clic en Gu ard ar. Si no se desea guardar cambios de clic en Reg resar (volver a la pantalla anterior).

Copyright 2013 - Bizagi

1829

Editar un registro de una Entidad Paramtrica

1. En el men Admin, seleccione la opcin En tid ad es. Una nueva ventana mostrar la lista de Entidades Paramtricas.

2. Seleccione la entidad que desee modificar.

3. Una ventana mostrar la informacin detallada de la entidad. Para editar (o ver) un registro existente, haga clic en Ver.

1830

Copyright 2013 - Bizagi

4. Se mostrar la informacin relativa al registro seleccionado.

Realice los cambios necesarios y haga clic en Gu ard ar. Si no se desea guardar cambios de clic en Reg resar (volver a la pantalla anterior).

Copyright 2013 - Bizagi

1831

Personalizar las Formas para administracin de entidades

Bizagi trae por defecto las Formas para la administracin de las Entidades Paramtricas en el Portal de Trabajo. Estas formas incluyen todos los atributos de la entidad sin tener que seleccionar opciones adicionales. Usted puede personalizar estas formas: Forma visual, de adicin y de edicin de registros, determinando los atributos que se desean mostrar y su requeribilidad. Para ms informacin referirse a Formas de administracin de entidades paramtricas. 4.1.3.4 Administrar Polticas en el Portal de Trabajo

Bizagi ofrece un entorno grfico sencillo que permite a los Analistas de negocio definir y gestionar las Polticas desde el Portal de Trabajo. Puede administrar Polticas de negocio, Grupos de reglas, Precondiciones y Tablas de decisin cuando sea necesario utilizando las facilidades del Vocabulario definido. Nota: Desde el Portal de Trabajo, las Polticas pueden ser editadas, pero no eliminadas o creadas.

Editar Polticas en el Portal de Trabajo

1. Haga clic en la opcin Polticas del Negocio en el men de A d m in .

2. Seleccione la aplicacin, el proceso y la poltica que desea. En la seccin del lado derecho usted podr editar los elementos existentes de Poltica. Al hacer clic en la Poltica se habilitan cuatro opciones en la parte inferior, para aadir nuevos elementos a la poltica existente.

1832

Copyright 2013 - Bizagi

Al hacer doble clic sobre la Poltica podr editar sus condiciones actuales.

3. Una nueva ventana se mostrar de acuerdo con el tem de la Poltica seleccionada, con el fin de permitir los cambios necesarios.

Copyright 2013 - Bizagi

1833

Todo el vocabulario creado estar disponible en la pestaa de Co m p o n en tes, para modificar las condiciones y acciones.

Administrar Polticas en produccin

Cuando un proyecto se lleva a produccin por primera vez, todas las definiciones de Polticas tendrn un color gris. Tan pronto como se cambie una Poltica, un enlace "Reset" se mostrar en frente y el color cambiar a negrilla, para identificar que fue cambiada y su valor ya no es el mismo que se tiene en el ambiente de desaroollo.

1834

Copyright 2013 - Bizagi

Si hace clic en el enlace de Reset, la Poltica ser restaurada a su valor inicial, es decir el valor que tena cuando se hizo deployment. Las Polticas que no hayan sido modificadas se sobrescribirn en futuros deployments, con la configuracin del entorno de desarrollo. Si realiza cambios en cualquier Poltica en produccin, se conservarn dichos valores en futuros deployments. Si desea sobrescribir los cambios hecho en produccin con los valores de desarrollo debe restaurar los valores originales y luego realizar un deployment. 4.1.3.5 Definicin de alarmas Durante la ejecucin de los procesos, la duracin de las tareas debe ser controlada para poder cumplir con las mtricas de la organizacin, el control de los tiempos de proceso, y tomar decisiones con el fin de mejorar el rendimiento de los procesos. Para ello, Bizagi tiene una herramienta que permite generar avisos para diferentes personas cuando una tarea est a punto de vencer o ha vencido. Las Alarmas en Bizagi son notificaciones de correo electrnico. Un mensaje se enviar a las personas indicadas para informar el estado de una tarea con el fin de ejecutar las acciones necesarias para su realizacin.

Copyright 2013 - Bizagi

1835

Los mensajes enviados como alarmas pueden ser personalizados. Si la plantilla predeterminada no se utiliza es posible personalizar una nueva plantilla. La configuracin de estas alarmas es flexible en cuanto a tiempo y los destinatarios. El Programador de Bizagi debe estar encendido de modo que las alarmas se puede ejecutar. Las alarmas son configuradas del Portal de Trabajo por los usuarios finales, utilizando la opcin A d m in - A larm as . Los cambios las alarmas son individuales para los ambientes de desarrollo, pruebas y produccin. Si desea que los cambios sean permanentes y se conviertan en parte del diseo del proceso, debe hacerlos en todos los entornos para garantizar que estn sincronizados.

Cmo configurar Alarmas

1. En el Portal de Trabajo, haga clic en A d m in y luego A larm as.

1836

Copyright 2013 - Bizagi

2. Elija la Aplicaciones, Proceso y tarea en las que desee crear o editar la alarma y a continuacin, haga clic en A larm as> > .

3. En la pantalla del editor de alarmas se puede configurar los lapsos, las repeticiones y los tiempos:

Copyright 2013 - Bizagi

1837

Repeticiones: es la recurrencia del envo de la alarma . Los tipos de repeticiones ofrecidos por Bizagi son: o Ninguno: La alarma se enviar slo una vez sin repeticin. o Cada Vez que se Cumpla el Tiempo Especificado: La alarma se enviar cada cierto periodo de tiempo definido con la funcin Interval. o Cada Vez que se Cumpla el Tiempo de la Actividad o del Proceso: La alarma se repetir cada vez que la duracin de la tarea se termine.

Lapso: Lapso se utiliza para definir el tiempo para ejecutar la alarma por primera vez. Esta caracterstica se requiere siempre, independientemente del tipo de alarma seleccionada. Las opciones disponibles son las siguientes:

1838

Copyright 2013 - Bizagi

o Antes del vencimiento: La alarma se ejecuta por primera vez, un cierto tiempo antes de que el tiempo establecido para la tarea se haya agotado. o En el vencimiento: La alarma ser ejecutada por primera vez una vez que la duracin establecida para la tarea haya terminado. o Despus del vencimiento: La alarma ser ejecutada por primera vez un cierto tiempo despus de que la duracin establecida para la tarea ha terminado.

Nota Si selecciona la opcin A n tes d el v en cim ien to o Desp u s d el v en cim ien to , debe definir el tiempo antes o despus en la propiedad Lap so .

Tiempos: en esta seccin se debe definir el tiempo de Lapso de ejecucin y el tiempo entre repeticiones: o Lapso (min): Se utiliza para definir el tiempo de ejecucin (en minutos) de la primera alarma, tomando el tiempo de vencimiento de la tarea como punto de referencia. Este tiempo debe ser definido cuando el Lapso seleccionado es Antes del vencimiento o Despus del vencimiento. o o Tiempo entre repeticiones: Permite definir el tiempo de recurrencia de la alarma cuando el tipo de alarma seleccionado es Cad a Vez q u e se Cu m p la el Tiem p o Esp ecificad o . Usted puede seleccionar la unidad de medida del combo: minutos, horas, das, semanas o meses.

Destinatarios: permite definir los destinatarios de la alarma. Una alarma puede tener uno o ms destinatarios. Usted puede agregar destinatarios una vez que la alarma ha sido creada.

Copyright 2013 - Bizagi

1839

Para seleccionar el destinatario, puede determinar el perfil del destinatario seleccionado el Rol del combo y luego haciendo clic en A d icio n ar d estin atario . Para eliminar destinatarios marque la casilla Destinatario y haga clic en Elim in ar d estin atario s seleccio n ad o s. Tambin puede configurar que la alarma se enve al usuario actual de la actividad marcando el campo En v iar al asig n ad o actu al.

Eliminar o editar una alarma desde el Portal de Trabajo

Una vez que la alarma ha sido creada se despliega una lista con las alarmas para cada tarea. Puede eliminar o editar las alarmas pulsando los botones Ed itar o Elim in ar. La lista de alarmas se actualizar automticamente.

4.1.4

Consultas

Informacin General
Bizagi permite la definicin y personalizacin de Formas especiales para consultar la informacin relacionada a los casos. Estas formas se denominan Co n su ltas. Usted puede definir consultas muy poderosas para buscar casos por rango de fecha o utilizar la informacin del caso y definir coincidencias exactas o similares, etc. Usted tambin puede construir Consultas para buscar informacin relacionada a Entidades especficas (Maestras o Paramtricas). Estas Consultas a nivel de Entidad permiten a los usuarios finales ver la informacin, por ejemplo, acerca de Clientes, productos o cualquier entidad principal. Dicha informacin no esta relacionada a casos en particular sino directamente a valores de la entidad. Para mayor informacin, consulte Formas de Consulta

1840

Copyright 2013 - Bizagi

Una vez definidas, las Formas de Consulta se utilizan desde el Portal de Trabajo. Dentro de los resultados de las bsquedas Bizagi permite realizar anlisis grficos con nuestra herramienta de A n lisis Grfico . Los resultados de las consultas se pueden guardar para ayudar en la definicin de las mas frecuentes y ejecutarlas fcilmente en cualquier momento.

Realizar consultas desde el Portal de Trabajo

1. En el Portal de Trabajo vaya al men de Co n su ltas.

2. Seleccione la Consulta que desee realizar de las siguientes categoras: Aplicacin: Esta opcin mostrar todas las Consultas definidas para buscar informacin en los casos creados. Otras Entidades: Esta opcin mostrar las Consultas definidas para entidades especficas.

3. Se mostrar la Forma de Consulta. En ella ingrese sus criterios de bsqueda. Usted debe configurar dos cosas en la Consulta para obtener los resultados deseados: Ingresar el filtro o criterio de bsqueda: La informacion ingresada en cualquier campo servir como filtro. Los resultados de bsqueda devolvern informacin de casos (o Entidades) que cumpla con el criterio ingresado. Si los campos se dejan vacos, la bsqueda ignorar estos parmetros. Seleccione las columnas que deberas mostrarse en los resultados: En frente de cada campo hay

Copyright 2013 - Bizagi

1841

un cuadro de marcacin. Cuando se activa, el campo ser parte de la tabla de resultados. De lo contrario, el campo no se mostrar en los resultados.

Nota Para Consultas de Entidad seleccione al menos un campo para mostrar en los resultados. 4. Cuando usted ha definido sus criterios de bsqueda y columnas, d clic en B u scar. Si el criterio definido no es el que desea, d clic en Lim p iar. Nota Los resultados de la bsqueda mostrarn la informacin de casos o entidades que han sido guardados en la base de datos. Por lo tanto, cualquier informacin que haya sido actualizada, agregada o eliminada DENTRO de las actividades que no han sido completadas (los usuarios finales no han dado clic en Siguiente) no se reflejar en la bsqueda.

Ejemplo
1842 Copyright 2013 - Bizagi

En un Proceso de Gestin de Oportunidades de Venta queremos consultar la "Fecha de Creacin", "Lead Source", "Ingreso Estimado" y "Etapa" de todos los casos creados entre las siguientes fechas: 01/01/2012 y 01/02/2012. Se ha definido una Forma de Consulta para este Proceso y se ha nombrado como Gen eral Q u ery. 1. En el men de Consultas selecciones la Consulta General Query dentro del Proceso de Oportunidades de Venta.

2. En la consulta, seleccione el periodo de tiempo para la Fecha de Creacin en los campos Desd e y H asta.

Copyright 2013 - Bizagi

1843

3. Marque los atributos Fecha de Creacin", "Lead Source", "Ingreso Estimado" y "Etapa" para que sean mostrados en la tabla de resultados.

4. Cuando damos clic en Buscar, la Consulta mostrar los resultados. Observe que los campos seleccionados se incluyen en la tabla de resultados que se muestra.

1844

Copyright 2013 - Bizagi

Guardar una Consulta

Para obtener la tabla de resultados usted debe configurar la Forma de Consulta para buscar basado en ciertos criterios y devolver resultados que muestren cierta informacin. Cuando se muestran los resultados de una Consulta, usted encontrar el vnculo Gu ard ar Co n su lta, en la parte inferior de la ventana, para guardar esta configuracin.

Copyright 2013 - Bizagi

1845

Cuando damos clic en el vnculo, una nueva ventana muestra lo siguiente: Nombre: Asigne un nombre a su bsqueda. Puede ser de hasta 25 caracteres. Descripcin: Ingrese una descripcin tan clara como sea posible.

Compartir una consulta guardada

1846 Copyright 2013 - Bizagi

Si usted quisiera compartir la consulta guardada con otros usuarios finales, d clic en el botn O b ten er Usu ario s. Una nueva ventana se mostrar.

Esta ventana tiene dos pestaas: La pestaa de Usu ario s permite seleccionar usuarios por Nombre de usuario, dominio y nombre completo.

Copyright 2013 - Bizagi

1847

De la lista de usuarios encontrados, seleccione los usuarios con los que desee compartir la Consulta y de clic en el botn ">" Luego d clic en el botn Co m p artir para permitir al grupo acceder a su Consulta.

1848

Copyright 2013 - Bizagi

La pestaa de Gru p o s permite la adicin de un grupo de usuarios para compartir la consulta. En la lista de N o m b re d e Gru p o se listan todos los grupos que han sido creados en la aplicacin. Para agregar un Grupo, utilice el botn A g reg ar. Una vez que los grupos deseados han sido aadidos, d clic en el botn Co m p artir. Si el usuario quisiera eliminar un grupo de la lista, solo debe seleccionarlo y dar clic en el botn Elim in ar.

Copyright 2013 - Bizagi

1849

Nota Los usuarios con acceso a Consultas guardadas pueden ver los resultados de la consulta, y guardarla como una nueva consulta. No podrn editarlas ni eliminarlas.

Ejecutar consultas guardadas

Las Consultas guardadas se acceden desde el men de Consultas. Estas se almacenan como entidades hijas de la original. En nuestro ejemplo previo, los casos de Oportunidades de Venta se buscaron de acuerdo a ciertos criterios especificados en la Consulta General Query. Los resultados se guardaron con el nombre de " O p p o rtu n ities 2011". Esta nueva consulta puede accederse desdde una carpeta denominada Gen eral Q u ery que se encuentra dentro de las Consultas de Oportunidades de Venta en el men de Consultas. Solo d clic sobre ella para ejecutarla de nuevo.

1850

Copyright 2013 - Bizagi

Editar una Consulta guardada

1. D clic en el botn Ed itar que se encuentra a la derecha de la Consulta guardada.

2. Una nueva ventana se mostrar. Aqui usted puede modificar el Nombre, Descripcin, personas a quien compartir la Consulta y los criterios de bsqueda segn lo requiera.

Copyright 2013 - Bizagi

1851

3. Usted puede guardar la consulta modificada como una nueva y mantener la versin original dando clic en Gu ard ar u n a N u ev a, o actualizar la version original dando clic en A ctu alizar.

1852

Copyright 2013 - Bizagi

Eliminar una Consulta guardada

1. D clic en el botn Eliminar que se encuentra en la parte derecha de la Consulta guardada.

2. Confirme la eliminacin dando clic en la opcin Elim in ar.

4.1.4.1

Anlisis grafico

El anlisis grfico permite analizar grficamente los resultados de bsqueda devueltos por Consultas facilitando la compresin de la informacin de una manera rpida y flexible. El anlisis grfico permite acceder a datos actualizados y precisos para concentrarse ne la observacin de tendencias y oportunidades de mejora en tiempo real. 1. Una vez que se ha ejecutado una consulta, se presentan sus resultados. D clic en el vnculo A n lisis

Copyright 2013 - Bizagi

1853

Grfico que aparece en la parte inferior de los resultados de la bsqueda.

2. Se abrir el Asistente de Anlisis Grfico. En el paso 1de este Asistente usted debe definir las Medidas. Estas Medidas representan cualquier apecto cuantificable o medible de la Consulta. Para las medidas, se debe aplicar al menos una funcin agregada. Cuando se seleccione d clic en Sig u ien te. Contador: Retorna el nmero total de medidas. Max: Retorna el mximo valor de las medidas. Min: Retorna el mnimo valor de las medidas. Promedio : Retorna el valor promedio de las medidas. Sum: Retorna el valor total de las medidas.

1854

Copyright 2013 - Bizagi

Nota Cada columna de los resultados de la Consulta se clasifica automticamente de acuerdo con el tipo de datos. Las columnas de atributos numricos (enteros moneda, etc) se definen como medidas. Recuerde que solo los campos seleccionados en la consulta se mostrar como resultados a aparecer en la lista.

3. En el paso 2 del Asistente de Anlisis Grfico usted debe definir las dimensiones que usted desea mostrar. Las Dimensiones son los datos a ser medidos. Estos son campos que fueron seleccionados para ser mostrados en la Consulta que no son numricos; usualmente son descriptivos como nombre, ciudad, regin fechas.

Copyright 2013 - Bizagi

1855

Para copiar dimensiones a la lista de dimensiones seleccionadas, arrstrelas desde el cuadro izquierdo y sultelas en el cuadro derecho.

1856

Copyright 2013 - Bizagi

Nota Para el Anlisis Grfico de Consultas de Aplicacin hay medidas y dimensiones adicionales de datos de proceso como: fecha de creacin de caso, fecha de solucin del caso, estado final, monto. 4. El resultado del anlisis grfico se presenta como en la imagen siguiente:

Men de Grfico
Este men se divide en tres secciones. Cada seccin le permitir configurar y visualizar diferentes caractersticas del Anlisis Grfico:

Copyright 2013 - Bizagi

1857

rea de Dimensiones y Medidas

En esta seccin usted puede agregar y remover medidas y dimensiones al grfico actual.

Marcar o Demarcar Nuevas funciones agregadas a las Medidas 1. En el elemento de Medidas del anlisis grfico, seleccione la medida que ha sido agregada. Se mostrar las funciones agregadas disponibles.

1858

Copyright 2013 - Bizagi

2. Las funciones aplicadas aparecern en la lista de funciones con un smbolo de marcacin verde. Cuando usted selecciona una funcin, esta se aplica para el anlisis. De igual manera, cuando usted selecciona las funciones que han sido aplicadas, no se aplicarn ms para el anlisis. Agregar Medidas para llevar a cabo Anlisis Grfico 1. En el elemento de dimensiones del anlisis grfico, d clic en la opcin A g reg ar. La ventana de Adicin de Medidas se mostrar.

Copyright 2013 - Bizagi

1859

2. En la ventana de Adicin de Medidas, usted ver la lista de campos numricos que fueron seleccionados en la Consulta para ser mostrados. Cuando se despliega el rbol de la medida, se muestran las funciones agregadas. Usted puede seleccionar las funciones de las medidas que desea aplicar para el anlisis.

3. D clic en el botn de A g reg ar. La informacin es actualizada automticamente.

1860

Copyright 2013 - Bizagi

Agregar Dimensiones para llevar a cabo Anlisis Grfico 1. En el elemento de dimensiones del anlisis grfico, d clic en el botn A g reg ar. La ventana de adicin de dimensiones se mostrar.

2. En la ventana de Adicin de Dimensiones, usted ver la lista de campos NO numricos que fueron seleccionados en la Consulta para ser mostrados. El usuario puede seleccionar todas las dimensiones haciendo uso del vnculo Seleccio n ar To d o o seleccionando dimensiones dando clic en el cuadro de marcacin que se encuentra a la izquierda de cada dimensin.

Copyright 2013 - Bizagi

1861

3. D clic en el botn A g reg ar. La informacin se actualiza automticamente.

Nota La ltima dimensin de la lista se representar como el eje X del grfico. Cuando usted selecciona las columnas o marcadores de las lineas en los grficos, una etiqueta aparecer con la informacin de lass dimensiones y el clculo de la funcion agregada de la medida que representa. Filtrar dimensiones en el anlisis grfico Si usted desea mostrar solo valores especficos de una dimensin en ele analisis grfico, usted puede filtrarlos. 1. En el elemento Dimensiones del anlisis grfico, d clic sobre la dimensin a filtrar. D clic en el ico n o d e filtro que aparecer.

1862

Copyright 2013 - Bizagi

2. Se abrir una nueva ventana. En esta usted encontrar todos los posibles valores para la dimensin.

Copyright 2013 - Bizagi

1863

3. Agregue los valores que se mostrar seleccionndolos y dando clic en el botn ">".

1864

Copyright 2013 - Bizagi

4. Finalmente d clic en el botn A p licar F iltro . La informacin se actualiza automticamente.

Men de configuracin
Este men brinda funciones para guardar el anlisis, exportarlo a Excel as como mostrar los resultados en tablas o grficos.

Copyright 2013 - Bizagi

1865

Guardar Anlisis Grfico: Esta opcin guarda el anlisis grfico generado. Exportar a Excel: Permite al usuario exportar las tablas de resultados a excel. Ver grfico y datos: Esta funcionalidad permite ver los datos presentados en tablas, en la pestaa de grficos, debajo del grfico. Agrupar grfico por: Esta opcin permite mostrar el grfico de acuerdo con las dimensiones existentes y se representa con unas lneas de divisin que agrupa el resultado de la consulta para la dimensin definida. Tipo de Grfico: Esta funcionalidad permite seleccionar el tipo de grfico a visualizar. Lnea 2D, Columnas 2D, Columnas 3D, Columnas Apiladas 2D, Columnas Apiladas 3D, rea 2D, torta 2D, torta 3D, Dona 2D, Dona 3D,

rea de Grfico
En esta rea usted puede visualizar el grfico de diferentes maneras as como el sumario de los datos representados. En esta rea usted encuentra tres pestaas: Pestaa de Grfico Este elemento presenta los resultados de la consulta de manera grfica. Los tipos de grfico que se visualizan en esta pestaa son: Lnea 2D, Columnas 2D, Columnas 3D, Columnas Apiladas 2D, Columnas Apiladas 3D, rea 2D. Los grficos son construidos teniendo en cuenta las dimensiones y medidas seleccionadas. Los datos que no son cuantificables o dimensiones que caracterizan la informacin van a constituir el eje de las X, las cuales son utilizadas para ordenar y agrupar los valores. Adicionalmente, los valores que se calculan para las medidas dependiendo la funcin de agregacin utilizada constituyen el eje de las Y.

1866

Copyright 2013 - Bizagi

Nota: Dependiendo el tipo de dimensin, automticamente se define el tipo de grfico. Normalmente se utiliza el tipo de grfico de barras, pero si se ha seleccionado una dimensin y es de tipo Fecha se utiliza un grfico de tipo lineal para representar la lnea de tiempo.

Pestaa de Detalles de Medidas Este elemento presenta los resultados de la consulta de manera grfica, por cada funcin de agregacin de las medidas que fueron seleccionadas. Los tipos de grfico que se visualizan en esta pestaa son: Circular 2D, Circular 3D, Anillo 2D y Anillo 3D.

Pestaa de Datos Las tablas de resultados organizan la informacin dependiendo las dimensiones seleccionadas y muestra los valores resultantes de las medidas de acuerdo con las funciones de agregacin definidas en columnas.

Copyright 2013 - Bizagi

1867

4.1.5

Localizar el Portal de Trabajo

Bizagi es una aplicacin web con soporte multi-lenguaje que permite visualizar el Portal de Trabajo en cualquier idioma. Este soporte se da tanto para los mens del Portal de Trabajo como para los Procesos. Usted puede definir ms de un idioma y permitir que el usuario final elija aquel en el cual desea visualizar el Portal de Trabajo. Si usted tiene Procesos definidos en varios idiomas, el Portal de Trabajo los convertir automticamente al escogido por el usuario final. Bizagi ofrece una variedad de idiomas para la visualizacin del Portal de Trabajo. Todos los mens se ajustarn automticamente sin necesidad de traduccin posterior. Estos idiomas son: Ingls Espaol Alemn Francs Portugus Ruso Holands Italiano Japons Chino simplificado

1868

Copyright 2013 - Bizagi

Definir el idioma predeterminado

El idioma predeterminado ser el que todos los usuarios finales ven en su Portal de trabajo para un proyecto especfico. Para definir el idioma predeterminado del Portal de Trabajo usted debe cambiar la configuracin de Cultura Global de Bizagi. Abra el men de Co n fig u raci n d e n eg o cio y vaya a las opciones de localizacin. En la primera opcin, seleccione de la lista desplegable, el idioma que desea definir como predeterminado .

Copyright 2013 - Bizagi

1869

4.1.5.1

Traducir los objetos del Portal de Trabajo Cuando se habilita ms de un idioma, o se habilita uno distinto a los brindados por Bizagi (Ingls, alemn, espaol, portugus, francs, holands, polaco, ruso), usted debe traducir todos los objetos para que el Portal de Trabajo se visualice correctamente y no con una mezcla de idiomas.

Traducir objetos internos

Los O b jeto s in tern o s son aquellos que Bizagi crea de forma predeterminada para cada uno de los proyectos, como por ejemplo: los mens, mensajes que se muestran en la actualizacin, nulidad, etc Si todos los idiomas que usted habilita estn dentro de los predefinidos, usted no tendr que realizar traducciones adicionales para los objetos internos. Sin embargo, si usted ha habilitado un idioma que no est dentro de los predefinidos, deber traducir cada uno de los objetos internos. Para traducir los objetos internos vaya a la Vista d e m d u lo s y acceda al mdulo P o rtal d e Trab ajo . D clic en la opcin In tern o s.

En el panel derecho Bizagi mostrar todos sus objetos internos. Tenga en cuenta que habr una columna disponible para uno de los idiomas habilitados. Ingrese la traduccin del objeto en la columna del idioma correspondiente. Repita este procedimiento para todos los elementos de la lista.

1870

Copyright 2013 - Bizagi

Cuando se selecciona un idioma de la Cu ltu ra en la lista desplegable ubicada en la parte superior de la pantalla, se mostrarn los nombres visuales de cada elemento en el Portal de Trabajo, en la columna Valo r. Sin embargo, esta pantalla es nicamente para fines de referencia y no significa que se haya elegido el idioma de visualizacin.

Usted puede buscar un recurso especifico introduciendo su nombre en el campo N o m b re d el recu rso .

Copyright 2013 - Bizagi

1871

Recursos Extendidos
Para crear y localizar recursos extendidos, vaya al mdulo P o rtal d e Trab ajo y d clic sobre Ex ten d id o s. Seleccione el elemento extendido que est asociado con la localizacin del recurso. Aqu puede aadir los recursos extendidos junto con sus localizaciones correspondientes.

Se pueden aadir nuevos recursos en la parte inferior del rea de trabajo del elemento extendido, despus de seleccionar el recurso extendido. Adems, se pueden modificar los recursos existentes. Las modificaciones se guardarn automticamente en el sistema.

1872

Copyright 2013 - Bizagi

Traduccin de objetos Bizagi

Los O b jeto s B izag i son todos los elementos que se crean en sus procesos, por ejemplo: entidades, atributos, habilidades y posiciones. Usted debe traducir estos objetos cuando utilice ms de un idioma. Para ms informacin, consulte Localizar los procesos y sus componentes. 4.1.5.2 Localizar los procesos y sus componentes Adems de los mens del Portal de Trabajo, Bizagi ofrece la posibilidad de disear y construir procesos en cualquier idioma, permitiendo que toda la interfaz de usuario se visualice en un nico idioma. Si el Portal de Trabajo solo se muestra en un idioma, los componentes del proceso se pueden disear en el idioma seleccionado desde el principio. Sin embargo, para soporte multi-idioma se debe localizar cada elemento del proceso (por ejemplo, flujo de trabajo, los atributos, los controles (campos de formulario), etc). Hay dos formas de traducir los recursos que componen los objetos de la Bizagi dentro de la aplicacin. Estos son:

Copyright 2013 - Bizagi

1873

Enfoque individual: debe utilizarse cuando los recursos traducidos se incluyen a medida que se modela el Proceso. Enfoque masivo: se debe utilizar cuando el proyecto ya ha sido modelado y se debe incluir la traduccin posteriormente.

Enfoque Individual
El enfoque individual permite que los trminos traducidos se incluyan durante el modelado. Esto se puede hacer cuando se crean nuevos elementos Bizagi.

Localizar los Procesos

Los Procesos pueden ser traducidos desde la Vista d e M d u lo s dando clic en la v ersi n del Proceso y seleccionando la opcin P ro p ied ad es.

Una nueva ventana mostrar sus propiedades. A la derecha del campo N o m b re v isu al del proceso se encuentra un icono de Globo conocido como B o t n d e lo calizaci n d e recu rso s. D clic en el icono para abrir el men de localizacin y traducir el nombre del proceso al idioma(s) deseado(s).

1874

Copyright 2013 - Bizagi

Nota La traduccin de la propiedad N o m b re v isu al puede realizarse para la mayora de objetos Bizagi tales como aplicaciones, entidades y organizaciones, desde cualquier lugar donde se muestre el botn de localizacin de recursos (es decir, el icono del globo) en la pantalla.

Localizar figuras y elementos de diagrama

Las figuras y elementos del diagrama (Lanes, Milestones) se pueden traducir desde la Vista d e M d u lo s dando clic en la v ersi n de Proceso y luego seleccionando la opcin Lo calizaci n .

Copyright 2013 - Bizagi

1875

Una nueva ventana mostrar el diagrama de proceso. Seleccione un elemento para traducir sus propiedades principales.

Localizar el Modelo de Datos

Los atributos de las entidades pueden traducirse en el momento de su creacin, independientemente del punto de entrada: M en d e M o d elo d e d ato s (segundo paso del asistente), Dise ad o r d e fo rm as

1876

Copyright 2013 - Bizagi

(tercer paso del asistente) o la Vista d e M d u lo s. Seleccione el atributo a traducir en la lista de atributos y d clic en el B o t n d e Lo calizaci n d e recu rso s.

Localizar Formas
Los atributos pueden localizarse globalmente. En otras palabras, se pueden traducir todos los atributos de una entidad de una sola vez. Sin embargo, es posible asignar localizaciones especficas a un formulario. La traduccin de elementos de formas se determina por el formato de visualizacin deseado. Suponga que est creando una Solicitud de Crdito, en la que el formulario contiene un control llamado Nombre completo. Cuando un analista revisa su solicitud, la etiqueta de control se mostrara como Nombre del cliente o Nombre del Solicitante. Las Vistas alternativas de la misma interfaz son una prctica de negocio comn, en este caso, el desarrollador sabe que debera cambiarse el nombre visual. Para localizar los atributos en un formulario, seleccione el atributo para ver sus propiedades bsicas y d clic en el B o t n d e lo calizaci n d e recu rso s.

Copyright 2013 - Bizagi

1877

Los elementos de las Formas tales como etiquetas, separadores y grupos pueden ser traducidos de la misma manera. Seleccione el elemento y haga clic en el B o t n d e lo calizaci n d e recu rso s en el panel de propiedades bsicas.

4.1.5.3

Escoger el idioma del Portal de Trabajo El Portal de Trabajo se muestra en el idioma predeterminado que se defini en la Cu ltu ra g lo b al del proyecto. Si se habilitan varios idiomas, los usuarios finales pueden elegir individualmente el idioma en el que se mostrar su Portal de Trabajo. El idioma elegido se debe seleccionar desde las P referen cias del Portal de Trabajo.

1878

Copyright 2013 - Bizagi

Para hacerlo, vaya al Portal de Trabajo y d clic en P referen cias

Una ventana mostrar las preferencias personales del usuario. Seleccione su preferencia de idioma desde la lista desplegable Id io m a y d clic en A ctu alizar. Tenga en cuenta que slo se listan los idiomas habilitados.

Reinicie el Portal de Trabajo para que lo cambios tengan efecto.

4.1.6

Comentarios del caso

Informacin general
Los Comentarios del caso presentan informacin complementaria para cada caso, que puede ser

Copyright 2013 - Bizagi

1879

introducida por el asignado o por cualquier persona con acceso a la Forma de Resumen. Los Comentarios del caso se utilizan a lo largo de la vida el caso para compartir informacin importante y ayudar a las personas que trabajan en ste a que se de un tratamiento adecuado de acuerdo con lo que se discute. La informacin ingresada en los Comentarios del caso debe ser relevante para todos los usuarios que trabajan en ste, que puede generar discusiones y que no se incluye en la informacin del caso dentro de las formas. La intencin es ayudar al desempeo y la comprensin que permitan a los usuarios finales a tomar mejores decisiones, evitar flujos innecesarios de proceso y reducir las brechas de comunicacin.

Crear un comentario
Comentarios de casos pueden ser introducidos al trabajar en una tarea. Haga clic en la pestaa Comentarios situado en el panel izquierdo de la pantalla y escriba su comentario en el campo de comentarios.

Una vez que el comentario se ha escrito, haga clic en Co m en tar. El comentario ser publicado.

1880

Copyright 2013 - Bizagi

Las personas con acceso a la Forma Resumen podrn ver los comentarios y tambin incluir comentarios propios:

Nota

Copyright 2013 - Bizagi

1881

La pestaa de comentarios estar visible para las personas con acceso al caso. Los Comentarios podrn verse desde la Forma resumen cuando por lo menos un comentario haya sido introducido por un asignado.

Responder un comentario existente

Puede responder a los comentarios del caso para completar la informacin o discusiones. Para hacer esto, coloque el ratn sobre el comentario que desea responder. Dos iconos aparecern:

Para responder a un comentario de clic en el botn de resp o n d er.

1882

Copyright 2013 - Bizagi

Haga clic en Co m en tar para publicar su respuesta.

Copyright 2013 - Bizagi

1883

Eliminar Comentarios de caso

Los comentarios pueden ser borrados por la persona que los escribi. Para hacer esto basta con colocar el ratn sobre el comentario.

1884

Copyright 2013 - Bizagi

Para eliminar el comentario clic en el icono de papelera y confirme la eliminacin.

Copyright 2013 - Bizagi

1885

Usando Categoras
Las Categoras clasifican los comentarios que se han hecho para un caso, en funcin de su prioridad, pertinencia o tema. Por ejemplo, puede clasificar sus comentarios entre instrucciones, consejos, a tener en cuenta, etc. La definicin y asignacin de categoras le permite a los usuarios finales filtrar los comentarios y centrarse en la informacin de su inters. Para definir las categoras siguientes pasos:

Definir categoras
1. Haga clic en F iltro en la pestaa Comentarios.

1886

Copyright 2013 - Bizagi

2. Se le presentar una lista de las categoras definidas por colores. Para cambiar la categora ingrese el nombre que desea definir y, a continuacin, haga clic en el icono de lpiz situado a la derecha.

3. Cambie el nombre de la categora y haga clic en el icono de aprobacin.

Copyright 2013 - Bizagi

1887

Nota Las categoras pueden ser editadas por cualquier usuario con acceso a los comentarios. Es recomendable estandarizar sus categoras y evitar su modificacin.

Asignar un filtro a un comentario

Haga clic en el icono de Filtro situado a la derecha de cada comentario y luego seleccione la categora deseada. Recuerde que slo puede asignar una categora a los comentarios hechos por usted.

1888

Copyright 2013 - Bizagi

Filtrar comentarios por categora

Los comentarios pueden ser filtrados cuando tienen una categora definida. Haga clic en la opcin Filtro y seleccione la categora que desea filtrar.

Copyright 2013 - Bizagi

1889

Retire los filtros y limpie las categoras

Para eliminar un filtro haga clic en el botn rojo situado en el lado derecho de la categora.

1890

Copyright 2013 - Bizagi

Para borrar una categora asociada seleccione el icono de categora, situado a la derecha del comentario. Seleccione la opcin Lim p iar en la lista desplegable. Recuerde que slo puede borrar Categoras de los comentarios hechos por usted.

Copyright 2013 - Bizagi

1891

Perfiles de usuario
El perfil de usuario identifica a cada usuario final con una foto para que todos puedan saber quin realiz un comentario. Su perfil puede ser configurado para incluir un nombre de usuario personalizado (apodo) y una imagen. 1. En el Portal de Trabajo vaya al men P referen cias.

1892

Copyright 2013 - Bizagi

2. Una nueva ventana aparecer. Para cambiar o actualizar la foto haga clic sobre la imagen predeterminada y luego cargue una nueva.

3. Para cambiar el nombre de usuario slo tiene que escribir el nuevo nombre en el campo Nombre. Luego haga clic en A ctu alizar.

Copyright 2013 - Bizagi

1893

4.1.7

Personalizar el Portal de Trabajo

Vista general
Bizagi permite personalizar los datos a mostrar (columnas) para las actividades pendientes y resultados de bsqueda, para ajustarse a sus necesidades. Usted puede incluir datos desde el modelo de datos del proceso y eliminar o modificar las columnas que Bizagi muestra por defecto. Las columnas personalizadas se muestran en: El Inbox del Portal de Trabajo Resultados de bsqueda Consultas La opcin de administracin de casos (bajo el men de Admin) Las columnas personalizadas para actividades pendientes pueden ser configuradas en cuatro niveles: Nivel global de aplicaciones: Es la configuracin de columnas que aparece cuando el usuario ingresa al portal de trabajo (Inbox). Nivel de aplicacin: Es la configuracin de columnas que aparece cuando el usuario filtra una bsqueda por una aplicacin especfica. Nivel de proceso : Es la configuracin de columnas que aparece cuando el usuario filtra una bsqueda por un proceso especfico. Nivel de sub-proceso: Es la configuracin de columnas que aparece cuando se accede a un subproceso desde una tarea de su proceso padre. Cada nivel de personalizacin prevalecer sobre el nivel previo. Por ejemplo, si usted ha configurado personalizacin a nivel de global de aplicaciones y a nivel de proceso, cuando usted realiza una bsqueda sobre los casos de un proceso, la informacin se mostrar con la configuracin de

1894

Copyright 2013 - Bizagi

columnas definida a nivel de proceso. Por el contrario, si no hay configuracin a nivel de proceso, la informacin se mostrara con la configuracin definida a nivel global de aplicaciones.

Cmo personalizar columnas?

1. Vaya al mdulo de P ro ceso s desde Bizagi Studio y busque el nivel en el cual desea definir la personalizacin de columnas. 2. D clic derecho sobre el componente que desea personalizar (nivel global de aplicaciones, aplicaciones o diagramas) y seleccione la opcin P erso n alizar co lu m n as.

Usted tambin puede acceder a esta opcin desde el men contextual que aparece en la parte superior de la pantalla al seleccionar una, aplicacin o proceso especfico.

Copyright 2013 - Bizagi

1895

3. Aparecer la ventana de P erso n alizaci n d e Co lu m n as. Para incluir nuevas columnas, deshabilite la opcin Utilizar co n fig u raci n p o r d efecto y luego d clic en A g reg ar Vo cab u lario o A g reg ar A trib u to de acuerdo al tipo de informacin que desee incluir.

Cuando se agrega un atributo, usted encontrar la lista de columnas estndar tales como n m ero d e

1896

Copyright 2013 - Bizagi

caso , Categ o ra, p ro ceso , activ id ad , fech a d e v en cim ien to , fech a d e creaci n entre otras. Usted tambin encontrar los atributos del modelo de datos del proceso que se encuentran relacionados a la aplicacin. Cuando se van a incluir atributos a nivel global de aplicaciones, los atributos del proceso no estan disponibles.

Cuando se agrega un vocabulario, usted encontrar la lista de definiciones disponibles para cada aplicacin o proceso.

Una vez incluidas las columnas deseadas, usted puede modificar el nombre de visualizacin de los atributos.

Copyright 2013 - Bizagi

1897

Adicionalmente usted puede cambiar el orden en el que se muestran las columnas, utilizando los iconos A rrib a o A b ajo .

Para eliminar columnas simplemente d clic en el atributo/vocabulario y luego d clic en el icono Rem o v er icon.

Columnas a nivel de sub-proceso

Biazgi tambin le permite configurar la informacin mostrada para un proceso, cuando este se accede como sub-proceso de otro proceso. Por defecto la vista de los sub-procesos de un proceso se muestra desde el Portal de trabajo de la siguiente manera:

Cuando se personalizan la columnas de un sub-proceso, usted no puede eliminar las columnas de informacin estndar (Nmero de caso y nombre del sub-proceso), solamente incluir nueva informacin. Para configurar la vista de un proceso cuando se accede como un sub-proceso, vaya al mdulo de

1898

Copyright 2013 - Bizagi

Procesos en Bizagi Studio y busque el sub-proceso. D clic sobre el y seleccione la opcin P erso n alizar co lu m n as. En la nueva ventana vaya a la pestaa de sub-procesos. Agregue la informacin necesaria siguiendo el paso tres de la seccin anterior.

Ejemplos
Personalizar columnas en general (aplica para todas las aplicaciones y todos los procesos) Por defecto Bizagi muestra las columnas de n m ero d e caso , p ro ceso , activ id ad , fech a d e creaci n , fech a d e v en cim ien to d e la tarea y fech a d e v en cim ien to d el p ro ceso en el Inbox del Portal de Trabajo. Suponga que solo deseamos mostrar las columnas de n m ero d e caso , n o m b re d e la activ id ad y n o m b re d el p ro ceso . Para hacerlo, vaya a la opcin A p licacio n es, desde el mdulo de P ro ceso s, y d clic derecho sobre ella. Luego seleccione la opcin P erso n alizar co lu m n as.

Copyright 2013 - Bizagi

1899

En la nueva ventana deshabilite la opcin Utilizar co n fig u raci n p o r d efecto y luego d clic en A g reg ar atrib u to .

Agregue los atributos deseados y d clic en O k.

1900

Copyright 2013 - Bizagi

Ahora vaya al Portal de Trabajo para ver los cambios. Antes de personalizar la columnas, las actividades pendientes se mostraban con la siguiente informacin:

Copyright 2013 - Bizagi

1901

Despus de la personalizacin se muestran de la siguiente manera:

Personalizar columnas a nivel de aplicacin Ahora suponga que usted tiene una aplicacin llamada Mesa de ayuda. Cuando usted filtra las actividades pendientes por un proceso de esta aplicacin (seleccionado el proceso desde el rea de Casos) usted solo desea ver la siguiente informacin: N m ero d e caso , fech a d e ap ertu ra, p rio rid ad y asu n to . Las dems aplicaciones mantendrn la personalizacin global de aplicaciones configurada en el

1902

Copyright 2013 - Bizagi

ejemplo anterior. Para hacerlo, vaya a la A p licaci n especfica (Mesa de ayuda), desde el mdulo de P ro ceso s, y d clic derecho sobre ella. Luego seleccione la opcin P erso n alizar co lu m n as.

En la nueva ventana deshabilite la opcin Utilizar co n fig u raci n p o r d efecto y luego d clic en A g reg ar atrib u to .

Copyright 2013 - Bizagi

1903

Agregue los atributos deseados desde el modelo de datos de la aplicacin y d clic en O k.

1904

Copyright 2013 - Bizagi

Vaya al Portal de Trabajo para ver los cambios. Antes de personalizar la columnas, las actividades pendientes se mostraban con la siguiente informacin:

Despus de la personalizacin se muestran de la siguiente manera:

Personalizar columnas a nivel de sub-proceso Suponga que usted desea controlar las diferentes actividades de un proyecto en el proceso Ad-hoc (disponible para descarga en nuestra Central de Procesos). En este proceso, cada actividad del

Copyright 2013 - Bizagi

1905

proyecto es una instancia de un sub-proceso (realizar tarea ad-hoc). Actualmente, cuando el gerente de proyecto accede al proceso padre, la informacin no es muy clara acerca de a cual actividad corresponde cada sub-proceso.

Con el fin de proveer mayor informacin al gerente, es necesario utilizar columnas personalizadas a nivel de sub-proceso. Para hacerlo, vaya al sub-proceso (realizar tarea ad-hoc), desde el mdulo de P ro ceso s, y d clic derecho sobre l. Luego seleccione la opcin P erso n alizar co lu m n as.

1906

Copyright 2013 - Bizagi

En la nueva ventana, vaya a la pestaa de sub-procesos. Deshabilite la configuracin por defecto y luego d clic sobre la opcin A g reg ar atrib u to .

Copyright 2013 - Bizagi

1907

Agregue los atributos deseados desde el modelo de datos del proceso y d clic en O k.

Ahora los sub-procesos se mostrarn de la siguiente manera:

1908

Copyright 2013 - Bizagi

Columnas personalizadas en produccin

Cuando un proyecto ha hecho deployment, algunos elementos como las Columnas personalizadas tendrn algunas restricciones para evitar posibles problemas con deployments futuros. Por esta razn, cuando una columna personalizada est en produccin, no podr ser editada ni borrada.

4.2

Deployment de sus Procesos Introduccin

Una vez que el ciclo de automatizacin se ha completado, Bizagi ofrece la posibilidad de publicar los Procesos para su ejecucin y puesta en marcha. El Deployment de Bizagi consiste en crear o actualizar la implementacin de los Procesos hacia un ambiente de pruebas o produccin.

A travs del Deployment asistido de Bizagi (aplica para Bizagi Enterprise .NET y Bizagi Xpress), se crean automticamente los otros ambientes diferentes al de desarrollo.

Si su proyecto est en Bizagi Enterprise JEE, el Deployment de los Procesos se realiza por medio del Deployment Avanzado de Bizagi.

Ambientes en Bizagi
Un proyecto de Bizagi tiene varios ambientes. Un ambiente lo definimos como una aplicacin independiente del proyecto, que cuenta con su propia Base de datos, Portal de Trabajo y servicio

Copyright 2013 - Bizagi

1909

Programador. De cara al Deployment de Bizagi, se recomienda utilizar los 3 ambientes que se crean por defecto (desarrollo, pruebas y produccin). desarrollo: Es el ambiente de construccin e implementacin. Es el nico ambiente donde se modelan e implementan los Procesos. Las fases de diseo y construccin hacen parte en l: se define el modelo de datos, las formas, las reglas de negocio, interfaces y participantes, entre otros. Es trabajado mediante Bizagi Studio. pruebas: Este ambiente es usado para simular un ambiente de produccin. Mediante l, se llevan a cabo pruebas de aceptacin de usuario en la funcionalidad de los Procesos (su certificacin). Los Procesos que se lleven al ambiente de pruebas se pueden marcar como "Release Candidate", de manera que los mismos queden bloqueados en el ambiente de desarrollo (para no permitir modificaciones hasta que se complete el ciclo de Deployment). Se administra mediante Bizagi Management Console. produccin: Este es el ambiente donde operan los Procesos de manera productiva. En l, los usuarios finales son quienes realizan su trabajo. En este ambiente y mediante Bizagi Management Console, es posible realizar tareas administrativas y de mantenimiento como: editar las polticas del negocio, administrar los usuarios y sus permisos sobre el Portal, revisar o reconfigurar el servidor SMTP para notificaciones, reconfigurar sistemas ECM, etc.

Deployment en un clic

Bizagi Studio presenta un asistente de Deployment llamado Deployment en un clic, el cual permite publicar y poner en marcha los Procesos de una manera rpida y amigable. El Deployment es un procedimiento asistido por el asistente mediante unas configuraciones muy sencillas (disponible para las ediciones Bizagi Enterprise .NET y Bizagi Xpress). La configuracin en un Deployment involucra: seleccionar los Procesos y sus versiones que sern publicadas, y seleccionar el ambiente de destino (pruebas o produccin), con otras preferencias especficas para cada ambiente. El Deployment en un clic crear automticamente el ambiente de destino (si es el primer Deployment a ese ambiente), donde quedar con su propia Base de datos, Portal de Trabajo y servicio Programador. En los siguientes Deployment, Bizagi actualizar la informacin de los Procesos a ese ambiente existente.

Ejecutar el Deployment
El Deployment en un clic se accede mediante Bizagi Studio, y se ejecuta desde el paso 7 del Asistente de Proceso (con la opcin Ejecu te y Dep lo y m en t). Ntese que esta opcin estar disponible una vez que por lo menos un Proceso ya haya completado

1910

Copyright 2013 - Bizagi

el Paso 6 (haber dado Sig u ien te) desde el Asistente de Proceso.

Alternatively, the deployment window and procedure can be launched too from the Process module (in the Modules View) by right-clicking on a specific Process version:

Qu pasa con los casos existentes?

Con el Deployment de Bizagi, los casos existentes de los Procesos (instancias de Proceso) del ambiente de desarrollo nunca son llevados al ambiente ed produccin ni al ambiente de pruebas (Bizagi no traslada valores almacenados en Entidades Maestras). Cuando se realiza un Deployment a un ambiente ya existente de produccin (no es el primer Deployment), entonces los casos previos se siguen ejecutando de manera consistente en ese ambiente con las siguientes caractersticas: Si se hace Deployment de una nueva versin de Proceso a produccin, los casos existentes de ese Proceso continuarn trabajando bajo la versin en la cual fueron creados. Por otro lado, los casos nuevos que se creen en produccin a partir de ese momento, trabajarn en la nueva versin. Ntese que tambin puede optar por realizar ajustes pequeos a un Proceso cuya versin ya est en produccin (y por ende hacer que los casos existentes tomen los nuevos cambios). En este escenario que involucra por ejemplo: adicionar un nuevo atributo, modificar una regla de negocio, o una asignacin de participante, se requiere hacer los cambios directamente sobre la misma versin de Proceso en produccin y publicarla de nuevo.

Copyright 2013 - Bizagi

1911

Cmo hacer un Deployment?

El Deployment de los Procesos en Bizagi debe realizarse una vez se cumplan los prerequisitos y siguiendo el ciclo recomendado de Deployment.

Prerequisitos
Para revisar las condiciones que deben cumplirse previo a un Deployment, consulte las Consideraciones y requerimientos para un Deployment.

Ciclo recomendado de Deployment

El siguiente diagrama ilustra el ciclo recomendado para el Deployment de Procesos:

1. Primero, se realizan Deployments al ambiente de pruebas de manera iterativa para identificar cualquier ajuste o modificacin en los Procesos. Estos se deben realizar en el ambiente de desarrollo. Estas iteraciones deben hacerse primero sin la marca de Release Candidate, de manera que en el ambiente de pruebas se ejecuten inicialmente las pruebas unitarias.

1912

Copyright 2013 - Bizagi

2. Cuando no hay ms ajustes o modificaciones pendientes de los resultados del ambiente de pruebas, un nuevo Deployment al mismo ambiente de pruebas debe ser realizado pero esta vez especificando que los Procesos deben marcarse como Release Candidate. De requerirse cualquier ajuste, entonces ser necesario cancelar el Release Candidate, llevar a cabo los cambios en desarrollo, y repetir el Deployment con Release Candidate. 3. Una vez que los Procesos con la marca de Release Candidate sean aprobados y certificados en pruebas, y se garantice que su comportamiento es el adecuado, entonces el Release Candidate podr ser aplicado en el ambiente de produccin. 4. Cualquier Deployment posterior (sea de nuevos Procesos, o enfocado al mejoramiento continuo de los Procesos), debe seguir este mismo ciclo recomendado. Vea ms informacin acerca del mejoramiento continuo de los Procesos y el desarrollo despus de un Deployment.

Deployment al ambiente de pruebas

Se recomienda enfticamente utilizar el ambiente de pruebas, y siempre realizar Deployments en l, antes de un Deployment a produccin. Para ello, tambin se debe optar por tener un ambiente de pruebas con caractersticas similares al ambiente de produccin, de manera que las pruebas de aceptacin de usuario puedan garantizar que los Procesos ya estn listos para ponerse en marcha en produccin (tienen un comportamiento esperado). Para mayor informacin acerca del Deployment al ambiente de pruebas y la opcin del Release Candidate, consulte el Deployment a pruebas.

Deployment al ambiente de produccin

Una vez que el Deployment a pruebas se haya hecho hasta que no se requieran modificaciones en desarrollo, puede optar por llevar los Procesos al ambiente de produccin. Para mayor informacin, consulte el Deployment a produccin.

Copyright 2013 - Bizagi

1913

4.2.1

Consideraciones y requerimientos
Antes de iniciar un Deployment en Bizagi, las siguientes consideraciones y requerimientos deben tenerse en cuenta:

1. Check-in de los Procesos

Asegrese que las versiones de los Procesos que quiere publicar mediante el Deployment no estn en un estatus de check-out (en edicin). Para ello, vaya al Mdulo de Procesos en la vista de Mdulos de Bizagi Studio. Revise que los Procesos (en sus versiones activas), estn en estatus de check-in (esto puede confirmarse si nadie est trabajando en el modelo del Proceso, y por lo tanto tienen visible la opcin de hacer check-out):

Se recomienda coordinar con su equipo de trabajo del proyecto, que cualquier usuario en Bizagi Studio est al tanto de que se va a realizar un Deployment, y cules versiones de Procesos involucra.

2. Revisar metadata desde Management Console

1914 Copyright 2013 - Bizagi

Abra su proyecto con Bizagi Management Console y utilice la opcin de Rev isar m etad ata para que Bizagi ejecute unas validaciones para detectar si hay errores en el modelamiento y detalles de implementacin de los Procesos.

De presentarse algn error, Bizagi indicar que debe ajustarse. Para ms informacin acerca de esta opcin, consulte Management Console.

3. Revisar los objetos que se van a desplegar

Tenga en cuenta que Bizagi tiene un tratamiento especial para los objetos a nivel de un proyecto que se publican en los dems ambientes. Por lo tanto, es importante conocer y entender cul es este tratamiento ya que vara segn los diferentes objetos en los mdulos de Bizagi (Entidades, Seguridad, Sistemas, etc.). Por ejemplo, las Entidades de Parametrizacin presentan una configuracin especfica para decidir si cada una de ellas debe trasladar sus valores o no. Para ms informacin acerca de este tratamiento, consulte Objetos que ya han tenido Deployment.

4. Requisitos tcnicos
Los siguientes son los requerimientos tcnicos para utilizar el Deployment en un clic que ofrece Bizagi Studio:

Bizagi instalado en los ambientes destino

Para realizar un Deployment a pruebas o produccin, se requiere instalar la misma edicin y versin de Bizagi que se tiene en el ambiente de desarrollo, en el Servidor BPM que tendr el ambiente de pruebas o produccin.

Copyright 2013 - Bizagi

1915

Para ms informacin, consulte Instalar Bizagi.

Los ambientes actualizados a la misma versin de Bizagi

Cuando se ha hecho ya un Deployment a pruebas o produccin, se requiere que estos ambientes existentes se encuentren actualizados a la misma versin de Bizagi en el ambiente de desarrollo. Para revisar la versin en la que se encuentra el ambiente del proyecto, use las opciones de administrar los proyectos registrados a travs de Bizagi Management Console:

1916

Copyright 2013 - Bizagi

Base de datos de la misma versin en los diferentes Servidores

Se requiere que la instancia de la Base de datos en los Servidores de pruebas y produccin, tenga la misma versin de Base de datos que se utiliza por el ambiente de desarrollo. Cuando se utiliza Microsoft SQL Server, esto significa revisar que sea la misma versin y service packs aplicados:

Cuando se utiliza Oracle, esto significa revisar que sea la misma versin y release:

Copyright 2013 - Bizagi

1917

Base de datos con la misma configuracin de caracteres en los diferentes Servidores

Se requiere que la instancia de la Base de datos en los Servidores de pruebas y produccin, tenga la misma configuracin de caracteres soportados para la Base de datos que se utiliza por el ambiente de desarrollo. Cuando se utiliza Microsoft SQL Server, esto significa revisar que la intercalacin (collation) sea el mismo:

1918

Copyright 2013 - Bizagi

Cuando se utiliza Oracle, esto significa revisar que la configuracin del set de caracteres sea el mismo:

Copyright 2013 - Bizagi

1919

Contar con credenciales autorizadas en el Servidor del ambiente

Se requieren crendenciales autorizadas para crear o actualizar el ambiente en pruebas o produccin. Esto se debe a que para crear el servicio Programador y el Portal de Trabajo se usan privilegios de adminstrador. Para ello, revise que la cuenta utilizada para iniciar Bizagi Studio se encuentre dentro del grupo de Administradores y del grupo Bizagi en el Servidor BPM. De lo contrario, requiere tener a la mano las credenciales de una cuenta con estos privilegios.

1920

Copyright 2013 - Bizagi

Para ms informacin, consulte Autorizacin para trabajar en un servidor remoto.

Acceso desde el Servidor de desarrollo a los dems servidores

Dado que el Deployment en un clic se realiza de una manera en-lnea, en este procedimiento se requiere que el Servidor BPM de desarrollo tenga acceso a los Servidores de pruebas o produccin. Adicionalmente, se recomienda revisar que no haya una configuracin de firewall (o cortafuegos) que bloquee los puertos utilizados en el transporte de datos del Deployment.

Para las ediciones Bizagi Enterprise En la conexin usada por el Deployment de la edicin Enterprise, la comunicacin entre los Servidores BPM Server deben tener habilitados los siguientes puertos: TCP 5679 UDP 50051, 50052 El puerto TCP que se define para la notificacin de respuesta (desde pruebas o produccin hacia desarrollo). Este puerto se puede cambiar explcitamente en el archivo B izag iStu d io .ex e.co n fig file (ubicado en la ruta de instalacin de Bizagi Studio, por defecto: "C:\Program Files\Bizagi\Bizagi Enterprise\Studio"). Por defecto, este puerto TCP est especificado como 0, lo cual implica un puerto aleatorio. Para cambiar este valor, ubique el elemento ch an n el del archivo de configuracin. Asegrese de utilizar un nmero de puerto que est permitido por la configuracin de red e infraestructura corporativa.

Para la conexin hacia la Base de datos, asegrese que el puerto del servicio de la Base de datos est habilitado desde el servidor BPM de pruebas o produccin. El puerto por defecto para una instancia SQL Server es 1433, mientras que el puerto por defecto para

Copyright 2013 - Bizagi

1921

una instancia Oracle es 1521.

Para Bizagi Xpress TCP 5678 UDP 50001, 50002 El puerto TCP que se define para la notificacin de respuesta (desde pruebas o produccin hacia desarrollo). Este puerto se puede cambiar explcitamente en el archivo B izag iStu d io .ex e.co n fig file (ubicado en la ruta de instalacin de Bizagi Studio, por defecto: "C:\Program Files\Bizagi\Bizagi Xpress\Studio"). Por defecto, este puerto TCP est especificado como 0, lo cual implica un puerto aleatorio. Para cambiar este valor, ubique el elemento ch an n el del archivo de configuracin. Asegrese de utilizar un nmero de puerto que est permitido por la configuracin de red e infraestructura corporativa.

Para la conexin hacia la Base de datos, asegrese que el puerto del servicio de la Base de datos est habilitado desde el servidor BPM de pruebas o produccin. El puerto por defecto para una instancia SQL Server es 1433, mientras que el puerto por defecto para una instancia Oracle es 1521. 4.2.1.1 Deployment de los objetos El Deployment en un clic de Bizagi publica los Procesos con las siguientes caractersticas y tratamiento:

1. Validaciones del motor de dependencias

Bizagi cuenta con un motor de dependencias el cual detecta las Entidades, formas, reglas de negocio,

1922

Copyright 2013 - Bizagi

etc, que estn siendo utilizadas por los Procesos involucrados en el Deployment. De esta manera, Bizagi incluye la informacin y objetos relevantes de manera automtica en el Deployment. De manera similar, Bizagi identifica esas Entidades, formas, reglas de negocio, etc, en el ambiente de desarrollo que no estn siendo utilizadas, sea por ningn objeto o no estn siendo utilizadas por los Procesos seleccionados en el Deployment. Estos que no se utilizan, no son incluidos por Bizagi en el Deployment. Sin embargo, tambin es posible como una opcin avanzada, forzar de manera manual que un objeto adicional se incluya en el Deployment. Nota Los elementos que se definen de manera global (p.e, funciones scripting o expresiones a nivel de la Entidad de Aplicacin) no pertenecen a los Procesos en s, y por lo tanto, no son detectados para ser incluidos en el Deployment por el motor de Dependencias. Para asegurarse de publicar estos elementos en el Deployment, junto con los Procesos que los utilizan, debe asegurarse de manualmente relacionar los elementos usando la opcin de Relacionar objetos.

2. Validaciones de integridad
Bizagi tambin ejecuta una serie de validaciones de integridad de los datos, para detectar si hay inconvenientes en el diseo, o errores en el modelamiento que deben ajustarse de cara al Deployment. Dentro de estas validaciones, Bizagi tambin detecta si hay posible conflictos con la informacin de los metadatos en produccin (cuando se realizan cambios y se publican hacia un ambiente de produccin ya existente). Es posible que estas validaciones arrojen: Mensajes de advertencia (warnings), que son idenfiticados con un cono amarillo. Mensajes de errores de integridad, que requiered de ajuste inmediato y son identificados con una equis roja. Los mensajes de advertencia no son errores como tal, y por lo tanto no detendrn la ejecucin del Deployment. Este tipo de alertas ensean temas sujetos a mejores prcticas, como por ejemplo cuando se modela una entidad con demasiados atributos (ms de 50). En este caso particular, no hay un error, sin embargo Bizagi previene que puede haber un tema de rendimiento si se hacen muchas consultas sobre esa entidad especfica. Por otro lado, los errores de integridad deben solucionarse para poder permitir el Deployment:

Copyright 2013 - Bizagi

1923

Cuando se presenta un error de integridad, puede dar clic sobre l para ver mayor detalle:

1924

Copyright 2013 - Bizagi

Ntese que puede almacenar este log como un archivo XML.

3. Administracin de Entidades de Parametrizacin

Cada Entidad de Parametrizacin tiene propiedades avanzadas, dentro de las cuales se define si la Entidad est diseada para que sus valores se administren directamente en el ambiente de produccin (o si por el contrario, sus valores se definen nicamente desde el ambiente de desarrollo). Por lo tanto, se recomienda revisar detalladamente esta definicin para las Entidades de Parametrizacin que se van a incluir en el Deployment. Ntese que es necesario ser consciente de esta definicin, ya que es exclusivo si la administracin de sus valores (ingresar, modificar o deshabilitarlos) debe hacerse en desarrollo o en produccin.

Copyright 2013 - Bizagi

1925

Solamente para el primer Deployment, se presenta la opcin de decidir si los valores de las Entidades de Parametrizacin se deben incluir, de manera que se lleven de desarrollo a produccin sin importar la propiedad mencionada anteriormente. En los Deployments posteriores, (cuando el ambiente de produccin ya exista), slo los valores de las Entidades de Parametrizacin que sean administrables en desarrollo sern actualizados en el ambiente de produccin. Para ms informacin sobre esta propiedad, consulte Dnde administrar las Entidades de Parametrizacin.

4. Configuracin en produccin
Tenga en cuenta que existen diferentes configuraciones asociadas a los distintos mdulos de un proyecto Bizagi. Para cada mdulo, los diferentes valores se manejan por el Deployment con un tratamiento es especial. Es posible definir los valores para el ambiente de pruebas siempre desde Bizagi Studio. Esto implica que estos valores se actualizan en el ambiente de pruebas siempre al momento de hacer Deployment. Para el ambiente de produccin, se definen los valores inicialmente cuando todava este ambiente no existe, (no se ha realizado Deployment a produccin). Para los Deployment posteriores, la admnistracin de estos valores se realiza directamente sobre el ambiente especfico (usando Bizagi Management Console). Este concepto y tratamiento aplica para los siguientes mdulos y configuraciones:

4.1 Opciones de entorno

En el ambiente de desarrollo, es posible definir los valores iniciales que debe tomar el ambiente de pruebas o produccin en cuanto a la configuracin de las O p cio n es d e en to rn o .

1926

Copyright 2013 - Bizagi

Para el ambiente de produccin, esto solamente es definible antes del primer Deployment.

Esto se debe a que una vez que esta configuracin sea llevada a produccin, la edicin de estos valores debe hacerse directamente sobre el ambiente (usando Bizagi Management Console). Para ms informacin sobre esta configuracin especficamente, consulte Configuracin de entorno.

4.2 Propiedades de interfaces (Sistemas)

Cuando se define una interfaz para la invocacin de un servicio Web o REST, se definen inicialmente los valores para dicha configuracin (por ejemplo, la URL, el mtodo, las credenciales autorizadas, etc) . Una vez que ya se haya hecho un Deployment a produccin, esta configuracin no es editable desde el ambiente de desarrollo (debe realizarse de manera separada a travs del Management Console). Para el ambiente de pruebas, los valores si se pueden redefinir nuevamente desde el ambiente de desarrollo (a travs de Bizagi Studio) para que el Deployment los actualice.

Copyright 2013 - Bizagi

1927

En resumen, cambios en la configuracin de invocacin a servicios externos Web o REST, que ya est en produccin, deben hacerse directamente sobre ese ambiente.

4.3 Propiedades de Proveedores de datos (Sistemas)

Cuando se crea un nuevo Proveedor de datos (para la Virtualizacin o Replicacin), se definen sus parmetros iniciales (de conexin, como la cadena o el login con permisos) para los dems ambientes: pruebas y produccin. Una vez que ya se haya hecho un Deployment a produccin, esta configuracin no es editable desde el ambiente de desarrollo (debe realizarse de manera separada a travs del Management Console). Para el ambiente de pruebas, los valores si se pueden redefinir nuevamente desde el ambiente de desarrollo (a travs de Bizagi Studio) para que el Deployment los actualice.

1928

Copyright 2013 - Bizagi

En resumen, cambios en la configuracin de sistemas con Proveedores de datos, que ya est en produccin, debe hacerse directamente sobre ese ambiente.

4.4 Propiedades ECM (Sistemas)

Al crear un nuevo repositorio, se definen las propiedades de la carpeta y del mismo, para cada ambiente. Una vez que esta configuracin ya ha sido llevada a produccin, los valores de configuracin para este repositorio no son editables desde el ambiente de desarrollo (deben hacerse directamente en el ambiente a travs del Management Console). Para el ambiente de pruebas, los valores si se pueden redefinir nuevamente desde el ambiente de desarrollo (a travs de Bizagi Studio) para que el Deployment los actualice. En resumen, cambios en la configuracin de sistemas ECM que ya est en produccin, debe hacerse directamente sobre ese ambiente. El mismo concepto aplica This same concept applies for the folders definition in the ECM integration.

4.5 Autenticacin y configuracin con LDAP

Las opciones presentadas en el mdulo de Seguridad tienen un manejo especial. La configuracin de Autenticacin y sincronizacin con LDAP se define inicialmente en el ambiente de desarrollo (por ejemplo, el mtodo de Autenticacin usado en el Portal de Trabajo o si se importan usuarios desde un Servidor LDAP). Una vez que ya se haya hecho un Deployment a produccin, esta configuracin no es editable desde el ambiente de desarrollo (debe realizarse de manera separada a travs del Management Console). Para el ambiente de pruebas, los valores si se pueden redefinir nuevamente desde el ambiente de desarrollo (a travs de Bizagi Studio) para que el Deployment los actualice.

Copyright 2013 - Bizagi

1929

En resumen, cambios en la configuracin de Autenticacin y LDAP que ya est en produccin, debe hacerse directamente sobre ese ambiente. Nota Lo anterior no incluye la configuracin de autorizaciones la cual puede ser administrada tanto: directamente en produccin con el Management Console, o sobre el ambiente de desarrollo y ejecutar un Deployment para actualizar la configuracin.

4.6 Usuarios (WFUser)

Solamente para el primer Deployment al ambiente de produccin, se presenta la opcin de incluir los usuarios que se hayan creado en el ambiente de desarrollo (hacia produccin). Despus del primer Deployment, la administracin de usuarios en produccin se realiza de manera separada (independientemente a travs de las opciones del Portal de Trabajo). Para los Deployments al ambiente de pruebas, siempre se presenta la opcin de incluir los usuarios desde desarrollo.

4.7 Grupos de usuarios (Desde la definicin de Organizacin)

1930

Copyright 2013 - Bizagi

La definicin de los elementos de la Organizacin en un proyecto (tal como: areas, posiciones, habilidades, roles, grupos de usuario, etc...), se realiza nicamente desde el ambiente de desarrollo. Los grupos de usuario en particular, a pesar de que son definidos desde desarrollo, se pueden configurar directamente en el ambiente produccin solo para incluir o excluir usuarios. Esta edicin no incluye la redefinicin, eliminacin, o creacin de grupos de usuario. 4.2.1.2 Relacionar objetos Cuando se hace Deployment de los Procesos al ambiente de pruebas o produccin, Bizagi ejecutar las validaciones de su motor de dependencias para determinar qu objetos especficamente se debe llevar a estos ambientes (los que se usan por los Procesos seleccionados en el Deployment). A travs de estas validaciones Bizagi incluye de manera automtica los objetos como Entidades, formas y reglas de negocio, entre otros.

De manera similar, Bizagi identifica esas Entidades, formas, reglas de negocio, etc, en el ambiente de desarrollo que no estn siendo utilizadas, sea por ningn objeto o no estn siendo utilizadas por los Procesos seleccionados en el Deployment. Estos que no se utilizan, no son incluidos por Bizagi en el Deployment. Sin embargo, tambin es posible de manera manual decidir que un objeto se incluya adicionalmente en el Deployment. Esta opcin es especialmente til para incluir objetos tales como: Formas de consulta de entidades (consultas de entidades), que no estn necesariamente atadas a un Proceso en particular.

Definir los objetos relacionados

Para definir y configurar qu objetos adicionales se relacionan a ciertas versiones de Proceso, hay 2 maneras: previamente desde las propiedades del Proceso, o desde el Deployment en un clic asistido (durante la configuracin de un Deployment).

Desde las propiedades del Proceso

Cuando se est trabajando en los detalles de implementacin de los Procesos en un proyecto Bizagi, se puede optar por ir relacionando los objetos recin creados a un Proceso especfico (el Proceso que principalmente utiliza estos objetos). De esta manera, cuando el Proceso se lleva a produccin mediante el Deployment, se tendr certeza de que estos objetos siempre se incluyan tambin.

Copyright 2013 - Bizagi

1931

Por ejemplo, cuando se crea un consulta a nivel de Entidad, es til definirlo explcitamente como un objeto relacionado a un Proceos, para que ste sea llevado y actualizado en el ambiente de produccin siempre que se seleccione dicho Proceso en el Deployment.

Desde el Deployment Asistido

Cuando se configura y se ejecuta un Deployment, es posible incluir manualmente los objetos que se deseen atar forsozamente a un determinado Proceso. Es recomendado realizar esto con los objetos que se observe que no son necesariamente pertenecientes al Proceso como tal (y que Bizagi no los detecta dentro de los objetos que debe llevar en el Deployment).

1932

Copyright 2013 - Bizagi

Por ejemplo, cuando se crea un consulta a nivel de Entidad, es til definirlo explcitamente como un objeto relacionado a un Proceos, para que ste sea llevado y actualizado en el ambiente de produccin siempre que se seleccione dicho Proceso en el Deployment. Esto se puede realizar desde el Deployment con la opcin desde el clic derecho del Proceso seleccionado.

Objects to relate
Para relacionar objetos, haga clic en la opcin Relacio n ar o b jeto s desde las propiedades del Proceso o desde la configuracin del Deployment. En esta opcin, podr relacionar: En tid ad es, F o rm as d e co n su lta, o Reg las d e n eg o cio (incluye funciones).

Entities
Haga clic en el tem de Entidades para marcar las Entidades Maestras o de Parametrizacin las cuales se relacionan al determinado Proceso.

Copyright 2013 - Bizagi

1933

En la imagen superior, las 2 Entidades: Cu sto m er y Cu sto m erTy p e son marcadas como objetos relacionados.

Formas de consulta
Haga clic en el tem de Formas de consulta para marcar aquellas formas de consulta (sea a nivel de aplicacin o a nivel de Entidad) las cuales se relacionan al determinado Proceso.

1934

Copyright 2013 - Bizagi

En la imagen superior, la forma de consulta de Entidad llamada Ticket Resp o n se Q u ery es marcada como un objeto relacionado.

Reglas de negocio
Haga clic en el tem de Regla de negocio para marcar aquellas reglas (sean de scripting o de tipo Booleano) y funciones las cuales se relacionan al determinado Proceso.

Copyright 2013 - Bizagi

1935

En la imagen superior, la regla de negocio llamada A ssig n Statu s (que se encuentra a nivel de la aplicacin) y la funcin llamada m y F u n ctio n , son marcadas como objetos relacionados.

4.2.2

Deployment a Pruebas

Introduccin
El Deployment de los Procesos hacia un ambiente de pruebas es enfticamente recomendado para realizar las pruebas de aceptacion necesarias que determinen que los Procesos se comportan adecuadamente. En este artculo ilustramos cmo realizar un Deployment al ambiente de pruebas.

1936

Copyright 2013 - Bizagi

Prerequisitos
Antes de continuar leyendo este documento, asegrese de conocer y revisar los requisitos para un Deployment de Bizagi. Para ms informacin, consulte las Consideraciones y requerimientos del Deployment.

Deployment a pruebas
Tenga en cuenta que los pasos y opciones mencionados a continuacin, sern enfocados y clasificados si se trata del primer Deployment que se efecta a este ambiente, o si por el contrario no es un primer Deployment (se considera como un Deployment posterior). Esto se debe a que las opciones que se presentan en la configuracin del Deployment en un clic difieren ligeramente dependiendo de si el ambiente ya existe o no. De igual manera, las configuraciones tienen tambin diferencias con respecto a las que se presentan cuando se realiza un Deployment a produccin.

Primer deployment a pruebas

En el primer Deployment a cualquier ambiente, Bizagi crea de manera automtica el ambiente y sus componentes en los Servidores destino (por ejemplo, se crea el Portal de Trabajo y el servicio Programador en el Servidor BPM, y las Base de datos en el Servidor de Base de datos). Por lo tanto, para crear el ambiente, debe asegurarse de tener la configuracin y requisitos apropiados tal como se deben tener para crear un proyecto de Bizagi. Para ms informacin, consulte la lista de chequeo para creacin de proyectos.

Copyright 2013 - Bizagi

1937

Para realizar un primer Deployment al ambiente de pruebas, se llevan a cabo los siguientes pasos. 1. Ejecute el Deployment en un clic. Vaya al paso # 7 del Asistente de Proceso (opcin Ejecu tar) y de clic sobre H acer Dep lo y m en t d el P ro ceso .

2. Seleccione el ambiente. Bizagi inicia el asistente del Deployment en un clic. Marque el ambiente a dnde va a realizar el Deployment de sus Procesos. Ntese que para el ambiente de pruebas, adicionalmente se puede escoger la opcin de Release Candidate para bloquear la edicin de los Procesos en desarrollo (para dejarlos es un estatus similar al de produccin). Para ms informacin sobre esta opcin, consulte Release Candidate.

1938

Copyright 2013 - Bizagi

Seleccione el ambiente de p ru eb as, y de clic en Sig u ien te. 3. Seleccione el Servidor BPM De la lista de servidores disponibles que se muestran, seleccione su Servidor de pruebas. Ntese que en la lista aparecen aquellos que cuenten con los componentes de Servidor de Bizagi instalados (y que sean visibiles dentro de la red del Servidor de desarrollo). Es posible seleccionar el Servidor local de desarrollo como Servidor de pruebas, sin embargo tenga en cuenta que esto no es lo recomendado para llevar a cabo ptimas pruebas de aceptacin de usuario o pruebas enfocadas al rendimiento de la aplicacin, y tampoco es lo ideal por buenas prcticas de autorizacin a usuarios.

Copyright 2013 - Bizagi

1939

Una vez seleccione su servidor, de clic en Sig u ien te. En dado caso en el que su servidor no aparezca en la lista (pero si se tenga acceso y este tiene instalado Bizagi), puede ingresar directamente el nombre del servidor en el primer cono. Nota Tambin es posible digitar directamente la direccin IP en vez del nombre del servidor, sin embargo si se especifica de esta manera, debe asegurarse que la direccin IP no sea dinmica (es decir, que la IP no cambie). Tenga presente que al seleccionar un Servidor de pruebas, debe asegurarse que se cuenten con las credenciales autorizadas de acceso a ese servidor. Esto se cumple con 2 posibilidades: o la cuenta de Windows que se usa para el Deployment (con la que se abri Bizagi Studio) pertenece al grupo de Bizagi y al grupo de Administradores del Servidor de pruebas, o se tienen a la mano las credenciales de una cuenta autorizada para ese servidor (que pertenezca a los grupos mencionados anteriormente).

1940

Copyright 2013 - Bizagi

4. Seleccione el Servidor de Base de datos Seguidamente, Bizagi presentar las instancias de Base de datos que encuentre instaladas en el servidor. Seleccione o digite directamente el nombre del Servidor de Base de datos y la instancia de Base de datos a usarse para el ambiente. Para el ambiente de pruebas, por defecto se nombra la Base de datos como "Test_[miProyecto]" pero es posible editar este nombre.

Copyright 2013 - Bizagi

1941

Ingrese la cuenta y contrasea para la Base de datos y de clic en Sig u ien te. 5. Configure las opciones avanzadas. Revise las opciones avanzadas de acuerdo a si desea incluir esas posibilidades:

Relacionar objetos: Puede optar por marcar objetos adicionales (como reglas, entidades o formas de consulta) para que sean forzosamente incluidos en el Deployment (as no se usen por los Procesos seleccionados).

1942

Copyright 2013 - Bizagi

Para ms informacin acerca de esta opcin, consulte Relacionar objetos. Agregar ms Procesos: Puede optar por incluir ms Procesos en el mismo Deployment.

Copyright 2013 - Bizagi

1943

Incluir usuarios en el ambiente destino: Puede optar por trasladar los usuarios que se crearon en el ambiente de desarrollo hacia el ambiente de pruebas. Incluir registros de entidades de Parametrizacin administradas en produccin: Puede optar por incluir los valores (registros) de aquellas entidades de Parametrizacin que fueron definidas como administrables nicamente en produccin. Nota Cuando no se incluyen los usuarios de desarrollo hacia pruebas (se deja sin marcar la opcin In clu ir u su ario s en el am b ien te d estin o ), Bizagi igualmente crear el usuario por defecto (slamente crear este usuario) en el ambiente de pruebas (el cual es domain\admon). Siendo as, tenga en cuenta que el usuario domain\admon debe tener los permisos necesarios para crear ms usuarios. 6. Confirme la configuracin del Deployment. En la ventana de resmen y confirmacin, se vern los Procesos que se seleccionaron para el Deployment, al igual que la configuracin relacionada al ambiente de pruebas (Servidor BPM y de Base de datos). En esta ventana es igualmente posible revisar si hay o se necesitan objetos adicionales relacionados.

1944

Copyright 2013 - Bizagi

Para iniciar el Deployment, de clic en F in alizar. Bizagi notificar que debe cerrar otras ventanas de Bizagi Studio o Management Console que pueda tener abiertas con el mismo proyecto.

7. Finalice el Deployment. El Deployment en un clic de Bizagi ejecutar las validaciones y el Deployment. Dado que es el primer Deployment, Bizagi crear el ambiente y sus componentes de manera automtica.

Copyright 2013 - Bizagi

1945

Bizagi notifica cuando se complete el Deployment satisfactoriamente.

1946

Copyright 2013 - Bizagi

Haga clic en Cerrar.

Copyright 2013 - Bizagi

1947

Al finalizar el Deployment, los Procesos en el ambiente de pruebas podrn probarse y ejecutarse inmediatamente. Para iniciar el Portal de Trabajo del ambiente de pruebas, puede usar la opcin Ejecu tar desde el asistente de Procesos, en la cual se podr observar su URL. Haga clic en el cono o etiqueta del mismo para iniciar el Portal de Trabajo:

1948

Copyright 2013 - Bizagi

Deployments posteriores a pruebas

El concepto de un Deployment posterior aplica a aquellos Deployments que se realicen despus del primer Deployment. Las opciones de los Deployments posteriores varan ligeramente con respecto a las presentadas en un primer Deployment. En estos Deployments posteriores, Bizagi ubicar el ambiente existente para actualizar lleva la informacin de los Procesos. Esto significa que por defecto no se crea un proyecto nuevo, a menos que se escoja la opcin de cambiar el ambiente. El procedimiento involucra los siguientes pasos: 1. Ejecute el Deployment en un clic. Vaya al paso # 7 del Asistente de Proceso (opcin Ejecu tar) y de clic sobre H acer Dep lo y m en t d el P ro ceso .

Copyright 2013 - Bizagi

1949

Tenga presente que si su Deployment ms reciente fue hecho precisamente al ambiente de pruebas con la marca de Release Candidate (y todava no se ha aplicado a produccin), entonces deber primero decidir si llevar estos Procesos a produccin o cancelar el Release Candidate. Para ms informacin sobre esta opcin, consulte Release Candidate. 2. Seleccione el ambiente. Bizagi inicia el asistente del Deployment en un clic. Marque el ambiente a dnde va a realizar el Deployment de sus Procesos. Ntese que para el ambiente de pruebas, adicionalmente se puede escoger la opcin de Release Candidate para bloquear la edicin de los Procesos en desarrollo (para dejarlos es un estatus similar al de produccin).

1950

Copyright 2013 - Bizagi

Seleccione el ambiente de p ru eb as, y de clic en Sig u ien te. 3. Defina las opciones con respecto al ambiente de produccin. Bizagi ensea una opcin adicional cuando ya existe un ambiente de produccin. En este escenario, la opcin permite: Hacer el Deployment a pruebas nicamente con los Procesos seleccionados desde desarrollo (de una manera aislada), o cargar inicialmente en pruebas los Procesos que ya estn en produccin (y adicionarle los Procesos que vienen desde desarrollo).

Copyright 2013 - Bizagi

1951

Sin los Procesos en produccin: Con esta opcin, el ambiente de pruebas se crea slo con los Procesos que se seleccionaron para el Deployment. Incluir los Procesos en produccin: Con esta opcin, el ambiente de pruebas tendr tanto los Procesos que se seleccionaron para el Deployment, como los Procesos que estn operativos en el ambiente de produccin. Con cualquiera de las opciones anteriores, tenga en cuenta que no habrn casos poblados en el ambiente de pruebas (de produccin tambin solamente se traeran los Procesos y no los datos). 4. Configure las opciones avanzadas. Revise las opciones avanzadas de acuerdo a si desea incluir esas posibilidades:

1952

Copyright 2013 - Bizagi

Relacionar objetos: Puede optar por marcar objetos adicionales (como reglas, entidades o formas de consulta) para que sean forzosamente incluidos en el Deployment (as no se usen por los Procesos seleccionados). Para ms informacin acerca de esta opcin, consulte Relacionar objetos. Agregar ms Procesos: Puede optar por incluir ms Procesos en el mismo Deployment. Incluir usuarios en el ambiente destino: Puede optar por trasladar los usuarios que se crearon en el ambiente de desarrollo hacia el ambiente de pruebas. Incluir registros de entidades de Parametrizacin administradas en produccin: Puede optar por incluir los valores (registros) de aquellas entidades de Parametrizacin que fueron definidas como administrables nicamente en produccin. Nota Cuando no se incluyen los usuarios de desarrollo hacia pruebas (se deja sin marcar la opcin In clu ir u su ario s en el am b ien te d estin o ), Bizagi igualmente crear el usuario por defecto (slamente crear este usuario) en el ambiente de pruebas (el cual es domain\admon). Siendo as, tenga en cuenta que el usuario domain\admon debe tener los permisos necesarios para crear ms usuarios. 5. Confirme la configuracin del Deployment. En la ventana de resmen y confirmacin, se vern los Procesos que se seleccionaron para el Deployment, al igual que la configuracin relacionada al ambiente de pruebas (Servidor BPM y de Base de datos).

Copyright 2013 - Bizagi

1953

En esta ventana es igualmente posible revisar si hay o se necesitan objetos adicionales relacionados. Cuando no se est ejecutando un primer Deployment, se presenta en este punto la posibilidad de cambiar el ambiente actual de pruebas (esto es, seleccionar un Servidor BPM o de Base de datos diferente al existente). Para ello, utilice la opcin de Cam b iar serv id o r, con la que se presentarn las ventanas de configuracin para escoger los servidores (similar a cmo se realiza en un primer Deployment).

Nota Si se cambia el ambiente de pruebas (se seleccionan otros servidores), Bizagi crear el ambiente nuevo en el servidor nuevo y actualizar la informacin en su ambiente de desarrollo. Sin embargo, Bizagi no eliminar el ambiente anterior. Para iniciar el Deployment, de clic en F in alizar. Bizagi notificar que debe cerrar otras ventanas de Bizagi Studio o Management Console que pueda tener abiertas con el mismo proyecto.

1954

Copyright 2013 - Bizagi

7. Finalice el Deployment. El Deployment en un clic de Bizagi ejecutar las validaciones y el Deployment. Previo a ello, realiza de manera automtica un backup de los componentes del ambiente: la Base de datos, las carpetas del Portal de Trabajo y del servicio Programador.

El backup automtico de la Base de datos se almacena segn el escenario: Cuando se utiliza SQL Server de manera local (el Servidor de Base de datos es el mismo Servidor BPM), entonces la ruta es "C:\Bizagi\[edicion_Bizagi]\Projects\[su_proyecto]\Backups\". Cuando se utiliza SQL Server en un Servidor remoto, la ruta es la de los backups de la instancia (por defecto "C:\Program Files (x86)\Microsoft SQL Server\[instancia_MSSQL]\MSSQL\Backup\"). Cuando se utiliza Oracle, esta ruta es la predefinida para la instancia; tal como se configura en el

Copyright 2013 - Bizagi

1955

momento de crear el proyecto en Oracle.

Al finalizar el Deployment, haga clic en Cerrar.

Qu pasa con los casos existentes en pruebas?

Cuando se realiza un Deployment al ambiente de pruebas, los casos previos del ambiente de pruebas no se conservan (esto no sucede con el ambiente de produccin). Lo anterior obedece a la buena prctica de llevar a cabo pruebas de aceptacin de usuario de punta a punta, garantizando que se prueben los Procesos con nuevos casos (desde el comienzo del flujo). 4.2.2.1 Release Candidate en Deployment a Pruebas En el Deployment al ambiente de pruebas, Bizagi presenta una opcin para marcar los Procesos seleccionados como Release Can d id ate. Cuando se usa esta opcin, los Procesos sern tratados por Bizagi de manera especial en el ambiente de desarrollo (con el mismo tratamiento que tienen los Procesos que ya se estn ejecutando en produccin).

1956

Copyright 2013 - Bizagi

Cuando utilizar el Release Candidate

Un Deployment de Procesos que se lleven al ambiente de pruebas sin utilizar la opcin Release Candidate, es til para: 1. Ejecutar pruebas unitarias 2. Detectar posibles temas de configuracin que requieran ajustes 3. Ejecutar una demo (una presentacin). Por otro lado, cuando los Procesos se llevan al ambiente de pruebas con la marca de Release Candidate, Bizagi har lo siguiente: 1. Un bloqueo de los mismos en el ambiente de desarrollo, para evitar que sean modificados. En otras palabras, Bizagi congela el modelo del Proceso (flujo) y dems objetos que estn siendo utilizados por el Proceso (p.e formas, atributos, etc) para garantizar que el Proceso que se prueba en el ambiente de pruebas es tal como se llevaran los Procesos a produccin. 2. Mantendr el grupo de Procesos en Release Candidate Processes en un estatus "en espera", con toda la informacin de los mismos listo para ser llevado a produccin si las pruebas de certificacin de calidad son exitosas. Nota De requerirse cualquier ajuste al Proceso o sus objetos, se debe cancelar el Release Candidate para que Bizagi levante el bloqueo de edicin en desarrollo. De esta manera, debe repetirse el Deployment a pruebas con Release Candidate despus de los ajustes.

Cmo funciona el concepto Release Candidate?

Copyright 2013 - Bizagi 1957

Los Procesos marcados como Release Candidate tendrn sus objetos bloqueados para edicin en el ambiente de desarrollo. Dicho bloqueo de edicin es diferente para los distintos tipos de objetos (el tratamiento que se da como si el objeto estuviera ya en produccin), segn lo descrito en Mejora continua y desarrollo despus de Deployments. Si las pruebas de aceptacin de usuario no son exitosas y se detecta que se debe realizar alguna modificacin, entonces se debe cancelar el Release Candidate iniciando el asistente de Deployment (con Bizagi Studio). El Deployment en un clic, mostrar el Release Candidate pendiente y se debe escoger la opcin de Can celar el Release Can d id ate:

Al cancelarlo, Bizagi pedir confirmacin del procedimiento:

1958

Copyright 2013 - Bizagi

Despus de realizar las modificaciones o ajustes identificados, se debe repetir el Deployment a pruebas con la marca de Release Candidate. Este procedimiento se repite hasta que las pruebas de aceptacin de usuario sean existosas y se certifique que los Procesos se comportan adecuadamente y estn listos para el ambiente de produccin. De esta manera, al iniciar el asistente de Deployment nuevamente desde Bizagi Studio, se escoge que Bizagi debe aplicar el Release Candidate en produccin. Para ello, seleccione la opcin A p licar Release Can d id ate:

Con esto, Bizagi iniciar la configuracin del Deployment al ambiente de produccin con los Procesos aprobados y certificados.

En resumen de este ltimo concepto, cuando se tienen unos Procesos marcados como Release Candidate, el Deployment en un clic de Bizagi avisar que se debe resolver dicho Release Candidate (sea aplicarlo a produccin o cancelarlo) antes de cualquier otra opcin de Deployment.

4.2.3

Deployment a Produccin

Introduccin
Bizagi presenta un asistente de Deployment con una configuracin amigable para publicar los Procesos a un ambiente productivo. Este Deployment se lleva a cabo con el Deployment en un clic, de una manera en-lnea y sencilla. En este artculo ilustramos cmo realizar un Deployment de los Procesos al ambiente de produccin.

Copyright 2013 - Bizagi

1959

Prerequisitos
Antes de continuar leyendo este documento, asegrese de haber revisado: 1. Los prerequisitos generales del Deployment en Bizagi. Para ms informacin, consulte las Consideraciones y requerimientos del Deployment. 2. Cmo realizar un Deployment a pruebas, y el uso del Release Candidate. Para ms informacin, consulte el Deployment a pruebas.

Adicional a lo anterior, asegrese de: 1. Tener a la mano la licencia para su ambiente de produccin Bizagi (para el Portal de Trabajo se requiere licenciar el Servidor BPM segn el nmero de usuarios finales). Ms informacin sobre licenciamiento. 2. Tomar previamente backups de los ambientes de desarrollo y produccin, ya que el Deployment a produccin es un procedimiento que no puede deshacerse desde Bizagi. Nota Es recomendado que un Deployment se programe con anticipacin y se notifique debidamente. El Deployment en un clic detiene de manera temporal los servicios del servidor, por lo que es recomendado realizarlo en horas no laborales.

Deployment a produccin
El Deployment a produccin debe hacerse siempre despus de haber probado y garantizado que los Procesos se comportan adecuadamente en un ambiente dedicado a pruebas. Tenga presente que para ello, se debe haber realizado un Deployment a pruebas con la marca de Release Candidate.

Los Deployments realizados directamente desde desarrollo hacia produccin (sin pasar por el ambiente de pruebas) son soportados y se llevan a cabo de manera similar a un Deployment a pruebas, sin embargo tenga en cuenta que este no es el procedimiento recomendado.

Primer deployment a produccin

1960

Copyright 2013 - Bizagi

De acuerdo a la idea presentada anteriormente, los siguientes pasos se llevan a cabo para un primer Deployment a produccin (a partir de un Release Candidate). 1. Ejecute el Deployment en un clic. Vaya al paso # 7 del Asistente de Proceso (opcin Ejecu tar) y de clic sobre H acer Dep lo y m en t d el P ro ceso .

2. Aplique el Release Candidate. Dado que el Deployment ms reciente fue el realizado al ambiente de pruebas con la marca de Release Candidate, Bizagi notificar que se debe resolver el Release Candidate pendiente.

Copyright 2013 - Bizagi

1961

Haga clic en A p licar a p ro d u cci n y en Sig u ien te. 3. Seleccione el Servidor BPM Bizagi presenta una lista de servidores disponibles para el ambiente de produccin. De la lista que se muestra, seleccione su Servidor de produccin. Ntese que en la lista aparecen aquellos que cuenten con los componentes de Servidor de Bizagi instalados (y que sean visibiles dentro de la red del Servidor de desarrollo).

1962

Copyright 2013 - Bizagi

Una vez seleccione su servidor, de clic en Sig u ien te. En dado caso en el que su servidor no aparezca en la lista (pero si se tenga acceso y este tiene instalado Bizagi), puede ingresar directamente el nombre del servidor en el primer cono. Nota Tambin es posible digitar directamente la direccin IP en vez del nombre del servidor, sin embargo si se especifica de esta manera, debe asegurarse que la direccin IP no sea dinmica (es decir, que la IP no cambie). Tenga presente que al seleccionar un Servidor de produccin, debe asegurarse que se cuenten con las credenciales autorizadas de acceso a ese servidor. Esto se cumple con 2 posibilidades: o la cuenta de Windows que se usa para el Deployment (con la que se abri Bizagi Studio) pertenece al grupo de Bizagi y al grupo de Administradores del Servidor de produccin, o se tienen a la mano las credenciales de una cuenta autorizada para ese servidor (que pertenezca a los grupos mencionados anteriormente).

Copyright 2013 - Bizagi

1963

4. Seleccione el Servidor de Base de datos Bizagi presentar las instancias de Base de datos que encuentre instaladas en el servidor. Seleccione o digite directamente el nombre del Servidor de Base de datos y la instancia de Base de datos a usarse para el ambiente. Para el ambiente de pruebas, por defecto se nombra la Base de datos como "[miProyecto]" pero es posible editar este nombre.

1964

Copyright 2013 - Bizagi

Ingrese la cuenta y contrasea para la Base de datos y de clic en Sig u ien te.

5. Configure las opciones avanzadas. Revise las opciones avanzadas de acuerdo a si desea incluir esas posibilidades:

Incluir usuarios en el ambiente destino: Puede optar por trasladar los usuarios que se crearon en el ambiente de desarrollo hacia el ambiente de produccin. Incluir registros de entidades de Parametrizacin administradas en produccin: Puede optar por incluir los valores (registros) de aquellas entidades de Parametrizacin que fueron definidas como administrables nicamente en produccin. Nota Cuando no se incluyen los usuarios de desarrollo hacia produccin (se deja sin marcar la opcin In clu ir u su ario s en el am b ien te d estin o ), Bizagi igualmente crear el usuario por defecto (slamente crear este usuario) en el ambiente de produccin (el cual es domain\admon). Siendo as, tenga en cuenta que el usuario domain\admon debe tener los permisos necesarios para crear ms usuarios. 6. Confirme la configuracin del Deployment. En la ventana de resmen y confirmacin, se vern los Procesos que se seleccionaron para el

Copyright 2013 - Bizagi

1965

Deployment, al igual que la configuracin relacionada al ambiente de produccin (Servidor BPM y de Base de datos).

Ntese que esta informacin es solo para confirmar que la configuracin es la esperada; ya que en este punto no se pueden realizar cambios sobre el Release Candidate que se aprob en el ambiente de pruebas (no ser posible adicionar Procesos ni relacionar ms objetos). Para iniciar el Deployment, de clic en F in alizar. Bizagi notificar que debe cerrar otras ventanas de Bizagi Studio o Management Console que pueda tener abiertas con el mismo proyecto.

1966

Copyright 2013 - Bizagi

7. Finalice el Deployment. El Deployment en un clic de Bizagi ejecutar las validaciones y el Deployment. Dado que es el primer Deployment, Bizagi crear el ambiente y sus componentes de manera automtica.

Bizagi notifica cuando se complete el Deployment satisfactoriamente. Haga clic en Cerrar.

Copyright 2013 - Bizagi

1967

Al finalizar el Deployment, los Procesos en el ambiente de produccin podrn ejecutarse inmediatamente. Para iniciar el Portal de Trabajo del ambiente de produccin, puede usar la opcin Ejecu tar desde el asistente de Procesos, en la cual se podr observar su URL. Haga clic en el cono o etiqueta del mismo para iniciar el Portal de Trabajo:

1968

Copyright 2013 - Bizagi

Deployments posteriores a produccin

El concepto de un Deployment posterior aplica a aquellos Deployments que se realicen despus del primer Deployment. Las opciones de los Deployments posteriores varan ligeramente con respecto a las presentadas en un primer Deployment. En estos Deployments posteriores, Bizagi ubicar el ambiente existente para actualizar lleva la informacin de los Procesos y no se crear un nuevo proyecto. Las diferencias principales en Deployments posteriores involucran: 1. Bizagi crea backups de la Base de datos de produccin antes de iniciar el Deployment. El backup automtico de la Base de datos se almacena segn el escenario: Cuando se utiliza SQL Server de manera local (el Servidor de Base de datos es el mismo Servidor BPM), entonces la ruta es "C:\Bizagi\[edicion_Bizagi]\Projects\[su_proyecto]\Backups\". Cuando se utiliza SQL Server en un Servidor remoto, la ruta es la de los backups de la instancia (por defecto "C:\Program Files (x86)\Microsoft SQL Server\[instancia_MSSQL]\MSSQL\Backup\"). Cuando se utiliza Oracle, esta ruta es la predefinida para la instancia; tal como se configura en el momento de crear el proyecto en Oracle. 2. Bizagi no presenta opciones de reconfiguracin de la infraestructura del ambiente (Servidor BPm o Servidor de Base de dato). Tenga presente que si requiere migrar su ambiente de produccin (moverlo a un Servidor diferente), entonces esto debe hacerse previamente con las opciones de Administracin de servidores.

Copyright 2013 - Bizagi

1969

Solo cuando el Deployment de Bizagi no logre ubicar la Base de datos de produccin (dado que se haya movido a otro servidor manualmente), se pedir que se reconfigure dicha informacin (se debe especificar cul es la nueva ubicacin de la Base de datos).

Nota Al reconfigurar la ubicacin de la Base de datos de produccin en caso de que haya sido migrada, recuerde que es estrictamente requerido que se configure la ubicacin acertada de la Base de datos de produccin. Bizagi valida que realmente corresponda al estado y al ambiente correcto. 3. Bizagi no presenta opciones para una carga inicial de datos en el ambiente de produccin. Las opciones para incluir los usuarios o los registros de las entidades de Parametrizacin administrables en produccin no estn disponibles dado que el ambiente de produccin ya tiene sus propios datos. 4. Los casos existentes del ambiente de produccin se mantienen de manera consistente en cuento a la versin del Proceso. Esto quiere decir que los casos (instancias de Procesos) seguirn trabajndose bajo la versin de Proceso en la cual fueron creados. 5. Tenga presente el manejo de Bizagi para los objetos que ya estn en produccin y su tratamiento; al igual que cmo se deben manejar las nuevas versiones de Proceso, segn lo descrito en Mejoramiento continuo. 4.2.3.1 Mejoramiento continuo

Introduccin
Como parte de la mejora continua en los Procesos, Bizagi ofrece la posibilidad de realizar ajustes sobre los Procesos que les permitan su evolucin a medida que el mismo negocio evoluciona. A menudo, estos ajustes involucran cambios a los datos y reglas del negocio, las interfaces predefinidas o incluso el mismo flujo del Proceso. Dependiendo de los cambios requeridos, se recomienda generar una nueva versin del Proceso que ya se encuentra ejecutndose en produccin. Esto obedece a una manera segura de implementar cambios sin comprometer la informacin de los casos existentes (instancias de Proceso) en el ambiente de produccin. Por otro lado, en escenarios donde se requieren solamente cambios menores a los Procesos existentes, tambin es posible optar por que los casos existentes tomen ese ajuste en produccin.

1970

Copyright 2013 - Bizagi

Este artculo ilustra a manera de gua, cundo deben crearse nuevas versiones de Proceso y cundo se pueden manejar los cambios menores dentro de las versiones de Proceso ya existentes.

Mejora continua
Antes que nada, recuerde que cualquier cambio estructural que se desee hacer a un Proceso en produccin, debe hacerse en el ambiente de desarrollo y actualizarse por medio del Deployment.

Tipos de cambios estructurales son: nuevas transiciones y Actividades en el flujo, nuevas formas o cambios en ellas, ajustes en las reglas de negocio, nuevas asignaciones a participantes o definiciones de integracin, entre otras.

Tales cambios estructurales no incluyen las tareas administrativas, las cuales si se pueden llevar a cabo directamente sobre el Portal de Trabajo en produccin. Tales tareas son por ejemplo: editar polticas del negocio, la administracin de usuarios y sus configuraciones de autorizacin, o la administracin de la configuracin del Servidor SMTP o de sistemas externos como ECMs, entre otras. Tenga en cuenta que de igual manera se debe seguir el ciclo recomendado del Deployment, donde se utiliza primero el ambiente de pruebas para verificar que los Procesos se comportan adecuadamente y estn listos para ser llevados a produccin.

desarrollos despus de un Deployment

Para Deployments posteriores al primer Deployment a Produccipon, y para realizar cambios enfocados en el mejoramiento de Procesos que se encuentran operativos, tenga en cuenta las siguientes recomendaciones:

1. Los objetos en produccin deben conservarse siempre

Una vez que un Proceso haya sido llevado al ambiente de produccin (aplica tambin cuando un Proceso est marcado como Release Candidate en pruebas), no es posible eliminar en el ambiente de desarrollo cualquier objeto que sea utilizado por este Proceso.

Copyright 2013 - Bizagi

1971

Entre tales objetos, se consideran: entidades, atributos y relaciones, formas, reglas de negocio y definicin de participantes (reglas de asignacin), definicin de sistemas y de elementos de la organizacin. De manera similar, no es posible modificar el nombre de estos objetos en produccin (la propiedad N o m b re). Esto es una restriccin para garantizar la estabilidad del ambiente de produccin en Deployments posteriores.

2. Versionamiento de Procesos
Una vez que un Proceso haya sido llevado al ambiente de produccin (aplica tambin cuando un Proceso est marcado como Release Candidate en pruebas), no es posible editar su flujo. Dicho Proceso queda bloqueado en desarrollo, de manera que si se requiere un cambio en el flujo (una nueva tarea, una nueva transicin, etc), se requiere crear una nueva versin de ese Proceso. Esto significa que a partir del primer Deployment de un Proceso, no se puede utilizar el Paso 1 del Asistente de Proceso (para la adicin o edicin de elementos BPMN en el flujo) para la versin del Proceso que est en produccin. Para ello, se debe crear una nueva versin del Proceso y de los Sub Procesos que utilice.

1972

Copyright 2013 - Bizagi

Por otro lado, los siguientes cambios no requieren que se cree una nueva versin del Proceso: Adicionar un nuevo atributo o entidad. Adicionar o editar una regla de negocio (sea como accin de Actividad, regla de asignacin, o para la invocacin de servicios Web o REST). Crear una nueva forma de consulta a nivel de aplicacin o entidad. En otras palabras, no se requiere una nueva versin del Proceso si se van a hacer cambios que se realizan desde el paso 2 en adelante del Asistente de Proceso. Ms informacin sobre este tema se detalla en la siguiente seccin. Nota Los cambios que se hagan sobre la versin de Proceso actual (sin crear una nueva), aplicaran directamente sobre los casos existentes del ambiente de produccin. Por lo tanto, en este escenario es muy importante tener en cuenta las medidas, pruebas y consideraciones necesarias que garanticen que no se presenten problemas de consistencia en los casos nuevos y existentes.

Copyright 2013 - Bizagi

1973

Para ms informacin sobre las recomendaciones en este aspecto, consulte la gua para nueva versin de Proceso.

3. Posibilidades de edicin de los objetos en produccin

Una vez que un Proceso haya sido llevado al ambiente de produccin (aplica tambin cuando un Proceso est marcado como Release Candidate en pruebas), Bizagi Studio controlar en el ambiente de desarrollo, las posibilidades para editar los objetos usados por ese Proceso. Esto es una restriccin para garantizar la estabilidad del ambiente de produccin en Deployments posteriores. Por lo tanto, para un Proceso que est en produccin, es recomendado crear una nueva versin de Proceso para realizar cambios que no sean ajustes menores. Ajustes menores se pueden realizar a la versin actual del Proceso si involucran cambios puntuales sobre ciertos objetos que se usan por esos Procesos, como se detalla en la siguiente tabla:

Objeto Entidades y atributos

Opciones No ser posible editar las siguientes propiedades de lsa entidades y atributos (incluye relaciones) : nombre, tipo o fuente. Solo se puede editar su nombre para mostrar. No ser posible editar las formas (adicionar, modificar o eliminar controles, o sus expresiones, validaciones o acciones asociadas). Sin embargo, las formas pueden clonarse o versionarse de por si, de manera que se puede cambiar la forma que se usa en cierta Actividad. Su cdigo podr ser editado (junto con otras propiedades como el nombre de mostrar o su descripcin). Al hacerlo, se debe tener cuidado en no alterar el buen funcionamiento de los casos existentes. Su cdigo podr ser editado (junto con su descripcin). Su cdigo podr ser editado (junto con su descripcin). Todas sus propiedades y condiciones podrn ser editadas. Esto implica las definiciones del criterio y reglas de asignacin. Solo el nombre de mostrar podr ser editado para los elementos de la organizacin previamente definidos (reas, Roles, habilidades, grupos de usuario).

Formas

Expresiones (booleanas y de tipo scripting)

Funciones personalizadas

Widgets de Bizagi

Definicin de participantes (reglas de asignacin)

Definicin de la organizacin

1974

Copyright 2013 - Bizagi

Esquemas de festivos (en el esquema de horario de trabajo) Seguridad

Solo la descripcin del esquema de dias no laborales podr ser editado. Cambios en la configuracin de Autenticacin y LDAP, debern hacerse directamente en el ambiente de produccin con el Management Console. Los cambios realizados en el ambiente de desarrollo para la configuracin de autorizaciones sern siempre actualizados por el Deployment hacia produccin. Nuevos mensajes (cuando se utiliza la posibilidad de mltiples correos) se pueden incluir en la configuracin de notificaciones. Los mensajes existentes no se podrn eliminar. Dentro de la definicin del mensaje, su asunto, destinatario ("Para", "CC", y "BCC"), y contenido del cuerpo, podrn ser editado. Las condiciones de envo de los correos podrn ser editadas tambin pero no eliminadas. Su contenido podr ser editado. La configuracin de la invocacin a un servicio Web o REST puede cambiarse tal como lo permite el asistente de interfaces en Bizagi. Los ajustes de parmetros (por ejemplo, de conexin, y dems que no requieran un nuevo mapeo de datos), podrn realizarse directamente sobre produccin con el Management Console. Todas sus propiedades podrn ser editadas (excepto el nombre). Ser posible cambiar el archivo o ensamblado asociado al componente.

Notificaciones por correo (e-mails)

Cartas Invocaciones de interfaces

Dimensiones

Componentes en la Librera de componentes

Trabajos personalizados

Se podrn adicionar nuevos P aso s y P ro g ram acio n es a los trabajos personalizados.

Cualquier otro cambio que no se encuentre listado en la tabla anterior, requerir crear una nueva versin de Proceso que utilice otro objeto diferente al que ya exista en produccin.

4. Nuevas llaves de negocio

Cuando se definen nuevas llaves de negocio, se recomienda revisar que los datos en produccin son compatibles con las nuevas caractersticas o restricciones (constraints).

Copyright 2013 - Bizagi

1975

De lo contrario, si se aplican llaves de negocio en desarrollo que no se dan con los datos en produccin, se tendr un error de integridad advertido por Bizagi durante el Deployment. Para ilustrar lo anterior, supongamos que se tiene una entidad llamada Producto, la cual ya fue llevada al ambiente de produccin sin definicin de llaves de negocio. Entonces, no se debe redefinir posteriorment en la entidad Producto que su llave de negocio es el atributo N o m b reP ro d u cto si se detecta: que hay ms de un registro en produccin con N o m b reP ro d u cto =Crdito (ms de un producto con el mismo nombre).. Para ms informacin sobre estas definiciones, consulte predefiniendo llaves de negocio.

5. Las configuraciones previas deben permanecer compatibles

No se deben alterar las configuraciones que ya se tenan anteriormente a nivel de infraestructura. Esto significa que las caracteristicas de los prerequisitos tcnicos del Deployment no deben cambiarse. Lo anterior incluye no cambiar la intercalacin de la instancia de Base de datos (si es SQL Server), o de manera similar no cambiar la configuracin del set de caracteres en una instancia de Oracle. Si requiere cambiar su Servidor de produccin, asegrese de utilizar las opciones del Management Console.
4.2.3.1.1 Gua para nueva versin de Proceso

Introduccin
La administracin de versiones de Proceso en Bizagi, ofrecen la flexibilidad de implementar mejoras a los Procesos. Estas mejoras que son producto del anlisis de indicadores o debido a la evolucin de los Procesos (por polticas de mejoramiento continuo), se incluyen gilmente en nuevas versiones de Procesos en Bizagi. Es recomendado que se evalen previamente las mejoras requeridas, para determinar si los ajustes deben realizarse o no sobre una nueva versin de Proceso. Esto se debe a que a menudo se pueden detectar ajustes muy puntuales que no necesariamente requieren una nueva versin, en cuyo caso, se debe de igual manera analizar que estos cambios sean compatibles con los casos existentes.

Cundo crear una nueva versin?

Tenga presente que Bizagi maneja mltiples versiones de Procesos: los casos (instancias de Proceso) que se estn ejecutando en el momento en que una nueva versin de Proceso se publique a produccin, seguirn ejecutndose sobre esa versin en la cual fueron creados. Solamente los casos nuevos sern creados siempre en la ltima versin del Proceso. La siguiente tabla ilustra escenarios comunes de ajustes a Procesos en produccin.

Escenario

Se requiere nueva versin

No se requiere nueva versin

1976

Copyright 2013 - Bizagi

Se debe hacer cualquier tipo de cambio en el modelo del Proceso (el flujo). Esto incluye: agregar o quitar elementos BPMN (por ejemplo eventos o tareas), cambiar el nombre de los mismos, la duracin esperada, y otras propiedades como sus notificaciones automticas. Se deben incluir nuevas transiciones en el Proceso (por ejemplo, flujos nuevos despus de una compuerta exclusiva, paralela o inclusiva). Se deben configurar Sub Procesos. Se debe crear una nueva entidad, atributo o relacin. Se debe crear una forma de consulta o editar una existente. Se debe editar una regla de negocio (accin de Actividad a la entrada, salida o al guardar) con un cambio que utiliza un atributo nuevo (afecta los casos abiertos). Se debe editar una regla de negocio (accin de Actividad a la entrada, salida o al guardar) con cambios que no afecten los casos abiertos. Se debe editar una regla de asignacin (redefinicin de participantes de las tareas)

X X X X

Recomendaciones
Antes de crear una nueva versin de Proceso, tenga en cuenta: 1. Los criterios anteriormente mencionados, y la posibilidad de editar los objetos en produccin. Para ms informacin sobre la posibilidad de edicin de objetos en produccin, consulte el Mejoramiento continuo. 2. Bizagi ofrece tambin la posibilidad de clonar Procesos basado en uno existente de la misma Aplicacin de Proceso. Esto significa que si realmente es una mejora a un Proceso en produccin, puede optar por crear una nueva versin, pero tambin puede darse el caso de querer crear un nuevo Proceso a partir de otro muy similar (a travs de la clonacin de Procesos). 3. Tenga presente que antes de crear una versin, es recomendado tomar un backup de la Base de datos.

Crear una nueva versin de Proceso

Para crear una nueva versin, siga estos pasos: 1. Vaya a la vista de Mdulos y ubquese en el mdulo de Procesos. De clic derecho sobre la versin del Proceso que quiere versionar y seleccione la opcin de N u ev a v ersi n .

Copyright 2013 - Bizagi

1977

2. Seleccione en la ventana emergente, la versin de Proceso exacta y los Sub Procesos que pueda tener asociados.

3. Revise las opciones avanzadas (a travs del botn) para optar por incluir tambin versiones nuevas de los Sub Procesos que utiliza ese Proceso.

1978

Copyright 2013 - Bizagi

4. De clic en N u ev a v ersi n . Clic en O K ante el mensaje de confirmacin de Bizagi.

Este procedimiento puede tardar unos minutos.

Tan pronto como se termine el procedimiento, Bizagi notificar el xito. De presentarse algn error, aparecer un log con el detalle sobre lo que debe ajustarse en la versin del Proceso actual (y repetir el procedimiento una vez que se solucione el problema).

Copyright 2013 - Bizagi

1979

A partir de la terminacin exitosa y creacin de la nueva versin, Bizagi tomar el cambio automticamente sobre la nueva versin activa, de manera que a travs del asistente de Proceso se edita directamente la nueva versin.

4.3

Movilidad
Bizagi adopta la revolucin mvil y lleva a la automatizacin de procesos de negocio al siguiente nivel. Bizagi entiende que cada vez ms empleados tienen sus dispositivos mviles en sus sitios de trabajo y las empresas deben apoyar estos ser capaces de soportar estos dispositivos para mantener a sus empleados conectados a los procesos organizacionales. Bizagi ofrece compatibilidad con todas las plataformas, garantizando una gran experiencia de usuario: con su dedo, un ratn o un bolgrafo todos los procesos se ejecutan en la forma que se espera que funcionen. Su compaa puede crear procesos y los empleados acceden a la informacin en cualquier momento en cualquier lugar. Para usar las aplicaciones mviles de Bizagi, es necesario tener un proyecto ejecutndose en un servidor. Desde el dispositivo se puede conectar a ste y seguir trabajando como si estuviera en tu computadora desde la oficina. IMPORTANTE: Para acceder a un proyecto desde un dispositivo mvil, el proyecto debe estar publicado en Internet. Tambin es posible acceder estando conectado a la misma red (el dispositivo conectado a la misma red que el servidor del proyecto) o puede tener una conexin VPN en su dispositivo.

1980

Copyright 2013 - Bizagi

Obtenga la aplicacin Bizagi

1. Para los dispositivos IOS vaya a la tienda de aplicaciones y busque B izag i. La aplicacin es gratuita para descargar. Para dispositivos Android vaya a http://play.google.com y busque B izag i. La aplicacin es gratuita para descargar (aplica para versiones .Net).

Copyright 2013 - Bizagi

1981

Una vez descargada configure lo siguiente: URL para acceder a la aplicacin Bizagi Usuario: nombre de usuario configurado en el Portal de Trabajo Contrasea: contrasea del usuario. Domain: usuario de dominio

1982

Copyright 2013 - Bizagi

Tenga en cuenta que las cuatro propiedades necesarias se pueden obtener en el Portal de Trabajo:

Copyright 2013 - Bizagi

1983

Reinicie la aplicacin Bizagi. Ahora tendr acceso a su Inbox y podr permanecer conectado con su trabajo. iPhone:

1984

Copyright 2013 - Bizagi

Telfono Android

Copyright 2013 - Bizagi

1985

iPad:

1986

Copyright 2013 - Bizagi

Tableta Android:

Copyright 2013 - Bizagi

1987

4.4

Integracin de Portales
Hay empresas que tienen la mayora de las aplicaciones disponibles en un Portal Web. Usted puede integrar sus procesos de Bizagi en su portal corporativo, mediante el uso de la funcionalidad de Capa SOA de Bizagi. Para ms informacin acerca de esta posibilidad, consulte el ejemplo mostrado en el artculo Sharepoint. Para ver un how-to enfocado en el inicio de procesos desde Joomla!, vaya a Cmo integrar Bizagi con Joomla.

4.4.1

Sharepoint

Informacin general
Hay empresas que tienen la mayora de sus aplicaciones disponibles en un Portal Web (Sharepoint).

1988

Copyright 2013 - Bizagi

La integracin entre los portales y Bizagi es posible gracias a la Capa SOA de BizAgi y a WebParts de Sharepoint. El siguiente ejemplo muestra cmo incluir botones en Sharepoint para: Iniciar procesos en Bizagi (crear casos) e incluir el listado de pendientes (Inbox) directamente en Sharepoint.

Para esta integracin, lo ms fcil es usar un Page Viewer Web Part, que requiere bsicamente la creacin de pginas Web y, a continuacin incluir su URL.

Lo que hay que hacer en Bizagi

Copyright 2013 - Bizagi 1989

En este ejemplo, se utiliza Visual Studio C # para crear las pginas Web y IIS como servidor Web. Con el fin de configurar la integracin con Sharepoint (como Portal), es posible utilizar este proyecto disponible de Visual Studio. En resumen, los pasos necesarios para llevar a cabo esta integracin son: 1. Descargar e instalar el proyecto de ejemplo. 2. Editar de la configuracin bsica de este proyecto. 3. Configurar los Web Parts en Sharepoint.

Descargar e instalar el proyecto de ejemplo

Descargue el proyecto de ejemplo de Visual Studio (archivo comprimido que contiene las pginas que se muestran en las imgenes anteriores). Guarde y extraiga el archivo y cree un directorio virtual nuevo en el Sitio Web por Defecto de su IIS.

Editing the basic settings

Una vez que el directorio virtual es creado, modifique su seguridad a Autenticacin Integrada de Windows.

1990

Copyright 2013 - Bizagi

Abra el archivo Web.config y haga los siguientes cambios necesarios: En el valor de la llave o p en CaseUrl reemplace SERVER_N A M E con el nombre o la direccin IP del servidor en donde esta su proyecto Bizagi En el valor de la llave o p en CaseUrl reemplace P RO JECT_N A M E con el nombre del proyecto Bizagi. Note que el valor de la llave refresh F req est dado en segundos y es el tiempo que pasara antes que la pgina de Casos Pendientes sea refrescada.

Proceed to make the same type of changes mentioned previously (as with o p en CaseUrl), for the value of the setting W eb B izP ro ject_w fSO A _B P M P ro ject_W o rkflo w En g in eSO A .

Copyright 2013 - Bizagi

1991

Configurar Web Parts en Sharepoint

Ahora edite el sitio SharePoint y agregue dos P ag e View Web Parts.

Configure un Web Part seleccionando para que despliegue una Pgina Web (Web Page) e ingrese la URL de la pgina de los Casos Pendientes: h ttp ://SERVER_N A M E/VIRTUA L_DIRECTO RY _N A M E/P en d in g Cases.asp x

1992

Copyright 2013 - Bizagi

En el otro Web Part tambin seleccione para desplegar una Pgina Web (Web Page) pero ingrese la URL de la pgina Crear Casos: h ttp ://SERVER_N A M E/VIRTUA L_DIRECTO RY _N A M E/CreateCases.asp x

En este punto, estamos listos con la integracin de Bizagi con Sharepoint, para que los usuarios finales puedan iniciar procesos Bizagi y tengan su bandeja de entrada directamente en Sharepoint.

4.4.2

Joomla!

Informacin general
En este artculo se describe cmo crear un caso en Bizagi desde Joomla!. Con el ejemplo Joomla! se puede extender con una potente solucin de BPM como Bizagi. Esta integracin se centra en Joomla! como punto de entrada de las solicitudes de sus clientes (un gestor de contenidos utilizado como Portal), y Bizagi como la aplicacin web interna de la implementacin de BPM. El siguiente diagrama representa la arquitectura considerada por la integracin en este ejemplo.

Copyright 2013 - Bizagi

1993

1 Los clientes acceden a su sitio web y envan una solicitud de contacto a travs de Joomla! 2 La informacin de contacto es enviada a travs de la capa SOA de Bizagi. 3 Un nuevo caso es creado en su proyecto Bizagi para darle continuidad al proceso BPM.

Pre-requisitos
Para este ejemplo necesita Joomla! 1.5 o superior instalado. Joomla! puede ser descargado desde su pgina oficial.

Lo que debe hacer en Bizagi

Para llevar a cabo esta integracin se consideran los siguientes pasos: 1. El uso de componentes en Joomla! para la forma de contacto. 2. Tener el proceso de Bizagi para gestionar las peticiones de contacto. 3. El uso de una aplicacin web para la invocacin de servicios Web.

Ejemplo
El ejemplo se muestra y describe En primer lugar, la publicacin de un "Contctenos" en el sitio Web de su empresa para capturar la informacin inicial.

1994

Copyright 2013 - Bizagi

Luego, esta informacin se enva a travs de servicios Web a Bizagi para que se delegue en sus procesos (creando un caso para la peticin de contacto). Para enviar esta informacin a travs de los servicios Web, es necesario incluir el desarrollo de una invocacin de servicio Web. Para simplificar la integracin y el ejemplo, la invocacin de los servicios Web publicados por Bizagi no se llevar a cabo a travs de PHP directamente, sino a travs de un componente en una aplicacin .NET.

1. Usando componentes en Joomla! para la forma de Contctenos

Con el fin de llevar a cabo este ejemplo para Joomla!, se requiere la creacin de los siguientes archivos (y estructura de carpetas) como se muestra a continuacin: site/contactus.php - este es el punto de entrada de nuestro componente. site/controller.php - este archivo contiene el controlador base. site/views/contactus/view.html.php - este archivo obtiene cierta informacin y la utiliza en la plantilla (template). site/views/contactus/tmpl/default.php - esta es la plantilla para nuestra pgina HTML que contiene el formulario "contctenos". site/models/contactus.php - este archivo es creado para seguir el patrn MVC. contactus.xml - este archivo XML describe los archivos del componente ("manifest") que permiten la instalacin en Joomla! del componente.

Estos archivos y estructura de carpetas fueron nombrados de acuerdo al estndar definido de [de nomenclatura], y nuestro componente se llama "contactus" (contctenos en ingls). En Joomla!, ser instalado como "com_contactus". El archivo Defau lt.p h p es como se muestra a continuacin:

Copyright 2013 - Bizagi

1995

1996

Copyright 2013 - Bizagi

Ntese que el valor de "action" (parmetro HTML) en la forma, hace referencia a la ubicacin HTTP en el que encontraremos el componente .Net. La instalacin de este componente ser detallada ms adelante en lo instrudo en "Usando una aplicacin web (en .Net) para la invocacin de los servicios web". Descargue el componente en Joomla! listo para su instalacin aqu.

2.Creando el proceso BPM en Bizagi para manejar la solicitud de contacto

Ya que tenemos el punto de entrada para estas peticiones de contacto como una pgina web en Joomla!, es necesario tener ahora un proceso de Bizagi para recibir la informacin de estas peticiones, y darle continuidad al proceso bajo el enfoque de BPM (por ejemplo: revisar la solicitud, enviar un correo a esa persona, etc,). Para este ejemplo, se describe un simple proceso de "Contacto" creado en Bizagi con las siguientes caractersticas: 1. El proceso se denomina Co n tactUsReq u est, y el modelo de datos para este proceso tiene como Entidad de Proceso una entidad llamada Co n tactUsReq u est. 2. La entidad ContactUsRequest tiene principalmente estos atributos: - ContactName (tipo texto) - EmailAddress (tipo texto) - Message (tipo texto) - TelephoneNumber (tipo texto)

Copyright 2013 - Bizagi

1997

Ntese que es necesario especificar una longitud para los atributos de tipo texto (para los 4). Asegrese de que sean lo suficientemente largos para soportar la informacin entrante desde el formulario en Joomla!. Los valores sugeridos son: ContactName Longitud: 50 EmailAddress Longitud: 50 Message Longitud: 4000 TelephoneNumber Longitud: 20 3. La construccin de la forma de la primera actividad en el proceso Bizagi debe inclur los 4 atributos mencionados anteriormente. En la forma de esta primera actividad en Bizagi se podr ver la informacin enviada desde Joomla! de manera no-editable. En resumen, los atributos: Co n tactN am e, Em ailA d d ress, M essag e y Telep h o n eN u m b er se incluyen con la propiedad de Editable en falso.

1998

Copyright 2013 - Bizagi

3. Usando una aplicacin web para la invocacin de los servicios web

Con el fin de crear casos en Bizagi con la informacin ingresada externamente, es necesario que una aplicacin Web invoque los servicios web de Bizagi. Para ello, en este ejemplo vamos a ilustrar el desarrollo de una aplicacin Web en una solucin. NET. Esta aplicacin web se encargar de enviar la informacin al invocar el mtodo web createCases en la Capa SOA de Bizagi (para iniciar una instancia de proceso. Recuerde sin embargo, que Bizagi ofrece a travs de su capa SOA muchos ms mtodos disponibles para la integracin con otros sistemas. Estos otros mtodos pueden ser utilizados en Joomla! bajo este escenario tambin (por ejemplo, para actualizar o consultar la informacin de un caso ya existente). Para ms informacin refirase a Invocar servicios Bizagi desde aplicaciones externas. Puesto que este ejemplo se trabaj con Microsoft Visual Studio 2008, la solucin de la aplicacin web creada se referenciar a partir de ahora como el Co n tactUsA p p licatio n , y se instruyen su paso a paso a continuacin.

1. Cree un nuevo proyecto en Visual Studio y seleccione A SP . N ET W eb A p p licatio n para este tipo de proyecto.

Copyright 2013 - Bizagi

1999

Para la aplicacin Co n tactUsA p p licatio n , se requiere una referencia web (web reference) en el proyecto visual studio de la manera: h ttp ://[su _serv id o r_B izag i]/[su _p ro y ecto _B izag i]/w eb serv ices/w o rkflo w en g in eso a.asm x 2. Cree entonces la referencia web correspondiente a los servicios web publicados por su proyecto Bizagi.

2000

Copyright 2013 - Bizagi

Note

Copyright 2013 - Bizagi

2001

Recuerde que lo indicado es un ejemplo y que para seguir prcticas seguras y recomendadas, el acceso a estos servicios web debe estar restringido y controlado en su servidor IIS de acuerdo a sus polticas de seguridad. Dado que la informacin proveniente desde Joomla! se enva desde un formulario, estos datos pasarn a la Co n tactUsA p p licatio n bajo el mtodo get de HTML. Por lo tanto, se requiere la recuperacin de estos parmetros en el Defau lt.asp x .cs, en su mtodo "Page_Load". El archivo Defau lt.asp x .cs debe quedar como se muestra a continuacin:

La invocacin del servicio web se realiza en una clase diferente, llamada W SCo n tro ller.cs. Para crear la clase W SCo n tro ller, se debe agregar un nuevo elemento (add New Item) al proyecto tal como se muestra:

2002

Copyright 2013 - Bizagi

Copyright 2013 - Bizagi

2003

El archivo W SCo n tro ller.cs debe quedar como se muestra a continuacin:

2004

Copyright 2013 - Bizagi

Descargue el proyecto completo en Visual Studio aqu.

Finalmente, monte estos archivos en su servidor IIS como una aplicacin para que pueda ser accesada

Copyright 2013 - Bizagi

2005

desde el enlace (como h ttp ://[y o u r_B izag i_serv er]/[y o u r_iis_ap p licatio n ]/Defau lt.asp x ). Para hacerlo, copie primero la carpeta del proyecto en Visual Studio en la carpeta C: \in etp u b \w w w ro o t\ de su servidor IIS. Seguidamente, abra el administrador de IIS desde el comando Ejecutar como se muestra a continuacin:

De clic derecho sobre la carpeta copiada y seleccione la opcin convertir en aplicacin.

Ntese que la URL de ubicacin donde queda este componente debe corresponder a lo definido en el archivo Default.php, en el "action" de la forma.

2006

Copyright 2013 - Bizagi

En este punto, hemos finalizado el cmo, y estamos listos para que los clientes puedan acceder la forma de "Contctenos" a travs de Joomla! y hacia su proceso Bizagi. Para probar y acceder al formulario, asegrese de que su servidor Apache (conteniendo Joomla!) est iniciado y digite en un explorador:

h ttp :[su _serv id o r]:[p u erto _ap ach e]/Jo o m la_1.5.22-Stab le-F u ll_P ackag e/in d ex .p h p ? o p tio n = co m _co n tactu s

Ejecucin
Para ver este ejemplo, lo primero que complete la informacin inicial en el formulario de contacto directamente en Joomla! (acceda a nuestro formulario de contacto mencionado anteriormente). Luego ejecute nuestro Proceso en Portal de Trabajo haciendo clic en la opcin Ejecu tar:

Podemos ver la actividad pendiente en Bizagi, creada con Joomla!

Copyright 2013 - Bizagi

2007

2008

Copyright 2013 - Bizagi

Parte V
Anlisis del Proceso

Anlisis del Proceso

Bizagi ofrece un amplio conjunto de indicadores de desempeo para el anlisis histrico y en tiempo real. A lo largo de las observaciones y conclusiones obtenidas a partir de ellos, se da la posibilidad identificar mejoras a los procesos. Bizagi ofrece un completo conjunto de reportes para monitorear la operacin de su negocio en tiempo real. Le mostrar qu tareas o procesos estn a tiempo, expiradas o en riesgo, lo que permite prever o identificar problemas, reasignar trabajo y la gestionar el riesgo con el fin de cumplir con sus objetivos de rendimiento. El trmino "riesgo" se refiere a los casos en que expiran el da de hoy. Bizagi tambin ofrece un conjunto de informes que le permite analizar la informacin histrica de rendimiento. Estos le indicadores permiten obtener una visin general de la operacin: los cuellos de botella, el rendimiento de los recursos, niveles de servicio y las tendencias. Esta informacin es la base para la bsqueda de oportunidades para mejorar el rendimiento de su proceso Puede ver los detalles de cualquier caso dentro de los informes para ver la ruta que han seguido, los usuarios que han participado en l, entre otras cosas. Los reportes Bizagi se acceden desde el men Rep o rtes del Portal de Trabajo.

Los reportes se clasifican en: BAM: B u sin ess A ctiv ity M o n ito rin g o B A M proporciona informacin grfica sobre el estado de los casos pendientes y tareas, clasificadas por Procesos. Anlisis: proporciona informacin grfica sobre el rendimiento de los procesos basados en casos cerrados. Sensores: Permite extraer informacin de los sensores definidos por el usuario sobre los procesos. Estos sensores se dividen en co n tad o res y cro n m etro s. Mis reportes: Permite acceder a sus informes guardados previamente. (por usuario).

2010

Copyright 2013 - Bizagi

5.1

BAM
B u sin ess A ctiv ity M o n ito rin g es una herramienta de anlisis que le permite ver informacin grficamente sobre el estado de los casos en curso.
IMPORTANTE: Esta funcin se activa cuando la duracin de tareas y procesos se ha configurado. De esta manera Bizagi puede establecer una comparacin entre los tiempos de ejecucin esperados y reales. BAM se divide en tres informes: BAM de Proceso : permite analizar el estado actual de todos los procesos en curso. BAM de Tareas: permite analizar el estado actual de las tareas en curso. Monitor de Reursos: permite analizar la carga de trabajo actual y el rendimiento de los usuarios finales y los equipos de trabajo.

BAM de Procesos
Este reporte permite analizar el estado actual de todos los procesos en curso. Puede realizar dos tipos de anlisis: Anlisis de Carga: Esta grfica muestra un histograma con el nmero de casos en curso que estn a tiempo, en riesgo y vencidos, para cada proceso. La grfica se presenta en colores para identificar cada estado del proceso. La informacin utilizada para mostrar los grficos se obtiene de la ltima versin del proceso.

Trabajo en progresa: Un grfico circular muestra el porcentaje de casos que estn a tiempo, en riesgo y vencidos. El grfico de barras de la derecha muestra la fecha en la que los casos abiertos se vencern. El eje horizontal representa los siguientes diez das y el vertical muestra el nmero de casos que expiran cada da. Los casos pueden ser filtrados por proceso o cualquiera de las Dimensiones definidas.

Copyright 2013 - Bizagi

2011

BAM de Tareas
Este reporte le permite analizar el estado actual de las tareas en curso. Puede realizar dos tipos de anlisis: Anlisis de Carga:. Cada tarea manual tiene un grfico de barras pequeo en la esquina inferior izquierda. Esta grfica muestra el nmero de casos que estn a tiempo, en riesgo y vencidos. Al hacer clic sobre una tarea, se muestra una nueva ventana con un resumen. Cuando no hay casos pendientes para una tarea determinada, no hay grfico de barras.

2012

Copyright 2013 - Bizagi

En la parte inferior del diagrama hay una lista, oculto por defecto, que muestra todas las tareas, indicando para cada una el nmero de casos a tiempo, en riesgo y vencidos. Haga clic en cualquier tarea del diagrama. Las columnas se pueden reordenar arrastrndolas.

Trabajo en progreso: Un grfico circular muestra el porcentaje de tareas para un proceso que estn a tiempo, en riesgo y vencidas. Los casos pueden ser filtrados por proceso o cualquiera de las Dimensiones definidas. Un grfico de barras a la derecha muestra las tareas abiertas y cuando se vencern. El eje horizontal representa los siguientes diez das y el vertical muestra el nmero de

Copyright 2013 - Bizagi

2013

casos que se vencen cada da.

Resources Monitor
Este informe permite analizar la carga de trabajo actual y el rendimiento de los usuarios finales y los equipos de trabajo. Puede realizar tres tipos de anlisis: Trabajo en progreso: Este reporte presenta grficamente, para cada tarea en curso del proceso, los usuarios que estn asignados y el estado de sus actividades pendientes. Un grfico de barras muestra en colores los casos que estn a tiempo, en riesgo y vencidos para cada usuario. Puede seleccionar una tarea independiente para analizarla independientemente, haciendo clic en el diagrama de proceso.

2014

Copyright 2013 - Bizagi

Si no hay ninguna actividad ha sido seleccionada, el informe mostrar todas las tareas abiertas del proceso con sus asignados.

Copyright 2013 - Bizagi

2015

Puede filtrar el informe por cualquier Dimensin para mostrar la informacin de los usuarios que cumplen con los criterios definidos. Trabajo en progreso por usuario: Este reporte presenta grficamente el estado de los casos en curso exclusivamente para los usuarios que cumplan con las condiciones especificadas en las Dimensiones. Si no hay Dimensiones seleccionadas, el informe estar en blanco. Al menos una dimensin debe ser seleccionada con el fin de mostrar informacin. Se muestra un informe individual para cada usuario. Usted puede ver grficamente, con colores el estado de la tarea que el usuario tiene asignadas, especificando el proceso y la tarea.

2016

Copyright 2013 - Bizagi

Mi equipo: El presente informe ha sido diseado especficamente para obtener informacin sobre el rendimiento de su equipo, es decir, las personas que le reportan directamente a usted. El informe est pre-filtrado para mostrar slo aquellos usuarios que pertenecen a su equipo de trabajo. Este reporte est disponible slo si tiene la gente a cargo configurada en Bizagi. Si no existe, este reporte NO se mostrar. El reporte muestra un informe individual para cada usuario. Usted puede ver grficamente, con colores el estado de las tareas que el usuario tiene asignados, especificando el proceso y la tarea.

Copyright 2013 - Bizagi

2017

Todos los reportes se pueden exportar a Excel. Usted encontrar un enlace en la parte inferior de cada reporte; haga clic en l para exportar los datos.

2018

Copyright 2013 - Bizagi

Detalles de los casos

Haga clic en cualquier grfico para mostrar una lista de todos los casos relacionados con ste. Esta lista se puede exportar a Excel haciendo clic en el enlace situado en la parte inferior de la pantalla.

1. Haga clic en el nmero de caso para acceder a un caso especfico.

Copyright 2013 - Bizagi

2019

2. Haga clic en Vista para ver el estado del caso dentro del proceso y de su trayectoria.

3. Haga clic en A d m in para acceder a la pgina de administracin con el fin de reasignar o abortar el caso.

4. Para el reporte de Casos, al desplegar la lista de los casos, se muestra una columna con el usuario asignado.

2020

Copyright 2013 - Bizagi

5.2

Anlisis
El reporte de Anlisis es una herramienta de anlisis que le permite ver grficamente informacin sobre los casos cerrados. Anlisis se divide en dos perspectivas: A n lisis d e P ro ceso s y A n lisis d e Tareas. Es posible profundizar en cualquier informe para ver informacin acerca de cada caso. IMPORTANTE: Esta funcin se habilita cuando la duracin de procesos y de tareas estn configuradas. De esta manera Bizagi puede establecer una comparacin entre los tiempos de ejecucin esperados y reales.

Anlisis de Procesos
El reporte de Anlisis de Procesos presenta indicadores de rendimiento de los casos cerrados. Usted puede optar por filtrar por proceso y por cualquiera de las Dimensiones definidas previamente. Los informes se mostrarn siempre de acuerdo con un intervalo de tiempo especificado en la parte inferior de la pantalla. Anlisis de Procesos se divide en cinco informes: Tiempo de ciclo: permite analizar el tiempo de ciclo de los procesos cerrados. Histograma Duraciones: le permite controlar el tiempo que tarda cerrar procesos. Actividad Proceso: le permite analizar la eficacia obtenida a partir de la proporcin de casos cerrados sobre los casos creados. Ranking de activaciones: muestra un grfico para comparar el nmero de caso creados de todos los procesos del proyecto. Caminos frecuentes: le permite identificar las rutas frecuentes del proceso.

Tiempo de Ciclo
El reporte contiene el nmero de casos cerrados en un proceso elegido, mostrando la duracin p ro m ed io , d u raci n esp erad a, la d esv iaci n estn d ar y el n m ero d e caso s term in ad o s a tiem p o . Los casos terminados NO incluyen los casos abortados. El reporte muestra un histograma grfico llamado Du raci n d e caso s que compara la duracin promedio versus la duracin prevista de los casos cerrados. Tambin muestra un grfico circular denominado Estad o d e Caso s que muestra el porcentaje de casos cerrados a tiempo en comparacin con el porcentaje de casos cerrados cerrados vencidos.

Copyright 2013 - Bizagi

2021

Histrograma de duraciones
Este reporte muestra el nmero de das que le llev a los casos para poder ser completados, o cerrados (sin incluir los casos abortados). La lnea vertical representa el tiempo de cierre esperado de los casos. La lnea separa los casos cerrados a tiempo de los casos cerrados vencidos.

2022

Copyright 2013 - Bizagi

Actividad de Proceso
Este reporte muestra un resumen de la actividad del procesos durante el perodo de tiempo seleccionado. Contiene el nmero de casos creados (abiertos), el nmero casos completos (cerrados) y el nmero de casos abortados. Tambin muestra un valor de Efectivdad obtenido a partir de la relacin entre los cerrados y los creados. La actividad del proceso se muestra como un grfico de histograma. Tambin muestra un g rfico d e Ten d en cia que muestra la tendencia de creacin de casos ocurre en el intervalo de fechas seleccionado.

Copyright 2013 - Bizagi

2023

Ranking de activaciones
Un grfico de barras muestra el nmero de casos creados para todos los procesos del proyecto. El grfico est ordenado por nmero de creacin.

Caminos frecuentes

2024

Copyright 2013 - Bizagi

Este reporte muestra los caminos ms frecuentes de un proceso especfico. Esta opcin le permite identificar los casos de negocio que son ms comunes y tomar decisiones sobre la base de estas estadsticas. Como ejemplo, vamos a utilizar el proceso de Solicitud de viaje. El gerente del rea de Recursos Humanos debe esperar que la mayora de las solicitudes son aprobadas y necesitan reservas. El gerente controla las rutas frecuentes. Habr rutas disponibles slo si hay casos cerrados que han pasado por all. Los casos en curso no se mostrar en este informe.

En esta opcin Bizagi identifica y muestra los caminos ms frecuentes en el proceso. Se calcula el porcentaje de casos cerrados que pas por una ruta especfica entre todos los casos cerrados para el proceso (los casos no abortados). En el ejemplo, se puede comprobar que el 62,4% de los casos han pasado por el camino marcado (aprobado con anticipo y con reservas) Se puede entender de este resultado que la mayora de las solicitudes se han aprobado (como se esperaba), pero muchos de ellos requieren un anticipo. Para reducir estas actividades manuales el Administrador podra pensar en proveer Tarjetas de Crdito Corporativa para todos los que viajan.

Copyright 2013 - Bizagi

2025

Tambin puede verificar los otros caminos que se han utilizado con frecuencia y obtener el porcentaje de uso. Bizagi resaltar cada uno de los otros caminos. En la imagen de abajo, el usuario puede comprobar que slo el 24,7% de los casos no fueron aprobadas.

2026

Copyright 2013 - Bizagi

Anlisis de Tareas
Este reporte presenta los indicadores de rendimiento de las Actividades cerradas que pertenecen a los casos cerrados (sin incluir los casos abortados). Las tareas pueden ser filtrados por la versin de Procesos y Dimensiones. Seleccione un proceso para poder analizar sus tareas. Para cada uno, el nmero de actividades a tiempo y vencidas se muestra con un grfico circular. Estas tareas NO incluyen los casos abortados. Al hacer clic en cualquier tarea una pequea ventana muestra un resumen de las medidas pertinentes: duracin promedio, duracin esperada, el nmero de actividades cerradas a tiempo, el nmero de actividades cerradas vencidas y el recuento de casos (nmero de casos que pas por la tarea entre todos casos cerrados).

En la parte inferior del diagrama hay una lista, oculta por defecto, que muestra todas las tareas que forman parte del proceso elegido. En la lista se indican medidas relevantes. Haga clic en cualquier tarea en el diagrama. Las columnas pueden reordenarse arrastrando cada ttulo.

Copyright 2013 - Bizagi

2027

Detalles de casos
Para obtener ms informacin sobre los casos incluidos en cada informe, haga clic en los grficos. Estos mostrar una lista de todos los casos relacionados. Esta lista se puede exportar a Excel haciendo clic en el enlace situado en la parte inferior de la pantalla Al hacer clic en el nmero de caso usted acceder a la Forma Resumen del caso.

2028

Copyright 2013 - Bizagi

Al hacer clic en la columna Vista se desplegar la vista grfica del proceso que le da acceso a la ruta que sigui el caso.

5.3

Sensores
Lo s Sen so res son un conjunto de reportes que despliegan informacin que le permitir realizar mejora continua de procesos. Los sensores le permiten revisar y controlar:
El tiempo y el nmero de casos entre dos tareas de proceso Nmero de activaciones de una tarea Acuerdos de nivel de servicio SLA Los sensores se dividen en dos informes: Cro n m etro s y Co n tad o res.

Cronmetros
Los Cronmetros determinan el nmero de casos que han pasado a travs de una ruta especfica y el tiempo que ha llevado a hacerlo. El tiempo se define a partir de la primera vez que entra en la tarea de partida hasta el momento en que deja la tarea final. Slo los casos que han completado todo el recorrido se tienen en cuenta en los informes. Es posible que en un caso particular un camino se repita varias veces. Por lo tanto, un solo caso puede tener varias instancias de un cronmetro. Hay informes diferentes para cada Cronmetro: Resumen Tiempo del ciclo: Esta tabla muestra el nmero de veces que se ha completado la ruta seleccionada, el tiempo mnimo que tom as como el tiempo mximo y la duracin media. De acuerdo con el SLA definido en el cronmetro, en la tabla se muestran el nmero de casos que cumplieron los SLA (a tiempo) y el nmero de casos que no cumplan con el SLA (Atrasadas).

Copyright 2013 - Bizagi

2029

Nivel de servicio: muestra el nmero de casos que cumpli con la ruta dividido por el tiempo que le tom cada uno ser completado. Se divide en das, de cero a seis

Histograma de duracin: Este grfico muestra grficamente los das que las instancias del cronmetro tardaron en ser completadas. Hay una lnea vertical que separa las instancias a tiempo de las retrasadas.

Tendencia de duraciones: Este grfico muestra el tiempo de duracin promedio del cronmetro en el rango de tiempo seleccionado.

2030

Copyright 2013 - Bizagi

Tendencia de activaciones vs cierres: el cronmetro, en el tiempo seleccionado, combina las tendencias del nmero de activaciones y el nmero de cierres.

Informacin importante de Cronmetros: Los Cronmetros son independientes para cada usuario final. Cada usuario define las rutas que l o ella considere necesarias. Estos son creados en el Portal de Trabajo. Usted puede optar por filtrar el informe por cualquiera de las dimensiones definidas previamente. Los rangos de tiempo estn disponibles en la parte baja del reporte Cada cronmetro se puede eliminar o editar en cualquier momento Los cronmetros se pueden exportar a Excel

Contadores
Los Contadores se selecciona para una tarea especfica en un proceso para obtener el nmero de veces que el flujo del proceso ha pasado por ella. Este sensor ser til para determinar los ndices de

Copyright 2013 - Bizagi

2031

re-procesamiento y bucles. Proporciona datos para optimizar los procesos, la identificacin de las tendencias de activacin, recuentos y la lista de los casos. Los contadores se calculan de dos maneras diferentes: De acuerdo con la fecha de creacin del caso: Este reporte cuentan los casos que llegan a la tarea seleccionada y que se han creado durante el perodo de tiempo elegido. Es decir, el contador tiene en cuenta los casos que se han creado durante el periodo de tiempo elegido y activado la tarea seleccionada. De acuerdo con la fecha de activacin del contador: Este contador tiene en cuenta todos los casos que pasan por la tarea seleccionada, independientemente de la fecha de creacin. Es decir, cualquier caso, ya sea creado antes o durante el perodo de tiempo elegido, que activa la tarea seleccionada se cuentan.

Inicialmente los Contadores se muestran para cada proceso, con el nombre del proceso colapsado. El proceso colapsado mostrar dos informes: Resumen: En esta tabla se muestran las medidas de todos los contadores del proceso. Cada contador muestra el nmero de activaciones. Un caso podra activar la misma tarea ms de una vez, y contar cada uno. As el nmero de casos ser siempre menor o igual que el recuento de tareas. Tambin hay un porcentaje que muestra cuntos casos pasaron por la tarea frente al conjunto de

2032

Copyright 2013 - Bizagi

todos los casos.

Diagrama de conteos: este grfico es un histograma que muestra el recuento total de todos los contadores del proceso seleccionado.

Copyright 2013 - Bizagi

2033

Reportes individuales
Al expandir los contadores de un proceso, usted podr acceder a la informacin de contador individualmente. Cada contador dispone de dos informes: Resumen: Esta tabla muestra el nmero de veces que la tarea seleccionada se ha activado y el nmero de casos que incluyeron dicha tarea. Un caso podra activar la misma tarea ms de una vez, y contar cada uno. As el nmero de casos ser siempre menor o igual que el recuento de tareas. Tambin hay un porcentaje que muestra cuntos casos pasaron por la tarea frente al conjunto de todos los casos. Tendencia del contador: Este grfico muestra la tendencia del nmero de activaciones del contador.

2034

Copyright 2013 - Bizagi

Informacin importante de Contadores Los contadores son creadas por por cada usuario final: cada uno define las rutas que l o ella considere necesarias. Estos son creados en el Portal de Trabajo. Usted puede optar por filtrar por cualquiera de las dimensiones definidas previamente. Los rangos de tiempo estn disponibles para elegir las fechas de inicio y de fin al final del reporte. Cada contador se puede eliminar o editar en cualquier momento. Los contadores se pueden exportar a Excel.

Cmo crear Sensores

1. En Portal de Trabajo haga clic en el men Rep o rtes. Seleccione la opcin Sensores.

Copyright 2013 - Bizagi

2035

2. En la ventana, haga clic en Ed itar sensores para crear uno nuevo.

3. En la parte izquierda de la pantalla, seleccione el proceso al que desea aadir el sensor. Seleccionar el proceso..

2036

Copyright 2013 - Bizagi

4. Haga clic en N u ev o Cro n m etro o N u ev o Co n tad o r de acuerdo con el sensor que desea crear.

5. Seleccione los puntos necesarios del proceso para el sensor. Si va a crear un cronmetro definir dnde comienza y dnde termina.

Copyright 2013 - Bizagi

2037

Si va a crear un contador de definir la tarea que se va a contar.

6. Escriba un Nombre, Nombre visible y una descripcin para el sensor. Tambin incluya el SLA para Cronmetros. Haga clic en A p licar.

2038

Copyright 2013 - Bizagi

Cmo editar y eliminar Sensores

1. En el Portal de Trabajo haga clic en el men Rep o rtes. Seleccione la opcin Sen so res.

2. En la ventana de clic en Ed itar Sen so res.

3. En el lado izquierdo de la pantalla seleccione el proceso donde se cre el sensor a ser editado. Seleccione el sensor que desee y haga clic en Ed itar o Elim in ar.

Copyright 2013 - Bizagi

2039

4. Si est editando el sensor debe definir los nuevos puntos del proceso. Haga clic en A p licar para guardar los cambios.

5.4

Dimensiones
Una Dimensin es un conjunto de valores que se utiliza como filtro en los reportes. Los reportes BAM, Anlisis y Sensores presentan informacin acerca de todos los casos de forma predeterminada, pero los casos se pueden filtrar con respecto a una dimensin especifica. Bizagi ofrece dos conjuntos de dimensiones: Creadas por defecto, presentes para todos los proyectos y procesos Definidas por el usuario.

Dimensiones del sistema (por defecto)

Estas son las dimensiones que Bizagi ha definido de forma predeterminada, se mostrarn siempre en cada proyecto. Las Dimensiones del sistema son: rea: enumera todas las reas creadas. Ubicacin: lista de todas las Ubicaciones creadas. Posicin: lista todas las Posiciones creadas en Organizacin. Rol: enumera todos los roles creados en Organizacin. Habilidad: listas todas las habilidades creadas en Organizacin. Usuario: Todos los usuarios del sistema Mi equipo: si el usuario tiene subordinados,mostrar las personas a cargo. Si el usuario no tiene subordinados Mi equipo mostrar todos los usuarios que tienen el mismo nivel jerrquico. Estas dimensiones se muestran en azul oscuro.

Dimensiones definidas por el Usuario

Usted puede definir sus propias dimensiones de acuerdo a sus necesidades. Las dimensiones pueden ser creadas en Bizagi Studio en tiempo de desarrollo, o en el Portal de Trabajo cuando el proyecto est en produccin. Segn donde se cree las Dimensiones de Usuario se clasifican en:

2040

Copyright 2013 - Bizagi

Dimensiones fijas: Estas son las dimensiones que se crean en Bizagi Studio en tiempo de desarrollo. Ellas se mostrar a todos los usuarios finales y no son administrables. Se despliegan en color rojo. Dimensiones administrables: Estas son las dimensiones creadas a travs del Portal de Trabajo por cada usuario individualmente. Pueden ser editadas o eliminadas en cualquier momento. Se muestran en azul claro.

Las Dimensiones pueden ser creadas usando el modelo de datos para los siguientes tipos de atributos: Entidad relacionada: Atributos relacionados con otra Entidad. Para ser elegible como Dimensiones estos atributos slo puede tener un valor para cada caso. Es decir, no se permiten las colecciones. Por ejemplo, en un proceso de solicitud de viaje, el Estado del caso y el Hotel se puede elegir. Sin embargo, las entradas o los gastos que son colecciones no son elegibles.

Copyright 2013 - Bizagi

2041

Los atributos booleanos: Los atributos que pueden ser verdaderas o falsas.

Nota: Las dimensiones se definen para cada proceso por lo que slo se puede utilizar para los reportes relacionados con ese proceso.

Crear Dimensiones
En Bizagi Studio
Recuerde que las dimensiones creadas en Bizagi Studio son fijas, es decir, que no se puede cambiar en el Portal de Trabajo. 1. En la vista de Mdulos vaya a el mdulo de Anlisis. En el item de Dimensiones de clic derecho y seleccione N u ev a d im en si n .

2042

Copyright 2013 - Bizagi

2 .Seleccione un Nombre, Nombre para mostrar y un proceso. Escriba una descripcin de la dimensin.

3. Elija el XPath para identificar los valores para filtro. Cuando termine, haga clic en A cep tar.

Copyright 2013 - Bizagi

2043

En el Portal de Trabajo
1. En el men A d m in , haga clic en Dim en sio n es.

2. Haga clic en N u ev a d im en si n y escriba un nombre, el nombre de visualizacin y un proceso. Escriba una descripcin de la dimensin.

2044

Copyright 2013 - Bizagi

3. Elija el XPath para identificar de donde se tomar el filtro. Cuando termine, haga clic en Aceptar.

4. Para editar o borrar la dimensin, seleccinela en el men Dimensiones administrables a la izquierda y haga clic en Ed itar o Elim in ar.

Copyright 2013 - Bizagi

2045

Nota Slo los usuarios que tengan los permisos necesarios puede crear, editar y borrar Dimensiones en el Portal de Trabajo.

Usar las Dimensiones

Usted podr utilizar las dimensiones en cualquier reporte que contenga el icono Filtro:

Puede seleccionar tantas dimensiones como se desee. Un rbol se mostrar con las dimensiones organizadas jerrquicamente para seleccionar las que necesita.

2046

Copyright 2013 - Bizagi

Estar disponible una pestaa de bsqueda para que escriba el nombre del valor de una dimensin. La lista de dimensiones se desplegar en la pantalla.

Copyright 2013 - Bizagi

2047

Dimensiones en produccin
Para garantizar el correcto funcionamiento de todos los ambientes, una vez hecho deployment, no es posible eliminar Dimensiones. Las Dimensiones seguirn siendo editables en el entorno de desarrollo en Bizagi Studio, para que pueda realizar cambios si es necesario. Cuando se abre una dimensin para editar un mensaje de advertencia aparecer como se muestra a continuacin, para recordarle que la dimensin ya est en produccin y cualquier cambio podra afectar el entorno de produccin.

5.5

Mis Reportes
Todos los reportes pueden ser guardados para su posterior anlisis y toma de decisiones. Los informes guardados estarn disponibles en el men de M is Rep o rtes, en Reportes. Los informes guardados estarn disponibles por usuario individualmente.

Guardar informes
En el informe que desea guardar, haga clic en Gu ard ar co n su lta.

2048

Copyright 2013 - Bizagi

En la nueva ventana ingrese un nombre y una descripcin para el informe. En algunos casos, ser necesario establecer un filtro de tiempo

Copyright 2013 - Bizagi

2049

Por ltimo, haga clic en Gu ard ar. Una vez que el informe ha sido guardado se puede ver en mi opcin Reportes. Recuerde que los informes guardados slo son visibles para el usuario que los crea.

Editar y eliminar reportes guardados

Los reportes guardados se pueden editar y eliminar. En M is Rep o rtes seleccione el informe que desea

2050

Copyright 2013 - Bizagi

editar o eliminar y haga clic en el botn Ed itar o Elim in ar. Si va a editar un informe, realice los cambios necesarios y haga clic en Gu ard ar.

Si va a eliminar un informe confirme esta accin haciendo clic en Elim in ar en la ventana emergente de confirmacin.

Copyright 2013 - Bizagi

2051

Parte VI
Administracin del Sistema Bizagi

Administracin del Sistema Bizagi

Los siguientes captulos permiten a los administradores del sistema manejar la configuracin, instalaciones y versiones de Bizagi.

6.1

Actualizacin de Bizagi
Bizagi es una solucin orientada al modelo. Esta caracterstica permite la actualizacin de proyectos en Bizagi de una manera sencilla.

Dentro de estas opciones de actualizacin, puede realizar el upgrade peridico de su versin de Bizagi (recomendado), y tambin puede optar por actualizar la edicin de su proyecto en cualquier momento (pasarlo de la Xpress a la Enterprise .NET).

Para mayor informacin sobre estos temas, consulte los artculos: Actualizacin de versin de Bizagi. Actualizacin de edicin de Bizagi (de Xpress a Enterprise).

6.1.1

Actualizacin de versin
Bizagi libera nuevas versiones de manera peridica. Estas versiones incluyen nuevas funcionalidades poderosas y ajustes o mejoras a las funcionalidades existentes. Recomendamos que se siempre realice la actualizacin a la nueva versin, de manera que sus proyectos puedan contar con todos los beneficios de las nuevas mejoras y funcionalidades.

Copyright 2013 - Bizagi

2053

La actualizacin de versin es un procedimiento simple, el cual lo realiza Bizagi de manera automtica. Para ello, cuando haya una nueva versin disponible, al abrir Bizagi Studio ser informado para iniciar la descarga. Describiremos de manera separada el procedimento tanto para actualizarse a una versin mayor (por ejemplo, de una versin 9.1.a la versin Bizagi Go), y actualizarse a una versin menor.

Recomendaciones
Antes de actualizar su proyecto, recomendamos: 1. Crear archivos de respaldo (backups) de su Base de datos y de las carpetas de su aplicacin. Esto significa crear un backup de la Base de datos, y tambin crear una copia del contenido de las carpetas "C:\BizAgi\[edicin_bizagi]\Projects\[su_proyecto]\WebApplication\" y "C: \BizAgi\[edicin_bizagi]\Projects\[su_proyecto]\Scheduler\". 2. Siempre actualice primero su ambiente de desarrollo. Bajo esta misma idea, es muy importante realizar las pruebas unitarias que garanticen que los Procesos existentes tienen un comportamiento adecuado. Una vez se haya verificado esto, podr actualizar su ambiente de pruebas y llevar a cabo las pruebas de aceptacin de usuario en este ambiente. Luego de certificar que los Procesos estn OK tanto en desarrollo como en pruebas, y de acuerdo a la criticidad de sus Procesos, usted puede crear un ambiente llamado Replica de produccin.

2054

Copyright 2013 - Bizagi

El fin de este ambiente, es para realizar la actualizacin y probar los Procesos de produccin con las instancias activas (casos reales). Y de esta manera, solamente despus de la revisin de Procesos e instancias en el ambiente de Replica de produccin, proceder a actualizar su ambiente real de produccin. Nota El ambiente llamado Replica de produccin, es un proyecto de Bizagi el cual tiene restaurado en l, un backup del ambiente de produccin. Este ambiente no es el de produccin en si, ya que por ejemplo en l se debern cambiar los parmetros de produccin como por ejemplo: el servidor SMTP real, los correos reales de los usuarios, las URL de servicios Web o puntos de integracin, o cualquier otra informacin suceptible del ambiente real. 3. Planee la actualizacin del ambiente de produccin en un horario no laboral. Esto se debe a que la actualizacin de versin detendr temporalmente los servicios (por aproximadamente 3 minutos). 4. No realice la actualizacin de versin si tiene un Deployment marcado como Release Candidate pendiente por llevar a produccin.

Actualizacin a versin mayor

Para actualizar su proyecto 9.1.x a la versin ms reciente de Bizagi Go, por favor revise la informacin sobre la Actualizacin a Bizagi Go.

Actualizacin a versin menor

La actualizacin a una versin menor significa actualizar un proyecto en una versin de Bizagi Go, a una versin ms reciente de Bizagi Go. Para dicho procedimiento, lleve a cabo los siguientes pasos.

1. Actualice su instalacin
Para actualizar la versin de Bizagi que tiene instalado, descargue primero el instalador de Bizagi desde nuestra pgina oficial de descarga en www.bizagi.com, y luego ejectelo directamente en su servidor de desarrollo. Tambin puede optar por usar el botn de actualizacin directamente desde el aviso de nueva versin que presenta Bizagi Studio.

Copyright 2013 - Bizagi

2055

2. Actualice su proyecto
Una vez que haya instalado la versin reciente de Bizagi, actualice su ambiente de desarrollo a travs de Bizagi Studio. 1. Abra Bizagi Studio y abra su proyecto usando la opcin A b rir p ro y ecto ex isten te.

2056

Copyright 2013 - Bizagi

2. Seleccione el servidor local desde la lista desplegable (o ingrese directamente el nombre del servidor si ste no se encuentra en la lista). Seguidamente, seleccione el proyecto a actualizar.

Copyright 2013 - Bizagi

2057

3. De clic en F in alizar. Bizagi mostrar una ventana de confirmacin, en la cual usted deber dar clic en SI para que Bizagi inicie de manera automtica la actualizacin:

Cuando la actualizacin se haya completado el proyecto se abrir en Bizagi Studio.

2058

Copyright 2013 - Bizagi

4. Asegrese de probar sus Procesos existentes y garantizar que se comporten adecuadamente. Una vez que haya revisado lo anterior, puede actualizar sus dems ambientes (primero pruebas, luego el ambiente de Replica de produccin, y finalmente produccin). Si usted utiliza Bizagi Enterprise .NET o Bizagi Xpress, para los otros ambientes, la actualizacin se realiza a travs de Bizagi Management Console siguiendo el mismo procedimiento descrito en las secciones anteriores. Si usted utiliza Bizagi Enterprise JEE, consulte la Actualizacin de versin en la edicin Enterprise JEE.

6.1.1.1

Actualizacin de versin en la edicin JEE

Bizagi libera nuevas versiones de manera peridica. Estas versiones incluyen nuevas funcionalidades poderosas y ajustes o mejoras a las funcionalidades existentes. Recomendamos que se siempre realice la actualizacin a la nueva versin, de manera que sus proyectos puedan contar con todos los beneficios de las nuevas mejoras y funcionalidades. La actualizacin de versin es un procedimiento simple, el cual lo realiza Bizagi de manera automtica.

Copyright 2013 - Bizagi

2059

En la edicin Enterprise JEE, cuando se ha instalado una versin nueva, por medio de Bizagi Studio al abrir el proyecto podr actualizarlo automticamente en su ambiente de desarrollo. Para los ambientes de pruebas o produccin en la JEE, se debe llevar a cabo un procedimiento diferente. Este artculo describe cmo actualizar la versin en los ambientes de pruebas o de produccin de proyectos Bizagi en la edicin Enterprise JEE para versiones 10.0.1 o superior. Para ms informacin acerca de la actualizacin del ambiente de desarrollo, consulte Actualizacin de versin.

Antes de comenzar
Antes de actualizar su proyecto, recomendamos enfticamente: 1. Crear archivos de respaldo (backups) de su Base de datos y de la aplicacin. Esto significa crear un backup de la Base de datos, y tambin crear una copia de la aplicacin en el Servidor de Aplicaciones JEE. 2. Siempre actualice primero su ambiente de desarrollo, luego el ambiente de pruebas y despus el de Produccin. Tambin evale si requiere del ambiente adicional que es Rplica de produccin. Es muy importante realizar las pruebas unitarias que garanticen que los Procesos existentes en el ambiente de desarrollo tienen un comportamiento adecuado. Una vez se haya verificado esto, podr actualizar su ambiente de pruebas y llevar a cabo las pruebas de aceptacin de usuario en este ambiente. Luego de certificar que los Procesos estn OK tanto en desarrollo como en pruebas, y de acuerdo a la criticidad de sus Procesos, usted puede crear un ambiente llamado Replica de produccin. El fin de este ambiente, es para realizar la actualizacin y probar los Procesos de produccin con las instancias activas (casos reales). Y de esta manera, solamente despus de la revisin de Procesos e instancias en el ambiente de Replica de produccin, proceder a actualizar su ambiente real de produccin. Nota El ambiente llamado Replica de produccin, es un proyecto de Bizagi el cual tiene restaurado en l, un backup del ambiente de produccin. Este ambiente no es el de produccin en si, ya que por ejemplo en l se debern cambiar los parmetros de produccin como por ejemplo: el servidor SMTP real, los correos reales de los usuarios, las URL de servicios Web o puntos de integracin, o cualquier otra informacin suceptible del ambiente real. 3. Planee la actualizacin del ambiente de produccin en un horario no laboral. Esto se debe a que la actualizacin de versin detendr temporalmente los servicios y por lo tanto deber agendarse debidamente. 4. Tener a la mano los archivos de configuracin (y de despliegue) proporcionados por Bizagi ( B izA g iear-W eb sp h ere-d ist.zip , B izA g i-ear-W eb lo g ic-d ist.zip , o B izA g i-ear-JB o ss-d ist.zip) de acuerdo a su

2060

Copyright 2013 - Bizagi

Servidor de Aplicaciones JEE.

Lo que debe hacerse

Para actualizar la versin en su ambiente de pruebas o de produccin, estos son los pasos a seguir: 1. Reemplace los archivos de configuracin y libreras que utiliza Bizagi. 2. Generar el portal de trabajo haciendo el despliegue de la aplicacin al Servidor de Aplicaciones.

Procedimiento
Siga el detalle proporcionado para cada paso: 1. Reemplace los archivos de configuracin y libreras que utiliza Bizagi. Este paso implica reemplazar los archivos de configuracin que utiliza Bizagi, por su versin ms reciente (aquellos incluidos en los archivos de distribucin B izA g i-ear-W eb sp h ere-d ist.zip , B izA g i-earW eb lo g ic-d ist.zip , o B izA g i-ear-JB o ss-d ist.zip). Esto se realiza de acuerdo a si usted utiliza WebSphere, Weblogic o JBoss, como se describe en el p aso 1: Ex traer lo s arch iv o s u sad o s p o r B izag i de cada gua en particular para configurar el Servidor de Aplicaciones JEE. Para WebSphere consulte la Configuracin de WebSphere. Para Weblogic consulte la Configuracin de Weblogic. Para JBoss consulte la Configuracin de JBoss. Tenga en cuenta que debe realizar este paso para cada nodo (implicando que se debe repetir si su solucin cuenta con una configuracin en clster). Nota Cuando se reemplacen estos archivos de configuracin (driver y otras libreras .jar principalmente), tenga en cuenta que debe considerar el nombre exacto que se referencia en la configuracin de su Servidor de Aplicaciones. Esto significa que se recomienda asegurarse que los jars se renombren para garantizar que se haga la referencia por su nombre sin necesidad de incluir la versin especfica.

2. Generar el portal de trabajo haciendo el despliegue de la aplicacin al Servidor de Aplicaciones. Para ms informacin sobre este paso, consulte el Despliegue de la aplicacin hacia un Servidor de Aplicaciones JEE.

6.1.2

Actualizacin de edicin Xpress a Enterprise

Si se ha desarrollado un proyecto utilizando Bizagi Xpress, es posible actualizarlo en cualquier momento a la edicin Bizagi Enterprise. Esto se lleva a cabo mediante un procedimiento muy sencillo, el cual se describe en este artculo (donde especficamente se ilustra cmo actualizar un proyecto en Bizagi Xpress a Bizagi Enterprise .NET.

Copyright 2013 - Bizagi

2061

Para mayor informacin acerca de las diferencias entre ediciones de Bizagi (un listado de funcionalidad), consulte las diferencias de ediciones Bizagi BPM Suite.

Antes de comenzar
Antes de seguir el procedimiento a continuacin, asegrese de contar con las licencia de Bizagi Enterprise para su ambiente de produccin. Tenga en cuenta que la licencia para sus Procesos en Bizagi Xpress no podr ser utilizada en la edicin Enterprise. Esta licencia de Bizagi Enterprise la debe tener a la mano para poder activarla en el ambiente de produccin en el momento en el que realice la actualizacin. De no ser as, el Portal de Trabajo de Bizagi no seguir funcionando. Para ms informacin acerca del licenciamiento, por favor contctenos a sales@Bizagi.com.

El concepto detrs de la actualizacin de edicin

El procedimiento para actualizar la edicin de un proyecto Bizagi es simple: consiste en abrir el proyecto existente (creado inicialmente con Bizagi Xpress), con la edicin Bizagi Enterprise .NET. Al realizar esto, Bizagi automticamente actualiza la informacin sobre la edicin en su registro de proyectos, y no se realiza modificacin alguna a la base de datos del proyecto (la Xpress y Enterprise utilizan la misma estructura y metadatos). Bases de datos nuevas o temporales tampoco son requeridas en este procedimiento. Dentro del procedimiento de actualizacin, el proyecto existente y su base de datos quedarn asociados para trabajarse bajo la edicin Bizagi Enterprise .NET.

Prerequisitos
Tenga en cuenta las siguientes consideraciones para el procedimento presentado a continuacin: La actualizacin debe hacerse desde una misma versin en Xpress a una misma versin en Enterprise .NET (p.e. de 9.1.9 Xpress a 9.1.9 Enteprise). Esto puede implicar actualizarse primero de versin en Xpress a la ms reciente de Bizagi.

2062

Copyright 2013 - Bizagi

Todos los ambientes del proyecto (desarrollo, pruebas, produccin) deben ser actualizados. De lo contrario, no ser posible llevar a cabo la puesta en marcha de los Procesos a travs del Deployment de Bizagi. Los pasos descritos en este artculo contemplan el procedimiento con los 3 ambientes: primero desarrollo, luego pruebas y finalmente produccin. El procedimiento de actualizacin detiene temporalmente los servicios (el servidor Web se reinicia). Adicional a la actualizacin en si, se requiere poder el acceso al servidor de produccin para poder aplicar la licencia. NOTA: Aunque usted puede optar por crear sus propios backups de la Base de datos y carpetas de la aplicacin, Bizagi tambin genera automticamente estos respaldos para: la Base de datos, el servicio Programador (Scheduler) y archivos de la aplicacin Web antes de comenzar la actualizacin. En caso de que requiera de estos archivos de respaldo, los podr encontrar en la ruta de backups (para SQL Server y en un proyecto con Base de datos local, esta ruta ser: "C: \Bizagi\Xpress\Projects\[su_proyecto]\Backups"):

Cuando se tiene la Base de datos remotamente, esta ruta para SQL Server ser: "C:\Program Files (x86) \Microsoft SQL Server\[instancia_MSSQL]\MSSQL\Backup\" Si se usa una Base de datos Oracle, el backup quedar en la ruta de backups definida para esa instancia Oracle (tal como se especific al momento de crear el proyecto).

Copyright 2013 - Bizagi

2063

Procedimiento
Para la actualizacin descrita a continuacin, actualizaremos los 3 ambientes del proyecto M y B izag iP ro ject, desde una vesin 9.1.6 (en Xpress) a la versin 9.1.6 (en Enterprise .NET), y despus licenciar el servidor de produccin.

1. Actualizar el ambiente de desarrollo

Antes de iniciar, asegrese que su proyecto no est abierto y siendo modificado por otra instalacin de Bizagi Studio o el Management Console. 1.1. Instale la versin de Bizagi Enterprise .NET (disponible directamente desde nuestra pgina oficial). Para ms informacin acerca de nuestras ediciones disponibles, consulte ediciones Bizagi BPM Suite. Tenga en cuenta que para el ambiente de desarrollo, se requiere instalar Bizagi con la opcin de los componentes cliente:

2064

Copyright 2013 - Bizagi

Para ms informacin acerca de instalar Bizagi, consulte Instalacin de Bizagi Enterprise .NET. 1.2. Abra Bizagi Studio en su servidor de desarrollo (para este ejemplo, es Bizagi Studio de la 9.1.6). Recuerde asegurarse que est abriendo Bizagi Studio de la edicin Enterprise. Esto lo puede revisar, si la ubicacin de B izag iStu d io .ex e es dentro de la carpeta de instalacin de la edicin Enterprise (por defecto en "C:\Program Files\Bizagi\Bizagi Standard\Studio"). Si esto lo realiza desde el acceso directo del escritorio, debe llamarse Bizagi Studio Enterprise.

Copyright 2013 - Bizagi

2065

1.3. Seleccione la opcin de A b rir p ro y ecto ex isten te. En la ventana inicial, seleccione el servidor local (donde est registrado el proyecto en la Xpress) de la lista desplegable. 1.4. Seleccione el nombre del proyecto a abrir en la lista desplegable. Note que se presentan tanto proyectos en Xpress o Enterprise.

2066

Copyright 2013 - Bizagi

Haga clic en F in alizar. 1.5. Bizagi mostrar una alerta de la actualizacin de Xpress a Enterprise, informando que el procedimiento no es reversible. Confirme que desea continuar. 1.6. Bizagi iniciar el procedimiento, el cual debe tomar unos pocos minutos. El detalle tcnico y progreso del procedimiento se ensear en el dilogo:

Copyright 2013 - Bizagi

2067

Una vez que se haya completado el procedimiento, el proyecto abrir en Bizagi Studio de la edicin Enterprise. 1.7. Como una recomendacin orientada a evitar confusiones, en este punto puede optar por desinstalar Bizagi Xpress de su servidor de desarrollo. Para desinstalar Bizagi Xpress, basta con acceder a las opciones del Panel de control local y usar la opcin de desinstalacin desde all:

2068

Copyright 2013 - Bizagi

2. Actualizar el ambiente de pruebas

Antes de iniciar, asegrese que su proyecto no est abierto y siendo modificado por otra instalacin de Bizagi Studio o el Management Console. 2.1. Instale la versin de Bizagi Enterprise .NET (disponible directamente desde nuestra pgina oficial). Tenga en cuenta que para el ambiente de pruebas, es suficiente con instalar Bizagi con la opcin de los componentes de servidor:

Copyright 2013 - Bizagi

2069

2.2. Abra Bizagi Management Console de la edicin Enterprise .NET en pruebas (en este ejemplo, es el Management Console de la 9.1.6). Recuerde asegurarse que est abriendo el Management Console de la edicin Enterprise. Esto lo puede revisar, si la ubicacin de B izag iM C.ex e es dentro de la carpeta de instalacin de la edicin Enterprise (por defecto en "C:\Program Files\Bizagi\Bizagi Standard\MC").

2070

Copyright 2013 - Bizagi

2.3. Seleccione la opcin de A b rir p ro y ecto ex isten te. En la ventana inicial, seleccione el servidor local (donde est registrado el proyecto en ambiente de pruebas en la Xpress) de la lista desplegable. 2.4. Seleccione el nombre del proyecto a abrir en la lista desplegable. Note que se presentan tanto proyectos en Xpress o Enterprise.

Copyright 2013 - Bizagi

2071

Haga clic en F in alizar. 2.5. Bizagi mostrar una alerta de la actualizacin de Xpress a Enterprise, informando que el procedimiento no es reversible. Confirme que desea continuar. 2.6. Bizagi iniciar el procedimiento, el cual debe tomar unos pocos minutos. El detalle tcnico y progreso del procedimiento se ensear en el dilogo:

2072

Copyright 2013 - Bizagi

Una vez que se haya completado el procedimiento, el proyecto abrir en el Management Console de la edicin Enterprise. 2.7. Como una recomendacin orientada a evitar confusiones, en este punto puede optar por desinstalar Bizagi Xpress de su servidor de pruebas. Para desinstalar Bizagi Xpress, basta con acceder a las opciones del Panel de control local y usar la opcin de desinstalacin desde all:

Copyright 2013 - Bizagi

2073

3. Actualizar el ambiente de produccin

Antes de iniciar, asegrese que su proyecto no est abierto y siendo modificado por otra instalacin de Bizagi Studio o el Management Console. 3.1. Instale la versin de Bizagi Enterprise .NET (disponible directamente desde nuestra pgina oficial). Tenga en cuenta que para el ambiente de produccin, es suficiente con instalar Bizagi con la opcin de los componentes de servidor:

2074

Copyright 2013 - Bizagi

3.2. Abra Bizagi Management Console de la edicin Enterprise .NET en produccin (en este ejemplo, es el Management Console de la 9.1.6). Recuerde asegurarse que est abriendo el Management Console de la edicin Enterprise. Esto lo puede revisar, si la ubicacin de B izag iM C.ex e es dentro de la carpeta de instalacin de la edicin Enterprise (por defecto en "C:\Program Files\Bizagi\Bizagi Standard\MC").

Copyright 2013 - Bizagi

2075

3.3 Active la licencia de Bizagi Enterprise para su ambiente productivo. Esto se hace mediante la opcin de administracin de licencias, la cual est ubicada como un cono desde la parte inferior de la ventana inicial.

2076

Copyright 2013 - Bizagi

Tenga en cuenta que si su servidor de produccin no cuenta con conexin a Internet, deber aplicar la licencia desde un servidor con conexin al servidor de produccin y con salida a Internet.

3.4. Seleccione la opcin de A b rir p ro y ecto ex isten te. En la ventana inicial, seleccione el servidor local (donde est registrado el proyecto en ambiente de produccin en la Xpress) de la lista desplegable. 3.5. Seleccione el nombre del proyecto a abrir en la lista desplegable. Note que se presentan tanto proyectos en Xpress o Enterprise.

Haga clic en F in alizar. 3.6. Bizagi mostrar una alerta de la actualizacin de Xpress a Enterprise, informando que el procedimiento no es reversible. Confirme que desea continuar. 3.7. Bizagi iniciar el procedimiento, el cual debe tomar unos pocos minutos. El detalle tcnico y progreso del procedimiento se ensear en el dilogo:

Copyright 2013 - Bizagi

2077

Una vez que se haya completado el procedimiento, el proyecto abrir en el Management Console de la edicin Enterprise. 3.8. Como una recomendacin orientada a evitar confusiones, en este punto puede optar por desinstalar Bizagi Xpress de su servidor de produccin. Para desinstalar Bizagi Xpress, basta con acceder a las opciones del Panel de control local y usar la opcin de desinstalacin desde all:

2078

Copyright 2013 - Bizagi

At this point, we have all the environments of our project upgraded to Bizagi Enterprise! This means we will use the Enterprise .NET edition's Bizagi Studio to open the Development project, and the Enterprise edition's Management Console to manage our Test and Production environments.

6.2

Mantenimiento de proyectos
Una tareas comn en la administracin de proyectos, es garantizar la disponibilidad de la informacin y as evitar interrupciones en el servicio a los usuarios finales. Estas tareas administrativas de mantenimiento del proyecto son tiles como una medida de contingencia cuando algo no sucede como se plane, o cuando hay un evento externo el cual interrumpe el servicio de la aplicacin o su informacin.

Recomendaciones para el mantenimiento

Para contar con la opcin de revertir su proyecto a un estado previo (si algn evento inesperado sucede) lea con atencin las siguientes recomendaciones.

1. Crear Backups de manera frecuente

Copyright 2013 - Bizagi

2079

Los backups (o archivos de respaldo) brindan la posibilidad de no perder informacin, y asegurar que siempre re-establezcamos acceso a los datos en el menor tiempo posible ante eventualidades. Los backups son el elemento principal para las medidas y planes de contingencia. Es por ello que stos se deben crear de manera frecuente. Es tambin recomendado que se identifiquen los riesgos principales (los cuales pueden causar eventos inesperados), para que de esta manera se generen backups justo antes. De suceder algn evento inesperado, la solucin de Bizagi podr volver a un estado anterior con la restauracin de estos backups.

2. Cmo crear los Backups

En las soluciones de Bizagi se deben crear backups contemplando los siguientes elementos: La Base de datos. Archivos del Programador (Scheduler). Archivos de la aplicacin Web. Adjuntos de los casos (archivos que se hayan adjuntado a las instancias de Proceso).

Backups de la Base de datos Para crear backups de manera manual, siga el procedimiento indicado en Backups y restauracin en SQL Server o en Export e Import de Oracle. En Bases de datos SQL Server, usted tambin podr crear diferentes tipos de Backups: Full Backup: Esta opcin crea un backup completo (de toda la Base de datos). Con esta opcin se limpian las transacciones almacenadas en el log de transacciones. Differential Backup: Es un backup diferencial, donde se almacena la parte que ha cambiado con respecto al ltimo backup completo (Full Backup). El log de transacciones tambin es truncado.

2080

Copyright 2013 - Bizagi

Si desea programar Backups, de manera que se generen de manera automtica, puede revisar otros enlaces externos como http://support.microsoft.com/kb/930615.

Backups de la aplicacin Web y del Programador (Scheduler) Cree copias de las carpetas (y su contenido) del Servidor BPM donde estn los ensamblados usados por el Portal de Trabajo (la aplicacin Web) y por el servicio del Programador (Scheduler). Aplicacin Web: Los archivos que se encuentran en "C:\Program Files\[edicin_bizagi] \Projects\[su_proyecto]\Web Application\". Programador: Los archivos que se encuentran en "C:\Program Files\[edicin_bizagi] \Projects\[su_proyecto]\Scheduler\".

Copyright 2013 - Bizagi

2081

Para crear backups de estos archivos y su configuracin, basta con crear una copia de estas carpetas en otra ubicacin segura (preferiblemente en dispositivos externos o en la nube).

Backups de los adjuntos Los archivos y documentos adjuntos a los casos (instancias de Procesos) se almacenan por defecto en el Servidor BPM (la ruta "C:\BizAgi\[edicin_bizagi]\Projects\[su_proyecto]\Docs\"). Esta ruta de almacenamiento est definida por la configuracin del valor "upload path", que puede ser cambiada en cualquier momento.

2082

Copyright 2013 - Bizagi

Asegrese de respaldar estos archivos de los casos, sea si esta configuracin define que la ruta de almancenamiento es un ECM u otro Servidor de archivos. Para crear backups de estos archivos y su configuracin, basta con crear una copia de estas carpetas en otra ubicacin segura (preferiblemente en dispositivos externos o en la nube).

6.3

Mover un proyecto de Bizagi a otro servidor

A menudo durante el desarrollo de un proyecto de Bizagi (mientras se est en etapas de construccin y automatizacin de los Procesos), puede requerirse mover el proyecto de un servidor a otro. Por ejemplo, cuando se tiene un proyecto el cul fue inicialmente trabajado en una estacin de trabajo personal, y se desea mover a un Servidor para soportar el desarrollo colaborativo (con todo un equipo de trabajo). Este artculo describe cmo mover un proyecto de Bizagi a un servidor nuevo, considerando si: Se desea mover solamente la Base de datos. Se desea mover la Base de datos y el Servidor BPM (aplica solamente para el ambiente de desarrollo).

Antes de continuar
Copyright 2013 - Bizagi 2083

Tenga en cuenta que este procedimiento no aplica para publicar (poner en marcha) los Procesos de Bizagi en un ambiente de pruebas o produccin. Para publicar los Procesos, Bizagi provee una funcionalidad llamada Deployment. A travs del Deployment asistido de Bizagi, usted tambin puede eventualmente migrar el Servidor de pruebas a uno diferente. Si desea mover o migrar su Servidor de produccin (considerando tambin la licencia activada y los adjuntos de las instancias de Proceso), consulte la opcin de Administracin de servidores.

Procedimiento
El procedimiento para mover o copiar un proyecto de un servidor a otro es una tarea muy sencilla dado que Bizagi es una solucin orientada al modelo. De acuerdo a esto, toda la informacin de los Procesos (y del proyecto) en Bizagi se almacena en la Base de datos (sin necesidad de generar cdigo intermedio). Esto implica que en un proyecto de Bizagi: Para mover el ambiente de desarrollo (migrar tanto la Base de datos como el Servidor BPM) se llevan a cabo los siguientes pasos: 1. Crear un backup de la Base de datos. 2. Crear un proyecto nuevo de Bizagi en el nuevo servidor BPM. 3. Restaurar el backup en la nueva Base de datos. 4. Eliminar el proyecto anterior en Bizagi (con esto se elimina la anterior Base de dato, Portal de Trabajo y servicio del Scheduler). En caso de que solamente quiera mover la Base de datos a un nuevo servidor, no hara falta el paso #2, y en elimine la Base de datos anterior solamente (manualmente) en el paso #4.

Para mover el ambiente de pruebas de un proyecto, se utiliza la opcin de cambiar el servidor desde las opciones del Deployment de Bizagi. Para ver ms informacin acerca de esta posibilidad, consulte el Deployment de sus Procesos. Para mover el ambiente de produccin de un servidor a otro, se utilizan las opciones administrativas de Bizagi Management Console. Con estas opciones Bizagi tendr en cuenta escenarios en clster, licencias, adjuntos de casos y dems consideraciones. Para ver ms informacin acerca de estas opciones, consulte Administracin de servidores. Ntese que con esta opcin, la Base de datos y su servidor no son migrados. Si desea mover la base de datos, entonces deber realizar un backup y restaurarlo en la nueva ubicacin.

Informacin adicional
Para ms informacin acerca de cmo realizar un backup de una Base de datos, y su restauracin, consulte los artculos de acuerdo a las caracterstica de su proyecto: Backups y su restauracin en SQL Server.

2084

Copyright 2013 - Bizagi

Export e import de Oracle. Si desea ver ms informacin sobre la creacin de proyectos en Bizagi (para el ambiente de desarrollo), consulte crear nuevos proyectos.

6.3.1

Backups y su restauracin en SQL Server

Un requerimiento y una tarea administrativa frecuente, es tener la posibilidad de crear backups para una eventual restauracin a un estado anterior del proyecto Bizagi. Los backups en este tipo de tareas se crean principalmente como una medida de contingencia, o tambin para mover o copiar un proyecto en etapa de desarrollo. Todo esto es muy sencillo para la solucin Bizagi dado que es orientado al modelo. Cuando se usa una Base de datos SQL Server, las tareas de crear backups y restaurarlos, se realizan a travs de SQL Server Management Studio.

NOTA: La restauracin de backups debe usarse slo para migrar una base de datos o como medida de contingencia para restaurar el estado anterior de un mismo ambiente. Es decir que un backup del ambiente de desarrollo slo debe ser restaurado en el ambiente de desarrollo. Para crear ambientes, se debe usar la funcionalidad del Deployment de Bizagi. En este artculo ilustramos cmo realizar backups y cmo restaurarlos para proyectos de Bizagi que usen Microsoft SQL Server. Si su proyecto utiliza Oracle, consulte el artculo Export e Import de Oracle article.

Prerequisitos
Para crear un backup o restaurarlo, se requiere: 1. Tener instalado Microsoft SQL Server Management Studio para la conexin a la instancia de Base de datos (2005, 2008, 2008 R2). Mas informacin en enlaces externos de Microsoft: http://www.microsoft.com/en-us/download/ details.aspx?id=22985. 2. Tener instalada una misma versin e intercalacin (collation) de SQL en los Servidores involucrados (donde se va a restaurar el backup y de donde se obtuvo el backup).

Copyright 2013 - Bizagi

2085

Consideraciones adicionales
Si usted est migrando un proyecto en ambiente de desarrollo a un servidor diferente y desea conservar las instancias de Proceso (casos), tenga en cuenta que los adjuntos de estos casos no estarn dentro de la informacin del backup. Por lo tanto en el hipottico escenario en el que desee trasladar los casos de un ambiente de desarrollo, deber considerar mover tambin la ubicacin de stos (sea el Servidor BPM, un Servidor diferente de archivos, o un ECM).

Crear un Backup
Para crear un backup de su Base de datos: 1. Autentquese en su instancia de SQL Server (login) a travs de SQL Server Management Studio.

2086

Copyright 2013 - Bizagi

2. Ubique la Base de datos y de clic derecho sobre sta. Seleccione la opcin B acku p ... desde las tareas:

Copyright 2013 - Bizagi

2087

3. Especifque que el backup se realice completo (modo F ULL).

2088

Copyright 2013 - Bizagi

Ntese que debe seleccionar una ruta vlidad para almacenar el archivo resultante (.bak). Si no desea utilizar la ruta por defecto, puede navegar y seleccionar otro directorio. Si utiliza otro directorio, asegrese de contar con los permisos de escritura sobre l.

Copyright 2013 - Bizagi

2089

4. Haga clic en O K cuando la operacin se haya completado:

2090

Copyright 2013 - Bizagi

Restaurar un Backup
Antes de comenzar
Antes de restaurar un backup en una base de datos en uso, asegrese que no hayan conexiones activas (requisito de la restauracin). Si su proyecto est en Bizagi Enterprise .NET o Bizagi Xpress, tenga en cuenta que el servicio del Programador (Scheduler) muy probablemente tendr una conexin a la base de datos. Por lo tanto, deber previamente detener este servicio. Puede detener el Programador por medio de Bizagi Management Console:

Copyright 2013 - Bizagi

2091

Si su proyecto est en Bizagi Enterprise JEE, el Programdor debe detenerse desde el Servidor de aplicaciones JEE.

Restauracin
Una vez que garantice que no hay conexiones activas (la Base de datos donde se va a restaurar un backup no est en uso), restaure un backup con los siguientes pasos: 1. Autentquese en su instancia de SQL Server (login) a travs de SQL Server Management Studio.

2092

Copyright 2013 - Bizagi

2. Ubique la Base de datos y de clic derecho sobre sta. Seleccione la opcin de Restau rar -> B ase d e d ato s:

Copyright 2013 - Bizagi

2093

3. Especifique que la Base de datos ser restaurada desde un dispositivo. Navegue hasta seleccionar el archivo .bak de origen:

2094

Copyright 2013 - Bizagi

Copyright 2013 - Bizagi

2095

NOTA: Tenga en cuenta que SQL Server mantiene la compatibilidad hacia atrs. Esto significa que un backup de SQL 2005 o SQL 2008 puede restaurarse dentro de una instancia SQL 2008 R2, pero no en sentido contrario (un backup generado no podr restaurarse en una instancia con una versin menos reciente). 4. Marque el archivo con la opcin de Restau rar:

2096

Copyright 2013 - Bizagi

5. Vaya al tab de O p cio n es, y marque la opcin de Sobrescritura ( O v erw rite th e ex istin g d atab ase).

Copyright 2013 - Bizagi

2097

Asegrese de seleccionar el destino de los archivos usados por la Base de datos (.dat y .log).

2098

Copyright 2013 - Bizagi

Ntese que estos archivos se ubican por defecto en la siguiente ruta: "C:\Bizagi\[edicin_bizagi]\Projects\[su_proyecto]\Database\", si el Servidor de Base de datos es el mismo Servidor BPM (el proyecto usa una Base de datos local). En la ruta de la instancia SQL Server (por defecto "C:\Program Files (x86)\Microsoft SQL Server\[instancia]\MSSQL\Data\"), si el Servidor de Base de datos no es el mismo Servidor BPM. 6. Haga clic en O K cuando la operacin de restauracin se haya completado.

Copyright 2013 - Bizagi

2099

Nota: Despus de restaurar un backup en un proyecto de Bizagi que utilice IIS (Bizagi Enterprise .NET o Bizagi Xpress), se debe refrescar la memoria cach del servidor Web. Para ello, se recomienda ejecutar un IISReset.

7. Asegrese de iniciar de nuevo los servicios que haya detenido antes (ms especficamente, el servicio del Programador). Este paso aplica para Bizagi Enterprise .NET y Bizagi Xpress. Si su proyecto utiliza Bizagi Enterprise JEE, entonces al iniciar el Servidor de aplicaciones JEE, se

2100

Copyright 2013 - Bizagi

iniciar automticamente el Programador.

6.3.2

Export e Import en Oracle

Un requerimiento y una tarea administrativa frecuente, es tener la posibilidad de crear backups para una eventual restauracin a un estado anterior del proyecto Bizagi. Los backups en este tipo de tareas se crean principalmente como una medida de contingencia, o tambin para mover o copiar un proyecto en etapa de desarrollo. Todo esto es muy sencillo para la solucin Bizagi dado que es orientado al modelo.

Cuando se usa una Base de datos Oracle (aplica para las ediciones Enterprise), las tareas de crear backups y restaurarlos, se realizan a travs (y se mencionan como) de los utilitarios de Oracle de Import y Export. Nota La restauracin de backups debe usarse slo para mover una base de datos o como medida de contingencia para restaurar el estado anterior de un mismo ambiente. Es decir que un backup del ambiente de desarrollo slo debe ser restaurado en el ambiente de desarrollo. Para crear ambientes, se debe usar la funcionalidad del Deployment de Bizagi. En este artculo ilustramos cmo ejecutar el Export e Import de una base de datos Oracle de Bizagi. Si su proyecto utiliza SQL Server, consulte el artculo de Backups y su restauracin en SQL Server article.

Prerequisitos
Para usar los utilitarios Export o Import en Oracle, se requiere: 1. Tener instalado el cliente de Oracle donde se va a realizar el Export e Import. Se requiere que la versin del cliente sea igual a la versin instalada en el Servidor (incluyendo los bits soportados). Tenga en cuenta que en Bizagi, se soportan instancias Oracle 10g R2. 2. Tener ya sea los mismos set de caracteres, o unos sets compatibles (en los configurados en las mquinas clientes y en los servidores involucrados en el Export e Import). Debe asegurarse que los sets de caracteres configurados sean los mismos o compatibles en las mquinas involucradas. Esto es un requisito directamente el Export e Import de Oracle para mantener la integridad de la informacin. 3. No tener ms de una definicin activa del Oracle home. Esto significa que si tiene ms de un cliente Oracle instalado (de donde se va a ejecutar el Export o

Copyright 2013 - Bizagi

2101

Import), deber asegurrse de que la variable de entorno ORACLE_HOME est definida adecuadamente para apuntar al cliente de Oracle que utiliza Bizagi.

Consideraciones adicionales
Si usted est moviendo un proyecto en ambiente de desarrollo a un servidor diferente y desea conservar las instancias de Proceso (casos), tenga en cuenta que los adjuntos de estos casos no estarn dentro de la informacin del backup. Por lo tanto en el hipottico escenario en el que desee trasladar los casos de un ambiente de desarrollo, deber considerar mover tambin la ubicacin de stos (sea el Servidor BPM, un Servidor diferente de archivos, o un ECM).

Tambin se recomienda que el uso de Export e Import lo realice un usuario experimentado y con conocimiento del tema (por ejemplo un dba). Esto se debe a 3 razones principales: 1. El Export e Import se lleva a cabo con linea de comandos y especificacin de parmetros (los cuales son conocidos por un dba). 2. Se requiere en algn momento (de acuerdo a ciertas instrucciones), tener a la mano las credenciales de un esquema de usuario con privilegios (por ejemplo, el uso del usuario BizagiAdmon). 3. Despus de un Export o Import, se requiere revisar los logs de ejecucin de la operacin, y as determinar si hubo errores o advertencias que requieren de solucin inmediata. Por ejemplo, puede darse que en medio de una operacin de Import, los tablespaces se queden sin espacio. Este tipo de errores no detendrn la operacin, son ajenos a Bizagi, pero deben solucionarse de manera que la informacin no quede incompleta (se garantice integridad de los datos).

Nota Se requiere adems que el usuario BizagiAdmon ya se haya creado en la instancia de Oracle. Este es un requerimiento en s de la creacin de proyectos Bizagi sobre Oracle. Vea ms informacin acerca de la configuracin de Oracle para trabajar con Bizagi.

Ejecutar Export (exp)

Ilustraremos cmo utilizar el utilitario Export para crear un backup con la informacin de la Base de datos del proyecto Bizagi en un archivo dmp. Para utilizar el Export de Oracle, se llevan a cabo los siguientes pasos: 1. Abra una consola de comandos Vaya a Inicio de Windows, y ejecute una consola de comandos DOS:

2102

Copyright 2013 - Bizagi

Seguidamente, navegue hacie la ruta del cliente de Oracle, y dentro de la carpeta b in :

2. Ejecute el Export Para ejecutar el Export tenga en cuenta que debe usar parmetros. Para ello, ingrese la siguiente lnea: export %SCHEMA_USER_TO_EXPORT%/%SCHEMA_USER_PASSWORD%@%SERVICE_NAME% OWNER=

Copyright 2013 - Bizagi

2103

%SCHEMA_USER _TO_EXPORT% FILE=%EXPORT_FILE% LOG=%EXPORT_LOG% STATISTICS=none En el comando anterior, considere: %SCHEMA_USER_TO_EXPORT% es el nombre del proyecto en Bizagi. %SCHEMA_USER_PASSWORD% es la contrasea de este esquema de usuario (proyecto en Bizagi). %SERVICE_NAME% es el alias de su instancia de Base de datos. %EXPORT_FILE% es la ruta y archivo que se generar con el backup. Este archivo utiliza comnmente la extensin .dmp. %EXPORT_LOG% es la ruta y archivo que se generar con el log del backup. Este archivo utiliza comnmente la extensin .log.

Ntese que: este comando se ejecuta desde el usuario del esquema que vamos a respaldar, y que es requerido especificar el parmetro STA TISTICS= n o n e. 3. Revise el log Despus del Export, se debe revisar y/o resolver los errores no esperados en la operacin. Para hacerlo, revise detalladamente el log tal donde se especific su ruta en el paso anterior.

El log quedar segn la definicin de "%EXPORT_LOG%".

2104

Copyright 2013 - Bizagi

Nota Tenga en cuenta que el Export utilizar los sets de caracteres definidos en el cliente de Oracle. Por lo tanto, y como se mencion en los prerequisitos, se debe garantizar que sea un set de caracteres igual o compatible al del Servidor, y a los que se usen en el cliente y Servidor al momento de hacer un Import.

Ejecutar Import (imp)

Ilustraremos cmo utilizar el utilitario Import para restaurar un backup de la Base de datos del proyecto Bizagi. Estas instrucciones aplican cuando el backup se ha realizado con Export a un archivo dmp.

Nota Tenga en cuenta que este procedimiento no aplica si el backup se ha generado a travs del utilitario de Export de Datapump, o si Bizagi ha creado automticamente el backup (antes de un Deployment o de actualizar un proyecto). En estos escenarios, el backup se debe restaurar con el uso del Import de DataPump (descrito en la ltima seccin). Para utilizar el Import de Oracle, se llevan a cabo los siguientes pasos: 1. Asegrese de que no hayan conexiones activas Para restaurar un backup, se requiere que el esquema de usuario no se encuentre en uso. Tenga en cuenta que el servicio de Programador de Bizagi (Scheduler) muy posiblemente estar en un estatus de iniciado y por ende tendr conexiones abiertas. Si este es el caso, deber detener primero el Programador. 2. Elimine el esquema de usuario Para restaurar, primero eliminamos el esquema de usuario mismo que representa el proyecto. Para hacerlo, primero conctese a su instancia de Oracle con el usuario BizagiAdmon a travs de sqlplus: sqlplus BizagiAdmon/%BIZAGIADMON_USER_PASSWORD%@%DATABASE_SERVER%:% SERVICE_PORT%/%SERVICE_NAME% En este comando, considere: %BIZAGIADMON_USER_PASSWORD% es la contrasea del usuario BizagiAdmon. %DATABASE_SERVER% es el nombre del Servidor de la instancia de Oracle. %SERVICE_PORT% es el nmero del puerto sobre el cual el servicio atiende. %SERVICE_NAME% es el alias de la instancia de Oracle.

Copyright 2013 - Bizagi

2105

Seguidamente, ejecute el siguiente comando para eliminar el esquema de usuario en cascada (cascade): drop user %SCHEMA_USER_TO_IMPORT% cascade; Note que %SCHEMA_USER_TO_IMPORT% corresponde al nombre del proyecto.

3. Cree el esquema de usuario de nuevo Esta vez, creamos el esquema de usuario en blanco. Para ello, usamos un procedimiento almacenado de Bizagi. En la misma sesin que tenemos abierta, ejecute el procedimiento "spBA_ORA_CreateAppUser" de Bizagi: exec spBA_ORA_CreateAppUser('%SCHEMA_USER_TO_IMPORT%','% SCHEMA_USER_PASSWORD%');

Ntese que deberamos nombrar con el mismo nombre anterior al proyecto eliminado. Luego, desconctese de la sesin B izag iA d m o n en la instancia. 4. Abra una consola de comandos Vaya a Inicio de Windows, y ejecute una consola de comandos DOS:

2106

Copyright 2013 - Bizagi

Seguidamente, navegue hacie la ruta del cliente de Oracle, y dentro de la carpeta b in :

5. Ejecute el Import Para ejecutar el Import tenga en cuenta que debe usar parmetros. Para ello, ingrese la siguiente lnea:

Copyright 2013 - Bizagi

2107

import %SCHEMA_USER_TO_IMPORT%/%SCHEMA_USER_PASSWORD%@%SERVICE_NAME% FILE=% EXPORT_FILE% LOG=%IMPORT_LOG% STATISTICS=none FROMUSER=% SCHEMA_USER_TO_EXPORT% TOUSER=%SCHEMA_USER_TO_IMPORT% En el comando anterior, considere: %SCHEMA_USER_TO_EXPORT% es el nombre del esquema de usuario involucrado en el momento de haber generado el Export. %SCHEMA_USER_TO_IMPORT% es el nombre del proyecto de Bizagi (donde vamos a restaurar). %SCHEMA_USER_PASSWORD% es la contrasea de este esquema de usuario (el proyecto donde vamos a restaurar). %SERVICE_NAME% es el alias de la instancia de Oracle. %EXPORT_FILE% es la ruta y archivo donde se encuentra el backup (el .dmp creado con el Export). %IMPORT_LOG% es la ruta y archivo donde se generar el log de la operacin. Utiliza comnmente la extensin .log.

Ntese que: este comando se ejecuta desde el usuario del esquema del paso 3, y que es requerido especificar el parmetro STA TISTICS= n o n e. 6. Revise el log Despus del Import, se debe revisar y/o resolver los errores no esperados en la operacin (no deben haber errores en el import de una Base de datos en Bizagi). Para hacerlo, revise detalladamente el log tal donde se especific su ruta en el paso anterior.

El log quedar segn la definicin de "%IMPORT_LOG%". El Import debe finalizar notificando que no hubo advertencias si quiera, y que se han habilitado los constraints de Bizagi. Nota

2108

Copyright 2013 - Bizagi

Tenga en cuenta que el Import utilizar los sets de caracteres definidos en el cliente de Oracle. Por lo tanto, y como se mencion en los prerequisitos, se debe garantizar que sea un set de caracteres igual o compatible al del Servidor, y a los que se usaron en el cliente y Servidor al momento de hacer el Export.

7. Revise la metadata (check metadata) Para validar que la totalidad de los objetos y registros hayan sido importados, se recomienda utilizar la opcin de Bizagi para una revisin de la metadata. Esta opcin esta disponible desde Bizagi Management Console, a travs del botn ch eck m etad ata:

Ejecutar el Import de DataPump (impdp)

Ilustraremos cmo utilizar el utilitario Import de DataPump para restaurar un backup de la Base de datos del proyecto Bizagi. Estas instrucciones aplican cuando: El archivo dmp ha sido creado a travs del Export de DataPump (manualmente con el comando expdp). El archivo dmp ha sido creado automticamente por Bizagi. Esto lo realiza Bizagi en escenarios tales como: antes de un Deployment, o antes de una actualizacin de versin. Los dmp de backup que Bizagi crea de manera automtica, quedan ubicados en la ruta de backups configurada al momento de crear proyectos en Oracle (como prerequisito de configuracin de la instancia).

Copyright 2013 - Bizagi

2109

Nota Tenga en cuenta que este procedimiento no aplica si el backup se ha generado a travs del utilitario de Export exp. Si este es el escenario, el backup se debe restaurar con el uso del Import imp (descrito en la seccin previa). Para utilizar el Import de DataPump de Oracle, se llevan a cabo los siguientes pasos: 1. Asegrese de que no hayan conexiones activas Para restaurar un backup, se requiere que el esquema de usuario no se encuentre en uso. Tenga en cuenta que el servicio de Programador de Bizagi (Scheduler) muy posiblemente estar en un estatus de iniciado y por ende tendr conexiones abiertas. Si este es el caso, deber detener primero el Programador. 2. Elimine el esquema de usuario Para restaurar, primero eliminamos el esquema de usuario mismo que representa el proyecto. Para hacerlo, primero conctese a su instancia de Oracle con el usuario BizagiAdmon a travs de sqlplus: sqlplus BizagiAdmon/%BIZAGIADMON_USER_PASSWORD%@%DATABASE_SERVER%:% SERVICE_PORT%/%SERVICE_NAME% En este comando, considere: %BIZAGIADMON_USER_PASSWORD% es la contrasea del usuario BizagiAdmon. %DATABASE_SERVER% es el nombre del Servidor de la instancia de Oracle. %SERVICE_PORT% es el nmero del puerto sobre el cual el servicio atiende. %SERVICE_NAME% es el alias de la instancia de Oracle.

Seguidamente, ejecute el siguiente comando para eliminar el esquema de usuario en cascada (cascade): drop user %SCHEMA_USER_TO_IMPORT% cascade; Note que %SCHEMA_USER_TO_IMPORT% corresponde al nombre del proyecto.

2110

Copyright 2013 - Bizagi

3. Cree el esquema de usuario de nuevo Esta vez, creamos el esquema de usuario en blanco. Para ello, usamos un procedimiento almacenado de Bizagi. En la misma sesin que tenemos abierta, ejecute el procedimiento "spBA_ORA_CreateAppUser" de Bizagi: exec spBA_ORA_CreateAppUser('%SCHEMA_USER_TO_IMPORT%','% SCHEMA_USER_PASSWORD%');

Ntese que deberamos nombrar con el mismo nombre anterior al proyecto eliminado. 4. Consulte el directorio de backups Para utilizar el Import de DataPump, necesitar especificar el directorio donde se encuentra el archivo dmp del backup. Por lo tanto, puede optar por consultar los directorios creados para su instancia (y decidir si usar la ruta por defecto de backups definida en Bizagi o usar otra).

Copyright 2013 - Bizagi

2111

Si desea usar otro directorio y crearlo manualmente puede hacerlo mediante el comando a continuacin:

Luego de tener a la mano el nombre del directorio que va a utilizar, desconctese de la sesin B izag iA d m o n en la instancia.

5. Abra una consola de comandos Vaya a Inicio de Windows, y ejecute una consola de comandos DOS:

2112

Copyright 2013 - Bizagi

Seguidamente, navegue hacia la ruta del cliente de Oracle, y dentro de la carpeta b in :

6. Ejecute el Import de DataPump Para ejecutar el Import de DataPump tenga en cuenta que debe usar parmetros. Estos parmetros son completamente diferentes a los que se utilizaban en el Import imp.

Copyright 2013 - Bizagi

2113

Para ello, ingrese la siguiente lnea: impdp %SCHEMA_USER_TO_IMPORT%/%SCHEMA_USER_PASSWORD%@%SERVICE_NAME% REMAP_SCHEMA=%SCHEMA_USER_TO_EXPORT%:%SCHEMA_USER_TO_IMPORT% DIRECTORY=% BIZAGI_BACKUP_PATH% DUMPFILE=%EXPORT_FILE% LOGFILE=%IMPORT_LOG% En el comando anterior, considere: %SCHEMA_USER_TO_EXPORT% es el nombre del esquema de usuario involucrado en el momento de haber generado el Export. %SCHEMA_USER_TO_IMPORT% es el nombre del proyecto de Bizagi (donde vamos a restaurar). %SCHEMA_USER_PASSWORD% es la contrasea de este esquema de usuario (el proyecto donde vamos a restaurar). %SERVICE_NAME% es el alias de la instancia de Oracle. %BIZAGI_BACKUP_PATH% debe corresponder a "BizAgiBackupPath" por defecto, de acuerdo a lo mencionado en el paso #4 (este parmtero define la ubicacin del backup). %EXPORT_FILE% es la ruta y archivo donde se encuentra el backup (el .dmp creado con el Export). %IMPORT_LOG% es la ruta y archivo donde se generar el log de la operacin. Utiliza comnmente la extensin .log.

Ntese que: este comando se ejecuta desde el usuario del esquema del paso #3, y que es requerido especificar el parmetro STA TISTICS= n o n e. Para ver ms informacin acerca del Import o Export de DataPump (disponible en versiones de Oracle 10g), consulte enlaces externos de Oracle como: http://www.orafaq.com/wiki/Data_Pump.

7. Revise el log DataPump Despus del Import con DataPump, se debe revisar y/o resolver los errores no esperados en la operacin (no deben haber errrores en un import de Base de datos en Bizagi). Para hacerlo, revise detalladamente el log tal donde se especific su ruta en el paso anterior.

2114

Copyright 2013 - Bizagi

El log quedar segn la definicin de "%IMPORT_LOG%". El Import debe finalizar notificando que no hubo advertencias si quiera, y que se han habilitado los constraints de Bizagi. Nota Tenga en cuenta que el Import de DataPump utilizar los sets de caracteres definidos en el cliente de Oracle. Por lo tanto, y como se mencion en los prerequisitos, se debe garantizar que sea un set de caracteres igual o compatible al del Servidor, y a los que se usaron en el cliente y Servidor al momento de hacer el Export de DataPump.

8. Revise la metadata (check metadata) Para validar que la totalidad de los objetos y registros hayan sido importados, se recomienda utilizar la opcin de Bizagi para una revisin de la metadata. Esta opcin esta disponible desde Bizagi Management Console, a travs del botn ch eck m etad ata:

6.4

Copiar o reutilizar proyectos en Bizagi

A menudo podemos optar por reutilizar el diseo de los Procesos como punto de partida para otro proyecto de Bizagi (como una plantilla). En las etapas de construccin del proyecto, podemos reusar la implementacin de Procesos siempre

Copyright 2013 - Bizagi

2115

y cuando no hayan sido llevados ya a un ambiente Productivo.

Procedimiento
Bizagi como solucin orientada al modelo, permite fcilmente la reutilizacin de proyectos. Para ello, la implementacin de un proyecto en ambiente de desarrollo se puede copiar con los siguientes pasos: 1. Crear un backup de la Base de datos. 2. Crear el nuevo proyecto de Bizagi. 3. Restaurar el backup en la Base de datos del proyecto nuevo. De esta manera, tendr un nuevo proyecto que reusa el diseo de los Procesos en una Base de datos diferente, con su propio Portal de Trabajo y servicio Programador (Scheduler).

Informacin adicional
Para mayor informacin acerca de cmo crear backups y cmo restaurarlos, consulte los siguientes enlaces de acuerdo al motor de Base de datos de su proyecto: Backups y su restauracin en SQL Server. Export e Import de Oracle. Para mayor informacin sobre la creacin de un proyecto en Bizagi (paso #2), consulte crear un nuevo proyecto.

6.5

Management Console Introduccin

La consola de administracin de Bizagi (Management Console) es la aplicacin que se utiliza en Bizagi para la administracin de los proyectos en su ambiente de produccin o pruebas (para las tareas de mantenimiento como: seguimiento de trabajos programados, el posible cambio de un servidor SMTP para las notificaciones, habiliciones de log y trazas, o revisin de parmetros de conectividad con sistemas externos (integrados en la solucin), o administracin de licencias y montaje de un clster en el ambiente de produccin, entre otros. Bizagi Management Console se incluye automticamente el Servidor BPM al instalar Bizagi.

2116

Copyright 2013 - Bizagi

Para abrir Bizagi Management Console, acceda desde la ruta de instalacin del ejecutable (por defecto en "C:\Program Files (x86)\BizAgi\[edicin_bizagi]\MC\BizAgiMC.exe" o ejecute el acceso directo).

Interfaz de usuario
Al abrir Bizagi Management Console, la ventana incial provee atajos para las opciones ms usadas:

Copyright 2013 - Bizagi

2117

Entre ellas, es posible: Crear un proyecto nuevo. Abrir un proyecto existente. Administrar los proyectos registrados. Acceder a la documentacin y guas para comenzar a utilizar Bizagi. Instalar las plantillas disponibles de nuestra Central de Procesos. Administrar las licencias del ambiente de produccin. Estas opciones son las mismas que se presentan desde Bizagi Studio. Para mayor informacin acerca de las mismas, consulte la interfaz de usuario en Bizagi Studio.

Opciones de administracin
Al abrir el proyecto existente en el ambiente de pruebas o produccin, se podrn utilizar las siguientes opciones de administracin generales o de los mdulos.

Opciones generales
Las opciones generales se prentan desde la cinta de opciones en la aplicacin: Pestaa en la cinta Archivo Nuevo Opcin Descripcin Crea un nuevo proyecto

2118

Copyright 2013 - Bizagi

Abrir proyecto Proyectos

Abre un proyecto existente Permite administrar los proyectos registrados(para actualizarlos, desaciarlos, etc). Para mayor informacin, consulte proyecto registrados. Consulte las opciones del men en las secciones de abajo para las caractersticas de su proyecto. Ejecuta en Bizagi una validacin para detectar errores en la implementacin del proyecto. El diagnstico y las validaciones son especialmente tiles para validar la implementacin (reglas de negocio, modelo de datos, etc) de cara al Deployment de sus Procesos. Para mayor informacin sobre esta opcin, consulte la seccin inmediatamente abajo. Ensea las configuraciones y opciones de preferencias en el ambiente dado. Para mayor informacin, consulte la configuracin de Entorno. Permite habilitar o deshabilitar las diferentes trazas en la ejecucin de los Procesos. Para mayor informacin, consulte Diagnstico y control de errores. Elimina todos los casos existentes en el ambiente determinado (aplica solamente para pruebas o desarrollo). Permite cambiar la contrasea del super usuario Admon. Si la contrasea no se ha definido explcitamente, entonces ser por defecto en blanco.

Home

En esta pestaa se presentan opciones de rpido acceso segn el mdulo seleccionado.

Herramientas

Revisar Metadata

Configuracin

Entorno

Segimiento

Borrar casos

Contrasea de administracin

Copyright 2013 - Bizagi

2119

Ayuda

Ayuda

Presenta la opcin de descargar como PDF, o navegar nuestra documentacin oficial. Direcciona a nuestro sitio de soporte, donde se accede a la plataforma de tickets o a nuestros foros. Direcciona a nuestras plantillas de Proceso gratuitas de la Central de Procesos (para descarga e instalacin de Procesos). Direcciona a nuestros foros gratuitos de soporte. Comparte la informacin y funcionalidad de Bizagi con un amigo. Direcciona a las notas de la versin oficiales en nuestro sitio Web. Permite administrar su licencia de Bizagi. Para mayor informacin, consulte sobre Licencias. Ensea la versin actual de su proyecto en Bizagi.

Foros de Soporte

Central de Procesos

Comentarios

Contarle a un amigo

Notas de la versin

Administracin de licencias

Acerca de

Revisar metadata Revisar la metadata en un proyecto es una buena prctica en etapas de implementacin en el ambiente de desarrollo. Esto se debe a que con dicha opcin, se puede detectar de manera temprana cualquier error de modelamiento que el Deployment de Bizagi detecte en sus validaciones. Errores que se pueden detectar en la metadata involucran: La infomacin que define los datos del negocio (Entidades, Atributos, Hechos). La informacin que define todas las rutas posibles que puede tomar un caso de proceso (Procesos, Fases, Areas Funcionales, Tareas, Transiciones). Las reglas de negocio que definen la ruta que cada caso toma en cada actividad (Expresiones, Condiciones de Transicin, Reglas de Asignacin, Componentes, Interfases). Las acciones que se tomaron en cada actividad del proceso (Alarmas, Cartas, Notificaciones, Interfases). La informacin que define la estructura de la organizacin (Areas, Ubicaciones, Trabajos, Roles, Habilidades, Calendarios).

2120

Copyright 2013 - Bizagi

La informacin de la interfaz de usuario utilizada en cada actividad de proceso (Formas, Renders, Validaciones). La informacin que define los parmetros de negocio (Instancias de Entidades Paramtricas). En resumen, todo lo que define la manera en la que opera el negocio y describe los datos (pero no son los datos de casos en s). Para usar la opcin, haga clic en Rev isar m etad ata dentro de la pestaa de h erram ien tas:

Una nueva ventana mostrar los errores que se detecten.

Mdulos
Las opciones en los mdulos permiten tareas de administracin tales como: el Programador y sus trabajos, Sistemas externos, un ambiente en clster, configuracin en la seguridad y definicin de grupos de usuarios en la organizacin.

Copyright 2013 - Bizagi

2121

Programador Este mdulo presenta las opciones para administrar el Programador y sus trabajos. El Programador es un servicio creado en cada proyecto de Bizagi, el cual lleva a cabo ciertas tareas como: el envo de alarmas, activacin de temporizadores, la ejecucin de la Replicacin, ejecucin de trabajos personalizados y Actividades asncronas. Nota En Bizagi Enterprise JEE, el inicio del servicio Programador es controlado por el Servidor de aplicaciones JEE en si. Las opciones para iniciar, reiniciar o detener el Programdorfor Bizagi Enterprise .NET and Bizagi Xpress. Para mayor informacin, consulte la Administracin de trabajos programados. Sistemas Este mdulo presenta las opciones para revisar o reconfigurar los parmetros de conectividad con sistemas externos integrados a la solucin. Dentro de tales opciones encontramos: configuracin de Proveedores de datos usados en la Replicacin y Virtualizacin, interfaces usadas en invocacin de servicios Web o REST, y configuracin de repositorios ECM. Para mayor informacin sobre estas opciones, consulte Administracin de sistemas externos. Administracin de sistemas externos.

2122

Copyright 2013 - Bizagi

Organizacin Este mdulo presenta las opciones para administrar los grupos de usuario o el esquema de tiempo de trabajo. Esquema de tiempo de trabajo: Con esta opcin disponible desde el item de Organizacin, se mostrar el asistente para configurar el horario y dias de trabajo y de festivos. Ms opciones sobre la definicin de la organizacin se deben editar desde Bizagi Studio y llevadas al ambiente de produccin mediante el Deployment. Grupos de usuario: A travs de esta opcin, se puede incluir o excluir usuarios dentro de los grupos de usuario predefinidos en el proyecto. De requerirse nuevos grupos de usuario, o la redefinicin de los existentes, se debe hacer en el ambiente de desarrollo con Bizagi Studio.

Cualquier cambio en este mdulo que se realice directamente en el ambiente de produccin, no ser aplicar en el ambiente de desarrollo. Se recomienda que estos cambios estn sincronizados, realizndolos en el ambiente de desarrollo y llevndolos a los dems ambientes por medio del Deployment. Seguridad Este mdulo presenta las opciones en la configuracin de Autenticacin, Autorizacin e importar usuarios LDAP. Desde el primer Deployment, la configuracin de estos elementos definida desde Bizagi Studio aplicar en produccin. A partir de ese momento, en el ambiente de desarrollo esta configuracin ser a modo de lectura. Cualquier cambio en la Autenticacin o en la importacin de usuarios LDAP deber hacerse por separado en cada ambiente (mediante estas opciones del Management Console). Cualquier cambio directamente para las Autorizaciones, si deben hacerse en el ambiente de desarrollo y ser actualizadas en los dems ambientes mediante el Deployment. Administracin de Servidores Este mdulo se presenta nicamente en el ambiente de produccin.

Copyright 2013 - Bizagi

2123

Provee la posibilidad de utilizar opciones como: adicionar nuevos nodos a un ambiente en clster, mover el Servidor de produccin (con licencias y adjuntos). Para mayor informacin, consulte la Administracin de servidores.

6.5.1

Administracin de trabajos programados

En Bizagi Management Console, se puede usar el mdulo del Programador (Scheduler) para la administracin de los trabajos que el servicio mismo del Programador ejecuta. Las siguientes opciones se presentan para este servicio y sus trabajos.

Estatus del Programador

El color del cono del programados indicar el estatus del servicio (gris cuando est detenido, ocre cuando est iniciado). Puede iniciar, reiniciar o detener el servicio directamente desde stas opciones. Para hacerlo, de clic derecho sobre el cono del Programador y seleccione la accin. La accin tambien aparece disponibles desde la cinta en las opciones del men principal.

El Programador debe estar en estatus de iniciado para ejecutar cualquier trabajo programado.

2124

Copyright 2013 - Bizagi

Administracin de trabajos programados

Los trabajos programados se dividen como se describen en la tabla presentada a continuacin: Tipo de trabajo programado Trabajos de usuario Descripcin Los Trabajos de Usuario son un conjunto de pasos personalizados que pueden ser ejecutados de acuerdo a una programacin. Por ejemplo, una regla de negocio que debe ejecutarse una vez en una fecha especfica, o que debe ejecutarse peridicamente durante un intervalo de tiempo dado. Bizagi ejecuta ciertas tareas automticas para asegurar un correcto funcionamiento del sistema. Esta categora almacena los trabajos relacionados a tareas de manetenimiento. Se recomendienda NO manipular estos trabajos, ya que la informacin se presenta exclusivamente para seguimiento.

Trabajos de sistema

Copyright 2013 - Bizagi

2125

Trabajos de espera

En los trabajos en espera usted puede ver el estado de los trabajos programados que estan relacionados al BPMN de los Procesos tales como: temporizadores o Actividades Asncronas. Las Alarmas son notificaciones automticas que se envan a diferentes usuarios, de acuerdo a criterios relacionados a tiempos. Por ejemplo, cuando una Actividad esta prxima a vencerse, se vence o ya ha vencido.

Alarmas

Ntese que independientemente de la clasificacin de la tabla, los trabajos se presentan discriminados en 2 listas: aquellos que estn a la espera de sus ejecucin, y aquellos que ya han sido ejecutados exitosamente.

Administracin y reintentos de trabajos en espera

Los trabajos en espera pueden ser administrados tanto para su revisin, como para habilitarlos para una ejecucin inmediatamente. Nota Si algn trabajo en espera falla (o la transaccin completa hace rollbak ms adelante por otra razn), entonces el trabajo ser listado nuevamente como un trabajo en espera. Dentro de estas opciones tambin es posible revisar el log de la ejecucin del trabajo. Para revisar un trabajo, haga doble-clic sobre l:

2126

Copyright 2013 - Bizagi

Opcin Agendas de la tarea

Descripcin En esta pestaa se presentan la planeacin de los pasos y trabajos. En esta pestaa se listan los registros y log de las ejecuciones previas que ha tenido el trabajo. Este botn posibilita reactivar un trabajo, para que ste quede nuevamente programado para una ejecucin inmediata.

Logs de ejecucin

Habilitar para ejecucin

Administracin de Esquemas de Replicacin

You may manage and reconfigure the schedules set for Replication in your project. Within these options you may also disable the scheduled execution.

Copyright 2013 - Bizagi

2127

Consola de administracin de Replicacin

A travs de la Consola de administracin de Replicacin es posible realizar tareas de seguimiento a la Replicacin, por ejemplo reactivar su programacin para una ejecucin inmediata. Dentro de esta consola se presentan las siguientes opciones:

Opcin Logs de Replicacin

Descripcin En esta pestaa se listan el log y registro de las ejecuciones de la Replicacin.

2128

Copyright 2013 - Bizagi

Programar ahora

Este botn posibilita reactivar la programacin de la Replicacin, para que esta quede nuevamente programada para una ejecucin inmediata.

Propiedades de la programacin de Replicacin

Para revisar o editar la configuracin programada para una Replicacin, acceda a las propiedades de la misma desde el clic derecho del esquema de Replicacin. La siguiente ventana mostrar las propiedades:

Por la configuracin presentada en esta pestaa, defina la periodicidad y frecuencia de ejecucin de acuerdo a la siguiente tabla:

Opciones del programador Habilitar programador para la replicacin

Descripcin Marque esta opcin en Bizagi para ejecutar los datos de la replicacin desde la fuente de datos

Copyright 2013 - Bizagi

2129

externa. Periodicidad Marque, diario, semanal o mensual para definir con que frecuencia Bizagi ejecutar el esquema de Replicacin. Esta opcin cambiara de acuerdo a la opcin seleccionada en Periodicidad. Cuando se selecciona Diario: ingrese el nmero de das para realizar la repeticin. Cuando se selecciona semanal: ingrese el nmero de semanas para realizar la repeticin. Tambin seleccione en que da de la semana se debe ejecutar el esquema. Cuando se selecciona mensual: ingrese el nmero de meses para realizar la repeticin. Tambin seleccione en que da del mes se debe ejecutar el esquema. Defina si la ejecucin ocurre una vez al da (y en que hora), o si se debe ejecutar cada cierto tiempo (horas, minutos). Configure la fecha inicial para que el esquema comience la ejecucin.

Cada [...] da(s)

Frecuencia diaria

Fecha de inicio

Descripcin de las propiedades del programador

6.5.2

Administracin de Servidores y Clsters

Introduccin
Bizagi ofrece una consola administrativa llamada Management Console, la cual permite realizar tareas administrativas en cualquier ambiente del proyecto (Desarrolllo, produccin o pruebas). Dentro de estas tareas administrativas, hay un mdulo de administracin de servidores el cual permite administrar la infraestructura especfica del ambiente de produccin. Dentro de estas opciones encontramos: la configuracin de un clster para el Servidor BPM, la migracin del mismo (mover el Servidor BPM), la posibilidad de recrear el ambiente a partir de una base de datos (el Portal de Trabajo y el servicio Programador).

Montar la solucin en un clster est soportado en la edicin Bizagi Enterprise JEE, sin embargo los pasos que se llevan a cabo para dicha edicin difieren a los presentados en este documento (que aplican para la edicin Enterprise .NET). Si usted est utilizando la edicin Bizagi Enterprise JEE y desea montar su solucin en clster, consulte Clsters en la edicin Enterprise JEE.

Algunas opciones a continuacin aplican slamente para la edicin Bizagi Enterprise .NET. Las opciones que no estn disponibles para Bizagi Xpress, son principalmente aquellas que estn orientadas a los entornos corporativos donde se requiera establecer un esquema de misin crtica

2130

Copyright 2013 - Bizagi

(p.e el montaje de clsters para el Servidor BPM: el Portal de Trabajo y el servicio Programador).

Antes de iniciar
Por defecto, Bizagi se podr configurar para utilizar las capacidades de balanceo de carga del sistema operativo (p.e Network Load Balancing para Servidores Windows). Sin embargo, se soporta utilizar cualquier Balanceador de cargas a nivel de Hardware (recomendado para ambientes de alta disponibilidad y misin crtica). Para configurar el clster en Bizagi, se debe: 1. Llevar a cabo los pasos desde la Consola Administrativa (como se describen en este artculo). Mediante estos, se define en Bizagi los nodos que hacen parte de la solucin, y se permitir que compartan la informacin de la licencia activa. 2. Asegurarse de contar con un Balanceador de cargas. ste se debe configurar para que considere los nodos de la solucin (en este paso se define el balanceo como una tarea externa a Bizagi). Este paso vara de acuerdo al Balanceador de cargas utilizado (este artculo no entrar en este detalle) .

Prerequisitos
Para utilizar cualquiera de las opciones descritas a continuacin (incluye el paso #1 mencionado en la seccin anterior), asegrese de: 1. Tener credenciales autorizadas para acceder a los Servidores involucrados en los procedimientos especfcos. Esto significa, tener a la mano una cuenta de acceso de los servidores que estn tanto dentro del grupo Administrador, como del grupo Bizagi. Para mayor informacin sobre la configuracin de autorizacin requerida en servidores remotos, consulte Autorizacin para trabajar en un servidor remoto. Autorizacin para trabajar en un servidor remoto. 2. Tener la informacin relacionada a sus licencias activas (para casos donde se mueva esta informacin de las licencias). Esto significa que para opciones donde se migre el servidor de produccin, debe validar que la informacin sobre las licencias sea correcta. Otras consideraciones adicionales al realizar operaciones que involucren licencias son: El nuevo servidor no debe tener ya otra licencia activa. El servidor desde donde se mueve una licencia, debe tener acceso a internet (especficamente a www.bizagi.com). El nuevo servidor debe cumplir con los requerimiento tcnicos, tal como el Servidor de produccin.

Mdulo de administracin de Servidores

Este mdulo est disponible en el Management Console para ambientes de produccin. Las opciones descritas a continuacin varan ligeramente dependiendo de si se maneja un ambiente en

Copyright 2013 - Bizagi

2131

clster o no.

Opciones para clsters

En proyectos de Bizagi donde se esperan una gran cantidad de usuarios concurrentes, y un alto nmero de solicitudes en el Portal de Trabajo, Bizagi ofrece la posibilidad de configurar el Servidor BPM como un clster. Esto es una medida de escalamiento horizontal que permite mejorar la disponibilidad y el rendimiento de la solucin BPM, dado que permite agregar cualquier nmero adicional de nodos dentro del clster (para as lograr balanceo de carga). De acuerdo a lo anterior, Bizagi manejar automticamente las licencias que estn activas en el Servidor. Nota El ambiente de produccin seguir teniendo lgicamente un Servidor principal (el que se lista de primero en la lista de Servidores). A este Servidor principal se le hace referencia como el Nodo maestro.

2132

Copyright 2013 - Bizagi

Para configurar un clster, registramos nodos adicionales al Servidor BPM actual utilizando las opciones de A d m in . Serv id o res. Para ello, se requiere: 1. Previamente haber hecho un Deployment desde el ambiente de desarrollo al de produccin. De esta manera, en el Deployment se habr definido cul es el Servidor BPM de produccin principal (el Nodo maestro). Para mayor informacin, consulte el Deployment de Bizagi. 2. Adicionar servidores como nodos nuevos dentro de la configuracin de produccin. Este paso se debe hacer para cada nodo que se desee adicionar. Ntese que en cualquier momento se podr eliminar un nodo del ambiente en clster.

Adicionar un Servidor Para adicionar un nuevo Servidor, primero asegrese de tener instalado Bizagi Enterprise, en una mquina la cual tenga acceso al servidor que se va a adicionar, y al servidor que es el Nodo maestro.

Copyright 2013 - Bizagi

2133

Nota Tenga en cuenta que debe instalar la misma versin de Bizagi que est usando actualmente su ambiente de produccin. Abra Bizagi Management Console y seleccione la opcin de A b rir p ro y ecto ex isten te desde la ventana inicial. Seleccione el servidor local en la lista desplegable, y luego seleccione el nombre del proyecto en produccin. Haga clic en F in alizar para abrir el proyecto.

Para cada nodo que se desee agregar, siga los siguientes pasos: 1. Haga click en la opcin de A d ico n ar serv id o r. Esta opcin se encuentra como un botn en la cinta del men principal, o desde las opciones del clic derecho sobre el Nodo maestro.

2134

Copyright 2013 - Bizagi

De manera similar a las opciones presentadas en la configuracin de un Deployment, una ventana ensear la lista de servidores en la red los cuales cuentan con Bizagi instalado. 2. Seleccione el servidor nuevo que se incluir como nodo y haga clic en Sig u ien te. Si su servidor no aparece listado a pesar de que exista la conexin a l, puede optar por digitar el nombre del servidor (en la opcin de In g resar u n n u ev o serv id o r). Nota Tambin es posible ingresar directamente la direccin IP (en vez del nombre), sin embargo tenga en cuenta que debe ser una IP no dinmica. En otras palabras, los servidores configurados en Bizagi no deben tener una IP variable dado que son referenciados por el Deployment.

Copyright 2013 - Bizagi

2135

Recuerde que si la cuenta de Windows con la que inici el Management Console no es la autorizada en el Servidor objetivo, entonces deber proporcionar unas credenciales autorizadas para el registro del nuevo nodo (como se describe en los Prerequisitos).

Asegrese de entender y confirmar que est de acuerdo con el concepto que involucra la adicin de un nuevo nodo dentro del clster.

2136

Copyright 2013 - Bizagi

3. Especifique si desea crear un servicio adicional tambin del Programador en dicha mquina. Ntese que esto es opcional, y por lo tanto se puede optar por balancear la carga del Programador tambin, especialmente si sus Procesos utilizan muchos trabajos programados o ciertos trabajos en lote que sean de alta demora y exigencia en el procesamiento.

Nota Los trabajos en lote y programados representarn principalmente la ejecucin de Actividades Asncronas, la sincronizacin de la Replicacin, Trabajos personalizados, y sincronizacin con LDAP, entre otros.

Copyright 2013 - Bizagi

2137

Haga clic en Sig u ien te para continuar. Al finalizar, Bizagi mostrar la confirmacin del xito en la operacin. De ocurrir algn error, ser enseado en esta ventana.

2138

Copyright 2013 - Bizagi

Haga clic en F in alizar. En la lista de Servidores, se podr apreciar el nuevo nodo registrado (el refresco de esta vista puede tardar unos segundos).

Copyright 2013 - Bizagi

2139

Eliminar un Servidor Esta opcin permite remover el registro de un nodo asociado a una configuracin en clster. Esta opcin es til cuando: 1. Se desea dejar de usar un servidor dado, dentro de un esquema de balanceo de cargas al Servidor BPM. 2. Se desea cambiar el nodo (usar otro servidor para este propsito). Para ello, se debe eliminar el nodo registrado, y luego registrar el nuevo nodo (mediante la opcin de A d icio n ar n u ev o serv id o r, como se describe en la seccin anterior).

Nota Si desea mover su Nodo maestro, de manera que no desea utilizar el actual y desea usar otr Servidor, use la opcin de M o v er N o d o m aestro . Dicha opcin funciona de manera similar a la que se describe acerca de M o v er u n Serv id o r, en la seccin ms abajo. Para remover un servidor registrado en la configuracin del clster, primero asegrese de tener instalado Bizagi Enterprise, en una mquina la cual tenga acceso al servidor que se va a eliminar, y al servidor que es el Nodo maestro.

2140

Copyright 2013 - Bizagi

Nota Tenga en cuenta que debe instalar la misma versin de Bizagi que est usando actualmente su ambiente de produccin.

Abra Bizagi Management Console y seleccione la opcin de A b rir p ro y ecto ex isten te desde la ventana inicial. Seleccione el servidor local en la lista desplegable, y luego seleccione el nombre del proyecto en produccin. Haga clic en F in alizar para abrir el proyecto.

Copyright 2013 - Bizagi

2141

Luego, ubique el servidor y desde sus opciones del clic derecho, seleccione la opcin de Elim in ar serv id o r. Ntese que esta opcin elimina el Portal de Trabajo y/o servicio de Programador. Por lo tanto, si desea eliminar ambos, deber hacerlo para cada uno de los dos componentes.

2142

Copyright 2013 - Bizagi

Confirme esta accin.

Nota Esta opcin no elimina archivos del servidor. Por lo tanto, tenga en cuenta que el servidor tendr localmente la informacin pertinente a cuando haca parte del clster.

Mover un Servidor (aplica tambin a Mover un Nodo maestro)

Esta opcin permite migrar el servidor BPM a uno diferente. Mediante esta, Bizagi crear automticamente el Portal de Trabajo y el servicio Programador en un servidor diferente, y mover igualmente la licencia activada. Nota Esta opcin no mueve la Base de datos en s. Si desea migrar la Base de datos a un nuevo Servidor, debe hacer esto mediante la restauracin de un backup. Para ver ms informacin al respecto, consulte los artculos segn su motor de Base de datos: Backups y su restauracin en SQL Server, o Export e Import en Oracle. Cuando se tiene una configuracin de clster para el Servidor BPM (ms de un nodo para el Portal de Trabajo), se visualiza la opcin de M o v er el N o d o m aestro .

Copyright 2013 - Bizagi

2143

Se recomienda realizar este procedimiento en un horario no laboral, principalmente porque con dicho procedimiento se reincian los servicios en el Servidor. Para migrar el ambiente de produccin a un servidor BPM diferente, los siguientes pasos se llevan a cabo:

1. Instale Bizagi en una mquina con acceso en red. Instale Bizagi Enterprise .NET en una mquina la cual tenga acceso al servidor que se va a mover, y al servidor que ser el nuevo Servidor. Nte que si la configuracin del Servidor BPM usa clster, esto implica que la mquina tenga acceso al Nodo maestro y los dems nodos.

Nota Tenga en cuenta que debe instalar la misma versin de Bizagi que est usando actualmente su ambiente de produccin.

2. Abra el proyecto desde el Management Console. Abra Bizagi Management Console y seleccione la opcin de A b rir p ro y ecto ex isten te desde la ventana

2144

Copyright 2013 - Bizagi

inicial. Seleccione el servidor local en la lista desplegable, y luego seleccione el nombre del proyecto en produccin. Haga clic en F in alizar para abrir el proyecto.

3. Use la opcin de Mover Servidor. Desde el mdulo de A d m in istraci n d e Serv id o res, ubique el servidor y haga clic derecho sobre l. Seleccione la opcin de M o v er Serv id o r.

Copyright 2013 - Bizagi

2145

Tenga en cuenta que este procedimiento tambin mueve la licencia activada en el Servidor BPM, y por lo tanto Bizagi ensear esta informacin involucrada en la migracin.

2146

Copyright 2013 - Bizagi

Haga clic en Sig u ien te para continuar.

Revise y asegrese de acordar con el procedimiento que se va a realizar. Haga clic en Sig u ien te para continuar.

4. Seleccione el Servidor destino. Seleccione el Servidor BPM de la lista de Servidores que cuentan con Bizagi instalado. Si su servidor no aparece listado a pesar de que exista la conexin a l, puede optar por digitar el nombre del servidor (en la opcin de In g resar u n n u ev o serv id o r). Nota Tambin es posible ingresar directamente la direccin IP (en vez del nombre), sin embargo tenga en cuenta que debe ser una IP no dinmica. En otras palabras, los servidores configurados en Bizagi no deben tener una IP variable dado que son referenciados por el Deployment.

Copyright 2013 - Bizagi

2147

Recuerde que si la cuenta de Windows con la que inici el Management Console no es la autorizada en el Servidor objetivo, entonces deber proporcionar unas credenciales autorizadas para el registro del nuevo nodo (como se describe en los Prerequisitos).

Una vez que el procedimiento haya finalizado, la licencia activa, el Portal de Trabajo, el servicio Programador y los adjuntos de casos existentes (documentos en el servidor BPM), sern eliminados del servidor anterior, y sern movidos hacia el nuevo servidor.

2148

Copyright 2013 - Bizagi

Finalice dando clic en Cerrar.

Recrear desde Base de datos

Esta opcin permite crear de nuevo un ambiente a partir de una base de datos existente. Con ella, Bizagi crear de manera automtica el Portal de Trabajo y el servicio Programador en un servidor. Esta opcin es til especialmente cuando hubo un factor externo que imposibilita el uso o recuperacin de configuracin de los componentes Programador y Portal de Trabajo. Ntese que esta opcin no activa de manera automtica una licencia que posiblemente haya tenido el servidor anterior. Por lo tanto, es recomendado que tenga a la mano la informacin sobre sus licencias si desea activar su ambiente de produccin. Contacte nuestra rea de soporte si tiene dudas al respecto. Para usar la opcin de recrear desde Base de datos, siga estos pasos: 1. Instale Bizagi en una mquina con acceso en red. Instale Bizagi Enterprise .NET en una mquina la cual tenga acceso al servidor que se va a mover, y al servidor que ser el nuevo Servidor. Nte que si la configuracin del Servidor BPM usa clster, esto implica que la mquina tenga acceso al Nodo maestro y los dems nodos.

Copyright 2013 - Bizagi

2149

Nota Tenga en cuenta que debe instalar la misma versin de Bizagi que est usando actualmente su ambiente de produccin.

2. Abra Bizagi Management Console Abra Bizagi Management Console y en la primera ventana de bienvenida, seleccione la opcin de P ro y ecto s.

2150

Copyright 2013 - Bizagi

3. Use la opcin de Recrear desde Base de datos. De clic en la opcin sobre la mano izquierda, identificada con el cono de una Base de datos:

Copyright 2013 - Bizagi

2151

Bizagi iniciar un asistente para este procedimiento. Ingrese el detalle de la conexin a la Base de datos existente.

2152

Copyright 2013 - Bizagi

En esta ventana, ingrese la siguiente informacin (de manera similar a cuando se crea un nuevo proyecto): Si utiliza una Base de datos SQL Server: Servidor: El nombre de la Base de Datos que contiene la instancia del Servidor SQL. Base de Datos: El nombre de su proyecto. Bizagi crear una Base de Datos con su nombre. Nombre de Usuario: Una cuenta de usuario para acceder a la instancia del Sevidor SQL. Contrasea: La contrasea para el nombre de usuario especificado. Si utiliza una Base de datos Oracle: Servicio: Acceso a su instancia de Oracle especificado como "servidorBaseDatos:puerto/ nombreServicio". Contrasea: Contrasea para el usuario BizagiAdmon. Ingrese la siguiente informacin sobre el esquema existente (Base de datos): Usuario: El nombre del esquema de usuario existente. Contrasea: Contrasea para el esquema de usuario existente. Confirmar contrasea: Confirme la misma contrasea anterior. Haga clic en Sig u ien te para iniciar con el procedimiento. Asegrese de confirmar el inicio del mismo.

Copyright 2013 - Bizagi

2153

Nota Recuerde que requiere de una cuenta autorizada en el servidor de destino, ya que Bizagi crea de manera automtica los componentes: Portal de Trabajo y servicio Programador.

Bizagi mostrar un mensaje al finalizar la operacin. Haga clic en F in alizar. 6.5.2.1 Clsters en la edicin Enterprise JEE

Introduccin
La edicin Enterprise JEE de Bizagi soporta la configuracin de un ambiente en clster, para montar Servidores BPM con balanceo de cargas. Para configurar un esquema de alta disponibilidad de su ambiente de produccin, en torno a los Servidores de Aplicacin JEE (incluir nodos a la solucin), slo se necesita: 1. Configurar los nodos del Servidor de Aplicaciones JEE (WebSphere, Weblogic o JBoss). Para ms informacin, consulte Configurar un Servidor de Aplicaciones JEE para trabajar con Bizagi. 2. Asegurarse que su licencia soporte las activaciones que implican los nodos adicionales. Contctenos si usted tiene dudas sobre su licencia actual de la edicin Enterprise JEE.

2154

Copyright 2013 - Bizagi

Procedimiento
Una vez que haya configurado las instancias del Servidor de Aplicaciones, activar las licencias de su ambiente en clster, se lleva a cabo activando la misma licencia en cada uno de sus nodos (esto significa en cada uno de los Servidores que tienen una instancia del Servidor de Aplicaciones JEE). Para activar estas licencias en cada nodo, siga el procedimiento estndar de activacin de licencias como se describe en Activar licencias para la edicin Enterprise JEE.

6.6

Configuracin de entorno
La Configuracin de Entorno determina la forma en la que se configura el envo de correos, scheduler y autenticacin. Esta opcin se encuentra en la pestaa de Configuracin en el men estndar de Bizagi Studio.

La configuracin de entorno posee tres opciones: Popular Avanzado Personalizado

Copyright 2013 - Bizagi

2155

Nota Antes del el primer deployment, la configuracin de TODOS los ambientes puede ser realizada en el ambiente de desarollo en Bizagi Studio. El primer deployment se llevar esta configuracin a cada ambiente. A partir de ese momento los cambios son locales, es decir son independientes para cada ambiente, desde el Management Console. Si desea que los cambios sean permanentes y sean parte del diseo del proceso, realice igualmente el cambio en el ambiente de desarrollo.

Popular
Desde esta opcin usted puede configurar los parmetros para envo de correo electrnico en cada ambiente (desarrollo, Test, produccin)

2156

Copyright 2013 - Bizagi

Los parmetros para configurar son OPCIN Habilitar Email DESCRIPCIN Habilita o deshabilita el envo de correos automticos. Si se habilita, se enviarn correos electrnicos. De lo contrario, los correos electrnicos se ignorarn. Define el nombre del servidor SMTP. El SMTP puede ser local (localhost) para propsitos de prueba en el ambiente de desarrollo. Para los ambientes de pruebas y produccin el servidor debe ser el servidor de la compaa desde donde se envan los correos electrnicos. Define la cuenta SMTP (o direccin) utilizada para el envo de correos electrnicos. Debe ser una direccin de correo vlida en el servidor SMTP. Si se utiliza un servidor local (localhost) la direccin de correo electrnico puede ser una que no vlida. Si se utiliza el servidor SMTP real, las direcciones deben pertenecer al dominio. Enviar copia de Define una cuenta de correo electrnico a la cual se enviarn las copias de

Servidor SMTP

Cuenta de Servidor SMTP

Copyright 2013 - Bizagi

2157

OPCIN Email a Enviar copia Oculta a

DESCRIPCIN todos los correos enviados por la aplicacin. Define una cuenta de correo electrnico a la cual ser enviada una copia OCULTA de todos los correos enviados por la aplicacin.

Avanzado
Desde esta opcin usted puede configurar los parmetros de caractersticas avanzadas, para cada ambiente (desarrollo, pruebas, produccin).

Los parmetros que pueden ser configurados son: OPCIN OPCIONES DE SCHEDULER Intervalo Configura el intervalo (en horas, minutos y segundos), para cuan DESCRIPCIN

2158

Copyright 2013 - Bizagi

OPCIN

DESCRIPCIN frecuente el servicio de Scheduler monitorear para ver si hay trabajos pendientes.

OPCIONES DE UPLOAD Directorio de Upload Define el directorio fsico donde los archivos subidos por el cliente se almacenan. El directorio por defecto en Bizagi Enteprise .NET y Bizagi Xpress es: C:\B izA g i\[B izag i ed itio n ]\P ro jects\[P ro ject n am e]\Do cs La ruta por defecto en Bizagi Enteprise JEE es el directorio ./ B izA g iDo cs ubicado en el home del usuario (p.e. C:\Users\[user] \BizAgiDocs en Windows). Tenga presente que [user] corresponde al usuario que inicia el Servicio del Servidor de Aplicaciones (p.e, usuario root en Linux). Define el tamao mximo que puede tener un archivo para ser subido a la aplicacin Bizagi (bytes).

Tamao mximo de Upload

OPCIONES SOA Forzar llave de negocio de SOA La opcin de deshabilitar esta configuracin, aplica para las ediciones Bizagi Xpress y Enterprise .NET. Si est marcado, Bizagi mostrar una excepcin para la actualizacin de registros por medio de la Capa SOA cuando se intente registrar una llave de negocio apuntando a una entidad paramtrica, cuyo valor no exista en Bizagi. Si no est marcado el valor que no exista quedar en nulo.

OPCIONES DE LOG Habilitar registro de Jobs Permite el registro de la informacin en todos los trabajos en ejecucin. Permite el registro de informacin en las entidades. Si est habilitado, Bizagi crea un registro en la base de datos (Attriblog) con cualquier cambio (relacionar o des-relacionar) relaciones M-M (mltiple-a-mltiple)

Habilitar registro Entidades Habilitar registro de relaciones M-M

OPCIONES DE ENTIDAD (1) Lmite mximo de longitud de Atributo Y (2) Lmite de instancias de Entidades Las Entidades Paramtricas en el Portal de Trabajo se manejan en cach si el nmero de atributos es menor que el primer parmetro y el nmero de registros es menor que el segundo parmetro. Las Entidades Paramtricas que tengan ms atributos o ms registros que los umbrales se cargarn por la demanda (acceso a la base de datos). Estos parmetros se usan para afinar el rendimiento de la aplicacin cuando hay un gran volumen de datos.

Copyright 2013 - Bizagi

2159

OPCIN OPCIONES DE INTERFAZ DE SERVICIOS WEB Tiempo de Espera

DESCRIPCIN

Sirve para configurar un TimeOut para los WebServices sincrnicos. Si el valor especificado es menor o igual a cero, se ignorar, comportndose por defecto: el llamado espera una respuesta con xito o con error, sin importar el tiempo que tome. Dado que esto puede generar bloqueos y se sugiere configurar un valor. Threshold time in seconds to log interfaces that last more than this time.

Umbral para registro

OPCIONES DE NOTIFICACIN DE ANULACIN Deshabilitar notificaciones de anulacin Si se selecciona desactiva la notificacin de los casos que sean anulados. Estas notificaciones se envan a todas las personas que tengan tareas pendientes en el caso en cuestin.

ALMACENAMIENTO DE DATOS OPERACIONALES ODS ODS es un mecanismo diseado para mejorar el rendimiento y disponibilidad del servidor de sus aplicaciones Bizagi Configuracin del uso de la conexin ODS para el proyecto Para ms informacin dirgase Configuracin ODS

Tipo de Proveedor

Personalizado
Desde esta opcin usted puede agregar, editar y borrar los diferentes parmetros del proyecto para cada ambiente (desarrollo, pruebas, produccin).

2160

Copyright 2013 - Bizagi

Para agregar nuevos parmetros, d clic en el signo ms (+). Se abrir una nueva ventana. Defina el nombre, valor y descripcin del parmetro. El botn Editar mostrar la misma ventana de creacin, pero con la informacin cargada del parmetro seleccionado. Seleccionando un parmetro y dando clic en el icono de X, eliminar el parmetro. Los parmetros personalizados se pueden utilizar en una expresin de scripting de la siguiente manera:

CHelper.getParameterValue("PARAMETER_NAME") ;
Si usted crea un parmetro personalizado llamado LOGOSPATH, usted puede utilizarlo en una expresin de la siguiente manera: var tmp = CHelper.getParameterValue("LOGOSPATH"); Nota: En caso que el usuario desee asignar una direccin diferente para el Portal de Usuarios, se debe modificar el archivo web.config que es archivo de configuracin de la aplicacin (ms

Copyright 2013 - Bizagi

2161

especficamente, se debe modificar el valor asociado a la llave SERVER_NAME). Por favor tenga en cuenta que no se recomienda modificar valores de configuracin directamente en el archivo Web a menos que sea estrictamente necesario. En lugar de ello, utilice la funcionalidad de Configuracin de Ambiente cada vez que sea posible. Parmetros personalizados en produccin Para garantizar el funcionamiento correcto de todos los ambientes cuando un proyecto ha hecho deployment los Parmetros Personalizados no podrn ser editados ni borrados.

6.7

Configuracin de negocio
La Configuracin de Negocios determina la configuracin de la forma de moneda, fechas y horas se muestran en el Portal de Trabajo. El men se encuentra en la pestaa de Co n fig u raci n , como se muestra a continuacin:

En el men de Configuracin de Negocio, el usuario encontrar tres grupos principales de opciones para cambiar la configuracin del Proyecto. Localizacin: Este grupo de opciones permite a la administracin de la configuracin regional para el proyecto Bizagi, incluyendo la cultura, la fecha, hora y formato de moneda. Notificaciones: Se puede personalizar el cuerpo de los mensajes de notificaciones automticas a fin de incluir la informacin deseada. Avanzado: Este grupo de opciones permite configurar los parmetros de visualizacin generales del proyecto Bizagi.

2162

Copyright 2013 - Bizagi

Localizacin
Este grupo de opciones permite la administracin de la configuracin regional para el proyecto Bizagi, incluyendo la cultura, la fecha, hora y formato de moneda. Para cambiar cualquier configuracin, haga clic en el valor deseado en la lista desplegable de cada opcin. A continuacin, haga clic en O k.

Copyright 2013 - Bizagi

2163

Las opciones disponibles en el grupo de localizacin son: ELEMENTO Opciones de localizacin Cultura global Define la cultura de la aplicacin, incluyendo el texto y el calendario que se utilizar. DESCRIPCIN

Formato para Fecha y Hora Formato corto fecha Formato corto hora Formato largo fecha Define el formato de fecha corta. Define el formato de hora corta. Define el formato de fecha que se utiliza para mostrar la fecha de creacin y fecha de solucin en el rea de trabajo.

Formato de Moneda Dgitos decimales Smbolo de moneda Separador decimal Define el nmero de dgitos decimales en valores de moneda. Define el smbolo de moneda aparecer antes del valor. Define el caracter separador decimal.

2164

Copyright 2013 - Bizagi

ELEMENTO Separados de miles Zona horaria Zona horaria servidor

DESCRIPCIN Define el caracter separador de miles.

Define la zona horaria utilizada en el servidor Web.

Notificaciones
Usted puede personalizar el cuerpo de los mensajes de notificaciones automticas a fin de incluir la informacin deseada. Las Notificaciones automticas son mensajes de correo electrnico enviados a los usuarios finales para informar sobre casos abortados, actividades retrasadas y tareas asignadas.

Copyright 2013 - Bizagi

2165

Para personalizar el cuerpo de una notificacin especfica, haga clic en la opcin Ed itar. Una nueva ventana aparecer para modificar el nombre, el asunto y el texto del cuerpo del mensaje. ELEMENTO Tareas DESCRIPCIN Estos mensajes se envan tan pronto como una tarea ha sido asignada. Dado que una tarea se puede asignar a varias personas, la notificacin se enva a todos los asignados a la actividad. Estas notificaciones se enviarn tan pronto como un caso ha sido abortado a todos los que estn asignados actualmente a una actividad del caso. Estas notificaciones se envan cuando una alarma se ha configurado para una tarea especfica del Proceso. Estas notificaciones no estn soportadas actualmente.

Abortar

Alarmas de tareas

Alarmas de Procesos

2166

Copyright 2013 - Bizagi

Avanzado
Este grupo de opciones permite configurar los parmetros generales de visualizacin para el proyecto Bizagi.

ELEMENTO Asignaciones Grupo de usuario por defecto

DESCRIPCIN

Define el grupo de usuarios predeterminado para las asignaciones cuando ningun usuario cumple las condiciones de asignacin.

Opciones del proyecto Mostrar Link Excel Mostrar Eventos como Tareas Ocultar tipos de tarea en el Log de Estados Muestra el enlace para exportar tablas a Excel. Muestra los Eventos en el Inbox. Oculta tareas que no tienen una interaccin directa con el usuario.

Copyright 2013 - Bizagi

2167

ELEMENTO Deshabilitar Link al caso padre Agrupar casos por nmero de caso Preferencias de usuario Forma de preferencias de usuario

DESCRIPCIN Desactiva el enlace al caso padre desde los subprocesos Agrupa los casos en el Inbox por nmero de caso

Permite definir una forma para la edicin de preferencias de usuario

Opciones de descarga Ver contenido de archivo como Define cmo los archivos mostrados en el Portal de Trabajo se deben descargar: abrir en un navegador nuevo o con una ventana de descarga. Define el tipo de contenido para los archivos subidos. Debe configurar la extensin del archivo y la aplicacin asociada con el fin de mostrar los archivos.

Tipos de contenido

6.8

Diagnstico y control de errores Informacin general

Durante las fases de desarrollo de un proyecto (al automatizar los procesos), o en el ambiente de produccin, hay ciertos escenarios en los que puede desear para rastrear, o hacer seguimiento a la ejecucin de sus procesos (tambin para depurar). Bizagi ofrece la posibilidad de hacer rastreo de los errores en los flujos de procesos (para su control y diagnstico), de modo que los administradores puedan validar si las reglas del negocio, validaciones, invocaciones interfaces, o incluso el proceso necesita ser afinado. Para el control de errores de un proyecto, Bizagi presenta su configuracin de Rastreo o Traces. Esta es una opcin poderosa para ayudar a la comprensin y la deteccin de aquellos comportamientos que requieren un ajuste, o para garantizar que el proceso funcione como se espera (durante las pruebas). Tenga en cuenta que los traces no deben dejarse habilitados todo el tiempo, y que por el contrario se recomienda que se habiliten solo temporalmente para obtener detalle adicional cuando se detecta que los procesos no se comportan como se espera.

Nota Adems de la posibilidad de consultar Bizagi traces, tambin se puede revisar el log del Servidor. En sistemas operativos Windows, Bizagi registrar logs de eventos en el Servidor (los cuales pueden revisarse en el visor de eventos).

2168

Copyright 2013 - Bizagi

En la edicin Bizagi Enterprise JEE, es muy importante consultar el log a nivel del Servidor de Aplicaciones JEE (el log especfico sea: WebSphere, Weblogic o JBoss). En WebSphere especficamente, tenga presente que hay un log aparte para el registro de errores (separado del log del servidor como tal).

Cmo funcionan los traces?

Los Traces supervisan el proceso en varios niveles, tales como: el proceso y actividades, las reglas de negocio, validaciones y polticas de negocio, invocaciones interfaces y Formas (con sus campos). En otras palabras, es posible realizar el seguimiento de todo el proceso y sus objetos / componentes que hacen parte del Portal de Trabajo. Para activar y configurar los Traces, puede habilitar cada objeto / componente por separado y establecer un filtro para que los registros generados incluyan ciertos niveles de detalle (por ejemplo, las advertencias y los errores, o errores solamente). Los pasos para esto son: 1. Reconocer cuales son los Traces que se deben activar (de los distintos objetos y componentes). 2. Definir sus detalles del Trace.

1. Reconocer qu Traces activar

Bizagi traces
La habilitacin de Traces se realiza ya sea desde Bizagi Studio (Entorno de desarrollo) o desde el Management Console (para pruebas o produccin). Desde Bizagi Studio:

Desde el Management Console:

Copyright 2013 - Bizagi

2169

Nota Tenga en cuenta que la funcin de Traces para el uso de troubleshooting (debug) est orientada principalmente al entorno de desarrollo. Es muy recomendable aprovechar esta caracterstica mientras se realizan las pruebas de los procesos a fin de que en el entorno de produccin slo las utilice si es estrictamente necesario. Por ejemplo, cuando un servicio Web externo ha cambiado y no hubo consideraciones a este cambio frente a la configuracin en Bizagi, puede ser til habilitar los Traces en el ambiente de produccin para ayudar a detectar comportamientos no deseados. Al abrir la ventana de configuracin de rastreo (Traces) ya sea desde Bizagi Studio o desde el Management Console ver los objetos y componentes disponibles:

2170

Copyright 2013 - Bizagi

Es importante reconocer y planificar qu Traces desea habilitar. La siguiente tabla describe las posibilidades: ELEMENTO EntityManager DESCRIPCIN Registra la ejecucin de EntityManager (acceso de base de datos). Registra cuando una interfaz externa se invoca. Rastrea las peticiones y respuestas.. Regista la ejecucin de la sincronizacin

Interfaces

LDAP

Copyright 2013 - Bizagi

2171

programada de usuarios de LDAP en Bizagi. Render Registra la construccin Formas en el Portal de Trabajo (y sus campos). Registra la ejecucin y la evaluacin de las reglas de negocio y polticas. Los Traces en reglas son personalizados using la funcin CH elp er.trace Registra la ejecucin de los trabajos programados. Registra cuando comienza una transaccin, cuando la informacin se guarda en la base de datos, cuando un caso se crea y la ejecucin de cada elemento. Cuando la asignacin est seleccionada, registra la ejecucin de reglas de asignacin.

Reglas y expresiones

Scheduler

Workflow

2. Definir el detalle de los Traces Con el fin de decidir lo se desea rastrear (el nivel de detalle), en la opcin seleccionada en el men de rastreo, haga clic en el tipo de rastreo y defina el nivel de detalle (Error, Advertencia, todo).

2172

Copyright 2013 - Bizagi

Por defecto est seleccionado A p ag ad o (una caja vaca se muestra) para todos los objetos / componentes. Cuando Erro r es seleccionado, el archivo de rastreo slo registra los errores. Cuando A d v erten cia se selecciona, el archivo de rastreo rastrear advertencias y errores. Cuando To d o est seleccionado, el archivo de rastreo registrar: advertencias, errores y paso a paso la informacin sobre los comandos ejecutados. Tenga en cuenta que puede seleccionar cada tipo de rastreo (y sus subtipos) y seleccionar una configuracin de detalle de seguimiento para cada uno. Despus de guardar los cambios en estos elementos, debe reiniciar el servicio de su servidor de BPM (p.ej. IISreset en IIS).

Ubicacin de los Traces

Una vez activado, los Traces se guardan como archivos de texto sin formato en el servidor de BPM. Ellos estarn ubicados en una ruta diferente, de acuerdo con el servidor web especfico y la aplicacin

Copyright 2013 - Bizagi

2173

utilizada como servidor de BPM.

Para Bizagi Enterprise .NET or Bizagi Xpress

En los proyectos que utilizan IIS (. NET ambientes), los Traces se guardar en: C:\Bizagi\[bizagi_edition]\Projects\[project_name]\Trace\ Interfaces SOA se encuentran por separado en: C:\Bizagi\[bizagi_edition]\Projects\[project_name]\Temporary\SOA\

Para Bizagi Enterprise JEE

En los proyectos que utilizan un Servidor de Aplicaciones JEE, los Traces se guardan en la carpeta temporal del Servidor BPM. Esto implica una ruta diferente de acuerdo con la plataforma tecnolgica. En un SO Linux, la ruta es: /tmp/Bizagi En Windows, la ruta es: C:\Windows\Temp\Bizagi\

Ejemplos y mayor informacin

Como se describi anteriormente, hay ms de 1 tipo de objeto / componente para rastrear. Lo siguiente describe los Traces ms comunmente usados.

Trace del Portal de Trabajo

El portal de trabajo graba unos logs con el detalle sobre lo que se ejecuta a nivel de aplicacin (Web). Estos logs se encuentran en la carpeta .\Trace como un archivo llamado B A Trace_W eb _[fech a].lo g. El siguiente ejemplo ilustra la informacin que se graba en estos archivos:

Trace del Scheduler (Programador)

2174

Copyright 2013 - Bizagi

El servicio programador graba unos logs con el detalle sobre lo que ejecuta de manera offline. Estos logs se encuentran en la carpeta .\Trace como un archivo llamado B A Trace_Sch ed u ler_[fech a] .lo g. El siguiente ejemplo ilustra la informacin que se graba en estos archivos:

Traces en Expresiones (reglas de negocio)

Para esta opcin, adems de activar la opcin de rastreo correspondiente y sus niveles, tambin es necesario incluir una lnea de comando de seguimiento en el cdigo de la expresin (reglas de negocio) que se desea rastrear. Este enfoque generar un registro separado, para cualquier informacin que el usuario desea rastrear. Para ms informacin, consulte Validar mi regla de negocio.

Traces en interfaces
Para ms informacin sobre como los Traces para la invocacin de interfaces, consulte Diagnstico y control de errores para servicios Web. Diagnstico y control de errores para servicios Web.

6.8.1

Diagnstico y control de errores para servicios Web

Cuando se configuran invocaciones a servicios Web desde Bizagi, puede contar con varias opciones para el diagnstico y control de errores. Una de las opciones es el uso de Traces cuando se detecta que hay un inconveniente con la invocacin a un servicio Web, y por lo tanto se desea obtener mayor detalle sobre este.

Traces de interfaces
Cuando se hace debug en la invocacin de un servicio Web (en ambientes de desarrollo) o cuando se desea obtener log detallado sobre una ejecucin fallida, se pueden habilitar los Traces de In terfaces.

Copyright 2013 - Bizagi

2175

Nota Tenga en cuenta que los Traces de interfaces pueden habilitarse desde Bizagi Studio o desde el Management Console y se recomienda enfticamente solo habilitarlos de manera temporal (despus de obtener el detalle deben ser deshabilitados). Los cambios en la configuracin de Traces posiblemente requieran reiniciar los servicios de su servidor BPM.

La habilitacin de los Traces es til para detectar en qu punto exactamente hubo un fallo en la ejecucin, principalmente porque se cuentan con 6 puntos donde se registra detalle que es til para diagnosticar si el problema est internamente en el servicio Web exterrno, o si se produjo cuando se

2176

Copyright 2013 - Bizagi

realizaban transformaciones de datos a la informacin de Bizagi.

Tipos de Traces
Los siguientes Traces se registran en un orden cronolgico. Orden cronolgico 1 Tipo de Trace Descripcin

Request mapping JSON (o Request)

Registra un log con estructura JSON con la informacin de cmo se realiza el mapeo para los datos de entrada (involucrando las transformaciones necesarias). El nombre de este archivo sigue esta estructura: [id en tificad o r_d el_caso ]_B izA g iSO A Req u estM ap p in g _ [tim estam p ].jso n Ntese que el timestamp se define como: yyyyMMddHHmm. En versiones anteriores de Bizagi, el Request mapping JSON no se utiliza (y en cambio se registra Request, el cual deja un log con estructura XML con la informacin que se extrae de Bizagi).

Request data JSON (o Request transformed)

Registra un log con estructura JSON con la informacin de negocio que extrae de Bizagi. El nombre de este archivo sigue esta estructura: [id en tificad o r_d el_caso ]_B izA g iSO A Req u est_ [tim estam p ].jso n Ntese que el timestamp se define como: yyyyMMddHHmm. En versiones anteriores de Bizagi, el Request data JSON no se utiliza (y en cambio se registra Request transformed, el cual deja un log con estructura XML con la informacin como se envia despus de aplicar transformaciones).

SOAP Message body Request

Aplica para las invocaciones a servicios Web de tipo SOAP (los de tipo REST no se incluyen). Registra un log la informacin detallada de la invocacin. Esta informacin queda en un archivo con esta estructura: SO A P _TraceVersio n 02_[tim estam p ].sv clo g Ntese que el timestamp se define como: yyyyMMddHHmm. En versiones anteriores de Bizagi, se registra el contenido del XML justo como se envia al servicio externo pero sin los datos que van en la cabecera de

Copyright 2013 - Bizagi

2177

SOAP (sin el SOAP Header). 4 SOAP Message body Response Aplica para las invocaciones a servicios Web de tipo SOAP (los de tipo REST no se incluyen). Registra un log la informacin detallada de la invocacin. Esta informacin queda en un archivo con esta estructura: SO A P _TraceVersio n 02_[tim estam p ].sv clo g Ntese que el timestamp se define como: yyyyMMddHHmm. En versiones anteriores de Bizagi, se registra el contenido del XML justo como se recibe del servicio externo pero sin los datos que van en la cabecera de SOAP (sin el SOAP Header). 5 Response mapping JSON (o Response) Registra un log con estructura JSON con la informacin de cmo se realiza el mapeo para los datos de salida (involucrando las transformaciones necesarias). El nombre de este archivo sigue esta estructura: [id en tificad o r_d el_caso ]_B izA g iSO A Resp o n seM ap p in g _ [tim estam p ].jso n Ntese que el timestamp se define como: yyyyMMddHHmm. En versiones anteriores de Bizagi, el Response mapping JSON no se utiliza (y en cambio se registra Response, el cual deja un log con estructura XML con la informacin que se obtiene de respuesta del servicio Web). 6 Response data JSON (o Response transformed) Registra un log con estructura JSON con la informacin de negocio que proviene de la respuesta del servicio Web. El nombre de este archivo sigue esta estructura: [id en tificad o r_d el_caso ]_B izA g iSO A Resp o n se_ [tim estam p ].jso n Ntese que el timestamp se define como: yyyyMMddHHmm. En versiones anteriores de Bizagi, el Response data JSON no se utiliza (y en cambio se registra Response transformed, el cual deja un log con estructura XML con la informacin como llega a Bizagi despus de aplicar transformaciones).

Medida adicional para el control de errores

Se recomienda enfticamente que se definan los tiempos esperados para la invocacin de un servicio externo, de manera que se pueda tener explcitamente un valor para: el time-out del servicio, y el

2178

Copyright 2013 - Bizagi

tiempo esperado de umbral de la respuesta (logging threshold). El parmetro para definir el tiempo umbral de respuessta para las interfaces provee un log que da alertas sobre aquellas interfaces que se estn demorando ms del tiempo esperado. De esta manera, se puede hacer un diagnstico a los servicios Web y un control anticipado para revisar las variables que puedan estar afectando el desempeo del sistema externo. Para mayor informacin sobre estas opciones, consulte la Administracin de interfaces.

Cmo diagnosticar la invocacin a un servicio Web?

Con los siguientes pasos, ilustramos cmo utilizar los Traces de interfaces para detectar o diagnosticar errores en la invocacin de servicios externos. 1. Detectar el error Partiendo de las prcticas comunes, podr verificar si hay algn error en la invocacin de un servicio Web a travs de la Consola de actividades asncronas (desde las opciones de Administracin, ubicada como A sy n ch ro n o u s A ctiv ities co n so le). Esto aplica para las actividades asncronas.

2. Habilite los Traces A traves de Traces, habilite todos los que se utilizan en interfaces.

3. Vuelva a ejecutar la invocacin (para obtener el log) Ejecute un reintento de la invocacin para que se registre un log detallado.

Copyright 2013 - Bizagi

2179

Seguidamente, ubique en la ruta de su servidor BPM en la carpeta SO A , el log de la ejecucin (en este ejemplo con .NET, la ubicacin es C:\Bizagi\[edicin_Bizagi] \Projects\[nombre_proyecto]\SOA). Es muy importante tener en cuenta que no en todos los escenarios, se visualizarn todos los tipos de logs. Por ejemplo, si el error ocurre en la extraccin de informacin desde Bizagi, entonces solamente el primer log (Request mapping) quedar registrado dado que el error ocurre antes de que siquiera se realice la invocacin. 4. Validar los Traces para identificar el error (uno por uno) Valide la informacin que se registra en estos logs. Si encuentra que todos los archivos de request estn all, entonces el error debe estar justo cuando Bizagi invoca el servicio Web, y podr revisar el archivo SO A P _TraceVersio n 02_[tim estam p ].sv clo g o enviarlo a nuestro equipo de soporte.

Tenga en cuenta que este tipo de log puede ser visualizado con herramientas como SvcTraceViewer de Microsoft, que usualmente vienen en el framework 4.0 de .NET.

2180

Copyright 2013 - Bizagi

6.9

Administracin de sistemas externos

Bizagi ofrece la posibilidad de gestionar la informacin de los sistemas externos y aplicaciones integradas en los procesos. La gestin de esta informacin (Interfaces y parmetros del ECM, bases de datos conectadas a travs de la replicacin y virtualizacin, etc) se lleva a cabo para cualquiera de los entornos del proyecto: desarrollo, produccin o pruebas. Para ello, tendr los Sistemas externos configurados en una vista:

Copyright 2013 - Bizagi

2181

Para gestionar los valores de sistemas externos para el ambiente de desarrollo, use Bizagi Studio por medio de la configuracin de Sistem as en la vista de Mdulos. Para gestionar los valores de Sistemas externos para produccin o pruebas, utilice la Consola de Administracin (Management Console) de Bizagi. Para ms informacin sobre cmo gestionar especficamente tales valores, consulte los siguientes artculos: Administracin de interfaces: Para editar los valores ajustados en servicios externos invocados por procesos Bizagi. Verificacin de replicacin: el hacer seguimiento o editar valores en las bases de datos conectadas (Entidades replicadas).

6.9.1

Administracin de interfaces

Informacin general
Bizagi ofrece la posibilidad de gestionar la informacin de los sistemas externas y aplicaciones integradas en los procesos. A travs de las opciones presentadas en la vista del mdulo en la opcin de Sistem as, usted puede definir interfaces nuevas que se integran a los procesos Bizagi, o editar la informacin de las existentes (para gestionar los ambientes de produccin o de pruebas). Las interfaces enumeradas en un sistema, consideran tanto las que invocan un servicio web SOAP y y servicios REST.

2182

Copyright 2013 - Bizagi

Interfaces de servicios web SOAP se identifican con este icono: Interfaces para servicios REST se identifican con este icono: Las Interfaces creadas a travs del Asistente de interfaces, ya sea en el sexto paso del Asistente de Proceso (Definir interfaces) o como una tarea de evento al Salir, tambin se consideran en este mdulo de Sistem as. Las Interfaces creadas con el asistente se crean inmediatamente bajo un sistema de auto-generado llamado Default:

Nota La administracin de interfaces en los ambientes de pruebas y produccin se realiza a travs de las opciones de Bizagi Management Console.

Creando nuevas interfaces

Para crear una nueva interfaz desde la vista de Mdulos, asegrese de tener un Sistema creado con la propiedad activa H ab ilitar in terfaces en este sistem a:

Copyright 2013 - Bizagi

2183

A continuacin, haga clic en su Sistema creado y haga clic en la opcin N u ev a in terface:

Se le mostrar la siguiente ventana:

2184

Copyright 2013 - Bizagi

Tenga en cuenta que, por defecto, la nueva interface ser tratada como una interfaz de servicio web SOAP (Servicio type = SOAP). Los siguientes campos se presentan: Nombre : Nombre nico y requerido que identifica a la interface. ste no debe contener espacios. Mostrar el nombre: Nombre visible para esta interface (requerido). Descripcin de la interfaz: una descripcin opcional para documentar la informacin relevante para esta interfaz. Tipo de Servicio: Opciones de SOAP o REST. Al elegir resto como el tipo de servicio, no habr campo para especificar mtodo del servicio. Interfaz de propiedades de la tabla:. Un conjunto de valores de configuracin orientada a entornos del proyecto (desarrollo, prueba o produccin Este conjunto incluye:

Copyright 2013 - Bizagi

2185

Propiedad URL Servicio Web La URL de acceso al servicio. Para servicios REST, este campo tendr la URL Base Cuando el servicio requiere autenticacin HTTP bsico, este nombre de usuario se requiere para el acceso al servicio. Cuando el servicio requiera la autenticacin bsica HTTP, esta contrasea se requiere para el acceso al servicio. Cuando el servicio requiera autenticacin HTTP bsica, este campo es opcional para complementar el nombre de usuario, para el acceso al servicio. El tiempo en segundos que define un umbral de servicio esperado para la interfaz. Si la invocacin supera esta definicin en ejecucin, entonces se registra una lnea de trace en el registro .csv log en " .\SO A \Lo g \" para propsitos de monitoreo.. El valor predeterminado se establece en 30 segundos, por lo que siempre se registra si la invocacin tarda ms que este tiempo. El tiempo en segundos que define el tiempo de espera para cualquier intento de invocacin de una interfaz. Si la invocacin supera esta definicin en ejecucin, se genera un error y se registra en una lnea de trace en el registro. csv en " .\SO A \Lo g \". Por defecto esta opcin no se utiliza (su valor inicial es -1). La invocacin har timeout de acuerdo a esta propiedad, o la propiedad en la actividad si la invocacin se realiza en una actividad asncrona (se disparar cualquier timeout de los 2, el cual tenga el menor valor).

Nombre de usuario

Contrasea

Dominio

Umbral para registro (en seg)

Tiempo de espera (en seg)

Editando una interface existente

Una vez que se hayan definido interfaces ya configuradas en algn punto de los procesos, es posible tambin editar su informacin desde esta vista. De manera similar a la creacin de la misma, las opciones para editar una interface permitirn principalmente: editar o incluir las credenciales usadas en la autenticacin HTTP bsica, o administrar la URL del servicio. Para editar una interface existente, de clic derecho sobre la interface y seleccione sus P ro p ied ad es.

2186

Copyright 2013 - Bizagi

Nota: La edicin de servicios REST contempla ciertas consideraciones al momento de editar la URL Base. Vea las consideraciones relacionadas a interfaces de servicios REST.

Eliminando una interface

Para eliminar una interface, de clic derecho sobre la misma y seleccione la opcin de Elim in ar in terface. Tenga en cuenta que no es posible eliminar interfaces que se encuentren en funcionamiento en el ambiente de produccin. Bizagi ejecutar las validaciones de su motor de dependencia de manera que se permita eliminar aquellas interfaces que no estn siendo utilizadas en alguna versin de proceso.

Interfaces en produccin
Copyright 2013 - Bizagi 2187

Las interfaces listadas en esta vista de Bizagi Studio, permiten la definicin inicial de sus valores en sus diferentes ambientes (desarrollo, pruebas y produccin). Una vez que estas interfaces se encuentre en produccin, su administracin se realizar directamente sobre cada ambiente en separado. Esta administracin se realiza directamente desde la consola administrativa de Bizagi, al abrir el ambiente especfico. Vea mayor informacin sobre la opcin de administracin de Sistemas desde la Consola de Administracin (Management Console) de Bizagi.

6.9.2

Verificar Replicacin

Informacin general
Una vez que la Replicacin se ha configurado, usted puede verificar que su ejecucin sincroniza los valores en las entidades Paramtrocas con columnas de las tablas externas. Hay dos formas de hacerlo: mediante las opciones de los mdulos de Sistem as, o a travs de la informacin que aparece entidades (mdulo de Entidades). Las opciones presentadas en el mdulo de Sistem as son tiles para ambientes de pruebas o de produccin. Las opciones presentadas en el mdulo de Entidades servirn como un punto de control durante la configuracin de replicacin (en el ambiente de desarrollo). Para obtener ms informacin acerca de la replicacin y su configuracin, consulte el artculo principal de Replicacin.

Usando el mdulo de Sistemas

Esta opcin es especialmente til para todos los ambientes de los proyectos. El mdulo de Sistemas est disponible tanto en Bizagi Studio (Entorno de desarrollo) a travs de la Consola de administracin (Management Console) para entornos de produccin o de pruebas. Vea ms informacin acerca de la Consola de administracin. Para revisar una ejecucin de Replicacin programada, vaya al mdulo de Sistemas. Esto mostrar el sistema establecido para su replicacin. Expanda el nodo de elementos y navegue hasta la configuracin del esquema de Replicacin (bajo el nodo de P ro v eed o res, el proveedor especfico, el nodo replicado Entidades, y, finalmente, la clase predeterminada de replicacin). Haga clic en el esquema y haga clic en P ro p ied ad es d e la rep licaci n :

2188

Copyright 2013 - Bizagi

En esta ventana, seleccione la pestaa In fo rm es d e rep licaci n para mostrar la fecha y la hora de las ejecuciones de replicacin. De haber algn error, en lugar del estado de xito, usted ver el estado de error, con su correspondiente causa (mensaje).

Copyright 2013 - Bizagi

2189

Cuando el esquema de replicacin se ha ejecutado con xito, usted puede buscar los valores replicados en las Entidades Paramtricas en Bizagi. Esta opcin est disponible directamente para el entorno de desarrollo y se describe en la siguiente seccin. Adems de este registro, y permitiendo que corra de nuevo la repeticin proceso, puede usar la opcin Rep licar ah o ra para sus entidades replicadas para iniciar su sincronizacin inmediata:

2190

Copyright 2013 - Bizagi

Usando el mdulo de Entidades

Esta opcin le permite ver los valores sincronizados para sus Entidades Paramtricas establecidas en la replicacin en el entorno de desarrollo. Para usarlo, vaya al mdulo Entidades y ubique las Entidades paramtricas (Territorries y Region en nuestro ejemplo). Es posible que necesite actualizar la vista en caso de que ya se encontrara en esta opcin.

Copyright 2013 - Bizagi

2191

En las Entidades Paramtricas creadas, puede hacer clic en Valo res para consultar sus registros. Bizagi mostrar los valores sincronizados. Nota: Tenga en cuenta que esta opcin debe utilizarse con precaucin cuando se tiene un nmero muy grande de registros en el origen, ya que la consulta y recuperacin de estos valores puede tardar algn tiempo. Valores para Reg i n del origen de datos externo:

2192

Copyright 2013 - Bizagi

Los valores de Territo ries de la fuente de datos externa:

Copyright 2013 - Bizagi

2193

6.10

Administracin de Actividades Asncronas Informacin general

Cuando hay puntos de integracin en los procesos donde se utiliza una tarea de tipo de Servicio (ya sea para invocar un servicio Web o REST o utilizar cdigo personalizado para una actividad avanzada de reglas,por medio de la Librera de Componentes), Bizagi permite este tipo de tareas a ser configuradas para ejecutarse de manera asncrona. Cuando se define una tarea de servicio BPMN como una actividad asncrona, Bizagi permite configurar un nmero de reintentos, en caso de que las acciones de integracin no respondan en un determinado umbral (por lo general, una invocacin a un servicio externo). Ver ms informacin acerca de actividades asincrnicas. Por lo tanto, en este escenario en el que una actividad asincrnica falla (es decir, una aplicacin externa no se inicia, hay problemas de conectividad, etc) y se supera el nmero de intentos predefinidos, Bizagi ofrece la posibilidad de que un administrador haga revisin, seguimiento y diganstico y reintente manualmente estas operaciones.

En la imagen de arriba, vemos los parmetros de configuracin para realizar una actividad asncrona, como se define modelando el proceso.

Dentro de las opciones de administracin de las actividades asncronas, Bizagi almacenar un registro relacionando las instancias de proceso (casos) que no pudieron ser completadas y el motivo correspondiente (un mensaje de error).

2194

Copyright 2013 - Bizagi

A travs de esta consola, el administrador podr reintentar manualmente estas actividades que contengan errores.

Consola de Actividades Asncronas

Para acceder a esta opcin, haga clic en el men Admin en el Portal de Trabajo Bizagi. Haga clic en Co n so la d e activ id ad es asn cro n as.

Esta opcin permite al administrador decidir qu tems volver a intentar, de forma individual o en grupo. Tambin puede ver el log de reintentos o elegir los casos a abortar (si es necesario).

Tenga en cuenta que se le presentar una tabla que tiene todas las Actividades asncronas fallidas con

Copyright 2013 - Bizagi

2195

informacin general como: registro de detalle del error, el nmero de caso al que pertenece la actividad, el nombre de la actividad, el nmero de reintentos hasta el momento, la fecha en que se cre la primera actividad, y la fecha lmite de reintentos.

Reintentar un tem
Para reintentar manualmente una actividad asncrona, seleccione la pestaa de A ctiv id ad es A sn cro n as y haga clic en el icono Vo lv er a in ten tar en la fila correspondiente.

Reintentar tems especficos

Para reintentar ms de un elemento a la vez, seleccione los elementos en la pestaa A ctiv id ad es asn cro n as y luego haga clic en el botn H ab ilitar . Estos items sern marcados para reintento automtico, que se lleva a cabo por el Programador (el servicio que se instala para cada proyecto Bizagi que realiza ciertas tareas en un intervalo dado).

2196

Copyright 2013 - Bizagi

Reintentar items en grupo

Bizagi permite al usuario reintentar todos los items que han fallado agrupando por proceso o actividad. Este reintento no se realiza inmediatamente, se ejecuta por el Programador (ver el detalle en la opcin anterior). Para ello, seleccione la pestaa A g ru p ad as p o r A ctiv id ad. Haga clic en A ctiv ar en la columna Deleg ar al Sch ed u ler, para que el Programador vuelva a intentar en las actividades agrupadas por lotes.

Copyright 2013 - Bizagi

2197

Ten g a en cu en ta q u e p u ed e activ ar A ctiv id ad es ag ru p ad o s p o r p ro ceso .

Ver Registro de reintentos

Para ver el registro de reintentos que tiene el detalle de la ejecucin (el mensaje de error que causa que la actividad asncrona falle), haga clic en el icono en la columna Log. En el registro de actividades asncronas, se encuentra la historia de los intentos con fecha y el mensaje de error especfico.

2198

Copyright 2013 - Bizagi

6.11

Lista de chequeo para la creacin de proyectos

Siga la lista de chequeo para las diferentes ediciones de Bizagi en los enlaces abajo:

Lista de chequeo para Bizagi Enterprise .NET Lista de chequeo para Bizagi Enterprise JEE Lista de chequeo para Bizagi Xpress 6.11.1 Lista de verificacin para Bizagi Enterprise .NET
Revise la siguiente lista de chequeo para la creacin de proyectos usando Bizagi Enterprise .NET.

1. Base de datos configurada para trabajar con Bizagi.

Bizagi Enterprise .NET soporta proyectos en Base de datos SQL Server o en Oracle. Si su proyecto utilizar SQL Server, consulte la configuracin de SQL Server (donde podr consultar igualmente las versiones e intercalaciones soportadas). Si su proyecto utilizar Oracle, consulte Crear un proyecto utilizando Oracle (en la seccin de prerequisitos).

2. IIS instalado con los componentes de Servidor

Para ms informacin acerca de cmo instalar y configurar el Internet Infomation Services de Microsoft en el Servidor BPM (donde se instala Bizagi), consulte la Instalacin de IIS.

3. Permisos del usuario para crear proyectos

La creacin de proyectos de Bizagi requiere permisos de administrador para la cuenta de Windows que ejecuta Bizagi Studio. Esto se debe a que Bizagi crea los componentes y servicios locales de un proyecto como lo son: el Portal de Trabajo (en el IIS) y el servicio Programador (Scheduler).

Consideraciones para proyectos remotos

Si el proyecto se registra y se abre desde una estacin de trabajo hacia un Servidor dedicado para trabajo en equipo, debe asegurarse de lo siguiente: Tener acceso desde la estacin de trabajo hacia el Servidor BPM a travs de los puertos TCP 5679 y puertos UDP 50051 y 50052. Tener acceso desde el Servidor BPM al servidor de Base de datos a travs del puerto de la instancia de la Base de datos. Al usar SQL Server, el puerto por defecto es el TCP 1433. Al usar Oracle, el puerto por defecto es el TCP 1521.

Copyright 2013 - Bizagi

2199

Tener las credenciales de una cuenta de Windows autorizada para los proyectos en ese Servidor BPM. Esto significa contar con el acesso a una cuenta que pertenezca al grupo de Bizagi y Administradores).

6.11.2 Lista de verificacin para Bizagi Enterprise JEE

Revise la siguiente lista de chequeo para la creacin de proyectos usando Bizagi Enterprise JEE.

1. Base de datos configurada para trabajar con Bizagi.

Bizagi Enterprise JEE soporta proyectos en Base de datos SQL Server o en Oracle. Si su proyecto utilizar SQL Server, consulte la configuracin de SQL Server (donde podr consultar igualmente las versiones e intercalaciones soportadas). Si su proyecto utilizar Oracle, consulte Crear un proyecto utilizando Oracle (en la seccin de prerequisitos).

2. Servidor de Aplicaciones JEE configurado para trabajar con Bizagi.

Bizagi Enterprise JEE instala un Servidor de Aplicacin JBoss 7.1.1, el cul viene incorporado para el ambiente de desarrollo (para trabajar con Bizagi Studio). Esto no requiere de configuracin alguna. Para el ambiente de pruebas o produccin se debe instalar de manera independiente el Servidor de Aplicacin JEE y asegurarse de que est configurado para trabajar con Bizagi. Para ello, siga la gua segn los Servidores soportados: Configuracin de WebSphere para trabajar con Bizagi. Configuracin de Weblogic para trabajar con Bizagi. Configuracin de JBoss para trabajar con Bizagi.

3. Permisos del usuario para crear proyectos

La creacin de proyectos de Bizagi en un ambiente de desarrollo, requiere permisos de administrador para la cuenta de Windows que ejecuta Bizagi Studio. Esto se debe a que Bizagi crea los componentes y servicios locales de un proyecto.

Consideraciones para proyectos remotos

Si el proyecto se registra y se abre desde una estacin de trabajo hacia un Servidor dedicado para trabajo en equipo, debe asegurarse de lo siguiente: Tener acceso desde la estacin de trabajo hacia el Servidor BPM a travs de los puertos TCP 5679 y puertos UDP 50051 y 50052. Tener acceso desde el Servidor BPM al servidor de Base de datos a travs del puerto de la instancia de la Base de datos. Al usar SQL Server, el puerto por defecto es el TCP 1433. Al usar Oracle, el puerto por defecto es el TCP 1521. Tener las credenciales de una cuenta de Windows autorizada para los proyectos en ese Servidor BPM. Esto significa contar con el acesso a una cuenta que pertenezca al grupo de Bizagi y

2200

Copyright 2013 - Bizagi

Administradores). Para ms informacin sobre estas consideraciones, consulte Autorizacin para trabajar en un servidor remoto.

6.11.3 Lista de verificacin para Xpress

Revise la siguiente lista de chequeo para la creacin de proyectos usando Bizagi Xpress.

1. Base de datos configurada para trabajar con Bizagi.

Para una gua sobre cmo configurar SQL Server, consulte la configuracin de SQL Server (donde podr consultar igualmente las versiones e intercalaciones soportadas).

2. IIS instalado con los componentes de Servidor

Para ms informacin acerca de cmo instalar y configurar el Internet Infomation Services de Microsoft en el Servidor BPM (donde se instala Bizagi), consulte la Instalacin de IIS.

3. Permisos del usuario para crear proyectos

La creacin de proyectos de Bizagi requiere permisos de administrador para la cuenta de Windows que ejecuta Bizagi Studio. Esto se debe a que Bizagi crea los componentes y servicios locales de un proyecto como lo son: el Portal de Trabajo (en el IIS) y el servicio Programador (Scheduler).

Consideraciones para proyectos remotos

Si el proyecto se registra y se abre desde una estacin de trabajo hacia un Servidor dedicado para trabajo en equipo, debe asegurarse de lo siguiente: Tener acceso desde la estacin de trabajo hacia el Servidor BPM a travs de los puertos TCP 5678 y puertos UDP 50001 and 50002. Tener acceso desde el Servidor BPM al servidor de Base de datos a travs del puerto de la instancia de la Base de datos. Al usar SQL Server, el puerto por defecto es el TCP 1433. Al usar Oracle, el puerto por defecto es el TCP 1521. Tener las credenciales de una cuenta de Windows autorizada para los proyectos en ese Servidor BPM. Esto significa contar con el acesso a una cuenta que pertenezca al grupo de Bizagi y Administradores).

6.12

Instalacin de IIS

El Portal de trabajo de Bizagi es una aplicacin Web, la cual es accedida por los usuarios finales para trabajar en los flujos de Proceso y sus actividades diarias. En Bizagi Enterprise .NET y Bizagi Xpress, el Portal se configura en el Servidor Web de Microsoft llamado Internet Information Services (IIS).

Copyright 2013 - Bizagi

2201

Cuando se crea un proyecto (para la ejecucin de los Procesos), Bizagi requiere que se instale el IIS en el Servidor BPM (donde se instala Bizagi). En la instalacin del IIS, es necesario asegurarse que se habiliten y se incluyan los componentes que requiere Bizagi, como se describe a continuacin. Nota Versiones del IIS soportadas son: 5, 6, 7 y 8.

Instalar el IIS
Siga las instrucciones de la seccin que corresponda a su sistema operativo.

Windows 8
Windows 8 incluye Internet Information Services en su versin 8. En tales sistemas operativos, la instalacin del IIS no se incluye por defecto, por loq que de igual manera no cuenta con los componentes requeridos habilitados. Para revisar la instalacin y adicionar los componentes que hacen falta, se deben activar los componentes de Windows desde el Panel de control como se muestra a continuacin. 1. Vaya al Panel de Control\Programas\Programas y componentes, y de clic en H ab ilitar/d esh ab ilitar co m p o n en tes d e w in d o w s.

2. Asegrese de marcar las casillas de los componentes como se ensea a continuacin. Ntese que algunas casillas ya estn marcadas por defecto, y estas deben mantenerse activas,

2202

Copyright 2013 - Bizagi

Copyright 2013 - Bizagi

2203

3. De clic en O K para finalizar la configuracin. Ntese que esto puede tardar algunos minutos y que estos cambios muy posiblemente requieran reiniciar la mquina.

Windows Server 2008 y 2008 R2

Windows Server 2008 y Windows Server 2008 R2 incluyen Internet Information Services en su versin 7. En tales sistemas operativos, la instalacin del IIS se realiza como un rol, y se configura con estos pasos: 1. Vaya a las opciones de administracin de servidor (Inicio\Programas\Herramientas administrativas\Administrador del servidor). Esta administracin tambin esta disponible desde las opciones del clic derecho sobre MiPC. Ntese que para ello, se requiere de permisos de administrador.

2. En la ventana de administracin del Servidor, ubique el item de roles, y seleccione la opcin de A d icio n ar Ro les.

2204

Copyright 2013 - Bizagi

Esta opcin inicia un asistente para configurar el IIS seleccionando los items y componentes.

Copyright 2013 - Bizagi

2205

Ntese que cuando se inicie el asistente de instalacin, se mostrar una pgina de introduccin informativa y para que se revise lo siguiente: La cuenta del administrador tiene una contrasea segura. Las direcciones IP y dems temas de red ya estn configurados. Se tienen las ltimas actualizaciones de Windows para el sistema operativo. Puede escoger saltarse esta pgina para las configuraciones a futuro. 3. Marque la opcin del Servidor Web (IIS) para que los componentes del IIS se muestren a continuacin. Esto permite la adicin de sus roles.

Haga clic en Sig u ien te. En la siguiente ventana se muestra la informacin general del IIS, donde no se requiere accin alguna. Haga clic en Sig u ien te cuando haya revisado la informacin.

2206

Copyright 2013 - Bizagi

4. Seleccione los servicios de rol que se requiere para el Portal de Trabajo de Bizagi.

Copyright 2013 - Bizagi

2207

Haga clic en Sig u ien te despus de asegurarse que haya marcado todos los componentes y subcomponentes necesarios, como se muestra en la imagen superior. Ntese que para marcar algunos componentes, se requiere la adicin de algunos roles. Para ello, el asistente le avisar, y debe asegurarse de adicionar los requerimientos de estos roles (haciendo clic en A d icio n ar lo s serv icio s d e ro les req u erid o s).

2208

Copyright 2013 - Bizagi

5. Una ventana de confirmacin aparece con el resumen de los roles y servicios que se instalarn. Una vez que proceda y de el visto bueno, comenzar la instalacin.

6. Una vez finalizada la instalacin, una ventana mostrar el xito del procedimiento y qu roles y servicios fueron instalados. Este cambio requiere que se reinicie el Servidor.

Windows Vista y Windows 7

Windows Vista y Windows 7 incluyen Internet Information Services en su versin 7. En tales sistemas operativos, la instalacin del IIS se incluye por defecto pero no cuenta con todos los componentes habilitados. Para revisar la instalacin y adicionar los componentes que hacen falta, se deben activar los componentes de Windows desde el Panel de control como se muestra a continuacin. 1. Vaya al Panel de Control\Programas\Programas y componentes, en el menu de izquierda, y de clic en H ab ilitar/d esh ab ilitar co m p o n en tes d e w in d o w s.

Copyright 2013 - Bizagi

2209

2. Asegrese de marcar las casillas de los componentes como se ensea a continuacin. Ntese que algunas casillas ya estn marcadas por defecto, y estas deben mantenerse activas,

2210

Copyright 2013 - Bizagi

3. De clic en O K para finalizar la configuracin. Ntese que esto puede tardar algunos minutos y que estos cambios muy posiblemente requieran reiniciar la mquina.

Windows Server 2003 y XP

Windows Server 2003 y Windows XP no incluyen por defecto el IIS.

Copyright 2013 - Bizagi

2211

Nota En estos sistemas operativos, para instalar el IIS se requieres del CD de instalacin de Windows. 1. Vaya al Panel de control y seleccione la opcin de A g reg ar o rem o v er p ro g ram as. En esta ventana, seleccione A d icio n ar/rem o v er co m p o n en tes d e W in d o w s desde el botn del panel a la izquierda.

2. Seleccione el componente Serv id o r d e ap licaci n en la ventana donde se listan los componentes a instalar. De clic en Detalles.

2212

Copyright 2013 - Bizagi

3. Marque la casilla de IIS.

De clic en O K y despus en Sig u ien te para iniciar la instalacin.

Copyright 2013 - Bizagi

2213

4. Una vez se complete la instalacin, el sistema le notificar que debe reiniciar el equipo. Nota Despus de configurar el IIS 5 o 6, es posible que requiera de configuracin adicional para cada aplicacin Web que crea Bizagi. Esto significa que despus de crear un proyecto Bizagi, debe revisar los pasos siguientes para cada proyecto. Crear un mapeo de ISAPI (ISAPI Wildcard mapping) que referencie el filtro ASP.NET ISAPI: Abra el administrador del IIS (IIS Manager) y ubique su sitio web (expanda los items para navegar) . En IIS 5, de clic derecho sobre su directorio virtual (de la aplicacin) y seleccione las propiedades. En IIS 6, de clic derecho sobre su sitio y seleccione las propiedades. En IIS 5, seleccione la pestaa del directorio virtual. En IIS 6, seleccione la pestaa del directorio de inicio Home. De clic en el botn de configuracin. La pestaa para el mapeo a nivel de aplicaciones debe estar visible. De clic en el botn de insertar. En el texto de ejecutable (Executable), digite la ruta completa al ensamblado del filtro ISAPI (ASP.NET ISAPI filter DLL). Para ASP.NET 4, esta ruta usualmente es: "C:\Windows\Microsoft.NET\Framework\v4.0.30319 \aspnet_isapi.dll" En el texto de extensin (Extension), digite: .* Importante: Desmarque la opcin de verificar (Verify). De clic en Ok en ambos dilogos para retornar al administrador del IIS (IIS Manager). Hemos finalizado los cambios. Ejecute un iisreset

Consideraciones adicionales
Tenga en cuenta: 1. Si se instala el IIS despus de instalar el Framework de .NET de Microsoft, es posible que tenga que registrar dicho framework en el IIS de manera manual. Para ello, se puede utliizar el comando aspnet_regiis -i desde la ruta del framework (por defecto en C: \Windows\Microsoft.NET\Framework\[version]\. 2. Que el IIS debe tener el sitio por defecto llamado Default Web site, ya que all Bizagi crear el Portal de Trabajo para los proyectos.

6.13

Instalacin de un SMTP local

El siguiente artculo ilustra cmo configurar el Servidor SMTP como servicio, que se provee por los componentes de Internet Information Services (IIS). A travs de este servicio, es posible enviar notificaciones por correo desde los Procesos de Bizagi, como se describe en las opciones avanzadas para el Servidor de notificaciones.

2214

Copyright 2013 - Bizagi

La siguiente seccin se enfoca en cmo instalar el Servidor SMTP en un sistema operativo Windows Server 2008 o 2008 R2. Nota Windows 7 incluye IIS 7 tambin. Sin embargo, en este sistema operativo no se encuentra disponible el servicio SMTP debido a una restriccin del fabricante mismo (Microsoft). En Windows 7 no es posible configurar un servicio SMTP local para el envo de correos por lo que debe usarse un servicio de terceros.

Windows Server 2008 or Windows Server 2008 R2

El siguiente procedimiento aplica para la versin 7 de IIS. 1. Inicie el administrador del Servidor. Vaya a In icio -> H erram ien tas ad m in istrativ as-> A d m in istrad o r d el serv id o r.

2. Adicione los componentes.

Copyright 2013 - Bizagi

2215

Para adicionar el Servidor SMTP, seleccion la opcin de A d icio n ar en el item de caracteristicas .

3. Seleccione SMTP Server. Marque la casilla del componente Sm tp serv er y las herramientas de administracin Rem o te Serv er A d m in To o ls.

2216

Copyright 2013 - Bizagi

Revise los componentes marcados, y de clic en In stalar para adicionar estas caracteristicas.

4. Inicie el servicio Simple Mail Transfer Protocol (SMTP). Una vez que se haya completado la instalacin del Servidor SMTP, vaya a los servicios Windows de la mquina y asegrese de tener ejecutndose el SMTP:

Copyright 2013 - Bizagi

2217

Para revisar, ubique el Servicio Sim p le M ail Tran sfer P ro to co l. Debe estar con estatus de iniciado :

6.14

Configuracin de SQL Server Introduccin

La Suite BPM de Bizagi utiliza una Base de datos como el repositorio de los Procesos. Microsoft SQL Server se soporta como motor de Base de datos para ser este repositorio. Este artculo ilustra cmo configurar una instancia SQL Server para trabajar con Bizagi. La configuracin que se describe a continuacin utiliza las herramientas de configuracin y herramientas cliente de SQL Server, tal como: SQL Server Management Studio y SQL Server

2218

Copyright 2013 - Bizagi

Configuration Manager. Tenga en cuenta que SQL Server Management Studio no se instala por defecto por lo que debe instalarse y descargarse desde las pginas oficiales de Microsoft (no tiene costo).

Prerequisitos
Bizagi soporta las siguientes versiones de SQL Server: SQL Server 2012 (versin 11.0.2100 o superior). Esta versin est soportada para las ediciones Bizagi Enterprise .NET y Bizagi Xpress. SQL Server 2008 R2 Service Pack 1 (versin 10.50.2500 o superior). SQL Server 2008 Service Pack 1 (versin 10.00.2531 o superior). SQL Server 2005 Service Pack 2 (versin 9.00.3042 o superior). Las ediciones Enterprise, Standard o Express son todas soportadas.

Nota La instancia de Base de datos debe instalarse con una intercalacin (collation) que sea sensible a maysculas, case-insensitive (CI), y no debe ser una intercalacin del idioma turco.

Qu versin tengo?
Para determinar la versin de SQL Server y su detalle (p.e, la edicin), ejecute el siguiente comando desde SQL Server Management Studio (habindose conectado a su instancia): Select @@version

Esta consulta debe mostrar el detalle completo de la instancia:

Copyright 2013 - Bizagi

2219

Configuracin bsica
Para configurar la instancia de SQL Server para trabajar con Bizagi, se requiere revisar lo siguiente: 1. Tener el modo de Autenticacin SQL Server habilitado. Para revisar esta configuracin, de clic derecho sobre la instancia y de clic sobre sus p ro p ied ad es:

Luego, en las opciones de Seg u rid ad, asegrese de est marcado A u ten ticaci n SQ L Serv er y W in d o w s.

2220

Copyright 2013 - Bizagi

De clic en O K. 2. Tener una cuenta de login utilizando la Autenticacin SQL Server. Esa cuenta login es la que se utiliza para crear proyectos de Bizagi, y para la aplicacin en ejecucin. Se requiere que tenga habilitada el modo de autenticacin SQL Server, como se revisa desde Seg u rid ad -> Lo g in s. Para ello, haga clic derecho sobre el login y seleccione sus p ro p ied ad es:

Copyright 2013 - Bizagi

2221

Ntese que tambin se debe asegurar que su contrasea no expire. Asegrese que la cuenta est habilitada (en el item de Statu s):

2222

Copyright 2013 - Bizagi

De clic en O K. Tenga en cuenta que si no desea utilizar el login sa que se usa por defecto (la super cuenta de usuario), puede optar por crear un login nuevo y dedicarlo al uso de Bizagi, siempre y cuando se otorguen los permisos necesarios a este login.

Configuracin para conexiones remotas

En escenarios donde hay un Servidor de Base de datos dedicado (diferente al Servidor BPM de Bizagi), se requiere asegurar que la configuracin de SQL Server considere lo siguiente. 1. Asegrese de permitir las conexiones remotas . Esta propiedad se revisa desde el SQL Server Management Studio, en las propiedades de la instancia:

Copyright 2013 - Bizagi

2223

En el item Co n ex io n es, revise la propiedad P erm itir co n ex io n es rem o tas a este serv id o r:

2224

Copyright 2013 - Bizagi

De clic en O K. 2. Asegrese de habilitar el protocolo TCP/IP para la conexin. Para esta configuracin, inicie la herramienta SQL Server Configuration Manager.

Copyright 2013 - Bizagi

2225

En la instancia especfica de Base de datos (bajo SQ L Serv er N etw o rk Co n fig u ratio n ), habilite el protocolo TCP/IP haciendo clic derecho sobre l, y seleccionando H ab ilitar :

En las propiedades TCP/IP, se recomienda seleccionar un puerto TCP explcitamente (por defecto es 1433) de manera que se garantice que no se utilizarn puertos dinmicos:

2226

Copyright 2013 - Bizagi

De clic en O K. 4. Inicie el Browser de SQL Server. En la misma configuracin a travs de SQL Server Configuration Manager, asegrese de tener en un estatus de iniciado, el servicio SQL Server Browser.

Ntese que esto requiere que no hayan firewalls (cortafuegos) o bloqueos para el puerto de servicio TCP de esta instancia. Si realiz cambios en esta configuracin, es posible que se deba reiniciar el servicio de la instancia.

Copyright 2013 - Bizagi

2227

6.15

Cambiar el login usado en SQL Server Introduccin

Las polticas de seguridad en las compaas pueden a menudo restringir el uso del login sa en instancias SQL Server (la cuenta de sper usuario utilizada por Bizagi por defecto). Debido a este motivo, en este articulo presentamos cmo establecer o cambiar la cuenta de login a una instancia SQL Server para trabajar con Bizagi. Este cambio se describe desglosadamente para que aplique tanto al ambiente de desarrollo (construccin de la solucin BPM), y para la ejecucin de los Procesos (la configuracin del Portal de Trabajo).

Antes de Comenzar
Aunque es posible cambiar la cuenta de login, tenga en cuenta que se debe seguir utilizando en su configuracin, la Autenticacin modo SQL Server. Para ms informacin sobre la configuracin en SQL Server, consulte Cmo configurar una instancia de SQL Server para trabajar con Bizagi. Adicionalmente, si se desea cambiar la cuenta de login para el acceso a una instancia SQL Server, es importante notar que son 2 tipos diferentes de permisos que se requieren en proyectos Bizagi dado que esta configuracin puede ser diferente segn el componente que realiza el acceso: 1. La configuracin del login usado por Bizagi Studio, el cual requiere privilegios para crear objetos en la Base de datos (dado que es el ambiente de desarrollo y construccin de la solucin). 2. La configuracin del login usado por el Portal de Trabajo (y el servicio Programador). Esta se utiliza para ejecutar los Procesos. Aplica para la ejecucin en cualquier ambiente, por ejemplo para el Portal de Trabajo en produccin. Bizagi utiliza por defecto el login sa para las 2 configuraciones, pero esto se puede cambiar como se describe a continuacin.

Consideraciones Adicionales
Si no se han creado proyectos con Bizagi, entonces el login sa no se ha usado todava en archivos de configuracin ni es instanciado por proyecto alguno. Si este es el escenario, entonces bastar con tener un login con las directrices que se enumeran, y despus utilizar este login para la creacin del proyecto con Bizagi. Si por el contrario, usted ya tiene proyectos creados (donde por defecto se utiliz el login sa), entonces adems del login que debe configurar, debe ajustar los archivos de configuracin del proyecto.

Definir el login de SQL Server para Bizagi Studio

2228 Copyright 2013 - Bizagi

La siguiente seccin describe cmo configurar un login diferente para el ambiente de desarrollo (usado por Bizagi Studio para la implementacin del proyecto). Ntese que a travs de Bizagi Studio, se crean nuevos objetos en la Base de datos (entidades, atributos y relaciones, etc) y por lo tanto, es estrictamente necesario que el login cuente con las siguientes caracteristicas:

Autenticacin modo SQL Server

El login debe utilizar la Autenticacin SQL Server:

Roles del Servidor

En los roles de servidor que se especifican para el login se debe incluir: p u b lic y sy sad m in .

Copyright 2013 - Bizagi

2229

Ntese que este login no necesita especificar mapeos de usuario (User mappings) de una Base de datos en particular. Esto se debe a que este mismo login se podr utilizar para todos los proyectos que se abran desde esta instalacin. Tan pronto se tenga este login configurado, se puede especificar para la creacin de nuevos proyectos para que Bizagi lo utilice automticamente en sus archivos de configuracin. Para ms informacin acerca de la configuracin de nuevos proyectos, consulte crear un nuevo proyecto.

Definir el login para la ejecucin de Procesos

La siguiente seccin describe cmo configurar un login diferente para el acceso desde el Portal de Trabajo y Programador, para la ejecucin de los Procesos en cualquier ambiente.

2230

Copyright 2013 - Bizagi

La configuracin a continuacin puede ser realizada de manera separada para cada ambiente del proyecto (desarrollo, pruebas y produccin), de manera que la ejecucin de los Procesos en cada ambiente utilice un login diferente (recomendado). En servidores donde se tenga ms de un proyecto, es igualmente posible tener un login diferente para cada proyecto. Para configurar un login que se use por el Portal de Trabajo o el servicio Programador se requieren las siguientes caractersticas:

Autenticacin modo SQL Server

El login debe utilizar la Autenticacin SQL Server:

Roles del Servidor

Copyright 2013 - Bizagi

2231

En los roles de servidor que se especifican para el login se debe incluir: p u b lic.

Mapeos de usuario
El login debe incluir los siguientes mapeos para la Base de datos especfica (del ambiente de ese proyecto): "db_datareader", "db_datawriter", "public", "rlBA_SQL_BizagiWebApp" y "rlBA_SQL_ExecuteBizagiSPs".

2232

Copyright 2013 - Bizagi

Una vez que se haya configurado el login, se debe usar en la cadena de conexin que tiene establecida el Portal de Trabajo y Programador en sus archivos de configuracin respectivos. Para ello, se deben editar estos archivos como se menciona a continuacin.

Editar el string de conexin al Portal de Trabajo

Editar el string de conexin del Portal de Trabajo En Bizagi Enterprise .NET y Bizagi Xpress, los archivos de configuracin que definen esta conexin son los XML de extensin .config. Para el Portal de Trabajo, la configuracin queda a nivel del sitio Web en el descriptor "web.config" del IIS.

Copyright 2013 - Bizagi

2233

Este archivo se ubica en la carpeta llamada "Web application" del ambiente del proyecto (por defecto en "C:\Bizagi\[edicin_Bizagi]\Projects\[su_proyecto]\WebApplication"). Para editar este archivo "web.config" se deb ubicar el elemento "DSNDB" y modificar su valor de manera que se cambie la informacin de "[mi_nuevo_login]" y "[contrasea_mi_login]" segn:

<add key="DSNDB" value="Current Language=us_english;Initial Catalog= [MY_PROJECT_DATABASE];Data Source=[MY_SQL_SERVER_INSTANCE];User ID= [MY_NEW_LOGIN];Password=[MY_LOGIN_PASSWORD];" /> Ntese que para la informacin de la contrasea se puede ingresar la misma como una cadena encriptada. Para ello, se puede utilizar la opcin de encripcin que se presenta desde el Portal de Trabajo. Este mismo login e informacin se debe utilizar tambin en la configuracin del servicio Programador. Nota Si su proyecto utiliza Bizagi Enterprise JEE, el string de conexin del Portal de Trabajo se especifica al definir la fuente de datos en el Servidor de aplicaciones JEE.

Editar el string de conexin del Programador

En Bizagi Enterprise .NET y Bizagi Xpress, los archivos de configuracin que definen esta conexin son los XML de extensin .config. Para el Programador, la configuracin queda en el archivo "Bizagi.Scheduler.Services.exe.config" de la carpeta llamada "Scheduler" de ese ambiente del proyecto (por defecto en "C:\Bizagi\[edicin_Bizagi] \Projects\[su_proyecto]\Scheduler"). Para editar este archivo "Bizagi.Scheduler.Services.exe.config" se deb ubicar el elemento "DSNDB" y modificar su valor de manera que se cambie la informacin de "[mi_nuevo_login]" y "[contrasea_mi_login]" segn: <add key="DSNDB" value="Current Language=us_english;Initial Catalog= [MY_PROJECT_DATABASE];Data Source=[MY_SQL_SERVER_INSTANCE];User ID= [MY_NEW_LOGIN];Password=[MY_LOGIN_PASSWORD];" /> Ntese que para la informacin de la contrasea se puede ingresar la misma como una cadena encriptada. Para ello, se puede utilizar la opcin de encripcin que se presenta desde el Portal de Trabajo.

Nota Si su proyecto utiliza Bizagi Enterprise JEE, el string de conexin del Programador se especifica al definir la fuente de datos en el Servidor de aplicaciones JEE.

2234

Copyright 2013 - Bizagi

6.16

Autorizacin para trabajar en un servidor remoto

Con Bizagi BPM Suite se puede establecer un entorno para trabajo colaborativo (para el trabajo en equipo en el Desarollo de un proyecto), donde ms de una persona trabajan de manera simultnea en la implementacin de Procesos. Para configurar este entorno, se debe crear el proyecto en un Servidor BPM de comn acceso donde los miembros del equipo de trabajo puedan cargar y acceder el proyecto. Para este Servidor BPM, se requiere configurar los permisos para que se pueda: abrir el proyecto de una manera remota, o realizar un Deployment de los Procesos (cuando estn lista la implementacin para un ambiente de pruebas o produccin).

Para lo anterior, se debe instalar la misma versin de Bizagi tanto en el Servidor BPM, como en las estaciones de trabajo de cada miembro del equipo. Este artculo describe los permisos requeridos para trabajar en proyectos de Bizagi de una manera remota (con un enfoque colaborativo).

Realizar un Deployment a un Servidor remoto

Cuando se realiza un Deployment, se crea un proyecto de Bizagi para ese ambiente en el Servidor BPM destino (sea pruebas o produccin). Para ello, es requerido que la cuenta que se usa en Bizagi Studio tenga pertenezca al g ru p o d e A d m in istrad o res B izag i y a los A d m in istrad o res d el Serv id o r. Si no es as, o se tiene el Servidor en una configuracin de red por fuera del dominio, entonces existe la posibilidad de ingresar las credenciales de una cuenta autorizada en el momento del Deployment:

Copyright 2013 - Bizagi

2235

Ntese que para asegurarse que estas cuentas pertenezcan a los grupos en el Servidor, requiere de una cuenta con permisos de administracin. Para revisar esta configuracin de las cuentas de usuario, revise que: 1. La cuenta pertenece al grupo de Bizagi del Servidor BPM. 2. La cuenta pertenece al grupo de Administradores del Servidor BPM. Revisar que una cuenta pertenezca al grupo Bizagi 1. De clic derecho sobre MiPC para seleccionar la opcin de administrar el equipo:

2236

Copyright 2013 - Bizagi

2. Vaya a la vista de grupos en los items a la izquierda de la ventana de administracin del equipo:

Copyright 2013 - Bizagi

2237

3. Revise las propiedades. En caso de que el usuario no est incliudo, utilice la opcin de A d icio n ar al g ru p o , desde las mismas opciones del clic-derecho del determinado grupo. Realice esto para el g ru p o B izag i: 4. Para registrar un usuario dentro del grupo, use el botn A d icio n ar. Desde la nueva ventana podr seleccionar la cuente del usuario:

2238

Copyright 2013 - Bizagi

Ingrese el nombre del usuario y de clic en O K. Este usuario aparecer registrado en la lista del grupo.

Copyright 2013 - Bizagi

2239

De clic en O K para confirmar el cambio. Revisar que una cuenta pertenezca al grupo de Administradores De manera similar a lo descrito en la seccin inmediatamente anterior, para revisar que la cuenta de usuario pertenezca al grupo de administradores: Administre los grupos del Servidor, pero esta vez incluya el usuario en el grupo de Administradores.

2240

Copyright 2013 - Bizagi

Conectarse a un proyecto remoto

Cuando se ha creado el proyecto en el Servidor BPM para trabajo en equipo, los usuarios en las estaciones de trabajo, deben unirse al proyecto. Al unirse al proyecto, se conectan al servidor remoto para trabajar en los Procesos de Bizagi. Para ello, se debe revisar que la cuenta de usuario est incluida dentro del grupo de Bizagi del Servidor. De no ser posible realizar este ajuste, tendr la opcin de especificar unas credenciales autorizadas al momento de abrir el proyecto existente:

Copyright 2013 - Bizagi

2241

Para revisar o ajustar la configuracin, revise los pasos de la primera parte de la seccin anterior (Revisar que una cuenta pertenezca al grupo Bizagi).

Conectarse a un proyecto remoto con la seguridad de Bizagi Studio

Adicional a lo anterior, cuando se ha habilitado la Seguridad de Bizagi Studio para definir los privilegios dentro del equipo de trabajo, se puede optar por: adicionar cualquier usuario de manera explcita a lista y de esta forma permitir a Bizagi que realice el ajuste del grupo del Servidor de manera automtica (sin necesidad de hacerlo directamente por la administracin del equipo). Para ms informacin sobre esto, consulte la Seguridad de Bizagi Studio.

Si su proyecto no utiliza esta funcionalidad de Seguridad de Bizagi Studio, si debe hacerlo de manera remota. Para ello, revise los pasos de la primera parte de la seccin anterior (Revisar que una cuenta pertenezca al grupo Bizagi).

2242

Copyright 2013 - Bizagi

6.17

Configuracin de ODS para el anlisis de Procesos Introduccin

Bizagi presenta la opcin de configurar un Almacn de datos operacionales (ODS), el cual est diseado para mejorar la disponibilidad y rendimiento de los Procesos ejecutndose sobre el Servidor BPM. El concepto detrs del ODS de Bizagi, es separar los recursos involucrados en las opciones de Anlisis y BAM del Portal de Trabajo, de los dems recursos empleados en las actividades del da a da de los Procesos. Vea ms informacin sobre las opciones de Anlisis e indicadores. Esta funcionalidad es especialmente poderosa y til en aplicaciones de misin crtica, donde se maneja un gran volmen de datos dentro de la informacin de solicitudes de consultas de anlisis, y no debemos afectar el rendimiento de la ejecucin de los Procesos en la aplicacin.

Cmo funciona?
A travs del ODS de Bizagi, las opciones de Anlisis y BAM utilizarn una conexin diferente, a una Base de datos replicada con respecto a la Base de datos donde se realizan las transacciones diarias. Esto permite que las solicitudes realizadas sobre opciones de anlisis (opciones enfocadas a monitoreo, reportes, mejora continua e indicadores) donde se maneja un gran volmen de datos, se lleven a cabo sin competir con los recursos asignados a la ejecucin como tal de los Procesos. El siguiente diagrama ilustra el diseo en Bizagi ODS:

Lo que debe hacer

Copyright 2013 - Bizagi 2243

Para utilizar el ODS de Bizagi, como prerequisito, se debe configurar la replicacin de la Base de datos repositorio de los Procesos. Esta configuracin de replicacin se realiza desde las opciones del manejador de la instancia de la Base de datos como tal, donde dichas opciones difieren de acuerdo al motor de Base de datos (SQL Server u Oracle)

Una vez que se establezca la replicacin de acuerdo a las recomendaciones enumeradas a continuacin, la configuracin del ODS en Bizagi es muy simple: se especifican los parmetros de conexin a la Base de datos rplica. Ms informacin sobre cmo llevar a cabo la replicacin, se puede revisar en los enlaces externos: Sobre SQL Server 2008 o 2008 R2: http://technet.microsoft.com/en-us/library/ms151198.aspx. Sobre SQL Server 2005: http://technet.microsoft.com/en-us/sqlserver/bb895875. Sobre Oracle: http://www.orafaq.com/wiki/Advanced_Replication_FAQ

La siguientes recomendaciones se presentan como gua para enumerar los aspectos importantes que se deben tener en cuenta en la configuracin de la replicacin de la Base de datos de Bizagi.

Lista gua para la configuracin de la replicacin

Cabe mencionar que la configuracin apropiada de una replicacin de Base de datos, as como su configuracin de seguridad, son responsabilidad del dba. Esta gua y recomendaciones se enfoca en buenas prcticas y requerimientos de cara a la configuracin del ODS en Bizagi.

1. La Base de datos de Bizagi es la nica que publica informacin. Esto significa que sin importar cuntos distribuidores intermediaros se utilicen, la Base de datos de los

2244

Copyright 2013 - Bizagi

Procesos de Bizagi debe ser la nica de la cul proviene realmente la replicacin de datos.

2. Replicacin en tiempo real. Para lograr la actualizacin de informacin de la manera ms acertada, y que se refleje la totalidad de los datos al consultar las opciones de Anlisis y BAM, se debe transmitir rpidamente la informacin en la replicacin. Por ejemplo y si se utiliza SQL Server, la replicacin transaccional cubre este requerimiento. 3. Replicacin en una sola va. Las operaciones en el ODS no deben afectar la Base de datos principal de Bizagi. En las consultas sobre el ODS, puede guardarse informacin sobre las mismas, e internamente se manejan agregaciones, datos temporales, tablas intermedias y otra informacin no relevante para la ejecucin de Procesos. Por lo tanto, esto no debe verse reflejado hacia la Base de datos principal. Por ejemplo y si se utiliza SQL Server, nuevamente la replicacin transaccional cubre este requerimiento. 4. Estimacin apropiada de bloques de replicacin. Dado que hay transacciones de escritura en la Base de datos que pueden llegar a involucrar una gran cantidad de datos (por ejemplo, cuando se adjuntan archivos en las instancias de Proceso), se recomienda que se realice una estimacin adecuada de los artculos de replicacin y su configuracin. Esta estimacin puede realizarse sobre el ambiente de pruebas de la solucin. Por ejemplo y si se utiliza SQL Server, el parmetro de Max Text replication Data define el tamao que en trminos de Bizagi, es apropiado usualmente de 3 a 5 MB. 5. Credenciales apropiadas para la replicacin. Es frecuente y obedece a una buena prctica, que la Base de datos principal y el ODS se ubiquen en Servidores de Base de datos diferentes. Siendo as, asegrese de tener las cuentas del dominio para ejecutar las tareas y servicios de replicacin, como por ejemplo las que inician el Agente de SQL Server. Evite utilizar cuentas como la del sistema local ("Local System"), dado que estas credenciales no tienen el acceso a otras ubicaciones en la red, e igualmente no se autentica frente a la red.

Definir el ODS en Bizagi

Una vez que se haya configurado la replicacin de la Base de datos hacia el ODS, la configuracin de la conexin hacia el ODS en Bizagi se realiza a travs del Management Console para cualquier ambiente (produccin, pruebas, desarrollo), como se describe a continuacin: 1. Edite las opciones del entorno. Ejecute el Management Console y abra su proyecto Bizagi en el ambiente de pruebas o produccin. Vaya a la pestaa Avanzado, de clic sobre Opciones para abrir la configuracin del entorno.

Copyright 2013 - Bizagi

2245

Esta opcin tambin est disponible a travs de Bizagi Studio para el ambiente de desarrollo:

2246

Copyright 2013 - Bizagi

2. Ubique la configuracin del ODS. Debajo de las opciones avanzadas, ubique la seccin del Almacn de datos operacional, y configure la conexin hacia su Base de datos replicada.

3. Configure la conexin. Para configurar la conexin, primero escoja el tipo de Proveedor. Para Bizagi Enterprise .NET y Bizagi Xpress Cuando se utiliza Bizagi Enterprise .NET o Bizagi Xpress, seleccione SQ L Serv er u O racle como el tipo de Proveedor (segn el motor de su Base de datos), y configure los detalles adicionales de conexin a la Base de datos replicada (como se describe a continuacin).

Copyright 2013 - Bizagi

2247

Para SQL Server, ingrese los detalles de la cadena de conexin teniendo en cuenta: Servidor: El Servidor e instancia donde se encuentra la Base de datos replicada. Base de datos: La Base de datos replicada (ODS). Login: La cuenta para acceder a la instancia de SQL Server. Contrasea: La contrasea para esa cuenta de login.

Para Oracle, ingrese los detalles de la cadena de conexin teniendo en cuenta: Servicio: La cadena de conexin a la instancia de Oracle. Debe tener el siguiente formato: [ServidorBD]:[puerto]/[servicio] Usuario: El esquema de usuario que representa la Base de datos replicada. Contrasea: La contrasea para ese esquema de usuario.

Para Bizagi Enterprise JEE Cuando se utiliza Bizagi Enterprise JEE y se utiliza la funcionalidad del ODS, se debe primero configurar una fuente de datos en el Servidor de Aplicaciones JEE. Dicha fuente de datos debe contener el detalle de la conexin a la Base de datos replicada, lo cual implica configurar un Data Source (paso que vara ligeramente de acuerdo al Servidor de Aplicaciones JEE en s, sea WebSphere, Weblogic o JBoss).

2248

Copyright 2013 - Bizagi

Para ms informacin sobre este paso, consulte Definir una fuente de datos para el ODS en el Servidor de aplicaciones JEE. Una vez que se haya definido la fuente de datos en el Servidor JEE, seleccione la opcin de Dataso u rce Ex tern o como el tipo de Proveedor. Seguidamente, ingrese el nombre exacto del Data Source como se configur en el Servidor JEE.

4. Ejecucin Una vez que esta informacin est configurada, las opciones de Anlisis y BAM del Portal de Trabajo utilizarn inmediatamente la conexin al ODS. Es decir, que las solicitudes y recursos estarn enfocados en la Base de datos replicada, sin afectar el rendimiento de las actividades diarias de los Procesos.

Copyright 2013 - Bizagi

2249

6.17.1 Definicin del ODS en el Servidor de Aplicaciones JEE

Introduccin
When using Bizagi Enterprise JEE edition, using the ODS feature requires that you define the Data Source in your JEE Application Server that connects to your replicated Database. This feature is optional and it is recommended to improve the BPM Server's performance and availability. For more information about the concept behind this feature, refer to Configuring Bizagi ODS for Process Analytics.

Definicin de la fuente de datos del ODS

Once you have configured your replicated Database, make sure you register and define the Data source at your JEE Application Server. This step slightly varies according to the JEE Application Server itself (WebSphere, Weblogic, JBoss).

Configuracin en WebSphere
Para definir y registrar la fuente de datos al ODS en WebSphere, tenga en cuenta que puede utilizar el Proveedor JDBC que se tenga previamente definido para la conexin al Portal de Bizagi. Al reutilizar este proveedor, solamente se debe crear una nueva fuente de datos (un Data Source). Para ello, acceda a la consola administrativa y ubique el panel a la izquiera para ir rpidamente al enlace de Fuentes de datos ( Data so u rces), ubicado todava bajo la seccin de recursos ( Reso u rces) sobre el item JDB C. Asegrese de seleccionar el scope que incluye la instancia del servidor (o el clster si tiene una

2250

Copyright 2013 - Bizagi

configuracin en clster). Cree una fuente de datos haciendo clic sobre el botn Nuevo ( N ew ). En la configuracin de la nueva fuente de datos, ingrese la siguiente informacin: Data so u rce n am e (nombre de la fuente de datos): Ingrese un nombre nico. Tenga presente que este nombre ser el que debe referenciar para el registro del ODS en la configuracin desde Bizagi. JN DI n am e (nombre JNDI): Puede ingresar el mismo nombre que asign en la anterior propiedad (el nombre de la fuente de datos).

Seguidamente, marque la opcin de seleccionar un proveedor existente ( Select an ex istin g JDB C P ro v id er). De esta manera, seleccione el Proveedor de acuerdo a su motor de Base de datos (Oracle o SQL Server).

Copyright 2013 - Bizagi

2251

Si usted utiliza una Base de datos Oracle, de clic en Siguiente ( N ex t) y asegrese de editar la URL de la cadena de conexin. Para el valor de la URL, ingrese la informacin de conexin a su instancia de Oracle. Esta conexin debe tener el siguiente formato: jdbc:oracle:thin:@[database_server]:[port_number]:[service_name] Considere: o d atab ase_serv er: El Servidor de Base de datos. Puede utilizar el SID en cambio. o p o rt_n u m b er: El puerto bajo el cual el servicio de la Base de datos atiende. En Oracle por defecto, es el puerto 1521. o serv ice_n am e: El nombre del servicio de la instancia Oracle. Una vez que haya configurado la conexin a su instancia Oracle, de clic en Siguiente ( N ex t ) en las ventanas a continuacin (hasta que se llegue al final de los pasos asistidos, donde se debe dar clic en Finalizar -- F in ish -- para crear la fuente de datos). Por otro lado, y si usted utiliza una Base de datos SQL Server, de clic en Siguiente ( N ex t) en las ventanas a continuacin (hasta que se llegue al final de los pasos asistidos, donde se debe dar clic en Finalizar -- F in ish -- para crear la fuente de datos). No se requiere configuracin adicional e igualmente se pueden mantener los valores por defecto de WebSphere.

De clic sobre la fuente de datos creada (independientemente del motor de Base de datos: Oracle o SQL Server), para configurar las propiedades adicionales. Para ello, de clic en el enlace de propiedades personalizadas ( Cu sto m p ro p erties) ubicado en la seccin de Propiedades adicionales ( A d d itio n al P ro p erties).

2252

Copyright 2013 - Bizagi

Edite las propiedades como se describe a continuacin (de acuerdo a su motor de Base de datos), y asigne los valores correspondientes de la conexin. Para Oracle: Cree 2 nuevas propiedades: usuario ( u ser) y contrasea ( p assw o rd). Para sus valores considere: o u ser: El esquema de usuario que representa el proyecto Bizagi. o p assw o rd: La contrasea de ese esquema de usuario. Para SQL Server: Edite las siguientes propiedades. o serv erN am e: El nombre del Servidor de Base de datos. o p o rtN u m b er: El puerto bajo el cual la instancia atiende. En SQL Server y por defecto, es el puerto 1433. o d atab aseN am e: El nombre de la Base de datos que corresponde al proyecto. o u ser: La cuenta login para acceder a la Base de datos. o p assw o rd: La contrasea de esa cuenta login. Al finalizar con la edicin de propiedades, haga clic en Guardar( Sav e) para aplicar los cambios.

Configuracin en Weblogic
Para definir y registrar la fuente de datos del ODS en Weblogic, tenga en cuenta que solamente se debe crear la fuente de datos (se selecciona un proveedor de datos existente). Para ello, acceda a la consola administrativa y vaya a la seccin de Servicios ( Serv ices) y de clic sobre fuentes de datos ( Data So u rces).

Copyright 2013 - Bizagi

2253

Cree una nueva fuente de datos dando clic sobre Nuevo ( N ew ) y especificando que es una fuente de datos de tipo genrica ( Gen eric Data So u rce). Para la fuente de datos, especifique: Data so u rce n am e (nombre de la fuente de datos): Ingrese un nombre nico. Tenga presente que este nombre ser el que debe referenciar para el registro del ODS en la configuracin desde Bizagi. JN DI n am e (nombre JNDI): Puede ingresar el mismo nombre que asign en la anterior propiedad (el nombre de la fuente de datos). Seguidamente, y para una Base de datos replicada en Oracle, seleccione Oracle como el tipo de Base de datos ( Datab ase ty p e). De clic en Siguiente ( N ex t) y seleccione el driver Oracles Driver (Thin) for instance connections; Versions: 9.0.1 and later ( Datab ase Driv er). Si est utilizando una Base de datos replicada en SQL Server, entonces seleccione MS SQL Server como el tipo de Base de datos ( Datab ase ty p e). De clic en Siguiente ( N ex t) y seleccione el driver Microsoft's MS SQL Server Driver (Type 4) Versions:2005 and later ( Datab ase Driv er).

De clic en Siguiente ( N ex t) para especificar los detalles de la conexin, independientemente de si su motor de Base de datos es Oracle o SQL Server. En ello, asegrese de editar y revisar la URL de la conexin. Finalice la configuracin cerciorndose que la fuente de datos aplique al contexto de su instancia (o de su clster, si utiliza una configuracin con esquema de alta disponibilidad).

Finalmente, asegrese de activar los cambios realizados.

2254

Copyright 2013 - Bizagi

Qu sigue?
Una vez haya finalizado, asegrese de configurar la fuente de datos del ODS en Bizagi (como se describe en Configuracin del ODS en el Servidor de aplicaciones JEE), teniendo en cuenta el uso del nombre exacto de la fuente de datos que se defini en este artculo.

6.18

Configuracin de Bizagi para el acceso seguro desde Internet

Introduccin
Este artculo describe cmo montar Bizagi sobre un Servidor HTTP para el acceso seguro desde internet. Los Procesos de Bizagi se pueden acceder tanto desde intranet, como desde internet, con las medida adecuada de seguridad en la cual se consira un proxy inverso. A travs de esta guia se ilustra cmo configurar un Servidor HTTP Apache con la posibilidad de utilizar SSL, y activando el mdulo del proxy inverso de manera que el Portal de Trabajo de Bizagi se acceda desde internet desde cualquier dispositivo (porttiles, telfonos inteligentes, tabletas). Lo siguiente representa la arquitectura considerada:

1. Este servidor se monta para redirigir el acceso desde Internet hacia Bizagi con protocolos seguros. Para ambientes de alta disponibilidad, se recomienda montar 2 de estos servidores. 2. Los usuarios en la intranet continuarn accediendo el Portal de Trabajo de Bizagi de igual manera.

Copyright 2013 - Bizagi

2255

Utilizar el Servidor HTTP Apache

Para utilizar el Servidor HTTP Apache, instlelo en el Servidor dentro de la Zona desmilitarizada (DMZ) y configrelo de acuerdo a como se indica en las secciones inferiores.

Instalar el Servidor HTTP Apache

Para instalar Apache, lleve a cabo estos pasos: 1. Descargue el instalador del Servidor HTTP Apache desde la pgina oficial. 2. Instale el Servidor. Ntese que los parmetros configurados al momento de la instalacin pueden modificarse ms adelante. La ruta que se seleccione para instalar el Servidor ser referenciado en este documento como <APACHE_HOME>.

Configuracin de seguridad
Para habilitar los mdulos avanzados de seguridad en Apache, los cuales incluyen el proxy inverso, siga estos pasos: 1. Configure las opciones del proxy de Apache, editando el archivo httpd.conf ubicado en la ruta <APACHE_HOME>\conf\. Este archivo puede editarse en sistemas operativos Windows a travs de la opcin en Inicio ->

2256

Copyright 2013 - Bizagi

Programas -> Apache HTTP Server -> Configure Apache Server -> Editar el archivo de configuracin httpd.conf.

2. Habilite el mdulo del proxy, removiendo el caracter "#" de las siguientes lneas: LoadModule LoadModule LoadModule LoadModule LoadModule LoadModule proxy_module modules/mod_proxy.so proxy_ajp_module modules/mod_proxy_ajp.so proxy_balancer_module modules/mod_proxy_balancer.so proxy_connect_module modules/mod_proxy_connect.so proxy_ftp_module modules/mod_proxy_ftp.so proxy_http_module modules/mod_proxy_http.so

Si desea habilitar y utilizar el protocolo de Secure Socket Layer (SSL), remueva el caracter "#" de la siguiente lnea:

LoadModule ssl_module modules/mod_ssl.so

Copyright 2013 - Bizagi

2257

Para ms informacin detallada sobre este mdulo de Apache, consulte la documentacin oficial.

3. Habilite el puerto del SSL incluyendo la siguiente lnea, ubicado debajo de las opciones donde escucha el servicio (Listen). Este paso aplica si se escoge habilitar el SSL en el paso anterior. Listen 443 Ntese que el puerto por defecto para el servicio es el por defecto del navegador (80), pero 8080 tambin es frecuentemente utilizado.

2258

Copyright 2013 - Bizagi

4. Configure las preferencias del proxy inverso. Si el Servidor HTTP Apache no utiliza un certificado digital y no se habilita el SSL, entonces incluya las siguientes lneas al final del archivo:

<IfModule mod_proxy.c> ProxyRequests off ProxyPass [path] [url] ProxyPassReverse [path] [url] </IfModule> En estas lneas, considere reemplazar los valores correspondientes de "[path] [url]" con: la ruta virtual y URL parcial del Servidor remoto. Para ello, la URL no debe contener query string (parmetros). Por ejemplo, si su proyecto de Bizagi se llama "ProcessCentral" y fue creado en el Servidor llamado "miServidor", entonces se debe configurar los valores para "path y url" con:

ProxyPass /ProcessCentral ProxyPassReverse /ProcessCentral

Por otro lado, si se configur el Servidor HTTP Apache para que utilice un certificado digital, por medio de SSL, entonces es necesario configurar el host virtual incluyendo las siguientes lneas:

Copyright 2013 - Bizagi

2259

NameVirtualHost *:443 <VirtualHost *:443> DocumentRoot "<APACHE_HOME>/htdocs" ServerName <YOUR_SERVER> <Directory "<APACHE_HOME>/htdocs"> Options Indexes FollowSymLinks MultiViews AllowOverride None SSLRequireSSL Order allow,deny Allow from all </Directory> SSLProxyEngine on <IfModule mod_proxy.c> ProxyRequests off ProxyPass / http://<YOUR_SERVER>/ ProxyPassReverse / http://<YOUR_SERVER>/ </IfModule> SSLEngine on

SSLCipherSuite ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP: +eNULL SSLCertificateFile "<LOCAL_PATH>/public.crt" SSLCertificateKeyFile "<LOCAL_PATH>/ApachePrivateKey.key" SSLCertificateChainFile "<LOCAL_PATH>/intermediate.crt"

<FilesMatch "\.(cgi|shtml|phtml|php)$"> SSLOptions +StdEnvVars </FilesMatch> <Directory "<YOUR_SERVER>/cgi-bin"> SSLOptions +StdEnvVars </Directory> BrowserMatch ".*MSIE.*" \ nokeepalive ssl-unclean-shutdown \ downgrade-1.0 force-response-1.0 </VirtualHost>

En estas lneas, considere reemplazar los valores correspondientes para: *<APACHE_HOME>: La ruta de instalacin de Apache. Tenga en cuenta que el formato en este archivo espera "/" (en vez de "\") como el caracter separador de carpeta. *<LOCAL_PATH>: La ruta donde se encuentran los archivos del certificado a usar por el SSL.

2260

Copyright 2013 - Bizagi

Para ms informacin y documentacin sobre las directivas y parmetros de SSL, consulte este enlace externo.

5. Guarde los cambios de este archivo y reinicie su Servidor HTTP Apache. En este punto hemos terminado la configuracin para acceder Bizagi desde internet de una manera segura, desde cualquier dispositivo.

Punto de chequeo
Para verificar la configuracin, y acceder al servicio, digite en un navegador desde afuera de la intranet: http://<YOUR_SERVER>:<APACHE_PORT_NUMBER>/

Con lo que esta solicitud se redirigir al Portal de Trabajo de Bizagi de manera automtica y segura.

6.19

Configuracin de Bizagi en Amazon WS

Bizagi es soportado en la nube. Puede configurar Bizagi de manera que se monte en una cuenta AWS (Amazon Web services), de manera que el Portal de Trabajo se acceda en servicios de la nube. Encuentre aqu una gua en ingls en PDF, escrita por Timothy Olsen y Richard Welke de la Universidad de Georgia. Este documento describe la instalacin del ambiente de una instancia de Amazon, y Bizagi para su acceso por Internet.

Copyright 2013 - Bizagi

2261

Parte VII
Temas Avanzados

Temas Avanzados
Los siguientes captulos incluyen temas avanzados de Bizagi.

7.1

Servicios Web de la Capa SOA

Este artculo provee el detalle tcnico sobre los Servicios Web que trae Bizagi incorporados en los proyectos. Para conocer sobre la Capa SOA de Bizagi, donde vienen estos servicios, consulte Invocar servicios de Bizagi desde otras aplicaciones. Siga los enlaces a los sub artculos para conocer ms acerca de los mtodos Web y servicios Web de la Capa SOA.

Bizagi Enterprise .NET y Bizagi Xpress

En proyectos que utilicen el IIS de Microsoft (soluciones .NET de Bizagi Enterprise .NET o Bizagi Xpress), los servicios Web de la Capa SOA se encuentran en: http://[nombre_servidor]/[proyecto_Bizagi]/WebServices/[componente_interno] .asmx?wsdl Considere que: [nombre_servidor] es el nombre del Servidor donde est el proyecto. [proyecto_Bizagi] es el nombre del proyecto de Bizagi. [componente_interno] es el nombre del componente el cual ofrece los servicios Web. Bizagi presenta 4 servicios Web: EntityManagerSOA, WorkflowEngineSOA, QuerySOA y RenderSOA.

Ejemplo: http://localhost/CreditApplication/WebServices/EntityManagerSOA.asmx?wsdl

Bizagi Enterprise JEE

En proyectos que utilicen Bizagi Enterprise JEE, los servicios Web de la Capa SOA se encuentran en: http://[nombre_servidor]:[puerto]/Bizagi-war/WebServices/ [componente_interno]?wsdl Considere que: [nombre_servidor] es el nombre del Servidor donde est el proyecto. [puerto] es el nmero de puerto sobre el cual inicia el Servidor de Aplicaciones JEE. [componente_interno] es el nombre del componente el cual ofrece los servicios Web. Bizagi presenta 4 servicios Web: EntityManagerSOA, WorkflowEngineSOA, QuerySOA y RenderSOA. Ejemplo: http://localhost:8080/Bizagi-war/WebServices/EntityManagerSOA?wsdl

Copyright 2013 - Bizagi

2263

7.1.1

Mtodos Web de WorkflowEngineSOA

Los mtodos Web publicados en W o rkflo w En g in eSO A son tiles para manejar el flujo de los Procesos a travs del motor de BPMN de Bizagi (por ejemplo: iniciar Procesos, ejecutar Actividades, disparar Eventos, abortar casos, entre otros). Este servicio Web y sus mtodos se acceden en la siguiente URL: Para Bizagi Enterprise .NET y Bizagi Xpress: http://[nombre_servidor]/[proyecto_Bizagi]/WebServices/ WorkflowEngineSOA.asmx?wsdl

2264

Copyright 2013 - Bizagi

Copyright 2013 - Bizagi

2265

Para Bizagi Enterprise JEE: En Servidores de Aplicaciones Weblogic y JBoss: http://[nombre_servidor]:[puerto]/Bizagi-war/WebServices/WorkflowEngineSOA? wsdl En WebSphere: http://[nombre_servidor]:[puerto]/Bizagi-war/WorkflowEngineSOAImplService/ WorkflowEngineSOAImplService.wsdl

Para informacin puntual sobre cada mtodo, consulte los sub artculos. 7.1.1.1 abortCasesAsString

Introduccin
Este mtodo se utiliza para abortar (cancelar) uno o ms casos en Bizagi (desde una aplicacin externa). Este mtodo recibe un nico parmetro de entrada el cual contiene principalmente: el identificador del caso (puede ser ms de un caso) y una razn detallada del motivo de porqu abortar esos casos, de la misma manera como se presenta esta opcin desde las opciones administrativas del Portal de Trabajo. Para ms informacin acerca de esta opcin en el Portal, consulte Portal de Trabajo de Bizagi.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web ab o rtCases, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo abortCases, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo abortCasesAsString la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="BizAgiWSParam"> <xs:complexType> <xs:sequence> <xs:element name="domain" type="xs:string" minOccurs="0"/>

2266

Copyright 2013 - Bizagi

<xs:element name="userName" type="xs:string" minOccurs="0"/> <xs:element name="cases"> <xs:complexType> <xs:sequence> <xs:element name="case" maxOccurs="unbounded"> <xs:complexType> <xs:sequence> <xs:element name="radNumber" type="xs:unsignedShort"/> <xs:element name="abortReason" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de entrada
BizAgiWSParam: Nodo raz. domain: Contiene el nombre del dominio del usuario Bizagi que ser registrado como el usuario que cancela el caso. userName: Contiene el nombre (usado en Bizagi) del usuario, que ser registrado como el usuario que cancela el caso. cases: Este elemento se incluye para agrupar varios elemento case dependiendo del nmero de casos que se van a cancelar. case: Se incluye la informacin del caso que se va a cancelar. radNumber: Se refiere al nmero de creacin del caso. abortReason: Contiene los motivos de la cancelacin del caso.

Ejemplo
Con el siguiente ejemplo, se cancelarn dos casos por el domain\admon. <?xml version="1.0" encoding="utf-8"?> <BizAgiWSParam> <domain>domain</domain> <userName>admon</userName> <cases> <case> <radNumber>8951</radNumber> <abortReason>Invalid case</abortReason> </case> <case>

Copyright 2013 - Bizagi

2267

<radNumber>9001</radNumber> <abortReason>Test case</abortReason> </case> </cases> </BizAgiWSParam>

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="unqualified" attributeFormDefault="qualified"> <xs:element name="Processes"> <xs:complexType> <xs:sequence> <xs:element name="Process" maxOccurs="unbounded"> <xs:complexType> <xs:sequence> <xs:element name="ProcessId" type="xs:integer"/> <xs:element name="ProcessRadNumber" type="xs:string"/> <xs:element name="ProcessCreationDate" type="xs:dateTime"/> <xs:element name="ProcessSolutionDate" type="xs:dateTime"/> <xs:element name="ProcessWorkflowClass"> <xs:complexType> <xs:sequence> <xs:element name="workflowClassId" type="xs:integer"/> <xs:element name="workflowClassName" type="xs:string"/> <xs:element name="workflowClassDisplayName" type="xs:string"/> <xs:element name="workflowClassDescription" type="xs:string"/> <xs:element name="workflowClassHelpText" type="xs:string"/> <xs:element name="workflowClassHelpURL" type="xs:string"/> <xs:element name="workflowClassDisplayOrder" type="xs:unsignedByte"/> <xs:element name="workflowClassCreationDate" type="xs:dateTime"/> <xs:element name="workflowClassGlobalForm" type="xs:integer"/> <xs:element name="workflowClassAllocationPrinciple" type="xs:string"/>

2268

Copyright 2013 - Bizagi

<xs:element name="workflowClassProcessType" type="xs:string"/> <xs:element name="workflowClassDisplay" type="xs:boolean"/> <xs:element name="workflowClassUseParentRadicationNumber" type="xs:boolean"/> <xs:element name="workflowClassSupportsScopes" type="xs:boolean"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="ProcessError"> <xs:complexType> <xs:sequence> <xs:element name="errorCode" type="xs:integer"/> <xs:element name="errorMessage" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de salida
processes: Nodo raz. process: Este elemento se incluye para cada caso que se ha cancelado. processId: Nmero de identificacin del caso (idCase). processRadNumber: Valor Alfanumrico que corresponde al nmero de creacin del caso. processCreationDate: Fecha de creacin del caso. processSolutionDate: Fecha de solucin del caso. processWorkflowClass: Este nodo contiene informacin del proceso (metadata). No es informacin del caso en particular. workflowClassId: Nmero de identificacin (o llave) del proceso. workflowClassName: Nombre del proceso. workflowClassDisplayName: Nombre a mostrar del proceso. workflowClassDescription: Descripcin del proceso. workflowClassHelpText: Texto de ayuda del proceso. workflowClassHelpURL: Url de ayuda del proceso. workflowClassDisplayOrder: El orden en el cual aparece el proceso en la aplicacin web. workflowClassCreationDate: Fecha de creacin del proceso. workflowClassGlobalForm: Nmero de identificacin de la forma global del proceso (cero si no est configurada). workflowClassAllocationPrinciple: Reservado para una funcionalidad posterior. workflowClassProcessType: Tipo de proceso. workflowClassDisplay: Indica si el proceso es visible o no.

Copyright 2013 - Bizagi

2269

workflowClassUseParentRadicationNumber: Indica si un caso de este proceso utiliza su propio nmero de creacin o si es el mismo nmero que el proceso padre (para subprocesos). processError: Si se present un error en el momento de cancelar un caso, este elemento mostrar informacin del error. errorCode: Cdigo del error presentado, Si no hubo error, este nodo estar vaco. errorMessage: Mensaje del error presentado. Si no hubo error, este nodo estar vaco.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi, en donde; Para el caso con idenfiticador 8951, abortar el caso es una operacin exitosa. Para el caso con idenfiticador 9001, el cual fue abortado anteriormente, el mensaje de respuesta indica que la posibilidad de abortarlo no est disponible.

7.1.1.2

assignActivityAsString

Introduccin
Este mtodo se utiliza para reasignar las Actividades pendientes (Inbox) en Bizagi (desde una aplicacin externa). Este mtodo recibe un nico parmetro de entrada el cual contiene principalmente: filtros para la informacin del caso, y cul usuario ser reasignado a la Actividad. 2270 Copyright 2013 - Bizagi

Con esto, se cubre la tarea de reasignar de la misma manera como se presenta esta opcin desde las opciones administrativas del Portal de Trabajo. Para ms informacin acerca de esta opcin en el Portal, consulte Portal de Trabajo de Bizagi.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web assig n A ctiv ity, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo assignActivity, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo assignActivityAsString la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD: <xs:schema elementFormDefault="qualified" attributeFormDefault="unqualified" xmlns:xs="http://www.w3.org/2001/ XMLSchema"> <xs:element name="BizAgiWSParam"> <xs:complexType> <xs:sequence> <xs:element name="CaseInfo"> <xs:complexType> <xs:sequence> <xs:choice> <xs:element name="AssignedByIdUser" type="xs: integer"/> <xs:element name="AssignedByUserName" type="xs: string"/> </xs:choice> <xs:choice> <xs:element name="IdUser" type="xs:integer"/> <xs:element name="UserName" type="xs:string"/> </xs:choice> <xs:choice> <xs:element name="IdWorkItem" minOccurs="0" type="xs:integer"/> <xs:choice> <xs:element name="IdCase" type="xs:integer"/> <xs:element name="CaseNumber" type="xs:string"/> </xs:choice> <xs:choice> <xs:element name="IdTask" type="xs:integer"/> <xs:element name="TaskName" type="xs:string"/> </xs:choice> </xs:choice> </xs:sequence> </xs:complexType>

Copyright 2013 - Bizagi

2271

</xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de entrada
BizAgiWSParam: Es el elemento "Nodo raz". Es de carcter obligatorio. CaseInfo: Es el elemento de carcter obligatorio que especifica la informacin requerida para la asignacin de una actividad. AssignedByIdUser: Es el elemento en donde se define el usuario en Bizagi que tiene actualmente asignada la actividad. Se recomienda que dicho usuario asignado actual sea especificado en este XML. Sin embargo y si este elemento no est presente, se puede optar por incluir el elemento "AssignedByUserName". Cuando ninguno de estos 2 elementos se especifica, la informacin por defecto para el usuario asignado actual se tomar como "domain\admon". AssignedByUserName: Es el elemento en donde se define el usuario en Bizagi ( y su dominio) que tiene actualmente asignada la actividad. El formato y valor esperado para este elemento debe inclur el dominio antepuesto por una barra invertida ("backslash").Por ejemplo: "domain\admon". Se recomienda que dicho usuario asignado actual sea especificado en este XML. Sin embargo y si este elemento no est presente, se puede optar por incluir el elemento "AssignedByIdUser". Cuando ninguno de estos 2 elementos se especifica, la informacin por defecto para el usuario asignado actual se tomar como "domain\admon". IdCase: Es el elemento en donde se define el caso especfico para el cual se desea reasignar una actividad. Es obligatorio especificar informacin del caso. Si este elemento no est presente en el XML, entonces se debe optar por definir el elemento "CaseNumber". CaseNumber: Es el elemento en donde se define el caso especfico para el cual se desea reasignar una actividad. Es obligatorio especificar informacin del caso. Si este elemento no est presente en el XML, entonces se debe optar por definir el elemento "IdCase". IdTask: Es el elemento en donde se define la tarea especfica para la cual se desea reasignar un usuario. Es obligatorio especificar informacin de la tarea. Si este elemento no est presente en el XML (por ejemplo si se desconoce el id de la tarea), entonces se debe optar por definir el elemento "TaskName". TaskName: Es el elemento en donde se define la tarea especfica para la cual se desea reasignar un usuario. Es obligatorio especificar informacin de la tarea. Si este elemento no est presente en el XML (por ejemplo si se desconoce el nombre de la tarea), entonces se debe optar por definir el elemento "IdTask".

2272

Copyright 2013 - Bizagi

IdWorkItem: Es el elemento en donde se define la identificacin del registro de "workitem". Esto es, la instancia de la actividad del caso especfico. Su uso es opcional ya que esta definicin especifica el caso y actividad a reasignar. Por lo tanto, su definicin puede reemplazar la especificacin includa para el caso (IdCase o CaseNumber) y para la tarea (IdTask o TaskName). Por ejemplo si el IdWorkItem se incluye en el XML, ninguno de los elementos: IdCase, CaseNumber, IdTask o TaskName ser necesario. IdUser: Es el elemento en donde se define el usuario de Bizagi el cual ser reasignado a una tarea de un caso. Es obligatorio especificar informacin sobre el usuario. Si este elemento no est presente en el XML, entonces se debe optar por definir el elemento "UserName". UserName: Es el elemento en donde se define el usuario de Bizagi ( y su dominio) el cual ser reasignado a una tarea de un caso. El formato y valor esperado para este elemento debe inclur el dominio antepuesto por una barra invertida ("backslash").Por ejemplo: "domain\admon". Es obligatorio especificar informacin sobre el usuario. Si este elemento no est presente en el XML, entonces se debe optar por definir el elemento "IdUser".

Ejemplo
Con el siguiente ejemplo, se reasigna el caso 2, en su Actividad Ev alu ateReq u est al usuario domain\admon (y ya no estar disponible para domain\johnw). <BizAgiWSParam> <CaseInfo> <AssignedByUserName>domain\johnw</AssignedByUserName> <UserName>domain\admon</UserName> <IdCase>2</IdCase> <IdTask>EvaluateRequest</IdTask> </CaseInfo> </BizAgiWSParam>

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="Process"> <xs:complexType> <xs:sequence> <xs:element name="ProcessId" type="xs: unsignedShort" /> <xs:element name="ProcessRadNumber" type="xs: unsignedShort" />

Copyright 2013 - Bizagi

2273

<xs:element name="savedMessage"> <xs:complexType> <xs:sequence> <xs:element name="Entities" type="xs:string" /> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="ProcessWorkflowClass"> <xs:complexType> <xs:sequence> <xs:element name="workflowClassId" type="xs:unsignedByte" /> <xs:element name="workflowClassName" type="xs:string" /> <xs:element name="workflowClassDisplayName" type="xs:string" /> <xs:element name="workflowClassDescription" type="xs:string" /> <xs:element name="workflowClassHelpText" type="xs:string" /> <xs:element name="workflowClassDisplayOrder" type="xs:unsignedByte" /> <xs:element name="workflowClassCreationDate" type="xs:string" /> <xs:element name="workflowClassGlobalForm" type="xs:unsignedByte" /> <xs:element name="workflowClassAllocationPrinciple" type="xs:string" /> <xs:element name="workflowClassProcessType" type="xs:string" /> <xs:element name="workflowClassDisplay" type="xs:string" /> <xs:element name="workflowClassUseParentRadicationNumber" type="xs:string" /> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="ProcessError"> <xs:complexType> <xs:sequence> <xs:element name="errorCode" type="xs:string" /> <xs:element name="errorMessage"> <xs:complexType mixed="true"> <xs:sequence minOccurs="0"> <xs:element name="Entities"> <xs: complexType>

2274

Copyright 2013 - Bizagi

<xs:sequence> <xs:element name="Path" type="xs:string" /> <xs:element name="Atrib" type="xs:string" /> <xs:element name="Value" type="xs:string" /> <xs:element name="ErrorMessage" type="xs:string" /> </ xs:sequence> </xs: complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="CurrentWorkItems"> <xs:complexType> <xs:sequence> <xs:element name="workItem"> <xs:complexType> <xs:sequence> <xs:element name="workItemId" type="xs:unsignedShort" /> <xs:element name="workItemState" type="xs:string" /> <xs:element name="workItemEntryDate" type="xs:string" /> <xs:element name="workItemDuration" type="xs:unsignedByte" /> <xs:element name="workItemEstimatedSolutionDate" type="xs:string" /> <xs:element name="task"> <xs: complexType> <xs:sequence> <xs:element name="taskId" type="xs:unsignedByte" /> <xs:element name="taskName" type="xs:string" /> <xs:element name="taskDisplayName" type="xs:string" /> <xs:element name="taskDescription" type="xs:string" /> <xs:element name="taskHelpText" type="xs:string" />

Copyright 2013 - Bizagi

2275

<xs:element name="taskEstimatedDuration" type="xs:unsignedByte" /> <xs:element name="taskType" type="xs:string" /> <xs:element name="taskCost" type="xs:unsignedByte" /> <xs:element name="taskPriority" type="xs:string" /> </ xs:sequence> </xs: complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de salida
Una respuesta exitosa de la invocacin contendr un mensaje de xito dentro del nodo BizAgiWSResponse. Si la respuesta es fallida, entonces tendr: processes: Es el elemento "Nodo raz". Contiene en XML la informacin de respuesta. process: Es el elemento que contiene mayor detalle del error en invocacin. processId: Contiene el id del proceso. processRadNumber: Contiene el valor alfanumrico que corresponde al nmero de creacin del caso (radicacin). processError: Contiene la descripcin del error (cdigo y mensaje) del intento de asignacin de la actividad. errorCode: Contiene el cdigo del error. errorMessage: Contiene el mensaje del error.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi, en donde; La invocacin es exitosa: La invocacin falla:

2276

Copyright 2013 - Bizagi

7.1.1.3

createCasesAsString

Introduccin
Este mtodo se utiliza para crear cualquier nmero de casos en Bizagi (iniciar instancias de Proceso), con informacin inicial de negocio, desde una aplicacin externa. Este mtodo recibe un nico parmetro de entrada el cual contiene principalmente: los casos a iniciarse (cantidad) con su informacin de negocio, el tipo de Proceso y el creador de los casos. A travs de este mtodo los casos nuevos quedarn en su primera Actividad, tal y como sucede cuando se crean casos por los usuarios desde el Portal de Trabajo. Para ms informacin acerca de esta opcin en el Portal, consulte Portal de Trabajo de Bizagi.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web createCases, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo createCases, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo createCasesAsString la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="BizAgiWSParam"> <xs:complexType> <xs:sequence> <xs:element name="domain" type="xs:string"/> <xs:element name="userName" type="xs:string"/> <xs:element name="Cases"> <xs:complexType> <xs:sequence> <xs:element name="Case" maxOccurs="unbounded">

Copyright 2013 - Bizagi

2277

<xs:complexType> <xs:sequence> <xs:element name="Process" type="xs:string"/> <xs:element name="Entities"> <xs: complexType/> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de entrada
BizAgiWSParam: Nodo raz. domain: Contiene el nombre del dominio del usuario Bizagi que ser registrado como el creador del caso. userName: Contiene el nombre (usado en Bizagi) del usuario que ser registrado como el creador del caso. cases: Este elemento ser includo para agrupar varios elementos case dependiendo del nmero de casos que sern creados. case: En este elemento se incluye informacin del caso que ser creado. Process: En este elemento, escriba el nombre (no el nombre a mostrar) del proceso. Entities: Incluya aqu la informacin que ser almacenada en el modelo de datos del paso que se est creando. Para ms informacin sobre la estructura esperada de los elementos dentro de Entities, consulte cmo se representan el modelo de datos del Proceso en Esquema XML de Bizagi para el modelo de datos .

Ejemplo
Con el siguiente ejemplo, se crean 2 casos del Proceso de Crdito ( Cred it) .

2278

Copyright 2013 - Bizagi

Si desea ver un ejemplo completo con un caso de negocio para utilizar el mtodo createCasesA sStrin g , consulte Cmo iniciar un Proceso en Bizagi desde aplicaciones externas.

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="Processes"> <xs:complexType>

Copyright 2013 - Bizagi

2279

<xs:sequence> <xs:element name="Process" maxOccurs="unbounded"> <xs:complexType> <xs:sequence> <xs:element name="ProcessId" type="xs:integer"/> <xs:element name="ProcessRadNumber" type="xs:string" minOccurs="0"/> <xs:element name="savedMessage" minOccurs="0"> <xs:complexType> <xs:sequence> <xs:element name="Entities" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="ProcessWorkflowClass" minOccurs="0"> <xs:complexType> <xs:sequence> <xs:element name="workflowClassId" type="xs:integer"/> <xs:element name="workflowClassName" type="xs:string"/> <xs:element name="workflowClassDisplayName" type="xs:string"/> <xs:element name="workflowClassDescription" type="xs:string"/> <xs:element name="workflowClassHelpText" type="xs:string"/> <xs:element name="workflowClassDisplayOrder" type="xs:integer"/> <xs:element name="workflowClassCreationDate" type="xs:string"/> <xs:element name="workflowClassGlobalForm" type="xs:integer"/> <xs:element name="workflowClassAllocationPrinciple" type="xs:string"/> <xs:element name="workflowClassProcessType" type="xs:string"/> <xs:element name="workflowClassDisplay" type="xs:string"/> <xs:element name="workflowClassUseParentRadicationNumber" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="ProcessError"> <xs:complexType> <xs:sequence> <xs:element name="errorCode" type="xs:string"/>

2280

Copyright 2013 - Bizagi

<xs:element name="errorMessage"> <xs: complexType mixed="true"> <xs:sequence minOccurs="0"> <xs:element name="Entities"> <xs:complexType> <xs:sequence> <xs:element name="Path" type="xs:string"/> <xs:element name="Atrib" type="xs:string"/> <xs:element name="Value" type="xs:string"/> <xs:element name="ErrorMessage" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> </ xs:sequence> </xs: complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="CurrentWorkItems"> <xs:complexType mixed="true"> <xs:sequence minOccurs="0"> <xs:element name="workItem"> <xs: complexType> <xs:sequence> <xs:element name="workItemId" type="xs:integer"/> <xs:element name="workItemState" type="xs:string"/> <xs:element name="workItemEntryDate" type="xs:string"/>

Copyright 2013 - Bizagi

2281

<xs:element name="workItemDuration" type="xs:integer"/> <xs:element name="workItemEstimatedSolutionDate" type="xs:string"/> <xs:element name="task"> <xs:complexType> <xs:sequence> <xs:element name="taskId" type="xs:integer"/> <xs:element name="taskName" type="xs:string"/> <xs:element name="taskDisplayName" type="xs: string"/> <xs:element name="taskDescription" type="xs: string"/> <xs:element name="taskHelpText" type="xs:string"/> <xs:element name="taskEstimatedDuration" type="xs: integer"/> <xs:element name="taskType" type="xs:string"/> <xs:element name="taskCost" type="xs:integer"/> <xs:element name="taskPriority" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> </ xs:sequence> </xs: complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

2282

Copyright 2013 - Bizagi

Parmetros de salida
processes: Nodo raz. process: Este elemento se incluye para cada caso que se va a crear. processId: Nmero de identificacin del caso (idCase). processRadNumber: Valor Alfanumrico que corresponde al nmero de creacin del caso. savedMessage: Reservado para una funcionalidad posterior. Entities: Reservado para una funcionalidad posterior. processWorkflowClass: Este nodo contiene informacin del proceso (metadata). No es informacin del caso en particular. workflowClassId: Nmero de identificacin (o llave) del proceso. workflowClassName: Nombre del proceso. workflowClassDisplayName: Nombre a mostrar del proceso. workflowClassDescription: Descripcin del proceso. workflowClassHelpText: Texto de ayuda del proceso. workflowClassHelpURL: Url de ayuda del proceso. workflowClassDisplayOrder: El orden en el cual aparece el proceso en la aplicacin web. workflowClassCreationDate: Fecha de creacin del proceso. workflowClassGlobalForm: Nmero de identificacin de la forma global del proceso (cero si no est configurada). workflowClassAllocationPrinciple: Reservado para una funcionalidad posterior workflowClassProcessType: Tipo de proceso. workflowClassDisplay: Indica si el proceso es visible o no. workflowClassUseParentRadicationNumber: Indica si un caso de este proceso utiliza su propio nmero de creacin o si es el mismo nmero que el proceso padre (para subprocesos). workflowClassSupportScopes: Indica si el proceso soporta los "scopes" de Bizagi, los cuales son un mtodo eficiente de persistencia de datos. processError: Si se present un error en el momento de cancelar un caso, este elemento mostrar informacin del error. errorCode: Cdigo del error presentado, Si no hubo error, este nodo estar vaco. errorMessage: Mensaje del error presentado. Si no hubo error, este nodo estar vaco. Path: XPath del elemento en el XML de entrada que genera el error. Este elemento es visible cuando el error es generado por informacin incorrecta. Attrib: Es el nombre del atributo en Bizagi donde se intent realizar la operacin de almacenamiento de datos. Este elemento es visible cuando el error es generado por informacin incorrecta. Value: Es el valor que causa el error. Es visible cuando el error es generado por informacin incorrecta. ErrorMessage: Mensaje que explca por qu se present el error. Visible cuando el error es causado por informacin incorrecta. CurrentWorkItems: Serie de actividades disponibles para un caso. workItem: Es una actividad especfica del proceso (una instancia de una tarea) que se encuentra activa para el caso. workItemId: Nmero de identificacin de la llave de la actividad. workItemState: Estado en el cual se encuentra la actividad. workItemEntryDate: Fecha y hora en la que el caso lleg a esta actividad. workItemDuration: Duracin estimada, en minutos, para la actividad. workItemEstimatedSolutionDate: Es la fecha estimada de solucin para el caso. task: Contiene informacin sobre la tarea. taskId: Nmero de identificacin o llave de la tarea. taskName: Nombre de la tarea. taskDisplayName: Nombre a mostrar de la tarea.

Copyright 2013 - Bizagi

2283

taskDescription: Texto descriptivo de la tarea. taskHelpText: Texto de ayuda de la tarea. taskEstimatedDuration: Es la duracin estimada, en minutos, de la tarea. taskType: Tipo de tarea. taskCost: Costo estimado de la tarea. Este valor, como el de las fechas estimadas, es configurado y determinado por el diseador del proceso. taskPriority: Prioridad de la tarea.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi, en donde; Con el primer nodo, se crea un caso (instancia de Proceso) de manera exitosa. Con el segundo nodo, se lanza un error donde el caso no es creado. Dentro de esta respuesta, el detalle de error se despliega dentro de P ro cessErro r.

2284

Copyright 2013 - Bizagi

Mtodos Web relacionados

Si desea completar y avanzar una Actividad especfica del Proceso (de las pendientes en el Inbox), utilice los mtodos p erfo rm A ctiv ity A sStrin g o p erfo rm A ctiv ity. Para ms informacin, consulte performActivityAsString.

Copyright 2013 - Bizagi

2285

7.1.1.4

getActivitiesAsString

Introduccin
Este mtodo se utiliza para obtener un listado de Actividades pendientes de Bizagi (aquellas en el Inbox) desde una aplicacin externa. Este mtodo recibe un nico parmetro de entrada el cual contiene principalmente: el detalle sobre el Proceso y posibles filtros. A travs de este mtodo, se ven las Actividades pendientes que se listan en el Portal de Trabajo. Para ms informacin acerca de esta opcin en el Portal, consulte Portal de Trabajo de Bizagi.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web g etA ctiv ities, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo getActivities, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo getActivitiesAsString la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="BizAgiWSParam"> <xs:complexType> <xs:sequence> <xs:element name="domain" type="xs:string" minOccurs="0"/> <xs:element name="userName" type="xs:string" minOccurs="0"/> <xs:element name="radNumber" type="xs:string" minOccurs="0"/> <xs:element name="applicationName" type="xs:string" minOccurs="0"/> <xs:element name="categoryName" type="xs:string" minOccurs="0"/> <xs:element name="ProcessName" type="xs:string" minOccurs="0"/> <xs:element name="idCase" type="xs:integer" minOccurs="0"/> <xs:element name="subProcessDepth" type="xs: integer" minOccurs="0"/> <xs:element name="creationDate" minOccurs="0"> <xs:complexType> <xs:sequence> <xs:element name="From" type="xs:

2286

Copyright 2013 - Bizagi

dateTime" minOccurs="0"/> <xs:element name="To" type="xs: dateTime" minOccurs="0"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="expirationDate" minOccurs="0"> <xs:complexType> <xs:sequence> <xs:element name="From" type="xs: dateTime" minOccurs="0"/> <xs:element name="To" type="xs: dateTime" minOccurs="0"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de entrada
BizAgiWSParam: Nodo raz. Aqu se incluyen todos los filtros posibles. Estos filtros son opcionales. Si se utiliza ms de un criterio, el resultado debera traer nicamente las actividades que cumplen con todas las condiciones. domain: Busca las actividades cuyo usuario asignado pertenezca a este dominio. userName: Busca las actividades cuyo usuario asignado sea el indicado en este elemento. radNumber: Actividades que pertenezcan a este nmero de creacin (nmero de caso). applicationName: Actividades que pertenezcan a esta aplicacin (ingrese el nombre y no el nombre a mostrar). categoryName: Todas las actividades abiertas de esta categora (ingrese el nombre y no el nombre a mostrar). processName: Obtiene las actividades de este proceso (ingrese el nombre y no el nombre a mostrar). idCase: Actividades que pertenecen a este idCase (nmero de identificacin del caso). subprocessDepth: Este no es un parmetro de bsqueda sino un indicador de la profundidad del subproceso que se debe considerar. Se utiliza cuando hay una tarea de tipo subproceso dentro del proceso del cual se obtienen las tareas, para poder obtener informacin de actividades en los subprocesos que puedan existir en un caso (sin embargo, no se tienen en cuenta subprocesos de tipo Stand alone). Por defecto, esta consulta retorna un nivel de profundidad, es decir, el resultado contendr las actividades de los subprocesos relacionados al proceso del caso actual; pero no las actividades pertenecientes al subproceso o subprocesos dentro de este subproceso. Se puede ingresar cualquier valor entero, pero es importante tener presente que para profundidades ms grandes, el tiempo de respuesta puede aumentar, por lo cual se recomienda ingresar un nmero pequeo. creationDate: Se refiere a la fecha a partir de la cual una actividad se encuentra disponible (cuando se habilita la actividad para un caso). expirationDate: Fecha tentativa en la cual una actividad expirar (de acuerdo a la configuracin de duracin). From: Ser utilizado como un sub-nodo ya sea de la fecha de creacin o de la fecha de expiracin;

Copyright 2013 - Bizagi

2287

permite que se pueda ingresar un rango de fechas. Esta ser la fecha inicial para la bsqueda (la ms antigua). To: Ser utilizado como un sub-nodo ya sea de la fecha de creacin o de la fecha de expiracin; permite que se pueda ingresar un rango de fechas. Esta ser la fecha final para la bpusqueda (la ms reciente).

Ejemplo
Con el siguiente ejemplo, se consultan aquellas Actividades que: 1. Se activaron (empezaron a estar pendientes) desde el rango: Mayo 17 a las 4 pm hasta Mayo 21 a las 4 pm. 2. Estn actualmente asignadas al usuario admon de Bizagi. <?xml version="1.0" encoding="utf-8"?> <BizAgiWSParam> <userName>admon</userName> <creationDate> <From>2012-05-17T16:00:00</From> <To>2012-05-21T16:00:00</To> </creationDate> </BizAgiWSParam>

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> <xs:element name="workItems"> <xs:complexType> <xs:sequence> <xs:element name="workItem" type="workItemType" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element> <xs:complexType name="workItemType"> <xs:sequence> <xs:element name="workItemId" type="xs:integer"/> <xs:element name="workItemState" type="xs:string"/> <xs:element name="workItemEntryDate" type="xs:dateTime"/> <xs:element name="workItemDuration" type="xs:integer"/> <xs:element name="workItemSubProcesses"> <xs:complexType> <xs:sequence> <xs:element name="workItems" minOccurs="0"> <xs:complexType> <xs:sequence>

2288

Copyright 2013 - Bizagi

<xs:element name="workItem" type="workItemType" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="workItemEstimatedSolutionDate" type="xs:dateTime"/> <xs:element name="workItemSolutionDate" type="xs: dateTime"/> <xs:element name="task"> <xs:complexType> <xs:sequence> <xs:element name="taskId" type="xs: integer"/> <xs:element name="taskName" type="xs: string"/> <xs:element name="taskDisplayName" type="xs:string"/> <xs:element name="taskDescription" type="xs:string"/> <xs:element name="taskHelpText" type="xs:string"/> <xs:element name="HelpURL" type="xs: string"/> <xs:element name="taskEstimatedDuration" type="xs:integer"/> <xs:element name="taskType" type="xs: string"/> <xs:element name="taskCost" type="xs: integer"/> <xs:element name="taskPriority" type="xs:string"/> <xs:element name="taskTransactional" type="xs:boolean"/> <xs:element name="taskCompensation" type="xs:boolean"/> <xs:element name="taskTimerEventDuration" type="xs:integer"/> <xs:element name="AllowsReassign" type="xs:boolean"/> <xs:element name="SendNotification" type="xs:boolean"/> <xs:element name="SendAlarms" type="xs: boolean"/> <xs:element name="ExtendedEstimatedDuration" type="xs:integer"/> <xs:element name="Form" type="xs: integer"/> <xs:element name="IsAsynchTask" type="xs:boolean"/>

Copyright 2013 - Bizagi

2289

<xs:element name="NumberOfRetries" type="xs:integer"/> <xs:element name="RetryInterval" type="xs:integer"/> <xs:element name="ShowFeedback" type="xs:boolean"/> <xs:element name="TimeoutSeconds" type="xs:integer"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="Process"> <xs:complexType> <xs:sequence> <xs:element name="ProcessId" type="xs: integer"/> <xs:element name="ProcessRadNumber" type="xs:integer"/> <xs:element name="ProcessCreationDate" type="xs:dateTime"/> <xs:element name="ProcessSolutionDate" type="xs:dateTime"/> <xs:element name="ProcessWorkflowClass"> <xs:complexType> <xs:sequence> <xs:element name="workflowClassId" type="xs:integer"/> <xs:element name="workflowClassName" type="xs:string"/> <xs:element name="workflowClassDisplayName" type="xs:string"/> <xs:element name="workflowClassDescription" type="xs:string"/> <xs:element name="workflowClassHelpText" type="xs:string"/> <xs:element name="workflowClassHelpURL" type="xs:string"/> <xs:element name="workflowClassDisplayOrder" type="xs:integer"/> <xs:element name="workflowClassCreationDate" type="xs:dateTime"/> <xs:element name="workflowClassGlobalForm" type="xs:integer"/> <xs:element name="workflowClassAllocationPrinciple" type="xs:string"/> <xs:element name="workflowClassProcessType" type="xs:string"/> <xs:element name="workflowClassDisplay" type="xs:boolean"/> <xs:element name="workflowClassUseParentRadicationNumber" type="xs:boolean"/> <xs:element

2290

Copyright 2013 - Bizagi

name="workflowClassSupportsScopes" type="xs:boolean"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="ProcessError"> <xs:complexType> <xs:sequence> <xs:element name="errorCode" type="xs:string"/> <xs:element name="errorMessage" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:schema>

Parmetros de salida
workItems: Nodo raz, contiene un nodo "workItem" para cada actividad includa en la respuesta. workItem: Es una actividad especial (una instancia de una tarea) del proceso que se encuentra activa para el caso. workItemId: Nmero de identificacin o llave de la actividad. workItemState: Estado actual de la actividad. workItemEntryDate: Fecha y hora en la que se llega a la actividad por primera vez. workItemDuration: Es la duracin estimada, en minutos, para esta actividad. workItemSubprocesses: Si la actividad es de tipo subproceso, en este nodo encontrar informacin de las actividades del subproceso. Tiene un nodo hijo llamado "workItems" de manera que desde este punto la estructura la misma incluyendo un nodo "workItem" para cada actividad que cumple con los criterios de bsqueda dentro del subproceso. workItemEstimatedSolutionDate: Es la fecha estimada de solucin de la actividad. workItemSolutionDate: Es la fecha en la cual se complet la actividad. task: Contiene informacin sobre la tarea correspondiente a la actividad. taskId: Nmero de identificacin o llave de la tarea. taskName: Nombre de la tarea. taskDisplayName: Nombre a mostrar de la tarea. taskDescription: Texto descriptivo de la actividad. taskHelpText: Texto de ayuda de la actividad. HelpUrl: URL con infromacin de la actividad. taskEstimatedDuration: Es la duracin estimada, en minutos, para la tarea. taskType: Tipo de tarea. taskCost: Costo estimado de la tarea. Este valor, al igual que es de las fechas estimadas, es configurado y determinado por la persona que disea el proceso. taskPriority: Prioridad de cumplimiento de la tarea. taskTransactional: Indica si la tarea es transaccional. taskCompensation: Indica si es una tarea de compensacin. taskTimerEventDuration: Si es una tarea de temporizador, contendr su duracin en minutos.

Copyright 2013 - Bizagi

2291

AllowsReassign: Una marca que muestra si esta tarea puede ser resignada a otro usuario. SendNotification: Indica si se debe enviar un email a un usuario informando sobre la disponibilidad de la tarea. SendAlarms: Indica si se debe enviar un email al usuario asignado informndole que la tarea tiene riesgo de vencerse. ExtendedEstimatedDuration: Duracin de tiempo extendida. Form: Reservada para uso futuro. IsAsynchTask: Especifica si esta es una tarea asincrnica. Utilizada normalmente para interfaces. NumberOfRetries: Aplica para tareas asincrnicas. Corresponde al nmero de intentos automticos de una tarea. En caso de error se arroja una excepcin. RetryInterval: Aplica para tareas asincrnicas. es el tiempo (en minutos) entre cada reintento. ShowFeedback: Aplica para tareas asincrnicas. Indica si se le informar a usuario cuando se presente un error. TimeoutSeconds: Aplica para tareas asincrnicas. Tiempo (en segundos) que debe esperar la tarea asincrnica por una respuesta del sistema externo. process: Tiene informacin sobre el proceso al cual pertenece la actividad. processId: Nmero de identificacin del caso (idCase). processCreationDate: Fecha de creacin del caso. processSolutionDate: Fecha de solucin del caso. processWorkflowClass: Toda la informacin de este nodo es informacin del proceso (metadata) y no informacin del caso en particular workflowClassId: Nmero de identifiacacin (o llave) del proceso. workflowClassName: Nombre del proceso. workflowClassDisplayName: Nombre a mostrar del proceso. workflowClassDescription: Descripcin del proceso. workflowClassHelpText: Texto de ayuda del proceso. workflowClassHelpURL: URL de ayuda del proceso. workflowClassDisplayOrder: Orden en el cual apareceer el proceso en la aplicacin web. workflowClassCreationDate: Fecha de creacin del proceso. workflowClassGlobalForm: Nmero de identificacin de la forma global del proceso (cero si no est configurada). workflowClassAllocationPrinciple: Reservado para uso futuro. workflowClassProcessType: Tipo de proceso. workflowClassDisplay: Indica si el proceso es visible o no. workflowClassUseParentRadicationNumber: Indica si un caso de este proceso utiliza su propio nmero de creacin o si es el mismo nmero que el del proceso padre (si es un subproceso). workflowClassSupportScopes: Indica si el proceso soporta los "scopes" de Bizagi, los cuales son un mtodo eficiente de persistencia de datos. processError: Contiene informacin de los errores presentados durante el procesamiento de este mtodo. errorCode: Cdigo del error, si es que se present alguno. errorMessage: Mensaje de error, si es que se present alguno.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi.

2292

Copyright 2013 - Bizagi

Mtodos Web relacionados

Si desea obtener una lista de Eventos disponibles del Proceso, use el mtodo g etEv en tsA sStrin g o el g etEv en ts. Para ms informacin sobre esta opcin, consulte getEventsAsString. Una vez que obtenga la lista de Actividades pendientes, puede optar por completar dichas Actividades desde la aplicacin externa. Para ello, utilice los mtodos p erfo rm A ctiv ity A sStrin g o p erfo rm A ctiv ity.

Copyright 2013 - Bizagi

2293

Para ms informacin sobre esta opcin, consulte performActivityAsString. 7.1.1.5 getApplications

Introduccin
Este mtodo se utiliza para obtener las aplicaciones de negocio en una implementacin de Bizagi, desde una aplicacin externa. Este mtodo no recibe datos de entrada, y retorna todas las aplicaciones de negocio del proyecto, tal como aparecen en el mdulo de Procesos que se define en Bizagi Studio:

Datos de entrada
Este mtodo no recibe datos de entrada.

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:

2294

Copyright 2013 - Bizagi

xs="http://www.w3.org/2001/XMLSchema" xmlns:xsd="http://www.w3.org/2001/ XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="applications"> <xs:complexType>Es <xs:sequence> <xs:element name="application" maxOccurs="unbounded"> <xs:complexType> <xs:sequence> <xs:element name="applicationId" type="xs:unsignedByte"/> <xs:element name="applicationName" type="xs:string"/> <xs:element name="applicationDisplayName" type="xs:string"/> <xs:element name="applicationCreationDate" type="xs:dateTime"/> <xs:element name="applicationAllocationPrinciple" type="xs:string"/> <xs:element name="applicationOrganizationId" type="xs:unsignedByte"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de salida
Applications: Es el nodo raz; contiene un nodo hijo llamado "Application" para cada Aplicacin. Application: Contiene la informacin para una aplicacin en particular. applicationId: Contiene el nmero de identificacin (o llave) de la aplicacin. applicationName: Nombre interno de la aplicacin. applicationDisplayName: Nombre a mostrar de la aplicacin. applicationCreationDate: Fecha en la cual se cre la aplicacin. applicationAllocationPrinciple: Reservado para uso futuro. applicationOrganizationId: Nmero de identificacin de la organizacin a la cual pertenece la aplicacin.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi, en donde el proyecto solo tiene la aplicacin de Crdito:

Copyright 2013 - Bizagi

2295

Mtodos Web relacionados

Una vez obtenga la lista de las aplicaciones de negocio del proyecto, puede optar por navegar hacia dentro estas aplicaciones, donde se obtiene jerrquicamente las categoras y los Procesos de estas aplicaciones. Para obtener la lista de las categoras de una aplicacin, use los mtodos g etCateg o riesA sStrin g o g etCateg o ries. Para ms informacin sobre esta opcin, consulte getCategoriesAsString. 7.1.1.6 getCasesAsString

Introduccin
Este mtodo se utiliza para obtener un set de casos de Procesos en Bizagi y su detalle general, desde una aplicacin externa. Este mtodo recibe un nico parmetro de entrada el cual contiene principalmente: filtros de datos generales de Proceso (tales como rangos de la fecha de creacin, un usuario asignado especficamente, un determinado Proceso, etc). A travs de esta informacin, Bizagi retorna los casos que cumplen con estos criterios, (p.e los que se listan a un usuario determinado en el Portal de Trabajo). Para ms informacin acerca de esta opcin en el Portal, consulte Portal de Trabajo de Bizagi. Si desea que la invocacin retorne el detalle con datos de negocio de los casos, consulte la seccin de mtodos relacionados al final de este artculo.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web g etCases, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo g etCases, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo g etCasesA sStrin g la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"

2296

Copyright 2013 - Bizagi

elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="BizAgiWSParam"> <xs:complexType> <xs:sequence> <xs:element name="domain" type="xs:string" minOccurs="0"/> <xs:element name="userName" type="xs:string" minOccurs="0"/> <xs:element name="radNumber" type="xs:string" minOccurs="0"/> <xs:element name="applicationName" type="xs:string" minOccurs="0"/> <xs:element name="categoryName" type="xs:string" minOccurs="0"/> <xs:element name="ProcessName" type="xs:string" minOccurs="0"/> <xs:element name="idCase" type="xs:integer" minOccurs="0"/> <xs:element name="subProcessDepth" type="xs: integer" minOccurs="0"/> <xs:element name="creationDate" minOccurs="0"> <xs:complexType> <xs:sequence> <xs:element name="From" type="xs: dateTime" minOccurs="0"/> <xs:element name="To" type="xs: dateTime" minOccurs="0"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="expirationDate" minOccurs="0"> <xs:complexType> <xs:sequence> <xs:element name="From" type="xs: dateTime" minOccurs="0"/> <xs:element name="To" type="xs: dateTime" minOccurs="0"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de entrada
BizAgiWSParam: Nodo raz. En este nodo se incluyen todos los filtros posibles. Estos filtros son opcionales. Si se utiliza ms de un criterio de bsqueda, la respuesta debera incluir nicamente aquellos casos que cumplan con todas las condiciones. domain: Busqueda de los casos cuyo usuario asignado pertenezca a este dominio. userName: Busca los casos cuyo usuario asignado sea el usuario que se indica en este elemento.

Copyright 2013 - Bizagi

2297

radNumber: Casos que pertenezcan a este nmero de creacin (nmero de caso). applicationName: Casos que pertenezcan a la aplicacin con este nombre (ingrese el nombre, no el nombre a mostrar). categoryName: Busca todos los casos abiertos en esta categora (ingrese el nombre, no el nombre a mostrar). processName: Obtiene los casos de este proceso (ingrese el nombre, no el nombre a mostrar). idCase: Retorna el caso con este idCase (nmero de identificacin del caso). creationDate: Se refiere a la fecha cuando se cre el caso. expirationDate: Fecha programada para la expiracin del caso (de acuerdo a la durain configurada). From: Ser utilizado como un sub-nodo ya sea de la fecha de creacin o de la fecha de expiracin; permite que se pueda ingresar un rango de fechas. Esta ser la fecha inicial para la bsqueda (la ms antigua). To: Ser utilizado como un sub-nodo ya sea de la fecha de creacin o de la fecha de expiracin; permite que se pueda ingresar un rango de fechas. Esta ser la fecha final para la bpusqueda (la ms reciente).

Ejemplo
Con el siguiente ejemplo, se obtienen los casos que: 1. Fueron creados desde Enero 31 de 2012. 2. Se encuentren actualmente asignados al usuario domain\admon. <?xml version="1.0" encoding="utf-8"?> <BizAgiWSParam> <userName>admon</userName> <domain>domain</domain> <creationDate> <From>2012-01-31</From> </creationDate> </BizAgiWSParam>

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns: xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="Processes"> <xs:complexType> <xs:sequence> <xs:element name="Process"> <xs:complexType> <xs:sequence> <xs:element name="ProcessId" type="xs:unsignedShort"/> <xs:element

2298

Copyright 2013 - Bizagi

name="ProcessRadNumber" type="xs:unsignedShort"/> <xs:element name="savedMessage"> <xs:complexType> <xs:sequence> <xs:element name="Entities" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="ProcessCreationDate" type="xs:dateTime"/> <xs:element name="ProcessSolutionDate" type="xs:dateTime"/> <xs:element name="ProcessWorkflowClass"> <xs:complexType> <xs:sequence> <xs:element name="workflowClassId" type="xs:unsignedByte"/> <xs:element name="workflowClassName" type="xs:string"/> <xs:element name="workflowClassDisplayName" type="xs:string"/> <xs:element name="workflowClassDescription"/> <xs:element name="workflowClassHelpText"/> <xs:element name="workflowClassHelpURL"/> <xs:element name="workflowClassDisplayOrder" type="xs:unsignedByte"/> <xs:element name="workflowClassCreationDate" type="xs:dateTime"/> <xs:element name="workflowClassGlobalForm" type="xs:unsignedByte"/> <xs:element name="workflowClassAllocationPrinciple" type="xs:string"/> <xs:element name="workflowClassProcessType" type="xs:string"/> <xs:element name="workflowClassDisplay" type="xs:boolean"/> <xs:element name="workflowClassUseParentRadicationNumber" type="xs:boolean"/> <xs:element name="workflowClassSupportsScopes" type="xs:boolean"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="ProcessError"> <xs:complexType> <xs:sequence> <xs:element name="errorCode"/>

Copyright 2013 - Bizagi

2299

<xs:element name="errorMessage"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="CurrentWorkItems"> <xs:complexType> <xs:sequence> <xs:element name="workItem"> <xs: complexType> <xs:sequence> <xs:element name="workItemId" type="xs:unsignedShort"/> <xs:element name="workItemState" type="xs:string"/> <xs:element name="workItemEntryDate" type="xs:dateTime"/> <xs:element name="workItemDuration" type="xs:unsignedByte"/> <xs:element name="workItemSubProcesses"/> <xs:element name="workItemEstimatedSolutionDate" type="xs:dateTime"/> <xs:element name="workItemSolutionDate" type="xs:dateTime"/> <xs:element name="task"> <xs:complexType> <xs:sequence> <xs:element name="taskId" type="xs:unsignedByte"/> <xs:element name="taskName" type="xs:string"/> <xs:element name="taskDisplayName" type="xs: string"/> <xs:element name="taskDescription"/> <xs:element name="taskHelpText"/> <xs:element name="taskEstimatedDuration" type="xs: unsignedByte"/> <xs:element name="taskType" type="xs:string"/> <xs:element name="taskCost" type="xs:unsignedByte"/

2300

Copyright 2013 - Bizagi

> <xs:element name="taskPriority" type="xs:string"/> <xs:element name="taskTransactional" type="xs: boolean"/> <xs:element name="taskCompensation" type="xs: boolean"/> <xs:element name="taskTimerEventDuration" type="xs: unsignedByte"/> <xs:element name="AllowsReassign" type="xs: boolean"/> <xs:element name="SendNotification" type="xs: boolean"/> <xs:element name="SendAlarms" type="xs:boolean"/> <xs:element name="ExtendedEstimatedDuration" type="xs:unsignedByte"/> <xs:element name="Form" type="xs:unsignedByte"/> <xs:element name="IsAsynchTask" type="xs:boolean"/> <xs:element name="NumberOfRetries" type="xs: unsignedByte"/> <xs:element name="RetryInterval" type="xs: unsignedByte"/> <xs:element name="ShowFeedback" type="xs:boolean"/> <xs:element name="TimeoutSeconds" type="xs: unsignedByte"/> </xs:sequence> </xs:complexType> </xs:element> </ xs:sequence> </xs: complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence>

Copyright 2013 - Bizagi

2301

</xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de salida
processes: Nodo raz de la respuesta, contiene un nodo "process" para cada actividad includa en el resultado. process: Se incluye este elemento para cada uno de los casos retornados. processId: Nmero de identificacin del caso (idCase). processRadNumber: Valor alfanumrico correspondiente al nmero de creacin del caso. savedMessage: Reservado para uso futuro. Entities: Reservado para uso futuro. processCreationDate: Fecha de creacin del caso. processSolutionDate: Fecha de solucin (cierre) del caso. processWorkflowClass: Este nodo contiene nicamente informacin del proceso (metadata), no informacin del caso en particular. workflowClassId: Nmero de identificacin (o llave) del proceso. workflowClassName: Nombre del proceso. workflowClassDisplayName: Nombre a mostrar del proceso. workflowClassDescription: Descripcin del proceso. workflowClassHelpText: Texto de ayuda del proceso. workflowClassHelpURL: URL de ayuda del proceso. workflowClassDisplayOrder: El orden en el cual aparece el proceso en la aplicacin web. workflowClassCreationDate: Fecha de creacin del proceso. workflowClassAllocationPrinciple: Reservado para uso futuro. workflowClassProcessType: Tipo de proceso. workflowClassDisplay: Indica si un proceso es visible o no. workflowClassUseParentRadicationNumber: Indica si un caso de este proceso utiliza su propio nmero de creacin o si es el mismo nmero que el proceso padre (para subprocesos). workflowClassSupportScopes: Indica si el proceso soporta los "scopes" de Bizagi, los cuales son un mtodo eficiente de persistencia de datos. processError: Si se present un error en el momento de cancelar un caso, este elemento mostrar informacin del error. errorCode: Cdigo del error presentado, Si no hubo error, este nodo estar vaco. errorMessage: Mensaje del error presentado. Si no hubo error, este nodo estar vaco. CurrentWorkItems: Serie de actividades disponibles para un caso. workItem: Es una actividad especfica del proceso (una instancia de una tarea) que se encuentra activa para el caso. workItemId: Nmero de identificacin de la llave de la actividad. workItemState: Estado en el cual se encuentra la actividad. workItemEntryDate: Fecha y hora en la que el caso lleg a esta actividad. workItemDuration: Duracin estimada, en minutos, para la actividad. workItemEstimatedSolutionDate: Es la fecha estimada de solucin para el caso. task: Contiene informacin sobre la tarea. taskId: Nmero de identificacin o llave de la tarea. taskName: Nombre de la tarea.

2302

Copyright 2013 - Bizagi

taskDisplayName: Nombre a mostrar de la tarea. taskDescription: Texto descriptivo de la tarea. taskHelpText: Texto de ayuda de la tarea. HelpUrl: URL con informacin de la actividad. taskEstimatedDuration: Duracin estimada de la tarea, en minutos. taskType: Tipo de tarea. taskCost: The estimated cost of the task. This value, like the estimated dates, is configured and determined by the designer of the process. taskPriority: Prioridad de la tarea. taskTransactional: Indicador de comienzo si la tarea es transaccional. taskCompensation: Indica si es una tarea de compensacin. taskTimerEventDuration: Si es una tarea de temporizador, contendr la duracin en minutos. AllowsReassign: Una marca que muestra si la tarea puede ser reasignada a otro usuario. SendNotification: Indica si se debe enviar un email a un usuario informndole sobre la disponibilidad de la tarea. SendAlarms: Indica si se debe enviar un email a un usuario informndole que la tarea esta prxima a vencerse. ExtendedEstimatedDuration: Tiempo extendido de duracin estimada. Form: Reservada para uso futuro. IsAsynchTask: Especifica si es una tarea asincrnica o no. Se utiliza normalmente para interfaces.. NumberOfRetries: Aplica para tareas asincrnicas. Es el nmero de reintentos automticos para una tarea en caso de error (se arroja una excepcin). RetryInterval: Aplica para tareas asincrnicas. Es el tiempo (en minutos) entre cada reintento. ShowFeedback: Aplica para tareas asincrnicas. indica si el usuario ser informado cuando se presente un error. TimeoutSeconds: Aplica para tareas asincrnicas. Tiempo (en segundos) que la tarea asincrnica esperar por una respuesta del sistema externo.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi pra el caso identificado como 9001:

Copyright 2013 - Bizagi

2303

Mtodos Web relacionados

Si desea obtener los datos especficos de negocio en esta consulta de casos, use los mtodos de los Servicios Web de EntityManagerSOA (por ejemplo g etCaseDataUsin g Sch em aA sStrin g o g etCaseDataUsin g XP ath sA sStrin g). Para ms informacin sobre esta opcin, consulte EntityManagerSOA.

2304

Copyright 2013 - Bizagi

Si desea obtener tanto datos generales de Proceso, como los datos especficos de negocio en esta consulta de casos, use el mtodo QueryCasesAsString de los Servicios Web de QuerySOA. Para ms informacin sobre esta opcin, consulte QuerySOA. 7.1.1.7 getCategoriesAsString

Introduccin
Este mtodo se utiliza para obtener las categoras de negocio de las aplicaciones de una implementacin de Bizagi (desde una aplicacin externa). Este mtodo recibe un nico parmetro de entrada el cual contiene principalmente: el nombre de la aplicacin de negocio de la cual se quieren obtener las categoras, y el lenguage deseado. Las categoras que retorna Bizagi son las que se listan y se pueden consultar desde el mdulo de Procesos, desde Bizagi Studio:

Nota: La descripcin en este artculo aplica tambin para el mtodo Web g etCateg o ries, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo getCategories, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo getCategoriesAsString la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Copyright 2013 - Bizagi

2305

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="BizAgiWSParam"> <xs:complexType> <xs:sequence> <xs:element name="application" type="xs:string"/> <xs:element name="language" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de entrada
BizAgiWSParam: Nodo raz. application: Contiene el nombre de la aplicacin deseada (escriba el nombre, no el nombre a mostrar). language: Contiene el cdigo del idioma en el que se desea que sean retornadas las categorias. En caso de enviarse un cdigo de idioma no registrado en Bizagi, este retornar los valores en el idioma por defecto.

Ejemplo
Con el siguiente ejemplo, se obtienen las categorias de la apliacin de Viajes (Travel): <?xml version="1.0" encoding="utf-8"?> <BizAgiWSParam> <application>Travel</application> <language>en-us</language> </BizAgiWSParam>

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns: xs="http://www.w3.org/2001/XMLSchema" xmlns:xsd="http://www.w3.org/2001/ XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="categories"> <xs:complexType> <xs:sequence> <xs:element name="category"> <xs:complexType> <xs:sequence>

2306

Copyright 2013 - Bizagi

<xs:element name="categoryId" type="xs:unsignedByte"/> <xs:element name="categoryName" type="xs:string"/> <xs:element name="categoryDisplayName" type="xs:string"/> <xs:element name="categoryDescription"/> <xs:element name="categoryHelpText"/> <xs:element name="categoryDisplayOrder" type="xs:unsignedByte"/> <xs:element name="categoryCreationDate" type="xs:dateTime"/> <xs:element name="parentCategoryId" type="xs:unsignedByte"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de salida
categories: Es el nodo raz; contiene todas las categoras de la aplicacin dada. category: Contiene toda la informacin de una categora especfica. categoryId: Este es el nmero de identificacin (o llave) para la categora. categoryName: Nombre interno de la categora. categoryDisplayName: Es el nombre que el usuario ve. categoryDescription: Descripcin de la categora. categoryHelpText: Texto de ayuda de la categora. categoryDisplayOrder: Orden en el cual se muestra la categora. categoryCreationDate: Fecha de creacin de la categora. parentCategoryId: Si se trata de una sub categora, este elemento contendr el nmero de identificacin (o llave) de la categora padre, de lo contrario, contendr un 0 (cero).

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi.

Copyright 2013 - Bizagi

2307

Ntese que la categora llamada Travel es la nica que figura dentro de la aplicacin Travel.

Mtodos Web relacionados

Para ms informacin sobre esta opcin, consulte 7.1.1.8 getCategoriesLocalized

Introduccin
Este mtodo se se utiliza para obtener las categoras de negocio en una implementacin de Bizagi (desde una aplicacin externa). Este mtodo recibe dos parmetros de entrada: el nombre de la Aplicacin de negocio (sobre la cul se van a obtener las categoras), y el idioma para el retorno de los nombres de estas categoras. Esta informacin va cada una en un parmetro de tipo cadena (string). A diferencia, del mtodo g etCateg o riesA sStrin g , la informacin de entrada NO es especificada con estructura XML. Las categoras de negocio en una implementacin de Bizagi son aquellas que se listan para una aplicacin, desde el mdulo de Procesos de Bizagi Studio:

2308

Copyright 2013 - Bizagi

Datos de entrada
Los datos de entrada son 2 parmetros de tipo string.

Parmetros de entrada
application: Contiene el nombre de la aplicacin deseada (escriba el nombre, no el nombre a mostrar). language: Contiene el cdigo del idioma con una cultura (por ejemplo pt-br o pt-pt), en el que se desea que sean retornadas las categorias. En caso de enviarse un cdigo de idioma no registrado en Bizagi, este retornar los valores en el idioma por defecto.

Ejemplo
Con el siguiente ejemplo, se envia la siguiente informacion: application: Travel language: en-us

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:

Copyright 2013 - Bizagi

2309

xs="http://www.w3.org/2001/XMLSchema" xmlns:xsd="http://www.w3.org/2001/ XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="categories"> <xs:complexType> <xs:sequence> <xs:element name="category"> <xs:complexType> <xs:sequence> <xs:element name="categoryId" type="xs:unsignedByte"/> <xs:element name="categoryName" type="xs:string"/> <xs:element name="categoryDisplayName" type="xs:string"/> <xs:element name="categoryDescription"/> <xs:element name="categoryHelpText"/> <xs:element name="categoryDisplayOrder" type="xs:unsignedByte"/> <xs:element name="categoryCreationDate" type="xs:dateTime"/> <xs:element name="parentCategoryId" type="xs:unsignedByte"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de salida
categories: Es el nodo raz; contiene todas las categoras de la aplicacin dada. category: Contiene toda la informacin de una categora especfica. categoryId: Este es el nmero de identificacin (o llave) para la categora. categoryName: Nombre interno de la categora. categoryDisplayName: Es el nombre que el usuario ve. categoryDescription: Descripcin de la categora. categoryHelpText: Texto de ayuda de la categora. categoryDisplayOrder: Orden en el cual se muestra la categora. categoryCreationDate: Fecha de creacin de la categora. parentCategoryId: Si se trata de una sub categora, este elemento contendr el nmero de identificacin (o llave) de la categora padre, de lo contrario, contendr un 0 (cero).

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi;

2310

Copyright 2013 - Bizagi

Ntese que la categora Travel (Viajes) es la nica de la aplicacin Travel.

Mtodos Web relacionados

Una vez que obtenga la lista de categoras de negocio, puede navegar hacia ellas y obtener la lista de los Procesos para una categora en particular. Para obtener esta lista, use los mtodos g etW o rkflo w ClassesA sStrin g o g etW o rkflo w Classes. Para ms informacin sobre esta opcin, consulte getWorkflowClassesAsString. Tambin es factible que desee utilizar el mtodo g etA p p licatio n s previamente, para obtener categories presented in this article. Para ms informacin sobre esta opcin, consulte getApplications. Otra opcin para obtener las categoras es utilizar los mtodos g etCateg o ries o g etCateg o riesA sStrin g. La diferencia, es que con estos otros mtodos, se envia un nico parmetro (en vez de los 2 de tipo cadena). Para ms informacin sobre esta opcin, consulte getCategoriesAsString. 7.1.1.9 getClosedActivitiesAsString

Introduccin
Este mtodo se utiliza para obtener un listado con las Actividades cerradas en Bizagi (desde una aplicacin externa). Las actividades cerradas son aquellas que han sido completadas (donde ya se realiz el trabajo pendiente). Este mtodo recibe un nico parmetro de entrada el cual contiene principalmente: el identificador del caso (instancia de Proceso), y un nmero que representa los niveles de informacin (profundidad) que se debe manejar en cuanto a Actividades en los sub Procesos.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web g etClo sed A ctiv ities, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo getClosedActivities, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo getClosedActivitiesAsString la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Copyright 2013 - Bizagi 2311

Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="BizAgiWSParam"> <xs:complexType> <xs:sequence> <xs:element name="idCase" type="xs:integer" minOccurs="0"/> <xs:element name="subprocessDepth" type="xs: integer" minOccurs="0"/> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de entrada
BizAgiWSParam: Nodo raz. idCase: idCase (nmero de identificacin del caso) al cual pertenecen las actividades cerradas deseadas. subprocessDepth: Es un indicador de nivel de profundidad de los subprocesos. Se utiliza cuando existen tareas de tipo subproceso, para poder retornar informacin de actividades en los subrpocesos que pueda tener el caso. Por defecto, la consulta retorna un nivel de profundidad, es decir, el resultado contiene las actividades de de los subprocesos relacionados al proceso del caso actual; pero no incluye las actividades de los subprocesos dentro de los subprocesos (2 niveles de profundidad). El valor de este elemento puede ser cualquier nmero entero, pero es importante tener presente que entre ms niveles de profundidad, ms demorada ser la respuesta. por lo tanto se recomienda un nmero pequeo. v

Ejemplo
Con el siguiente ejemplo, se obtienen las Actividades ya completadas (cerradas) para el caso con identificador=9201. Con lo siguiente, se consideran dos niveles de profundidad de informacin (en torno a sub Procesos): <?xml version="1.0" encoding="utf-8"?> <BizAgiWSParam> <idCase>9201</idCase> <subprocessDepth>2</subprocessDepth> </BizAgiWSParam>

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?>

2312

Copyright 2013 - Bizagi

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> <xs:element name="workItems"> <xs:complexType> <xs:sequence> <xs:element name="workItem" type="workItemType" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element> <xs:complexType name="workItemType"> <xs:sequence> <xs:element name="workItemId" type="xs:integer"/> <xs:element name="workItemState" type="xs:string"/> <xs:element name="workItemEntryDate" type="xs:dateTime"/> <xs:element name="workItemDuration" type="xs:integer"/> <xs:element name="workItemSubprocesses"> <xs:complexType> <xs:sequence> <xs:element name="workItems" minOccurs="0"> <xs:complexType> <xs:sequence> <xs:element name="workItem" type="workItemType" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="workItemEstimatedSolutionDate" type="xs:dateTime"/> <xs:element name="workItemSolutionDate" type="xs: dateTime"/> <xs:element name="task"> <xs:complexType> <xs:sequence> <xs:element name="taskId" type="xs: integer"/> <xs:element name="taskName" type="xs: string"/> <xs:element name="taskDisplayName" type="xs:string"/> <xs:element name="taskDescription" type="xs:string"/> <xs:element name="taskHelpText" type="xs:string"/> <xs:element name="HelpURL" type="xs: string"/> <xs:element name="taskEstimatedDuration" type="xs:integer"/> <xs:element name="taskType" type="xs:

Copyright 2013 - Bizagi

2313

string"/> <xs:element name="taskCost" type="xs: integer"/> <xs:element name="taskPriority" type="xs:string"/> <xs:element name="taskTransactional" type="xs:boolean"/> <xs:element name="taskCompensation" type="xs:boolean"/> <xs:element name="taskTimerEventDuration" type="xs:integer"/> <xs:element name="AllowsReassign" type="xs:boolean"/> <xs:element name="SendNotification" type="xs:boolean"/> <xs:element name="SendAlarms" type="xs: boolean"/> <xs:element name="ExtendedEstimatedDuration" type="xs:integer"/> <xs:element name="Form" type="xs: integer"/> <xs:element name="IsAsynchTask" type="xs:boolean"/> <xs:element name="NumberOfRetries" type="xs:integer"/> <xs:element name="RetryInterval" type="xs:integer"/> <xs:element name="ShowFeedback" type="xs:boolean"/> <xs:element name="TimeoutSeconds" type="xs:integer"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="process"> <xs:complexType> <xs:sequence> <xs:element name="processId" type="xs: integer"/> <xs:element name="processRadNumber" type="xs:integer"/> <xs:element name="processCreationDate" type="xs:dateTime"/> <xs:element name="processSolutionDate" type="xs:dateTime"/> <xs:element name="processWorkflowClass"> <xs:complexType> <xs:sequence> <xs:element name="workflowClassId" type="xs:integer"/> <xs:element name="workflowClassName" type="xs:string"/>

2314

Copyright 2013 - Bizagi

<xs:element name="workflowClassDisplayName" type="xs:string"/> <xs:element name="workflowClassDescription" type="xs:string"/> <xs:element name="workflowClassHelpText" type="xs:string"/> <xs:element name="workflowClassHelpURL" type="xs:string"/> <xs:element name="workflowClassDisplayOrder" type="xs:integer"/> <xs:element name="workflowClassCreationDate" type="xs:dateTime"/> <xs:element name="workflowClassGlobalForm" type="xs:integer"/> <xs:element name="workflowClassAllocationPrinciple" type="xs:string"/> <xs:element name="workflowClassProcessType" type="xs:string"/> <xs:element name="workflowClassDisplay" type="xs:boolean"/> <xs:element name="workflowClassUseParentRadicationNumber" type="xs:boolean"/> <xs:element name="workflowClassSupportsScopes" type="xs:boolean"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="processError"> <xs:complexType> <xs:sequence> <xs:element name="errorCode" type="xs:string"/> <xs:element name="errorMessage" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:schema>

Parmetros de salida
workItems: Nodo raz de la respuesta; contiene un nodo "workItem" para cada actividad includa en el resultado. workItem: Actividad especfica (instancia de una tarea) del proceso activo para el caso. workItemId: Nmero de identificacin o llave de la actividad. workItemState: Estado en el que se encuentra la actividad. workItemEntryDate: Fecha y hora cuando se ingresa por primera vez a la actividad.

Copyright 2013 - Bizagi

2315

workItemDuration: Duracin estimada, en minutos, para esta actividad. workItemSubprocesses: Si la actividad es de tipo subproceso, este elemento incluir informacin de las actividades cerradas del subproceso. Tiene un nodo hijo llamado "workItems" de manera que desde all en adelante, la estructura es la misma que la descrita anteriormente a partir del workitem de la actividad que cumple con los criterios de bsqueda. workItemEstimatedSolutionDate: Fecha estimada de solucin de la actividad. workItemSolutionDate: Fecha en la cual se complet la actividad. task: Contiene informacin acerca de la tarea correspondiente a la actividad. taskId: Nmero de identificacin o llave de la tarea. taskName: Nombre de la tarea. taskDisplayName: Nombre a mostrar de la tarea. taskDescription: Texto descriptivo de la tarea. taskHelpText: Texto de ayuda de la tarea. HelpUrl: URL con informacin de la tarea. taskEstimatedDuration: Duracin estimada de la tarea, en minutos, for the task. taskType: Tipo de tarea. taskCost: Costo estimado de la tarea. Este valor, como el de las fechas estimadas, se configura y determina por la persona que disea en proceso. taskPriority: Prioridad de la tarea. taskTransactional: Indica si la tarea es transaccional. taskCompensation: Indica si se trata de una tarea de compensacin. taskTimerEventDuration: Se usa si la tarea es un temporizador, la duracin se incluye en minutos. AllowsReassign: Marca que muestra si la tarea puede ser reasignada a otro usuario. SendNotification: Indica si un se debe enviar un email a un usuario informando sobre la disponibilidad de la tarea. SendAlarms: Indica si se debe enviar un email al usuario asignado informando que la tarea est prxima a vencerse. ExtendedEstimatedDuration: Tiempo estimado de duracin extendida. Form: Reservado para uso futuro. IsAsynchTask: Especifica si se trata de una tarea asincrnica. Utilizado normalmente para interfaces. NumberOfRetries: Aplica para tareas asincrnicas. Es el nmero de reintentos automticos de la tarea en caso de presentarse una falla (se arroja una excepcin). RetryInterval: Aplica para tareas asincrnicas. Es el tiempo (en minutos) entre cada reintento. ShowFeedback: Aplica para tareas asincrnicas. Indica si el usuario ser informado en caso de presentarse un error. TimeoutSeconds: Aplica para tareas asincrnicas. Tiempo mximo (en segundos) que la tarea asincrnica debe esperar por una respuesta del sistema externo. process: Tiene informacin sobre el proceso al cual pertenece la actividad. processId: Nmero de identificacin del caso (idCase). processCreationDate: Fecha de creacin del caso. processSolutionDate: Fecha de solucin del caso. processWorkflowClass: Este nodo contiene bsicamente informacin sobre el proceso (metadata) y no sobre el caso en particular. workflowClassId: Nmero de identificacin (o llave) del proceso. workflowClassName: Nombre del proceso. workflowClassDisplayName: Nombre a mostrar del proceso. workflowClassDescription: Descripcin del proceso. workflowClassHelpText: Texto de ayuda del proceso. workflowClassHelpURL: URL de ayuda del proceso. workflowClassDisplayOrder: Orden en el cual aparecer el proceso en la aplicacin web.

2316

Copyright 2013 - Bizagi

workflowClassCreationDate: Fecha de creacin del proceso. workflowClassGlobalForm: Nmero de identificacin de la forma global del proceso (cero si no se encuentra configurada). workflowClassAllocationPrinciple: Reservado para uso futuro. workflowClassProcessType: Tipo de proceso. workflowClassDisplay: Indica si el proceso es visible o no. workflowClassUseParentRadicationNumber: Indica si un caso de este proceso es creado utilizando si propio nmero de creacin o si es el mismo nmero que el del proceso padre (en caso de ser un subproceso). workflowClassSupportScopes: Indica si el proceso soporta los "scopes" de Bizagi; los cuales constituyen un mtodo eficiente para la persistencia de datos. processError: Contiene informacin de los errores que ocurren durante el procesamiento de este mtodo. errorCode: Cdigo del error, en caso de presentarse alguno. errorMessage: Mensaje de error, en caso de presentarse alguno.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi;

Copyright 2013 - Bizagi

2317

Mtodos Web relacionados

Para obtener un listado de Actividades abiertas, use los mtodos g etA ctiv itiesA sStrin g o g etA ctiv ities. Para ms informacin sobre esta opcin, consulte getActivitiesAsString. 7.1.1.10 getEventsAsString

Introduccin
Este mtodo se se utiliza para obtener un listado de los Eventos disponibles en Bizagi (desde una aplicacin externa). 2318 Copyright 2013 - Bizagi

Los Eventos disponibles son aquellos Eventos (de tipo BPMN, como el Intermedio), los cuales estn activos y en espera de la posibilidad de que sean disparados. Este mtodo recibe un nico parmetro de entrada el cual contiene principalmente: el identificador del caso (instancia de Proceso) u otros criterios de filtro. A travs de este mtodo, se obtienen los Eventos que estn como pendientes para ejecucin, as como se despliegan al estar disponibles en el Portal de Trabajo. Para ms informacin acerca de esta opcin en el Portal, consulte Portal de Trabajo de Bizagi.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web g etEv en ts, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo getEvents, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo getEventsAsString la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="BizAgiWSParam"> <xs:complexType> <xs:sequence> <xs:element name="domain" type="xs:string" minOccurs="0"/> <xs:element name="userName" type="xs:string" minOccurs="0"/> <xs:element name="radNumber" type="xs:string" minOccurs="0"/> <xs:element name="processName" type="xs:string" minOccurs="0"/> <xs:element name="idCase" type="xs:integer" minOccurs="0"/> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de entrada
BizAgiWSParam: Nodo raz. En este nodo se deben incluir todos los filtros necesarios. Estos filtros son opcionales. Si se utiliza mas de un criterio de bsqueda, el resultado seran nicamente las actividades que cumplan con todas las condiciones. domain: Eventos de bsqueda cuyo usuario asignado pertenezca a este dominio. userName: Eventos de bsqueda cuyo usuario asignado es el que se encuentra indicado en este

Copyright 2013 - Bizagi

2319

elemento. radNumber: Eventos que pertenecen a este nmero de creacin (nmero de caso). processName: Obtiene los eventos de este proceso (ingrese el nombre, no el nombre a mostrar).

Ejemplo
Con el siguiente ejemplo, se obtiene la lista de eventos activos para el caso con identificador = 351. <?xml version="1.0" encoding="utf-8"?> <BizAgiWSParam> <radNumber>351</radNumber> </BizAgiWSParam>

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> <xs:element name="workItems"> <xs:complexType> <xs:sequence> <xs:element name="workItem" type="workItemType" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element> <xs:complexType name="workItemType"> <xs:sequence> <xs:element name="workItemId" type="xs:integer"/> <xs:element name="workItemState" type="xs:string"/> <xs:element name="workItemEntryDate" type="xs:dateTime"/> <xs:element name="workItemDuration" type="xs:integer"/> <xs:element name="workItemEstimatedSolutionDate" type="xs:dateTime"/> <xs:element name="workItemSolutionDate" type="xs: dateTime"/> <xs:element name="task"> <xs:complexType> <xs:sequence> <xs:element name="taskId" type="xs: integer"/> <xs:element name="taskName" type="xs: string"/> <xs:element name="taskDisplayName" type="xs:string"/> <xs:element name="taskDescription" type="xs:string"/> <xs:element name="taskHelpText" type="xs:string"/>

2320

Copyright 2013 - Bizagi

<xs:element name="HelpURL" type="xs: string"/> <xs:element name="taskEstimatedDuration" type="xs:integer"/> <xs:element name="taskType" type="xs: string"/> <xs:element name="taskCost" type="xs: integer"/> <xs:element name="taskPriority" type="xs:string"/> <xs:element name="taskTransactional" type="xs:boolean"/> <xs:element name="taskCompensation" type="xs:boolean"/> <xs:element name="taskTimerEventDuration" type="xs:integer"/> <xs:element name="AllowsReassign" type="xs:boolean"/> <xs:element name="SendNotification" type="xs:boolean"/> <xs:element name="SendAlarms" type="xs: boolean"/> <xs:element name="ExtendedEstimatedDuration" type="xs:integer"/> <xs:element name="Form" type="xs: integer"/> <xs:element name="IsAsynchTask" type="xs:boolean"/> <xs:element name="NumberOfRetries" type="xs:integer"/> <xs:element name="RetryInterval" type="xs:integer"/> <xs:element name="ShowFeedback" type="xs:boolean"/> <xs:element name="TimeoutSeconds" type="xs:integer"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:schema>

Parmetros de salida
workItems: Nodo raz de la respuesta; contienen un nodo "workItem" para cada evento includo en el resultado. workItem: Evento especfico (instancia de una tarea) del proceso que se encuentra activo para el caso. workItemId: Nmero de identificacin o llave de la tarea. workItemState: Estado en el que se encuentra la tarea. workItemEntryDate: Fecha y hora cuando se ingresa a la tarea por primera vez.

Copyright 2013 - Bizagi

2321

workItemDuration: Duracin estimada, en minutos, para la tarea. workItemEstimatedSolutionDate: Es la fecha estimada de solucin para el caso. workItemSolutionDate: Fecha en la cual se complet la tarea. task: Contiene informacin sobre la tarea que corresponde a este evento. taskId: Nmero de identificacin o llave de la tarea. taskName: Nombre de la tarea. taskDisplayName: Nombre a mostrar de la tarea. taskDescription: Texto descriptivo de la tarea. taskHelpText: Texto de ayuda de la tarea. HelpUrl: URL con informacin de la actividad. taskEstimatedDuration: Duracin estimada, en miniutos , para la tarea. taskType: Tipo de tarea. taskCost: Costo estimado de la tarea. Este valor, como el de la fecha estimada, se confiigura y determina por la persona que disea el proceso. taskPriority: Prioridad de cumplimiento de la tarea. taskTransactional: Indica si la tarea es transaccional. taskCompensation: Indica si es una tarea de compensacin. taskTimerEventDuration: Si se trata de un temporizador, este contendr la duracin en minutos. AllowsReassign: Una marca que muestra si la tarea puede ser asignada a un usuario diferente. SendNotification: Indica si se debe enviar un email a un usuario informndole que la tarea se encuentra disponible. SendAlarms: Indica si se debe enviar un email al usuario asignado informndole que la tarea se encuentra prxima a vencerse. ExtendedEstimatedDuration: Tiempo estimado de duracin extendida. Form: Resevado para uso futuro. IsAsynchTask: Especifica si se trata de una trea asincrnica. Usualmente utilizado para interfaces. NumberOfRetries: Aplica para tareas asincrnicas. Es el nmero de reintentos automticos para una tarea en caso de falla o error (se arroja una excepcin). RetryInterval: Aplica para tareas asincrnicas. Es el tiempo (en minutos) entre cada reintento. ShowFeedback: Aplica para tareas asincrnicas. Indica si se informar al usuario cuando se presente un error. TimeoutSeconds: Aplica para tareas asincrnicas. Tiempo (en segundos) que la tarea asincrnica esperar por una respuesta del sistema externo.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi.

2322

Copyright 2013 - Bizagi

Mtodos Web relacionados

Para obtener un listado de Actividades pendientes de un caso en particular, use los mtodos g etA ctiv itiesA sStrin g o g etA ctiv ities. Para ms informacin sobre esta opcin, consulte getActivityAsString. Una vez que obtenga los Eventos disponibles, puede optar por ejecutarlos y actualizar la informacin de negocio. Para ello, use los mtodos setEv en tA sStrin g o setEv en t. Para ms informacin sobre esta opcin, consulte setEventAsString. 7.1.1.11 getWorkflowClassesAsString

Introduccin
Este mtodo se utiliza para obtener un listado de los Procesos que pertencen a cierta categora de negocio en Bizagi (desde una aplicacin externa). Este mtodo recibe un nico parmetro de entrada el cual contiene el nombre de la categora a la que pertenecen los Procesos. Los Procesos estn clasificados por categoras, como se define en Bizagi Studio en el mdulo de Procesos, para cada aplicacin y categora (jerrquicamente):

Copyright 2013 - Bizagi

2323

Ntese que para la categora Travel (Viajes), encontramos 2 Procesos: Solicitud de viajes (Travel Request) y Reporte de gastos (Expenses report). Nota: La descripcin en este artculo aplica tambin para el mtodo Web g etW o rkflo w Classes, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo getWorkflowClasses, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo getWorkflowClassesAsString la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="BizAgiWSParam"> <xs:complexType> <xs:sequence> <xs:element name="category" type="xs:string"/>

2324

Copyright 2013 - Bizagi

</xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de entrada
BizAgiWSParam: Nodo raz. category: Contiene el nombre de la categora que ser consultada (ingrese el nombre, no el nombre a mostrar).

Ejemplo
Con el siguiente ejemplo, se obtienen los Procesos para la categora Travel: <?xml version="1.0" encoding="utf-8"?> <BizAgiWSParam> <category>Travel</category> </BizAgiWSParam>

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns: xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="workflowClasses"> <xs:complexType> <xs:sequence> <xs:element name="workflowClass" maxOccurs="unbounded"> <xs:complexType> <xs:sequence> <xs:element name="workflowClassId" type="xs:unsignedByte"/> <xs:element name="workflowClassName" type="xs:string"/> <xs:element name="workflowClassDisplayName" type="xs:string"/> <xs:element name="workflowClassDescription"/> <xs:element name="workflowClassHelpText"/> <xs:element name="workflowClassHelpURL"/> <xs:element name="workflowClassDisplayOrder" type="xs:unsignedByte"/> <xs:element name="workflowClassCreationDate" type="xs:dateTime"/> <xs:element name="workflowClassGlobalForm" type="xs:unsignedByte"/>

Copyright 2013 - Bizagi

2325

<xs:element name="workflowClassAllocationPrinciple" type="xs:string"/> <xs:element name="workflowClassProcessType" type="xs:string"/> <xs:element name="workflowClassDisplay" type="xs:boolean"/> <xs:element name="workflowClassUseParentRadicationNumber" type="xs:boolean"/> <xs:element name="workflowClassSupportsScopes" type="xs:boolean"/> <xs:element name="caseAccessType" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de salida
workflowClasses: Nodo raz. Contiene un nodo workflowClass por cada proceso dentro de la categora dada. workflowClass: La informacin en este nodo es bsicamente informacin del proceso (metadata). workflowClassId: Nmero de identificacin (o llave) del proceso. workflowClassName: Nombre del proceso. workflowClassDisplayName: Nombre a mostrar del proceso. workflowClassDescription: Descripcin del proceso. workflowClassHelpText: Texto de ayuda del proceso. workflowClassHelpURL: URL de ayuda para el proceso. workflowClassDisplayOrder: El orden en el cual aparece el proceso dentro de la aplicacin web. workflowClassCreationDate: Fecha de creacin del proceso. workflowClassGlobalForm: Nmero de identificacin de la froma global del proceso (cero si no se encuentra configurada). workflowClassAllocationPrinciple: Reservado para uso futuro. workflowClassProcessType: Tipo de proceso. workflowClassDisplay: Indica si el proceso es visible o no. workflowClassUseParentRadicationNumber: Indica si un caso de este proceso utiliza su propio nmero de creacin o el mismo nmero que el proceso padre (en caso de ser subproceso). workflowClassSupportScopes: Indica si el proceso soporta los "scopes" de Bizagi; los cuales son un mtodo ms eficiente de persistencia de datos.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi;

2326

Copyright 2013 - Bizagi

Ntese que dentro de la categora de Travel (Viajes), tenemos 2 Procesos: Travel Request (Solicitud de Viaje) y Expenses report (Reporte de gastos).

Mtodos Web relacionados

Es posible que se desee utilizar los mtodos g etCateg o riesA sStrin g o g etCateg o ries previamente para obtener la categora a la que pertenecen estos Processes. Para ms informacin sobre esta opcin, consulte getCategoriesAsString. Otra opcin para obtener los Procesos es utilizando el mtodo g etW o rkflo w ClassesF ro m Categ o ry N am e. La diferencia en este otro mtodo es que el dato de entrada es una nica cadena que no contiene formato XML. Para ms informacin sobre esta opcin, consulte getWorkflowClassesFromCategoryName.

7.1.1.12 getWorkflowClassesFromCategoryName

Introduccin
Este mtodo se utiliza para obtener un listado de los Procesos que pertencen a cierta categora de negocio en Bizagi (desde una aplicacin externa).

Copyright 2013 - Bizagi

2327

Este mtodo recibe un nico parmetro de entrada el cual contiene el nombre de la categora a la que pertenecen los Procesos. A diferencia del mtodo g etW o rkflo w ClassesA sStrin g , el dato de entrada NO contiene formato de XML. Los Procesos estn clasificados por categoras, como se define en Bizagi Studio en el mdulo de Procesos, para cada aplicacin y categora (jerrquicamente):

Ntese que para la categora Travel (Viajes), encontramos 2 Procesos: Solicitud de viajes (Travel Request) y Reporte de gastos (Expenses report).

Datos de entrada
Los datos de entrada se especifican en un parmetro de tipo cadena (string).

Parmetros de entrada
categora: Contiene el nombre de la categora de negocio para la cual vamos a obtener los Procesos (el nombre real, no el nombre de mostrar).

2328

Copyright 2013 - Bizagi

Ejemplo
Con el siguiente ejemplo, se envia como dato de entrada: categora: Travel

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns: xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="workflowClasses"> <xs:complexType> <xs:sequence> <xs:element name="workflowClass" maxOccurs="unbounded"> <xs:complexType> <xs:sequence> <xs:element name="workflowClassId" type="xs:unsignedByte"/> <xs:element name="workflowClassName" type="xs:string"/> <xs:element name="workflowClassDisplayName" type="xs:string"/> <xs:element name="workflowClassDescription"/> <xs:element name="workflowClassHelpText"/> <xs:element name="workflowClassHelpURL"/> <xs:element name="workflowClassDisplayOrder" type="xs:unsignedByte"/> <xs:element name="workflowClassCreationDate" type="xs:dateTime"/> <xs:element name="workflowClassGlobalForm" type="xs:unsignedByte"/> <xs:element name="workflowClassAllocationPrinciple" type="xs:string"/> <xs:element name="workflowClassProcessType" type="xs:string"/> <xs:element name="workflowClassDisplay" type="xs:boolean"/> <xs:element name="workflowClassUseParentRadicationNumber" type="xs:boolean"/> <xs:element name="workflowClassSupportsScopes" type="xs:boolean"/> <xs:element name="caseAccessType" type="xs:string"/> </xs:sequence>

Copyright 2013 - Bizagi

2329

</xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de salida
workflowClasses: Nodo raz. Contiene un nodo workflowClass para cada proceso en la categora dada. workflowClass: La informacin en este nodo es bsicamente informacin del proceso (metadata). workflowClassId: Nmero de identificacin (o llave) del proceso. workflowClassName: Nombre del proceso. workflowClassDisplayName: Nombre a mostrar del proceso. workflowClassDescription: Descripcin del proceso. workflowClassHelpText: Texto de ayuda del proceso. workflowClassHelpURL: URL de ayuda del proceso. workflowClassDisplayOrder: Orden en el cual aparecern los procesos dentro de la aplicacin. workflowClassCreationDate: Fecha de creacin del proceso. workflowClassGlobalForm: Nmero de identificacin de la forma global del proceso (cero si no est configurada). workflowClassAllocationPrinciple: Reserva a para uso futuro. workflowClassProcessType: Tipo de proceso. workflowClassDisplay: Indica si el proceso se encuentra visible. workflowClassUseParentRadicationNumber: Indica si un caso del proceso utiliza su propio nmero de creacin o si es el mismo nmero que el del proceso padre (aplica si es un subproceso). workflowClassSupportScopes: Indica si el proceso soporta los "scopes" de Bizagi; los cuales constituyen un mtodo eficiente de persistencia de datos.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi, en donde;

2330

Copyright 2013 - Bizagi

Ntese que para la categora Travel (Viajes), encontramos 2 Procesos diferentes: Travel request (Solicitud de viaje) y Expenses report (Reporte de gastos).

Mtodos Web relacionados

Es posible que se desee utilizar los mtodos g etCateg o riesA sStrin g o g etCateg o ries para obtener las categoras de negocio a la cul pertenece un listado de Procesos. Para ms informacin sobre esta opcin, consulte getCategoriesAsString. Otra opcin para obtener el listado de Procesos de una categora dada, es utilizando los mtodos g etW o rkflo w ClassesA sStrin g o g etW o rkflo w Classes. La diferencia con estos mtodos es que los otros reciben una cadena con la informacin en formato XML. Para ms informacin sobre esta opcin, consulte getWorkflowClassesAsString. 7.1.1.13 perfomActivityAsString

Introduccin
Este mtodo se utiliza para ejecutar o realizar una Actividad que est pendiente (en el Inbox) en Bizagi (desde una aplicacin externa). De esta forma, la Actividad se completa y el caso contina a lo siguiente que se deba realizar en el

Copyright 2013 - Bizagi

2331

flujo. Este mtodo recibe un nico parmetro de entrada el cual contiene principalmente: el usuario que ejecuta la Actividad, el identificador del caso sobre el cual se realiza la Actividad, el nombre de la Actividad e informacin de negocio relevante a la misma. Al invocar este mtodo, se completa la Actividad y se ejecutan las reglas de negocio que hayan a la salida de la misma, de la misma manera en que se realiza desde el Portal de Trabajo. Para ms informacin acerca de esta opcin en el Portal, consulte Portal de Trabajo de Bizagi.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web p erfo rm A ctiv ity, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo performActivity, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo performActivityAsString la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="BizAgiWSParam"> <xs:complexType> <xs:sequence> <xs:element name="domain" type="xs:string"/> <xs:element name="userName" type="xs:string"/> <xs:element name="ActivityData"> <xs:complexType> <xs:sequence> <xs:choice> <xs:element name="idCase" type="xs:integer"/> <xs:element name="radNumber" type="xs:string"/> </xs:choice> <xs:choice> <xs:element name="taskId" type="xs:integer"/> <xs:element name="taskName" type="xs:string"/> </xs:choice> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="Entities"> <xs:complexType/> </xs:element>

2332

Copyright 2013 - Bizagi

</xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de entrada
BizAgiWSParam: Nodo raz, contiene toda la informacin necesaria para avanzar la actividad. domain: Nombre del dominio al cual pertenece el usuario de Bizagi que aparecer como aquel que avanz la Actividad. userName: Nombre del usuario que ser registrado como el usuario que avanz la actividad. ActivityData: Contiene toda la informacin correspondiente a la actividad. Esta informacin es necesaria para encontrar dicha actividad. idCase: Nmero de identificacin del caso para la actividad que se desea avanzar. Es necesario incluir este elemento o el Nmero de Radicacin (radNumber). radNumber: Elemento alternativo al idCase. Es el nmero de creacin (case number) del caso que contiene la actividad pediente que se desea avanzar.Cuando se usa el mismo nmero de creacin en varios casos (por ejemplo, si un subproceso tiene el mismo nmero que el caso padre) se debe usar el nmero del caso (idCase) para distinguir a cual caso pertenece la actividad. taskId: Nmero de identificacin de la Actividad que se desea avanzar. Este elemento es necesario; si no se conoce el nmero, se debe incluir el nombre de la tarea (taskName). taskName: Usado como elemento alternativo al id de la tarea (taskId). Es el nombre de la actividad pendiente que se desea avanzar. Entities: Nodo que contiene los valores de las informacin de negocio que ser asociada al caso. Para ms informacin sobre la estructura esperada de los elementos dentro de Entities, consulte cmo se representan el modelo de datos del Proceso en Esquema XML de Bizagi para el modelo de datos .

Ejemplo
Con el siguiente ejemplo, se completar la Actividad cuyo nombre es (Task name = Task3), para el caso con identificador 9253.

Copyright 2013 - Bizagi

2333

Si desea ver un ejemplo completo con un caso de negocio para utilizar el mtodo p erfo rm A ctiv ity A sStrin g , consulte Cmo realizar una Actividad en Bizagi desde aplicaciones externas.

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="process"> <xs:complexType> <xs:sequence> <xs:element name="processId" type="xs: unsignedShort"/> <xs:element name="processRadNumber" type="xs: unsignedShort"/> <xs:element name="savedMessage"> <xs:complexType> <xs:sequence> <xs:element name="Entities" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="processWorkflowClass"> <xs:complexType> <xs:sequence> <xs:element name="workflowClassId" type="xs:unsignedByte"/> <xs:element name="workflowClassName" type="xs:string"/> <xs:element name="workflowClassDisplayName" type="xs:string"/> <xs:element name="workflowClassDescription" type="xs:string"/> <xs:element name="workflowClassHelpText" type="xs:string"/> <xs:element name="workflowClassDisplayOrder" type="xs:unsignedByte"/> <xs:element name="workflowClassCreationDate" type="xs:string"/> <xs:element name="workflowClassGlobalForm" type="xs:unsignedByte"/> <xs:element name="workflowClassAllocationPrinciple" type="xs:string"/> <xs:element name="workflowClassProcessType" type="xs:string"/> <xs:element name="workflowClassDisplay" type="xs:string"/>

2334

Copyright 2013 - Bizagi

<xs:element name="workflowClassUseParentRadicationNumber" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="processError"> <xs:complexType> <xs:sequence> <xs:element name="errorCode" type="xs:string"/> <xs:element name="errorMessage"> <xs:complexType mixed="true"> <xs:sequence minOccurs="0"> <xs:element name="Entities"> <xs: complexType> <xs:sequence> <xs:element name="Path" type="xs:string"/> <xs:element name="Atrib" type="xs:string"/> <xs:element name="Value" type="xs:string"/> <xs:element name="ErrorMessage" type="xs:string"/> </ xs:sequence> </xs: complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="CurrentWorkItems"> <xs:complexType> <xs:sequence> <xs:element name="workItem"> <xs:complexType> <xs:sequence> <xs:element name="workItemId" type="xs:unsignedShort"/> <xs:element name="workItemState" type="xs:string"/> <xs:element name="workItemEntryDate" type="xs:string"/> <xs:element

Copyright 2013 - Bizagi

2335

name="workItemDuration" type="xs:unsignedByte"/> <xs:element name="workItemEstimatedSolutionDate" type="xs:string"/> <xs:element name="task"> <xs: complexType> <xs:sequence> <xs:element name="taskId" type="xs:unsignedByte"/> <xs:element name="taskName" type="xs:string"/> <xs:element name="taskDisplayName" type="xs:string"/> <xs:element name="taskDescription" type="xs:string"/> <xs:element name="taskHelpText" type="xs:string"/> <xs:element name="taskEstimatedDuration" type="xs:unsignedByte"/> <xs:element name="taskType" type="xs:string"/> <xs:element name="taskCost" type="xs:unsignedByte"/> <xs:element name="taskPriority" type="xs:string"/> </ xs:sequence> </xs: complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de salida
process: Este elemento incluye informacin del proceso. processId: Nmero de identificacin del caso (idCase). processRadNumber: Valor Alfanumrico correspondiente al nmero de creacin del caso. savedMessage: Reservado para uso futuro. Entities: Reservado para uso futuro. processWorkflowClass: Este nodo contiene informacin del proceso (metadata), no informacin de un caso en particular.

2336

Copyright 2013 - Bizagi

workflowClassId: Nmero de identificacin (o llave) del proceso. workflowClassName: Nombre del proceso. workflowClassDisplayName: Nombre a mostrar del proceso. workflowClassDescription: Descripcin del proceso. workflowClassHelpText: Texto de ayuda del proceso. workflowClassHelpURL: URL de ayuda del proceso. workflowClassDisplayOrder: Orden en el cual aparecern los procesos en Bizagi Studio. workflowClassCreationDate: Fecha de creacin del proceso. workflowClassGlobalForm: Nmero de identificacin de la forma global del proceso (cero en caso de no estar configurada). workflowClassAllocationPrinciple: Reservada para uso futuro. workflowClassProcessType: Tipo de proceso. workflowClassDisplay: Indica si un proceso es o no visible. workflowClassUseParentRadicationNumber: Indica si un caso del proceso utiliza su propio nmero de creacin si usa el mismo nmero que el del proceso padre (en caso de ser un subproceso). processError: Si el proceso de avanzar la actividad no fue exitoso, este elemento contendr la informacin del error. errorCode: Cdigo del error, si no hubo error, este nodo estar vaco. errorMessage: Mensaje del error presentado, si no hubo error este nodo estar vaco. Path: XPath del elemento en el XML de entrada que genera el error . Visible cuando el error se presenta por informacin incorrecta. Attrib: Nombre del atributo en Bizagi donde se intent almacenar la informacin que gener el error. Este nodo es visible nicamente cuando el error es generado por informacin incorrecta. Value: Valor que gener el error. Este nodo es visible nicamente cuando el error es generado por informacin incorrecta. ErrorMessage: Mensaje explicatorio sobre el error. Visible si el error fue generado por informacin incorrecta. CurrentWorkItems: Serie de actividades desponibles para el caso. workItem: Actividad especfica (instancia de la tarea) del proceso que se encuentra activo para el caso. workItemId: Nmero de identificacin o llave de la actividad. workItemState: Estado en el que se encuentra la actividad. workItemEntryDate: Fecha y hora en la cual se llega a la actividad por primera vez. workItemDuration: Duracin estimada, en minutos, para la actividad. workItemEstimatedSolutionDate: Fecha estimada de solucin del caso. Task: Contiene informacin sobre la tarea asociada a la actividad. taskId: Nmero de identificacin o llave de la tarea. taskName: Nombre de la tarea. taskDisplayName: Nombre a mostrar de la tarea. taskDescription: Texto descriptivo de la tarea. taskHelpText: Texto de ayuda de la tarea. taskEstimatedDuration: Duracin estimada de la tarea, en minutos. taskType: Tipo de tarea. taskCost: Costo estimado de la tarea. Este valor, al igual que las fechas estimadas, es configurado y determinado por la persona que disea el proceso. taskPriority: Prioridad para el cumplimiento de la tarea.

Ejemplo

Copyright 2013 - Bizagi

2337

Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi:

Mtodos Web relacionados

Para obtener un listado de Actividades pendientes de un caso en particular, use los mtodos g etA ctiv itiesA sStrin g o g etA ctiv ities. Para ms informacin sobre esta opcin, consulte getActivityAsString.

2338

Copyright 2013 - Bizagi

If you wish to trigger a business Event instead (set the occurrence of a BPMN Intermediate Event), use the setEv en tA sStrin g or setEv en t Web method. For further information refer to the setEventAsString article. If you wish to only input information for a pending Activity without completing it (simulate clicking on the Save button in a form, instead of the Next button), use the sav eA ctiv ity A sStrin g or sav eA ctiv ity Web method. For further information refer to the saveActivityAsString article. Si desea iniciar el Proceso (crear un caso) en vez de avanzar uno existente, use los mtodos createCasesA sStrin g o createCases. Para ms informacin sobre esta opcin, consulte createCasesAsString. 7.1.1.14 saveActivityAsString

Introduccin
Este mtodo se utiliza para guardar el progreso de una Actividad pendiente (aquellas Actividades en el Inbox), desde una aplicacin externa. A travs de este mtodo, la Actividad no avanza (no es completada con Sig u ien te), como sucede con el mtodo p erfo rm A ctiv ity A sStrin g. A su vez, este mtodo funciona al igual que cuando se da clic en Gu ard ar en una Actividad (lo cual lo hace til para ejecutar las reglas de negocio que se realizan al guardar). Este mtodo recibe un nico parmetro de entrada el cual contiene principalmente: el usuario el cual guarda el progreso de la Actividad, la informacin de negocio de la Actividad, el identificador del caso y el nombre de la Actividad. Con ello, se guarda lo que se ha diligenciado de la Actividad,,de la misma manera como se realiza desde el Portal de Trabajo. Para ms informacin acerca de esta opcin en el Portal, consulte Portal de Trabajo de Bizagi.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web sav eEn tity, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo saveEntity, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo saveEntityAsString la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="BizAgiWSParam">

Copyright 2013 - Bizagi

2339

<xs:complexType> <xs:sequence> <xs:element name="domain" type="xs:string"/> <xs:element name="userName" type="xs:string"/> <xs:element name="ActivityData"> <xs:complexType> <xs:sequence> <xs:element name="radNumber" type="xs:string"/> <xs:element name="taskName" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="Entities"> <xs:complexType/> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema> Para ms informacin sobre la estructura esperada de los elementos dentro de Entities, consulte cmo se representan el modelo de datos del Proceso en Esquema XML de Bizagi para el modelo de datos .

Parmetros de entrada
BizAgiWSParam: Nodo raz. domain: Nombre del dominio del usuario de Bizagi que se va a registrar como el usuario que guard la informacin en la actividad. userName: Nombre del usuario que se va a registrar como el usuario que guard la informacin en la actividad. ActivityData: Contiene toda la informacin necesaria para encontrar la actividad. radNumber: Nmero de creacin (nmero del caso) del caso que contiene la actividad pendiente en la cual se almacenar la informacin. Este elemento es requerido. taskName: Nombre de la actividad pendiente en la cual se almacenar la informacin. Entities: Nodo que contiene los valores de la informacin de negocio que se va a guardar en el caso.

Ejemplo
Con el siguiente ejemplo, se guarda el progreso de la Actividad con Nombre= Task3, para el caso con identificador= 9301.

2340

Copyright 2013 - Bizagi

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns: xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="process"> <xs:complexType> <xs:sequence> <xs:element name="processId" type="xs:integer"/> <xs:element name="processRadNumber" type="xs: string"/> <xs:element name="savedMessage"> <xs:complexType> <xs:sequence> <xs:element name="Entities" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="processCreationDate" type="xs: dateTime"/> <xs:element name="processSolutionDate" type="xs: dateTime"/> <xs:element name="processWorkflowClass"> <xs:complexType> <xs:sequence>

Copyright 2013 - Bizagi

2341

<xs:element name="workflowClassId" type="xs:integer"/> <xs:element name="workflowClassName" type="xs:string"/> <xs:element name="workflowClassDisplayName" type="xs:string"/> <xs:element name="workflowClassDescription" type="xs:string"/> <xs:element name="workflowClassHelpText" type="xs:string"/> <xs:element name="workflowClassHelpURL" type="xs:string"/> <xs:element name="workflowClassDisplayOrder" type="xs:integer"/> <xs:element name="workflowClassCreationDate" type="xs:dateTime"/> <xs:element name="workflowClassGlobalForm" type="xs:integer"/> <xs:element name="workflowClassAllocationPrinciple" type="xs:string"/> <xs:element name="workflowClassProcessType" type="xs:string"/> <xs:element name="workflowClassDisplay" type="xs:boolean"/> <xs:element name="workflowClassUseParentRadicationNumber" type="xs:boolean"/> <xs:element name="workflowClassSupportsScopes" type="xs:boolean"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="processError"> <xs:complexType> <xs:sequence> <xs:element name="errorCode"/> <xs:element name="errorMessage"> <xs:complexType mixed="true"> <xs:sequence minOccurs="0"> <xs:element name="Entities"> <xs: complexType> <xs:sequence> <xs:element name="Path" type="xs:string"/> <xs:element name="Atrib" type="xs:string"/> <xs:element name="Value" type="xs:string"/>

2342

Copyright 2013 - Bizagi

<xs:element name="ErrorMessage" type="xs:string"/> </ xs:sequence> </xs: complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="CurrentWorkItems"> <xs:complexType> <xs:sequence> <xs:element name="workItem"> <xs:complexType> <xs:sequence> <xs:element name="workItemId" type="xs:integer"/> <xs:element name="workItemState" type="xs:string"/> <xs:element name="workItemEntryDate" type="xs:dateTime"/> <xs:element name="workItemDuration" type="xs:integer"/> <xs:element name="workItemSubprocesses"/> <xs:element name="workItemEstimatedSolutionDate" type="xs:dateTime"/> <xs:element name="workItemSolutionDate" type="xs:dateTime"/> <xs:element name="task"> <xs: complexType> <xs:sequence> <xs:element name="taskId" type="xs:integer"/> <xs:element name="taskName" type="xs:string"/> <xs:element name="taskDisplayName" type="xs:string"/> <xs:element name="taskDescription" type="xs:string"/> <xs:element name="taskHelpText" type="xs:string"/> <xs:element name="taskEstimatedDuration" type="xs:integer"/> <xs:element name="taskType" type="xs:string"/>

Copyright 2013 - Bizagi

2343

<xs:element name="taskCost" type="xs:integer"/> <xs:element name="taskPriority" type="xs:string"/> <xs:element name="taskTransactional" type="xs:boolean"/> <xs:element name="taskCompensation" type="xs:boolean"/> <xs:element name="taskTimerEventDuration" type="xs:integer"/> <xs:element name="AllowsReassign" type="xs:boolean"/> <xs:element name="SendNotification" type="xs:boolean"/> <xs:element name="SendAlarms" type="xs:boolean"/> <xs:element name="ExtendedEstimatedDuration" type="xs:integer"/> <xs:element name="Form" type="xs:integer"/> <xs:element name="IsAsynchTask" type="xs:boolean"/> <xs:element name="NumberOfRetries" type="xs:integer"/> <xs:element name="RetryInterval" type="xs:integer"/> <xs:element name="ShowFeedback" type="xs:boolean"/> <xs:element name="TimeoutSeconds" type="xs:integer"/> </ xs:sequence> </xs: complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de salida
process: Este elemento incluye informacin del proceso. processId: Nmero de identificacin del caso (idCase). processRadNumber: Valor alfanumrico correspondiente al nmero de creacin del caso. savedMessage: Reservado para uso futuro. Entities: Reservado para uso futuro. processCreationDate: Fecha de creacin del caso.

2344

Copyright 2013 - Bizagi

processSolutionDate: Fecha de solucin (cierre) del caso. processWorkflowClass: Toda la informacin en este nodo es informacin del proceso (metadata), no es informacin del caso en particular. workflowClassId: Nmero de identificacin (o llave) del proceso. workflowClassName: Nombre del proceso. workflowClassDisplayName: Nombre a mostrar del proceso. workflowClassDescription: Descripcin del proceso. workflowClassHelpText: Texto de ayuda del proceso. workflowClassHelpURL: URL de ayuda del proceso. workflowClassDisplayOrder: Orden en el cual aparecen los procesos en Bizagi Studio. workflowClassCreationDate: Fecha de creacin del proceso. workflowClassGlobalForm: Nmero de identificacin de la forma global del proceso (cero si no se encuentra configurada). workflowClassAllocationPrinciple: Reservado para uso futuro. workflowClassProcessType: Tipo de proceso. workflowClassDisplay: Indica si el proceso es visible o no. workflowClassUseParentRadicationNumber: Indica si un caso del proceso utiliza su propio nmero de creacin, o si es el mismo nmero que el del proceso padre (en caso de ser un subproceso). workflowClassSupportScopes: Indica si el proceso soporta los "scopes" de Bizagi, los cuales constituyen un mtodo eficiente de persistencia de datos. processError: Si el proceso de guardar informacin en la actividad no fue exitoso, este elemento contendr informacin del error. errorCode: Cdigo del error ocurrido. En caso de no haber error, este elemento estar vaco. errorMessage: Mensaje del error ocurrido, En caso de no haber error, este elemento estar vaco. Path: XPath del elemento que gener el error desde el XML de envo. Visible cuando el error es generado por informacin errada. Attrib: Nombre del atributo en Bizagi donde se intent almacenar la informacin que gener el error. Visible cuando el error es generado por informacin errada. Value: Es el valor que caus el error. Visible cuando el error es causado por informacin errada. ErrorMessage: Mensaje donde se describe por qu se ha presentado el error. Visible cuando el error es generado por informacin incorrecta. CurrentWorkItems: Serie de actividades disponibles para el caso. workItem: Actividad especfica del proceso (instancia de una tarea) que se encuentra activa para el caso. workItemId: Nmero de identificacin o llave de la actividad. workItemState: Estado en el cual se encuentra la actividad. workItemEntryDate: Fecha y hora en la cual el caso lleg a esta actividad por primera vez. workItemDuration: Duracin estimada de la actividad, en minutos. workItemEstimatedSolutionDate: Fecha estimada de solucin del caso. task: Contiene informacin sobre la tarea que corresponde a la actividad. taskId: Nmero de identificacin o llave de la tarea. taskName: Nombre de la tarea. taskDisplayName: Nombre a mostrar de la tarea. taskDescription: Texto descriptivo de la tarea. taskHelpText: Texto de ayuda de la tarea. taskEstimatedDuration: Duracin estimada, en minutos, de la tarea. taskType: Tipo de tarea. taskCost: Costo estimado de la tarea. Este valor, as como las fechas estimadas, es configurado y determinado por las persona que disea el proceso. taskPriority: Prioridad de terminacin de la tarea.

Copyright 2013 - Bizagi

2345

taskTransactional: Indica si la tarea es transaccional o no. taskCompensation: Informa si es una tarea de compensacin. taskTimerEventDuration: Si es un temporizador, su duracin estar en minutos. AllowsReassign: Marca que muestra si la tarea puede ser reasignada a un usuario distinto. SendNotification: Indica si se debe enviar un email al usuario asignado informndole sobre la disponibilidad de la tarea. SendAlarms: Indica si se debe enviar un email al usuario asignado informndole que la tarea est prxima a vencerse. ExtendedEstimatedDuration: Tiempo de duracin extendida estimado. Form: Reservado para uso futuro. IsAsynchTask: Especifica si se trata o no de una tarea asincrnica. Utilizado normalmente para interfaces. NumberOfRetries: Aplica para tareas asincrnicas. Nmero automtico de reintentos para la tarea en case de fallar (se arroja una excepcin). RetryInterval: Aplica para tareas asincrnicas. Tiempo (en minutos) entre cada reintento. ShowFeedback: Aplica para tareas asincrnicas. Indica si el usuario ser informado cuando se presente un error. TimeoutSeconds: Aplica para tareas asincrnicas. Tiempo (en segundos) que la tarea asincrnica esperar por una respuesta del sistema externo.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi;

2346

Copyright 2013 - Bizagi

Mtodos Web relacionados

Para obtener un listado de Actividades pendientes para un caso determindao, use los mtodos g etA ctiv itiesA sStrin g o g etA ctiv ities. Para ms informacin sobre esta opcin, consulte getActivitiesAsString. Si desea completar la Actividad pendiente (de manera similar a este mtodo pero en vez de guardar

Copyright 2013 - Bizagi

2347

temporalmente un progreso), use los mtodos p erfo rm A ctiv ity A sStrin g o p erfo rm A ctiv ity. Para ms informacin sobre esta opcin, consulte performActivityAsString. 7.1.1.15 setEventAsString

Introduccin
Este mtodo se utiliza para disparar y completar cualquier cantidad de Eventos disponibles en Bizagi (desde una aplicacin externa). Los Eventos de negocio en Bizagi se modelan a travs de los elementos BPMN en los cuales hay tipos de Eventos como los Intermedios que se encuentran disponibles desde algn momento del flujo del Proceso.

Este mtodo recibe un nico parmetro de entrada el cual contiene principalmente: el usuario quien realiza el Evento, la informacin de negocio relevante, el nombre o id del Evento y el nmero de caso. A travs de este mtodo, se completa un Evento de la misma manera como se hace desde el Portal de Trabajo. Para ms informacin acerca de esta opcin en el Portal, consulte Portal de Trabajo de Bizagi.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web setEv en t, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo setEvent, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo setEventAsString la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="BizAgiWSParam"> <xs:complexType> <xs:sequence> <xs:element name="domain" type="xs:string"/> <xs:element name="userName" type="xs:string"/> <xs:element name="Events"> <xs:complexType> <xs:sequence> <xs:element name="Event" maxOccurs="unbounded"> <xs:complexType> <xs:sequence> <xs:element name="EventData"> <xs:

2348

Copyright 2013 - Bizagi

complexType> <xs:sequence> <xs:choice> <xs:element name="idCase" type="xs:integer" minOccurs="0"/> <xs:element name="radNumber" type="xs:string" minOccurs="0"/> </xs:choice> <xs:choice> <xs:element name="idTask" type="xs:integer" minOccurs="0"/> <xs:element name="eventName" type="xs:string" minOccurs="0"/> </xs:choice> </ xs:sequence> </xs: complexType> </xs:element> <xs:element name="Entities"> <xs: complexType/> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de entrada
BizAgiWSParam: Nodo raz. domain: Nombre del dominio del usuario Bizagi que ser registrado como aquel que avanz el Evento. userName: Nombre del usuario registrado como aquel que avanz el Evento. Events: Contiene informacin de todos los Eventos. Event: Contiene informacin de un Evento en particular. EventData: Contiene la informacin necesaria para localizar el Evento. idCase: Es el nmero de identificacin del caso para el Evento que se desea avanzar. Es necesario que se incluya este elemento, o en su defecto el radNumber.

Copyright 2013 - Bizagi

2349

radNumber: alternativa al idCase. es el nmero de creacin (nmero de caso) del caso que contiene el Evento pendiente que se desea avanzar. Cuando se usa el mismo nmero de creacin para varios casos (como cuando un subproceso utiliza el nmero del caso padre) el idCase debe ser utilizado para distinguir a cual caso pertenece el evento. taskId: Nmero de identificacin del Event que se desea avanzar. Este elemento es necesario; Si no se conoce este nmero, se debe incluir el eventName. eventName: Empleado como alternativa al identificador de la tarea (taskId), es el nmero del evento pendiente que se va a avanzar. Entities: Es el nodo que contiene la informacin de negocio que se va a guardar en el caso. Para ms informacin sobre la estructura esperada de los elementos dentro de Entities, consulte cmo se representan el modelo de datos del Proceso en Esquema XML de Bizagi para el modelo de datos .

Ejemplo
Con el siguiente ejemplo, se completan Eventos para dos casos diferentes. En este ejemplo, podemos ver que el usuario domain\Raulp es quien dispara los Eventos. El primer Evento se referencia por su nombre (Event2), y el segundo Evento se referencia por el id del elemento (idTask=145).

Ntese que la informacin de negocio est contenida dentro del elemento Entities, dado que esta informacin es opcional.

2350

Copyright 2013 - Bizagi

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns: xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="processes"> <xs:complexType> <xs:sequence> <xs:element name="process"> <xs:complexType> <xs:sequence> <xs:element name="processId" type="xs:integer"/> <xs:element name="processRadNumber" type="xs:string"/> <xs:element name="savedMessage"> <xs:complexType> <xs:sequence> <xs:element name="Entities" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="processCreationDate" type="xs:dateTime"/> <xs:element name="processSolutionDate" type="xs:dateTime"/> <xs:element name="processWorkflowClass"> <xs:complexType> <xs:sequence> <xs:element name="workflowClassId" type="xs:integer"/> <xs:element name="workflowClassName" type="xs:string"/> <xs:element name="workflowClassDisplayName" type="xs:string"/> <xs:element name="workflowClassDescription" type="xs:string"/> <xs:element name="workflowClassHelpText" type="xs:string"/> <xs:element name="workflowClassHelpURL" type="xs:string"/> <xs:element name="workflowClassDisplayOrder" type="xs:integer"/> <xs:element name="workflowClassCreationDate" type="xs:dateTime"/> <xs:element

Copyright 2013 - Bizagi

2351

name="workflowClassGlobalForm" type="xs:integer"/> <xs:element name="workflowClassAllocationPrinciple" type="xs:string"/> <xs:element name="workflowClassProcessType" type="xs:string"/> <xs:element name="workflowClassDisplay" type="xs:boolean"/> <xs:element name="workflowClassUseParentRadicationNumber" type="xs:boolean"/> <xs:element name="workflowClassSupportsScopes" type="xs:boolean"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="processError"> <xs:complexType> <xs:sequence> <xs:element name="errorCode"/> <xs:element name="errorMessage"> <xs: complexType mixed="true"> <xs:sequence minOccurs="0"> <xs:element name="Entities"> <xs:complexType> <xs:sequence> <xs:element name="Path" type="xs:string"/> <xs:element name="Atrib" type="xs:string"/> <xs:element name="Value" type="xs:string"/> <xs:element name="ErrorMessage" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> </ xs:sequence> </xs: complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element>

2352

Copyright 2013 - Bizagi

<xs:element name="CurrentWorkItems"> <xs:complexType> <xs:sequence> <xs:element name="workItem"> <xs: complexType> <xs:sequence> <xs:element name="workItemId" type="xs:integer"/> <xs:element name="workItemState" type="xs:string"/> <xs:element name="workItemEntryDate" type="xs:dateTime"/> <xs:element name="workItemDuration" type="xs:integer"/> <xs:element name="workItemSubprocesses"/> <xs:element name="workItemEstimatedSolutionDate" type="xs:dateTime"/> <xs:element name="workItemSolutionDate" type="xs:dateTime"/> <xs:element name="task"> <xs:complexType> <xs:sequence> <xs:element name="taskId" type="xs:integer"/> <xs:element name="taskName" type="xs:string"/> <xs:element name="taskDisplayName" type="xs: string"/> <xs:element name="taskDescription" type="xs: string"/> <xs:element name="taskHelpText" type="xs:string"/> <xs:element name="taskEstimatedDuration" type="xs: integer"/> <xs:element name="taskType" type="xs:string"/> <xs:element name="taskCost" type="xs:integer"/> <xs:element name="taskPriority" type="xs:string"/> <xs:element name="taskTransactional" type="xs:

Copyright 2013 - Bizagi

2353

boolean"/> <xs:element name="taskCompensation" type="xs: boolean"/> <xs:element name="taskTimerEventDuration" type="xs: integer"/> <xs:element name="AllowsReassign" type="xs: boolean"/> <xs:element name="SendNotification" type="xs: boolean"/> <xs:element name="SendAlarms" type="xs:boolean"/> <xs:element name="ExtendedEstimatedDuration" type="xs:integer"/> <xs:element name="Form" type="xs:integer"/> <xs:element name="IsAsynchTask" type="xs:boolean"/> <xs:element name="NumberOfRetries" type="xs: integer"/> <xs:element name="RetryInterval" type="xs:integer"/ > <xs:element name="ShowFeedback" type="xs:boolean"/> <xs:element name="TimeoutSeconds" type="xs: integer"/> </xs:sequence> </xs:complexType> </xs:element> </ xs:sequence> </xs: complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element>

2354

Copyright 2013 - Bizagi

</xs:schema>

Parmetros de salida
processes: Nodo raz, contiene informacin sobre los procesos a los cuales pertenecen los eventos. process: Este elemento incluye informacin del proceso. processId: Nmero de identificacin del caso (idCase). processRadNumber: Valor alfanumrico correspondiente al nmero de creacin del caso. savedMessage: Reservado para uso futuro. Entities: Reservado para uso futuro. processWorkflowClass: Toda la informacin en este nodo es informacin del proceso (metadata), no es informacin del caso en particular. workflowClassId: Nmero de identificacin (o llave) del proceso. workflowClassName: Nombre del proceso. workflowClassDisplayName: Nombre a mostrar del proceso. workflowClassDescription: Descripcin del proceso. workflowClassHelpText: Texto de ayuda del proceso. workflowClassHelpURL: URL de ayuda del proceso. workflowClassDisplayOrder: Orden en el cual aparecen los procesos en Bizagi Studio. workflowClassCreationDate: Fecha de creacin del proceso. workflowClassGlobalForm: Nmero de identificacin de la forma global del proceso (cero si no se encuentra configurada). workflowClassAllocationPrinciple: Reservado para uso futuro. workflowClassProcessType: Tipo de proceso. workflowClassDisplay: Indica si el proceso es visible o no. workflowClassUseParentRadicationNumber: Indica si un caso del proceso utiliza su propio nmero de creacin, o si es el mismo nmero que el del proceso padre (en caso de ser un subproceso). processError: Si el proceso de guardar informacin en la actividad no fue exitoso, este elemento contendr informacin del error. errorCode: Cdigo del error ocurrido. En caso de no haber error, este elemento estar vaco. errorMessage: Mensaje del error ocurrido, En caso de no haber error, este elemento estar vaco. Path: XPath del elemento que gener el error desde el XML de envo. Visible cuando el error es generado por informacin errada. Attrib: Nombre del atributo en Bizagi donde se intent almacenar la informacin que gener el error. Visible cuando el error es generado por informacin errada. Value: Es el valor que caus el error. Visible cuando el error es causado por informacin errada. ErrorMessage: Mensaje donde se describe por qu se ha presentado el error. Visible cuando el error es generado por informacin incorrecta. CurrentWorkItems: Serie de actividades disponibles para el caso. workItem: Actividad especfica del proceso (instancia de una tarea) que se encuentra activa para el caso. workItemId: Nmero de identificacin o llave de la actividad. workItemState: Estado en el cual se encuentra la actividad. workItemEntryDate: Fecha y hora en la cual el caso lleg a esta actividad por primera vez. workItemDuration: Duracin estimada de la actividad, en minutos. workItemEstimatedSolutionDate: Fecha estimada de solucin del caso. Task: Contiene informacin sobre la tarea que corresponde a la actividad. taskId: Nmero de identificacin o llave de la tarea. taskName: Nombre de la tarea.

Copyright 2013 - Bizagi

2355

taskDisplayName: Nombre a mostrar de la tarea. taskDescription: Texto descriptivo de la tarea. taskHelpText: Texto de ayuda de la tarea. taskEstimatedDuration: Duracin estimada, en minutos, de la tarea. taskType: Tipo de tarea. taskCost: Costo estimado de la tarea. Este valor, as como las fechas estimadas, es configurado y determinado por las persona que disea el proceso. taskPriority: Prioridad de terminacin de la tarea. taskTransactional: Indica si la tarea es transaccional o no. taskCompensation: Informa si es una tarea de compensacin. taskTimerEventDuration: Si es un temporizador, su duracin estar en minutos. AllowsReassign: Marca que muestra si la tarea puede ser reasignada a un usuario distinto. SendNotification: Indica si se debe enviar un email al usuario asignado informndole sobre la disponibilidad de la tarea. SendAlarms: Indica si se debe enviar un email al usuario asignado informndole que la tarea est prxima a vencerse. ExtendedEstimatedDuration: Tiempo de duracin extendida estimado. Form: Reservado para uso futuro. IsAsynchTask: Especifica si se trata o no de una tarea asincrnica. Utilizado normalmente para interfaces. NumberOfRetries: Aplica para tareas asincrnicas. Nmero automtico de reintentos para la tarea en case de fallar (se arroja una excepcin). RetryInterval: Aplica para tareas asincrnicas. Tiempo (en minutos) entre cada reintento. ShowFeedback: Aplica para tareas asincrnicas. Indica si el usuario ser informado cuando se presente un error. TimeoutSeconds: Aplica para tareas asincrnicas. Tiempo (en segundos) que la tarea asincrnica esperar por una respuesta del sistema externo.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi;

2356

Copyright 2013 - Bizagi

Copyright 2013 - Bizagi

2357

Mtodos Web relacionados

Si desea ejecutar una Actividad pendiente en cambio de un Evento, use los mtodos p erfo rm A ctiv ity A sStrin g o p erfo rm A ctiv ity . Para ms informacin sobre esta opcin, consulte performActivityAsString. Para obtener un listado de los Eventos disponibles para un caso determinado, use los mtodos g etEv en tsA sStrin g o g etEv en ts. Para ms informacin sobre esta opcin, consulte getEventsString.

7.1.2

Mtodos Web de EntityManagerSOA

Los mtodos Web publicados en En tity M an ag erSO A son tiles para acceder al modelo de datos de los Procesos (por ejemplo para: obtener o actualizar informacin de negocio, obtener insertar o actualizar listas de valores en Entidades de Bizagi, entre otros). Este servicio Web y sus mtodos se acceden en la siguiente URL: Para Bizagi Enterprise .NET y Bizagi Xpress: http://[nombre_servidor]/[proyecto_Bizagi]/WebServices/ EntityManagerSOA.asmx?wsdl

2358

Copyright 2013 - Bizagi

Para Bizagi Enterprise JEE: En Servidores de Aplicaciones Weblogic y JBoss: http://[nombre_servidor]:[puerto]/Bizagi-war/WebServices/EntityManagerSOA? wsdl En WebSphere: http://[nombre_servidor]:[puerto]/Bizagi-war/EntityManagerSOAImplService/ EntityManagerSOAImplService.wsdl

Para informacin puntual sobre cada mtodo, consulte los sub artculos. 7.1.2.1 getCaseDataUsingSchemaAsString

Introduccin
Este mtodo se utiliza para obtener tanto informacin de negocio, como detalle general (por ejemplo,

Copyright 2013 - Bizagi

2359

fecha de creacin, fecha estimada de solucin, etc) para un caso en Bizagi (desde una aplicacin externa). Este mtodo recibe 3 parmetros de entrada, de los cuales 2 de ellos son estrictamente requeridos: el identificador del caso, y un XSD (esquema de XML) para especificar qu informacin de negocio se quiere obtener. El parmetro opcional es especificar el work-item (instancia de Actividad para un caso) para indicar si Bizagi debe obtener la informacin de una Actividad en particular (que no est persistida necesariamente en la Base de datos pero que est en el scope).

Nota: La descripcin en este artculo aplica tambin para el mtodo Web g etCaseDataUsin g Sch em a, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo getCaseDataUsingSchema, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo getCaseDataUsingSchemaAsString la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string) Nota: La siguiente definicin aplica tambin para los mtodos g etCaseDataUsin g Sch em aLiteA sStrin g o g etCaseDataUsin g Sch em aLite. La nica diferencia con respecto a estos mtodos, se basa en cmo Bizagi retorna la informacin de los adjuntos. Con g etCaseDataUsin g Sch em aA sStrin g, Bizagi retorna los adjuntos de Bizagi como cadenas (string) en base 64 (si se incluyen estos atributos en el esquema). Con g etCaseDataUsin g Sch em aLiteA sStrin g, Bizagi obteniene nicamente los nombres de los archivos.

Datos de entrada
Esquema y Parmetros de entrada
idCase: Corresponde al nmero de identificacin interno (id en la base de datos) del caso en Bizagi. idWorkitem: (Opcional). Corresponde al identificador de la instancia de una tarea. Con dicho parmetro se puede obtener los datos de un caso que estn almacenados en una actividad, sin que necesariamente esa actividad haya avanzado y persistido los datos. xsd: Esquema con la informacin que ser extrada. Una forma sencilla de crear este esquema es usar la opcin Xml Schemas para la entidad con la jerarqua mas alta en el modelo (e.g. la entidad de aplicacin). Para ms informacin sobre la estructura esperada de los elementos dentro de Entities, consulte cmo se representan el modelo de datos del Proceso en Esquema XML de Bizagi para el modelo de datos .

Ejemplo
Con el siguiente ejemplo, se obtienen el nmero de dias solicitados para vacaciones (Number of Office Days requested), en un Proceso de solicitud de Vacaciones (Vacation Request). La siguiente informacin considera el caso con identificador=752: idCase = 752.

2360

Copyright 2013 - Bizagi

sxsd: <?xml version="1.0" encoding="utf-8"?><xs:schema attributeFormDefault="qualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"><xs:element name="VacationRequest"><xs:complexType><xs:sequence><xs:element minOccurs="0" maxOccurs="1" name="Numberofofficedaysrequeste" type="xs:integer" /></xs:sequence></xs: complexType></xs:element></xs:schema> Ntese que el esquema que hemos especificado, inicia desde el atributo de la Entidad de Aplicacin que referencia a la Entidad de Proceso (en nuestro ejemplo, se llama VacationRequest). Para esta definicin, el esquema corresponde a como se consulta para la Entidad de Aplicacin en Bizagi Studio:

Datos de salida
Esquema y Parmetros de salida
La informacin retornada en formato XML contiene el nodo raz BizAgiWSResponse, y sus elementos internos corresponden a lo definido en el esquema (del dato de entrada).

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi;

Mtodos Web relacionados

Es probable que desee utilizar previamente el metodo g etCasesA sStrin g de los servicios Web de WorkflowEngineSOA, de manera se obtenga de antemano la lista de casos segn algn criterio. Para ms informacin sobre esta opcin, consulte getCasesAsString. Si desea utilizar definiciones de Xpath en vez de un XSD como filtro de la informacin a obtener, use los mtodos g etCaseDataUsin g XP ath sA sStrin g o g etCaseDataUsin g XP ath s. Para ms informacin sobre esta opcin, consulte getCaseDataUsingXPathsAsString. 7.1.2.2 getCaseDataUsingXPathsAsString

Introduccin
Este mtodo se utiliza para obtener tanto informacin de negocio, como detalle general (por ejemplo, fecha de creacin, fecha estimada de solucin, etc) para un caso en Bizagi (desde una aplicacin externa). Este mtodo recibe un nico parmetro de entrada el cual contiene principalmente: el identificador del caso, filtros a forma de XPath para especificar qu informacin de negocio se quiere obtener.

Copyright 2013 - Bizagi

2361

Nota: La descripcin en este artculo aplica tambin para el mtodo Web g etCaseDataUsin g XP ath , el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo g etCaseDataUsin g XP ath , el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo g etCaseDataUsin g XP ath A sStrin g la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD: <?xml version="1.0" encoding="UTF-8"?> <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="BizAgiWSParam"> <xs:complexType> <xs:sequence> <xs:element name="CaseInfo" minOccurs="1" maxOccurs="1"> <xs:complexType> <xs:sequence> <xs:element name="IdCase" minOccurs="0" maxOccurs="1" type="xs:integer" /> <xs:element name="CaseNumber" minOccurs="0" maxOccurs="1" type="xs:integer" /> <xs:element name="TaskName" minOccurs="0" maxOccurs="1" type="xs:string" /> <xs:element name="IdTask" minOccurs="0" maxOccurs="1" type="xs:integer" /> <xs:element name="IdWorkItem" minOccurs="0" maxOccurs="1" type="xs:integer" /> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="XPaths" minOccurs="1" maxOccurs="1"> <xs:complexType> <xs:sequence> <xs:element name="XPath" minOccurs="1" maxOccurs="unbounded"> <xs:complexType> <xs:attribute name="XPath" type="xs:string" /> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element>

2362

Copyright 2013 - Bizagi

</xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de entrada
IdCase: Nmero de identificacin Interna (id en la base de datos) del caso en Bizagi. CaseNumber: Nmero de caso o nmero de creacin del caso. Si se utiliza el IdCase, este no ser necesario. TaskName: Este elemento debe ser utilizado en conjunto con el IdCase o el nmero del caso (CaseNumber). Cuando se incluye en la consulta, la infomacin retornada ser la informacin guardada en una tarea en curso (nicamente para actividades manuales o eventos intermedios disponibles), der lo contrario, se retorna nicamente la informacin existente en la base de datos. IdTask: Es posible utilizar el nmero de identificacin interno de la Actividad (en la base de datos) en lugar del nombre de la Tarea. IdWorkItem: Otra forma de obtener la informacin de una tarea especfica en el caso es enviando el nmero de identificacin del workitem (la tabla WORKITEM almacena la informacin sobre las tareas en curso y ejecutadas para cada caso). Si se enva este elemento, entonces es necesario llenar el nombre de la tarea o el id, y no el id del caso (idCase) o el nmero de creacin. Es importante que el id que se enva sea el de un workitem que se encuentre abierto, no el de uno que ya haya sido ejecutado. XPaths: Contiene 1 o ms nodos de tipo Xpath, que se usa para filtrar la informacin. XPath: Incluya este elemento para cada XPath en la consulta. Este elemento tiene a su vez un atributo llamado XPath. El valor de este atributo ser el XPath de Bizagi solicitado. Por lo tanto, en este nodo, las posibilidades son: - Llenar nicamente el IdCase (la respuesta incluira solamente informacin de las tareas terminadas). - Llenar el nmero del caso, en ingls CaseNumber (la respuesta incluira solamente informacin de las tareas terminadas). - Llenar el IdCase o el nmero del caso junto con el Nombre de la tarea (TaskName) o el IdTask. (La respuesta incluira informacin de las tareas activas). - Llenar nicamente el IdWorkItem (La respuesta incluira informacin de las tareas activas). XPath: Incluya este elemento para cada XPath en la consulta. Este elemento tiene a su vez un atributo llamado XPath. El valor de este atributo ser el XPath de Bizagi solicitado.

Ejemplo
Con el siguiente ejemplo, se quieren obtener datos de un caso del Proceso de Solicitud de crdito (Credit Request) con el siguiente modelo de datos:

Copyright 2013 - Bizagi

2363

Con este ejemplo, obtendremos la informacin de negocio de un caso con identificador=8451. Este caso tiene una Actividad pendiente cuyo id es 180. La informacin que deseamos obtener es: BuroScore, BuroFile, DocumentNumber y DocsDelivieryDate de la Entidad Applicant (para todos los solicitantes --instancias de applicant-- de la solicitud). Adicionalmente, queremos obtener el valor de DocumentNumber de aplicantes con BuroScore menor que 100.

2364

Copyright 2013 - Bizagi

En la imagen anterior, se aprecia que el filtro usa (BuroScore &lt; 100). Para este tipo de filtros, donde se use el caracter <, es necesario utilizar su notacin para XML (dado que este es un caracter especial de la notacin de XML); y por lo tanto se define como &lt;. En la siguiente table podemos ver los formatos XML equivalentes para usar cuando hayan caracteres especiales. Caracter < > " ' & Descripcin Operador menor-que Operador mayor-que Comilla doble Apstrofe, o comilla simple Ampersand Formato XML &lt; &gt; &quot; &apos; &amp;

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="UTF-8"?> <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="BizAgiWSResponse">

Copyright 2013 - Bizagi

2365

<xs:complexType> <xs:sequence> <xs:choice maxOccurs="unbounded"> <xs:element name="XPath"> <xs:complexType mixed="true"> <xs:sequence minOccurs="0"> <xs:element name="Items"> <xs:complexType> <xs:sequence> <xs: element maxOccurs="unbounded" name="Item"> <xs:complexType> <xs:simpleContent> <xs:extension base="xs:string"> <xs:attribute name="Id" type="xs:integer" use="optional" /> <xs:attribute name="FileName" type="xs:string" use="optional" /> </xs:extension> </xs:simpleContent> </ xs:complexType> </xs: element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> <xs:attribute name="XPath" type="xs:string" use="required" /> </xs:complexType> </xs:element> <xs:element name="Error"> <xs:complexType> <xs:sequence> <xs:element name="ErrorCode" type="xs:integer" /> <xs:element name="ErrorMessage" type="xs:string" /> </xs:sequence> <xs:attribute name="XPath" type="xs:string" use="required" /> </xs:complexType> </xs:element> </xs:choice> </xs:sequence>

2366

Copyright 2013 - Bizagi

</xs:complexType> </xs:element> </xs:schema>

Parmetros de salida

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi, en donde vemos una invocacin exitosa, y un error:

Mtodos Web relacionados

Es probable que desee utilizar previamente el metodo g etCasesA sStrin g de los servicios Web de WorkflowEngineSOA, de manera se obtenga de antemano la lista de casos segn algn criterio. Para ms informacin sobre esta opcin, consulte getCasesAsString. Si desea utilizar un XSD (esquema de XML) en vez de Xpaths como filtro de la informacin a obtener, use los mtodos g etCaseDataUsin g Sch em aA sStrin g o g etCaseDataUsin g Sch em a. Para ms informacin sobre esta opcin, consulte getCaseDataUsingSchemaAsString. 7.1.2.3 getEntitiesAsString

Introduccin
Este mtodo se utiliza para consultar los registros en una Entidad del modelo de datos de Bizagi

Copyright 2013 - Bizagi

2367

(desde una aplicacin externa). Este mtodo es especialmente til para Entidades de Parametrizacin, dado que los registros en estas Entidades no son modificados a lo largo de instancias de Procesos. Este mtodo recibe un nico parmetro de entrada el cual contiene principalmente: la Entidad a consultar, y posibles filtros para la bsqueda. Ntese que este mtodo retorna la informacin de los registros en la Entidad pero tambin la informacin relacionada a travs de sus atributos para un nivel de profundidad. Si desea especificar que se utilice una mayor profundidad (para navegar la informacin a ms de una relacin de distancia), use los mtodos g etEn titiesUsin g Sch em aA sStrin g o g etEn titiesUsin g Sch em a. Para ms informacin sobre ste y otros mtodos relacionados, consulte la seccin al final de este artculo.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web g etEn tities, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo getEntities, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo getEntitiesAsString la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="BizAgiWSParam"> <xs:complexType> <xs:sequence> <xs:element name="EntityData"> <xs:complexType> <xs:sequence> <xs:choice> <xs:element name="EntityName" type="xs:string"/> <xs:element name="EntityID" type="xs:integer"/> </xs:choice> <xs:element name="FilterDisabled" type="xs:boolean" minOccurs="0" /> <xs:element name="Filters" type="xs:string" nillable="true" minOccurs="0"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence>

2368

Copyright 2013 - Bizagi

</xs:complexType> </xs:element> </xs:schema> Para ms informacin sobre la estructura esperada de los elementos dentro de Entities, consulte cmo se representan el modelo de datos del Proceso en Esquema XML de Bizagi para el modelo de datos .

Parmetros de entrada
BizAgiWSParam: Es el nodo raz. EntityData: Contiene el nombre de la Entidad, o su Id (una de las 2 opciones). EntityName: Es el nombre (no el nombre a mostrar o display name) de la entidad deseada. Si se incluye este elemento no se debe incluir el que se explica a continuacin (EntityID). EntityID: Se usa en lugar del mtodo EntityName explicado previamente, se debe incluir nicamente uno de los dos en el XML. Corresponde a la llave o id (en la base de datos para la tabla ENTITY) de la entidad que se va a consultar. Es ms sencillo utilizar este elemento junto con otros mtodos SOA, como por ejemplo aquellos del servicio web RenderSOA, los cuales se usan para replicar formas Bizagi en la interfaz de usuario de un sistema externo, este mtodo retorna los ids de las entidades relacionadas a la metadata de las formas. FilterDisabled: Se usa para decidir si la consulta debe incluir registros de Entidades de Parametrizacin que estn deshabilitados (con borrado lgico). Para incluirlos, utilice el valor falso ( false) para este nodo. Filters: Establece el filtro para la entidad consultada. El formato del filtro funciona como la sentencia WHERE de una consulta bsica de SQL. Se recomienda que se utilice el elemento CDATA para incluir los filtros (y de esta manera poder utilizar los caracteres especiales en notacin XML, como por ejemplo el operador menor-que). La siguiente tabla presenta los operadores vlidos en filtros, para usar en CDATA: Caracter = < > <> != <= >= Descripcin Equal to Less than Greater than Different from Different from Less than or equal to Greater than or equal to

Ejemplo
Con el siguiente ejemplo, se obtiene la informacin de solicitantes (instancias de Applicant), con BuroScore menor que 100. <?xml version="1.0" encoding="utf-8"?> <BizAgiWSParam>

Copyright 2013 - Bizagi

2369

<EntityData> <EntityName>Applicant</EntityName> <Filters> <![CDATA[BuroScore < 100]]> </Filters> </EntityData> </BizAgiWSParam> Otros ejemplos de filtros vlidos son: Con una comparacin directa: <![CDATA[ Option = 'Automatic' ]]> Usando la clasula conyuntiva A N D: <![CDATA[ (DocumentType = 1 OR City = 2) AND Approved = true ]]> Comparando informacin de fechas (con el formato del proyecto): <![CDATA[ date1 >= '06/05/2008' ]]>

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="BizAgiWSResponse"> <xs:complexType> <xs:sequence> <xs:element name="Entities" maxOccurs="1"> <xs:complexType /> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema> Dentro del elemento Entities se incluyen los elementos del modelo de datos de Bizagi con sus valores (atributos, relaciones, Entidades). Para ms informacin sobre esta estructura, consulte cmo se representan el modelo de datos del Proceso en Esquema XML de Bizagi para el modelo de datos.

Parmetros de salida
BizAgiWSResponse: Es el nodo raz. Entities: Dentro de este elemento, se obtiene la informacin del modelo de datos del Proceso. Ntese que este mtodo retorna un set de registros, por lo que se obtiene una nica ocurrencia de este elemento pero posiblemente muchas ocurrencias de sus elementos internos.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi;

2370

Copyright 2013 - Bizagi

Ntese que los atributos que contienen valores nulos ( N ULL) no los retorna Bizagi.

Mtodos Web relacionados

Si desea obtener informacin a partir de una Entidad (como punto de partida) pero con un mayor nivel de profundidad (navegando los atributos), use los mtodos g etEn titiesUsin g Sch em aA sStrin g o g etEn titiesUsin g Sch em a. Adicionalmente, con estos otros mtodos, los campos en NULL son retornados si se especifican explcitamente dentro del esquema. Para ms informacin sobre esta opcin, consulte getEntitiesUsingSchemaAsString. 7.1.2.4 getEntitiesUsingSchemaAsString

Introduccin
Este mtodo se utiliza para consultar los registros en una Entidad del modelo de datos de Bizagi (desde una aplicacin externa). Este mtodo recibe dos parmetros de entrada: un XSD (esquema de XML) con el nombre de la Entidad a consultar e informacin de filtro, y otro con un XSD para indicar qu informacin de negocio se va a obtener. Si no desea utilizar un XSD, y no es necesario una profundidad de datos (navegando la informacin a

Copyright 2013 - Bizagi

2371

travs de atributos), use los mtodos g etEn titiesA sStrin g o g etEn tities. Para ms informacin sobre ste y otros mtodos relacionados, consulte la seccin al final de este artculo.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web g etEn titiesUsin g Sch em a, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo g etEn titiesUsin g Sch em a, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo g etEn titiesUsin g Sch em aA sStrin g la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi como primer parmetro, debe ser cumplir con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="BizAgiWSParam"> <xs:complexType> <xs:sequence> <xs:element name="EntityData"> <xs:complexType> <xs:sequence> <xs:choice> <xs:element name="EntityName" type="xs:string"/> <xs:element name="EntityID" type="xs:integer"/> </xs:choice> <xs:element name="FilterDisabled" type="xs:boolean" minOccurs="0" /> <xs:element name="Filters" type="xs:string" nillable="true" minOccurs="0"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema> Para el segundo parmetro, la estructura del esquema debe corresponder al modelo de datos de Bizagi. Para ms informacin sobre los elementos de este esquema, consulte cmo se representan el modelo de datos del Proceso en Esquema XML de Bizagi para el modelo de datos.

Parmetros de entrada

2372

Copyright 2013 - Bizagi

Para el primer parmetro llamado entitiesInfo, es necesario considerar: BizAgiWSParam: Es el nodo raz. EntityData: Contiene el nombre de la Entidad, o su Id (una de las 2 opciones). EntityName: Es el nombre (no el nombre a mostrar o display name) de la entidad deseada. Si se incluye este elemento no se debe incluir el que se explica a continuacin (EntityID). EntityID: Se usa en lugar del mtodo EntityName explicado previamente, se debe incluir nicamente uno de los dos en el XML. Corresponde a la llave o id (en la base de datos para la tabla ENTITY) de la entidad que se va a consultar. Es ms sencillo utilizar este elemento junto con otros mtodos SOA, como por ejemplo aquellos del servicio web RenderSOA, los cuales se usan para replicar formas Bizagi en la interfaz de usuario de un sistema externo, este mtodo retorna los ids de las entidades relacionadas a la metadata de las formas. FilterDisabled: Se usa para decidir si la consulta debe incluir registros de Entidades de Parametrizacin que estn deshabilitados (con borrado lgico). Para incluirlos, utilice el valor falso ( false) para este nodo. Filters: Establece el filtro para la entidad consultada. El formato del filtro funciona como la sentencia WHERE de una consulta bsica de SQL. Se recomienda que se utilice el elemento CDATA para incluir los filtros (y de esta manera poder utilizar los caracteres especiales en notacin XML, como por ejemplo el operador menor-que). La siguiente tabla presenta los operadores vlidos en filtros, para usar en CDATA: Caracter = < > <> != <= >= Descripcin Equal to Less than Greater than Different from Different from Less than or equal to Greater than or equal to

Ejemplo
Con el siguiente ejemplo, se obtienen los solicitantes (registros de Applicant) que tengan un BuroScore menor que 100. En el primer parmetro se envia: <?xml version="1.0" encoding="utf-8"?> <BizAgiWSParam> <EntityData> <EntityName>Applicant</EntityName> <Filters> <![CDATA[BuroScore < 100]]> </Filters> </EntityData> </BizAgiWSParam>

Copyright 2013 - Bizagi

2373

En el segundo parmetro se envia:

Otros ejemplos de filtros vlidos en el primer parmetro son: Con una comparacin directa: <![CDATA[ Option = 'Automatic' ]]> Usando la clasula conyuntiva A N D: <![CDATA[ (DocumentType = 1 OR City = 2) AND Approved = true ]]> Comparando informacin de fechas (con el formato del proyecto): <![CDATA[ date1 >= '06/05/2008' ]]>

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0" encoding="utf-8"?> <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="BizAgiWSResponse"> <xs:complexType> <xs:sequence> <xs:element name="Entities" maxOccurs="1"> <xs:complexType /> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema> Dentro del elemento Entities se incluyen los elementos del modelo de datos de Bizagi con sus valores (atributos, relaciones, Entidades). Para ms informacin sobre esta estructura, consulte cmo se representan el modelo de datos del Proceso en Esquema XML de Bizagi para el modelo de datos.

Parmetros de salida
BizAgiWSResponse: Es el nodo raz. Entities: Dentro de este elemento, se obtiene la informacin del modelo de datos del Proceso.

2374

Copyright 2013 - Bizagi

Ntese que este mtodo retorna un set de registros, por lo que se obtiene una nica ocurrencia de este elemento pero posiblemente muchas ocurrencias de sus elementos internos.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi, en donde;

Ntese que a diferencia del mtodo getEntitiesAsString, los atributos que contienen valores nulos ( N ULL) si los retorna Bizagi en esta invocacin. La razn es que se retorna siempre y cuando estn incluidos en el esquema.

Mtodos Web relacionados

Si desea obtener informacin de una Entidad, los valores de sus atributos e inmediatas relaciones, use los mtodos g etEn titiesA sStrin g o g etEn tities. Con estos mtodos no hay necesidad de utilizar un esquema, y adicionalmente la informacin que est en NULL no se retorna. Para ms informacin sobre esta opcin, consulte getEntitiesAsString. Es posible que tambin se desee obtener el esquema de una Entidad previamente, para utilizarlo en este mtodo. Si este es el escenario y el esquema se enva dinmicamente, utilice los mtodos g etEn tity Sch em aStr o g etEn tity Sch em a. Para ms informacin sobre esta opcin, consulte getEntitySchemaStr. 7.1.2.5 getEntitySchemaStr

Introduccin
Este mtodo se utiliza para obtener un XSD (esquema de XML) que define una Entidad en Bizagi (desde una aplicacin externa). Este mtodo recibe un nico parmetro de entrada que es de tipo cadena (string). En este se especifica el nombre de la Entidad de la cul se obtiene la definicin del esquema. Este mtodo es til para posteriormente invocar otros mtodos como

Copyright 2013 - Bizagi

2375

g etCaseDataUsin g Sch em aA sStrin g o g etEn titiesUsin g Sch em aA sStrin g , donde se envia un esquema como dato de entrada. Para ms informacin sobre estos mtodos, consulte la seccin al final de este artculo.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web g etEn tity Sch em a, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo g etEn tity Sch em a, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo g etEn tity Sch em aStr la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Los datos de entrada se envan de tipo cadena (string).

Esquema y Parmetros de entrada

entityName: Contiene el nombre de la Entidad de la cual vamos a obtener el XSD (esquema de XML) .

Ejemplo
Con el siguiente ejemplo, se envia: entityName: Hotel

Datos de salida
Esquema y Parmetros de salida
La estructura del XML que retorna Bizagi corresponde a la estructura esperada de los elementos dentro de Entities, consulte cmo se representan el modelo de datos del Proceso en Esquema XML de Bizagi para el modelo de datos.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi, en donde vemos la definicin de esquema para la Entidad Hotel:

2376

Copyright 2013 - Bizagi

Mtodos Web relacionados

Una vez que se obtenga la definicin del esquema de una Entidad del modelo de datos, puede optar por utilizar otros mtodos para obtener la informacin de esa Entidad de acuerdo al esquema. Para ello, use el esquema como filtro. Para ms informacin sobre consultar informacin de negocio para un caso, consulte getCaseDataUsingSchemaAsString. Para ms informacin sobre consultar los registros de una Entidad, consulte getEntitiesUsingSchemaAsString. 7.1.2.6 saveEntityAsString

Introduccin
Este mtodo se utiliza para actualizar la informacin de negocio en una Entidad del modelo de datos de Bizagi (desde una aplicacin externa). Por actualizar informacin, entindase: insertar nuevos registros, modificar algunos existentes, o

Copyright 2013 - Bizagi

2377

marcarlos como deshabilitados (borrado lgico).

Este mtodo es especialmente til para manejar registros de Entidades de Parametrizacin, dado que sus valores no son modificados a lo largo de las instancias de Procesos. Este mtodo recibe un nico parmetro de entrada el cual contiene los valores a insertar, modificar o deshabilitar.

Par las Entidades de Parametrizacin, la invocacin a este mtodo actualiza los registros de la misma manera como se puede realizar a travs de las opciones de administracin del Portal de Trabajo. Tenga en cuenta que en la administracin de Entidades del Portal, se requiere que la Entidad haya sido definida como administrable en ese ambiente especfico (por ejemplo, produccin. Para ms informacin sobre esta opcin, consulte la Administracin de Entidades.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web sav eEn tity, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo sav eEn tity, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo sav eEn tity A sStrin g la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD: <?xml version="1.0"?> <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="BizAgiWSParam"> <xs:complexType> <xs:sequence> <xs:element name="Entities" maxOccurs="1"> <xs:complexType/> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

Parmetros de entrada
BizAgiWSParam: Es el nodo raz del XML. Entities: Dependiendo de lo que se pretenda hacer, puede contener las entidades que se van a actualizar en el caso de entidades paramtricas; o puede contener la jerarqua del modelo entidad relacin, comenzando por la entidad del procesos requerido, para actualizar la informacin del caso. El resto del XML se basa en la estructura del modelo entidad relacin. A continuacin se presentan dos ejemplos, en el primero de ellos se actualiza informacin en entidades paramtricas y

2378

Copyright 2013 - Bizagi

en el segundo se muestra como actualizar informacin en el caso. Se puede ver fcilmente la diferencia entre una actualizacin y una insercin ya que la actualizacin requiere una especificacin explcita de la llave primaria (oo llaves primarias) de los registros que se van a actualizar, e.g. key="valor" (o businessKey="Attributo=valor"); las inserciones no requieren esta especificacin. Para ms informacin sobre la estructura esperada de los elementos dentro de Entities, consulte cmo se representan el modelo de datos del Proceso en Esquema XML de Bizagi para el modelo de datos .

Ejemplo # 1
Con el siguiente ejemplo, se realizan 3 operaciones diferentes a la Entidad de Parametrizacin llamada Ciudad ( City ): Con la primera operacin, se ingresa un nuevo registro. Con la siguiente, se modifica el nombre de un registro que se ubica por su llave primaria. Con la ltima, se deshabilita un registro (borrado lgico).

Para la primera operacin, ntese que la Entidad tiene un atributo que referencia a otra Entidad de Parametrizacin que en este ejemplo es la Entidad Pas ( Co u n try). En este escenario, establecemos la relacin a un registro existente de pas. Para ello hay dos opciones: La primera involucra el uso del atributo XML llamado b u sin essKey , como se muestra en la imagen superior. Esta opcin aplica si no hay una definicin explcita de llaves de negocio predefinidas en esa Entidad. Por otro lado, est la opcin de usar la sintaxis de XML para un nuevo registro (si ya hay llaves de negocio predefinidas):

Copyright 2013 - Bizagi

2379

Para ms informacin sobre el uso de llaves de negocio, consulte Usando llaves de negocio en XMLs.

En la segunda operacin, utilizamos un atributo llamado key. Dado que cada Entidad en Bizagi tiene un atributo que es asignado como llave primaria de Bizagi, se puede ubicar un registro por medio de la llave surrogada. Este atributo se ubica como el atributo con id como prefijo, seguido del nombre de la Entidad (por ejemplo idCountry para la Entidad Country). Nota Es posible utilizar tambin el atributo b u sin essKey para definir una llave compuesta. Esto significa utilizar ms de un atributo para la definicin de una llave de negocio en los registros. Por ejemplo: businessKey=" Do cu m en tN u m b er= '123456' an d Do cu m en tTy p e= 'P assp o rt' ".

Si se conoce el valor de este atributo de antemano (se sabe cul es la llave surrogada para un registro), se puede actualizar un registro como se muestra en la primera imagen para la ciudad llamada B o g o t D.C..

En la tercera operacin, utilizamos un atributo que Bizagi crea de manera automtica en las Entidades de Parametrizacin para deshabilitar registros. Este atributo maneja un borrado lgico (donde estos registros no estaran disponibles para nuevas instancias de Procesos) ya que el borrado fsico comprometera la integridad de los datos (integridad referencial en instancias existentes). En la Capa SOA, este atributo se ubica con el prefijo d sb l seguido del nombre de la Entidad. Por ejemplo, el atributo de la primera imagen que nos muestra d sb lCity , que sera el atributo de deshabilitar registros para le Entidad City. Ntese que en este ejemplo, deshabilitamos un registro cuya llave es key=3 (tambin se usa el atributo key).

2380

Copyright 2013 - Bizagi

Ejemplo #2
En este ejemplo, se ilustra como actualizar la informacin de negocio de una instancia de Proceso en particular (un caso existente):

En este escenario, usamos el atributo XML id Case (para asignar 340 al DocumentNumber para el caso con identificador=9001).

Datos de salida
Esquema y Parmetros de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD: <?xml version="1.0"?> <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="Entities"> <xs:complexType/> </xs:element> </xs:schema> Los elementos al interior de Entities, corresponden a la estructura (atributos y relaciones) de la Entidad, como se define en Bizagi.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi, en donde vemos la respuesta de una invocacin exitosa para: Una Entidad de Parametrizacin: se tienen la informacin de las llaves involucradas (ids):

Una Entidad Maestra (por ejemplo, al actualizar informacin de un caso):

Copyright 2013 - Bizagi

2381

Mtodos Web relacionados

Para actualizar la informacin de negocio de un caso particular (por ejemplo, datos de Entidades maestras), es comn utilizar un mtodo que asocie esta informacin a una Actividad o Evento, a travs de los mtodos p erfo rm A ctiv ity A sStrin g o setEv en tA sStrin g. Para ms informacin sobre estos mtodos del motor BPMN de Bizagi, consulte los servicios Web de WorkflowEngineSOA. Tambin es posible que se desee obtener previamente el esquema de la Entidad a utilizar como dato de entrada en este mtodo. Para hacerlo de una manera dinmica, use los mtodos g etEn tity Sch em aStr o g etEn tity Sch em a. Para ms informacin sobre esta opcin, consulte getEntitySchemaStr.

7.1.3

Mtodos Web de QuerySOA

Los mtodos Web publicados en Q u ery SO A son tiles para acceder a las consultas de Bizagi (por ejemplo para: ejecutar formas de consulta y sus reportes, para obtener los resultados de casos o registros a nivel de Entidades). Este servicio Web y sus mtodos se acceden en la siguiente URL. Para Bizagi Enterprise .NET y Bizagi Xpress: http://[nombre_servidor]/[proyecto_Bizagi]/WebServices/QuerySOA.asmx?wsdl

2382

Copyright 2013 - Bizagi

Para Bizagi Enterprise JEE: En Servidores de Aplicaciones Weblogic y JBoss: http://[nombre_servidor]:[puerto]/Bizagi-war/WebServices/QuerySOA?wsdl En WebSphere: http://[nombre_servidor]:[puerto]/Bizagi-war/QuerySOAImplService/ QuerySOAImplService.wsdl

Para informacin puntual sobre cada mtodo, consulte los sub artculos. 7.1.3.1 QueryCasesAsString

Introduccin
Este mtodo se utiliza para obtener detalle de los casos de Procesos tanto con informacin de

Copyright 2013 - Bizagi

2383

negocio como detalle general (fecha de creacin, de solucin, etc), desde una aplicacin externa. A travs de este mtodo se ejecuta una forma de consulta predefinida y se obtienen sus resultados de la misma manera en que se obtienen desde la ejecucin de esos reportes en el Portal de Trabajo. Para ms informacin acerca de la predefinicin de estos reportes, consulte Formas de consulta. Para ms informacin acerca de cmo ejecutar estos reportes, consulte Consultas. Este mtodo recibe un nico parmetro de entrada el cual contiene principalmente: el usuario que ejecuta la forma de consulta, criterios de filtro generales para la bsqueda (por ejemplo, rangos de fechas de creacin), criterios de filtros especficos al Proceso (por ejemplo, filtros con informacin de negocio), y parmetros para el manejo de los resultados (cuantas occurrencias, cmo manejar la paginacin, etc).

Para invocar la forma de consulta especfica, asegrese de consultar su ID:

Nota: La descripcin en este artculo aplica tambin para el mtodo Web q u ery Cases, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo queryCases, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo queryCasesAsString la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada

2384

Copyright 2013 - Bizagi

La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD:

Parmetros de entrada
BizAgiWSParam: Es el nodo raz que contiene toda la informacin para ejecutar la forma de consulta. Contiene los nodos "domain", "userName", "QueryParams", y "Parameters". domain: Ac se especifica el dominio del usuario en Bizagi que ejecuta la consulta. userName: El nombre de usuario que ejecuta la consulta. QueryParams: Contiene la informacin para los filtros de la bsqueda al ejecutar la consulta. Contiene los nodos "Internals" y "XPaths". Internals: Contiene 1 o ms nodos de tipo "Internal", que se utilizan para especificar los filtros relacionados a los datos de proceso (por medio de renders internos). Internal: Especifica en su atributo "Name", el render interno. El valor del filtro va como el valor del nodo y es sensible a maysculas. Los posible valores para el atributo "Name" de Internal son: ProcessState: Permite filtrar los casos que estn abietos ("Running"), cerrados ("Completed") o que hayan sido abortados ("Aborted"). "ALL" se utliza como defecto, en cuyo caso no habra filtro para este criterio. RadNumber: Permite filtrar para obtener un caso especfico. CreationDate: Permite filtrar de acuerdo a la fecha de creacin del caso. ExpiryDate: Permite filtrar de acuerdo a la fecha de vencimiento del caso. ExpiryDays: Permite filtrar de acuerdo al nmero de das que quedan para el vencimiento del caso.

o o o o

Copyright 2013 - Bizagi

2385

o Users: Permite filtrar de acuerdo a los usuarios (especificando el UserId) que estn actualmente trabajando en los casos. o Creatorfullname: nombre completo (fullname) del creador del caso. o Creatorposition: posicin del creador del caso. o Creatorloginname: nombre de usuario (username) del creador del caso. o Userfullname: nombre completo (fullname) del usuario actualmente loggeado (currentuser). o Userposition: posicin del usuario actualmente loggeado (currentuser). o Userloginname: nombre de usuario (username) del usuario actualmente loggeado (currentuser). o idWfClass: Permite filtrar de acuerdo al id de proceso (wfclass). o idApplication: Permite filtrar de acuerdo al id de la aplicacin Bizagi. o idCategory: Permite filtrar de acuerdo al id de la categora de proceso. o idTask: Permite filtrar de acuerdo a la actividad actual. XPaths: Contiene 1 o ms nodos "XPath", que se utilizan para especificar filtros relacionados a datos de negocio. XPath: Especifica en su atributo "Path", la ruta XPath del atributo en el modelo de datos tal como se filtra en la forma de consulta. El XPath utiliza el caracter punto (.) como separador. El valor del filtro va como "Value" del nodo y es sensible a maysculas. nicamente cuando se especifique un rango de valores (para filtrar una fecha), ser necesario inclur los subnodos "<From>" y/o "<To>" para que stos contengan los valores de los lmites del rango. Otros atributos adicionales en este nodo son: o "Include": Se puede incluir y definirse como "true" para incluir los resultados de ese atributo en la respuesta. o "Approx": Se puede incluir y definirse como "true" para realizar una bsqueda aproximada en atributos de tipo "string" (cadenas de texto). o "Sort": Se puede incluir y definirse como "Desc" (descendiente) or "Asc" (ascendiente) para ordenar los resultados de acuerdo al valor del atributo. Cuando no se especifica esta opcin, el ordenamiento de los registros por defecto tendr en cuenta el "RadNumber" de manera ascendenete. Parameters: Contiene 1 o ms nodos "Parameter", que se utilizan para especificar los parmetros de la ejecucin de la forma de consulta y el manejo de los resultados. Parameter: Especifica en su atributo "Name", las diversas opciones para manejar los resultados de la forma de consulta. El valor del filtro va como "Value" del nodo y es sensible a maysculas. Los posibles valores para el atributo "Name" son: "idQueryForm" (define un nmero que corresponde al id de la forma de consulta), "PageSize" (define el nmero de registros que componen cada pgina de la ejecucin), "pag" (define un nmero de pgina especfico que contiene los casos), "Culture" (define la cultura global para el soporte multi-lenguage de los resultados, por ejemplo: "enUs").

Ejemplo
Con el siguiente ejemplo, se invoca una forma de consulta cuyo id es 24, donde queremos los registros que: Estn en un estatus pendiente (Running). Tengan una fecha de creacin (atributo OpeningDate) que sea posterior a Noviembre 1 de 2011.

2386

Copyright 2013 - Bizagi

En este otro ejemplo, ilustramos cmo usar un filtro para una Entidad de Parametrizacin en la forma de consulta. Para ello, usamos el atributo de llaves de negocio ( b u sin essKey). <?xml version="1.0" encoding="UTF-8"?> <BizAgiWSParam> <domain>domain</domain> <userName>admon</userName> <QueryParams> <Internals> </Internals> <XPaths> <XPath Path="VacationRequest.RejectionReason" businessKey="RejectionReason='No replacement available'" Include="true"/> </XPaths> </QueryParams> <Parameters> <Parameter Name="idQueryForm">2</Parameter> </Parameters> </BizAgiWSParam>

Ntese que dentro del Path definido para el filtro XPath, se requiere que el atributo de la Entidad de Aplicacin que referencia a la Entidad de Proceso, tenga el mismo nombre que la Entidad de Proceso como tal.

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD:

Copyright 2013 - Bizagi

2387

2388

Copyright 2013 - Bizagi

Parmetros de salida
BizAgiWSResponse: Es el nodo raz que contiene toda la informacin para ejecutar la forma de consulta. Contiene los nodos "Results", y "Parameters". Results: Contiene los nodos "RowsCount", "PageCount" y "Tables" con la informacin de los casos. RowsCount: Nmero total de registros (casos) retornados por la ejecucin de la forma de consulta. PageCount: Nmero total de pginas retornadas por la ejecucin de la forma de consulta. Tables: Contiene los nodos "CaseTable" y "TaskTable". CaseTable: Contiene 1 ocurrencia del nodo "Columns", y ocurrencias indefinidas del nodo "Rows" (una ocurrencia para cada registro resultado). Los siguientes subnodos se incluyen en este nodo: o RADNUMBER: Nmero (cadena) de radicacin. o BAWORKFLOWPATH: Path del proceso. o WFCLSDISPLAYNAME: El nombre para mostrar del proceso. o CASCREATIONDATE: Fecha de creacin del caso. o CASSOLUCIONDATE: Fecha de solucin del caso. o IDWFCLASS: Id del proceso. o IDCASE: Nmero de creacin del caso. o IDCASESTATE: El estado del caso manejado por Bizagi. Los siguientes cdigo de estados son vlidos: Iniciado "Initiated" (1), "Ejecutndose" Running (2), Suspendido "Suspended" (3), Abortado "Aborted" (4), Cerrado "Completed" (5), No-iniciado "NotInitiated" (6), Cancelado por evento de compensacin "CancelledByCompensation" (7), Cancelado por excepcin "CancelledByException" (8). TaskTable: Contiene 1 ocurrencia del nodo "Columns", y ocurrencias indefinidas del nodo "Rows" (una para cada actividad). Los siguiente subnodos se incluyen en este nodo: TaskState: Estado actual de la actividad. CurrentTask: El nombre para mostrar de la actividad. wiEstimatedSolutionDate: Fecha de solucin estimada para la actividad. idTaskType: Tipo de actividad. idTask: Id de la actividad. idWorkItem: Id del workitem. idCase: Nmero de caso relacionado a esa instancia de actividad. Parameters: Contiene 1 o ms nodos "Parameter", los cuales se utilizaron como parmetros para la ejecucin de la consulta. Parameter: Especifica en su atributo "Name", las parametrizaciones usadas para el manejo de los resultados de la ejecucin de la consulta.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi;

Copyright 2013 - Bizagi

2389

Mtodos Web relacionados

Si no requiere obtener informacin de negocio de los casos consultados, use los mtodos g etCasesA sStrin g o g etCases de los servicios Web de WorkflowEngineSOA. A travs de estos mtodos, no se requiere tener una forma de consulta predefinida. Para ms informacin sobre esta opcin, consulte WorkflowEngineSOA. Si desea obtener ms informacin especfica de un solo caso, use los mtodos g etCaseDataUsin g Sch em aA sStrin g o g etCaseDataUsin g XP ath sA sStrin g de los servicios Web de EntityManagerSOA. A travs de estos mtodos, no se requiere tener una forma de consulta predefinida. Para ms informacin sobre esta opcin, consulte EntityManagerSOA.

2390

Copyright 2013 - Bizagi

7.1.3.2

QueryEntitiesAsString

Introduccin
Este mtodo se utiliza para obtener detalle de registros en una Entidad del modelo de datos de Bizagi, desde una aplicacin externa. A travs de este mtodo se ejecuta una forma de consulta a nivel de Entidad (forma de Entidad) y se obtienen sus resultados de la misma manera en que se obtienen desde la ejecucin de esos reportes en el Portal de Trabajo. Para ms informacin acerca de la predefinicin de estos reportes, consulte Formas de consulta. Para ms informacin acerca de cmo ejecutar estos reportes, consulte Consultas. Este mtodo recibe un nico parmetro de entrada el cual contiene principalmente: el usuario que ejecuta la forma de consulta, criterios de filtros especficos a la Entidad (por ejemplo, filtros con informacin de negocio para sus atributos), y parmetros para el manejo de los resultados (cuantas occurrencias, cmo manejar la paginacin, etc).

Para invocar la forma de Entidad especfica, asegrese de consultar su ID:

Nota: La descripcin en este artculo aplica tambin para el mtodo Web q u ery En tities, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo q u ery En tities, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo q u ery En titiesA sStrin g la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Copyright 2013 - Bizagi

2391

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD:

Para ms informacin sobre la estructura esperada de los elementos dentro de Entities, consulte cmo se representan el modelo de datos del Proceso en Esquema XML de Bizagi para el modelo de datos .

Parmetros de entrada
BizAgiWSParam: Es el nodo raz que contiene toda la informacin para ejecutar la forma de consulta. Contiene los nodos "domain", "userName", "QueryParams", y "Parameters". domain: Ac se especifica el dominio del usuario en Bizagi que ejecuta la consulta. userName: El nombre de usuario que ejecuta la consulta. QueryParams: Contiene la informacin para los filtros de la bsqueda al ejecutar la consulta. Contiene el nodo "XPaths". XPaths: Contiene 1 o ms nodos "XPath", que se utilizan para especificar filtros relacionados a datos de negocio. XPath: Especifica en su atributo "Path", la ruta XPath del atributo en el modelo de datos tal como se

2392

Copyright 2013 - Bizagi

filtra en la forma de consulta. El XPath utiliza el caracter punto (.) como separador. El valor del filtro va como "Value" del nodo y es sensible a maysculas. nicamente cuando se especifique un rango de valores (para filtrar una fecha), ser necesario inclur los subnodos "<From>" y/o "<To>" para que stos contengan los valores de los lmites del rango. Otros atributos adicionales en este nodo son: o "Include": Se puede incluir y definirse como "true" para incluir los resultados de ese atributo en la respuesta. o "Approx": Se puede incluir y definirse como "true" para realizar una bsqueda aproximada en atributos de tipo "string" (cadenas de texto). o "Sort": Se puede incluir y definirse como "Desc" (descendiente) or "Asc" (ascendiente) para ordenar los resultados de acuerdo al valor del atributo. Cuando no se especifica esta opcin, el ordenamiento de los registros por defecto tendr en cuenta el "RadNumber" de manera ascendenete. Tenga en cuenta que el XPath para una forma de consulta a nivel de entidad, parte de la entidad misma. Parameters: Contiene 1 o ms nodos "Parameter", que se utilizan para especificar los parmetros de la ejecucin de la forma de consulta y el manejo de los resultados. Parameter: Especifica en su atributo "Name", las diversas opciones para manejar los resultados de la forma de consulta. El valor del filtro va como "Value" del nodo y es sensible a maysculas. Los posibles valores para el atributo "Name" son: "idQueryForm" (define un nmero que corresponde al id de la forma de consulta), "PageSize" (define el nmero de registros que componen cada pgina de la ejecucin), "pag" (define un nmero de pgina especfico que contiene los casos), "Culture" (define la cultura global para el soporte multi-lenguage de los resultados, por ejemplo: "enUs").

Ejemplo
Con el siguiente ejemplo, se ejecuta una forma de Entidad con id=3.

Copyright 2013 - Bizagi

2393

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD:

2394

Copyright 2013 - Bizagi

Copyright 2013 - Bizagi

2395

Parmetros de salida
BizAgiWSResponse: Es el nodo raz que contiene toda la informacin para ejecutar la forma de consulta. Contiene los nodos "Results", y "Parameters". Results: Contiene los nodos "RowsCount", "PageCount" y "Tables" con la informacin de los casos. RowsCount: Nmero total de registros (casos) retornados por la ejecucin de la forma de consulta. PageCount: Nmero total de pginas retornadas por la ejecucin de la forma de consulta. Tables: Contiene los nodos "CaseTable" y "TaskTable". ResponseTable: Contiene 1 ocurrencia del nodo "Columns", y ocurrencias indefinidas del nodo "Rows" (una ocurrencia para cada registro resultado). Los nodos al interior del ResponseTable tendrn la informacin de los atributos de la entidad de la consulta. Parameters: Contiene 1 o ms nodos "Parameter", los cuales se utilizaron como parmetros para la ejecucin de la consulta. Parameter: Especifica en su atributo "Name", las parametrizaciones usadas para el manejo de los resultados de la ejecucin de la consulta.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi:

2396

Copyright 2013 - Bizagi

Mtodos Web relacionados

Si desea obtener informacin de los registros de Entidades especficas, por ejemplo que sean Entidades de Parametrizacin, puede optar por usar los mtodos g etEn titiesA sStrin g o g etEn tities de los servicios Web de EntityManagerSOA. A travs de estos mtodos, no se requiere tener una forma de Entidad predefinida. Para ms informacin sobre esta opcin, consulte EntityManagerSOA.

Copyright 2013 - Bizagi

2397

7.1.4

Mtodos Web de RenderSOA

Los mtodos Web publicados en Ren d erSO A son tiles para acceder a la metadata de las formas en Bizagi (por ejemplo para integrar y mostrar las formas de Actividades o Eventos en un portal externo) . Este servicio Web y sus mtodos se acceden en la siguiente URL. Para Bizagi Enterprise .NET y Bizagi Xpress: http://[nombre_servidor]/[proyecto_Bizagi]/WebServices/RenderSOA.asmx?wsdl

Para Bizagi Enterprise JEE: En Servidores de Aplicaciones Weblogic y JBoss: http://[nombre_servidor]:[puerto]/Bizagi-war/WebServices/RenderSOA?wsdl

2398

Copyright 2013 - Bizagi

En WebSphere: http://[nombre_servidor]:[puerto]/Bizagi-war/RenderSOAImplService/ RenderSOAImplService.wsdl

Para informacin puntual sobre cada mtodo, consulte los sub artculos. 7.1.4.1 GetActivityForm

Introduccin
Este mtodo se utiliza para obtener los controles de una forma y su informacin relevante, para una Actividad pendiente en Bizagi (desde una aplicacin externa). Esto significa que con este mtodo se obtiene la metadata de la forma de una instancia activa de una Actividad para un caso.

Este mtodo es til para la integracin de las formas y funcionalidad de Bizagi dentro de un portal externo (por ejemplo Sharepoint). Este mtodo recibe un nico parmetro de entrada el cual contiene principalmente: la informacin del caso y de la instancia de la Actividad, y el lenguage y cultura para desplegar la forma y sus controles segn la localizacin predefinida.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web g etA ctiv ity F o rm XM L, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo g etA ctiv ity F o rm XM L, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo g etA ctiv ity F o rm la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD:

Copyright 2013 - Bizagi

2399

Parmetros de entrada
BizAgiWSParam: Nodo raz. domain: Dominio de usuario asignado a la actividad. userName: Nombre del usuario asignado a la actividad. Case: Incluye informacin sobre el caso y el workitem deseado. idCase: Nmero de identificacin del Caso. idWorkItem: Nmero de identificacin de la instancia de la tarea dek usuario a la cual pertenece la forma. language: Se debe usar nicamente si el proceso ha sido configurado en varios idiomas, para especificar cual es el idioma deseado. Incluye el cdigo del idioma definido por los estndares ISO y los estndares de Internet.

Ejemplo
Con el siguiente ejemplo, se The following XML will be used to obtain the form of the workitem number 708 for the case number 551. The process of this case was configured to have more than one language, one of which is the Brazilian Portuguese, for this reason in the language element is included pt-br:

Datos de salida
Esquema de salida
El XML de retorno vara segn como se haya construido la forma, y los controles que tenga la misma. Por ejemplo, una forma puede contener grupos, pestaas e incluso a su vez, otras formas anidadas (o tablas y campos de bsqueda que utilizan otras formas en su configuracin). Por lo tanto, tenga en cuenta lo anterior para visualizar el esquema completo que se puede representar estructuralmente con la respuesta de este mtodo.

Parmetros de salida
En la respuesta, los parmetros los desglosamos para su descripcin como elementos o atributos XML. La siguiente descipcin corresponde a los elementos del retorno: BizagiResponse: Nodo raz.

2400

Copyright 2013 - Bizagi

Form: Contiene la informacin de la forma. Tab: Indica que hay una pestaa en la forma. Group: Indica si hay un grupo en la forma. ExtendedText: Uno de los tipos de campo en Bizagi el cual es una caja de texto para textos largos. Text: Caja de texto en una forma (ver Tipos de Campo). ComboBox: Este tipo de campo es una lista desplegable en la forma. Option: Este elemento es usado con los combos, si el combo es editable habr una de estas opciones en la losta desplegable. Si no es editable, solamente habr una con la opcin seleccionada. RadioButton: Otro tipo de campo que muestra las diferentes opciones que se pueden seleccionar. Item: Este elemento es usado sea con el RadioButton o la coleccin de datos (GridSM). Para los radio buttons se incluye un elemento por cada opcin posible. Para las colecciones, se incluye el elemento dentro de un elemento Fila que representa el valor de cada columna en la fila. Money: Render usado para mostrar un atributo de tipo Currency, (ver tipos de campo). Numeric: Render usado para mostrar cualquier otro atributo que representa un nmero (integer, float, real, etc.), (ver Tipos de Campo). YesNo: Este tipo de campo es usado para Atributos Booleanos y consiste en un par de radio buttons Si/No. Date: Representa un tipo de campo de fecha y hora. SearchDialog: Representa un Join Search Dialog o un Join Search Field (ver tipos de campo). Actions: Serie de acciones configuradas para el render. Action: Accin en particular. Behaviours: Serie de comportamientos configurados para el render. Behaviour: Un comportamiento en particular. ClientValidations: Serie de validaciones configuradas para el render. ClientValidation: Una validacin en particular. Expression: Este elemento es usado para acciones, comportamientos y validaciones. Contiene la expresin que ser evaluada. Target: Elemento usado en acciones el cual incluye las acciones especfias para el objetivo. GridSM: Usado para indicar una grilla (tabla) el cual es un render para Colecciones. DisplayForm: Este elemento es parte del GridSM y contiene los renders (columnas) de la tabla. AddForm: Hace parte tambin de GridSM, contiene el nmero de identificacin de la forma utilizada para aadir una nueva fila en la tabla. EditForm: Hace parte tambin de GridSM, contiene el nmero de identificacin de la forma utilizada para editar una fila en la tabla. Values: Forma parte de GridSM, contiene todas las filas en la tabla. Row: Este elemento indica una forma en una tabla (grilla). CaseInfo: Informacin del caso. IdCase: Identificacin del nmero del caso. IdWorkItem: Nmero de identificacin o llave de la instancia de la actividad. RadicationNumber: Valor alfanumrico correspondiente al nmero de creacin del caso. SolutionDate: Fecha en la cual se complet el caso. Creator: Informacin sobre el creador del caso. o Id: Nmero de identificacin del creador del caso. UserName: Nombre del usuario creador del caso. Domain: Dominio al cual pertenece el creador del caso. FullName: Nombre completo del creador del caso. Activity: Informacin sobre la actividad consultada. o Id: Nmero de identificacin de la tarea. Name: Nombre de la tarea.

Copyright 2013 - Bizagi

2401

DisplayName: Nombre a mostrar de la tarea. Description: Texto corto con alguna descripcin de la tarea. Process: Datos del proceso. Id: Nmero que identifica el proceso. Name: Nombre del proceso. DisplayName: Texto con alguna explicacin sobre el proceso. La siguiente descipcin corresponde a los atributos del retorno: RenderId: Nmero de identificacin del render, estos atributos se incluyen en todos los elementos que representan un tipo de campo: Forma, Fecha, Combo Box, Texto, etc. ConfirmationRequired: Pertenece al elemento Forma y es un Booleano que indica si la actividad necesita confirmacin del usuario cuando se presiona el botn Siguiente. DisplayName: Casi todos los elementos tienen estos atributos, este es el texto que debe aparecer para un campo en caso que este se muestre. Editable: Todos los elementos correspondientes a tipos de campos (excepto las GridSM) tienen este atributo Booleano el cual indica si el campo debe mostrarse como editable o no. Required: As como el elemento previo, este elemento es un Booleano el cual indica si un render debera mostrarse o no como requerido. Este se puede encontrar en todos los elementos de tipo campo, excepto GridSM y Form. XPath: Contiene el mapeo del render hacia el modelo de datos, cada render tipo campo lo tiene excepto Form. Description: Este atributo aparece para los elementos que representan un tipo de campo solamente si el texto de descripcin fue includo en las propiedades del render. HelpText: Al igual que la Descripcin, este elemento aparece nicamente si la informacin fue diligenciada en las propiedades del render. LabelAlign: Texto que especifica la alineacin del render (izquierda, centro, derecha o justificado). LineBreak: Un booleano que indica si despus de este render hay o no un cambio de lnea (line break); es decir, si el render siguiente aparecer en la misma linea o en una lnea diferente. ValueAlign: Texto que especifica la alineacin del los valores del render (izquierda, centro, derecha o justificado). DisplayOption: Algunos renders tienen maneras diferentes de ser mostrados, estas opciones son: ambas, que es la opcin por defecto, muestra la etiqueta y a continuacin el valor; label, muestra nicamente la etiqueta del render; value, muestra nicamente el valor del render; reversed, muestra primero el valor y luego la etiqueta; y vertical, la cual muestra el valor entre etiquetas, en una nueva lnea. ColSpan: Nmero indicando el nmero de columnas que usa un render, usualmente el nmero es (0) . Retype: Este atributo puede ser encontrado en algunos elementos que representan tipos de campos y es un Booleano que indica si la informacin ingresada en este render debe ser digitada o no dos veces. Size: Es un nmero que indica el tamao para los tipos de campo donde se debe ingresar valores en las cajas: texto, texto extendido y moneda. Tambin se puede encontrar en combos y tendr un nmero distinto a (1) si el render se debe mostrar como una lista, este atributo indica el tamao de la lista. MaxLength: Atributo empleado para los elementos Texto y Texto Extendido el cual indica el nmero mximo de caracteres que se pueden ingresar en el render. ColSize: nicamente para los elementos de Texto Extendido, es un nmero que indica el tamao horizontal del render, si el nmero es 0 entonces tiene asignado el valor por defecto que es de 42 caracteres. ResetAppearance: Este se encuentra en los elementos Accin y Comportamiento; es un Booleano el

2402

Copyright 2013 - Bizagi

cual indica si el render debe retornar a su apariencia original si la condicin no se cumple. Show: Tambin hace parte del elementon de Comportamientos. Para las acciones se incluye en el elemento de Objetivo (Target). Este Booleano determina si el render al cual pertenece el Comportamiento o al cual se refiere el Objetivo, es o no visible. Color: Atributo encontrado en el elemento de Comportamiento y en el elemento de Objetivo (Target) que hace parte del elemento de Acciones. Es un cdigo hexadecimal con el color con el cual se mostrar el render en caso de cumplirse la condicin. OrderAttrib: Se puede encontrar en los elementos ComboBox, GridSM o SearchDialog. Contiene el nombre del atributo que debe ser usado para ordenar los elementos que contiene este campo. SubmitOnChange: Es un Booleano que puede ser encontrado en varios elementos de tipo de campo para indicar si la forma se actualiza en el momento que se cambia el valor del campo. Value: Este atributo se incluye en la mayora de tipos de campo y contiene el valor actual del campo, en caso de no encontrarse este elemento quiere decir que el campo no tiene valor asociado en ese momento. Tambin hace parte del elemento opcin de los combos, y contiene el valor de la llave del registro. Text: Texto que se muestra en las listas desplegables, este es el valor en el atributo a mostrar para una entidad; se incluye en el elemento de Opcin. AdditionalText: Para una lista desplegable es posible incluir un segundo texto que corresponde al valor de cualquier otro atributo en la entidad. Este atributo es para el elemento Opcin.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi:

Copyright 2013 - Bizagi

2403

Mtodos Web relacionados

Es posible que previamente se desee obtener la lista de Actividades disponibles a travs de los mtodos g etA ctiv itiesA sStrin g o g etA ctiv ities, para posteriormente usar este mtodo y poder mostrar su forma. Para ms informacin sobre esta opcin, consulte getActivitiesAsString. Si la forma que se obtiene en esta invocacin contiene una tabla con formas de adicin o edicin, se requiere utilizar el mtodo GetF o rm B y Id para presentar estas otras formas. Para ms informacin sobre esta opcin, consulte getFormById. 7.1.4.2 GetFormById

Introduccin
Este mtodo se utiliza para obtener los controles de una forma en Bizagi (desde una aplicacin externa). Este mtodo es particularmente til para manejar la respuesta e informacin adicional del mtodo GetA ctiv ity F o rm cuando ste incluye una tabla o campo de bsqueda, cuando se trabaja en integracin de las formas y funcionalidad de Bizagi dentro de un portal externo (por ejemplo

2404

Copyright 2013 - Bizagi

Sharepoint). En estos escenarios, parte de la informacin que se tiene de una forma, son las formas de adicin y de edicin.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web g etF o rm B y Id XM L, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo g etF o rm B y Id XM L, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo g etF o rm B y Id la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD:

Parmetros de entrada
BizAgiWSParam: Root node. domain: Dominio de usuario asignado a la actividad. userName: Nombre del usuario asignado a la actividad. Case: Incluye informacin sobre el caso y el workitem deseado. idCase: Nmero de identificacin del Caso. idWorkItem: Nmero de identificacin de la instancia de la tarea dek usuario a la cual pertenece la forma. language: Se debe usar nicamente si el proceso ha sido configurado en varios idiomas, para especificar cual es el idioma deseado. Incluye el cdigo del idioma definido por los estndares ISO y los estndares de Internet. Form: Incluye informacin sobre la forma deseada. IdForm: Nmero de identificacin de la forma deseada.

Copyright 2013 - Bizagi

2405

Ejemplo
Con el siguiente ejemplo, se obtiene la forma con id=1379 que est activa para el caso 9 con la instancia de una Actividad con workitem=104.

Datos de salida
Esquema de salida
El XML de retorno vara segn como se haya construido la forma, y los controles que tenga la misma. Por ejemplo, una forma puede contener grupos, pestaas e incluso a su vez, otras formas anidadas (o tablas y campos de bsqueda que utilizan otras formas en su configuracin).

Parmetros de salida
En la respuesta, los parmetros los desglosamos para su descripcin como elementos o atributos XML. La siguiente descipcin corresponde a los elementos del retorno: BizagiResponse: Nodo raz. Form: Contiene la informacin de la forma. Tab: Indica que hay una pestaa en la forma. Group: Indica si hay un grupo en la forma. ExtendedText: Uno de los tipos de campo en Bizagi el cual es una caja de texto para textos largos. Text: Caja de texto en una forma (ver Tipos de Campo). ComboBox: Este tipo de campo es una lista desplegable en la forma. Option: Este elemento es usado con los combos, si el combo es editable habr una de estas opciones en la losta desplegable. Si no es editable, solamente habr una con la opcin seleccionada. RadioButton: Otro tipo de campo que muestra las diferentes opciones que se pueden seleccionar. Item: Este elemento es usado sea con el RadioButton o la coleccin de datos (GridSM). Para los radio buttons se incluye un elemento por cada opcin posible. Para las colecciones, se incluye el elemento dentro de un elemento Fila que representa el valor de cada columna en la fila. Money: Render usado para mostrar un atributo de tipo Currency, (ver tipos de campo). Numeric: Render usado para mostrar cualquier otro atributo que representa un nmero (integer, float, real, etc.), (ver Tipos de Campo).

2406

Copyright 2013 - Bizagi

YesNo: Este tipo de campo es usado para Atributos Booleanos y consiste en un par de radio buttons Si/No. Date: Representa un tipo de campo de fecha y hora. SearchDialog: Representa un Join Search Dialog o un Join Search Field (ver tipos de campo). Actions: Serie de acciones configuradas para el render. Action: Accin en particular. Behaviours: Serie de comportamientos configurados para el render. Behaviour: Un comportamiento en particular. ClientValidations: Serie de validaciones configuradas para el render. ClientValidation: Una validacin en particular. Expression: Este elemento es usado para acciones, comportamientos y validaciones. Contiene la expresin que ser evaluada. Target: Elemento usado en acciones el cual incluye las acciones especfias para el objetivo. GridSM: Usado para indicar una grilla (tabla) el cual es un render para Colecciones. DisplayForm: Este elemento es parte del GridSM y contiene los renders (columnas) de la tabla. AddForm: Hace parte tambin de GridSM, contiene el nmero de identificacin de la forma utilizada para aadir una nueva fila en la tabla. EditForm: Hace parte tambin de GridSM, contiene el nmero de identificacin de la forma utilizada para editar una fila en la tabla. Values: Forma parte de GridSM, contiene todas las filas en la tabla. Row: Este elemento indica una forma en una tabla (grilla). CaseInfo: Informacin del caso. IdCase: Identificacin del nmero del caso. IdWorkItem: Nmero de identificacin o llave de la instancia de la actividad. RadicationNumber: Valor alfanumrico correspondiente al nmero de creacin del caso. SolutionDate: Fecha en la cual se complet el caso. Creator: Informacin sobre el creador del caso. o Id: Nmero de identificacin del creador del caso. UserName: Nombre del usuario creador del caso. Domain: Dominio al cual pertenece el creador del caso. FullName: Nombre completo del creador del caso. Activity: Informacin sobre la actividad consultada. o Id: Nmero de identificacin de la tarea. Name: Nombre de la tarea. DisplayName: Nombre a mostrar de la tarea. Description: Texto corto con alguna descripcin de la tarea. Process: Datos del proceso. Id: Nmero que identifica el proceso. Name: Nombre del proceso. DisplayName: Texto con alguna explicacin sobre el proceso. La siguiente descipcin corresponde a los atributos del retorno: RenderId: Nmero de identificacin del render, estos atributos se incluyen en todos los elementos que representan un tipo de campo: Forma, Fecha, Combo Box, Texto, etc. ConfirmationRequired: Pertenece al elemento Forma y es un Booleano que indica si la actividad necesita confirmacin del usuario cuando se presiona el botn Siguiente. DisplayName: Casi todos los elementos tienen estos atributos, este es el texto que debe aparecer para un campo en caso que este se muestre. Editable: Todos los elementos correspondientes a tipos de campos (excepto las GridSM) tienen este atributo Booleano el cual indica si el campo debe mostrarse como editable o no.

Copyright 2013 - Bizagi

2407

Required: As como el elemento previo, este elemento es un Booleano el cual indica si un render debera mostrarse o no como requerido. Este se puede encontrar en todos los elementos de tipo campo, excepto GridSM y Form. XPath: Contiene el mapeo del render hacia el modelo de datos, cada render tipo campo lo tiene excepto Form. Description: Este atributo aparece para los elementos que representan un tipo de campo solamente si el texto de descripcin fue includo en las propiedades del render. HelpText: Al igual que la Descripcin, este elemento aparece nicamente si la informacin fue diligenciada en las propiedades del render. LabelAlign: Texto que especifica la alineacin del render (izquierda, centro, derecha o justificado). LineBreak: Un booleano que indica si despus de este render hay o no un cambio de lnea (line break); es decir, si el render siguiente aparecer en la misma linea o en una lnea diferente. ValueAlign: Texto que especifica la alineacin del los valores del render (izquierda, centro, derecha o justificado). DisplayOption: Algunos renders tienen maneras diferentes de ser mostrados, estas opciones son: ambas, que es la opcin por defecto, muestra la etiqueta y a continuacin el valor; label, muestra nicamente la etiqueta del render; value, muestra nicamente el valor del render; reversed, muestra primero el valor y luego la etiqueta; y vertical, la cual muestra el valor entre etiquetas, en una nueva lnea. ColSpan: Nmero indicando el nmero de columnas que usa un render, usualmente el nmero es (0) . Retype: Este atributo puede ser encontrado en algunos elementos que representan tipos de campos y es un Booleano que indica si la informacin ingresada en este render debe ser digitada o no dos veces. Size: Es un nmero que indica el tamao para los tipos de campo donde se debe ingresar valores en las cajas: texto, texto extendido y moneda. Tambin se puede encontrar en combos y tendr un nmero distinto a (1) si el render se debe mostrar como una lista, este atributo indica el tamao de la lista. MaxLength: Atributo empleado para los elementos Texto y Texto Extendido el cual indica el nmero mximo de caracteres que se pueden ingresar en el render. ColSize: nicamente para los elementos de Texto Extendido, es un nmero que indica el tamao horizontal del render, si el nmero es 0 entonces tiene asignado el valor por defecto que es de 42 caracteres. ResetAppearance: Este se encuentra en los elementos Accin y Comportamiento; es un Booleano el cual indica si el render debe retornar a su apariencia original si la condicin no se cumple. Show: Tambin hace parte del elementon de Comportamientos. Para las acciones se incluye en el elemento de Objetivo (Target). Este Booleano determina si el render al cual pertenece el Comportamiento o al cual se refiere el Objetivo, es o no visible. Color: Atributo encontrado en el elemento de Comportamiento y en el elemento de Objetivo (Target) que hace parte del elemento de Acciones. Es un cdigo hexadecimal con el color con el cual se mostrar el render en caso de cumplirse la condicin. OrderAttrib: Se puede encontrar en los elementos ComboBox, GridSM o SearchDialog. Contiene el nombre del atributo que debe ser usado para ordenar los elementos que contiene este campo. SubmitOnChange: Es un Booleano que puede ser encontrado en varios elementos de tipo de campo para indicar si la forma se actualiza en el momento que se cambia el valor del campo. Value: Este atributo se incluye en la mayora de tipos de campo y contiene el valor actual del campo, en caso de no encontrarse este elemento quiere decir que el campo no tiene valor asociado en ese momento. Tambin hace parte del elemento opcin de los combos, y contiene el valor de la llave del registro. Text: Texto que se muestra en las listas desplegables, este es el valor en el atributo a mostrar para

2408

Copyright 2013 - Bizagi

una entidad; se incluye en el elemento de Opcin. AdditionalText: Para una lista desplegable es posible incluir un segundo texto que corresponde al valor de cualquier otro atributo en la entidad. Este atributo es para el elemento Opcin.

Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi.

7.1.4.3

GetQueryForms

Introduccin
Este mtodo se utiliza para obtener los controles de una forma para una forma de consulta en Bizagi (desde una aplicacin externa). Este mtodo es til para la integracin de las formas y funcionalidad de Bizagi dentro de un portal externo (por ejemplo Sharepoint). Este mtodo recibe el ID de la forma de consulta que se va a traer. Para ms informacin acerca de la predefinicin de estos reportes, consulte Formas de consulta.

Para invocar la forma de consulta especfica, asegrese de consultar su ID:

Copyright 2013 - Bizagi

2409

Nota: La descripcin en este artculo aplica tambin para el mtodo Web g etQ u ery F o rm sXM L, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo g etQ u ery F o rm sXM L, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo g etQ u ery F o rm s la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD:

Parmetros de entrada

2410

Copyright 2013 - Bizagi

BizAgiWSParam: Nodo raz. domain: Dominio del usuario Bizagi. userName: Nombre del usuario Bizagi. QueryForm: Incluye informacin sobre la forma de consulta deseada. IdQueryForm: Nmero de identificacin de la Forma.

Ejemplo
Con el siguiente ejemplo, se obtiene la metadata de la forma, para una forma de consulta con id=34. <?xml version="1.0" encoding="utf-8"?> <BizAgiWSParam> <userName>admon</userName> <domain>domain</domain> <QueryForm> <IdQueryForm>34</IdQueryForm> </QueryForm> </BizAgiWSParam>

Datos de salida
Esquema de salida
El XML de retorno vara segn como se haya construido la forma, y los controles que tenga la misma. Por ejemplo, una forma puede contener grupos, pestaas e incluso a su vez, otras formas anidadas (o tablas y campos de bsqueda que utilizan otras formas en su configuracin).

Parmetros de salida
En la respuesta, los parmetros los desglosamos para su descripcin como elementos o atributos XML. La siguiente descipcin corresponde a los elementos del retorno: BizagiResponse: Nodo raz. Form: Contiene la informacin de la forma. Tab: Indica que hay una pestaa en la forma. Group: Indica si hay un grupo en la forma. ExtendedText: Uno de los tipos de campo en Bizagi el cual es una caja de texto para textos largos. Text: Caja de texto en una forma (ver Tipos de Campo). ComboBox: Este tipo de campo es una lista desplegable en la forma. Option: Este elemento es usado con los combos, si el combo es editable habr una de estas opciones en la losta desplegable. Si no es editable, solamente habr una con la opcin seleccionada. RadioButton: Otro tipo de campo que muestra las diferentes opciones que se pueden seleccionar. Item: Este elemento es usado sea con el RadioButton o la coleccin de datos (GridSM). Para los radio buttons se incluye un elemento por cada opcin posible. Para las colecciones, se incluye el elemento dentro de un elemento Fila que representa el valor de cada columna en la fila. Money: Render usado para mostrar un atributo de tipo Currency, (ver tipos de campo). Numeric: Render usado para mostrar cualquier otro atributo que representa un nmero (integer, float, real, etc.), (ver Tipos de Campo). YesNo: Este tipo de campo es usado para Atributos Booleanos y consiste en un par de radio

Copyright 2013 - Bizagi

2411

buttons Si/No. Date: Representa un tipo de campo de fecha y hora. SearchDialog: Representa un Join Search Dialog o un Join Search Field (ver tipos de campo). Actions: Serie de acciones configuradas para el render. Action: Accin en particular. Behaviours: Serie de comportamientos configurados para el render. Behaviour: Un comportamiento en particular. ClientValidations: Serie de validaciones configuradas para el render. ClientValidation: Una validacin en particular. Expression: Este elemento es usado para acciones, comportamientos y validaciones. Contiene la expresin que ser evaluada. Target: Elemento usado en acciones el cual incluye las acciones especfias para el objetivo. GridSM: Usado para indicar una grilla (tabla) el cual es un render para Colecciones. DisplayForm: Este elemento es parte del GridSM y contiene los renders (columnas) de la tabla. AddForm: Hace parte tambin de GridSM, contiene el nmero de identificacin de la forma utilizada para aadir una nueva fila en la tabla. EditForm: Hace parte tambin de GridSM, contiene el nmero de identificacin de la forma utilizada para editar una fila en la tabla. Values: Forma parte de GridSM, contiene todas las filas en la tabla. Row: Este elemento indica una forma en una tabla (grilla). CaseInfo: Informacin del caso. IdCase: Identificacin del nmero del caso. IdWorkItem: Nmero de identificacin o llave de la instancia de la actividad. RadicationNumber: Valor alfanumrico correspondiente al nmero de creacin del caso. SolutionDate: Fecha en la cual se complet el caso. Creator: Informacin sobre el creador del caso. o Id: Nmero de identificacin del creador del caso. UserName: Nombre del usuario creador del caso. Domain: Dominio al cual pertenece el creador del caso. FullName: Nombre completo del creador del caso. Activity: Informacin sobre la actividad consultada. o Id: Nmero de identificacin de la tarea. Name: Nombre de la tarea. DisplayName: Nombre a mostrar de la tarea. Description: Texto corto con alguna descripcin de la tarea. Process: Datos del proceso. Id: Nmero que identifica el proceso. Name: Nombre del proceso. DisplayName: Texto con alguna explicacin sobre el proceso. La siguiente descipcin corresponde a los atributos del retorno: RenderId: Nmero de identificacin del render, estos atributos se incluyen en todos los elementos que representan un tipo de campo: Forma, Fecha, Combo Box, Texto, etc. ConfirmationRequired: Pertenece al elemento Forma y es un Booleano que indica si la actividad necesita confirmacin del usuario cuando se presiona el botn Siguiente. DisplayName: Casi todos los elementos tienen estos atributos, este es el texto que debe aparecer para un campo en caso que este se muestre. Editable: Todos los elementos correspondientes a tipos de campos (excepto las GridSM) tienen este atributo Booleano el cual indica si el campo debe mostrarse como editable o no. Required: As como el elemento previo, este elemento es un Booleano el cual indica si un render

2412

Copyright 2013 - Bizagi

debera mostrarse o no como requerido. Este se puede encontrar en todos los elementos de tipo campo, excepto GridSM y Form. XPath: Contiene el mapeo del render hacia el modelo de datos, cada render tipo campo lo tiene excepto Form. Description: Este atributo aparece para los elementos que representan un tipo de campo solamente si el texto de descripcin fue includo en las propiedades del render. HelpText: Al igual que la Descripcin, este elemento aparece nicamente si la informacin fue diligenciada en las propiedades del render. LabelAlign: Texto que especifica la alineacin del render (izquierda, centro, derecha o justificado). LineBreak: Un booleano que indica si despus de este render hay o no un cambio de lnea (line break); es decir, si el render siguiente aparecer en la misma linea o en una lnea diferente. ValueAlign: Texto que especifica la alineacin del los valores del render (izquierda, centro, derecha o justificado). DisplayOption: Algunos renders tienen maneras diferentes de ser mostrados, estas opciones son: ambas, que es la opcin por defecto, muestra la etiqueta y a continuacin el valor; label, muestra nicamente la etiqueta del render; value, muestra nicamente el valor del render; reversed, muestra primero el valor y luego la etiqueta; y vertical, la cual muestra el valor entre etiquetas, en una nueva lnea. ColSpan: Nmero indicando el nmero de columnas que usa un render, usualmente el nmero es (0) . Retype: Este atributo puede ser encontrado en algunos elementos que representan tipos de campos y es un Booleano que indica si la informacin ingresada en este render debe ser digitada o no dos veces. Size: Es un nmero que indica el tamao para los tipos de campo donde se debe ingresar valores en las cajas: texto, texto extendido y moneda. Tambin se puede encontrar en combos y tendr un nmero distinto a (1) si el render se debe mostrar como una lista, este atributo indica el tamao de la lista. MaxLength: Atributo empleado para los elementos Texto y Texto Extendido el cual indica el nmero mximo de caracteres que se pueden ingresar en el render. ColSize: nicamente para los elementos de Texto Extendido, es un nmero que indica el tamao horizontal del render, si el nmero es 0 entonces tiene asignado el valor por defecto que es de 42 caracteres. ResetAppearance: Este se encuentra en los elementos Accin y Comportamiento; es un Booleano el cual indica si el render debe retornar a su apariencia original si la condicin no se cumple. Show: Tambin hace parte del elementon de Comportamientos. Para las acciones se incluye en el elemento de Objetivo (Target). Este Booleano determina si el render al cual pertenece el Comportamiento o al cual se refiere el Objetivo, es o no visible. Color: Atributo encontrado en el elemento de Comportamiento y en el elemento de Objetivo (Target) que hace parte del elemento de Acciones. Es un cdigo hexadecimal con el color con el cual se mostrar el render en caso de cumplirse la condicin. OrderAttrib: Se puede encontrar en los elementos ComboBox, GridSM o SearchDialog. Contiene el nombre del atributo que debe ser usado para ordenar los elementos que contiene este campo. SubmitOnChange: Es un Booleano que puede ser encontrado en varios elementos de tipo de campo para indicar si la forma se actualiza en el momento que se cambia el valor del campo. Value: Este atributo se incluye en la mayora de tipos de campo y contiene el valor actual del campo, en caso de no encontrarse este elemento quiere decir que el campo no tiene valor asociado en ese momento. Tambin hace parte del elemento opcin de los combos, y contiene el valor de la llave del registro. Text: Texto que se muestra en las listas desplegables, este es el valor en el atributo a mostrar para una entidad; se incluye en el elemento de Opcin.

Copyright 2013 - Bizagi

2413

AdditionalText: Para una lista desplegable es posible incluir un segundo texto que corresponde al valor de cualquier otro atributo en la entidad. Este atributo es para el elemento Opcin.

Ejemplo
Para ver un ejemplo de respuesta, consulte el XML en este enlace. 7.1.4.4 GetSummaryForms

Introduccin
Este mtodo se utiliza para obtener tanto los controles de una forma como sus valores, para una forma de resumen en Bizagi (desde una aplicacin externa). Este mtodo es til para la integracin de las formas y funcionalidad de Bizagi dentro de un portal externo (por ejemplo Sharepoint). Este mtodo recibe el identificador del caso del cul queremos ver la forma de resumen (con informacin a modo de lectura). Para ms informacin acerca de la predefinicin de la forma de resumen, consulte Formas globales y de resumen.

Nota: La descripcin en este artculo aplica tambin para el mtodo Web g etSu m m ary F o rm sXM L, el cual est disponible en las ediciones Bizagi Enterprise .NET y Bizagi Xpress. Para el mtodo g etSu m m ary F o rm sXM L, el XML que se maneja en la solicitud (request) y en la respuesta (response) son del tipo XmlDocument (nativa de .NET). Para el mtodo g etSu m m ary F o rm s la misma estructura de XMLs se maneja, sin embargo este parmetro es de tipo cadena (string).

Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD:

Parmetros de entrada
BizAgiWSParam: Nodo raz. domain: Dominio del usuario Bizagi.

2414

Copyright 2013 - Bizagi

userName: Nombre del usuario Bizagi. Case: Incluye informacin sobre el caso y el workitem deseado. idCase: Nmero de identificacin del caso. idWorkItem: Nmero de identificacin del la instancia de la tarea del usuario a la cual pertenece la forma.

Ejemplo
Con el siguiente ejemplo, se obtiene la metadata de una forma de resumen para un caso con id=9. <?xml version="1.0" encoding="utf-8"?> <BizAgiWSParam> <userName>admon</userName> <domain>domain</domain> <Case> <idCase>9</idCase> <idWorkItem>104</idWorkItem> </Case> </BizAgiWSParam>

Datos de salida
Esquema de salida
El XML de retorno vara segn como se haya construido la forma, y los controles que tenga la misma. Por ejemplo, una forma puede contener grupos, pestaas e incluso a su vez, otras formas anidadas (o tablas y campos de bsqueda que utilizan otras formas en su configuracin).

Parmetros de salida
En la respuesta, los parmetros los desglosamos para su descripcin como elementos o atributos XML. La siguiente descipcin corresponde a los elementos del retorno: BizagiResponse: Nodo raz. Form: Contiene la informacin de la forma. Tab: Indica que hay una pestaa en la forma. Group: Indica si hay un grupo en la forma. ExtendedText: Uno de los tipos de campo en Bizagi el cual es una caja de texto para textos largos. Text: Caja de texto en una forma (ver Tipos de Campo). ComboBox: Este tipo de campo es una lista desplegable en la forma. Option: Este elemento es usado con los combos, si el combo es editable habr una de estas opciones en la losta desplegable. Si no es editable, solamente habr una con la opcin seleccionada. RadioButton: Otro tipo de campo que muestra las diferentes opciones que se pueden seleccionar. Item: Este elemento es usado sea con el RadioButton o la coleccin de datos (GridSM). Para los radio buttons se incluye un elemento por cada opcin posible. Para las colecciones, se incluye el elemento dentro de un elemento Fila que representa el valor de cada columna en la fila. Money: Render usado para mostrar un atributo de tipo Currency, (ver tipos de campo). Numeric: Render usado para mostrar cualquier otro atributo que representa un nmero (integer, float, real, etc.), (ver Tipos de Campo).

Copyright 2013 - Bizagi

2415

YesNo: Este tipo de campo es usado para Atributos Booleanos y consiste en un par de radio buttons Si/No. Date: Representa un tipo de campo de fecha y hora. SearchDialog: Representa un Join Search Dialog o un Join Search Field (ver tipos de campo). Actions: Serie de acciones configuradas para el render. Action: Accin en particular. Behaviours: Serie de comportamientos configurados para el render. Behaviour: Un comportamiento en particular. ClientValidations: Serie de validaciones configuradas para el render. ClientValidation: Una validacin en particular. Expression: Este elemento es usado para acciones, comportamientos y validaciones. Contiene la expresin que ser evaluada. Target: Elemento usado en acciones el cual incluye las acciones especfias para el objetivo. GridSM: Usado para indicar una grilla (tabla) el cual es un render para Colecciones. DisplayForm: Este elemento es parte del GridSM y contiene los renders (columnas) de la tabla. AddForm: Hace parte tambin de GridSM, contiene el nmero de identificacin de la forma utilizada para aadir una nueva fila en la tabla. EditForm: Hace parte tambin de GridSM, contiene el nmero de identificacin de la forma utilizada para editar una fila en la tabla. Values: Forma parte de GridSM, contiene todas las filas en la tabla. Row: Este elemento indica una forma en una tabla (grilla). CaseInfo: Informacin del caso. IdCase: Identificacin del nmero del caso. IdWorkItem: Nmero de identificacin o llave de la instancia de la actividad. RadicationNumber: Valor alfanumrico correspondiente al nmero de creacin del caso. SolutionDate: Fecha en la cual se complet el caso. Creator: Informacin sobre el creador del caso. o Id: Nmero de identificacin del creador del caso. UserName: Nombre del usuario creador del caso. Domain: Dominio al cual pertenece el creador del caso. FullName: Nombre completo del creador del caso. Activity: Informacin sobre la actividad consultada. o Id: Nmero de identificacin de la tarea. Name: Nombre de la tarea. DisplayName: Nombre a mostrar de la tarea. Description: Texto corto con alguna descripcin de la tarea. Process: Datos del proceso. Id: Nmero que identifica el proceso. Name: Nombre del proceso. DisplayName: Texto con alguna explicacin sobre el proceso. La siguiente descipcin corresponde a los atributos del retorno: RenderId: Nmero de identificacin del render, estos atributos se incluyen en todos los elementos que representan un tipo de campo: Forma, Fecha, Combo Box, Texto, etc. ConfirmationRequired: Pertenece al elemento Forma y es un Booleano que indica si la actividad necesita confirmacin del usuario cuando se presiona el botn Siguiente. DisplayName: Casi todos los elementos tienen estos atributos, este es el texto que debe aparecer para un campo en caso que este se muestre. Editable: Todos los elementos correspondientes a tipos de campos (excepto las GridSM) tienen este atributo Booleano el cual indica si el campo debe mostrarse como editable o no.

2416

Copyright 2013 - Bizagi

Required: As como el elemento previo, este elemento es un Booleano el cual indica si un render debera mostrarse o no como requerido. Este se puede encontrar en todos los elementos de tipo campo, excepto GridSM y Form. XPath: Contiene el mapeo del render hacia el modelo de datos, cada render tipo campo lo tiene excepto Form. Description: Este atributo aparece para los elementos que representan un tipo de campo solamente si el texto de descripcin fue includo en las propiedades del render. HelpText: Al igual que la Descripcin, este elemento aparece nicamente si la informacin fue diligenciada en las propiedades del render. LabelAlign: Texto que especifica la alineacin del render (izquierda, centro, derecha o justificado). LineBreak: Un booleano que indica si despus de este render hay o no un cambio de lnea (line break); es decir, si el render siguiente aparecer en la misma linea o en una lnea diferente. ValueAlign: Texto que especifica la alineacin del los valores del render (izquierda, centro, derecha o justificado). DisplayOption: Algunos renders tienen maneras diferentes de ser mostrados, estas opciones son: ambas, que es la opcin por defecto, muestra la etiqueta y a continuacin el valor; label, muestra nicamente la etiqueta del render; value, muestra nicamente el valor del render; reversed, muestra primero el valor y luego la etiqueta; y vertical, la cual muestra el valor entre etiquetas, en una nueva lnea. ColSpan: Nmero indicando el nmero de columnas que usa un render, usualmente el nmero es (0) . Retype: Este atributo puede ser encontrado en algunos elementos que representan tipos de campos y es un Booleano que indica si la informacin ingresada en este render debe ser digitada o no dos veces. Size: Es un nmero que indica el tamao para los tipos de campo donde se debe ingresar valores en las cajas: texto, texto extendido y moneda. Tambin se puede encontrar en combos y tendr un nmero distinto a (1) si el render se debe mostrar como una lista, este atributo indica el tamao de la lista. MaxLength: Atributo empleado para los elementos Texto y Texto Extendido el cual indica el nmero mximo de caracteres que se pueden ingresar en el render. ColSize: nicamente para los elementos de Texto Extendido, es un nmero que indica el tamao horizontal del render, si el nmero es 0 entonces tiene asignado el valor por defecto que es de 42 caracteres. ResetAppearance: Este se encuentra en los elementos Accin y Comportamiento; es un Booleano el cual indica si el render debe retornar a su apariencia original si la condicin no se cumple. Show: Tambin hace parte del elementon de Comportamientos. Para las acciones se incluye en el elemento de Objetivo (Target). Este Booleano determina si el render al cual pertenece el Comportamiento o al cual se refiere el Objetivo, es o no visible. Color: Atributo encontrado en el elemento de Comportamiento y en el elemento de Objetivo (Target) que hace parte del elemento de Acciones. Es un cdigo hexadecimal con el color con el cual se mostrar el render en caso de cumplirse la condicin. OrderAttrib: Se puede encontrar en los elementos ComboBox, GridSM o SearchDialog. Contiene el nombre del atributo que debe ser usado para ordenar los elementos que contiene este campo. SubmitOnChange: Es un Booleano que puede ser encontrado en varios elementos de tipo de campo para indicar si la forma se actualiza en el momento que se cambia el valor del campo. Value: Este atributo se incluye en la mayora de tipos de campo y contiene el valor actual del campo, en caso de no encontrarse este elemento quiere decir que el campo no tiene valor asociado en ese momento. Tambin hace parte del elemento opcin de los combos, y contiene el valor de la llave del registro. Text: Texto que se muestra en las listas desplegables, este es el valor en el atributo a mostrar para

Copyright 2013 - Bizagi

2417

una entidad; se incluye en el elemento de Opcin. AdditionalText: Para una lista desplegable es posible incluir un segundo texto que corresponde al valor de cualquier otro atributo en la entidad. Este atributo es para el elemento Opcin.

Ejemplo
Para ver un ejemplo de respuesta, consulte el XML en este enlace.

7.2

Instalacin de Oracle Data Provider para .NET

Informacin general
Bizagi utiliza el cliente de Oracle Data Provider para .NET (ODP.NET), para conectarse con bases de datos Oracle, ya sea cuando Oracle se use como la base de datos de los procesos de Bizagi (aplica para las ediciones Enterprise .NET y Enterprise JEE), o tambin cuando se utiliza la Virtualizacin o Replicacin para integrar bases de datos externas de Oracle a la solucin Bizagi. Tenga en cuenta que la Virtualizacin y Replicacin son mecanismos de integracin disponibles en todas las ediciones de Bizagi (Ediciones Xpress, Enterprise .NET y Enterprise JEE).

El cliente de Oracle Data Provider para .Net se instala al descargar (e instalar) el componente ODAC (Oracle Data Access Components). Bizagi requiere el ODAC en su versin 11g, el cual soporta la conectividad a bases de datos Oracle 10g R2 y tambin a plataformas de 64 bits.

Nota Tenga en cuenta que la versin de base de datos Oracle soportada como base de datos de los procesos de Bizagi es la Oracle 10g R2 (para la versin Enterprise .NET). Por otro lado, para hacer uso de la Virtualizacin o Replicacin, las base de datos Oracle soportadas pueden ser cualquiera de las siguientes versiones: 9i, 10g R2, 11g R1 o 11g R2.

Escogiendo el ODAC apropiado

El componente ODAC puede ser descargado directamente de los sitios oficiales de Oracle. Si su proyecto utiliza una versin de Bizagi Enterprise con soporte a 64 bits, descargue la versin 11.2.0.3.0 x64. Para ello, vaya a: http://www.oracle.com/technetwork/database/windows/downloads/ index-090165.html.

Si su proyecto utiliza Bizagi Xpress, o una versin de Bizagi Enterprise con soporte a 32 bits, descargue la versin 11.1.0.7.20 32-bits. Para ello, vaya a http://www.oracle.com/technetwork/ developer-tools/visual-studio/downloads/index.html.

2418

Copyright 2013 - Bizagi

La instalacin del ODAC puede requerirse en diferentes servidores o estaciones, de acuerdo a desde dnde se maneja la conexin a la instancia de la base de datos Oracle. La siguiente tabla ilustra dnde se requiere instalar ODAC, en relacin al feature que se utilizar en el proyecto Bizagi.

Instalacin ODAC

Servidor de Base de Datos

Servido r BPM

Servidor donde se ejecuta el Programador (Scheduler) X

Estacin de trabajo del usuario de Bizagi Studio (ambiente de desarrollo) X

Usando Oracle como la base de datos de Bizagi Usando Virtualizacin para integrar Oracle Usando Replicacin para integrar Oracle

Nota: Ntese que en ningn momento se requiere que las estaciones de los usuarios finales instalen este componente. Los usuarios finales acceden al portal de Bizagi, por lo que nicamente requieren de un navegador.

Vea mayor informacin sobre los requerimientos de sistema e instrucciones detalladas del ODAC en: http://www.oracle.com/technology/software/tech/windows/odpnet/install1110720.html.

Instalando ODAC
Una vez se ejecute el instalador, en la ventana Select a Product to Install, seleccione el ODAC para Cliente Oracle.

Copyright 2013 - Bizagi

2419

Luego, en la ventana Available Product Components, nicamente es necesario seleccionar el ODP.NET.

2420

Copyright 2013 - Bizagi

Vea mayor informacin acerca del Oracle Data Provider for .NET, en los sitios web oficiales de Oracle: http://www.oracle.com/technology/tech/windows/odpnet/index.html.

Una vez termine la instalacin se le notificar con una ventana que puede cerrar el instalador.

7.3

Crear un proyecto utilizando Oracle

Overview
Este artculo sirve de gua para la creacin de un proyecto de Bizagi en una base de datos Oracle. Ntese que Oracle como la base de datos repositorio de los procesos, puede usarse en las ediciones Enterprise JEE y Enterprise .Net.

Prerrequisitos
Para crear un proyecto de Bizagi en una base de datos Oracle, tenga en cuenta lo siguiente: 1. Se soporta Oracle 10g R2. La edicin Express de Oracle (XE) no est soportada. Usted puede verificar la versin de base de datos Oracle y release ejecutando:

Copyright 2013 - Bizagi

2421

select * from v$version;

Debe mostrarse la versin 10.2.x.x.x para Oracle 10g R2. 2. Se requiere que se haya instalado el Proveedor de conexin Oracle (ODP.NET) en el Servidor BPM (desde donde se desea crear el proyecto en Bizagi Studio). 3. Tenga presente que se debe utilizar en todos sus ambientes del proyecto de Bizagi (desarrollo, pruebas y produccin), una instancia de base de datos con la misma versin de Oracle y el mismo set de caracteres (character set). 4. La instancia debe tener un set de caracteres que no sea Unicode (se soporta una configuracin de sin g le-b y te). Para mayor informacin sobre los set de caracteres que no sean de multiple byte, consulte la documentacin oficial de Oracle. 5. Se requiere que la instancia de Oracle haya sido previamente configurada para trabajar con Bizagi. En esta configuracin de la instancia, se incluye la creacin del usuario BizagiAdmon.

Creando el usuario BizagiAdmon

El usuario BizagiAdmon es el usuario que se utiliza para crear la estructura (metadata) del proyecto Bizagi. Para crear este usuario, se requiere tener acceso a la instancia de Oracle como el usuario "sys" (sysdba). Los proyectos nuevos en Bizagi sern creados como usuarios en la instancia de una base de datos Oracle (usando el usuario BizagiAdmon). Para ello, puede permitir que Bizagi cree automticamente este usuario, o tambin puede manualmente ejecutar un script SQL'. Estas 2 opciones se describen a continuacin.

2422

Copyright 2013 - Bizagi

Creando BizagiAdmon desde un script

Para crear al usuario BizagiAdmon a travs de un script SQL, debe conectarse a su instancia de Oracle como el usuario "sys" (sysdba) y ejecutar el script llamado ConfigureInstanceForBizAgi-10g.sql. Para ello, deber tener en cuenta: 1. Este script se encuentra incluido en la ruta de instalacin de Bizagi, por defecto en "C:\Program Files (x86)\BizAgi\BizAgi Enterprise\ProjectModel\Database\". Antes de ejecutarlo, debe editar y definir en l, la informacin variable relacionada a: La ruta donde Bizagi crear los datafiles de los tablespaces (BA_TABLES_DATAFILES_DIR). La ruta donde Bizagi crear los datafiles de los ndices (BA_INDEXES_DATAFILES_DIR). La ruta donde Bizagi almacenar los respaldos (backups): BA_BACKUP_PATH. Una contrasea para el usuario BizagiAdmon (BA_BIZAGIADMON_PASSWORD).

Creando BizagiAdmon desde un proyecto nuevo

Para crear al usuario BizagiAdmon desde Bizagi (automticamente), vaya a la opcin de N u ev o p ro y ecto (New project). 1. Puede hacer clic sobre esta opcin directamente al abrir Bizagi Studio:

Copyright 2013 - Bizagi

2423

Ntese que la creacin del usuario BizagiAdmon de esta manera (a travs de un proyecto nuevo), efectivamente tambin crear inmediatamente un nuevo proyecto. 2. Ingrese un nombre para su proyecto, y seleccione la opcin de Co n fig u raci n d e b ase d e d ato s av an zad a (Advanced database configuration):

2424

Copyright 2013 - Bizagi

Haga clic en Sig u ien te. 3. En Informacin de base de datos Bizagi, seleccione O racle y la opcin de Usu ario B izag iA d m o n n o h a sid o cread o :

Copyright 2013 - Bizagi

2425

Haga clic en Sig u ien te. 4. En la ventana de Co n fig u re la in stan cia d e O racle, seleccione la opcin que indica que Bizagi crear el usuario BizagiAdmon automticamente. Seguidamente, ingrese el detalle de la conexin del usuario"sys" de su instancia de Oracle:

2426

Copyright 2013 - Bizagi

Ntese que el servicio de la instancia de Oracle se especifica como: "ServidorBaseDeDatos:puerto/ NombreServicio". Haga clic en Sig u ien te. 5. Ingrese y confirme la contrasea que ser utilizada para: el usuario BizagiAdmon, y para el proyecto nuevo a crear.

Copyright 2013 - Bizagi

2427

Haga clic en Sig u ien te. 6. En la siguiente ventana, especifique rutas vlidas para la creacin de los archivos que va a manejar Bizagi:

2428

Copyright 2013 - Bizagi

Ntese que estas rutas incluyen: la ubicacin donde sern creados los datafiles de los tablespaces y de los ndices, y la ubicacin donde Bizagi almacenar los respaldos (backups). Haga clic en Sig u ien te para iniciar la configuracin de la instancia, y la creacin del proyecto.

Creando un nuevo proyecto en Oracle

Una vez que se haya configurado la instancia de Oracle para trabajar con Bizagi (tener creado el usuario BizagiAdmon), la creacin de proyectos nuevos se realiza de la siguiente manera: 1. Vaya a la opcin de N u ev o p ro y ecto (New project). Puede hacer clic sobre esta opcin directamente al abrir Bizagi Studio:

Copyright 2013 - Bizagi

2429

2. Ingrese un nombre para su proyecto, y seleccione la opcin de Co n fig u raci n d e b ase d e d ato s av an zad a (Advanced database configuration):

2430

Copyright 2013 - Bizagi

Haga clic en Sig u ien te. 3. En la In fo rm aci n d e la b ase d e d ato s B izag i, seleccione O racle e ingrese: los detalles de la conexin a la instancia, y la informacin del nuevo proyecto. En los detalles de la conexin se debe incluir el servicio para la instancia de Oracle, y la contrasea del usuario BizagiAdmon (tal como se defini al momento de la creacin, en los prerequisitos). La informacin para este nuevo proyecto el nombre del proyecto (este ser un nuevo usuario en la instancia de Oracle), y pedir una contrasea y su confirmacin de este nuevo proyecto:

Copyright 2013 - Bizagi

2431

Ntese que el servicio de la instancia de Oracle se especifica como: "ServidorBaseDeDatos:puerto/ NombreServicio", y que NO es necesario seleccionar la opcin de Usu ario B izag iA d m o n n o h a sid o cread o . Haga clic en Sig u ien te para iniciar la creacin del proyecto.

7.4

Configuracin del Portal de Trabajo en JEE

Introduccin
Los Procesos en Bizagi se pueden configurar sobre una plataforma JEE. Despus de que se haya completado la implementacin de un proyecto con Bizagi Enterprise JEE, y una vez se hayan probado satisfactoriamente los Procesos en el ambiente de desarrollo, se publican los mismos hacia un ambiente de pruebas y posteriormente a un ambiente de produccin. Cuando se utiliza la edicin Bizagi Enterprise JEE, en los ambientes de pruebas y produccin se requiere de los pasos a continuacin para configurar el Portal de Trabajo.

Lo que debe hacer

En los ambientes de pruebas o produccin de una plataforma JEE, se debe tener una Base de datos del ambiente de pruebas o produccin con los Procesos implementados.

2432

Copyright 2013 - Bizagi

Para ello, se utiliza el Deployment Avanzado, con el cual se llevan los Procesos desde la Base de datos de desarrollo hacia la Base de datos de pruebas o produccin. Una vez que se tengan estos cambios listos, se genera el Portal de Trabajo como una aplicacin Web en el Servidor de Aplicaciones JEE. Para generar el Portal de Trabajo se requiere: contar con el Servidor de Aplicaciones JEE previamente configurado para trabajar con Bizagi, y tener la consola JEE de Bizagi. En resumen, estos son los pasos a seguir: 1. Realizar un Deployment de Bizagi. Esto se realiza para publicar los procesos y su implementacin desde el ambiente de desarrollo hacia la Base de datos de pruebas o de produccin. En la edicin Bizagi JEE, este Deployment se ejecuta mediante la herramienta para el Deployment Avanzado. 2. Configurar la arquitectura del sistema y los servidores. En este paso debe asegurarse de tener el Servidor de Aplicaciones JEE configurado para trabajar con Bizagi (sea Weblogic, WebSphere o JBoss). Para ms informacin, consulte Configuracin de un Servidor de Aplicaciones JEE donde podr ver la gua de configuracin para una solucin en clster o standalone. Adicionalmente, deber asegurarse que en la configuracin de la arquitectura del sistema se contemple la instalacin y configuracin de otros componentes necesarios cuando aplique a la solucin (por ejemplo Apache HTTP Server como Servidor Web). Esto aplica nicamente si su proyecto utilizar cualquiera de las siguientes caractersticas: Un esquema de 3 capas en la solucin (Capa de presentacin en adicin a la capa BPM lgica y la capa de Datos). La posibilidad de acceso al portal de Bizagi desde internet de manera segura (a travs de un proxy inverso donde se conserva el acceso desde la intranet tambin). Balanceo de cargas en los servidores BPM, para una solucin configurada en clster. Para ms informacin, consulte Configurar la arquitectura del sistema. 3. Generar el Portal de Trabajo. En este paso se realiza un despliegue de la aplicacin (en el Servidor de Aplicaciones JEE). Esto se realiza de una manera asistida, a travs de la consola JEE de Bizagi. Para ms informacin, consulte Despliegue hacia un Servidor de Aplicaciones JEE. Cada vez que se deseen publicar cambios (por ejemplo nuevas versiones de proceso) al ambiente de pruebas o produccin, deber realizar este paso.

Nota En proyectos que estn en el ambiente de desarrollo, estos pasos no son necesarios. Esto se debe a que Bizagi realiza lo anterior de manera automtica usando una instalacin embebida de JBoss 7.1.1. Si para su proyecto en el ambiente de desarrollo, usted no desea utilizar la instancia de JBoss por

Copyright 2013 - Bizagi

2433

defecto, puede realizar los pasos #2 y #3 del listado anterior. Sin embargo, tenga en cuenta que lo recomendado es utilizar la instancia de JBoss en desarrollo por motivos de agilidad en la implementacin (dado que es un Servidor ms ligero e inicia ms rpido, y no requiere de configuracin adicional).

7.4.1

Configuracin del Servidor de Aplicacin JEE para trabajar con Bizagi

Para publicar los Procesos de Bizagi en la edicin Bizagi Enterprise JEE, debe configurar el Servidor de Aplicaciones JEE para que trabaje con Bizagi. Esto aplica para cualquiera de los siguientes escenarios: 1. Se desea montar un ambiente de pruebas en plataforma JEE para los Procesos. 2. Se desea montar un ambiente de produccin en plataforma JEE para los Procesos. 3. Se desea montar un ambiente de desarrollo con un Servidor de Aplicaciones JEE diferente a JBoss 7.1.1. Se recomienda que previo a esta configuracin, se cuente con el repositorio de Procesos, el cual ser utilizado para la configuracin del ambiente destino. En otras palabras, para esta configuracin se debe tener la Base de datos de Bizagi creada a partir del Deployment Avanzado. Tenga en cuenta que estos pasos son parte de lo requerido para configurar el Portal de trabajo en JEE. Siga las instrucciones de los artculos a continuacin (de acuerdo al Servidor de Aplicaciones JEE que se desea usar): Configurar WebSphere para trabajar con Bizagi Configurar Weblogic para trabajar con Bizagi Configurar JBoss para trabajar con Bizagi 7.4.1.1 Configuracin de WebSphere La configuracin de un servidor WebSphere hace parte de la configuracin para Configurar un Servidor de Aplicaciones JEE, como un paso requerido al crear el Portal de trabajo de Bizagi en la edicin Enterprise JEE. La configuracin de WebSphere vara de acuerdo a si la configuracin de la solucin tendr un esquema de alta disponibilidad o no (si se involucra o no ms de una instancia de WebSphere en un clster).

Para una gua sobre cmo configurar WebSphere para trabajar con Bizagi en un esquema de alta disponibilidad (para aplicaciones de misin crtica), consulte la Configuracin en clster de WebSphere. Para una gua sobre cmo configurar WebSphere para trabajar con Bizagi como instancia standalone (estndar setup), consulte Configuracin estndar de WebSphere.

2434

Copyright 2013 - Bizagi

7.4.1.1.1 Configuracin de WebSphere en clster

Introduccin
Con la edicin Bizagi Enterprise JEE, sus Procesos se pueden configurar sobre diferentes Servidores de Aplicacin JEE (p.e. WebSphere, WebLogic, o JBoss). El procedimiento de configuracin de cada Servidor de Aplicaciones para trabajar con Bizagi, vara ligeramente de acuerdo a las diferencias en s de cada uno de los servidores. Este artculo se enfoca en la configuracin de WebSphere para trabajar con Bizagi, en un esquema de alta disponibilidad, donde se hace uso de un clster para contar con el balanceo de cargas en la aplicacin.

Si desea configurar WebSphere a modo standalone (solamente empleando un servidor BPM; sin esquema de balanceo de cargas), consulte la Configuracin estndar de WebSphere.

Lo que debe hacerse

Para la configuracin en clster de Bizagi, debe realizar estos pasos: 1. Seguir los requisitos para usar WebSphere y WASND. Estas directrices y pasos se indican en la Preconfiguracin de WebSphere para soporte a clster, e incluyen la creacin de perfiles y el registro del clster y de sus nodos. 2. Configurar WebSphere en clster para trabajar en Bizagi. Estos pasos se describen en la Configuracin en clster de WebSphere. 3. Configurar el servicio Scheduler (Programador) para una solucin en clster. Estos pasos se describen en la Configuracin del Scheduler en WebSphere.

Copyright 2013 - Bizagi

2435

4. Configurar otros componentes que hacen parte de la solucin, como el balanceador de cargas. Para ello, se recomienda revisar lo descrito en Configurar la arquitectura del sistema, donde se presenta la posibilidad de una instalacin de la solucin en 3 capas, y las directrices para la configuracin del balanceo de cargas.

7.4.1.1.1.1 Preconfiguracin de WebSphere para soporte a clster

El siguiente artculo describe los pasos y directrices a seguir para la configuracin de clsters en WebSphere. Esto es un prerequisito para llevar a cabo la configuracin de WebSphere para trabajar con Bizagi en clster. Para ms informacin sobre los pasos que se llevan a cabo, consulte Configurar WebSphere en clster.

Prerequisitos
Para configurar su instancia de WebSphere en un ambiente de pruebas o produccin, se requiere: JDK 6, update 31 instalado en cada nodo que har parte del clster. La variable de entorno JA VA _H O M E configurada previamente en cada nodo (se recomienda que sea en una ruta sin espacios). Tener a la mano los archivos de configuracin (y de despliegue) requeridos por Bizagi (BizAgi-earWebsphere-dist.zip). Tener instalado el Servidor WebSphere en cada nodo que har parte del clster. Las versiones soportadas son las pertenecientes a WebSphere V7. Tener instalado WebSphere Application Server Network Deployment (WASND) instalado en un Servidor con acceso a los nodos que harn parte del clster (puede ser incluso, un servidor que contenga nodos del clster). Debe ser la versin que corresponda a la versin del Servidor WebSphere (por ejemplo WASND v7 para WebSphere v7). WebSphere puede ser descargado o solicitado directamente desde la pgina oficial de IBM. Tenga presente que debe tener el instalador apropiado a su sistema, y que para su instalacin, debe seguir tanto los requisitos de WebSphere, como los lineamientos presentados en la seccin de Requisitos para usar WebSphere y WASND. Nota Los nodos con instancias de WebSphere pueden estar en un mismo servidor o en diferentes servidores. Bizagi soporta el uso de WebSphere en clster tanto horizontal como vertical. Se recomienda la configuracin de clster horizontal, de manera que se tenga un servidor dedicado

2436

Copyright 2013 - Bizagi

para cada nodo de WebSphere.

Requisitos para usar WebSphere y WASND

Tenga en cuenta que WebSphere requiere de lo siguiente para la configuracin con Bizagi en clster: 1. Asegurar que se instalen los componentes necesarios de WebSphere (y WASND) y que se cuente con las ltimas actualizaciones de fix packs del fabricante. Mayor detalle se describe a continuacin en la seccin Directrices d e in stalaci n y actu alizaci n . 2. Crear los perfiles para el manejo del clster a travs del WASND. Mayor detalle se describe en la seccin Req u erim ien to s d el cl ster: creaci n d e p erfiles. 3. Crear el clster, definiendo los nodos que hacen parte del mismo. Mayor detalle se describe en la seccin Creaci n d el cl ster.

1. Directrices de instalacin y actualizacin

Se recomienda que WASND se instale en una ruta sin espacios. Para instalar WebSphere (una vez que haya cubierto todos los prerequisitos), asegrese de considerar lo siguiente: Instalar los componentes de Servidor de Aplicacin ( A p p licatio n Serv er) de WebSphere. Habilitar la securidad administrativa ( A d m in istrativ e secu rity ), y definir un usuario y contrasea para la misma.

Copyright 2013 - Bizagi

2437

Dentro de la instalacin asistida de WASND, se recomienda indicar que no se incluyan perfiles por defecto y de esta manera poderlos crear manualmente despus de la instalacin, como se indica en la siguiente seccin. Una vez que haya instalado WebSphere Application Server y WASND, tenga presente que se recomienda enfticamente aplicar las ltimas actualizaciones y paquetes de mejoras (feature packs) del proveedor. Para hacerlo, recomendamos utilizar el Actualizador IBM Update Installer para WebSphere, y descargar igualmente los fix packs ms recientes para su instancia de WebSphere Application Server V7.0 (esto es, instalar los paquetes de mantenimiento), y tambin descargar y aplicar fix packs para WASND (por ejemplo, el fix pack 27 contiene mejoras que reducen el tiempo de despligue de las aplicaciones).

2438

Copyright 2013 - Bizagi

La ruta de instalacin de WASND ser referenciada como < W A S_H O M E> a partir de este momento.

2. Requerimientos del clster: creacin de perfiles

Sobre el uso de WASND, tenga presente que se deben crear 2 tipos de perfiles para la configuracin de la solucin en clster: un tipo de perfil que se crea para la administracin y configuracin centralizada del clster, y otro tipo de perfil que se debe crear tantas veces como la cantidad de nodos que hagan parte del clster. Estos perfiles son: Deployment Manager (DM): Es el perfil principal desde el cual se administra y se configura el clster (incluye el uso de la consola administrativa y despliegue de las aplicaciones). Custom: Es un perfil de ejecucin que se debe crear en cada nodo que haga parte del clster. Contiene la instancia del servidor de aplicaciones, de manera que el nodo queda federado al Deployment Manager (para que ste realice la distribucin y configuracin de las aplicaciones). Para la creacin de los perfiles, se utiliza la herramienta P ro file M an ag em en t To o l incluida en la instalacin del WASND.

Copyright 2013 - Bizagi

2439

Creacin del perfil DM Para crear este perfil, realice lo siguiente: De clic sobre el botn de Crear para definir un nuevo perfil ( Create). Seguidamente un asistente guiar las caractersticas del perfil. Seleccione Management como el tipo de entorno (Environment) y de clic en Siguiente ( N ex t):

Seleccione la opcin de Deployment Manager para el tipo de servidor ( Serv er ty p e) y de clic en Siguiente ( N ex t):

2440

Copyright 2013 - Bizagi

Seleccione la opcin Advanced profile creation para una configuracin avanzada del perfil, y de clic en Siguiente ( N ex t):

En la siguiente pantalla se requiere nicamente verificar que si se incluya la consola administrativa (la casilla Dep lo y th e ad m in istrativ e co n so le debe estar marcada). De clic en Siguiente ( N ex t). Defina las propiedades del perfil. Ingrese el nombre del mismo ( P ro file n am e), la ruta donde este perfil quedar instalado ( P ro file

Copyright 2013 - Bizagi

2441

d irecto ry), y verifique que no se utilice como perfil por defecto (la casilla M ake th is p ro file th e d efau lt debe quedar sin marcarse).
De clic en Siguiente ( N ex t).

Marque la casilla que habilita la seguridad administrativa (la opcin Enable administrative security debe quedar marcada). A partir de ello, ingrese las credenciales del usuario administrador (usuario, contrasea y su confirmacin). Tenga en cuenta que este usuario ser utilizado para la administracin del clster (p.e llevar a cabo la federacin de los nodos), por lo que se deber usar estas credenciales en la configuracin de perfiles tipo Cu sto m . Una vez haya ingresado estos datos, de clic en Siguiente ( N ex t):

2442

Copyright 2013 - Bizagi

En las siguientes dos pantallas, se presenta configuracin opcional relacionada a certificados de seguridad de la organizacin. Puede dejar estos valores por defecto cuando no se tienen certificados en el servidor (no realizar accin alguna), y de clic en Siguiente ( N ex t): Asigne los puertos para los servicios listados (en la pantalla de Port values assignment). Tenga en cuenta que de este listado de puertos, es importante que tenga presente e asignado a Administrative console secure port. Se debe recordar este puerto ya que se utilizar para las tareas de distribucin y despliegue (por medio de la consola administrativa). Una vez haya ingresado estos datos, de clic en Siguiente ( N ex t):

Copyright 2013 - Bizagi

2443

Seleccione si desea que el servidor se ejecute como un servicio (p.e como un servicio de Windows). Tenga en cuenta que esta opcin no se recomienda para entornos de pruebas ni de Desarollo. De clic en Siguiente ( N ex t). Finalmente, se mostrar una pantalla con el resumen de la configuracin que se asignar al nuevo perfil. Revise que estas opciones sean consistentes y de clic en el botn de Crear ( Create).

2444

Copyright 2013 - Bizagi

Ntese que dentro de la informacin de resumen, ver tambin el Nombre del host ( H o st n am e) que contempla este clster. Una vez que se finalice el asistente, debe iniciar el perfil. Para ello, abra una consola de comandos y ubquese en la ruta del perfil: <WAS_HOME>\AppServer\profiles\[Nombre_perfil]\bin Una vez all ejecute el comando startManager para iniciarlo (startManager.sh en Linux OS o startManager.sh en Windows):

Creacin del perfil Custom Tenga en cuenta que este paso se debe realizar para cada nodo que haga parte del clster.

Copyright 2013 - Bizagi

2445

Para crear este perfil, realice lo siguiente: De clic sobre el botn de Crear para definir un nuevo perfil ( Create). Seguidamente un asistente guiar las caractersticas del perfil. Seleccione Custom profile como el tipo de entorno (Environment) y de clic en Siguiente ( N ex t):

Seleccione la opcin Advanced profile creation para una configuracin avanzada del perfil, y de clic en Siguiente ( N ex t):

2446

Copyright 2013 - Bizagi

Defina las propiedades del perfil. Ingrese el nombre del mismo ( P ro file n am e) teniendo en cuenta que ste debe ser nico, la ruta donde este perfil quedar instalado ( P ro file d irecto ry), y verifique que no se utilice como perfil por defecto (la casilla M ake th is p ro file th e d efau lt debe quedar sin marcarse). De clic en Siguiente ( N ex t).

Copyright 2013 - Bizagi

2447

Ingrese la informacin relevante a la configuracin de su entorno de WebSphere: Nombre del nodo ( N o d e n am e) y nombre del Host ( H o st n am e) del que hace parte (segn se configur el perfil DM). De clic en Siguiente ( N ex t).

2448

Copyright 2013 - Bizagi

Ingrese la informacin para la federacin de nodos (configuracin que establezca que los nodos pertenecen a un clster en WebSphere). Para ello, considere: o Nodo DM ( Dep lo y m en t M an ag er h o st n am e o r IP ad d ress): El nodo el cual fue configurado con el perfil DM, como se indica en la seccin anterior. o Puerto para el manejo del DM ( Dep lo y m en t M an ag er SO A P p o rt n u m b er): El nmero de puerto bajo el cual se ejecuta la federacin de los nodos. o Deployment Manager authentication: El nombre de usuario y su contrasea para autenticarse en el nodo que es DM; tal como se especifica en la seccin anterior al momento de configurar el perfil DM y la seguridad administrativa. o Federar el nodo despus ( F ed erate th is n o d e later): Asegrese de dejar esta casilla desmarcada para llevar a cabo la federacin del nodo. Tenga en cuenta que para la federacin se requiere que el nodo DM se est ejecutando. De clic en Siguiente ( N ex t).

Copyright 2013 - Bizagi

2449

En las siguientes dos pantallas, se presenta configuracin opcional relacionada a certificados de seguridad de la organizacin. Puede dejar estos valores por defecto cuando no se tienen certificados en el servidor (no realizar accin alguna), y de clic en Siguiente ( N ex t). De igual manera, en la configuracin de los puertos que se utilizan puede dejar tambin los que se sugieren por defecto y continuar hasta la pgina de resumen para revisar que la configuracin sea la deseada. Una vez haya revisado esto, haga clic en Crear ( Create) para finalizar la configuracin para este nodo. Nota Recuerde que este paso de la Creaci n d el p erfil Cu sto m debe hacerse para cada nodo que haga parte del clster. Para las siguientes configuraciones, tenga presente que el nombre del perfil no debe repetirse.

Una vez que se finalice el asistente, debe iniciar el servicio de cada nodo. Para ello, abra una consola de comandos desde cada servidor donde est el nodo y ubquese en la ruta: <WAS_HOME>\profiles\[Nombre_nodo]\bin Una vez all ejecute el comando startNode.bat para iniciarlo (startNode.sh en Linux OS o startNode.sh en Windows):

2450

Copyright 2013 - Bizagi

Verificacin de perfiles Una vez que haya configurado los perfiles, puede verificar que la configuracin sea correcta y que la federacin de nodos se lleve a cabo sin inconvenientes. Para ello, ingrese a la consola administrativa desde en un navegador con la siguiente URL: http://[Servidor_DM]:[puerto_DM]/admin Dentro de las opciones de administracin del sistema ( Sy stem ad m in istratio n ), seleccione la opcin N o d e ag en ts donde podr ver el listado de los nodos que se federan al clster:

3. Creacin del clster

Para definir el clster de WebSphere, realice lo siguiente: 3.1 Vaya a la consola administrativa y ubique la opcin Serv ers.

Copyright 2013 - Bizagi

2451

Dentro de ella, expanda el tem Clu sters y haga clic sobre la opcin W eb Sp h ere ap p licatio n serv er clu sters.

3.2 Haga clic sobre el botn Nuevo ( N ew ) para definir el clster. En la informacin bsica del mismo, ingrese el nombre ( Clu ster n am e) y verifique que estn marcadas las 2 casillas: P refer lo cal y Co n fig u re H TTP sessio n m em o ry -to -m em o ry rep licatio n . De clic en Siguiente ( N ex t). 3.3 Ingrese la informacin del servidor de aplicaciones. Incluya: M em b er n am e: Ingrese el nombre del servidor de aplicaciones. Select n o d e: Seleccione el nodo al que corresponde al servicio. W eig h t: Conserve el valor por defecto. Gen erate u n iq u e H TTP p o rts: Asegrese que esta casilla est marcada. Create th e m em b er u sin g th e ap p licatio n serv er tem p late: Conserve el valor por defecto default.

2452

Copyright 2013 - Bizagi

De clic en Siguiente ( N ex t). 3.4 Ingrese la informacin de los nodos que hacen parte del clster. Para ello, de clic sobre A d d M em b er para adicionar cada nodo:

Copyright 2013 - Bizagi

2453

Repita este paso hasta asegurarse que los nodos que hacen parte de su clster aparezcan listados en la lista de miembros del clster. Este listado se aprecia en la parte inferior de la pantalla. Ntese que sus nodos deben tener un nombre nico pero deben conservar el mismo valor para las preferencias: W eig h t y Gen erate u n iq u e H TTP p o rts. Una vez que haya ingresado todos sus nodos, de clic en Siguiente ( N ex t). Verifique la informacin de la configuracin que es presentada a travs de la pantalla de resumen, y de clic en Finalizar ( F in ish ) para la creacin del clster.

Sincronizacin de cambios en el clster

Una vez se realice la configuracin del clster, o cada vez que se realicen cambios en l (por ejemplo, se adicione un nuevo nodo), se debe sincronizar la configuracin central hacia los nodos. Para realizar una sincronizacin de cambios, ubique la opcin de administracin del sistema ( Sy stem ad m in istratio n ), y seleccione la opcin N o d es donde podr ver el listado de los nodos actuales del clster. Marque los nodos y haga clic en Synchronize:

2454

Copyright 2013 - Bizagi

Ntese que una vez se finalice la sincronizacin, la columna Status mostrar un cono verde. Nota Si el cono del Status del nodo aparece con un signo de interrogacin, deber cerciorarse de que el servicio del nodo se encuentre iniciado y sea accessible para que se complete la sincronizacin. Una vez que complete estos pasos, consulte la Configuracin de WebSphere en clster para trabajar con Bizagi.
7.4.1.1.1.2 Configuracin de WebSphere en clster para trabajar con Bizagi

Para la configuracin de WebSphere para trabajar con Bizagi en un esquema de clster (ms de un nodo en la capa BPM), se debe contar con ciertas configuraciones previas del lado de WebSphere. Por lo tanto, antes de continuar, asegrese de haber seguido las instrucciones descritas en Preconfigurar WebSphere para soporte a clster. Para ms informacin sobre el procedimiento completo, consulte Configurar WebSphere en clster. Este artculo indica qu configuraciones debe realizar para que su cluster en WebSphere trabaje con el proyecto de Bizagi. Una vez que haya cumplido con lo descrito en el anterior artculo, se realiza lo siguiente: 1. Extraer los archivos usados por Bizagi hacia WebSphere. 2. Configurar las variables de entorno. Esto incluye las variables para el manejo del cach distribuido en una instalacin en clster. 3. Configurar los siguientes mdulos en WebSphere: Autenticacin Acceso a datos Servicio de mensajera (JMS) Libreras compartidas como un concepto de repositorio reutilizable Otros, tales como el Timeout de las transacciones y el usuario administrador por defecto Estos mdulos se configuran en WebSphere utilizando su Consola de administracin, y utilizan a su vez

Copyright 2013 - Bizagi

2455

los archivos de Bizagi que se extraen en el primer paso. Despus de estos pasos, su instancia de WebSphere estar configurado para que los Procesos de Bizagi se desplieguen en una aplicacin JEE (el Portal de Trabajo).

Procedimiento
Los siguientes pasos describen a detalle cmo configurar y editar las preferencias de una instalacin de WebSphere por defecto. Nota Realice la configuracin como se indica a continuacin, teniendo en cuenta que los nombres usados son sensibles a maysculas.

1. Extraer los archivos usados por Bizagi hacia WebSphere

En este paso, se incluyen archivos usados por Bizagi en la instancia de WebSphere (son archivos que no vienen por defecto en la instalacin limpia). Para ello, debe contar con el archivo de distribucin que entrega Bizagi ( B izA g i-ear-W eb sp h ered ist.zip). Este paso que contempla ubicar los archivos de configuracin de Bizagi, deber hacerlo para cada nodo que haga parte del clster.

1.1 Extraer el contenido de este .zip hacia una ruta local. Esta ruta ser referenciada como < P A TH _CO N F IGURA TIO N _F ILES> a partir de este momento. 1.2 Copiar las libreras para el modulo de Autenticacin ( B izA g i.W eb Sp h ere.Secu rity .jar, B izag iRem o te-1.0.jar, B izA g i.Secu rity .Co m m o n -1.0.jar) que se entregan en los archivos de configuracin, desde esta ruta: <PATH_CONFIGURATION_FILES>\security\ Hacia el repositorio de las libreras de WebSphere en: <WAS_HOME>\lib\ext\ 1.3 Copiar la librera que se utiliza para el registro de logs llamada lo g 4j-1.2.8.jar que se entrega en los archivos de configuracin. Copiarla de esta ruta: <PATH_CONFIGURATION_FILES>\configuration\ Hacia el repositorio de las libreras de WebSphere en: <WAS_HOME>\lib\ext\ 1.4 Si utiliza una Base de datos Oracle, edite el archivo de configuracin w eb .co n fig .x m l ubicado en <PATH_CONFIGURATION_FILES>\JiNET\config\, de manera que la llave P RO VIDERTY P E apunte al uso de Oracle:

2456

Copyright 2013 - Bizagi

1.5 Copiar las libreras que se utilizan para el acceso a datos, que son: la librera b izag i-jd b c-d riv er2.0.3.jar y la librera eclip selin k-2.1.0.jar (que se usa para la persistencia de datos) y que se entregan en los archivos de configuracin. Copiarlas de esta ruta: <PATH_CONFIGURATION_FILES>\configuration\ Hacia el repositorio de las libreras de WebSphere en: <WAS_HOME>\lib\ext\

2. Configurar las variables de entorno

Para configurar las variables que sern referenciadas como parmetros de ejecucin en el Servidor, primero inicie el servicio de su instancia de WebSphere. Seguidamente, acceda a la Consola de administracin. Nota Ntese que cuando se realizan cambios a travs de la Consola de administracin, deber guardarlos en la configuracin maestra. Para ello, se usa el enlace de Guardar (Save) que persiste los cambios. Este enlace aparecer en la parte superior siempre que se haya dado clic en O K o en Aplicar ( A p p ly).

Vaya a la seccin de administracin del sistema ( Sy stem ad m in istratio n ) y expndala para ubicar el DM ( Dep lo y m en t M an ag er. Ubique la seccin de Infraestructura del servidor ( Serv er In frastru ctu re) , localizada en la segunda columna. En ella, expanda el item Jav a an d P ro cess M an ag em en t y de clic sobre la definicin de Procesos ( P ro cess d efin itio n ).

Copyright 2013 - Bizagi

2457

De clic sobre el enlace de la configuracin de mquina virtual de Java ( Jav a Virtu al M ach in e), ubicada en la seccin de Propiedades adicionales ( A d d itio n al P ro p erties ).

Ingrese los siguientes valores para las variables y propiedades como se ensea a continuacin: In itial h eap size (tamao inicial de pila de memoria): Por defecto es 256. Se recomienda usar: 768 M ax im u m h eap size (tamao mximo de pila de memoria): 1024

De clic en O K y luego en Guardar ( Sav e) para aplicar los cambios.

Vaya a la seccin de Servidores ( Serv ers) y expndala para ubicar los tipos de Servidores ( Serv er

2458

Copyright 2013 - Bizagi

Ty p es). Expanda esta seccin y de clic sobre W eb Sp h ere ap p licatio n serv ers. All aparecern los nodos que hacen parte de su clster.

Ahora vamos a configurar las variables de entorno para todos los nodos. Por lo tanto, los siguientes pasos de configuracin deber repetirlos para cada nodo que hace parte de su clster. Para esta configuracin, haga clic sobre cada nodo. Al seleccionar un nodo, navegue hacia la seccin de Infraestructura del servidor ( Serv er In frastru ctu re) , localizada en la segunda columna. En ella, expanda el item Jav a an d P ro cess M an ag em en t y de clic sobre la definicin de Procesos ( P ro cess d efin itio n ).

Navegue hacia el enlace Jav a Virtu al M ach in e (ubicado en las propiedades adicionales -- A d d itio n al P ro p erties--). Ingrese los siguientes valores para las variables y propiedades como se ensea a continuacin:

Copyright 2013 - Bizagi

2459

Initial heap size (tamao inicial de pila de memoria): Por defecto es 256. Se recomienda usar: 768 Maximum heap size (tamao mximo de pila de memoria): 1024 Generic JVM arguments (argumentos genricos de la mquina virtual de Java): -DiNET_HOME=<PATH_CONFIGURATION_FILES>\JiNET -Duser.language=en Duser.country=us -Dfile.encoding=UTF-8 Ntese que deber reemplazar <PATH_CONFIGURATION_FILES> con la ruta correspondiente en su instalacin. Tenga en cuenta que en Sistemas operativos Linux, debe utilizar el caracter de separacin de carpetas apropiado (en vez del "\"). De clic en O K y luego en Guardar ( Sav e) para aplicar los cambios.

Haga clic sobre el enlace de propiedades personalizadas ( Cu sto m p ro p erties). A continuacin, se deben crear las siguientes propiedades: A P P _SERVER: Propiedad usada internamente por Bizagi para manejo acorde al servidor JEE. b izag i.cach e.m u lticast.en ab led : Propiedad booleano para habilitar el manejo del cach distribuido. b izag i.cach e.m u lticast.ad d ress: Propiedad de tipo cadena (string) que permite especificar la direccin IP de broadcast para la sincronizacin en los diferentes nodos. Por defecto se toma 224.2.2.3. b izag i.cach e.m u lticast.p o rt: Propiedad de tipo numrico para especificar el puerto sobre el cul se lleva a cabo la sincronizacin en los diferentes nodos. Por defecto se toma 7777. b izag i.cach e.m u lticast.ty p e: Propiedad de tipo cadena (string) que permite especificar el protocolo que se usa para la sincronizacin. Los valores permitidos son UDP (valor por defecto) y DB. Para crear estas propiedades, de clic sobre el botn de Nuevo ( N ew ) para registrar una propiedad personalizada. Nombre esta propiedad con: APP_SERVER, y especifique para su valor: WEBSPHERE.

2460

Copyright 2013 - Bizagi

De clic en O k y despus nuevamente sobre el botn de Nuevo ( N ew ) para registrar otra propiedad personalizada. Nombre esta propiedad como: bizagi.cache.multicast.enabled, y especifique para su valor: true. De clic en O k y despus nuevamente sobre el botn de Nuevo ( N ew ) para registrar otra propiedad personalizada. Nombre esta propiedad como: bizagi.cache.multicast.address, y especifique la direccin IP. De clic en O k y despus nuevamente sobre el botn de Nuevo ( N ew ) para registrar otra propiedad personalizada. Nombre esta propiedad como: bizagi.cache.multicast.port, y asigne el puerto. De clic en O k y despus nuevamente sobre el botn de Nuevo ( N ew ) para registrar otra propiedad personalizada. Nombre esta propiedad como: bizagi.cache.multicast.type, y especifique para su valor: UDP.

De clic en O K y luego en Guardar ( Sav e) para aplicar los cambios. Recuerde que estos ltimos pasos deber hacerlos para cada nodo que hace parte de su clster. Al finalizar con la totalidad de los nodos, reinicie el servicio.

3. Configurar los mdulos de WebSphere

Se deben configurar algunos mdulos en WebSphere a travs de la Consola de administracin, como se indica a continuacin.

Copyright 2013 - Bizagi

2461

3.1 Autenticacin Acceda a la Consola de administracin, y vaya a la seccin de Seguridad ( Secu rity ) y de expanda el item de Seguridad global ( Glo b al Secu rity). Seleccione la casilla de Habilitar la seguridad a nivel de aplicacin ( En ab le ap p licatio n secu rity) y de clic sobre Aplicar ( A p p ly ).

De clic sobre Dominios de seguridad ( Secu rity d o m ain s) , en la misma seccin de Seguridad ( Secu rity ). De clic sobre el botn Co p y Glo b al Secu rity .. para registrar un dominio de seguridad.

Ingrese BizagiDomain en el Nombre ( N am e) del nuevo dominio:

2462

Copyright 2013 - Bizagi

De clic en O K. De clic sobre el dominio recin creado ( B izag iDo m ain ), que aparecer listado:

En sus propiedades, asegrese de marcar la casilla que del scope que incluye el clster (debe visualizarse bajo Clu sters como [ N o m b re_cl ster]). Realice esto expandiendo los items necesarios en en la seccin de los scopes asignados ( A ssig n ed Sco p e):

Copyright 2013 - Bizagi

2463

En la seccin de atributos de seguridad ( Secu rity A ttrib u tes): Expanda el item de Seguridad a nivel de aplicacin ( A p p licatio n Secu rity). Revise que la casilla ( En ab led ap p licatio n secu rity ) est marcada (para el valor de Personalizar este dominio -Cu sto m ize th is d o m ain --). Expanda el item de logins de JAAS ( JA A S Sy stem lo g in s), y de clic sobre el enlace de logins del sistema ( Sy stem lo g in s), nuevamente para el valor de Use g lo b al an d d o m ain -sp ecific lo g in s.

2464

Copyright 2013 - Bizagi

Copyright 2013 - Bizagi

2465

Para esta definicin, haga clic en W EB _IN B O UN D:

Haga clic en Nuevo ( N ew ) para crear un login de JAAS. Asegrese de especificar: M o d u le class n am e: com.bizagi.security.jaas.BizAgiLoginModule. A u th en ticatio n strateg y (Estrategia de autenticacin): REQUIRED

2466

Copyright 2013 - Bizagi

De clic en O K. Ntese que el nuevo mdulo ser listado dentro de los mdulos usados bajo cierto orden predeterminado. De clic sobre el botn de Determinar el orden ( Set o rd er... ) para una reordenacin. A travs de esta opcin, asegrese de listar este nuevo mdulo de primero en la lista (utilizando el botn de Mover hacia arriba -- M o v e u p--).

Copyright 2013 - Bizagi

2467

De clic en O K, y revise que B izA g iLo g in M o d u le sea el primero de los mdulos de W EB _IN B O UN D (module order = 1).

2468

Copyright 2013 - Bizagi

Finalmente, de clic en Guardad ( Sav e) para persistir los cambios. En este punto el Servidor requiere de un reinicio.

3.2 Acceso a datos Antes de continuar, tenga en cuenta que si utiliza una base de datos SQL Server, deber requerir que el servicio no se inicie bajo un puerto dinmico. Se requiere que se use un puerto TCP/IP explcitamente (p.e el 1433 que es el usado por defecto).

Copyright 2013 - Bizagi

2469

Para la siguiente configuracin, acceda la Consola de administracin y realice los siguientes pasos. Ntese que para algunos de ellos, debe tener a la mano los valores de acuerdo a su motor de Base de datos (Oracle o SQL Server). Primero, vamos a registrar un Proveedor de datos JDBC. Para ello, vaya a la seccin de recursos ( Reso u rces) y expanda el item JDB C. De clic sobre los Proveedores JDBC ( JDB C P ro v id ers). Asegrese de seleccionar el scope que incluye el clster (debe listarse como Clu ster= [N o m b re_cl ster]).

2470

Copyright 2013 - Bizagi

Cree un Provider haciendo clic sobre el botn Nuevo ( N ew ). En la configuracin del nuevo Proveedor (que se realiza a travs de 3 pasos asistidos), ingrese la informacin correspondiente a su motor de Base de datos. Para Oracle: Database type (tipo de Base de datos): Oracle Provider type (tipo de Proveedor de datos): Oracle JDBC Driver Implementation type (tipo de implementacin): Connection pool data source Name (Nombre): Oracle JDBC Driver

o o o o

Copyright 2013 - Bizagi

2471

De clic en Siguiente ( N ex t) y especifique la ruta completa al driver de conexin de Oracle ( o jd b c): Ntese que debe renombrar el archivo o jd b c , para que no se incluya la versin menor especfica dentro de su nombre (debe quedar como ojdbc6.jar), de manera que se refencie por este nombre genrico y WebSphere lo encuentre.

2472

Copyright 2013 - Bizagi

De clic en Siguiente ( N ex t) y revise la informacin de resumen. De clic sobre Finalizar ( F in ish ). Para SQL Server: o Database type (tipo de Base de datos): User-defined o Implementation class name (Nombre de la clase de la implementacin): com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource o Name (Nombre): SQLServerProvider

Copyright 2013 - Bizagi

2473

De clic en Siguiente ( N ex t) y especifique la ruta completa hacia el driver de conexin de SQL Server ( sq ljd b c). Ntese que este .jar est contenido en los archivos de configuracin de Bizagi, dentro de < P A TH _CO N F IGURA TIO N _F ILES>.

2474

Copyright 2013 - Bizagi

De clic en Siguiente ( N ex t) y revise la informacin de resumen. De clic sobre Finalizar ( F in ish ). Una vez se haya creado el Proveedor, ste aparecer listado en la tabla (sea Oracle o SQL Server). Tenga en cuenta que debe dar clic sobre Guardar ( Sav e) para aplicar los cambios en la configuracin maestra.

Ahora vamos a crear y registrar una fuente de datos para la conexin a la Base de datos del proyecto. Para ello, ubique el panel a la izquiera para ir rpidamente al enlace de Fuentes de datos ( Data so u rces), ubicado todava bajo la seccin de recursos ( Reso u rces) sobre el item JDB C. Asegrese de seleccionar el scope que incluye el clster (debe listarse como Clu ster= [N o m b re_cl ster]).

Copyright 2013 - Bizagi

2475

Cree una fuente de datos haciendo clic sobre el botn Nuevo ( N ew ). En la configuracin de la nueva fuente de datos, ingrese la siguiente informacin: Data source name (nombre de la fuente de datos): BizAgiJava JNDI name (nombre JNDI): BizAgiJava

De clic en Siguiente ( N ex t) y marque la opcin de seleccionar un Proveedor JDBC existente ( Select an ex istin g JDB C P ro v id er). De esta manera, seleccione el Proveedor de acuerdo a su motor de Base de datos (Oracle o SQL Server, tal como se cre el Proveedor previamente).

2476

Copyright 2013 - Bizagi

Si usted utiliza una Base de datos SQL Server de clic en Siguiente ( N ex t) en las ventanas a continuacin (hasta que se llegue al final de los pasos asistidos, donde se debe dar clic en Finalizar -- F in ish -- para crear la fuente de datos). No se requiere configuracin adicional para esta fuente de datos en Bizagi cuando se utiliza SQL Server, e igualmente se pueden mantener los valores por defecto de WebSphere. Si usted utiliza una Base de datos Oracle, de clic en Siguiente ( N ex t) y asegrese de: editar la URL de la cadena de conexin y de seleccionar Oracle data store helper para la configuracin del Data Sto re h elp er class n am e. Para el valor de la URL, ingrese la informacin de conexin a su instancia de Oracle. Esta conexin debe tener el siguiente formato: jdbc:oracle:thin:@[database_server]:[port_number]:[service_name] Considere: o database_server: El Servidor de Base de datos. Puede utilizar el SID en cambio. o port_number: El puerto bajo el cual el servicio de la Base de datos atiende. En Oracle por defecto, es el puerto 1521. o service_name: El nombre del servicio de la instancia Oracle.

Copyright 2013 - Bizagi

2477

Una vez que haya configurado la conexin a su instancia, de clic en Siguiente ( N ex t ) en las ventanas a continuacin (hasta que se llegue al final de los pasos asistidos, donde se debe dar clic en Finalizar -F in ish -- para crear la fuente de datos).

De clic sobre la fuente de datos creada B izA g iJav a para configurar las propiedades adicionales, la cul aparecer listada en la tabla sea Oracle o SQL Server. De clic en el enlace de propiedades personalizadas ( Cu sto m p ro p erties) ubicado en la seccin de Propiedades adicionales ( A d d itio n al P ro p erties).

Edite las propiedades como se describe a continuacin (de acuerdo a su motor de Base de datos), y asigne los valores correspondientes de la conexin. Para Oracle: o webSphereDefaultIsolationLevel: Asgnelo a 2. Este valor indicar un nivel llamado REA DCO M M ITTED. Adicional, cree 2 nuevas propiedades: usuario ( u ser) y contrasea ( p assw o rd). Para sus valores considere: o user: El esquema de usuario que representa el proyecto Bizagi.

2478

Copyright 2013 - Bizagi

o password: La contrasea de ese esquema de usuario.

Para SQL Server: o serverName: El nombre del Servidor de Base de datos. o portNumber: El puerto bajo el cual la instancia atiende. En SQL Server y por defecto, es el puerto 1433. o webSphereDefaultIsolationLevel: Asgnelo a 1. Este valor indicar un nivel REA D-UN CO M M ITTED. o databaseName: El nombre de la Base de datos que corresponde al proyecto. o user: La cuenta login para acceder a la Base de datos. o password: La contrasea de esa cuenta login.

Copyright 2013 - Bizagi

2479

Despus de editar estas propiedades, asegrese de dar clic en Guardar ( Sav e) para aplicar los cambios. Una vez se haya configurado la fuente de datos, puede dar clic directamente sobre ella ( B izA g iJav a) para ir a la ventana anterior y utilizar la opcin de verificar la conexin ( Test co n n ectio n ): 3.3 Servicio de mensajera (JMS) En los siguientes pasos configuraremos un Servidor JMS que es utilizado por Bizagi para ejecutar Actividades Asncronas. En la configuracin de clster, es muy importante crear tambin un recurso adicional que se encarga del manejo de la memoria cach sin afectar recursos o desempeo involucrado en las dems tareas ( M en sajera p ara el m an ejo d e cach ). Para crear los recursos involucrados, acceda la Consola de administracin y vaya a la seccin de Integracin del servicio ( Serv ice in teg ratio n ) y de clic sobre B u ses.

2480

Copyright 2013 - Bizagi

Bus de integracin del servicio De clic sobre Nuevo ( N ew ) para crear un bus que permita la activacin de los servicios de mensajera. Ingrese BizAgiBus como su nombre ( N am e), y asegrese de desmarcar la casilla de Seguridad a nivel de Bus (B u s secu rity).

De clic en Siguiente ( N ex t), y luego en Finalizar ( F in ish ) para crear el bus.

Copyright 2013 - Bizagi

2481

De clic sobre el bus recientemente creado ( B izA g iB u s) y luego de clic sobre el enlace de Miembros del Bus ( B u s m em b ers) en la seccin de Topologa ( To p o lo g y).

Asocie la instancia del servidor como miembro, haciendo clic en Adicionar ( A d d ). En el nuevo miembro del bus, asegrese de habilitar Cluster y seleccionar de la lista, el nombre de su clster.

2482

Copyright 2013 - Bizagi

De clic en Siguiente ( N ex t). Marque la casilla de Enable Messaging engine policy assitance? y seleccione Scalability with high availability como el tipo de poltica a utilizar ( p o licy ty p e).

De clic en Siguiente ( N ex t). Seleccione File store como el tipo de almacenamiento de mensajera a utilizar y de clic en Siguiente ( N ex t).

Copyright 2013 - Bizagi

2483

Ntese que aparece el listado de motores de mensajera que se crean por defecto, y que no estn configurados an ( Is th e m essag e sto re co n fig u red = No). De clic sobre el nombre ( N am e) del motor de mensajera para configurarlo (y deber repetir el paso para configurar cada motor).

Para configurar cada motor de mensajera, conserve los valores por defecto para las propiedades, pero asegrese de ingresar: Log directory path: El directorio donde quedan los logs asociados al nodo. Debe referenciar <WAS_HOME>\profiles\<NODE_NAME>\logs Permanent store directory path: El directorio donde queda el almacen de archivo. Debe referenciar <WAS_HOME>\profiles\<NODE_NAME>\filestores

2484

Copyright 2013 - Bizagi

De clic en Siguiente ( N ex t). Recuerde repetir este paso para el otro motor de mensajera, y despus revisar que los dos hayan quedado configurados ( Is th e m essag e sto re co n fig u red = Yes). Configure el uso de memoria. Se recomienda incrementar la memoria sugerida por defecto a los siguientes valores: Initial JVM heap size: 768 Maximum JVM heap size: 1024 Adicionalmente, marque la casilla Ch an g e h eap size y de clic en Siguiente ( N ex t) . Verifique en el resumen de la configuracin que la informacin sea la correcta y de clic en Finalizar ( F in ish ) . Asegrese de dar clic en Guardar ( Sav e) para aplicar los cambios.

Recursos destino De vuelta en la informacin del bus, de clic sobre el enlace de Destinos ( Destin atio n s), ubicado bajo la seccin de los recursos destino ( Destin atio n reso u rces ) para crear y asociar una cola (queue).

Copyright 2013 - Bizagi

2485

De clic en Nuevo ( N ew ) para crear la cola ( d estin atio n ty p e = Q u eu e).

De clic en Siguiente ( N ex t) e ingrese BizagiQueue como identificador ( id en tifier) de la cola. Ingrese una descripcin tambin.

2486

Copyright 2013 - Bizagi

De clic en Siguiente ( N ex t) y asegrese de seleccionar el miembro de bus como se configur anteriormente (para incluir la configuracin que abarca el clster):

De clic en Siguiente ( N ex t ) y luego en Finalizar ( F in ish ) para registrar el destino. Esta informacin aparecer listada en la tabla de recursos destino.

Copyright 2013 - Bizagi

2487

De clic sobre la cola recin creada ( B izA g iQ u eu e) para editar su configuracin de reintentos. En el detalle de la cola, edite el nmero mximo de intentos fallidos del mensaje ( M ax im u m failed d eliv eries p er m essag e), para que tenga un valor igual a 1 (el Servidor de Aplicaciones hara un reintento para las Actividades Asncronas a nivel de colas, lo cual quiere decir que se respetara la configuracin de reintentos de la Asncrona en Bizagi).

2488

Copyright 2013 - Bizagi

De clic en O K. Recuerde dar clic en Guardar ( Sav e) para aplicar los cambios igualmente. Fbrica de conexiones JMS Ahora crearemos una Fbrica de conexiones para JMS. Navegue a la seccin de Recursos ( Reso u rces) y expanda el item JM S. De clic sobre Q u eu e Co n n ectio n facto ries. Asegrese de seleccionar el scope que incluye el clster (debe listarse como Clu ster= [N o m b re_cl ster]) y de clic en Nuevo ( N ew ) para crear una fbrica de conexin de colas (Queue Connection factory).

Copyright 2013 - Bizagi

2489

Para el nuevo recurso, mantenga el Proveedor de mensajera por defecto: Default messaging provider, y de clic en O K.

Esto nos lleva a definir las propiedades principales de la nueva fbrica de conexiones. Ingrese AsyncControllerFactory tanto para el Nombre ( N am e) como para el Nombre JNDI ( JN DI N am e). Asegrese de seleccionar el bus creado para Bizagi ( B izA g iB u s).

2490

Copyright 2013 - Bizagi

De clic en O k. De clic en la Fbrica creada recin A sy n cCo n tro llerF acto ry (la cual aparecer listada en la tabla), para editar el parmetro de timeout de la conexin.

Copyright 2013 - Bizagi

2491

De clic en las propiedades del Pool de conexiones ( Co n n ectio n p o o l p ro p erties) ubicado bajo la seccin de Propiedades adicionales (A d d itio n al P ro p erties). Asigne el timeout de la conexin ( Co n n ectio n tim eo u t) a 120 segundos y de clic en O K.

2492

Copyright 2013 - Bizagi

Recuerde guardar (dar clic en Sav e) para aplicar los cambios. Recurso de colas Ahora crearemos un recurso de colas. Para hacerlo, ubique el panel a la izquierda para seleccionar rpidamente el enlace de colas ( Q u eu es) , ubicado en la seccin de recursos ( Reso u rces) bajo el item JM S. Asegrese de seleccionar el scope que incluye el clster (debe listarse como Clu ster= [N o m b re_cl ster]). De clic en Nuevo ( N ew ) para crear este recurso. Mantenga el Proveedor de mensajera por defecto: Default messaging provider y de clic en O K.

Copyright 2013 - Bizagi

2493

Ingrese la siguiente informacin para el recurso de colas : Name (Nombre): AsyncController JNDI Name (Nombre JNDI): jms/AsyncController Bus name (Nombre del bus): seleccione el bus para Bizagi: BizAgiBus . Queue name (Nombre de la cola): seleccione la cola creada anteriormente: BizAgiQueue .

De clic en O K y luego en Guardar ( Sav e) para aplicar los cambios.

2494

Copyright 2013 - Bizagi

Ahora crearemos otro recurso para la especificacin de las activaciones (Activation specification). Para hacerlo, ubique el panel a la izquierda para seleccionar rpidamente el enlace A ctiv atio n sp ecificatio n s , ubicado en la seccin de recursos ( Reso u rces) bajo el item JM S. Asegrese de seleccionar el scope que incluye el clster (debe listarse como Clu ster= [N o m b re_cl ster]). De clic en Nuevo ( N ew ) para crear este recurso. Mantenga el Proveedor de mensajera por defecto: Default messaging provider y de clic en O K.

Ingrese el siguiente detalle para la especificacin: Name (Nombre): AsyncControllerActivationSpec JNDI Name (Nombre JNDI) : eis/AsyncControllerActivationSpec Destination type (tipo de destino): seleccione cola: Queue Destination JNDI Name (Nombre JNDI del destino): jms/AsyncController

Copyright 2013 - Bizagi

2495

Bus name (Nombre del bus): seleccione el bus creado para Bizagi: BizAgiBus

De clic en O K y luego en Guardar ( Sav e) para aplicar los cambios. Mensajera para el manejo de cach La capa de acceso a datos de Bizagi est basada en el framework JPA (Java Persistence API). En el manejo de esta capa Bizagi utiliza EclipseLink y se involucra una optimizacin en cach orientada a mejorar el desempeo de las aplicaciones. Es importante que este cach est replicado en todos los nodos que hacen parte de un clster, para lo cual se crea una Fbrica de tpicos y un tpico. Ubique el panel a la izquierda para seleccionar rpidamente la opcin To p ic Co n n ectio n facto ries , ubicada en la seccin de recursos ( Reso u rces) bajo el item JM S. Asegrese de seleccionar el scope que incluye el clster (debe listarse como Clu ster= [N o m b re_cl ster]). De clic en Nuevo ( N ew ) para crear este recurso. Mantenga el Proveedor de mensajera por defecto: Default messaging provider y de clic en O K.

Ingrese el siguiente detalle para la especificacin: Name (Nombre): EclipseLinkTopicConnectionFactory

2496

Copyright 2013 - Bizagi

JNDI Name (Nombre JNDI) : jms/EclipseLinkTopicConnectionFactory Bus name (Nombre del bus): seleccione el bus creado para Bizagi: BizAgiBus

De clic en O K. Para crear el tpico, ubique el panel a la izquierda para seleccionar rpidamente la opcin Tpico ( To p ics) , ubicada en la seccin de recursos ( Reso u rces) bajo el item JM S. Asegrese de seleccionar el scope que incluye el clster (debe listarse como Clu ster= [N o m b re_cl ster]). De clic en Nuevo ( N ew ) para crear este recurso. Mantenga el Proveedor de mensajera por defecto: Default messaging provider y de clic en O K.

Ingrese el siguiente detalle para la especificacin: Name (Nombre): EclipseLinkTopic JNDI Name (Nombre JNDI) : jms/EclipseLinkTopic Topic Name (Nombre del tpico): EclipseLinkTopic Bus name (Nombre del bus): seleccione el bus creado para Bizagi: BizAgiBus Topic space (Nombre de espacio al que pertenece el tpico: Default.Topic.Space JMS delivery modo (Modo de entrega): Nonpersistent

Copyright 2013 - Bizagi

2497

De clic en O K y luego en Guardar ( Sav e) para aplicar los cambios. 3.4 Libreras compartidas como un concepto de repositorio reutilizable Configure el concepto de libreras compartidas en WebSphere para que el despliegue de la aplicacin de Bizagi sea ms rpido y se tenga la opcin de utilizar libreras que potencialmente se usen por otros aplicativos. Para ello, navegue a la seccin del Entorno ( En v iro n m en t) y de clic sobre Libreras compartidas ( Sh ared lib raries). Asegrese de seleccionar el scope que incluye el clster (debe listarse como Clu ster= [N o m b re_cl ster]). De clic en Nuevo ( N ew ) para registrar las libreras compatidas. Tenga en cuenta que este paso se repite para registrar 3 libreras: BizagiLibs-ear BizagiLibs-war Eclipselink.jar Para la primera librera compartida, ingrese el siguiente detalle para la especificacin: Name (Nombre): BizagiLibs-ear Classpath: <PATH_CONFIGURATION_FILES>/libs/earLib Ntese que <PATH_CONFIGURATION_FILES> hace referencia a la ruta donde se encuentran los archivos de configuracin de Bizagi.

2498

Copyright 2013 - Bizagi

De clic en O k y repita este paso para crear otra librera compartida. Para la segunda, ingrese el siguiente detalle para la especificacin: Name (Nombre): BizagiLibs-war Classpath: <PATH_CONFIGURATION_FILES>/libs/warLib Ntese que < P A TH _CO N F IGURA TIO N _F ILES> hace referencia a la ruta donde se encuentran los archivos de configuracin de Bizagi. De clic en O k y repita nuevamente este paso para crear la tercer librera compartida. Para la tercera, ingrese el siguiente detalle para la especificacin: Name (Nombre): Eclipselink Classpath: <PATH_CONFIGURATION_FILES>/libs/elLib Ntese que < P A TH _CO N F IGURA TIO N _F ILES> hace referencia a la ruta donde se encuentran los archivos de configuracin de Bizagi. Adicionalmente, tenga presente que la librera de eclipselink tendr que referenciarse como eclipselink.jar (sin el detalle de la versin) y por lo tanto, el archivo .jar fsicamente debe ser renombrado para que no incluya la versin. Nota Si usted utiliza Oracle como la Base de datos de Bizagi, deber asegurase de tener en la ruta del Classpath la siguiente librera: xmlparserv2.jar (12g) Esta librera se puede encontrar como parte de la distribucin O racle To p lin k. Las 3 libreras compartidas saldrn listadas al finalizar este paso.

Copyright 2013 - Bizagi

2499

De clic en O K y luego en Guardar ( Sav e) para aplicar los cambios. 3.5 Timeout de las transacciones y usuario administrador por defecto Para definir el timeout de las transacciones, incrementamos la cantidad empleada por defecto para permitir transacciones de mayor duracin (p.e til en la sincronizacin de usuarios LDAP). Para hacerlo, acceda a la Consola de administracin y vaya a la seccin de Servidores ( Serv ers). Expanda el item tipos de servidores ( Serv er ty p es) y de clic sobre el enlace W eb Sp h ere A p p licatio n Serv ers. Asegrese de realizar estos cambios para los nodos de su clster. Expanda el item de Servicios del contenedor ( Co n tain er Serv ices) bajo la seccin de Configuracin del contenedor ( Co n tain er settin g s), y de clic sobre Servicio de la transaccin ( Tran sactio n serv ice).

2500

Copyright 2013 - Bizagi

Edite las propiedades: Tiempo de espera del ciclo de la transaccin total ( To tal tran sactio n lifetim e tim eo u t) y Tiempo de espera mximo de la transaccin ( M ax im u m tran sactio n tim eo u t). Asigne 3600 segundos a ambas propiedades.

De clic en O K y luego en Guardar ( Sav e) para aplicar los cambios. Usuario administrador La configuracin del usuario administrador por defecto de Bizagi se realiza estrictamente para el usuario llamado ad m o n del dominio por defecto llamado d o m ain . Para la configuracin de este usuario, acceda la Consola de administracin y vaya a la seccin de Usuarios y grupos ( Users an d g ro u p s) , y de clic sobre el enlace de Administrar usuarios ( M an ag e u sers ).

Copyright 2013 - Bizagi

2501

De clic en el botn de crear ( Create... ) para registrar el usuario administrador por defecto. Ingrese la siguiente informacin: User ID (id de usuario): domain\admon First name (nombre): BizAgi Last name (apellido): BizAgi Password (contrasea): Ingrese el password de su preferencia.

De clic sobre Crear ( Create). WebSphere notificar que la operacin ha sido exitosa, y podr hacer clic sobre Cerrar ( Clo se). En este punto su WebSphere deber ser reiniciado. Una vez que complete estos pasos, consulte la Configuracin de el Scheduler en WebSphere.

2502

Copyright 2013 - Bizagi

Escalamiento
En cualquier momento que se desee escalar la solucin (agregar ms nodos de manera horizontal o vertical al clster), puede hacerlo asegurndose de: crear el perfil de tipo custom en el nodo, y agregarlo al clster. Deber cerciorarse tambin de incluir los archivos de configuracin de Bizagi en el nuevo nodo y llevar a cabo los pasos que apliquen a nivel de nodo. En resumen, al ingresar un nuevo nodo debe: 1. Crear el perfil custom para ese nodo. 2. Agregar el nodo al clster. 3. Copiar los archivos de configuracin de Bizagi hacia el nuevo nodo (paso 1 del procedimiento). 4. Configurar las variables de entorno para ese nodo (paso 2 del procedimiento). Adicional a lo anterior, debe asegurarse de que el nodo quede registrado en el balanceador de cargas. Esto puede implicar actualizar cambios a nivel del Servidor de Aplicaciones, como por ejemplo en WebSphere como se indica en Configurar el balanceo de cargas.
7.4.1.1.1.3 Configuracin del Scheduler en WebSphere

Introduccin
Para ambientes de alta disponibilidad donde se tiene Bizagi en un ambiente de clster, Bizagi ofrece la posibilidad de configurar su servicio de Scheduler (programador) de manera que se tenga un esquema de: Tolerancia a fallos en el programador (para que ste se pueda ejecutar sobre cualquier nodo de la solucin). Administracin del programador para que se pueda detener, iniciar o reiniciar el servicio de manera independiente en cualquier momento.

Prerequisitos
Para configurar del servicio de Scheduler de WebSphere asegrese de cumplir con los siguientes prerequisitos: Se debe haber configurado la solucin de Bizagi en WebSphere. Para ms informacin sobre ello, consulte Configuracin en clster de WebSphere. Tenga a la mano los archivos de configuracin (y de despliegue) requeridos por Bizagi (BizAgi-earWebsphere-dist.zip). Estos archivos deben haber sido descomprimidos en los pasos de configuracin de WebSphere y ubicados en una ruta que ser referenciada como <PATH_CONFIGURATION_FILES> en este artculo.

Configuracin
Ubique la siguiente ruta local: <PATH_CONFIGURATION_FILES>/BizagiSchedulerService/ 1. En esa ruta, configure el archivo de propiedades scheduler_configuration.properties Para ello, considere: bizagi.scheduler.timer: Propiedad utilizada para indicar al temporizador el intervalo de tiempo en

Copyright 2013 - Bizagi

2503

el cual debe ser ejecutado el scheduler de Bizagi. Por defecto el valor asignado es de 30 Segundos. bizagi.scheduler.connection.port: Nmero de puerto asignado al servicio por el cual sern recibidas las peticiones. Por defecto el valor asignado es 5681. bizagi.scheduler.remote.connection.retries: Propiedad que define en caso de presentarse un problema de conexin, el nmero de reintentos mximo para establecer una comunicacin con el servidor de aplicaciones. Por defecto el valor asignado es 3.

2. Copie las libreras cliente para EJB en la ruta <PATH_CONFIGURATION_FILES>/ BizagiSchedulerService/lib/ext/ Estas se encuentran en la ruta de instalacin del servidor de aplicaciones: <WAS_HOME>/runtimes/com.ibm.ws.ejb.thinclient_[VERSION].jar <WAS_HOME>/runtimes/com.ibm.ws.orb_[VERSION].jar

3. Configure el archivo de propiedades custom_jndi.properties: java.naming.factory.initial: Propiedad de uso exclusivo de Bizagi que define el contexto del componente cliente que ser utilizado para establecer comunicacin con el servidor de aplicaciones WebSphere. El valor asignado a esta propiedad es: com.ibm.websphere.naming.WsnInitialContextFactory java.naming.provider.url: Propiedad configurable en la cual se especifica el nombre o direccin IP del servidor de aplicaciones. El valor asignado debe cumplir con el siguiente formato: o Configuracin para un ambiente distribuido, clster horizontal: Se define la lista de servidores que hacen parte del cluster con su respectivo puerto. corbaloc:iiop:[SERVER_NAME1]:[PORT1],:[SERVER_NAME2]:[PORT2],: [SERVER_NAME3]:[PORT3] o Configuracin para un ambiente distribuido, clster vertical: Se utiliza el mismo nombre de servidor y simplemente cambia el nmero de puerto que le fue asignado a cada nodo virtual. corbaloc:iiop:[SERVER_NAME]:[PORT1],:[SERVER_NAME]:[PORT2],: [SERVER_NAME]:[PORT3] java.naming.security.principal: Esta propiedad por defecto se encuentra deshabilitada (#). Si en el servidor de aplicaciones se configur seguridad a nivel de aplicacin para establecer comunicacin con componentes externos, se bebe especificar el nombre del usuario creado. java.naming.security.credentials: Esta propiedad por defecto se encuentra deshabilitada (#). Si en el servidor de aplicaciones se configur seguridad a nivel de aplicacin para establecer comunicacin con componentes externos, se bebe especificar la contrasea del usuario creado. ejb.remote.jndi: Propiedad de uso exclusivo de Bizagi en la cual se especifica la direccin (JNDI) utilizada para acceder al servicio remoto de Scheduler que se encuentra en el servidor de aplicaciones WebSphere. Se debe cambiar el token [CLUSTER_NAME] por el valor asignado durante la creacin del clster: cell/clusters/[CLUSTER_NAME]/ BizAgiSchedulerBean#com.vision.bizagi.scheduler.BizAgiSchedulerRemote

Operacin del servicio

Tenga presente que para la operacin del servicio deben estar correctamente definidas las variables de entorno: bizagi.cache.multicast.enabled, bizagi.cache.multicast.address,

2504

Copyright 2013 - Bizagi

bizagi.cache.multicast.port, y bizagi.cache.multicast.type (como se indica en la seccin de configuracin de variables de entorno para configurar WebSphere para trabajar en clster).

Para iniciar el servicio, ejecute el archivo start-service como usuario administrador. En Linux OS, este archivo ser: <PATH_CONFIGURATION_FILES>/BizagiSchedulerService/bin/start-service.sh En Windows, este archivo ser: <PATH_CONFIGURATION_FILES>\BizagiSchedulerService\bin\start-service.bat sta operacin crea un proceso javaw.exe el cual se mantiene en ejecucin utilizando el puerto (por defecto 5681) configurado en el archivo scheduler_configuration.properties.

Para detener el servicio, simplemente se debe ejecutar el archivo shutdown-service como usuario administrador. En Linux OS, este archivo ser: <PATH_CONFIGURATION_FILES>/BizagiSchedulerService/bin/shutdown-service.sh En Windows, este archivo ser: <PATH_CONFIGURATION_FILES>\BizagiSchedulerService\bin\shutdown-service.bat

Una vez que complete estos pasos, consulte la Configuracin de la arquitectura del sistema.
7.4.1.1.2 Configuracin estndar de WebSphere

Introduccin
Con la edicin Bizagi Enterprise JEE, sus Procesos se pueden montar sobre diferentes Servidores de Aplicacin JEE (p.e. WebSphere, WebLogic, o JBoss). El procedimiento de configuracin de cada Servidor de Aplicaciones para trabajar con Bizagi, vara ligeramente de acuerdo a las diferencias en s de cada uno de los servidores. Este artculo se enfoca en la configuracin de WebSphere para trabajar con Bizagi, dirigida a un ambiente de pruebas o de produccin y bajo una configuracin standalone (usando un nico servidor BPM y sin balanceo de cargas).

Copyright 2013 - Bizagi

2505

Si desea configurar WebSphere en un esquema de alta disponibilidad y con la posibilidad de balanceo de cargas, consulte la Configuracin en clster de WebSphere. Ntese que para el ambiente de desarrollo (con Bizagi Studio), no se requieren pasos de configuracin dado que la edicin de Bizagi Enterprise JEE instala una instancia de JBoss 7.1.1, el cual es embebido y configurado de manera automtica. Tenga en cuenta que lo recomendado es utilizar la instancia por defecto de JBoss en desarrollo, dado que se promueve la agilidad en la implementacin (JBoss es un Servidor ms ligero e inicia o reinicia ms rpido, y para su proyecto no requiere de configuracin adicional). Sin embargo, si su proyecto requiere estrictamente que se utilice WebSphere en el ambiente de desarrollo, siga los pasos a continuacin para ese ambiente tambin.

Prerequisitos
Para configurar su instancia de WebSphere en un ambiente de pruebas o produccin, se requiere: JDK 6, update 31 instalado. La variable de entorno JA VA _H O M E configurada previamente (se recomienda que sea en una ruta sin espacios). Tener a la mano los archivos de configuracin (y de despliegue) requeridos por Bizagi (BizAgi-earWebsphere-dist.zip). Tener instalado el Servidor WebSphere. Las versiones soportadas son las pertenecientes a WebSphere V7. WebSphere puede ser solicitado directamente desde la pgina oficial de IBM. Tenga presente que debe tener el instalador apropiado a su sistema, y que para su instalacin, debe seguir tanto los requisitos de WebSphere, como los lineamientos presentados en la siguiente seccin.

2506

Copyright 2013 - Bizagi

Requisitos de WebSphere
Para instalar WebSphere (una vez que haya cubierto todos los prerequisitos), asegrese de considerar lo siguiente: Instalar los componentes de Servidor de Aplicacin ( A p p licatio n Serv er) de WebSphere.

Habilitar la securidad administrativa ( A d m in istrativ e secu rity ), y definir un usuario y contrasea para la misma.

Copyright 2013 - Bizagi

2507

Una vez que haya instalado WebSphere Application Server, tenga presente que debe aplicar las ltimas actualizaciones y paquetes de mejoras (feature packs) del proveedor. Para hacerlo, recomendamos utilizar el Actualizador IBM Update Installer para WebSphere, y descargar igualmente los fixes ms recientes para su instancia de WebSphere Application Server V7.0 (esto es, instalar los paquetes de mantenimiento). La ruta de instalacin, que incluye la instancia del servidor creada ( serv er1), ser referenciada a partir de este momento como < W EB SP H ERE_H O M E> en este artculo.

Opciones de WebSphere
Para ms informacin acerca de como iniciar, detener o acceder a las opciones de administracin de la consola en WebSphere, consulte la informacin a continuacin.

Iniciar el Servidor (domain)

Para iniciar el servicio de WebSphere, ejecute el siguiente archivo desde una consola de comandos: En Linux: <WEBSPHERE_HOME>/profiles/AppSrv01/bin/startServer.sh server1 En Windows: <WEBSPHERE_HOME>\profiles\AppSrv01\bin\startServer.bat server1 Ntese que serv er1 es la instancia instalada por defecto de WebSphere Application Server.

2508

Copyright 2013 - Bizagi

Nota En sistemas operativos Windows, puede tambin optar por iniciar el servicio desde la opcin del menu (p.e. IB M W eb Sp h ere -> A p p licatio n Serv er V7.0 -> P ro files -> A p p Srv 01 -> Start th e Serv er).

Detener el Servidor (domain)

To stop WebSphere services, execute the following file in a command prompt: En Linux: <WEBSPHERE_HOME>/profiles/AppSrv01/bin/stopServer.sh server1 En Windows: <WEBSPHERE_HOME>\profiles\AppSrv01\bin\stopServer.bat server1 Ntese que serv er1 es la instancia instalada por defecto de WebSphere Application Server. Nota En sistemas operativos Windows, puede tambin optar por iniciar el servicio desde la opcin del menu (p.e. IB M W eb Sp h ere -> A p p licatio n Serv er V7.0 -> P ro files -> A p p Srv 01 -> Sto p th e Serv er).

Acceder a la Consola de administracin

Para acceder a la Consola de administracin de WebSphere, ingrese la siguiente URL en un navegador: https://localhost:9043/ibm/console/logon.jsp

Copyright 2013 - Bizagi

2509

Lo que debe hacer

Para la configuracin de WebSphere para trabajar con Bizagi, el siguiente procedimiento se lleva a cabo: 1. Extraer los archivos usados por Bizagi hacia WebSphere. 2. Configurar las variables de entorno. 3. Configurar los siguientes mdulos en WebSphere: Autenticacin Acceso a datos Servicio de mensajera (JMS) Otros, tales como el timeout en transacciones, y el usuario administrador por defecto Estos mdulos se configuran en WebSphere utilizando su Consola de administracin, y utilizan a su vez los archivos de Bizagi que se extraen en el primer paso. Despus de estos pasos, su instancia de WebSphere estar configurado para que los Procesos de Bizagi se desplieguen en una aplicacin JEE (el Portal de Trabajo).

Procedimiento
Los siguientes pasos describen a detalle cmo configurar y editar las preferencias de una instalacin de WebSphere por defecto. Nota

2510

Copyright 2013 - Bizagi

Realice la configuracin como se indica a continuacin, teniendo en cuenta que los nombres usados son sensibles a maysculas.

1. Extraer los archivos usados por Bizagi hacia WebSphere

En este paso, se incluyen archivos usados por Bizagi en la instancia de WebSphere (son archivos que no vienen por defecto en la instalacin limpia). Para ello, debe contar con el archivo de distribucin que entrega Bizagi ( B izA g i-ear-W eb sp h ered ist.zip). 1.1 Extraer el contenido de este .zip hacia una ruta local. Esta ruta ser referenciada como < P A TH _CO N F IGURA TIO N _F ILES> a partir de este momento. 1.2 Copiar las libreras para el modulo de Autenticacin ( B izA g i.W eb Sp h ere.Secu rity .jar, B izag iRem o te-1.0.jar, B izA g i.Secu rity .Co m m o n -1.0.jar) que se entregan en los archivos de configuracin, desde esta ruta: <PATH_CONFIGURATION_FILES>\security\ Hacia el repositorio de las libreras de WebSphere en: <WEBSPHERE_HOME>\lib\ext\ 1.3 Copiar la librera que se utiliza para el registro de logs llamada lo g 4j-1.2.8.jar y la librera eclip selin k-2.1.0.jar (que se usa para la persistencia de datos), que se entregan en los archivos de configuracin. Copiarlas de esta ruta: <PATH_CONFIGURATION_FILES>\configuration\ Hacia el repositorio de las libreras de WebSphere en: <WEBSPHERE_HOME>\lib\ext\ 1.4 Si utiliza una Base de datos Oracle, edite el archivo de configuracin w eb .co n fig .x m l ubicado en <PATH_CONFIGURATION_FILES>\JiNET\config\, de manera que la llave P RO VIDERTY P E apunte al uso de Oracle:

2. Configurar las variables de entorno

Para configurar las variables que sern referenciadas como parmetros de ejecucin en el Servidor, primero inicie el servicio de su instancia de WebSphere.

Copyright 2013 - Bizagi

2511

Seguidamente, acceda a la Consola de administracin. Nota Ntese que cuando se realizan cambios a travs de la Consola de administracin, deber guardarlos en la configuracin maestra. Para ello, se usa el enlace de Guardar (Save) que persiste los cambios. Este enlace aparecer en la parte superior siempre que se haya dado clic en OK o en Aplicar (Apply) . Vaya a la seccin de Servidores ( Serv ers) y expndala para ubicar los tipos de Servidores ( Serv er Ty p es). Expanda nuevamente esta seccin y de clic sobre W eb Sp h ere ap p licatio n serv ers. Haga clic sobre su instancia del Servidor, que por defecto es server1.

Ubique la seccin de Infraestructura del servidor ( Serv er In frastru ctu re) , localizada en la segunda columna. En ella, expanda el item Jav a an d P ro cess M an ag em en t y de clic sobre la definicin de Procesos ( P ro cess d efin itio n ).

2512

Copyright 2013 - Bizagi

De clic sobre el enlace de la configuracin de mquina virtual de Java ( Jav a Virtu al M ach in e), ubicada en la seccin de Propiedades adicionales ( A d d itio n al P ro p erties ).

Ingrese los siguientes valores para las variables y propiedades como se ensea a continuacin: I n itial h eap size (tamao inicial de pila de memoria): 768 M ax im u m h eap size (tamao mximo de pila de memoria): 1024 Gen eric JVM arg u m en ts (argumentos genricos de la mquina virtual de Java): -DiNET_HOME=<PATH_CONFIGURATION_FILES>\JiNET -Duser.language=en Duser.country=us -Dfile.encoding=UTF-8

Copyright 2013 - Bizagi

2513

Tenga en cuenta que en Sistemas operativos Linux, debe utilizar el caracter de separacin de carpetas apropiado (en vez del "\").

Ntese que debe reemplazar <PATH_CONFIGURATION_FILES> con el valor correspondiente a esta ruta de archivos de configuracin. De clic en O K y luego en Guardar ( Sav e) para aplicar los cambios.

2514

Copyright 2013 - Bizagi

Navegue nuevamente hacia el enlace Jav a Virtu al M ach in e (ubicado en las propiedades adicionales -A d d itio n al P ro p erties--), pero esta vez, haga clic sobre el enlace de propiedades personalizadas ( Cu sto m p ro p erties).

De clic sobre el botn de Nuevo ( N ew ) para registrar una propiedad personalizada. Nombre esta propiedad con: APP_SERVER, y especifique para su valor: WEBSPHERE.

Copyright 2013 - Bizagi

2515

De clic en O K y luego en Guardar ( Sav e) para aplicar los cambios. Reinicie el servidor una vez haya finalizado este paso.

3. Configurar los mdulos de WebSphere

Se deben configurar algunos mdulos en WebSphere a travs de la Consola de administracin, como se indica a continuacin. 3.1 Autenticacin Acceda a la Consola de administracin, y vaya a la seccin de Seguridad ( Secu rity ) y expanda el item de Seguridad global ( Glo b al Secu rity). Seleccione la casilla de Habilitar la seguridad a nivel de aplicacin ( En ab le ap p licatio n secu rity) y de clic sobre Aplicar ( A p p ly ).

2516

Copyright 2013 - Bizagi

De clic sobre Dominios de seguridad ( Secu rity d o m ain s) , en la misma seccin de Seguridad ( Secu rity ). De clic sobre el botn Co p y Glo b al Secu rity .. para registrar un dominio de seguridad.

Ingrese BizagiDomain en el Nombre ( N am e) del nuevo dominio:

Copyright 2013 - Bizagi

2517

De clic en O K. De clic sobre el dominio recin creado ( B izag id o m ain ), que aparecer listado:

En sus propiedades, asegrese de marcar la casilla de la instancia del Servidor ( serv er1). Realice esto expandiendo el item de Nodo ( N o d e), despus expanda el item de [su _serv id o r], y el de Servidores (Serv ers). Esta configuracin se encuentra en la seccin de los scopes asignados ( A ssig n ed Sco p e).

2518

Copyright 2013 - Bizagi

En la seccin de atributos de seguridad ( Secu rity A ttrib u tes): Expanda el item de Seguridad a nivel de aplicacin ( A p p licatio n Secu rity). Revise que la casilla ( En ab led ap p licatio n secu rity ) est marcada (para el valor de Personalizar este dominio -Cu sto m ize th is d o m ain --). Expanda el item de logins de JAAS ( JA A S Sy stem lo g in s), y de clic sobre el enlace de logins del sistema ( Sy stem lo g in s), nuevamente para el valor de Use g lo b al an d d o m ain -sp ecific lo g in s.

Copyright 2013 - Bizagi

2519

2520

Copyright 2013 - Bizagi

Para esta definicin, haga clic en W EB _IN B O UN D:

Haga clic en Nuevo ( N ew ) para crear un login de JAAS. Asegrese de especificar: com.bizagi.security.jaas.BizAgiLoginModule como el nombre de la clase del mdulo ( M o d u le class n am e). REQUERIDO como la estrategia de Autenticacin ( A u th en ticatio n strateg y = REQ UIRED).

Copyright 2013 - Bizagi

2521

De clic en O K. Ntese que el nuevo mdulo ser listado dentro de los mdulos usados bajo cierto orden predeterminado. De clic sobre el botn de Determinar el orden ( Set o rd er... ) para una reordenacin. A travs de esta opcin, asegrese de listar este nuevo mdulo de primero en la lista (utilizando el botn de Mover hacia arriba -- M o v e u p--).

2522

Copyright 2013 - Bizagi

De clic en O K, y revise que B izA g iLo g in M o d u le sea el primero de los mdulos de W EB _IN B O UN D (module order = 1).

Copyright 2013 - Bizagi

2523

Finalmente, de clic en Guardad ( Sav e) para persistir los cambios. En este punto el Servidor requiere de un reinicio. 3.2 Acceso a datos Antes de continuar, tenga en cuenta que si utiliza una base de datos SQL Server, deber requerir que el servicio no se inicie bajo un puerto dinmico. Se requiere que se use un puerto TCP/IP explcitamente (p.e el 1433 que es el usado por defecto).

2524

Copyright 2013 - Bizagi

Para la siguiente configuracin, acceda la Consola de administracin y realice los siguientes pasos. Ntese que para algunos de ellos, debe tener a la mano los valores de acuerdo a su motor de Base de datos (Oracle o SQL Server). Primero, vamos a registrar un Proveedor de datos JDBC. Vaya a la seccin de recursos ( Reso u rces) y expanda el item JDB C. De clic sobre los Proveedores JDBC ( JDB C P ro v id ers). Seleccione el scope que incluye la instancia del servidor (debe listarse como N o d e= [su _serv id o r], Serv er= serv er1):

Copyright 2013 - Bizagi

2525

Cree un Provider haciendo clic sobre el botn Nuevo ( N ew ). En la configuracin del nuevo Proveedor (que se realiza a travs de 3 pasos asistidos), ingrese la informacin correspondiente a su motor de Base de datos. Para Oracle: Database type (tipo de Base de datos): Oracle Provider type (tipo de Proveedor de datos): Oracle JDBC Driver Implementation type (tipo de implementacin): Connection pool data source Name (Nombre): Oracle JDBC Driver

o o o o

2526

Copyright 2013 - Bizagi

De clic en Siguiente ( N ex t) y especifique la ruta completa al driver de conexin de Oracle ( o jd b c): Ntese que debe renombrar el archivo o jd b c , para que no se incluya la versin menor especfica dentro de su nombre (debe quedar como ojdbc6.jar), de manera que se refencie por este nombre genrico y WebSphere lo encuentre.

Copyright 2013 - Bizagi

2527

De clic en Siguiente ( N ex t) y revise la informacin de resumen. De clic sobre Finalizar ( F in ish ). Para SQL Server: o Database type (tipo de Base de datos): User-defined o Implementation class name (Nombre de la clase de la implementacin): com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource o Name (Nombre): SQLServerProvider

2528

Copyright 2013 - Bizagi

De clic en Siguiente ( N ex t) y especifique la ruta completa hacia el driver de conexin de SQL Server ( sq ljd b c). Ntese que este .jar est contenido en los archivos de configuracin de Bizagi, dentro de < P A TH _CO N F IGURA TIO N _F ILES>.

Copyright 2013 - Bizagi

2529

De clic en Siguiente ( N ex t) y revise la informacin de resumen. De clic sobre Finalizar ( F in ish ). Una vez se haya creado el Proveedor, ste aparecer listado en la tabla (sea Oracle o SQL Server). Tenga en cuenta que debe dar clic sobre Guardar ( Sav e) para aplicar los cambios en la configuracin maestra.

2530

Copyright 2013 - Bizagi

Ahora vamos a crear y registrar una fuente de datos para la conexin a la Base de datos del proyecto. Para ello, ubique el panel a la izquiera para ir rpidamente al enlace de Fuentes de datos ( Data so u rces), ubicado todava bajo la seccin de recursos ( Reso u rces) sobre el item JDB C. Seleccione el scope que incluye la instancia del servidor (debe listarse como N o d e= [su _serv id o r], Serv er= serv er1):

Copyright 2013 - Bizagi

2531

Cree una fuente de datos haciendo clic sobre el botn Nuevo ( N ew ). En la configuracin de la nueva fuente de datos, ingrese la siguiente informacin: Data source name (nombre de la fuente de datos): BizAgiJava JNDI name (nombre JNDI): BizAgiJava

De clic en Siguiente ( N ex t) y marque la opcin de seleccionar un Proveedor JDBC existente ( Select an

2532

Copyright 2013 - Bizagi

ex istin g JDB C P ro v id er). De esta manera, seleccione el Proveedor de acuerdo a su motor de Base de datos (Oracle o SQL Server, tal como se cre el Proveedor previamente).

Si usted utiliza una Base de datos SQL Server, de clic en Siguiente ( N ex t) en las ventanas a continuacin (hasta que se llegue al final de los pasos asistidos, donde se debe dar clic en Finalizar -- F in ish -- para crear la fuente de datos). No se requiere configuracin adicional para esta fuente de datos en Bizagi cuando se utiliza SQL Server, e igualmente se pueden mantener los valores por defecto de WebSphere. Si usted utiliza una Base de datos Oracle, de clic en Siguiente ( N ex t) y asegrese de editar la URL de la cadena de conexin. Para el valor de la URL, ingrese la informacin de conexin a su instancia de Oracle. Esta conexin debe tener el siguiente formato: jdbc:oracle:thin:@[database_server]:[port_number]:[service_name] Considere: o database_server: El Servidor de Base de datos. Puede utilizar el SID en cambio. o port_number: El puerto bajo el cual el servicio de la Base de datos atiende. En Oracle por defecto, es el puerto 1521. o service_name: El nombre del servicio de la instancia Oracle. Una vez que haya configurado la conexin a su instancia Oracle, de clic en Siguiente ( N ex t ) en las ventanas a continuacin (hasta que se llegue al final de los pasos asistidos, donde se debe dar clic en Finalizar -- F in ish -- para crear la fuente de datos).

De clic sobre la fuente de datos creada B izA g iJav a para configurar las propiedades adicionales, la

Copyright 2013 - Bizagi

2533

cul aparecer listada en la tabla sea Oracle o SQL Server.

De clic en el enlace de propiedades personalizadas ( Cu sto m p ro p erties) ubicado en la seccin de Propiedades adicionales ( A d d itio n al P ro p erties).

2534

Copyright 2013 - Bizagi

Edite las propiedades como se describe a continuacin (de acuerdo a su motor de Base de datos), y asigne los valores correspondientes de la conexin. Para Oracle: o webSphereDefaultIsolationLevel: Asgnelo a 2. Este valor indicar un nivel llamado REA DCO M M ITTED. Adicional, cree 2 nuevas propiedades: usuario ( u ser) y contrasea ( p assw o rd). Para sus valores considere: o user: El esquema de usuario que representa el proyecto Bizagi. o password: La contrasea de ese esquema de usuario.

Para SQL Server: o serverName: El nombre del Servidor de Base de datos. o portNumber: El puerto bajo el cual la instancia atiende. En SQL Server y por defecto, es el puerto 1433. o webSphereDefaultIsolationLevel: Asgnelo a 1. Este valor indicar un nivel REA D-UN CO M M ITTED. o databaseName: El nombre de la Base de datos que corresponde al proyecto. o user: La cuenta login para acceder a la Base de datos. o password: La contrasea de esa cuenta login.

Copyright 2013 - Bizagi

2535

Despus de editar estas propiedades, asegrese de dar clic en Guardar ( Sav e) para aplicar los cambios. Una vez se haya configurado la fuente de datos, puede dar clic directamente sobre ella ( B izA g iJav a) para ir a la ventana anterior y utilizar la opcin de verificar la conexin ( Test co n n ectio n ):

2536

Copyright 2013 - Bizagi

3.3 Servicio de mensajera (JMS) En los siguientes pasos configuraremos un Servidor JMS que es utilizado por Bizagi para ejecutar Actividades Asncronas. Para ello, acceda la Consola de administracin y vaya a la seccin de Integracin del servicio ( Serv ice in teg ratio n ) y de clic sobre B u ses.

Bus de integracin del servicio De clic sobre Nuevo ( N ew ) para crear un bus que permita la activacin de los servicios de mensajera. Ingrese BizAgiBus como su nombre ( N am e), y asegrese de desmarcar la casilla de Seguridad a nivel de Bus (B u s secu rity).

Copyright 2013 - Bizagi

2537

De clic en Siguiente ( N ex t), y luego en Finalizar ( F in ish ) para crear el bus.

De clic sobre el bus recientemente creado ( B izA g iB u s) y luego de clic sobre el enlace de Miembros del Bus ( B u s m em b ers) en la seccin de Topologa ( To p o lo g y).

2538

Copyright 2013 - Bizagi

Asocie la instancia del servidor como miembro, haciendo clic en Adicionar ( A d d ). En el nuevo miembro del bus, asegrese que la instancia del servidor est incluida en la seleccin de la propiedad Serv er (desde las opciones del combo).

De clic en Siguiente ( N ex t). Seleccione File store como el tipo de almacenamiento de mensajera a utilizar.

Copyright 2013 - Bizagi

2539

En los siguientes 2 pasos, de clic en Siguiente ( N ex t) para dejar los valores por defecto. No se requiere configuracin adicional para el almacn de archivos (file store), y su configuracin podr ser revisada o editada posteriormente por el administrador del Servidor de Aplicaciones. De clic en Finalizar ( F in ish ) para crear el miembro del bus. Recursos destino De vuelta en la informacin del bus, de clic sobre el enlace de Destinos ( Destin atio n s), ubicado bajo la seccin de los recursos destino ( Destin atio n reso u rces ) para crear y asociar una cola (queue).

2540

Copyright 2013 - Bizagi

De clic en Nuevo ( N ew ) para crear la cola ( d estin atio n ty p e = Q u eu e).

De clic en Siguiente ( N ex t) e ingrese BizagiQueue como identificador ( id en tifier) de la cola. Ingrese una descripcin tambin.

Copyright 2013 - Bizagi

2541

De clic en Siguiente ( N ex t) y asegrese de seleccionar el miembro de bus como se configur anteriormente (para incluir la instancia del servidor):

De clic en Siguiente ( N ex t ) y luego en Finalizar ( F in ish ) para registrar el destino. Esta informacin aparecer listada en la tabla de recursos destino.

2542

Copyright 2013 - Bizagi

De clic sobre la cola recin creada ( B izA g iQ u eu e) para editar su configuracin de reintentos. En el detalle de la cola, edite el nmero mximo de intentos fallidos del mensaje ( M ax im u m failed d eliv eries p er m essag e), para que tenga un valor igual a 1 (el Servidor de Aplicaciones hara un reintento para las Actividades Asncronas a nivel de colas, lo cual quiere decir que se respetara la configuracin de reintentos de la Asncrona en Bizagi).

Copyright 2013 - Bizagi

2543

De clic en O K. Recuerde dar clic en Guardar ( Sav e) para aplicar los cambios igualmente. Fbrica de conexiones JMS Ahora crearemos una Fbrica de conexiones para JMS. Navegue a la seccin de Recursos ( Reso u rces) y expanda el item JM S. De clic sobre Q u eu e Co n n ectio n facto ries.

2544

Copyright 2013 - Bizagi

Seleccione el scope que incluye la instancia del servidor (debe listarse como N o d e= [su _serv id o r], Serv er= serv er1) y de clic en Nuevo ( N ew ) para crear una fbrica de conexin de colas (Queue Connection factory). Para el nuevo recurso, mantenga el Proveedor de mensajera por defecto: Default messaging provider, y de clic en O K.

Copyright 2013 - Bizagi

2545

Esto nos lleva a definir las propiedades principales de la nueva fbrica de conexiones. Ingrese AsyncControllerFactory tanto para el Nombre ( N am e) como para el Nombre JNDI ( JN DI N am e). Asegrese de seleccionar el bus creado para Bizagi ( B izA g iB u s).

De clic en O K. De clic en la Fbrica creada recin A sy n cCo n tro llerF acto ry (la cual aparecer listada en la tabla), para editar el parmetro de timeout de la conexin.

2546

Copyright 2013 - Bizagi

De clic en las propiedades del Pool de conexiones ( Co n n ectio n p o o l p ro p erties) ubicado bajo la seccin de Propiedades adicionales (A d d itio n al P ro p erties).

Asigne el timeout de la conexin ( Co n n ectio n tim eo u t) a 120 segundos y de clic en O K.

Copyright 2013 - Bizagi

2547

Recuerde guardar (dar clic en Sav e) para aplicar los cambios. Recurso de colas Ahora crearemos un recurso de colas. Para hacerlo, ubique el panel a la izquierda para seleccionar rpidamente el enlace de colas ( Q u eu es) , ubicado en la seccin de recursos ( Reso u rces) bajo el item JM S. Seleccione el scope que incluye la instancia del servidor (debe listarse como N o d e= [su _serv id o r], Serv er= serv er1), y de esta manera los Proveedores JMS sern filtrados:

2548

Copyright 2013 - Bizagi

De clic en Nuevo ( N ew ) para crear este recurso. Mantenga el Proveedor de mensajera por defecto: Defau lt m essag in g p ro v id er y de clic en O K.

Ingrese la siguiente informacin para el recurso de colas : Name (Nombre): AsyncController JNDI Name (Nombre JNDI): jms/AsyncController Bus name (Nombre del bus): seleccione el bus para Bizagi: BizAgiBus . Queue name (Nombre de la cola): seleccione la cola creada anteriormente: BizAgiQueue .

Copyright 2013 - Bizagi

2549

De clic en O K y luego en Guardar ( Sav e) para aplicar los cambios.

2550

Copyright 2013 - Bizagi

Ahora crearemos otro recurso para la especificacin de las activaciones (Activation specification). Para hacerlo, ubique el panel a la izquierda para seleccionar rpidamente el enlace A ctiv atio n sp ecificatio n s , ubicado en la seccin de recursos ( Reso u rces) bajo el item JM S. Seleccione el scope que incluye la instancia del servidor (debe listarse como N o d e= [su _serv id o r], Serv er= serv er1):

Copyright 2013 - Bizagi

2551

De clic en Nuevo ( N ew ) para crear la especificacin. Mantenga el Proveedor de mensajera por defecto: d efau lt m essag in g p ro v id er y de clic en O K.

Ingrese el siguiente detalle para la especificacin: Name (Nombre): AsyncControllerActivationSpec JNDI Name (Nombre JNDI) : eis/AsyncControllerActivationSpec Destination type (tipo de destino): seleccione cola: Queue . Destination JNDI Name (Nombre JNDI del destino): jms/AsyncController Bus name (Nombre del bus): seleccione el bus creado para Bizagi: BizAgiBus .

2552

Copyright 2013 - Bizagi

De clic en O K y luego en Guardar ( Sav e) para aplicar los cambios. 3.4 Timeout de las transacciones y usuario administrador por defecto Para definir el timeout de las transacciones, incrementamos la cantidad empleada por defecto para permitir transacciones de mayor duracin (p.e til en la sincronizacin de usuarios LDAP). Para hacerlo, acceda a la Consola de administracin y vaya a la seccin de Servidores ( Serv ers). Expanda el item tipos de servidores ( Serv er ty p es) y de clic sobre el enlace W eb Sp h ere A p p licatio n Serv ers.

Copyright 2013 - Bizagi

2553

De clic sobre la instancia nombrada del servidor ( serv er1). Expanda el item de Servicios del contenedor ( Co n tain er Serv ices) bajo la seccin de Configuracin del contenedor ( Co n tain er settin g s), y de clic sobre Servicio de la transaccin ( Tran sactio n serv ice).

Edite las propiedades: Tiempo de espera del ciclo de la transaccin total ( To tal tran sactio n lifetim e tim eo u t) y Tiempo de espera mximo de la transaccin ( M ax im u m tran sactio n tim eo u t). Asigne 3600 segundos a ambas propiedades.

2554

Copyright 2013 - Bizagi

De clic en O K y luego en Guardar ( Sav e) para aplicar los cambios. Usuario administrador La configuracin del usuario administrador por defecto de Bizagi se realiza estrictamente para el usuario llamado ad m o n del dominio por defecto llamado d o m ain . Para la configuracin de este usuario, acceda la Consola de administracin y vaya a la seccin de Usuarios y grupos ( Users an d g ro u p s) , y de clic sobre el enlace de Administrar usuarios ( M an ag e u sers ).

Copyright 2013 - Bizagi

2555

De clic en el botn de crear ( Create... ) para registrar el usuario administrador por defecto. Ingrese la siguiente informacin: User ID (id de usuario): domain\admon First name (nombre): Bizagi Last name (apellido): Bizagi Password (contrasea): Ingrese el password de su preferencia.

De clic sobre Crear ( Create). WebSphere notificar que la operacin ha sido exitosa, y podr hacer clic sobre Cerrar ( Clo se). En este punto su WebSphere deber ser reiniciado.

2556

Copyright 2013 - Bizagi

Qu sigue?
Despus de estos pasos, su instalacin de WebSphere est configurada para albergar Procesos Bizagi! Puede ahora iniciar su servidor y hacer generar el Portal de Trabajo (un despliegue de aplicacin). Para ms informacin sobre esta opcin, consulte el despliegue de la aplicacin hacia WebSphere. 7.4.1.2 Configuracin de Weblogic La configuracin de un servidor Weblogic hace parte de la configuracin para Configurar un Servidor de Aplicaciones JEE, como un paso requerido al crear el Portal de trabajo de Bizagi en la edicin Enterprise JEE. La configuracin de Weblogic vara de acuerdo a si la configuracin de la solucin tendr un esquema de alta disponibilidad o no (si se involucra o no ms de una instancia de Weblogic en un clster).

Para una gua sobre cmo configurar Weblogic para trabajar con Bizagi en un esquema de alta disponibilidad (para aplicaciones de misin crtica), consulte la Configuracin en clster de Weblogic. Para una gua sobre cmo configurar Weblogic para trabajar con Bizagi como instancia standalone (estndar setup), consulte Configuracin estndar de Weblogic.
7.4.1.2.1 Configuracin de Weblogic para soporte a clster

Introduccin
Con la edicin Bizagi Enterprise JEE, sus Procesos se pueden configurar sobre diferentes Servidores de Aplicacin JEE (p.e. WebSphere, WebLogic, o JBoss). El procedimiento de configuracin de cada Servidor de Aplicaciones para trabajar con Bizagi, vara ligeramente de acuerdo a las diferencias en s de cada uno de los servidores. Este artculo se enfoca en la configuracin de Weblogic para trabajar con Bizagi, en un esquema de alta disponibilidad, donde se hace uso de un clster para contar el balanceo de cargas en la aplicacin.

Copyright 2013 - Bizagi

2557

Si desea configurar Weblogic a modo standalone (solamente empleando un servidor BPM; sin esquema de balanceo de cargas), consulte la Configuracin estndar de Weblogic.

Lo que debe hacerse

Para la configuracin en clster de Bizagi, debe realizar estos pasos: 1. Seguir los requisitos para usar Weblogic. Estas directrices y pasos se indican en la Preconfiguracin de Weblogic para soporte a clster, e incluyen la defincin de un dominio y el registro del clster y de sus nodos. 2. Configurar Weblogic en clster para trabajar en Bizagi. Estos pasos se describen en la Configuracin en clster de Weblogic. 3. Configurar el servicio Scheduler (Programador) para una solucin en clster. Estos pasos se describen en la Configuracin del Scheduler en Weblogic. 4. Configurar otros componentes que hacen parte de la solucin, como el balanceador de cargas. Para ello, se recomienda revisar lo descrito en Configurar la arquitectura del sistema, donde se presenta la posibilidad de una instalacin de la solucin en 3 capas, y las directrices para la configuracin del balanceo de cargas.

7.4.1.2.1.1 Preconfiguracin de Weblogic para soporte a clster

El siguiente artculo describe los pasos y directrices a seguir para la configuracin de clsters en Weblogic.

2558

Copyright 2013 - Bizagi

Esto es un prerequisito para llevar a cabo la configuracin de Weblogic para trabajar con Bizagi en clster. Para ms informacin sobre los pasos que se llevan a cabo, consulte Configurar Weblogic en clster.

Prerequisitos
Para configurar su instancia de Weblogic en un ambiente de pruebas o produccin, se requiere: JDK 6, update 31 instalado en cada nodo que har parte del clster. La variable de entorno JA VA _H O M E configurada previamente (se recomienda que sea en una ruta sin espacios). Tener a la mano los archivos de configuracin (y de despliegue) requeridos por Bizagi (BizAgi-earWeblogic-dist.zip). Tener instalado el Servidor Weblogic en los nodos que harn parte del clster. Las versiones soportadas son las pertenecientes a Weblogic 11g: 10.3.6.0. Weblogic puede descargarse o solicitarse directamente desde la pgina oficial de Oracle. Tenga presente que debe tener el instalador apropiado a su sistema (p.e w ls[v ersio n ]_lin u x 32.b in , w ls [v ersio n ]_w in 32.ex e), y que para su instalacin debe seguir tanto los requisitos de Weblogic, como los lineamientos presentados en la siguiente seccin (p.e la creacin de un dominio y el registro del clster y los servidores involucrados). Nota Los nodos con instancias de Weblogic pueden estar en un mismo servidor o en diferentes servidores. Bizagi soporta el uso de Weblogic en clster tanto horizontal como vertical. Se recomienda la configuracin de clster horizontal, de manera que se tenga un servidor dedicado para cada nodo de Weblogic.

Requerimientos de Weblogic
Para instalar Weblogic (una vez que haya cubierto todos los prerequisitos), asegrese de considerar lo siguiente: Instalar todos los componentes del Servidor Weblogic.

Copyright 2013 - Bizagi

2559

Seleccionar un JDK pre-instalado (Java home). No se debe instalar el java embebido en el instalador, dado que se debe tener controlado que sea un JDK de versin soportada por Bizagi.

2560

Copyright 2013 - Bizagi

Instalar el servicio de Windows (cuando aplica para el sistema operativo utilizado). Esta ruta de instalacin ser referenciada como < W EB LO GIC_H O M E> en este artculo a partir de este momento. Para una gua completa sobre la instalacin de Weblogic, consulte la documentacin oficial de Oracle. Tenga presente que deber realizar la instalacin para cada servidor que vaya a contener un Nodo de Weblogic.

Configuracin del clster

Una vez que se haya instalado Weblogic en cada servidor que tendr un nodo, deber tener un dominio de usuario creado para Bizagi y registrar el clster y sus nodos. Para ello, puede utilizar las opciones del Inicio rpido ( Ru n Q u ickstart) para que Weblogic asista dicha configuracin. Este paso solo se requiere una vez (a diferencia de instalar Weblogic para cada nodo).

Dentro de estas opciones asistidas, ubique la opcin de Empezar a utilizar Weblogic ( Gettin g started w ith W eb lo g ic Serv er ) y seleccione la opcin de Crear un nuevo dominio ( Create a n ew W eb lo g ic d o m ain ).

Copyright 2013 - Bizagi

2561

Puede optar por usar la opcin de Generar el dominio configurado automticamente ( Gen erate a d o m ain co n fig u red au to m atically). Nota Tenga presente que en la configuracin de dominio deber ingresar un usuario y contrasea que deber recordar para el acceso a la consola administrativa. En las opciones de configuracin, para configurar automticamente las opciones de clster se debe seleccionar: Servidor de administracin ( A d m in istratio n Serv er) y Servidores gestionados, clsters y mquinas ( M an ag ed Serv ers, clu sters an d m ach in es). En la configuracin del Administration server, ingrese lo siguiente: N am e (Nombre): AdminServer Listen ad d ress (Direccin de recepcin): La direccin IP del servidor. Listen p o rt (Puerto de recepcin): Puerto utlizado por el servidor de administracin. Por defecto es el 7001.

En las opciones para configurar los servidores administrados, asegrese de registrar el detalle de los nodos de Weblogic que haran parte del clster. Para ello, ingrese un registro para cada nodo con la siguiente informacin: N am e (Nombre): El nombre del nodo de Weblogic. Listen ad d ress (Direccin de recepcin): La direccin IP del nodo. Listen p o rt (Puerto de recepcin): Puerto utlizado por el nodo. Ntese que en caso de utilizar SSL, deber activar la casilla de SSL y especificar el puerto de recepcin

2562

Copyright 2013 - Bizagi

SSL.

En la opcin para configurar el clster, registre el clster ingresando los siguientes detalles: N am e (Nombre): El nombre del clster. M essag e m o d e (Modo de mensajes de clster): Seleccione Unicast. Clu ster ad d ress (Direccin del clster): Las direcciones IP de los nodos (asociadas al clster). Estas se deben ingresar separadas por comas de la siguiente manera: [IP_Nodo1], [IP_Nodo2],[IP_NodoN] . En la configuracin siguiente, asegrese de asignar los nodos al clster de manera explcita (incluyndolos en el listado del clster. En las opciones de configuracin de mquinas, asegrese de ingresar las mquinas donde los nodos del clster se encuentran. La direccin IP de ellas deber corresponder a lo definido previamente para los nodos. Adicionalmente, puede especificar el puerto bajo el cul se realizar la sincronizacin del clster. Tenga en cuenta que la configuracin deber hacerse en la pestaa correspondiente al tipo de sistema operativo (Windows o Unix). Finalmente, en las opciones para asociar las instancias de los servidores a las mquinas, asegrese de incluir la totalidad de las instancias a las mquinas a las cuales pertencen, e igualmente definir la ubicacin del AdminServer que se encarga de la administracin del clster sea vertical u horizontal. Para mayor informacin acerca de estos temas de instalacin y primeros pasos consulte la documentacin oficial de Weblogic. Una vez haya finalizado con la creacin del dominio para un ambiente en clster, podr revisar que la configuracin sea exitosa, iniciando el servicio de su dominio.

Sincronizacin de cambios en el clster

Una vez se realice la configuracin del clster, o cada vez que se realicen cambios en l (por ejemplo, se adicione un nuevo nodo), se debe sincronizar la configuracin central hacia los nodos. Para realizar una sincronizacin de cambios, se replican manualmente los cambios a travs de una plantilla que se ejecuta en cada nodo. Para hacerlo, lleve a cabo lo siguiente: 1. Abra una consola de comandos y ubquese en el directorio common\bin de la ruta de instalacin de Weblogic: < W EB LO GIC_H O M E> \w lserv er_10.3\co m m o n \b in \. Debe ser en la mquina donde se realizaron los cambios. 2. Desde esa ubicacin ejecute el siguiente comando. Para Linux OS: pack.sh -managed=true -domain=<WEBLOGIC_HOME>/user_projects/domains/ [CLUSTER_DOMAIN] -template=template.jar -template_name="[CLUSTER_DOMAIN]" Para Windows: pack.cmd -managed=true domain=<WEBLOGIC_HOME>\user_projects\domains\[CLUSTER_DOMAIN] -

Copyright 2013 - Bizagi

2563

template=template.jar -template_name="[CLUSTER_DOMAIN]" Esto exporta una plantilla .jar con el nombre del dominio del clster para la replicacin de la configuracin. Por defecto, esta plantilla queda en la misma ruta < W EB LO GIC_H O M E> \w lserv er_10.3\co m m o n \b in \. 3. Copie esta plantilla [CLUSTER_DO M A IN ].jar hacia las mquinas donde hay nodos del clster que no han sido sincronizados. Ntese que este paso deber repetirse segn la cantidad de nodos, para que la totalidad de ellos tomen los cambios. Ubquela en una ruta sin espacios (puede ser en la ruta home de instalacin de Weblogic < W EB LO GIC_H O M E>). 4. Abra una consola de comandos y ubquese en el directorio common\bin de la ruta de instalacin de Weblogic: < W EB LO GIC_H O M E> \w lserv er_10.3\co m m o n \b in \. Recuerde que debe ser en la mquina donde no se han replicados los cambios. 5. Desde esa ubicacin ejecute el siguiente comando. Para Linux OS: unpack.sh -template=<WEBLOGIC_HOME>/[CLUSTER_DOMAIN].jar domain=<WEBLOGIC_HOME>/user_projects/domains/[CLUSTER_DOMAIN] Para Windows: unpack.cmd -template=<WEBLOGIC_HOME>\[CLUSTER_DOMAIN].jar domain=<WEBLOGIC_HOME>\user_projects\domains\[CLUSTER_DOMAIN]

6. Seguidamente, revise el archivo de propiedades de configuracin ubicado como < W EB LO GIC_H O M E> \w lserv er_10.3\co m m o n \n o d em an ag er\n o d em an ag er.p ro p erties. En l, asegrese de tener: StartScrip tN am e: Asignado al ejecutable startW eb Lo g ic. Tenga presente el sistema operativo; en caso de ejecutarse sobre Windows ser: StartScriptName=startWebLogic.cmd Para Linux OS ser: StartScriptName=startWebLogic.sh

StartScrip tEn ab led: Asignado con verdadero. Deber quedar: StartScriptEnabled=true

Guarde los cambios y cierre el archivo de propiedades.

7. Para verificar que se haya sincronizado la configuracin, primero ejecute el manejador de cada nodo, a travs de una consola de comandos (el uso del NodeManager se instancia con el siguiente comando): Para Linux OS: <WEBLOGIC_HOME>/wlserver_10.3/server/bin/startNodeManager.sh Para Windows: <WEBLOGIC_HOME>\wlserver_10.3\server\bin\startNodeManager.cmd

2564

Copyright 2013 - Bizagi

La ejecucin deber mostrar que el manejador inicia bajo el puerto 5556:

8. Una vez el manejador de cada nodo est operando, inicie el servicio de Weblogic desde el comando startW eb Lo g ic Para ello, ejectelo desde una consola segn el sistema operativo. Para Linux: <WEBLOGIC_HOME>/user_projects/domains/[CLUSTER_DOMAIN]/bin/startWebLogic.sh Para Windows: <WEBLOGIC_HOME>\user_projects\domains\[CLUSTER_DOMAIN] \bin\startWebLogic.cmd De esta manera, podr acceder a la Consola de administracin de Weblogic con la siguiente direccin URL en un navegador y validar que sus nodos hagan parte del clster:

Copyright 2013 - Bizagi

2565

http://localhost:7001/console/login/LoginForm.jsp En la seccin de Entorno ( En v iro n m en t), podr ubicar la opcin Serv ers y verificar los nodos del clster (p.e iniciarlos a travs de la pestaa de Co n tro l):

Ntese que la columna State mostrar si cada nodo se encuentra en ejecucin ( RUN N IN G) o no ( SH UTDO W N ). Una vez que complete estos pasos y la verificacin, puede detener los nodos (desde las opciones de Sh u td o w n ) y el servicio de Weblogic (a travs de sto p W eb Lo g ic como se describe en las Opciones de Weblogic).

Para continuar con la configuracin como tal de Weblogic y Bizagi consulte la Configuracin de Weblogic en clster para trabajar con Bizagi.

Opciones de Weblogic
Para iniciar, detener o acceder a la Consola de administracin de Weblogic, consulte la informacin a continuacin. Ntese que en este artculo nuestro dominio se llama b izag i_d o m ain .

Iniciar el servidor (dominio)

Para iniciar Weblogic, execute the following file in a command prompt: En Linux: <WEBLOGIC_HOME>/user_projects/domains/[CLUSTER_DOMAIN]/bin/startWebLogic.sh En Windows: <WEBLOGIC_HOME>\user_projects\domains\[CLUSTER_DOMAIN] \bin\startWebLogic.cmd Nota

2566

Copyright 2013 - Bizagi

En Windows, tambin se puede optar por usar las opciones del men ( O racle W eb lo g ic > User P ro jects > [clu ster_d o m ain ] > Start A d m in Serv er).

Asegrese de especifica el usuario y contrasea (tal como fue especificado cuando se cre el dominio de Weblogic).

Detener el servidor (dominio)

Para detener Weblogic, execute the following file in a command prompt:

Copyright 2013 - Bizagi

2567

En Linux: <WEBLOGIC_HOME>/user_projects/domains/[CLUSTER_DOMAIN]/bin/stopWebLogic.sh En Windows: <WEBLOGIC_HOME>\user_projects\domains\[CLUSTER_DOMAIN]\bin\stopWebLogic.cmd Nota En Windows, tambin se puede optar por usar las opciones del men ( O racle W eb lo g ic > User P ro jects > [clu ster_d o m ain ] > Start A d m in Serv er).

Acceder a la Consola de administracin

Para acceder a la Consola de administracin de Weblogic, ingrese la siguiente direccin URL en un navegador: http://localhost:7001/console/login/LoginForm.jsp Recuerde que igualmente requerida ingresar el usuario y contrasea autorizado del dominio.

2568

Copyright 2013 - Bizagi

7.4.1.2.1.2 Configuracin de Weblogic en clster para trabajar con Bizagi

Para la configuracin de Weblogic para trabajar con Bizagi en un esquema de clster (ms de un nodo en la capa BPM), se debe contar con ciertas configuraciones previas del lado de Weblogic. Por lo tanto, antes de continuar, asegrese de haber seguido las instrucciones descritas en Preconfigurar Weblogic para soporte a clster. Para ms informacin sobre el procedimiento completo, consulte Configurar Weblogic en clster. Este artculo indica qu configuraciones debe realizar para que su cluster en Weblogic trabaje con el proyecto de Bizagi. Una vez que haya cumplido con lo descrito en el anterior artculo, se realiza lo siguiente: 1. Extraer los archivos usados por Bizagi hacia Weblogic. 2. Configurar las variables de entorno. 3. Configurar los siguientes mdulos en Weblogic: Autenticacin Acceso a datos Servicio de mensajera (JMS) Libreras compartidas (JSTL, JSF) Otros, tales como el timeout en transacciones, y el usuario administrador por defecto Estos mdulos se configuran en Weblogic utilizando su Consola de administracin, y utilizan a su vez los archivos de Bizagi que se extraen en el primer paso. Despus de estos pasos, su instancia de Weblogic estar configurado para que los Procesos de Bizagi se desplieguen en una aplicacin JEE (el Portal de Trabajo).

Copyright 2013 - Bizagi

2569

Procedimiento
Los siguientes pasos describen a detalle cmo configurar y editar las preferencias de una instalacin de Weblogic por defecto. Nota Realice la configuracin como se indica a continuacin, teniendo en cuenta que los nombres usados son sensibles a maysculas.

1. Extraer los archivos usados por Bizagi hacia Weblogic

En este paso, se incluyen archivos usados por Bizagi en la instancia de Weblogic (son archivos que no vienen por defecto en la instalacin limpia). Para ello, debe contar con el archivo de distribucin que entrega Bizagi ( B izA g i-ear-W eb lo g ic-d ist.zip). Este paso que contempla configurar los archivos utilizados por Bizagi, deber hacerlo para cada nodo que haga parte del clster. 1.1 Extraer el contenido de este .zip hacia una ruta local. Esta ruta ser referenciada como < P A TH _CO N F IGURA TIO N _F ILES> a partir de este momento. 1.2 Copie las libreras del mdulo de Autenticacin ( B izA g iSecu rity P ro v id er-1.2.jar, B izag iRem o te1.0.jar, B izA g i.Secu rity .Co m m o n -1.0.jar) de los archivos de configuracin, desde esta ruta: <PATH_CONFIGURATION_FILES>\security\ Hacia la ruta de libreras de Weblogic en: <WEBLOGIC_HOME>\wlserver_10.3\server\lib\mbeantypes\ 1.3 Copie los driveres para el acceso a datos, segn el motor de Base de datos (los drivers entregados en los archivos de configuracin), desde esta ruta: <PATH_CONFIGURATION_FILES>\configuration\ Hacia la ruta de libreras de Weblogic como se describe a continuacin. Si utiliza Weblogic 10.3.6.0, la ruta de destino es: <WEBLOGIC_HOME>\wlserver_10.3\server\lib\ Si su proyecto utiliza Oracle, entonces no requiere copiar el driver (ya que el ojdbc6 est incluido por defecto en Weblogic). Lo que si debe hacer, es editar el archivo w eb .co n fig .x m l ubicado en <PATH_CONFIGURATION_FILES>\JiNET\config\ de manera que la llave P RO VIDERTY P E est asignada al uso de Oracle:

2570

Copyright 2013 - Bizagi

Si su proyecto utiliza Microsoft SQL Server, copie el driver sq ljd b c-4.0.jar. 1.4 Copie la librera utilizada para el registro de logs, que se llama lo g 4j-1.2.8.jar (tambin entregada en los archivos de configuracin). Copie la librera de esta ruta: <PATH_CONFIGURATION_FILES>\configuration\ Hacia la ruta de libreras de Weblogic en: <WEBLOGIC_HOME>\user_projects\domains\[your_domain]\lib\ 1.5 Copie las libreras compartidas, principalmente: jsf-m y faces-1.2.8.w ar y eclip selin k-2.5.0.jar (que se entrega en los archivos de configuracin). Copiela de esta ruta: <PATH_CONFIGURATION_FILES>\configuration\ Hacia la ruta de libreras de Weblogic en: <WEBLOGIC_HOME>\wlserver_10.3\common\deployable-libraries\

2. Configurar las variables de entorno

Para configurar las variables que sern referenciadas como parmetros de ejecucin en el Servidor, primero asergrese de que sus instancias de Weblogic no estn iniciadas (deben estar detenidas). Este paso que contempla configurar las variables utilizadas por Bizagi, deber hacerlo para cada nodo que haga parte del clster. Seguidamente, edite el archivo de inicio del servicio de Weblogic para asignar las variables necesarias. En Linux: Ubique la siguiente lnea en el archivo < W EB LO GIC_H O M E> /u ser_p ro jects/d o m ain s/[USER_DO M A IN ]/ b in /startW eb Lo g ic.sh : JA VA _O P TIO N S= "${SA VE_JA VA _O P TIO N S}" Adicione lo siguiente al final de la lnea, asegurndose que todo el contenido quede en una misma lnea: -DiNET_HOME=<PATH_CONFIGURATION_FILES>/JiNET -Duser.language=en Duser.country=us -Dfile.encoding=UTF-8 -DAPP_SERV=WEBLOGIC Dbizagi.cache.multicast.enabled=true Dbizagi.cache.multicast.address=224.2.2.3 Dbizagi.cache.multicast.port=7777 -Dbizagi.cache.multicast.type=UDP

Copyright 2013 - Bizagi

2571

Considere que debe asignar el valor correspondiente a la ruta <PATH_CONFIGURATION_FILES>, y que debe utilizar "/" como el caracter de separacin de ruta.

Adicional a lo anterior, incremente la memoria utilizada en los parmetros por defecto para un mejor desempeo y tiempo de despliegue. Para ello, ubique la siguiente lnea en el mismo archivo: USER_M EM _A RGS= Asigne los siguientes valores: USER_MEM_ARGS="-Xms768m -Xmx2048m -XX:PermSize=768m -XX:MaxPermSize=2048m" Guarde los cambios y reinicie su Servidor Weblogic. Nota Si est utilizando Weblogic 10.3.6.0 y una Base de datos SQL Server, deber entonces hacer una modificacin adicional a los parmetros de ambiente compartidos, de maneera que se incluya el driver sq ljd b c-4.0.jar en el CLASSPATH de Weblogic. Para hacerlo, edite el archivo <WEBLOGIC_HOME>/wlserver_10.3/common/bin/ commEnv.sh y ubique la lnea que contiene W EB LO GIC_CLA SSP A TH = "${JA VA _H O M E} . Adicione: ${W L_H O M E}/serv er/lib /sq ljd b c-4.0.jar como una dependencia en el archivo (usando el caracter apropiado de separacin cuando se definen mltiples parmetros).

2572

Copyright 2013 - Bizagi

En Windows: Ubique la siguiente lnea en el archivo < W EB LO GIC_H O M E> \u ser_p ro jects\d o m ain s\[USER_DO M A IN ] \b in \startW eb Lo g ic.cm d: set JA VA _O P TIO N S= % SA VE_JA VA _O P TIO N S% Adicione lo siguiente al final de la lnea, asegurndose que todo el contenido quede en una misma lnea: -DiNET_HOME=<PATH_CONFIGURATION_FILES>\JiNET -Duser.language=en Duser.country=us -Dfile.encoding=UTF-8 -DAPP_SERV=WEBLOGIC Dbizagi.cache.multicast.enabled=true Dbizagi.cache.multicast.address=224.2.2.3 Dbizagi.cache.multicast.port=7777 -Dbizagi.cache.multicast.type=UDP Considere que debe asignar el valor correspondiente a la ruta <PATH_CONFIGURATION_FILES>, y que debe utilizar "/" como el caracter de separacin de ruta.

Adicional a lo anterior, incremente la memoria utilizada en los parmetros por defecto para un mejor desempeo y tiempo de despliegue. Para ello, ubique la siguiente lnea en el mismo archivo: set USER_M EM _A RGS= Asigne los siguientes valores: set USER_MEM_ARGS=-Xms768m -Xmx2048m -XX:PermSize=768m -XX: MaxPermSize=2048m Guarde los cambios y reinicie su Servidor Weblogic. Note Si est utilizando Weblogic 10.3.6.0 y una Base de datos SQL Server, deber entonces hacer una modificacin adicional a los parmetros de ambiente compartidos, de maneera que se incluya el driver sq ljd b c-4.0.jar en el CLASSPATH de Weblogic. Para hacerlo, edite el archivo <WEBLOGIC_HOME>\wlserver_10.3

Copyright 2013 - Bizagi

2573

\common\bin\commEnv.cmd y ubique la lnea que contiene W EB LO GIC_CLA SSP A TH = % JA VA _H O M E% . Adicione: % W L_H O M E% \serv er\lib \sq ljd b c-4.0.jar como una dependencia en el archivo (usando el caracter apropiado de separacin cuando se definen mltiples parmetros).

3. Configurar los mdulos de Weblogic

Se deben configurar algunos mdulos en Weblogic a travs de la Consola de administracin, como se indica a continuacin. Nota Ntese que para editar esta configuracin, puede requerir primero utilizar el botn de Desbloqueo y edicin ( Lo ck & Ed it b u tto n ) ubicado en la esquina superior izquierda. Al final de los pasos, igualmente asegrese de aplicar los cambios y liberar el bloqueo (haciendo clic en A ctiv ate ch an g es y al finalizar, clic en Release co n fig u ratio n ). Despus de realizar cambios, Weblogic puede indicar que se requiere de un reinicio del servicio. 3.1 Autenticacin Acceda la Consola de administracin, y vaya a la seccin Secu rity Realm s y seleccione el item del mbito de dominio ( m y realm ).

2574

Copyright 2013 - Bizagi

Seleccione la pestaa de Proveedores P ro v id ers y luego la pestaa de Autenticacin ( A u th en ticatio n ). Cree un nuevo item dando clic sobre el botn Nuevo ( N ew ).

Ingrese BizagiAuthenticator como el Nombre ( N am e) del Proveedor y seleccione BizagiAuthenticator como el tipo ( Ty p e) de Proveedor de Autenticacin.

Copyright 2013 - Bizagi

2575

De clic en O K. De vuelta en la lista de Proveedores de Autenticacin, asegrese de seleccionar B izA g iA u th en ticato r para que sea el primer item. Esto se requiere dado que el nuevo Proveedor opera en un contexto compartido. Use la opcin de reordenar (botn Reo rd er) para mover B izA g iA u th en ticato r hasta la cima de la lista.

2576

Copyright 2013 - Bizagi

De clic en O K. B izA g iA u th en ticato r debe aparecer de primero, y de clic sobre l. Cambie la configuracin de control ( Co n tro l F lag ) a el valor: SUFFICIENT (seleccinelo del combo de opciones y de clic en Guardar -- Sav e--).

Copyright 2013 - Bizagi

2577

Finalmente, active los cambios. 3.2 Acceso de datos Antes de continuar con esta configuracin, tenga presente que al utilizar una Base de datos SQL Server, se requiere que el servicio de la instancia no se inicie bajo un puerto dinmico. Se requiere que el puerto TCP/IP del servicio est predefinido explcitamente (p.e el 1433 por defecto).

Para la siguiente configuracin, acceda la Consola de administracin y tenga en cuenta que la configuracin vara ligeramente de acuerd al motor de Base de datos de su proyecto (Oracle o SQL Server). Vaya a la seccin de Servicios ( Serv ices) y de clic sobre fuentes de datos ( Data So u rces).

2578

Copyright 2013 - Bizagi

Cree una nueva fuente de datos dando clic sobre Nuevo ( N ew ) y especificando que es una fuente de datos de tipo genrica ( Gen eric Data So u rce).

Para la fuente de datos, especifique: Primero ingrese BizAgiJava tanto para el Nombre ( N am e) como para el Nombre JNDI ( JN DI N am e) .

Copyright 2013 - Bizagi

2579

Para Oracle Seleccione Oracle como el tipo de Base de datos ( Datab ase ty p e). De clic en Siguiente ( N ex t) y seleccione el driver Oracles Driver (Thin) for instance connections; Versions: 9.0.1 and later ( Datab ase Driv er).

2580

Copyright 2013 - Bizagi

De clic en Siguiente ( N ex t). Para SQL Server Seleccione MS SQL Server como el tipo de Base de dato ( Datab ase ty p e). De clic en Siguiente ( N ex t) y seleccione el driver Microsoft's MS SQL Server Driver (Type 4) Versions:2005 and later ( Datab ase Driv er).

Copyright 2013 - Bizagi

2581

De clic en Siguiente ( N ex t).

En las opciones de transaccin ( Tran sactio n O p tio n s), tanto para Oracle como para SQL Server, asegrese de desmarcar la casilla de Su p p o rts Glo b al Tran sactio n s. De clic en Siguiente ( N ex t) y especifique el detalle de conexin a su Base de datos. De clic nuevamente en Siguiente ( N ex t). Verifique la conexin a su Base de datos, utilizando la opcin de Probar ( Test Co n fig u ratio n ). Ntese que tambin puede revisar la URL de la cadena de conexin.Una vez que esta verificacin sea exitosa, de clic en Siguiente ( N ex t).

2582

Copyright 2013 - Bizagi

Revise que esta fuente de datos sea aplicada en su configuracin de clster. Para ello, asegrese de marcar la casilla del clster e incluir All servers in the cluster para la configuracin del destino ( Select Targ et) y de clic en Finalizar ( F in ish ):

Finalmente, asegrese de aplicar los cambios.

Copyright 2013 - Bizagi

2583

3.3 Servicio de mensajera (JMS) En los siguientes pasos vamos a configurar un Servidor JMS que se utiliza por Bizagi para las Actividades Ascronas. Para hacerlo, acceda la Consola de administracin y vaya a la seccin de Servicios ( Serv ices). De clic sobre el enlace de Mensajera ( M essag in g ).

Servidor JMS Para la configuracin en clster, se debe crear un Servidor JMS con su respectivo File Store, para cada nodo de Weblogic que haga parte del clster.

Para crear un Servidor JMS, de clic en Servidores JMS ( JM S Serv ers) y sobre Nuevo ( N ew ). A travs de las opciones del nuevo Servidor JMS, cree un nuevo almacn de persistencia dando clic sobre Create a N ew Sto re .

2584

Copyright 2013 - Bizagi

Para el tipo de almacn, seleccione File Store. De clic en Siguiente ( N ex t).

En sus propiedades, ingrese el nombre ( N am e): FileStore-BizAgi. Seleccione la instancia de Weblogic (para el primero que cree, escoja AdminServer como destino -Targ et--), y especifique un directorio vlido para persistir la informacin. Haga clic en O k.

Copyright 2013 - Bizagi

2585

De vuelta en la informacin del nuevo Servidor JMS (habiendo creado ya el almacn de persistencia tipo archivo), ingrese: JMSServer-BizAgi para el Nombre ( N am e) y seleccione el almacn creado de las opciones del combo. De clic en Siguiente ( N ex t).

2586

Copyright 2013 - Bizagi

Finalmente, seleccione la instancia del servidor destino ( Targ et) . Para el primero, seleccione AdminServer. De clic en Finalizar ( F in ish ).

Tenga en cuenta que debe repetir este paso de creacin de Servidor JMS para cada nodo de su clster (y cada Servidor JMS con su respectivo File Store). Es decir, en el ltimo paso deber asignar la instancia del servidor destino (bajo Targ et).

Copyright 2013 - Bizagi

2587

Recuerde que los nombres de los Servidores JMS y los File Stores deben ser nicos (puede utilizar un nombrado: JMSServer-Bizagi2, JMSServer-BizagiN). Al finalizar, ver el listado de los mltiples Servidores JMS con sus Stores, incluyendo el que se registra para la instancia AdminServer:

En esta lista de Servidores JMS, de clic cada uno de los creados anteriorment (p.e JM SServ er-B izA g i) para editar su propiedad Ex p iratio n Scan In terv al. Asgnele el valor de 120 segundos.

De clic en Guardar ( Sav e). Asegrese de asignar este valor para cada uno de los Servidores JMS creados anteriormente. Recuerde activar los cambios una vez haya finalizado con todos los Servidores JMS.

Mdulo JMS

2588

Copyright 2013 - Bizagi

Navegue a la seccin de Servicios ( Serv ices) y expanda la opcin de Mensajera ( M essag in g ). . De clic sobre JM S M o d u les y en Nuevo (N ew ) para registrar un mdulo JMS.

Ingrese: SystemModule-BizAgi en el nombre ( N am e). No se requiere informacin adicional; de clic en Siguiente ( N ex t).

Asegrese de marcar la casilla del clster (en Select Targ et) e incluir All servers in the cluster para aplicar a la configuracin a todos los nodos.

Copyright 2013 - Bizagi

2589

De clic en Finalizar ( F in ish ).

Recursos adicionales En la lista de mdulos JMS, de clic sobre el recin creado Sy stem M o d u le-B izA g i para editar sus propiedades, Dentro de las mismas opciones, vamos a crear 4 nuevos recursos ( Co n n ectio n F acto ry p ara co las, Distrib u ted Q u eu e, Co n n ectio n F acto ry p ara t p ico s, Distrib u ted To p ic).

Para crear y asociar un recurso, de clic sobre Nuevo ( N ew ) desde la tabla de resumen de recursos ( Su m m ary o f Reso u rces).

2590

Copyright 2013 - Bizagi

Para el primer recurso, seleccione Connection Factory como el tipo ( Ty p e).

De clic en Siguiente ( N ex t) e ingrese: AsyncControllerFactory tanto en el Nombre ( N am e), como en el Nombre JNDI ( JN DI N am e).

Copyright 2013 - Bizagi

2591

Asegrese de marcar la casilla que activa el uso de XA Connection Factory Enabled y de clic en Finalizar ( F in ish ). Para el segundo recurso que se crea, seleccione Distributed Queue como el tipo ( Ty p e).

2592

Copyright 2013 - Bizagi

De clic en Siguiente ( N ex t) e ingrese: AsyncController en el Nombre ( N am e). Ingrese jms/AsyncController en el Nombre JNDI ( JN DI N am e) y de clic en Siguiente ( N ex t).

De clic en Siguiente ( N ex t) y en Finalizar ( F in ish ). Este recurso debe quedar asociado de manera distribuida al clster. Para el tercer recurso, seleccione Connection Factory como el tipo ( Ty p e).

Copyright 2013 - Bizagi

2593

De clic en Siguiente ( N ex t) e ingrese: EclipseLinkTopicConnectionFactory en el Nombre ( N am e). Ingrese jms/EclipseLinkTopicConnectionFactory en el Nombre JNDI ( JN DI N am e) y de clic en Siguiente ( N ex t).

Asegrese de marcar la casilla que activa el uso de XA Connection Factory Enabled y de clic en Finalizar ( F in ish ).

2594

Copyright 2013 - Bizagi

Para el cuarto recurso, seleccione Distributed Topic como el tipo ( Ty p e).

De clic en Siguiente ( N ex t) e ingrese: EclipseLinkTopic en el Nombre ( N am e). Ingrese jms/EclipseLinkTopic en el Nombre JNDI ( JN DI N am e) y de clic en Siguiente ( N ex t).

Copyright 2013 - Bizagi

2595

De clic en Siguiente ( N ex t) y en Finalizar ( F in ish ). Este recurso debe quedar asociado de manera distribuida al clster. Al finalizar, los 4 nuevos recursos quedarn listados y aplicarn al clster:

En la lista de los recursos, de clic sobre la cola distribuda creada como A sy n cCo n tro ller (la cola distribuda) para editar sus propiedades, De clic en la pestaa de manejo de fallas en la entrega ( Deliv ery F ailu re) para configurar el manejo de reintentos cuando algn mensaje no pueda ser entregado. Especifique 1 como el lmite de reintentos ( Red eliv ery Lim it) y de clic en Guardar ( Sav e). De esta manera, el Servidor de Aplicaciones hara un reintento para las Actividades Asncronas a nivel de colas (lo cual quiere decir que se respetara la configuracin de reintentos de la Asncrona en Bizagi).

2596

Copyright 2013 - Bizagi

Finalmente, recuerde activar los cambios.

3.4 Libreras compartidas Acceda la Consola de administracin y vaya a la seccin de despliegues ( Dep lo y m en ts). Instale 4 libreras compartidas ( jstl-1.2.w ar, jsf-1.2.w ar, jsf-m y faces-1.2.8.w ar y eclip selin k-2.5.0.jar) como se indica a continuacin.

Para la primera, de clic en Instalar ( In stall) y navegue hacia la ruta donde se encuentran estas librerias desplegables. La ruta es la correspondiente a <WEBLOGIC_HOME>\wlserver_10.3

Copyright 2013 - Bizagi

2597

\common\deployable-libraries\. Marque la librera jsf-1.2.w ar .

De clic en Siguiente ( N ex t). Seleccione la opcin de Instalarla como una librera ( In stall th is d ep lo y m en t as lib rary).

De clic en Siguiente ( N ex t). Asegrese de marcar la casilla del clster (en Select Targ et) e incluir All servers in the cluster para aplicar a la configuracin a todos los nodos.

2598

Copyright 2013 - Bizagi

De clic en Finalizar ( F in ish ). Para la segunda, repita los pasos de Instalacin (la opcin In stall) pero esta vez marque la librera jsfm y faces-1.2.8.w ar (ubicada en la misma ruta: <WEBLOGIC_HOME>\wlserver_10.3 \common\deployable-libraries\).

Para la tercera, repita los pasos de Instalacin (la opcin In stall) pero esta vez marque la librera jstl1.2.w ar (ubicada en la misma ruta: <WEBLOGIC_HOME>\wlserver_10.3\common\deployablelibraries\).

Copyright 2013 - Bizagi

2599

Para la cuarta, repita los pasos de Instalacin (la opcin In stall) pero esta vez marque la librera eclip selin k-2.5.0.jar (ubicada en la misma ruta: <WEBLOGIC_HOME>\wlserver_10.3 \common\deployable-libraries\).

2600

Copyright 2013 - Bizagi

Una vez haya instalado estas 4 libreras desplegables, se listarn inmediatamente:

Recuerde activar los cambios.

3.5 Parmetros de transaccin (JTA) y usuario administrador por defecto Para la configuracin de parmetros de transaccin (Java Transaction API) slo necesitamos aumentar el tiempo lmite asignado por defecto de la transaccin (timeout). Para hacerlo, acceda la Consola de administracin y vaya a la seccin de Servicios ( Serv ices).

Copyright 2013 - Bizagi

2601

Seleccione JTA y edite la propiedad Tim eo u t seco n d s para asignarle 120 segundos.

De clic en Guardar ( Sav e) y active los cambios. En este punto, debe reiniciar su servicio de Weblogic. Usuario administrador Para configurar el usuario administrador por defecto de Bizagi, es necesario crear el usuario ad m o n del dominio d o m ain . Para ello, acceda la Consola de admnistracin y vaya a la seccin Secu rity realm s y de clic en el mbito de dominio ( m y realm ). Ubique la pestaa de Usuarios y grupos ( Users an d Gro u p s), y cree el nuevo usuario dando clic sobre Nuevo ( N ew ).

2602

Copyright 2013 - Bizagi

Ingrese la siguiente informacin para el usuario administrador N am e: Si utiliza Weblogic 10.3.6.0, el nombre del usuario deber ser: ad m o n . Descrip tio n : Bizagi administrator user P ro v id er: Defau ltA u th en ticato r P assw o rd: bizagi$91

Copyright 2013 - Bizagi

2603

De clic en O K. Una vez que complete estos pasos, consulte la Configuracin de el Scheduler en Weblogic.
7.4.1.2.1.3 Configuracin del Scheduler en Weblogic

Introduccin
Para ambientes de alta disponibilidad donde se tiene Bizagi en un ambiente de clster, Bizagi ofrece la posibilidad de configurar su servicio de Scheduler (programador) de manera que se tenga un esquema de: Tolerancia a fallos en el programador (para que ste se pueda ejecutar sobre cualquier nodo de la solucin). Administracin del programador para que se pueda detener, iniciar o reiniciar el servicio de manera independiente en cualquier momento.

2604

Copyright 2013 - Bizagi

Prerequisitos
Para configurar del servicio de Scheduler de Weblogic asegrese de cumplir con los siguientes prerequisitos: Se debe haber configurado la solucin de Bizagi en Weblogic. Para ms informacin sobre ello, consulte Configuracin en clster de Weblogic. Tenga a la mano los archivos de configuracin (y de despliegue) requeridos por Bizagi (BizAgi-earWeblogic-dist.zip). Estos archivos deben haber sido descomprimidos en los pasos de configuracin de Weblogic y ubicados en una ruta que ser referenciada como <PATH_CONFIGURATION_FILES> en este artculo.

Configuracin
Ubique la siguiente ruta local: <PATH_CONFIGURATION_FILES>/BizagiSchedulerService/ 1. En esa ruta, configure el archivo de propiedades scheduler_configuration.properties Para ello, considere: bizagi.scheduler.timer: Propiedad utilizada para indicar al temporizador el intervalo de tiempo en el cual debe ser ejecutado el scheduler de Bizagi. Por defecto el valor asignado es de 30 Segundos. bizagi.scheduler.connection.port: Nmero de puerto asignado al servicio por el cual sern recibidas las peticiones. Por defecto el valor asignado es 5681. bizagi.scheduler.remote.connection.retries: Propiedad que define en caso de presentarse un problema de conexin, el nmero de reintentos mximo para establecer una comunicacin con el servidor de aplicaciones. Por defecto el valor asignado es 3.

2. Copie las libreras cliente para EJB en la ruta <PATH_CONFIGURATION_FILES>/ BizagiSchedulerService/lib/ext/ Estas se encuentran en la ruta de instalacin del servidor de aplicaciones: <WEBLOGIC_HOME>/server/lib/wlclient.jar

3. Configure el archivo de propiedades custom_jndi.properties: java.naming.factory.initial: Propiedad de uso exclusivo de Bizagi que define el contexto del componente cliente que ser utilizado para establecer comunicacin con el servidor de aplicaciones WebSphere. El valor asignado a esta propiedad es: weblogic.jndi.WLInitialContextFactory java.naming.security.principal: Esta propiedad por defecto se encuentra deshabilitada (#). Si en el servidor de aplicaciones se configur seguridad a nivel de aplicacin para establecer comunicacin con componentes externos, se bebe especificar el nombre de usuario creado. java.naming.security.credentials: Esta propiedad por defecto se encuentra deshabilitada (#). Si en el servidor de aplicaciones se configur seguridad a nivel de aplicacin para establecer comunicacin con componentes externos, se bebe especificar el password de usuario creado. ejb.remote.jndi: Propiedad de uso exclusivo de Bizagi en la cual se especifica la direccin (JNDI) utilizada para acceder al servicio remoto de Scheduler que se encuentra en el servidor de aplicaciones Weblogic. o Valor utilizado en la configuracin, tanto para un solo servidor o en un ambiente distribuido:

Copyright 2013 - Bizagi

2605

BizAgiSchedulerBean#com.vision.bizagi.scheduler.BizAgiSchedulerRemote java.naming.provider.url: Propiedad configurable en la cual se especifica el nombre o direccin IP del servidor de aplicaciones. El valor asignado debe cumplir con el siguiente formato: Se define la lista de servidores que hacen parte del clster con su respectivo puerto, todos separados por coma (,): t3://[SERVER_NAME1]:[PORT1],:[SERVER_NAME2]:[PORT2],: [SERVER_NAME3]:[PORT3] Debe ser remplazado [SERVER_NAME1] por el nombre del servidor o direccin IP donde se encuentra una instancia, sea Stand-Alone o Cluster. Igualmente, para [PORT1] por el nmero de puerto de recepcin de peticiones de la instancia del servidor.

Operacin del servicio

Tenga presente que para la operacin del servicio deben estar correctamente definidas las variables de entorno: bizagi.cache.multicast.enabled, bizagi.cache.multicast.address, bizagi.cache.multicast.port, y bizagi.cache.multicast.type (como se indica en la seccin de configuracin de variables de entorno para configurar Weblogic para trabajar en clster).

Para iniciar el servicio, ejecute el archivo start-service como usuario administrador. En Linux OS, este archivo ser: <PATH_CONFIGURATION_FILES>/BizagiSchedulerService/bin/start-service.sh En Windows, este archivo ser: <PATH_CONFIGURATION_FILES>\BizagiSchedulerService\bin\start-service.bat sta operacin crea un proceso javaw.exe el cual se mantiene en ejecucin utilizando el puerto (por defecto 5681) configurado en el archivo scheduler_configuration.properties.

Para detener el servicio, simplemente se debe ejecutar el archivo shutdown-service como usuario administrador. En Linux OS, este archivo ser: <PATH_CONFIGURATION_FILES>/BizagiSchedulerService/bin/shutdown-service.sh En Windows, este archivo ser: <PATH_CONFIGURATION_FILES>\BizagiSchedulerService\bin\shutdown-service.bat

Una vez que complete estos pasos, consulte la Configuracin de la arquitectura del sistema.
7.4.1.2.2 Configuracin estndar de Weblogic

Introduccin
Con la edicin Bizagi Enterprise JEE, sus Procesos se pueden montar sobre diferentes Servidores de Aplicacin JEE (p.e. WebSphere, WebLogic, o JBoss).

2606

Copyright 2013 - Bizagi

El procedimiento de configuracin de cada Servidor de Aplicaciones para trabajar con Bizagi, vara ligeramente de acuerdo a las diferencias en s de cada uno de los servidores. Este artculo se enfoca en la configuracin de Weblogic para trabajar con Bizagi, dirigida a un ambiente de pruebas o de produccin, y en un montaje standalone (sin balanceo de cargas).

Si desea configurar Weblogic en un esquema de alta disponibilidad y con la posibilidad de balanceo de cargas, consulte la Configuracin en clster de Weblogic. Ntese que para el ambiente de desarrollo (con Bizagi Studio), no se requieren pasos de configuracin dado que la edicin de Bizagi Enterprise JEE instala una instancia de JBoss 7.1.1, el cual es embebido y configurado de manera automtica. Tenga en cuenta que lo recomendado es utilizar la instancia por defecto de JBoss en desarrollo, dado que se promueve la agilidad en la implementacin (JBoss es un Servidor ms ligero e inicia o reinicia ms rpido, y para su proyecto no requiere de configuracin adicional). Sin embargo, si su proyecto requiere estrictamente que se utilice Weblogic en el ambiente de desarrollo, siga los pasos a continuacin para ese ambiente tambin.

Prerequisitos
Para configurar su instancia de Weblogic en un ambiente de pruebas o produccin, se requiere: JDK 6, update 31 instalado. La variable de entorno JA VA _H O M E configurada previamente (se recomienda que sea en una ruta sin espacios). Tener a la mano los archivos de configuracin (y de despliegue) requeridos por Bizagi (BizAgi-earWeblogic-dist.zip). Tener instalado el Servidor Weblogic. Las versiones soportadas son las pertenecientes a Weblogic 11g 10.3.6.0.

Copyright 2013 - Bizagi

2607

Weblogic puede descargarse directamente desde la pgina oficial de Oracle. Tenga presente que debe tener el instalador apropiado a su sistema (p.e w ls[v ersio n ]_lin u x 32.b in , w ls [v ersio n ]_w in 32.ex e), y que para su instalacin debe seguir tanto los requisitos de Weblogic, como los lineamientos presentados en la siguiente seccin (p.e la creacin de un dominio).

Requerimientos de Weblogic
Para instalar Weblogic (una vez que haya cubierto todos los prerequisitos), asegrese de considerar lo siguiente: Instalar todos los componentes del Servidor Weblogic.

Seleccionar un JDK pre-instalado (Java home). No se debe instalar el java embebido en el instalador, dado que se debe tener controlado que sea un JDK de versin soportada por Bizagi.

2608

Copyright 2013 - Bizagi

Instalar el servicio de Windows (cuando aplica para el sistema operativo utilizado). Esta ruta de instalacin ser referenciada como < W EB LO GIC_H O M E> en este artculo a partir de este momento. Para una gua completa sobre la instalacin de Weblogic, consulte la documentacin oficial de Oracle. Crear un dominio de usuario Una vez que se haya instalado Weblogic debe tener un dominio de usuario creado para Bizagi. Para ello, puede utilizar las opciones del Inicio rpido ( Ru n Q u ickstart) para que Weblogic asista dicha configuracin. Dentro de estas opciones asistidas, ubique la opcin de Empezar a utilizar Weblogic ( Gettin g started w ith W eb lo g ic Serv er ) y seleccione la opcin de Crear un nuevo dominio ( Create a n ew W eb lo g ic d o m ain ).

Copyright 2013 - Bizagi

2609

Puede optar por usar la opcin de Generar el dominio configurado automticamente ( Gen erate a d o m ain co n fig u red au to m atically). Nota Tenga presente que en la configuracin de dominio deber ingresar un usuario y contrasea que deber recordar para el acceso a la consola administrativa. Para mayor informacin acerca de estos temas de instalacin y primeros pasos consulte la documentacin oficial de Weblogic. Ntese que en este artculo nuestro dominio se llama b izag i_d o m ain .

Opciones de Weblogic
Para iniciar, detener o acceder a la Consola de administracin de Weblogic, consulte la informacin a continuacin.

Iniciar el servidor (dominio)

Para iniciar Weblogic, execute the following file in a command prompt: En Linux: <WEBLOGIC_HOME>/user_projects/domains/<USER_DOMAIN>/bin/startWebLogic.sh

2610

Copyright 2013 - Bizagi

En Windows: <WEBLOGIC_HOME>\user_projects\domains\<USER_DOMAIN>\bin\startWebLogic.cmd Nota En Windows, tambin se puede optar por usar las opciones del men ( O racle W eb lo g ic > User P ro jects > [u ser_d o m ain ] > Start A d m in Serv er).

Asegrese de especifica el usuario y contrasea (tal como fue especificado cuando se cre el dominio de Weblogic).

Copyright 2013 - Bizagi

2611

Detener el servidor (dominio)

Para detener Weblogic, execute the following file in a command prompt: En Linux: <WEBLOGIC_HOME>/user_projects/domains/<USER_DOMAIN>/bin/stopWebLogic.sh En Windows: <WEBLOGIC_HOME>\user_projects\domains\<USER_DOMAIN>\bin\stopWebLogic.cmd Nota En Windows, tambin se puede optar por usar las opciones del men ( O racle W eb lo g ic > User P ro jects > [u ser_d o m ain ] > Start A d m in Serv er).

Acceder a la Consola de administracin

Para acceder a la Consola de administracin de Weblogic, ingrese la siguiente direcccin URL en un navegador: http://localhost:7001/console/login/LoginForm.jsp Recuerde que igualmente requerida ingresar el usuario y contrasea autorizado del dominio.

2612

Copyright 2013 - Bizagi

Lo que debe hacer

Para la configuracin de Weblogic para trabajar con Bizagi, el siguiente procedimiento se lleva a cabo: 1. Extraer los archivos usados por Bizagi hacia Weblogic. 2. Configurar las variables de entorno. 3. Configurar los siguientes mdulos en Weblogic: Autenticacin Acceso a datos Servicio de mensajera (JMS) Libreras compartidas (JSTL, JSF) Otros, tales como el timeout en transacciones, y el usuario administrador por defecto Estos mdulos se configuran en Weblogic utilizando su Consola de administracin, y utilizan a su vez los archivos de Bizagi que se extraen en el primer paso. Despus de estos pasos, su instancia de Weblogic estar configurado para que los Procesos de Bizagi se desplieguen en una aplicacin JEE (el Portal de Trabajo).

Procedimiento
Los siguientes pasos describen a detalle cmo configurar y editar las preferencias de una instalacin de Weblogic por defecto. Nota Realice la configuracin como se indica a continuacin, teniendo en cuenta que los nombres usados

Copyright 2013 - Bizagi

2613

son sensibles a maysculas.

1. Extraer los archivos usados por Bizagi hacia Weblogic

En este paso, se incluyen archivos usados por Bizagi en la instancia de Weblogic (son archivos que no vienen por defecto en la instalacin limpia). Para ello, debe contar con el archivo de distribucin que entrega Bizagi ( B izA g i-ear-W eb lo g ic-d ist.zip). 1.1 Extraer el contenido de este .zip hacia una ruta local. Esta ruta ser referenciada como < P A TH _CO N F IGURA TIO N _F ILES> a partir de este momento. 1.2 Copie las libreras del mdulo de Autenticacin ( B izA g iSecu rity P ro v id er-1.2.jar, B izag iRem o te1.0.jar, B izA g i.Secu rity .Co m m o n -1.0.jar) de los archivos de configuracin, desde esta ruta: <PATH_CONFIGURATION_FILES>\security\ Hacia la ruta de libreras de Weblogic en: <WEBLOGIC_HOME>\wlserver_10.3\server\lib\mbeantypes\ 1.3 Copie los driveres para el acceso a datos, segn el motor de Base de datos (los drivers entregados en los archivos de configuracin), desde esta ruta: <PATH_CONFIGURATION_FILES>\configuration\ Hacia la ruta de libreras de Weblogic. Si utiliza Weblogic 10.3.6.0, la ruta de destino es: <WEBLOGIC_HOME>\wlserver_10.3\server\lib\ Si su proyecto utiliza Oracle, entonces no requiere copiar el driver (ya que el ojdbc6 est incluido por defecto en Weblogic). Lo que si debe hacer, es editar el archivo w eb .co n fig .x m l ubicado en <PATH_CONFIGURATION_FILES>\JiNET\config\ de manera que la llave P RO VIDERTY P E est asignada al uso de Oracle:

Si su proyecto utiliza Microsoft SQL Server, copie el driver sq ljd b c-4.0.jar. 1.4 Copie la librera utilizada para el registro de logs, que se llama lo g 4j-1.2.8.jar (tambin entregada en los archivos de configuracin). Ntese que este paso NO es requerido si se utiliza una Base de datos Oracle (dado que en este escenario, dicha librera se incluye por defecto).

2614

Copyright 2013 - Bizagi

De no ser este su caso, entonces copie la librera de esta ruta: <PATH_CONFIGURATION_FILES>\configuration\ Hacia la ruta de libreras de Weblogic en: <WEBLOGIC_HOME>\user_projects\domains\[your_domain]\lib\ 1.5 Copie las libreras compartidas, principalmente: jsf-m y faces-1.2.8.w ar y eclip selin k-2.5.0.jar (que se entrega en los archivos de configuracin). Copiela de esta ruta: <PATH_CONFIGURATION_FILES>\configuration\ Hacia la ruta de libreras de Weblogic en: <WEBLOGIC_HOME>\wlserver_10.3\common\deployable-libraries\

2. Configurar las variables de entorno

Para configurar las variables que sern referenciadas como parmetros de ejecucin en el Servidor, primero asergrese de que su instancia de Weblogic no est iniciada (debe estar detenido). Seguidamente, edite el archivo de inicio del servicio de Weblogic para asignar las variables necesarias. En Linux: Ubique la siguiente lnea en el archivo < W EB LO GIC_H O M E> /u ser_p ro jects/d o m ain s/ < USER_DO M A IN > /b in /startW eb Lo g ic.sh : JA VA _O P TIO N S= "${SA VE_JA VA _O P TIO N S}" Adicione lo siguiente al final de la misma lnea: -DiNET_HOME=<PATH_CONFIGURATION_FILES>/JiNET -Duser.language=en Duser.country=us -Dfile.encoding=UTF-8 -DAPP_SERV=WEBLOGIC Considere que debe asignar el valor correspondiente a la ruta <PATH_CONFIGURATION_FILES>, y que debe utilizar "/" como el caracter de separacin de ruta.

Adicional a lo anterior, incremente la memoria utilizada en los parmetros por defecto para un mejor desempeo y tiempo de despliegue. Para ello, ubique la siguiente lnea en el mismo archivo: USER_M EM _A RGS=

Copyright 2013 - Bizagi

2615

Asigne los siguientes valores: USER_MEM_ARGS="-Xms768m -Xmx2048m -XX:PermSize=768m -XX:MaxPermSize=2048m" Guarde los cambios y reinicie su Servidor Weblogic. Nota Si est utilizando Weblogic 10.3.6.0 y una Base de datos SQL Server, deber entonces hacer una modificacin adicional a los parmetros de ambiente compartidos, de maneera que se incluya el driver sq ljd b c-4.0.jar en el CLASSPATH de Weblogic. Para hacerlo, edite el archivo <WEBLOGIC_HOME>/wlserver_10.3/common/bin/ commEnv.sh y ubique la lnea que contiene W EB LO GIC_CLA SSP A TH = "${JA VA _H O M E} . Adicione: ${W L_H O M E}/serv er/lib /sq ljd b c-4.0.jar como una dependencia en el archivo (usando el caracter apropiado de separacin cuando se definen mltiples parmetros).

En Windows: Ubique la siguiente lnea en el archivo <WEBLOGIC_HOME>\user_projects\domains\<USER_DOMAIN>\bin\startWebLogic.cmd: set JA VA _O P TIO N S= % SA VE_JA VA _O P TIO N S% Adicione lo siguiente al final de la misma lnea: -DiNET_HOME=<PATH_CONFIGURATION_FILES>\JiNET -Duser.language=en Duser.country=us -Dfile.encoding=UTF-8 -DAPP_SERV=WEBLOGIC Considere que debe asignar el valor correspondiente a la ruta <PATH_CONFIGURATION_FILES>, y que debe utilizar "/" como el caracter de separacin de ruta.

2616

Copyright 2013 - Bizagi

Adicional a lo anterior, incremente la memoria utilizada en los parmetros por defecto para un mejor desempeo y tiempo de despliegue. Para ello, ubique la siguiente lnea en el mismo archivo: set USER_M EM _A RGS= Asigne los siguientes valores: set USER_MEM_ARGS=-Xms768m -Xmx2048m -XX:PermSize=768m -XX: MaxPermSize=2048m Guarde los cambios y reinicie su Servidor Weblogic.

Note Si est utilizando Weblogic 10.3.6.0 y una Base de datos SQL Server, deber entonces hacer una modificacin adicional a los parmetros de ambiente compartidos, de maneera que se incluya el driver sq ljd b c-4.0.jar en el CLASSPATH de Weblogic. Para hacerlo, edite el archivo <WEBLOGIC_HOME>\wlserver_10.3 \common\bin\commEnv.cmd y ubique la lnea que contiene W EB LO GIC_CLA SSP A TH = % JA VA _H O M E% . Adicione: % W L_H O M E% \serv er\lib \sq ljd b c-4.0.jar como una dependencia en el archivo (usando el caracter apropiado de separacin cuando se definen mltiples parmetros).

3. Configurar los mdulos de Weblogic

Copyright 2013 - Bizagi

2617

Se deben configurar algunos mdulos en Weblogic a travs de la Consola de administracin, como se indica a continuacin. Nota Ntese que para editar esta configuracin, puede requerir primero utilizar el botn de Desbloqueo y edicin ( Lo ck & Ed it b u tto n ) ubicado en la esquina superior izquierda. Al final de los pasos, igualmente asegrese de aplicar los cambios y liberar el bloqueo (haciendo clic en A ctiv ate ch an g es y al finalizar, clic en Release co n fig u ratio n ). Despus de realizar cambios, Weblogic puede indicar que se requiere de un reinicio del servicio. 3.1 Autenticacin Acceda la Consola de administracin, y vaya a la seccin Secu rity Realm s y seleccione el item del mbito de dominio ( m y realm ).

Seleccione la pestaa de Proveedores P ro v id ers y luego la pestaa de Autenticacin ( A u th en ticatio n ). Cree un nuevo item dando clic sobre el botn Nuevo ( N ew ).

2618

Copyright 2013 - Bizagi

Ingrese BizagiAuthenticator como el Nombre ( N am e) del Proveedor y seleccione BizagiAuthenticator como el tipo ( Ty p e) de Proveedor de Autenticacin.

Copyright 2013 - Bizagi

2619

De clic en O K. De vuelta en la lista de Proveedores de Autenticacin, asegrese de seleccionar B izA g iA u th en ticato r para que sea el primer item. Esto se requiere dado que el nuevo Proveedor opera en un contexto compartido. Use la opcin de reordenar (botn Reo rd er) para mover B izA g iA u th en ticato r hasta la cima de la lista.

2620

Copyright 2013 - Bizagi

De clic en O K. B izA g iA u th en ticato r debe aparecer de primero, y de clic sobre l. Cambie la configuracin de control ( Co n tro l F lag ) a el valor: SUFFICIENT (seleccinelo del combo de opciones y de clic en Guardar -- Sav e--).

Copyright 2013 - Bizagi

2621

Finalmente, active los cambios. 3.2 Acceso de datos Antes de continuar con esta configuracin, tenga presente que al utilizar una Base de datos SQL Server, se requiere que el servicio de la instancia no se inicie bajo un puerto dinmico. Se requiere que el puerto TCP/IP del servicio est predefinido explcitamente (p.e el 1433 por defecto).

Para la siguiente configuracin, acceda la Consola de administracin y tenga en cuenta que la configuracin vara ligeramente de acuerd al motor de Base de datos de su proyecto (Oracle o SQL Server). Vaya a la seccin de Servicios ( Serv ices) y de clic sobre fuentes de datos ( Data So u rces).

2622

Copyright 2013 - Bizagi

Cree una nueva fuente de datos dando clic sobre Nuevo ( N ew ) y especificando que es una fuente de datos de tipo genrica ( Gen eric Data So u rce).

Para la fuente de datos, especifique: Primero ingrese BizAgiJava tanto para el Nombre ( N am e) como para el Nombre JNDI ( JN DI N am e) .

Copyright 2013 - Bizagi

2623

Para Oracle Seleccione Oracle como el tipo de Base de datos ( Datab ase ty p e). De clic en Siguiente ( N ex t) y seleccione el driver Oracles Driver (Thin) for instance connections; Versions: 9.0.1 and later ( Datab ase Driv er).

2624

Copyright 2013 - Bizagi

De clic en Siguiente ( N ex t). Para SQL Server Seleccione MS SQL Server como el tipo de Base de dato ( Datab ase ty p e). De clic en Siguiente ( N ex t) y seleccione el driver Microsoft's MS SQL Server Driver (Type 4) Versions:2005 and later ( Datab ase Driv er).

Copyright 2013 - Bizagi

2625

De clic en Siguiente ( N ex t). En las opciones de transaccin ( Tran sactio n O p tio n s), asegrese de marcar la casilla de Supports Global Transactions. Seleccione igualmente lo siguiente de acuerdo a su versin de Weblogic: Si utiliza Weblogic 10.3.6.0, marque Emulate Two-Phase Commit. De clic en Siguiente ( N ex t) y especifique el detalle de conexin a su Base de datos. De clic nuevamente en Siguiente ( N ex t). Verifique la conexin a su Base de datos, utilizando la opcin de Probar ( Test Co n fig u ratio n ). Ntese que tambin puede revisar la URL de la cadena de conexin.Una vez que esta verificacin sea exitosa, de clic en Siguiente ( N ex t).

2626

Copyright 2013 - Bizagi

Revise que esta fuente de datos sea aplicada en su Servidor de aplicaciones y de clic en Finalizar ( F in ish ). Finalmente, asegrese de aplicar los cambios. 3.3 Servicio de mensajera (JMS) En los siguientes pasos vamos a configurar un Servidor JMS que se utiliza por Bizagi para las Actividades Ascronas. Para hacerlo, acceda la Consola de administracin y vaya a la seccin de Servicios ( Serv ices). De clic sobre el enlace de Mensajera ( M essag in g ).

Copyright 2013 - Bizagi

2627

Servidor JMS De clic en Servidores JMS ( JM S Serv ers) y sobre Nuevo ( N ew ). A travs de las opciones del nuevo Servidor JMS, cree un nuevo almacn de persistencia dando clic sobre Create a N ew Sto re .

Para el tipo de almacn, seleccione File Store. De clic en Siguiente ( N ex t).

En sus propiedades, ingrese el nombre ( N am e): FileStore-BizAgi. Seleccione AdminServer (como el destino -- Targ et--), y especifique un directorio vlido para persistir la informacin. Haga clic en O k.

2628

Copyright 2013 - Bizagi

De vuelta en la informacin del nuevo Servidor JMS (habiendo creado ya el almacn de persistencia tipo archivo), ingrese: JMSServer-BizAgi para el Nombre ( N am e) y seleccione el almacn creado de las opciones del combo. De clic en Siguiente ( N ex t).

Copyright 2013 - Bizagi

2629

Finalmente, seleccione AdminServer como la instancia de servidor destino( Targ et) . De clic en Finalizar ( F in ish ).

En la lista de Servidores JMS, de clic sobre el recin creado JM SServ er-B izA g i para editar su propiedad Ex p iratio n Scan In terv al. Asgnele el valor de 120 segundos.

2630

Copyright 2013 - Bizagi

De clic en Guardar ( Sav e) y active los cambios.. Mdulo JMS Navegue a la seccin de Servicios ( Serv ices) y expanda la opcin de Mensajera ( M essag in g ). . De clic sobre JM S M o d u les y en Nuevo (N ew ) para registrar un mdulo JMS.

Ingrese: SystemModule-BizAgi en el nombre ( N am e). No se requiere informacin adicional; de clic en Siguiente ( N ex t).

Copyright 2013 - Bizagi

2631

Marque la casilla de la instancia de Servidor A d m in Serv er.

De clic en Siguiente ( N ex t) y en Finalizar ( F in ish ) en este siguiente paso. En la lista de mdulos JMS, de clic sobre el recin creado Sy stem M o d u le-B izA g i para editar sus propiedades, Dentro de las mismas, cree 2 nuevos recursos de la siguiente manera.

2632

Copyright 2013 - Bizagi

Para crear y asociarle el recurso, de clic sobre Nuevo ( N ew ) desde la tabla de resumen de recursos ( Su m m ary o f Reso u rces). Para el primer recurso, seleccione Connection Factory como el tipo ( Ty p e).

De clic en Siguiente ( N ex t) e ingrese: AsyncControllerFactory tanto en el Nombre ( N am e), como en el Nombre JNDI ( JN DI N am e). Asegrese de marcar la casilla que activa el uso de XA Co n n ectio n F acto ry En ab led y de clic en Finalizar ( F in ish ).

Copyright 2013 - Bizagi

2633

Para el segundo recurso que se crea, seleccione Queue como el tipo ( Ty p e).

2634

Copyright 2013 - Bizagi

De clic en Siguiente ( N ex t) e ingrese: AsyncController en el Nombre ( N am e). Ingrese jms/AsyncController en el Nombre JNDI ( JN DI N am e) y de clic en Siguiente ( N ex t).

De clic en Siguiente ( N ex t) y cree una configuracin de subdeployment (clic sobre Create a N ew Su b d ep lo y m en t en la opcin de Su b d ep lo y m en ts). Para la configuracin del Su b d ep lo y m en t, ingrese AsyncController en el Nombre ( N am e) y de clic en O K.

Copyright 2013 - Bizagi

2635

Asegrese que el nuevo Su b d ep lo y m en t sea seleccionado en el combo, y marque la casilla del servidor destino JMSServer-BizAgi ( JM S Serv er targ et) De clic en Finalizar ( F in ish ).

En la lista de los recursos, de clic sobre el recin creado A sy n cCo n tro ller Q u eu e para editar sus propiedades, De clic en la pestaa de manejo de fallas en la entrega ( Deliv ery F ailu re) para configurar el manejo de reintentos cuando algn mensaje no pueda ser entregado.

2636

Copyright 2013 - Bizagi

Especifique 1 como el lmite de reintentos ( Red eliv ery Lim it) y de clic en Guardar ( Sav e). De esta manera, el Servidor de Aplicaciones hara un reintento para las Actividades Asncronas a nivel de colas (lo cual quiere decir que se respetara la configuracin de reintentos de la Asncrona en Bizagi).

Finalmente, recuerde activar los cambios. 3.4 Libreras compartidas Acceda la Consola de administracin y vaya a la seccin de despliegues ( Dep lo y m en ts). Instale 4 libreras compartidas ( jstl-1.2.w ar, jsf-1.2.w ar, jsf-m y faces-1.2.8.w ar y eclip selin k-2.5.0.jar) como se indica a continuacin.

Copyright 2013 - Bizagi

2637

Para la primera, de clic en Instalar ( In stall) y navegue hacia la ruta donde se encuentran estas librerias desplegables. La ruta es la correspondiente a <WEBLOGIC_HOME>\wlserver_10.3 \common\deployable-libraries\. Marque la librera jsf-1.2.w ar .

De clic en Siguiente ( N ex t). Seleccione la opcin de Instalarla como una librera ( In stall th is d ep lo y m en t as lib rary). De clic en Siguiente ( N ex t y luego en Finalizar ( F in ish ).

2638

Copyright 2013 - Bizagi

Para la segunda, repita los pasos de Instalacin (la opcin In stall) pero esta vez marque la librera jsfm y faces-1.2.8.w ar (ubicada en la misma ruta: <WEBLOGIC_HOME>\wlserver_10.3 \common\deployable-libraries\).

Para la tercera, repita los pasos de Instalacin (la opcin In stall) pero esta vez marque la librera jstl1.2.w ar (ubicada en la misma ruta: <WEBLOGIC_HOME>\wlserver_10.3\common\deployablelibraries\).

Copyright 2013 - Bizagi

2639

Para la cuarta, repita los pasos de Instalacin (la opcin In stall) pero esta vez marque la librera eclip selin k-2.5.0.jar (ubicada en la misma ruta: <WEBLOGIC_HOME>\wlserver_10.3 \common\deployable-libraries\).

Una vez haya instalado estas 4 libreras desplegables, se listarn inmediatamente. Recuerde activar los cambios.

3.5 Parmetros de transaccin (JTA) y usuario administrador por defecto Para la configuracin de parmetros de transaccin (Java Transaction API) slo necesitamos aumentar el tiempo lmite asignado por defecto de la transaccin (timeout). Para hacerlo, acceda la Consola de administracin y vaya a la seccin de Servicios ( Serv ices). Seleccione JTA y edite la propiedad Tim eo u t seco n d s para asignarle 120 segundos.

2640

Copyright 2013 - Bizagi

De clic en Guardar ( Sav e) y active los cambios. En este punto, debe reiniciar su servicio de Weblogic.

Usuario administrador Para configurar el usuario administrador por defecto de Bizagi, es necesario crear el usuario ad m o n del dominio d o m ain . Para ello, acceda la Consola de admnistracin y vaya a la seccin Secu rity realm s y de clic en el mbito de dominio ( m y realm ). Ubique la pestaa de Usuarios y grupos ( Users an d Gro u p s), y cree el nuevo usuario dando clic sobre Nuevo ( N ew ).

Copyright 2013 - Bizagi

2641

Ingrese la siguiente informacin para el usuario administrador N am e: Si utiliza Weblogic 10.3.6.0, el nombre del usuario deber ser: ad m o n . Descrip tio n : Bizagi administrator user P ro v id er: DefaultAuthenticator P assw o rd: bizagi$91

2642

Copyright 2013 - Bizagi

De clic en O K.

Qu sigue?
Despus de estos pasos, su instalacin de Weblogic est configurada para albergar Procesos Bizagi! Puede ahora iniciar su servidor y hacer generar el Portal de Trabajo (un despliegue de aplicacin). Para ms informacin sobre esta opcin, consulte el despliegue de la aplicacin hacia Weblogic. 7.4.1.3 Configuracin de JBoss La configuracin de un servidor JBoss hace parte de la configuracin para Configurar un Servidor de Aplicaciones JEE, como un paso requerido al crear el Portal de trabajo de Bizagi en la edicin Enterprise JEE (para ambientes de pruebas o produccin). La configuracin de JBoss vara de acuerdo a si la configuracin de la solucin tendr un esquema de alta disponibilidad o no (si se involucra o no ms de una instancia de JBoss en un clster).

Copyright 2013 - Bizagi

2643

Para una gua sobre cmo configurar JBoss para trabajar con Bizagi como instancia standalone (setup estndar), consulte Configuracin estndar de JBoss.

7.4.1.3.1 Configuracin estndar de JBoss

Introduccin
Con la edicin Bizagi Enterprise JEE, sus Procesos se pueden montar sobre diferentes Servidores de Aplicacin JEE (p.e. WebSphere, WebLogic, o JBoss). El procedimiento de configuracin de cada Servidor de Aplicaciones para trabajar con Bizagi, vara ligeramente de acuerdo a las diferencias en s de cada uno de los servidores. Este artculo se enfoca en la configuracin de JBoss para trabajar con Bizagi, dirigida a un ambiente de pruebas o de produccin, y en un montaje standalone (sin balanceo de cargas).

2644

Copyright 2013 - Bizagi

Ntese que para el ambiente de desarrollo (con Bizagi Studio), no se requieren pasos de configuracin dado que la edicin de Bizagi Enterprise JEE instala una instancia de JBoss 7.1.1, el cual es embebido y configurado de manera automtica. Para ms informacin sobre JBoss 7, su descarga y sus requerimientos, consulte la pgina oficial de JBoss.

Prerequisitos
Para configurar su instancia de WebSphere en un ambiente de pruebas o produccin, se requiere: JDK 6, update 31 instalado. La variable de entorno JAVA_HOME configurada previamente (se recomienda que sea en una ruta sin espacios). Tener a la mano los archivos de configuracin (y de despliegue) requeridos por Bizagi (BizAgi-earJBoss-dist.zip). Tener instalado el Servidor JBoss. La versin soportada es JBoss 7.1.1. Mayor informacin en la pgina oficial de JBoss (p.e de requerimientos de sistema). JBoss puede ser descargado directamente desde Sourceforge.net. La variable de entorno JBOSS_HOME configurada previamente.

Acerca de JBoss
Instalar JBoss (una vez se tengan cubiertos los prerequisitos) solo requiere de extraer el contenido del descargable ( jb o ss-as-7.1.1.F in al.zip) en una ruta local del Servidor. Se requiere que esta ruta local no contenga espacios en blanco. La ruta local donde se extrae JBoss ser referenciada en este artculo como <JBOSS_HOME> a partir

Copyright 2013 - Bizagi

2645

de este momento. Para conocer ms detalle sobre el proceso de instalacin de JBoss, consulte la documentacin oficial de JBoss. Para los servicios de JBoss (iniciar, reiniciar o detener), siga las indicaciones a continuacin.

Iniciar el servidor Para iniciar el Servidor de Aplicaciones JBoss, ubique la ruta < JB O SS_H O M E> /b in y ejecute el archivo stan d alo n e. En Linux, ejecute standalone.sh en una consola de comandos con los siguientes parmetros: standalone.sh -b 0.0.0.0 En Windows, ejecute standalone.bat en una consola de comandos con los siguientes parmetros: standalone.bat -b 0.0.0.0

Valide que JBoss se haya iniciado y se est ejecutando, ingresando la siguiente URL en un navegador: http://localhost:8080/ La siguiente pgina inicial debe cargarse:

2646

Copyright 2013 - Bizagi

Ntese que el puerto 8080 corresponde al configurado para atender las solicitudes http.

Detener el servidor Para detener el servicio de JBoss existen 2 opciones: Utilizar el comando de terminar un proceso (CTRL+C) en la consola de comandos que ejecut el inicio de JBoss. Ubicar la carpeta < JB O SS_H O M E> /b in y ejecutar el archivo jb o ss-cli . Para esta segunda opcin, en Linux ejecute jb o ss-cli.sh en una consola de comando con los siguientes parmetros: jboss-cli.sh --connect command=:shutdown Para esta segunda opcin, en Windows ejecute jb o ss-cli.b at en una consola de comando con los siguientes parmetros: jboss-cli.bat --connect command=:shutdown

Lo que debe hacer

Para configurar JBoss 7.1.1 se lleva a cabo lo siguiente: 1. Extraer los archivos usados por Bizagi hacia JBoss. 2. Configurar las variables de entorno. 3. Configurar los siguientes mdulos en JBoss: Autenticacin Acceso a datos Servicio de mensajera (JMS) Parmetros de transaccin (JTA) Estos mdulos se configuran en JBoss utilizando los archivos de Bizagi que se extraen en el primer paso. Despus de estos pasos, su instancia de JBoss estar configurado para que los Procesos de Bizagi se

Copyright 2013 - Bizagi

2647

desplieguen en una aplicacin JEE (el Portal de Trabajo).

Procedimiento
Los siguientes pasos describen a detalle cmo configurar una instalacin de JBoss por defecto.

Nota Realice la configuracin como se indica a continuacin, teniendo en cuenta que los nombres usados son sensibles a maysculas.

1. Extraer los archivos usados por Bizagi hacia WebSphere

En este paso, se incluyen archivos usados por Bizagi en la instancia de JBoss (son archivos que no vienen por defecto en la instalacin limpia). Para ello, debe contar con el archivo de distribucin que entrega Bizagi ( B izA g i-ear-JB o ss-d ist.zip). 1.1 Extraer el contenido de este .zip hacia una ruta local sin espacios. Esta ruta ser referenciada como < P A TH _CO N F IGURA TIO N _F ILES> a partir de este momento. Esto crear una carpeta llamada "BizagiBPMJEE":

Ntese que en nuestro caso <PATH_CONFIGURATION_FILES> referencia la ruta E:\JBOSS7\.

2648

Copyright 2013 - Bizagi

El zip descomprimido provee la siguientes estructura y archivos:

1.1 Extraer el contenido de BizagiJbossModules.zip Ubique el archivo B izag iJb o ssM o d u les.zip contenido dentro de la carpeta "BizagiBPMJEE/ configuration" dentro <PATH_CONFIGURACION_FILES>.

Copyright 2013 - Bizagi

2649

Al extraer estos archivos, especifique que la ruta destino sea < JB O SS_H O M E> /m o d u les/.

Esto significa que al final, tendremos en < JB O SS_H O M E> /m o d u les/ los siguientes archivos en " co m " y " o rg" (de la instalacin JBoss):

2650

Copyright 2013 - Bizagi

La siguiente imagen ilustra el detalle de los archivos extrados haci JBoss. En la vista de la izquierda (1), se aprecia la estructura inicial antes de los cambios:

Copyright 2013 - Bizagi

2651

2. Configurar las variables de entorno

En una instalacin por defecto de JBoss se deben configurar las variables de entorno requeridas por Bizagi para el inicio del servicio.Esto es: incluir la ruta del componente JiNet, y ajustar la asignacin de memoria en JBoss. Para ello, edite el archivo de configuracin del ejecutable.

2652

Copyright 2013 - Bizagi

En Linux Edite el archivo < JB O SS_H O M E> /b in /stan d alo n e.co n f de acuerdo a lo siguiente: Incluya estas lneas al final del archivo: # Bizagi Configuration JAVA_OPTS="$JAVA_OPTS -DiNET_HOME=<PATH_CONFIGURATION_FILES>/BizagiBPMJEE/ JiNET DAPP_SERV=JBOSS" JAVA_OPTS="$JAVA_OPTS -Xms512m -Xmx1024m -XX:MaxPermSize=1024m"

Tenga en cuenta que se debe utilizar slash (/) como separador de ruta, en cambio del back-slash. En la segunda lnea se asigna 512MB para el tamao de memoria mnimo inicial y 1024MB para la memoria mxima. Al finalizar, el archivo < JB O SS_H O M E> /b in /stan d alo n e.co n f deber verse de esta manera:

Copyright 2013 - Bizagi

2653

En Windows Edite el archivo <JBOSS_HOME>/bin/standalone.conf.bat de acuerdo a lo siguiente: Ubique la lnea que contiene "JVM m em o ry allo catio n " (aprximadamente sobre la lnea nmero 49). Incluya esta lnea donde se asigna 512MB para el tamao de memoria mnimo inicial y 1024MB para la memoria mxima. set "JAVA_OPTS=-Xms512M -Xmx1024M -XX:MaxPermSize=1024M" Ubique la lnea que contiene "Red u ce th e RM I GCs..." (aprximadamente sobre la lnea nmero 52), y agregue al final de la misma: -DiNET_HOME=<PATH_CONFIGURATION_FILES>/BizagiBPMJEE/JiNET DAPP_SERV=JBOSS Tenga en cuenta que se debe utilizar slash (/) como separador de ruta, en cambio del back-slash. Al incluir esta parte, la lnea completa quedar como: set "JAVA_OPTS=%JAVA_OPTS% -Dsun.rmi.dgc.client.gcInterval=3600000 Dsun.rmi.dgc.server.gcInterval=3600000 -Djava.net.preferIPv4Stack=true DiNET_HOME=<BIZAGI_JEE_HOME>/ DAPP_SERV=JBOSS

Al finalizar, el archivo <JBOSS_HOME>/bin/standalone.conf.bat deber verse de esta manera:

2654

Copyright 2013 - Bizagi

3. Configurar los mdulos de JBoss

Se deben configurar algunos mdulos en el servicio standalone de JBoss, editando el archivo ubicado como "<JBOSS_HOME>/standalone/configuration/standalone.xml" 3.1 Autenticacin Para la configuracin de Autenticacin, incluya las siguientes lneas en el archivo standalone.xml: <security-domain name="BizAgiRealm" cache-type="default"> <authentication> <login-module code="com.bizagi.security.jaas.BizAgiLoginModule" flag="required" module="com.bizagi.security"/> </authentication> </security-domain> Estas lneas deben ir dentro del elemento <security-domains> dentro de la seccin "<subsystem xmlns="urn:jboss:domain:security:1.1">". En este punto, el archivo standalone.xml se ver de la siguiente manera:

Copyright 2013 - Bizagi

2655

3.2 Acceso a datos Para incluir los drivers para el acceso a datos en JBoss, incluya las siguientes lneas en el archivo standalone.xml: <driver name="MICROSOFTSQLSERVER" module="com.microsoft.sqlserver"> <driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driverclass> </driver> <driver name="ORACLE" module="com.oracle.ojdbc6"> <driver-class>oracle.jdbc.driver.OracleDriver</driver-class> </driver> Estas lneas deben ir dentro del elemento "<drivers>". En este punto, el archivo standalone.xml se ver de la siguiente manera:

Una vez se registren los drivers, configuramos la fuente de datos del proyecto. Este paso vara ligeramente de acuerdo al motor de Base de datos usado por el proyecto (Oracle or SQL Server).

o Para Oracle Adicione las siguientes lneas en el archivo standalone.xml para ingresar el detalle de la conexin a su Base de datos Oracle: <datasource jta="true" jndi-name="java:/BizAgiJava" pool-name="BizAgiJava" enabled="true" use-ccm="true"> <connection-url>jdbc:oracle:thin:@//[databaseServer]:[servicePort]/ [serviceName]</connection-url> <driver>ORACLE</driver> <transaction-isolation>TRANSACTION_READ_COMMITTED</transactionisolation> <security> <user-name>[schemaUser]</user-name> <password>[schemaUserPassword]</password> </security>

2656

Copyright 2013 - Bizagi

<validation> <validate-on-match>false</validate-on-match> <background-validation>false</background-validation> </validation> <statement> <share-prepared-statements>false</share-prepared-statements> </statement> </datasource> Estas lneas deben ir dentro del elemento "<datasources>" de la seccin "<subsystem xmlns="urn: jboss:domain:datasources:1.0">". Asigne los valores correspondientes, considerando: [databaseServer]: El Servidor de Base de datos de la instancia Oracle. [servicePort]: El nmero del puerto bajo el cual el servicio atiende (por defecto es el 1521). [serviceName]: El ID de la instancia de Oracle. [schemaUser]: El nombre del esquema de usuario en Oracle, que representa el proyecto de Bizagi. [schemaUserPassword]: La contrasea para ese esquema de usuario.

En este punto, el archivo standalone.xml se ver de la siguiente manera:

o Para SQL Server Adicione las siguientes lneas en el archivo standalone.xml para ingresar el detalle de la conexin a su Base de datos SQL Server: <datasource jta="true" jndi-name="java:/BizAgiJava" pool-name="BizAgiJava" enabled="true" use-ccm="true"> <connection-url>jdbc:sqlserver://[databaseServerInstance]: [instancePort];databaseName=[SQLdatabase]</connection-url> <driver>MICROSOFTSQLSERVER</driver>

Copyright 2013 - Bizagi

2657

<transaction-isolation>TRANSACTION_READ_COMMITTED</transactionisolation> <security> <user-name>[userLogin]</user-name> <password>[userLoginPassword]</password> </security> <validation> <validate-on-match>false</validate-on-match> <background-validation>false</background-validation> </validation> <statement> <share-prepared-statements>false</share-prepared-statements> </statement> </datasource> Estas lneas deben ir dentro del elemento "<datasources>" de la seccin "<subsystem xmlns="urn: jboss:domain:datasources:1.0">". Asigne los valores correspondientes, considerando: [databaseServerInstace]: El Servidor de Base de datos SQL Server, con el nombre de la instancia si aplica. [instancePort]: El nmero del puerto bajo el cual la instancia SQL Server atiende (por defecto es el 1433). [SQLdatabase]: El nombre de la Base de datos que corresponde al proyecto de Bizagi. [userLogin]: La cuenta login para acceder a la instancia de SQL Server. [userLoginPassword]: La contrasea para la cuenta login.

En este punto, el archivo standalone.xml se ver de la siguiente manera:

3.3 Servicio de mensajera (JMS) Para incluir el mdulo de servicio de mensajera en JBoss, incluya las siguientes lneas en el archivo

2658

Copyright 2013 - Bizagi

standalone.xml: <extension module="org.jboss.as.messaging"/> Estas lneas deben ir dentro del elemento "<extensions>". En este punto, el archivo standalone.xml se ver de la siguiente manera:

Seguidamente, incluya las siguientes lneas dentro de la seccin "<subsystem xmlns="urn:jboss: domain:ejb3:1.2">": <mdb> <resource-adapter-ref resource-adapter-name="hornetq-ra"/> <bean-instance-pool-ref pool-name="mdb-strict-max-pool"/> </mdb> En este punto, el archivo standalone.xml se ver de la siguiente manera:

Copyright 2013 - Bizagi

2659

Luego, incluya estas lneas de registro del subsistema dentro del elemento "<profile>": <subsystem xmlns="urn:jboss:domain:messaging:1.1"> <hornetq-server> <persistence-enabled>false</persistence-enabled> <security-enabled>false</security-enabled> <journal-type>NIO</journal-type> <journal-file-size>102400</journal-file-size> <journal-min-files>2</journal-min-files> <connectors> <netty-connector name="netty" socket-binding="messaging"/ > <netty-connector name="netty-throughput" socketbinding="messaging-throughput"> <param key="batch-delay" value="50"/> </netty-connector> <in-vm-connector name="in-vm" server-id="0"/> </connectors> <acceptors> <acceptor name="stomp-acceptor"> <factoryclass>org.hornetq.core.remoting.impl.netty.NettyAcceptorFactory</factoryclass> <param key="protocol" value="stomp"/> <param key="port" value="61613"/> </acceptor> <netty-acceptor name="netty" socket-binding="messaging"/> <netty-acceptor name="netty-throughput" socketbinding="messaging-throughput"> <param key="batch-delay" value="50"/> <param key="direct-deliver" value="false"/> </netty-acceptor> <in-vm-acceptor name="in-vm" server-id="0"/> </acceptors> <security-settings> <security-setting match="#">

2660

Copyright 2013 - Bizagi

<permission type="send" roles="guest"/> <permission type="consume" roles="guest"/> <permission type="createNonDurableQueue" roles="guest"/> <permission type="deleteNonDurableQueue" roles="guest"/> </security-setting> </security-settings> <address-settings> <address-setting match="#"> <dead-letter-address>jms.queue.DLQ</dead-letteraddress> <expiry-address>jms.queue.ExpiryQueue</expiryaddress> <redelivery-delay>0</redelivery-delay> <max-size-bytes>10485760</max-size-bytes> <address-full-policy>BLOCK</address-full-policy> <message-counter-history-day-limit>10</messagecounter-history-day-limit> </address-setting> </address-settings> <jms-connection-factories> <connection-factory name="InVmConnectionFactory"> <connectors> <connector-ref connector-name="in-vm"/> </connectors> <entries> <entry name="java:/ConnectionFactory"/> </entries> </connection-factory> <connection-factory name="RemoteConnectionFactory"> <connectors> <connector-ref connector-name="netty"/> </connectors> <entries> <entry name="RemoteConnectionFactory"/> </entries> </connection-factory> <connection-factory name="AsyncControllerFactory"> <connectors> <connector-ref connector-name="netty"/> </connectors> <entries> <entry name="/AsyncControllerFactory"/> </entries> </connection-factory> <pooled-connection-factory name="hornetq-ra"> <transaction mode="xa"/> <connectors> <connector-ref connector-name="in-vm"/> </connectors> <entries> <entry name="java:/JmsXA"/>

Copyright 2013 - Bizagi

2661

</entries> </pooled-connection-factory> </jms-connection-factories> <jms-destinations> <jms-queue name="testQueue"> <entry name="queue/test"/> </jms-queue> <jms-queue name="AsyncController"> <entry name="jms/AsyncController"/> </jms-queue> <jms-topic name="testTopic"> <entry name="topic/test"/> </jms-topic> </jms-destinations> </hornetq-server> </subsystem> Al editarlo, el archivo se ver de la siguiente manera:

2662

Copyright 2013 - Bizagi

Copyright 2013 - Bizagi

2663

Finalmente, incluya las siguientes lneas dentro del elemento "<socket-binding-group>": <socket-binding name="messaging" port="5445"/> <socket-binding name="messaging-throughput" port="5455"/> En este punto, el archivo standalone.xml se ver de la siguiente manera:

3.5 Parmetros de transaccin (JTA) Para incluir el mdulo de JTA y su configuracin en JBoss, incluya las siguientes lneas en el archivo standalone.xml: <system-properties> <property name="com.arjuna.ats.arjuna.allowMultipleLastResources" value="true"/> </system-properties> Estas lneas deben ir despus del elemento "<extensions>". Guarde los cambios. En este punto hemos finalizado con la edicin y configuracin del archivo standalone.xml y deber verse en esta parte como se ilustra:

2664

Copyright 2013 - Bizagi

Qu sigue?
Despus de estos pasos, su instalacin de JBoss est configurada para albergar Procesos Bizagi! Puede ahora iniciar su servidor y hacer generar el Portal de Trabajo (un despliegue de aplicacin). Para ms informacin sobre esta opcin, consulte el despliegue de la aplicacin hacia JBoss. Tenga en cuenta que si su proyecto utiliza Replicacin o Virtualizacin (como mtodos de integracin en la solucin Bizagi), entonces para su ambiente de produccin deber configurar la Replicacin o Virtualizacin directamente en el Servidor de Aplicaciones JEE. Para ms informacin sobre esta opcin, consulte Cmo configurar Replicacin o Virtualizacin en un Servidor de Aplicaciones JEE.

7.4.2

Configuracin de la arquitectura del sistema

Introduccin
Copyright 2013 - Bizagi 2665

Bizagi cuenta con una arquitectura la cual ofrece los componentes necesarios para instalar la solucin en una arquitectura de sistema multi-capa. Dentro de la configuracin de la infraestructura (arquitectura del sistema), puede optar por desplegar la solucin en una arquitectura de 3 de 2 capas. Ambas opciones estn diseadas para trabajar de acuerdo a mejores prcticas de ambientes corporativos. Esto se debe a que Bizagi provee un set de servicios de renderizacin, los cuales le permiten a las aplicaciones cliente desplegar las interfaces de usuario de una manera ptima y de acuerdo al dispositivo desde donde se accede Bizagi (p.e, sea una tableta o dispositivo mvil, o un pc).

La diferencia entre estas 2 opciones se basa en la configuracin de una capa de presentacin adicional. Dicha capa se configura en un servidor Web (Apache HTTP Server) de manera que sta se encarga de almacenar el contenido esttico Web que se utiliza por el Portal de trabajo de Bizagi (p.e, archivos css, js, imgenes, etc). El beneficio de configurar esta capa adicional est en la posibilidad de separar estos recursos estticos, de forma que el Servidor BPM se dedique nicamente a atender las solicitudes dinmicas (una configuracin distribuda).

Arquitectura de sistema en tres capas

Esta solucin aplica para la edicin Bizagi JEE, e involucra lo siguiente: Servidor de Base de datos (provisto en la capa de acceso de datos). En aplicaciones de misin crtica y para un esquema de alta disponibilidad de la solucin, se recomienda configurar ms de un nodo para la Base de datos, de manera que se cuente con tolerancia a fallos. Las posibilidad de la tolerancia a fallos y su configuracin (p.e, tener un esquema activo-pasivo) es provista por los diferentes motores de Base de datos. Servidor BPM Bizagi (provisto en la capa BPM). En aplicaciones de misin crtica y para un esquema de alta disponibilidad de la solucin, se recomienda configurar ms de un nodo para el Servidor BPM, de manera que se cuente con capacidades de balanceo de cargas.

2666

Copyright 2013 - Bizagi

Para el balanceo de cargas, Bizagi soporta tanto balanceadores en hardware o software, y se recomienda el uso de un balanceador de cargas por hardware (p.e F5). Bizagi no provee como tal el balanceador de cargas. Bizagi soporta cualquier algoritmo que se configure para el balanceo de cargas (esta configuracin se realiza de manera independiente), y se requiere que se habilite el uso de sesiones pegajosas (sticky sessions). Para ms informacin sobre la configuracin del balanceador de cargas, consulte Configuracin de balanceo de cargas. Para configurar los componentes de Bizagi en el Servidor BPM, configure su Servidor de Aplicaciones JEE de acuerdo a Configurar un Servidor de Aplicaciones JEE para trabajar con Bizagi. Ntese que si se utiliza una configuracin en 3 capas, deber utilizar los archivos de distribucin .ear para el Servidor de Aplicaciones JEE los cuales no incluyen los recursos estticos que ya se configuran en la capa de Presentacin. Servidor Web (provisto en la capa de Presentacin). El Servidor Web no requiere de gran cantidad de recursos (requerimientos de sistema), y no hay necesidad de configurar ms de un nodo para este propsito. Para configurar un Servidor Web, recomendamos utilizar Apache HTTP Server. Para la configuracin de los componentes de Bizagi en esta capa consulte Configurar la capa de Presentacin en el Servidor Web. Para ms informacin sobre los requerimientos de sistema, consulte los requerimientos de Bizagi Enteprise JEE.

Tenga en cuenta que adems de lo anterior, tambin puede utilizar un servidor Web para configurar Bizagi de manera que se acceda tambin desde Internet de una manera segura. Consulte mas informacin acerca de esta opcin en Configurar Bizagi para acceso seguro a Internet (a

Copyright 2013 - Bizagi

2667

travs de un proxy reverso en un DMZ).

Arquitectura de sistema en dos capas

Esta solucin involucra lo siguiente: Servidor de Base de datos (provisto en la capa de acceso de datos). En aplicaciones de misin crtica y para un esquema de alta disponibilidad de la solucin, se recomienda configurar ms de un nodo para la Base de datos, de manera que se cuente con tolerancia a fallos. Las posibilidad de la tolerancia a fallos y su configuracin (p.e, tener un esquema activo-pasivo) es provista por los diferentes motores de Base de datos. Servidor BPM Bizagi (provisto en la capa BPM). En aplicaciones de misin crtica y para un esquema de alta disponibilidad de la solucin, se recomienda configurar ms de un nodo para el Servidor BPM, de manera que se cuente con capacidades de balanceo de cargas. Para el balanceo de cargas, Bizagi soporta tanto balanceadores en hardware o software, y se recomienda el uso de un balanceador de cargas por hardware (p.e F5). Bizagi no provee como tal el balanceador de cargas. Bizagi soporta cualquier algoritmo que se configure para el balanceo de cargas (esta configuracin se realiza de manera independiente), y se requiere que se habilite el uso de sesiones pegajosas (sticky sessions). Para ms informacin sobre la configuracin del balanceador de cargas, consulte Configuracin de balanceo de cargas. Para esta configuracin, configure su Servidor de Aplicaciones JEE de la capa BPM de acuerdo a Configurar un Servidor de Aplicaciones JEE para trabajar con Bizagi. Para ms informacin sobre los requerimientos de sistema, consulte los requerimientos de Bizagi Enteprise JEE.

2668

Copyright 2013 - Bizagi

Tenga en cuenta que adems de lo anterior, tambin puede utilizar un servidor Web para configurar Bizagi de manera que se acceda tambin desde Internet de una manera segura. Consulte mas informacin acerca de esta opcin en Configurar Bizagi para acceso seguro a Internet (a travs de un proxy reverso en un DMZ). 7.4.2.1 Configuracin de la capa de presentacin en el Servidor Web

Introduccin
Bizagi soporta una arquitectura de sistema multi-capa. Dentro de la configuracin de la infraestructura (arquitectura del sistema), puede optar por desplegar la solucin en una arquitectura de 2 de 3 capas. Para conocer sobre las posibilidades, consulte Configurar la arquitectura del sistema. El siguiente artculo describe cmo configurar la capa de Presentacin en el Servidor Web, para una arquitectura de 3 capas.

Copyright 2013 - Bizagi

2669

Cmo funciona?
La capa de Presentacin se puede montar de una manera separada del Servidor BPM, de manera que sea almacenado en ella el contenido Web esttico que es utilizado por el Portal de trabajo (p.e, archvos css, js, imgenes, etc). La ventaja de contar con una capa de Presentacin, es la posibilidad de separar completamente los recursos estticos en un Servidor Web, para que el Servidor BPM se encargue nicamente de atender y servir las solicitudes dinmicas (una configuracin distribuda).

Los recursos que son estticos, y por lo tanto configurados en la capa de Presentacin en el servidor Web son: archivos de javascript, imgenes, y otros como componentes de flash. Los recursos que son dinmicos y que se manejan por el Servidor BPM sern los involucrados en los

2670

Copyright 2013 - Bizagi

archivos jsp y jsf principalmente.

Prerequisitos
1. Tener instalado un servidor Web, por ejemplo, recomendamos una instancia de Apache HTTP Server. La descarga de este servidor se puede hacer directamente desde la pgina oficial de Apache HTTP Server donde se selecciona la ltima versin disponible de acuerdo a su plataforma. La ruta donde se instala Apache HTTP Server ser referenciada a partir de este momento como <APACHE_HOME>.

2. Tener a la mano el entregable de los recursos estticos de Bizagi (bizagi-web.zip), que se debe configurar en el Servidor Web (el entregable es proporcionado por Bizagi Ltd). Los recursos estticos deben ser descomprimidos en una ruta local del Apache HTTP Server. 3. Haber configurado el Servidor de Aplicaciones JEE para trabajar con Bizagi, segn la gua en Configurar el Servidor de Aplicacin JEE. Una vez que haya revisado y cumplido con estos 3 prerequisitos, proceda a configurar la capa de presentacin de Bizagi como se describe en la siguiente seccin.

Configurar la capa de Presentacin de Bizagi

Siga estos pasos para configurar Bizagi y sus recursos estticos dentro de la capa de Presentacin del Servidor Web:

Copyright 2013 - Bizagi

2671

1. Copie los recursos estticos (que se descomprimieron a partir de bizagi-web.zip) hacia la ruta <APACHE_HOME>\htdocs\BizAgi-war\. Ntese que B izA g i-w ar deber ser el directorio que corresponde al contexto de la aplicacin Web. 2. Ubique el archivo llamado bizagi.workportal.services.service.js, dentro de la ruta <APACHE_HOME>\htdocs\BizAgi-war\jquery\workportal\js\services\. 3. Edite este archivo de manera que el valor para la variable params.proxyPrefix apunte al Servidor de Aplicaciones JEE en modo standalone, o apunte hacia el balanceador de cargas (cuando se tiene un montaje en clster). La edicin del valor de esta variable debe hacerse como se indica: params.proxyPrefix = !bizagi.util.isEmpty(params.proxyPrefix) ? params.proxyPrefix : "[BPM_SERVER]:[PUERTO]/BizAgi-war"; Considere: [BPM_SERVER]: Corresponde a la ruta del Portal de Bizagi. Ser el Servidor de Aplicaciones JEE Server configurado como standalone cuando no se usa clster. Ser la ruta al balanceador de cargas cuando se usa clster. [PUERTO]: Corresponde al nmero del puerto sobre el cual el Servidor atiende las solicitudes. BizAgi-war: Hace referencia a la aplicacin Web desplegada. Esta corresponde al Portal de trabajo de Bizagi y conserva este mismo nombre. En este punto, el archivo deber verse como se muestra a continuacin.

Guarde los cambios y cierre el archivo.

4. Ubique el archivo llamado httpd.conf en la ruta <APACHE_HOME>\conf\. 5. Edite este archivo de manera que se establezca el uso del proxy inverso. De esta manera, el Apache HTTP Server tendr las dos funciones de: servir los recursos estticos, y proveer las capacidades del proxy inverso. La habilitacin de los mdulos necesarios para el proxy inverso se realiza como se describe a continuacin: Remueva los caracteres "#" que se encuentran al inicio de las siguientes lneas: LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_http_module modules/mod_proxy_http.so

2672

Copyright 2013 - Bizagi

Cree las reglas asociadas al proxy inverso asegurndose de tener: <VirtualHost *:[APACHE_PUERTO]> ServerName [APACHE_SERVER]:[APACHE_PUERTO] # Proxy configuration ProxyRequests Off ProxyPreserveHost Off ProxyPass ProxyPass ProxyPass ProxyPass ProxyPass ProxyPass /BizAgi-war/jquery ! /BizAgi-war/Charts ! /BizAgi-war/css ! /BizAgi-war/img ! /BizAgi-war/js ! /BizAgi-war/Localization !

ProxyPass /BizAgi-war http://[BPM_SERVER]:[PUERTO]/BizAgi-war ProxyPassReverse /BizAgi-war http://[BPM_SERVER]:[PUERTO]/BizAgi-war </VirtualHost> En las primeras 2 lneas, considere: [APACHE_SERVER]: Corresponde a la instancia local del Apache HTTP Server (p.e su direccin IP). [APACHE_PUERTO]: Corresponde al nmero del puerto bajo el cual ese servidor de Apache atiende las solicitudes. En las ltimas 2 lneas, considere: [BPM_SERVER]: Corresponds to the JEE Server set as a standalone BPM Server. [PUERTO]: Corresponds to the port number under which that BPM Server attends the requests. BizAgi-war: References the deployed Web application. This Web application corresponds to Bizagi's Work Portal and it is named in this exact way. En este punto, el archivo deber verse de manera similar a la siguiente imagen:

Copyright 2013 - Bizagi

2673

Guarde los cambios y cierre el archivo.

Nota Ntese que el smbolo de admiracin ! se utiliza en las lineas anteriores: ProxyPass /BizAgi-war/[RECURSO_ESTATICO] ! Este smbolo definir que cuando se solicite el recurso /B izA g i-w ar/[RECURSO _ESTA TICO ], el servidor local de Apache ser el encargado de proveerlo. Si estos recursos se encuentran instalados en otra ubicacin (otro servidor adicional a Apache), entonces deber especificar una URL de la ubicacin en su lugar. Por ejemplo: ProxyPass /BizAgi-war/jquery http://[SERVIDOR_WEB_ADICIONAL]:[PUERTO]/ BizAgi-war/jquery En el ejemplo anterior, considere: [SERVIDOR_WEB_ADICIONAL]: Corresponde al servidor Web adicional sobre el cual los recursos estticos de Bizagi estn instalados. Esta definicin a menudo requerir incluir explcitamente el dominio. [PUERTO]: Corresponde al nmero del puerto bajo el cual este servidor Web adicional atiende las solicitudes.

2674

Copyright 2013 - Bizagi

7.4.2.2

Configuracin del balanceo de cargas

Introduccin
En aplicaciones de misin crtica y para un esquema de alta disponibilidad de la solucin, se recomienda el uso de ms de un nodo en la Capa BPM, de manera que se cuente con capacidades de balanceo de cargas. Bizagi soporta la configuracin de balanceo de cargas a travs de las capacidades del sistema operativo (p.e Network Load Balancing en Sistemas operativos Windows Server). Es decir, Bizagi soporta tanto balanceadores en hardware o software, y se recomienda el uso de un balanceador de cargas por hardware (p.e F5). A continuacin presentamos los lineamientos para la configuracin del balanceo de cargas en la edicin Bizagi Enterprise JEE y con el uso de un Servidor de Aplicaciones JEE, en donde se utilizar como ejemplo Apache HTTP Server. Tenga en cuenta que Apache HTTP Server cuenta con un mdulo que se encarga de balancear cargas.

Prerequisitos
Se debe cumplir con los siguientes prerequisitos: 1. Tener instalado el balanceador de cargas. 2. Tener Bizagi configurado en clster. Los enlaces de gua sobre cmo configurar la solucin Bizagi en un esquema de clster, se encuentran segn el Servidor de Aplicaciones JEE que se emplee (WebSphere, Weblogic o JBoss) en Configurar el Servidor de Aplicaciones JEE.

Lo que debe hacerse

Para configurar el balanceo de cargas en Bizagi, lleve a cabo lo siguiente: 1. Configurar el balanceador para que contemple los mltiples nodos del clster. 2. Configurar el Servidor de Aplicaciones para soportar el balanceo.

Ejemplos
Para ms informacin y ejemplo puntual a travs del uso de Apache HTTP Server, consulte los enlaces a continuacin: Balanceo de cargas con WebSphere (ejemplo). Balanceo de cargas con Weblogic (ejemplo).

7.4.2.2.1 Balanceo de cargas con WebSphere

El siguiente artculo ilustra un ejemplo donde se configura balanceo de cargas para el Servidor BPM de Bizagi. Este ejemplo aplica para la edicin Enterprise JEE donde se utiliza configuracin de WebSphere en

Copyright 2013 - Bizagi

2675

clster y el balanceo de cargas a travs de los mdulos de Apache HTTP Server.

Tenga en cuenta que Bizagi soporta tanto balanceadores en hardware o software, y se recomienda el uso de un balanceador de cargas por hardware (p.e F5). Para ms informacin sobre las directrices del balanceo de cargas, consulte Configurar el balanceo de cargas.

Ejemplo
Para ilustrar la configuracin de un balanceo de cargas, en este artculo se describen los cambios que se deben realizar utilizando los servicios de Apache HTTP Server. Por lo tanto, en el siguiente ejemplo se parte del uso de un servidor Web con una instancia de Apache HTTP Server. La descarga de este servidor se puede hacer directamente desde la pgina oficial de Apache HTTP Server donde se selecciona la ltima versin disponible de acuerdo a su plataforma. La ruta donde se instala Apache HTTP Server ser referenciada a partir de este momento como <APACHE_HOME>.

Configurar el balanceador para que contemple los mltiples nodos del clster.
En nuestro ejemplo que utiliza Apache HTTP Server y WebSphere, se especifica que nodos hacen parte de la solucin al editar el archivo de configuracin <APACHE_HOME>\conf\httpd.conf Para ello, asegrese de tener habilitados los mdulos requeridos como se describe a continuacin.

2676

Copyright 2013 - Bizagi

Revise que las siguientes lneas no estn comentareadas: LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_balancer_module modules/mod_proxy_balancer.so LoadModule proxy_http_module modules/mod_proxy_http.so LoadModule headers_module modules/mod_headers.so Adicione las siguientes lneas dentro de la definicin del VirtualHost: ProxyRequests OFF ServerName [Servidor_Balanceador]:80 Header add Set-Cookie "ROUTEID=.%{BALANCER_WORKER_ROUTE}e; path=/" env=BALANCER_ROUTE_CHANGED <Proxy balancer://[Nombre_cluster]> BalancerMember http://[Nombre_Nodo1]:[Puerto1] route=1 BalancerMember http://[Nombre_Nodo2]:[Puerto2] route=2 Order Deny,Allow Deny from none Allow from all ProxySet lbmethod=byrequests ProxySet stickysession=ROUTEID </Proxy> <Location /balancer-manager> SetHandler balancer-manager Order deny,allow Allow from localhost </Location> ProxyPass /balancer-manager ! ProxyPass /BizAgi-war/ balancer://[Nombre_cluster]/BizAgi-war/ ProxyPassReverse /BizAgi-war/ http://[Nombre_Nodo1]:[Puerto1] route=1 ProxyPassReverse /BizAgi-war/ http://[Nombre_Nodo2]:[Puerto2] route=2

Considere: [Servidor_Balanceador]: Nombre del servidor (o IP) que ejerce el balanceo (en este ejemplo ser el servidor local que tiene instalado Apache). [Nombre_cluster]: Nombre del servidor (o IP) que representa el clster. [Nombre_Nodo1]: Nombre del servidor (o IP) donde se encuentra el Nodo1 que hace parte del clster. [Puerto1]: Nmero de puerto sobre el cual atiende el servicio del Nodo1. [Nombre_Nodo2]: Nombre del servidor (o IP) donde se encuentra el Nodo2 que hace parte del clster. [Puerto2]: Nmero de puerto sobre el cual atiende el servicio del Nodo2. Ntese que la lnea BalancerMember http://[Nombre_NodoN]:[PuertoN] route=N deber agregarse para cada miembro del clster involucrado en el balanceo, al igual que la lnea ProxyPassReverse /BizAgi-war/ http://[Nombre_NodoN]:[PuertoN] route=N. En el siguiente ejemplo vemos que se tiene balanceo de cargas para 2 servidores: MyServer01 y MyServer02 (por el puerto 9082 y 9083 respectivamente). La definicin completa del VirtualHost en Apache de este ejemplo es: <VirtualHost *:80> ProxyRequests OFF

Copyright 2013 - Bizagi

2677

ServerName MyApacheServer:80 Header add Set-Cookie "ROUTEID=.%{BALANCER_WORKER_ROUTE}e; path=/" env=BALANCER_ROUTE_CHANGED <Proxy balancer://WASCluster> BalancerMember http://MyServer01:9082 route=1 BalancerMember http://MyServer02:9083 route=2 Order Deny,Allow Deny from none Allow from all ProxySet lbmethod=byrequests ProxySet stickysession=ROUTEID </Proxy> <Location /balancer-manager> SetHandler balancer-manager Order deny,allow Allow from localhost </Location> ProxyPass /balancer-manager ! ProxyPass /BizAgi-war/ balancer://WASCluster/BizAgi-war/ ProxyPassReverse /BizAgi-war/ http://MyServer01:9082/BizAgi-war/ ProxyPassReverse /BizAgi-war/ http://MyServer02:9083/BizAgi-war/ </VirtualHost>

Nota Bizagi soporta cualquier algoritmo que se configure para el balanceo de cargas (esta configuracin se realiza de manera independiente), y se requiere que se habilite el uso de sesiones pegajosas (sticky sessions) como se observa en la lnea ProxySet stickysession=ROUTEID Una vez haya editado la informacin, guarde los cambios y cierre el archivo. Verificar la configuracin Para revisar que el balanceador de Apache est operacional y que los nodos involucrados estn listos para atender las peticiones, ingrese la siguiente URL en un navegador: http://[Servidor_Balanceador]/balancer-manager All se ver el status de los nodos:

2678

Copyright 2013 - Bizagi

Configurar el Servidor de Aplicaciones JEE para soportar el balanceo

Asegrese que el Servidor de Aplicaciones JEE soporte el balanceo de cargas en la aplicacin. Esto puede implicar la instalacin de algunos plug-ins dependiendo del Servidor de Aplicaciones JEE y su versin. En este ejemplo de WebSphere usando Apache HTTP Server, realice lo siguiente: Acceda a la Consola de administracin, y vaya a la seccin de Servidores ( Serv ers) y expanda el item de tipos de servidores ( Serv er ty p es). De clic sobre W eb serv ers y sobre el botn Nuevo ( N ew ) para registrar el servidor Web que balancea las cargas.

Ingrese la siguiente informacin: o Select n o d e: Seleccione el primer nodo de su clster. o Serv er n am e: Ingrese un nombre para identificar el servidor. Ingrese ApacheLoadBalancer. o Ty p e: Seleccione Apache HTTP Server de la lista desplegable. De clic en Siguiente ( N ex t). En la seleccin de plantillas, puede dejar los valores por defecto y dar clic en Siguiente ( N ex t). En la siguiente ventana de definicin de ubicacin, ingrese la siguiente informacin:

Copyright 2013 - Bizagi

2679

o P o rt (Puerto): Ingrese el valor del puerto por el cual atiende el servidor Web que balancea cargas. Para nuestro ejemplo con Apache HTTP Server, el puerto es 80. o P lu g -in in stallatio n lo catio n (Ubicacin de la ruta de instalacin del plug-in): Ingrese cualquier ubicacin en disco para la instalacin del plug-in que no contenga espacios. Puede aceptar la ruta por defecto. o A p p licatio n m ap p in g to th e W eb serv er (Aplicacin que se mapea en el servidor Web): Seleccione All de la lista desplegable.

De clic en Siguiente ( N ex t). Verifique en el resumen de la configuracin que la informacin sea la correcta y de clic en Finalizar ( F in ish ) .

De regreso en la lista de W eb serv ers, marque la casilla del recientemente creado y de clic en el botn de Generar plug-in ( Gen erate p lu g -in ). Una vez se complete la accin, de clic sobre el botn de propagar los cambios ( P ro p ag ate p lu g -in ):

Con ello, esta configuracin aplicar a todos los nodos del clster. Finalmente, asegrese de dar clic en Guardar ( Sav e) para aplicar los cambios.

2680

Copyright 2013 - Bizagi

7.4.2.2.2 Balanceo de cargas con Weblogic

El siguiente artculo ilustra un ejemplo donde se configura balanceo de cargas para el Servidor BPM de Bizagi. Este ejemplo aplica para la edicin Enterprise JEE donde se utiliza configuracin de Weblogic en clster y el balanceo de cargas a travs de los mdulos de Apache HTTP Server.

Tenga en cuenta que Bizagi soporta tanto balanceadores en hardware o software, y se recomienda el uso de un balanceador de cargas por hardware (p.e F5). Para ms informacin sobre las directrices del balanceo de cargas, consulte Configurar el balanceo de cargas.

Ejemplo
Para ilustrar la configuracin de un balanceo de cargas, en este artculo se describen los cambios que se deben realizar utilizando los servicios de Apache HTTP Server. Por lo tanto, en el siguiente ejemplo se parte del uso de un servidor Web con una instancia de Apache HTTP Server. La descarga de este servidor se puede hacer directamente desde la pgina oficial de Apache HTTP Server donde se selecciona la ltima versin disponible de acuerdo a su plataforma. La ruta donde se instala Apache HTTP Server ser referenciada a partir de este momento como <APACHE_HOME>.

Copyright 2013 - Bizagi

2681

Configurar el balanceador para que contemple los mltiples nodos del clster.
En nuestro ejemplo que utiliza Apache HTTP Server y Weblogic, se especifica que nodos hacen parte de la solucin al editar el archivo de configuracin <APACHE_HOME>\conf\httpd.conf Al editar este archivo, habilite el servicio incluyendo: Listen [Nombre_Servidor_Balanceador]:[Puerto] Asegrese tambin de habilitar los mdulos necesarios de la siguiente manera: LoadModule weblogic_module modules/mod_wl[cifrado]_[version].so <IfModule mod_weblogic.c> WebLogicCluster [Nodo1:Puerto1], [Nodo2:Puerto2] MatchExpression /* </IfModule> <Location /weblogic> SetHandler weblogic-handler WebLogicCluster [Nodo1:Puerto1], [Nodo2:Puerto2] PathTrim /weblogic </Location> Para lo anterior, considere: [ N o m b re_Serv id o r_B alan cead o r]: El nombre del servidor local el cul ejerce el balanceo de cargas. [ P u erto ]: El nmero de puerto bajo el cual el balanceador atiende las peticiones. [N o d o 1] : El nombre del servidor (o IP) en donde est el servicio del Nodo1. [P u erto 1] : El nmero de puerto bajo el cual el Nodo1 atiende las peticiones. [N o d o 2] : El nombre del servidor (o IP) en donde est el servicio del Nodo2. [P u erto 2] : El nmero de puerto bajo el cual el Nodo2 atiende las peticiones. [v ersio n ]: Ingrese 20 o 22, segn la versin de Apache HTTP Server que est utilizando (versin 2.0.x o 2.2.x respectivamente. [cifrad o ]: El nmero de bits cifrado que se usa en la transferencia de manera opcional. Puede dejar el valor vaco en cuyo caso un ejemplo de esta informacin sera: LoadModule weblogic_module modules/mod_wl_22.so Ntese que para cada nodo adicional que se tenga en la instalacin del clster de Weblogic, deber tener repetidas occurrencias de: ,[NodoN:PuertoN] Nota Bizagi soporta cualquier algoritmo que se configure para el balanceo de cargas (esta configuracin se realiza de manera independiente), y se requiere que se habilite el uso de sesiones pegajosas (sticky sessions). Una vez haya editado la informacin, guarde los cambios y cierre el archivo.

Configurar el Servidor de Aplicaciones JEE para soportar el balanceo

2682

Copyright 2013 - Bizagi

Asegrese que el Servidor de Aplicaciones JEE soporte el balanceo de cargas en la aplicacin. Esto puede implicar la instalacin de algunos plug-ins dependiendo del Servidor de Aplicaciones JEE y su versin. En este ejemplo de Weblogic usando Apache HTTP Server, realice lo siguiente: 1. Verifique la versin de Weblogic que tiene instalada. Para las versiones de Weblogic 11g, en la ruta <WEBLOGIC_HOME>\wlserver_10.3 \server\plugin\ encontrar los archivos necesarios que se deben incorporar a manera de plugins para la compatibilidad con el mdulo de balanceo de Apache HTTP Server. 2. Copie el archivo plugin hacia la ruta de instalacin del Apache HTTP Server en <APACHE_HOME>\modules. Tenga presente que deber considerar el plugin apropiado de acuerdo al sistema operativo y plataforma de Weblogic. Estos plugins estn dentro de una estructura referente al sistema operativo. Los plugins son nombrados de la siguiente manera: mod_wl[cifrado]_[version].so Donde: [ v ersio n ]: Define la versin de Apache con la que es compatible (p.e. version 2.0.x o 2.2.x). [ cifrad o ]: Define si utiliza una transferencia de datos con un nmero de bits cifrado (p.e. 128). Puede tomar los plugins que no tienen este detalle (p.e m o d _w l_22.so ). Finalizada esta configuracin, se recomienda reiniciar el servicio de Apache HTTP Server.

7.4.3

Despliegue a un Servidor de Aplicacin JEE

El Portal de Trabajo se genera en el Servidor JEE como el despliegue de la aplicacin, una vez que ya se hayan completado estas tareas: La implementacin de los Procesos actualizada en una Base de datos de pruebas o produccin. Para ms informacin sobre cmo publicar la implementacin de los Procesos en un ambiente de pruebas o de produccin, consulte el Deployment Avanzado. La configuracin del Servidor de Aplicaciones JEE para trabajar con Bizagi (para el ambiente de pruebas o produccin). Para ms informacin sobre cmo configurar un Servidor de Aplicaciones JEE, consulte Configurar el Servidor de Aplicacin JEE para trabajar con Bizagi. Para ello, siga la configuracin detallada en los artculos a continuacin (de acuerdo al Servidor de Aplicaciones JEE que se desea usar): Despliegue hacia WebSphere. Despliegue hacia Weblogic. Despliegue hacia JBoss. 7.4.3.1 Despliegue hacia WebSphere

Introduccin
Este artculo describe cmo generar el Portal de Trabajo para los Procesos de Bizagi en WebSphere (haciendo un despliegue de la aplicacin JEE).

Copyright 2013 - Bizagi

2683

Lo siguiente aplica tanto para el despliegue de soluciones configuradas en clster (con ms de un nodo de WebSphere) tanto como para soluciones en modo standalone (configuracin estndar).

Prerequisitos
Asegrese de cumplir con: Tener la Base de datos del ambiente de produccin (o de pruebas) con la publicacin de Procesos desde el ambiente de desarrollo (a travs de la herramienta de Deployment Avanzado). Tener WebSphere configurado para trabajar con Bizagi. WebSphere debe estar iniciado. Para ms informacin, consulte la Configuracin de WebSphere Tener acceso al archivo .ear distribuible que se encuentra en < P A TH _CO N F IGURA TIO N _F ILES> \B izag i\B izag i-ear-W eb sp h ere.ear. Ms informacin sobre esta ruta y archivo se referencia en la configuracin de WebSphere. Tener instalada la Consola Bizagi JEE (Bizagi JEE Console). La ruta de la esta consola se refenciar en este artculo como < JEECO N SO LE_H O M E> a partir de este momento.

Lo que debe hacer

Para desplegar la aplicacin debe: 1. Configurar la plantilla XML del proyecto. 2. Generar el archivo .EAR final. 3. Instalar el Portal de Trabajo.

Procedimiento
Los siguientes pasos describen en detalle cmo hacer un despliegue de aplicacin hacia WebSphere.

1. Configurar la plantilla XML del proyecto.

Para la generacin del .EAR final, debe primero configurar un archivo XML con la informacin del proyecto. La plantila XML de esta configuracin la puede encontrar dentro de la ruta de la Consola Bizagi JEE, ubicada como <JEECONSOLE_HOME>\ProjectTemplate.xml. Por lo tanto, asegrese de copiar y pegar esta plantilla y editarla para su proyecto. Nota Tenga en cuenta: 1. Las rutas se separan con el caracter slash ("/"). 2. Este archivo XML de configuracin no debe contener lineas comentareadas. Las lineas comentreadas slo sirven para proveer un ejemplo ilustrativo de las configuraciones posibles. Para WebSphere, asegrese que su archivo de configuracin especifique el uso de WebSphere:

2684

Copyright 2013 - Bizagi

2. Generar el archivo .EAR final

Una vez que tenga configurado el archivo XML de configuracin, ejecute el siguiente comando de registro de proyecto a travs de la consola Bizagi JEE: En Linux utilice: sh <JEECONSOLE_HOME>/bin/JEEConsoleManager.sh createproject <CONFIG_PATH> En Windows utilice: <JEECONSOLE_HOME>\bin\JEEConsoleManager.bat createproject <CONFIG_PATH> Considere que < CO N F IG_P A TH > es la ruta donde se encuentra el archivo de configuracin XML. Ntese que este comando crear la siguiente ruta: < JEECO N SO LE_H O M E> \p ro jects\[N O M B RE_P RO Y ECTO ] Una vez que este comando sea exitoso, ejecute el comando de pre-despliegue (predeploy) con la misma consola Bizagi JEE: En Linux utilice: sh <JEECONSOLE_HOME>/bin/JEEConsoleManager.sh predeploy -o <OUTPUT_PATH> -p [PROJECT_NAME] -f <FILE_PATH> En Windows utilice: <JEECONSOLE_HOME>\bin\JEEConsoleManager.bat predeploy -o <OUTPUT_PATH> -p [PROJECT_NAME] -f <FILE_PATH> Considere: < O UTP UT_P A TH > es la ruta opcional para especificar dnde se genera el archivo EAR. No utilice o si no desea incluir esta ruta (por defecto quedar como < JEECO N SO LE_H O M E> \p ro jects\[N O M B RE_P RO Y ECTO ]\d ist\B izA g i-ear-W eb Sp h ere.ear). [P RO JECT_N A M E] es el nombre el proyecto tal como se especific en el archivo XML de configuracin en < CO N F IG_P A TH >. El uso de -p con el nombre del proyecto es obligatorio. < F ILE_P A TH > es la ruta opcional de donde se toma el archivo de distribucin .EAR (se debe referenciar para la generacin de la aplicacion final). No utilice -f si no desea incluir esta ruta. Al no especificar la ruta, se tomar la ruta especificada en el archivo de configuracin projectemplate.xml. Si su configuracin de WebSphere utiliza ms de un nodo (configuracin en clster), deber utilizar -c para especificar el modo clster.De lo contrario, la ausencia de este parmetro indicar que es un despliegue a un servicio standalone.

Nota Puede encontrar ms detalle tcnico sobre la Consola (Bizagi JEE Console) en su archivo local Read m e-co n so le.tx t file.

Copyright 2013 - Bizagi

2685

Consideracin en ambientes de desarrollo Si usted utiliza WebSphere en su ambiente de Desarrollo (en vez del JBoss que viene embebido con Bizagi Studio), entonces hay escenarios donde puede optar por refrescar la informacin en cach en vez de volver a generar la aplicacin. Para ello, existe el comando clean cach e de la consola de JEE para refrescar cambios sencillos, nicamente cuando el modelo de datos no haya sido modificado. Por ejemplo para cambios sencillos de reglas o en las formas. Este comando se utiliza de la siguiente manera: cleancache -p [NOMBRE_PROYECTO] -host [SERVIDOR] -port [PUERTO] Para ello, considere: N O M B RE_P RO Y ECTO : Es el nombre del proyecto. Su definicin debe ir con el parmetro -p. SERVIDO R: Es el nombre o la direccin IP del servidor en el cual se quiere limpiar el cache interno de Bizagi. Su definicin debe ir con el parmetro -host. P UERTO : Es el puerto sobre el cual atiende el Servidor de Aplicaciones. Su definicin debe ir con el parmetro -port.

3. Instalar el Portal de Trabajo

Los pasos requeridos para la instalacin del Portal de Trabajo difieren ligeramente si su Servidor de Aplicaciones WebSphere est configurado para utilizar ms nodo (configuracin de clster). Siga los pasos de la seccin Instalacin para clster o de la seccin Instalacin en modo standalone, segn su configuracin.

Instalacin para clster 1. Ingrese a la consola de administracin de WebSphere, y utilice el panel a la izquierda para ir a la opcin: A p p licatio n s A p p licatio n Ty p es W eb Sp h ere en terp rise ap p licatio n s. De clic en Instalar ( In stall). 2. Utilice la opcin de Preparacin ( P rep arin g fo r th e ap p licatio n in stallatio n o p tio n ) para ubicar el archivo .ear final (el B izA g i-ear-W eb Sp h ere.ear generado) que se instala y luego de clic en Siguiente ( N ex t).

2686

Copyright 2013 - Bizagi

3. Digite la opcin F ast P ath para la seleccin de la instalacin y de clic en Siguiente ( N ex t). 4. Asegurese de marcar la casilla de desplegar los servicios Web ( Dep lo y W eb serv ices) en las opciones de instalar la aplicacin ( In stall N ew A p p licatio n / Select in stallatio n ). Los otros parmetros de configuracin podrn ser modificados a criterio del administrador del Servidor de aplicaciones. Sin embargo, puede dejar los valores por defecto y dar clic en Siguiente (N ex t).

5. Verifique que se tenga asignado el valor All security domains en la lista de Disp lay clu sters an d serv ers in th e fo llo w in g secu rity d o m ain . En la lista de clsters y servidores ( Clu sters an d serv ers), asegrese de incluir tanto los nodos que hacen parte del clster, como tambin el servidor Web donde se ejerce el balanceo de cargas. Marque las casillas de todos los mdulos listados en la tabla y de clic sobre el botn de Aplicar ( A p p ly).

Copyright 2013 - Bizagi

2687

De clic en Siguiente ( N ex t). 6. Revise los parmetros del proceso de instalacin en la ventana de resumen (Su m m ary ), y de clic en Finalizar ( F in ish ). 7. Una vez que se haya instalado la aplicacin, de clic en Guardar ( Sav e) para aplicar los cambios.

2688

Copyright 2013 - Bizagi

8. Seleccione la aplicacin instalada haciendo clic sobre ella ( B izag i-ear). Haga clic sobre la opcin de administracin de la sesin ( Sessio n m an ag em en t) ubicada bajo la seccin W eb M o d u le p ro p erties. Ubique las propiedades adicionales ( A d d itio n al p ro p erties) y de clic sobre la opcin de configuracin de un ambiente distribuido ( Distrib u ted en v iro n m en t settin g s). En ella, de clic sobre la opcin M em o ry -to -m em o ry rep licatio n y configure para la aplicacin lo siguiente: Rep licatio n d o m ain : Seleccione su clster de WebSphere. Rep licatio n m o d e: Seleccione Both client and server.

De clic en O k. 9. De regreso en el listado de aplicaciones instaladas, marque la casilla de la aplicacin ( B izag i-ear) y utilice el botn de Iniciar ( Start ) para cargar sus componentes e iniciar el Portal de Trabajo.

Copyright 2013 - Bizagi

2689

10. Asegrese de propagar los cambios en todos los nodos de la configuracin de su clster. Para ello, de clic sobre la opcin Up d ate g lo b al W eb serv er p lu g -in co n fig u ratio n en la seccin de entorno ( En v iro n m en t).

Para verificar que el Portal de Trabajo se instal correctamente, ingrese la siguiente direccin URL en un navegador (tenga en cuenta que estas direcciones son sensibles a maysculas): http://[Servidor_Balanceador]:[Puerto]/BizAgi-war/default.jsp

Instalacin en modo standalone (configuracin estndar de WebSphere) 1. Ingrese a la consola de administracin de WebSphere, y utilice el panel a la izquierda para ir a la opcin: A p p licatio n s A p p licatio n Ty p es W eb Sp h ere en terp rise ap p licatio n s. De clic en Instalar ( In stall). 2. Utilice la opcin de Preparacin ( P rep arin g fo r th e ap p licatio n in stallatio n o p tio n ) para ubicar el archivo .ear final (el B izA g i-ear-W eb Sp h ere.ear generado) que se instala y luego de clic en Siguiente ( N ex t).

3. Digite la opcin F ast P ath para la seleccin de la instalacin y de clic en Siguiente ( N ex t). 4. Ensure you mark the Dep lo y W eb serv ices checkbox in the In stall N ew A p p licatio n / Select in stallatio n options. The other configuration may be modified depending on the Application Server's administrator criteria, but you may leave the defaults and click N ex t.

2690

Copyright 2013 - Bizagi

5. De clic en Siguiente ( N ex t) en la opcin: M ap m o d u les to serv ers. 6. De clic en Siguiente ( N ex t) en la opcin: M ap v irtu al h o sts fo r W eb m o d u les. 7. Revise los parmetros del proceso de instalacin en la ventana de resumen (Su m m ary ), y de clic en Finalizar ( F in ish ). 8. Una vez que se haya instalado la aplicacin, de clic en Guardar ( Sav e) para aplicar los cambios.

9. Seleccione la aplicacin instalada y utilice el botn de Iniciar ( Start ) para cargar sus componentes e iniciar el Portal de Trabajo.

Copyright 2013 - Bizagi

2691

Para verificar que el Portal de Trabajo se instal correctamente, ingrese la siguiente direccin URL en un navegador (tenga en cuenta que estas direcciones son sensibles a maysculas): http://[Servidor]:[Puerto]/BizAgi-war/default.jsp

Pasos adicionales
Si su proyecto se est configurando para un ambiente de pruebas o produccin y ste utiliza Virtualizacin o Replicacin, deber registrar en su Servidor de Aplicaciones JEE, la fuente de datos externa que se integra en la solucin. Para ms informacin acerca de este paso, consulte cmo configurar la Replicacin o Virtualizacin en la JEE. Tambin puede optar por activar la funcionalidad del ODS de Bizagi para mejorar la disponibilidad y el rendimiento de los Procesos. Para ms informacin sobre esta opcin, consulte Configuracin de ODS para el anlisis de Procesos. 7.4.3.2 Despliegue hacia Weblogic

Introduccin
Este artculo describe cmo generar el Portal de Trabajo para los Procesos de Bizagi en Weblogic (haciendo un despliegue de la aplicacin JEE). Lo siguiente aplica tanto para el despliegue de soluciones configuradas en clster (con ms de un nodo de Weblogic) tanto como para soluciones en modo standalone (configuracin estndar).

Prerequisitos
Asegrese de cumplir con:

2692

Copyright 2013 - Bizagi

Tener la Base de datos del ambiente de produccin (o de pruebas) con la publicacin de Procesos desde el ambiente de desarrollo (a travs de la herramienta de Deployment Avanzado). Tener Weblogic configurado para trabajar con Bizagi. Weblogic debe estar iniciado. Para ms informacin, consulte la Configuracin Weblogic. Tener acceso al archivo .ear distribuible que se encuentra en < P A TH _CO N F IGURA TIO N _F ILES> \B izag i\B izag i-ear-W eb lo g ic.ear. Ms informacin sobre esta ruta y archivo se referencia en la configuracin de Weblogic. Tener instalada la Consola Bizagi JEE (Bizagi JEE Console). La ruta de la esta consola se refenciar en este artculo como < JEECO N SO LE_H O M E> a partir de este momento.

Lo que debe hacer

Para desplegar la aplicacin debe: 1. Configurar la plantilla XML del proyecto. 2. Generar el archivo .EAR final. 3. Instalar el Portal de Trabajo.

Procedimiento
Los siguientes pasos describen en detalle cmo hacer un despliegue de aplicacin hacia Weblogic.

1. Configurar la plantilla XML del proyecto.

Para la generacin del .EAR final, debe primero configurar un archivo XML con la informacin del proyecto. La plantila XML de esta configuracin la puede encontrar dentro de la ruta de la Consola Bizagi JEE, llamada como ProjectTemplate.xml. Por lo tanto, asegrese de copiar y pegar esta plantilla y editarla para su proyecto. Nota Tenga en cuenta: 1. Las rutas se separan con el caracter slash ("/"). 2. Este archivo XML de configuracin no debe contener lineas comentareadas. Las lineas comentreadas slo sirven para proveer un ejemplo ilustrativo de las configuraciones posibles. Para Weblogic, asegrese que su archivo de configuracin especifique el uso de Weblogic:

2. Generar el archivo .EAR final

Una vez que tenga configurado el archivo XML de configuracin, ejecute el siguiente comando de

Copyright 2013 - Bizagi

2693

registro de proyecto a travs de la consola Bizagi JEE: En Linux utilice: sh <JEECONSOLE_HOME>/bin/JEEConsoleManager.sh createproject <CONFIG_PATH> En Windows utilice: <JEECONSOLE_HOME>\bin\JEEConsoleManager.bat createproject <CONFIG_PATH> Considere que < CO N F IG_P A TH > es la ruta donde se encuentra el archivo de configuracin XML. Ntese que este comando crear la siguiente ruta: < JEECO N SO LE_H O M E> \p ro jects\[N O M B RE_P RO Y ECTO ]

Una vez que este comando sea exitoso, ejecute el comando de pre-despliegue (predeploy) con la misma consola Bizagi JEE: En Linux utilice: sh <JEECONSOLE_HOME>/bin/JEEConsoleManager.sh predeploy -o <OUTPUT_PATH> -p [PROJECT_NAME] -f <FILE_PATH> En Windows utilice: <JEECONSOLE_HOME>\bin\JEEConsoleManager.bat predeploy -o <OUTPUT_PATH> -p [PROJECT_NAME] -f <FILE_PATH> Considere: < O UTP UT_P A TH > es la ruta opcional para especificar dnde se genera el archivo EAR. No utilice o si no desea incluir esta ruta (por defecto quedar como < JEECO N SO LE_H O M E> \p ro jects\[N O M B RE_P RO Y ECTO ]\d ist\B izA g i-ear-W eb lo g ic.ear). [P RO JECT_N A M E] es el nombre el proyecto tal como se especific en el archivo XML de configuracin en < CO N F IG_P A TH >. El uso de -p con el nombre del proyecto es obligatorio. < F ILE_P A TH > es la ruta opcional de donde se toma el archivo de distribucin .EAR (se debe referenciar para la generacin de la aplicacion final). No utilice -f si no desea incluir esta ruta. Al no especificar la ruta, se tomar la ruta especificada en el archivo de configuracin projectemplate.xml. Si su configuracin de Weblogic utiliza ms de un nodo (configuracin en clster), deber utilizar c para especificar el modo clster.De lo contrario, la ausencia de este parmetro indicar que es un despliegue a un servicio standalone. Nota Puede encontrar ms detalle tcnico sobre la Consola (Bizagi JEE Console) en su archivo local Read m e-co n so le.tx t file. Consideracin en ambientes de desarrollo Si usted utiliza Weblogic en su ambiente de Desarrollo (en vez del JBoss que viene embebido con Bizagi Studio), entonces hay escenarios donde puede optar por refrescar la informacin en cach en vez de volver a generar la aplicacin. Para ello, existe el comando clean cach e de la consola de JEE para refrescar cambios sencillos, nicamente cuando el modelo de datos no haya sido modificado. Por ejemplo para cambios sencillos de reglas o en las formas.

2694

Copyright 2013 - Bizagi

Este comando se utiliza de la siguiente manera: cleancache -p [NOMBRE_PROYECTO] -host [SERVIDOR] -port [PUERTO] Para ello, considere: N O M B RE_P RO Y ECTO : Es el nombre del proyecto. Su definicin debe ir con el parmetro -p. SERVIDO R: Es el nombre o la direccin IP del servidor en el cual se quiere limpiar el cache interno de Bizagi. Su definicin debe ir con el parmetro -host. P UERTO : Es el puerto sobre el cual atiende el Servidor de Aplicaciones. Su definicin debe ir con el parmetro -port.

3. Instalar el Portal de Trabajo

Los pasos requeridos para la instalacin del Portal de Trabajo siguientes aplican tanto para su Servidor de Aplicaciones Weblogic configurado para utilizar ms de un nodo (configuracin de clster) o para un Servidor configurado para ejecucin en modo standalone (sin balanceo de cargas). La nica diferencia radica en el ltimo paso, donde se especifica el alcance y destino ( Targ et) de la aplicacin.

1. Acceda a la Consola de administracin y utilice el panel de navegacin a la izquierda para ubicar rpidamente la seccin Do m ain Stru ctu re Dep lo y m en ts. Tenga presente que si una versin anterior de la aplicacin de Bizagi ya estaba instalada, entonces para actualizarla con la recientemente generada deber eliminar (a travs de Delete) la aplicacin existente. De clic sobre Instalar ( In stall). 2. Navegue hacia la ruta de < P A TH _CO N F IGURA TIO N _F ILES>, donde se encuentra el archivo EAR generado de la aplicacin Weblogic. Seleccione este archivo ( B izag i-ear-W eb lo g ic.ear).

Copyright 2013 - Bizagi

2695

3. En la opcin de Ch o o se targ etin g sty le o p tio n seleccione Instalar este despligue como una aplicacin ( In stall th is d ep lo y m en t as an ap p licatio n ) y de clic en Siguiente ( N ex t).

4. Si usted cuenta con una configuracin de Weblogic en clster, asegrese de marcar la casilla del clster e incluir All servers in the cluster para aplicar la configuracin al clster ( Select Targ et) y de clic en Finalizar ( F in ish ):

2696

Copyright 2013 - Bizagi

Si por el contrario, su configuracin de Weblogic es en modo standalone, de clic en Finalizar ( F in ish ).

Para verificar que el Portal de Trabajo se instal correctamente, ingrese la siguiente direccin URL en un navegador (tenga en cuenta que estas direcciones son sensibles a maysculas): http://localhost:7001/BizAgi-war/default.jsp

Pasos adicionales
Si su proyecto se est configurando para un ambiente de pruebas o produccin y ste utiliza Virtualizacin o Replicacin, deber registrar en su Servidor de Aplicaciones JEE, la fuente de datos externa que se integra en la solucin. Para ms informacin acerca de este paso, consulte cmo configurar la Replicacin o Virtualizacin en la JEE. Tambin puede optar por activar la funcionalidad del ODS de Bizagi para mejorar la disponibilidad y el rendimiento de los Procesos. Para ms informacin sobre esta opcin, consulte Configuracin de ODS para el anlisis de Procesos. 7.4.3.3 Despliegue hacia JBoss

Introduccin
Este artculo describe cmo generar el Portal de Trabajo para los Procesos de Bizagi en JBoss (haciendo un despliegue de la aplicacin JEE).

Prerequisitos
Copyright 2013 - Bizagi 2697

Asegrese de cumplir con: Tener la Base de datos del ambiente de produccin (o de pruebas) con la publicacin de Procesos desde el ambiente de desarrollo (a travs de la herramienta de Deployment Avanzado). Tener JBoss configurado para trabajar con Bizagi (su ruta ser referenciada en este documento como < JB O SS_H O M E>). JBoss debe estar iniciado. Para ms informacin, consulte la Configuracin de JBoss. Tener acceso al archivo .ear distribuible que se encuentra en < P A TH _CO N F IGURA TIO N _F ILES> \B izag i\B izag i-ear-JB o ss.ear. Ms informacin sobre esta ruta y archivo se referencia en la configuracin de JBoss. Tener instalada la Consola Bizagi JEE (Bizagi JEE Console). La ruta de la esta consola se refenciar en este artculo como < JEECO N SO LE_H O M E> a partir de este momento.

Lo que debe hacer

Para desplegar la aplicacin debe: 1. Configurar la plantilla XML del proyecto. 2. Generar el archivo .EAR final. 3. Instalar el Portal de Trabajo.

Procedimiento
Los siguientes pasos describen en detalle cmo hacer un despliegue de aplicacin hacia WebSphere.

1. Configurar la plantilla XML del proyecto.

Para la generacin del .EAR final, debe primero configurar un archivo XML con la informacin del proyecto. La plantila XML de esta configuracin la puede encontrar dentro de la ruta de la Consola Bizagi JEE, llamada como ProjectTemplate.xml. Por lo tanto, asegrese de copiar y pegar esta plantilla y editarla para su proyecto. Nota

2698

Copyright 2013 - Bizagi

Tenga en cuenta: 1. Las rutas se separan con el caracter slash ("/"). 2. Este archivo XML de configuracin no debe contener lineas comentareadas. Las lineas comentreadas slo sirven para proveer un ejemplo ilustrativo de las configuraciones posibles. Para JBoss, asegrese que su archivo de configuracin especifique el uso de JBoss:

2. Generar el archivo .EAR final

Una vez que tenga configurado el archivo XML de configuracin, ejecute el siguiente comando de registro de proyecto a travs de la consola Bizagi JEE: En Linux utilice: sh <JEECONSOLE_HOME>/bin/JEEConsoleManager.sh createproject <CONFIG_PATH> En Windows utilice: <JEECONSOLE_HOME>\bin\JEEConsoleManager.bat createproject <CONFIG_PATH> Considere que < CO N F IG_P A TH > es la ruta donde se encuentra el archivo de configuracin XML. Ntese que este comando crear la siguiente ruta: < JEECO N SO LE_H O M E> \p ro jects\[N O M B RE_P RO Y ECTO ]

Una vez que este comando sea exitoso, ejecute el comando de pre-despliegue (predeploy) con la misma consola Bizagi JEE: En Linux utilice: sh <JEECONSOLE_HOME>/bin/JEEConsoleManager.sh predeploy -o <OUTPUT_PATH> -p [PROJECT_NAME] -f <FILE_PATH> En Windows utilice: <JEECONSOLE_HOME>\bin\JEEConsoleManager.bat predeploy -o <OUTPUT_PATH> -p [PROJECT_NAME] -f <FILE_PATH> Considere: < O UTP UT_P A TH > es la ruta opcional para especificar dnde se genera el archivo EAR. No utilice o si no desea incluir esta ruta (por defecto quedar como < JEECO N SO LE_H O M E> \p ro jects\[N O M B RE_P RO Y ECTO ]\d ist\B izA g i-ear-JB o ss.ear). [P RO JECT_N A M E] es el nombre el proyecto tal como se especific en el archivo XML de configuracin en < CO N F IG_P A TH >. El uso de -p con el nombre del proyecto es obligatorio. < F ILE_P A TH > es la ruta opcional de donde se toma el archivo de distribucin .EAR (se debe referenciar para la generacin de la aplicacion final). No utilice -f si no desea incluir esta ruta. Al no especificar la ruta, se tomar la ruta especificada en el archivo de configuracin

Copyright 2013 - Bizagi

2699

projectemplate.xml.

Nota Puede encontrar ms detalle tcnico sobre la Consola (Bizagi JEE Console) en su archivo local Read m e-co n so le.tx t file.

3. Instalar el Portal de Trabajo

JBoss permite que las aplicaciones Web se instalen simplemente compiando el EAR generado en la carpeta de despliegue (carpeta deploy) del Servidor. Esta carpeta se encuentra ubicada como: <JBOSS_HOME>/standalone/deployments Por lo tanto, para este paso, slo copie el archivo EAR generado en esta carpeta. Ntese que esto se puede realizar en caliente (cuando el servicio del Servidor est arriba), o tambin cuando JBoss est detenido. Para verificar que el Portal de Trabajo se instal correctamente, ingrese la siguiente direccin URL en un navegador (tenga en cuenta que estas direcciones son sensibles a maysculas): http://localhost:8080/BizAgi-war/default.jsp Nota Es posible editar el archivo ru n .co n f para modificar los parmetros de memoria del Servidor. Esto es especialmente til en caso de que el Servidor presente un error de memoria (permGen) al hacer el despliegue de la aplicacin (dado que por defecto la asignacin de memoria en JBoss no es amplia). Para hacerlo, ubique el archivo <JBOSS_HOME>\bin\run.conf.bat (en Windows); o el archivo <JBOSS_HOME>\bin\run.conf (en sistemas operativos Linux). Edite,este archivo teniendo en cuenta: Editar los parmetros de memoria inicial y memoria mxima para Linux agregando: Xms512m Xmx1024m -XX:MaxPermSize=512m debajo de la lnea que contiene: # Sp ecify o p tio n s to p ass to th e Jav a VM . Editar los parmetros de memoria inicial y memoria mxima para Windows agregando: set "JAVA_OPTS=-Xms512m -Xmx1024m -XX:MaxPermSize=512m" debajo de la lnea que contiene: rem # JVM m em o ry allo catio n p o o l p aram eters - m o d ify as ap p ro p riate.

Pasos adicionales
Si su proyecto se est configurando para un ambiente de pruebas o produccin y ste utiliza Virtualizacin o Replicacin, deber registrar en su Servidor de Aplicaciones JEE, la fuente de datos externa que se integra en la solucin. Para ms informacin acerca de este paso, consulte cmo configurar la Replicacin o Virtualizacin en la JEE.

2700

Copyright 2013 - Bizagi

Tambin puede optar por activar la funcionalidad del ODS de Bizagi para mejorar la disponibilidad y el rendimiento de los Procesos. Para ms informacin sobre esta opcin, consulte Configuracin de ODS para el anlisis de Procesos.

7.5

Deployment Avanzado Introduccin

Bizagi presenta una herramienta de Deployment Avanzado para realizar el Deployment de los Procesos. El Deployment de los Procesos se realiza una vez se haya completado la fase de automatizacin, para publicar uno o ms Procesos hacia el ambiente de pruebas y el ambiente de produccin. El Deployment Avanzado es una alternativa al Deployment en un clic que se presenta desde Bizagi Studio, para cubrir escenarios avanzados con requerimientos de Deployment tales como: 1. Proyectos de la edicin Bizagi Enterprise JEE (aquellos que no utilizan el IIS). 2. Proyectos que requieren de un Deployment fuera de lnea (offline). 3. Proyectos con un gran nmero de desarrolladores que realizan modificaciones en paralelo. 4. Proyectos que deban manejar ms de 3 ambientes. El Deployment Avanzado provee un procedimiento ms flexible que el deployment tradicional, dado que habilita una serie de opciones para revisar o modificar la informacin que ser llevada desde desarrollo hacia el ambiente destino (pruebas o produccin). De esta manera, todos los objetos de Bizagi (Entidades, reglas, formas, etc) pertenecientes a uno o ms Procesos pueden seleccionarse de manera explcita, o desmarcarse (para no ser tenidos en cuenta) en el deployment.

Cmo funciona?
En breve, el Deployment Avanzado mediante su herramienta, le permitir: Primero seleccionar los Procesos y sub Procesos (sus versiones exactas), los cuales se quieren publicar al ambiente de pruebas o produccin. Puede de manera opcional, incluir otros objetos (no necesariamente atados a los Procesos seleccionados), para llevarlos en el deployment. Esta informacin es exportada a un paquete de Deployment de Bizagi (un archivo utilizando una extensin .bex). El archivo .bex es utilizado para analizar y previsualizar lo que se va a importar al ambiente destino (se pueden revisar los objetos que sern llevados en el deployment), de manera que se pueda asegurar que la estructura e informacin que va a quedar en pruebas o produccin sea la adecuada. Este anlisis realiza una comparacin contra la Base de datos de destino sin modificarla en este punto. Finalmente, cuando el anlisis y las revisiones han sido efectuadas, puede escoger exportar el paquete revisado como un archivo .bim, el cual puede ser aplicado directamente a la Base de datos de destino.

Prerequisitos
El usuario que lleve a cabo un Deployment Avanzado, debe contar con el siguiente perfil: 1. Tener un conocimiento bsico sobre la estructura de un XML (para editar los archivos de

Copyright 2013 - Bizagi

2701

configuracin). 2. Tener acceso a las Base de Datos involucradas (con credenciales de super usuario). 3. Tener conocimiento sobre automatizacin de Procesos en Bizagi (conceptos y mdulos de Bizagi Studio). Para ms informacin sobre el tratamiento que Bizagi da a los objetos en un deployment, consulte el Deployment de los objetos. 4. Tener un entendimiento sobre los Procesos implementados en particular, en el proyecto. Esto implica conocer sobre el propsito de los Procesos involucrados, sus versiones, modelo de datos, integraciones, configuracin de sseguridad, parmetros de ambiente y su administracin (p.e polticas, alarmas, valores de entidades de parametrizacin), y el funcionamiento del Proceso en general. Tenga en cuenta que para llevar a cabo pruebas adecuadas (de aceptacin de usuario), se debe poder determinar cul es el comportamiento esperado de los Procesos en el Portal de Trabajo de acuerdo a las diferentes posibilidades de negocio.

Antes de continuar (Importante)

1. Es posible decidir utilizar el Deployment Avanzado (su herramienta), an si se ha utilizado el Deployment en un clic de Bizagi (pero no viceversa). Esto significa que una vez que se decida utilizar el Deployment Avanzado para su proyecto, no ser posible cambir y volver a utilizar el Deployment en un clic (el Deployment tradicional presentado en Bizagi Studio). Para los proyectos que hayan usado la herramienta para el Deployment Avanzado, cualquier Deployment a futura deber seguirse realizando por medio del Deployment Avanzado. 2. Las herramientas de Deployment Avanzado no crean backups de manera automtica de ninguna Base de datos. Recuerde que como medida de contingencia, se recomienda siempre tomar backups de sus distintos ambientes del proyecto, antes de realizar cambios significativos en ellos. El Deployment realiza cambios significativos, sea por medio del Deployment en un clic o el Deployment Avanzado. Esto implica que si se utiliza el Deployment Avanzado, se debe tomar un backup del ambiente destino (pruebas o produccin), por lo menos antes de aplicar cualquier cambio (p.e antes de importar paquetes). 3. Es muy importante que tenga en cuenta que al usar el Deployment Avanzado, Bizagi Studio no podr realizar sus validaciones de dependencias. Es decir, si un objeto ya existe en produccin. Ante esto, es sumamente indispensable que no se eliminen objetos en desarrollo que estn siendo usados en produccin y que se creen nuevas versiones de Proceso cuando se requieran realizar cambios sobre los Procesos. 4. Al igual que con el Deployment en un clic, se recomienda programar y llevar a cabo el Deployment Avanzado en un horario no laboral. Esto promueve poder tener rpidas medidas de contigencia como la restauracin de backups, en caso de que los resultados del Deployment no sean los esperados.

2702

Copyright 2013 - Bizagi

Configurar el Deployment Avanzado

Para configurar el Deployment Avanzado, tenga en cuenta que esta herramienta provee 4 ejecutables diferentes (1 de ellos debe usarse en el ambiente de desarrollo, y los otros 2 en una mquina donde haya acceso a la Base de datos del ambiente destino (p.e una mquina que acceda a produccin que no necesariamente est en la misma red del ambiente de desarrollo). Para la configuracin, realice lo siguiente: 1. Tenga a la mano la herramienta con los ejecutables del Deployment Avanzado. Si su proyecto utiliza la edicin Bizagi Enterprise JEE, ubique la carpeta del Management Console en la ruta de instalacin de Bizagi (por defecto en "C:\Program Files (x86)\BizAgi\Bizagi Enterprise\MC"). Si su proyecto utiliza las ediciones Bizagi Enterprise .NET o Bizagi Xpress, por favor contacte nuestro equipo de soporte. 2. Asegrese que esta carpeta completa est en una mquina que tenga acceso en red a las Bases de datos de los ambientes. No se requiren pasos de instalacin adicionales. Ntese que es posible que requiera duplicar esta carpeta y ubicarla en 2 mquinas diferentes, dado el caso en el que su ambiente destino (p.e. produccin) no sea visible desde la misma mquina donde se accede al ambiente de desarrollo. 3. Configure los archivos para los ejecutables. Dentro de la estructura de la carpeta del Deployment Avanzado, se encuentran los siguientes ejecutables: Ex p o rt.ex e, CreateIm p o rt.ex e, y A p p ly Im p o rt.ex e, cons sus respectivos archivos de configuracin: Ex p o rt.ex e.co n fig, CreateIm p o rt.ex e.co n fig, y A p p ly Im p o rt,ex e.co n fig. Para configurar estos archivos, siga estas instrucciones: Primero configure el Export.exe, mediante la edicin de su archivo de configuracin Export.exe.config. De esta manera, especifique la conexin a la Base de datos de desarrollo (desde donde se va a obtener la informacin). Seguidamente configure CreateIm p o rt.ex e y A p p ly Im p o rt.ex e, editando sus archivos de configuracin CreateIm p o rt.ex e.co n fig y A p p ly Im p o rt.ex e.co n fig respectivamente. De esta manera, especifique la conexin a la Base de datos destino (hacia donde se publicarn los cambios: pruebas o produccin). Para configurar el detalle de conexin en estos archivos, ubique los elementos DSN DB y P RO VIDERTY P E (las llaves), y utilice: Para SQL Server: <add key="DSNDB" value="Persist Security Info=True;User ID=[login_user]; Password=[login_password];Data Source=[database_instance];Initial Catalog= [database_name];" /> <add key="PROVIDERTYPE" value="MSSqlClient" /> Para Oracle: <add key="DSNDB" value="Data Source=[connection_to_service];User ID= [schema_name];Password=[schema_password];Unicode=True;"/> <add key="PROVIDERTYPE" value= "Oracle" /> Nota En el escenario en el que se realiza un primer Deployment hacia el ambiente de pruebas o de produccin (la Base de datos destino todava no ha sido creada), entones deber utilizar un

Copyright 2013 - Bizagi

2703

ejecutable adicional de la carpeta, llamado CreateDatab ase.ex e. Para hacerlo, configure el archivo CreateDatab ase.ex e.co n fig con la informacin con la cual ser creada la Base de datos. Esta Base de datos ser creada como modelo en blanco de Bizagi, y estar configurada para uso exclusivo de ambiente de pruebas o de produccin. Tenga en cuenta: Si usted crea una Base de datos SQL Server, deber asegurarse que la instancia tenga un puerto TCP/IP explcito. Si usted crea una Base de datos Oracle, deber asegurarse de haber creado previamente el usuario BizagiAdmon. La nueva Base de datos quedar con la misma contrasea del usuario BizagiAdmon, de manera que deber especificar la contrasea de BizagiAdmon para la nueva configuracin.

Preparar el Deployment Avanzado

La primera tarea del Deployment Avanzado es crear el paquete del Export (archivo .bex), dado que este archivo contiene los cambios e informacin que se va a llevar al ambiente destino. Por lo tanto, antes de exportar los Procesos ys sus objetos, asegrese de cumplir con estas condiciones: 1. Todos los cambios en el ambiente de desarrollo deben haber sido guardados. En este punto, deberan conocerse los Procesos (y sub Procesos) que se van a publicar, y stos mismos deben haber tenido un check-in en Bizagi Studio (y que ningn miembro del equipo se encuentre trabajando sobre ellos). 2. Asegrese que para sus ambientes la ejecucin de validaciones de Rev isar m etad ata sea exitosa y no arroje ningn error. 3. Considere los datos y la configuracin administrable que se llevar directamente desde desarrollo (versus la que ser administrada en produccin). Es muy importante revisar los datos en cuanto a Entidades de Parametrizacin, para determinar cules registros de ellas deben ser llevados desde desarrollo, o cuales deben ser administrados directamente en produccin. Adems de esto, y en general, se recomienda enfticamente asegurarse de conocer lo que se debe llevar desde desarrollo tales como: configuracin de seguridad, de interfaces y sistemas externos, parmetros de ambiente, etc. Para ms informacin sobre estas consideraciones consulte las Consideraciones previas a un Deployment.

Utilizar el Deployment Avanzado

La utilizacin del Deployment Avanzado est dividido en 2 tareas principales: Primero se ejecuta la utilidad Export para generar el paquete con la informacin del Deployment, y luego se utilizan los otros ejecutables en el ambiente destino (pruebas o produccin) para aplicar el paquete de Deployment con sus cambios.

Utilizar el Export en el ambiente de desarrollo

2704 Copyright 2013 - Bizagi

1. Ejecute el Ex p o rt.ex e. ste le mostrar la siguiente informacin y opciones:

Opcin- Nmero en la imagen 1

Descripcin

Ensea el nombre de la Base de datos del proyecto, junto con su Servidor de Base de datos. Debe apuntar a su ambiente de desarrollo. Lista las aplicaciones del proyecto. Lista los Procesos (y sub Procesos) por cada aplicacin que son seleccionables para el Deployment. Lista las versiones de los Procesos que se pueden marcar para el Deployment. Al hacer clic derecho sobre una versin, aparece la posibilidad de incluir dependencias de manera manual. Permite configurar las opciones para la exportacin del paquete. Crea el archivo de exportacin (.bex). Presenta la posibilidad de revisar la informacin que se incluy en el archivo de exportacin.

2 3

5 6 7

Copyright 2013 - Bizagi

2705

Existen unas tareas adicionales, las cuales puede revisarse despus de la generacin del archivo de exportacin. Sin embargo, estas opciones tambin estn presentes en los ejecutables de importacin. 2. Marque los Procesos y sub Procesos a exportar. Recuerde que hay una opcin sobre el clic-derecho de la versin de Proceso, para definir manualmente dependencias adicionales, para que hayan ciertos objetos que se incluyan en el Deployment. Para ms informacin sobre este concepto, consulte Relacionar objetos.

Puede tambin optar por editar los objetos de sistema que se incluyen en el Deployment. Para ello, utilice el botn Avanzado ( A d v an ced). Las opciones en este botn varan de acuerdo a la edicin (Xpress o Enterprise). 3. Genere el archivo .bex haciendo clic en el botn de Exportar ( Ex p o rt). Seleccione la ruta donde guardar este archivo. Usted necesitar este archivo para la ejecucin del Import (en el ambiente de pruebas o produccin). Nota Si aparece algn error, entonces deber ajustarlo en el ambiente de desarrollo, y repetir el procedimiento hasta que no hayan errores.

2706

Copyright 2013 - Bizagi

Utilizar las utilidades del Import en el ambiente destino

Antes de ejecutar las utilidades de Import, asegrese que la Base de datos destino exista. Si es un primer Deployment en donde todava no hay dicho ambiente de pruebas o de produccin, utilice el ejecutable CreateDatab ase.ex e para crear un modelo de Base de datos de Bizagi en blanco. Una vez haya revisado lo anterior, recuerde tomar backups de su ambiente destino antes de proceder con estos pasos: 1. Ejecute el CreateIm p o rt.ex e. ste mostrar las siguientes opciones:

Opcin- Nmero en la imagen 1

Descripcin

Muestra el nombre de la Base de datos del proyecto en el ambiente destino, al igual que el nombre del Servidor de Base de datos. Debe referenciar al ambiente de pruebas o produccin (segn el caso), Presenta la opcin de cargar el archivo .bex del Export. Presenta la informacin sobre cmo se realiz el paquete de exportacin. Ejecuta una serie de validaciones para analizar potenciales

2 3

Copyright 2013 - Bizagi

2707

conflictos. Esto no realiza ningn cambio a la Base de datos destino. 5 Permite revisar y decidir si desmarcar o no, cada uno de los objetos (informacin del sistema) que sern llevados con el Deployment. Permite revisar y decidir si desmarcar o no, cada uno de los registros de las entidades de Parametrizacin que sern llevados con el Deployment. Crea el archivo de importacin final (.bim).

2. Cargue el archivo .bex (creado previamente en el Export) utilizando el botn de cargar archivo ( Lo ad F ile). Una vez se cargue, ejecute un anlisis usando la opcin de anlisis ( P ro cess Im p o rt an aly sis).

Nota Si aparece algn error, entonces deber ajustarlo (en este punto, la mayora de estos errores deben ajustarse en el ambiente de desarrollo). Una vez se hayan hecho ajustes, se debe repetir el procedimiento hasta que no hayan errores.

3. Utilice la opcin para revisar los objetos a importar ( v iew /ed it p ro cess o b jects to im p o rt). De esta

2708

Copyright 2013 - Bizagi

manera puede decidir desmarcar aquellos objetos bajo informacin detallada. Dentro de los objetos que se pueden revisar, se inclluye un filtro para revisar los objetos del sistema que sea actualizados, eliminados o adicionados. Este paso es realmente importante dado que permitir excluir cualquier informacin a nivel de registros, para no llevarla en el paquete del Deployment. Al hacer clic en esta opcin, la siguiente ventana se mostrar:

Opcin- Nmero en la imagen 1

Descripcin

Lista los objetos a nivel de tablas, que se incluyen en el Import. Seleccione cualquier tabla, para visualizar en el panel derecho, sus registros y poder desmarcarlos en caso de que aplique. No aplica ningn filtro para visualizar las tablas las cuales contienen informacin de registros (muestra todas). Filtra las tablas para mostrar nicamente aquellas que tienen registros que no han cambiado. Filtra las tablas para mostrar nicamente aquellas que tienen registros nuevos que sern adicionados. Filtra las tablas para mostrar nicamente aquellas que tienen registros que sern eliminados. Este filtro es muy importante, para

Copyright 2013 - Bizagi

2709

revisar que efectivamente se eliminen registros de la forma esperada. 6 Filtra las tablas para mostrar nicamente aquellas que tienen registros que sern actualizados. Este filtro es muy importante, para revisar que efectivamente se actualice informacin de la forma esperada. Permite excluir cualquier registro que se detecte como no necesario o acertado en trminos de llevarlo en el Deployment. Provee detalle sobre lo que va a quedar diferente. Es especialmente til para revisar la informacin a nivel de registro que va a ser actualizada. Filtra la informacin de manera similar a lo especificado en los nmeros 2-6. Es especialmente til revisar la informacin a detalle que va a ser actualizada, adicionada o eliminada. Guarda los cambios una vez que haya finalizado con la revisin de excluir objetos.

10

Una vez haya finalizado, proceda al siguiente paso. 4. Utilice la opcin para revisar los registros a importar ( v iew /ed it en tity o b jects to im p o rt) .De esta manera puede decidir desmarcar aquellos registros bajo informacin detallada. Dentro de los registros que se pueden revisar, se inclluye un filtro para revisar aquellos que sern actualizados, eliminados o adicionados. Este paso es realmente importante dado que permitir excluir cualquier informacin a nivel de registros, para no llevarla en el paquete del Deployment. Al hacer clic en esta opcin, la siguiente ventana se mostrar:

2710

Copyright 2013 - Bizagi

Opcin- Nmero en la imagen 1

Descripcin

Lista las Entidades de Parametrizacin que sern incluidas en el Import. Seleccione cualquiera de ellas, para visualizar en el panel derecho, sus registros y poder desmarcarlos en caso de que aplique. No aplica ningn filtro para visualizar las entidades las cuales contienen informacin de registros (muestra todas aquellas administrables en desarrollo que tengan registros). Filtra las entidades para mostrar nicamente aquellas que tienen registros que no han cambiado. Filtra las entidades para mostrar nicamente aquellas que tienen registros nuevos que sern adicionados. Filtra las entidades para mostrar nicamente aquellas que tienen registros que sern eliminados. Este filtro es muy importante, para revisar que efectivamente se elimine informacin de la forma esperada. Filtra las entidades para mostrar nicamente aquellas que tienen registros que sern actualizados. Este filtro es muy importante, para revisar que efectivamente se actualice informacin de la

Copyright 2013 - Bizagi

2711

forma esperada. 7 Permite excluir cualquier registro que se detecte como no necesario o acertado en trminos de llevarlo en el Deployment. Provee detalle sobre lo que va a quedar diferente. Es especialmente til para revisar la informacin a nivel de registro que va a ser actualizada. Filtra la informacin de manera similar a lo especificado en los nmeros 2-6. Es especialmente til revisar la informacin a detalle que va a ser actualizada, adicionada o eliminada. Guarda los cambios una vez que haya finalizado con la revisin de excluir objetos.

10

Una vez haya finalizado, proceda al siguiente paso. 5. Genere el archivo de importacin .bim haciendo clic en el botn de generar ( Gen erate Im p o rt file). Seleccione la ruta donde guardar este archivo. Usted necesitar este archivo para aplicar finalmente el paquete del Import (en el ambiente de pruebas o produccin) a travs del utilitario A p p ly Im p o rt.ex e. 6. Ejecute A p p ly Im p o rt.ex e. ste mostrar las siguientes opciones:

Opcin- Nmero en la imagen 1

Descripcin

Muestra el nombre de la Base de datos del proyecto en el ambiente destino, al igual que el nombre del Servidor de Base de

2712

Copyright 2013 - Bizagi

datos. Debe referenciar al ambiente de pruebas o produccin (segn el caso), de manera igual que el CreateIm p o rt.ex e. 2 3 Presenta la opcin de cargar el archivo .bim. Presenta la informacin sobre cmo se realiz el paquete de importacin. Aplica el paquete de Deployment hacia la Base de datos destino.

7. Cargue el archivo .bim (creado previamente en el Import), usando el botn de cargar ( Lo ad F ile ). Una vez que cargue, puede revisar que los objetos que se importan y cualquier modificacin, sean los esperados para aplicar en el ambiente destino. 8. Ejecute el Deployment utilizando el botn de Aplicar hacia la Base de datos ( A p p ly in to targ et Datab ase). Esto har que se ejecuten las modificaciones en la Base de datos destino. Una vez se realice, asegrese de llevar a cabo una revisin de lo llevado por el Deployment.

Qu sigue?
Despus de realizar un Deployment de Procesos hacia una Base de datos de ambiente de pruebas o de produccin, asegrese de actualizar la informacin que carga su Servidor BPM. En Bizagi Enterprise .NET, esto significa reiniciar los servicios del IIS para que el Portal de Trabajo tome los cambios. En Bizagi Enterprise JEE, esto significa: generar el Portal de Trabajo, haciendo despliegue de la aplicacin (el archivo .EAR) hacia el Servidor de Aplicaciones JEE; y reiniciar el servidor. Para ms informacin sobre este paso, consulte Despliegue a un Servidor de Aplicaciones JEE.

Copyright 2013 - Bizagi

2713

Parte VIII
Cmo....

Cmo....
Consulte los sub artculos de esta seccin para conocer acerca de cmo trabajar en situaciones tcnicas y de modelado especficas durante la implementacin de su proyecto en Bizagi.

8.1
8.1.1

Integracin
Cmo configurar Replicacin o Virtualizacin en JEE Application Server?

Introduccin
El procedimiento que se presenta en este artculo ilustra cmo configurar una fuente de datos externa en un servidor de aplicaciones JEE, usado para un ambiente de Bizagi de pruebas o de produccin. Este procedimiento slo se requiere si se utiliza la Virtualizacin o Replicacin como mtodos de integracin en el proyecto Bizagi. Este paso no se requiere en un ambiente de desarrollo del proyecto de Bizagi, ya que Bizagi Studio configura de manera automtica el servidor JBoss 7.1.1 (que se instala embebido en este ambiente), al momento de configurar la Virtualizacin o Replicacin.

Prerequisitos
Antes de continuar, asegrese que su servidor de Aplicaciones JEE haya sido configurado para trabajar con Bizagi. Para revisar esta configuracin, consulte el artculo correspondiente al procedimiento de acuerdo a cada Servidor de Aplicaciones JEE: Configuracin de WebSphere para trabajar con Bizagi. Configuracin de WebLogic para trabajar con Bizagi. Configuracin de JBoss para trabajar con Bizagi. Tambin recomendamos que ya se haya probado y verificado la Virtualizacin o Replicacin configurada en el ambiente de desarrollo.

Qu debe hacerse
Para configurar una fuente de datos externa (que sea utilizada por medio de Virtualizacin o Replicacin), a nivel del Servidor de Aplicaciones JEE, se requieren los siguientes pasos: 1. Registrar el driver de Bizagi utilizado para la conexin a esa fuente de datos. 2. Incluir la informacin de la conexion a las fuentes de datos. 3. Incluir parmetros de transaccin (aplica slo para la Virtualizacin).

Ejemplo
Copyright 2013 - Bizagi 2715

El siguiente ejemplo ilustra cmo configurar la Virtualizacin y Replicacin en un ambiente de produccin usando JBoss 7.1.1.

1. Registrar el driver de Bizagi utilizado para la conexin a esa fuente de datos

Para registrar el driver de conexin en JBoss 7.1.1, edite el archivo de configuracin stan d alo n e.x m l ubicado en <JBOSS_HOME>/standalone/configuration/. Tenga en cuenta que < JB O SS_H O M E> es la ruta inicial de instalacin JBoss 7.1.1, como se define en la configuracin de JBoss para trabajar con Bizagi (de la seccin de prerequisitos).

Para editar este archivo: 1. Ubique el elemento <drivers>. 2. Incluya las siguientes lneas para registrar el driver de "Bizagi" usado en la conexin a fuentes de datos externas: <driver name="BIZAGI" module="com.bizagi.jdbc"> <driver-class>bizagi.jdbc.BizAgiDriver</driver-class> </driver> En este punto, el archivo standalone.xml file deber verse de la siguiente manera:

2. Incluir la informacin de la conexion a las fuentes de datos

En el mismo archivo de configuracin <JBOSS_HOME>/standalone/configuration/ standalone.xml file, ubique el elemento <datasources> y adicione las siguientes lneas:

2716

Copyright 2013 - Bizagi

<datasource jta="false" jndi-name=" java:/[externalDS]" poolname="[externalDS]" enabled="true" use-ccm="true"> <connection-url>[connectionURL]</connection-url> <driver>[driver]</driver> <transaction-isolation>TRANSACTION_READ_COMMITTED</transactionisolation> <security> <user-name>[dbUser]</user-name> <password>[dbUserPassword]</password> </security> <validation> <validate-on-match>false</validate-on-match> <background-validation>false</background-validation> </validation> <statement> <share-prepared-statements>false</share-prepared-statements> </statement> </datasource> Edite las lneas adicionadas, asegurndose de tener en ellas los valores correspondientes a la conexin a la fuente de datos: [externalDS]: Un nombre nico que se da a esta fuente de datos externa. Si esta fuente de datos se utiliza para Replicacin, etonces este nombre debe corresponder al nombre dado en la propiedad JDataSource del proveedor (definida en Bizagi). Ms informacin sobre esto en la seccin Usan d o la p ro p ied ad JDataSo u rce . [driver]: El nombre del driver usado en la conexin (de acuerdo al motor de Base de datos de la fuente: O RA CLE,o M ICRO SO F TSQ LSERVER. [dbUser]: El usuario de la instancia de Base de datos. [dbUserPassword]: La contrasea utilizada para ese usuario. [connectionURL]: La cadena de conexin a la Base de datos. Para Bases de datos ORACLE, la cadena de conexin debe tener este formato: jdbc:oracle:thin:@//[databaseServer]:[servicePort]/[serviceName] Donde: [databaseServer]: Es el Servidor de Base de Datos Oracle. [servicePort]: El puerto sobre el cual la instancia Oracle atiende. [serviceName]: El nombre de la instancia de Oracle. Para Bases de datos SQL Server, la cadena de conexin debe tener este formato: jdbc:sqlserver://[databaseServerInstance]:[instancePort];databaseName= [SQLdatabase] Donde: [databaseServerInstance]: El nombre de la instancia de SQL Server, que incluye el nombre del Servidor de Base de datos. [instancePort]: El puerto sobre el cual la instancia SQL Server atiende.

Copyright 2013 - Bizagi

2717

[SQLdatabase]: El nombre de la Base de datos externa. Nota Este paso se requiere para cada fuente de datos externa que se use en el proyecto (sea para Virtualizacin o Replicacin). Esto significa que si se tiene ms de 1 fuente de datos externa, asegrese de incluir tantos elementos "datasource" (y configurarlos), como proveedores de datos para sistemas externos que tenga en Bizagi.

En la siguiente imagen, podemos ver que se utilizan 2 fuentes de datos en el proyecto:

Guarde el archivo y sus cambios.

Usando la propiedad JDataSource (aplica para la Replicacin) Al utilizar la Replicacin, tenga en cuenta que debe contar con la propiedad JDataSource para ese proveedor de datos. Esto se revisa desde el mdulo de Sistemas. La opcin puede ser configurada desde el Management Console de Bizagi:

2718

Copyright 2013 - Bizagi

Ntese que el valor para esta propiedad debe corresponder al nombre definido en [externalDS] en la edicin del archivo standalone.xml.

3. Incluir parmetros de transaccin (aplica slo para la Virtualizacin).

El siguiente paso se requiere nicamente si se cuenta con Virtualizacin para al menos 1 fuente de datos registrada. En el mismo archivo <JBOSS_HOME>/standalone/configuration/standalone.xml editado previamente: 1. Ubique el elemento <datasources>. 2. Adicione las siguientes lneas, que registran una nueva fuente de datos llamada "MainDS" (esto se realiza para la conexin principal a la Base de datos del proyecto Bizagi): <datasource jta="false" jndi-name=" java:/MainDS" pool-name=" MainDS" enabled="true" use-ccm="true"> <connection-url>[connectionURL]</connection-url> <driver>[driver]</driver> <transaction-isolation>TRANSACTION_READ_COMMITTED</transactionisolation> <security> <user-name>[dbUser]</user-name> <password>[dbUserPassword]</password> </security> <validation> <validate-on-match>false</validate-on-match> <background-validation>false</background-validation> </validation> <statement> <share-prepared-statements>false</share-prepared-statements>

Copyright 2013 - Bizagi

2719

</statement> </datasource>

3. Edite estas lneas, asegurndose de reemplazar en ellas los valores correspondientes para la conexin a su proyecto. Tenga en cuenta que esta informacin de la conexin, debe referenciar la Base de datos de Bizagi. [driver]: El nombre del driver usado en la conexin (de acuerdo al motor de Base de datos de la fuente: O RA CLE,o M ICRO SO F TSQ LSERVER. [dbUser]: El usuario de la instancia de Base de datos. [dbUserPassword]: La contrasea utilizada para ese usuario. [connectionURL]: La cadena de conexin a la Base de datos. Para Bases de datos ORACLE, la cadena de conexin debe tener este formato: jdbc:oracle:thin:@//[databaseServer]:[servicePort]/[serviceName] Donde: [databaseServer]: Es el Servidor de Base de Datos Oracle. [servicePort]: El puerto sobre el cual la instancia Oracle atiende. [serviceName]: El nombre de la instancia de Oracle. Para Bases de datos SQL Server, la cadena de conexin debe tener este formato: jdbc:sqlserver://[databaseServerInstance]:[instancePort];databaseName= [SQLdatabase] Donde: [databaseServerInstance]: El nombre de la instancia de SQL Server, que incluye el nombre del Servidor de Base de datos. [instancePort]: El puerto sobre el cual la instancia SQL Server atiende. [SQLdatabase]: El nombre de la Base de datos que corresponde a su proyecto en Bizagi. 4. Edite la fuente de datos "BizAgiJava" existente, de manera que se modifique la informacin dentro de los elementos "<connection-url>" y "<driver>". Esto se realiza para que utilicen un formato en el cul se consideran tanto las fuentes de datos externas con los proveedores de datos asociados, como la conexin a Bizagi. Para hacerlo, incluya en la fuente de datos BizagiJava la siguiente informacin en estos 2 elementos: <connection-url>jdbc:bizagi:mainDS=MainDS:external={[myProvider_N]: [externalDS_N]}</connection-url> <driver>BIZAGI</driver> Edite estas lneas, asegurndose de reemplazar en ellas los nombres correspondientes de los proveedores de datos de la fuente externa. Para ello, considere: [myProvider_N]: Es el nombre del proveedor de datos tal como se defini en Bizagi para la Virtualizacin .

2720

Copyright 2013 - Bizagi

[externalDS_N]: Es el nombre nico que se di en el elemento "<datasource>" para este proveedor (como se edit en un paso anterior).

Si hay ms de una fuente de datos externa configurada para la Virtualizacin, entonces se deben agregar duplas adicionales de {[myProvider_N]:[externalDS_N]} separados por punto y coma (;). Por ejemplo: <connection-url>jdbc:bizagi:mainDS=MainDS:external={[myProvider1]: [myExternal1]};{[myProvider2]:[myExternal2]}</connection-url> <driver>BIZAGI</driver>

Guarde el archivo y sus cambios.

8.1.2

Cmo configurar Virtualizacin para entidades relacionadas?

Informacin general
Como un requerimiento de negocio frecuente, un proceso puede necesitar acceder a cierta informacin que reside en un repositorio existente. Esto es, con el objetivo de presentar y utilizar esta informacin en Bizagi (como parte de informacin del negocio en el proceso). Para este tipo de integracin de datos, Bizagi presenta una funcionalidad llamada Virtualizacin, la cual es un mecanismo de integracin a nivel de datos que permite que ms de una tabla externa desde el repositorio existente, sean incluida en el modelo de datos del proceso de Bizagi para su uso de manera transparente. El acceso a datos a la fuente externa de informacin se realiza por demanda desde la ejecucin del proceso, sea para leer o escribir datos en ella. A travs de la Virtualizacin, ms de una tabla externa (mltiples tablas) se pueden mapear en el modelo de datos de Bizagi, de manera que esta informacin haga parte de la solucin Bizagi sin importar su origen. Cuando se desea trabajar e incluir ms de una tabla externa (es decir, se quiera virtualizar mltiples tablas), es comn que estas tablas contengan una relacin entre ellas (tpicamente mediante llaves forneas). Por lo tanto, para configurar apropiadamente este escenario, en Bizagi utilizamos el asistente de virtualizacin y unos pasos adicionales para incluir explcitamente el mapeo de los atributos que representan la relacin en dichas entidades.

Copyright 2013 - Bizagi

2721

El siguiente artculo ilustra cmo configurar las entidades relacionadas en cuanto al mapeo de la virtualizacin, de manera que Bizagi utilice la relacin de la llave fornea para obtener automticamente la informacin de los registros asociados (un "JOIN" en SQL).

Ejemplo
En este artculo presentaremos como ejemplo, un proceso en Bizagi el cual virtualiza 2 entidades desde un repositorio existente (una base de datos de ejemplo de un CRM en SQL Server). Las entidades a virtualizar corresponden a las tablas: Customer (Cliente) y Customer_Account (Cuentas del cliente), donde hay una relacin 1 a muchos entre ellas.

2722

Copyright 2013 - Bizagi

Nuestro proceso en Bizagi se llama Product Request (Solicitud de productos), y permitir al usuario final buscar un cliente existente o el registro de uno nuevo (por medio de un Join search dialog, o "Buscador Ventana"). Esto se realiza en la primera actividad del proceso que llamamos Register Request (Registrar solicitud).

Copyright 2013 - Bizagi

2723

Cuando el usuario final seleccione un cliente existente, la informacin de las cuentas del mismo (y su informacin), ser automticamente presentada en Bizagi. Para lograr lo anterior, describiremos el procedimiento que involucra: la configuracin de la virtualizacin para las entidades, incluir sus atributos de relacin, especificar el mapeo para estas relaciones, y definir la forma para nuestra actividad Register Request.

Procedimiento
Este procedimiento se realiza as: 1. 2. 3. 4. Configurar la virtualizacin para el repositorio existente. Incluir las relaciones de las entidades virtuales en el proceso. Especificar el mapeo para las relaciones. Definir la forma de mostrar la informacin de los registros mltiples.

La configuracin que se muestra en este artculo implica dos pasos del Asistente para la virtualizacin y las opciones avanzadas de virtualizacin.

Configurar la virtualizacin para el repositorio existente

2724

Copyright 2013 - Bizagi

Primero utilizaremos el asistente de virtualizacin para crear las entidades virtuales en nuestro proyecto Bizagi a partir de las existentes en nuestra base de datos CRM. Para realizarlo, vaya al paso 2 del asistente de Proceso Process llamado Modelo de datos (Data Model):

Seleccione virtualizacin para iniciar el asistente que permitir configurar fcilmente la informacin relacionada a nuestra conexin al CRM:

Copyright 2013 - Bizagi

2725

Incluya la informacin para nombrar y definir nuestro CRM como un "sistema externo" (external system) en el proyecto Bizagi:

2726

Copyright 2013 - Bizagi

Especifique el detalle de la conexin para el proveedor de la conexin (Provider):

Copyright 2013 - Bizagi

2727

Bizagi presentar las tablas y vistas disponibles del CRM para su virtualizacin. Seleccione (marque) las entidades a virtualizar y de clic en Sig u ien te.

2728

Copyright 2013 - Bizagi

En el siguiente paso no se define un filtro, ya que no se necesita en nuestro ejemplo. Haga clic en Sig u ien te.

Copyright 2013 - Bizagi

2729

Bizagi crear las entidades correspondientes:

2730

Copyright 2013 - Bizagi

Cuando este proceso termine, haga clic en F in alizar (Finish).

Copyright 2013 - Bizagi

2731

Incluir los atributos para las relaciones de las entidades

Ahora procederemos a incluir la relacin en nuestro modelo de datos Bizagi para representar y manejar la relacin entre las tablas Customer y Customer_Account del CRM. Habiendo completado el paso anterior, el modelo de datos del proceso Product Request mostrar las 2 entidades creadas para la virtualizacin: Customer y Customer_Accou (acortado de Customer_Account).

2732

Copyright 2013 - Bizagi

Asegrese que haya incluido un atributo de tipo referencia en la entidad de proceso (llamada "Product Request"), a la entidad Custom

Copyright 2013 - Bizagi

2733

De esta manera, definiremos que en nuestra entidad Product Request podremos tener un cliente nuevo o existente asociado al caso (a la solicitud). Edite la entidad Customer para incluir explcitamente una relacin hacia la entidad Customer_Accou.

2734

Copyright 2013 - Bizagi

De esta forma, un cliente tendr una o ms cuentas (registros en Customer_Accou). Para esta definicin, incluiremos un atributo de tipo coleccin:

Copyright 2013 - Bizagi

2735

Bizagi incluir los atributos para representar esta relacin:

2736

Copyright 2013 - Bizagi

Especificar el mapeo para la relacin

Una vez que nuestro modelo de datos en Bizagi contenga la informacin de la relacin, necesitaremos incluir el mapeo para estos atributos. Para realizarlo, vaya a la vista de Mdulos y seleccione el mdulo de Sistemas (Systems). Navegue en el nodo de Sistem a (System) y P ro v eed o r (Provider), nombrados en nuestra configuracin de virtualizacin como: "MyCRM" y "MyProvider1", hasta encontrar el listado de las entidades virtuales (Customer y Customer_Accou). Haga clic derecho sobre Customer_Accou y seleccione la opcin de A d icio n ar atrib u to a la v irtu alizaci n ("Add attribute to virtual"):

Copyright 2013 - Bizagi

2737

Incluya el atributo "Customer" de referencia que se cre para la relacin en la entidad Customer_Accou, y defina su mapeo de acuerdo a la fuente de este campo en el CRM (es decir, digitar el nombre del campo).

Ntese que esta parte es clave en la configuracin, principalmente porque es importante que se defina explcitamente en Bizagi el mapeo para el atributo de la relacin donde est la llave fornea (la entidad n de la relacin 1-n). Este mapeo debe ser a la llave de la entidad Customer.

2738

Copyright 2013 - Bizagi

Esto significa que sin importar si la Virtualizacin se configur por medio del asistente o no (tambin manualmente desde el mdulo de sistema), el mapeo al final debe contener: el atributo de la relacin de Bizagi en la entidad virtual que est mapeado al atributo de la fuente. Nota En el ejemplo anterior, el atributo Cu sto m er es el que se cre automticamente por Bizagi al definir la relacin 1-n (este atributo mantiene la relacin en Bizagi desde la entidad Cu sto m er_A cco u n t). Se recomienda entonces que se elimine el atributo id Cu sto m er, dado que su informacin quedara duplicada y no hara parte de la relacin en Bizagi (ya contemplada por el otro atributo). Para eliminar este atributo cuya informacin ya estara mapeada en Cu sto m er, puede ir al mdulo de entidades:

Hemos ahora incluido el mapeo adicional para la relacin en Bizagi, para definir qu columna determina la relacin en la base de datos del CRM.

Definir la forma para mostrar informacin de registros mltiples

Por ltimo vamos a incluir en nuestra Forma de Solicitud de Registro, los mbitos de nuestras entidades para: permitir la seleccin de un cliente y mostrar las cuentas asociadas para ese cliente (que muestra la informacin de varios registros de la relacin). Para ello, vaya al Asistente de Procesos y seleccione el tercer paso (Definir formas):

Copyright 2013 - Bizagi

2739

Incluya el atributo Cu sto m er de su entidad de proceso en la forma de Solicitud de Registro. De forma predeterminada, esto se representa como un control Search .

2740

Copyright 2013 - Bizagi

Para este control, establezca sus propiedades de bsqueda tales como: el atributo para mostrar, y la forma que se abre (defina una nueva seleccionando N u ev a fo rm a):

Copyright 2013 - Bizagi

2741

Para la nueva forma del control asegrese de arrastrar y soltar algunos de los atributos de los clientes (como criterios de bsqueda), y tambin asegurarse de darle un nombre a la Forma. Observe en este ejemplo, hemos incluido el nombre del cliente y los atributos de correo electrnico, y hemos llamado a nuestra forma M y Cu sto m erSearch F o rm .

Guarde esta forma. Incluya la coleccin Cu en tas (Accounts) en la forma y edite las columnas que se muestran en la tabla:

2742

Copyright 2013 - Bizagi

Se incluyen los atributos Cu sto m er_A cco u n t: Nmero de cuenta, Fecha de creacin y el Balance.

Copyright 2013 - Bizagi

2743

Guarde la forma. De vuelta a la forma principal, asegrese de que la tabla Cuentas se establece como de slo lectura. Esto significa, asegurando que la propiedad Edit est en flaso y no se permita aadir, editar o eliminar registros. En este punto, hemos terminado de configurar la virtualizacin para las entidades relacionadas. Nuestras tablas externas de bases de datos CRM se usan de manera transparente en nuestro proceso de Solicitud de productos!

Ejecucin
Ahora ejecute su proceso.

En el portal de trabajo puede crear un caso nuevo del proceso Product Request. En la primera actividad (Register Request) realice una bsqueda de un cliente existente:

2744

Copyright 2013 - Bizagi

Al seleccionarlo, sus cuentas asociadas se presentarn automticamente en la tabla:

Consideraciones adicionales
Cuando se utiliza la virtualizacin para las entidades relacionadas, hay escenarios ms sofisticados que son soportados por Bizagi. Por ejemplo: tener llaves primarias compuestas en el origen, tener Entidades Paramtricas replicadas relacionadas con Entidades maestras virtualizadas, etc

Compound primary keys

Bizagi soporta la virtualizacin de entidades que tengan llaves primarias compuestas (es decir que en

Copyright 2013 - Bizagi

2745

el repositorio existente, la tabla tenga ms de una columna componiendo su llave primaria). Para configurar este tipo de escenarios, en Bizagi solamente se requiere asegurar que los atributos mapeados en la virtualizacin de la llave primaria, estn incluidos en su totalidad como llave de negocio de la entidad virtual (business key). Para revisar o modificar (incluir atributos) la definicin de los atributos que hacen parte de la llave primaria de la fuente, haga clic derecho sobre la entidad virtual y seleccione sus propiedades (en el Mdulo de Sistemas). En nuestro ejemplo, nicamente el atributo nmero de cuenta (accountnumber) se defini como llave de negocio para la entidad Customer_Accou (sin llave compuesta). Usted puede editar o examinar este ajuste ubicando de la entidad especfica en el mdulo de Sistemas, y haciendo clic en sus Propiedades:

Para incluir ms de un atributo como llave principal, seleccione los atributos adicionales que conforman la definicin businessKey. Nota De forma predeterminada, Bizagi leer la definicin de llave principal de la fuente (cuando se utiliza el Asistente de virtualizacin) e incluir los atributos que componen la llave primaria compuesta. Usando como ejemplo una tabla Customer_Products (productos de un cliente) de una fuente de datos externa, podramos encontrar que su llave primaria es definida por tanto el atributo ProductId y el CustomerId:

2746

Copyright 2013 - Bizagi

Esto significa que en Bizagi, necesitaremos asegurar que para esa entidad, la llave de negocio (businessKey) incluya estos 2 atributos:

Copyright 2013 - Bizagi

2747

Nota Si se virtualiza a su vez una entidad adicional que referencia a esta llave compuesta (una relacin fornea a la entidad Customer_Products), entonces se requiere mapear en el atributo de la relacin, los N atributos que compongan la llave primaria compuesta. Esto se hace con separacin de coma y en el mismo orden exacto en que se definen en la fuente, de la manera: "atributo1, atributo2". En el ejemplo anterior, esto significa mapear contra "customerid, productid".

8.1.3

Cmo iniciar Procesos en Bizagi desde otras aplicaciones

Informacin general
Un requerimiento comn en los proyectos Bizagi, es la posibilidad de iniciar procesos de Bizagi desde un portal o sistema externo, por ejemplo desde SharePoint, un correo electrnico, o desde un aplicacin desarrollada de manera personalizada. En Bizagi, esta opcin se presenta desde la Capa SOA de Bizagi y sus servicios web, para crear de manera automtica uno o ms casos de cualquier proceso de Bizagi.

2748

Copyright 2013 - Bizagi

Vea mayor informacin de esta funcionalidad Invocar servicios Bizagi desde aplicaciones externas.

Lo que se debe hacer

Para inciar uno o ms procesos en Bizagi desde otras aplicaciones todo lo que debe hacer es invocar el mtodo web createCasesA sStrin g del servicio web "WorkflowEngineSOA", publicado en todos los proyectos de Bizagi. Este mtodo Web pertenece a los servicios Web WorkflowEngineSOA , que se publican de forma predeterminada en http://[su_servidor]/[su_proyecto]/WebServices/WorkflowEngineSOA.asmx?wsdl (para las Ediciones Enterprise. NET y Xpress). Para obtener informacin completa acerca de la direccin URL de acceso a estos servicios web (y para la edicin Enterprise JEE), consulte la URL Capa SOA y consideraciones. Al invocar los mtodos Web createCasesA sStrin g, o createCases disponibles para Bizagi Xpress y Enterprise .NET, se enviar informacin estructurada XML de entrada que contiene principalmente: el usuario que crea del caso o los casos, el proceso o procesos para iniciarar y cualquier otra informacin considerada relevante de negocio.

Ejemplo
El siguiente ejemplo se lleva a cabo usando el proceso de Solicitud de Vacaciones de Mi Primer Proceso. Para este proceso, vamos a crear casos desde una aplicacin externa.

Copyright 2013 - Bizagi

2749

Para poder hacer esto, es importante estar familiarizado con el modelo de datos. Queremos enviar la informacin mostrada en la primera actividad del proceso que corresponde a: Las fechas de inicio y fin de vacaciones y el nmero de das solicitados. Esta informacin corresponde a los siguientes atributos de nuestro proceso llamado Vacatio n Req u est.

Para incluir informacin tanto del proceso como informacin de negocio en las instancias de proceso (casos creados), es importante utilizar el nombre exacto de los elementos como se espera en Bizagi en la estructura XML. Por ejemplo, el valor del tag <Process> debe ser el nombre del proceso, no su nombre visual. De igual modo el primer tag bajo <Entities> ser el nombre del atributo de la Aplicacin (en este caso App) que referencia a la entidad del proceso. Se debe usar siempre el nombre correspondiente del atributo, entidad, o coleccin y no el nombre visual, y tener en cuenta que los tags de la estructura XML son sensibles a maysculas (y minsculas). Para revisar cmo se espera la informacin de negocio en el modelo de datos Bizagi, refirase a Esquemas del modelo de datos de Bizagi XML.

Definir el XML de entrada

Para crear un nuevo caso para este proceso, el XML que necesita ser enviado a createCases es como el siguiente: <BizAgiWSParam> <domain>domain</domain> <userName>admon</userName> <Cases> <Case>

2750

Copyright 2013 - Bizagi

<Process>VacationRequest</Process> <Entities> <VacationRequest> <VacationStartingDate>2012-03-18T12:00:00-05:00</ VacationStartingDate> <VacationEndingDate>2012-03-26T12:00:00-05:00</ VacationEndingDate> <NumberOfOfficeDaysReques>6</NumberOfOfficeDaysReques> </VacationRequest> </Entities> </Case> </Cases> </BizAgiWSParam> El XML anterior crea un caso para el proceso VacationRequest, y el creador sera el usuario domain\admon. Para crear ms de un caso en una misma invocacin, incluya un tag <Case> para cada caso necesario dentro del tag "Cases". El creador puede tambin ser cambiado pero tenga en cuenta que: 1. Debe ser un usuario que exista para el proyecto de Bizagi creado en el Portal de Trabajo 2. Debe tener permisos para iniciar un nuevo caso del proceso deseado.

Por ejemplo crearemos mltiples casos con el siguiente XML: <BizAgiWSParam> <domain>domain</domain> <userName>admon</userName> <Cases> <Case> <Process>VacationRequest</Process> <Entities> <VacationRequest> <VacationStartingDate>2012-03-18T12:00:00-05:00</ VacationStartingDate> <VacationEndingDate>2012-03-26T12:00:00-05:00</ VacationEndingDate> <NumberOfOfficeDaysReques>6</NumberOfOfficeDaysReques> </VacationRequest> </Entities> </Case> <Case> <Process>VacationRequest</Process> <Entities> <VacationRequest> <VacationStartingDate>2012-07-19T12:00:00-05:00</ VacationStartingDate> <VacationEndingDate>2012-07-23T12:00:00-05:00</ VacationEndingDate> <NumberOfOfficeDaysReques>4</NumberOfOfficeDaysReques> </VacationRequest>

Copyright 2013 - Bizagi

2751

</Entities> </Case> <Case> <Process>VacationRequest</Process> <Entities> <VacationRequest> <VacationStartingDate>2011-12-16T12:00:00-05:00</ VacationStartingDate> <VacationEndingDate>2012-01-07T12:00:00-05:00</ VacationEndingDate> <NumberOfOfficeDaysReques>17</NumberOfOfficeDaysReques> </VacationRequest> </Entities> </Case> </Cases> </BizAgiWSParam>

Npta: Ntese que para crear casos sin incluir informacin de negocio, no hara falta incluir el tag <Entities>. Puede crear casos vacos.

La aplicacin externa
Usando en este ejemplo una Aplicacin de Windows como la aplicacin externa que dispara el caso nuevo (como se muestra en la siguiente imgen), se ingresa la informacin necesaria y seguidamente mediante un botn se invoca la creacin de un nuevo caso por medio del mtodo web de la Capa SOA. Dado que este ejemplo se trabaja con la Edicin Enterprise .NET, podemos invocar el mtodo createCasesA sStrin g o createCases. Para este ejemplo trabajado en una aplicacin .NET en Visual Studio, que se ha definido previamente una referencia Web que seala a nuestra direccin web createCases: http://myServer/MyFirstProcess/webservices/WorkflowEngineSOA.asmx?wsdl Una vez que se pulsa el botn, el caso se crea utilizando la Capa SOA de Bizagi. Dentro de la informacin de respuesta (output), recibimos el nmero de caso, junto con otra informacin adicional.

2752

Copyright 2013 - Bizagi

El cdigo del botn al hacer clic sera: private void button1_Click(object sender, EventArgs e) { //Dates are converted to string using this command to avoid problems with different dates formats string sStartingDate = XmlConvert.ToString(dateTimePicker1.Value, XmlDateTimeSerializationMode.Unspecified); string sSEndingDate = XmlConvert.ToString(dateTimePicker2.Value, XmlDateTimeSerializationMode.Unspecified); //We build the input XML string sXml = "<BizAgiWSParam>"; sXml += "<domain>domain</domain>"; sXml += "<userName>admon</userName>"; sXml += "<Cases>"; sXml += "<Case>"; sXml += "<Process>VacationRequest</Process>"; sXml += "<Entities>"; sXml += "<VacationRequest>"; sXml += "<VacationStartingDate>" + sStartingDate + "</ VacationStartingDate>"; sXml += "<VacationEndingDate>" + sSEndingDate + "</ VacationEndingDate>"; sXml += "<NumberOfOfficeDaysReques>" + textBox1.Text + "</ NumberOfOfficeDaysReques>"; sXml += "</VacationRequest>"; sXml += "</Entities>"; sXml += "</Case>"; sXml += "</Cases>"; sXml += "</BizAgiWSParam>"; XmlDocument xDoc = new XmlDocument(); xDoc.LoadXml(sXml);

Copyright 2013 - Bizagi

2753

//We use the set web reference and invoke the createCases method MyFirstProcessWE.WorkflowEngineSOA ws = new MyFirstProcessWE.WorkflowEngineSOA(); XmlNode xn = ws.createCases(xDoc); //If the response information is succesful, we retrieve the new case's Id. if (xn.SelectSingleNode("process/processId").InnerText != "0") { textBox2.Text = xn.SelectSingleNode("process/processRadNumber") .InnerText; } }

Verificacin en el Portal
En nuestro Portal de Trabajo http://myServer/MyFirstProcess/, verificamos que el nmero de caso 502 se ha creado satisfactoriamente. Este caso ser mostrado en las actividades pendientes con la informacin inicial enviada. Note que la actividad justo cuando empieza el proceso se llama Reg ister Vacatio n Req u est:

8.1.4

Cmo realizar Actividades Bizagi desde otras aplicaciones

Informacin general
Un requerimiento comn en los proyectos Bizagi, es la posibilidad de realizar y avanzar una actividad de un caso en Bizagi, desde un portal o sistema externo. En Bizagi, esta opcin se presenta desde la Capa SOA de Bizagi y sus servicios web, para realizar (y avanzar) de manera externa una actividad pendiente de cualquier proceso de Bizagi. Vea mayor informacin de esta funcionalidad Invocar servicios Bizagi desde aplicaciones externas.

2754

Copyright 2013 - Bizagi

Lo que se debe hacer

Para completar actividades pendientes y avanzar el flujo de proceso en Bizagi desde otra aplicacin todo lo que debe hacer es invocar el mtodo web p erfo rm A ctiv ity A sStrin g, publicado en todos los proyectos de Bizagi. Este mtodo Web pertenece a los servicios Web WorkflowEngineSOA , que se publican de forma predeterminada en http://[su_servidor]/[su_proyecto]/WebServices/WorkflowEngineSOA.asmx?wsdl (para las Ediciones Enterprise. NET y Xpress). Para obtener informacin completa acerca de la direccin URL de acceso a estos servicios web (y para la edicin Enterprise JEE), consulte la URL Capa SOA y consideraciones. Al invocar los mtodos Web p erfo rm A ctiv ity A sStrin g,o p erfo rm A ctiv ity disponibles para Bizagi Xpress y Enterprise .NET, se enviar informacin estructurada XML de entrada que contiene principalmente: el usuario que realiza la actividad, el elemento de trabajo especfico para trabajar (la instancia actual de actividad pendiente para un caso dado), y cualquier informacin adicional que se considere pertinente negocios.

Ejemplo
El siguiente ejemplo se lleva a cabo usando el proceso de Solicitud de Vacaciones de el Process Central.

Para este proceso avanzaremos la actividad Reg ister Vacatio n Leav e Req u est desde una aplicacin externa. Para incluir informacin de negocio o editar informacin existente en esta actividad, es importante estar familiarizado con el modelo de datos. Queremos incluir la informacin en la primera actividad del proceso que corresponde a: Las fechas de inicio y fin de vacaciones y el nmero de das solicitados. Esta informacin corresponde a los siguientes atributos de nuestro proceso llamado Vacatio n Req u est.

Copyright 2013 - Bizagi

2755

Definir el XML de entrada

Es importante utilizar siempre los nombre exactos de los elementos, como se esperan en la estructura XML de Bizagi. Por ejemplo el valos contenido en el tag <taskName>, debe ser el nombre de la Actividad y no utilizar el nombre para mostrar. De la misma manera el tag debajo de <Entities> ser el nombre del atributo en la Entidad de Aplicacin (en este caso App) que referencia a la entidad de proceso. Se debe usar siempre el nombre correspondiente del atributo, entidad, o coleccin y no el nombre visual, y tener en cuenta que los tags de la estructura XML son sensibles a maysculas (y minsculas). Para revisar cmo se espera la informacin de negocio en el modelo de datos Bizagi, refirase a Esquemas del modelo de datos de Bizagi XML. Para ver el nombre exacto de la actividad, vaya al primer paso en el Asistente de proceso (Modelar Procesos) y vea los detalles de la actividad dada.

2756

Copyright 2013 - Bizagi

En nuestro ejemplo para avanzar la Actividad se enva la siguiente estrucutra XML como entrada: <BizAgiWSParam> <ActivityData> <idCase>1001</idCase> <taskName>Register</taskName> </ActivityData> <Entities> <VacationRequest> <RequestVacation>true</RequestVacation> <LeavingDate>2010-06-21T12:00:00-05:00</LeavingDate> <ReturningDate>2010-06-25T12:00:00-05:00</ReturningDate>

Copyright 2013 - Bizagi

2757

<NumberOfOfficeDaysReques>5</NumberOfOfficeDaysReques> </VacationRequest> </Entities> </BizAgiWSParam>

Note que este XML completa la actividad para el proceso de Solicitud de Vacaciones, para la instancia que tenga el idCase 1001.

Note: El tag <Entities> es opcional. Usted puede escoger slo avanzar la actividad sin enviar informacin. Para hacerlo NO incluya en este tag ninguna informacin.

La aplicacin externa
Usando en este ejemplo una Aplicacin de Windows como la aplicacin externa que avanza el caso de una Actividad pendiente. E el ejemplo se ingresa la informacin de negocio necesaria y seguidamente mediante un botn se invoca el mtodo web de la Capa SOA.

Dado que este ejemplo se trabaja con la Edicin Enterprise .NET, podemos invocar el mtodo p erfo rm A ctiv ity A sStrin g o p erfo rm A ctiv ity.

2758

Copyright 2013 - Bizagi

Para este ejemplo trabajado en una aplicacin .NET en Visual Studio, que se ha definido previamente una referencia Web que seala a nuestra direccin web createCases: http://myServer/MyFirstProcess/webservices/WorkflowEngineSOA.asmx?wsdl Una vez que se pulsa el botn, el caso avanza utilizando la Capa SOA de Bizagi. Dentro de la informacin de respuesta (output), recibiramos un mensaje de error si falla la invocacin junto con otra informacin adicional.

El cdigo del clic del botn sera: private void button2_Click(object sender, EventArgs e) { try { string sStartingDate = XmlConvert.ToString (dateTimePicker1.Value, XmlDateTimeSerializationMode.Unspecified); string sSEndingDate = XmlConvert.ToString (dateTimePicker2.Value, XmlDateTimeSerializationMode.Unspecified); string sXml = "<BizAgiWSParam>"; sXml += "<ActivityData>"; sXml += "<idCase>" + textBox2.Text + "</idCase>"; sXml += "<taskName>Task1</taskName>"; sXml += "</ActivityData>"; sXml += "<Entities>"; sXml += "<VacationRequest>"; sXml += "<VacationStartingDate>" + sStartingDate + "</ VacationStartingDate>"; sXml += "<VacationEndingDate>" + sSEndingDate + "</ VacationEndingDate>";

Copyright 2013 - Bizagi

2759

sXml += "<NumberOfOfficeDaysReques>" + textBox1.Text + "</ NumberOfOfficeDaysReques>"; sXml += "</VacationRequest>"; sXml += "</Entities>"; sXml += "</BizAgiWSParam>"; XmlDocument xDoc = new XmlDocument(); xDoc.LoadXml(sXml); MyFirstProcessWE.WorkflowEngineSOA ws = new MyFirstProcessWE.WorkflowEngineSOA(); XmlNode xn = ws.performActivity(xDoc); if (xn.SelectSingleNode("process/processError/errorCode") != null) { label6.Text = "ERROR:" + xn.SelectSingleNode("process/ processError/errorMessage").InnerText; } else { label6.Text = "SUCCESS"; } } catch (Exception ex) { label6.Text = "ERROR: " + ex.Message; } finally { label6.Visible = true; } }

Verifying at the Work Portal

En nuestro Portal de Trabajo http://myServer/MyFirstProcess/, verificamos que el nmero de caso 502 se ha avanzado de su estado inicial ( Reg ister Vacatio n Req u est) al siguiente. La siguiente actividad es A p p ro v e Vacatio n Req u est que mostrar la informacin enviada:

2760

Copyright 2013 - Bizagi

8.1.5

Cmo integrar Bizagi con SAP

Informacin general
La integracin de Bizagi con SAP es posible en ambas direcciones: se puede tener un proceso en Bizagi que consulte o enve informacin a SAP, o se puede tener una funcin en SAP que invoque un servicio web de Bizagi (por ejemplo, para iniciar un proceso). En este artculo, nos enfocaremos en describir cmo integrar Bizagi con SAP bajo el escenario de tener un proceso en Bizagi que invoque funciones BAPI ("BAPI wrappers") de SAP. Para entender la integracin en la otra direccin (desde SAP hacia Bizagi) necesita invocar servicios web, riefirase a Capa SOA de Bizagi.

Integracin con SAP

La invocacin de funciones de SAP desde Bizagi puede lograrse de 2 maneras diferentes: Configurando invocaciones de servicios web a travs del asistente de interfaces de Bizagi, el cul no require programacin alguna. Desarrollando y registrando un componente que invoque las APIs de SAP (en este caso las "BAPI wrappers"). El siguiente diagrama representa las dos opciones de integracin para invocar las funciones en SAP:

Copyright 2013 - Bizagi

2761

Vea mayor informacin sobre Cmo integrar Bizagi con SAP a travs de la invocacin de un servicios web de SAP (no requiere de programacin). Integrar Bizagi con SAP invocando servicios web de SAP Vea mayor informacin sobre Cmo integrar Bizagi con SAP mediante la invocacin de BAPI wrappers desde un componente (requiere programacin). Integrar Bizagi con SAP invocando directamente BAPI Wrappers

8.1.5.1

Integrar Bizagi con SAP invocando servicios web de SAP

Overview
En este artculo vamos a describir cmo integrar Bizagi con SAP, desde la perspectiva de tener un proceso en Bizagi que invoque un web service de SAP. Este enfoque no requiere de programacin, ya que se utiliza el asistente de interfaces en Bizagi.

2762

Copyright 2013 - Bizagi

Se pueden consultar los 2 ejemplos disponibles acerca de la integracin Bizagi-SAP a travs de servicios web: el Cmo crear un proveedor en SAP (datos maestros), y este ejemplo sobre la creacin de datos transaccionales. En este ejemplo se ilustra especficamente la creacin de una reserva de vuelo en SAP que se realiza desde el proceso en Bizagi. Para ver el otro artculo para creacin de datos maestros refirase a Crear un proveedor en SAP desde Bizagi. En SAP, requerimos que las funciones para crear la reserva de vuelo sean publicadas como un servicio web. Para esto, se puede optar por usar los utilitarios de SAP Netweaver para publicar servicios web, o mediante el componente PI de SAP (o anteriormente conocido como "XI"). Para ms informacin de SAP Netweaver y sus mdulos refirase a Documentacin SAP. Para ilustrar esta idea, el siguiente diagrama representa el funcionamiento y arquitectura de esta integracin:

En este artculo, vamos a ilustrar especficamente a la creacin de una reserva de vuelo en SAP, realizado desde Bizagi sin necesidad de programacin.

Copyright 2013 - Bizagi

2763

Si desea ver otra posibilidad para esta integracin, en la que las llamadas directas sobre las funciones de SAP (Wrappers BAPI) se utilizan en lugar de las invocaciones de servicios Web, consulte Integrar Bizagi con SAP invocando directamente BAPI Wrappers (requiere programacin y aplica para las Ediciones Enterprise).

Prerequisitos
Para lograr esta integracin es necesario: Tener las funciones disponibles en el sistema SAP que consulten y creen registros en SAP. Si se planea usar BAPI wrappers para actualizar o crear informacin en SAP, se recomienda garantizar que estas mismas funciones persistan la informacin (hagan "commit" de la trasaccin). Publicar dichas funciones en un servicio web, ya sea usando el componente PI de SAP o los utilitarios que presenta SAP Netweaver. Al final, las funciones estarn publicadas correctamente en un servicio web si podemos revisar el/los WSDL que contiene los mtodos:

Lo que debe hacer en Bizagi

Los pasos a seguir para cubrir la integracin son: 1. Buscar la funcin en SAP a invocar (y sus parmetros de importacin y exportacin). De esta manera podemos reconocer la informacin y su estructura, la enviada y recibida en la funcin (input y output).

2764

Copyright 2013 - Bizagi

2. Configurar el servicio web de invocacin. La configuracin en Bizagi se realiza por medo del asistente de interfaces..

Ejemplo
El ejemplo de este artculo fue trabajado con el mdulo de vuelo disponible en SAP R/3, y junto con un proceso en Bizagi que llamamos "BookFlight" (Reservas de vuelo). Las funciones usadas en esta integracin que se invocan en SAP, son las BAPI wrappers: "BAPI_FLIGHT_GETLIST", que consulta y retorna una lista de vuelos disponibles de acuerdo a cierto criterio de filtro. "BAPI_FLBOOKING_CREATEFROMDATA", que crea la reserva de vuelo y retorna el nmero de reserva. Para ms informacin acerca del mdulo de vuelo de SAP refirase a la documentacin de SAP: http:// help.sap.com/saphelp_nw04/helpdata/en/content.htm. En una breve descripcin, el proceso "BookFlight" en Bizagi funciona como se describe a continuacin: 1. Un usuario crea un nuevo caso para su solicitud de viaje en la cul l/ella ingresa principalmente: ciudad de salida (departure city), ciudad de destino (arrival city), y un rango de fecha de vuelo (flight date). 2. Una lista de vuelos disponibles le es presentada con todos los vuelos en SAP que cumplen las condiciones ingresadas en el paso anterior. 3. El solicitante escoge un vuelo especifico para realizar su reservacin, y enva dicha informacin junto con: el nombre completo del pasajero, la clase del vuelo deseada. 4. Cuando la solicitud es aprobada por otro usuario quien realiza esta revisin, se crea la reserva en SAP y una notificacin de correo le llega al usuario solicitante. El siguiente modelo de proceso ilustra el proceso de Solicitud de Viaje en Bizagi:

En este ejemplo, partimos de que ambas funciones ya estn publicadas y disponibles en un servicio web (configuradas por defecto en la instalacin del mdulo de vuelo de SAP):

Copyright 2013 - Bizagi

2765

1. Obteniendo el detalle de las funciones a invocar en SAP

Una vez que tengamos publicado el servicio web con las funciones disponibles, podemos revisar el detalle y definicin de estas funciones que vamos a invocar. Este paso incluye conocer los parmetros de importacin/exportacin (import/export) y tablas involucradas, as mismo como la metadata de las estructuras de SAP empleadas en las funciones. En este caso particular, vamos a ilustrar la invocacin de la funcin BAPI wrapper B A P I_F LIGH T_GETLIST, para lo cual necesitamos entender la estructura de retorno del listado de vuelos disponibles. Para conocer este detalle (sobre los parmetros de entrada del mtodo), revisamos las funciones usando en SAP la transaccin se37, la cual nos muestra una pantalla para la administracin de funciones.

2766

Copyright 2013 - Bizagi

En la imagen a continuacin, vemos detalle de la funcin BAPI_FLIGHT_GETLIST y sus parmteros de importacin ("import").

La estructura del listado de vuelos ( F LIGH T_LIST structure) que retorna SAP es:

Copyright 2013 - Bizagi

2767

De manera similar, se revisa tambin el detalle de la funcin B A P I_F LB O O KIN G_CREA TEF RO M DA TA que se invoca posteriormente para crear la reserva del vuelo en SAP. Nota Se debe revisar si el servicio web de SAP maneja parmetros de tipo DATE ("FECHA"), como en este caso. De ser as, debemos preparar la informacin en Bizagi que se enviar a la funcin para garantizar que se enve en formato estandar de fechas para archivos XML (es decir, en formato 'yyyy-MM-dd'). Bizagi actualmente soporta nicamente enviar campos de fecha como DATE-TIME (fecha-hora), cuyo formato siempre incluye la hora de la manera: 'yyyy-MM-ddThh-mm-ss'. Debemos eliminar la informacin de tiempo para el campo, pues SAP espera FECHA solamente. Ahora procedemos a configurar el servicio web en Bizagi por medio del asistente de interfaces, tiendo en cuenta la estructura y la informacin esperada por las funciones SAP.

2. Configurando la invocacin del servicio web en Bizagi

Para este ejemplo, configuraremos la consulta de vuelos disponibles en las tarea de servicio: Get A v ailab le F lig h ts fro m SA P . Para ello, vamos al sexto paso del Asistente de proceso en Bizagi Studio, In teg rar y seleccionamos Definir interfaces de integracin.

2768

Copyright 2013 - Bizagi

Seguidamente seleccionamos la tarea de servicio Get A v ailab le F lig h ts fro m SA P y usamos el asistente de interfaces para configurar el mappeo en Bizagi. Selecciona SOA como tipo de servicio e ingrese la URL del servicio web y hacemos click en el botn de Go . Seleccionamos el mtodo web para nuestro ejemplo y damos clic en Sig u ien te.

Copyright 2013 - Bizagi

2769

Ntese que de acuerdo a la configuracin y seguridad en la publicacin del servicio web, este paso puede requerir autenticacin y solicitar las credenciales autorizadas.

Para este ejemplo, hemos mapeado los parmetros de entrada de tipo fecha ("date") apoyndonos en las funciones de Bizagi de concatenar (Concat) y de usar constantes (Constant) para asegurarnos de que el formato de fecha que se enva a SAP es: 'yyyy-MM-dd'. En la ventana de input mapeamos la informacin correspondiente desde Bizagi a SAP:

2770

Copyright 2013 - Bizagi

Tenga en cuenta que para usar las funciones Concat y Constant necesita maximizar la ventana de configuracin D clic en Sig u ien te una vez finalice su mapeo. El mapeo de los parmetros de salida se hace como se muestra a continuacin:

Copyright 2013 - Bizagi

2771

En el ltimo paso, damos clic en F in alizar. (No necesitamos definir manejo de error en esta invocacin).

2772

Copyright 2013 - Bizagi

De manera similar, la tarea de servicio B o o k flig h t in SA P se configura con la invocacin de la funcin que crea la reserva de vuelo en SAP ( B A P I_F LB O O KIN G_CREA TEF RO M DA TA ), enviando los datos del vuelo seleccionado en Bizagi. En este punto, la integracin via servicios web a travs de la Capa SOA se ha configurado para que el proceso en Bizagi cree un registro en SAP!

Ejecucin
Para ver este ejemplo ejecutamos el Portal de Trabajo desde la opcin Ejecu tar:

Copyright 2013 - Bizagi

2773

AL trabajar el proceso de Reserva de Vuelos la tarea de servicio Get av ailab le flig h ts fro m SA P obtendr y actualizacin en Bizagi los resultados de la consulta desde SAP:

2774

Copyright 2013 - Bizagi

8.1.5.2

Crear un proveedor en SAP desde Bizagi

Informacin general
En este artculo vamos a describir cmo integrar Bizagi con SAP, desde la perspectiva de tener un proceso en Bizagi que cree un nuevo dato maestro en SAP. Para este caso, se crear un proveedor. Este ejemplo y enfoque no requiere de programacin, dicha integracin es posible usando el asistente de interfaces de Bizagi. En SAP, requerimos que las funciones de la administracin de datos maestros del proveedor, estn disponibles en un servicio web. Para esto, se puede optar tanto por usar los utilitarios de SAP Netweaver para publicar servicios web, o mediante el componente PI de SAP (o anteriormente conocido como "XI"). Para ms informacin de SAP Netweaver y sus mdulos refirase a Documentacin SAP. Para ilustrar esta idea, el siguiente diagrama representa el funcionamiento y arquitectura de esta integracin:

Copyright 2013 - Bizagi

2775

Prerequisitos
Para lograr esta integracin es necesario: Tener las funciones disponibles en el sistema SAP que administren los datos maestros en SAP, y publicar dichas funciones en un servicio web (ya sea usando el componente PI de SAP o los utilitarios que presenta SAP Netweaver). Si no est familiarizado con la posibilidad de publicar funciones de SAP en servicios web, le recomendamos revisar la Ayuda Online de SAP para tener una gua sobre este procedimiento acorde a su versin de SAP y los componentes instalados.

Lo que debe hacer en Bizagi

Los pasos para esta integracin, una vez se cumplen los prerequisitos, es configurar la tarea de Servicios en el proceso que invoca los servicios web de SAP. La configuracin se realiza por medio del asistente de interfaces.

Ejemplo
El proceso en Bizagi que crea el proveedor en SAP, se describe a continuacin:

2776

Copyright 2013 - Bizagi

1. Un usuario solicita la inclusin de un proveedor ingresando el nombre y cdigo para ste. 2. Bizagi consulta en SAP si ya existe el proveedor y despliega la informacin del mismo si ese es el caso. 3. Si el proveedor no existe, entonces el usuario toda la informacin necesaria para el proveedor que normalmente se registra en SAP. 4. Cuando la solicitud es aprobada por otro usuario quien realiza esta revisin, se crea el proveedor en SAP y al usuario se le muestra la confirmacin y referencia de creacin. El modelo del proceso en Bizagi es:

En este artculo vamos a ilustrar puntualmente cmo configurar con el asistente de interfaces de Bizagi, las invocaciones para consultar y crear el proveedor en SAP. Esto significa que configuraremos dos (2) invocaciones a servicios web separados.

1. Configurando la invocacin desde Bizagi para consultar un proveedor

Para configurar la invocacin del servicio web en Bizagi Studio, vamos al sexto paso del asistente de proceso llamado Integrar y seleccionamos Definir interfaces de integracin.

Copyright 2013 - Bizagi

2777

En este punto, vamos a configurar la tarea de servicio Verify P ro v id er in SA P para que invoque la funcin que retorna si el proveedor ya existe en SAP.

Haciendo clic en la tarea Bizagi ejecutar el asistente de interfaces que lo guiar en la configuracin. Primero seleccionamos SO A como el tipo de servicio y la URL WSDL, luego clic en Go . Seleccione el mtodo correspondiente y de clic en Sig u ien te.

2778

Copyright 2013 - Bizagi

Mapeamos los parmetros de entrada que se envan desde Bizagi a SAP, arrastrando y soltando (haciendo "drag and drop") del atributo cdigo y atributo nombre hacia los parmetros que espera SAP.

Copyright 2013 - Bizagi

2779

D clic en Sig u ien te. El mapeo para los parmetros de salida permitir que la informacin del proveedor se muestre en Bizagi (si dicho proveedor existe): En esta ventaba realice el mapeo del resultado que llega a Bizagi y de clic en Sig u ien te.

2780

Copyright 2013 - Bizagi

En el ltimo paso, hacemos clic en finalizar (el manejo de error lo toma Bizagi).

Copyright 2013 - Bizagi

2781

Ahora procedemos a configurar la invocacin del segundo servicio web.

2. Configurando la invocacin desde Bizagi para crear e proveedor

Para configurar la invocacin del servicio web en Bizagi Studio, usamos el sexto paso del asistente de proceso llamado Integrar y seleccionamos Definir interfaces de integracin. Esta vez, vamos a configurar la tarea de servicio Create Ven d o r in SA P para que invoque la creacin del proveedor en SAP.

2782

Copyright 2013 - Bizagi

Seleccione SO A como el tipo de servicio, ingrese la URL del servicio web y seleccione el mtodo correspondiente. De click en Sig u ien te.

Mapeamos los parmetros de entrada que se envan desde Bizagi a SAP, arrastrando y soltando (haciendo "drag and drop") los atributos que contienen el detalle del proveedor nuevo que vamos a crear en SAP.

Copyright 2013 - Bizagi

2783

De clic en Sig u ien te. El mapeo para los parmetros de salida nos actualizar en Bizagi la respuesta de la invocacin (con el nmero de referencia del proveedor si la creacin es exitosa): En esta ventana realice el mapeo del resultado entrante a Bizagi y de clic en Sig u ien te.

2784

Copyright 2013 - Bizagi

En el ltimo paso, hacemos clic en finalizar (el manejo de error lo toma Bizagi).

Copyright 2013 - Bizagi

2785

En este punto hemos terminado la configruacin de la integracin Bizagi-SAP para el proceso de Proveedores. En la ejecucin, Bizagi crear un proveedor (datos maestros) en SAP y retornar el nmero de referencia del proveedor creado. El proveedor puede consultarse en el sistema SAP. 8.1.5.3 Integrar Bizagi con SAP invocando directamente BAPI Wrappers

Informacin general
En este artculo vamos a describir cmo integrar Bizagi con SAP, desde la perspectiva de tener un proceso en Bizagi que invoque directamente una funcin BAPI wrapper en SAP. Esto es posible desarrollando un componente en .Net que utiliza la librera "SAP.Net connector", y posteriormente registrndolo con la opcin de Librera de Componentes (component library) presente en Bizagi en la edicin Enterprise .Net. Este ejemplo ilustra especficamente la creacin de una reserva de vuelo en SAP que se realiza desde un proceso en Bizagi mediante la programacin de un componente que invoca las funciones BAPI wrappers. El componente desarrollado en. Net contiene la conexin al sistema SAP e invoca las funciones BAPI wrappers de SAP para crear los registros y persistir la informacin.

2786

Copyright 2013 - Bizagi

Por medio de este componente es posible invocar funciones de SAP en las reglas de negocio. Para ilustrar esta idea, el siguiente diagrama representa el funcionamiento y arquitectura de esta integracin:

En este artculo, vamos a ilustrar especficamente a la creacin de una reserva de vuelo en SAP, desde Bizagi con la programacin requerida. El componente desarrollado ha sido desarrollado en .NET y consiste en conectar a SAP e invocar los BAPI wrappers disponibles para crear la transaccin y guardar la informacin. Si desea ver otra posibilidad para esta integracin,usando servicios web en lugar de llamados directos funciones SAP consulte Integrar Bizagi con SAP.

Prerequisitos
Para lograr esta integracin es necesario: Tener las funciones BAPI wrappers disponibles en su sistema SAP, para poder invocarlas desde Bizagi de manera que se pueda obtener informacin y/o crear registros en SAP.

Copyright 2013 - Bizagi

2787

Descargar e instalar el "SAP.Net Conector" provisto por SAP. Este conector permite a un proyecto en .Net tener acceso al sistema SAP y acceder a los BAPI wrappers. Revise mayor informacin sobre SAP.Net Connector, en el enlace de los conectores de SAP con acceso autorizado.

Lo que se debe hacer

Los pasos para cubrir esta integracin son: 1. Buscar la funcin en SAP a invocar (y sus parmetros de importacin y esportacin) De esta manera podemos reconocer la informacin (y su estructura) para la de salida y de llegada (input and output). 2. Desarrollar un componenten que use SAP.Net connector. Con este componente invocaremos las funciones de SAP. 3. Registrar el componente en Bizagi. Una vez registrado podemos usarlo desde una regla de negocio en el proceso. 4. Crear la regla de negocio. Ahora podemos definir una regla de negocio para la actividad que ejecutar la integracin.

Ejemplo
El ejemplo de este artculo fue trabajado con el mdulo de vuelo disponible en SAP R/3, y junto con un proceso en Bizagi que llamamos "BookFlight" (Reservas de vuelo). Las funciones usadas en esta integracin que se invocan en SAP, son las BAPI wrappers: "BAPI_FLIGHT_GETLIST", que consulta y retorna una lista de vuelos disponibles de acuerdo a cierto criterio de filtro. "BAPI_FLBOOKING_CREATEFROMDATA", que crea la reserva de vuelo y retorna el nmero de reserva. "BAPI_TRANSACTION_COMMIT", que persiste la informacin (hace "commit" de la transaccin).

Para ms informacin acerca del mdulo de vuelo de SAP refirase a la documentacin de SAP: http:// help.sap.com/saphelp_nw04/helpdata/en/content.htm. En una breve descripcin, el proceso "BookFlight" en Bizagi funciona como se describe a continuacin: 1. Un usuario crea un nuevo caso para su solicitud de viaje en la cul l/ella ingresa principalmente: ciudad de salida (departure city), ciudad de destino (arrival city), y un rango de fecha de vuelo (flight date). 2. Una lista de vuelos disponibles le es presentada con todos los vuelos en SAP que cumplen las condiciones ingresadas en el paso anterior. 3. El solicitante escoge un vuelo especifico para realizar su reservacin, y enva dicha informacin junto con: el nombre completo del pasajero, la clase del vuelo deseada. 4. Cuando la solicitud es aprobada por otro usuario quien realiza esta revisin, se crea la reserva en SAP y una notificacin de correo le llega al usuario solicitante.

2788

Copyright 2013 - Bizagi

El siguiente modelo ilustra el proceso de Reservas de vuelo en Bizagi:

1. Obteniendo el detalle de las funciones a invocar en SAP

Dado que hemos identificado las funciones BAPI wrappers a invocar, consultamos el detalle de las mismas. Este paso incluye conocer los parmetros de importacin/exportacin (import/export) y tablas involucradas, as mismo como la metadata de las estructuras de SAP empleadas en las funciones. En este caso particular, vamos a ilustrar la invocacin de la funcin BAPI wrapper B A P I_F LB O O KIN G_CREA TEF RO M DA TA , para lo cual necesitamos entender la estructura que se espera en SAP para crear un registro de reserva de vuelo. Con el fin de instanciar estos objetos en nuestro proyecto .Net, obtenemos el detalle de estas funciones utilizando el Logon en SAP NetWeaver. Mediante la transaccin "se37", visualizamos la gestin de funciones de SAP.

Copyright 2013 - Bizagi

2789

En la siguiente imagen, vemos la ventana de detalle que se muestra para nuestra funcion B A P I_F LB O O KIN G_CREA TEF RO M DA TA (crear una nueva reserva) y sus parmetros de importacin.

La estructura B A P ISP O N EW en detalle para la creacin de una reserva de vuelo es:

Esta funcin nos retorna tablas tambin. Para el ejemplo, vamos a obtener la informacin de la tabla RETURN para confirmar si la reserva de vuelo fue creada e igualmente para notificar al usuario Bizagi con el nmero de referencia de la reserva creada en SAP.

2790

Copyright 2013 - Bizagi

De manera similar, revisamos el detalle de la funcin B A P I_F LIGH T_GETLIST (para obtener lista de vuelos) que se invocara tambin en SAP para obtener el listado de vuelos disponibles (en un punto anterior del proceso de Bizagi).

2. Desarrollando un componente que use SAP.Net connector.

Para este componente que accede a SAP, creamos un nuevo proyecto en Visual Studio y inclumos las libreras de "SAP.Net Connector" como referencias. Las libreras de "SAP.Net Connector" en su versin 3.0 son: sap n co .d ll y sap n co _u tils.d ll, y quedan ubicadas en la ruta escogida durante la ejecucin de instalacin del conector.

Copyright 2013 - Bizagi

2791

Para este ejemplo, hemos creado 2 clases diferentes para el acceso a SAP, como se describe a continuacin. SAPController.cs es nuestro punto de entrada para el proceso de reserva de vuelo en Bizagi ("BookFlight"). Esta clase contiene los dos mtodos GetF lig h ts() y CreateB o o kin g(), cada una para invocar la funcin de SAP que corresponde. Su cdigo es:

SA P A ccess.cs contiene la configuracin para la conexin al sistema SAP. Su cdigo es:

2792

Copyright 2013 - Bizagi

Copyright 2013 - Bizagi

2793

Ntese que el mtodo mencionado setCo n n ectio n () en la clase SAPAccess.cs tiene los datos de la conexin al sistema SAP. Asegrese de editar estos valores de acuerdo a la informacin de su instalacin SAP. Ntese tambin que el mtodo CreateF ro m Data_B o o kin g() utiliza la estructura B A P ISP O N EW y su metadata y la tabla de retorno RETURN , como la habamos consultado a travs del Netweaver de SAP en el paso anterior. Nota Tenga en cuenta que despus de invocar una funcin que crea datos en SAP, necesitamos llamar la funcin BAPI wrapper B A P I_TRA N SA CTIO N _CO M M IT para persistir la nueva informacin (hacer commit). Tambin se requiere cerrar el contexto actual (utilizando RfcSessio n M an ag er.En d Co n tex t()). En este ejemplo, se usaron valores fijos para el cliente de vuelo o "customer" (en la tabla SCUSTOM) y para la agencia de viajes o "agency" (en la tabla STRAVELAG), ya que estos valores deben existir en SAP como datos de entrada para crear la reserva de vuelo.

Descargue el proyecto completo en Visual Studio aqu. Recuerde que este proyecto no contiene las libreras para la conexin con SAP. Esas libreras (del SAP.Net Connector) deben ser adquiridas por medio de SAP y sus pginas de recursos, con credenciales autorizadas.

3. Registrando el componente en Bizagi

Una vez que nuestro proyecto en Visual Studio compile de forma que el resultado sea una dll (output type = "class library"), se deber registrar ese componente compilado en nuestro proyecto Bizagi. Para nuestro ejemplo, este output resultante es "BizagiSAP.dll" y por lo tanto, este paso se hace incluyendo el archivo B izag iSA P .d ll con la opcin de Librera de Componentes en Bizagi Studio. Los archivos .dll se incluyen con la opcin de Librera de Componentes como se muestra a continuacin:

Creamos una nueva librera de componentes y definimos informacin como por ejemplo, cmo se

2794

Copyright 2013 - Bizagi

denomina.

Adjuntamos la librera dll en esta nueva librera:

Copyright 2013 - Bizagi

2795

Asegrese de ingresar el namespace correspondiente para la librera, tal cual como se defini en el cdigo en .Net:

2796

Copyright 2013 - Bizagi

Para este ejemplo especfico, tenga en cuenta que requerimos tambin registrar las libreras del SAP.Net Connector ("sapnco.dll" y "sapnco_utils.dll"). Por lo tanto, repetimos los pasos de ingreso de nueva librera de componentes para las dll sap n co y sap n co _u tils de SAP. En resumen, para la conexin a SAP deber tener en el proyecto Bizagi 3 componentes en su librera de componentes:

4. Creando la regla de negocio

Copyright 2013 - Bizagi 2797

Ahora que hemos registrado nuestro componente desarrollado, se define una regla de negocio para la actividad que va a realizar esta integracin. Los mtodos en los componentes ya registrados en el paso anterior pueden ser llamados directamente desde nuestros procesos en Bizagi. Usaremos dos expresiones para usar el componente. Una expresin en la tarea de servicio Get av ailab le flig h ts fro m SA P (obtener vuelos disponibles de SAP) para invocar desde all el mtodo en .Net que termina invocando la funcin BAPI wrapper B A P I_F LIGH T_GETLIST. La otra expresin se configura en la tarea de servicio B o o k flig h t in SA P (reservar vuelo en SAP) para terminar invocando la funcin BAPI wrapper B A P I_F LB O O KIN G_CREA TEF RO M DA TA . La creacin de la expresin se realiza desde el paso cuatro del Asistente de Proceso: A ccio n es d e la A ctiv id ad.

Para ilustrar esto, la accin de actividad en la salida de la tarea B o o k flig h t in SA P se muestra a continuacin:

2798

Copyright 2013 - Bizagi

El mdulo expresin create b o o kin g contiene el siguiente cdigo que se utiliza para invocar el mtodo de .Net (de nuestra clase de punto de entrada SA P Co n tro ller.cs):

Copyright 2013 - Bizagi

2799

La lnea principal que contiene la invocacin es: <BookFlight.ResponseConfirmation> = BizagiSAP.SAPController.CreateBooking (airlineId,connectionId, flightYear, flightMonth, flightDay,customerId, flightClass, agencyCode, passengerName);

De manera similar, la expresin a la salida de la tarea "Get available flights from SAP", incluye la invocacin al mtodo para consultar los vuelos: responseArray = BizagiSAP.SAPController.GetFlights (<BookFlight.FlightRequest.ArrivalCity.Name>, <BookFlight.FlightRequest.DepartureCity.Name>, date1.Year, date1.Month, date1.Day, date2.Year, date2.Month, date2.Day, <BookFlight.FlightRequest.DateRange>);

Ntese que hemos incluido un manejo en Bizagi para trabajar con campos separados para la informacin de la fecha de vuelo (esto es: el da, el mes, y el ao). Esto se hizo para asegurar que la informacin en SAP de tipo fecha (DATE) se enve como la espera la funcin de SAP (es decir, en formato 'yyyy-MM-dd'). En este punto, ya hemos completado la integracin desde un proceso Bizagi usando libreras de componentes para invocar los BAPI wrappers de nuestro sistema SAP!

Ejecucin
Para ver el ejemplo de clic en Ejecutar para abrir el Portal de Trabajo:

2800

Copyright 2013 - Bizagi

Cuando se trabaja en el proceso de Reserva vuelo, la tarea Servicio ejecutar la integracin y actualizacin en Bizagi de la informacin entrante y la confirmacin de SAP:

Copyright 2013 - Bizagi

2801

8.1.6

Cmo ejecutar procedimientos almacenados desde Bizagi

Overview
En este artculo vamos a describir cmo ejecutar procedimientos almacenados en bases de datos externas, desde un proceso en Bizagi. Esta integracin es posible mediante el desarrollo de un componente el cual: administre la conexin a la base de datos externa, y exponga los mtodos para la ejecucin de los procedimientos almacenados. Este componente se registra en Bizagi a travs de la Librera de Componentes (disponible en las ediciones Enterprise), y ante esto los procesos en Bizagi tendrn la posibilidad de ejecutar estos procedimientos almacenados desde una regla de negocio. Para ilustrar lo anterior, el siguiente diagrama representa la arquitectura y consideraciones de este ejemplo:

2802

Copyright 2013 - Bizagi

Informacin adicional
Tenga en cuenta que existen otras alternativas de integracin con los procesos Bizagi y sistemas externos. En este ejemplo se utiliza la biblioteca de componentes para un corredor de integracin orientado a las bases de datos existentes. Este enfoque es comn que los escenarios de integracin que involucran sistemas de legado o cualquier otro sistema que no cuenta con un diseo de arquitectura orientada a servicios. Sin embargo, si su base de datos externa tiene un diseo de arquitectura orientada a servicios, se recomienda que cualquier integracin se centre en la invocacin de esos servicios (por ejemplo, la integracin a travs de servicios Web) en lugar de un acceso directo a la base de datos (mejores prcticas). Al elegir esta alternativa (ejecutar procedimientos almacenados directamente en una base de datos externa), debe tomar las consideraciones apropiadas para gestionar las conexiones y transacciones a la base de datos, a fin de evitar problemas de rendimiento o locks.

Lo que debe hacer en Bizagi

Los pasos para esta integracin son: 1. Desarrollar el componenten que se conecta con sistemas externos. 2. Registrar el componenten en la Librera de Componentes de Bizagi. 3. Llamar los mtodos del componente (invocacin de procedimientos almacenados) desde una regla de negocio Bizagi.

Copyright 2013 - Bizagi

2803

Ejemplo
En este ejemplo vamos a ilustrar la invocacin de 2 procedimientos almacenados (uno en una base de datos Microsoft SQL Server, y otro en una base de datos Oracle), desde dos puntos del proceso. Para este ejemplo usaremos el proceso P erso n al Lo an Req u est que tiene un subproceso llamado A p p lican t A n aly sis que trabaja de la siguiente manera: En este subproceso de Anlisis de Solicitantes, se realiza una tarea automtica de Im p o rtar P ro d u cto s P rev io s (Import Previous Products), en el cual Bizagi consultar si existe historia de productos del solicitante. En esta consulta, Bizagi cargar al proceso los productos existentes asociados al solicitante. Seguidamente, en otra tarea automtica llamada Calcu lar la cap acid ad d e p ag o (Calculate Payment Capacity), Bizagi usara la lgica existente en un sistema externo con base de datos en Oracle para obtener el clculo del monto de capacidad de pago, de acuerdo a cierta informacin del solicitante (ingresos, gastos, valor total de patrimonios, etc.). El modelo de este ejemplo ha sido extrado y simplificado del disponible en la Central de Procesos gratuitos de Bizagi:

A travs de la funcin de Librera de componentes vamos a invocar los procedimientos almacenados:

2804

Copyright 2013 - Bizagi

Los siguientes pasos de este ejemplo, se han desarrollado para la Edicin Enterprise .NET (y por lo tanto los componentes desarrollados son libreras de clases bajo el marco de la tecnologa. NET)

1. Desarrollando el componente en .NET que se conecta a las bases de datos externas

Para este ejemplo creamos una nuevo proyecto de tipo Class Lib rary utilizando Visual Studio 2008, e inclumos las referencias correspondientes para usar los drivers de conexin a las base de datos externas. La conexin a la base de datos Oracle de este ejemplo se realiz usando Oracle Data Provider para .Net (ODP.net), y por lo tanto inclumos el assembly O racle.DataA ccess.

Copyright 2013 - Bizagi

2805

Nota El assembly para este ejemplo se encuentra instalado una vez se instale el componente cliente Oracle Provider para .Net dado que la conexin la realizamos de esta manera (ODP.Net). Sin embago, tambin se puede optar por usarse otro tipo de conexin a la base de datos Oracle (p.e ODBC, OLE DB).

Nuestro proyecto se llama SPProvider y consiste de 2 clases principales: Co n tro ller.cs y Im p lem en tatio n P ro v id er.cs. Im p lem en tatio n P ro v id er.cs administra la conexin y los mtodos para ejecutar los procedimientos almacenados. Su cdigo es:

2806

Copyright 2013 - Bizagi

using using using using using using using

System; System.Collections.Generic; System.Linq; System.Text; System.Data.SqlClient; System.Data; System.Configuration;

namespace SPProvider { internal class ImplementationProvider { protected string _connectionString; protected SqlConnection conn = null; protected Oracle.DataAccess.Client.OracleConnection connO = null; protected System.Collections.ArrayList parameters = new System.Collections.ArrayList();

internal string ConnectionString { set { _connectionString = value; } get { return _connectionString; } } internal ImplementationProvider(string sKey, string engine) { //ConnectionString = ConfigurationManager.AppSettings[sKey] .ToString(); if (sKey.Equals("SYS2") && engine.Equals("ORACLE")) { ConnectionString = "Data Source = (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = myHost)(PORT = myPort)))" + "(CONNECT_DATA = (SERVER = DEDICATED)(SERVICE_NAME = myOracleServiceName))); User Id = myUserDb; Password = myPassword;"; connO = new Oracle.DataAccess.Client.OracleConnection (this.ConnectionString); } else { ConnectionString = "Persist Security Info=True;Current Language=us_english;" + "Data Source=myDatabaseInstance;Initial Catalog=myDatabase;User ID=myLogin;Password=myPassword"; conn = new SqlConnection(this.ConnectionString); } }

Copyright 2013 - Bizagi

2807

internal void AddParameter_SQLServer(string sParamName, string sParamValue, ParameterDirection dir) { SqlParameter param; // Requiered SP development team change: pass NULL values not empty strings if (sParamValue == "") param = new SqlParameter(sParamName, DBNull.Value); else param = new SqlParameter(sParamName, sParamValue); parameters.Add(param); param.Direction = dir; } internal void AddParameter_Oracle(string sParamName, int sParamValue, ParameterDirection dir) { Oracle.DataAccess.Client.OracleParameter param; param = new Oracle.DataAccess.Client.OracleParameter (sParamName, sParamValue); parameters.Add(param); param.Direction = dir; }

internal DataSet RunStoredProcedureSQLServer(string storeprocedure, string tableName) { SqlCommand comm = new SqlCommand(storeprocedure, conn); for (int i = 0; i < parameters.Count; i++) { comm.Parameters.Add((SqlParameter)parameters[i]); } comm.CommandType = CommandType.StoredProcedure; SqlDataAdapter da = new SqlDataAdapter(comm); DataSet ds = new DataSet(); da.Fill(ds); if (ds.Tables.Count > 0) ds.Tables[0].TableName = tableName; parameters = new System.Collections.ArrayList(); return ds; } internal int RunStoredProcedureOracle(string storeprocedure, string tableName) {

2808

Copyright 2013 - Bizagi

int resp = 0;

Oracle.DataAccess.Client.OracleCommand commO = new Oracle.DataAccess.Client.OracleCommand(storeprocedure, connO); for (int i = 0; i < parameters.Count; i++) { commO.Parameters.Add ((Oracle.DataAccess.Client.OracleParameter)parameters[i]); } commO.CommandType = CommandType.StoredProcedure; try { commO.Connection.Open(); resp = commO.ExecuteNonQuery(); Oracle.DataAccess.Client.OracleParameter tempParam = commO.Parameters[3]; resp = Convert.ToInt32(tempParam.Value); } finally { commO.Connection.Close(); } parameters = new System.Collections.ArrayList(); return resp; } } }

Los 2 procedimientos almacenados para este ejemplo tienen los siguientes parmetros de entrada y salida: El procedimiento almacenado en SQL Server: CREATE PROCEDURE sp_GetCustomerProducts @AppId INTEGER AS select * from Products p ... El procedimiento almacenado en Oracle: CREATE OR REPLACE PROCEDURE SP_CALCULATE_PAYMENTCAPACITY (Incomes IN NUMBER, Expenses IN NUMBER, Equity IN OUT NUMBER, Capacity OUT NUMBER) AS ...

La clase Co n tro ller.cs es nuestro punto de entrada, y provee los mtodos para su invocacin desde una regla de negocio del proceso en Bizagi. Su cdigo es:

Copyright 2013 - Bizagi

2809

using using using using using using

System; System.Collections.Generic; System.Linq; System.Text; System.Data; System.Collections;

namespace SPProvider { public class Controller { public static DataSet GetProductsList(int appId, string storedPr) { ImplementationProvider myProvider; DataSet ds = null; try { //instance provider myProvider = new ImplementationProvider("SYS1", "SQLSERVER"); myProvider.AddParameter_SQLServer("AppId", appId.ToString (), ParameterDirection.Input); ds = myProvider.RunStoredProcedureSQLServer(storedPr, "NA"); return ds; } catch (Exception ex) { throw new Exception(ex.Source + ":" + ex.Message); } } public static int CalculateCapacity(Hashtable inputs, Hashtable inouts, Hashtable outputs, string storedPr) { ImplementationProvider myProvider; int resp = 0; try { //instance provider myProvider = new ImplementationProvider("SYS2", "ORACLE"); foreach (string iname in inputs.Keys) { myProvider.AddParameter_Oracle(iname, Convert.ToInt32 (inputs[iname]), ParameterDirection.Input); } foreach (string ioname in inouts.Keys) { myProvider.AddParameter_Oracle(ioname, Convert.ToInt32

2810

Copyright 2013 - Bizagi

(inouts[ioname]), ParameterDirection.InputOutput); } foreach (string oname in outputs.Keys) { myProvider.AddParameter_Oracle(oname, Convert.ToInt32 (outputs[oname]), ParameterDirection.Output); } resp = myProvider.RunStoredProcedureOracle(storedPr, "NA"); return resp; } catch (Exception ex) { throw new Exception(ex.Source + ":" + ex.Message); } } } } Para la simplificacin de este ejemplo, el cdigo que se ensea utiliza los datos de la conexin (el string de the conexin) quemadas en la clase de implementacin del proveedor. Sin embargo, para la implementacin de esta solucin, se recomienda que esta informacin sea leda y administrada en un archivo de configuracin con las medidas de seguridad pertinentes. Ntese que el namespace de nuestro Co n tro ller.cs se llama SP P ro v id er. Usaremos este nombre ms adelante para registrar el componente en Bizagi. Para construir este proyecto asegrese que el output soporte 32 bit support porque referencia el assembly O racle.DataA ccess.

Finalmente, hacemos build al proyecto y producimos nuestra salida que es el assmebly SP P ro v id er.d ll. Puede descargar aqu el proyecto completo en Visual Studio 2008 (recuerde que para la conexin que ya est configurada en este ejemplo se requiere la instalacin del Oracle Data Provider para .Net).

2. Registrando el componente en la Librera de Componentes de Bizagi

El siguiente paso es ir a Bizagi Studio y registrar el componente desarrollado SP P ro v id er, agregndolo a travs de la funcionalidad de la Libreria de Componentes:

Copyright 2013 - Bizagi

2811

Despus de haber especificado un nombre (name), nombre para mostrar (display name), y descripcin (description), para identificar nuestro componente, registramos nuestro assembly (cargando el archivo dll). Asegrese de especificar el N am esp ace que corresponde al que definimos en el proyecto de Visual Studio, como se seal en nuestro paso anterior (el Namespace de nuestro ejemplo es SP P ro v id er).

Al final, nuestra Librera de Componentes registradas tendr:

2812

Copyright 2013 - Bizagi

3. Llamando los mtodos de componentes desde una regla de negocio

Los mtodos del componente que registramos ya pueden usarse desde los procesos desde reglas de negocio Bizagi. En este ejemplo, se crean 2 reglas para utilizar los mtodos del componente, una regla en cada punto de integracin --tarea automtica-- de nuestro proceso de "Anlisis de Solicitantes". La primera regla se llama g etP rev io u sP ro d u cts, y se define en la tarea automtica Im p o rtar p ro d u cto s p rev io s (Import Previous Products) en la accin de actividad al Salir de la actividad. La segunda regla se llama calcu lateP ay m en tCap acity, y se define en la tarea automtica Calcu lar cap acid ad d e p ag o (Calculate Payment Capacity) igualmente al Salir de la actividad. La creacin de estas reglas se realiza en la segunda opcin del paso 4 del Asistente de Proceso llamado A ccio n es d e la A ctiv id ad .

Copyright 2013 - Bizagi

2813

Para incluir la lnea que invoca el mtodo de nuestro componente, incluimos un mdulo de expresin en la regla y se especifica de la manera Namespace.Class.Method(); Finalmente, nuestra regla g etP rev io u sP ro d u cts se define as:

2814

Copyright 2013 - Bizagi

El mdulo de expresin contiene el siguiente cdigo: var ApplicantId = <ApplicantsAnalysis.Applicant.Identification>; var MyResult = SPProvider.Controller.GetProductsList(ApplicantId, "sp_GetCustomerProducts"); for(var i = 0; i < MyResult.Tables[0].Rows.Count; i++) { var tempRow = MyResult.Tables[0].Rows[i]; var newrecord = Me.addRelation ("ApplicantsAnalysis.PreviousProducts"); newrecord.setXPath("Name", tempRow["Product"]); newrecord.setXPath("Observations", tempRow["Observations"]); } Ntese que la invocacin de este mtodo de la ejecucin del procedimiento almacenado en SQL Server retorna un DataSet. Por lo tanto, tomamos ese DataSet de resultado en la expresin y creamos los registros de productos en nuestra coleccin. Los productos sern mostrados automticamente en la siguiente forma A p p lican t's P ro d u cts en una tabla. Finalmente, nuestra regla calcu lateP ay m en tCap acity se define as:

Copyright 2013 - Bizagi

2815

El mdulo de expresin contiene el siguiente cdigo: var inputsH = new Hashtable(); inputsH.Add("Incomes", <ApplicantsAnalysis.Applicant.AnnualIncome>); inputsH.Add("Expenses", <ApplicantsAnalysis.Applicant.AnnualExpenses>); var inoutsH = new Hashtable(); inoutsH.Add("Equity", <ApplicantsAnalysis.Applicant.EquititesTotal>); var outputsH = new Hashtable(); outputsH.Add("Capacity", 0); var v_resp = SPProvider.Controller.CalculateCapacity( inputsH, inoutsH, outputsH, "SP_CALCULATE_PAYMENTCAPACITY"); <ApplicantsAnalysis.PaymentCapacity> = v_resp; Ntese que la invocacin de este mtodo del procedimiento almacenado en Oracle recibe 3 parmetros de tipo hashtable. Cada hashtable es usado para ingresar los mtiples parmetros del procedimiento almacenado de acuerdo al tipo de parmetro "input", "output" o "inputoutput" (entrada, salida o ambos). Dado que el mismo mtodo retorna un valor calculado, slo necesitamos asignar la respuesta a nuestro atributo P ay m en tCap acity (capacidad de pago) del modelo de datos del proceso. En este punto, la integracin a travs de un componente se ha realizado para que nuestro proceso en Bizagi ejecute los procedimientos almacenados en los sistemas externos!

2816

Copyright 2013 - Bizagi

Ejecucin
Para ver el ejemplo de clic en Ejecutar para abrir el Portal de Trabajo:

Al oprimir Siguiente en la actividad In clu d e In itial In fo rm atio n , Bizagi ejecutar los procedimientos almacenados y actualizar la informacin de respuesta.

Copyright 2013 - Bizagi

2817

8.2

Cmo incluir documentos en cualquier momento en Bizagi Informacin general

En muchos procesos, los documentos anexos conforman una parte principal de la informacin de un caso (tanto para trabajar en l, como para tomar decisiones en el caso). En algunos de estos escenarios de negocio, incluso no es posible preveer cuntos documentos de un caso sern adjuntos, ni cundo estarn disponibles para ello. En este artculo, ilustraremos cmo incluir un diseo en los procesos Bizagi para presentar la administracin y disponibilidad de documentos de un caso.

Dentro de este enfoque para el manejo y administracin de los documentos de un caso, los usuarios finales podrn:

2818

Copyright 2013 - Bizagi

Tener la posibilidad de adjuntar nuevos documentos en cualquier momento durante el proceso. Esto es contemplado por el diseo mismo del modelo de proceso, en donde se incluye un evento intermedio BPMN. Este evento estar disponible siempre para que sea tomado por cualquier usuario final. Ver todos los documentos de un caso en cualquier actividad del proceso. Esto se realiza en la definicin de formas, incluyendo la coleccin de documentos en una pestaa separada. Si usted desea que Bizagi genere automticamente los archivos de documentos (por ejemplo, PDF) de informacin de negocio contenida en el caso, consulte Plantillas de Documentos.

Lo que debe hacer en Bizagi

El diseo presentado en este artculo es llevado a cabo con 3 pasos sencillos en los cuales no se involucran conocimientos avanzados ni tcnicos de Bizagi. Los 3 pasos descritos son guiados por asistentes grficos en Bizagi, lo cual elimina la necesidad de programacin! Para incluir la administracin de documentos para que puedan ser subidos a Bizagi en cualquier momento, siga estos pasos: 1. Incluir un Evento Intermedio en el proceso. 2. Crear una entidad para repositorio de documentos. 3. Definir la interfaz de usuario para el evento y las actividades.

Ejemplo
En este artculo usaremos como ejemplo el proceso de " Su b scrip ci n d e P lizas d e A u to m v il (Vehicle Insurance Policy Underwriting)", disponible en la plantilla del proceso "Subscripcin de Plizas (Policy Underwriting)", el cual es descargable desde la Central de Procesos de Bizagi (Process Central).

Copyright 2013 - Bizagi

2819

1. Incluyendo un Evento intermedio

Primero, editaremos el model del proceso para incluir un Evento Intermedio que estar disponible en todo momento de la vida del proceso. El evento se llamar In clu d e case d o cu m en t, y ser una opcin para el usuario final para cargar un documento nuevo. Para editar el modelo vamos al paso uno del Asistente de Procesos y seleccionamos Ed itar p ro ceso .

2820

Copyright 2013 - Bizagi

Incluya un nuevo evento intermedio que parta desde la compuerta paralela "Parallel Gateway 1 (Compuerta Paralela 1)".

Copyright 2013 - Bizagi

2821

Nombramos el Evento y usamos un flujo de secuencia para indicar que estar disponible tan pronto el evento salga de s mismo. Esto se hace para que este evento est disponible de nuevo, cada vez que el usuario final que trabaja en que haga clic en Sig u ien te.

2822

Copyright 2013 - Bizagi

2. Creando la entidad para almacenar los documentos del caso en el modelo de datos
Para crear la entidad que almacenar los documentos del caso, vaya al Paso 2 del Asistente de proceso, M o d elar Dato s.

Copyright 2013 - Bizagi

2823

A continuacin, incluya una nueva entidad maestra arrastrando el cono M aster (ubicado en la esquina superior izquierda) hacia el diagrama. Nombre la entidad como Do cu m en ts , y edite su lista de atributos seleccionado Ed it attrib u tes list:

2824

Copyright 2013 - Bizagi

Se crean 4 atributos en la entidad: Un atributo de tipo Archivo (File) llamado Do cu m en t, para almacenar el archivo adjunto. Tenga en cuenta que un atributo de tipo Archivo en Bizagi puede almacenar 1 o ms archivos por defecto. Un atributo de tipo cadena (String) llamado Descrip tio n , para que el usuario final pueda incluir observaciones relacionadas al archivo que se adjunta. Debe tener una longitud de 200 caracteres. Un atributo de tipo fecha (Datetime) llamado A ttach ed Date, para que ste registre automticamente la fecha en la cual se anexa el documento del caso. Un atributo de tipo WFUser llamado A ttach ed B y: para guardar el usuario final que hace la carga.

Copyright 2013 - Bizagi

2825

Ahora se debe definir que en el proceso un caso pueda tener una coleccin de documentos (1 o ms registros con los atributos descritos anteriormente). Para ello, en nuestro modelo de datos creamos una relacin entre: la entidad de proceso (que es "InsurancePolicyRequest" en el proceso "Vehicle Insurance Policy Underwriting"), y la entidad que llamamos Do cu m en ts. Seleccione la opcin de Relaci n en la esquina superior izquierda:

2826

Copyright 2013 - Bizagi

Especifique que la relacin sea de tipo coleccin ("uno - muchos"):

Copyright 2013 - Bizagi

2827

De clic en F in alizar. Finalmente en el modelo de datos, se visualizar que la entidad de proceso contiene una coleccin de documentos. En el diagrama, se ver de la siguiente manera:

2828

Copyright 2013 - Bizagi

3. Definiendo las formas de la actividad y el evento

En este paso haremos lo siguiente: El diseo de la interfaz de usuario para el evento intermedio llamado In clu d e case d o cu m en t. La creacin de esta forma implica tambin la creacin de una regla de negocio que establece la fecha y el responsable del documento adjunto. Modificar las formas existentes para las actividades en las que desee que se muestren los documentos cargados. Vamos a ilustrar cmo hacerlo desde las opciones correspondientes que permitan la reutilizacin de las formas (ya que vamos a utilizar uno de ellos en ms de 1 punto en el proceso). En nuestro ejemplo, la adicin y edicin de documentos se realiza directamente en la forma del Evento Intermedio. En el resto de las actividades, el conjunto de documentos cargados se ver como de slo lectura.

Creando formas reusables Para definir las formas reutilizables, lo primero es definir una forma para ver slo los documentos (como de slo lectura). Esto se hace estrictamente por la Entidad de Proceso.

Copyright 2013 - Bizagi

2829

Vaya a la vista de Mdulos y ubique la Entidad de Proceso P liza d e Seg u ro y utilice la opcin N u ev a fo rm a del men al hacer clic derecho.

En la nueva forma, arrastre y suelte la coleccin de Documentos que se muestra automticamente como una tabla.

2830

Copyright 2013 - Bizagi

Haga clic en la tabla y luego en su opcin Editar columnas. De esta manera, defina qu atributos se muestran en la tabla. Incluya todos los atributos: Documento, Descripcin, fecha adjunta, y Adjuntado por.

Copyright 2013 - Bizagi

2831

Haga clic en O k. De vuelta en la forma que tiene la tabla, haga clic en la tabla y asegurarse de que sus propiedades avanzadas no permiten aadir, editar o eliminar Documentos:

2832

Copyright 2013 - Bizagi

Por ltimo, asigne un nombre de visualizacin haciendo clic en la opcin P ro p ied ad es. Note que se nombra M y Do cu m en tsRead O n ly F o rm ya que se har referencia ms adelante.

Copyright 2013 - Bizagi

2833

Haga clic en Gu ard ar y cierre la forma. Ahora que hemos creado esta forma, vamos a crear la forma para el evento intermedio y modificaremos las formas para otras actividades del Proceso. Para ello, vaya la vista de Asistente en el Paso 3, Defin ir fo rm as.

2834

Copyright 2013 - Bizagi

Haga clic en el Evento Intermedio In clu d e case n o tes para definir la forma que permitir nuevos documentos. En esta forma, arrastre y suelte la coleccin de Documentos, que se muestra automticamente como una tabla.

Copyright 2013 - Bizagi

2835

Haga clic en la opcin Ed itar co lu m n as (haciendo clic primero en la tabla de Documentos) para definir los atributos que se mostrarn. Incluya todos los atributos: Documento, Descripcin, fecha adjunta, y Adjuntado por.

2836

Copyright 2013 - Bizagi

Haga clic en O k. De vuelta en la forma que tiene la tabla, haga clic en la tabla y asegurarse de que permita agregar y editar documentos (en su configuracin de Propiedades). Al configurar las opciones de A d icio n ar, seleccione la opcin N u ev a F o rm a de la lista desplegable para asignar una forma para adicionar.

Copyright 2013 - Bizagi

2837

Arrastre y suelte los atributos de los Documentos de la Entidad muestra en el panel izquierdo. Incluya todos los atributos Documentos: Documento, Descripcin, fecha adjunta, y Adjuntado por.

2838

Copyright 2013 - Bizagi

Asegrese de que slo Documento y Descripcin se establecen como campos ed itab les y req u erid o s. Fecha adjunta, y Adjuntado por sern no editables. D un nombre de visual para la forma haciendo clic en la opcin P ro p ied ad es.

Copyright 2013 - Bizagi

2839

Haga clic en Gu ard ar y cierre la forma. De vuelta en la forma que tiene la tabla, notar que la forma de adicionar se ha establecido. Elija esta misma forma para la propiedad de edicin (de la lista desplegable).

2840

Copyright 2013 - Bizagi

De manera, busque la propiedad de Valid aci n de las opciones de Adicionar para crear y asignar una regla de negocio, que fijar la fecha actual y el usuario responsable de un archivo cargado. Haga clic en el icono de Ex para crear una regla de negocio. Asegrese de darle un nombre, nombre para mostrar y una descripcin significativa. Para esta regla de negocio, agregue un mdulo de expresin mediante las opciones del botn derecho y seleccionando A d icio n ar ex p resi n .

Copyright 2013 - Bizagi

2841

En la expresin, se establece el atributo A ttach ed B y para el usuario actual. Para ello, utilice la funcin User Id o f cu rren t u ser de la categora Cu rren t u ser in fo rm atio n :

A continuacin, de el valor a A ttach ed Date con la fecha actual del sistema.

2842

Copyright 2013 - Bizagi

Para ello, utilice la funcin de To d ay de la categora F ech a y H o ra:

La expresin final debe ser como se muestra:

Copyright 2013 - Bizagi

2843

Haga clic en OK y asigne esta misma expresin para la propiedad expresin de validacin de las opciones de Edicin: Para ello, haga clic en el botn de Ex y luego en Can celar.

Seleccione la expresin creada anteriormente y haga clic en A cep tar.

2844

Copyright 2013 - Bizagi

Guarde los cambios la forma y cierre. En este punto, hemos definido las formas de entrada de los documentos. Podemos proceder ahora a incluir en el resto de las formas para mostrar los documentos como de slo lectura. Para esto, se ilustrar cmo modificar una de sus formas pero esto se puede hacer para cada una de ellas (repitiendo el mismo procedimiento que se muestra a continuacin). En el paso actual para definir las formas, localice los componentes la actividad Reg ister F eatu res an d Select P ro d u ct y haga clic en ella para modificar su forma actual.

Copyright 2013 - Bizagi

2845

En la forma abierta, agregue una pestaa y nmbrela Documentos.

2846

Copyright 2013 - Bizagi

En el panel izquierdo, busque las formas reutilizables de Insurance. Ahora todo lo que tiene que hacer es arrastrar y soltar el formulario M y Do cu m en tsRead O n ly F o rm en esta nueva pestaa:

Por ltimo, haga clic en Gu ard ar y cierre. Como se mencion anteriormente, incluir esta forma reutilizable se puede hacer para cualquier otra actividad en el proceso. En este punto estamos preparados para nuestra gestin de documentos en el proceso!

Ejecucin
Para ver el ejemplo de clic en Ejecutar para abrir el Portal de Trabajo:

Copyright 2013 - Bizagi

2847

Cuando se trabaja en el Portal de Trabajo, en cualquier punto del proceso, cualquier usuario final ser capaz de cargar un nuevo documento, activando el evento In clu d e case d o cu m en ts. Una vez que se carga un documento y haga clic en Sig u ien te. Otros usuarios finales que trabajen en otras las actividades podrn ver el documento, la descripcin, la fecha adjunta, y quien adjunt el documento.

2848

Copyright 2013 - Bizagi

Copyright 2013 - Bizagi

2849

Parte IX
FAQ

FAQ
Bizagi Go presenta un nuevo concepto de Plantillas Documentos, qu ha sucedido con Las Cartas Bizagi? de

Plantillas de documentos es una funcionalidad que le permite definir y generar fcilmente documentos en formato Word o PDF con informacin del Proceso. Esta nueva funcionalidad ha evolucionado del concepto de Cartas en versiones anteriores de Bizagi, 9.1.x (las cuales han sido ahora deprecadas). Plantillas de documentos es una solucin ms poderosa, amigable, y rpida, para generar contratos, cartas, memorndos, certificaciones, comunicaciones por escrito, y cualquier entregable o documento impreso en general. Ms informacin sobre Plantillas de Documentos. Si usted requiere que stos documentos sean editados a lo largo del Proceso (lo que antes se conoca como Cartas editables), entonces puede optar por la siguiente opcin: Definir como editables, aquellos controles que contengan informacin la cul est sujeta a revisiones y cambios. Estos controles editables se ubican en la misma forma en la que es posible generar el documento. De esta manera, si se requiere actualizar alguna informacin, entonces el usuario podr generar el documento nuevamente.

Copyright 2013 - Bizagi

2851