Sunteți pe pagina 1din 2758

Bizagi BPM Suite

Gua de Usuario

Tabla de Contenido
13

Parte I Bienvenido a Bizagi BPM Suite V10.5


Introduccin

................................................................................................................................... 14

Conceptos de Bizagi BPM Suite


................................................................................................................................... 15
Productos relacionados

................................................................................................................................... 19

Entrenamiento y soporte

................................................................................................................................... 22

Arquitectura

................................................................................................................................... 23

Central de Procesos

................................................................................................................................... 33

Instalacin de ..........................................................................................................................................................
servicios web para la Central de Procesos
38

47

Parte II Bizagi Studio

Bizagi Studio - requerimientos


...................................................................................................................................
de sistema
48
Base de datos ..........................................................................................................................................................
- requisitos
54
SQL Server.........................................................................................................................................................
- requisitos
54
Configuracin avanzada
.........................................................................................................................................
de usuarios SQL Server
64
Oracle - requisitos
......................................................................................................................................................... 72
Servidor BPM -..........................................................................................................................................................
requisitos
79
Configuracin
.........................................................................................................................................................
del IIS
80
Plataforma
.........................................................................................................................................................
JEE
104

Bizagi Studio - instalacin ................................................................................................................................... 104


Instalacin y configuracin
..........................................................................................................................................................
de inicio rpido
105
Instalacin de..........................................................................................................................................................
plataforma JEE
115

Proyectos Bizagi

................................................................................................................................... 116

Crear un nuevo
..........................................................................................................................................................
proyecto
116
Crear un .........................................................................................................................................................
proyecto utilizando Oracle
121
Crear un .........................................................................................................................................................
proyecto en la plataforma JEE
129
Configuracin
..........................................................................................................................................................
de trabajo colaborativo
139
Abrir un proyecto
.......................................................................................................................................................... 146
Manejo de sus
..........................................................................................................................................................
proyectos
150
Actualizacin
.........................................................................................................................................................
del proyecto
152

Interfaz de Bizagi Studio

................................................................................................................................... 160

Asistente de Procesos
.......................................................................................................................................................... 169
Vista del asistente
.......................................................................................................................................................... 171
Vista de mdulos
.......................................................................................................................................................... 172
Procesos.........................................................................................................................................................
en Vista de Mdulos
174
Entidades
.........................................................................................................................................................
en Vista de Modulos
177
Ajustes avanzados
.......................................................................................................................................................... 181
Definiendo
.........................................................................................................................................................
la estructura del proyecto en su compaa
181
Configuracin
.........................................................................................................................................................
de entorno
185
Configuracin
.........................................................................................................................................................
de negocio
192
Configuracin
.........................................................................................................................................................
de Traces
198
Traces para las .........................................................................................................................................
interfaces
204
Configuracin
.........................................................................................................................................................
del Servidor Web
210

Mi primer proceso

................................................................................................................................... 217

Copyright 2014 - Bizagi

Modelamiento de Proceso ................................................................................................................................... 217


Crear un proceso
..........................................................................................................................................................
con Bizagi Studio
219
Editar un proceso
.......................................................................................................................................................... 224
Importar un proceso
.......................................................................................................................................................... 230
Modelado para
..........................................................................................................................................................
ejecucin
233
Propiedades
.........................................................................................................................................................
de las figuras
241
Propiedades
.........................................................................................................................................................
de los Procesos
242
Propiedades
.........................................................................................................................................................
de las Tareas
243
Propiedades
.........................................................................................................................................................
de las Compuertas
247
Propiedades
.........................................................................................................................................................
del Evento de Inicio
249
Propiedades
.........................................................................................................................................................
del Evento Intermedio
250
Propiedades
.........................................................................................................................................................
del Evento de Fin
254
Propiedades
.........................................................................................................................................................
de los Carrilles
257
Propiedades
.........................................................................................................................................................
de los Conectores
259
Subprocesos
......................................................................................................................................................... 260
Subprocesos Embebidos
......................................................................................................................................... 264
Subprocesos Reusables
......................................................................................................................................... 270
Manejando entidades
...................................................................................................................................
de sub-procesos
275
Entendiendo los
.........................................................................................................................................
Subprocesos mltiples
279
Conceptos del...................................................................................................................................
mltiple Subproceso
282
Configuracin...................................................................................................................................
bsica para los Subprocesos mltiples
286
Acceso de la informacin del Proceso Padre desde el contexto
................................................................................................................................... 294
del Subproceso
Configuracin...................................................................................................................................
avanzada para los Subprocesos mltiples
295
Configuracin...................................................................................................................................
avanzada utilizando agrupar por
296
Configuracin...................................................................................................................................
avanzada utilizando creacin secuencial
307
Entendiendo Subprocesos
.........................................................................................................................................
transaccionales
312
Configuracin...................................................................................................................................
del Subproceso transaccional
317
Entendiendo el.........................................................................................................................................
proceso Ad Hoc
326
Configurar un...................................................................................................................................
subproceso Ad Hoc
327
BPMN Colaborativo
.......................................................................................................................................................... 329
Ejemplo de
.........................................................................................................................................................
seal
336
Duracin de Tareas
..........................................................................................................................................................
y procesos
338
Duracin.........................................................................................................................................................
dinmica
344

Modelo de datos

................................................................................................................................... 344

Crear el modelo
..........................................................................................................................................................
de datos
345
Opciones.........................................................................................................................................................
del modelo de datos
351
Tipos de entidades
.......................................................................................................................................................... 353
Tipos de atributos
.......................................................................................................................................................... 355
Informacin
.........................................................................................................................................................
del atributo tipo archivo
358
Tipos de relaciones
.......................................................................................................................................................... 362
Administracin
..........................................................................................................................................................
de las entidades
367
Incluir datos
.........................................................................................................................................................
en entidades paramtricas
367
Entidades
.........................................................................................................................................................
padre e hijo
372
Donde administrar
.........................................................................................................................................................
las entidades paramtricas
377
Entidad de proceso
.......................................................................................................................................................... 382
Contexto......................................................................................................................................................... 384
Conexiones con
..........................................................................................................................................................
fuentes de datos externas
386
Replicacin
.........................................................................................................................................................
de datos
387
Utilizar el asistente
.........................................................................................................................................
de Replicacin
391
Utilizar la configuracin
.........................................................................................................................................
avanzada de Replicacin
401
Personalizando
...................................................................................................................................
la Replicacin
419
Verificar la Replicacin
......................................................................................................................................... 456
Opciones adicionales
.........................................................................................................................................
en la configuracin de Replicacin
462

Copyright 2014 - Bizagi

Virtualizacin
.........................................................................................................................................................
de datos
470
Utilizar el asistente
.........................................................................................................................................
de Virtualizacin
475
Utilizar la configuracin
.........................................................................................................................................
avanzada de Virtualizacin
485
Personalizar la...................................................................................................................................
Virtualizacin
501
Verificar la Virtualizacin
......................................................................................................................................... 542
Opciones adicionales
.........................................................................................................................................
para la configuracin de Virtualizacin
545
Mejores prcticas
.........................................................................................................................................................
para la integracin de datos
556
Tipos de .........................................................................................................................................................
datos soportados
561
Atributos Temporales
.......................................................................................................................................................... 564
Scopes
.......................................................................................................................................................... 571
Llaves de negocio
.......................................................................................................................................................... 572

Creacin de interfaces de usuario


................................................................................................................................... 573
Creando mi primera
..........................................................................................................................................................
forma
574
Componentes..........................................................................................................................................................
de la forma
583
Ribbon ......................................................................................................................................................... 584
Panel Izquierdo
......................................................................................................................................................... 585
Contenedores:.........................................................................................................................................
Grupos, Pestaas y Paneles
586
Layouts
......................................................................................................................................... 592
rea de Trabajo
......................................................................................................................................................... 594
Propiedades
.........................................................................................................................................................
de las Formas
596
Controles
.......................................................................................................................................................... 597
Asociacin
......................................................................................................................................................... 601
Botn ......................................................................................................................................................... 608
Lista desplegable
.........................................................................................................................................................
en Cascada
615
Combo ......................................................................................................................................................... 620
Fecha ......................................................................................................................................................... 624
Archivos ......................................................................................................................................................... 630
Archivos .........................................................................................................................................................
ECM
637
Impresin
.........................................................................................................................................................
de archivos
639
Vnculo a.........................................................................................................................................................
Forma
644
Geolocalizacin
......................................................................................................................................................... 648
Tabla agrupada
......................................................................................................................................................... 652
Oculto ......................................................................................................................................................... 663
Imagen ......................................................................................................................................................... 663
Etiqueta ......................................................................................................................................................... 670
Vnculo ......................................................................................................................................................... 672
Lista
......................................................................................................................................................... 676
Moneda ......................................................................................................................................................... 682
Nmero ......................................................................................................................................................... 686
Radio ......................................................................................................................................................... 688
Vista por.........................................................................................................................................................
registro
695
Campo de
.........................................................................................................................................................
Bsqueda
703
Forma de Bsqueda
......................................................................................................................................... 711
Forma de Adicin
.........................................................................................................................................
de Registros
715
Sugerencia
......................................................................................................................................................... 718
Tabla
......................................................................................................................................................... 727
Editar Columnas
......................................................................................................................................... 732
Totalizadores ......................................................................................................................................... 735
Agregar Registros
......................................................................................................................................... 739
Editar Registros
......................................................................................................................................... 744
Detalle de Registros
......................................................................................................................................... 749
Exportar tablas.........................................................................................................................................
a Excel o PDF
752
Cambiar el formato
.........................................................................................................................................
de las columnas
756
Cuadro de
.........................................................................................................................................................
Texto
760

Copyright 2014 - Bizagi

Si/No
......................................................................................................................................................... 765
Propiedades
.........................................................................................................................................................
de los Controles
768
Valor por Defecto
......................................................................................................................................... 772
Propiedad de Filtro
......................................................................................................................................... 773
Filtrar Tablas ......................................................................................................................................... 778
Valores Mximo
.........................................................................................................................................
y Mnimo
783
Habilitar enviar.........................................................................................................................................
como adjunto
792
Validaciones de
.........................................................................................................................................
Tabla
793
Botn de Validaciones
...................................................................................................................................
de Tabla
794
Expresiones de
...................................................................................................................................
Validacin en Adicin, Edicin y Borrado
802
Cambiar el Tipo
..........................................................................................................................................................
de Control
805
Personalizar la
..........................................................................................................................................................
interfaz de usuario (Widgets)
807
Personalizar comportamientos
..........................................................................................................................................................
del Control
818
Ejecutar Acciones
.........................................................................................................................................................
y Validaciones
819
Componentes .........................................................................................................................................
de las acciones
821
Acciones bsicas
................................................................................................................................... 828
Otras acciones................................................................................................................................... 842
Ejecutar acciones
...................................................................................................................................
sobre colecciones
870
Componentes .........................................................................................................................................
de las Validaciones
884
Validaciones bsicas
................................................................................................................................... 888
Validaciones sobre
...................................................................................................................................
colecciones
891
Condiciones compuestas
.........................................................................................................................................
en Acciones y Validaciones
893
Botones de forma
.......................................................................................................................................................... 901
Contexto en Formas
.......................................................................................................................................................... 913
Donde crear formas
.......................................................................................................................................................... 917
Formas de
.........................................................................................................................................................
Entidad
923
Formas Administrables
.........................................................................................................................................................
para Entidades Paramtricas
931
Formas de
.........................................................................................................................................................
consulta
939
Consultas de Aplicacin
......................................................................................................................................... 946
Campos Internos
................................................................................................................................... 954
Consultas de Entidad
......................................................................................................................................... 961
Formas globales
.........................................................................................................................................................
y de resumen
965
Guardar una ..........................................................................................................................................................
Forma
971
Usar la opcin
..........................................................................................................................................................
Copiar Desde
979
Seguridad de..........................................................................................................................................................
Formas: check-in / check-out
981

Definicin de Reglas de Negocio


................................................................................................................................... 983
Acceso al modelo
..........................................................................................................................................................
de datos a travs de XPath
985
Filtros usando
.........................................................................................................................................................
XPath
987
Filtros avanzados
......................................................................................................................................................... 989
Elementos de..........................................................................................................................................................
las reglas de negocio
991
Elemento.........................................................................................................................................................
de expresiones
993
Funciones
......................................................................................................................................... 998
Ejemplos de funciones
...................................................................................................................................
bsicas de XPath
1005
Ejemplos de funciones
...................................................................................................................................
avanzadas de XPath
1009
Acceder a entidades
.........................................................................................................................................
no relacionas con el modelo de datos
1012
Buscar y reemplazar
.........................................................................................................................................
expresiones
1021
Elemento
.........................................................................................................................................................
Iterate over XPath
1023
Elemento
.........................................................................................................................................................
de Asignacin
1028
Elementos
.........................................................................................................................................................
Boolean, While e If
1037
Elemento
.........................................................................................................................................................
Funcin
1044
Elemento
.........................................................................................................................................................
Web service
1049
Elemento
.........................................................................................................................................................
For
1062
Elemento
.........................................................................................................................................................
Iterate over Fact
1066
Donde utilizar
..........................................................................................................................................................
reglas de negocio
1073

Copyright 2014 - Bizagi

Asignaciones,
.........................................................................................................................................................
clculos y validaciones
1074
Ruta del.........................................................................................................................................................
proceso
1089
Script booleano
......................................................................................................................................... 1102
Manejo.........................................................................................................................................................
de la interfaz de usuario
1110
Visible, editable,
.........................................................................................................................................
requerido usando expresions
1111
Visibilidad y editabilidad
...................................................................................................................................
de celdas
1131
Valores por defecto
.........................................................................................................................................
usando expresiones
1138
Valor mnimo .........................................................................................................................................
usando expresiones
1142
Valor mximo.........................................................................................................................................
usando expresiones
1146
Filtros con expresiones
......................................................................................................................................... 1151
Ejemplos de..........................................................................................................................................................
reglas de negocio
1163
Mostrar.........................................................................................................................................................
validaciones al usuario final
1164
Validacin
.........................................................................................................................................................
de Datos
1169
Definir la
.........................................................................................................................................................
duracin de tareas y temporizadores
1172
Realizar.........................................................................................................................................................
operaciones con fechas
1190
Realizar.........................................................................................................................................................
operaciones matemticas
1217
Realizar.........................................................................................................................................................
operaciones con cadenas de texto
1237
Obtener.........................................................................................................................................................
y utilizar informacin del usuario actual
1246
Obtener.........................................................................................................................................................
y utilizar informacin del caso actual
1251
Obtener.........................................................................................................................................................
y utilizar informacin de los asignados actuales
1267
Obtener.........................................................................................................................................................
y utilizar valores de la tarea actual
1277
Obtener.........................................................................................................................................................
y utilizar valores de un vocabulario
1280
Obtener.........................................................................................................................................................
y utilizar valores de una entidad
1286
Obtener.........................................................................................................................................................
propiedades de usuario
1296
Obtener.........................................................................................................................................................
usuarios basados en componentes de la organizacin
1297
Obtener.........................................................................................................................................................
los usuarios que han trabajado en un caso
1312
Definir y.........................................................................................................................................................
utilizar secuencias
1314
Ejecutar.........................................................................................................................................................
eventos
1319
Usar .id.........................................................................................................................................................
con XPath
1322
Usar Me.Context
......................................................................................................................................................... 1326
Mtodos
.........................................................................................................................................................
para interfaces
1331
Ejemplos
.........................................................................................................................................................
de colecciones
1340
Adicionar elementos
.........................................................................................................................................
a una relacin
1340
Eliminar elementos
.........................................................................................................................................
de una coleccin
1345
Asociar elementos
.........................................................................................................................................
a una coleccin
1348
Desasociar elementos
.........................................................................................................................................
de una coleccin
1351
Adicionar registros
.........................................................................................................................................
a tablas dentro de tablas
1355
Acceder al isimo
.........................................................................................................................................
registro de una coleccin
1362
Guardar el valor
.........................................................................................................................................
total de una columna
1366
Manejo.........................................................................................................................................................
de archivos con expresiones
1370
Cargar un archivo
.........................................................................................................................................
utilizando una expresin
1371
Borrar archivo.........................................................................................................................................
subido
1372
Copiar el contenido
.........................................................................................................................................
de un archivo de un atributo a otro
1374
Copiar el contenido
.........................................................................................................................................
de un archivo en una coleccin
1375
Contar el nmero
.........................................................................................................................................
de archivos cargados
1378
Obtener el nombre
.........................................................................................................................................
del archivo cargado
1380
Validar el nombre
.........................................................................................................................................
de los archivos
1382
Obtener la ruta
.........................................................................................................................................
del archivo cargado en Bizagi
1385
Polticas
.......................................................................................................................................................... 1386
Creando.........................................................................................................................................................
una poltica
1387
Vocabulario
......................................................................................................................................................... 1396
Definicin de.........................................................................................................................................
constantes
1402
Definicin de.........................................................................................................................................
XPath
1408
Propiedades ...................................................................................................................................
avanzadas de XPath
1417

Copyright 2014 - Bizagi

Reglas de
.........................................................................................................................................................
polticas
1421
Tablas de
.........................................................................................................................................................
decisin
1435
Precondiciones
.........................................................................................................................................................
o rboles de decisin
1444
Grupo de
.........................................................................................................................................................
reglas
1460
Reusabilidad
......................................................................................................................................................... 1464
Validar mi regla
..........................................................................................................................................................
de negocio
1470
Copiar desde
..........................................................................................................................................................
en expresiones
1476
Reutilizar reglas
..........................................................................................................................................................
de negocio
1479
Trabajos personalizados
.......................................................................................................................................................... 1493

Definicin de notificaciones
................................................................................................................................... 1501
Correos electrnicos
..........................................................................................................................................................
automticos
1502
Notificaciones
..........................................................................................................................................................
creadas (no automticas)
1504
Incluir informacin
.........................................................................................................................................................
del proceso y del caso
1508
Incluir Tablas
.........................................................................................................................................................
o colecciones
1517
Enviar mensajes
.........................................................................................................................................................
de acuerdo a condiciones
1528
Incluir informacin
.........................................................................................................................................................
de una regla
1533
Enviar a.........................................................................................................................................................
mltiples destinatarios
1536
Cambio de contexto
......................................................................................................................................... 1547
Envo de
.........................................................................................................................................................
copias y copias ocultas
1556
Configuracin
..........................................................................................................................................................
de servidor de correo
1557
Instalacin
.........................................................................................................................................................
de un SMTP local
1559
Configuracin
.........................................................................................................................................................
avanzada de servidor de correo
1564

Plantillas de Documentos ................................................................................................................................... 1572


Crear la plantilla
.......................................................................................................................................................... 1574
Crear plantilla
.........................................................................................................................................................
de Word
1575
Crear plantilla
.........................................................................................................................................................
de Excel
1578
Crear plantilla
.........................................................................................................................................................
de archivo plano
1583
Definir cmo..........................................................................................................................................................
generar el documento
1586
Incluir plantilla
.........................................................................................................................................................
para generar manualmente
1586
Incluir plantilla
.........................................................................................................................................................
para generar automticamente
1590
Configurar plantilla
..........................................................................................................................................................
de documento
1592
Configurar
.........................................................................................................................................................
una plantilla de word
1594
Configurar
.........................................................................................................................................................
una plantilla de excel
1604
Configurar
.........................................................................................................................................................
una plantilla de texto plano
1615
Editar y.........................................................................................................................................................
eliminar una plantilla
1625
Temas avanzados
..........................................................................................................................................................
de plantillas de documentos
1628
Incluir imagenes
.........................................................................................................................................................
en plantillas de documentos
1628
Mltiples
.........................................................................................................................................................
Plantillas de documentos
1632
Funciones
.........................................................................................................................................................
avanzadas de mapeo
1639
Plantillas
.........................................................................................................................................................
de documento con tablas dentro de tablas
1653
Plantillas
.........................................................................................................................................................
de documentos en tablas
1660
Integracin
.........................................................................................................................................................
ECM
1665
Preconfigurar.........................................................................................................................................
el ECM
1667
Configurar SharePoint
...................................................................................................................................
como ECM
1667
Configurar Alfresco
...................................................................................................................................
como ECM
1675
Configurar Documentum
...................................................................................................................................
como ECM
1677
Definir el ECM.........................................................................................................................................
en Bizagi
1678
Asignar la metadata
...................................................................................................................................
a travs de reglas
1698

Integracin con aplicaciones


................................................................................................................................... 1700
Invocar servicios
..........................................................................................................................................................
externos desde Bizagi
1704
Invocar .........................................................................................................................................................
servicios Web (SOAP)
1707
Invocar servicios
.........................................................................................................................................
desde el Bus de IBM WebSphere
1719
Enviar y recibir
.........................................................................................................................................
archivos
1728

Copyright 2014 - Bizagi

Enviar archivos
...................................................................................................................................
a un servicio Web
1729
Recibir archivos
...................................................................................................................................
desde servicios Web
1736
Invocar .........................................................................................................................................................
servicios REST
1744
Consideraciones
.........................................................................................................................................
sobre servicios REST
1760
Caractersticas
.........................................................................................................................................................
y funciones de mapeo
1763
Funciones de.........................................................................................................................................
Mapeo
1776
Mapeo con Colecciones
......................................................................................................................................... 1785
Mapeo .........................................................................................................................................................
avanzado
1791
Manejo.........................................................................................................................................................
de Errores en Interfaces
1798
Invocar .........................................................................................................................................................
desde actividades asncronas
1804
Integrar APIs..........................................................................................................................................................
o cdigo personalizado en Bizagi
1809
Ejemplo.........................................................................................................................................................
en Enterprise .NET
1811
Ejemplo.........................................................................................................................................................
en Enterprise JEE
1821
Consideraciones
.........................................................................................................................................
especiales con componentes
1831
API de Bizagi..........................................................................................................................................................
para aplicaciones externas
1834
URL de .........................................................................................................................................................
la Capa SOA y consideraciones
1837
Esquemas
.........................................................................................................................................................
del modelo de datos de Bizagi XML
1841
Servicios
.........................................................................................................................................................
Web disponibles en la Capa SOA
1848
Mtodos Web.........................................................................................................................................
de WorkflowEngineSOA
1849
abortCasesAsString
................................................................................................................................... 1851
assignActivityAsString
................................................................................................................................... 1855
createCasesAsString
................................................................................................................................... 1862
getActivitiesAsString
................................................................................................................................... 1871
getApplications
................................................................................................................................... 1879
getCasesAsString
................................................................................................................................... 1881
getCategoriesAsString
................................................................................................................................... 1890
getCategoriesLocalized
................................................................................................................................... 1893
getClosedActivitiesAsString
................................................................................................................................... 1896
getEventsAsString
................................................................................................................................... 1903
getWorkflowClassesAsString
................................................................................................................................... 1908
getWorkflowClassesFromCategoryName
................................................................................................................................... 1912
perfomActivityAsString
................................................................................................................................... 1916
saveActivityAsString
................................................................................................................................... 1925
setEventAsString
................................................................................................................................... 1934
Mtodos Web.........................................................................................................................................
de EntityManagerSOA
1944
getCaseDataUsingSchemaAsString
................................................................................................................................... 1945
getCaseDataUsingXPathsAsString
................................................................................................................................... 1947
getEntitiesAsString
................................................................................................................................... 1953
getEntitiesUsingSchemaAsString
................................................................................................................................... 1957
getEntitySchemaStr
................................................................................................................................... 1961
saveEntityAsString
................................................................................................................................... 1963
Mtodos Web.........................................................................................................................................
de QuerySOA
1968
QueryCasesAsString
................................................................................................................................... 1970
QueryEntitiesAsString
................................................................................................................................... 1978
Mtodos Web.........................................................................................................................................
de RenderSOA
1985
GetActivityForm
................................................................................................................................... 1986
GetFormById................................................................................................................................... 1991
GetQueryForms
................................................................................................................................... 1996
GetSummaryForms
................................................................................................................................... 2001
Usando.........................................................................................................................................................
llaves de negocio en XMLs
2005
Cargar un
.........................................................................................................................................................
archivo o imagen utilizando capa SOA
2007

Asignacin de trabajo

................................................................................................................................... 2010

Componentes
..........................................................................................................................................................
de la asignacin de trabajo
2011
Asignaciones
..........................................................................................................................................................
de trabajo bsicas
2016

Copyright 2014 - Bizagi

Asignaciones
..........................................................................................................................................................
usando expresiones
2023
Asignaciones
..........................................................................................................................................................
de tareas utilizando pre condiciones
2026
Cuando ningun
..........................................................................................................................................................
usuario cumple las condiciones de asignacin
2034
Ignorar las reglas
..........................................................................................................................................................
de asignacin
2041
Reasignar trabajo
.......................................................................................................................................................... 2042
Organizacin
.......................................................................................................................................................... 2049
Crear una
.........................................................................................................................................................
organizacin
2052
Asistente de organizacin
......................................................................................................................................... 2067
Propiedades
.........................................................................................................................................................
de usuario
2075
Grupos .........................................................................................................................................................
de usuarios
2086
Esquema
.........................................................................................................................................................
de horarios de trabajo y calendarios
2090
Esquema de horario
.........................................................................................................................................
de trabajo
2091
Esquema de festivos
......................................................................................................................................... 2100
Mltiples
.........................................................................................................................................................
organizaciones
2103

Definicin de Seguridad ................................................................................................................................... 2109


Seguridad en
..........................................................................................................................................................
Bizagi Studio
2110
Configurar
.........................................................................................................................................................
la seguridad en Bizagi Studio
2113
Crear grupos
.........................................................................................................................................................
en la Seguridad de Bizagi Studio
2118
Seguridad del
..........................................................................................................................................................
Portal de Trabajo
2120
Autenticacin
......................................................................................................................................................... 2122
Autenticacin.........................................................................................................................................
Bizagi
2124
Autenticacin.........................................................................................................................................
Windows
2126
Autenticacin.........................................................................................................................................
LDAP
2131
Importar usuarios
...................................................................................................................................
LDAP
2133
Atributos LDAP
................................................................................................................................... 2140
Autenticacin.........................................................................................................................................
avanzada
2142
Autenticacin...................................................................................................................................
personalizada
2142
Autenticacin...................................................................................................................................
mixta
2145
Seguridad
.........................................................................................................................................................
para mens del Portal
2147
Dar acceso a los
.........................................................................................................................................
mens del Portal
2150
Seguridad
.........................................................................................................................................................
del caso
2166
Manejar los privilegios
.........................................................................................................................................
a travs de la capa SOA
2183
Restringir acceso
..........................................................................................................................................................
mvil a Procesos/Tareas
2185
Encripcin en
..........................................................................................................................................................
la base de datos
2188

Definicin de la localizacin
................................................................................................................................... 2203
Traducir los ..........................................................................................................................................................
objetos del Portal de Trabajo
2204
Localizar los..........................................................................................................................................................
procesos y sus componentes
2208

Nmero de caso personalizado


................................................................................................................................... 2213
Cmo configurar
..........................................................................................................................................................
Virtualizacin para entidades relacionadas
2223

Columnas personalizadas ................................................................................................................................... 2250


Cmo hacer? ....

................................................................................................................................... 2266

Temas de integracin
.......................................................................................................................................................... 2266
Cmo integrar
.........................................................................................................................................................
Bizagi con SAP
2266
Integrar Bizagi
.........................................................................................................................................
con SAP invocando servicios web de SAP
2268
Crear un proveedor
.........................................................................................................................................
en SAP desde Bizagi
2281
Integrar Bizagi
.........................................................................................................................................
con SAP invocando directamente BAPI Wrappers
2292
Cmo iniciar
.........................................................................................................................................................
Procesos en Bizagi desde otras aplicaciones
2309
Cmo realizar
.........................................................................................................................................................
Actividades Bizagi desde otras aplicaciones
2315
Cmo integrar
.........................................................................................................................................................
Bizagi con Joomla!
2322
Cmo ejecutar
.........................................................................................................................................................
procedimientos almacenados desde Bizagi
2337
Temas de inters
..........................................................................................................................................................
general
2353
Cmo crear
.........................................................................................................................................................
un backup de la base de datos de Bizagi
2353

Copyright 2014 - Bizagi

Crear backups.........................................................................................................................................
en SQL Server
Crear backups.........................................................................................................................................
en Oracle
Cmo restaurar
.........................................................................................................................................................
un backup de la base de datos de Bizagi
Restaurar backups
.........................................................................................................................................
en SQL Server
Restaurar backups
.........................................................................................................................................
en Oracle
Cmo mover
.........................................................................................................................................................
o clonar un proyecto Bizagi
Cmo cambiar
.........................................................................................................................................................
la ubicacin de su proyecto Bizagi

2354
2359
2364
2365
2375
2382
2384

2397

Parte III Bizagi Engine

Bizagi Engine - requerimientos


...................................................................................................................................
de sistema
2398
Bizagi Engine
..........................................................................................................................................................
ejecutndose sobre plataforma .NET
2399
Alta disponibilidad
.........................................................................................................................................................
.NET - requerimientos de sistema
2399
Arquitectura
.........................................................................................................................................................
estndar .NET - requerimientos de sistema
2404
Bizagi Engine
..........................................................................................................................................................
ejecutndose sobre plataforma JEE
2408
Alta disponibilidad
.........................................................................................................................................................
JEE - requerimientos de sistema
2408
Arquitectura
.........................................................................................................................................................
estndar JEE - requerimientos de sistema
2413

Bizagi Engine - instalacin................................................................................................................................... 2417


Bizagi Engine
..........................................................................................................................................................
para .NET - instalacin
2418
Bizagi Engine
..........................................................................................................................................................
para JEE - instalacin
2425

Soporte multi idioma

................................................................................................................................... 2426

Portal de Trabajo de Bizagi


................................................................................................................................... 2429
Interfaz del Portal
..........................................................................................................................................................
de Trabajo
2431
Men principal
......................................................................................................................................................... 2433
rea de.........................................................................................................................................................
casos
2436
rea de.........................................................................................................................................................
trabajo
2440
Inbox
......................................................................................................................................... 2441
Actividades pendientes
......................................................................................................................................... 2446
Log de estado
................................................................................................................................... 2456
Consulta grfica
................................................................................................................................... 2464
Inicio de sesin
..........................................................................................................................................................
en el Portal de Trabajo
2468
Escoger.........................................................................................................................................................
el idioma del Portal de Trabajo
2473
Administracin
..........................................................................................................................................................
del Portal de Trabajo
2474
Administracin
.........................................................................................................................................................
de Casos
2476
Administracin
.........................................................................................................................................................
de usuarios
2484
Manejo de Posiciones,
.........................................................................................................................................
Roles y Habilidades
2492
Cuentas bloqueadas
......................................................................................................................................... 2495
Usuario delegado
......................................................................................................................................... 2503
Valores .........................................................................................................................................................
de Entidades Paramtricas en el Portal de Trabajo
2508
Administrar
.........................................................................................................................................................
Polticas en el Portal de Trabajo
2514
Definicin
.........................................................................................................................................................
de alarmas
2517
Consultas .......................................................................................................................................................... 2522
Anlisis.........................................................................................................................................................
grafico
2535
Cambiar la apariencia
..........................................................................................................................................................
del Portal de Trabajo
2550
Constructor
.........................................................................................................................................................
de Temas
2551
Configurar un.........................................................................................................................................
tema predefinido
2552
Crear un tema.........................................................................................................................................
a partir de un color base
2554
Personalizar componentes
.........................................................................................................................................
especficos
2557
Comentarios..........................................................................................................................................................
del caso
2560

Movilidad

................................................................................................................................... 2575

Consideraciones
..........................................................................................................................................................
para mviles
2584
Aplicacin de
..........................................................................................................................................................
Windows 8
2585

Integracin con portales ................................................................................................................................... 2589


10

Copyright 2014 - Bizagi

10

Bizagi Web parts


..........................................................................................................................................................
para SharePoint
2590
Instalacin
.........................................................................................................................................................
de las Web parts
2592
Configuracin
.........................................................................................................................................................
de las Web parts
2609
Propiedades
.........................................................................................................................................................
de las Web parts
2616
El portal de trabajo
.........................................................................................................................................
como Web part
2619
Opciones de personalizacin
.........................................................................................................................................
y avanzadas
2627
Estilos en
.........................................................................................................................................................
las Web parts
2639
Personalizacin
.........................................................................................................................................
del layout
2643
Uso de Web..........................................................................................................................................................
parts desde portales
2646
Detalle .........................................................................................................................................................
de las Web parts y personalizacin
2652

Anlisis del Proceso

................................................................................................................................... 2654

BAM
..........................................................................................................................................................
Anlisis
..........................................................................................................................................................
Sensores ..........................................................................................................................................................
Mis Reportes
..........................................................................................................................................................
Dimensiones..........................................................................................................................................................

2655
2665
2672
2684
2687

Licenciamiento explicado ................................................................................................................................... 2695


Tipos de licencias
.......................................................................................................................................................... 2696
Comprar licencias
.......................................................................................................................................................... 2699
Administrar ..........................................................................................................................................................
licencias
2704
Activacin de
..........................................................................................................................................................
licencia
2710
Activacin
.........................................................................................................................................................
de licencia sin acceso a Internet
2715
Activacin
.........................................................................................................................................................
de licencia en la Enterprise JEE
2716
Soporte a clientes
.......................................................................................................................................................... 2722
Cmo usar
.........................................................................................................................................................
el Sitio de Soporte
2723

2741

Parte IV Recursos tiles


Glosario Bizagi

................................................................................................................................... 2741

Copyright 2014 - Bizagi

11

Parte I
Bienvenido a Bizagi BPM Suite V10.5

Bienvenido a Bizagi BPM Suite V10.5


Refirase a los temas presentados a la izquierda o realice una bsqueda para encontrar
lo que necesite.

Desde el diseo y modelamiento a la automaizacin y despliegue,


Bizagi BPM Suite soporta completamente el ciclo de vida BPM, para
hacer del mejoramiento continuo una realidad.

Copyright 2014 - Bizagi

13

Introduccin

Obtenga visibilidad y control con Bizagi BPM Suite, su alternativa para una gestin de procesos
rpida y flexible. Al cerrar la brecha entre los negocios y TI, Bizagi le permite a su equipo obtener los
resultados que deseen, en el momento en que los deseen. Descubra una plataforma de colaboracin
de procesos de negocio que habla su mismo idioma: el lenguaje de procesos de negocio.
Desde el diseo y modelado hasta la automatizacin y despliegue, Bizagi BPM Suite soporta
completamente el ciclo de vida BPM para hacer de la mejora continua una realidad.
Bizagi permite a los expertos de negocio disear, documentar, ejecutar y evolucionar sus modelos de
proceso con total confianza. Una intuitiva funcionalidad de arrastre y suelte, actualizaciones libres de
cdigo y herramientas de generacin automtica de documentos hacen de esta una experiencia sin
fisuras, incluso sin conocimientos tcnicos.
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.
Apoderamos a los usuarios de negocio para automatizar y modificar procesos de negocio complejos
y dinmicos ms rpido y de forma ms flexible que cualquier otra solucin, parte vital para el
mejoramiento continuo de los procesos crticos de la organizacin.
Cada herramienta de Bizagi BPM Suite: Bizagi Modeler, Bizagi Studio y Bizagi Engine, le ayudarn a
completar el ciclo de vida de sus Procesos de negocio.
Bizagi Modeler : Reconocido por nuestra comunidad como el ms potente entorno de
modelamiento BPMN en el mercado, Bizagi permite a los expertos de negocio disear, documentar,
ejecutar y evolucionar sus modelos de proceso con total confianza. Una intuitiva funcionalidad de
arrastre y suelte, actualizaciones libres de cdigo y herramientas de generacin automtica de
documentos hacen de esta una experiencia sin fisuras, incluso sin conocimientos tcnicos.
Bizagi Studio : Gracias a la filosofa de Bizagi de "Modelamiento sobre programacin", los expertos
de negocio tienen todo lo que necesitan, para transformar los modelos de procesos en aplicaciones
y flujos de trabajo reales. Desde la definicin de su modelo de datos y la interfaz de usuario hasta la
integracin de recursos de TI, el asistente incorporado de Bizagi lo apoya en cada paso del camino.

Copyright 2014 - Bizagi

14

Bizagi Engine: Desplegados en JEE o NET para adaptarse a cualquier arquitectura que usted posea,
Bizagi Engine ejecuta y controla los procesos de negocio automatizados por Bizagi Studio. El
enfoque de "Actualice una vez y cambie en cualquier lugar" optimiza la carga de trabajo hacia arriba
y abajo de su cadena de valor, reduciendo tiempo y costos. El Portal multi- lenguaje de Bizagi
permite una fcil visualizacin de las actividades pendientes, mientras que los KPIs proporcionan un
control total sobre el rendimiento del proceso
Bizagi BPM Suite ofrece un Modelador de Procesos integrado en Bizagi Studio. Sin embargo lo
invitamos a diagramar y documentar sus procesos utilizando nuestro Bizagi Modeler y luego
automatizarlos con Bizagi Studio.

Conceptos de Bizagi BPM Suite


Bizagi BPM Suite le permite a usted y a su organizacin manejar todo el ciclo de vida de sus procesos:
Modelar, Construir, y Ejecutar, usando un ambiente grfico 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.

Modelar
El primer paso para crear un solucin Bizagi es disear el flujo del proceso. El flujo de proceso 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 Bizagi Modeler para disear y documentar sus diagramas de
proceso. Bizagi Modeler es una aplicacin gratuita independiente de Bizagi BPM Suite, dedicada a
ofrecerle la mejor experiencia al disear y documentar flujos de procesos, utilizando el estndar BPMN
(Business Process Model and Notation). BPMN es un estndar aceptado mundialmente para el
modelamiento de procesos.
Una vez finaliza el diseo del lujo de trabajo, seleccione Ejecutar Workflow en la pestaa de Inicio del
Modeler. Esto exportar automticamente sus procesos al ambiente de construccin, Bizagi Studio.

Copyright 2014 - Bizagi

15

Construir
Luego de disear el proceso, el siguiente paso es construir la solucin, es decir automatizar.
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 en
Bizagi Modeler. Un asistente fcil de usar lo guiar a travs de cada uno de los pasos 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.

Copyright 2014 - Bizagi

16

Ejecutar
El modelo es almacenado en una base de datos y es interpretado y ejecutado por Bizagi Engine. El
modelo se presenta en el Portal de Trabajo (aplicacin web) accediendo a este a travs de un
navegador. Bizagi Engine, 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
correcta 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

Copyright 2014 - Bizagi

17

visualizado de forma inmediata.

Mejorar
Bizagi incluye un conjunto de reportes e indicadores de rendimiento acerca del proceso que le
ayudarn a analizar la operacin de sus negocios en tiempo real e histricamente. Estos indicadores
permiten a los dueos de proceso y 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 Reportes de Anlisis en el Portal
de Trabajo, se identifican las oportunidades de mejoramiento de los procesos.
Basado en sus hallazgos, los procesos y 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 continuo 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 2014 - Bizagi

18

Productos relacionados

El Modelamiento del Proceso es el primer paso en cualquier automatizacin de Proceso. Modelar un


Proceso es una tarea iterativa y sencilla para representar condiciones de negocio en un diagrama de
flujo, utilizando smbolos y elementos.
Bizagi Modeler es una herramienta para modelamiento y documentacin de procesos. El modelador le
permitir de forma grfica diagramar, modelar y documentar sus procesos de negocio utilizando el
estndar BPMN (Business Process Model and Notation). BPMN es un estndar mundialmente aceptado
para el modelamiento de procesos.
Lleve su viaje BPM al mejor comienzo con Bizagi Modeler. La colaboracin y la rpida e intuitiva
funcionalidad "arrastre y suelte" cierra la brecha entre el negocio y TI, involucrando a todos en la

Copyright 2014 - Bizagi

19

discusin del proceso, desde el primer momento.


Publique documentos de alta calidad en su formato preferido: Word, PDF, Pginas Web, SharePoint o
Wiki. Cualquier tamao, cualquier industria, cualquier proyecto.
Basado 100% en notacin BPMN.
El modelador de procesos BPMN ms intuitivo del mercado.
Fomente la colaboracin en equipo.
Mantenga discusiones al momento de definir procesos. Trabaje de forma segura en el mismo
proyecto, donde quiera que se encuentre su equipo.
Simule sus procesos
Evale cmo sus grandes ideas impactarn realmente su negocio.
Multi-idioma
Comience a utilizar el modelador en su idioma preferido.
El Intellisense (finalizacin de cdigo inteligente) acoplado al modelador unido a su aspecto nico, le
permite mapear y documentar de forma rpida y sencilla, sin la demora de las rutinas de validacin.

Cmo se conectan nuestros productos?


Los Procesos son modelados y documentados utilizando Bizagi Modeler.
Una vez sus diagramas estn listos, llvelos a Bizagi Studio, el ambiente de desarrollo que transforma
estos procesos en aplicaciones ejecutables. Con Bizagi Studio, la implementacin de los procesos
incluye la definicin de: 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.
1. Descargue e instale Bizagi Modeler
2. Modele y documente sus procesos utilizando Bizagi Modeler .
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 Bizagi Studio, donde usted podr automatizar sus
proceso.

Copyright 2014 - Bizagi

20

3. Por medio 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.

Copyright 2014 - Bizagi

21

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

Entrenamiento y soporte
Bizagi BPM Suite 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 2014 - Bizagi

22

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.

Arquitectura
Introduccin
La vida de ciclo de un proceso involucra las siguientes fases: Modelar (model), Construir (build) y
Ejecutar (run), 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 Bizagi Modeler. Luego, por medio de Bizagi Studio, los detalles
de los procesos son extendidos para su ejecucin.

Construir
Luego de disear el proceso, el siguiente paso es construir la solucin. Bizagi Studio es la herramienta
utilizada para la automatizacin de procesos que fueron definidos previamente en Bizagi Modeler. Un
asistente fcil de usar lo guiar a travs de cada uno de los pasos 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.

Ejecutar

Copyright 2014 - Bizagi

23

Una vez el detalle de los procesos est completo, Bizagi ofrece la posibilidad de publicar estos
Procesos al ambiente de Produccin por medio de un asistente. Bizagi Engine se 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, por medio de Bizagi Engine.
Bizagi es una solucin model-driven, es decir, Bizagi Engine interpreta el modelo BPMN diseado sin
realizar ninguna transformacin.
Bizagi directamente ejecuta y controla el flujo del proceso en cualquier plataforma, a partir del modelo
BPMN como se defini grficamente por los analistas del proceso, sin la necesidad de cdigo
intermedio.
La siguiente imagen ilustra y resume lo mencionado anteriormente.

Procesos y su ciclo de vida en Bizagi

Bizagi se adapta a la infraestructura de su empresa


El siguiente diagrama ilustra los componentes que soportan tanto las funcionalidades orientadas a
procesos de Bizagi, y las mltiples opciones de integracin con los sistemas de su empresa (el
Enterprise Services Bus, servidor LDAP, servidor SMTP, sistemas de gestin documental, etc).

Copyright 2014 - Bizagi

24

El flujo del proceso es ejecutado por Bizagi Engine.


El siguiente diagrama ilustra los componentes principales de Bizagi Engine y su arquitectura:

Copyright 2014 - Bizagi

25

Copyright 2014 - Bizagi

26

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
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).
Para ms informacin sobre el portal de trabajo para usuarios finales, por favor dirjase a Portal de
Trabajo de Bizagi.

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 Bizagi
Modeler.
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.
Para las aplicaciones donde hay un gran volumen de datos y consultas de anlisis de reportes el
rendimiento de la aplicacin se puede ver afectado, 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

Copyright 2014 - Bizagi

27

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
Autenticacin Windows o 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 Bizagi Engine 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.
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 (Enterprise Mapping Layer)


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 Correo:
Los procesos en Bizagi pueden enviar notificaciones automticas usando un servidor de correo que
sea SMTP, tal como Lotus Notes y Exchange, entre otros.
Revise la Configuracin de SMTP para saber ms acerca de la configuracin del servidor de correos
para sus procesos de Bizagi.
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.
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.

Copyright 2014 - Bizagi

28

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.
Aunque se trate de un concepto que involucra la interaccin entre procesos (BPMN Colaborativo), los
eventos de negocio soportados incluyen Trabajos Personalizados.
Para los Trabajos Personalizado, se puede hacer uso de la programacin para especificar el
procesamiento por lotes u otras tareas sofisticadas, lo cual es una herramienta muy poderosa para
propsitos de integracin.

Integracin de Aplicaciones (Enterprise Service Bus, ERP, CRM, Core Applications, Legacy
Systems):
Bizagi soporta la integracin con ESB corporativas (p.e Bus WebSphere de IBM) y otros sistemas
externos.
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). Las dos posibilidades presentadas en
detalle son:

a) 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

b) 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.

API de Bizagi (Capa SOA)

Copyright 2014 - Bizagi

29

Bizagi sigue una arquitectura orientada a servicios, para tener las mejores prcticas de integracin y de
diseo.
Bizagi publica la funcionalidad de los procesos en su API a manera de servicios 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.
Vea ms informacin sobre los servicios web publicados por procesos en la capa SOA.

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).

Copyright 2014 - Bizagi

30

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

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 (2012,

Copyright 2014 - Bizagi

31

2008 R2, 2008, 2005) y Oracle 11g R2 o 10g R2.


Los mecanismos de tolerancia a fallos se soportan tanto para configuraciones pasivo-activo o activoactivo (p.e, a travs de Oracle RAC para Base de datos Oracle).
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.
Cuando sus procesos se ejecutan sobre una plataforma en .NET, se usa un entorno Windows con
Internet Information Services (IIS) como Servidor Web.
Cuando sus procesos se ejecutan sobre una JEE, los Servidores de Aplicacin ms representativos del
mercado son soportados: WebLogic, WebSphere, y JBoss.

Opcin Adicional
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.
Tenga en cuenta que se puede acceder al Portal de Trabajo a travs de diferentes dispositivos mviles
ya sean iOS (como iPad o iPhone) o Android.

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.

Copyright 2014 - Bizagi

32

Central de Procesos
La Central de Procesos 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.

Copyright 2014 - Bizagi

33

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 la central de procesos, d clic en Central de Procesos


Una nueva ventana ser mostrada con la lista de las plantillas existentes.

Copyright 2014 - Bizagi

34

2. Navegu por la central de procesos. 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.

Copyright 2014 - Bizagi

35

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 2014 - Bizagi

36

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 a la Central de Procesos a travs de la pestaa archivo en Bizagi Studio, la plantilla se
instalar en el PROCESO QUE ESTA ABIERTO ACTUALMENTE.

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.

Copyright 2014 - Bizagi

37

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.

Algunos procesos pueden no estar disponibles. Estamos trabajando para publicarlos todos. Por
favor ingrese a nuestra Central de Procesos continuamente para revisar nuestros anuncios ms
recientes.

Instalacin de servicios web para la Central de Procesos


Los usuarios de Bizagi utilizan diferentes mecanismos que permiten la conexin de la Suite BPM 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:
Para Solicitud de Vacaciones, Solicitud de Compra y Suscripcin de Plizas: ESB.zip

http://download.bizagi.com/partner/ESB.zip
Para Solicitud de Crdito: WsCreditRequest.zip

http://download.bizagi.com/partner/WsCreditRequest.zip
2. Descomprima la carpeta y cpiela en su ruta local del Default Web Site. Normalmente esta ruta es C:
\Inetpub\wwwroot

Copyright 2014 - Bizagi

38

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".
Clic para ms informacin sobre cmo verificar si el IIS fue instalado correctamente.

Copyright 2014 - Bizagi

39

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 2014 - Bizagi

40

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.
Clic para ms informacin sobre cmo verificar si el IIS fue instalado correctamente.
4. En el administrador, abra el Default Web Site y busque la carpeta del servicio web (ESB o
WsCreditRequest). Haga clic derecho sobre ella y seleccione Propiedades.

Copyright 2014 - Bizagi

41

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

Copyright 2014 - Bizagi

42

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.

Copyright 2014 - Bizagi

43

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

Copyright 2014 - Bizagi

44

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

Copyright 2014 - Bizagi

45

Parte II
Bizagi Studio

Bizagi Studio

Bizagi Studio convierte sus modelos de proceso en aplicaciones ejecutables para que pueda
distribuirlos en toda la organizacin a gran velocidad . Sin Cdigo, sin problemas , slo una simple
aplicacin web que le permite adaptarse fcilmente a los constantes cambios.
Con Bizagi Studio, la mejora continua es ya una realidad. Bienvenido al software empresarial que
funciona.
El Proceso ES la aplicacin
Convierta su proceso en una aplicacin web y adptatelo al instante. No requiere codificacin y todo
ello alineado con los ltimos estndares web.
Logre resultados rpidos
La Capa de datos promueve la reutilizacin, as que usted puede compartir de forma rpida y rentable
objetos de negocio a travs de procesos y proyectos.
Formas sin cdigo
Arrastre y suelte los atributos en cualquiera de nuestros formularios generados automticamente. Es
as de simple.
Reglas de negocio flexibles
Administre y comparta sus polticas y reglas de negocio a travs de muchos proyectos. Haga los
cambios e implemntelos fcilmente al instante.
Balanceo de carga de trabajo y el enrutamiento
Obtenga un control total sobre los recursos. Defina el trabajo que se asignar. Optimice y equilibre las
cargas de trabajo a travs de algoritmos incorporados y gestione los delegados y calendarios de
trabajo.
Fcil integracin
Enlace los datos de Bizagi con sus recursos de TI utilizando nuestra herramienta basada en SOA de
gran alcance. Desde SAP hasta Documentum , SharePoint hasta Outlook, conecte procesos sin
programacin.

Copyright 2014 - Bizagi

47

Bizagi Studio - requerimientos de sistema


Qu utiliza Bizagi Studio?
Para convertir sus modelos de proceso en aplicaciones ejecutables, Bizagi Studio utiliza lo siguiente:

1. Una base de datos


Los procesos y los detalles de su implementacin en Bizagi se almacenan en una base de datos.

2. Un Portal de trabajo basado en la web


Bizagi presenta un entorno de ejecucin integrado donde podr probar los procesos automatizados.
Mientras se automatizan los procesos, este entorno de ejecucin con su portal de trabajo, refleja en
tiempo real todos los cambios que se realizan en Bizagi Studio.
El portal de trabajo es una aplicacin web que nicamente requiere de un navegador, por lo que esta
aplicacin se alberga en una instancia de servidor web.
La mquina donde se alberga el Portal de trabajo se conoce como el servidor BPM.
Bizagi Studio utiliza esta instancia de servidor web para que en cualquier momento se pueda visualizar
el portal de trabajo, justo como se disponibilizar a los usuarios finales en un ambiente productivo.
Bizagi Studio genera de manera automtica el portal de trabajo y provee este entorno de ejecucin

Copyright 2014 - Bizagi

48

para que usted pueda ver el prototipo y hacer pruebas rpidas sobre sus procesos.

Requerimientos de sistema
Puede optar por una configuracin de inicio rpido que le instale los componentes que necesita Bizagi
Studio de manera local, o puede tambin realizar una configuracin para un equipo de trabajo
colaborativo para que mltiples usuarios automaticen los procesos corporativos de manera conjunta.
Ntese que en cualquier momento, es posible mover el proyecto desde una configuracin local de
inicio rpido a una configuracin para un equipo de trabajo colaborativo.

Se recomienda enfticamente utilizar sistemas con soporte a 64 bits para la mejor experiencia en
rendimiento.

Configuracin de inicio rpido


Puede optar por instalar Bizagi Studio y que se incluya automticamente una instancia de base de
datos local, y utilizar tambin una instancia de servidor web local.
Esta opcin es muy til para conseguir resultados gilmente, para demos, evaluacin del producto y
prototipos.
Para un inicio rpido con Bizagi Studio, slo necesita instalar Bizagi Studio y asegurarse de seleccionar
la opcin de Instalar SQL Server Express 2008 SP3 durante la instalacin:

Copyright 2014 - Bizagi

49

Por defecto si no se tiene una instancia de servidor web, Bizagi Studio utilizar la instancia local:
IIS Express, para ejecucin de procesos en una plataforma .NET.
JBoss EAP, para ejecucin de procesos en una plataforma JEE (requiere de Bizagi JEE Plugin).

Las opciones de inicio rpido, le permite fcilmente comenzar a utilizar Bizagi, con los componentes
requeridos instalados de manera local. Para ello, asegrese de que su sistema cumpla con los
siguientes requisitos:
REQUISITOS DE LA CONFIGURACIN DE INICIO RPIDO PARA BIZAGI STUDIO
H RAM
A
R
D Disco duro
WResolucin de
A pantalla
R
E
Sistema
S operativo
O
F
T
W
A

4 GB mnima.
Recomendado: 6 GB.
10 GB de espacio libre
1024 x 768 o superior

Windows
Windows
Windows
Windows
Windows
Windows
Windows

Server 2012
Server 2008 R2
Server 2008
8.1
8 (todas las ediciones excepto Windows 8 SL).
7 (Soporte a las ediciones Ultimate, Enterprise o Professional).
Vista (Soporte a las ediciones Ultimate, Business o Professional).

Copyright 2014 - Bizagi

50

R
E

Windows Server 2003 SP1 - 32 bits


Base de datos

Instancia local de SQL Server 2008 SP3, edicin Express.


Opcin disponible durante la instalacin de Bizagi Studio.

Servidor web

Instancia de IIS Express 8 local incluida por la instalacin de Bizagi Studio.


De esta manera se ejecutan los procesos en una plataforma de .NET.
En caso de que usted quiera estrictamente automatizar los procesos y
probarlos en una plataforma de JEE, consulte la Instalacin de plataforma JEE.

Framework

Versin 4.0 del framework .NET que instala Bizagi Studio. El framework incluye
otros componentes como Visual C++ 2010, 2008 redistribuble.

Navegador

Internet Explorer 9 o superior


Chrome 24 o superior
Safari 5 o superior
Firefox 19 o superior

Una vez que haya revisado que su equipo cumple con los requerimientos de sistema, no requiere de
pasos adicionales de configuracin por lo que puede omitir la informacin sobre requerimientos.

Configuracin para trabajo colaborativo


Bizagi soporta una configuracin para trabajo colaborativo.
Al automatizar los procesos corporativos, la configuracin recomendada para soportar el trabajo
colaborativo considera los siguientes requisitos:

Copyright 2014 - Bizagi

51

SERVIDOR DE BASE DE DATOS


RAM

8 GB

Disco duro

80 GB de espacio libre

HARDWARE

SOFTWARE

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
Oracle Database 10g R2

Motor de base de
datos

SERVIDOR BPM
RAM

8 GB

Disco duro

40 GB de espacio libre

HARDWARE

Sistema operativo

Windows Server 2012


Windows Server 2008 R2
Windows Server 2008
Windows 8.1
Windows 8 (todas las ediciones excepto Windows 8 SL).
Windows 7 (Soporte a las ediciones Ultimate, Enterprise
o Professional).
Windows Vista (Soporte a las ediciones Ultimate,
Business o Professional).
Windows Server 2003 SP1 - 32 bits
Para
IIS
IIS
IIS
IIS
IIS

SOFTWARE

una plataforma .NET:


8.5.
8.0.
7.5.
7.0.
6.0.

Servidor web
Para una plataforma JEE (mediante un plugin descrito en
Instalacin de plataforma JEE):
JBoss 6.2 EAP (preconfigurado y listo para usar por
defecto)
WebSphere V7
Weblogic 11g

Componentes
adicionales

Bizagi Studio, que instala el framework de .NET 4.0 full (y


este framework de .NET incluye otros componentes
necesarios como Visual C++ 2010, 2008 Redistribuble).
Oracle Data Provider para .NET (aplica para proyectos
que utilicen una base de datos Oracle).

Copyright 2014 - Bizagi

52

ESTACIONES DE TRABAJO CON BIZAGI STUDIO

HARDWARE

RAM

4 GB mnima.
Recomendado: 6 GB.

Disco duro

10 GB de espacio libre

Resolucin de
pantalla

1024 x 768 o superior

Sistema operativo

Windows Server 2012


Windows Server 2008 R2
Windows Server 2008
Windows 8.1
Windows 8 (todas las ediciones excepto Windows 8 SL).
Windows 7 (Soporte a las ediciones Ultimate, Enterprise
o Professional).
Windows Vista (Soporte a las ediciones Ultimate, Business
o Professional).
Windows Server 2003 SP1 - 32 bits

Navegador

Internet Explorer 9 o superior


Chrome 24 o superior
Safari 5 o superior
Firefox 19 o superior

Componentes
adicionales

Bizagi Studio, que instala el framework de .NET 4.0 full (y


este framework de .NET incluye otros componentes
necesarios como Visual C++ 2010, 2008 Redistribuble).
Oracle Data Provider para .NET (aplica para proyectos
que utilicen una base de datos Oracle).

SOFTWARE

Tenga en cuenta las siguientes consideraciones:


1. Framework 3.5 de .NET para SQL Server y plataforma JEE.
Si usted utiliza SQL Server y ejecuta sus procesos en una plataforma JEE, deber instalar el
framework 3.5 de .NET sobre sistemas operativos Windows Server 2012, Windows 8.1 o Windows 8.
2. No se soportan sistema operativos o configuracin de mquina en idioma turco.
Los equipos y servidores de los requerimientos mencionados, debern tener una configuracin
regional que no utilice idioma o cultura de Turqua (tr, tr-TR).

Importante
Copyright 2014 - Bizagi

53

Los requerimientos del hardware tambin dependen de otras variables, como por ejemplo: el nmero
de usuarios que trabajan en el equipo, la demanda de procesamiento involucrada, si hay mltiples
puntos de integracin en los procesos, entre otras.
Por lo tanto, las recomendaciones anteriores corresponden a lo mnimo que debe ser considerado.

Base de datos - requisitos

Introduccin
Los procesos y los detalles de su automatizacin en Bizagi son almacenados en una base de datos.
Esta base de datos se configura sobre una instancia de servidor de base de datos.
Las siguientes bases de datos son soportadas:
Microsoft SQL Server
Oracle

Inicio rpido
Para utilizar las opciones de inicio rpido con Bizagi, usted podr instalar un base de datos SQL Server
local que provee Bizagi con su instalador.
Para ello, no se requiere de configuracin adicional y podr omitir los siguientes captulos sobre los
requisitos de la base de datos.
Si desea ver informacin sobre los requerimientos de Bizagi Studio, consulte Bizagi Studio
requerimientos de sistema.

Otras opciones
Si desea utilizar una instancia corporativa de SQL Server, o una base de datos Oracle, asegrese de
llevar a cabo la configuracin requerida para SQL Server o Oracle, como se describe en los siguientes
captulos.

SQL Server - requisitos

Introduccin
Bizagi Studio requiere de una instancia de base de datos para el repositorio de sus procesos.
Microsoft SQL Server es soportado como motor de base de datos para este fin.

Versiones y ediciones soportadas


Bizagi soporta las siguientes versiones:
VERSIN

NMERO

SQL Server 2012

11.0.2100 o superior

SQL Server 2008 R2, service pack 1

10.50.2500 o superior

Copyright 2014 - Bizagi

54

SQL Server 2008, service pack 1

10.00.2531 o superior

SQL Server 2005, service pack 2

9.00.3042 o superior

Las ediciones Enterprise, Standard o Express son todas soportadas.

La base de datos debe instalarse con una intercalacin (collation) que cumpla lo siguiente:
Sea sensible a maysculas, o sea "case-insensitive" (CI).
No sea una intercalacin del idioma turco.

Configuracin requerida
La configuracin de una instancia SQL Server para trabajar con Bizagi, requiere lo siguiente:
Autenticacin tipo SQL Server
Deber habilitar la autenticacin tipo SQL Server para esa instancia de base de datos.
Protocolo TCP/IP
Deber asegurarse de habilitar el protocolo TCP/IP, y de revisar que ste se configure bajo prcticas
recomendadas como: un puerto explcito TCP/IP (no utilizando puertos dinmicos), y permitir las
conexiones remotas.
Login de usuario autorizado
Deber contar por lo menos con 1 login de usuario (inicio de sesin), que utilice la autenticacin SQL
Server y que tenga los permisos necesarios.

Si usted opt por utilizar la opcin de inicio rpido donde Bizagi Studio instala una base de datos
SQL Server local, entonces no requiere de configuracin adicional.
Podr utilizar el login de usuario sa que se habilita por defecto para esa base de datos.
La contrasea inicial para el login de usuario sa es Bizagi10GO.
Si usted no desea utilizar el login de usuario sa para el ambiente de desarrollo de su proyecto de
Bizagi Studio, entonces podr crear y utilizar login de usuarios adicionales como se describe en
Configuracin avanzada de usuarios SQL Server.

Verificando la configuracin en SQL Server


Lleve a cabo los siguientes pasos, para asegurarse de que su instancia SQL Server tenga la
configuracin requerida.

Antes de comenzar
Copyright 2014 - Bizagi

55

Para verificar la configuracin apropiada de su instancia SQL Server, necesitar las herramientas de
configuracin y herramientas cliente de SQL Server.
Las herramientas utilizadas para los siguientes pasos son SQL Server Management Studio y SQL Server
Configuration Manager.
Tenga en cuenta que ambas herramientas las puede instalar con la instalacin de la base de datos SQL
Server. En caso de que su base de datos no haya incluido estas herramientas, tambin puede
instalarlas y descargarlas desde las pginas oficiales de Microsoft (sin costo).

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:


El nombre oficial del producto y el service pack
El nmero exacto de versin y su fecha
Detalla adicional acerca de la edicin de SQL Server y bits soportados.

Revisando la configuracin
Revise o configure como se indica a continuacin.
1. Autenticacin tipo SQL Server
Ejecute el SQL Server Management Studio.
Conctese a su instancia, y d clic derecho sobre sta para seleccionar sus propiedades (properties):

Copyright 2014 - Bizagi

56

Luego, en las opciones de Seguridad, asegrese de est marcado Autenticacin SQL Server y
Windows.

Copyright 2014 - Bizagi

57

2. TCP/IP protocol
Ejecute el SQL Server Configuration Manager.

Copyright 2014 - Bizagi

58

En la instancia especfica de Base de datos (bajo SQL Server Network Configuration), habilite el
protocolo TCP/IP haciendo clic derecho sobre l, y seleccionando Habilitar:

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:

Copyright 2014 - Bizagi

59

En la misma configuracin a travs de SQL Server Configuration Manager, podr asegurarse tambin
de tener en un estatus de iniciado el servicio SQL Server Browser.

Si realiz cambios en esta configuracin, es posible que se deba reiniciar el servicio de la instancia.
Ntese que la configuracin anterior requiere que no hayan firewalls (cortafuegos) o bloqueos para
el puerto de servicio TCP de esa instancia.

Copyright 2014 - Bizagi

60

Para permitir conexiones remotas, en el tem Conexiones, revise la propiedad Permitir conexiones
remotas a este servidor:

3. Login de usuario autorizado


Ejecute SQL Server Management Studio y asegrese de estar conectado a su instancia con un login de
usuario con privilegios de administrador (p.e, con el login de usuario sa).
Con este usuario, verifique que el login de usuario que utilizar para Bizagi Studio cumpla lo siguiente:
El login de usuario debe usar autenticacin tipo SQL Server:

Copyright 2014 - Bizagi

61

Asegrese de que tenga el rol sysadmin:

Copyright 2014 - Bizagi

62

Verifique que este login de usuario est habilitado y permitido para conectarse, bajo sus opciones
de Status:

Copyright 2014 - Bizagi

63

Configuracin avanzada de usuarios SQL Server

Introduccin
Las polticas de seguridad en las compaas pueden a menudo restringir el uso del login sa que utiliza
Bizagi por defecto en instancias SQL Server (la cuenta de sper usuario con role sysadmin).
Debido a este motivo, presentamos cmo crear login de usuarios (inicio de sesin) en una instancia
SQL Server y configurarlos para trabajar con Bizagi.

Tipos de login de usuario


Los siguientes tipos se listan en un rden jerrquico, desde el login de usuario que tiene mayor
privilegio y abarca los dems, hasta el login de usuario que no puede realizar lo de los de arriba.
El login de usuario fundamental para la configuracin de la conexin en Bizagi Studio es el del
administrador de procesos.

Copyright 2014 - Bizagi

64

TIPO DE LOGIN
DE USUARIO /
PERFIL

PERMISOS

OBJETIVO / DESCRIPCIN

Administrador
del sistema
(opcional)

Rol de servidor:
sysadmin

Este login de usuario no es para uso de Bizagi Studio.

Administrador
de procesos

Analista de
procesos
(opcional)

El objetivo es utilizarlo para la administracin en SQL


Server de los otros login de usurio (p.e, para crear el
siguiente login), sin necesidad de utilizar las credenciales
del DBA.
Rol de servidor:
public
Permisos sobre la
base de datos
Master:
Crear BD, crear
backup de BD,
"grant view",
cualquier definicin.
Permisos sobre la
base de datos
Tempdb:
Crear, eliminar y
seleccionar tablas,
"grant view" cualquier
definicin.
Rol de servidor:
public
DB Owner de la
base de datos
especfica del
proyecto Bizagi.

Este login de usuario para Bizagi Studio se emplea en el


mismo servidor BPM donde se alberga el proyecto.
Esto con el fin de permitir mediante este login: crear o
actualizar proyectos Bizagi, y realizar deployments del
proyecto.

Este login de usuario para Bizagi Studio se emplea para


los analistas de proceso que deseen trabajar en el
proyecto a travs de sus estaciones de trabajo
(sobretodo, en una configuracin de trabajo
colaborativo). Los diferentes analistas de proceso
compartiran el mismo login de usuario.
Esto con el fin de permitir mediante este login trabajar
en la automatizacin de los procesos (modelar el
proceso, definir el modelo de datos, las interfaces de
usuario, reglas de negocio, etc).

Creando los login de usuario


Ejecute SQL Server Management Studio y asegrese de estar conectado a su instancia con un login de
usuario con privilegios de administrador (p.e, con el login de usuario sa).
Podr a partir de este, crear login de usuarios adicionales, de acuerdo a los perfiles involucrados en
su proyecto como se describe a continuacin.

Creando el login para el administrador del sistema (opcional)

Copyright 2014 - Bizagi

65

Cree un nuevo login de usuario que sea administrador del sistema, para no utilizar el login provisto
por defecto (sa).
Para hacerlo, ubique el tem de Seguridad y cree un login de usuario que cumpla lo siguiente:
El login de usuario debe usar autenticacin tipo SQL Server:

Asegrese de que tenga el rol sysadmin:

Copyright 2014 - Bizagi

66

Verifique que este login de usuario est habilitado y permitido para conectarse, bajo sus opciones
de Status:

Copyright 2014 - Bizagi

67

D clic en Ok.

Creando el login para el administrador de procesos


Use el login de usuario creado previamente (de administrador del sistema, o incluso el login de
usuario sa si no realiz este paso).
Ejecute el siguiente script para crear un login de usuario con privilegios para crear, actualizar o hacer
deployment de los proyectos:
/* Create login */
USE [master]
/* Create login */
IF EXISTS (SELECT * FROM sys.server_principals WHERE name =
N'process_admin_user')
DROP LOGIN [process_admin_user]
GO
CREATE LOGIN [process_admin_user] WITH PASSWORD=N'process_admin_password',

Copyright 2014 - Bizagi

68

DEFAULT_DATABASE=[master], CHECK_EXPIRATION=OFF, CHECK_POLICY=OFF


GO
ALTER LOGIN [process_admin_user] ENABLE
GO
/* Grant permission on server */
GRANT VIEW ANY DEFINITION TO [process_admin_user]
GO
/* Create user on master */
USE [master]
GO
IF EXISTS (SELECT name FROM sys.database_principals WHERE name =
'process_admin_user')
BEGIN
DROP USER [process_admin_user]
END
CREATE USER [process_admin_user] FROM LOGIN [process_admin_user]
GO
/* Grant permission on master */
GRANT CREATE DATABASE TO [process_admin_user]
GO
GRANT BACKUP DATABASE TO [process_admin_user]
GO
/* Create user on tempdb */
USE [tempdb]
GO
IF EXISTS (SELECT name FROM sys.database_principals WHERE name =
'process_admin_user')
BEGIN
DROP USER [process_admin_user]
END
CREATE USER [process_admin_user] FROM LOGIN [process_admin_user]
GO
/* Grant permission on tempdb */
GRANT ALTER TO [process_admin_user]
GO
GRANT CREATE TABLE TO [process_admin_user]
GO
GRANT SELECT TO [process_admin_user]
GO

Considere:
process_admin_user: El nombre que desee dar a su login de usuario.
process_admin_password: La contrasea que desee dar a ese login de usuario.
Para verificar que este login de usuario haya sido creado adecuadamente con los permisos necesarios,
ejecute:
use [master]
exec sp_helprotect NULL, 'process_admin_user'

Copyright 2014 - Bizagi

69

use [tempdb]
exec sp_helprotect NULL, 'process_admin_user'

Deber ver lo siguiente:

En este punto, el login de usuario ha sido creado.


Tenga en cuenta que el objetivo de este login es para configurarlo en la conexin desde el Bizagi
Studio instalado en su servidor BPM (p.e al crear el proyecto).

Creando el login para los analistas de proceso (opcional)


Use el login de usuario de administrador del sistema, o incluso el login de usuario sa si no realiz el
primer paso.
Ejecute el siguiente script para crear un login de usuario con privilegios para abrir el proyecto y
trabajar en l:
/* Create login */
USE [master]
GO
IF EXISTS (SELECT * FROM sys.server_principals WHERE name =
N'proc_analyst')
DROP LOGIN [proc_analyst]
GO
CREATE LOGIN [proc_analyst] WITH PASSWORD=N'proc_analyst_password',
DEFAULT_DATABASE=[master], CHECK_EXPIRATION=OFF, CHECK_POLICY=OFF

Copyright 2014 - Bizagi

70

GO
ALTER LOGIN [proc_analyst] ENABLE
GO
/* Grant permission on server */
GRANT VIEW ANY DEFINITION TO [proc_analyst]
GO
/* Deny view other databases */
DENY VIEW ANY DATABASE TO [proc_analyst]
Considere:
proc_analyst: El nombre que desee dar a su login de usuario.
proc_analyst_password: La contrasea que desee dar a ese login de usuario.

Para verificar que este login de usuario haya sido creado adecuadamente con los permisos necesarios,
ejecute:
use [master]
exec sp_helprotect NULL, 'proc_analyst'

Deber ver lo siguiente:

En este punto, el login de usuario ha sido creado.


Tenga en cuenta que el objetivo de este login es para configurarlo de manera uniforme, en la conexin
desde el Bizagi Studio instalado en las estaciones de trabajo de los analistas de proceso, para la
automatizacin de procesos en el proyecto.

Importante
Asegrese de tener en cuenta las siguientes consideraciones:
1. DBOwnership, al login del analista de proceso sobre la BD especfica
Si crea un login de usuario para su analista de proceso, deber ejecutar el siguiente script despus de
la creacin del proyecto, para asegurarse que dicho login se configure como dueo de la base de

Copyright 2014 - Bizagi

71

datos (database owner) de ese proyecto de Bizagi:


use [your_Bizagi_database]
exec sp_changedbowner 'proc_analyst'

2. Consideracin sobre Tempdb al reiniciar la instancia


Cuando se reinicie una instancia de base de datos, tenga en cuenta que las definiciones sobre la base
de datos de SQL llamada tempdb, sern reiniciadas.
Por lo tanto, para el login de usuario del administrador de procesos, deber volver a ejecutar la parte
del script que crea una definicin sobre tempdb:
/* Create user on tempdb */
USE [tempdb]
GO
IF EXISTS (SELECT name FROM sys.database_principals WHERE name =
'process_admin_user')
BEGIN
DROP USER [process_admin_user]
END
CREATE USER [process_admin_user] FROM LOGIN [process_admin_user]
GO
/* Grant permission on tempdb */
GRANT ALTER TO [process_admin_user]
GO
GRANT CREATE TABLE TO [process_admin_user]
GO
GRANT SELECT TO [process_admin_user]
GO
De lo contrario, este login no podr crear proyectos, o actualizar y realizar deployments de un
proyecto.
3. Conexiones no autorizadas
Cuando la configuracin de Bizagi Studio utilice un login de usuario que no tenga permisos para
realizar cierta tarea (p.e al hacer deployment), tendr la opcin de redefinir la cuenta involucrada para
su instalacin de Bizagi Studio.
Usted puede hacer esto desde la consola mostrada cuando se intente utilizar una funcin que requiera
credenciales autorizadas, o desde la opcin de configurar la conexin de base de datos.

Oracle - requisitos

Introduccin
Bizagi Studio requiere de una instancia de base de datos para el repositorio de sus procesos.
Oracle es soportado como motor de base de datos para este fin.

Versiones y ediciones soportadas


Bizagi soporta las siguientes versiones:

Copyright 2014 - Bizagi

72

VERSIN

NMERO

Oracle 11g R2

11.2.0.1 o superior

Oracle 10g R2

10.2.0.1 o superior

Las ediciones soportadas son la Estndar y la Enterprise (la edicin Express de Oracle XE no est
soportada).

La instancia debe tener un set de caracteres (NLS_CHARACTERSET) que no sea Unicode (se soporta
una configuracin de single-byte).
Para mayor informacin sobre los set de caracteres que no sean de multiple byte, consulte la
documentacin oficial de Oracle.

Configuracin requerida
Para configurar una instancia de Oracle para trabajar con Bizagi, se requiere lo siguiente:
1. Crear un usuario especfico que utiliza Bizagi.
Necesitar crear el usuario que utiliza Bizagi en su instancia de Oracle, sea por medio de las opciones
al momento de crear un proyecto en Bizagi Studio, o ejecutando un script.
Este usuario se conoce como el usuario BizagiAdmon.
2. Instalar el componente ODP.NET desde donde se instala Bizagi Studio.
Bizagi Studio utiliza el conector Oracle Data Provider para .NET para acceder a una base de datos
Oracle.
Este componente no se requiere en el servidor de base de datos sino donde los proyectos de Bizagi
(o sus componentes) se ejecutan.
Cuando un proyecto est en fase de automatizacin, esto significa que deber instalar el conector
Oracle Data Provider para .NET donde tenga instalado Bizagi Studio, sea si usa una base de datos
Oracle para el repositorio de los procesos o si est integrando una fuente externa en Oracle al
proyecto de Bizagi (uso de Virtualizacin o Replicacin de datos).

Verificando la configuracin en Oracle


Lleve a cabo los siguientes pasos, para asegurarse de que su instancia de Oracle tenga la
configuracin requerida.

Qu versin tengo?
Usted puede verificar la versin de base de datos Oracle y release ejecutando:
select * from v$version;
Si utiliza Oracle 11g R2, deber asegurarse de tener una versin 11.2.0.3.x o superior:

Copyright 2014 - Bizagi

73

Si utiliza Oracle 10g R2, deber asegurarse de tener una versin 10.2.0.1.x o superior:

Revisando la configuracin
Revise o configure como se indica a continuacin.
1. Crear un usuario especfico que utiliza Bizagi.
Bizagi se apoya en un usuario en Oracle para realizar tareas de administracin y del proyecto (p.e,
para crear la metadata y estructura inicial de un proyecto de Bizagi, para crear backups, etc).
Este usuario se conoce como BizagiAdmon y su creacin es prerrequisito para trabajar con una base
de datos Oracle.
Usted puede optar por que Bizagi cree de manera automtica este usuario, o ejecutar un script SQL
para crearlo.
Para un inicio rpido donde opte por que Bizagi cree de manera automtica este usuario, asegrese
de especificar las credenciales del usuario sys (sysdba) al momento de crear el proyecto Bizagi.
Para mayor informacin sobre esta posibilidad, consulte Crear un proyecto utilizando Oracle.
Para crear el usuario ejecutando un script SQL, siga estas instrucciones:

Copyright 2014 - Bizagi

74

1.1 Conctese a su instancia de Oracle como el usuario sys (sysdba)

1.2 Edite el script ConfigureInstanceForBizAgi-[Oracle_Version].sql.


Ubique la ruta de instalacin de Bizagi Studio y dentro de esta, la ruta del modelo de proyecto donde
est la carpeta de archivos de base de datos (por defecto en C:\Archivos de programa\BizAgi
\ProjectModel\Database\).
Si usted utiliza Oracle 11g R2, edite el script llamado ConfigureInstanceForBizAgi-11g.sql.
Si usted utiliza Oracle 10g R2, edite el script llamado ConfigureInstanceForBizAgi-10g.sql.
Para editar este script, asegrese de remover las lneas comentareadas que definen las variables, y
seguidamente edite sus valores:
BA_TABLES_DATAFILES_DIR: La ruta donde Bizagi crear los datafiles de los tablespaces.
BA_INDEXES_DATAFILES_DIR: La ruta donde Bizagi crear los datafiles de los ndices.
BA_BACKUP_PATH: La ruta donde Bizagi almacenar los respaldos (backups).
BA_BIZAGIADMON_PASSWORD: La contrasea para el usuario BizagiAdmon.

Copyright 2014 - Bizagi

75

1.3 Ejecute el script.


Ejecute el script asegurndose que la operacin sea existosa.

El script anterior puede cambiar en cada versin de Bizagi.


Por lo tanto, siempre debe tomar el script en cuestin que corresponda a la versin instalada de
Bizagi.

2. Instalar el componente ODP.NET desde donde se instala Bizagi Studio


Para instalar el componente para la conexin, siga estas instrucciones:

2.1 Escoger el instalador adecuado

Copyright 2014 - Bizagi

76

El conector Oracle Data Provider para .NET se instala a travs de los componentes para el acceso de
datos a Oracle (ODAC).
Bizagi utiliza la versin ODAC 11g, la cual puede ser descargada directamente desde el sitio oficial de
Oracle.
Si su proyecto utiliza una versin de Bizagi con soporte a 64 bits, descargue la versin 11.2.0.3.0 x64
para el framework 4.0, desde:
http://www.oracle.com/technetwork/database/windows/downloads/index-090165.html
Si su proyecto utiliza una versin de Bizagi con soporte a 32 bits, descargue la versin 11.1.0.7.20
32-bits para el framework 4.0, desde:
http://www.oracle.com/technetwork/developer-tools/visual-studio/downloads/index.html

2.2 Instalar ODAC y su conector ODP.NET


Ejecute el instalador donde tenga instalado Bizagi Studio, y asegrese de seleccionar la opcin Oracle
Data Access Components for Oracle Client :

Seguidamente, asegrese de marcar Oracle-Data-Provider for .NET:

Copyright 2014 - Bizagi

77

D clic en Instalar para completar el procedimiento.


Una vez completado, ser notificado que puede cerrar el instalador.
Vea mayor informacin sobre este conector, e instrucciones detalladas del ODAC en: http://
www.oracle.com/technology/software/tech/windows/odpnet/install1110720.html.

2.3 Repita la instalacin en otras mquinas, segn aplique


Cuando se configura un entorno de trabajo colaborativo, los usuarios de Bizagi Studio tambin
debern instalar este conector en sus estaciones de trabajo.
Este conector tambin es necesario si se utiliza la Virtualizacin o Replicacin de datos como
caractersticas de integracin en Bizagi, para conectar el proyecto a una fuente externa de Oracle.

Ntese que:
El servidor de base de datos no requiere de este componente.
No 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.

Copyright 2014 - Bizagi

78

Servidor BPM - requisitos

Introduccin
Bizagi presenta un Portal de trabajo donde los usuarios hacen login para trabajar en sus procesos de
negocio. A medida que el proceso de construccin se lleva a cabo, este entorno de ejecucin, o Portal
de Trabajo, refleja en tiempo real todos los cambios realizados en Bizagi Studio.
Este Portal de trabajo es una aplicacin web (solo requiere de un navegador), la cul es albergada en
una instancia de servidor web.
La mquina donde se alberga el Portal de trabajo se conoce como el servidor BPM.
Bizagi Studio utiliza este servidor web para que pueda poner en marcha el Portal de Trabajo en
cualquier momento, tal y como se ve y se pone a disposicin de los usuarios finales en un entorno de
trabajo.
Bizagi Studio genera automticamente el Portal de Trabajo y proporciona este entorno de ejecucin
para sus procesos automatizados, para que usted pueda llevar a cabo la creacin de prototipos y
pruebas rpida.
Las plataformas de aplicacin soportadas para instalarse en el servidor web son:
Microsoft Internet Information Services (para la ejecucin sobre plataforma .NET).
WebSphere (para la ejecucin sobre plataforma JEE).
Weblogic (para la ejecucin sobre plataforma JEE).
JBoss Enterprise Application Platform (para la ejecucin sobre plataforma JEE).

Bizagi Studio utiliza esta instancia de servidor web para que en cualquier momento se pueda
visualizar el portal de trabajo, justo como se disponibilizar a los usuarios finales en un ambiente
productivo.
Bizagi Studio genera de manera automtica el portal de trabajo y provee este entorno de ejecucin
para que usted pueda ver el prototipo y hacer pruebas rpidas sobre sus procesos.

Inicio rpido
Para utilizar las opciones de inicio rpido con Bizagi, usted podr utilizar una instancia de IIS Express
incluida en la instalacin de Bizagi Studio.
Para ello, no se requiere de configuracin adicional y podr omitir los siguientes captulos sobre los
requisitos del servidor web.
Si desea ver informacin sobre los requerimientos de Bizagi Studio, consulte Bizagi Studio
requerimientos de sistema.

Otras opciones
Si desea configurar un entorno para el trabajo colaborativo, asegrese de llevar a cabo la
configuracin e instalacin del IIS, como se describe en los siguientes captulos.
Para ejecutar sus procesos en una plataforma JEE, requerir de Bizagi JEE Plugin, el cul incluye un

Copyright 2014 - Bizagi

79

JBoss EAP preconfigurado y listo para utilizarse.


Mayor informacin sobre la ejecucin sobre una plataforma JEE, se presenta en los siguientes
captulos.

Configuracin del IIS

Introduccin
Bizagi Studio requiere un servidor web para la ejecucin de los procesos.
Microsoft Internet Information Services (IIS) se soporta como el servidor web que se configura para
albergar estos procesos en una plataforma .NET.

Versiones soportadas
Las siguientes versiones son soportadas:
VERSIN IIS

SISTEMA OPERATIVO

8.5

Windows Server 2012, Windows 8.1

8.0

Windows Server 2012, Windows 8

7.5

Windows Server 2008 R2, Windows 7

7.0

Windows Server 2008, Windows 7, Windows Vista

6.0

Windows Server 2003, Windows XP

Configuracin requerida
Para configurar el IIS para trabajar con Bizagi, deber habilitarlo en su sistema operativo y asegurarse
de habilitar tambin las siguientes caractersticas propias del IIS:
GRUPO DE
CARACTERSTICAS

CARACTERSTICA DEL IIS

APLICA PARA...

Web Management Tools

IIS 6 Metabase compatibility

IIS versions 7 o superior.

IIS Metabase and IIS 6


configuration compatibility

IIS versions 7 o superior.

IIS Management Console

IIS versions 7 o superior.

.NET Extensibility

IIS versions 7 o 7.5.

.NET Extensibility 4.5

IIS versions 8 o superior.

ASP.NET

IIS versions 7 o 7.5.

World Wide Web Services

Copyright 2014 - Bizagi

80

ASP.NET 4.5

IIS versions 8 o superior.

Common HTTP Features

Static Content

IIS versions 7 o superior.

Performance Features

Static Content Compression

IIS versions 7 o superior, para


mejoras de rendimiento.

Dynamic Content Compression

IIS versions 7 o superior, para


mejoras de rendimiento.

Windows authentication

IIS versions 7 o superior, al utilizar


autenticacin tipo Windows.

Security

Verificar la configuracin del IIS


Siga las instrucciones para verificar una correcta instalacin y configuracin del IIS para trabajar con
Bizagi.
Consulte la seccin que corresponda a su sistema operativo.

Windows Server 2012


Windows Server 2012 trabaja con Internet Information Services en su versin 8.5 o 8.0.
Para revisar la instalacin del servidor y los componentes que requiere Bizagi, siga los pasos a
continuacin.
1. Ubique 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 Mi PC y sobre
el cono de acceso rpido:

Copyright 2014 - Bizagi

81

Ntese que para ello, se requiere de permisos de administrador.


2. En la ventana de administracin (Server Manager), ubique la opcin rpida desde el Dashboard y
utilice Adicionar roles y caractersticas (Add Roles and features).
Esta opcin inicia un asistente para configurar el IIS seleccionando los tems y componentes.
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. Seleccione Role-based or feature-based installation y d clic en Siguiente (Next).

Copyright 2014 - Bizagi

82

4. Utilice la opcin de seleccionar el servidor Web desde el pool (Select the Web Server from the
server pool), de manera que se ubique el servidor local para la instalacin y se adicionen los roles
requeridos.

Copyright 2014 - Bizagi

83

D clic en Siguiente (Next).


5. Marque la opcin del Servidor Web (IIS) para que los componentes del IIS se muestren a
continuacin.
Esto permite la adicin de sus roles.

Copyright 2014 - Bizagi

84

D clic en Siguiente (Next).


Ntese que para marcar algunos componentes, se requiere la adicin de algunas caractersticas.
Para ello, el asistente le avisar, y debe asegurarse de adicionar los requerimientos (haciendo clic en
Adicionar caractersticas).

Copyright 2014 - Bizagi

85

Asegrese de marcar las casillas como se ensea a continuacin:

Copyright 2014 - Bizagi

86

Copyright 2014 - Bizagi

87

D clic en Siguiente y revise la configuracin general de roles del servidor Web. Clic en Siguiente.
6. Confirme la seleccin de configuracin para la instalacin.
D clic en Finalizar (Finish) para iniciar con la instalacin:

Una vez finalizada la instalacin, una ventana mostrar el xito del procedimiento y qu roles y
servicios fueron instalados.
Note que el enlace de exportar la configuracin le permite opcionalmente reutilizar esta configuracin
a travs de PowerShell en otro equipo.

Copyright 2014 - Bizagi

88

Haga clic en Cerrar (Close).

Windows 8.1 o Windows 8


Windows 8.1 incluye Internet Information Services en su versin 8.5.
Windows 8 incluye Internet Information Services en su versin 8.0.
En estos sistemas operativos, la instalacin del IIS no se incluye por defecto, por lo 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 d clic en Habilitar/deshabilitar
componentes de Windows.

Copyright 2014 - Bizagi

89

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,

Copyright 2014 - Bizagi

90

Copyright 2014 - Bizagi

91

3. D clic en OK para finalizar la configuracin.


Ntese que esto puede tardar algunos minutos, estos cambios muy posiblemente requieran reiniciar la
mquina.

Windows Server 2008 R2 o Windows Server 2008


Windows Server 2008 y Windows Server 2008 R2 incluyen Internet Information Services en su versin
7.5.
En estos 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 Mi PC. Ntese
que para ello, se requiere de permisos de administrador.

2. En la ventana de administracin del Servidor, ubique el tem de roles, y seleccione la opcin de


Adicionar Roles.

Copyright 2014 - Bizagi

92

Esta opcin inicia un asistente para configurar el IIS seleccionando los tems y componentes.

Copyright 2014 - Bizagi

93

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 Siguiente.


En la siguiente ventana se muestra la informacin general del IIS, donde no se requiere accin alguna.
Haga clic en Siguiente cuando haya revisado la informacin.

Copyright 2014 - Bizagi

94

4. Seleccione los servicios de rol requeridos por Bizagi para el componente del servidor Web (IIS).

Copyright 2014 - Bizagi

95

Copyright 2014 - Bizagi

96

Haga clic en Siguiente despus de asegurarse que haya marcado todos los componentes y subcomponentes necesarios.
Ntese que para marcar algunos componentes, se requiere la adicin de algunos roles.
Asegurarse de adicionar los requerimientos de estos roles (haciendo clic en Adicionar los servicios de
roles requeridos).

5. Una ventana de confirmacin aparece con el resumen de los roles y servicios que se instalarn.

Copyright 2014 - Bizagi

97

Una vez que proceda y d 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 o Windows 7


Windows Vista y Windows 7 incluyen Internet Information Services en su versin 7.0.
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 men izquierdo, y d clic en
Habilitar/deshabilitar componentes de windows.

Copyright 2014 - Bizagi

98

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,

Copyright 2014 - Bizagi

99

3. D clic en OK para finalizar la configuracin.

Copyright 2014 - Bizagi

100

Ntese que esto puede tardar algunos minutos, estos cambios muy posiblemente requieran reiniciar la
mquina.

Windows Server 2003 o Windows XP


Windows Server 2003 y Windows XP no incluyen por defecto el IIS.

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 Agregar o remover programas.
En esta ventana, seleccione Adicionar/remover componentes de Windows desde el botn del panel a
la izquierda.

2. Se muestra una nueva ventana donde los componentes de Windows adicionales pueden ser
seleccionados.
Seleccione el componente Servidor de aplicacin en la ventana donde se listan los componentes a
instalar. D clic en Detalles.

Copyright 2014 - Bizagi

101

3. Marque la casilla de IIS.

Copyright 2014 - Bizagi

102

D clic en OK y despus en Siguiente para iniciar la instalacin.


4. Una vez se complete la instalacin, el sistema le notificar que debe reiniciar el equipo.

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, d clic derecho sobre su directorio virtual (de la aplicacin) y seleccione las propiedades.
En IIS 6, d 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.
D clic en el botn de configuracin.
La pestaa para el mapeo a nivel de aplicaciones debe estar visible.
D 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).
D clic en Ok en ambos dilogos para retornar al administrador del IIS (IIS Manager). Hemos
finalizado los cambios.
Ejecute un iisreset

Importante
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. Si se instala el IIS despus de haber instalado Bizagi (el servicio Server Operations Service), entonces
deber reinstalar dicho servicio o ejecutar los siguientes comandos:

%systemroot%\system32\inetsrv\APPCMD
httpCompression
%systemroot%\system32\inetsrv\APPCMD
serverRuntime

unlock

config

-section:system.webServer/

unlock

config

-section:system.webServer/

Copyright 2014 - Bizagi

103

3. El IIS debe tener el sitio por defecto llamado Default Web site, ya que all Bizagi crear el Portal de
Trabajo para los proyectos.

Plataforma JEE

Introduccin
Bizagi soporta la ejecucin de procesos en una plataforma .NET o una JEE.
Para una configuracin de inicio rpido y por defecto sin necesidad de configuracin adicional, Bizagi
Studio le permite llevar a cabo prototipos giles y pruebas sobre los procesos automatizados en una
plataforma .NET.
Sin embargo, usted podr fcilmente descargar e instalar Bizagi JEE Plugin para la automatizacin de
procesos directamente sobre una plataforma JEE.
Bizagi JEE Plugin incluye un JBoss Enterprise Application Platform embebido (y un JDK), preconfigurado
y listo para trabajar con Bizagi.
De esta manera usted podr en cualquier momento iniciar el Portal de trabajo de Bizagi como una
aplicacin JEE, justo como ser presentado a los usuarios finales en un ambiente de produccin.

Antes de continuar
Asegrese de consultar los siguientes captulos sobre la instalacin de Bizagi Studio.
Para utilizar una plataforma JEE, igualmente deber antes instalar Bizagi Studio de manera regular, y
luego instalar Bizagi JEE Plugin.
Para mayor informacin sobre cmo instalar Bizagi Studio consulte la Instalacin y configuracin de
Bizagi Studio.

Bizagi Studio - instalacin


Dnde instalar Bizagi Studio?
Instale Bizagi Studio en su mquina para una configuracin de inicio rpido, til para conseguir
resultados rpidos para demos, evaluacin de producto o prototipos.
Para mayor informacin consulte Configuracin de inicio rpido
Si usted desea tener mltiples usuarios trabajando simultneamente en los mismos procesos, siga la
configuracin de colaboracin de equipo de trabajo.
Tenga en cuenta que usted puede mover fcilmente su proyecto, en cualquier momento, desde la
configuracin de inicio rpido a la configuracin colaborativa.
Para mayor informacin consulte Teamwork collaboration setup.

Copyright 2014 - Bizagi

104

Instalacin y configuracin de inicio rpido

Antes de empezar
Asegrese de que su mquina cumple con los requisitos presentados en requerimientos del sistema.
Tenga en cuenta que para instalar Bizagi con soporte nativo de 64 bits, usted necesitar tener un
sistema operativo de 64 bits instalado.

Instalacin de Bizagi Studio


Para instalar Bizagi Studio, siga los pasos descritos a continuacin:
1. Descargue una copia gratuita y totalmente funcional de Bizagi Studio.
Puede descargarla desde nuestro sitio oficial en http://www.bizagi.com.
2. Ejecute el instalador con permisos de administracin.

Copyright 2014 - Bizagi

105

Seleccione el idioma para la instalacin (ingls o espaol)

3. Cuando la ventana de Bienvenida del instalador se abra, haga clic en Siguiente.

Copyright 2014 - Bizagi

106

4. Revise el acuerdo de la licencia de Bizagi Studio y haga clic en Siguiente.

Copyright 2014 - Bizagi

107

5. Seleccione la base de datos a utilizar.


La instalacin detectar si ya tiene SQL Server instalado.
Si este no es su caso y usted no cuenta con SQL Server, seleccione la opcin para incluir una
instalacin de SQL Server Express 2008 Service pack 3 (seleccionando "Instalar SQL Server Express
2008 SP3").

Cuando se incluya el SQL Server Express 2008 SP3, las credenciales por defecto para acceder el
servidor son:
LOGIN: sa
PASSWORD: Bizagi10GO

Copyright 2014 - Bizagi

108

Por otro lado si usted ya tiene un SQL Server instalado, seleccione la opcin "Ya tengo un Servidor
SQL".
Con dicha opcin, ingrese el Nombre de Usuario y la contrasea (autenticacin SQL Server) para esta
conexin, en la ventana emergente. Despus de ingresar la informacin, d clic en Login para verificar
la conexin.

Copyright 2014 - Bizagi

109

Note 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.
6. Haga clic en Siguiente si desea instalar Bizagi en su ruta predeterminada ("C:\Program Files\...")
De otra manera y para seleccionar una ubicacin diferente de la carpeta, haga clic en Buscar, y
seleccione la carpeta de su preferencia.

Copyright 2014 - Bizagi

110

7. 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
Comprobar si hay actualizaciones y haga clic en Siguiente.

Copyright 2014 - Bizagi

111

8. Inicie el proceso de instalacin


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

Copyright 2014 - Bizagi

112

Bizagi instalar los componentes requeridos como: Framework 4.0 de .NET y Visual C++ 2010, 2008
Redistributable, si no se encuentran instalados previamente.
La siguiente ventana aparecer cuando la instalacin haya terminado.

Copyright 2014 - Bizagi

113

Clic en el botn Finalizar.


Observe que esta instalacin puede requerir el reinicio del equipo (de ser notificado por su sistema).

Qu sigue?
Usted podr empezar a utilizar Bizagi Studio usando la opcin de Iniciar Bizagi Studio, o desde los
accesos directos.

Copyright 2014 - Bizagi

114

Para empezar, cree un proyecto nuevo de Bizagi como se describe en Proyectos Bizagi.

Nunca instale una versin de Bizagi Enterprise .NET o Bizagi Enterprise JEE en un servidor donde
exista previamente una instalacin de Bizagi Studio 10.5 o superior. Esto causar daos a los
archivos de instalacin.

Instalacin de plataforma JEE

Introduccin
Bizagi soporta la ejecucin en una plataforma .NET o JEE.
Para opciones de inicio rpido y por defecto, Bizagi Studio permite probar la ejecucin de los
procesos y visualizar sus prototipos al realizar la implementacin sobre una plataforma .NET.
Sin embargo, tambin puede fcilmente descargar e instalar Bizagi JEE Plugin, para automatizar sus

Copyright 2014 - Bizagi

115

procesos y probarlos directamente en una plataforma JEE.


Bizagi JEE Plugin incluye una instancia embebida de JBoss Enterprise Application Platform (y un JDK),
pre-configurada y lista para trabajar con Bizagi, de manera que en cualquier momento pueda lanzar el
portal de trabajo de Bizagi como una aplicacin JEE.
Justo como ser disponible para los usuarios finales en un ambiente productivo.

Antes de continuar
Asegrese de tener instalado Bizagi Studio, como se describe en Instalacin de Bizagi Studio.
Necesitar una instalar Bizagi Studio para empezar, y despus instalar el Bizagi JEE Plugin.
La instalacin de este plugin se realiza al momento de crear un proyecto de Bizagi para plataforma
JEE.
Para mayor informacin sobre cmo instalar Bizagi JEE Plugin, consulte la Creacin de proyecto en la
plataforma JEE.

Proyectos Bizagi
Para automatizar sus Procesos organizacionales usted primero necesita crear un proyecto Bizagi.
Un proyecto de Bizagi cumple con estas caractersticas:
1. Puede incluir tantos procesos como sea necesario.
2. El proyecto crear automticamente:
El repositorio de procesos:
Una base de datos donde se almacenan los procesos y los detalles de su implementacin.
El Portal de trabajo para el ambiente de desarrollo.
Una aplicacin web de Bizagi donde se hace login y se trabaja en los procesos, presentado tal y como
ser el portal para los usuarios finales en el ambiente de produccin.
El Portal de trabajo de Bizagi para el ambiente de desarrollo lo incluye Bizagi Studio para poder
realizar prototipos giles, y pruebas mientras se automatizan los procesos.
El servicio programador (Scheduler).
Un agente que ejecuta Bizagi como un servicio para ejecutar tareas de mantenimiento del sistema, y
otras tareas offline y asncronas que usted puede programar.

Crear un nuevo proyecto

Introduccin
Cree un nuevo proyecto Bizagi para iniciar con la automatizacin de sus Procesos.

Copyright 2014 - Bizagi

116

Este proyecto se ejecutar en una plataforma .NET


Si usted desea ejecutar este proyecto en una plataforma JEE, consulte Crear un proyecto en la
plataforma JEE.

Crear el proyecto
Siga estos pasos:

1. Utilice la opcin Nuevo proyecto en Bizagi.


Haga clic directamente en el enlace Nuevo, al abrir Bizagi Studio.

Tenga en cuenta que para crear un proyecto, su cuenta debe pertenecer tanto al grupo local Bizagi,
como al grupo de Administradores (donde se encuentre instalado Bizagi Studio).

Copyright 2014 - Bizagi

117

Si su cuenta no posee estos permisos, entonces podr ingresar las credenciales de una cuenta
autorizada que s cumpla con stas condiciones:

2. Ingrese los detalles de su proyecto.


Asegrese de nombrar su proyecto y definir su ubicacin.
Usted puede habilitar el cuadro de Configuracin Avanzada para especificar detalles del servidor de

Copyright 2014 - Bizagi

118

Base de datos utilizado por su nuevo proyecto.


Para una configuracin de inicio rpido, usted puede ignorar la configuracin avanzada y dejar sta
casilla de marcacin deshabilitada.

Haga clic en Siguiente.

3. Ingrese los detalles del servidor de Base de datos.


Si usted seleccion la Configuracin avanzada, asegrese de especificar dnde desea establecer su
repositorio de procesos.
Observe que la Base de datos puede ser almacenada en el computador local o un servidor remoto.
Si usted utiliz la configuracin de inicio rpido durante la instalacin de Bizagi Studio, podr utilizar el
servidor de Base de datos SQL que Bizagi instala.
Esta Base de datos es detectada automticamente, para lo cual solo necesita ingresar las credenciales
de conexin por defecto, que son:
Nombre de Usuario: sa
Contrasea: Bizagi10GO

Copyright 2014 - Bizagi

119

Si usted utiliza el servidor de Base de datos SQL que Bizagi Studio instala (o una instancia local),
asegrese de que cuenta con al menos 300 MB de espacio libre en su unidad de disco C:\.
De lo contrario, cuando utilice un servidor de Base de datos SQL (en una mquina remota)
asegrese de que se cuenta con al menos 300 MB de espacio de disco libre en ese servidor.
Si usted desea utilizar un servidor de Base de datos SQL diferente, 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.
Soporte Unicode: Asegrese de que este cuadro se encuentre habilitado para permitir el soporte de
caracteres unicode en su Base de datos.
Haga clic en Siguiente.
Bizagi iniciar la creacin del proyecto, que puede tardar unos minutos.
Una vez el proyecto ha sido creado, Bizagi Studio se abrir para iniciar la automatizacin de sus
Procesos.
Si usted desea crear un proyecto en una Base de datos de Oracle, consulte Cmo crear un proyecto en
Oracle

Copyright 2014 - Bizagi

120

Crear un proyecto utilizando Oracle

Introduccin
Este artculo sirve de gua para la creacin de un proyecto de Bizagi en una Base de datos Oracle.
Si usted utiliza SQL Server, consulte Crear un nuevo proyecto.

Prerrequisitos
Para crear un proyecto de Bizagi en una base de datos Oracle, primero debe asegurarse de cumplir
con los requisitos de configuracin de Bizagi para trabajar con una instancia de Oracle.
En este paso deber tener en cuenta que se requiere instalar el Proveedor de conexin Oracle
(ODP.NET) donde tenga instalado Bizagi Studio.
Este componente es requerido para la conexin a la Base de datos desde Bizagi Studio,
independientemente de la plataforma donde se ejecuten los procesos.
Si desea ver los requisitos y la configuracin previa de Oracle para trabajar con Bizagi, consulte
Requisitos de Base de datos Oracle

Crear el proyecto
Una vez que ha creado su instancia de Oracle configurada para trabajar con Bizagi (teniendo los
requisitos validados y habiendo creado el usuario BizagiAdmon en su instancia de Oracle), la creacin
de proyectos nuevos se realiza de la siguiente manera:

Si usted desea que este proyecto corra en una plataforma JEE, asegrese de que ya ha instalado el
plug-in de Bizagi JEE, como se describe en Crear un proyecto en la plataforma JEE.
1. Use la opcin Nuevo en Bizagi.
Usted puede hacer clic sobre esta opcin directamente al abrir Bizagi Studio:

Copyright 2014 - Bizagi

121

Tenga en cuenta que para crear un proyecto, su cuenta debe pertenecer tanto al grupo local Bizagi,
como al grupo de Administradores (donde se encuentre instalado Bizagi Studio).

Copyright 2014 - Bizagi

122

Si su cuenta no posee estos permisos, entonces podr ingresar las credenciales de una cuenta
autorizada que s cumpla con stas condiciones:

2. Ingrese los detalles de su proyecto.


Asegrese de nombrar su proyecto y definir su ubicacin.
Luego habilite la opcin de Configuracin de base de datos avanzada:

Copyright 2014 - Bizagi

123

Haga clic en Siguiente.


3. Configure la Base de datos Bizagi.
Seleccione Oracle e ingrese: los detalles de conexin de la instancia y la informacin para este nuevo
proyecto.
Los detalles de conexin incluyen la informacin de la instancia de Oracle (Servicio), y la contrasea
para el usuario BizagiAdmon (segn lo especificado en su como prerrequisito en su creacin).
La informacin para este nuevo proyecto muestra cmo se nombrar el proyecto (este ser un nuevo
usuario en su instancia de Oracle), y solicitar una contrasea y confirmacin para este nuevo proyecto:

Copyright 2014 - Bizagi

124

Haga clic en Siguiente.


Observe que el servicio de la instancia de Oracle se especifica como: "ServidorBaseDeDatos:puerto/
NombreServicio", y que no es necesario habilitar la opcin Comprobar si el usuario BizagiAdmon no
est creado.
Haga clic en Siguiente.

Consideraciones
Usted puede usar la opcin Comprobar si el usuario BizagiAdmon no est creado para que Bizagi cree
el usuario BizagiAdmon automticamente por usted (si usted no lo ha hecho al momento de configurar
su instancia de Oracle).

Copyright 2014 - Bizagi

125

Si lo hizo, en la siguiente ventana (Configurar la instancia de Oracle), seleccione la opcin para que
Bizagi cree el usuario BizagiAdmon automticamente.
Seguidamente, ingrese el detalle de la conexin del usuario "sys" de su instancia de Oracle:

Copyright 2014 - Bizagi

126

Observe que el servicio de la instancia de Oracle se especifica como: "ServidorBaseDeDatos:puerto/


NombreServicio".
Haga clic en Siguiente y luego ingrese y confirme la contrasea que ser utilizada para: el usuario
BizagiAdmon, y para el proyecto a crear.

Copyright 2014 - Bizagi

127

Haga clic en Siguiente.


En la ventana Defina rutas y archivos de datos en Bizagi, especifique rutas vlidas para la creacin de
los archivos que va a manejar Bizagi:

Copyright 2014 - Bizagi

128

Observe 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).

Es realmente importante que estas rutas definidas cuenten por lo menos con 300 MB de espacio
inicial disponible para que Bizagi cree los datafiles del proyecto. De lo contrario, la creacin del
proyecto no podr realizarse por Oracle.
Haga clic en Siguiente para iniciar la configuracin de la instancia, y la creacin del proyecto.

Crear un proyecto en la plataforma JEE

Introduccin
Con Bizagi tendr la posibilidad de escoger si desea crear el proyecto con un Portal de trabajo
configurado sobre una plataforma JEE (usando JBoss como servidor de aplicaciones).
Tenga en cuenta que una vez que cree un proyecto en una determinada plataforma (JEE o .NET), no
podr cambiar ese proyecto para su ejecucin en la otra plataforma.

Copyright 2014 - Bizagi

129

Es decir, los proyectos que se crean para ejecucin sobre .NET no se ejecutarn en una plataforma
JEE, y viceversa.

Antes de comenzar
Para crear el proyecto sobre una plataforma JEE, se requiere instalar Bizagi JEE Plugin.
Si no cuenta con el plugin de antemano, necesitar conexin a internet para descargarlo desde
bizagi.com como se ilustra en los siguientes pasos.

Bizagi JEE Plugin en detalle


Bizagi JEE Plugin se encuentra disponible para la descarga a travs de 2 archivos distribubles:
Para sistemas de 64 bits, el plugin se descarga como un archivo zip, que contiene el nombre de la
versin de Bizagi Studio correspondiente, y los bits que soporta. Por ejemplo para la versin 10.5 es:
10.5.0.2030_x64.zip.
Para sistemas de 32 bits, el plugin se descarga como un archivo zip, que contiene el nombre de la
versin de Bizagi Studio correspondiente. Por ejemplo para la versin 10.5 es: 10.5.0.2030.zip.
Este plugin de Bizagi incluye:
Una mquina virtual de Java (JVM) para su sistema de 32 o 64 bits. Bizagi instalar un JAVA SE JDK
versin 6, actualizacin 45.
Esto significa que usted no requiere tener un JDK previamente, o tener configurada una variable
JAVA_HOME.
Bizagi automticamente utiliza su JDK local instalado y no tendr en cuenta configuraciones de
JAVA_HOME en su equipo.
Una instancia de JBoss EAP, en su versin 6.2. Bizagi lo instalar de manera que el Bizagi Studio
directamente utilice este servidor para publicar sus procesos.

Para crear proyectos sobre una plataforma JEE, dado que necesitar configurar el Bizagi JEE Plug-in,
deber utilizar el asistente el cual se soporta teniendo instalador Internet Explorer 8 o superior.
El asistente utiliza libreras de IE y por lo tanto, las versiones anteriores de Internet Explorer no se
soportan.

Crear el proyecto
Siga estos pasos:

1. Utilice la opcin Nuevo proyecto en Bizagi.


Haga clic directamente en el enlace Nuevo, al abrir Bizagi Studio.

Copyright 2014 - Bizagi

130

Tenga en cuenta que para crear un proyecto, su cuenta debe pertenecer tanto al grupo local Bizagi,
como al grupo de Administradores (donde se encuentre instalado Bizagi Studio).

Copyright 2014 - Bizagi

131

Si su cuenta no posee estos permisos, entonces podr ingresar las credenciales de una cuenta
autorizada que s cumpla con stas condiciones:

2. Ingrese los detalles de su proyecto.


Asegrese de nombrar su proyecto y definir su ubicacin.
Para crear un proyecto sobre la plataforma JEE deber especficamente seleccionar JEE como
plataforma:

Copyright 2014 - Bizagi

132

Haga clic en Siguiente.

3. Instale Bizagi JEE plugin.


Si usted est creando por primera vez un proyecto de Bizagi para plataforma JEE, Bizagi le presentar
las pantallas para la instalacin de Bizagi JEE plugin.

Cuando Bizagi detecte que el plugin est instalado, este paso no sern necesario.

Copyright 2014 - Bizagi

133

Utilice el botn Download now para descargar el plugin a su mquina local.


Tambin puede utilizar el botn a la derecha para obtener la URL de la descarga del plugin (til si lo
desea hacer desde otra mquina).

Al utilizar la opcin de descarga (el botn Download), Bizagi automticamente detectar si para su
sistema requiere del plugin compatible para 64 bits o si requiere del plugin compatible para 32 bits.
Por lo tanto y si no utiliza este botn (p.e si comparte el plugin con otros miembros de su equipo de
trabajo, o utiliza un enlace directo para descargarlo), recuerde que deber instalar el plugin
apropiado segn la arquitectura de su sistema (especficamente para 32 o 64 bits).
Una vez haya descargado el plugin, utilice el botn Browse para configurar en Bizagi Studio dnde ha
almacenado el plugin:

Copyright 2014 - Bizagi

134

Ntese que podr referenciar el .zip (el plugin directamente) o podr referenciar la ruta del mismo
descomprimido.
Haga clic en Siguiente.

4. Configure JBoss.
Si usted est creando por primera vez un proyecto de Bizagi para plataforma JEE, Bizagi le presentar
las pantallas para la configuracin del servidor JBoss que provee Bizagi JEE plugin, para ejecutar sus
procesos en una plataforma JEE.

Cuando Bizagi detecte que el plugin est instalado, este paso no sern necesario.
Configure JBoss especificando el puerto que usar.
Si no est seguro sobre esta configuracin, puede dejar el puerto 8080 que se sugiere por defecto:

Copyright 2014 - Bizagi

135

Haga clic en Siguiente.


Bizagi iniciar la configuracin del plugin, que puede tardar unos minutos.

Copyright 2014 - Bizagi

136

6. Ingrese los detalles del servidor de Base de datos.


Si usted seleccion la Configuracin avanzada, asegrese de especificar dnde desea establecer su
repositorio de procesos.
Observe que la Base de datos puede ser almacenada en el computador local o un servidor remoto.
Si usted utiliz la configuracin de inicio rpido durante la instalacin de Bizagi Studio, podr utilizar el
servidor de Base de datos SQL que Bizagi instala.
Esta Base de datos es detectada automticamente, para lo cual solo necesita ingresar las credenciales
de conexin por defecto, que son:
Nombre de Usuario: sa
Contrasea: Bizagi10GO

Copyright 2014 - Bizagi

137

Si usted utiliza el servidor de Base de datos SQL que Bizagi Studio instala (o una instancia local),
asegrese de que cuenta con al menos 300 MB de espacio libre en su unidad de disco C:\.
De lo contrario, cuando utilice un servidor de Base de datos SQL (en una mquina remota)
asegrese de que se cuenta con al menos 300 MB de espacio de disco libre en ese servidor.
Si usted desea utilizar un servidor de Base de datos SQL diferente, 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.
Soporte Unicode: Asegrese de que este cuadro se encuentre habilitado para permitir el soporte de
caracteres unicode en su Base de datos.
Si usted desea utilizar un servidor de Base de datos, seleccione Oracle e ingrese los detalles de
conexin de la instancia:
Los
detalles
de
conexin
incluyen
la
informacin
del
servicio
de
Oracle
(ServidorBaseDeDatos:puerto/NombreServicio), y la contrasea para el usuario BizagiAdmon (segn
lo especificado en su como prerequisito en su creacin).
La informacin para este nuevo proyecto muestra cmo se nombrar el proyecto (este ser un nuevo
usuario en su instancia de Oracle), y solicitar una contrasea y confirmacin para este nuevo proyecto.

Copyright 2014 - Bizagi

138

Haga clic en Siguiente.


Bizagi iniciar la creacin del proyecto.
Una vez el proyecto ha sido creado, Bizagi Studio se abrir para iniciar la automatizacin de sus
Procesos.

Importante
Tenga presente las siguientes consideraciones de Bizagi JEE Plug-in:
Bizagi JEE Plug-in tiene un nmero de versin especfica que debe corresponder a la versin de Bizagi
Studio.
Si usted tiene ms de 1 proyecto de Bizagi sobre su instalacin de Bizagi Studio (ejecutndose en la
plataforma JEE), se recomienda en lo posible mantener estos proyectos actualizados en la misma
versin de Bizagi.
De no ser posible, tenga en cuenta que Bizagi JEE plugin ser almacenado y utilizado por cada versin
de los proyectos, lo cul significa que cada proyecto en diferente versin tendr cada uno su versin
de Bizagi JEE plugin correspondiente.
Lo anterior indica que sus proyectos JEE estarn dentro de una ruta que contiene la versin del plugin
(por ejemplo C:\BizagiJEE\10.5.0.2030\BizagiConsoleManagerJEE\...).

Actualizacin del plugin


La anterior consideracin implica que cuando actualice su instalacin de Bizagi Studio, deber tambin
actualizar el plugin.
Para ello, siga los pasos presentados en Actualizacin de proyecto.

Desinstalacin del plugin


En caso de que quiera desinstalar Bizagi JEE plugin, podr hacerlo eliminando la carpeta de este
plugin (descomprimido).
Podr continuar trabajando con Bizagi Studio, con su plataforma de .NET embebida al hacerlo.
Si desea desinstalar Bizagi Studio, entonces adems de eliminar el plugin, podr despus desinstalar
Bizagi Studio mediante las opciones del panel de control.

Configuracin de trabajo colaborativo

Introduccin
Bizagi Studio brinda un ambiente colaborativo donde usted y sus colaboradores podrn trabajar
simultneamente en sus procesos.
Es muy comn que los usuarios de Bizagi descarguen Bizagi Studio y comiencen a construir sus
procesos en un computador personal como un laptop o un notebook para una configuracin de inicio
rpido.
Eventualmente, cuando inicia un proyecto de automatizacin, los usuarios necesitan un grupo ms

Copyright 2014 - Bizagi

139

grande de personas para trabajar, como equipo, en los mismos procesos.


Para atender esto, Bizagi soporta una configuracin de ambiente colaborativo en el ambiente de
Desarrollo (Autora), de manera que varios usuarios pueden trabajar con Bizagi Studio en sus propios
computadores, mientras acceden al proyecto almacenado en un servidor central.
Como resultado, todos pueden trabajar en el mismo modelo al mismo tiempo.

Funcionalidades de la colaboracin de equipo de trabajo


Bizagi habilita la interaccin coordinada entre usuarios. Las siguientes funcionalidades estan enfocadas
en trabajo colaborativo:

Check-in, Check-out
Bizagi ayuda a los usuarios a ser coordinados y evitar conflictos cuando trabajen en un mismo
diagrama de proceso, utilizando los controles Check-in y Check-out.
Cuando un usuario esta editando un diagrama de proceso, en el primer paso del asistente, est ser
habilitado solamente para ese usuario, es decir, solo se permitir la edicin para el usuario actual y los
dems usuarios sern bloqueados para editar el diagrama. Apenas el usuario cierre el diagrama, este
estar disponible para su edicin por parte de cualquier miembro del equipo.
El mismo concepto aplica cuando los usuarios trabajan en la definicin de interfaces; Cuando se crean
o editan las formas que se presentan a los usuarios finales, un control automtico de Check-in y
Check-out ser habilitado.
El resto de pasos del asistente de procesos de Bizagi estarn disponibles para realizar cambios al
mismo tiempo, sin ninguna restriccin.

Copyright 2014 - Bizagi

140

Recomendamos establecer reglas con su equipo de desarrollo y comunicarse entre s, para evitar
sobrescribir el trabajo de otros.

Mltiples proyectos
Usted puede tener varios proyectos Bizagi albergados en un mismo servidor y trabajar en ellos de
forma independiente.
Cuando se tienen mltiples proyectos en una plataforma JEE (i.e usando JBos), usted podr publicar el
Portal de trabajo de UN solo proyecto a la vez.
Esto implica que si usted necesita ejecutar ms de un proyecto de Bizagi de manera simultnea, con la
edicin JEE necesitar configurar mltiples instancias de Servidores de aplicacin (p.e, tener 2
instancias de JBoss ejecutndose en el mismo servidor).

Recuerde que un proyecto Bizagi puede contener cualquier nmero de Procesos.


Mltiples proyectos solo deberan ser necesarios para diferentes implementaciones, por ejemplo, si
usted quiere tener Bases de datos separadas para cada proyecto o un conjunto diferente de
usuarios finales accediendo a cada proyecto a travs distintos tipos de de autenticacin.

Lo que necesita hacer


Como prerrequisito, debe definir explcitamente:
El servidor de Base de datos que posee un servidor SQL Server u Oracle instalado.
Para dudas acerca de la configuracin requerida para este servidor, consulte Requisitos del servidor
de Base de datos
El servidor servidor central BPM que almacenar el proyecto Bizagi.
Qu usuarios y estaciones de trabajo trabajarn en este proyecto, conectndose al servidor central
BPM,
Para configurar los equipos de trabajo de desarrollo se deben realizar las siguientes actividades:
1. Instalar Bizagi Studio en el servidor central BPM.
2. Crear el proyecto Bizagi en el servidor central BPM.
3. Incluir la autorizacin de entradas en el servidor central BPM para sus usuarios.
4. Instalar Bizagi Studio en cada una de las estaciones de trabajo de los usuarios que se conectan
a este proyecto.
5. Conectarse al proyecto desde cada una de las estaciones de trabajo.

Configurando la colaboracin de equipos de trabajo


Siga estos pasos para habilitar el trabajo colaborativo.

1. Instalar Bizagi Studio en el servidor central BPM.


Instale Bizagi Studio ejecutando el instalador con derechos de administracin en el servidor central
BPM.
Lleve a cabo los pasos de instalacin descritos en Configuracin de inicio rpido, pero esta vez se
puede omitir la opcin de instalar una instancia de SQL Server.
En su lugar, usted puede verificar el acceso a su Base de datos si va a utilizar una instancia de SQL

Copyright 2014 - Bizagi

141

Server:

2. Crear el proyecto Bizagi en el servidor central BPM.


Tras una instalacin completa, cree un nuevo proyecto de Bizagi en el servidor BPM central, tal como
se describe en Crear un nuevo proyecto.
Si usted ya tiene algunos avances en un proyecto existente, sigue siendo mejor que cree un nuevo
proyecto en este servidor.
A continuacin, puede importar fcilmente su progreso mediante la creacin de una copia de
seguridad de base de datos de su proyecto existente, y restaurar esta copia de seguridad en la base
de datos del nuevo proyecto.

Si est utilizando una Base de datos SQL Server, y usted confa en la configuracin avanzada de las
cuentas de inicio de sesin de SQL Server, asegrese de conectarse al proyecto especificando el uso
de una cuenta de acceso autorizado.
Usted necesitar una cuenta de autenticacin Administrador de Proceso o una cuenta con privilegios
elevados, como se describe en Configuracin avanzada de cuentas de autenticacin a SQL Server.

Copyright 2014 - Bizagi

142

3. Incluir la autorizacin de entradas en el servidor central BPM para sus


usuarios.
En el servidor central BPM, asegrese de agregar todas las cuentas de los miembros de su equipo en
el grupo de Bizagi.
Tenga en cuenta que este grupo es creado automticamente por la instalacin de Bizagi y por defecto,
se incluye slo el administrador local.
Para aadir usuarios a este grupo, revise las opciones de administracin local para encontrar los
elementos de usuario y grupos locales.
Haga clic derecho en el grupo de Bizagi para utilizar la opcin Agregar al grupo..:

Copyright 2014 - Bizagi

143

Tambin puede confiar en la funcin de seguridad Bizagi Studio, con el fin de definir las opciones de
autorizacin de quien puede trabajar en el cules los procesos.
Para obtener ms informacin sobre esta opcin, consulte Seguridad en Bizagi Studio.

4. Instalar Bizagi Studio en cada una de las estaciones de trabajo de los


usuarios que se conectan a este proyecto.
Instale Bizagi Studio en cada una de las estaciones de trabajo de los miembros del equipo.
Asegrese de:
Instalar la misma versin de Bizagi Studio instalada en el servidor central BPM (como en el paso #1).
El instalador corre con permisos de administracin.
Lleve a cabo los pasos de instalacin descritos en Configuracin de inicio rpido pero esta vez usted
debe utilizar directamente la opcin para omitir los pasos relacionados a la instancia de Base de
datos.

5. Conectarse al proyecto desde cada una de las estaciones de trabajo.


Para conectarse al proyecto desde las estaciones de trabajo, abra Bizagi Studio y seleccione la opcin
Abrir proyecto existente en la ventana principal.

Copyright 2014 - Bizagi

144

Seleccione el servidor central BPM que almacena el proyecto y seleccione el nombre el proyecto.
Haga clic en Finalizar.

Copyright 2014 - Bizagi

145

Si est utilizando una Base de datos SQL Server, y usted confa en la configuracin avanzada de las
cuentas de inicio de sesin de SQL Server, asegrese de conectarse al proyecto especificando el uso
de una cuenta de acceso autorizado.
Usted necesitar una cuenta de autenticacin de Analista de procesos o una cuenta con privilegios
elevados, como se describe en Configuracin avanzada de cuentas de autenticacin a SQL Server.

Importante
En esta configuracin, es importante resaltar que la implementacin de los procesos (promocin y
publicacin de los procesos, desde el entorno de desarrollo a un entorno de prueba o de
produccin), as como la actualizacin de su versin de Bizagi, deben hacerse desde el servidor central
BPM.
No se recomienda realizar dichas tareas (implementaciones, actualizaciones de proyectos) desde las
estaciones de trabajo de los usuarios.

Abrir un proyecto

Introduccin
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 accederlo) o puede ser abierto desde un servidor remoto (un servidor central BPM).

Copyright 2014 - Bizagi

146

Requisitos
Considere las siguientes configuraciones de autorizacin al momento de abrir un proyecto:
1. Su usuario debe estar definido explicitamente como miembro del grupo Bizagi.
Si usted desea abrir un proyecto almacenado en un servidor remoto, deber asegurarse de que su
usuario pertenece al grupo Bizagi en ese servidor remoto.

2. Si la funcionalidad de seguridad Bizagi Studio ha sido configurada para este proyecto, asegrese de
que su usuario se encuentra autorizado para abrir el proyecto y trabajar en los procesos relevantes.
Para ms informacin acerca de la funcionalidad de seguridad Bizagi Studio consulte Cmo configurar
la Seguirdad de Bizagi Studio

Abrir el proyecto
Para abrir un proyecto se deben llevar a cabo los siguientes pasos:
1. Haga clic en Abrir proyecto existente en la ventana inicial de Bizagi Studio.

Copyright 2014 - Bizagi

147

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 haga clic en Finalizar para registrarlo.

Copyright 2014 - Bizagi

148

Importante
Tenga en cuenta los siguientes aspectos para abrir proyectos:
1. Misma plataforma Bizagi
Un proyecto configurado para su ejecucin en .NET no estar disponible para su ejecucin en la
plataforma JEE.
De manera similar, un proyecto configurado para ejecucin en la plataforma JEE, no podr ser
ejecutado en la plataforma .NET.
2. Misma versin de Bizagi
Para acceder a un proyecto almacenado en un servidor remoto, asegrese que de la versin de Bizagi
Studio que tiene instalada es la misma que la instalada en el servidor remoto.
3. Conexin a la red
Para abrir un proyecto alojado en un servidor remoto, asegrese de que ese servidor remoto est
dentro de la red de su mquina.
Tambin puede abrir un proyecto alojado en un servidor con un dominio diferente o una configuracin
de equipo de trabajo.
Si las mquinas involucradas no estn bajo la misma configuracin de dominio, usted necesita tener a
mano credenciales de administrador autorizadas para acceder a este servidor remoto.
4. Desconectarse al finalizar
Cuando se conecte a un proyecto remoto, se recomienda que las tareas de administracin o ese
proyecto (por ejemplo, despliegue de procesos, actualizacin del proyecto a una versin ms reciente

Copyright 2014 - Bizagi

149

de Bizagi, etc), se realice directamente en ese servidor remoto.


No se recomienda realizar dichas tareas (despliegues, actualizaciones de proyectos) desde las
estaciones de trabajo de los usuarios.
En caso de que usted ya no desee abrir el proyecto desde su estacin de trabajo, puede utilizar la
opcin desconectarse para anular el registro del proyecto en lugar de eliminarlo.
Para obtener ms informacin sobre esta opcin, consulte Administracin de proyectos

Manejo de sus proyectos

Introduccin
Esta opcin es utilizada para administrar proyectos existentes que haya abierto en Bizagi Studio.
Todos los proyectos que usted haya abierto se listarn.
Las opciones para el manejo de sus proyectos son: eliminarlos, desconectarse de ellos (cuando el
proyecto est albergado en un servidor remoto), actualizarlo a una nueva versin, abrirlo, o
reconfigurar la conexin que utiliza para la base de datos.
Adems de lo anterior, desde estas opciones podr crear nuevos proyectos tambin.

Opciones
Cada opcin y su detalle se enumera a continuacin.

Copyright 2014 - Bizagi

150

Nuevo proyecto
Inicia el asistente para crear nuevos proyectos.
Para informacin sobre este procedimiento, consulte Crear un nuevo proyecto.

Eliminar un proyecto
Los proyectos nicamente pueden ser eliminados desde la mquina la cul alberga el proyecto.
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 remover permanentemente el proyecto.

Una segunda ventana solicitar al usuario confirmar si la Base de Datos se mantendr.


Esta Base de Datos podr ser til en el futuro si usted necesita restaurar su estado en una nueva
ubicacin.

Desconectarse de un proyecto
Cuando un proyecto se alberga en un servidor remoto, y usted no desea seguir trabajando desde su
estacin de trabajo en ese proyecto, podr hacer uso de la opcin de desconectarse del proyecto.
Esta opcin no elimina el proyecto, sino que elimina el registro del mismo en su Bizagi Studio.
Un dialogo de confirmacin advertir sobre la desconexin del proyecto.

Copyright 2014 - Bizagi

151

Actualizar un proyecto
Los proyectos nicamente pueden ser actualizados desde la mquina que alberga el proyecto.
Cuando se actualiza la versin de Bizagi Studio, deber utilizar esta opcin para cada proyecto para
ser actualizado a la nueva versin.
Para mayor informacin, consulte la Actualizacin de proyecto.

Abrir un proyecto
Carga el proyecto en su Bizagi Studio.
Si el proyecto no ha sido actualizado a la versin actual de Bizagi Studio, un dilogo de confirmacin
advertir sobre esto y le permitir llevar a cabo la actualizacin del proyecto.

Cambiar el usuario de base de datos


Le permite reconfigurar la conexin a la base de datos de su proyecto.
Est opcin es especialmente til cuando se opta por el uso avanzado de login de usuarios SQL
Server, para los diferentes perfiles trabajando en el proyecto.

Actualizacin del proyecto

Introduccin
Bizagi libera nuevas versiones de manera peridica las cuales incluyen nuevas funcionalidades
poderosas y ajustes o mejoras a las funcionalidades existentes.
Recomendamos enfticamente que se realicen actualizaciones a las nuevas versiones, de manera que
sus proyectos puedan contar con todos los beneficios de las nuevas funcionalidades, mejoras y ajustes
a bugs.

Copyright 2014 - Bizagi

152

La versin mas reciente en todas sus ediciones, estar disponible para descarga desde nuestro sitio
en www.bizagi.com.
Tambin podr ser notificado por Bizagi Studio acerca de la liberacin de nueva versin (si durante la
instalacin, usted habilit verificar actualizaciones).

Copyright 2014 - Bizagi

153

Actualizacin de Bizagi Studio


Para actualizar su proyecto a la nueva versin, primero debe actualizar su versin de Bizagi Studio.
Este procedimiento es simple, y para ello se desinstala su Bizagi Studio actual, a travs de las opciones
del panel de control:

Y despus, se instala la versin nueva de Bizagi Studio.


Si desea ver informacin sobre la instalacin de Bizagi Studio, consulte la Configuracin de inicio
rpido.

Si el proyecto est configurado para trabajo colaborativo (mltiples usuarios trabajando en un


proyecto), debe hacer la actualizacin de Bizagi Studio y del proyecto en el servidor central BPM
(donde se alberga el proyecto).

Consideraciones
La actualizacin de un proyecto Bizagi es un procedimiento simple, que incluye principalmente la
actualizacin de metadata en la base de datos y otros pasos para actualizar los componentes de
Bizagi (como el Portal de trabajo).
Estos pasos son asistidos por Bizagi.

Copyright 2014 - Bizagi

154

Antes de continuar considere lo siguiente:


1. Versiones mayores y menores
Bizagi contempla versiones mayores y versiones menores.
Aunque el procedimiento de actualizacin del proyecto es similar en los 2 escenarios, pueden existir
consideraciones adicionales cuando se realiza una actualizacin de proyecto a una versin mayor.
Por lo tanto, los siguientes pasos aplican para la actualizacin de una versin menor de Bizagi.
Si usted cuenta con una versin de Bizagi 10.x, siga los pasos.

De lo contrario, y si usted cuenta con una versin de Bizagi 9.1.x o anterior, revise la informacin sobre
la Actualizacin a versin Bizagi 10.x.

2. Deployment de procesos sobre la misma versin de Bizagi


Si su proyecto todava no ha tenido un deployment hacia un ambiente de produccin, podr omitir
esta consideracin.
De lo contrario y si su proyecto ha sido previamente publicado a produccin, considere que la
actualizacin del proyecto en el ambiente de desarrollo (a travs de Bizagi Studio), requiere
eventualmente que tambin actualice su proyecto en los ambientes de pruebas y de produccin.
Esto es un prerrequisito para realizar un nuevo deployment.
El procedimiento se realiza de manera aparte en cada ambiente, y siempre se debe hacer primero en
el ambiente de desarrollo.

Copyright 2014 - Bizagi

155

No realice la actualizacin de versin si tiene un Deployment marcado como Release Candidate


pendiente por llevar a produccin.
Deber cerciorarse de que se hayan aplicado los release candidate o cancelarlos.
Si usted tiene dudas sobre lo anterior, no dude en contactar a nuestro equipo de soporte.

3. Creacin de backups
Recomendamos crear backups (archivos de respaldo) de la base de datos y de los archivos de
configuracin del proyecto.
Aunque Bizagi genera automticamente backups antes de comenzar la actualizacin, cree sus propios
backups para: la Base de datos, y la estructura completa de los archivos y carpetas donde se configura
el proyecto (p.e, los archivos del portal de trabajo).
Para proyectos ejecutndose en una plataforma .NET, la estructura completa de los archivos y carpetas
de configuracin del proyecto son: WebApplication y Scheduler, dentro de la ruta de configuracin
del proyecto, usualmente y por defecto C:\Bizagi\Projects\[su_proyecto].
Si se tiene una base de datos SQL Server local, los archivos de la base de datos de backup estarn
dentro de la carpeta Database de la ruta de configuracin del proyecto.
Si se tiene una base de datos SQL Server remota, los archivos de la base de datos de backup
estarn en: C:\Program Files (x86)\Microsoft SQL Server\[instancia_MSSQL]\MSSQL\Backup\.
Si se usa una Babse 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 en la variable
BA_BACKUP_PATH.
Para proyectos ejecutndose en una plataforma JEE, la estructura completa de los archivos y carpetas
de configuracin del proyecto, se encuentran en la Consola JEE en la ruta C:\BizagiJEE
\BizagiConsoleManagerJEE\.
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\Projects
\[su_proyecto]\Backups):

Copyright 2014 - Bizagi

156

Actualizando el proyecto
Una vez que haya instalado la versin nueva de Bizagi Studio en la mquina donde se alberga el
proyecto de Bizagi, siga estos pasos.
Requerimientos de Sistema
1. Abra Bizagi Studio y abra su proyecto.
Puede hacerlo desde el listado de proyectos abiertos recientemente:

Copyright 2014 - Bizagi

157

Si el proyecto no est en la lista, puede usar la opcin de Abrir proyecto existente:

Copyright 2014 - Bizagi

158

Si usted est actualizando su Bizagi Studio para trabajar en proyectos en una plataforma JEE, al
escoger el proyecto JEE podr asegurarse de actualizar Bizagi JEE Plug-in a la versin
correspondiente del Studio.
Para la actualizacin, lo importante es que el plugin correspondiente se encuentre instalado en la
ruta y su contenido est descomprimido (por ejemplo, a manera de C:\BizagiJEE\[version_plugin]
\...).
2. D clic en S para confirmar que Bizagi inicie de manera automtica la actualizacin:

Asegrese de coordinar previamente entre el equipo de trabajo involucrado, que la actualizacin se


realizar en el servidor BPM y de esta manera, corroborar que ningn otro usuario est trabajando

Copyright 2014 - Bizagi

159

actualmente en el proyecto o tenga su Bizagi Studio abierto.


3. Cuando la actualizacin se haya completado el proyecto se abrir en Bizagi Studio.
En este punto el proyecto habr sido actualizado a la nueva versin.

4. Finalmente, y cuando se tiene una configuracin de trabajo colaborativo, los dems miembros del
equipo de trabajo que se conecten a este proyecto pueden actualizar la instalacin de Bizagi Studio en
sus estaciones de trabajo.

Una vez que haya verificado exitosamente el comportamiento de los procesos, podr actualizar su
ambiente de pruebas para realizar un deployment de estos procesos hacia all.

Interfaz de Bizagi Studio


Bizagi Studio posee dos vistas principales: El Asistente y la vista de Mdulos.
Cada proyecto puede ser automatizado utilizando la vista de Asistente; sin embargo, algunas
caractersticas avanzadas estn disponibles nicamente en la vista de Mdulos. Para cambiar la vista
actual, seleccione la pestaa de Inicio en la parte superior izquierda de la pantalla y luego d clic en el
botn Mdulos/Asistente en el grupo de Vista, segn corresponda.

Copyright 2014 - Bizagi

160

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

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

Copyright 2014 - Bizagi

161

Cinta de Opciones
Las vistas de Asistente y Mdulos comparten la misma interfaz de men. Esta seccin de mens es
denominada Cinta de Opciones.
La Cinta de Opciones contiene los principales controles para administrar cada vista. Estos estn
organizados en diferentes pestaas y son brevemente descritos a continuacin:

Pestaa de Archivo

Copyright 2014 - Bizagi

162

OPCIN DE MEN

DESCRIPCIN

Nuevo Proyecto

Crea un nuevo proyecto de Bizagi BPM.

Abrir Proyecto Existente

Abre un proyecto existente de Bizagi BPM.

Proyectos

Administra proyectos existentes.

Recientes

Da acceso rpido a los ltimos proyectos que han sido utilizados.

Seguridad Bizagi Studio

Controla permisos de acceso de usuario a elementos de un proyecto


de Bizagi.

Importar Plantillas

Accede a nuestra Central de Procesos gratuitos para descargar


procesos ejecutables listos para utilizar.

Salir

Cierra Bizagi Studio

Pestaa de Inicio

Copyright 2014 - Bizagi

163

La pestaa de Inicio contiene tres botones principales que siempre se muestran.


OPCIN DE MEN

DESCRIPCIN

Mdulos / Asistente

Cambia la vista de Bizagi Studio entre las vistas de Asistente y


Mdulos.

Ejecutar

Accede al Portal de Trabajo para ejecutar los procesos.

Buscar

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 mens contextuales, Procesos y Atributos basados en
las selecciones realizadas.
La siguiente imagen muestra la distribucin del men de Inicio, con el men contextual de Proceso,
cuando se accede a un Proceso especfico en el Mdulo de Procesos.

Copyright 2014 - Bizagi

164

Esta otra muestra una vista levemente alterada de la distribucin del men de Inicio, con el men
contextual Atributos, cuando se accede a atributos de una entidad especfica en el Mdulo de
Entidades.

Copyright 2014 - Bizagi

165

Pestaa de Herramientas

OPCIN DE MEN

DESCRIPCIN

Campos de Usuario

Accede al men de Campos de Usuario, donde usted puede crear y


administrar controles HTML personalizados sofisticados los cuales
no estn por defecto en los controles del Editor de Formas de
Bizagi.

Scripting

Scripting le permite a los usuarios la inclusin y uso de cdigo


JavaScript en cualquier forma de un Proceso. Las funciones

Copyright 2014 - Bizagi

166

OPCIN DE MEN

DESCRIPCIN
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


Aplicaciones y Procesos creadas en el proyecto. Estas son las Reglas
de librera que pueden se llamadas desde cualquier Proceso, regla o
elemento.

Librera 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, as como una
funcionalidad denominada Librera de Componentes para una
integracin a nivel de Proceso (transaccional).

Pestaa de Configuracin

OPCIN DE MEN

DESCRIPCIN

Entorno

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 especifica
para cada ambiente de manera individual (desarrollo, pruebas y
produccin)

Negocios

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

Seguimiento

Activa traces para dar seguimiento a los diferentes 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.

Copyright 2014 - Bizagi

167

OPCIN DE MEN

DESCRIPCIN

Secuencias y Numeracin Personaliza identificadores de caso, los cuales son los nmeros de
de Casos
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
Ayuda

SUB OPCIN

Ayuda

Muestra esta Gua de Usuario. El documento


puede ser descargado a un archivo PDF para
acceso sin conexin ala red.

Foros de Soporte

Accede a los foros de Soporte Online.

Central de Procesos

Comunidad

Comentarios

Accede a las plantillas de Proceso de la Central de


Procesos de Bizagi y a los foros de discusin.
Accede a la pgina de Comentarios y Preguntas
para transmitir comentarios, preguntas,
sugerencias e ideas de mejoramiento,

Comentarle a un amigo

Acerca de

DESCRIPCIN

Link que le ayudar a compartir Bizagi BPM Suite


con clientes, colegas y amigos.

Notas de la Versin

Informacin acerca de la versin actual y


anteriores de Bizagi.

Administracin de Licencias

Abre la ventana de Administracin de Licencias


para activar o comprar licencias.

Acerca de

Informacin acerca de Bizagi Studio y


colaboradores.

Copyright 2014 - Bizagi

168

Estilo e Idioma

OPCIN DE
MEN
Estilo

Idioma

SUB OPCIN

DESCRIPCIN

Color: Azul, Negro, Plateado, Permite cambiar el color de fondo de Bizagi


Esquema personalizado.
Studio.
Sin animaciones

Desactiva las animaciones del Asistente de


Procesos para mejorar la velocidad de la pantalla.
Aplica nicamente para la vista de Asistente.

Barra de explorador extendida

Extiende o contrae los iconos en la barra de


Mdulos de la vista de Mdulos.

Refrescar Vista Carrusel.

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.

Control de
Ocultar/
Mostrar

Minimiza la Cinta de Opciones.

Asistente de Procesos
Bizagi Studio 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.
Simplemente siga cada uno de los siete pasos para transformar los procesos que fueron diseados en
Bizagi Modeler, en aplicaciones sin necesidad de programacin.

Copyright 2014 - Bizagi

169

Modelar Procesos: Defina el flujo del proceso utilizando Bizagi Modeler.


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

Copyright 2014 - Bizagi

170

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 d 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

Copyright 2014 - Bizagi

171

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, d clic derecho
sobre el nombre del proceso y seleccione Adicionar al asistente.

Vista de mdulos
La vista de Mdulos es una vista avanzada donde los usuarios pueden interactuar con las
caractersticas y mens de Bizagi sin seguir el procedimiento paso a paso propuesto en la vista del
asistente.
Recomendamos usar la vista del asistente para crear inicialmente sus procesos por completo y
acceder a la vista de Mdulos para agregar opciones avanzadas que no puedan ser aadidas a travs
del asistente, como por ejemplo: crear su organizacin, administrar la seguridad del Portal de Trabajo,
administrar el programador, crear reglas de negocio globales, crear formas globales, administrar
entidades paramtricas, entre otras.

Copyright 2014 - Bizagi

172

La vista de Mdulos tiene las siguientes opciones.


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.

Copyright 2014 - Bizagi

173

Portal de trabajo: Permite personalizar la imagen mostrada en el Portal de Trabajo.


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.

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.

ELEMENTO

OPCIONES

Copyright 2014 - Bizagi

174

Todas las
Aplicaciones

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.

Aplicacin

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.

Procesos
(Categora por
defecto)

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.

Nombre del
Proceso

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.

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
usuarios.

Copyright 2014 - Bizagi

175

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 Configurar como la forma principal de la actividad actual, dando clic
derecho sobre ella. Esto cambiar la forma activa actual para la Actividad, en el
Portal de Trabajo.

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 Propiedades de check-out saber quin tiene el
proceso.

Copyright 2014 - Bizagi

176

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.

Copyright 2014 - Bizagi

177

ELEMENTO

OPCIONES

DESCRIPCIN

SUB-OPCIONES

Atributos

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).

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.

Formas

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

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

Elementos
que aplican
a todos los
mens

Copyright 2014 - Bizagi

178

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.

Valores (no
disponibles en el
Sistema)

Consultas (no
disponibles en el
Sistema)

Aplicacin

Propiedades
Generales

Muestra una lista de valores


ingresados en la ejecucin del
Proceso.

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.

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.

Propiedades: Muestra el Asistente de Modelo de Datos de la


Entidad.
Propiedades Avanzadas: Habilita la posibilidad de registrar

Copyright 2014 - Bizagi

179

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
Generales

Maestra

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.

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.

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.

Diagramas

Expresiones

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
elemento.

Copyright 2014 - Bizagi

180

Ver dependencias: Muestra una lista que contiene objetos en el


proyecto relacionados al elemento.

Expresiones

Sistema

Propiedades
Generales

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.

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

Ajustes avanzados
Consulte los captulos de esta seccin para configurar los ajustes avanzados en un proyecto de Bizagi,
que le permiten definir:
La estructura de su compaa, con los procesos segn the process por unidades de negocio.
Dnde almacenar los documentos adjuntos, o qu servidor de correos utilizar para las
notificaciones.
Configuracin de negocio, tal como: lenguaje por defecto, formato de fechas y decimales por
defecto, etc.
Cmo habilitar los Traces para depurar sus reglas de negocio o tareas de integracin con otros
sistemas.
Qu servidor web utilizar (IIS o IIS Express).

Definiendo la estructura del proyecto en su compaa

Introduccin
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 2014 - Bizagi

181

Bizagi permite organizar sus procesos utilizando aplicaciones, y categoras con diferentes niveles
jerrquicos.
Una aplicacin 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 Categoras.

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.

Copyright 2014 - Bizagi

182

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: Talento Humano y Nomina.
En un nivel ms bajo de Talento humano, hemos creado dos categoras adicionales, Administracin de
Personal y Administracin de Talento, para incluir procesos que aplican a esas reas especficamente.

Copyright 2014 - Bizagi

183

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: Transicin del Servicio y
Operacin del Servicio. Cada categora tiene diferentes procesos. Por ejemplo Operacin del Servicio
tiene Administracin de incidentes y Gestin de problemas.

Copyright 2014 - Bizagi

184

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

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.

Copyright 2014 - Bizagi

185

La configuracin de entorno posee tres opciones:


Popular
Avanzado
Personalizado

Copyright 2014 - Bizagi

186

Antes del realizar un deployment inicial, la configuracin en todos los ambientes puede ser realizada
en el ambiente de desarollo en Bizagi Studio.
Con el primer deployment, se publicar esta configuracin a cada ambiente. A partir de ese
momento, los cambios se deben realizar de manera local, independientemente en cada ambiente.
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)

Los parmetros para configurar son

Copyright 2014 - Bizagi

187

OPCIN

DESCRIPCIN

Habilitar Email

Habilita o deshabilita el envo de correos automticos. Si se habilita, se


enviarn correos electrnicos. De lo contrario, los correos electrnicos se
ignorarn.

Servidor SMTP

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.

Cuenta de Servidor
SMTP

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
Email a

Define una cuenta de correo electrnico a la cual se enviarn las copias de


todos los correos enviados por la aplicacin.

Enviar copia Oculta


a

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).

Copyright 2014 - Bizagi

188

Los parmetros que pueden ser configurados son:


OPCIN

DESCRIPCIN

OPCIONES DE SCHEDULER
Intervalo

Configura el intervalo (en horas, minutos y segundos), para cuan


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 es: C:\BizAgi
\Enterprise\Projects\[Project name]\Docs
La ruta por defecto en Bizagi Enteprise JEE es el directorio ./
BizAgiDocs 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).

Copyright 2014 - Bizagi

189

OPCIN

DESCRIPCIN

Tamao mximo de Upload

Define el tamao mximo que puede tener un archivo para ser subido
a la aplicacin Bizagi (bytes).

OPCIONES SOA
Forzar llave de negocio de La opcin de deshabilitar esta configuracin, aplica para las edicin
SOA
Bizagi .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.

Habilitar registro Entidades

Permite el registro de informacin en las entidades.

Habilitar
registro
relaciones M-M

de 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)

OPCIONES DE ENTIDAD
(1) Lmite mximo de Las Entidades Paramtricas en el Portal de Trabajo se manejan en
longitud de Atributo Y (2) cach si el nmero de atributos es menor que el primer parmetro y
Lmite de instancias de el nmero de registros es menor que el segundo parmetro.
Entidades
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.
OPCIONES DE INTERFAZ DE SERVICIOS WEB
Tiempo de Espera

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.

Umbral para registro

Tiempo del umbral en segundos para el log de interfaces que duran


ms de este tiempo.

OPCIONES DE NOTIFICACIN DE ANULACIN


Deshabilitar notificaciones Si se selecciona desactiva la notificacin de los casos que sean
de anulacin
anulados.
Estas notificaciones se envan a todas las personas que tengan tareas

Copyright 2014 - Bizagi

190

OPCIN

DESCRIPCIN
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

Tipo de Proveedor

Configuracin del uso de la conexin ODS para el proyecto Para ms


informacin dirjase Configuracin ODS

Personalizado
Desde esta opcin usted puede agregar, editar y borrar los diferentes parmetros del proyecto para
cada ambiente (desarrollo, pruebas, produccin).

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.

Copyright 2014 - Bizagi

191

Seleccionando un parmetro y dando clic en el icono de equis (

), 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");

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
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.

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 Configuracin, 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.

Copyright 2014 - Bizagi

192

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.

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 Ok.

Copyright 2014 - Bizagi

193

Las opciones disponibles en el grupo de localizacin son:


ELEMENTO

DESCRIPCIN

Opciones de localizacin
Cultura global

Define la cultura de la aplicacin, incluyendo el texto y el calendario que


se utilizar.

Formato para Fecha y Hora


Formato corto fecha

Define el formato de fecha corta.

Formato corto hora

Define el formato de hora corta.

Formato largo fecha

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

Define el nmero de dgitos decimales en valores de moneda.

Smbolo de moneda

Define el smbolo de moneda aparecer antes del valor.

Separador decimal

Define el caracter separador decimal.

Copyright 2014 - Bizagi

194

ELEMENTO
Separados de miles

DESCRIPCIN
Define el caracter separador de miles.

Zona horaria
Zona horaria servidor

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 2014 - Bizagi

195

Para personalizar el cuerpo de una notificacin especfica, haga clic en la opcin Editar. Una nueva
ventana aparecer para modificar el nombre, el asunto y el texto del cuerpo del mensaje.
ELEMENTO

DESCRIPCIN

Tareas

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.

Abortar

Estas notificaciones se enviarn tan pronto como un caso ha sido


abortado a todos los que estn asignados actualmente a una actividad
del caso.

Alarmas de tareas

Estas notificaciones se envan cuando una alarma se ha configurado para


una tarea especfica del Proceso.

Alarmas de Procesos

Estas notificaciones no estn soportadas actualmente.

Copyright 2014 - Bizagi

196

Avanzado
Este grupo de opciones permite configurar los parmetros generales de visualizacin para el proyecto
Bizagi.

ELEMENTO

DESCRIPCIN

Asignaciones
Grupo de usuario por defecto

Define el grupo de usuarios predeterminado para las


asignaciones cuando ningn usuario cumple las condiciones de
asignacin.

Opciones del proyecto


Mostrar Link Excel

Muestra el enlace para exportar tablas a Excel.

Mostrar Eventos como Tareas

Muestra los Eventos en el Inbox.

Ocultar tipos de tarea en el Log de


Estados

Oculta tareas que no tienen una interaccin directa con el


usuario.

Copyright 2014 - Bizagi

197

ELEMENTO

DESCRIPCIN

Deshabilitar Link al caso padre

Desactiva el enlace al caso padre desde los subprocesos

Agrupar casos por nmero de caso Agrupa los casos en el Inbox por nmero de caso
Preferencias de usuario
Forma de preferencias de usuario

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.

Tipos de contenido

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.

Configuracin de Traces

Introduccin
Durante las fases de automatizacin de los procesos, hay ciertos escenarios en los que desea rastrear
o hacer seguimiento a la ejecucin de sus procesos.
Bizagi ofrece la posibilidad de hacer rastreo de los errores en los flujos de procesos (para su control y
diagnstico), de modo que usted pueda 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.
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 necesite.

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).

Copyright 2014 - Bizagi

198

2. Definir sus detalles del Trace.

1. Reconocer qu Traces activar


Para habilitar los Traces en una fase de automatizacin, utilice la opcin Tracing desde Bizagi Studio:

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:

Copyright 2014 - Bizagi

199

Es importante reconocer y planificar qu Traces desea habilitar.


La siguiente tabla describe las posibilidades:
ELEMENTO

DESCRIPCIN

EntityManager

Registra la ejecucin de EntityManager


(acceso de base de datos).

Interfaces

Registra cuando una interfaz externa se


invoca. Rastrea las peticiones y
respuestas..

LDAP

Registra la ejecucin de la

Copyright 2014 - Bizagi

200

sincronizacin programada de usuarios


de LDAP en Bizagi.
Render

Registra la construccin Formas en el


Portal de Trabajo (y sus campos).

Reglas y expresiones

Registra la ejecucin y la evaluacin de


las reglas de negocio y polticas.
Los Traces en reglas son
personalizados using la funcin
CHelper.trace

Scheduler

Registra la ejecucin de los trabajos


programados.

Workflow

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.

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).

Copyright 2014 - Bizagi

201

Por defecto est seleccionado Apagado (una caja vaca se muestra) para todos los objetos /
componentes.
Cuando Error es seleccionado, el archivo de rastreo slo registra los errores.
Cuando Advertencia se selecciona, el archivo de rastreo rastrear advertencias y errores.
Cuando Todo 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 BPM.
Ellos estarn ubicados en una ruta diferente, de acuerdo con el servidor web.

Copyright 2014 - Bizagi

202

En los proyectos que se ejecuten sobre una plataforma de .NET, los Traces se guardarn en:
C:\Bizagi\Projects\[project_name]\Trace\
Los Traces de las interfaces SOA se guardan por separado en:
C:\Bizagi\Projects\[project_name]\Temporary\SOA\

En los proyectos que se ejecuten sobre una plataforma de JEE, los Traces se guardarn en la ruta
temporal de la mquina:
C:\Windows\Temp\Bizagi\
Los Traces de las interfaces SOA se guardan por separado en la carpeta bin del JBoss.

Ejemplos y mayor informacin


Como se describi anteriormente, hay ms de 1 tipo de objeto / componente para rastrear.
Lo siguiente describe los Traces ms comnmente 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 BATrace_Web_[fecha].log.
El siguiente ejemplo ilustra la informacin que se graba en estos archivos:

Trace del Scheduler (Programador)


El servicio programador graba unos logs con el detalle sobre lo que ejecuta de manera offline.

Copyright 2014 - Bizagi

203

Estos logs se encuentran en la carpeta .\Trace como un archivo llamado


BATrace_Scheduler_[fecha].log.
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 los Traces para
las interfaces (invocacin de servicios web).

Traces para las interfaces


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 Interfaces.

Copyright 2014 - Bizagi

204

Tenga en cuenta que los Traces de interfaces pueden habilitarse en cualquier momento, sin
embargo 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 externo, o si se produjo cuando se

Copyright 2014 - Bizagi

205

realizaban transformaciones de datos a la informacin de Bizagi.

Tipos de Traces
Los siguientes Traces se registran en un orden cronolgico.
Orden
cronolgico

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:
[identificador_del_caso]
_BizAgiSOARequestMapping_[timestamp].json
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:
[identificador_del_caso]
_BizAgiSOARequest_[timestamp].json
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:
SOAP_TraceVersion02_[timestamp].svclog
Ntese que el timestamp se define como:
yyyyMMddHHmm.
En versiones anteriores de Bizagi, se registra el
contenido del XML justo como se enva al servicio
externo pero sin los datos que van en la cabecera de

Copyright 2014 - Bizagi

206

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:
SOAP_TraceVersion02_[timestamp].svclog
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).

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:
[identificador_del_caso]
_BizAgiSOAResponseMapping_[timestamp].json
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).

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:
[identificador_del_caso]
_BizAgiSOAResponse_[timestamp].json
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

Copyright 2014 - Bizagi

207

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.
El time-out arrojado por un servicio se da cuando la invocacin del mismo es ms demorada que su
definicin de time-out (o tiempo de espera).
Cuando el servicio es invocado desde una actividad asncrona, esta definicin se toma del menor
tiempo asignado a cualquiera de las 2 propiedades: el timeout de la actividad asncrona, o el time-out
especfico de la invocacin (dado a la interface a travs de su administracin desde el mdulo de
sistemas).

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 Asynchronous Activities console).
Esto aplica para las actividades asncronas.

2. Habilite los Traces


A traves de Traces, habilite todos los que se utilizan en interfaces.

Copyright 2014 - Bizagi

208

3. Vuelva a ejecutar la invocacin (para obtener el log)


Ejecute un reintento de la invocacin para que se registre un log detallado.
Seguidamente, ubique en la ruta de su servidor BPM en la carpeta SOA, 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 SOAP_TraceVersion02_[timestamp].svclog 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.

Copyright 2014 - Bizagi

209

Configuracin del Servidor Web

Introduccin
Bizagi soporta la ejecucin en una plataforma .NET o JEE.
En un proyecto abierto, Bizagi ofrece la posibilidad de configurar el servidor web que desea usar para
ejecutar los procesos mientras los automatiza (para creacin rpida de prototipos y pruebas).
Esta configuracin no aplica directamente para el ambiente de produccin. Es configurada en Bizagi
Studio para permitirle iniciar el Portal de Trabajo, en cualquier momento, tal y como se presentara a
los usuarios finales en un ambiente final de produccin.

Cul debo elegir?


Para una plataforma .NET, usted puede elegir ejecutar el Portal de Trabajo en una configuracin
completa de Microsoft's Internet Information Services (IIS) o en una configuracin local de IIS Express
installation.

Copyright 2014 - Bizagi

210

Para configurar un entorno de trabajo colaborativo, se recomienda utilizar Internet Information


Services (IIS) como servidor Web.
Para un inicio rpido con Bizagi, til para la creacin de prototipos gile o demos, usted puede
escoger IIS Express.
Para una ejecucin en una plataforma JEE, esta opcin no es aplicable.
A travs de Bizagi JEE Plugin, usted podr ejecutar sus procesos en la instancia local incluida de JBoss
EAP.
Para ms informacin sobre el Plug-in de JEE de Bizagi, consulte Crear un proyecto en la plataforma
JEE.

Utilizando IIS
Internet Information Services (IIS) requiere el Framework de Microsoft's .NET.
Bizagi establece IIS de manera predeterminada cuando este ya est instalado, para usarlo, asegrese
de haberlo configurado correctamente como servidor del proyecto de Bizagi.
En caso de inquietudes sobre cmo configurar IIS, consulte la Configuracin de IIS.
Para establecer el uso de IIS, haga clic en la opcin Servidor Web en la pestaa Configuracin del
Bizagi Studio:

Copyright 2014 - Bizagi

211

Seleccione IIS y haga clic en Ok.

Observe que IIS incluye una casilla de Opciones Avanzadas. Cuando esta es seleccionada, muestra la
opcin para cambiar el puerto 80 establecido por defecto. Este puerto debe ser el mismo que est
configurado en el IIS Manager.

Copyright 2014 - Bizagi

212

Una vez ejecute el proceso desde Bizagi Studio, se cargar en el navegador la URL del Portal de
Trabajo:

Utilizando IIS Express


IIS Express es una versin liviana de Internet Information Server que se ejecuta locamente en sistemas
operativos Windows y tambin, requiere del Framework de Microsoft .NET.

Copyright 2014 - Bizagi

213

Escoger esta opcin como su servidor Web es til en un ambiente de desarrollo donde solo hay un
usuario trabajando en el proyecto y haciendo pruebas y procesos rpidos.
IIS Express no requiere configuracin previa debido a que es instalado junto con Bizagi Studio.
La versin de IIS Express instalada es:
IIS Express, 8.0: Para Windows Server 2012, Windows Server 2008 R2, Windows Server 2008,
Windows 8.1, Windows 8, Windows 7 y Windows Vista,.
IIS Express 7.5: Para Windows XP y Windows Server 2003.

Para usar IIS Express, haga clic en la opcin Servidor Web en la pestaa Configuracin del Bizagi
Studio:

Seleccione IIS Express.


Observe que IIS Express incluye una casilla de Opciones Avanzadas. Cuando esta es seleccionada,
muestra la opcin para cambiar el puerto 1024 establecido por defecto. Recuerde que si su sistema
operativo no tiene instalado Internet Information Server, Bizagi escoger Internet Information Server
Express para desplegar el Web Portal.

Copyright 2014 - Bizagi

214

Si su sistema operativo no tiene instalado Internet Information Server, la opcin para escoger IIS no
estar disponible.
El puerto debe ser mayor o igual a 1024 si el usuario autenticado no tiene privilegios de
administrador.
Haga clic en Ok. Una vez ejecute el proceso desde Bizagi Studio, se cargar en el navegador la URL
del Portal de Trabajo:

Copyright 2014 - Bizagi

215

Limitaciones
IIS Express solo debe ser usado para creacin de prototipos y demos (no para la implementacin
final) esto debido a que tiene las siguientes limitaciones:
El portal de trabajo solo funciona en el computador local (No se publica contenido para acceso
desde un navegador remoto).
Solo se puede desplegar un portal de trabajo al tiempo.
Debido a estas limitaciones, algunas caractersticas de Bizagi no estn soportados mientras se use IIS
Express:
No ser posible usar los servicios SMTP de IIS para opciones avanzadas de notificaciones por email.
No ser posible invocar la capa SOA del proyecto (Bizagi Web Service) de manera remota.
No ser posible probar opciones como: Porvar la conexin al proveedor para configuraciones de
Virtualizacin y Replicacin, Probar la configuracin de una entidad virtual.

Cambio del servidor web


Usted puede cambiar el servidor Web usado por Bizagi en cualquier momento.
Si instal IIS despus de la creacin del proyecto, es probable que su proyecto est usando IIS
Express. Por lo tanto, si desea usar IIS, necesitar configurar explcitamente a IIS como el servidor Web
de su proyecto.
Cambiando esta configuracin, Bizagi actualizar esta informacin para su proyecto y automticamente
recrear el portal de trabajo para el proyecto actual (Como una aplicacin Web en IIS).
Esta aplicacin es creada en IIS en el sitio llamado Default Web Site.

Copyright 2014 - Bizagi

216

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 ejercicio lo guiar a travs de los conceptos bsicos de Bizagi por lo que le
recomendamos hacerlos. 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)

Modelamiento de Proceso
El primer paso para crear soluciones Bizagi es disear el flujo de trabajo (o flujo de Proceso). El flujo
de trabajo, conocido como una cadena de actividades, es la estructura fundamental del proyecto, al
cual se incluyen las variables y elementos necesarios de acuerdo a los requerimientos de la
organizacin.
Usted tiene dos opciones para Disear sus procesos para automatizacin:

1. Disee sus diagramas de proceso usando Bizagi Modeler


(recomendado)
Utilice Bizagi Modeler para disear y documentar sus diagramas de Proceso. Bizagi Modeler es una
aplicacin gratuita, independiente de Bizagi Studio, dedicada a brindarle la mejor experiencia al
momento de disear y documentar flujos de trabajo bajo el estndar BPMN (Business Process Model
and Notation). BPMN es un estndar de reconocimiento mundial para el modelamiento de Procesos.

Escoja esta opcin si usted est interesado en diagramar y documentar procesos,


adicional a su documentacin.

Copyright 2014 - Bizagi

217

Una vez su proceso est completo y listo para automatizar, presione el botn Ejecutar Workflow en la
pestaa Inicio del Modelador. Esto exportar su modelo automticamente al ambiente de
construccin, Bizagi Studio.
Si usted no est familiarizado con Bizagi Modeler consulte la Gua de usuario de Bizagi Modeler

2. Disee sus diagramas de proceso usando el Modelador de


Procesos incluido en Bizagi Studio
Utilice el modelador de Procesos en Bizagi Studio. Este Modelador de Procesos est orientado a
diseo de procesos para automatizacin.

Escoja esta opcin si usted est interesado exclusivamente en automatizacin de


procesos, sin documentacin.
Para ver un ejemplo de cmo diagramar un proceso, vea Crear un Proceso

Copyright 2014 - Bizagi

218

Crear un proceso con Bizagi Studio


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 Supervisor inmediato del empleado aprueba, rechaza o solicita cambios a la Orden (en Bizagi, El
supervisor inmediato ser direccionado a "Boss" para este ejemplo).
Se deben solicitar cotizaciones para seleccionar el Proveedor.
Se crea una Orden de Compra.
El jefe administrativo aprueba, rechaza o modifica la Orden.
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 d clic en la opcin Nuevo Proceso en el paso 1 (Modelo de Proceso)
del asistente.

Copyright 2014 - Bizagi

219

2. Nombre su proceso y luego d 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. Adicione 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.

Copyright 2014 - Bizagi

220

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 Men Circular. Seleccione el siguiente elemento y

Copyright 2014 - Bizagi

221

arrstrelo y sultelo donde desea localizarlo.

6. Para conectar dos elementos en el flujo de secuencia, seleccione el objeto desde le Men Circular y
arrstrelo sobre el segundo elemento, realizando esta accin se conectarn de forma automtica.

Copyright 2014 - Bizagi

222

7. Contine seleccionando 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 2014 - Bizagi

223

La siguiente imagen muestra el diagrama del proceso Solicitud de Compra.

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, d clic en la opcin Editar Proceso. Esto abrir modelador con el
proceso.

Copyright 2014 - Bizagi

224

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

Eliminando elementos
Si necesita eliminar un elemento del diagrama, d 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 2014 - Bizagi

225

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

Copyright 2014 - Bizagi

226

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, d clic derecho sobre la tarea y seleccione
la opcin Transformar en subproceso del men. Repita el procedimiento en la tarea Orden de

Copyright 2014 - Bizagi

227

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.

Copyright 2014 - Bizagi

228

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

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

Copyright 2014 - Bizagi

229

Importar un proceso
Si su proceso ha sido modelado utilizando Bizagi Modeler, 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 d clic en la opcin Importar Proceso.

Copyright 2014 - Bizagi

230

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

Copyright 2014 - Bizagi

231

ASEGRESE DE QUE EL PROCESO HAYA SIDO GUARDADO EN EL FORMATO EXPORTAR A MODELO


DE DIAGRAMAS DE BIZAGI V1.6 ANTES DE IMPORTAR.

Copyright 2014 - Bizagi

232

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

4. Su proceso ser abierto en modo de edicin. Ahora usted est listo para automatizarlo.

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 2014 - Bizagi

233

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

Tarea

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.

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).

NOTACIN

Es una tarea que se ejecuta por un motor de procesos


Tarea de Script 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.
ELEMENTO

DESCRIPCIN

Copyright 2014 - Bizagi

NOTACIN

234

Subproceso
Embebido

Subproceso
Reusable

Subproceso
transaccional

Subproceso
mltiple

Es una actividad cuyos detalles internos han sido


modelados utilizando actividades, compuertas,
eventos y flujos de secuencia. La forma tiene una
borde delgado.

Identifica un punto en el flujo donde se invoca un


proceso pre-definido. Los procesos reutilizables 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.

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

Compuerta Exclusiva

DESCRIPCIN

NOTACIN

De divergencia: Se utiliza para crear caminos


alternativos dentro del proceso, pero solo uno se
selecciona.
De convergencia: Se utiliza para unir caminos
alternativos.

Compuerta Basada
en Eventos

Representa un punto de ramificacin en los


procesos donde los caminos alternativos que siguen
la compuerta estn basados en eventos que
ocurren.
Cuando el primer evento se dispara, se usar el
camino que sigue a ese evento. Los caminos
restantes sern deshabilitados.

Copyright 2014 - Bizagi

235

De divergencia: Se utiliza para crear caminos


alternativos sin evaluar condicin alguna.
Compuerta Paralela

Compuerta
Compleja

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.

Compuerta Inclusiva

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.

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.

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

DESCRIPCIN

Evento de Inicio
Simple

Indica dnde se inicia un proceso. No tiene algn


comportamiento particular.

Copyright 2014 - Bizagi

NOTACIN

236

Evento de Inicio de
Mensaje

Evento de Inicio de
Temporizacin

Evento de Inicio de
Seal

Se utiliza cuando el inicio de un proceso se da al


recibir un mensaje de un participante externo.

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.

Eventos Intermedios
ELEMENTO

DESCRIPCIN

Evento Intermedio
Simple

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.

NOTACIN

Indica que un mensaje puede ser enviado o


recibido.

Evento de Mensaje

Si un proceso est esperando un mensaje y ste es


capturado, el proceso continuar su flujo. El
marcador de eventos en esta instancia estar lleno.
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.

Evento de
Temporizacin

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.

Evento de Enlace
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

Copyright 2014 - Bizagi

237

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
corresponde a cul.

Evento de Seal

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.
Si el evento es usado para capturar la seal, la
marca del Evento de Seal estar rellena.
Alternativamente, el marcador del evento vaco
estar en el encargado de enviar la seal.

Eventos Intermedios adjuntos a los lmites de una Actividad


ELEMENTO

Evento
Temporizador

DESCRIPCIN

NOTACIN

Si un Evento Temporizador 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.
Un Evento Intermedio de Error solo puede ser
adjunto a los lmites de una actividad.

Evento de Error

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.

Evento de
Cancelacin

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 mientras

Copyright 2014 - Bizagi

238

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.

Evento de
Compensacin

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.

Eventos de Finalizacin
ELEMENTO
Finalizacin simple

DESCRIPCIN

NOTACIN

Indica que el flujo finaliza.

Finalizacin de
Mensaje

Indica que se enva un mensaje una vez finaliza el


flujo.

Finalizacin de Error

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.

Finalizacin de
Cancelacin

Se utiliza dentro de un Subproceso de transaccin e


indica que ste debe ser cancelado.

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

Copyright 2014 - Bizagi

NOTACIN

239

Grupo

Es un artefacto que provee un mecanismo visual


para agrupar elementos de un diagrama de manera
informal.

Anotacin

Son mecanismos para que un modelador provea


informacin adicional, al lector de un diagrama
BPM.

Objetos de datos

Proveen informacin sobre cmo documentos,


datos y otros objetos son utilizados y actualizados
durante el proceso.

Carriles (Swim lanes)


ELEMENTO

Contenedor (Pool)

DESCRIPCIN

NOTACIN

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 existir al menos un pool.

Carril (Lane)

Es una sub-particin dentro del proceso. Los lanes


se utilizan para diferenciar roles internos,
posiciones, departamentos, etc.

Fase

Es una sub-particin dentro del proceso. Puede


indicar diferentes etapas durante el mismo.

Conectores
ELEMENTO

DESCRIPCIN

Flujo de Secuencia

Un flujo de secuencia es utilizado para mostrar el


orden en el que las actividades se ejecutarn dentro
del proceso.

Asociacin

Se utiliza para asociar informacin y artefactos con


objetos de flujo. Tambin se utiliza para mostrar las
tareas que compensan una actividad.

Copyright 2014 - Bizagi

NOTACIN

240

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
Bizagi Modeler.
Descargue nuestro Poster de BPMN 2.0

Propiedades de las figuras


En Bizagi Modeler, 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 d clic derecho sobre la figura y seleccione la opcin Propiedades.
Las siguientes secciones describen las propiedades para cada figura.

Copyright 2014 - Bizagi

241

Propiedades de los Procesos


Para mostrar las Propiedades del Proceso, d clic en el nombre del Proceso y seleccione la opcin
Propiedades. Se mostrar la siguiente tabla:

PROPIEDAD

DESCRIPCIN

Nombre de Mostrar

El nombre del Proceso que se mostrar en el Portal de Trabajo. Este se


puede cambiar a travs de la Vista de Mdulos.

Nombre

El nombre del proceso. No se permiten espacios ni caracteres especiales.


No se puede cambiar.

Descripcin

Incluya una descripcin para el proceso. Esta descripcin se mostrar


cuando se creen nuevos casos.

Texto de Ayuda
URL de Ayuda
Categora

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.

Copyright 2014 - Bizagi

242

Tipo de Acceso

Proceso: Permite a los usuarios finales crear nuevas instancias de casos


en el Portal de Trabajo.
Mdulo: Directamente relacionado a los Subprocesos Embebidos. Si un
proceso es embebido debera tener este tipo de acceso. Los usuarios
finales no pueden crear casos de estos Procesos en el Portal de Trabajo.
Solo Subproceso: Directamente relacionado a los Subprocesos
reutilizables. Los usuarios finales no pueden crear instancias de estos
Procesos en el Portal de Trabajo.

Orden

Define el orden en el cual los procesos se mostrarn para crear nuevos


casos en el Portal de Trabajo. Aplica para cada aplicacin individualmente.

Forma Global

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.

Forma de Resumen

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 de Resumen.

Usar nmero de caso


del Padre

Esta opcin permite mostrar un nmero de caso nico tanto para el


Proceso padre como para todos sus Subprocesos. Si esta casilla no esta
marcada, el Subproceso mostrar un nmero de caso diferente al del
Proceso padre.

Habilitar Alarmas

Habilita las alarmas configuradas para enviar notificaciones de alarma. Si


esta opcin est deshabilitada, las alarmas configuradas no enviarn
correos electrnicos.

Habilitar Notificaciones

Habilita el envo de las notificaciones configuradas. Si esta opcin est


deshabilitada, las notificaciones configuradas no enviarn correos
electrnicos.

Versin

Versin del Proceso.

Estado

El estado del proceso (activo/inactivo). Si esta opcin est habilitada, el


proceso se habilitar para su uso (si es un Subproceso o mdulo) y estar
disponible para creacin de casos (si es un proceso). Si se encuentra
inactivo, no podr ser utilizado.

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.
diseadas con la ayuda del
Nombre: Es el nombre de la actividad en
Modelador de Formas.

Copyright 2014 - Bizagi

243

la base de datos.
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.
Cada tarea tiene un ejecutante.
Para definir quien ejecuta cada
actividad se debe definir una
Regla de Asignacin.

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.
Acceso mvil: Habilita la tarea para ser
ejecutada desde dispositivos mviles.

Copyright 2014 - Bizagi

244

Mensaje de finalizacin de tarea: Define


el mensaje que se muestra cuando la
tarea se termina y el usuario asignado no
tiene ms tareas pendientes en el caso. Si
no se define un mensaje se muestra la
Forma Global.
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.
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.

Las tareas de servicio son tareas


que son ejecutadas por el
sistema sin intervencin alguna
del usuario final.

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 se lanza un error.
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.

Copyright 2014 - Bizagi

245

Tiempo de Espera: Permite definir el


tiempo mximo (en segundos), en que se
permite la ejecucin de la tarea; el sistema
de forma automtica cancela la operacin
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
Propiedades bsicas
Mensaje, es necesario que exista
una tarea que atrape el mensaje.
Nombre visual: Es el nombre de la
Es posible utilizar un Evento
actividad que se muestra en el Portal de
Intermedio de Mensaje, un
Trabajo.
Mensaje de Inicio o una Tarea de
Recepcin.
Nombre: Es el nombre de la actividad en
la base de datos.
Las tareas de envo deben ser
configuradas para identificar el
Descripcin:
Muestra
informacin
proceso objetivo y el elemento
adicional sobre la tarea.
objetivo.
Los eventos de lanzar y recibir
mensajes deben tener el mismo
nombre y deben estar en
procesos diferentes.
Propiedades bsicas

Las tareas de script son


automticas utilizadas por Bizagi
para
enviar
notificaciones
personalizadas
(correos
electrnicos).

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.
Descripcin:
Muestra
adicional sobre la tarea.

informacin

Es es una Tarea que se espera Propiedades bsicas


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

Copyright 2014 - Bizagi

246

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.

la base de datos.
Descripcin:
Muestra
adicional sobre la tarea.

informacin

Propiedades de las Compuertas

ELEMENTO

Compuerta
Exclusiva

CONSIDERACIONES

Cuando dos o ms transiciones Propiedades bsicas


salen de la figura, al menos uno de
Nombre visual: Es el nombre de la
los caminos debe ser configurado
compuerta que se muestra en el Portal
con la validacin Sino. Las otras
de Trabajo.
salidas de secuencia deben tener
condiciones de negocio para que
Nombre: Es el nombre de la compuerta
Bizagi evalu y decida que camino
en la base de datos. Este nombre no
tomar. Solo se puede escoger uno
puede ser modificado.
de los caminos disponibles.
Esta figura est asociada a la
sincronizacin de caminos. El
primer token que alcance la figura
continuar por el flujo.
Una transicin
compuerta no
Subproceso,
Subproceso o
exclusiva.

Compuerta
basada en
eventos.

Compuerta
Paralela

PROPIEDADES

Descripcin:
Muestra
informacin
adicional sobre la compuerta.

que salga de esta Propiedades bsicas


puede entrar a un
Nombre visual: Es el nombre de la
a
un
mltiple
compuerta que se muestra en el Portal
a una compuerta
de Trabajo.

Es posible utilizar las siguientes


figuras luego de la compuerta
basada
en
eventos:
Tareas,
Eventos, compuertas paralelas.

Nombre: Es el nombre de la compuerta


en la base de datos.
Descripcin:
Muestra
informacin
adicional sobre la compuerta.

Los caminos que salen de la figura Propiedades bsicas


no requieren reglas de negocio ya
que se deben seguir todos los
Nombre visual: Es el nombre de la
caminos.
compuerta que se muestra en el Portal
de Trabajo.
Cuando la compuerta es utilizada
como
elemento
convergente
Nombre: Es el nombre de la compuerta
(sincronizacin) se contina solo
en la base de datos.
por un camino, de forma contrara,

Copyright 2014 - Bizagi

247

ELEMENTO

CONSIDERACIONES

PROPIEDADES

cuando de utiliza como elemento


divergente existen muchos caminos
para continuar.
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.

Compuerta
compleja

Descripcin:
Muestra
informacin
adicional sobre la compuerta.

Cuando un proceso alcanza este


elemento, se presenta una interfaz
al usuario final donde se muestran
el nombre de las actividades que Propiedades bsicas
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.
La interfaz de usuario debe ser
Nombre: Es el nombre de la compuerta
configurado como una forma de
en la base de datos.
actividad.
Descripcin:
Muestra
informacin
adicional sobre la compuerta.

Cuando se utiliza la compuerta


como elemento divergente, la
condicin
de
negocio
ser
evaluado cada vez que una
transicin alcance la figura.

Compuerta
inclusiva

Cuando se utiliza una compuerta


inclusiva como elemento divergente
se debe asegurar que al menos un
camino
sea
valido.
Le
recomendamos
incluir
una
transicin definida con la condicin
Sino para continuar el proceso si
ninguna condicin es cumplida.

Propiedades bsicas
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.

Descripcin:
Muestra
informacin
Cuando se utilice como elemento
adicional sobre la compuerta.
divergente, al menos un camino
debe ser activado para continuar
Propiedades Extendidas
con el flujo del proceso.
Expresiones o acciones: Se

Copyright 2014 - Bizagi

pueden

248

ELEMENTO

CONSIDERACIONES

PROPIEDADES

Cuando se utiliza la compuerta


como elemento convergente, ms
de un camino puede llegar a ella,
pero solo puede tener un camino
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.

asociar expresiones Al Entrar o Al Salir


de la compuerta.

Propiedades del Evento de Inicio


ELEMENTO

Evento de
Inicio

Evento de
Inicio de
Mensaje

CONSIDERACIONES

PROPIEDADES

Todos los flujos de procesos deben


tener un inicio, independientemente
que estn contenidos en un Proceso o Propiedades bsicas
en un Subproceso.
Nombre visual: Es el nombre del
Solamente un flujo de procesos puede
evento que se muestra en el Portal de
salir de esta forma. Un Evento de Inicio
Trabajo.
no puede tener flujos de secuencia de
Nombre: Es el nombre del evento en
entrada.
la base de datos.
Un diagrama de procesos pude tener
Descripcin: Muestra informacin
mltiples eventos de inicio pero solo
adicional sobre el evento.
uno de cada tipo. Es decir, el Evento de
Inicio solo puede aparecer una vez
dentro del proceso.
El Evento de Inicio de Mensaje siempre Propiedades bsicas
es una figura que captura. Es decir,
para utilizar un Evento de Inicio de
Nombre visual: Es el nombre del
Mensaje es necesario que exista un
evento que se muestra en el Portal de
Evento de Mensaje que enve el
Trabajo.
mensaje.
Nombre: Es el nombre del evento en
La figura dentro del Proceso que enva
la base de datos.
el mensaje debe ser configurada para
Descripcin: Muestra informacin
que identifique el Proceso y el
adicional sobre el evento.
Elemento objetivo.

Copyright 2014 - Bizagi

249

ELEMENTO

CONSIDERACIONES

PROPIEDADES

El Evento Intermedio que lanza el


mensaje y el Evento de Inicio de
Mensaje que atrapa el mensaje deben
tener el mismo nombre.
Propiedades bsicas

Evento de
Inicio de
Temporizaci
n

Un Subproceso no pude tener un


Evento de Inicio de Temporizacin.

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.
Schedule: Es el momento en que el
caso ser iniciado.

Evento de
Inicio de
Seal

El Evento de Inicio de Seal siempre es


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

Propiedades del Evento Intermedio


ELEMENTO

CONSIDERACIONES

PROPIEDADES
Propiedades bsicas

Evento
Intermedio

Ninguna.

Nombre visual: Es el nombre del


evento que se muestra en el Portal
de Trabajo.
Nombre: Es el nombre del evento

Copyright 2014 - Bizagi

250

ELEMENTO

CONSIDERACIONES

PROPIEDADES
en la base de datos.
Descripcin: Muestra informacin
adicional sobre el evento.
Reasignar: 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
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 pueda cambiar al flujo
de manejo de excepcin.
Para poder utilizar un Mensaje de envo
de captura, es necesario que exista un
Evento de Mensaje que enve el mensaje,
este puede ser un Evento Intermedio de
Mensaje o puede ser un Evento
Intermedio de Inicio.
Evento de
Mensaje

La figura en el proceso que enva el


mensaje debe ser configurada para
identificar el Proceso y el Elemento
objetivo.

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.
Descripcin: Muestra informacin
adicional sobre el evento.

El evento que lanza el mensaje y el evento

Copyright 2014 - Bizagi

251

ELEMENTO

CONSIDERACIONES

PROPIEDADES

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.

Evento
Temporizacin

La duracin o el tiempo asociado al


Evento Intermedio de Temporizacin
puede ser fijo o variable y debe ser
definido en minutos. Los minutos
Propiedades bsicas
asignados corresponden al tiempo que
debe esperar el evento para su
Nombre visual: Es el nombre del
lanzamiento. Por ejemplo, si el flujo del
evento que se muestra en el Portal
proceso llega a un
Evento
de
de Trabajo.
Temporizacin, cuya duracin ha sido
definida como 120 minutos, a las 17:00
Nombre: Es el nombre del evento
(5:00 p.m.) del viernes y los turnos de
en la base de datos.
trabajo han sido definidos de Lunes a
Viernes de 9:00 (9:00 a.m.) a 17:00 (5:00
Costo: Indica el costo del evento.
p.m.), el Proceso espera hasta el Lunes en
la maana para continuar con las
Duracin: El tiempo en minutos
actividades.
que debe transcurrir antes del
lanzamiento
del
evento.
El
Para que la figura pueda funcionar de
calendario asociado al Esquema
forma adecuada, el servicio de Scheduler
de Tiempo de Trabajo de la
(Scheduler service) de la aplicacin
organizacin se considera para
correspondiente debe estar habilitada.
este clculo.
Para ms informacin sobre cmo
configurar Evento de Temporizacin
visite Duracin de Temporizadores.

Evento de
enlace

Solo es posible utilizar Eventos de Enlace


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

Copyright 2014 - Bizagi

252

ELEMENTO

CONSIDERACIONES

PROPIEDADES

Los Eventos de Enlace de captura y de


lanzamiento deben tener el mismo
nombre.
La seal es enviada a todas las figuras
Propiedades bsicas
que puedan recibirla, es decir, deben
tener el mismo nombre. Este tipo de seal
Nombre visual: Es el nombre del
no tiene un objetivo especfico, cualquier
evento que se muestra en el Portal
figura de captura ser activada con el
de Trabajo.
lanzamiento el la seal.

Evento de
Seal

Esta figura tiene las opciones de lanzar y


atrapar, es decir, es posible lanzar una
Seal o recibir la seal. Cuando se utiliza
como seal de lanzamiento, la figura es
rellena, cuando se utiliza como seal que
atrapa la figura va sin rellenar.

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 intermedio adjuntos a los lmites de una actividad


ELEMENTO

CONSIDERACIONES

PROPIEDADES
Propiedades bsicas

Si la figura se utiliza para controlar el


tiempo de una Actividad Manual, la figura
ser diagramada sobre la actividad.

Evento de
Temporizacin

Evento de
Error

Cuando se activa el evento, la actividad al


cual esta adjunto ser interrumpida.

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.
Costo: Indica el costo del evento.

Para ms informacin sobre cmo


configurar Evento de Temporizacin
visite Para ms informacin sobre cmo
configurar Evento de Temporizacin
visite

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.

El evento reacciona para atrapar un error Propiedades bsicas


especfico, o cualquier error si no se ha
Nombre visual: Es el nombre del
especificado ningn nombre para el
evento que se muestra en el Portal
evento.
de Trabajo.
Un evento de error siempre interrumpe la
Nombre: Es el nombre del evento
actividad a la cual est adjunto.

Copyright 2014 - Bizagi

253

ELEMENTO

CONSIDERACIONES

PROPIEDADES
en la base de datos.

Para ms informacin visite Subprocesos


Transaccionales

Descripcin: Muestra informacin


adicional sobre el evento.

Este evento es utilizado en los


Subprocesos transaccionales y debe ser
adjunto a sus lmites.

Evento de
Cancelacin

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.

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.
Descripcin: Muestra informacin
adicional sobre el evento.

Para ms informacin visite Subprocesos


Transaccionales.

Evento de
Compensacin

El evento se utiliza para capturar el Evento Propiedades bsicas


de compensacin. Cuando esto ocurre,
Nombre visual: Es el nombre del
una Actividad de Compensacin ser
evento que se muestra en el Portal
ejecutada.
de Trabajo.
Para ms informacin visite Subprocesos
Nombre: Es el nombre del evento
Transaccionales.
en la base de datos. Este nombre
no puede ser modificado.
Descripcin: Muestra informacin
adicional sobre el evento.

Propiedades del Evento de Fin


ELEMENTO

Evento de Fin sin


especificar.

CONSIDERACIONES

PROPIEDADES

El evento de finalizacin no puede Propiedades bsicas


tener flujos de salida.
Nombre visual: Es el nombre del
El Evento de fin verifica si hay o no
evento que se muestra en el
hay actividades pendientes (tokens)
Portal de Trabajo.

Copyright 2014 - Bizagi

254

ELEMENTO

CONSIDERACIONES

PROPIEDADES

para cada caso. Si no existe ninguna


actividad pendiente, el Procesos se
cerrara automticamente.
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.

Nombre: Es el nombre
evento en la base de datos.

del

Descripcin:
Muestra
informacin adicional sobre el
evento.

El Evento de fin terminal es una figura


opcional
para
diagramar
los
procesos.
Sin
embargo,
es
recomendable su uso.
Evento de Fin de Mensaje siempre es
una figura de lanzamiento. Es decir,
Propiedades bsicas
para poder utilizar un Evento de Fin
de Mensaje es necesario que exista
Nombre visual: Es el nombre del
un Evento de Inicio de Mensaje o un
evento que se muestra en el
Evento Intermedio de Mensaje que
Portal de Trabajo.
escuche el mensaje.
Evento Fin de
Mensaje

El Evento de Fin de Mensaje debe ser


configurado para identificar el
Proceso y el Elemento objetivo.
La figura que captura el mensaje y el
Evento de Fin de Mensaje deben
tener el mismo nombre.

Nombre: Es el nombre
evento en la base de datos.

del

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.
Evento de Error

Nombre: Es el nombre
evento en la base de datos.

del

Descripcin:
Muestra
informacin adicional sobre el
evento.

Copyright 2014 - Bizagi

255

ELEMENTO

CONSIDERACIONES

PROPIEDADES
Propiedades bsicas
Nombre visual: Es el nombre del
evento que se muestra en el
Portal de Trabajo.

Evento de
Cancelacin

Ninguna.

Nombre: Es el nombre
evento en la base de datos.

del

Descripcin:
Muestra
informacin adicional sobre el
evento.
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
Intermedio de Seal que escuche el
Propiedades bsicas
mensaje

Evento de seal

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 seal.
El Evento de Fin de Seal debe ser
configurado para identificar el
Proceso y el Elemento objetivo.

Nombre visual: Es el nombre del


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

del

Descripcin:
Muestra
informacin adicional sobre el
evento.

La figura que captura la seal y el


Evento de Fin de Seal deben tener el
mismo nombre.
Propiedades bsicas
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.

Copyright 2014 - Bizagi

Nombre visual: Es el nombre del


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

del

Descripcin:
Muestra
informacin adicional sobre el
evento.

256

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.
Descripcin:
Muestra
informacin adicional sobre el
contenedor.
Texto de Ayuda: En esta opcin,
el usuario puede configurar un
texto de ayuda
para
la
actividad.

Contenedor
(Pool)

Un proceso debe estar


completamente
dentro
contenedor.

contenido
de
un

URL de Ayuda: En esta opcin,


el usuario puede configurar una
URL que contenga un texto de
ayuda para el contenedor.
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

Copyright 2014 - Bizagi

257

ELEMENTO

CONSIDERACIONES

PROPIEDADES
habilita solo un nmero de caso
para el Proceso padre y sus
subprocesos. Si la opcin no
est 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.
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.

El primero carril del proceso es creado Propiedades bsicas


automticamente cuando se crea el
proceso.
Nombre visual: Es el nombre

Copyright 2014 - Bizagi

258

ELEMENTO

CONSIDERACIONES

PROPIEDADES
del carril (lane) que se muestra
en el Portal de Trabajo.

Carril (Lane)

Todas las figuras deben pertenecer a


algn carril.

Nombre: Es el nombre del carril


en la base de datos. Este
nombre
no
puede
ser
modificado.
Descripcin:
Muestra
informacin adicional sobre el
carril.

Todas las figuras deben pertenecer a


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

Fase (Milestone)

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.

Descripcin:
Muestra
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.

Propiedades de los Conectores


ELEMENTO

CONSIDERACIONES

PROPIEDADES

Se representan con una flecha que Propiedades bsicas


indica el desde y el hasta
Flujo Normal:
Flujo de secuencia

La

lnea

normal

se

utiliza

Copyright 2014 - Bizagi

para

Nombre visual: Es el nombre


del flujo de secuencia que se
muestra en el Portal de
Trabajo.

259

ELEMENTO

CONSIDERACIONES

PROPIEDADES

representar el flujo entre dos actividades


que no es afectado por condiciones. El
uso ms simple para esta figura es la
secuencia entre dos actividades.
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
las condiciones son falsas al mismo
tiempo.

Nombre: Es el nombre del flujo


de secuencia en la base de
datos.
Descripcin:
Muestra
informacin adicional sobre el
flujo de secuencia.

Una vez que la condicin Sino (Else) se


ha asignado a una transicin, la fecha es
mostrada como la figura anterior.
Propiedades bsicas

Asociacin

Se utiliza para asociar informacin y


Artefactos con los objetos del flujo del
proceso. Tambin se utiliza en las
actividades de compensacin.

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.
Descripcin:
Muestra
informacin adicional sobre la
Asociacin.

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. El proceso ms grande se conoce como proceso Padre y el Subproceso como proceso hijo.
Cuando una instancia del Subproceso es creada, el proceso hijo hereda el nmero del caso del
proceso padre. Esto ayuda a identificar qu Subproceso pertenece a cul padre. Usted puede

Copyright 2014 - Bizagi

260

configurar que se herede o no el nmero del caso en Usar nmero de caso padre.
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. Esto ser explicado en detalle en las siguientes
secciones.
Un Subproceso puede ser representado de forma expandida o colapsada:

Subproceso Expandido
Cuando un Subproceso est expandido, 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.

Subproceso Colapsado
Cuando un Subproceso esta colapsado, los detalles del Subproceso no pueden ser vistos. El signo
ms (+) 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.

Copyright 2014 - Bizagi

261

Todos los diagramas modelados en Bizagi pueden ser Subprocesos.

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.

Los
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.
Subproceso
Embebido

Los Subprocesos Embebidos no


estn
diseados
para
ser
reutilizables.
No pueden ser usados
Subprocesos mltiples.

como

Nombre: Es el nombre de la actividad


en la base de datos.
Descripcin: Muestra
adicional sobre la tarea.

informacin

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

Copyright 2014 - Bizagi

262

ELEMENTO

CONSIDERACIONES

PROPIEDADES
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 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.
Portal de Trabajo.
o Si se selecciona la opcin
standalone, el Proceso padre
Nombre: Es el nombre del Subproceso
contina con la siguiente actividad
en la base de datos.
en el momento que inicie el
Subproceso.
Descripcin: Muestra informacin
adicional sobre del Subproceso.
Los Subprocesos reutilizables no
pueden ser transaccionales y no
pueden ser configurados como un
Subprocesos mltiple.
Propiedades bsicas
Se debe asociar eventos de Error,
de Cancelacin y de Compensacin
al Subproceso Transaccional.

Subproceso

Copyright 2014 - Bizagi

Nombre visual: Es el nombre del


Subproceso que se muestra en el
Portal de Trabajo.

263

ELEMENTO

CONSIDERACIONES

PROPIEDADES

Nombre: Es el nombre del Subproceso


en la base de datos.

Transaccional

Descripcin: Muestra
informacin
adicional sobre del Subproceso.
Pueden ser creados de dos formas: Propiedades bsicas
de forma Secuencial o en Paralelo.
Nombre visual: Es el nombre del
Los Subprocesos mltiples paralelos
Subproceso que se muestra en el
se representan con tres lneas
Portal de Trabajo.
horizontales
Los
Subprocesos
mltiples
secuenciales se representan con tres
Subproceso
Mltiple

lneas verticales

Nombre: Es el nombre del Subproceso


en la base de datos.
Descripcin: Muestra
informacin
adicional sobre del Subproceso.

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

El diagrama representa el Proceso de Solicitud de Compras. Vamos a transformar la tarea Cotizaciones


en un Subproceso Embebido.
1. En el primer paso del Asistente de Procesos de Bizagi, clic en la opcin Editar Proceso.

Copyright 2014 - Bizagi

264

2. Haga clic derecho sobre la actividad que desea convertir en el Subproceso embebido, en este caso,
la tarea Cotizaciones y seleccione la opcin Transformar en Subproceso.

Copyright 2014 - Bizagi

265

3. El asistente de la configuracin del Subprocesos aparecer en una nueva ventana y muestra los tipos
de Subproceso. Seale la opcin Embebido y d clic en el botn Siguiente.

Copyright 2014 - Bizagi

266

4. Ingrese el nombre del Nuevo proceso o seleccione un proceso existente desde la lista desplegable,
luego d clic en Finalizar.

Copyright 2014 - Bizagi

267

5. Una vez se ha creado el Subproceso, usted podr editarlo.


Clic derecho en el recin creado Subproceso (Cotizaciones) y seleccione la opcin Editar Subproceso.

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.

Copyright 2014 - Bizagi

268

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

El Subproceso embebido Cotizaciones 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 2014 - Bizagi

269

formas asociadas al Subproceso.

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 de que la opcin Mdulo est seleccionada en la opcin de Tipo de Acceso.

Estos Subprocesos siempre deben tener la misma Entidad de Proceso que el proceso padre con
el fin de funcionar correctamente. Cuando un caso entra en un Subproceso embebido, la
informacin del proceso padre estar disponible en la misma navegacin XPath. La navegacin de
datos no cambia de un proceso al otro.
Todos los eventos y tareas en el Subproceso deben terminarse para que el Subproceso pueda
cerrarse. Si hay tareas pendientes el Subproceso no se cerrar, incluso llegando a un Evento de
Fin Terminal.

Subprocesos Reusables
Para mostrar cmo transformar una tarea en un Subproceso Reutilizable, utilizaremos el siguiente
diagrama:

Copyright 2014 - Bizagi

270

El diagrama representa el Proceso de Solicitud de Compras. Vamos a transformar la tarea Orden de


Compra en un Subproceso Reutilizable.
1. En el primer paso del Asistente de Procesos de Bizagi, clic en la opcin Editar Proceso.

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

Copyright 2014 - Bizagi

271

tarea Cotizaciones y seleccione la opcin Transformar en Subproceso.

3. El asistente de la configuracin del Subprocesos aparecer en una nueva ventana y mostrar los
tipos de Subproceso. Seale la opcin Reusable y d clic en el botn Siguiente.

Copyright 2014 - Bizagi

272

4. El modelo del Proceso que se va asignar como Subproceso Reutilizable debe existir (Debe crear el
proceso a travs del paso 1 del asistente de Procesos de Bizagi).
Seleccione Orden de Compra de la lista desplegable y clic en Siguiente.

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 Orden de Compra debe finalizar antes de que el Proceso Solicitud de
Compra termine, por lo tanto se selecciona el modo Integrado.

Copyright 2014 - Bizagi

273

6. Finalmente d clic en Finalizar. El Subproceso


exitosa.

Orden de Compra quedo configurado de forma

El Subproceso Reutilizable debe tener definido como tipo de acceso 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 de que la opcin Proceso o Solamente Subproceso este seleccionada.

Copyright 2014 - Bizagi

274

Manejando entidades de sub-procesos


Los Subprocesos pueden o no tener la misma Entidad de Proceso que su proceso padre. Por lo tanto,
para acceder a la informacin del caso padre desde el Subproceso se debe tener en cuenta el
contexto de los procesos para evaluar cmo navegar el modelo de datos.
Los Subprocesos reutilizables pueden o no tener la misma Entidad de Proceso que el proceso padre.
Si el Subproceso tiene la MISMA Entidad de Proceso que el padre, la informacin del proceso padre
estar disponible exactamente en el mismo XPath. La navegacin de datos no cambia de un proceso
al otro.
Si NO tienen la misma Entidad de Proceso:
Los datos del proceso padre no estn disponibles desde el Subproceso.
Para hacer que la informacin del Proceso Padre est disponible desde el Subproceso, se debe definir
un 'mapeo' antes de ingresar al Subproceso. La informacin del Proceso Padre que debe estar
disponible en el Subproceso debe ser definida y relacionada antes de ingresar. Por lo tanto, se deben
crear nuevos atributos en el Subproceso para poder mapearlos.

Acceder a la informacin del Proceso Padre desde el Subproceso


Suponga que tenemos los siguientes Procesos:
Proceso Padre: Invoice (cuya Entidad de Proceso es Invoice)
Subproceso Reusable: Payments (cuya Entidad de Proceso es Payment).

Copyright 2014 - Bizagi

275

En el Proceso Padre los atributos se acceden navegando : <Invoice.TotalAmount>


En el Subproceso, los atributos se acceden navegando: <Payment.PaymentOption>
Observe que el punto de partida es diferente debido a que la entidad de Proceso es diferente. Por
esto decimos que el contexto es diferente.
Para hacer que la informacin necesaria del Proceso Invoice est disponible desde el Subproceso
Payment, siga estos pasos:
1. Usted necesita una relacin entre las entidades de ambos Procesos, en el Modelo de Datos.
Cree el atributo Payment en la Entidad Invoice y relacinelo a la entidad del Subproceso (Payment):

2. Identifique los atributos del Proceso Padre que se deben mostrar en el Subproceso.
Crelos en la entidad principal del Subproceso.
En este caso queremos mostrar el Invoice amount y el Invoice Due Date del Proceso Padre, en las
formas del Subproceso.
Por lo tanto, creamos dos nuevos atributos en la entidad Invoice, llamados Payment Amount y
Payment Due Date para mapearlos.

Copyright 2014 - Bizagi

276

3. Cree una expresin como una accin a la entrada del Subproceso (presionando la tecla shift
mientras hace clic sobre el Subproceso).

4. Cree un elemento de expresin.


Asocie (mapee) la informacin del Proceso Padre que se utilizar en el Subproceso.

Copyright 2014 - Bizagi

277

4. Finalmente asocie la instancia de la entidad del Subproceso, al atributo en la entidad del proceso
padre utilizado para referenciarlo.

Copyright 2014 - Bizagi

278

//Asocie la informacin a reutilizar


<Invoice.Payment.PaymentAmount>=<Invoice.InvoiceAmount>;
<Invoice.Payment.PaymentDueDate>=<Invoice.InvoiceDueDate>;
//Asocie la instancia del Sub-proceso al Proceso Padre
<Payment> = <Invoice.Payment>;
La informacin del Proceso Padre podr accederse ahora desde el Subproceso.

Si se necesita actualizar informacin del proceso padre con datos ingresados en el subproceso, es
necesario crear una regla a la salida del Subproceso y mapear la informacin requerida.
Por ejemplo si queremos actualizar el atributo InvoiceAmount la expresin ser la opuesta al
mapeo de entrada, y se ver as:
<Invoice.InvoiceAmount> = <Payment.PaymentAmount>

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
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 realizan la solicitud de inscripcin. El segundo
proceso 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.

Copyright 2014 - Bizagi

279

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:
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, es decir, el proceso Matrcula de Estudiantes.

Copyright 2014 - Bizagi

280

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 (Matrcula de Estudiantes).
La
relacin
ser
(StudentsApplication.StudentsEnrollment).

InscripciondeEstudiantes.MatriculaEstudiante

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.

Copyright 2014 - Bizagi

281

Si el proceso (o Subproceso) 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 Subproceso mltiple de
forma manual.
Clic para ms informacin sobre cmo definir una Entidad de Proceso.

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.
tems 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 Subproceso) 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
Subproceso mltiple de forma manual.

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

Secuencial

IMPORTANTE:
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.

Copyright 2014 - Bizagi

282

Si la opcin Agrupar por es seleccionada, solamente puede seleccionarse 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 y 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 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 Subproceso son la misma
entidad, sin embargo, algunas veces no. Cuando la entidad de negocio del Subproceso difiere de la
entidad Coleccin, el asistente mostrara una 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

Copyright 2014 - Bizagi

283

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 Subproceso, Grade planning, tienen su
entidad de proceso llamada Planning. Por lo tanto la coleccin que crear los casos es diferente de la
entidad del Subproceso:
Entidad de coleccin: Grades
Entidad de Subproceso: 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

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

Copyright 2014 - Bizagi

284

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

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

Copyright 2014 - Bizagi

285

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.

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 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:

Copyright 2014 - Bizagi

286

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 Bizagi Modeler y se han definido sus Entidades de Proceso
respectivas.
Ingreso de Estudiantes es la Entidad de Proceso del proceso Ingreso de Estudiantes y Matrcula de
Estudiantes el la Entidad de Proceso del proceso Matrcula de Estudiantes.
Para crear la relacin de las instancias del Subproceso mltiple se debe definir una coleccin: La
coleccin llamada Matrcula de Estudiantes.

Copyright 2014 - Bizagi

287

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. Vaya al paso uno del Asistente de Procesos (Modelar Proceso) y haga clic en Editar Proceso.
Seleccione el proceso padre llamado Ingreso de Estudiantes.

Copyright 2014 - Bizagi

288

2. En el diagrama, d clic derecho en la tarea que desea convertir, en este caso Matrcula de
Estudiantes y seleccione la opcin Transformar en Subproceso.

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

Copyright 2014 - Bizagi

289

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 2014 - Bizagi

290

5. Para utilizar la configuracin Bsica del Subproceso Mltiple d clic en Siguiente sin marcar la
opcin de Configuracin Avanzada.

Copyright 2014 - Bizagi

291

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 2014 - Bizagi

292

7. Clic en Finalizar

Copyright 2014 - Bizagi

293

El Subproceso Matrcula de Estudiantes ha sido configurado de forma exitosa.

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.

Navegando el modelo de datos desde el Subproceso se puede obtener informacin del Proceso
padre que puede ser til cuando se crea una expresin o cuando una forma necesita incluir
informacin del proceso padre.
Por ejemplo, suponga que necesitamos acceder a tres atributos del Proceso padre, Nombre, Apellido
y Curso 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.

Copyright 2014 - Bizagi

294

Los XPath sern:


<StudentApplication.Grade>
<StudentApplication.Name>
<StudentApplication.LastName>

Cuando se crea y se asocia una expresin con una actividad dentro del Subproceso Mltiple, 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).

Configuracin avanzada para los Subprocesos mltiples


Las opciones avanzadas del Asistente de configuracin del Mltiple Subproceso tienen algunas
propiedades especiales en algunos escenarios:

Copyright 2014 - Bizagi

295

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).
Los 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 la casilla
Configuracin Avanzada.

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 2014 - Bizagi

296

En este ejemplo el Proceso Padre se llama Ingreso de Estudiantes y un Subproceso Mltiple llamado
Matrcula de Estudiantes.
Ambos procesos han sido diagramados en Bizagi Modeler y se han definido sus Entidades de Proceso
respectivas.
Ingreso de Estudiantes es la Entidad de Proceso del proceso Ingreso de Estudiantes y Matrcula de
Estudiantes el la Entidad de Proceso del proceso Matrcula de Estudiantes.
Para crear la relacin de las instancias del Subproceso mltiple se debe definir una coleccin: La
coleccin llamada Matrcula de Estudiantes.

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

Copyright 2014 - Bizagi

297

Para agrupar las instancias del Subproceso siga los siguientes pasos:
1. Vaya al paso 1 (Modelar Proceso) del asistente y d clic en Editar Proceso. Seleccione el Proceso
Padre Ingreso de Estudiantes.
En el diagrama del modelo, d clic derecho sobre la actividad que desea convertir, en este caso
Matrcula de Estudiantes y seleccione la opcin Transformar en Subproceso.
Una nueva ventana mostrar los tipos de Subprocesos. Seleccione la opcin Mltiple y luego clic en
Siguiente.

2. Seleccione el proceso a ser transformado, Matrcula de Estudiante, de la lista desplegable,


seleccione el proceso y d clic en Siguiente.
Una vez el diagrama ha sido asociado al Subproceso, seleccione la opcin Configuracin Avanzada y
d clic en Siguiente.

Copyright 2014 - Bizagi

298

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.

Copyright 2014 - Bizagi

299

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 2014 - Bizagi

300

Clic en S para establecer la relacin de forma automtica. Luego clic en Siguiente.

Copyright 2014 - Bizagi

301

5. Seleccione los atributos por 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 Siguiente.

Relacin con el proceso Padre


Cuando ejecute el Proceso notar que no es posible acceder 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 2014 - Bizagi

302

Es necesario definir la relacin faltante para navegar por el modelo de datos 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:

Copyright 2014 - Bizagi

303

1. Estando en el proceso padre, vaya al segundo paso del Asistente y d 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 2014 - Bizagi

304

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.

Copyright 2014 - Bizagi

305

5. Ahora es necesario crear una expresin que incluya la informacin necesaria para completar la
nueva relacin.
Defina una expresin "al entrar" 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].StudentsApplicat
ion>
<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 2014 - Bizagi

306

Para agrupar instancias del Subproceso, tenga en cuenta 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 matricula 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 Bizagi Modeler y las entidades de proceso han sido
definidas para cada uno de ellos.
Ingreso de Estudiantes es la Entidad de Proceso del proceso Ingreso de Estudiantes y Matrcula de
Estudiantes es la Entidad de Proceso del proceso Matrcula de Estudiantes.
Para crear la relacin de las instancias del Subproceso mltiple se debe definir una coleccin. La
coleccin llamada Matrcula de Estudiantes.

Copyright 2014 - Bizagi

307

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 d clic en Editar Proceso. Seleccione el Proceso
Padre Ingreso de Estudiantes.
En el diagrama del modelo, d clic derecho sobre la actividad que desea convertir, en este caso
Matrcula de Estudiantes y seleccione la opcin Transformar en Subproceso.
Una nueva ventana mostrar los tipos de Subprocesos. Seleccione la opcin Mltiple y luego clic en
Siguiente.

Copyright 2014 - Bizagi

308

2. Seleccione el proceso a ser transformado,(Matrcula de Estudiante) de la lista desplegable,


seleccione el proceso y d clic en Siguiente.
Una vez el diagrama ha sido asociado al Subproceso, seleccione la opcin Configuracin Avanzada y
d clic en Siguiente.

Copyright 2014 - Bizagi

309

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 tems en la Coleccin y la opcin Nmero de instancias, luego d clic en Siguiente.

Copyright 2014 - Bizagi

310

4. Seleccione Modo de Ejecucin Secuencial.

Copyright 2014 - Bizagi

311

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 Finalizar.

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

Entendiendo Subprocesos transaccionales


Los Subprocesos 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

Copyright 2014 - Bizagi

312

actividades se 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 lanzados 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


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.

Copyright 2014 - Bizagi

313

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 2014 - Bizagi

314

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 Compensar Dbito es actividad de compensacin 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.

Copyright 2014 - Bizagi

315

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
Un error de excepcin en lanzado cuando existe un error que no puede ser manejado por el

Copyright 2014 - Bizagi

316

Subproceso transaccional el cual no permite que el Subproceso contine; las actividades son
interrumpidas sin compensacin. 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 Evento de Error Intermedio.
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.

Tenga en cuenta las siguientes consideraciones:


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 nuevo.
Los eventos de error solo pueden ser definidos en Subprocesos transaccionales.

Configuracin del Subproceso transaccional


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

Copyright 2014 - Bizagi

317

El diagrama hace referencia a un proceso de Solicitud de 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
Reservar 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 d clic en Editar Proceso.

Copyright 2014 - Bizagi

318

2. Haga clic derecho en la tarea que desea convertir a un Subproceso transaccional, en este caso la
tarea Reservar, y seleccione la opcin Transformar en Subproceso.

3. El asistente es lanzado. Una nueva ventana ser mostrada con los tipos de Subprocesos. Seleccione
la opcin Transaccional y d clic en Siguiente.

Copyright 2014 - Bizagi

319

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


Finalizar.

Copyright 2014 - Bizagi

320

5. Una vez el Subproceso ha sido creado, usted puede empezar a editarlo.


Clic derecho en el Subproceso recin creado (Reservar) y seleccione la opcin Editar Subproceso.

6. La ventana muestra el diagrama del Subproceso.


Cuando usted crea un subproceso por primera vez, aparece un diagrama en blanco 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
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

Copyright 2014 - Bizagi

321

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.
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, d clic derecho en la actividad a compensar y seleccione la
opcin Adjuntar Evento. Seleccione el evento de compensacin.

Copyright 2014 - Bizagi

322

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

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.

Copyright 2014 - Bizagi

323

En el Proceso padre, d 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
pudieron ser realizadas. Por esta razn, hemos agregado una tarea de Script 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
Reservar Vuelo en una tarea automtica y adicionar una interfaz. Si durante la ejecucin de la tarea
automtica Reservar Vuelo se presenta un error (error de conexin, etc.), el Subproceso terminar y
lanzar el flujo de excepcin en el Proceso principal.

Copyright 2014 - Bizagi

324

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 Evento de Error a los lmites del Subproceso Reservar. Clic
sobre el Subproceso, seleccione la opcin Adjuntar Evento y seleccione Error.

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


error.

Copyright 2014 - Bizagi

325

Nuestro Subproceso transaccional ha sido configurado de forma exitosa.

Entendiendo el proceso Ad Hoc


Es muy comn encontrar dentro de los negocios casos en los cuales es necesario manejar un proceso
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
Quin 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
Copyright 2014 - Bizagi

326

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:

Las actividades iniciales son definidas en la tarea Configurar Actividades Iniciales adicionando cada
actividad a la coleccin.
La primera Compuerta Paralela (PG1) 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 (PG2) 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
ms actividades.

Configurar un subproceso 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

Copyright 2014 - Bizagi

327

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
la reunin ha terminado, una actividad es creada para el responsable a travs del subproceso 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 subproceso 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
Reunin de comit 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.

Copyright 2014 - Bizagi

328

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. Para ms informacin sobre cmo configurar
tablas editables visite tablas.
Ejecutar Tareas: En est forma deber incluir toda la informacin relacionada con la tarea con el fin
de identificarla y actualizarla.

BPMN Colaborativo
Los Procesos se pueden comunicar entre s a travs de flujos de mensaje. Este tipo de comunicacin se
denomina Colaboracin.
Las Colaboracin es una herramienta que relaciona dos o ms procesos, permitiendo su comunicacin
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 Lanzamiento y Captura, 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.

Copyright 2014 - Bizagi

329

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 Tipo de evento y luego d clic sobre el evento deseado.
Recuerde definir eventos de lanzamiento y de captura.

Copyright 2014 - Bizagi

330

Cuando utilice eventos intermedios, deber configurar manualmente el evento de Lanzamiento. Por
defecto, Bizagi define todos los eventos como eventos de captura.
Una vez que el evento intermedio ha sido convertido, d clic de nuevo sobre l y seleccione Lanza el
evento.

Copyright 2014 - Bizagi

331

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 2014 - Bizagi

332

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 al sexto paso del Asistente de Procesos.

Copyright 2014 - Bizagi

333

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
Evento de mensaje de inicio, 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 2014 - Bizagi

334

Copyright 2014 - Bizagi

335

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 2014 - Bizagi

336

Cuando el caso llega al Evento de fin de seal, una seal se enva a cualquier otro evento (catch) que
posea el mismo nombre. En este caso, para continuar.
Este es un evento de Seal de Inicio, por lo que al ser activado, crear un nuevo caso del proceso
Process payment.
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 dentro
del mismo proceso.
En estos procesos las formas, reglas y dems elementos se construyen partiendo de la misma Entidad
de Proceso: Invoice.

Copyright 2014 - Bizagi

337

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 duracin estimada definida en las propiedades de las
tareas.

Copyright 2014 - Bizagi

338

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:
Verde cuando la tarea se encuentra a tiempo.
Amarillo cuando la fecha lmite de la actividad es ese da, es decir la actividad se encuentra en
Riesgo.
Rojo cuando la tarea presenta retraso o ha expirado.

En Bizagi existen varios tipos de elementos que deben poseer 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.
Los siguientes elementos requieren de la definicin de tiempo de duracin:
Tareas de usuario

Copyright 2014 - Bizagi

339

Tareas Manuales
Subprocesos
Eventos de temporizacin

Duracin de tareas y procesos


La duracin definida para las 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; pueden ser configuradas con un nmero entero en
la propiedad del elementos o como una duracin dinmica definida a travs de 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 asumir 24 horas
(3 das x 8 horas hbiles), y NO 72 horas.
Es importante recordar que la duracin de una Actividad NO se define como el tiempo que toma a 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), haga clic derecho sobre la actividad y seleccione Propiedades.

Copyright 2014 - Bizagi

340

La duracin es definida en das, horas y minutos. Ingrese el tiempo para cada tarea.
Recuerde grabar cuando haya terminado.

Para incluir la duracin del proceso, haga clic derecho sobre el nombre del Proceso y seleccione
Propiedades.

Los lmites Superior e Inferior son utilizados para propsitos de documentacin y no afectan el
reporte de indicadores.

Copyright 2014 - Bizagi

341

La Duracin Estimada y los lmites Superior e Inferior aparecern en las propiedades de la siguiente
forma:

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. 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 lmite se
sobrepas. Cuando una actividad tiene luz roja, 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.

Copyright 2014 - Bizagi

342

Se mostrar una nueva ventana con la lista de los Procesos. Elija el que desee administrar.
Haga clic en cualquier tarea y luego en Editar para cambiar su duracin. Se podr modificar el tiempo
del proceso.
Haga clic en Aplicar cuando haya definido la nueva duracin.

Esta opcin solo est disponible en el ambiente de produccin. En desarrollo se debe utilizar las
propiedades de la figura.

Copyright 2014 - Bizagi

343

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 Al Entrar, 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.

Modelo de datos
El segundo paso del Asistente de Bizagi es definir los datos que el proceso requiere para su ejecucin.
Bizagi provee un asistente amigable para construir un modelo estructurado de datos con entidades
definidas y sus correspondientes atributos. A diferencia de otros BPMs usted puede estructurar la
informacin del negocio utilizando un ambiente grfico y lgico. El modelo de Datos se crea una sola
vez y se usa durante todo el proceso. El modelo de Datos puede ser reutilizado en todos los procesos
creados e el mismo proyecto sin restricciones.
La manera en que defina su modelo de Datos en Bizagi, determinar especficamente cmo se
almacenan y se acceden los datos.
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. Las entidades se nombran normalmente con sustantivos. Por ejemplo, cliente, Ciudad,
Compaa, Factura, Carro.
Las entidades tienen Atributos. Estos son las propiedades que describen cada entidad. Por ejemplo

Copyright 2014 - Bizagi

344

un cliente tiene un nombre, un nmero de seguridad industrial y una edad.


Las 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.

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.

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.

Copyright 2014 - Bizagi

345

1. Seleccione la opcin Modelo de Datos en el Segundo paso del Asistente de proceso.

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 OK.

3. Clic derecho sobre la Entidad de Proceso y seleccione Editar Lista de Atributos para empezar a
incluir atributos.

Copyright 2014 - Bizagi

346

4. El asistente de la entidad ser ejecutado para permitir incluir los atributos que necesite.
Clic en el botn Adicionar. 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-time). La direccin de entrega debe
ser un texto (Tipo de dato Texto).

Copyright 2014 - Bizagi

347

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 Ciudad.
En el Nombre Visual incluya el nombre de la Relacin. Digite el nombre de la relacin en el campo de
Nombre Visual y seleccione la entidad hijo.
Para realizar esto, primero extienda los elementos de la Entidad (dando clic en el signo ms) y luego
en el elemento Parmetro. Seleccione Nueva Entidad o seleccione una entidad existente de la lista
presentada.

Copyright 2014 - Bizagi

348

6. La ventana con la Lista de Atributos aparecer para que pueda ingresar todos los atributos a la
nueva Entidad Paramtrica.

Copyright 2014 - Bizagi

349

7. En el ltimo paso, debe definir el Atributo para Mostrar y la entidad pap (Clic en Avanzado/
Ocultar 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, d 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.

Copyright 2014 - Bizagi

350

Usted puede incluir atributos adicionales en cualquier momento, de la misma forma como se realiz
en el ejemplo.

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.

Copyright 2014 - Bizagi

351

NOMBRE DEL GRUPO

OPCIONES

DESCRIPCIN

Entidad

Abre 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.

Relacin

Abra el asistente de relaciones para crear


una nueva relacin entre dos entidades.

Agregar

Entidad

Muestra y permite agregar las entidades


creadas anteriormente en el diagrama.

Zoom

Opciones de Zoom

Habilita al usuario para modificar el tamao


de los elementos mostrados en la pantalla.

Mostrar cuadrcula

Controla si la cuadrcula es mostrada al


fondo del diagrama. La cuadrcula ayuda a
alinear los objetos vertical y horizontalmente
dentro del diagrama.

Nueva

Mostrar/Ocultar

Maestra/Paramtrica/Sistema

Muestra la lista de las entidades por tipo


para facilitar la ubicacin de estas dentro del
espacio del diagrama (utilizando la

Copyright 2014 - Bizagi

352

NOMBRE DEL GRUPO

OPCIONES

DESCRIPCIN
funcionalidad de arrastrar y soltar).

Adicionar
entidades
relacionadas
Editar
lista
atributos
Men de la lista desplegable
(clic derecho sobre la entidad)
Propiedades

Remover del
diagrama.

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

Remueve
la
entidad
del
diagrama
nicamente, es decir, LA ENTIDAD NO
APARECE EN EL DIAGRAMA PERO SIGUE
DENTRO DEL MODELO DE DATOS.

Usted no puede borrar una entidad desde el Asistente del Modelo de Datos. Esta accin debe
realizarse desde la vista de Mdulos.

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.
La informacin es 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 es comn ni recomendado tener ms de 30). Cuando se
excede este nmero, se puede comprometer el desempeo de su proyecto.
En el diagrama del modelo de Datos, las Entidades Maestras se muestran de color azul.

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 Gnero 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

Copyright 2014 - Bizagi

353

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.
En el diagrama del modelo de Datos, las Entidades Paramtricas se muestran de color verde.

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 2014 - Bizagi

354

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.

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.
Entidad: Da acceso a todas las entidades de Aplicacin, Maestras, Paramtricas y del Sistema del

Copyright 2014 - Bizagi

355

modelo. Accediendo a las entidades a travs de esta categora se crea un Atributo Relacionado 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

DESCRIPCIN

Booleano

Almacena nicamente dos valores booleanos Verdadero y Falso.

Moneda

Almacena un valor entero en el formato de la moneda definida en la


configuracin del negocio.

Fecha-Hora

Almacena un atributo que puede ser una fecha o una fecha con hora.

Entero

Almacena un entero del siguiente rango: -2,147,483,648 a 2,147,483,647.

Texto

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 2014 - Bizagi

356

Entero largo

Almacena un entero del siguiente rango: -9,223,372,036,854,775,808 a


9,223,372,036,854,775,807

Texto extendido

Almacena una cadena de texto en formato texto enriquecido.

Archivo

Almacena y adjunta archivos dentro del caso.


Configuraciones adicionales (como el lmite de tamao de adjuntos) se
realizan 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.

Flotante

Almacena los nmeros decimales en formato binario de 8 bytes con 15


dgitos significativos de precisin.

Imagen

Almacena imgenes cargadas y las muestra en el Portal de trabajo como


miniaturas.

Galera de imgenes

Almacena una coleccin de imgenes para crear un lbum.

Real

Almacena los nmeros decimales en formato binario de 4 bytes con 7


dgitos significativos de precisin.

Entero corto

Almacena un entero del siguiente rango: -32,768 a 32,767.

Entero muy corto

Almacena un entero del siguiente rango: 0 a 255

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 de Atributos, 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.

Texto de Ayuda

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 d clic sobre el campo.

Valor por defecto

Valor inicial asignado al atributo. El valor por


defecto ser mostrado si no se especifica un
valor para el atributo.

Longitud

Carpeta ECM

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

Copyright 2014 - Bizagi

357

configurada en el repositorio ECM seleccione el


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.

Localizable

Para los atributos de las entidades paramtricas.


Habilita/deshabilita la localizacin (MultiLenguaje) para los valores de una entidad
paramtrica.

Cifrado

Cifra el atributo en la base de datos. Para ms


informacin, por favor dirjase a Encripcin en la
base de datos.

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

Copyright 2014 - Bizagi

358

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
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\Projects\ApplicationName\WebApplication\Docs
ApplicationName: Nombre de la aplicacin web del proyecto.
Para cambiar la ruta por defecto, seleccione la pestaa de Configuracin en Bizagi Studio y abra la
opcin Entorno.
1. Seleccione la opcin Avanzado del lado izquierdo de la ventana mostrada.

Copyright 2014 - Bizagi

359

2. bajo la opcin Uploads 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 Configuracin y abra el men de Negocios.
Seleccione la opcin Avanzado.

Copyright 2014 - Bizagi

360

2. Al final de la ventana encontrar el tipo de contenido y las extensiones disponibles para cargar
archivos por defecto.
Para configurar alguno, d clic en la extensin del archivo o en el tipo de contenido e ingrese el nuevo
valor.
Para borrar alguno, seleccione el tipo de contenido y d 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.

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:
Copyright 2014 - Bizagi

361

Manejo de Archivos con Expresiones

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.

Copyright 2014 - Bizagi

362

Las entidades a ser relacionadas deben ser incluidas en el diagrama.


1. Clic en el botn Relacin en la pestaa inicio y seleccione las dos entidades ha relacionar.

2. Seleccione el tipo de relacin y clic en Finalizar.

Copyright 2014 - Bizagi

363

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 2014 - Bizagi

364

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. Una relacin muchos a
muchos se modela como una doble fecha con un asterisco (*) al final de cada flecha.

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 Relacin en la pestaa inicio y seleccione las dos entidades ha relacionar.
Despus haga clic en Siguiente.

Copyright 2014 - Bizagi

365

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 (Product_Guarantee).
La relacin entre las garantas y los productos cubiertos ser Garanta de Productos
(Guarantee_Products).
Luego d clic en Finalizar.

Copyright 2014 - Bizagi

366

Administracin de las entidades


En los siguientes enlaces podr encontrar informacin sobre cmo 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.
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.

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 diferentes con este tipo de registros en
Bizagi Studio.

Copyright 2014 - Bizagi

367

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.
Una vez haya incluido una entidad paramtrica en el diagrama d clic derecho sobre ella y seleccione
la opcin Valores.

Copyright 2014 - Bizagi

368

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 Editar
Valores.

Copyright 2014 - Bizagi

369

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 2014 - Bizagi

370

En el editor de expresiones d 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 Valores.
Para incluir nuevos registros, clic en el botn Agregar.
Para borrar registros, seleccione una fila dando clic sobre el registro, luego oprima el botn Suprimir
en su teclado.
Para cambiar un valor solo debe escribir en el campo que se quiere modificar.

Copyright 2014 - Bizagi

371

Tan pronto como el proyecto ha sido deployed, 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.

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


Copyright 2014 - Bizagi

372

Imagine que tiene una solicitud de compra donde debe seleccionar un pas, estado y una ciudad para
la informacin de entrega.
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: Ciudad.

2. Abra el modelo de datos en el segundo paso del asistente. D clic derecho en la entidad Ciudad y
seleccione la opcin Propiedades.
En el ultimo paso del asistente d clic en el link Avanzado.
Un nuevo campo ser mostrado para incluir la entidad padre.

Copyright 2014 - Bizagi

373

3. Clic en Finalizar
Si no existe la relacin entre estas dos entidades (el padre y el hijo), se le pedir que la cree.

4. Seleccione S y d clic en Finalizar.


La relacin ha sido creada.

5. Siga los pasos 2 y 3 para configurar la entidad Estado como padre.

Copyright 2014 - Bizagi

374

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.

Copyright 2014 - Bizagi

375

Copyright 2014 - Bizagi

376

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.

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
que sea administrable en el ambiente de produccin.

Copyright 2014 - Bizagi

377

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 Administrar valores en el ambiente de produccin 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 2014 - Bizagi

378

Para una entidad paramtrica existente, la propiedad puede ser modificada en la vista de Mdulos.
Seleccione el mdulo Entidades, d clic derecho sobre la entidad deseada y seleccione la opcin
Propiedades Avanzadas. En la pestaa Instancia, usted podr marcar la opcin mencionada.

Copyright 2014 - Bizagi

379

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 2014 - Bizagi

380

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
administrables en desarrollo.

deben tener

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.

Copyright 2014 - Bizagi

381

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

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.

Copyright 2014 - Bizagi

382

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.
1. La primera forma es a travs del men Entidades.
Vaya a la vista de Mdulos y seleccione la opcin Entidades. 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 d clic derecho sobre el proceso
deseado, luego seleccione la opcin Asignar entidad de Proceso.
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.

Copyright 2014 - Bizagi

383

Contexto
El contexto es el punto de inicio del modelo de dato el cual determina cmo navegar el usuario 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 2014 - Bizagi

384

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 Para define el contexto del correo. El contexto cambia en correos enviados en relaciones uno
a muchos, cuando el campo Para tiene direcciones que corresponden a una coleccin.
Cuando el campo Para contiene una direccin de correo fija, o no se toma de una campo del

Copyright 2014 - Bizagi

385

modelo de datos, el contexto ser siempre la Entidad de proceso.


Cuando el campo Para contiene una coleccin, usted podr elegir entre la entidad del proceso o la
entidad del muchos de la relacin para definirla como contexto.

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.
Ambos 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.
Estos dos mecanismos son conocidos en Bizagi como Replicacin y Virtualizacin (las diferencias
entre ellos estn dadas por el tipo de Entidades involucradas).
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).

Copyright 2014 - Bizagi

386

Replicacin de datos

Introduccin
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 una 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). Estas listas 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 2014 - Bizagi

387

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 asistente 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
Datos

Versin

Microsoft SQL Server

2012 (aplica para la

Copyright 2014 - Bizagi

388

edicin Bizagi .NET)


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 Access, 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.

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 .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.

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

Copyright 2014 - Bizagi

389

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
El 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 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).

Copyright 2014 - Bizagi

390

Utilizar el asistente de Replicacin

Introduccin
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 (Modelar Datos).

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.

Copyright 2014 - Bizagi

391

Antes de utilizar el Asistente 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. (registra 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 va a replicar.
4. Defina filtros adicionales para las tablas o vistas a 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.
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 Sistema, seleccione Nuevo 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.

Copyright 2014 - Bizagi

392

Ingrese le Nombre Visual y la Descripcin, luego d clic en Siguiente.

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).

Copyright 2014 - Bizagi

393

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 Siguiente.

Copyright 2014 - Bizagi

394

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 TABLAS 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 Regin y Territorios.
Clic en Siguiente.

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 2014 - Bizagi

395

4. Defina filtros para las tablas y vistas a replicar (opcional).

Una vez haya seleccionado las tablas o vistas a 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 NULL (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 Siguiente.

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.

Copyright 2014 - Bizagi

396

5. Definir el esquema de Replicacin


En la siguiente ventana, defina el esquema de la programacin del trabajo que ser ejecutado en la
replicacin (sincronizacin de informacin).
Seleccione Nuevo desde la lista desplegable de Programacin (Schedule), ingrese el Nombre, Nombre
Visual y una Descripcin. En futuras replicaciones, tendr la opcin de escoger una programacin
existente (configurado anteriormente) desde la lista desplegable de programaciones.

Copyright 2014 - Bizagi

397

Clic en la pestaa de Propiedades de Programacin

Copyright 2014 - Bizagi

398

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

Descripcin

Habilitar la programacin
para la Replicacin.

Marque esta opcin para que Bizagi ejecute la


replicacin de datos desde la fuente externa.

Periodicidad

Marque Diario, Semanal, o Mensual para definir con


que frecuencia Bizagi ejecutar el esquema de
Replicacin.

Copyright 2014 - Bizagi

399

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).

Comienzo

Seleccione una fecha de inicio para el esquema para


comenzar la ejecucin.
Descripcin de las propiedades del esquema

Marque la opcin Replicar Ahora para ejecutar inmediatamente la Replicacin (sincronizacin de la


informacin).
Si la opcin Replicar Ahora 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 Siguiente.
Finalmente, clic en Finalizar cuando complete de forma exitosa la configuracin.

Copyright 2014 - Bizagi

400

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 Sistemas
(Vista mdulos) o a travs de la informacin mostrada de las entidades (Mdulo de Entidades).
Las opciones representadas en el mdulo de Sistemas son tiles para los ambientes de produccin o
pruebas.
Las opciones representadas en el mdulo de Entidades 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.

Utilizar la configuracin avanzada de Replicacin

Introduccin
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).

Copyright 2014 - Bizagi

401

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 Avanzadas
Si desea ms informacin y un ejemplo sobre replicacin a MySQL visite Replicacin Personalizada.
Tenga en cuenta que solamente la versin de Bizagi .NET soporta cualquier motor de base de datos.

Utilizando la 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 Sistema.

Copyright 2014 - Bizagi

402

Qu necesita hacer?
Para realizar la configuracin de la Replicacin a travs de la configuracin avanzada 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)
Necesitamos definir explcitamente si vamos a utilizar una implementacin personalizada.
5. Definir el esquema de Replicacin
Especificar la programacin del trabajo el cual ser ejecutado en la sincronizacin de la Replicacin.

Copyright 2014 - Bizagi

403

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 Southwind.

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 para 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

Copyright 2014 - Bizagi

404

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, d clic derecho en Sistema y seleccione la opcin
Nuevo Sistema.

Copyright 2014 - Bizagi

405

En la ventana de Nuevo Sistema, debe definir la informacin del sistema donde se encuentra la fuente
de datos externa.
Ingrese los detalles para el nuevo sistema: Nombre, Nombre Visual y Descripcin.

Copyright 2014 - Bizagi

406

Asegrese de que la opcin Permitir Entidades Virtuales y Replicacin este seleccionada.


Clic en OK.

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 Proveedor ubicado en el sistema recin creado y
seleccione la opcin Nuevo Proveedor.

En la pestaa de configuracin del Proveedor, ingrese los detalles del nuevo proveedor: Nombre,
Nombre Visual y Descripcin.
Asegrese de marcar la opcin Permitir Replicacin para el proveedor.

Copyright 2014 - Bizagi

407

Luego, en la pestaa Propiedades de desarrollo del Proveedor d clic en el botn OLEDB Config.
Note que puede establecer diferentes valores para los diferentes ambientes del proyecto (desarrollo,
Test y produccin).
En el siguiente ejemplo, vamos a establecer 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.

Copyright 2014 - Bizagi

408

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 2014 - Bizagi

409

Clic en Ok para guardar la conexin.


De nuevo, clic en OK para regresar a la ventana de nuevo proveedor.

Tenga en cuenta que es necesario definir las propiedades y valores de conexin 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 realizarse 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, Postgresql, DB2, etc).
Aqu necesita definir si se 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 d clic derecho sobre el nodo de Entidades Replicadas
y seleccione la opcin Nueva clase de Replicacin.
Deje los valores que trae por defecto y d clic en Ok.

Copyright 2014 - Bizagi

410

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, Default Replication Entity) bajo la opcin entidades replicadas; d clic
derecho en ella y seleccione la opcin Adicionar esquema de Replicacin.

Copyright 2014 - Bizagi

411

En la ventana de configuracin, digite un Nombre, Nombre visual y descripcin para el esquema de


replicacin.

En la pestaa de propiedades de programacin (Schedule Properties), 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.

Copyright 2014 - Bizagi

412

La replicacin comenzar a ejecutarse en el da y la hora definida previamente, sin embargo, podr


utilizar la opcin de Replicar ahora para que se ejecute de inmediato.
Se requiere que el servicio del programador para el ambiente se encuentre encendido 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 Replicar Ahora 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

Descripcin

Habilitar programador para


la replicacin

Marque esta opcin en Bizagi para ejecutar los


datos de la replicacin desde la fuente de datos
externa.

Periodicidad

Marque, diario, semanal o mensual para definir con


que frecuencia Bizagi ejecutar el esquema de
Replicacin.

Copyright 2014 - Bizagi

413

Cada [...] da(s)

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.

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).

Inicio

Configure la fecha inicial para que el esquema


comience la ejecucin.
Descripcin de las propiedades del programador

Clic OK.
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 Territorios 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 Adicionar Entidad de
Replicacin.

Copyright 2014 - Bizagi

414

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.

La llave de negocio debe corresponder a la llave primaria de la tabla de la fuente.


Realice esto para cada Entidad Paramtrica (Regin, Rama y Transportista de nuestro ejemplo).
La tabla Territorios (incluida como Rama) para la configuracin de replicacin y el esquema:

Copyright 2014 - Bizagi

415

La tabla Regin (incluida como Regin) para la configuracin de replicacin y el esquema:

La tabla Transportista (incluida como Transportista) para la configuracin de replicacin y el esquema:

Esto significa que cuando el esquema de replicacin se ejecute, este sincronizar la informacin de las

Copyright 2014 - Bizagi

416

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 Propiedades.

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 2014 - Bizagi

417

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.

Copyright 2014 - Bizagi

418

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 Sistemas
(Vista mdulos) o a travs de la informacin mostrada de las entidades (Mdulo de Entidades).
Las opciones representadas en el mdulo de Sistemas son tiles para los ambientes de produccin o
pruebas.
Las opciones representadas en el mdulo de Entidades 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.

Personalizando la Replicacin

Introduccin
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: Sobrescribir de Clases y Mtodos).
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 en Bizagi.

Sobrescribir de Clases y Mtodos


Para personalizar la virtualizacin de Bizagi, es necesario desarrollar un componente que implemente
las interfaces:

Copyright 2014 - Bizagi

419

IProviderVirtualDA2
IReplicationEntDA.
IParameter
IDatabaseConstants

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

Descripcin

obj Provider

Permite convertir el objeto que invoca la interfaz


IProviderVirtualDA.

htMetadata

Contiene la informacin requerida en forma de metada para


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

Descripcin

sEntSource

Nombre de la tabla a replicar en la fuente de datos

Copyright 2014 - Bizagi

420

arrsColList

Arreglo que contiene el nombre de las columnas de la


consulta en la fuente de datos.

RETURNED DataSet

Un DataSet con los valores de la entidad.

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".

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 2014 - Bizagi

421

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()
{
bDisposed = false;
MySqlconn = null;
m_alParams = new List<CMySqlParameter>();
}
#region IProviderVirtualDA2 Members
void

IProviderVirtualDA2.AddParameter(string sParameterName,

Copyright 2014 - Bizagi

422

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)
{

IProviderVirtualDA2.AddParameter(Vision.DA.IParameter

throw new NotImplementedException();


}
void
{

IProviderVirtualDA2.ClearParameters()
m_alParams.Clear();

}
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,

Copyright 2014 - Bizagi

423

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())
{
//--- Add the SQLParameter object to the SQLCommand
object
oCmd.Parameters.Add(ConvertParameterToMySqlParameter((CMySq
lParameter)oEnumerator.Current));
}
}

Copyright 2014 - Bizagi

424

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 2014 - Bizagi

425

}
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(nLastStrInde
x, _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++;

Copyright 2014 - Bizagi

426

}
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;
}
private static int IndexOfParam(string sParamName,
List<CMySqlParameter> alParams, int iMaxParamIndex)
{
int _i = 0, _n = iMaxParamIndex;
while (_i < _n)
{
if (((CMySqlParameter)alParams[_i]).ParameterName ==

Copyright 2014 - Bizagi

427

sParamName)
{
_n = _i;
}
else
{
_i++;
}
}
return (_n == iMaxParamIndex) ? -1 : _n;
}

#endregion
#region IProviderVirtualDA Members
void
{

IProviderVirtualDA.BeginTransaction()
throw new NotImplementedException();

}
void
{

IProviderVirtualDA.CloseConnection()
if (MySqlconn != null)
MySqlconn.Close();
MySqlconn = null;

}
void
{

IProviderVirtualDA.Commit()

}
void
{

IProviderVirtualDA.Init(HybridDictionary htMetadata)
m_htMetadata = htMetadata;

}
void
{

IProviderVirtualDA.OpenConnection()

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");

Copyright 2014 - Bizagi

428

}
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
{

IProviderVirtualDA.Rollback()

}
#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);

Copyright 2014 - Bizagi

429

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
pairs
/// </summary>
protected HybridDictionary m_htMetadata;

public CMySQLReplication()
{

Copyright 2014 - Bizagi

430

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)
{
m_bDisposed = true;
}
}
#endregion
#region IReplicationEntDA Members

Copyright 2014 - Bizagi

431

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
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;

Copyright 2014 - Bizagi

432

//--- 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;
direction = (ParameterDirection) eDirection;
}
public CMySqlParameter (string sParameterName, EDataType
eDataType, int iSize, byte iPrecision, byte iScale, object oValue,
EParamDirection eDirection, string sSourceColumn, bool
bUseCurrentSourceColumnValue)

Copyright 2014 - Bizagi

433

{
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;
}
}
public EDataType Type
{
get
{
return dataType;
}
set

Copyright 2014 - Bizagi

434

{
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
{
return paramValue;
}
set
{
paramValue = value;
}
}

Copyright 2014 - Bizagi

435

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;
}
}
private static SqlDbType getSqlDataType(EDataType eDataType) {
SqlDbType oDbType = SqlDbType.Int;
switch (eDataType) {
case EDataType.BigInt:
oDbType = SqlDbType.BigInt;

Copyright 2014 - Bizagi

436

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;
case EDataType.Char:
oDbType = SqlDbType.Char;
break;
case EDataType.VarChar:
oDbType = SqlDbType.VarChar;
break;

Copyright 2014 - Bizagi

437

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;
using System.Data;
using System.Data.Common;
using System.Collections;
using System.Collections.Generic;
using System.Diagnostics;
using System.IO;
using System.Text;

Copyright 2014 - Bizagi

438

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
{
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

Copyright 2014 - Bizagi

439

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; } }
/// <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; } }

Copyright 2014 - Bizagi

440

/// <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; } }
/// <summary>
/// Maximum lenght for a database object id
/// </summary>
private readonly int m_iMaxDbIdLength = 128;
public int MaxDbIdLength { get { return m_iMaxDbIdLength; } }
/// <summary>

Copyright 2014 - Bizagi

441

/// 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
/// </summary>
private readonly bool m_bCaseSensitive;
public bool CaseSensitive { get { return m_bCaseSensitive; } }
/// <summary>
/// Keyword to specify storage for a table creation
/// </summary>

Copyright 2014 - Bizagi

442

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; } }
/// <summary>
/// key word to drop indexes
/// </summary>
private readonly string m_sKeywordDropPKIndex = string.Empty;
public string KeywordDropPKIndex { get { return
m_sKeywordDropPKIndex; } }

Copyright 2014 - Bizagi

443

/// <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);
}
result.AppendFormat("SELECT TOP {0} ", top);
result.Append(suffix);
return result.ToString();
}
#endregion

Copyright 2014 - Bizagi

444

}
}

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).

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 Sistemas, en la vista de Mdulos de Bizagi.


Puede dar clic derecho sobre el elemento sistema y seleccionar Nuevo Sistema del men desplegable
o dar clic en Nuevo sistema de la barra del men.

2. Ingrese el Nombre, Nombre Visual y Descripcin para el nuevo sistema y seleccione el checkbox de

Copyright 2014 - Bizagi

445

Permitir Entidades Virtuales para replicacin para este sistema.


Clic en Ok para guardar cambios.

3. Clic en el signo (+) al lado del sistema recin creado.


Clic derecho en el elemento Nuevo Proveedor.

4. En la ventana del Nuevo Proveedor ingrese Nombre, Nombre Visual y Descripcin en la pestaa de
configuracin del proveedor.
Marque la opcin Permitir Replicacin para este proveedor. Tambin marque la opcin Permitir
entidades virtuales para este proveedor (si aplica).

Copyright 2014 - Bizagi

446

5. Seleccione la pestaa de proveedor y la librera de la entidad y clic en Nueva librera (New


Assembly).

6. Ingrese Nombre, Nombre Visual y Descripcin.


Luego haga clic Seleccionar Librera para seleccionar el .dll de la librera de replicacin personalizada
previamente. D clic en Ok en la ventana de Nueva Librera.

Copyright 2014 - Bizagi

447

7. D 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.
D clic en Ok. .

Copyright 2014 - Bizagi

448

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.
D 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.

Copyright 2014 - Bizagi

449

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.

Copyright 2014 - Bizagi

450

11. D clic derecho sobre el nuevo elemento de la clase de la entidad y seleccione la opcin Nueva
Programacin de Replicacin.

12. En la ventana de Configuracin de Replicacin, ingrese un Nombre, Nombre Visual y


una Descripcin para la programacin de replicacin.

Copyright 2014 - Bizagi

451

Seleccione la pestaa Props. Calendario y configure la frecuencia con que la informacin ser replicada
desde la fuente de datos.

Copyright 2014 - Bizagi

452

Defina la periodicidad y frecuencia de ejecucin de acuerdo a la informacin de la siguiente tabla;


Opciones del programador

Descripcin

Habilitar programador para


la replicacin

Marque esta opcin en Bizagi para ejecutar los


datos de la replicacin desde la fuente de datos
externa.

Periodicidad

Marque, diario, semanal o mensual para definir con


que frecuencia Bizagi ejecutar el esquema de
Replicacin.

Cada [...] da(s)

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.

Copyright 2014 - Bizagi

453

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).

Inicio

Configure la fecha inicial para que el esquema


comience la ejecucin.
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 Adicionar Entidad a Replicacin.

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

Copyright 2014 - Bizagi

454

para diferenciar un registro de otro).

D 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 Propiedades.

En la ventana Editar Atributo, escriba el nombre del atributo externo y haga clic en Ok.

Copyright 2014 - Bizagi

455

Haga esto para todos los atributos de la entidad replicada.

Si su librera de replicacin personalizada tiene referencias a otras libreras, es necesario copiarlas a


la carpeta del Programador, usualmente es: "C:\Bizagi\Standard\Projects\[PROJECT_NAME]
\Scheduler".
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 Sistemas
(Vista mdulos) o travs de la informacin mostrada de las entidades (Modul de Entidades).
Las opciones representadas en el mdulo de Sistemas son tiles para los ambientes de produccin o
pruebas.
Las opciones representadas en el mdulo de Entidades 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.

Verificar la Replicacin

Introduccin
Una vez que la Replicacin se ha configurado, usted puede verificar que su ejecucin sincroniza los
valores en las entidades Paramtricas con columnas de las tablas externas.
Hay dos formas de hacerlo: mediante las opciones de los mdulos de Sistemas, o a travs de la
informacin que aparece entidades (mdulo de Entidades).
Para obtener ms informacin acerca de la replicacin y su configuracin, consulte la Replicacin.

Copyright 2014 - Bizagi

456

Usando el mdulo de Sistemas


Esta opcin es especialmente til para todos los ambientes de los proyectos, por medio de los
siguientes pasos.
1. 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 Proveedores, el proveedor especfico, el nodo Entidades Replicadas, y, finalmente, la clase
predeterminada de replicacin).
2. Haga clic en el esquema y haga clic en Propiedades de la replicacin:

En esta ventana, seleccione la pestaa Informes de replicacin 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 2014 - Bizagi

457

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.
3. Adems de este registro, y permitiendo que corra de nuevo la repeticin proceso, puede usar la
opcin Replicar ahora para sus entidades replicadas para iniciar su sincronizacin inmediata:

Copyright 2014 - Bizagi

458

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 como se describe a continuacin.
1. Vaya al mdulo Entidades y ubique las Entidades paramtricas (Territorries y Region en nuestro
ejemplo) bajo la clasificacin Parmetros.
Es posible que necesite actualizar la vista en caso de que ya se encontrara en esta opcin.

Copyright 2014 - Bizagi

459

2. En las Entidades Paramtricas creadas, puede hacer clic en Valores para consultar sus registros.
Bizagi mostrar los valores sincronizados.

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 Regin del origen de datos externo:

Copyright 2014 - Bizagi

460

Los valores de Territories de la fuente de datos externa:

Copyright 2014 - Bizagi

461

Opciones adicionales en la configuracin de Replicacin

Introduccin
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.

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 d clic derecho sobre la opcin Probar proveedor (o
d clic en el botn en el men como se muestra).

Copyright 2014 - Bizagi

462

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.

La caracterstica Probar proveedor necesita tener IIS (Internet Information Services), ya que es usado

Copyright 2014 - Bizagi

463

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".

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).

Esta caracterstica solamente esta disponible en el ambiente de desarrollo cuando la configuracin


de una entidad para replicacin no han sido llevada al ambiente de produccin.

Copyright 2014 - Bizagi

464

Aunque la entidad haya sido removida del esquema de replicacin, esta puede ser utilizada, y los
valores que se encontraban seguirn siendo los mismos.

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 avanzadas de
configuracin.
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.

Copyright 2014 - Bizagi

465

Esta opcin se encuentra dando clic derecho en la entidad replicada.

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).

Copyright 2014 - Bizagi

466

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.
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
avanzada.

Copyright 2014 - Bizagi

467

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
Sistemas) se puede hacer a travs del modulo Entidades.

D clic derecho en la entidad paramtrica replicada y seleccione Propiedades Avanzadas.


En la pestaa Fuente de Filtro (Source Filter) revise o realice cambios en el filtro.

Copyright 2014 - Bizagi

468

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
(referencia) por otros objetos.

Copyright 2014 - Bizagi

469

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:
Una vez se haya hecho deployment a produccin del proceso que usa replicacin, no ser posible
eliminar los proveedores configurados que se usen en las versiones de proceso.
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.

Virtualizacin de datos

Introduccin
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
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).

Copyright 2014 - Bizagi

470

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.

Beneficios
El uso de la Virtualizacin en una solucin BPM promueve:
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 capacidad de Bizagi para virtualizar cualquier entidad definida en Bizagi provee los siguientes
beneficios:

Copyright 2014 - Bizagi

471

La distribucin de trabajo a travs de miembros del equipo de proyecto BPM se realiza de forma
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.
A travs de esto, el mantenimiento de la solucin se simplifica, el nmero de interfaces con sistemas
externos se reduce significantemente.
La siguiente imagen ilustra el podero y los beneficios que ofrece la arquitectura de Bizagi mediante el
uso de la Virtualizacin de datos:

Copyright 2014 - Bizagi

472

Ntese que tanto desde las formas de las actividades, las reglas de negocio (del flujo, de las tareas,
etc) o tareas automticas, el acceso a los datos en fuentes externas ser transparente ya que mediante
la Virtualizacin, Bizagi podr acoplarse fcilmente a la arquitectura de sus sistemas existentes y del
ESB corporativo.

Prerrequisitos
La fuente de datos externa debe cumplir los siguientes requerimientos:

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 (Bizagi permite la
configuracin de llaves compuestas) 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

Copyright 2014 - Bizagi

473

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

Versin

Microsoft SQL Server

2012 (aplica para la


edicin Bizagi .NET)
2008 R2
2008
2005

Oracle

9i
10g R1
10g R2
11g R1
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.

Copyright 2014 - Bizagi

474

Tenga en cuenta estas consideraciones:


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 .NET.
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.

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.

Utilizar el asistente de Virtualizacin

Introduccin
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).

Copyright 2014 - Bizagi

475

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.

Utilizando el asistente
Para lanzar el asistente de virtualizacin, vaya al segundo paso del Asisten de Procesos de Bizagi
Studio (Modelo de datos)

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.

Copyright 2014 - Bizagi

476

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.
Detalles que requiere la conexin a la fuente de datos externa.
3. Seleccione cuales tablas o vistas va a virtualizar.
4. Defina filtros adicionales para las tablas o vistas a virtualizar.
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:
Cliente y Producto.
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 Sistema, seleccione Nuevo 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 virtualizaciones, tendr la opcin de escoger un sistema
existente (configurado anteriormente) desde la lista desplegable de sistemas.
Ingrese le Nombre Visual y la Descripcin, luego d clic en Siguiente.

Copyright 2014 - Bizagi

477

Observe que usted tambin debera ingresar detalles para este nuevo sistema tales como: Nombre del
Sistema, Nombre de mostrar y Descripcin.
En posteriores configuraciones de Virtualizacin, usted podr seleccionar en una lista desplegable, un
sistema existente (configurado previamente).
D clic en Siguiente.

2. Ingrese los detalles para el Proveedor de Datos


En la ventada de Proveedor, seleccione Nuevo 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 Nombre del Proveedor, 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: SQL Server u Oracle.

Copyright 2014 - Bizagi

478

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 Siguiente.

Copyright 2014 - Bizagi

479

En futuras virtualizaciones, tendr la opcin de escoger un sistema existente (configurado


anteriormente) desde la lista desplegable de sistemas.
D clic en Siguiente.
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 TABLAS 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 Cliente y Producto.
D clic en Siguiente.

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 2014 - Bizagi

480

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
Clientes con un cierto tipo de Cdigo de clasificacin.

Copyright 2014 - Bizagi

481

Si usted define un filtro, este debera ser probado utilizando el botn Probar Filtro de Fuente

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 2014 - Bizagi

482

D clic en Siguiente.
Bizagi crear las entidades y las componentes de configuracin necesarios.

Copyright 2014 - Bizagi

483

D clic en Finalizar cuando termine la configuracin.

Copyright 2014 - Bizagi

484

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), como se indica en Verificar la Virtualizacin.

Utilizar la configuracin avanzada de Virtualizacin

Introduccin
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
Avanzada, la cual es otra alternativa para realizar una Virtualizacin en su proyecto.
Estos escenarios se refieren principalmente a:

Copyright 2014 - Bizagi

485

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
Avanzadas.
Si desea ms informacin y un ejemplo sobre virtualizacin a MySQL visite Virtualizacin Personalizada.

Tenga en cuenta que solamente la versin de Bizagi .NET soporta cualquier motor de base de datos.

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 Sistema.

Copyright 2014 - Bizagi

486

Qu necesita hacer?
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.
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)
Necesitamos definir explcitamente si vamos a utilizar una implementacin personalizada.
5. Incluir Entidades maestras para la Virtualizacin

Copyright 2014 - Bizagi

487

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 Empleado y Orden de Compra de la base de datos
Southwind de Oracle

Nuestro primer paso es asegurarnos de que estas tablas hayan sido creadas previamente en Bizagi

Copyright 2014 - Bizagi

488

como Entidades Maestras.

1. Crear las entidades en Bizagi con sus atributos pata igualar con la informacin de la fuente.
Vamos a crear las entidades maestras Empleados y Orden de Compra en Bizagi.
Entidad Empleados y sus atributos en Bizagi:

Entidad Orden de compra y sus atributos en Bizagi:

2. Definir el sistema
Para definir el sistema a utilizar en la integracin, d clic derecho en Sistema y seleccione la opcin
Nuevo Sistema.

Copyright 2014 - Bizagi

489

En la ventana de Nuevo Sistema, debe definir la informacin del sistema donde se encuentra la fuente
de datos externa.
Ingrese los detalles para el nuevo sistema: Nombre, Nombre Visual y Descripcin.

Copyright 2014 - Bizagi

490

Asegrese de que la opcin Permitir Entidades Virtuales y Replicacin este seleccionada.


Clic en OK.

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 Proveedor
seleccione la opcin Nuevo Proveedor.

Copyright 2014 - Bizagi

ubicado en el sistema recin creado, y

491

En la pestaa de configuracin del Proveedor, ingrese los detalles del nuevo proveedor: Nombre,
Nombre Visual y Descripcin.
Asegrese de marcar la opcin Permitir Replicacin para el proveedor.

Copyright 2014 - Bizagi

492

Luego, en la pestaa Propiedades de desarrollo del Proveedor d clic en el botn OLEDB Config.
Note que puede establecer diferentes valores para los diferentes ambientes del proyecto (desarrollo,
Test y produccin).
En el siguiente ejemplo, vamos a establecer las propiedades para el ambiente de desarrollo.

Luego, si la fuente de datos externa es SQL Server ingrese la siguiente informacin:

Copyright 2014 - Bizagi

493

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 2014 - Bizagi

494

Clic en OK para guardar la conexin.


De nuevo, clic en OK para regresar a la ventana de Nuevo proveedor.

Tenga en cuenta que es necesario definir las propiedades y valores de conexin 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 los valores
en Test o en produccin debe realizarse 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, PostgreSQL, DB2, etc).
Aqu 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 d clic derecho sobre el nodo de Entidades
Virtualizadas y seleccione la opcin Nueva clase de Virtualizacin.
Deje los valores que trae por defecto y d clic en Ok.

Copyright 2014 - Bizagi

495

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.
D clic derecho en la nueva clase virtualizada y seleccione la opcin Adicionar Entidad a virtualizacin.

Copyright 2014 - Bizagi

496

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.

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 Orden se debe mapear para la Virtualizacin (Adicionada como la entidad Orden de compra )

Copyright 2014 - Bizagi

497

La tabla Empleado se debe mapear para la Virtualizacin (Adicionada como la entidad Empleado):

Copyright 2014 - Bizagi

498

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 Propiedades.

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 cdigo del empleado, ingresamos IDEmpleado.

Repita este paso para todos los atributos de cada entidad virtualizada.
Atributos configurados para Empleados:

Copyright 2014 - Bizagi

499

Atributos configurados para Orden de compra:

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 Fuente Externa.
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
Clic para ver un ejemplo sobre como configurar la virtualizacin de un conjunto de tablas relacionadas.

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 2014 - Bizagi

500

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, para verificar explcitamente que los valores han sido sincronizados con la fuente,
usted puede escoger ver los valores mostrados en las entidades especficas a travs del mdulo de
Entidades (disponible para el ambiente de Desarrollo).
Para ver cmo verificar que la virtualizacin ha sido correctamente configurada (est ejecutndose
correctamente), dirjase a Verificar la Virtualizacin.

Personalizar la Virtualizacin

Resumen
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: Sobrescribir de mtodos y clases).
2. Configurar el proveedor de datos de Bizagi para utilizarlo en la librera personalizada de
Virtualizacin.
Esta configuracin utiliza la configuracin avanzada de Bizagi para virtualizaciones.

Sobrescribir de Clases y Mtodos


Para personalizar la virtualizacin de Bizagi, es necesario desarrollar un componente que implemente
las interfaces:
IProviderVirtualDA2
IEntityVirtualDA
IParameter
IDatabaseConstants

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 virtualizacin personalizada, Bizagi sigue las mejores prcticas para la

Copyright 2014 - Bizagi

501

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


La clase que implementa esta interfaz debe contener la lgica necesaria para manipular la informacin
virtualizada, como insertar un registro nuevo, consultar dentro de un grupo de registros, modificar y
eliminar un registro.
Los mtodos que esta clase debe tener se listan a continuacin:
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

Descripcin

obj Provider

Permite convertir el objeto que invoca la interfaz


IProviderVirtualDA.

htMetadata

Contiene la informacin requerida en forma de metada para


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

Copyright 2014 - Bizagi

502

tener que aplicar filtros.


Parmetros

Descripcin

sEntSource

Nombre de la tabla a replicar en la fuente de datos

arrsColList

Arreglo que contiene el nombre de las columnas de la


consulta en la fuente de datos.

RETURNED DataSet

Un DataSet con los valores de la entidad.

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

Descripcin

sEntSource

Tabla donde la entidad es implementada.

arrsKeyColumns

Arreglo que contiene los nombres de la columna a ser


utilizada para filtrar los registros.

arroKeyValues

Arreglo que contiene los valores a ser utilizados como filtros


para la bsqueda de un registro.

arrsColList

Arreglo que contiene el nombre de las columnas a ser


consultadas.

RETURNED DataSet

Un conjunto de datos con valores para la entidad.

DataSet GetEntityInstancesTable(string sEntSource, string[] arrsKeyColumns, string[] arrsColList,


string sFilterText, bool bFillSchema, int iTopReturnRows)
Parmetros

Descripcin

sEntSource

Tabla donde se localiza la entidad.

arrsKeyColumns

Arreglo de columnas utilizadas como llaves.

arrsColList

Columnas a ser incluida en la lista.

sFilterText

Filtros para ser aplicados en bsqueda de entidades con la


clausula o condicin WHERE (donde)

bFillSchema

Verdadero si la informacin del esquema debe ser


retornada de la base, falso de lo contrario.

iTopReturnRows

Nmero de registros a ser regresados.

RETURNED DataSet

Un conjunto de datos con valores para la entidad

Object GetAttributeValue(string sEntSource, string[] arrsKeyColumns, object[] arroKeyValues, string

Copyright 2014 - Bizagi

503

sAttrSource)
Parmetros

Descripcin

sEntSource

Tabla donde se implementa la entidad.

arrsKeyColumns

Arreglo de columnas utilizadas como llaves.

arroKeyValues

Valores de las columnas utilizados como llaves.

sAttrSource

Columna de variables a regresar.

RETURNED Object

Los valores de los atributos.

bool ExistsEntityInstance(string sEntSource, string[] arrsKeyColumns, object[] arroKeyValues)


Parmetros

Descripcin

sEntSource

Tabla donde se implementa la entidad.

arrsKeyColumns

Arreglo de columnas utilizadas como llaves.

arroKeyValues

Valores de las columnas utilizados como llaves.

arrsColList

Arreglo que contiene le nombre de las columnas a ser


consultadas.

RETURNED bool

Verdadero si la instancia fue encontrada, falso de lo


contrario.

int ExistsEntityInstance(string sEntSource, string sColumn, object oValue, string[] arrsKeyColumns,


object[] arroKeyValues)
Parmetros

Descripcin

sEntSource

Tabla donde se implementa la entidad.

sColumn

Columna utilizada para encontrar la instancia.

oValue

Valores utilizados para encontrar una instancia.

arrsKeyColumns

Arreglo de columnas utilizadas como llave.

arroKeyValues

Arreglo de los valores de las columnas utilizadas como llave.

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

Descripcin

Copyright 2014 - Bizagi

504

sEntSource

Tabla donde se implementa la entidad

htAddCols

Lista de columnas para incluir valores.

arrsKeyColumns

Arreglo de columnas utilizadas como llave.

arroKeyValues

Arreglo de los valores de las columnas utilizadas como llave.

arrsAutoColumns

Arreglo de columnas auto-numeric

RETURNED
Hashtable

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

Descripcin

sEntSource

Tabla donde se implementa la entidad

arrsKeyColumns

Arreglo de columnas utilizadas como llave.

arroKeyValues

Arreglo de los valores de las columnas utilizadas como llave.

htUpdateCols

Hastable que contiene las columnas a ser actualizadas, con


los valores de sus parejas.

arrsAutoColumns

Arreglo de columnas auto-numeric

RETURNED
Hashtable

Debe regresar a HashTable que contiene el nombre de la


columna y el valor que fue incluido.

bool DeleteEntity(string sEntSource, string[] arrsKeyColumns, object[] arroKeyValues): Elimina un


registro de la base de datos.
Parmetros

Descripcin

sEntSource

Tabla donde se implementa la entidad

arrsKeyColumns

Arreglo de columnas utilizadas como llave.

arroKeyValues

Arreglo de los valores de las columnas utilizadas como llave.

RETURNED bool

Debe regresar verdadero si el registro fue borrado, y Falso


de lo contrario.

Interfaces de constantes: IParameter, IDatabaseConstants


Tenga en cuenta que Bizagi construir la consulta y su sintaxis.
De acuerdo a esta idea, asegrese de definir todas las constantes apropiadas para las consultas en el
motor de la Base de datos especfico en estas interfaces.
Por ejemplo: private readonly string m_sConcatSymbol, como el smbolo que se utilizar para la

Copyright 2014 - Bizagi

505

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".

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 2014 - Bizagi

506

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,

Copyright 2014 - Bizagi

507

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)
{

IProviderVirtualDA2.AddParameter(Vision.DA.IParameter

throw new NotImplementedException();


}
void
{

IProviderVirtualDA2.ClearParameters()
m_alParams.Clear();

}
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,

Copyright 2014 - Bizagi

508

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())
{
//--- Add the SQLParameter object to the SQLCommand
object
oCmd.Parameters.Add(ConvertParameterToMySqlParameter((CMySq
lParameter)oEnumerator.Current));
}
}

Copyright 2014 - Bizagi

509

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 2014 - Bizagi

510

}
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(nLastStrInde
x, _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++;

Copyright 2014 - Bizagi

511

}
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;
}
private static int IndexOfParam(string sParamName,
List<CMySqlParameter> alParams, int iMaxParamIndex)
{
int _i = 0, _n = iMaxParamIndex;
while (_i < _n)
{
if (((CMySqlParameter)alParams[_i]).ParameterName ==

Copyright 2014 - Bizagi

512

sParamName)
{
_n = _i;
}
else
{
_i++;
}
}
return (_n == iMaxParamIndex) ? -1 : _n;
}

#endregion
#region IProviderVirtualDA Members
void
{

IProviderVirtualDA.BeginTransaction()
throw new NotImplementedException();

}
void
{

IProviderVirtualDA.CloseConnection()
if (MySqlconn != null)
MySqlconn.Close();
MySqlconn = null;

}
void
{

IProviderVirtualDA.Commit()

}
void
{

IProviderVirtualDA.Init(HybridDictionary htMetadata)
m_htMetadata = htMetadata;

}
void
{

IProviderVirtualDA.OpenConnection()

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");

Copyright 2014 - Bizagi

513

}
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
{

IProviderVirtualDA.Rollback()

}
#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);

Copyright 2014 - Bizagi

514

return ds;
}
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()

Copyright 2014 - Bizagi

515

{
m_bDisposed = false;
}
#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
StringBuilder(htAddCols.Count
StringBuilder
StringBuilder(htAddCols.Count

sbIntoList = new
* 10);
sbValuesList = new
* 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(" ) ");

Copyright 2014 - Bizagi

516

m_objSystem.executeNonQueryMySQL(sbSQL.ToString());
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(strin

Copyright 2014 - Bizagi

517

g sEntSource, string[] arrsKeyColumns, object[] arroKeyValues)


{
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);

Copyright 2014 - Bizagi

518

// FROM clause
sbSQL.Append(" FROM ");
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;*/

Copyright 2014 - Bizagi

519

return ds;
}
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

Copyright 2014 - Bizagi

520

implemented.");
}
#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;
}

Copyright 2014 - Bizagi

521

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;
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;

Copyright 2014 - Bizagi

522

}
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;
}
}
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;
}

Copyright 2014 - Bizagi

523

set
{
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;
}
}

Copyright 2014 - Bizagi

524

public bool UseCurrentSourceColumnValue


{
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;

Copyright 2014 - Bizagi

525

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;
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;

Copyright 2014 - Bizagi

526

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;
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();

Copyright 2014 - Bizagi

527

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; } }
/// <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

Copyright 2014 - Bizagi

528

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; } }
/// <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

Copyright 2014 - Bizagi

529

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; } }
/// <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

Copyright 2014 - Bizagi

530

/// </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
/// </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;

Copyright 2014 - Bizagi

531

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; } }
/// <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; }

Copyright 2014 - Bizagi

532

/// <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);
}
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).

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 Sistemas, en la vista de Mdulos de Bizagi.
Puede dar clic derecho sobre el elemento sistema y seleccionar Nuevo Sistema del men desplegable
o dar clic en Nuevo sistema de la barra del men.

Copyright 2014 - Bizagi

533

2. Ingrese el Nombre, Nombre Visual y Descripcin para el nuevo sistema y seleccione el checkbox de
Permitir Entidades Virtuales para replicacin para este sistema.
Clic en Ok para guardar cambios.

3. Clic en el signo (+) al lado del sistema recin creado.

Copyright 2014 - Bizagi

534

Clic derecho en el elemento Nuevo Proveedor.

4. En la ventana del Nuevo Proveedor ingrese Nombre, Nombre Visual y Descripcin en la pestaa de
Cconfiguracin Bsica.
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 Detalles de Conexin y d clic en Nueva librera.

Copyright 2014 - Bizagi

535

6. Ingrese Nombre, Nombre Visual y Descripcin.


Luego haga clic en Seleccionar Librera para seleccionar el .dll de la librera de virtualizacin
personalizada creada previamente.
D clic en Ok en la ventana de Nueva Librera.

Copyright 2014 - Bizagi

536

7. D 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.
D clic en Ok .

Copyright 2014 - Bizagi

537

8. Ahora, en la pestaa Conexin Desarrollo, incluya las propiedades de la conexin haciendo clic en el
botn Metadata para crear una nueva fila Propiedad-Valor.
D clic en Ok.

9.Expanda el elemento nuevo proveedor, seleccione el elemento Entidades Virtuales y cree una Nueva
Clase de Virtualizacin.

Copyright 2014 - Bizagi

538

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.

Copyright 2014 - Bizagi

539

11.D clic derecho sobre el nuevo elemento de la clase de la entidad y seleccione la opcin Adicionar
Entidad a Virtualizacin.

12. En la ventana Adicionar Entidad, 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).
D clic en OK para guardar los cambios.

Copyright 2014 - Bizagi

540

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 Editar Atributo, escriba el nombre del atributo externo y haga clic en OK.

Copyright 2014 - Bizagi

541

Si su librera de Virtualizacin personalizada tiene referencias a otras libreras, es necesario copiarlas


a una carpeta de Bizagi Studio, (por defecto en "C:\Program Files\Bizagi\Bizagi Standard\Studio"), y
en la carpeta bin de la carpeta aplicacin web (por defecto en "C:\Bizagi\Standard\Projects
\[PROJECT_NAME]\WebApplication\bin").
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, 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) como se indica en Verificar la Virtualizacin.

Verificar la Virtualizacin

Introduccin
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.
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).

Copyright 2014 - Bizagi

542

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.

En las entidades maestras creadas, d clic en Valores para consultar sus registros.
El rea de trabajo de Bizagi mostrar los valores sincronizados.

Copyright 2014 - Bizagi

543

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 Clientes, incluidos desde la fuente de datos externa:

Valores de Proveedores, incluidos desde la fuente de datos externa:

Cmo acceder 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
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).

Copyright 2014 - Bizagi

544

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
CEntityManager 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.

Opciones adicionales para la configuracin de Virtualizacin

Introduccin
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.

Copyright 2014 - Bizagi

545

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 d clic derecho sobre la opcin Probar proveedor (o
d clic en el botn en el men como se muestra).

Copyright 2014 - Bizagi

546

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.

Copyright 2014 - Bizagi

547

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, d clic en la entidad virtual y seleccione la opcin Probar entidad Virtual.
Esta opcin usa IIS para realizar la prueba.

En la ventana que se abre, d clic en Comenzar test.

Copyright 2014 - Bizagi

548

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).

Esta caracterstica solamente esta disponible en el ambiente de desarrollo cuando el Esquema y la


entidad no han sido deployed al ambiente de produccin.

Copyright 2014 - Bizagi

549

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 Adicionar entidad a la Virtualizacin.

Copyright 2014 - Bizagi

550

A travs de esta opcin, usted podr incluir una entidad como lo hizo con las opciones avanzadas de
configuracin.
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.

Copyright 2014 - Bizagi

551

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 2014 - Bizagi

552

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
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
(es decir, cuando se realiza configuracin de forma manual utilizando la opcin Estndar en el modulo
Sistemas) se puede hacer a travs del modulo Entidades.

Copyright 2014 - Bizagi

553

Haga clic derecho en la entidad maestra que ha sido virtualizada y seleccione Propiedades Avanzadas.
En la pestaa Fuente de Filtro (Source Filter) revise o realice cambios en el filtro.

Copyright 2014 - Bizagi

554

Usted puede probar el filtro utilizando la opcin Probar Filtro de la fuente para obtener los valores de
la fuente:

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.

Copyright 2014 - Bizagi

555

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 datos (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.

Mejores prcticas para la integracin de datos

Lineamientos generales
El siguiente articulo enumera las mejores practicas que se deben utilizar (o planear usar) con la
Virtualizacin o Replicacin 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).

Copyright 2014 - Bizagi

556

De esta manera, considerar cuales entidades se virtualizarn o replicarn 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
Observaciones y Cuentas Totales para un cliente, son creados en otra entidad
(Customer_AdditionalInfo) que referencia a la entidad virtual RCustomer:

3. Tener en cuenta siempre el mapeo en Bizagi de relaciones y llaves


compuestas
Copyright 2014 - Bizagi

557

Es primordial configurar siempre los campos que se van a usar de la fuente externa como atributos en
Bizagi.
Adicionalmente, se deben crear las relaciones en Bizagi y asegurarse de que tambin estn mapeadas.
Para ms informacin y gua sobre esta configuracin, consulte el ejemplo en Como configurar
Virtualizacin , donde se ilustra tambin la consideracin cuando se referencien llaves primarias
compuestas.

4. 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.

El uso de un puerto TCP explicito sigue las mejores prcticas (en vez de usar puertos dinmicos TCP).

Cuando se configura la Virtualizacin utilizando la edicin Bizagi 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 2014 - Bizagi

558

La ltima configuracin de SQLServerDBPort solo es necesaria para la edicin Bizagi 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

Copyright 2014 - Bizagi

559

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?

5. 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.

6. Nomenclatura de las entidades


Los nombres en Bizagi de las entidades a virtualizar o a replicar, deben ser ms cortos de 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.

7. 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.

8. Utilice parmetros de optimizacin cuando se requieran


Cuando se consulta informacin de una fuente externa a travs de la Virtualizacin, Bizagi utilizar un
parmetro de optimizacin para crear consultas adicionales, y por demanda, sobre la informacin que
se encuentra en columnas de tipo texto cuya longitud sea mayor de 100 caracteres (p.e, varchar(101),
varchar2(200), etc).
Por lo tanto, usted puede modificar este parmetro de manera que mejore el rendimiento en ciertos

Copyright 2014 - Bizagi

560

escenarios
Para utilizarlo, adicione la siguiente llave al archivo de configuracin web.config:
<add key="AttribMaxLengthThreshold" value="[longitud_columna]"/>
Ntese que al editar el valor en [longitud_columna] con la longitud de la cadena que usted
desea que Bizagi considere en la consulta principal, har que los atributos con ms de 100 caracteres
no requieran una consulta adicional.

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
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.

Tipos de datos soportados

Introduccin
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 2014 - Bizagi

561

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

String

VARCHAR

String

TEXT

No soportado
Nmeros Exactos

BIGINT

Big Integer

INT

Integer

SMALLINT

Small Integer

TINYINT

Tiny Integer

DECIMAL

Currency

NUMERIC

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

MONEY

Currency

SMALLMONEY

Currency (soporte limitado)

BIT

Boolean
Nmeros Aproximados

FLOAT

Float

REAL

Real
Fecha y Hora

DATETIME

Date-time

SMALLDATETIME

No soportado
Textos Binarios

BINARY

No soportado

Copyright 2014 - Bizagi

562

Tipo de datos SQL Server


VARBINARY

No soportado

IMAGE

No soportado
Caracteres de Texto Unicode

NCHAR

String (Soporte total para unicode)

NVARCHAR

String (Soporte total para unicode)

NTEXT

No soportado
Otros Tipos de Dato

UNIQUEIDENTIFIER

No soportado

TIMESTAMP

No soportado

CURSOR

No soportado

SQL_VARIANT

No soportado

TABLE

No soportado

XML

No soportado

Tipos de Datos Oracle


Caracteres de Texto
CHAR

String

NCHAR

String (soporte limitado)

NVARCHAR

String (soporte limitado)

VARCHAR

String.
Oracle recomienda utilizar varchar2 en su lugar.

VARCHAR2

String

LONG

No soportado

RAW

No soportado

LONG RAW

No soportado
Numricos

NUMBER(1)

Tiny Integer

NUMBER (3)

Tiny Integer

NUMBER (6)

Small Integer

Copyright 2014 - Bizagi

563

Tipos de Datos Oracle


NUMBER(10)

Integer

NUMBER (19)

Big Integer

NUMBER (17,4)

Float

NUMBER(18,4)

Float

NUMBER (19,4)

Float

NUMERIC

Float

FLOAT

Float

DEC

Tiny Integer

DECIMAL

Tiny Integer
Fecha y Hora

DATE

Date-time

TIMESTAMP

No soportado

INTERVAL YEAR

No soportado

INTERVAL DAY

No soportado
Objeto Extenso (LOB)

BFILE

No soportado

BLOB

No soportado

CLOB

No soportado

NCLOB

No soportado
Rowid

ROWID

No soportado

UROWID

No soportado
XML

XMLTYPE

No soportado

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 la
razn por la que es temporal, los valores duran tanto como dure la variable sin afectar el modelo de
datos. Nos referiremos a esto como Atributos de Scope.

Copyright 2014 - Bizagi

564

Los atributos temporales (atributos del proceso) son utilizados en expresiones y en reglas 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 Elemento y luego la opcin Actividades, seleccione la actividad donde se va
agregar el atributo y seleccione Atributos.

Copyright 2014 - Bizagi

565

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 2014 - Bizagi

566

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.

Copyright 2014 - Bizagi

567

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, d clic derecho sobre la entidad y seleccione la opcin Editar
lista de atributos.

Copyright 2014 - Bizagi

568

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
utilizados en cualquier actividad que los necesite.

Copyright 2014 - Bizagi

569

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), d 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.

Copyright 2014 - Bizagi

570

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 Transacciones de larga duracin. 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 Scopes.
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.
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.

Copyright 2014 - Bizagi

571

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.

Llaves de negocio

Introduccin
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, d clic derecho en
ella y seleccione la opcin Propiedades Avanzadas.
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.
En la siguiente imagen TipodeDocumento y NmeroDocumento sern las llaves de negocio para la
entidad Cliente.

Copyright 2014 - Bizagi

572

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, Definir formas, 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 (WYSIWIG), 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 2014 - Bizagi

573

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 del asistente, d clic en Definir Formas. 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.

Copyright 2014 - Bizagi

574

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 imagen anterior.
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.
La informacin de la solicitud contiene: la fecha de la solicitud, el nombre del solicitante y la
justificacin de la compra.
Los tems solicitados: tabla con los servicios o bienes solicitados.
La informacin de entrega: direccin de entrega, fecha de entrega, ciudad de entrega.
Las formas sern creadas basndonos en el siguiente modelo de datos.

1. Vaya al tercer paso del asistente. Cuando se muestre el diagrama del proceso, d clic en la tarea

Copyright 2014 - Bizagi

575

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.

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 el panel, se muestra un mensaje de SOLTAR AQU y se
resalta una seccin de la forma, 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.

Copyright 2014 - Bizagi

576

3. D doble clic sobre el nombre del grupo para cambiar el nombre: Informacin de la solicitud,
Productos solicitados y Informacin de entrega respectivamente.

4. Regrese a la pestaa de Datos.


Para incluir atributos desde el modelo de datos, arrstrelos y sultelos a la posicin deseada.
Tan pronto como un atributo es incluido en la Forma, este se presenta en Bizagi y se convierte
en Control. Cada control tiene un tipo: texto, fecha, combo (lista desplegable), Si/No, nmero,
etc. Dependiendo del tipo de atributo.

Copyright 2014 - Bizagi

577

Para el primer grupo, arrastre y suelte los siguientes atributos: Fecha de la solicitud, Solicitado Por:
Informacin de la compra.
Asegrese de incluir los atributos en el primer grupo. Sultelos cuando el mensaje SOLTAR AQU del
primer grupo est resaltado.
Note que la Fecha de solicitud 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.

Copyright 2014 - Bizagi

578

6. Cuando se muestre la tabla de control, d 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. D clic
en OK cuando termine.

Copyright 2014 - Bizagi

579

7. Arrastre y suelte los controles para el ltimo grupo: Direccin de entrega, Ciudad de entrega y
Fecha de Entrega.

Copyright 2014 - Bizagi

580

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 2014 - Bizagi

581

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 el control no est marcado
obligatorio y de solo lectura.
Repita el procedimiento para el control de Solicitante.

Copyright 2014 - Bizagi

582

10. Cuando termine, clic en Guardar, para guardar todos los cambios.

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 2014 - Bizagi

583

Ribbon
El Ribbon presenta un conjunto de comandos que son relevantes para la Forma, por ejemplo, Guardar,
Copiar Desde, Propiedades de la Forma entre otras. Tambin muestra comandos contextuales, los
cuales estn relacionados al control seleccionado en un determinado momento, tales como Editable,
Visible y Requerido.

OPCIN DEL MEN

SUB OPCIN

DESCRIPCIN

Deshacer

Deshace la ltima accin realizada en la forma.

Rehacer

Rehace la ultima accin anulada.

Check-out
Forma
Guardar
Copiar Desde

Permite desbloquear la Forma para edicin cuando ha


sida abierta en modo slo lectura.
Guarda los cambios realizados en la forma.
Provee acceso a formas creadas previamente para

Copyright 2014 - Bizagi

584

OPCIN DEL MEN

SUB OPCIN

DESCRIPCIN
copiar su contenido exacto.

Copiar Formato

Copia el formato dado a un Control para configurarlo


en otro.

Propiedades

Provee acceso a las Propiedades de las formas tales


como Nombre de Mostrar, Descripcin, Es
Administrable.

Mostrar

Alertas

Resalta los errores y advertencias para toda la forma


o para controles especficos.

Validacin

Acciones y
Validaciones

Provee acceso al asistente de Acciones y Validaciones.

Convertir a

Muestra una lista de los posibles controles a los cuales


un control seleccionado puede ser convertido.

Eliminar
Renombrar
Controles
Visible
Editable
Requerido
Idiomas

Seleccionar Idioma

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.

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 Texto, Si/No, Fecha, entre otros. El ltimo funciona
como un contenedor para otros controles, por ejemplo, Grupos o Pestaas. Cuando un control es
incluido en el rea a mostrar, ser referenciado como un Control.
Pestaa de Layout: Le permite manipular el diseo de la forma, especficamente la separacin de
contenido en diferentes secciones.

Copyright 2014 - Bizagi

585

Contenedores: Grupos, Pestaas y Paneles


Los Contenedores le permiten organizar el rea de Trabajo para distribuir la informacin en Pestaas,
Grupos o Paneles.
Las Pestaas funcionan como en los navegadores web. Cuando usted da clic sobre ellas, muestran su
contenido y ocultan el de otras pestaas.
Los Grupos contienen controles en bloques, visualmente organizados en pequeos conjuntos de
informacin relacionada.
Los Panels agrupan controles que estn uno junto a otro en una forma para que las Acciones y
Validaciones los afecten como un todo, en vez de crear acciones individuales para cada uno, para ver
un ejemplo, dirjase a Afectando varios controles.

Copyright 2014 - Bizagi

586

Las pestaas y grupos tienen las siguientes propiedades. Nombre de mostrar, Visible y Editable. Las
dos ltimas propiedades Booleanas se pueden configurar en Verdadero (
Los Paneles solamente tienen la propiedad Nombre de mostrar.

) o Falso (

).

Adicionalmente, los grupos poseen una propiedad especial denominada Colapsado, la cual define si el
grupo se mostrar inicialmente expandido o colapsado.

Copyright 2014 - Bizagi

587

Cada control en el contenedor heredar los valores de propiedad asignados al Grupo o Pestaa. 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 Pestaa o Grupo, d doble clic sobre su nombre e ingrese el deseado.
D clic sobre el icono de marcacin verde ( ) para finalizar la edicin.
Para eliminar una Pestaa o Grupo, seleccinela y d clic en icono eliminar ( ) adjunto al borde del
control.

Copyright 2014 - Bizagi

588

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 2014 - Bizagi

589

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.

Copyright 2014 - Bizagi

590

Incluir una Pestaa dentro de una Pestaa


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 2014 - Bizagi

591

Layouts
Un Layout permite manipular el diseo de la forma, especficamente, la separacin del contenido en
diferentes columnas. La pestaa de Layout define el porcentaje por el cul se distribuye el espacio
disponible en el rea de trabajo. En esencia, divide el espacio en columnas de diferentes anchos
basados en una relacin porcentual. Por defecto, es una divisin de dos columnas con una distribucin
de anchura de 50/50.
Si se selecciona 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 Datos o Controles.
Para incluir un Layout en una forma, seleccione la pestaa de Layout e incluya el Layout deseado a la
seccin requerida.
Usted puede escoger entre 5 tipos de Layout predefinidos que distribuyen la informacin de acuerdo
al porcentaje seleccionado.
Panel Completo
70% - 30%
33% - 34% - 33%
30% - 70%
50% - 50%

Copyright 2014 - Bizagi

592

Cuando se incluye un layout, regrese a la pestaa de Datos o Control para poder arrastrar controles
dentro de l.

Copyright 2014 - Bizagi

593

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.

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), Controles (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. Esto indica dnde ser puesto el control cuando lo suelte
(Soltando el botn del mouse).

Copyright 2014 - Bizagi

594

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
obligatorio, 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, Grupos o Paneles para ayudarle a organizar la
informacin.

Copyright 2014 - Bizagi

595

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.

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 reutilizables, el nombre de mostrar es obligatorio. Para Formas de Proceso, el nombre de
mostrar se crea automticamente con el nombre de la Tarea a la cual estn asociadas.
El Texto de Ayuda y Descripcin no son campos obligatorios y se encuentran disponibles nicamente
para propsitos de documentacin.
La propiedad Es Administrable aplica solo en las formas creadas en entidades paramtricas. Si est
activada, Bizagi convierte la forma actual en una que contenga informacin usada ra administrar
entidades paramtricas en el Portal de Trabajo.
La propiedad Necesita confirmacin de Usuario se utiliza para mostrar un mensaje al usuario final

Copyright 2014 - Bizagi

596

cuando se da clic en Siguiente, para asegurarse de que el usuario desea continuar el Proceso actual.
Esto es muy til debido a que las acciones realizadas una vez se de Siguiente, NO SE PUEDEN
DESHACER.

Controles
Cada elemento incluido en una Forma se conoce como un Control en Bizagi.
Los elementos se adicionan de manera individual agregndolos desde el Panel Izquierdo del
Diseador de Formas. estos se pueden incluir dentro de una forma en dos formas:
Agregando atributos directamente del modelo de datos localizado en la pestaa Datos.
Seleccionando un elemento de la pestaa Controles y luego asociando el atributo.
Cuando un atributo o un control se inserta en una Forma, este es interpretado por Bizagi como un
Control.
Cada control procedente de un atributo tiene un tipo: texto, fecha, combo (lista desplegable), Si/No,
nmero, etc, dependiendo del tipo de atributo relacionado. Los que proceden de un tipo de Control
(Pestaa Controles) se limitan a heredar el tipo de control, ejemplos de estos se incluyen Moneda,
Campo de Texto y Controles de bsqueda.
Para borrar un Control seleccinelo y d clic en el icono de borrado (

Copyright 2014 - Bizagi

) adjunto al borde del mismo.

597

Usted puede seleccionar mltiples controles seleccionndolos mientras oprime la tecla Ctrl, Las
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 Supr.
Por defecto, cada control es visible, editable y no requerido en Bizagi.

Incluir un atributo a la Forma


Los atributos del modelo de datos son incluidos en la forma desde la pestaa Datos. Cuando un
atributo es agregado a la forma (rea de Trabajo), Bizagi interpreta y asigna un tipo al control
resultante.
Bizagi identifica la forma grfica ms apropiada de mostrar la informacin y selecciona el tipo de
control de manera acorde. Usted puede cambiar los tipos de control para ajustarse a sus necesidades.
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 Fecha de Solicitud es del tipo Fecha-Hora. Este se incluye como un Control
tipo Fecha en la forma.
El atributo Justificacin de la Compra es del tipo Texto. Este se incluye como un Control tipo Texto en
la forma.
Cuando usted arrastra un atributo relacionado como Cliente, este se incluir como un Control de
Bsqueda para permitir a los usuarios finales buscar el cliente deseado.

Incluir un control a la forma


La pestaa Controles (En el panel izquierdo) contiene varios elementos para incluirlos en la forma. El
Control heredar el tipo del elemento seleccionado, 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 2014 - Bizagi

598

Cuando un control es insertado en la Forma, sus propiedades se abrirn en la ventana de la izquierda.


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

DESCRIPCIN

Asociacin

Este control se utiliza para manipular relaciones muchos a muchos.


Permite relacionar valores de una coleccin a uno o ms valores de
otra coleccin.

Botn

Se muestra en el Portal de Trabajo y cuando se da clic sobre l, la


expresin o interfaz asociada se ejecutar.

Lista desplegable en Cascada

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.

Combo

Presenta una lista desplegable que muestra un conjunto de valores.


Solo uno de ellos puede ser seleccionado.

Fecha

Plantillas de Documentos

Presenta un calendario. La hora se muestra si es necesario.


Define y genera documentos en formato PDF que contienen
informacin del Proceso.
Se basan en una Plantilla de Word que contiene y muestra diferentes
tipos de contenido como imgenes, marcas de agua, formato de

Copyright 2014 - Bizagi

599

CONTROL

DESCRIPCIN
caracteres, tablas, etc.

Archivos

Permite cargar archivos a los usuarios finales. Cada archivo se


maneja como una coleccin de manera que se pueden cargar varios
archivos en un mismo atributo.

Archivos ECM

Permite a los usuarios adjuntar archivos a la aplicacin y mantenerlos


almacenados directamente en un repositorio ECM.
Para mayor informacin acerca de esta funcionalidad, consulte
Integracin ECM

Impresin de archivos

Permite la impresin de mltiples archivos relacionados a un caso,


todos al mismo tiempo con solo un clic

Vnculo a Forma

Presenta un vnculo que redirecciona a otra forma

Geolocalizacin

Muestra la ubicacin exacta del usuario final en trminos de latitud y


longitud, en dispositivos mviles.

Tabla agrupada

Presenta una tabla que contiene registros de una coleccin. La


principal diferencia con el control Tabla es que los registros pueden
ser agrupados de acuerdo a valores de una o ms de sus columnas.

Oculto

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 visibles al usuario

Imagen

Permite cargar y mostrar imgenes.

Etiqueta

Presenta un texto fijo sin relacin al modelo de datos.

Vnculo

Presenta un vnculo que redirecciona a una URL. Este puede estar


localizado en intranet o Internet.

Lista

Presenta una lista de valores para una entidad especfica. Solo un


valor puede ser seleccionado.

Moneda

Muestra montos monetarios.

Nmero

Muestra datos numricos.

Radio

Permite al usuario seleccionar exactamente un valor de una lista


corta.

Vista por registro

Presenta registros de una coleccin de manera individual, en una


forma embebida que contiene informacin detallada de cada uno.
Posee un men en la parte inferior que permite navegar la coleccin
y agregar, editar o eliminar registros.

Campo de Bsqueda

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
se puede seleccionar un registro de los resultados.

Copyright 2014 - Bizagi

600

CONTROL

DESCRIPCIN

Sugerencia

Busca registros de una entidad y propone datos de entrada a


medida que el usuario ingresa el texto. Estas sugerencias se basan
en la Fuente de Datos asociada al control.

Tabla

Presenta una tabla que debe ser relacionada a la Coleccin. La tabla


debe contener columnas para mostrar.

Cuadro de Texto
Si/No

Muestra atributos de tipo texto.


Muestra un atributo booleano a los usuarios finales para seleccionar
entre las opciones Si o No.

Asociacin

Uso
El Control de Asociacin se utiliza para administrar relaciones Muchos a Muchos. Este control permite
relacionar fcilmente valores de una coleccin con uno o mas valores de otra.
Para relacionarlos, el Control de Asociacin muestra los valores de una de las entidades como Grupos
y los de la otra como registros dentro de ellos. Una casilla de verificacin presente en cada registro
permite relacionarlo con su grupo correspondiente (valor de la otra entidad).

En la siguiente imagen relacionada a productos y garantas de una solicitud de crdito.


Las garantas de Hipoteca bsica y vehculo bsico estn relacionadas al producto Crdito.
Los Productos Cuenta y Tarjeta de crdito, no poseen garantas relacionadas.

Copyright 2014 - Bizagi

601

Consideraciones
Para utilizar un Control de Asociacin el modelo de datos debe contener:
Una Coleccin A (Entidad principal), en la siguiente imagen: Productos.
Una Coleccin B (Entidad secundaria), en la siguiente imagen: Garantas.
Una relacin uno a muchos desde la Coleccin A a la Coleccin B.

Tipos de atributo relacionados


El Control de Asociacin se relaciona a Colecciones que poseen relaciones muchos a muchos con otra
entidad.

Copyright 2014 - Bizagi

602

Propiedades
Las siguientes propiedades son exclusivas del Control de Asociacin:

Pestaa bsico
PROPIEDAD
Permitir girar

DESCRIPCIN
Permite cambiar el orden en el cual se realiza la asociacin de los valores.

Configuracin

Copyright 2014 - Bizagi

603

PROPIEDAD

DESCRIPCIN

Entidad principal

Xpath izquierdo: Relaciona el XPath a la Coleccin A.


Atributo visual izquierdo: Define el XPath del atributo que se muestra
para identificar los registros de la Coleccin principal.
Atributo adicional izquierdo: Define el XPath del atributo adicional que se
muestra para identificar los registros de la Coleccin principal.
Filtro izquierdo: Permite definir filtros sobre los registros mostrados en el
control de asociacin para la Coleccin principal. Los filtros avanzados
(definidos en reglas) no estn soportados.
Para mayor informacin consulte Filtros
Encabezado izquierdo: Define el encabezado que identifica a la Coleccin
principal.

Entidad secundaria

XPath derecho: Relaciona el XPath a la Coleccin secundaria.


Atributo visual derecho: Define el XPath del atributo que se muestra para
identificar los registros de la Coleccin secundaria.
Atributo adicional derecho: Define el XPath del atributo adicional que se
muestra para identificar los registros de la Coleccin secundaria.
Filtro derecho: Permite definir filtros sobre los registros mostrados en el
control de asociacin para la Coleccin secundaria. Los filtros avanzados
(definidos en reglas) no estn soportados.
Para mayor informacin consulte Filtros
Encabezado derecho: Define el encabezado que identifica a la Coleccin
secundaria.

Ejemplo
En un Proceso de solicitud de crdito, cada solicitud tiene varios productos y garantas asociadas. Una
garanta puede cubrir uno o ms productos y un producto puede ser cubierto por una o ms
garantas. El modelo de datos relacionado se muestra a continuacin:

Copyright 2014 - Bizagi

604

Para definir cules garantas cubren cuales productos y cules productos son cubiertos por cules
garantas, se utiliza un Control de Asociacin.
Siga los pasos que se describen a continuacin para configurarlo:
1. Vaya al Diseador de Formas e incluya un Control de Asociacin desde la pestaa de Controles.

2. Al soltar el control en la Forma, se abrir una ventana emergente.

Copyright 2014 - Bizagi

605

Ingrese la siguiente informacin:


Xpath izquierdo: Seleccione el XPath a la coleccin que contiene los registros a mostrar en la
entidad principal. En este caso, la coleccin Productos.
Atributo visual izquierdo: Seleccione el XPath al atributo de la coleccin que se mostrar. En este
caso, el atributo ProductSubtype.Name.
Filtro izquierdo: En este caso no se requiere utilizar un filtro.
Encabezado izquierdo: Ingrese "Productos"
Xpath derecho: Seleccione el XPath a la coleccin que contiene los registros a mostrar en la entidad
principal. En este caso, la coleccin Guarantees.
Atributo visual derecho: Seleccione el XPath al atributo de la coleccin que se mostrar. En este
caso, el atributo Guaranteetype.Name.
Filtro derecho: En este caso no se requiere utilizar un filtro.
Encabezado derecho: Ingrese "Garantas".

Copyright 2014 - Bizagi

606

3. Vaya al Portal de Trabajo para probar el control.


Para visualizar los registros en el control, estos deben ser incluidos en las entidades respectivas. En
este caso tenemos:
Entidad Productos: Cuenta, crdito y tarjeta de crdito.
Entidad garantas: Hipoteca bsica, prenda bsica y vehculo bsico.

Copyright 2014 - Bizagi

607

Marque los valores deseados de acuerdo a lo que desee relacionar para establecer las relaciones.

Botn

Uso
El Botn se muestra en el Portal de Trabajo y 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 reutilizable anidada, la expresin o interfaz creada tendr el
contexto de la entidad de la Forma.
Cuando un botn se usa en la columna de una tabla las acciones que ejecute deben estar
relacionadas exclusivamente con el registro en donde se encuentra el botn. Debe utilizarse para
solamente para realizar acciones de Refresco, Ejecutar interfaz y Ejecutar regla.
El comportamiento del control se configura utilizando Acciones de la Forma.
Los botones pueden ejecutar reglas o interfaces.

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

Copyright 2014 - Bizagi

608

PROPIEDAD
Etiqueta del
Botn

DESCRIPCIN
El texto ingresado en la Etiqueta del Botn se mostrar dentro del botn.

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.
Para configurar este comportamiento:
1. Incluya un botn en la forma e ingrese la etiqueta deseada.

2. Cree una Accin desde el asistente de Acciones y Validaciones.

Copyright 2014 - Bizagi

609

3. Seleccione el botn como el control de condicin. Al hacerlo, se habilitar la opcin clic para
identificar cundo el botn ha sido presionado.

Copyright 2014 - Bizagi

610

4. Incluya la accin que se ejecutar al dar clic en el botn. (Entonces)


En este caso, el botn ejecutar una regla que asigna la fecha actual a un atributo de la forma.
D clic en Agregar una accin y seleccione Ejecutar regla como el comando. Luego cree la regla
desde el editor de expresiones.

Copyright 2014 - Bizagi

611

La expresin tendr el contexto de la Entidad de Proceso.

Copyright 2014 - Bizagi

612

5. Actualice los controles que se van a actualizar.


Haga clic en Agregar una accin y defina los controles que se actualizarn una vez ejecutada la regla.
Para hacerlo, utilice el comando Refrescar.
En este caso, el control a refrescar es Fecha de solicitud.

Copyright 2014 - Bizagi

613

En el Portal de Trabajo el botn se mostrar con la etiqueta definida. Cuando se d clic sobre l, la
expresin asociada llenar la fecha de solicitud.

Copyright 2014 - Bizagi

614

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.

Ejemplo
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.

Propiedades
Las siguientes son propiedades exclusivas para el control de Lista desplegable en Cascada:

Copyright 2014 - Bizagi

615

Pestaa Bsico
PROPIEDAD

DESCRIPCIN

Atributo de Mostrar

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

Pestaa Avanzado
PROPIEDAD

DESCRIPCIN

Actualizar al Cambio

Esta propiedad est deprecada, recomendamos usar Acciones y


Validaciones.
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.

Al dar clic en el icono Valor Predeterminado se reiniciarn las propiedades.


Ejemplo Ordenar por

Copyright 2014 - Bizagi

616

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 es Estados.

Copyright 2014 - Bizagi

617

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 2014 - Bizagi

618

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.

Copyright 2014 - Bizagi

619

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 2014 - Bizagi

620

PROPIEDAD

DESCRIPCIN

Atributo de Mostrar

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

Copyright 2014 - Bizagi

621

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

Esta propiedad est deprecada, recomendamos usar Acciones y


Validaciones.
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.

Al dar clic en el icono Valor Predeterminado se reiniciarn las propiedades.


Ejemplo de Ordenar por

Copyright 2014 - Bizagi

622

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 (Centro de Costo)
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).

2. Ingrese los valores (o registros) de la entidad Centro de Costo.


3. En el diseador de formas identifique el atributo Centro de Costo. Insrtelo en el rea de trabajo.
Cuando usted inserta un atributo con una entidad relacionada, Bizagi lo interpretar, por defecto,
como un combo.

Copyright 2014 - Bizagi

623

4. Si usted necesita mas controles, agrguelos a la forma.


Vaya al Portal de Trabajo y pruebe el control.

Fecha

Uso
Presenta un calendario a los usuarios finales para seleccionar una fecha fija. El tiempo en horas y

Copyright 2014 - Bizagi

624

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

DESCRIPCIN

Formato de Fecha

Define el formato de la fecha.


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 Formato de Fecha.

Copyright 2014 - Bizagi

625

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.

Copyright 2014 - Bizagi

626

Pestaa Avanzado
PROPIEDAD

DESCRIPCIN

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. 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.

Al dar clic en el icono Valor Predeterminado 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 2014 - Bizagi

627

2. Como la hora se debe mostrar, vaya a la pestaa de Formato en las propiedades del control y
habilite la propiedad Mostrar Hora.

3. Para definir la fecha por defecto de este control (la fecha en la que se crea la queja), vaya a la
pestaa Avanzado, en las propiedades del control, y defina una expresin en la propiedad Valor por
defecto.

4. En un mdulo de expresin utilice la sentencia DateTime.Now para asignar la fecha en la cual se

Copyright 2014 - Bizagi

628

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 Bsico y
configure la propiedad Editable en No.

6. Vaya al Portal de Trabajo para probar el control.

Copyright 2014 - Bizagi

629

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.
Si necesita copiar archivos de un atributo a otro utilizando reglas de negocio, refirase a Manejar
archivos con expresiones.

Atributos Relacionados
Este control se relaciona exclusivamente a atributos tipo Archivo.

Propiedades
Las siguientes son propiedades exclusivas para el control Archivo.

Pestaa Avanzado

Copyright 2014 - Bizagi

630

PROPIEDAD

DESCRIPCIN

Permitir Borrar

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)

Define el tamao mximo (en bytes) que puede tener un archivo antes de que
se considere inadecuado para ser cargado.
Considere la siguiente tabla con el fin de convertir a bytes las unidades ms
comunes de medicin para el almacenamiento de datos
MEDIDA

Habilitar cono de
"enviar como
adjunto"

BYTES

1 KB
(Kilobyte)

1.024

1 MB
(Megabyte)

1.048.576

1 GB
(Gigabyte)

1.073.741.82
4

Muestra un cono que permite a los usuarios enviar rpidamente el archivo


como adjunto en un correo electrnico.

Al dar clic en el icono Valor Predeterminado 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 2014 - Bizagi

631

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.

3. Solo un archivo podr ser cargado en este control. Para configurar esta condicin, vaya a la
pestaa Avanzado e ingrese "1" en la propiedad Mximo de Archivos.

Copyright 2014 - Bizagi

632

4. En la propiedad de Extensiones Vlidas escriba pdf para restringir los archivos adjuntos a formato
pdf.

Copyright 2014 - Bizagi

633

5. Defina el tamao mximo permitido escribiendo 2000 en la propiedad Tamao Mximo.

6. Finalmente habilite la propiedad Permitir Eliminar para activar la opcin Eliminar.

Copyright 2014 - Bizagi

634

7. Vaya al Portal de Trabajo para probar el control Archivo.


D clic sobre el icono de Adjuntar para cargar un archivo. Una nueva ventana de exploracin se
mostrar para buscar y seleccionar el archivo deseado.

Copyright 2014 - Bizagi

635

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 PDF podrn ser seleccionados.

Si usted intenta adjuntar un archivo de mas de 2000 bytes, la siguiente validacin se mostrar.

Finalmente observe que usted puede eliminar el archivo adjunto dando clic en el icono (
muestra cuando se ubica el cursor sobre el archivo.

Copyright 2014 - Bizagi

) que se

636

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 Archivos ECM.

Pestaa Avanzado

Copyright 2014 - Bizagi

637

PROPIEDAD

DESCRIPCIN

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)

Define el tamao mximo (en bytes) que puede tener un archivo antes de que
se considere inadecuado para ser cargado.
Considere la siguiente tabla con el fin de convertir a bytes las unidades ms
comunes de medicin para el almacenamiento de datos
MEDIDA

Habilitar cono de
"enviar como
adjunto"

BYTES

1 KB
(Kilobyte)

1.024

1 MB
(Megabyte)

1.048.576

1 GB
(Gigabyte)

1.073.741.82
4

Muestra un cono que permite a los usuarios enviar rpidamente el archivo


como adjunto en un correo electrnico.

Copyright 2014 - Bizagi

638

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.

Impresin de archivos

Uso
El control de Impresin de archivos se utiliza para imprimir mltiples archivos, asociados a un caso,
todos al mismo tiempo son solo un clic.

Consideraciones
Los atributos de tipo archivo, plantillas de documento, imgenes y archivos ECM pueden ser
incluidos en este control para ser impresos de forma simultnea.
Los archivos incluidos pueden ser impresos o exportados a un archivo en PDF. Para la ltima opcin
se requiere tener instalado un lector de PDF.
Es posible incluir cualquier archivo del modelo de datos, incluso si este no es visible en la forma
donde se configura el control.
El comportamiento de este control depende del navegador donde se ejecute. En Internet Explorer se
abrir el dialogo de impresin por defecto. En Firefox se abre un PDF.
Los formatos no soportados son:
o
o
o
o
o
o
o

Documento de Microsoft Word 95- doc.


Imagen SVG - svg.
Xml - XML PowerPoint 2003
Documento de Microsoft Word encriptado doc/docx.
Archivo de PowerPoint encriptado Ppt/Pptx.
Archivo de Excel encriptado Xls/Xlsx.
PDF encriptado con contrasea abierta.

Propiedades
Las siguientes son propiedades exclusivas del control Impresin de archivos:

Pestaa Bsico
PROPIEDAD

DESCRIPCIN

Etiqueta del botn

El texto ingresado en la etiqueta del botn aparecer dentro del botn.

Origen

Define los archivos (del modelo de datos) asociados para impresin.

Pestaa de Formato

Copyright 2014 - Bizagi

639

PROPIEDAD

DESCRIPCIN

Alineacin
horizontal

Define la alineacin del botn. Las opciones posibles son: derecha, izquierda,
justificado y centrado.

Formato

Define el tamao de letra, color de fuente y color de fondo del botn.

Ejemplo
En un Proceso de Solicitud de Compra el departamento de compras necesita llevar un registro fsico
del proceso de seleccin de los proveedores.
Cada vez que se solicita una compra, se evalan al menos tres cotizaciones antes de seleccionar el
proveedor. Al final del proceso, el asistente de compras debera poder imprimir todas las cotizaciones
as como la orden de compra generada para el proveedor seleccionado.
Abrir e imprimir un documento a la vez no es eficiente. Por esta razn se incluir un control de
Impresin de archivos en la ltima tarea del proceso, con el fin de imprimir los documentos necesarios
haciendo clic en un botn.
Para configurar este control:
1. Vaya a la forma donde se debe incluir el control. En este caso, la ltima actividad del proceso de
Solicitud de Compras.
Observe que en esta forma tenemos un atributo de tipo archivo para almacenar la orden de compra.
As mismo, las cotizaciones se registran en la coleccin de Cotizaciones.

2. Incluya un control de Impresin de archivo en la forma, arrastrndolo desde la pestaa Controles.

Copyright 2014 - Bizagi

640

3. D clic en el control para acceder a sus propiedades e ingrese una etiqueta para el botn.

4. En la propiedad Origen, d clic en el icono Agregar que se encuentra a la derecha, para asociar un
archivo.

Copyright 2014 - Bizagi

641

5. Navegue a travs del modelo de datos e incluya tantos archivos como se requiera. Para este caso,
primero incluya el archivo de la orden de compra.

6. Ahora incluya el archivo de las cotizaciones. Debido a que este archivo se encuentra dentro de una
coleccin, el control imprimir tantos archivos como registros incluidos en la coleccin.

Copyright 2014 - Bizagi

642

7. Guarde la forma y vaya al Portal de Trabajo para probar el funcionamiento del control.
D clic en el control Impresin de archivos.

Bizagi genera un PDF que consolida todos los documentos asociados y abre el dialogo de impresin
para seleccionar una impresora.

Copyright 2014 - Bizagi

643

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

DESCRIPCIN

Abrir maximizado

Cuando se habilita, la forma asociada se abrir en modo pantalla completa.

Forma de Adicin

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
Copyright 2014 - Bizagi

644

Un Proceso de Gestin de Oportunidades de Venta administra las acuidades 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 potenciales 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 Vnculo a Forma.

2. Vaya a la pestaa Bsico en las propiedades del control y abra la lista desplegable bajo la
propiedad Forma de Adicin.

Copyright 2014 - Bizagi

645

3. Crearemos una nueva forma. Si su forma ha sido creada previamente, seleccinela en la lista.
D clic en la opcin Nueva Forma.

4. En la nueva forma incluya toda la informacin necesaria desde el modelo de datos.


Abra la opcin Propiedades de la forma (ubicada en el Ribbon) y asigne un nombre de mostrar a la

Copyright 2014 - Bizagi

646

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.

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.

Copyright 2014 - Bizagi

647

Geolocalizacin

Uso
El control Geolocalizacin se utiliza para mostrar la ubicacin exacta del usuario final en latitud y
longitud, en los dispositivos mviles.

Consideraciones
Destinado a dispositivos mviles .
Los servicios de GPS en el dispositivo mvil deben estar habilitadas. Bizagi le pedir el acceso a su
ubicacin.
El control ser SIEMPRE no editable.
Si no se permite el acceso a la ubicacin, el control mostrar un error. Si el control es obligatorio, el
caso no podr continuar. Si el control no es obligatorio la ubicacin permanecer vaca.
El control mostrado en la versin de escritorio puede o puede no mostrarse de acuerdo al
navegador y sus propiedades .

Atributos Relacionados
Geolocalizacin est relacionada con atributos de tipo texto. Le recomendamos que utilice una
longitud de 50.

Propiedades
Las siguientes propiedades son exclusivas para el control Geolocalizacin :

Pestaa Bsico

Copyright 2014 - Bizagi

648

PROPIEDAD
Permitir
actualizacin

DESCRIPCIN
Cuando se haya seleccionado una ubicacin, la propiedad Permitir
actualizacin permite la actualizar los datos mostrados.
Si no est habilitado, entonces los datos obtenidos se guardarn y no se
pueden cambiar.

Ejemplo
Imagine que tiene un proceso de Solicitud de viaje y la informacin Salida se complementa con un
control de Geolocalizacin que actualiza su ubicacin exacta.
1. Cree un atributo de tipo texto.
2. Arrastre y suelte el atributo en la forma deseada y haga clic derecho en l.
Seleccione Convertir a Geolocalizacin.

Copyright 2014 - Bizagi

649

Como alternativa, arrastre y suelte un control de Geolocalizacin de la lista de Controles y relacione el


atributo creado.

Copyright 2014 - Bizagi

650

3. El atributo siempre mostrar como slo lectura.

Copyright 2014 - Bizagi

651

Tabla agrupada

Uso
El control de Tabla agrupada presenta una tabla con columnas segn lo definido en el Diseador de
Formas y filas pobladas de acuerdo a la informacin de cada caso.
La principal diferencia de este control con el control Tabla es que los registros pueden ser agrupados
de acuerdo a los valores de una o ms columnas especficas.

Copyright 2014 - Bizagi

652

Para crear una Tabla agrupada en una forma, incluya un control de Tabla agrupada, desde la pestaa
de Controles, y luego asocie una coleccin.

Copyright 2014 - Bizagi

653

De manera alternativa usted puede incluir un atributo de Coleccin en el rea visual. Esto ser
interpretado por Bizagi como un control Tabla. Haga clic derecho sobre esta tabla, seleccione la
opcin Convertir a y luego haga clic en la opcin Tabla agrupada.

Copyright 2014 - Bizagi

654

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.
Las validaciones de la tabla son independientes de la opcin de Acciones y Validaciones de las
formas.
Tenga en cuenta las siguientes diferencias entre los controles Tabla y Tabla agrupada, para evaluar
la conveniencia de usar uno u otro:
TABLA

TABLA AGRUPADA

No permite agrupar registros de una coleccin Permite agrupar registros de una coleccin de
de acuerdo a los valores de una o ms acuerdo a los valores de una o ms columnas.
columnas.
Permite adicin en lnea.

No permite adicin en lnea.

Permite edicin en lnea.

No permite edicin en lnea.

Permite paginacin.

No permite paginacin.

Se pueden ejecutar Acciones de forma sobre No se pueden ejecutar Acciones de forma sobre
columnas.
columnas.

Agregar registros
Los registros se pueden aadir a travs de una Forma de Adicin independiente.
La adicin en lnea no est disponible en este control.

Editar registros
Los registros se pueden editar a travs de una Forma de Edicin independiente.
La edicin en lnea no est disponible en este control.

Opciones de Detalle
Usted puede crear una Forma de Detalle para mostrar informacin de solo lectura en una forma
separada.

Copyright 2014 - Bizagi

655

Atributos Relacionados
Las tablas agrupadas estn relacionadas a Colecciones que requieren una relacin uno a muchos.

Propiedades
Las siguientes son propiedades exclusivas para el control Tabla agrupada:

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.

Activar exportar a Muestra u oculta un icono, en la parte baja de la tabla, que permite exportar
Excel
a Excel la informacin contenida en ella. En Excel, los registros de la tablas se
ordenarn de acuerdo a los grupos definidos, pero los grupos no se
mostrarn explcitamente.
Activar exportar a Muestra u oculta un icono, en la parte baja de la tabla, que permite exportar
PDF
a PDF la informacin contenida en ella. En el archivo PDF, los registros de la
tablas se ordenarn de acuerdo a los grupos definidos, pero los grupos no
se mostrarn explcitamente.

Pestaa de Formato
PROPIEDAD

DESCRIPCIN

Orientacin

Define si el texto debera ser escrito de izquierda a derecha o viceversa. 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.

Formato de
encabezado

Personaliza la apariencia de los encabezados de las tablas. Se puede cambiar


el color de fondo y el tamao y color de fuente.

Pestaa Avanzado

Copyright 2014 - Bizagi

656

PROPIEDAD
Ordenar
atributo

DESCRIPCIN
por Ordena las filas de la tabla de acuerdo al valor de los atributos seleccionados
de la entidad.
Cuando se selecciona un atributo se habilita la opcin de ordenar ascendente
o descendentemente.
Haciendo clic en el cono Valor predeterminado, se reiniciar esta propiedad
a no ordenado

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.

Validaciones
tabla

de Le permite crear reglas de validacin para este control, que sern verificadas
en tiempo de ejecucin.

Opciones
Borrado

de 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.

Opciones
Adicin

de Habilita la adicin de registros a la tabla. Se debe definir una Forma de


adicin para capturar los nuevos datos.
Se pueden ejecutar Validaciones al adicionar registros. Estas se ejecutan
cuando el usuario da clic en el botn Guardar de la Forma de adicin.

Opciones de Fila

El grupo se divide en dos secciones: Editar y Detalles.


Editar
Permitir la edicin de filas implica que la informacin relacionada a un
registro puede ser modificada.
Por defecto, las ediciones no se permiten. Usted puede editar registros en
una forma independiente denominada Forma de edicin.
Se pueden ejecutar Validaciones al modificar registros. Estas se ejecutan
cuando el usuario da clic en el botn Guardar de la Forma de edicin.
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.

Copyright 2014 - Bizagi

657

Columnas de Tabla agrupada


Para definir las columnas de una Tabla agrupada haga clic en el control y luego en el botn Editar
columnas.

Se mostrar una nueva ventana con los atributos de coleccin disponibles, en el Panel izquierdo.
Usted puede incluir attributos como columnas, arrstrandolos a la tabla o haciendo doble clic sobre
ellos.

Las columnas mantienen las mismas propiedades relacionadas al tipo de control (datos) que muestran.
Adicionalmente se muestran las siguientes propiedades que son exclusivas de las columnas.

Pestaa Bsico

Copyright 2014 - Bizagi

658

PROPIEDAD

DESCRIPCIN

Visible

Define si toda la columna es visible o no.

Editable

Define si toda la columna es de solo lectura o no.

Requerido

Define si toda la columna es requerida o no.

Celda editable

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

Celda visible

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

Pestaa Formato
PROPIEDAD

DESCRIPCIN

Alineacin
horizontal de ttulo

Permite alinear el ttulo de la columna. Las opciones disponibles son: derecha,


izquierda, justificada y centrada.

Alineacin
horizontal de
columna

Permite alinear el texto dentro de las columnas. Las opciones disponibles son:
derecha, izquierda, justificada y centrada.
Para ms informacin consulte Formato de columnas.

Ancho de columnas

Permite definir el ancho deseado de las columnas de acuerdo a sus


necesidades. Se puede definir en trminos de porcentaje del ancho total de
la tala o en trminos de pixeles fijos.

Pestaa Avanzado

Copyright 2014 - Bizagi

659

PROPIEDAD

DESCRIPCIN

Aplicar filtro a cada


registro

Permite aplicar filtros individualmente a cada fila de la Tabla, con el fin de


mostrar informacin especfica.

Grupo

En la seccin grupo se encuentran tres propiedades:


Agrupar por: Define si los registros de la tabla se agruparn de acuerdo a
los valores de la columna.
Mostrar columnas: Muestra u oculta la columna utilizada para agrupar los
registros de la tabla.
Tipo de visualizacin: Habilita los distintos formatos visuales respecto al
texto (etiqueta) y el control (valor). Esto incluye ocultar la etiqueta o el
valor.

Totalizador

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

Ejemplo
La siguiente tabla muestra una lista de productos que deben ser comprados en una compaa.

Se desea agrupar los productos de acuerdo a su tipo. Para hacerlo incluiremos una Tabla agrupada.
1. Vaya al Diseador de Formas. Incluya un control de Tabla agrupada desde el Panel izquierdo.

Copyright 2014 - Bizagi

660

2. Haga clic en la tabla y asocie, en la propiedad Fuente de datos, la coleccin que contiene los
registros a mostrar.

3. Haga clic en el botn Editar columnas. En la nueva ventana arrstre los atributos a la tabla o haga
doble clic sobre ellos para incluirlos como columnas.

Copyright 2014 - Bizagi

661

4. En este caso, la tabla se agrupar de acuerdo a los valores del atributo Tipo de producto. Para
configurar esto, haga clic en la columna Tipo de producto, vaya a la pestaa de propiedades
Avanzadas y habilite la opcin Agrupar por.

Guarde y cierre la Forma.


5. Vaya al Portal de trabajo para probar el control. Observe como ahora los registros se encuentran
agrupados.

Copyright 2014 - Bizagi

662

Oculto

Uso
Permite que un atributo sea incluido en una forma pero sin ser mostrado al usuario final. Es til para
crear Acciones y Validaciones que incluyen referencias a controles que no deberan ser visibles en la
forma.

Consideraciones
Las acciones y validaciones se pueden configurar utilizando atributos incluidos en la forma donde son
ejecutadas. Si usted necesita realizar una validacin sobre un atributo que no debera estar en una
forma, usted debera utilizar el control Oculto.

Atributos Relacionados
Este control puede ser relacionado a cualquier tipo de atributo.

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.

Copyright 2014 - Bizagi

663

Las imgenes deben ser Editables 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

DESCRIPCIN

Tamao de imagen

Define las dimensiones en las cuales se mostrar la imagen.


Usted puede elegir entre los tamaos predefinidos: 128x128, 64x64 y 32x32
mpx. o usar la opcin Ajustar al tamao.
Ajustar al tamao despliega las imgenes ajustndose a su contenedor:
layout, contenedor o columna especfica. Si la imagen es ms pequea que su
contenedor, ser mostrada en tamao real. Si la imagen es ms grande que
su contenedor, se ajustar. Vea ajustar tamao a contenido

Pestaa Avanzado
PROPIEDAD

DESCRIPCIN

Extensiones Vlidas

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) que puede tener un archivo antes de que
se considere inadecuado para ser cargado.
Considere la siguiente tabla con el fin de convertir a bytes las unidades ms
comunes de medicin para el almacenamiento de datos
MEDIDA

BYTES

1 KB
(Kilobyte)

1.024

1 MB
(Megabyte)

1.048.576

1 GB
(Gigabyte)

1.073.741.824

Copyright 2014 - Bizagi

664

Al dar clic en el icono Valor Predeterminado 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
Foto del Empleado en la entidad del Proceso.

2. En la forma incluya el atributo Foto del Empleado. Este ser interpretado automticamente por Bizagi
como un control Imagen.
Guarde la Forma.

Copyright 2014 - Bizagi

665

3. Vaya al Portal de Trabajo para probar el control.


D clic sobre el control y adjunte una imagen.

Observe cmo se muestra.

Copyright 2014 - Bizagi

666

Usar la opcin Ajustar tamao a contenido


En el mismo proceso del ejemplo previo, la asistente de recursos humanos asigna el puesto de trabajo
al nuevo empleado, basada en la distribucin de las oficinas. Para ayudar a la correcta localizacin del
nuevo empleado, se debera mostrar en la forma el plano de las oficinas.
Debido a que el plano es una imagen grande y debe ser fcilmente consultado, los tamaos
predefinidos disponibles para las imgenes no son apropiados para este caso. Por lo tanto, la imagen
se ajustar al tamao de un contenedor de tipo grupo para su correcta visualizacin.
Para ajustar el tamao de una imagen a un contenedor de la forma:
1. Inserte el control de tipo imagen y d clic sobre ella para acceder a sus propiedades.

Copyright 2014 - Bizagi

667

2. En el men de propiedades, vaya a la pestaa de Formato.

3. En la propiedad de tamao de la imagen seleccione Ajustar a contenido.

Copyright 2014 - Bizagi

668

4. As mismo, en la propiedad Tipo de visualizacin seleccione Valor. Esto esconder la etiqueta de la


imagen.

Observe como se muestra la imagen en el Portal de Trabajo.

Copyright 2014 - Bizagi

669

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 Controles.

Copyright 2014 - Bizagi

670

2. En la pestaa Bsico de las propiedades del control, identifique la propiedad Etiqueta.

3. Ingrese el texto deseado en la propiedad. Guarde la forma.

Copyright 2014 - Bizagi

671

4. Vaya al Portal de Trabajo para probar el control.

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.

Copyright 2014 - Bizagi

672

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 (incluyendo el prefijo http://).

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.

Al dar clic en el icono Valor Predeterminado 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 Controles.

Copyright 2014 - Bizagi

673

2. Vaya a la pestaa Bsico en las propiedades del control y seleccione URL en las propiedades de
Ejecucin.

3. Ingrese la ruta fija.

Copyright 2014 - Bizagi

674

4. Asigne un nombre de mostrar al vnculo. Guarde la forma.

5. Vaya al Portal de Trabajo para probar el control.

Copyright 2014 - Bizagi

675

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

DESCRIPCIN

Atributo de Mostrar

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.

Ejemplo de Atributo de Mostrar y Atributo Adicional

Copyright 2014 - Bizagi

676

Pestaa Avanzado

PROPIEDAD

DESCRIPCIN

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. En las listas usted puede asignar un valor por defecto utilizando una
expresin.

Actualizar al Cambio

Esta propiedad est deprecada, recomendamos usar Acciones y


Validaciones.
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.

Al dar clic en el icono Valor Predeterminado se reiniciarn las propiedades.

Ejemplo Ordenar por

Copyright 2014 - Bizagi

677

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).

Copyright 2014 - Bizagi

678

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 2014 - Bizagi

679

4. En la pestaa Bsico de las propiedades del control, identifique la propiedad Fuente de Datos.

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 Centro de Costo.

Copyright 2014 - Bizagi

680

6. Seleccione el atributo de mostrar. En este aso ser el Centro de Costo.

7. Asigne un nombre de mostrar a la lista.

Copyright 2014 - Bizagi

681

5. Si usted necesita mas controles, agrguelos a la forma luego y gurdelos.


Vaya al Portal de Trabajo y pruebe el control.

Moneda

Uso
Muestra montos monetarios en la forma.

Copyright 2014 - Bizagi

682

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

DESCRIPCIN

Permitir Decimales

Define si el control mostrar dgitos decimales o no.

Posiciones
Decimales

De permitirse decimales, esta propiedad define cuantos decimales se


mostrarn en el control.

Pestaa Avanzado
PROPIEDAD

DESCRIPCIN

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.

Copyright 2014 - Bizagi

683

Al dar clic en el icono Valor Predeterminado se reiniciarn las propiedades.

Ejemplo
Una compaa de Transportes y Logstica ha definido un Proceso denominado Proceso de Entrega,
para administrar y monitorear 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 paquete, por lo que
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.
1. Usted necesita una atributo tipo Moneda en su modelo de datos. Crearemos uno en la Entidad de
Proceso y lo llamaremos Costo Estimado.

2. En la forma incluya el atributo Costo. Este se interpretar automticamente en la forma como un


control tipo Moneda.
Guarde la forma.

Copyright 2014 - Bizagi

684

3. Vaya al Portal de Trabajo para probar el control.

Copyright 2014 - Bizagi

685

Nmero

Uso
Muestra datos numricos en la forma.

Atributos Relacionados
Este control tambin se relaciona a atributos de tipo numrico. 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, el
control se mostrar sin smbolo monetario. (como lo hace el control Moneda)

Propiedades
Las siguientes son propiedades exclusivas del control Nmero:

Pestaa de Formato
PROPIEDAD

DESCRIPCIN

Permitir Decimales

Define si el control mostrar dgitos decimales o no. Se recomienda utilizar


atributos tipo Real o Flotantes.

Posiciones
Decimales

De permitirse decimales, esta propiedad define cuantos decimales se


mostrarn en el control.

Pestaa Avanzado

Copyright 2014 - Bizagi

686

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 Siguiente, 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

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 insrtelo en la forma.

Copyright 2014 - Bizagi

687

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.

Consideraciones
Asigne siempre un Atributo de Mostrar al control Radio.

Atributos Relacionados
Los Radios se relacionan a entidades paramtricas, como atributos relacionados.

Propiedades
Las siguientes son propiedades exclusivas del control Radio:

Pestaa Bsico

Copyright 2014 - Bizagi

688

PROPIEDAD

DESCRIPCIN

Atributo de Mostrar

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

Pestaa Avanzado

Copyright 2014 - Bizagi

689

PROPIEDAD

DESCRIPCIN

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. En los combos usted puede asignar un valor por defecto utilizando
una expresin.

Actualizar al Cambio

Esta propiedad est deprecada, recomendamos usar Acciones y


Validaciones.
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
Atributo
Filtro

por Muestra una lista de todos los atributos de la Entidad Paramtrica. El atributo
escogido ordenar ascendentemente las opciones mostradas.
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.

Al dar clic en el icono Valor Predeterminado se reiniciarn las propiedades.

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.

Cada entidad Respuesta contiene los siguientes atributos: Opciones, Respuesta correcta? y Respuesta.

Copyright 2014 - Bizagi

690

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.

2. En la pestaa Bsico de las propiedades del control, identifique la propiedad Fuente de Datos.

Copyright 2014 - Bizagi

691

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 Respuesta1.

4. Seleccione el atributo de mostrar. En este caso ser Opciones.

Copyright 2014 - Bizagi

692

5. Seleccione el atributo adicional para el radio. En esta caso ser Respuestas.

6. Asigne un nombre de mostrar al control.

Copyright 2014 - Bizagi

693

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 Respuesta2 y Respuesta3
respectivamente.

8. Vaya al Portal de Trabajo para probar los controles.

Copyright 2014 - Bizagi

694

Vista por registro

Uso
El control de Vista por registro presenta una manera alternativa de mostrar los registros contenidos en
una coleccin.
A diferencia del control Tabla, los registros de la coleccin se muestran de manera individual, en una
forma embebida que contiene informacin ms detallada y organizada de un registro particular. El
control de Vista por registro posee un men en la parte baja, que permite navegar, agregar, editar o
eliminar registros.

Copyright 2014 - Bizagi

695

Consideraciones
Por defecto la Vista por registro permite agregar nuevos registros editar y eliminar existentes.
Si la propiedad Editable es deshabilitada, los usuarios finales NO podrn agregar, aadir o
eliminar registros.
Las validaciones de la Vista de registros son independientes de la opcin Acciones y Validaciones de
las formas.

Agregar registros
Los registros se pueden aadir En lnea, la cual es una manera rpida de crear y llenar un nuevo
registro.
Los registros se pueden aadir con una Forma de Adicin 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 lnea o con Forma de Adicin son excluyentes.

Editar registros
Los registros se pueden editar En lnea, la cual es una manera rpida de editar registros existentes.
Los registros se pueden editar con una Forma de Edicin independiente. Esta lleva al usuario a una
nueva ventana, para llenar una gran cantidad de informacin o informacin compleja que debe ser
validada.
La edicin en lnea est habilitada por defecto.

Opciones de Detalle
Usted puede crear una Forma de Detalle para mostrar informacin de solo lectura en una forma
separada.

Copyright 2014 - Bizagi

696

Atributos Relacionados
La Vista por registro est relacionada a Colecciones que requieren una relacin uno a muchos.

Propiedades
Las siguientes son propiedades exclusivas para el control de Vista por registro:

Pestaa Bsico
PROPIEDAD

DESCRIPCIN

Forma de
navegacin

Permite configurar la forma que se utilizar para mostrar la informacin de


los registros, de manera individual, de la coleccin asociada.

Expresin de
validacin

Permite definir reglas de validacin para nuevos registros con el fin de


verificar si cumplen con condiciones de negocio determinadas, antes de ser
guardados. Estas validaciones se ejecutan al momento de dar clic en Guardar
en el men de la forma de navegacin.

Pestaa Avanzado

Copyright 2014 - Bizagi

697

PROPIEDAD

DESCRIPCIN

Ordenar

Ordena los registros de acuerdo al valor de los atributos seleccionados de la


entidad de coleccin, de forma ascendente.
Cuando se selecciona un atributo se habilita la opcin de ordenar ascendente
o descendentemente.
Al dar clic en el icono Valor Predeterminado se reiniciarn las propiedades.

Filtro

Permite definir un subconjunto de valores, de la lista de todos los registros de


la coleccin, a ser mostrados. Una expresin booleana define una condicin
que Bizagi evala para decidir cuales registros cumplen con las condiciones y
de acuerdo a esto mostrarlos u ocultarlos.

Validaciones de
tabla

Permite crear reglas de validacin para este control, que sern verificadas en
tiempo de ejecucin.

Opciones de
Borrado

La eliminacin de registros se administra en las opciones de borrado. Por


defecto, se permite eliminacin de registros.

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 Forma de Adicin 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
Guardar en la ventana emergente.

Opciones de Fila

El grupo se divide en dos secciones, denominadas Editar y Detalles.


Permitir la edicin de filas implica que usted no puede modificar la
informacin relacionada a un registro.
Editar
Usted puede editar registros En lnea o con una ventana emergente (Forma
de Edicin).
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
Guardar 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
Una compaa utiliza Bizagi para seleccionar anualmente al presidente del sindicato de trabajadores.
En este proceso cada empleado de la compaa debe realizar una actividad donde deber votar por

Copyright 2014 - Bizagi

698

uno de los candidatos. La informacin y propuestas del candidato se muestran en esta actividad para
ayudar a los empleados a hacer una adecuada eleccin.
Con el fin de mostrar la informacin de los candidatos y permitir al empleado votar fcilmente por su
preferido, se utiliza un control de Vista por registro.
1. Incluya un control de Vista por registro a la forma. Arrstrelo desde la pestaa de controles.

2. Haga clic en el control. En la pestaa Bsico, de las propiedades del control, ubique la propiedad
Fuente de datos y seleccione el Xpath de la coleccin que contiene los datos a mostrar.

Copyright 2014 - Bizagi

699

3. Haga clic en la propiedad Forma de navegacin y seleccione Nueva Forma.

4. Incluya la informacin a mostrar en la Forma. Defina los controles como editables y requeridos
segn lo necesite.

Copyright 2014 - Bizagi

700

5. Asigne un nombre a la Forma, gurdela y cirrela. En la Forma principal, haga clic en el control Vista
por registro, vaya a la pestaa Avanzado de las propiedades del control y configure las siguientes
opciones:
Permitir borrar: No
Permitir adicin: No
Permitir edicin: Si
Edicin en lnea: Si
Permitir detalles: No

Copyright 2014 - Bizagi

701

Guarde y cierre la Forma.


As es como el control muestra los registros en el Portal de trabajo.

Copyright 2014 - Bizagi

702

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.
Los resultados se pueden ordenar definiendo el criterio en la Forma de bsqueda.

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 Control de Bsqueda dentro de las opciones de Convertir a.

Copyright 2014 - Bizagi

703

Propiedades
Las siguientes son propiedades exclusivas del control de Bsqueda:

Pestaa Bsico
PROPIEDAD

DESCRIPCIN

Forma de Bsqueda

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.
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.


Por ejemplo, la entidad Ciudad tiene tres atributos llamados Nombre de la
ciudad, Cdigo de rea e iniciales. Para que los usuarios puedan reconocer
fcilmente la ciudad, el atributo a mostrar puede ser Nombre de la ciudad.

Pestaa Avanzado

Copyright 2014 - Bizagi

704

PROPIEDAD

DESCRIPCIN

Actualizar al Cambio

Esta propiedad est deprecada, recomendamos usar Acciones y


Validaciones.
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.

Permitir Limpiar

Habilita a los usuarios finales la opcin de limpiar la informacin cargada en


una bsqueda previa.

Permitir Digitar

Habilita a los usuarios finales la opcin de ingresar datos, cuando hay certeza
de que un registro existe, sin tener que buscarlo.

Mximo
Registros
Filtro

de 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
registros

crear Habilita la posibilidad de agregar nuevos registros a la entidad donde se


realiza la bsqueda.

Forma
creacin

para 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. (La
propiedad Permitir nuevos registros est habilitada)

Ejemplo Permitir Limpiar


Observe que la informacin de los controles Direccin y Telfono del Cliente es borrada.

Copyright 2014 - Bizagi

705

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 entre Solicitud de Compra (Entidad de Proceso) y Cliente (Entidad Maestra).

Copyright 2014 - Bizagi

706

2. En el Diseador de Formas identifique e atributo creado (Cliente). Insrtelo 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.

Copyright 2014 - Bizagi

707

4. Habilite la opcin de Nuevos Registros y seleccione una Forma de Adicin de Registros (Agregar
Cliente).

Copyright 2014 - Bizagi

708

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.

Copyright 2014 - Bizagi

709

6. En el Portal de Trabajo, el control de Cliente ser un control de bsqueda, donde los usuarios finales
pueden buscar 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 2014 - Bizagi

710

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..
Los controles disponibles para incluir dentro de la Forma de bsqueda son:
Combo, Fecha, Etiqueta, Moneda, Nmero, Cuadro de texto y Si/No.
Los dems controles no estn soportados.
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 reutilizable, 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.
Ninguno: Cuando no se seleccione ninguna forma. De todas maneras, se debe seleccionar una
forma para el control.
Una Forma existente: Si la Forma ha sido creada previamente, seleccinela de la lista.

Copyright 2014 - Bizagi

711

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. Inclyalos en cada seccin.

Copyright 2014 - Bizagi

712

Los resultados de la bsqueda pueden ordenarse por alguna de sus columnas de manera ascendente
o descendente. Defina la columna por la cual ordenar y el orden deseado en la pestaa Avanzado de
las propiedades de la forma.
Restriccin JEE: El ordenamiento por atributos de tipo texto Archivo no est soportado.
Restriccin JEE: El ordenamiento por atributos de tipo texto extendido no est soportado.

Copyright 2014 - Bizagi

713

Asigne a esta nueva forma un nombre de mostrar dando clic en la opcin Propiedades, que se
encuentra en el Ribbon. Guarde la forma y luego cirrela para regresar a la forma principal.
Cuando el usuario final haga clic en el cono de bsqueda en el Portal de Trabajo, se mostrar la
forma.
Ingrese la informacin y seleccione el registro deseado de los resultados de la bsqueda.

Copyright 2014 - Bizagi

714

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 Forma de creacin. 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 reutilizable, 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 Propiedades que
se encuentra en el Ribbon.
Ninguno: Cuando no se seleccione ninguna forma. De todas maneras, se debe seleccionar una
forma para el control.
Una Forma existente: Si la Forma ha sido creada previamente, seleccinela de la lista.

Copyright 2014 - Bizagi

715

Inserte todos los atributos requeridos para el nuevo registro. Asigne a esta nueva forma un nombre de
mostrar, dando clic sobre la opcin Propiedades que se encuentra en el Ribbon. Guarde la forma y
luego cirrela para regresar a la forma principal.

Copyright 2014 - Bizagi

716

Cuando se permiten nuevos registros, el usuario encontrar un botn de Agregar 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 2014 - Bizagi

717

La propiedad Habilitar "enviar como adjunto" del control Archivo no est soportada dentro de la
forma de adicin de registros.

Sugerencia

Uso
Con este control, Bizagi predice la palabra que el usuario final desea ingresar, sin necesidad de que la
ingrese completamente.

Consideraciones
El usuario debe conocer la secuencia de letras de la palabra (atributo Contenido). Si se define una
bsqueda completa, la secuencia puede estar constituida por cualquier parte de la palabra, de lo
contrario, debe incluir las primeras letras de la palabra. Por ejemplo, suponga que el control de
Sugerencia est relacionado al atributo Nombre de la Ciudad de la entidad Ciudad. El usuario debe
ingresar la letra "p" seguida de la "h" para que el sistema prediga el registro "Phoenix".
Si usted necesita mostrar informacin acerca del registro encontrado, el control debe ser refrescado
por Acciones y Validaciones.

Copyright 2014 - Bizagi

718

Atributos Relacionados
Los controles de Sugerencia estn relacionados a atributos con relacin a entidades Maestras,
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 Convertir a y luego d clic sobre la opcin Sugerencia.

Propiedades
Las siguientes son propiedades exclusivas para el control Sugerencia:

Pestaa Bsico
PROPIEDAD

DESCRIPCIN

Atributo de Mostrar

Define el atributo de la entidad donde el control buscar un resultado.

Atributo adicional

Define un atributo adicional para mostrar en el control, siguiendo el principal


con una coma. La bsqueda se realizar sobre ambos atributos: el principal y
el adicional.
Restriccin JEE: El atributo adicional debe tener valores para poder mostrarse
entre los resultados. Si el atributo adicional NO tiene valor (null) el resultado no
ser mostrado, incluso si el atributo principal S tiene valor.
Restriccin JEE: Atributos de tipo texto extendido no estn soportados.

Pestaa Avanzado

Copyright 2014 - Bizagi

719

PROPIEDAD

DESCRIPCIN

Actualizar al Cambio

Esta propiedad est deprecada, recomendamos usar Acciones y


Validaciones..
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.

Permitir Bsqueda
Completa

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, Bizagi
encontrar un registro debido a que ese texto se encuentra dentro del
nombre. Si la propiedad es deshabilitada, Bizagi NO encontrar registros.
Por defecto, esta propiedad est deshabilitada y la prediccin est basada en
la primera letra de la palabra objetivo. Recomendamos habilitar esta
propiedad para realizar bsquedas ms exactas.

Permitir Limpiar

Habilita a los usuarios finales la opcin de limpiar la informacin cargada en


una bsqueda previa.

Mximo de
Registros

Define el nmero mximo de resultados para mostrar en la seccin de


resultados.

Mnimo de
caracteres

Define el nmero mnimo de caracteres que deben ser digitados para


empezar a buscar registros.

Ordenar por

Permite ordenar los resultados de la bsqueda por algn atributo de la


entidad relacionada. Los resultados se ordenan de manera ascendente. Por
ejemplo, una bsqueda de Clientes puede ser ordenada por el apellido. Si no
se selecciona un mtodo de ordenamiento, Bizagi ordenar por el
identificador de los registros.

Filtro

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.

Ejemplo de Permitir Limpiar


Observe que la informacin de los controles Direccin y Telfono del Cliente es borrada.

Copyright 2014 - Bizagi

720

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 entre Solicitud de Compra (Entidad de Proceso) y Cliente (Entidad Maestra).

Copyright 2014 - Bizagi

721

2. En el Diseador de Formas identifique e atributo creado (Cliente). Insrtelo 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 Convertir a. Luego seleccione la opcin Sugerencia.

Copyright 2014 - Bizagi

722

4. En las propiedades Bsicas del control Sugerencia, seleccione el atributo de visualizacin deseado.
En esta caso ser el nombre del Cliente.

Copyright 2014 - Bizagi

723

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.

Copyright 2014 - Bizagi

724

6. Agrupe los atributos Nmero telefnico y gnero utilizando un contenedor de Panel.

7. Cree una accin para actualizar los datos del cliente, cuando este sea seleccionado. Utilice el
comando Refrescar para hacerlo.

Copyright 2014 - Bizagi

725

8. En las propiedades Avanzadas del control habilite las propiedades Permitir bsqueda completa y
Permitir borrar.

Copyright 2014 - Bizagi

726

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.

Observe que gracias a la Accin de Refrescar, los atributos gnero y telfono se actualizan tan pronto
como el usuario selecciona un registro.

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 Datos hasta el rea de Trabajo para crear una tabla. D
clic en Editar Columnas 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.

Copyright 2014 - Bizagi

727

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.
Las validaciones de la tabla son independientes de la opcin de Acciones y Validaciones de las
formas.

Agregar registros
Los registros se pueden aadir En lnea, la cual es una manera rpida de crear y llenar un nuevo
registro.
Los registros se pueden aadir con una Forma de Adicin independiente. Esta lleva al usuario a una
nueva ventana, para llenar una gran cantidad de informacin o informacin compleja que debe ser
validada.
La adicin En lnea est por defecto.

Editar registros
Los registros se pueden editar En lnea, la cual es una manera rpida de editar registros existentes.
Los registros se pueden editar con una Forma de Edicin independiente. Esta lleva al usuario a una
nueva ventana, para llenar una gran cantidad de informacin o informacin compleja que debe ser
validada.
La edicin En lnea est por defecto.

Opciones de Detalle
Usted puede crear una Forma de 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

DESCRIPCIN

Editable

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.

Activar exportar a
Excel

Muestra o oculta un cono que permite exportar la informacin contenida en


la tabla a Excel

Activar exportar a
PDF

Muestra o oculta un cono que permite exportar la informacin contenida en


la tabla a PDF

Copyright 2014 - Bizagi

728

Pestaa de Formato
PROPIEDAD

DESCRIPCIN

Filas por pgina

Configura el nmero de filas visualizadas por pgina. Por defecto Bizagi


mostrar 20 filas por pgina.
Cuando la tabla est paginada navegar por las pginas es muy sencillo.
Simplemente pase el mouse sobre los nmeros de pgina. Estas empezarn a
moverse para que usted seleccione la deseada.

Orientacin

Define si el texto debera ser escrito de izquierda a derecha o viceversa. 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.

Formato de
cabecera

Personaliza la apariencia de los encabezados de las tablas. Se puede cambiar


el color de fondo y el tamao y color de fuente.

Ejemplo Filas por pgina


La siguiente tabla tiene cuatro registros o filas. Cuando la Propiedad Filas por pgina se cambia a 3,
Bizagi pagina la tabla, cada pgina muestra unicamente un mximo de tres registros. Esta tabla va a
mostrar tres registros en la pgina uno y a continuacin, un registro en la pgina dos.

Copyright 2014 - Bizagi

729

Ejemplo Formato de cabecera


La siguiente imagen muestra una tabla con y sin personalizacin del formato del encabezado.

Pestaa Avanzado

Copyright 2014 - Bizagi

730

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.
Cuando se selecciona un atributo se habilita la opcin de ordenar ascendente
o descendentemente.
Al dar clic en el icono Valor Predeterminado se reiniciarn las propiedades.

Filtro

Permite definir un subconjunto de valores de la lista de todos los registros de


la tabla. Bizagi solo mostrar los valores que cumplen con la condicin de
filtro definida en una expresin booleana.

Validaciones de
tabla

Le permite crear reglas de validacin para este control, que sern verificadas
en tiempo de ejecucin.

Opciones de
Borrado

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.
Las Validaciones pueden ser ejecutadas cuando se eliminan registros. Estas se
ejecutan cuando el usuario da clic en el botn Borrar.

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 Forma de Adicin 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
Guardar en la ventana emergente.

Opciones de Fila

El grupo se divide en dos secciones, denominadas Editar 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 (Forma de Edicin).
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
Guardar 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.
Copyright 2014 - Bizagi

731

Ejemplo Ordenar por

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 Editar Columnas.

Copyright 2014 - Bizagi

732

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 OK.

Copyright 2014 - Bizagi

733

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

DESCRIPCIN

Visible

Define si toda la columna es visible o no.

Editable

Define si toda la columna es de solo lectura o no.

Requerido

Define si toda la columna es requerida o no.

Celda editable

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

Celda visible

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

Pestaa Formato

Copyright 2014 - Bizagi

734

PROPIEDAD

DESCRIPCIN

Alineacin del titulo


horizontal

Permite alinear el titulo de las columnas. Las opciones disponibles son:


derecha, izquierda, justificada y centrada.

Alineacin de
columna horizontal

Permite alinear el texto dentro de las columnas. Las opciones disponibles son:
derecha, izquierda, justificada y centrada.

Ancho de columna

Permite definir el ancho deseado de la columna de acuerdo a sus


necesidades. Puede se establecido en trminos de porcentaje del total del
ancho de la tabla o en trminos de pixeles fijos.

Pestaa Avanzado
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

Totalizadores
Los Totalizadores son funciones de agregacin que pueden ser aplicadas a columnas de una tabla con
el fin de obtener un valor nico, el cual, se muestra al final de la columna.
Estos solo se usan como una opcin de visualizacin (almacenar el totalizador no es posible
actualmente). Para almacenar el valor total de una columna, consulte almacenar el valor total de una
columna usando expresiones.
Las funciones agregadas disponibles son:
Cuenta: Devuelve el nmero total de registros en 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.

En general, los Totalizadores aplican solo para columnas de tipo numrico (entero,
real, moneda, etc). nicamente el totalizador Cuenta puede ser utilizado sobre
cualquier tipo de columna.
Los Totalizadores estn disponibles en las propiedades Avanzadas de las columnas.

Copyright 2014 - Bizagi

735

Para totalizar una columna de una tabla, seleccione la tabla que contiene la columna a totalizar y d clic
en el botn Editar Columnas.
En la ventana de Edicin de Columnas, seleccione la columna a totalizar y vaya a la Pestaa Avanzada
de las propiedades de la columna. Seleccione la funcin de agregacin deseada, bajo la opcin
Totalizador.

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 Productos solicitados. Configuraremos entonces un
Totalizador para la columna Precio de la grilla mencionada anteriormente.
1. Vaya a la forma de la actividad y seleccione la tabla Productos Solicitados, luego d clic en el botn
Editar Columnas.

Copyright 2014 - Bizagi

736

2. En la nueva ventana, seleccione la columna Precio Total y vaya a las Propiedades Avanzadas.

3. En la lista desplegable de Operador seleccione la funcin Suma.

Copyright 2014 - Bizagi

737

4. Opcionalmente puede dar formato al valor totalizado. Cambie su tamao de fuente, color y fondo
segn lo desee.

Copyright 2014 - Bizagi

738

5. Ahora vaya al Portal de Trabajo para probar el Totalizador. Observe como se muestra.

Agregar Registros
Agregar registros a una tabla requiere que:
Habilitar ( ) la propiedad Editable en la pestaa Bsico.
Habilitar la propiedad Permitir Adicin en la pestaa Avanzado.
Escoger la propiedad Adicin en lnea de acuerdo a si la adicin se har en lnea (S) o usando una
forma independiente (No). Si est deshabilitada, se debe seleccionar una forma de Adicin.
Los dos mtodos de agregar registros, es decir, Adicin en lnea y Forma de adicin son

Copyright 2014 - Bizagi

739

mutuamente excluyentes. Si selecciona adicin en lnea no podr agregar registros usando una
forma independiente y viceversa. Las propiedades disponibles en el grupo de opciones de adicin
difieren de acuerdo con el mtodo seleccionado.

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
Cuando la propiedad En lnea esta habilitada, la tabla mostrar un icono de Adicin (+) en el Portal de
Trabajo.

Copyright 2014 - Bizagi

740

D clic en el icono de Adicin. Se crear un nuevo registro con todas las columnas vacas.

Ingrese la informacin de las columnas. Para guardar esta informacin d clic en el icono de Guardar.
Para descartar los cambios, d clic en Cancelar.
Si usted no da clic en Guardar y abandona la pgina, perder sus cambios.

Adicin con Forma


Si la propiedad Adicin en lnea no est habilitada (No) indica que la adicin se realizar en una
ventana emergente independiente. Esto es muy til cuando la informacin a ingresar en el nuevo
registro es compleja, larga o requiere validaciones.

Copyright 2014 - Bizagi

741

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 reutilizable, 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 Propiedades que
se encuentra en el Ribbon.
Ninguno: Cuando no se seleccione ninguna forma. De todas maneras, se debe seleccionar una
forma para agregar registros.
Una Forma existente: Si la Forma ha sido creada previamente, seleccinela de la lista.

Copyright 2014 - Bizagi

742

Una vez definida la Forma de Adicin, gurdela y cirrela; luego, 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 Guardar para mantener los cambios.

Copyright 2014 - Bizagi

743

Editar Registros
Editar registros de una tabla requiere que:
Habilitar ( ) la propiedad Editable en la pestaa Bsico. Esta propiedad es obligatoria si la edicin
se hace en lnea.
Habilitar la propiedad Permitir Edicin en la pestaa Avanzado.
Escoger la propiedad Edicin en lnea de acuerdo a si la adicin se har en lnea (S) o usando una
forma independiente (No). Si est deshabilitada, se debe seleccionar una forma de Edicin.
Los dos mtodos de agregar registros, es decir, Edicin en lnea y Forma de edicin son
mutuamente excluyentes. Si selecciona edicin en lnea no podr agregar modificar usando una
forma independiente y viceversa. Las propiedades disponibles en el grupo de opciones de edicin
difieren de acuerdo con el mtodo seleccionado.

Copyright 2014 - Bizagi

744

Copyright 2014 - Bizagi

745

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 lnea 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


Si la propiedad Edicin en lnea no est habilitada (No) indica que la adicin se realizar en una

Copyright 2014 - Bizagi

746

ventana emergente independiente. Esto es muy til cuando la informacin a ingresar 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 reutilizable, 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 Propiedades que
se encuentra en el Ribbon.
Ninguno: Cuando no se seleccione ninguna forma. De todas maneras, se debe seleccionar una
forma para agregar registros.
Una Forma existente: Si la Forma ha sido creada previamente, seleccinela de la lista.

Copyright 2014 - Bizagi

747

Una vez definida la Forma de Edicin, guarde y cierre la forma de edicin y luego guarde la Forma
Padre.
En el Portal de Trabajo, la tabla mostrar un icono de Edicin ( ).

Seleccione el registro a editar y luego d clic en el icono de Edicin. Una nueva ventana se abrir para
editar la informacin deseada.

Copyright 2014 - Bizagi

748

Edite la informacin y d clic en Guardar para mantener los cambios.

Detalle de Registros
Una Forma de Detalles permite a los usuarios finales visualizar la informacin adicional de cada
registro de una tabla, en modo de solo lectura.
Los usuarios finales pueden ver los registros pero no podrn modificarlos.
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 una de la otra.
La forma de detalles requiere de la siguiente configuracin en la tabla Propiedades:
Habilite ( ) la propiedad Permitir en el grupo de las Opciones de Detalle de la pestaa Avanzado.
Asociar una Forma de Detalle.

Copyright 2014 - Bizagi

749

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 reutilizable, 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 Propiedades que
se encuentra en el Ribbon.
Ninguno: Cuando no se seleccione ninguna forma. De todas maneras, se debe seleccionar una
forma para agregar registros.
Una Forma existente: Si la Forma ha sido creada previamente, seleccinela de la lista.

Copyright 2014 - Bizagi

750

Una vez definida la Forma de Detalle, guarde y cierre la forma y despus guarde la Forma Padre.
En el Portal de Trabajo, la tabla mostrar un icono de Detalle ( ).

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 2014 - Bizagi

751

Exportar tablas a Excel o PDF


Usted puede exportar el contenido de tablas a Excel o PDF desde el Portal de Trabajo para obtener
los datos almacenados en una tabla especfica solo con presionar un botn. La informacin que se
exporta es la que se muestra en la tabla, es decir, se tiene en cuenta cualquier filtro existente.

Habilitar la exportacin a Excel o PDF


Para permitir la exportacin de datos de una tabla a Excel o PDF, usted debe habilitar esta opcin
primero.
1. Vaya a la forma y d clic en la tabla para mostrar sus propiedades.

Copyright 2014 - Bizagi

752

2. En la pestaa Bsico busque las propiedades Exportar a Excel y Exportar a PDF. Habilite la opcin
deseada.
Usted puede habilitar ambas.

Exportar datos de una tabla desde el Portal de Trabajo


Copyright 2014 - Bizagi

753

1. Vaya a la actividad donde se encuentra la tabla.


2. Usted ver un nuevo icono en la parte inferior derecha de la tabla. D clic sobre l.

3. Si usted activo ambas opciones (Excel y PDF), seleccione el formato deseado.

As se ven los datos una vez exportados a los diferentes formatos.


Excel

Copyright 2014 - Bizagi

754

PDF

Copyright 2014 - Bizagi

755

Cambiar el formato de las columnas


Usted puede cambiar el formato de las columnas de una tabla para organizar la informacin
presentada y mostrarla de manera clara a los usuarios finales.
El formato de las columnas puede modificarse desde la pestaa de Formato en las propiedades de
columna.

Copyright 2014 - Bizagi

756

Desde all usted puede definir:

Alineacin horizontal de columnas


Permite alinear el texto en la columnas. Las posibles opciones son: derecha, izquierda, justificado y
centrado.
Para cambiar la alineacin del texto en una columna solo seleccione la opcin deseada.

Copyright 2014 - Bizagi

757

As es como las diferentes alineaciones se ven en el Portal de Trabajo.

Ancho de columnas

Copyright 2014 - Bizagi

758

Por defecto, el ancho de columnas es definido de manera automtica por Bizagi: el ancho total de la
tabla se distribuye de manera equitativa entre sus columnas.
Esta propiedad le permite definir el ancho deseado de columna de acuerdo a sus necesidades. Este se
puede establecer en terminos de porcentaje del ancho total de la tabla o en trminos de pixeles
fijos.
Para definir el ancho de columnas en trminos del porcentaje total del ancho de la tabla, ingrese el
valor deseado seguido del signo %. En la tabla que se muestra a continuacin, la columna Productos
tiene un ancho del 40% respecto al ancho total de la tabla.

Observe que las otras tres columnas no poseen un ancho especfico. Bizagi distribuye de manera
automtica el 60% restante entre ellas. Por lo tanto, cada columnas tendr un ancho del 20% del ancho
total de la tabla.

Para definir el ancho de columna en trminos de pixeles fijos, solo ingrese el nmero de pixeles
deseados seguidos del texto "px". En la tabla que se muestra a continuacin, la columna Producto
posee un ancho de 200 px.

Copyright 2014 - Bizagi

759

Observe que las otras tres columnas no tienen un ancho especfico. Bizagi distribuye automticamente
los pixeles restantes de la tabla, entre estas columnas.

Se sugiere utilizar el porcentaje en vez de los pixeles fijos al momento de definir el ancho de las
columnas. Los pixeles solo deberan ser utilizados en casos donde sea estrictamente necesario;
tenga en cuenta que esto siempre depender de la resolucin de la pantalla.

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.

Copyright 2014 - Bizagi

760

Propiedades
Las siguientes son propiedades exclusivas para el control tipo cuadro de texto:

Pestaa Bsico
PROPIEDAD

DESCRIPCIN

Es extendido

Cuando se habilita esta propiedad, el tamao del rea de texto se expandir


y mostrar una barra de desplazamiento vertical.

Longitud Mxima

Define el nmero mximo de caracteres de texto que pueden ser ingresados


en el control.

Ejemplo de propiedad Es extendido

Pestaa Avanzado

Copyright 2014 - Bizagi

761

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 Siguiente, 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. El valor por defecto puede ser asignado usando una expresin.

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.

Al dar clic en el icono Valor Predeterminado se reiniciarn las propiedades.


Ejemplo propiedad Vuelva a escribir

Ejemplo
Un colegio ha implementado un proceso en Bizagi para realizar las pruebas de historia. Los
estudiantes deben responder diferentes preguntas relacionadas a eventos y personajes relevantes de

Copyright 2014 - Bizagi

762

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 Respuesta1 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 extendido.

Copyright 2014 - Bizagi

763

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.

Copyright 2014 - Bizagi

764

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: S 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 "S". De lo contrario, tomar el valor de "No".

Ejemplo propiedad Mostrar como

Copyright 2014 - Bizagi

765

Pestaa Avanzado
PROPIEDAD

DESCRIPCIN

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.

Actualizar al Cambio

Esta propiedad est deprecada, recomendamos usar Acciones y


Validaciones.
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.

Al dar clic en el icono Valor Predeterminado se reiniciarn las propiedades.

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
Aceptar polticas en la Entidad de Proceso.

Copyright 2014 - Bizagi

766

2. En la forma inserte el atributo Aceptar Polticas. 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 2014 - Bizagi

767

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.

Copyright 2014 - Bizagi

768

Para cada control existen tres grupos de propiedades organizadas en pestaas: Bsico, Formato y
Avanzado.
PESTAA BSICO

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.

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.

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 2014 - Bizagi

769

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 viceversa. 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.

Copyright 2014 - Bizagi

770

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 2014 - Bizagi

771

PESTAA AVANZADO
Aplica a cada control individualmente y permitir la configuracin de comportamientos avanzados
para cada uno.

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

Copyright 2014 - Bizagi

772

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.
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 ( ).
Para borrarlo, d clic en el icono 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 ( ) o en el cono de Expresin ( ).

Propiedad de Filtro
La definicin de un filtro en un Control le permite definir un subconjunto de la lista de todos los
posibles valores relacionados a una entidad. Bizagi solo muestra los registros que cumplen la
condicin de filtro definida en una expresin Booleana.
La propiedad de Filtro se muestra en los siguientes Controles, en la pestaa Avanzado de las
propiedades:
Combo
Lista
Bsqueda
Sugerencia

Copyright 2014 - Bizagi

773

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 ( ) junto a la propiedad.
En la nueva ventana, d clic en el botn Agregar 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 (Y lgico) o con al menos
una de ellas (O Lgico)
Usted tambin puede definir filtros usando expresiones complejas. Para ms informacin refirase a
Filtros Avanzados.

Ejemplo
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

Copyright 2014 - Bizagi

774

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.

2. En el diseador de formas, defina un filtro para el control de Centro de costo.

Copyright 2014 - Bizagi

775

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.

Copyright 2014 - Bizagi

776

4. Cree una nueva condicin donde el Centro de costo a mostrar sea Administracin.

Copyright 2014 - Bizagi

777

5. Asegrese de que en la parte superior, la opcin CUALQUIERA de las siguientes condiciones, est
seleccionada.
6. El Portal de Trabajo mostrar ahora solo dos Centro de costo en el combo.

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

Copyright 2014 - Bizagi

778

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.

D clic en el botn Agregar 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 (Y lgico) o con al menos
una de ellas (O lgico).

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.

Copyright 2014 - Bizagi

779

El filtro de columna de la tabla se encuentra en la opcin Editar columnas, para cada control. Active
(S) o desactive (No) la opcin Aplicar filtro a cada fila de acuerdo a sus necesidades.

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.

Copyright 2014 - Bizagi

780

Cuando creamos el filtro, solo un producto se mostrar ya que posee un precio unitario de $1,000.
1. Revise en el Portal de Trabajo que la Tabla de Productos muestre todos los registros en la entidad.

2. En el diseador de formas, defina un filtro para la Tabla y luego guarde la forma.

Copyright 2014 - Bizagi

781

3. El Portal de Trabajo mostrar ahora un producto en la Tabla.

Copyright 2014 - Bizagi

782

Valores Mximo y Mnimo


Usted podra 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 Mximo y
Mnimo.
Las propiedades de valor Mximo y Mnimo se encuentran en la pestaa Avanzado de las
propiedades del Control.
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.

Copyright 2014 - Bizagi

783

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 Ingreso Mensual y el Monto Solicitado se almacenan en los atributos con el mismo
nombre, dentro de la Entidad de Proceso Solicitud de Crdito.

1. En la forma, inserte el atributo Monto Solicitado y abra la pestaa Avanzado de las propiedades del
control.

2. En la propiedad de Valor Mnimo ingrese 100.

Copyright 2014 - Bizagi

784

3. Ahora vaya a la propiedad valor Mximo y d clic en el icono de expresin (


mximo permitido de acuerdo al ingreso mensual del solicitante.

Copyright 2014 - Bizagi

) para definir el valor

785

4. En el mdulo de expresiones, defina el umbral mximo basado en los ingresos mensuales.


La expresin en este ejemplo sera: <CreditRequest.MonthlyIncome>*10;

Guarde la expresin y luego cierre la forma.


5. Vaya al Portal de Trabajo para probar las validaciones.
Ingrese un valor menor que 100 en el control Solicitar Monto. Cuando intente avanzar la actividad, se
mostrar el siguiente mensaje.

Copyright 2014 - Bizagi

786

Ahora ingrese un valor mayor a diez veces el ingreso mensual del solicitante. Al intentar avanzar la
actividad, se mostrar el siguiente mensaje.

Copyright 2014 - Bizagi

787

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 Fecha de Salida, dentro de la
entidad de Proceso Solicitud de Vacaciones.

1. En el diseador de formas, vaya a las propiedades del control Fecha de Salida y abra la pestaa
Avanzado.

Copyright 2014 - Bizagi

788

2. En la propiedad de valor Mximo seleccione diciembre 30 de 2012.

3. Ahora vaya a la propiedad Valor Mnimo y d clic en el icono de expresin (


una expresin.

Copyright 2014 - Bizagi

) para asociarlo con

789

4. En el mdulo de Expresiones defina el mnimo valor permitido para el control (15 das despus de la
fecha actual) de acuerdo con la fecha actual.
La expresin en este ejemplo sera:
var Today=DateTime.Today;
var Max=Today.AddDays(15)
Max;

Copyright 2014 - Bizagi

790

Guarde la expresin y luego guarde la forma.


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 debido a que todos los das que caen despus de la
fecha limite estn deshabilitados (En este ejemplo, 31 de Diciembre). Adems, el cono de siguiente
mes ( ) est deshabilitado.

Copyright 2014 - Bizagi

791

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

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.

Copyright 2014 - Bizagi

792

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.

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:
Botn de validaciones de Tabla: Se ejecutan cuando los usuarios finales dan clic en el botn
Siguiente 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

Copyright 2014 - Bizagi

793

botn Guardar, 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 Guardar, dentro de una Forma de edicin. Validan la informacin del registro editado en ella.
Expresin de Validacin (Opciones de Borrado): Se ejecuta cuando se Borra un registro de una
tabla. Los datos se validan para permitir o no dicho borrado.

Botn de Validaciones de Tabla


El botn de Validaciones 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.

Las validaciones pueden evaluar contadores, que contarn el nmero de registros que cumplen con
una condicin en la tabla, o atributos directamente.

Copyright 2014 - Bizagi

794

Contadores
Los contadores son variables utilizadas para obtener el nmero de filas 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 NewCounter, el nmero de filas en la Tabla.


El segundo contador almacena el la variable NewCounter2, 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 NewCounter3 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 2014 - Bizagi

795

Adicionalmente usted puede crear grupos de condiciones vinculndolas a travs del uso de la opcin
Vincular ( ). 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.

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
En la seccin inferior de la ventana (Validaciones), definimos las validaciones que se ejecutarn. Como

Copyright 2014 - Bizagi

796

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.

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 una condicin "O", 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 Mostrar mltiples validaciones que se encuentra en la parte inferior izquierda de la ventana.
Esto mostrar el botn Nuevo que permite crear nuevas validaciones. Se puede acceder a cada

Copyright 2014 - Bizagi

797

validacin por separado a travs de la lista desplegable en la parte superior derecha de la ventana. La
ventana de Validaciones de tabla mostrar la primera validacin de manera predeterminada.

Ejemplo
En un Proceso de Solicitud de compra, la tabla de Productos Solicitados 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 (es decir, no hay
filas):

Copyright 2014 - Bizagi

798

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 2014 - Bizagi

799

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.

Copyright 2014 - Bizagi

800

Copyright 2014 - Bizagi

801

Expresiones de Validacin en Adicin, Edicin y Borrado


Las expresiones de validacin para agregar, editar o eliminar registros, se encuentran el la pestaa
Avanzado de las propiedades de la Tabla, cuando la propiedad Aadir, Editar o Borrar est
habilitada:
Cuando la propiedad Permitir Adicin esta habilitada (S) y creacin en lnea deshabilitada (No).
Cuando la propiedad Permitir Edicin esta habilitada (S) y edicin en lnea deshabilitada (No).
Cuando la propiedad Permitir Borrar esta habilitada (S).
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
en una ventana emergente o cuando dan clic en el botn Guardar..
Para las Validaciones de borrado, la validacin aparece cuando el usuario trata de borrar un registro
de la tabla.
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.

Para incluir una expresin de validacin de Clic en el icono de expresin (

Copyright 2014 - Bizagi

). Esto mostrar el editor

802

de expresiones.
Elimine una validacin relacionada dando clic en el icono de cruz ( ).
Edite una validacin relacionada dando clic en el Nombre de la expresin o el icono de expresin (

).

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 Forma de Adicin, 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.
3. Cree una nueva Expresin de Validacin dando clic en el icono de expresin (
El editor de Expresin se mostrar.

Copyright 2014 - Bizagi

).

803

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 d clic en el icono de adicin. Esto mostrar una nueva ventana donde la
informacin del nuevo registro debe ser ingresada.

6. Cuando se ingresa la informacin y el usuario da clic en Guardar, la expresin de validacin se


ejecutar.
En la siguiente imagen se muestra el error que aparece.

Copyright 2014 - Bizagi

804

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 podra 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 convertir un control a otro de una manera rpida sin necesidad de eliminar y recrear
otro tipo de control.
Para acceder a la opcin de Convertir a, d clic derecho sobre el control a convertir.

Copyright 2014 - Bizagi

805

Se mostrar la lista de controles a los cuales el control actual puede ser convertido. Simplemente
seleccione el control deseado para convertirlo.

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

Control por
Defecto

Controles Disponibles

Booleano

Si/No

Oculto
Si/No

Nmero
(Entero, Real,
corto, etc)

Nmero

Oculto
Moneda
Nmero

Fecha-Hora

Fecha

Oculto
Fecha

Moneda

Moneda

Nmero
Moneda

Texto

Cuadro d
Texto

Cuadro de Texto

Archivo

Archivo

Archivo

Imagen

Imagen

Imagen

Copyright 2014 - Bizagi

806

Combo

Lista
Sugerencia
Radio
Bsqueda
Lista desplegable en
cascada
Vnculo a Forma
Combo

Entidad
Maestra

Bsqueda

Lista
Sugerencia
Radio
Combo
Lista desplegable en
cascada
Vnculo a Forma
Bsqueda

Coleccin

Tabla

Tabla

Entidad
Paramtrica

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)

Personalizar la interfaz de usuario (Widgets)

Introduccin
Bizagi ofrece un conjunto exhaustivo de controles para agregar a las formas de Actividades (UI).
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 en las interfaces
de usuario o personalizarlas (p.e, mostrar un grfico de estadsticas, utilizar un mapa de Google,
integrar cmaras web, scanners y otros perifricos o cualquier cosa no considerada en los controles
incluido), usted tiene la posibilidad de incluir Widgets en sus formas de Bizagi.

Copyright 2014 - Bizagi

807

Widgets de Bizagi
Los Widgets son controles 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 en cualquier modelo de negocio.
El concepto detrs de un Widget es permitir definir y desarrollar controles cumpliendo con una
estructura especfica (impulsado para ser mostrado en cualquier dispositivo), se tal manera que
presente un comportamiento personalizado dirigido a modeles (adjuntable a cualquier proceso).

Los Widgets reemplazan un concepto presentado en versiones anteriores de Bizagi (9.1.x), llamado
User fields.
La extensibilidad de la funcionalidad de interfaz de usuario se ofrece a travs de los Widgets de
Bizagi en las versiones 10.x.

Usted puede descargar los Widgets desde la Tienda de Widgets de Bizagi para incluirlos fcilmente en
su proyecto. La tienda tiene una seccin amplia que abarca las siguientes categoras: Grficos (Charts),
Finanzas (Finance), Mapas (Maps), Utilidades (Utilities) y Perifricos (Peripheral devices). Este artculo
ilustra cmo incluir y usar los Widgets desde la Tienda de Widgets de Bizagi.

Copyright 2014 - Bizagi

808

Usted puede escoger definir sus propios Widgets e incluirlos en su proyecto.


Crear controles personalizados requieren habilidades tcnicas como por ejemplo: Fundamentos de
desarrollo de cdigo en JQuery y Javascript, estar familiarizado con la notacin JSON,
conocimientos de HTLM y CSS (preferiblemente HTML5 y CSS3).

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.
En la pestaa de Controles, encontrar una opcin de banner que lo llevar a la Tienda de Widgets.

D clic sobre ella para ir a la Tienda de Widgets de Bizagi (se requiere conexin a Internet):

Copyright 2014 - Bizagi

809

Dentro de la 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 2014 - Bizagi

810

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 (pestaa de
Comentarios).

Copyright 2014 - Bizagi

811

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 Instalar 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 usted lo lee, asegrese de aceptar los trminos y d clic en el botn Descargar.

Copyright 2014 - Bizagi

812

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.

Copyright 2014 - Bizagi

813

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. Desde otra estacin de trabajo, con acceso a Internet, visite la Tienda de Widgets de Bizagi desde
cualquier navegador. Esto se hace ingresando la siguiente URL:
http://www.bizagi.com/WidgetStore/Default.aspx

Copyright 2014 - Bizagi

814

Cuando acceda a la Tienda de Widgets de Bizagi desde un navegador (no directamente desde Bizagi
Studio), usted puede seguir los mismos pasos descritos en la seccin previa.
Esta vez, el Widget ser descargado como un archivo .bwg, en lugar de ser aadido a los controles de
la forma.
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.

Copyright 2014 - Bizagi

815

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.

Configurar un Widget
Para utilizar un Widget instalado, primero localcelo en la categora especfica de Controles.
1. Arrastre el Widget y sultelo en el rea de trabajo:

Copyright 2014 - Bizagi

816

2. D clic en el Widget para ver sus propiedades (de la misma manera que se hace para los dems
controles).

Para los Widgets tipo grfico, asegrese de dar clic en el rea que no tiene la grfica misma (el rea
gris, la parte ms a la derecha 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.

Copyright 2014 - Bizagi

817

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).
Para ms informacin sobre cada Widget, usted podr revisar en la Tienda de Widgets de Bizagi y
ver la vista detallada de cada uno.
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.

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.

Copyright 2014 - Bizagi

818

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.
Sin embargo, usted solo necesita utilizar expresiones para evaluar situaciones complejas e negocio
reales. Recomendamos utilizar las Acciones y Validaciones sobre expresiones cuando aplique.

Ejecutar Acciones y Validaciones


El Asistente de Acciones y Validaciones administra dos funcionalidades en las Formas: una, las
Acciones que controlan el comportamiento de los atributos incluidos en la forma, y dos, las
Validaciones que muestran mensajes de error cuando los datos ingresados no cumplen con los
requerimientos de negocio.
Basado en condiciones de validacin, el asistente evaluar cuales acciones tomar y que mensajes
mostrar.
Las Acciones & Validaciones definidas aplican a cada forma de manera independiente. El asistente se
encuentra en el Ribbon del Diseador de Formas.

Copyright 2014 - Bizagi

819

Recomendamos utilizar Acciones y Validaciones para administrar el comportamiento de las formas.


Estas impulsan el desempeo en ejecucin y son simples e intuitivas en su creacin y mantenimiento.

Acciones
Las Acciones se pueden ejecutar sobre uno o varios controles incluidos en la forma para:
Cambiar el formato (color de fondo, color del texto)
Definir visibilidad
Si los controles son de solo lectura o editables
Si los controles son requeridos o no
Refrescar el contenido de los controles
Limpiar el contenido de los controles
Asignar un valor exacto
Asignar el valor mnimo o mximo
Colapsar o expandir grupos
Activar una pestaa
Ejecutar una regla
Ejecutar una interfaz

Validaciones
Las validaciones muestran (lanzan) mensajes de error al usuario final, cuando se cumplen las
condiciones definidas.

Tenga en cuenta que el uso de Acciones y Validaciones en formas de adicin de controles de

Copyright 2014 - Bizagi

820

Bsqueda, no esta soportado.

Componentes de las acciones


Las Acciones se definen por tres componentes:
La condicin a evaluar.
La accin a ejecutar cuando se cumple la condicin.
La accin a ejecutar cuando no se cumple la condicin.
Para definir una accin vaya al asistente de Acciones y Validaciones y d clic en el botn Agregar,
dentro de la Pestaa de Acciones:

Definir las condiciones (Cundo)


D clic en Agregar una condicin. Se agregar una nueva fila para crear la nueva condicin.

Copyright 2014 - Bizagi

821

Las condicin posee un control, un operador y un argumento.


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. Los operadores disponibles son:

Operador

Descripcin

Aplica a controles

cambia a

Evala si el valor de un control ha Combo,


Combo
cambiado a un valor especfico.
cascada, Lista, Radio,
Bsqueda,
Sugerencia, Moneda,
Nmero, Fecha

es diferente a

Evala si el valor de un control es Combo,


Combo
diferente
a
un
valor cascada, Lista, Radio,
especfico.8888888888888
Bsqueda,
Sugerencia, Moneda,
Nmero, Fecha

est vaco

Evala si el control est vaco.

Combo,
Combo
cascada, Lista, Radio,
Bsqueda,
Sugerencia, Moneda,
Nmero, Fecha

no est vaco

Evala si el control no est vaco.

Combo,
Combo
cascada, Lista, Radio,
Bsqueda,
Sugerencia, Moneda,
Nmero, Fecha

cambia

Evala si el valor de un control ha Combo,


Combo
cambiado.
cascada, Lista, Radio,

Copyright 2014 - Bizagi

822

Bsqueda,
Sugerencia, Moneda,
Nmero,
Fecha,
Archivo
no contiene

Evala si el valor de un control no Cuadro de texto


contiene un caracter especfico.

contiene

Evala si el valor de un control Cuadro de texto


contiene un caracter especfico.

comienza con

Evala si el valor de un control Cuadro de texto


inicia con un caracter especfico.

no comienza con

Evala si el valor de un control no Cuadro de texto


comienza
con
un
caracter
especfico.

es
un
correo Evala si el valor de un control es Cuadro de texto
electrnico invlido un correo electrnico invlido.
menor que

Evala si el valor de un control es Fecha,


menor que un valor especfico.
Nmero

Moneda,

menor o igual

Evala si el valor de un control es Fecha,


menor o igual que un valor Nmero
especfico.

Moneda,

mayor que

Evala si el valor de un control es Fecha,


mayor que un valor especfico.
Nmero

Moneda,

mayor o igual que

Evala si el valor de un control es Fecha,


mayor o igual que un valor Nmero
especfico.

Moneda,

ha eliminado
registro

un Evala si se ha eliminado un Tabla


registro en una tabla.

clic

Evala si se ha hecho clic en un Botn


botn.

es verdadero

Evala si el valor de un control es Booleano


igual a verdadero.

es falso

Evala si el valor de un control es Booleano


igual a falso.

ha cargado
archivo

un Evala si un control de tipo Archivo


archivo tiene un archivo cargado.

no ha cargado un Evala si un control de tipo Archivo


archivo
archivo
no
posee
archivos
cargados.

Copyright 2014 - Bizagi

823

Argumento: Define el valor a ser comparado con el control. Este valor puede ser una constante o
un mapeo de datos.
Usted puede crear condiciones compuestas conectadas por Y/O.
Para crear una condicin compuesta conectada por Y, d clic en Agregar una condicin.
Para crear una condicin compuesta conectada por O, d clic en Agregar un grupo de condicin.

Defina las Acciones principales (Entonces)


D clic en Agregar una condicin. Se agregar una nueva fila para crear la nueva accin.
Usted puede crear tantas acciones como lo desee. Todas ellas se ejecutarn cuando se cumpla la
condicin definida en la parte superior.

Copyright 2014 - Bizagi

824

La accin posee un comando, un control y una argumento.


Comando: Define el tipo de comportamiento a aplicar. Dentro de los comandos usted encontrar:
Comando
Definir fondo
Definir color de primer plano

Cambia visibilidad para

Comportamiento
Cambia el color de un control.
Cambia el color de la fuente de un
control.
Muestra u oculta un control.

Cambia editabilidad para

Cambiar
la
configuracin
editabilidad de un control.

Definir como obligatorio

Define un control como obligatorio u


opcional.

Definir valor para

de

Asigna un valor a un control.

Definir valor mnimo para

Asigna un valor mnimo permitido para


un control.

Definir valor mximo para

Asigna un valor mximo permitido


para un control.

Contraer

Contrae/Expande un grupo.

Definir como activo


Refrescar

Ejecutar regla

Activa una pestaa.


Refresca el valor de un control de
acuerdo a la informacin ingresada en
la forma. Es muy til cuando el valor
de un control depende del valor de
otro o de la ejecucin de una interfaz
o expresin.
Ejecuta una expresin.

Copyright 2014 - Bizagi

825

Ejecutar interfaz
Limpiar datos para

Ejecuta una interfaz.


Elimina cualquier dato ingresado en el
control.

Control: Define el control al que se aplicar el comportamiento.


Argumento: Define el valor del comando a ser aplicado.

Defina la accin a ejecutar cuando no se cumpla la condicin (Si no)


Estas son las acciones a ejecutar cuando las condiciones definidas no se cumplen.

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.

Afectar varios controles


Cuando necesite afectar controles que se encuentran cerca uno del otro en una forma, usted puede
hacer uso del contenedor Panel para agruparlos. De esta manera, usted puede afectar todo el grupo,
en vez de ejecutar acciones individuales para cada uno.

Copyright 2014 - Bizagi

826

Este control se encuentra en los contenedores del Diseador de Formas.

Usando acciones usted puede ahorrar tiempo. Observe la siguiente imagen para apreciar cmo.
Ambas acciones son correctas y harn exactamente lo mismo, pero usando el control Panel, har ms
rpido el diseo de la forma.

Copyright 2014 - Bizagi

827

Tenga en cuenta lo siguiente sobre los pneles:


Los Paneles solamente le ayudan a trabajar con Acciones. No afectar la interfaz del usuario final
en s.
Los Paneles pueden utilizarse para cambiar el color de fondo, visibilidad y editabilidad de
controles as como para refrescarlos.

D clic aqu para ver ejemplos de cmo configurar acciones bsicas


D clic aqu para ver ejemplos de cmo configurar otras acciones
D clic aqu para ver ejemplos de cmo configurar sobre colecciones

Acciones bsicas
En los siguientes ejemplos mostraremos cmo definir acciones bsicas.
Mostrar u ocultar un control de acuerdo a una condicin
Definir varios controles como obligatorios y visibles de acuerdo a una condicin (incluyendo controles
uno a uno)
Definir varios controles como visibles de acuerdo a una condicin (usando Panel - recomendado)
Cambiar el formato de un control de acuerdo a condiciones compuestas (usando Y)

Mostrar u ocultar un control de acuerdo a una condicin


En un proceso de Solicitud de Vacaciones deseamos mostrar el control Fecha de salida, cuando
Solicitar Vacaciones sea verdadero.
Esconderemos el control Fecha de salida cuando Solicitar Vacaciones sea falso o no se encuentre
seleccionado.

Copyright 2014 - Bizagi

828

1. Cree una Accin.


En el diseador de Formas seleccione Acciones y Validaciones y agregue una nueva accin.

2. Incluya la condicin. D clic en Agregar una condicin y seleccione el control, operador y argumento
as:
Cundo Solicitar Vacaciones cambie a verdadero.

Copyright 2014 - Bizagi

829

3. Incluya la Accin (Entonces). D clic en Agregar una accin y defina lo que pasar cuando la
condicin no se cumpla.
Cambie la visibilidad para Fecha de Salida a verdadero.

Copyright 2014 - Bizagi

830

4. Defina la accin alterna (Si no), que se ejecutar cuando no se cumpla la condicin.
Cambie la visibilidad para Fecha de Salida a falso.

Copyright 2014 - Bizagi

831

As es como se ver el Portal de Trabajo de acuerdo a la seleccin del usuario:

Definir varios controles como requeridos y visibles de acuerdo a una condicin


- Incluyendo controles uno a uno
En un proceso de Solicitud de Vacaciones deseamos hacer obligatorios y visibles los siguientes
controles, cuando Solicitar Vacaciones sea verdadero: Fecha de salida, Fecha de regreso y Nmero de
das laborales solicitados.
Esconderemos estos controles cuando Solicitar Vacaciones sea falso o no se encuentre seleccionado.

Copyright 2014 - Bizagi

832

1. Cree una Accin.


En el diseador de Formas seleccione Acciones y Validaciones y agregue una nueva accin.

2. Incluya la condicin. D clic en Agregar una condicin y seleccione el control, operador y argumento
as:
Cundo Solicitar Vacaciones cambie a verdadero.

Copyright 2014 - Bizagi

833

3. Incluya la Accin (Entonces). D clic en Agregar una accin y defina lo que pasar cuando se cumpla
la condicin.
Agregue tantas acciones como sea necesario:
Cambie la visibilidad para Fecha de salida, Fecha de regreso y Nmero de das laborales solicitados a
verdadero.
Definir como obligatorio Fecha de salida, Fecha de regreso y Nmero de das laborales solicitados a
verdadero.

Copyright 2014 - Bizagi

834

4. Defina la accin alterna (Si no), que se ejecutar cuando no se cumpla la condicin.
Cambie la visibilidad para Fecha de salida, Fecha de regreso y Nmero de das laborales solicitados a
verdadero.
Observe que debido a que los controles se ocultaran, no ser necesario configurar acciones para
hacerlos no obligatorios.

Copyright 2014 - Bizagi

835

As es como se ver el Portal de Trabajo de acuerdo a la seleccin del usuario:

Copyright 2014 - Bizagi

836

Definir varios controles como requeridos y visibles de acuerdo a una condicin


- Usando Panel (recomendado)
En un proceso de Solicitud de Vacaciones deseamos hacer obligatorios y visibles los siguientes
controles, cuando Solicitar Vacaciones sea verdadero: Fecha de salida, Fecha de regreso y Nmero de
das laborales solicitados.
Usted puede incluir controles uno a uno como en el ejemplo anterior, o usted puede agruparlos y
ejecutar una nica Accin. Esto es lo recomendado: le ahorrar tiempo y har la administracin de los
comportamientos, ms fcil.
1. Incluya un Panel arrastrndolo desde el rea de Contenedores hasta la Forma.
Incluya en el Panel los atributos que afectar con su Accin.

Copyright 2014 - Bizagi

837

2. Cree una Accin utilizando unicamente el Panel como control. El Panel agrupa los controles que
contiene.

Copyright 2014 - Bizagi

838

Este ejemplo y el anterior tiene exactamente el mismo efecto en el Portal de Trabajo..


No hay diferencia en la presentacin de la interfaz. Los Paneles solo hacen el trabajo ms fcil.

Cambiar el formato de un control de acuerdo a condiciones compuestas


En un proceso de Solicitud de Vacaciones deseamos cambiar el color de la Fecha de salida a rojo,
cuando Solicitar Vacaciones sea verdadero y la Fecha de salida sea mayor a la Fecha de regreso (lo
cual no hace sentido).
1. Cree una Accin.
En el diseador de Formas seleccione Acciones y Validaciones y agregue una nueva accin.

2. Incluya ambas condiciones en la seccin Cundo.

Copyright 2014 - Bizagi

839

3. Agregue la accin en la seccin Entonces para cambiar el color del control.

Copyright 2014 - Bizagi

840

4. Agregue la accin alterna (Si no) para regresar el control a su estado original.

Copyright 2014 - Bizagi

841

As es como se ver el Portal de Trabajo:

Otras acciones
Adems de las acciones bsicas para cambiar la visibilidad, editabilidad, obligatoriedad o formato de
un control, Bizagi ofrece un conjunto de acciones enfocadas en mejorar el desempeo de las formas.
Las nuevas acciones refresca dinmicamente los controles de una forma y permiten definir la
informacin que debe ser actualizada. Esta moderna funcionalidad sin postbakcs, enva solo la
informacin requerida para mejorar notoriamente el desempeo tanto en dispositivos mviles como
en computadores.
Estas acciones invluyen:

Copyright 2014 - Bizagi

842

Asignar un valor a un control


Refrescar el valor de un control de acuerdo a una condicin
Usar un botn
Ejecutar una regla
Ejecutar una interfaz
Limpiar los datos para un control
Colapsar un grupo

Asignar un valor a un control


Con el uso de acciones, usted puede asignar un valor especfico a un control incluido en una forma, al
cumplirse una condicin determinada.
Ejemplo
En un Proceso de Solicitud de Compra, si el solicitante tiene un jefe directo, la solicitud debe ser
aprobada por este.
El atributo Jefe contiene el nombre del jefe del solicitante. El atributo Requiere aprobacin identifica si
la solicitud debe ser aprobada o no.

Por lo tanto, si el atributo Jefe se encuentra vaco, el solicitante no posee un jefe directo por lo que el
atributo Requiere aprobacin se debe configurar en falso..
Para configurar esta accin:
1. Cree una Accin.

Copyright 2014 - Bizagi

843

En el diseador de Formas seleccione Acciones y Validaciones y agregue una nueva accin.

2. Incluya la condicin.
D clic en Agregar una condicin y seleccione el control, operador y argumento as:
Cundo Jefe est vaco.

Copyright 2014 - Bizagi

844

3. Incluya la Accin (Entonces).


D clic en Agregar una accin y defina lo que pasar cuando se cumpla la condicin.
Definir valor para Requiere aprobacin a falso.

4. Defina la accin alterna (Si no), que se ejecutar cuando no se cumpla la condicin.
Definir valor para Requiere aprobacin a verdadero.

As es como se ver el Portal de Trabajo de acuerdo al usuario que hace la solicitud:

Copyright 2014 - Bizagi

845

Refrescar el valor de un control de acuerdo a una condicin


El comando Refrescar permite definir cuales controles deben ser actualizados cuando se cumpla una
condicin especfica. Normalmente, esta condicin responde a cambios en el valor de un atributo. Este
comando es especialmente til para mejorar los tiempos de respuesta de la forma, permitiendo
actualizar secciones especficas en vez de actualizar la forma entera.
Ejemplo
En un Proceso de Solicitud de Compra, cuando el solicitante incluye un producto, la descripcin y el
precio estimado de este deben ser actualizados. Estos atributos pertenecen a una misma entidad
paramtrica, por lo que se encuentran directamente relacionados.

Para actualizar nicamente estos campos, usted debe utilizar acciones.

Copyright 2014 - Bizagi

846

1. Cree una Accin.


En el diseador de Formas seleccione Acciones y Validaciones y agregue una nueva accin.
2. Incluya la condicin.
D clic en Agregar una condicin y seleccione el control, operador y argumento as:
Cundo Producto cambie

3. Incluya la Accin (Entonces). D clic en Agregar una accin y defina lo que pasar cuando se cumpla
la condicin.
Refrescar Descripcin y Precio Estimado.

Copyright 2014 - Bizagi

847

4. Defina la accin alterna (Si no). En este caso no se ejecutar ninguna accin por lo que se deja esta
opcin en No hacer nada.

As es como se comportar el Portal de Trabajo de acuerdo al cambiar el producto seleccionado:

Copyright 2014 - Bizagi

848

Usar un botn
Las Acciones pueden ser utilizadas para definir qu hacer cuando se d clic sobre un botn. La
utilizacin de Acciones en lugar de comportamientos especficos configurados directamente sobre un
botn, le permite ejecutar nicamente las acciones deseadas, sin actualizar la totalidad de la forma.
Solo los controles especificados se actualizarn despus de ejecutar el comportamiento del botn.
Ejemplo
En un Proceso de Solicitud de Compra se utiliza un botn para calcular el costo total de la compra
incluyendo descuentos e impuestos.

Al dar clic sobre el botn, se ejecuta una expresin para obtener el valor total. Como solo deseamos
actualizar el control Costo Total cuando se presione el botn, debemos utilizar acciones.

Copyright 2014 - Bizagi

849

1. Incluya el botn en la Forma.


Arrastre un control de botn desde el panel de controles y sultelo en la forma. Cambie el nombre a
Calcular.

2. Cree una Accin.


En el diseador de Formas seleccione Acciones y Validaciones y agregue una nueva accin.
3. Incluya la condicin.
D clic en Agregar una condicin y seleccione el botn en la lista de controles. La condicin Clic estar
disponible para identificar cundo el botn ha sido presionado.

La condicin es Cundo Calcular click.

Copyright 2014 - Bizagi

850

4. Incluya la Accin (Entonces).


D clic en Agregar una accin y defina lo que pasar cuando se cumpla la condicin.
Seleccione el comando Ejecutar regla y luego la expresin deseada, desde el editor de expresiones.

En este caso la regla para totalizar el costo de la compra se ha llamado Calcular costo total.
La accin es entonces Ejecutar regla Calcular costo total.

Copyright 2014 - Bizagi

851

5. Actualice los campos afectados.


D clic en Agregar una accin y defina los campos que deben ser actualizados una vez se ejecute la
regla. Para esto, utilice el comando Refrescar.
En este caso, el control a refrescar es Costo Total.
Refrescar Costo Total.

Copyright 2014 - Bizagi

852

6. Defina la accin alterna (Si no). En este caso no se ejecutar ninguna accin por lo que se deja esta
opcin en No hacer nada.

As es como se actualizar la informacin en el Portal de Trabajo al hacer clic en el botn:

Ejecutar una regla


Las acciones permiten ejecutar reglas cuando se cumplan condiciones especficas. El uso de acciones
para ejecutar reglas en lugar de eventos al guardar o botones independientes, permite actualizar
nicamente los controles afectados directamente por la ejecucin de la regla.

Copyright 2014 - Bizagi

853

Ejemplo
Un Proceso para apoyar operaciones de comercio internacional utiliza un convertidor de monedas en
la forma de una de sus actividades. Como cualquier convertidor, el usuario debe ingresar el valor a
convertir, la moneda actual y la moneda a convertir.

Cuando el valor de cualquiera de los campos cambie, el clculo debe actualizarse para reflejar dicho
cambio. El clculo se hace a travs de una expresin que hemos llamado Convertir moneda.
Se utiliza una accin para identificar el cambio en alguno de estos controles y de esta manera ejecutar
esta regla.

1. Cree una Accin.


En el diseador de Formas seleccione Acciones y Validaciones y agregue una nueva accin.
2. Incluya la condicin. D clic en Agregar una condicin y seleccione el control, operador y argumento
as:
Cundo Valor a convertir cambie O Moneda actual cambie O Moneda a convertir cambie.

Copyright 2014 - Bizagi

854

3. Incluya la Accin (Entonces). D clic en Agregar una accin y defina lo que pasar cuando se cumpla
la condicin.
Seleccione el comando Ejecutar regla y luego la expresin deseada, desde el editor de expresiones.
Ejecutar Regla Convertir moneda

La accin es Ejecutar regla Convertir Moneda

Copyright 2014 - Bizagi

855

4. Actualice los campos afectados.


D clic en Agregar una accin y defina los campos que deben ser actualizados una vez se ejecute la
regla. Para esto, utilice el comando Refrescar.
En este caso, el control a refrescar es Valor convertido.
Refrescar Valor convertido.

Copyright 2014 - Bizagi

856

5. Defina la accin alterna (Si no). En este caso no se ejecutar ninguna accin por lo que se deja esta
opcin en No hacer nada.

As es como se comporta el Portal de Trabajo al cambiar el valor de uno de sus campos:

Ejecutar una interfaz


Las acciones permiten ejecutar interfaces cuando se cumplan condiciones especficas. El uso de
acciones para ejecutar interfaces en lugar de eventos al guardar o botones independientes, permite
actualizar nicamente los controles afectados directamente por la ejecucin de la interfaz.
Ejemplo
En un Proceso de Solicitud de Crditos, la informacin de un solicitante puede ser consultada en la
centrales de riesgo en cualquier momento. Debido a que la central de riesgo es un sistema externo, se
utiliza una interfaz para realizar la verificacin. Se requiere el nmero de identificacin del solicitante y
presionar un botn para hacer la consulta.

Copyright 2014 - Bizagi

857

Se debe definir una interfaz para configurar este comportamiento.


1. Incluya el botn en la Forma.
Arrastre un control de botn desde el panel de controles y sultelo en la forma. Cambie el nombre a
Verificar solicitante.

2. Cree una Accin.


En el diseador de Formas seleccione Acciones y Validaciones y agregue una nueva accin.
3. Incluya la condicin.
D clic en Agregar una condicin y seleccione el control, operador y argumento. Use la condicin Click
para identificar cundo el botn ha sido presionado.

Copyright 2014 - Bizagi

858

La condicin es Cundo Verificar solicitante click

4. Incluya la Accin (Entonces).


D clic en Agregar una accin y defina lo que pasar cuando se cumpla la condicin.
Seleccione Ejecutar interfaz y configure la interfaz deseada.

Copyright 2014 - Bizagi

859

Para mayor informacin acerca de cmo configurar interfaces consulte Invocar servicios externos
desde Bizagi
5. Actualice los campos afectados.
D clic en Agregar una accin y defina los campos que deben ser actualizados una vez se ejecute la
interfaz. Para esto, utilice el comando Refrescar.
En este caso, el control a refrescar es Estado.
Refrescar Estado.

Copyright 2014 - Bizagi

860

6. Defina la accin alterna (Si no). En este caso no se ejecutar ninguna accin por lo que se deja esta
opcin en No hacer nada.

As es como se comportar el Portal de Trabajo al ejecutar la interfaz:

Colapsar un grupo
Usted puede manipular grupos utilizando acciones, para expandirlos o colapsarlos de acuerdo a

Copyright 2014 - Bizagi

861

condiciones especficas
Ejemplo
En un Proceso de Solicitud de Viaje, la informacin de reserva de hotel se muestra en un grupo. Este
grupo solo debera expandirse se el solicitante requiere reserva de hotel, de lo contrario, debera
permanecer colapsado.

Para colapsar o expandir el grupo de informacin de la reserva de hotel, de acuerdo a lo requerido,


configure una accin:
1. Cree una Accin.
En el diseador de Formas seleccione Acciones y Validaciones y agregue una nueva accin.
2. Incluya la condicin. D clic en Agregar una condicin y seleccione el control, operador y argumento
as:
Cundo Reservar hotel es falso.

Copyright 2014 - Bizagi

862

3. Incluya la Accin (Entonces). D clic en Agregar una accin y defina lo que pasar cuando se cumpla
la condicin.
Colapsar Informacin del Hotel a verdadero.

4. Defina la accin alterna (Si no), que se ejecutar cuando NO se cumpla la condicin.
Colapsar Informacin del Hotel a falso.

Copyright 2014 - Bizagi

863

As es como se comportar el Portal de Trabajo de acuerdo a la seleccin del usuario:

Limpiar datos para un control


Copyright 2014 - Bizagi

864

Con el uso de Acciones usted tambin puede limpiar los datos de uno o varios controles, cuando se
cumpla una condicin especfica.
Ejemplo
En un proceso de gestin de Quejas y Reclamos la informacin de un caso es ingresada en la primera
actividad.
En algunos casos, cuando la mayor parte de la informacin ha sido ingresada, el cliente puede decidir
declinar el caso. En esta situacin es deseable que el usuario que ingresa la informacin pueda
eliminar lo que ha diligenciado, con solo presionar un botn.
1. Incluya el botn en la Forma.
Arrastre un control de botn desde el panel de controles y sultelo en la forma. Cambie el nombre a
Limpiar informacin.

2. Cree una Accin.


En el diseador de Formas seleccione Acciones y Validaciones y agregue una nueva accin.
3. Incluya la condicin. D clic en Agregar una condicin y seleccione el control, operador y argumento
as:
Cuando Limpiar Informacin click.

Copyright 2014 - Bizagi

865

4. Incluya la Accin (Entonces). D clic en Agregar una accin y defina lo que pasar cuando se cumpla
la condicin.
Limpiar Informacin para Cliente, Medio de recepcin y Causa.

5. Defina la accin alterna (Si no). En este caso no se ejecutar ninguna accin por lo que se deja esta

Copyright 2014 - Bizagi

866

opcin en No hacer nada.

As es como se comportar el Portal de Trabajo al dar clic en el botn:

Llevar a cabo una accin cuando se elimina un registro de una


Copyright 2014 - Bizagi

867

coleccin
Mediante el uso de las acciones tambin se puede realizar una accin cuando se elimina el registro de
una coleccin.
Ejemplo
En una Solicitud de compra del valor total de la compra se calcula con cada producto incluido en una
tabla.
Si el valor total es mayor de $1,000 entonces el control Total debe ser de color rojo. De lo contrario, el
control debe ser verde.
Dado que los productos se pueden borrar de la tabla, el control total se debe actualizar para reflejar
los cambios y recalcular el total.
1. Cree la accin.
En el diseador de Formas seleccione Acciones y Validaciones y aada una nueva accin.
2. Incluya la condicin. Haga clic en Agregar una condicin y seleccione el control de la tabla
Productos, el operador y el argumento de la siguiente manera.
Cuando los productos solicitados tienen una fila eliminada
Ejecutar regla (que calcula la estimacin del costo total)
Actualizar Total
3 . Defina la Accin Si No. En este caso, ninguna accin se ejecutar cuando la condicin NO se cumpla
por lo que debemos seleccionar la opcin No hacer nada.

Copyright 2014 - Bizagi

868

4. En el Portal de Trabajo llenar la tabla de Producto. hasta que el costo Total se vuelve rojo.

5. Seleccione una fila para su eliminacin.

6. Observe cmo el costo Total se actualiza tan pronto como se elimina la fila.

Copyright 2014 - Bizagi

869

Ejecutar acciones sobre colecciones


Las acciones se pueden definir para afectar colecciones. Usted puede afectar:
Las celdas de una tabla especfica.
Por ejemplo, cambiar el color de una celda de acuerdo a una condicin.
Toda la tabla.
Por ejemplo, esconder toda la tabla de acuerdo a una condicin.
Cuando tenga que afectar una celda especfica de una tabla, es necesario seleccionar una opcin
avanzada que permite definir el contexto. Esta opcin se encuentra en la parte superior de la accin y
que se denomina Aplicar a.
Esta se refiere al objetivo de la accin, siendo un control o cualquier coleccin incluida. Por lo tanto,
contiene todas las colecciones de la forma y una opcin llamada Forma (seleccionada por defecto).
Decimos que el contexto cambia cuando se selecciona una de las colecciones. La Accin creada con un
contexto diferente, se aplica completamente a la coleccin elegida.
Una vez el contexto es modificado al de una coleccin especfica, se aplicarn las siguientes
restricciones:
Solo los elementos (columnas) de la coleccin estarn disponibles para ser evaluados en
condiciones.
Las acciones podrn ejecutarse nicamente sobre elementos (columnas) de la coleccin
seleccionada.
Las acciones evaluarn cada fila de manera independiente.

Copyright 2014 - Bizagi

870

Usted no puede utilizar Acciones y Validaciones para manipular colecciones filtradas con el mismo
XPath.
Cuando se utilicen dos tablas filtradas, usted deber utilizar las expresiones de control (visible,
requerido, editable).
Ejemplo: Usar una accin para afectar el color de una celda
Ejemplo: Usar una accin mostrar u ocultar una tabla

Usar acciones para cambiar el color de una celda


Cuando usted necesita afectar una columna o celda de una tabla, tendr que cambiar el contexto.
Suponga que usted esta definiendo una forma para una actividad en un proceso de Solicitud de
Crdito. En la actividad de Registrar Solicitud, un analista de crdito ingresa la informacin relacionada
a una solicitud presentada por un Cliente.
Un Cliente puede solicitar varios productos en la misma solicitud. Cada uno de ellos posee un Monto
solicitado y, de acuerdo a su capacidad de pago y a un anlisis de riesgo, se define un Monto mximo
permitido.

Copyright 2014 - Bizagi

871

Si el Monto solicitado de un producto es menor al Monto mximo permitido para ese producto, la
celda del monto solicitado debera mostrarse con fondo verde, de lo contrario, debera mostrarse con
fondo rojo.
1. Construya la forma.
Observe que los productos solicitados se incluyen en una tabla denominada Productos. Incluya el
Nombre del producto, Monto Solicitado y Monto mximo como columnas de la tabla.

2. Cree la Accin.
En el diseador de Formas seleccione Acciones y Validaciones y agregue una nueva accin.

Copyright 2014 - Bizagi

872

3. Defina el contexto de la accin.


Para este caso la accin se evaluara y aplicar sobre elementos de la coleccin Productos , por lo que
se selecciona Productos en el campo Aplicar a.

Copyright 2014 - Bizagi

873

4. Incluya la condicin. D clic en Agregar una condicin y seleccione el control, operador y argumento
as:
Cundo Productos.MontoSolicitado es mayor a Productos.MontoMaximo .

Copyright 2014 - Bizagi

874

Observe que cuando se definen acciones a nivel de coleccin, los elementos de la coleccin (columnas)
se identifican por su nombre seguido de un punto (.) y el nombre del elemento (i,e
coleccin.nombre_de_la_columna).

Copyright 2014 - Bizagi

875

5. Incluya la Accin (Entonces). D clic en Agregar una accin y defina lo que pasar cuando se cumpla
la condicin.
Cambie color de fondo para Productos.MontoSolicitado a rojo.

Copyright 2014 - Bizagi

876

Observe de nuevo que estamos haciendo referencia a las columnas de la coleccin Productos.

Copyright 2014 - Bizagi

877

6. Defina la accin alterna (Si no), que se ejecutar cuando NO se cumpla la condicin.
Cambie color de fondo para Productos.MontoSolicitado a verde.

As se comportar el Portal de Trabajo de acuerdo a los valores ingresados:

Copyright 2014 - Bizagi

878

Usar acciones para mostrar u ocultar una coleccin


En este caso usted puede mostrar u ocultar una tabla de la misma manera que muestra u oculta
cualquier otro control en la Forma. No hay necesidad de cambiar el contexto.
Suponga que usted esta definiendo una forma para una actividad en un proceso de Solicitud de
Crdito. En la actividad de Registrar Solicitud, un analista de crdito ingresa la informacin relacionada
a una solicitud presentada por un Cliente.
Un Cliente puede solicitar varios productos en la misma solicitud. Cada uno de ellos posee un Monto
solicitado y, de acuerdo a su capacidad de pago y a un anlisis de riesgo, se define un Monto mximo
permitido.
Si la capacidad de pago del cliente es menor a 1000, no se podr solicitar ningn tipo de producto y
por lo tanto la tabla de Productos no debera mostrarse al usuario final.
Con el fin de mostrar u ocultar la tabla de Productos de acuerdo al valor ingresado en el campo de
Capacidad de pago, usted puede utilizar acciones.

1. Cree la Accin.
En el diseador de Formas seleccione Acciones y Validaciones y agregue una nueva accin.

Copyright 2014 - Bizagi

879

2. Usted no necesita cambiar el contexto de la Accin. En el campo Aplica a, mantenga la opcin


Forma.

Copyright 2014 - Bizagi

880

3. Incluya la condicin.
D clic en Agregar una condicin y seleccione el control, operador y argumento as:
Cundo Capacidad de Pago es menor a 1000.

Copyright 2014 - Bizagi

881

4. Incluya la Accin (Entonces). D clic en Agregar una accin y defina lo que pasar cuando se cumpla
la condicin.
En este caso, oculte la coleccin Productos.
Cambie la visibilidad para Productos a falso.
Observe que las colecciones son referenciadas de la misma manera que los atributos.

Copyright 2014 - Bizagi

882

5. Defina la accin alterna (Si no), que se ejecutar cuando no se cumpla la condicin.
Cambie la visibilidad para Fecha de Salida a verdadero.

Copyright 2014 - Bizagi

883

As se comportar el Portal de Trabajo de acuerdo a los valores ingresados:

Componentes de las Validaciones


Las validaciones muestran (lanzan) mensajes de validacin a los usuarios finales, cuando se cumple una
condicin especfica.
Para definir una validacin, vaya al Asistente de Acciones y Validaciones y d clic en el botn Agregar
dentro de la Pestaa de Validaciones:

Copyright 2014 - Bizagi

884

Las Validaciones se definen por dos componentes: La condicin y el mensaje de validacin.

Condiciones (Si)
D clic en Agregar una condicin. Se mostrar una nueva fila para ingresar la condicin.

Copyright 2014 - Bizagi

885

Una condicin se define 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.

Operador

Descripcin

Aplica a controles

cambia a

Evala si el valor de un control ha Combo,


Combo
cambiado a un valor especfico.
cascada, Lista, Radio,
Bsqueda,
Sugerencia, Moneda,
Nmero, Fecha

es diferente a

Evala si el valor de un control es Combo,


Combo
diferente a un valor especfico.
cascada, Lista, Radio,
Bsqueda,
Sugerencia, Moneda,
Nmero, Fecha

est vaco

Evala si el control est vaco.

Combo,
Combo
cascada, Lista, Radio,
Bsqueda,
Sugerencia, Moneda,
Nmero, Fecha

no est vaco

Evala si el control no est vaco.

Combo,
Combo
cascada, Lista, Radio,
Bsqueda,
Sugerencia, Moneda,
Nmero, Fecha

cambia

Evala si el valor de un control ha Combo,


Combo
cambiado.
cascada, Lista, Radio,
Bsqueda,

Copyright 2014 - Bizagi

886

Sugerencia, Moneda,
Nmero,
Fecha,
Archivo
no contiene

Evala si el valor de un control no Cuadro de texto


contiene un caracter especfico.

contiene

Evala si el valor de un control Cuadro de texto


contiene un caracter especfico.

comienza con

Evala si el valor de un control Cuadro de texto


inicia con un caracter especfico.

no comienza con

Evala si el valor de un control no Cuadro de texto


comienza
con
un
caracter
especfico.

es
un
correo Evala si el valor de un control es Cuadro de texto
electrnico invlido un correo electrnico invlido.
menor que

Evala si el valor de un control es Fecha,


menor que un valor especfico.
Nmero

Moneda,

menor o igual

Evala si el valor de un control es Fecha,


menor o igual que un valor Nmero
especfico.

Moneda,

mayor que

Evala si el valor de un control es Fecha,


mayor que un valor especfico.
Nmero

Moneda,

mayor o igual que

Evala si el valor de un control es Fecha,


mayor o igual que un valor Nmero
especfico.

Moneda,

ha eliminado
registro

un Evala si se ha eliminado un Tabla


registro en una tabla.

clic

Evala si se ha hecho clic en un Botn


botn.

es verdadero

Evala si el valor de un control es Booleano


igual a verdadero.

es falso

Evala si el valor de un control es Booleano


igual a falso.

ha cargado
archivo

un Evala si un control de tipo Archivo


archivo tiene un archivo cargado.

no ha cargado un Evala si un control de tipo Archivo


archivo
archivo
no
posee
archivos
cargados.

Copyright 2014 - Bizagi

887

Argumento: Define el valor a ser comparado con el control. Este valor puede ser una constante o
un XPath.
Usted puede crear condiciones compuestas conectadas por Y/O.
Para crear una condicin compuesta conectada por Y, d clic en Agregar una condicin.
Para crear una condicin compuesta conectada por O, d clic en Agregar un grupo de condicin.

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.
D clic aqu para ver ejemplos de cmo configurar validaciones bsicas

Validaciones bsicas
En el siguiente ejemplo mostraremos cmo configurar una accin bsica:
En un Proceso de Solicitud de Vacaciones deseamos mostrar un mensaje de validacin, cuando la
Fecha de salida sea mayor a la Fecha de regreso (lo cual no hace sentido).

Copyright 2014 - Bizagi

888

1. Cree la validacin.
En el diseador de Formas seleccione Acciones y Validaciones y agregue una nueva Validacin.

2. Incluya la condicin.
D clic en Agregar una condicin y seleccione el control, operador y argumento as:
Si Fecha de Salida Mayor que Fecha de regreso.

Copyright 2014 - Bizagi

889

3. Ingrese el mensaje de validacin que se mostrar al cumplirse la condicin.

Copyright 2014 - Bizagi

890

As es como la validacin se mostrar en el Portal de Trabajo, cuando se cumpla la condicin.

Validaciones sobre colecciones


Usted puede definir validaciones a nivel de coleccin para evaluar condiciones sobre las celdas de una
tabla especfica.
El siguiente ejemplo clarificar este concepto.
Suponga que usted esta definiendo una forma para una actividad en un proceso de Solicitud de
Crdito. En la actividad de Registrar Solicitud, un analista de crdito ingresa la informacin relacionada
a una solicitud presentada por un Cliente.
Un Cliente puede solicitar varios productos en la misma solicitud. Cada uno de ellos posee un Monto
solicitado y, de acuerdo a su capacidad de pago y a un anlisis de riesgo, se define un Monto
mximo permitido.
Si cualquiera de los productos posee un monto solicitado mayor que su monto mximo permitido, se
debe 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. Cree la validacin.
En el diseador de Formas seleccione Acciones y Validaciones y agregue una nueva Validacin.

Copyright 2014 - Bizagi

891

2. Incluya la condicin.
D clic en Agregar una condicin y seleccione el control, operador y argumento as:
Si Productos.Monto solicitado Mayor que Productos.Monto mximo.

Si se definen validaciones a nivel de coleccin, los elementos (columnas) de la coleccin se identifican


por el nombre de la coleccin seguido de un punto (.) y el nombre del elemento. (p.e
Coleccin.nombre)
3. Ingrese el mensaje de validacin que se mostrar al cumplirse la condicin.

Copyright 2014 - Bizagi

892

Condiciones compuestas 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
grupos de condiciones.

Usar conectores Y/O para condiciones anidadas


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 Acciones y Validaciones cuando se define ms de una condicin.

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.
Si el solicitante tiene 25 aos o menos y el monto que solicita es menor a US$ 3000, el crdito se
aprobar; de lo contrario, se requerirn anlisis posteriores.
La edad del solicitante se almacena en el atributo Edad del Solicitante.
La decisin de aprobacin inmediata se almacena en un atributo booleano llamado Crdito
Aprobado.

Copyright 2014 - Bizagi

893

Necesitamos entonces definir una accin que establezca el valor apropiado para el atributo Crdito
Aprobado (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 Acciones y
Validaciones ubicado en el Ribbon.
Agregue una nueva condicin dando clic en el botn Agregar.

2. D clic en el botn Agregar Condicin y defina la primera condicin relacionada a la edad del
solicitante:

3. Agregue la segunda condicin relacionada al valor del monto solicitado. Observe que se han
habilitado los operadores lgicos.

Copyright 2014 - Bizagi

894

4. Cambie el conector a Y para definir la inclusin de las condiciones compuesta. p.e especificar que se
deben cumplir ambas condiciones.

5. En el cuadro Entonces defina una accin para ejecutarse cuando se cumpla la condicin, es decir,
asigne VERDADERO al control Crdito Aprobado.

6. En el cuadro Si no, seleccione Realice las siguientes acciones en la lista desplegable.

Copyright 2014 - Bizagi

895

7. Defina una accin para asignar FALSO al control Crdito Aprobado.

8. D clic en Ok 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
Los Grupos de condiciones se definen dando clic en el botn Agregar una grupo de condiciones (que
se encuentra en el cuadro Cundo para acciones y el cuadro Si para validaciones).

Copyright 2014 - Bizagi

896

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.
Si el solicitante tiene 60 aos o ms y el monto solicitado es menor a US$ 6000, el crdito ser
aprobado de forma inmediata.
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 Acciones y
Validaciones ubicado en el Ribbon.
Agregue una nueva accin dando clic en el botn Agregar.

Copyright 2014 - Bizagi

897

2. D clic en Agregar un grupo de condiciones.

3. Dentro del bloque defina las dos condiciones relacionadas a la poltica para solicitantes jvenes:

Copyright 2014 - Bizagi

898

4. Ahora d clic en el botn Agregar un grupo de condiciones para aadir un nuevo bloque de
condiciones.

5. En el segundo bloque, defina las dos condiciones para los solicitantes mayores de 60 aos. Primero,
agregue la condicin para evaluar la edad del solicitante.

6. Despus agregue otra condicin para evaluar valor del monto solicitado:

Copyright 2014 - Bizagi

899

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 Crdito Aprobado.

9. En el cuadro Si no seleccione Realice las siguientes acciones bajo las opciones de la lista
desplegable.

Copyright 2014 - Bizagi

900

10. En el cuadro Entonces defina una accin para asignar FALSO al control Crdito Aprobado.

11. D clic en Ok para conservar los cambios y luego guarde la forma.

Botones de forma
Por defecto, Bizagi muestra dos botones en el pie de pgina de todas las actividades; estos botones
son Guardar y Siguiente.
Los Botones de forma son una funcionalidad que permite a los usuarios personalizar estos botones
predefinidos y agregar unos nuevos.
Estos botones pueden ejecutar reglas de negocio, validar datos, guardar la forma y avanzar entre
actividades.
Usted puede definir el comportamiento de acuerdo a sus necesidades. As mismo, puede personalizar
la apariencia de estos botones (texto, color) para brindar interfaces de usuario amigables en cualquier
dispositivo.

Copyright 2014 - Bizagi

901

Cmo crear un Botn de forma


1. Vaya a la forma donde necesite crear el botn y habilite la opcin Botones de la forma, que se
encuentra en el Ribbon.

2. Aparecer un nuevo panel en la parte inferior de la forma.

Copyright 2014 - Bizagi

902

3. D clic en el icono Agregar para incluir un nuevo botn.

4. D clic en el nuevo botn para mostrar sus propiedades.

Copyright 2014 - Bizagi

903

5. Defina las propiedades requeridas de acuerdo a su necesidad. Las propiedades disponibles se


muestran en la siguiente tabla:

Copyright 2014 - Bizagi

904

PROPIEDAD

DESCRIPCIN

Etiqueta del botn

El texto ingresado en la etiqueta del botn aparecer dentro del botn.

Ejecucin del botn

Define el comportamiento asociado al botn::


Regla: Expresin de script asociada al botn. Cuando el usuario da clic
sobre el botn, la expresin se ejecuta.
Interfaz: Interfaz asociada al botn. Cuando el usuario da clic sobre el
botn, la interfaz se ejecuta.
Ninguno: No ejecuta ningn comportamiento.

Acciones

Define la accin asociada al botn:


Ninguna: No ejecuta ninguna accin.
Guardar datos: Guarda la informacin ingresada en la forma.
Se ejecutan las reglas definidas al Guardar.
Esta accin no valida la informacin ingresada en la forma.
Validar: Verifica que la informacin ingresada sea correcta (controles
requeridos, valores mnimo y mximo y Acciones & Validaciones).
Esta accin no ejecuta las validaciones de tabla.
Esta accin no guarda la forma.
Siguiente: Avanza el caso a la siguiente actividad. Esta accin guarda y
valida la informacin antes de proceder con el caso.
o Se ejecutan las reglas definidas al Salir.
o No se ejecutan las reglas definidas al Guardar.
o Valida los controles requeridos, mnimos, mximos, Acciones &
Validaciones y corre las validaciones de tabla.

Visible

Define la visibilidad del botn. Esta tambin puede ser determinada por una
expresin.

Formato

Define el tamao de letra, color y fondo del botn.

Usted puede combinar entre Ejecucin de botn y Acciones como lo desee.


Por ejemplo, usted puede ejecutar una expresin y ejecutar Siguiente. En este caso, con un solo clic en
el botn se ejecutar una regla y luego el caso continuar.
Si usted solo requiere una Accin, deje Ejecucin de botn en Ninguno.
Si usted solo requiere una ejecucin en el botn, deje Accin en Ninguno.

Cmo editar un Botn de forma


1. Vaya a la forma donde se encuentra el botn a editar. Habilite la opcin Botones de la forma, que se

Copyright 2014 - Bizagi

905

encuentra en el Ribbon.

2. Aparecer un nuevo panel en la parte inferior de la forma. D clic en el botn a editar para mostrar
sus propiedades.

3. Cambie las propiedades del botn segn lo requiera.

Cmo eliminar un botn


1. Vaya a la forma donde se encuentra el botn a eliminar. Habilite la opcin Botones de la forma, que
se encuentra en el Ribbon.

Copyright 2014 - Bizagi

906

2. Aparecer un nuevo panel en la parte inferior de la forma. D clic en el botn a eliminar.

3. D clic en el icono de Eliminar (que aparecer en la esquina superior derecha del botn) para
eliminarlo.

Ejemplo

Copyright 2014 - Bizagi

907

En un proceso de Solicitud de vacaciones, el jefe de la persona que solicita las vacaciones debe
aprobar la solicitud. El jefe debera poder aprobar o rechazar la solicitud simplemente dando clic en
un botn.
Para cumplir este requerimiento se utilizan Botones personalizados. Siga los pasos descritos a
continuacin para crearlos:
1. Vaya a la forma de la actividad Aprobar vacaciones y habilite la opcin Botones de forma que se
encuentra en el ribbon.

2. En el panel que se muestra en la parte inferior de la forma, d clic en el botn Agregar para incluir
un nuevo botn.

Copyright 2014 - Bizagi

908

3. D clic en el nuevo botn. En las propiedades defina lo siguiente:


Etiqueta del botn: "Aprobar"- Este botn se utilizar para aprobar la solicitud.
Ejecucin del botn: Regla - Una vez se da clic en el botn, este ejecutar una regla para identificar
la solicitud como aprobada.
Accin: Siguiente - Una vez se da clic en el botn, el caso avanzar a la siguiente actividad.

4. Ahora defina la regla asociada a la ejecucin del botn, dando clic en el icono de expresin.

Copyright 2014 - Bizagi

909

5. Para identificar si la solicitud es aprobada o rechazada, el proceso utiliza un atributo booleano


denominado Aprobado. Si el valor de este atributo es VERDADERO, la solicitud es aprobada. De lo
contrario es rechazada.
Este botn aprobar la solicitud. Cree un elemento de asignacin para asignar VERDADERO al atributo
Aprobado.

Copyright 2014 - Bizagi

910

6. Repita los pasos 2-5 para crear un nuevo botn denominado Rechazar. En la expresin asigne el
valor FALSO al atributo.

Copyright 2014 - Bizagi

911

7. Finalmente elimine los botones Guardar y Siguiente. Seleccione el botn y luego d clic en el icono
de eliminar.

En el Portal de Trabajo se mostrarn los nuevos botones y las acciones configuradas se ejecutarn al
dar clic sobre ellos.

Copyright 2014 - Bizagi

912

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 2014 - Bizagi

913

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 cambio de contexto. 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
de coleccin.

Copyright 2014 - Bizagi

914

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 contienen 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 2014 - Bizagi

915

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 reutilizables se incluyen dentro de una Forma, se muestran resaltadas con una
Forma Anidada.
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.

Copyright 2014 - Bizagi

916

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 2014 - Bizagi

917

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.

Copyright 2014 - Bizagi

918

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 2014 - Bizagi

919

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.

Copyright 2014 - Bizagi

920

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 2014 - Bizagi

921

Copyright 2014 - Bizagi

922

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 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 Trabajar en el caso si tienen tareas pendientes. Estas formas pueden ser
reutilizadas a lo largo del proyecto.

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.

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.
Estas formas son Formas de Entidad, tambin conocidas como Formas Reusables, debido a que no

Copyright 2014 - Bizagi

923

son creadas directamente en el Proceso sino en la entidad que contiene su informacin, es decir, en la
entidad de contexto.

Tenga en cuenta los siguientes conceptos relacionados a las Formas de Entidad:


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 reutilizable, tenga en cuenta que usted tiene que crearla en la
opcin Formas 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 reutilizable, hay dos maneras de hacerlo:
Directamente desde la primera forma donde usted desea utilizarla.
Desde la entidad.

Crear una Forma de Entidad (o Forma Reutilizable) 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 reutilizable. 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 reutilizable estn almacenados
en la Entidad de Proceso.
1. Ubique el icono Formas Reusables en el diseador de Formas, bajo la entidad.
D clic en Nueva forma

Copyright 2014 - Bizagi

924

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 2014 - Bizagi

925

4. Regrese a la forma de la actividad, arrastre y suelte la nueva forma para ser reutilizada.

Copyright 2014 - Bizagi

926

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 Editar en la parte inferior
izquierda.

Copyright 2014 - Bizagi

927

Crear una Forma de entidad (o Forma Reutilizable) 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 reutilizable. 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 reutilizable estn almacenados
en la Entidad de Proceso.
1. Vaya a la vista de Mdulos y abra el mdulo de Entidades. Ubique la entidad de contexto y d clic
derecho sobre la opcin Formas. Seleccione Nueva forma

Copyright 2014 - Bizagi

928

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 2014 - Bizagi

929

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 Editar en la parte inferior.

Copyright 2014 - Bizagi

930

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 formas
requeridas 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 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.

Copyright 2014 - Bizagi

931

La funcionalidad del Diseador de Formas se ejecuta actualmente en dos ambientes de diseo. El


ambiente de diseo tradicional es eficaz para las siguientes formas: Formas Administrables, Formas
de Consulta y Formas Globales y de Resumen. Las formas de Actividades y de Entidades ya han sido
migradas al nuevo ambiente de diseo. Todas las formas sern diseadas en el nuevo ambiente del
Diseador de Formas desde la versin 9.

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 Administrables, vaya el mdulo Entidades en Bizagi Studio. D clic derecho
sobre la entidad paramtrica de inters y seleccione la opcin Propiedades Avanzadas.

Copyright 2014 - Bizagi

932

2. Modifique cualquiera de las Formas 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 Administrable debe estar habilitada. Tenga cuidado de no alterar esta
configuracin despus de que su forma ha sido configurada, de lo contrario, la forma no puede ser
usada para administrar actividades en el Portal de Trabajo.

Copyright 2014 - Bizagi

933

Una vez que la forma por defecto se personaliza, se habilitar el botn de Desvincular 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

Descripcin

Nombre

Nombre de la Ciudad.

Estado

Entidad Paramtrica que contiene el nombre del


Estado al cual pertenece la ciudad.

Copyright 2014 - Bizagi

934

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 (Nombre, Estado, Pas).
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 Ciudad y
seleccione la opcin de Propiedades Avanzadas.

Copyright 2014 - Bizagi

935

2. Para configurar el comportamiento deseado en la Forma de Adicin, d clic en el botn Editar 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.

Copyright 2014 - Bizagi

936

Para este caso configure un filtro para el control Estado. D clic en el control, vaya a las opciones de
Entidad Relacionada 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
Pas.

Copyright 2014 - Bizagi

937

D clic en OK para mantener los cambios y luego cerrar la forma.


4. Repita el mismo procedimiento para la Forma de Edicin.
5. Vaya al Portal de Trabajo y pruebe los controles.

Copyright 2014 - Bizagi

938

Artculos relacionados
Valores de Entidades paramtricas en el Portal de Trabajo

Formas de consulta

Resumen
Bizagi permite la definicin y personalizacin de Formas especiales (reportes) para consultar la
informacin relacionada a los casos. Estas formas se denominan Consultas. 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 no relacionada a
casos en particular sino directamente a su comportamiento, es decir, informacin de negocio. Por
ejemplo, en un proceso de ventas al por menor, la compaa desea realizar bsquedas sobre sus
clientes. Quisieran buscar las edades y gneros desde sus clientes nuevo y existentes.
Para definir una Consulta usted debe utilizar las Formas de Consulta. 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 los criterios de bsqueda.
Se pueden disear dos tipos de consultas en Bizagi Studio:
Consultas de Aplicacin (Proceso)

Copyright 2014 - Bizagi

939

Permiten consultar casos en Bizagi. Para esto, la consulta utiliza 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.)
Consultas de Entidad
Permite consultar informacin asociada a Entidades. Para esto, la consulta utiliza la Entidad definida
como la Entidad de Contexto.
Las 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 Consulta cuando la propiedad de Es Forma de
Consulta se activa. Esto habilitar todas las propiedades especiales y comportamientos de una Forma
de Consulta.

Las Formas de Consulta estarn disponibles en el Modelador de Formas de la V.9.

Copyright 2014 - Bizagi

940

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 Usuarios a incluir. 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.

Copyright 2014 - Bizagi

941

Propiedades de control en las Formas de Consulta


Algunas caractersticas especiales para algunos controles se habilitarn, 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.
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 %
Wilson

Copyright 2014 - Bizagi

942

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 (Desde) o superior (Hasta). 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.

Copyright 2014 - Bizagi

943

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
acentos ni espacios.
Nombre de Mostrar: Es el nombre de mostrar de la Forma de Consulta. Debe comenzar con una
letra mayscula y puede contener acentos y espacios.
Descripcin: Describe la Forma para brindar ms claridad sobre ella.
Texto de Ayuda: El texto de ayuda aparece cuando usted da clic en un control de la forma en el
Portal de Trabajo.

Copyright 2014 - Bizagi

944

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.

Copyright 2014 - Bizagi

945

La Entidad de Contexto de la Forma ser la Entidad de Aplicacin o la Entidad especfica dependiendo


del tipo de Consulta que se est 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.

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 2014 - Bizagi

946

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 Entidad de Aplicacin, d clic derecho en la opcin Consultas y luego seleccione Nueva
Consulta. Alternativamente, esta opcin se encuentra en el Men contextual.

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 2014 - Bizagi

947

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 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 consulta.

Copyright 2014 - Bizagi

948

Finalmente d clic en Finalizar.

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 Procesos, vaya a el Proceso al cual se asociarn las Consultas. D clic derecho sobre
l y seleccione la opcin Mostrar Consultas Relacionadas.

Copyright 2014 - Bizagi

949

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 2014 - Bizagi

950

3. Una vez definidas, seleccione las consultas que se asociarn al Proceso y luego d clic en OK.

Copyright 2014 - Bizagi

951

Cmo Editar una Forma de Consulta de Aplicacin


1. En el men de Bizagi, d clic en el mdulo de Entidades y seleccione la Entidad de Aplicacin donde
se cre la consulta. D clic en la opcin Consultas.
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 Propiedades o puede dando doble clic sobre
ella. El asistente de Formas de Consulta se mostrar.

D clic en el botn Editar para abrir el Modelador de Formas y modificar los controles y propiedades
necesarias de la forma.

Copyright 2014 - Bizagi

952

Cmo eliminar una Forma de Consulta de Aplicacin


1. En el men de Bizagi, d clic en el mdulo de Entidades y seleccione la Entidad de Aplicacin donde
se cre la consulta. D clic en la opcin Consultas.
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 Borrar.

2. Seleccione S en la ventana de confirmacin de eliminacin. Usted podr llevar a cabo un anlisis de

Copyright 2014 - Bizagi

953

dependencias si lo desea. Si la forma de consulta no posee dependencias podr eliminarla


efectivamente.

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 Forma de Consulta 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.

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 Interno en el Tipo de Campo dentro de las propiedades de Informacin Bsica del
cuadro de texto.

Copyright 2014 - Bizagi

954

3. Seleccione el tipo de campo interno en la propiedad de Campo Interno.

4. Finalmente asigne un nombre de mostrar al cuadro de texto.

Copyright 2014 - Bizagi

955

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

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.

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
contrario).

Copyright 2014 - Bizagi

Incluir el
resultado de
las consultas

956

Nombre de
campo Interno

Descripcin

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.

Estado del Caso


(Case State)

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:

Incluir el
resultado de
las consultas

NO

Casos Cerrados
Casos Anulados
Casos con actividades pendientes, estado de la
actividad
Verde: A tiempo.
Amarillo: En Riesgo.
Rojo: Vencido.
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
Fecha de
configura en la pestaa Forma de Consulta (Query
Creacin del Caso Form).
(Case Radication
Date)
Para incluir la consulta por los criterios Desde y
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


solucin del caso. La consulta por este criterio
puede ser desde, hasta o Ninguna (exacta), esto se
Fecha de
configura en la pestaa Forma de Consulta (Query
Solucin del Caso Form).
(Case Solution
Date)
Para incluir la consulta por los criterios Desde y
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.

Permite hacer una bsqueda por el Nombre


Completo Usuario que cre el caso. En la forma de
consulta se presenta un atributo tipo Buscador

Creador del Caso


(Creator)

Copyright 2014 - Bizagi

957

Nombre de
campo Interno

Descripcin

Incluir el
resultado de
las consultas

Ventana que permite realizar una bsqueda


aproximada del usuario por el Nombre completo.

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.

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.

Cargo del
Creador (Creator
- Position)

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.
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.

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

Copyright 2014 - Bizagi

958

Nombre de
campo Interno

Descripcin

Incluir el
resultado de
las consultas

usuario por el Nombre completo.


Nombre
completo del
usuario
encargado
(Current User Full Name)

Nombre de
usuario del
usuario
encargado
(Current User Username)

Cargo del
usuario
encargado
(Current User Position)

Actividad
realizada
(Previous Task)

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.
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.

NO

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.

NO

Nombre
completo de
encargado
anterior

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

NO

Copyright 2014 - Bizagi

959

Nombre de
campo Interno

Descripcin

Incluir el
resultado de
las consultas

la pestaa Forma de Consulta (Query Form).


(Previous User Full Name)

Nombre de
usuario de
encargado
anterior
(Previous User
Username)

Cargo de
encargado
anterior
(Previous User Position)

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).

NO

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).

NO

En la forma de consulta se presenta un atributo tipo


texto.

Proceso
(Process)

Permite buscar todos los casos que pertenecen a un


proceso determinado.
En la forma de consulta se presenta un atributo tipo
combo con un listado de todos los procesos del
proyecto.

Fecha de
creacin de la
actividad (Task
Entry Date)

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).
Para incluir la consulta por los criterios Desde y
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.

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 consulta por los criterios Desde y
hasta, se debe incluir en la forma de consulta dos
veces el mismo campo y a uno seleccionar la opcin

Copyright 2014 - Bizagi

960

Nombre de
campo Interno

Descripcin

Incluir el
resultado de
las consultas

desde y al otro la opcin hasta.

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

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 Entidades e identifique la Entidad para la cul se definir la consulta. D clic
derecho en la opcin Consultas y luego seleccione Nueva Consulta.

Copyright 2014 - Bizagi

961

2. El asistente de Formas de Consulta se abrir. Llene lo campos requeridos y asocie una forma
existente o cree una nueva, segn lo requiera.

Observe, al momento de crear una Nueva Forma, que la Entidad de Contexto es la Entidad especfica.

Copyright 2014 - Bizagi

962

Finalmente d clic en Finalizar.

Cmo Editar una Forma de Consulta de Entidad


1. D clic en el mdulo de Entidades y seleccione la Entidad donde se cre la consulta. D clic en la
opcin Consultas.
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 Propiedades o d doble clic sobre ella. El
asistente de Formas de Consulta se mostrar.

Copyright 2014 - Bizagi

963

D clic en el botn Editar para abrir el Modelador de Formas y modificar los controles y propiedades
necesarias de la forma.

Cmo eliminar una Forma de Consulta de Entidad


Copyright 2014 - Bizagi

964

1. En el men de Bizagi, d clic en el mdulo de Entidades y seleccione la Entidad donde se cre la


consulta. D clic en la opcin Consultas.
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 Borrar.

2. Seleccione S 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.

Formas globales y de resumen

Introduccin
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 2014 - Bizagi

965

Crear y Asociar una Forma Global


1. En la vista de mdulos vaya a Entidades y d clic en la Entidad de Aplicacin a la cual pertenece el
Proceso,
D clic derecho en la opcin Formas y seleccione Nueva Forma. 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 Procesos identifique el Proceso y versin a la cual se configurar la Forma Global.
D clic derecho sobre la opcin Versin y luego en Propiedades.

Copyright 2014 - Bizagi

966

4. En la nueva ventana, habilite la opcin Utilizar Forma Global y seleccione la forma creada
anteriormente en la lista desplegable.

Copyright 2014 - Bizagi

967

Tenga en cuenta 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 Ver ( ) que se encuentra al lado de un caso
especfico desde el Portal de Trabajo.

Copyright 2014 - Bizagi

968

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 Entidades y d clic en la Entidad de Aplicacin a la cual pertenece el
Proceso,
D clic derecho en la opcin Formas y seleccione Nueva Forma. Usted tambin puede copiar una que
ya haya sido creada a travs la opcin Autogenerar.

Copyright 2014 - Bizagi

969

2. En el mdulo de Procesos identifique el Proceso y versin a la cual se configurar la Forma de


Resumen. D clic derecho sobre la opcin Versin y luego en Propiedades.

3. En la nueva ventana, habilite la opcin Utilizar Forma de Resumen y seleccione la forma creada
anteriormente en la lista desplegable.

Copyright 2014 - Bizagi

970

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.

Formas Globales y de Resumen en produccin


Para garantizar el correcto desempeo de todos los ambientes, una vez hecho el deployment, las
Formas Globales y de Resumen no se podrn editar o eliminar. Si se necesitan nuevas formas, los
usuarios pueden crear nuevas versiones de los procesos y asociar las nuevas formas a estas.

Guardar una Forma


Cuando se realizan cambios a una forma, estos pueden guardarse de dos maneras:
Dando clic en el icono Guardar que se encuentra en el Ribbon del Diseador de Formas.

Copyright 2014 - Bizagi

971

Cerrando la Forma. Esta accin guardar automticamente 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 Guardar, se mostrar el siguiente mensaje:

S: la forma se guardar ignorando los errores existentes.


NO: la forma no se guardar y todos los errores se resaltarn de manera que usted pueda
identificarlos y corregirlos.
En caso de que la Forma se guarde cerrndola, se mostrar el siguiente mensaje:

Copyright 2014 - Bizagi

972

S: la forma e guardar ignorando los errores existentes.


NO: la forma no se cerrar sin guardar los cambios.
CANCELAR: 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 va para resolverlos, se
describen a continuacin:
Mensaje de error: Hay ms de un atributo con XPath {NombredelXpath}. Usted puede tener solo
un atributo editable por XPath, por favor ajstelo.
Razn del error: Cuando dos o ms atributos editables, con el mismo mapeo al modelo de datos, se
han incluido en la forma.
Cmo resolverlo: Elimine el atributo duplicado o deje solo uno de ellos como editable.
Ejemplo del error:

Copyright 2014 - Bizagi

973

Mensaje de error: El contenedor no posee elementos. Incluya al menos una.


Razn del error: Cuando usted ha insertado un grupo o pestaa dentro de la Forma pero no ha
incluido elementos dentro de l.
Cmo resolverlo: Inserte al menos un Control en el contenedor.
Ejemplo del error:

Mensaje de error: La tabla no posee columnas. Incluya al menos una.


Razn del error: Cuando usted ha insertado una Tabla en la forma perno no ha definido columna
alguna en ella.
Cmo resolverlo: D clic en el botn Editar Columnas e incluya al menos una columna (atributo de la

Copyright 2014 - Bizagi

974

tabla) para mostrar.


Ejemplo del error:

Mensaje del error: La propiedad de Forma de Adicin es requerida.


Razn del error: Cuando usted ha insertado una Tabla en la forma, las propiedad Permitir Adicin
esta habilitada, Edicin En lnea deshabilitada y no se ha definido una nueva Forma de Adicin.
Cmo resolverlo: Asocie una Forma de Adicin para llevar a cabo los ajustes de la adicin actual o
active la propiedad de Permitir Adicin (habilitar) o desactive la propiedad de Permitir Adicin
(deshabilitar).

Copyright 2014 - Bizagi

975

Ejemplo del error:

Ejemplo de solucin: Asocie una Forma de Adicin.

Ejemplo de solucin: Para desactivar la propiedad Permitir Adicin o activar la propiedad Adicin En
lnea, vaya a la pestaa Avanzado y d clic en la propiedad para cambiar su valor a S o No segn
corresponda.

Copyright 2014 - Bizagi

976

Mensaje del error: Revise las propiedades


Razn del error: Cuando usted cre una Forma pero no asigno un Nombre de Mostrar.
Cmo resolverlo: Vaya a las Propiedades de la Forma y escriba un nombre en el campo Mostrar
Nombre.
Ejemplo del error:

Mensaje del error: 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.

Copyright 2014 - Bizagi

977

Razn del error: Cuando usted inserta un control de lista desplegable en cascada en la forma y 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.
Cmo resolverlo: 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.
Ejemplo del error:

Mensaje del error: 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.
Razn del error: Cuando usted 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.
Cmo resolverlo: 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.
Ejemplo del error:

Copyright 2014 - Bizagi

978

Usar la opcin Copiar Desde


Bizagi provee su funcionalidad Copiar Desde para acelerar el desarrollo de formas.
Esta funcionalidad le permite crear rpida y fcilmente una forma duplicando un diseo existente
creado previamente.
El contexto de Copiar Desde est definido por la forma desde donde se invoca, es decir, cuando se
llama a la funcin en una Forma de Proceso, se mostrar un listado de todas las formas de Actividad
asociadas al proceso actual.
Tenga en cuenta que la funcin Copiar Desde ANEXAR la informacin al PUNTO donde este copiando.
Por lo tanto, si usted ya tiene controles creados y utiliza esta opcin, la informacin copiada aparecer
en la parte inferior de la forma (despus de los Controles).

Ejemplo
Un Proceso de Solicitud de Vacaciones ha sido diseado en el Diseador de Formas. En la primera
actividad, Registrar solicitud de licencia, el usuario solicita su licencia.

La segunda actividad, Aprobar solicitud de licencia, el jefe del empleado aprueba o rechaza la
solicitud. Est actividad tendr la misma informacin que la primera actividad pero en modo de solo
lectura y adicionalmente se incluirn otros controles.

Copyright 2014 - Bizagi

979

Seleccione la opcin Copiar Desde en el Diseador de Formas. Una nueva ventana mostrar el flujo de
Proceso. D clic sobre la actividad Registrar Solicitud de Vacaciones para seleccionarla. Observe que
el contexto es el Proceso. Luego d clic en Ok.
La informacin se copia exactamente como la forma original. Uno a uno, usted puede configurar cada
uno de los controles en la forma (Fecha de Inicio, Fecha de Fin y Das Laborales solicitados) como de
solo lectura, configurando las propiedad Editable en Falso.

Ahora agregue los nuevos controles cuando se haya ejecutado la opcin Copiar Desde.

Copyright 2014 - Bizagi

980

Cuando la forma este completa, gurdela y cirrela.

Seguridad de Formas: check-in / check-out


Para evitar que los usuarios sobrescriban cambios realizados en una sola Forma, Bizagi ofrece una
funcionalidad de Check-in / Check-out.
Tan pronto como se abre una Forma sta se bloquea automticamente para otros usuarios.
Por lo tanto, el primer usuario que abre una Forma tiene permisos sobre ella para realizar cambios, y
el check-out se hace de manera automtica. Si alguien abre la misma forma mientras est bloqueada
se mostrar un mensaje informando quin la tiene, y se abrir de slo lectura, como se muestra a
continuacin.

Copyright 2014 - Bizagi

981

Cuando la Forma es de slo lectura (alguien ms ha hecho check-out), podr navegar nicamente el
modelo de datos.
En modo check-out las pestaas, las Propiedades, las formas anidadas, las tablas, los enlaces NO se
habilitarn.

Check-in o habilitar para edicin


Si el usuario que tiene la Forma bloqueado la cierra, se har check-in automticamente.
La Forma tiene un botn de Check-out en el Ribbon que permite desbloquearla sin cerrarla. Cuando el
usuario que tiene el formulario bloqueado lo cierra, haga clic en el botn Check-out y estar habilitado
para editar. El formulario mostrar los ltimos cambios realizados.

Copyright 2014 - Bizagi

982

Si la Forma NO se ha cerrado entonces el mensaje de bloqueo se mostrar de nuevo.

Definicin de Reglas de Negocio


Los procesos de negocio se rigen por reglas que garantizan una adecuada ejecucin de acuerdo a las
estrategias, objetivos y filosofa de la organizacin; Las reglas de negocio establecen los
procedimientos que deben ser ejecutados y las condiciones que deben ser evaluadas y controladas en
el flujo de Proceso.
Una iniciativa de automatizacin de Procesos brinda a las organizaciones la posibilidad de ceder la
evaluacin y ejecucin de estas reglas de negocio a Bizagi, permitiendo que las personas concentren
sus esfuerzos en las cosas realmente importantes, reduciendo errores, tiempo y brindando agilidad a
los Procesos.
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.
En Bizagi usted puede definir reglas de negocio para:
Direccionar flujos de Proceso: Controlar el flujo de secuencia para definir el camino que debe
seguir el Proceso de acuerdo a condiciones de negocio especficas (e.g Si una solicitud de viaje fue
aprobada se debe proceder a hacer las reservas respectivas, de lo contrario, se debe notificar el
rechazo).
Realizar acciones en Actividades: Ejecutar los procedimientos necesarios al realizar una tarea, tales
como validaciones y clculos (e.g Cuando un empleado reporta los gastos incurridos en un viaje, el
valor total de estos debe ser calculado automticamente).

Copyright 2014 - Bizagi

983

Manipular interfaces de usuario: Hacer los controles de una forma visibles, requeridos o de solo
lectura, para evitar errores en la informacin ingresada en el proceso (e.g Si una solicitud de viaje es
rechazada, el control de comentarios de rechazo debe mostrarse en la forma, de lo contrario, debe
ocultarse).
Asignar usuarios: Definir las condiciones que un usuario debe cumplir para poder ser asignado a
una tarea. (e.g Si una queja se relaciona a facturacin, debe ser atendida por un agente de servicio
al cliente especializado en quejas de facturacin).

Reglas de negocio dinmicas


Las condiciones de negocio cambian constantemente. En Bizagi es posible adaptar las reglas a las
condiciones de negocio actuales en tiempo real.
Bizagi ofrece un conjunto de reglas de negocio que pueden ser administrados en ambiente de
produccin; los cambios a los parmetros de estas reglas son realizados por los usuarios finales y se
aplican de manera inmediata a los Procesos. Estas reglas de negocio se conocen como Polticas.
Las Polticas de negocio permiten:
Ejecutar una accin cuando se cumpla una condicin: Evaluar una o ms condiciones para definir
una accin a ejecutar (e.g En un proceso de solicitud de crdito, si el solicitante posee unos ingresos
mensuales menores a US500, la solicitud es rechazada).
Evaluar tablas de decisin: Evaluar una combinacin de condiciones de negocio para ejecutar una
accin (e.g En un proceso de solicitud de crdito, si el solicitante posee un puntaje en centrales de
riesgo mayor a 600, la evaluacin de crdito es igual a 100. Si esta entre 400 y 600, la evaluacin de
crdito es igual a 80).
Evaluar rboles de decisin: Evaluar condiciones que poseen orden jerrquico, para definir una
accin a ejecutar (e.g Si la informacin de un ticket de soporte est incompleta, el ticket debe
resolverse. Si la informacin est completa, se debe decidir si solicitar informacin adicional por
telfono o por correo electrnico. Si la informacin es solicitada por telfono, se debe realizar una
llamada. Si la informacin es solicitada por correo electrnico, este debe ser enviado).
Agrupar reglas de negocio: Agrupar reglas que tienen propsitos similares para ejecutarlas en
conjunto.

Copyright 2014 - Bizagi

984

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 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:

Copyright 2014 - Bizagi

985

<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
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.

Copyright 2014 - Bizagi

986

<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
solicitadas (cantidad) para cada producto relacionado con cada compra. La coleccin de variables
guardar la cantidad de cada producto solicitado para cada compra.

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, el cul, espera un valor de
Verdadero o Falso.

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

Copyright 2014 - Bizagi

987

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.
Dentro del filtro no use parntesis. Si necesita usar parntesis use la funcin Me.getXPath("")
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

<PurchaseRequest.Quotation[Selected = true]>

!=

No igual

<PurchaseRequest.Quotation[Selected != true]>

Copyright 2014 - Bizagi

988

>

Mayor que

<PurchaseRequest.ProductsRequestedforPurchase[TotalPrice
1000]>

>

<

Menor que

<PurchaseRequest.ProductsRequestedforPurchase[UnitPrice
1000]>

<

>=

Mayor o igual que

<PurchaseRequest.Quotation[QuotationDiscount >= 1000]>

<=

Menor o igual que

<PurchaseRequest.Quotation[DiscountPercentaje <= 0,1]>

AND

<PurchaseRequest.Quotation[QuotationDiscount >= 1000 AND


DiscountPercentaje <= 0.1]>

OR

<PurchaseRequest.Quotation[QuotationDiscount >= 1000 OR


DiscountPercentaje <= 0.1]>

Es verdadero
defecto)
!

Es falso

(por <PurchaseRequest.ProductsRequestedforPurchase[QuotationsRe
quested]>
<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[Discount = true].Selected> = true
Esta expresin asigna al atributo booleano seleccionado el valor de verdadero para todas las
cotizaciones que tienen un descuento.

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 +"]")

Para asignar valores, utilice la siguiente sintaxis:

Me.setXPath("xpath[filter " + variable

+"]", value)

Me.setXPath

Copyright 2014 - Bizagi

989

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.
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
+" ].Selected", true)

>

"+

MinimumPercentage

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 +"]")

Copyright 2014 - Bizagi

!=

true

OR

990

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 de 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 d 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 establecer 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 2014 - Bizagi

991

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 se 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.

Copyright 2014 - Bizagi

992

Elemento de expresiones

Introduccin
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

USO

Modelo de datos

Permite construir un XPath que utilice expresiones. Adicionalmente,


usted puede modificar el modelo de datos e incluir valores a las
entidades paramtricas.

Funciones

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.
Usted puede buscar funciones desde el buscador superior si
conoce la sintaxis de la funcin o parte de ella.
Para ms informacin de funciones vaya a Funciones XPath.

Reglas de Librera

Da acceso a las Reglas de Librera creadas para el proyecto.


Cuando se selecciona una Regla de Librera, Bizagi la resuelve y
muestra en la expresin el valor de retorno, los parmetros y sus
correspondientes tipos.
Para obtener ms informacin, consulte Reglas de Librera

Copyright 2014 - Bizagi

993

Vocabulario

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.

Variables

Permite acceso rpido para administrar variables, crear, modificar o


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.

Las funciones XPath, vocabularios y variables que sean seleccionadas sern incluidas donde se
encuentre el cursor.
Bizagi utiliza la funcionalidad Intellisense 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. Si desea revisarlo, por favor dirjase al

Copyright 2014 - Bizagi

994

Ejemplo del elemento Expresin.

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
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 Modelo
de Datos.

Copyright 2014 - Bizagi

995

Incluya el nmero de cotizaciones ingresadas utilizando la funcin Contar. La funcin la encuentra en la


categora Navegacin de Datos, en la opcin funciones, luego incluya el XPath en la opcin Modelo de
Datos.

Copyright 2014 - Bizagi

996

Cuando se incluye un XPath utilizando la opcin de Modelo de Datos, se incluyen corchetes de


diamante <>. RECUERDE BORRAR LOS CORCHETES CUANDO UTILICE UNA FUNCIN XPath.
Agregue un mensaje de validacin utilizando la funcin Throw Validation error de la categora
Validacin de Data.

Copyright 2014 - Bizagi

997

El cdigo final ser:


if (<PurchaseRequest.NumberOfQuotationsRequir> >
<count(PurchaseRequest.Quotation)>)
CHelper.ThrowValidationError("You need at least "+
<PurchaseRequest.NumberOfQuotationsRequir> +"quotations");

Funciones
XPath provee una serie de funciones que ayudan al rendimiento de clculos a travs de las colecciones
en una forma fcil e intuitiva.
Las funciones se encuentran en el Editor de funciones de las expressiones.

Funciones bsicas
FUNCIN

DESCRIPCIN

SINTAXIS

And

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.

Avg

Obtiene el promedio de los elementos de la <avg(XPath)>

Copyright 2014 - Bizagi

998

coleccin. El atributo para realizar el clculo debe


ser un numrico o moneda.
Count

Cuenta el nmero de elementos de una coleccin.

<count(XPath)>

Empty

Regresa verdadero cuando una coleccin no tiene <empty(XPath)>


elementos, falso de lo contrario.

Equals

Compara dos argumentos XPath y regresa true si <equals(XPath,XPath)>


son equivalentes. Los parmetros pueden ser
expresiones XPath o funciones XPath.

Exist

Retorna verdadero si la coleccin tiene al menos un <exists(XPath)>


elemento, de lo contrario retorna falso.

Greater than

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.

Greater than Compara dos argumentos XPath y retorna <greater-equalsor equals to


verdadero si el primero es mayor o igual que el than(XPath,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.

Is False

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.

Is not Empty

Retorna verdadero si el atributo de tipo string esta <is-not-empty(XPath)>


lleno. Retorna falso de lo contrario.

Is not Null

Retorna verdadero si algn atributo esta lleno (no <is-not-null(XPath)>


es nulo), de lo contrario retorna falso.

Is Null

Retorna verdadero si un atributo es nulo (no lleno), <is-null(XPath)>


de lo contrario retorna falso.

Is True

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.

Less than

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.

Copyright 2014 - Bizagi

999

Less than or Compara dos argumentos XPath y retorna <less-equalsequals to


verdadero si el primero es menor o igual que el than(XPath,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.

Max

Obtiene el valor mximo de una coleccin de <max(XPath)>


elementos. El atributo deber ser numrico o
moneda.

Min

Obtiene el valor mnimo de una coleccin de <min(XPath)>


elementos. El atributo deber ser numrico o
moneda.

Not equals

Compara dos argumentos XPath y regresa <not-equals(XPath,XPath)>


verdadero si NO son equivalentes. Los parmetros
pueden ser expresiones o funciones XPath.

Or

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.

Sum

Suma el valor de un atributo de una coleccin. El <sum(XPath)>


atributo debe ser numrico o moneda.

Funciones Avanzadas
FUNCIN

DESCRIPCIN

SINTAXIS

Nuevo item de una Permite la inclusin o creacin de un nuevo Me.newCollectionItem("XPath")


coleccin
item (registro) a una coleccin. El item se
incluye inicialmente como una entrada en El XPath debe ser una coleccin
blanco. Puede asignar una variable para
establecer los valores para el nuevo
registro.
Asociar item a una

Permite asociar UN item (registro) de una Me.attachCollectionItem("XPath",

Copyright 2014 - Bizagi

1000

coleccin

Asociar items a
una coleccin

coleccin a otra coleccin. El artculo no se


duplica, es compartido por las dos
colecciones.
Ambas colecciones han de pertenecer
(relacionarse) con la misma entidad.

item)

Permite asociar uno o ms items (registros)


de una coleccin a otra coleccin. Los items
no estn duplicados, son compartidos por
ambas colecciones.
Ambas colecciones han de pertenecer
(relacionarse) con la misma entidad.

Me.attachCollectionItems("XPath",
items)

El XPath debe ser una coleccin


que recibir el item.
El item es el Xpath al registro
que se asociar.

El XPath debe ser una coleccin


que recibir los items.
Los items son Xpath a los
registros que se asociarn.

Desasociar item
de una coleccin

Permite desasociar UN elemento (registro) Me.detachCollectionItem("XPath",


de una coleccin. El item ya no sern parte item)
de la coleccin, pero no van a ser borrado
de la base de datos.
El XPath debe ser una coleccin
El item debe ser un registro de la
coleccin. Si no es UNO solo la
funcin fallar en ejecucin.

Desasociar items
de una coleccin

Permite desasociar ALGUNOS (uno o ms) Me.detachAllCollectionItems("XPa


items (registros) de una coleccin. Los items th")
ya no sern parte de la coleccin, pero no
van a ser borrados de la base de datos.
El XPath debe ser una coleccin

Desasociar todos
los items de una
coleccin

Permite desasociar TODOS los items Me.detachAllCollectionItems("XPa


(registros) de una coleccin. Los items ya th")
no sern parte de la coleccin, pero no van
a ser borrados de la base de datos.
El XPath debe ser una coleccin
que tendr todos sus items
desconectados.

Eliminar un item
de una coleccin

Permite la eliminacin completa UNO de los Me.deleteCollectionItem("XPath",


items (registros) de una coleccin. El item)
elemento se eliminar de la coleccin y de
la base de datos.
El XPath debe ser una coleccin
El item debe ser un registro de la
coleccin. Si no es UNO solo la
funcin fallar en ejecucin.

Eliminar items de
una coleccin

Permite la
ms items
elementos
de la base

Eliminar todos los


items de una

Permite la eliminacin completa de TODOS Me.deleteAllCollectionItems("XPat


los items (registros) de una coleccin. Los h")

eliminacin completa de uno o Me.deleteCollectionItems("XPath",


(registros) de una coleccin. Los item)
se eliminarn de la coleccin y
de datos.
El XPath debe ser una coleccin.
Los items deben ser uno o ms
registros de dicha coleccin

Copyright 2014 - Bizagi

1001

coleccin

elementos se eliminarn de la coleccin y


de la base de datos.
El XPath debe ser una coleccin.

Distinct-values

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.

Get
value
collection

as

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.

<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.

CHelper.GetValueAsCollection(<X
Path>)
El XPath debe ser una coleccin

Sort

Ordenar registros de una coleccin en <sort(XPath,'attribute')>;


orden ascendente de acuerdo a un atributo.
Solo es posible ordenar utilizando un El XPath debe ser una coleccin
entero, real, fecha o un atributo string. El
mtodo recibe una coleccin y regresa la
coleccin ordenada de acuerdo a los
valores del atributo.

Add relation
DEPRECADO

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.

Remove relation
DEPRECADO

Permite borrar elementos de una coleccin. Es Me.removeRelation("XPath",


posible especificar si se quiere o no eliminar los remove from database)
registros de la base de datos en el Segundo
parmetro.

Funciones matemticas
FUNCIN
Abs

DESCRIPCIN

SINTAXIS

Devuelve el valor absoluto de un CHelper.Math.Abs(Number)


nmero (entero, moneda, real, flotante).
Abs(1.5) -> 1.5
Abs(-1.5) -> 1.5
El parmetro puede ser Xpath, variable
o nmero.

Copyright 2014 - Bizagi

1002

Average

Obtiene el promedio (media aritmtica) CHelper.Math.Average([Number


de un conjunto de nmeros (entero, 1,Number2,....])
moneda, real, flotante).
Los parmetros pueden ser Xpaths,
variables o nmeros y deben estar
contenidos entre braquets []

Ceiling

Redondea un nmero (entero, moneda, CHelper.Math.Ceiling(Number)


real, flotante) hacia arriba al entero ms
cercano.
Ceiling(1.2) -> 2
Ceiling(1.9) -> 2
El parmetro puede ser Xpath, variable
o nmero.

Exp

Devuelve e (la base de logaritmos CHelper.Math.Exp(Number)


naturales) elevado a la potencia dada.
El parmetro puede ser Xpath, variable
o nmero.
EL RESULTADO DE ESTA FUNCIN
DEBE SER GUARDADO EN UN
ATRIBUTO TIPO FLOAT.

Floor

Redondea un nmero (entero, moneda, CHelper.Math.Floor(Number)


real, flotante) hacia abajo al entero ms
cercano.
Floor(1.2) -> 1
Floor(1.9)-> 1
El parmetro puede ser Xpath, variable
o nmero.

IsNaN

Esta funcin evala si un parmetro no CHelper.Math.IsNaN(Parameter)


es un nmero:
Devuelve verdadero si el parmetro
no es un nmero.
Devuelve falso si el parmetro es un
nmero.
El parmetro puede ser XPath, variable
o nmero.

Ln

Devuelve el logaritmo natural de un CHelper.Math.Ln(Number)


nmero (entero, moneda, real, flotante).
El parmetro puede ser Xpath, variable
o nmero.

Log10

Devuelve el logaritmo en base 10 de un CHelper.Math.Log10(Number)


nmero (entero, moneda, real, flotante).
El parmetro puede ser Xpath, variable
o nmero.

Max

Devuelve el mayor valor entre de un CHelper.Math.Max([Number1,Nu


conjunto de nmeros (entero, moneda, mber2...])

Copyright 2014 - Bizagi

1003

real, flotante).
Los parmetros pueden ser Xpaths,
variables o nmeros y deben estar
contenidos entre braquets []
Min

Devuelve el menor valor entre de un CHelper.Math.Min([Number1,Nu


conjunto de nmeros (entero, moneda, mber2...])
real, flotante).
Los parmetros pueden ser Xpaths,
variables o nmeros y deben estar
contenidos entre braquets [].

Module

Devuelve el residuo de una divisin.


Mod(8,3) -> 2
Mod(10,2) -> 0
Los parmetros pueden ser Xpaths,
variables o nmeros.
Solo recibe parmetros enteros.

Percentage

Devuelve el equivalente en porcentage CHelper.Math.Percentage(Numb


de un nmero( entero, moneda, real, er)
flotante).
Percentage(100) -> 1
Percentage( 75) -> 0.75
El parmetro puede ser Xpath, variable
o nmero.

Pow

Obtiene el resultado de nmero CHelper.Math.Pow(Base,Power)


elevado a una potencia (entero,
moneda, real, flotante).
Los parmetros pueden ser Xpaths,
variables o nmeros.

Quotient

Devuelve la porcin entera de una CHelper.Math.Quotient(Number,


divisin.
Divisor)
Quotient(100,3)-> 33
Quotient(5,2)-> 2
Los parmetros pueden ser Xpaths,
variables o nmeros.
Solo recibe parmetros enteros.

Rand(to,from
)

Devuelve un nmero aleatorio entero CHelper.Math.Rand(ValueFrom,V


entre dos nmeros.
alueTo)
Los parmetros pueden ser Xpaths,
variables o nmeros.
Solo recibe parmetros enteros.

Rand()

Devuelve un nmero aleatorio decimal CHelper.Math.Rand()


entre 0.0 y 1.0. No tiene parmetros.

Round

Reduce un nmero dado (entero, CHelper.Math.Round(Number,De


moneda, real, flotante) a un nmero cimalPlaces)

Copyright 2014 - Bizagi

CHelper.Math.Module(Number,D
ivisor)

1004

especfico de decimales (entero).


Round (1.247,2) -> 1.25
Round (1.534,1) -> 1.5
El parmetro puede ser Xpath, variable
o nmero.
Sqrt

Obtiene la raz cuadrada de un nmero CHelper.Math.Sqrt(Number)


(entero, moneda, real, flotante).
El parmetro puede ser Xpath, variable
o nmero.

Truncate

Trunca un nmero (entero, moneda, CHelper.Math.Truncate(Number)


real, flotante) a un entero al remover su
parte decimal o fraccional.
Truncate(35.5) -> 35
Truncate(35.89) -> 35
El parmetro puede ser Xpath, variable
o nmero.

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.

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-

Copyright 2014 - Bizagi

1005

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");
}

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
checked");
}

not

been

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")

Copyright 2014 - Bizagi

1006

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")
}

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), isempty(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-notempty(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)>){

Copyright 2014 - Bizagi

1007

<Request.RequestAuthorization>= true;
}

Is Null: Retorna verdadero si un atributo es nulo (no lleno), de lo contrario retorna falso.
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),istrue(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.
Los parmetros pueden ser XPath string o string. Cuando se utiliza un texto fijo utilice las comillas
sencillas (').

Copyright 2014 - Bizagi

1008

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.
<Request.RequestAuthorization> = <or(is-false(Request.Client.VIP),istrue(Request.Client.ReportedOnCreditBureau))>

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)>;

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

Copyright 2014 - Bizagi

1009

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.

newCollectionItem: 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 en la coleccin Historia.
var User = Me.Case.WorkingCredential.UserId;
CommentRecord=Me.newCollectionItem("ClaimsAndComplaints.History")
CommentRecord.setXPath("Actions",<ClaimsAndComplaints.Response>);
CommentRecord.setXPath("PostedBy",User);
CommentRecord.setXPath("Dates", DateTime.Now);

Distinct-values: Retorna 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.

Copyright 2014 - Bizagi

1010

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.
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')>;

Round: La funcin round se usa para reducir un numero (moneda, real, float) dado a un nmero
especfico de decimales.
Ejemplo: Redondear un valor moneda dos puestos decimales.
<Purchase.RoundedPrice> = CHelper.Math.Round(<Purchase.InitialPrice>,2)
Redondear un valor moneda sin puestos decimales
<Purchase.RoundedPrice> = CHelper.Math.Round(<Purchase.InitialPrice>)

Floor: La funcin floor redondea un nmero (moneda, real, float) hacia abajo al entero ms cercano.
Ejemplo: Redondear un atributo tipo moneda al entero menor
<Purchase.RoundedPrice> = CHelper.Math.Floor(<Purchase.InitialPrice>)

Ceiling: La funcin ceiling redondea un nmero (moneda, real, float) hacia arriba al entero ms
cercano.
Ejemplo: Redondear un atributo tipo moneda al entero mayor
<Purchase.RoundedPrice> = CHelper.Math.Ceiling(<Purchase.InitialPrice>)

Copyright 2014 - Bizagi

1011

Acceder a entidades no relacionas con el modelo de datos

Introduccin
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 EntityManager. La funcin retorna una coleccin de tems. Tendr que iterar
sobre la coleccin para acceder a informacin especfica (p.ej Los valores de un tem).

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 EntityManager 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

EJEMPLO

Igual a

"Client =" +<Request.Client>

<>

Diferente

"ClientName <>" +'John'

>

>=

Mayor que/ Mayor o


igual que

"Balance >= 600"

<

<=

Menor que/ Menor o


igual que

"Balance <= 600"

"Minumum <= " + <Request.BorrowingCapacity> + " and


Maximum >= " + <Request.BorrowingCapacity>

"Minimum <= " + <Request.BorrowingCapacity> + " or


Maximum >= 1000"

BETWEEN

Entre

"Balance BETWEEN 200 AND 500"

IN ()

En

"Balance in (500, 600, 700)"

AND

OR

Copyright 2014 - Bizagi

1012

IS NULL

Igual a nulo

"CityName IS NULL"

IS NOT
NULL

Diferente de nulo

"CityName IS NOT NULL"

La funcin EntityManager se encuentra en la categora Navegacin de Datos.

Cmo acceder a la informacin de la entidad?


Recordemos que la entidad es retornada como una coleccin de tems. La coleccin de la entidad
debe ser guardada dentro de una variable para poder recorrerla.
Para identificar cuantos elementos tiene la coleccin se debe utilizar el comando Length.
Recorra la coleccin utilizando un ciclo for de la siguiente manera:

Copyright 2014 - Bizagi

1013

//Obtenga el identificador del registro

var Entity =
CEntityManager.GetEntity("Entity").GetEntityList("Attribute","Filter","","");
for(var i=0; i< Entity.Length;i++)
{
//Obtenga el valor del atributo del registro

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 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.

Copyright 2014 - Bizagi

1014

1. En el paso cuatro del Asistente, agregue una expresin al entrar de la tarea 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 entity with EntityManager de la categora Navegacin de Datos para
acceder a las entidades paramtricas.

//Evale si la coleccin tiene elementos


if(<count(Request.Applicant.ApplicantTests)> == 0)
{
//Use la funcin EntityManager para obtener todos los exmenes que han sido agregados a la
coleccin
Test =
CEntityManager.GetEntity("MedicalTest").GetEntityList("","","","");
//Itere la variable en la que se almacenen los exmenes
for(var Counter=0; Counter < Test.Length; Counter++)

Copyright 2014 - Bizagi

1015

{
//Agregue cada examen a la coleccin
Test =
Me.newCollectionItem("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 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.

La siguiente imagen muestra la lista de exmenes mdicos que deben ser cargados dentro de la
coleccin, aquellos marcados como requeridos.

Copyright 2014 - Bizagi

1016

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 entity with EntityManager de la categora Navegacin de Datos para
acceder a las entidades paramtricas.

//Evale si la coleccin tiene elementos


if(<count(Request.Applicant.ApplicantTests)> == 0)
{
//Use la funcin EntityManager para obtener todos los exmenes que sern agregados a la
coleccin. Filtre los registros por el estado requerido

Copyright 2014 - Bizagi

1017

Tests =
CEntityManager.GetEntity("MedicalTest").GetEntityList("Required",true,"",""
);
//Itere la variable en la cual se almacenan los Exmenes.
for(Counter=0; Counter < Tests.Length; Counter++)
{
//Agregue cada examen a la coleccin.
Test =
Me.newCollectionItem("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 por 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 2014 - Bizagi

1018

La siguiente es la entidad paramtrica que contiene la informacin a ser cargada.

Copyright 2014 - Bizagi

1019

1. En el paso cuatro del Asistente, cree una accin al Entrar de la actividad donde se cargan los
documentos.
2. Escriba el cdigo de la regla de negocio para incluir los documentos dentro de la coleccin.
Seleccione la funcin Get entity with EntityManager de la categora Navegacin de Datos para
acceder a las entidades paramtricas.

//Cree un filtro para identificar el rol y la fuente de ingresos del solicitante


FilterDocs = "ApplicantRole = " + <Applicant.ApplicantRole.id> + " and
IncomeSource = " + <Applicant.IncomeSource.id>;
//Use la funcin EntityManager para obtener los documentos que sern agregados a la coleccin.
Filtre por el estado requerido.
DocsXApplicant =
CEntityManager.GetEntity("DocumentXApplicant").GetEntityList("","",FilterDo
cs,"");

Copyright 2014 - Bizagi

1020

//Itere la variable en la que se almacenan los documentos


for(Count =0; Count < DocsXApplicant.Length; Count++)
{
//Agregue cada documento a la coleccin
IdDocument = DocsXApplicant[Count].Attributes["Document"].Value;
AppicantDocument = Me.newCollectionItem("Applicant.Documents");
AppicantDocument.setXPath("Document",IdDocument);
AppicantDocument.setXPath("Required",DocsXApplicant[Count].Attributes["Requ
ired"].Value);
}

Buscar y reemplazar expresiones


Usted puede buscar dentro del contenido de las expresiones para Encontrar o Reemplazar palabras
especficas.
Con la expresin abierta teclee Ctrl + F para abrir el dilogo Buscar y reemplazar.
Usted puede buscar una palabra a la vez haciendo clic en Buscar siguiente.

Puede buscar todas las palabras en la expresin que coinciden con la palabra ingresada dando clic en
Buscar todos.

Copyright 2014 - Bizagi

1021

Puede reemplazar palabras en la expresin desde la pestaa Reemplazar.


Nuevamente, usted puede reemplazar una palabra a la vez o todas al mismo tiempo haciendo clic en
Reemplazar siguiente o Reemplazar todos.

Copyright 2014 - Bizagi

1022

Por defecto, la bsqueda no tiene en cuenta maysculas. Si hace clic en la casilla Coincidir
maysculas y ser sensible a maysculas.
Al cerrar el dilogo de Buscar y reemplazar las palabras iluminadas permanecer resaltadas hasta
que haga clic con su mouse.

Elemento Iterate over XPath

Introduccin
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.
4. Durante la iteracin del ciclo incluya una elemento de expresin para realizar los clculos

Copyright 2014 - Bizagi

1023

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 donde se ingresa la informacin.


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 2014 - Bizagi

1024

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 Request.Applicants.

Copyright 2014 - Bizagi

1025

4. Incluya un elemento de expresin para calcular el ingreso total.

Copyright 2014 - Bizagi

1026

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

Copyright 2014 - Bizagi

1027

sobre los registros que cumplen la condicin del filtro.

Elemento de Asignacin

Introduccin
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
TotalPrice (precio unitario por cantidad).
Luego se puede calcular el precio total de toda la compra y guardarlo en el atributo
TotalCostEstimate.

Copyright 2014 - Bizagi

1028

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 d clic en el
botn Guardar en el Portal de Trabajo, se realizar el clculo.
Incluya un elemento de asignacin y nmbrelo como TotalCostEstimate.

Copyright 2014 - Bizagi

1029

D 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. D clic en la lista desplegable y luego seleccione el atributo.

Copyright 2014 - Bizagi

1030

Navegue el modelo de datos hasta que se alcance el atributo deseado, en este caso Total Cost
Estimate. D clic en Ok.

Copyright 2014 - Bizagi

1031

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. D clic en
Ok cuando la expresin XPath este completa.

Copyright 2014 - Bizagi

1032

Usted puede agregar tantas asignaciones como necesite.


Si desea remover una asignacin asociada a un elemento, d clic en el botn Eliminar.

Copyright 2014 - Bizagi

1033

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) para minimizar las interrupciones en los servicios tecnolgicos de la empresa.
De acuerdo a cmo evolucione el reporte 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 2014 - Bizagi

1034

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 Abierto.
Incluya un elemento de Asignacin y seleccione el XPath a ser asignado: Ticket.Status.
Luego seleccione la opcin Entidad.

Una nueva ventana mostrar las entidades maestras y paramtricas del proyecto.

Copyright 2014 - Bizagi

1035

En este caso vamos a seleccionar la entidad paramtrica Help Desk Case Status y su atributo Cdigo.
Si se conoce el identificador de cada registro de la entidad (el id), este ser seleccionado con la
opcin de Validacin Simple.
La validacin Compleja (cuando no esta directamente asociado), permite utilizar filtros dentro de la
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. D clic en Ok para guardar la regla.

Copyright 2014 - Bizagi

1036

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.

Elementos Boolean, While e If

Introduccin
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
datos, 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.

Booleano

Igual a, Diferente de, Es blanco, Est lleno, Es


verdadero, Es falso.

Despus, en el lado derecho del condicional, ingrese el valor contra el cual se va a hacer la

Copyright 2014 - Bizagi

1037

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 d clic en el botn Y, este botn
permite incluir la condicin utilizando el operador lgico Y o 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 2014 - Bizagi

1038

Elemento While
Este elemento ejecuta un ciclo mientras que una condicin sea verdadera.
Asegrese de que la condicin que se evala tome el valor de FALSO en algn punto, para no tener
posibilidad de 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.

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:

Copyright 2014 - Bizagi

1039

4. Cree un elemento de expresin para incluir los elementos de la coleccin.


En este elemento, aumente en UNO la variable que controla 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).

Copyright 2014 - Bizagi

1040

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:

Copyright 2014 - Bizagi

1041

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 2014 - Bizagi

1042

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 Si no el estado de la solicitud debe ser Rechazado por riesgo, cdigo=5.

Copyright 2014 - Bizagi

1043

Elemento Funcin

Introduccin
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 Elemento Expresin, por lo que
recomendamos su uso desde all.
Mis funciones 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 2014 - Bizagi

1044

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

Copyright 2014 - Bizagi

1045

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 2014 - Bizagi

1046

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.

Copyright 2014 - Bizagi

1047

4. Finalmente utilice el resultado de la variable para asignar la edad del cliente en el modelo de datos.

Copyright 2014 - Bizagi

1048

Elemento Web service

Introduccin
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).
Para llamar un servicio web desde una regla de negocio debe incluir el elemento Servicio Web y
configure la invocacin.

Copyright 2014 - Bizagi

1049

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 2014 - Bizagi

1050

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, Reglas de negocio, seleccione la opcin Acciones de la actividad
(Eventos).

2. D 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 Inicio y seleccionando la
opcin Declaracin de variables.

Copyright 2014 - Bizagi

1051

3. D clic en Adicionar para crear una nueva variable y seleccione entero, como tipo de variable (int).
Asgnele un Nombre y d clic en Ok.

Observe que puede asignar un valor inicial por defecto. D clic en Ok.
4. D clic derecho sobre la lnea vertical de la regla y seleccione Adicionar Servicio Web.

Copyright 2014 - Bizagi

1052

5. D clic derecho sobre el elemento Servicio web y seleccione sus Propiedades: Esto lanzar un
asistente que lo guiar a travs de la configuracin de la invocacin del Servicio web.

Copyright 2014 - Bizagi

1053

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 2014 - Bizagi

1054

D clic en Siguiente.
7. Seleccione el mtodo Web de los mtodos proporcionados por el servicio Web. D clic en
Siguiente.

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 d clic en el botn establecer
valores.

Copyright 2014 - Bizagi

1055

En el ejemplo, el mtodo recibe como parmetro de entregada un nico parmetro de tipo String.
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).

D clic en Ok y luego en Siguiente.


9. Seleccione la variable en la cual se va a guarda el resultado de la respuesta.
En el ejemplo, la variable se llama tempResponse, la cual fue creada en el paso 3.

D clic en Siguiente para terminar la configuracin.

Copyright 2014 - Bizagi

1056

10. Incluya cualquier manipulacin adicional del resultado.


Vamos a continuar modificando la regla, lo cual indica que cualquier otra manipulacin se realiza
directamente sobre la variable tempResponse 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.

Haga doble clic sobre la expresin para realizar cambios.

Copyright 2014 - Bizagi

1057

11. Finalmente, asigne la informacin calculada al modelo de datos.


Para realizar esto, vamos a incluir un elemento de asignacin.

Copyright 2014 - Bizagi

1058

D clic derecho sobre el elemento Asignacin y seleccione sus Propiedades.

Copyright 2014 - Bizagi

1059

12. Asigne la variable a un atributo del modelo de datos.


En el ejemplo, vamos a asignar el valor final de TempResponse al atributo DaysAvailable del modelo
de datos:

Copyright 2014 - Bizagi

1060

Note que el atributo pertenece a la entidad VacationRequest.


Para asignar tempResponse, seleccionamos la opcin Expresin y escribimos directamente el nombre
de las variables.

D clic en Ok para guardar la regla de negocio.

Copyright 2014 - Bizagi

1061

Elemento For

Resumen
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 inicializacin del ciclo indica la variable de control utilizada para regular el nmero de veces que
el ciclo es ejecutado.
El valor inicial de la variable de control, est se fija con una constante. El valor inicial puede ser
cualquier nmero que cumpla sus necesidades, por defecto es cero (0).
El Incremento/Decremento 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 condicin del 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. Cree una expresin de Script.
2. Declare una variable para guardar los elementos de la coleccin.
3. Cree un elemento For e incluya la lgica del ciclo.

Copyright 2014 - Bizagi

1062

4. Defina las operaciones o clculos que se deben realizar dentro del ciclo.
5. Guarde la regla.

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.

Copyright 2014 - Bizagi

1063

3. Adicione un elemento de expresin para obtener los registros de la entidad paramtrica


Documentos por solicitante que apliquen para el caso.

//Guarde el filtro en una variable, de acuerdo con el rol del aplicante y la fuente de ingresos
FilterDocsXApplicant = "idApplicantRole = " +
<idApplicant.idApplicantRole.id>
+ " and IncomeSource = " + <idApplicant.IncomeSource.id>;
//Almacene los registros de la entidad paramtrica que cumplan con el filtro en la variable
DocsXApplicant =
CEntityManager.GetEntity("DocumentXApplicant").GetEntityList("",null,Filter
DocsXApplicant,"");

Copyright 2014 - Bizagi

1064

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 DocsxApplicant.
La variable se incrementar en uno para incluir cada registro de DocsXApplicant en
ApplicantDocument.
Cree una condicin: el ciclo se ejecutar hasta que la variable DocsXApplicant tenga registros a incluir
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.newCollectionItem("idApplicant.Documents");
//Asigna el identificador del documento al nuevo registro.
ApplicantDocument.setXPath("idDocument",IdDocument);
//Asigna el atributo requerido (Verdadero o Falso) del nuevo registros

Copyright 2014 - Bizagi

1065

ApplicantDocument.setXPath("Required",DocsXApplicant[Count].Attributes["Req
uired"].Value);

Note que la variable ApplicantDocument se utiliza para copiar los valores desde la entidad
paramtrica Document per Applicant a la entidad Applicant Document.
La expresin agrega cada registro de manera individual, iterando la entidad paramtrica.
Variable.setXPath("atributo en la coleccin", valor a setear);

Elemento Iterate over Fact

Introduccin
Iterate over Fact permite realizar iteraciones (o ciclos) sobre 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.

Copyright 2014 - Bizagi

1066

Qu se debe hacer en Bizagi?


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 le permite al departamento administrativo incluir, como entidades paramtricas, la informacin
para el nuevo ao, por ejemplo, lista de tiles escolares, los cursos 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.

Copyright 2014 - Bizagi

1067

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
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.

Copyright 2014 - Bizagi

1068

3. Utilizando un elemento de expresin para recuperar la coleccin y almacenarlo en la variable de


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 obtenga el idUser (llave) que ser
utilizado en el elemento Iterate over Fact.

Copyright 2014 - Bizagi

1069

5. En el elemento For se obtiene el idUser.

Copyright 2014 - Bizagi

1070

6. Incluya los siguientes elementos en el elemento Iterate over Fact.


- La variable para la iteracin: GradesToIterate
- La entidad: WFuser
- La relacin : Grades
- La llave: idUser (es el identificador que toma el registro de la entidad para identificar los registros de
la coleccin)

Copyright 2014 - Bizagi

1071

5. Incluya en el ciclo un elemento de expresin para realizar algunos clculos.

Copyright 2014 - Bizagi

1072

//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 Backtoschool- Teacher collection.
(relacin uno a muchos).
AddTeacher = Me.newCollectionItem("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.

Donde utilizar reglas de negocio


Bizagi ofrece un ambiente grfico desde donde usted puede definir y administrar sus Reglas de
Negocio de manera fcil e intuitiva; con nuestro poderoso motor de reglas de negocio usted puede
disear desde las ms simples hasta las ms complejas reglas.

Copyright 2014 - Bizagi

1073

En Bizagi usted puede definir reglas de negocio para:


Encaminar flujos de Proceso: 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 retornan el valor de verdadero o falso (Booleano) para decirle al proceso por
donde se debe seguir.
Realizar acciones en 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 datos y asignar o borrar valores de cualquier atributo.
Manipular interfaces de usuario: Es muy importante poder controlar qu campos se muestran o se
ocultan en el Portal de Trabajo para los usuarios finales, tambin cmo controlar los campos que
son obligatorios, que son editables o que son 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.
Asignar usuarios: Las reglas de negocio se pueden utilizar para controlar qu usuario debe ser
responsable de realizar una tarea, de acuerdo a las condiciones del negocio.

Asignaciones, clculos y validaciones

Introduccin
Es posible realizar clculos y validaciones en cada actividad del proceso con la opcin de Acciones de
la Actividad 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 d
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 d 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 Expresiones.

Copyright 2014 - Bizagi

1074

Lo que necesita hacer en Bizagi

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.
D clic sobre cualquier tarea para incluir una Accin.

Copyright 2014 - Bizagi

1075

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
<PurchaseRequest.RequestedBy>

cuyos

XPath

son:

<PurchaseRequest.RequestDate>

1. Para configurar la regla de negocio que incluya la informacin de estos atributos vaya al paso
cuatro del Asistente y seleccione Acciones de la Actividad.
Cuando se abra el flujo del proceso d clic sobre la primera actividad de este.
En la ventana Acciones de la Actividad, seleccione la opcin Al entrar y d clic en el signo ms.
Esto abrir una nueva ventana en donde se puede seleccionar entre acciones Al Entrar, Al Salvar o Al
Salir. Vamos a incluir una Expresin.

Copyright 2014 - Bizagi

1076

2. Se abrir el administrado de expresiones.


D clic en Nuevo para crear una expresin o seleccione una y d clic en Editar para editarla.

3. D clic 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.

Copyright 2014 - Bizagi

1077

4. D 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 d 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 recordar qu y dnde hace
cada una de ellas.

5. D 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).
D clic en la opcin de Modelo de Datos en la esquina superior izquierda.

Copyright 2014 - Bizagi

1078

Esto mostrar el Modelo de Datos de su proceso para poder construir los XPaths que necesite.
Para agregar un atributo d clic sobre este y luego en OK.

6. Para asignar la fecha de hoy en el atributo RequestDate utilizaremos una funcin de nuestra lista de
Funciones.
D clic en el men Funciones, luego seleccione la categora Fechas y Tiempo y seleccione la funcin
Today.

Copyright 2014 - Bizagi

1079

7. Para el atributo RequestedBy vamos a utilizar la funcin User Id, la cual se encuentra en la categora
Informacin del usuario actual.

8. D clic en Ok para guardar el elemento Expresin, y de nuevo, d clic en Ok, para guarda toda la

Copyright 2014 - Bizagi

1080

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 debe
aprobarla. Por lo que es necesario, 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
<PurchaseRequest.PurchaseApproval>

la

informacin de

la

aprobacin cuyo

XPath es:

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.
Cuando el flujo del proceso est abierto, d clic derecho en la segunda actividad del proceso.
En la ventana de Acciones de la actividad, seleccione Al Salir y d clic en el signo ms para incluir una
Expresin.

D clic en Nueva para crear una expresin.

Copyright 2014 - Bizagi

1081

2. Asigne un nombre, un nombre visual y una descripcin a la expresin.


D clic derecho sobre la flecha negra para incluir una expresin. Asigne un nombre al elemento y
luego d doble clic sobre l para abrir la ventana de la expresin.

3. Es necesario declarar una variable para manipular la adicin de nuevos registros a una coleccin.
D clic en el botn Variables y seleccione Nuevo. En la nueva ventana d clic en el signo ms y cree
una nueva variable de tipo objeto.
Recuerde siempre iniciar sus variables, en este caso asigne el valor null.

Copyright 2014 - Bizagi

1082

4. Para utilizar la variable creada, d clic en el botn Variables y luego d clic en la variable. Esta ser
incluida dentro de la expresin de forma automtica donde este parado el cursor.

Copyright 2014 - Bizagi

1083

5. Para agregar un nuevo registro a la coleccin usaremos una funcin del editor de funciones.
D clic en el men Funciones, vaya a la categora Colecciones y seleccione la funcin New collection
item.

Copyright 2014 - Bizagi

1084

6. Esto incluir la funcin a la expresin. Sin embargo se debe remplazar el XPath que trae por defecto
con el XPath de la coleccin.
Para hacer esto, d clic en el botn del Modelo de datos y seleccione el XPath de la coleccin.

Copyright 2014 - Bizagi

1085

7. Elimine los corchetes de diamante <>. Cambie la expresin:


NewApproval = Me.newCollectionItem("<PurchaseRequest.PurchaseApproval>")
por
NewApproval = Me.newCollectionItem("PurchaseRequest.PurchaseApproval")

8. Utilizando el botn Funciones incluya la funcin Me.setXPath, la podr encontrar en la categora


Navegacin de datos.
Como vamos a configurar cuatro Xpath, es necesario incluir cuatro funciones.
Remplace la sentencia Me con el atributo, reemplace el "XPath" con los atributos de la coleccin y
reemplace el value to set.
Para remplazar el XPath, abra el Modelo de datos y navegue por el hasta encontrar el atributo
deseado.
Cpielo y pguelo en la expresin.

Copyright 2014 - Bizagi

1086

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 Today.
El campo approval 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 2014 - Bizagi

1087

9. D clic en Ok para guardar el elemento Expresin, y de nuevo, d 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 subproceso


Para incluir una accin a la figura subproceso, mantenga sostenida la tecla Shift y luego d clic en la
figura. Esto abrir una ventana con las acciones de la figura.
Si usted da clic sobre a figura del subproceso sin tener oprimida la tecla shift, el flujo del subproceso
ser mostrado.

Copyright 2014 - Bizagi

1088

Ruta del proceso

Introduccin
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 entrada se consideran como un
elemento divergente. Cada uno de los flujos de salida debe tener una regla de negocio asociada la
cual ser evaluada por Bizagi para determinar cul 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 se debe seguir un camino.

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
que siempre retornan Verdadero o Falso

Copyright 2014 - Bizagi

1089

Qu se debe hacer en Bizagi?


En el cuarto paso del Asistente, seleccione la opcin Definir Expresiones.

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.

Copyright 2014 - Bizagi

1090

D 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 (Boss) 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 Subproceso 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 Solicitud de Compra y la entidad paramtrica Estado de la Solicitud.

Copyright 2014 - Bizagi

1091

D clic en el flujo de secuencia de Rechazo.


En la nueva ventana, seleccione Basado en el resultado de una expresin. Esto habilitar la pestaa
Expresiones.

Copyright 2014 - Bizagi

1092

Estando en Expresiones, d clic en Nueva.

Se mostrar la pestaa Nueva para ingresar la Expresin booleana.


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.
D clic en Finalizar para guardar la regla de negocio.

Copyright 2014 - Bizagi

1093

Defina las dems reglas de negocio siguiendo el procedimiento anterior.

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 y seleccione la condicin Sino y luego d clic en Ok.

Copyright 2014 - Bizagi

1094

Ejemplo 2: Definir mltiples condiciones


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 Alguna de las siguientes
condiciones est seleccionada para poder incluir el operador OR entre los argumentos.
Por defecto el operador AND (Todas las siguientes condiciones) esta seleccionada.

Copyright 2014 - Bizagi

1095

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 alguno 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 2014 - Bizagi

1096

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.

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.

Copyright 2014 - Bizagi

1097

Existen algunos productos que requieren activos, usados como garantas, para ser registrados antes
de que los productos sean desembolsados. Estos van al subproceso Garantas donde se registran
antes de la entrega de los productos. Solo algunos productos requieren garanta, por lo tanto, hay
productos que no estn respaldados por una garanta que pueden ir directamente a la entrega.
Una compuerta inclusiva evala cuales productos van directamente a Entrega (no se necesita garantas
o no se deben registrar las garantas) y cuales productos deben registrar la garanta antes de
continuar con el subproceso.
En este caso, la compuerta tiene tres flujos de salida: Uno para los productos que tienen garantas que
necesitan registrarse, este camino conduce al subproceso Garantas. Otro para los productos que van
directamente a Entrega y un ltimo con la condicin Sino, en este caso la evaluacin no puede definir a
donde debe ir el producto.
D clic en el flujo de secuencia y en la nueva ventana seleccione Basado en el resultado de una
expresin.

Vaya a la pestaa Expresiones y d clic en Nueva.

Copyright 2014 - Bizagi

1098

La regla de negocio que vamos a construir contar el nmero de productos que necesitan registro de
las garantas en el subproceso Garantas.
Si existe al menos un producto que cumpla la condicin, la regla debe retornar Verdadero, de lo
contrario retornar falso.
En el Editor de expresiones, expanda XPath. D clic en el botn Adicionar XPath personalizado.

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 (Garantas).
Tan pronto como una coleccin es seleccionada se habilitarn las funciones XPath, estas se encuentran

Copyright 2014 - Bizagi

1099

en la derecha de la ventana.

Es necesario incluir un filtro para poder seleccionar solo aquellos productos que requieren pasar por
el subproceso, es decir, aquellos donde las garantas deben ser registradas.
Para incluir un filtro, d clic en el botn Adicionar condicin de filtro. Esto crear una nueva lnea para
incluir la condicin del filtro.
En la primera columna seleccione un atributo del Modelo de Datos.
Luego seleccione el valor de la condicin (Igual o Es diferente que).
Finalmente seleccione un argumento. En este caso, el argumento es de tipo Booleano por lo que el
valor ser Verdadero.

Copyright 2014 - Bizagi

1100

Cuando termine de construir la condicin d clic en Asignar Filtro.


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. Seleccione los
condicionales Y o O, est opcin se encuentra al lado de la lista desplegable de las funciones XPath.
Cuando termine, verifique que el XPath est construido correctamente, la sentencia completa se
muestra en la parte inferior de la ventana.
Finalmente d clic en OK.

Copyright 2014 - Bizagi

1101

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.
Finalmente, d clic en Finalizar.

Script booleano

Introduccin
Las Expresiones booleanas son expresiones condicionales que retornan un valor booleano cuando se

Copyright 2014 - Bizagi

1102

evalan, es decir, 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 Script Booleano.
Como las expresiones Script Booleanas 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 Script Booleanas se construyen utilizando la interfaz de
Reglas de negocio con acceso a funcionalidades adicionales.

IMPORTANTE: Tenga en cuenta que debido a que los Script Booleanas aceptan cualquier
configuracin, podra darse el caso en que no se retorne ni verdadero ni falso. Esto NUNCA debe
pasar, las expresiones Script Booleanas SIEMPRE deber retornar el valor verdadero o falso.

Ejemplo
Copyright 2014 - Bizagi

1103

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 $3,000.
Si el cliente es mayor de 25 aos, sus ingresos deben ser superiores a $2,000.
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. Vaya al cuarto paso del Asistente y d clic en Definir Expresiones.

Copyright 2014 - Bizagi

1104

2. Seleccione el camino donde se debe evaluar la regla.

3. En la ventana de Expresin Booleana, d clic en Basado en el resultado de una expresin. Se


habilitar la Pestaa Expresiones.

Copyright 2014 - Bizagi

1105

4. Se muestra una lista con las expresiones por defecto y las expresiones reutilizables creadas
anteriormente.
Seleccione el campo Avanzado de la esquina inferior izquierda y d clic en Nueva Scripting.

5. La ventana de expresiones se abrir.


Incluya una nueva Expresin dando clic derecho sobre la flecha negra, luego seleccione la opcin
Adicionar Expresin.

Copyright 2014 - Bizagi

1106

6. Escriba el cdigo para definir las condiciones.


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.

Copyright 2014 - Bizagi

1107

//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.
D clic en la ruta alternativa.

Copyright 2014 - Bizagi

1108

En la ventana de expresin booleana seleccione Sino. Esta opcin va habilitar la ruta alternativa si la
condicin relacionada a la ruta principal retorna falso.

En la nueva ventana, seleccione Sino (else). Esta opcin habilitar el camino alternativo cuando la
condicin del camino principal retorne falso.

Copyright 2014 - Bizagi

1109

Finalmente, d clic en OK.

Manejo de la interfaz de usuario

Introduccin
Bizagi le permite manejar la informacin que se muestra en las formas y realizar validaciones para
asegurarse de que stos se comportan como su compaa requiere.
En algunos casos, estas validaciones y el comportamiento de los controles son bsicos y no necesitan
de lgica compleja.
Los comportamientos simples incluyen configurar un control como requerido, editable o visible en las
Propiedades Bsicas de los Controles.
Las validaciones dinmicas y los comportamientos que dependan de la informacin del caso, necesitan
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 configurar 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, se usa una expresin Booleana para establecer estas propiedades; retornar Verdadero o
Falso de acuerdo a las condiciones definidas. 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.

Copyright 2014 - Bizagi

1110

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
siguientes 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 configurados usando expresiones o valores
constantes.

Visible, editable, requerido usando expresions


Este artculo presenta ejemplos de cmo usar una expresin para establecer las propiedades bsicas
del control. Estas propiedades incluyen si los controles son visible, editable o requerido.
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 el transporte elegido es aire, se debe ofrecer servicio express para
que el paquete sea entregado el mismo da que se enva.
La forma usada para obtener esta informacin es:

Copyright 2014 - Bizagi

1111

Si el pas destino es Brasil o Estados Unidos, el Cdigo ZIP debe ser editable y requerido. De lo
contrario no aplica y debe ser de solo lectura.
La compaa ofrece el servicio express solo 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 Editable:
1. En la forma d clic sobre el control Zip Code. Sus propiedades se desplegarn en el Panel izquierdo.

Copyright 2014 - Bizagi

1112

2. En la pestaa de Propiedades Bsicas encontrar la propiedad Editable. D clic en el combo para


mostrar las opciones disponibles.

3. Seleccione la ltima opcin: Expresin. Una nueva ventana se desplegar.


Para crear una nueva expresin d clic en Nueva.

Copyright 2014 - Bizagi

1113

El editor de expresiones booleanas se desplegar.

4. Configure las condiciones requeridas. En este caso nuestra condicin se relaciona con el atributo de
pas destino..

Copyright 2014 - Bizagi

1114

Recuerde que una expresin booleana siempre retorna Verdadero o Falso. En este caso, si retornar
verdadero (si el pas es Brasil o Estados Unidos) el control ser editable. De lo contrario ser de slo
lectura.
5. Para evaluar esta expresin la forma debe refrescar cuando al seleccionar un pas. Para ello, cree
una accin y haga uso del comando Actualizar.

En el Portal de Trabajo, seleccione Irlanda como pas destino e intente ingresar un Cdigo ZIP. Note

Copyright 2014 - Bizagi

1115

que el control Cdigo ZIP es de slo lectura.

Seleccione Brasil o Estados Unidos y observe cmo el control queda disponible para edicin.

Configurar un control requerido


Siguiendo el mismo ejemplo anterior, si al paquete se le deben aplicar impuestos, se debe ingresar un
valor en Declared value. Para asegurarse de que este control tiene un valor es necesario configurar
que sea Requerido. Si el usuario final no ingresa un valor se debe desplegar un mensaje.
Para saber que un paquete aplica impuestos usaremos el atributo booleano Duitable. El control
Declared Value debe ser Requerido de acuerdo a si Duitable est o no seleccionado. Por lo tanto, se
debe usar una expresin para evaluar esta condicin:

Copyright 2014 - Bizagi

1116

1. En la forma, d clic sobre Declared Value. Sus propiedades se desplegarn en el Panel izquierdo.

2. En la pestaa de propiedades Bsicas ubique la propiedad Requerido. D clic en el combo para


mostrar la lista de opciones.

Copyright 2014 - Bizagi

1117

3. Seleccione la ltima opcin: Expresin. Para crear una nueva expresin, d clic en Nueva.

El editor de expresiones booleanas se desplegar para evaluar la condicin requerida.

Copyright 2014 - Bizagi

1118

4. En este caso nuestra condicin se relaciona con el atributo Duitable. Agregue una condicin donde
Duitable es igual a Verdadero.

5. La condicin debe ser evaluada cada vez que el usuario cambie el valor para el control Dutiable
material. Para hacerlo, cree una accin y utilice el comando Actualizar.

Copyright 2014 - Bizagi

1119

En el Portal de Trabajo, cuando el usuario final seleccione Duitable el campo Declared Value ser
requerido. Esto puede identificarse por la pequea raya roja que aparece al lado izquierdo del control.

Si el control Duitable no est seleccionado, el control Declared Value no ser requerido.

Copyright 2014 - Bizagi

1120

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 diferente a por aire, el control Express Service solo debe
verse cuando el Medio de Transporte es por aire. Para configurar esto, siga los pasos a continuacin:

1. En la forma, d clic sobre el control Express Service. Sus propiedades se mostrarn en el Panel
izquierdo.

Copyright 2014 - Bizagi

1121

2. En la pestaa de propiedades Bsicas encontrar la propiedad Visible. Despliegue la lista de


opciones de la propiedad.

3. Seleccione la ltima opcin: Expresin. Para crear una nueva expresin d clic en Nuevo.
La Expresin Booleana ser desplegado para evaluar la condicin requerida.

Copyright 2014 - Bizagi

1122

4. La condicin se refiere al valor del control Medio de Transporte. Agregue una condicin donde
TransportationMean es igual a Aire.

5. La condicin necesita ser evaluada cada vez que el usuario cambie el valor del control Medio de
Transporte. para hacer esto, cree una accin y use el comando Actualizar.

Copyright 2014 - Bizagi

1123

En el Portal de Trabajo, seleccione Aire como medio de transporte. Note cmo el control Servicio
Express se muestra.

Seleccione Martimo como medio de transporte. Note que el control de Servicio Express se oculta.

Copyright 2014 - Bizagi

1124

Mostrar u ocultar controles usando expresiones de script.


Algunas condiciones que deben ser evaluadas son ms complejas y no pueden ser hechas con la
funcionalidad de arrastrar y soltar en la interfaz de Reglas de Negocio. 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

Destino

Servicio express

Brasil

Irlanda

No

Brasil

EEUU

Yes

EEUU

Irlanda

Yes

EEUU

Brasil

Yes

Irlanda

EEUU

No

Irlanda

Brasil

No

Para no permitir que la seleccin de una ruta para los envos que no sea aire o seleccionar una ruta
incompatible para el envo, el control de Servicio Express solo se debe mostrar cuando se cumplan las
condiciones requeridas.
Este comportamiento no se puede configurar mediante una expresin booleana ya que la condicin se

Copyright 2014 - Bizagi

1125

refiere a diferentes combinaciones de rutas de envo. Por lo tanto, es necesario implementar una
expresin de Script Booleano.
1. En la forma, d clic sobre el control Express Service para mostrar sus propiedades se mostrarn en
el Panel izquierdo.

2. En la pestaa de propiedades Bsicas encontrar la propiedad Visible. Despliegue la lista de


posibles opciones.

Copyright 2014 - Bizagi

1126

3. Seleccione Expresin para mostrar el administrador de expresiones.


4. Se abrir la ventana del Administrador de Expresiones para seleccionar la regla (Si ya fue creada) o
crear una nueva.

5. Seleccione la opcin Nueva y luego Scripting.

6. D clic derecho en la lnea vertical de la regla y agregue una Expresin.

Copyright 2014 - Bizagi

1127

7. Esta expresin requiere la definicin de Constantes definida previamente en el vocabulario. Por la


cual se referencian valores especficos de entidades.
Estas definiciones contendrn el cdigo interno, el cul, es un atributo de la entidad, del pas especfico
o del medio de transporte.

8. Escriba el siguiente cdigo y guarde la expresin:

Copyright 2014 - Bizagi

1128

//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 2014 - Bizagi

1129

}
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, destino o medio de
transporte.
Cree una accin y utilice el comando Actualizar.

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 control del Servicio Express se muestra en el grupo Informacin del servicio.

Copyright 2014 - Bizagi

1130

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.

Cuando se aplican estos comportamientos sobre las columnas de una tabla, estos 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

Visibilidad y editabilidad de celdas


En muchas ocasiones es necesario evaluar condiciones con el fin de definir si una celda especfica 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.
Desde la tercera actividad del proceso, el gerente de proyecto puede ver el estado actual de cada

Copyright 2014 - Bizagi

1131

tarea, tal como se muestra en la siguiente imagen:

Los estados posibles para las tareas son: En progreso, completa, cancelada o vencida.

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 Editar Columnas.

Copyright 2014 - Bizagi

1132

3. D clic en la celda Fecha lmite. Aparecer un nuevo men contextual en la parte izquierda de la
pantalla.

4. En la opcin Celda editable, d clic en el icono de expresin.

Copyright 2014 - Bizagi

1133

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.

Copyright 2014 - Bizagi

1134

D clic en OK para guardar los cambios.


Vaya al Portal de Trabajo para probar el comportamiento. Note que si el estado de la tarea es
Completada o Cancelada, 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 Completada o cancelada, 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 2014 - Bizagi

1135

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 Editar Columnas.

3. D clic en la celda Comentarios. Aparecer un nuevo men contextual en la parte izquierda de la


pantalla.

4. En la opcin Celda Visible, d clic en el icono de expresin.

Copyright 2014 - Bizagi

1136

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 2014 - Bizagi

1137

D clic en OK para guardar los cambios.


Vaya al Portal de Trabajo para probar el comportamiento. Note que si el estado de la tarea es
Completada o Cancelada, la celda de comentarios no mostrar el valor contenido.

Valores por defecto usando expresiones


Cuando la opcin de valor por defecto se usa para controles relacionados a una tabla, como combos
o listas, estos reciben el identificador del registro que se quiere mostrar, es decir, la expresin usada
debe retornar un entero. Asegrese de que el identificador se encuentre actualmente en la tabla
relacionada.

Copyright 2014 - Bizagi

1138

El siguiente ejemplo muestra cmo configurar un valor por defecto a un control.

Ejemplo
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:

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, d clic al control Pas de Origen para mostrar las propiedades se desplegarn en el
Panel Izquierdo.

Copyright 2014 - Bizagi

1139

2. En la pestaa Avanzado ubique la propiedad Valor por defecto y d clic en el cono..

D clic en Nueva para crear una expresin.

Copyright 2014 - Bizagi

1140

3. Adicione un mdulo de expresin.

4. Escriba el siguiente cdigo y guarde la regla:

Copyright 2014 - Bizagi

1141

//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.
Recuerde aadir Pas como una propiedad de usuario de todos los usuarios.
Entre al Portal de Trabajo como usuario de Brasil y cree un nuevo caso. Note cmo ese es el pas
diligenciado.

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
manejar y monitorear los envos internacionales. La primera tarea de este proceso permite al cliente

Copyright 2014 - Bizagi

1142

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 servicio 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 Fecha de Envo. Sus propiedades se mostrarn en el Panel
izquierdo.

Copyright 2014 - Bizagi

1143

2. Seleccione el icono de expresin en el valor Mnimo del rango de fechas de la pestaa Avanzado.

D clic en Nuevo para crear una expresin.

Copyright 2014 - Bizagi

1144

3. En la nueva ventada, d clic derecho a la lnea vertical y 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 2014 - Bizagi

1145

//Retorna la fecha de hoy


DateTime.Today;
5. Prueba la expresin en el Portal de Trabajo. Note que en el calendario de la Fecha de Envo, los das
(y meses) anteriores a la fecha actual estn deshabilitados.

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 el 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:

Copyright 2014 - Bizagi

1146

Las dimensiones mximas que puede tener un paquete, varan de acuerdo al medio de transporte
seleccionado. La siguiente tabla muestra la altura mxima permitida para cada medio de transporte.
Use una expresin para validar la condicin.
Medio de Transporte

Altura mxima permitida (ft)

Aire

70

Mar

94

Tierra

100

1. En la forma, seleccione el control Altura para mostrar sus propiedades.

Copyright 2014 - Bizagi

1147

2. En la pestaa Avanzado encontrar la propiedad Mximo. D clic en el icono de Expresiones.

D clic en Nueva para crear una expresin.

Copyright 2014 - Bizagi

1148

3. En la nueva ventana, 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 el cdigo interno, el cual es un atributo de la entidad de medio de
transporte.

Copyright 2014 - Bizagi

1149

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)
{
94;

Copyright 2014 - Bizagi

1150

}
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.

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 Filtros Avanzados 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 utilizaremos sentencias de SQL (AND, OR, LIKE, <>, IN, etc).

Consideraciones
No se soportan filtros dentro de filtros.

Copyright 2014 - Bizagi

1151

Ejemplos de Filtros con expresiones


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. As 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 Proveedor seleccionado, 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 pestaa Avanzado.
D clic en el icono expresin ( ) dentro del campo Filtro.

Copyright 2014 - Bizagi

1152

D clic en Nuevo para crear una expresin.

2. Una nueva ventana mostrar el editor de expresiones. Cree un mdulo de expresin.

Copyright 2014 - Bizagi

1153

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.

Copyright 2014 - Bizagi

1154

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 2014 - Bizagi

1155

Filterstring=Condition1 + " OR "+ Condition2;


6. Finalmente, retorne el filtro de la siguiente manera:

Filterstring;
D clic en OK 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 WFUser, 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 Asignar a, por lo que este control debera
mostrar nicamente los usuarios que posean el rol de Tcnico de Soporte.
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:

Copyright 2014 - Bizagi

1156

idUser IN (idTech1,idTech2,idTech3....idTechN)
Donde idUser 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 Filtro.

D clic en Nuevo para crear una expresin.

Copyright 2014 - Bizagi

1157

2. En la expresin principal, cree mdulos de expresin y un mdulo For 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.

Copyright 2014 - Bizagi

1158

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 2014 - Bizagi

1159

4. Obtenga la lista de usuarios que poseen el Rol buscado utilizando la funcin Get users in Role que
se encuentra en la categora Usuarios de la lista de funciones.

Recuerde que usted puede obtener el identificador del Rol deseado utilizando la opcin Buscar 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.

Copyright 2014 - Bizagi

1160

En este caso, el Id del Rol Tcnico de Soporte 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).

Copyright 2014 - Bizagi

1161

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 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

Copyright 2014 - Bizagi

1162

//Si el usuario actual no es el primer usuario de la lista


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 OK para guardar los cambios.

Ejemplos de reglas de negocio


Los siguientes ejemplos representan los ejemplos ms comunes en las soluciones de Bizagi.
Muchos de ellos usan XPath y el API de Bizagi.
Mostrar validaciones al usuario final
Definir la duracin de tareas y temporizadores
Adicionar y remover elementos de una relacin

Copyright 2014 - Bizagi

1163

Acceder al isimo registro de una coleccin


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

Mostrar validaciones al usuario final


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 ThrowValidationError. 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 ThrowValidationError se encuentra en la categora Validacin de datos.

Copyright 2014 - Bizagi

1164

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 ThrowValidationError.
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 Vacaciones.

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 ThrowValidationError, La fecha de regreso debe ser
mayor que la fecha de salida.

Copyright 2014 - Bizagi

1165

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.

Mostrar validaciones localizadas


En algunos casos puede ser necesario localizar los mensajes de validacin con el fin de mostrarse de

Copyright 2014 - Bizagi

1166

acuerdo al idioma de los usuarios.


Esto puede hacerse utilizando Recursos extendidos.
Suponga que el mensaje de validacin de la Solicitud de Vacaciones debe mostrarse en el idioma de
solicitante. Para hacerlo, siga los pasos descritos a continuacin:
1. Desde la Vista de Mdulos cree un Recursos extendidos y defina la localizacin para los idiomas
deseados.

2. Vaya al cuarto paso del Asistente de Bizagi y cree una expresin a la salida de la tarea Registrar
Solicitud de Vacaciones.
En un elemento de expresin, defina la condicin requerida para mostrar el mensaje de validacin tal
como se hizo en el ejemplo anterior.

Copyright 2014 - Bizagi

1167

3. Utilice la funcin Me.Case.WorkingCredential.UserProperties para obtener el idioma del usuario


solicitante.

4. Utilice la funcin CHelper.GetStringExtended para obtener el mensaje de validacin en el idioma


requerido. Esta funcin utiliza tres parmetros:
Parmetro 1: Nombre del Recurso Extendido.
Parmetro 2: Mensaje por defecto (Mostrado si el recurso no est localizado en idioma
especificado).
Parmetro 3: Idioma.

Copyright 2014 - Bizagi

1168

5. Finalmente utilice la funcin CHelper.ThrowValidationError para mostrar el mensaje de validacin.

if (<VacationRequest.LeavingDate>>=<VacationsRequest.ReturningDate>)
{
//Obtenga el idioma del usuario.
Lang=Me.Case.WorkingCredential.UserProperties["language"];
//Obtenga el mensaje localizado.
LocalizedMessage=
CHelper.GetStringExtended("ReturningDateValidation",Returning Date cannot
be less than the Leaving Date,Lang);
//Muestre el mensaje localizado.
CHelper.ThrowValidationError(LocalizedMessage):
}

Validacin de Datos

Validar si un atributo o variable esta vaco


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 un atributo o variable esta vaco, usted puede usar la funcin CHelper.IsEmpty. Esta

Copyright 2014 - Bizagi

1169

funcin devuelve Verdadero si el objeto especificado como parmetro (Variable) esta vaco; de lo
contrario devuelve Falso.
La sintaxis de la funcin es:

CHelper.IsEmpty(Variable) ;
Cree una expresin como una accin a la entrada de la actividad Autorizar Compra.

Utilice la funcin CHelper.IsEmpty 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.
are:" + <PurchaseRequest.RejectionComments>;
}

The

reasons

Validar si un atributo o variable es nulo (CHelper.IsNull)


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.

Copyright 2014 - Bizagi

1170

Para validar si un atributo o variable es nula, usted puede usar la funcin CHelper.IsNull. Esta funcin
devuelve Verdadero si el objeto especificado como parmetro (Variable) es nulo; de lo contrario
devuelve Falso.
La sintaxis de la funcin es:

CHelper.IsNull(Variable) ;
Cree una expresin como una accin a la entrada de la actividad Autorizar Compra.

Utilice la funcin CHelper.IsNull para evaluar si se ingresaron comentarios de rechazo. Defina el


mensaje a enviar de acuerdo al resultado de la evaluacin anterior.

//Evala si los comentarios de rechazo han sido agregados


if CHelper.IsNull(<PurchaseRequest.RejectionComments>)
{
<PurchaseRequest.Message>="Your request has been approved"

Copyright 2014 - Bizagi

1171

}
else
{
<PurchaseRequest.Message>="Your request has been rejected. The reasons
are:" + <PurchaseRequest.RejectionComments>;
}

NO
USE
las
siguientes
sentencias:
<idRequest.ValueToCompare>==null
<idRequest.ValueToCompare>!=null
Tambin puede usar la funcin BAIsBlank: BAIsBlank(<Request.ValueToCompare>)

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 de
Definir la duracin de
Definir la duracin de
Definir la duracin de
Definir la duracin de
horaria de un usuario

una tarea - con un tiempo


una tarea - con una fecha determinada
un temporizador
un temporizador adjunto a una actividad
una tarea o temporizador considerando el esquema horario de trabajo y zona

Definir la duracin de una tarea 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.
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.

Copyright 2014 - Bizagi

1172

1. En el cuarto paso del Asistente (Reglas de Negocio), seleccione la opcin Acciones de la actividad.
D clic en la tarea en la cual, la duracin ser calculada y agregue una expresin Al Entrar.

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
momento por los usuarios finales en el Portal de Trabajo.

Copyright 2014 - Bizagi

1173

3. Determine si la solicitud es nacional o internacional


Asigne la duracin del elemento utilizando el vocabulario. Utilice la funcin Case Duration de la
categora Fechas y Tiempos.

Copyright 2014 - Bizagi

1174

La siguiente imagen muestra el cdigo de la expresin.

//Identificar si el destino es nacional


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 de una tarea 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 basado en el tipo de localidad de la solicitud
(Viaje nacional o internacional), el administrador va a tener hasta un da antes de la partida (Fecha de
Salida) para reservar el vuelo y el hotel.

Copyright 2014 - Bizagi

1175

1. En el cuarto paso del Asistente (Reglas de Negocio), seleccione la opcin Acciones de la actividad.
D clic en la tarea en la que se calcular la duracin y cree una expresin Al Entrar.

2. Declare las variables necesarias:


En el ejemplo necesitamos dos variables de tipo date time.
LeavingDate: Guarda el atributo Fecha de salida.
FixedDate: Guarda la fecha lmite derivada, se utilizar para definir la duracin de la tarea.

Copyright 2014 - Bizagi

1176

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.

La duracin de la tarea ser definida cmo un da antes deLeavingDate .


Para calcular la fecha, se debe restar un da a la fecha en la variable LeavingDate.
El resultado debe ser asignado en la variable FixedDate.

Copyright 2014 - Bizagi

1177

4. Para definir la duracin de la tarea vamos a utilizar la funcin Case estimated solution date la cual se
encuentra en la categora Fechas y Tiempos, como se muestra a continuacin.

La siguiente imagen muestra el cdigo de la expresin:

Copyright 2014 - Bizagi

1178

//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;

Definir la duracin de un temporizador


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.

Copyright 2014 - Bizagi

1179

Para configurar la duracin del temporizador siga los siguientes pasos:


1. En el cuarto paso del Asistente (Reglas de Negocio) seleccione la opcin Acciones de la actividad.
D clic en el evento temporizador donde se va a calcular la duracin y cree una expresin Al Entrar.

2. Declare las variables necesarias:


LeavingDate: Guarda el atributo Fecha de salida.
FixedDate: Guarda la fecha lmite derivada, se utilizar para definir la duracin del temporizador.

Copyright 2014 - Bizagi

1180

3. Cree una expresin para asignar la duracin.


Lo primero que debemos hacer es guardar la fecha de salida desde el atributo Fecha de Salida en el
Modelo de Datos. El valor se guardar en la variable que hemos declarado anteriormente.

La duracin del temporizador ser asignada como un da antes de LeavingDate.


Para obtener esta fecha, restamos un da de la fecha guardada en la variable LeavingDate.
Luego se debe guardar el resultado en la variable FixedDate.

Copyright 2014 - Bizagi

1181

4. Para definir la duracin del temporizador, vamos a utilizar la funcin Case estimated solution date la
cual se encuentra en la categora Fechas y Tiempos.

La siguiente imagen muestra el cdigo de la expresin.

Copyright 2014 - Bizagi

1182

//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;

La duracin de los temporizadores se definen de la misma forma que la duracin de las tareas. En
ambos casos se utiliza la expresin Me.Duration (x minutos) o Me.EstimatedSolutionDate (fecha
determinada) dependiendo de las condiciones del negocio.

Definir la duracin de temporizadores adjuntos a una actividad


En el Proceso de Solicitud de viajes, suponga que 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.

Copyright 2014 - Bizagi

1183

Para configurar la duracin del temporizador siga los siguientes pasos:


1. En el cuarto paso del Asistente seleccione la opcin Acciones de la actividad.
D clic en el evento temporizador en el cual se calcular la duracin y cree una expresin Al Entrar.

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).

Copyright 2014 - Bizagi

1184

Una constante ha sido definida anteriormente para este caso (BookingDuration). Esta constante puede
ser modificada en el Portal de Trabajo en cualquier momento.

3. Para definir la duracin utilice la funcin Timer Event Duration.

Copyright 2014 - Bizagi

1185

Obtenga el valor del vocabulario constante utilizando la funcin ResolveVocabulary de la categora


Miscelneo. como se muestra a continuacin.

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");

Copyright 2014 - Bizagi

1186

Definir la duracin de una tarea o temporizador considerando el


esquema horario de trabajo y zona horaria de un usuario
Agility Corp gestiona las quejas y reclamos de sus clientes a travs de Bizagi. La compaa ha
establecido que un agente de servicio al cliente puede emplear un mximo de cuatro horas para dar
respuesta a una queja o reclamo. Como los agentes trabajan en diferentes turnos y en diferentes
lugares, la fecha de vencimiento de la tarea asociada a la respuesta del caso, se define considerando
el esquema horario de trabajo de la compaa y la zona de trabajo del agente.
Bizagi utiliza un mtodo denominado Me.EstimatedSolutionDate, que asigna la fecha de vencimiento de
una actividad. Lo utilizaremos junto con otro mtodo para considerar la zona horaria del usuario.
1. En el cuarto paso del Asistente de Procesos (Reglas de negocio), seleccione Acciones de Actividad.
Haga clic en la tarea a la cual se asignar la duracin y cree una expresin a la entrada.

2. Cree una expresin.


Primero obtenga el id del usuario del agente utilizando la funcin id del usuario actual

Copyright 2014 - Bizagi

1187

3. Para definir la duracin de la tarea, utilice la funcin Fecha estimada de solucin del caso, en la
categora Fecha & Hora

Copyright 2014 - Bizagi

1188

4. Utilice la funcin Calcular una fecha considerando el esquema de horario de trabajo y zona horaria
del usuario para obtener la fecha de vencimiento de la tarea.

La sintaxis de esta funcin es:

CHelper.getEstimatedDateFromUserDateTime(UserId,iDuration)
Incluya los parmetros de la funcin. El primero es el id del agente que se obtuvo previamente. El
segundo, el tiempo que el agente tiene para completar la tarea.
El cdigo de la expresin es el siguiente:

Copyright 2014 - Bizagi

1189

Observe que la expresin anterior convierte las horas en minutos.


La conversin es requerida debido a que el parmetro iDuration espera la duracin en minutos. El
total de minutos en 4 horas se calcula usando la formula: 60 minutos en una hora multiplicado por 4
horas (i.e. 60*4)
//Obtenga el id del agente
UserId=Me.Case.WorkingCredetial.UserId
//Asigne la duracin a la tarea
Me.EstimatedSolutionDate = CHelper.getEstimatedDateFromUserDateTime(UserId,
60*4);

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 la fecha de hoy a un atributo de tipo fecha.
Comparar fechas
Restar fechas
Restar fechas de acuerdo al esquema de trabajo de un usuario
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.

Copyright 2014 - Bizagi

1190

En el ejemplo vamos a utilizar operaciones entre fechas para:


Asignar la fecha de hoy como fecha de la solicitud (atributo RequestDate)
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 Request Date, seleccione la opcin Acciones de la actividad del
paso cuatro del asistente.
D clic en la actividad donde desea agregar la expresin.

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.

Copyright 2014 - Bizagi

1191

Asigne la fecha de hoy al atributo utilizando la funcin Today de la categora Fechas y tiempos.

La expresin debe lucir de la siguiente forma:

Copyright 2014 - Bizagi

1192

<VacationRequest.RequestDate>=DateTime.Today;
Clic en Ok para guardar los cambios.

Comparar Fechas

En este punto es necesario validar que la fecha de regreso de las vacaciones sea mayor a la fecha de
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.
D clic en la tarea donde la accin ser ejecutada y cree una expresin.

2. En el elemento de expresin, cree la comparacin utilizando los operadores menor que, mayor que
o igual que (<,> o =).

Copyright 2014 - Bizagi

1193

3. Cree la condicin IF para comparar los atributos.

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 Throw validation error de la categora Validacin de datos para configurar la
validacin.

Copyright 2014 - Bizagi

1194

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.

Copyright 2014 - Bizagi

1195

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 mayor 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.
D clic en la actividad donde se ejecutar la accin y cree una Expresin.

2. En un mdulo de expresin cree un condicional if. Evale si la fecha de regreso es un da laboral

Copyright 2014 - Bizagi

1196

utilizando la funcin IsWorkingDay de la categora Validacin de datos.

Utilice como parmetro de entrada la fecha de regreso (ReturningDate) del modelo de datos.

La funcin IsWorkingDay, regresar verdadero si la fecha es un da laboral, de lo contrario regresa


falso.

Copyright 2014 - Bizagi

1197

//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 laboral para un usuario especfico


En un Proceso de Solicitud de Viaje usted puede iniciar un caso en la actividad de Registro de Solicitud.
Usted debe 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 funcin
CHelper.IsWorkingDayForUser. Este mtodo devuelve Verdadero si un da especfico es un da laboral
de acuerdo al esquema de trabajo del usuario. 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 Registrar solicitud.

Copyright 2014 - Bizagi

1198

Use la funcin IsWorkingDayForUser 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

Copyright 2014 - Bizagi

1199

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
CHelper.IsWorkingMinute. 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 IsWorkingMinute 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 2014 - Bizagi

1200

//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.
Seleccione la actividad donde se ejecutar esta accin y cree una expresin Al Guardar de la misma.

Copyright 2014 - Bizagi

1201

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 2014 - Bizagi

1202

4. La diferencia de fechas se guardar en un atributo del modelo de datos


NumberofBusinessDaysReq. Utilice la opcin modelo de datos para incluir el atributo.

llamado

5. Utilice la funcin GetEffectiveDuration de la categora Fechas y tiempos para calcular la diferencia


de fechas.

Copyright 2014 - Bizagi

1203

Los parmetros de la funcin son: una fecha de inicio (Start date) y una fecha de fin (End date).
En este caso, estas fechas son las variables StartDate y FinalDate declaradas previamente.

//Inicializar variables
Start=<VacationRequest.LeavingDate>;
End=<VacationsRequest.ReturningDate>;
//Calcular los das de la solicitud y guardarlos en un atributo
<VacationRequest.NumberofBusinessDaysReques>=CHelper.getEffectiveDuration(M
e,Start,End)/480;
Note que la expresin previa es dividida por 480.
La funcin retorna la diferencia en minutos; por lo tantom, el resultado se debe convertir a das. Por
defecto, 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. Si el resultado es requerido en minutos, la divisin
puede ser omitida.

El clculo 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 Number of
business days requested.

Copyright 2014 - Bizagi

1204

Resta de fechas de acuerdo al esquema de trabajo de un usuario


El siguiente ejemplo ilustra cmo encontrar la diferencia entre dos fechas teniendo en cuenta el
esquema de trabajo de un usuario especfico: en das, aos, horas o minutos. La funcin utilizada para
el ejemplo retorna la diferencia de tiempo considerando solamente das laborales para dicho usuario.
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.
Seleccione la actividad donde se ejecutar esta accin y cree una expresin Al Guardar de la misma.

2. Declare las variables StartDate y FinalDate, dando clic en la opcin Variables y luego seleccione la
opcin Nuevo.

Copyright 2014 - Bizagi

1205

3. Inicialice las variables con los valores de los atributos correspondientes.

4. La diferencia de fechas se guardar en un atributo del modelo de datos


NumberofBusinessDaysReq. Utilice la opcin modelo de datos para incluir el atributo.

llamado

5. Utilice la funcin GetEffectiveDurationForUser de la categora Fechas y tiempos para calcular la


diferencia de fechas.

Copyright 2014 - Bizagi

1206

Los parmetros de la funcin son: id del Usuario (idUser), una fecha de inicio (Start date) y una fecha
de fin (End date).
En este caso el usuario es el solicitante de las vacaciones. La fecha de inicio y de fin sern las variables
declaradas anteriormente.

//Inicializar variables
Start=<VacationRequest.LeavingDate>;
End=<VacationsRequest.ReturningDate>;
//Calcular los das de la solicitud y guardarlos en un atributo
<VacationRequest.NumberofBusinessDaysReques>=CHelper.getEffectiveDurationFo
rUser(<VacationRequest.Requester>,Start,End)/480;

Copyright 2014 - Bizagi

1207

Note que la expresin previa es dividida por 480.


La funcin retorna la diferencia en minutos; por lo tantom, el resultado se debe convertir a das. Por
defecto, 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. Si el resultado es requerido en minutos, la divisin
puede ser omitida.

El clculo se realiza considerando el esquema laboral del usuario especificado. Es decir, la diferencia
de fechas (desde la fecha de inicio hasta la fecha de fin) excluir los periodos de tiempo no
laborales de dicho usuario.

Luego de que la expresin ejecute el clculo, el valor podr observarse en el campo Number of
business days requested.

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.

ResultingDate=Date.AddDays(Value);
Otras funciones .Net que permiten la adicin de horas, meses o aos:
ResultingDate=Date.AddHours(Value);
ResultingDate=Date.AddMonths(Value);
ResultingDate=Date.AddYears(Value);
Si quiere restar horas, das, meses o aos, utilice la misma funcin pero con valores negativos:
ResultingDate=Date.AddDays(-Value);
Para establecer la duracin de una tarea utilice la funcin Estimated Solution date.
1. En el cuarto paso del Asistente seleccione la opcin Acciones de la actividad.

Copyright 2014 - Bizagi

1208

Seleccione la actividad donde se ejecutar esta accin y cree una expresin Al Guardar de la misma.

2. Declare dos variables de tipo date time.


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.

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 ReturningDate.

Copyright 2014 - Bizagi

1209

4. La fecha lmite de la tarea. Se debe agregar cinco das a la fecha guardada en la variable
ReturningDate.
El resultado ser asignado a la variable FixedDate.

5. Asigne la duracin de la tarea utilizando la funcin Estimated solution date de la categora Fechas y
tiempos.
En la siguiente imagen muestra la expresin:

Copyright 2014 - Bizagi

1210

//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;
D clic en Ok para guardar cambios.

Calcular una fecha en base al esquema de trabajo


Suponga que necesita calcular una fecha con 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 getEstimatedDate, 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 getEstimatedDate de la categora Fechas y tiempos.

Copyright 2014 - Bizagi

1211

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).

Copyright 2014 - Bizagi

1212

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;

Calcular una edad


Es posible obtener el da, mes o ao especifico de una fecha guardada en un atributo. Esto es muy til
en situaciones donde se necesita realizar clculos con 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, con base a la fecha de nacimiento almacenada
en la entidad Empleado.

1. Defina una expresin en la actividad donde se quiere calcular la edad del empleado.

Copyright 2014 - Bizagi

1213

2. En el editor de expresiones, agregue cuatro variables como se muestra a continuacin.

3. Asigne el valor del atributo DateofBirth a la variable BirthDate.


Del mismo modo se asignar la fecha actual a la variable TodayDate.

Copyright 2014 - Bizagi

1214

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 YearToday (ao de la fecha de
hoy), YearBirth (ao de la fecha de nacimiento)

Reste los dos aos como se muestra a continuacin:

Copyright 2014 - Bizagi

1215

//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:

Copyright 2014 - Bizagi

1216

//Validacin de cumpleaos
if (BirthDate<TodayDate)
{
//Calculo de la edad
<VacationRequest.Employee.Age>=YearToday-YearBirth;
}

Realizar operaciones matemticas


Bizagi ofrece funciones que le permiten realizar operaciones matemticas. Este grupo de funciones se
invocan a partir de la sentencia:

CHelper.Math.
Las funciones matemticas se encuentran dentro de la categora Matemticas del Editor de funciones.

Copyright 2014 - Bizagi

1217

A continuacin mostraremos cmo utilizar las funciones matemticas en Bizagi:

ABS
Esta funcin devuelve el valor absoluto de un nmero.

CHelper.Math.Abs(Number)
El parmetro de esta funcin puede definirse como un XPath, variable o nmero.
Consideraciones
El parmetro de entrada debe ser de tipo double.
Los tipos de atributo soportados como parmetro de entrada XPath (o XPaths almacenados en
variables) son: entero, moneda, flotante, real.
La funcin devuelve error si evala un parmetro no definido o vaco.
Use la funcin isNaN para validar si el parmetro usado es un nmero.

Copyright 2014 - Bizagi

1218

Ejemplo
En un Proceso de reporte de gastos un empleado registra todos los gastos incurridos en un viaje de
negocios. Si los gastos son superiores a los aprobados, la diferencia deber ser descontada de la
nmina del empleado. Como esta diferencia es negativa pero la cantidad de descuento tiene que ser
positiva, es necesario utilizar la funcin Abs:

//evala si los gastos registrados son mayores a los gastos aprobados


If (<ExpensesReport.TotalExpenses> > <ExpensesReport.ApprovedExpenses>)
{
//Si lo son, obtenga el valor absoluto de la diferencia
<ExpensesReport.AmountToDiscount> =
CHelper.Math.Abs(<ExpensesReport.TotalExpenses> <ExpensesReport.ApprovedExpenses>)
}else
//De lo contrario asigne 0 al monto a descontar de nmina
<ExpensesReport.AmountToDiscount>=0
}

Average
Esta funcin obtiene el promedio (media aritmtica) de un conjunto de nmeros.

CHelper.Math.Average([Number1,Number2,...])
El parmetro de esta funcin es un arreglo definido entre llaves
variables o nmeros.

[], que puede contener XPaths,

Consideraciones
El parmetro de entrada debe ser un arreglo de datos tipo double.
Los tipos de atributo soportados como parmetros de entrada XPath (o XPaths almacenados en
variables) son: entero, moneda, flotante, real.
La funcin devuelve error si evala un arreglo vaco.
La funcin devuelve error si alguno de los elementos del arreglo es muy grande o vaco.
Tenga cuidado al definir la entrada de la funcin para evitar que se muestren errores a los usuarios
finales.
Use la funcin isNaN para validar si los parmetros usados son nmero.
Ejemplo

Copyright 2014 - Bizagi

1219

En un Proceso de solicitud de compra, la estimacin del precio de un producto se realiza con base en
las tres ltimas compras del mismo. Los valores de compra se promedian para obtener una
estimacin. En Bizagi esta estimacin se puede obtener usando la funcin Average:

//Obtenga el precio estimado promediando los tres ltimos precios de compra


<Product.EstimatedPrice> =
CHelper.Math.Average([<Product.Price1>,<Product.Price2>,<Product.Price3>])
//Forma alternativa obteniendo el arreglo en una variable antes de usar la funcin
ArrayVariable=[<Product.Price1>,<Product.Price2>,<Product.Price3>]
<Product.EstimatedPrice> = CHelper.Math.Average(ArrayVariable)

Ceiling
Esta funcin redondea una nmero hacia arriba.

CHelper.Math.Ceiling(Number)
El parmetro de esta funcin puede ser definido como un XPath, variable o nmero.
Consideraciones
El parmetro de entrada debe ser de tipo double.
Los tipos de atributo soportados como parmetro de entrada XPath (o XPaths almacenados en
variables) son: entero, moneda, flotante, real.
Use la funcin isNaN para validar si el parmetro usado es un nmero.
Ejemplo
Una empresa transportadora de arena calcula el nmero de camiones necesarios para transportar una
carga especfica, como el cociente del peso de la carga sobre la capacidad de carga de los camiones.
Como el resultado obtenido puede ser fraccionario (que no tiene sentido en este contexto porque no
se puede contratar una fraccin de un camin), este resultado debe ser redondeado hacia arriba. En
Bizagi esto se puede hacer mediante el uso de la funcin Ceiling:

Copyright 2014 - Bizagi

1220

//Obtenga el nmero necesario de camiones


NumberofTrucks = <Freight.Weight>/<Freight.Trucks.WeightCapacity>;
//Redondee el nmero de camiones hacia arriba
<Freight.RequiredTrucks> = CHelper.Math.Ceiling(NumberofTrucks);

Exp
Esta funcin devuelve e (la base de los logaritmos naturales) elevado a una potencia dada.

CHelper.Math.Exp(Number)
El parmetro de esta funcin puede ser definido como un XPath, variable o nmero.
Consideraciones
Los tipos de atributo soportados como parmetro de entrada XPath (o XPaths almacenados en
variables) son: entero, moneda, flotante, real.
Use la funcin isNaN para validar si el parmetro usado es un nmero.
EL RESULTADO DE ESTA FUNCIN DEBE SER GUARDADO EN UN ATRIBUTO TIPO FLOAT.
Ejemplo
Un Laboratorio utiliza Bizagi para gestionar sus investigaciones mdicas. En estas investigaciones el
laboratorio comnmente debe realizar estimaciones de crecimiento de colonias bacterianas. Estos
crecimientos se suelen modelar usando la siguiente relacin exponencial:

Donde No es la poblacin inicial, e es la base de los logaritmos naturales, k es una constante y N es la


poblacin en el momento t.
Para calcular la poblacin final de bacterias en Bizagi, se puede utilizar la funcin Exp. Esta funcin
recibe la potenciar como parmetro:

Copyright 2014 - Bizagi

1221

//Obtenga los parmetros de la frmula en variables


No=<LabResearch.Bacteria.InitialPopulation>
k=<LabResearch.Bacteria.Growthconstant>
t=<LabResearch.Bacteria.TimeofEstimation>
//Use la frmula para obtener la poblacin final
<LabResearch.Bacteria.Finalpopulation>=No*CHelper.Math.Exp(k*t)

Floor
Esta funcin redondea un nmero hacia abajo.

CHelper.Math.Floor(Number)
El parmetro de esta funcin puede ser definido como un XPath, variable o nmero.
Consideraciones
El parmetro de entrada debe ser de tipo double.
Los tipos de atributo soportados como parmetro de entrada XPath (o XPaths almacenados en
variables) son: entero, moneda, flotante, real.
Use la funcin isNaN para validar si el parmetro usado es un nmero.
Ejemplo
En un Proceso de solicitud de compra, la estimacin del precio de un producto se realiza con base en
las tres ltimas compras del mismo. Los valores de compra se promedian para obtener la estimacin.
El departamento de compras ha decidido redondear este valor hacia abajo para obtener una
estimacin entera. Para este caso, se puede utilizar la funcin Floor:

Copyright 2014 - Bizagi

1222

//Obtenga el precio estimado promediando los precios de las tres ltimas compras
EstimatedPrice =
CHelper.Math.Average([<Product.Price1>,<Product.Price2>,<Product.Price3>]);
//Obtenga la parte entera del precio estimado
<Product.IntEstimatedPrice> = CHelper.Math.Floor(EstimatedPrice);

IsNaN
Esta funcin evala si un parmetro no es un nmero:
Devuelve verdadero si el parmetro no es un nmero.
Devuelve falso si el parmetro es un nmero.

CHelper.Math.IsNaN(Parameter)
El parmetro de esta funcin puede ser definido como un XPath, variable o nmero.
Consideraciones
Los tipos de atributo soportados como parmetro de entrada XPath (o XPaths almacenados en
variables) son: entero, moneda, flotante, real.
Ejemplo
Suponga que desea evaluar si los parmetros a utilizar en una funcin Math son nmeros, con el fin de
evitar errores y resultados incoherentes. Para hacerlo usted puede utilizar la funcin IsNaN:

Copyright 2014 - Bizagi

1223

//Evale si los parmetros a utilizar en la funcin Average son nmeros


Number1IsNotaNumber=CHelper.Math.IsNaN(<Product.Price1>);
Number2IsNotaNumber=CHelper.Math.IsNaN(<Product.Price2>);
If (Number1IsNotaNumber==true || Number1IsNotaNumber==true)
{
//Si alguno no es nmero, muestre un mensaje de error
CHelper.ThrowValidationError ("The parameters of the Average function must
be numbers")
}else{
//Si ambos son nmeros aplique la funcin
CHelper.Math.Average([<Product.Price1>,<Product.Price2>]);

Ln
Esta funcin devuelve el logaritmo natural de un nmero.

CHelper.Math.Ln(Number)
El parmetro de esta funcin puede ser definido como un XPath, variable o nmero.
Consideraciones
El parmetro de entrada debe ser de tipo double.
Los tipos de atributo soportados como parmetro de entrada XPath (o XPaths almacenados en
variables) son: entero, moneda, flotante, real.
La funcin devuelve un error si el parmetro de entrada es menor o igual a 0.
La funcin devuelve un error si el parmetro de entrada es muy grande o no est definido.
Use la funcin isNaN para validar si el parmetro usado es un nmero.
Ejemplo
Un Laboratorio utiliza Bizagi para gestionar sus investigaciones mdicas. En estas investigaciones el
laboratorio comnmente debe realizar estimaciones de crecimiento de colonias bacterianas. El tiempo

Copyright 2014 - Bizagi

1224

que una colonia necesita para lograr un crecimiento esperado se calcula mediante la siguiente
expresin:

Donde No es la poblacin inicial, e es la base de los logaritmos naturales, k es una constante y N es la


poblacin en el momento t.
Para calcular el tiempo en alcanzar la poblacin esperada de bacterias en Bizagi, usted puede utilizar
la funcin Ln:

//Obtenga los parmetros de la frmula en variables


No = <LabResearch.Bacteria.InitialPopulation>
N = <LabResearch.Bacteria.Finalpopulation>
k = <LabResearch.Bacteria.Growthconstant>
//Use la frmula para obtener el tiempo que una colonia necesita para alcanzar la poblacin esperada
<LabResearch.Bacteria.TimeofEstimation> = (CHelper.Math.Ln(N / No) / k);

Log10
Esta funcin devuelve el logaritmo en base 10 de un nmero.

CHelper.Math.Log10(Number)
El parmetro de esta funcin puede ser definido como un XPath, variable o nmero.
Consideraciones
El parmetro de entrada debe ser de tipo double.
Los tipos de atributo soportados como parmetro de entrada XPath (o XPaths almacenados en
variables) son: entero, moneda, flotante, real.

Copyright 2014 - Bizagi

1225

La funcin devuelve un error si el parmetro de entrada es menor o igual a 0.


La funcin devuelve un error si el parmetro de entrada es muy grande o no est definido.
Use la funcin isNaN para validar si el parmetro usado es un nmero.
Ejemplo
Un Banco ofrece variedad de productos a sus clientes. Cuando un cliente est interesado en un CDT
(Certificado de Depsito a Trmino fijo), es comn que pregunte por el tiempo necesario (el plazo)
que el dinero debe permanecer invertido para alcanzar una cantidad esperada, bajo la tasa de inters
ofrecida. Este trmino se puede calcular utilizando la siguiente frmula:

Donde n es el plazo necesario (en meses) que el capital inicial Po debe permanecer invertido para
lograr el capital deseado P a la tasa de inters i.
Para efectuar este clculo en Bizagi se puede utilizar la funcin Log10. Esta funcin recibe un nmero
como parmetro:

//Obtenga los parmetros de la frmula en variables


Po = <CDRequest.InvestedAmount>;
P = <CDRequest.DesiredAmount>;
i = <CDRequest.OfferedInterestRate>;
//Use la frmula para obtener trmino necesario
<CDRequest.RequiredTerm> = (CHelper.Math.Log10(P / Po) /
CHelper.Math.Log10(1+i));

Max
Esta funcin devuelve el valor mximo entre un conjunto de nmeros.

CHelper.Math.Max([Number1,Number2...])
Los parmetros de esta funcin pueden ser definidos como Xpaths, variables o nmeros y deben estar

Copyright 2014 - Bizagi

1226

contenidos entre braquets.


Consideraciones
Los parmetros de entrada deben ser de tipo double.
Los tipos de atributo soportados como parmetro de entrada XPath (o XPaths almacenados en
variables) son: entero, moneda, flotante, real.
La funcin devuelve un error si el parmetro de entrada es muy grande o no est definido.
Ejemplo
Una Solicitud de prstamo no se rechaza si el solicitante o codeudor poseen una puntuacin de riesgo
mayor a 600. Usted puede utilizar la funcin Max para evaluar cul es la mejor puntuacin de riesgo y
de acuerdo a esto definir si la solicitud es rechazada o no:

//Obtenga la mejor puntuacin de riesgo entre el solicitante y su codeudor


Bestscore=
CHelper.Math.Max([<LoanApplication.Applicant.Score>,<LoanApplication.Coborr
ower.Score>])
//Evalue si la mejor puntuacin es mayor o igual a 600
If (Bestscore>=600)
{
//Si lo es no rechace la solicitud
<LoanApplication.Rejected>= false;
}else
{
//De lo contrario rechace la solicitud
<LoanApplication.Rejected>= true;
}

Min
Esta funcin devuelve el valor mnimo entre dos nmeros.

CHelper.Math.Min([Number1,Number2])

Copyright 2014 - Bizagi

1227

Los parmetros de esta funcin pueden ser definidos como Xpaths, variables o nmeros y deben estar
contenidos entre braquets.
Consideraciones
Los parmetros de entrada deben ser de tipo double.
Los tipos de atributo soportados como parmetro de entrada XPath (o XPaths almacenados en
variables) son: entero, moneda, flotante, real.
La funcin devuelve un error si el parmetro de entrada es muy grande o no esta definido.
Use la funcin isNaN para validar si el parmetro usado es un nmero.
Ejemplo
Una Solicitud de prstamo se rechaza si el solicitante o codeudor poseen una puntuacin de riesgo
menor a 100. Usted puede utilizar la funcin Min para evaluar cul es la peor puntuacin de riesgo y
de acuerdo a esto definir si la solicitud es rechazada o no:

//Obtenga la peor puntuacin de riesgo entre el solicitante y su codeudor


Worstscore=
CHelper.Math.Min([<LoanApplication.Applicant.Score>,<LoanApplication.Coborr
ower.Score>])
//Evalue si la peor puntuacin es menor o igual a 100
If (Worstscore<=100)
{
//Si lo es rechace la solicitud
<LoanApplication.Rejected>= true;
}else
{
//De lo contrario no rechace la solicitud
<LoanApplication.Rejected>= false;
}

Module
Esta funcin devuelve el residuo de una divisin.

Copyright 2014 - Bizagi

1228

CHelper.Math.Module(Number,Divisor)
Los parmetros de esta funcin pueden ser definidos como XPaths, variables o nmeros.
Consideraciones
Los parmetros de entrada deben ser enteros.
El tipo de atributo soportado como parmetro de entrada XPath (o XPath almacenado en variable)
es entero.
La funcin devuelve un error si el Divisor es igual a 0.
Ejemplo
Suponga que en un Proceso se debe evaluar si un nmero es par. Para ello se puede utilizar la funcin
Module utilizando el nmero 2 como divisor. Si el resultado obtenido es igual a 0, entonces el nmero
es par.

//Obtenga el mdulo del nmero utilizando 2 como divisor


Module= CHelper.Math.Module(<Process.Numbertoevalate>,2)
//Evalue su el resultado es igual a 0.
If (Module==0)
{
//Si lo es, el nmero es par
<Process.IsPair>= true;
}else
{
//De lo contrario, el nmero es impar
<Process.IsPair>= false;
}

Percentage
Esta funcin devuelve el equivalente en porcentaje de un nmero.

CHelper.Math.Percentage(Number)

Copyright 2014 - Bizagi

1229

El parmetro de esta funcin puede ser definido como un XPath, variable o nmero.
Consideraciones
El parmetro de entrada debe ser de tipo double.
Los tipos de atributo soportados como parmetros de entrada XPath (o XPaths almacenados en
variables) son: entero, moneda, real ,flotante
La funcin devuelve un error si el parmetro de entrada es muy grande o no est definido.
Use la funcin isNaN para validar si el parmetro usado es un nmero.
Ejemplo
En un Proceso de solicitud de crdito, la informacin de las tasas de inters se muestra e ingresa en
las formas, como nmeros entre 0 y 100. Supongamos que en una actividad del Proceso se desea
calcular el monto a pagar por concepto de intereses de un perodo. El proceso no puede utilizar este
nmero entre 0 y 100 para realizar el clculo, por lo que este debe ser normalizado a un nmero entre
0 y 1. De esta manera se obtienen resultados coherentes. Para hacer esto en Bizagi, se puede utilizar la
funcin Percentage:

//Obtenga la tasa de inters (Entre 0 y 1)


RealInterestRate = CHelper.Math.Percentage(<CreditRequest.InterestRate>);
//Calcule el monto del inters
<CreditRequest.InterestAmount> = RealInterestRate *
<CreditRequest.RequestedAmount>;

Power
Esta funcin obtiene el resultado de un nmero elevado a una potencia.

CHelper.Math.Pow(Base,Power)
El parmetro de esta funcin puede ser definido como un Xpath, variable o nmero.
Consideraciones
Los parmetros de entrada deben ser de tipo double.

Copyright 2014 - Bizagi

1230

Los tipos de atributo soportados como parmetros de entrada XPath (o XPaths almacenados en
variables) son: entero, moneda, real, flotante
La funcin devuelve un error si la Base es muy grande y la Potencia es mayor a 0.
La funcin devuelve un error si la Base est entre 0 y 1 y la Potencia es muy grande o negativa.
La funcin devuelve un error si la Base no est entre 0 y 1 y la Potencia es muy grande.
La funcin devuelve un error si la Base es 0 y la Potencia es negativa.
La funcin devuelve un error si la Base o la Potencia no estn definidas.
Use la funcin isNaN para validar si el parmetro usado es un nmero.
Ejemplo
En un Proceso de solicitud de crdito un cliente desea saber cul sera el monto total que tendra que
pagar por un prstamo personal, despus de seis meses a una tasa de inters dada. Esta cantidad se
puede calcular utilizando la siguiente frmula:

Donde Po es el monto solicitado, i es la tasa de inters mensual y P es la cantidad en el mes n.


Para efectuar este clculo en Bizagi se puede utilizar la funcin Power. Esta funcin recibe dos
parmetros: nmero y potencia.
El monto solicitado y la tasa de inters son conocidos, por lo que el monto final puede ser fcilmente
calculado as:

//Obtenga los parmetros de la frmula en variables


Po=<CreditRequest.RequestedAmount>
i=<CreditRequest.InterestRate>
//Use la frmula para obtener el monto final
<CreditRequest.FinalAmount>=Po*CHelper.Math.Pow(1+i,6)

Quotient
Esta funcin devuelve la porcin entera de una divisin.

CHelper.Math.Quotient(Dividend,Divisor)

Copyright 2014 - Bizagi

1231

Los parmetros de esta funcin pueden ser definidos como XPaths, variables o nmeros.
Consideraciones
Los parmetros de entrada deben ser enteros.
El tipo de atributo soportado como parmetro de entrada XPath (o XPath almacenado en variables)
es entero.
La funcin devuelve error si el Divisor es igual a 0.
Use la funcin isNaN para validar si el parmetro usado es un nmero.
Ejemplo
Una compaa usa Bizagi para gestionar sus procesos logsticos. Uno de ellos es la gestin de
inventarios. En una de las actividades de este proceso es necesario calcular la capacidad de
almacenamiento de cajas de un almacn. Para su clculo, se introducen las dimensiones del almacn y
las cajas.
Como el resultado de un clculo normal devuelve un nmero fraccionario (que no tiene mucho sentido
en este contexto porque no se puede almacenar una fraccin de una caja), se puede utilizar la funcin
Quotient para obtener slo la parte entera del cociente.
La capacidad de almacenamiento del almacn puede ser calculado as:

//Obtenga el nmero de cajas que pueden ser almacenadas a lo ancho


WidthCapacity =
CHelper.Math.Quotient(<InventoryManagement.Warehouse.Width>,
<InventoryManagement.Boxes.Width>);
//Obtenga el nmero de cajas que pueden ser almacenadas a lo largo
LengthCapacity =
CHelper.Math.Quotient(<InventoryManagement.Warehouse.Length>,
<InventoryManagement.Boxes.Length>);
//Obtenga el nmero de cajas que pueden ser almacenadas a lo alto
HeightCapacity =
CHelper.Math.Quotient(<InventoryManagement.Warehouse.Height>,
<InventoryManagement.Boxes.Height>);
//Calcule el nmero total de cajas que pueden ser almacenados en la bodega
<InventoryManagement.Warehouse.Capacity> = WidthCapacity * LengthCapacity *
HeightCapacity;

Copyright 2014 - Bizagi

1232

Rand(from,to)
Esta funcin devuelve un nmero aleatorio entero entre dos nmeros.

CHelper.Math.Rand(ValueFrom,ValueTo)
Los parmetros de esta funcin pueden ser definidos como XPaths, variables o nmeros.
Consideraciones
Los parmetros de entrada deben ser enteros.
El tipo de atributo soportado como parmetro de entrada XPath (o XPath almacenado en variables)
es entero.
La funcin devuelve error si el parmetro ValueFrom es mayor al parmetro ValueTo.
Use la funcin isNaN para validar si el parmetro usado es un nmero.
Ejemplo
Una compaa usa Bizagi para rifar diferentes premios entre sus clientes. Cada cliente recibe un
nmero entre 0 y 100. Bizagi debe generar un nmero aleatorio entre los nmeros disponibles para
obtener un ganador.
Para implementar esta lgica se puede utilizar la funcin Rand:

//Genere el nmero ganador


<RaffleProcees.WinnerNumber> = CHelper.Math.Rand(0,100)

Rand()
Esta funcin devuelve un decimal aleatorio entre 0.0 a 1.0, y no tiene parmetros.

Copyright 2014 - Bizagi

1233

CHelper.Math.Rand()
Ejemplo
Supongamos que usted necesita generar un nmero aleatorio entre 10 y 20, con dos cifras decimales.
Usted tiene que usar dos funciones: una para generar un nmero aleatorio entre 10 y 20 y otra para
generar el nmero de decimales. A continuacin, puede aadir los dos resultados.

<Request.RandomNumber> = (CHelper.Math.Rand(10,20))+(CHelper.Math.Rand())

Round
Esta funcin reduce un nmero dado a un nmero especfico de decimales.

CHelper.Math.Round(Number,Decimalplaces)
Los parmetros de esta funcin pueden ser definidos como XPaths, variables o nmeros.
Consideraciones
El parmetro Number debe ser double.
El parmetro Decimalplaces debe ser entero.
Ejemplo
En un Proceso de reporte de gastos un empleado registra todos los gastos incurridos en un viaje de
negocios. Como los gastos pueden ser ingresados en diferente a la local, se debe realizar una
conversin. De acuerdo a la tasa de cambio, el monto convertido puede poseer varias cifras decimales
que no son muy significativas. Para redondear este monto a uno con un nmero significante de cifras
decimales (digamos 2) usted puede utilizar la funcin Round:

Copyright 2014 - Bizagi

1234

//Calcule los gastos en moneda local


ConvertedExpenses =
<ExpensesReport.ReportedExpenses>*<ExpensesReport.ExpensesCurrency.Exchange
Rate>;
//Redondee los gastos a un nmero significante de cifras decimales
<ExpensesReport.TotalExpenses> = CHelper.Math.Round(ConvertedExpenses,2);

Sqrt
Esta funcin obtiene la raz cuadrada de un nmero.

CHelper.Math.Sqrt(Number)
El parmetro de esta funcin puede ser definido como un XPath, variable o nmero.
Consideraciones
El parmetro de entrada debe ser de tipo double.
Los tipos de atributo soportados como parmetro de entrada XPath (o XPaths almacenados en
variables) son: entero, moneda, flotante, real.
La funcin devuelve error si evala un parmetro muy grande, no definido o vaco.
La funcin devuelve error si el parmetro es negativo.
Use la funcin isNaN para validar si el parmetro usado es un nmero.
Ejemplo
Una compaa usa Bizagi para gestionar sus procesos logsticos. Uno de ellos es la gestin de
inventario. En una de las actividades de este proceso es necesario para calcular la cantidad econmica
de pedido de un producto. Esta cantidad se puede calcular mediante el uso de la frmula siguiente:

Donde Q* es la cantidad ptima a ordenar, D es la demanda anual del producto, K es el costo fijo por
orden y h es el costo anual de almacenamiento por unidad.
Esta cantidad se puede calcular en Bizagi usando la funcin Sqrt:

Copyright 2014 - Bizagi

1235

//Obtenga los parmetros de la frmula en variables


D = <InventoryManagement.Demand>;
K = <InventoryManagement.OrderCost>;
h = <InventoryManagement.HoldingCost>;
//Calcule la cantidad econmica de pedido
<InventoryManagement.EconomicQuantityOrder> = CHelper.Math.Sqrt(2*D*K / h);

Truncate
Esta funcin trunca un nmero a un entero removiendo su parte decimal o fraccional.

CHelper.Math.Truncate(Number)
Consideraciones
El parmetro de entrada debe ser de tipo double.
Los tipos de atributo soportados como parmetro de entrada XPath (o XPaths almacenados en
variables) son: entero, moneda, flotante, real.
La funcin devuelve error si evala un parmetro muy grande, no definido o vaco.
Use la funcin isNaN para validar si el parmetro usado es un nmero.
Ejemplo
En un Proceso de solicitud de compra una estimacin del precio de un producto se realiza con base en
las tres ltimas compras del mismo. Los valores de compra se promedian para obtener la estimacin.
Probablemente esta estimacin tendr una parte decimal. Con el fin de obtener un valor entero, se
puede utilizar la funcin Truncate :

Copyright 2014 - Bizagi

1236

//Obtenga el precio estimado promediando los ltimos tres precios de compra


EstimatedPrice =
CHelper.Math.Average([<Product.Price1>,<Product.Price2>,<Product.Price3>]);
//Obtenga la parte entera del precio estimado
<Product.IntEstimatedPrice> = CHelper.Math.Truncate(EstimatedPrice);

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), tiene 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 2014 - Bizagi

1237

1. En el cuarto paso del Asistente seleccione la opcin Acciones de la actividad.


D clic en la tarea donde se ejecutar esta accin y cree una Expresin.

2. Ingrese el Nombre, Nombre visual y una descripcin de la expresin.

Copyright 2014 - Bizagi

1238

3. En el editor de expresiones, incluya las variables FirstString y SecondString, 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 2014 - Bizagi

1239

//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 Ok.
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 este 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:

Copyright 2014 - Bizagi

1240

1. Cree las siguientes variables en la expresin.

2. Aplique el mtodo .ToUpper 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 2014 - Bizagi

1241

actividad del proceso. El resultado se muestra en las siguientes imgenes.

Note que la expresin es asociada en la opcin Al Salvar. Una vez d 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 Substring dentro de la expresin.

Copyright 2014 - Bizagi

1242

El mtodo Substring tiene la siguiente sintaxis.


String.Substring(from position, to position);

Substring 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 (String.Substring(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>;

Copyright 2014 - Bizagi

1243

//Construir el texto concatenado con el mtodo Substring


Initials=FirstString.Substring(0,1)+" "+ SecondString.Substring(0,1);
//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 cabo 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 .Length el cual retorna un entero:
String.Length;
Para nuestro ejemplo, ser utilizada para establecer la condicin de la validacin as.

Copyright 2014 - Bizagi

1244

// 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 2014 - Bizagi

1245

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
Me.WorkingCredential.
Estas funciones se encuentran en la categora de Informacin del usuario actual.

Los siguientes son los mtodos disponibles para el usuario actual asignado:
Propiedades

Descripcin

Copyright 2014 - Bizagi

1246

AreaName

Retorna el nombre del rea del usuario actual.

FullName

Retorna el nombre completo del usuario.

IsInPosition

Retorna Verdadero si el usuario tiene una determinada posicin, falso de lo


contrario.

IsInRole

Retorna verdadero si el usuario tiene un role especifico, falso de lo


contrario.

IsInSkill

Retorna Verdadero si el usuario tiene una habilidad especifica, falso de lo


contrario.

UserId

Regresa el id del usuario.

UserProperties

Regresa el valor de una propiedad de usuario especificada.

Ejemplo
El siguiente ejemplo ilustra cmo utilizar las funciones anteriores:

Evaluar si el usuario asignado a la tarea actual tiene un rol especfico


Suponga un banco que tiene como misin hacer que el proceso de crdito sea ms eficiente: cuando
la solicitud es creada por una persona que tiene el rol de Pagador, el proceso no necesita pasar por la
actividad de Anlisis de Crdito.
Para evitar la actividad, el atributo booleano RequiereEstudio 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 2014 - Bizagi

1247

Copyright 2014 - Bizagi

1248

//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;
}

Obtener informacin del usuario que visualiza una Forma global o de resumen
En algunas ocasiones puede ser necesario identificar quin es el usuario que visualiza una Forma
global o de resumen. Esto es especialmente til en situaciones en que se debe mostrar u ocultar
alguna informacin segn propiedades especficas de un usuario (por ejemplo, un rol).
Para obtener esta informacin en formas globales o de resumen se puede utilizar el mtodo de
Credential con las mismas funciones del mtodo Me.WorkingCredential.

Copyright 2014 - Bizagi

1249

Supongamos que en un proceso de gestin de oportunidades de venta, la informacin de Clientes y


Partners slo se muestra a los miembros del equipo de ventas en el momento que consultan el estado
de un caso. El resto de la informacin se muestra a cualquier usuario.
Supongamos que los usuarios pertenecientes al equipo de ventas poseen un rol de Bizagi. Para
mostrar u ocultar la informacin de los Clientes y Partners en la forma global del proceso, se puede
utilizar una expresin de visibilidad.
Vaya a la Forma global y establezca una expresin como condicin de visibilidad para la informacin
del Cliente y el Partner.

Cree una expresin de script y agregue un elemento de expresin.


Use la funcin Credential.IsInRole para evaluar si el usuario visualizando la forma posee el role
requerido:

Copyright 2014 - Bizagi

1250

//Si la persona visualizando la forma Global posee el rol de Miembro del


equipo de ventas(id=100098)
if (Credential.IsInRole(10098)==true)
{
//Muestre la informacin
true;
}
//De lo contrario
else{
//Oculte la informacin
false;
}
Finalmente guarde la expresin.

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 Informacin del caso actual.

Copyright 2014 - Bizagi

1251

La informacin disponible para el caso actual es:

Propiedad

Descripcin

CaseId

Devuelve el id del caso actual.

CaseNumber

Devuelve el nmero de caso del caso


actual.

Creationdate

Devuelve la fecha de creacin del caso


actual.

ParentProcessId

Devuelve el id del proceso padre del


Subproceso actual.

ProcessState

Devuelve el estado del proceso del


caso actual. Este puede ser: Abortado,
Completo, Iniciado, No iniciado, En
ejecucin, Suspendido.

SolutionDate

Devuelve o asigna la fecha de solucin


para el caso actual.

getChildProcesses

Devuelve una coleccin con todos los


Subprocesos del caso actual.

getWorkItem()

Devuelve el Work Item relacionado a

Copyright 2014 - Bizagi

1252

una tarea dada del caso actual.

Ejemplos
Los siguientes ejemplos ilustrarn como usar estas funciones:
Obtener el 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


La funcin ParentProcessId devuelve el identificador del proceso padre de un Subproceso especfico.
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.

Todas las pruebas deben ser aprobadas para continuar con el proceso. De lo contrario, es decir, el
candidato debe ser rechazado.
Debido al rechazo, se ejecutar un evento llamado Cancelar Seleccin en el proceso padre, desde el
la actividad Proceso de Seleccin.

Copyright 2014 - Bizagi

1253

Para configurar el evento de cancelacin, haga lo siguientes:


1. En el cuarto paso del asistente, seleccione Acciones de la actividad.
Seleccione la actividad Cancelar proceso de seleccin encontrada en el Subproceso Realizar Test y
cree una expresin Al Entrar.

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 ParentProcessId de la categora Informacin del caso actual.

Copyright 2014 - Bizagi

1254

CHelper.setEvent(Me,Me.Case.ParentProcessId,"CloseSelection",null);
Finalmente guarde la expresin.

Obtener el id de los procesos hijos (Subprocesos) de un proceso.


Es posible obtener el identificador de un Subproceso relacionado a un proceso especfico utilizando la
funcin getSubProcessesId.
Esta funcin devuelve una lista con los identificadores de los Subprocesos 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 Actividades.
El Subproceso Realizar actividades es lanzado por cada actividad planeada. Simultneamente una
tarea permite al Gerente del Proyecto monitorear el progreso de cada actividad.

Copyright 2014 - Bizagi

1255

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 tambin necesita acceso.
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 para crear la expresin:

1. En el cuarto paso del asistente, seleccione Acciones de la actividad.


Seleccione la actividad Monitorear Actividades y cree una expresin Al Entrar. Esto ejecutar la
expresin en el mismo momento en que la instancia del Subproceso es creada.

2. Cree un elemento de expresin. Obtenga la lista de Subprocesos asociados en una variable


utilizando la funcin getSubProcessesid de la categora Informacin del caso actual.

Copyright 2014 - Bizagi

1256

3. Obtenga 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.

Copyright 2014 - Bizagi

1257

4. Agregue un operador FOR para recorrer la lista de los Subproceso.

5. Obtenga el id de cada Subproceso y utilcelo como primer parmetro en la funcin


CHelper.GrantCaseAccess. 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.

Copyright 2014 - Bizagi

1258

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.

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 getSiblingProcessesId.
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 Investigacin de Sospechosos 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.

Copyright 2014 - Bizagi

1259

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.

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.
Seleccione La tarea Cancelar actividades de la Investigacin en el Subproceso Investigacin de
sospechosos, cree una expresin Al entrar.

Copyright 2014 - Bizagi

1260

2. Cree un elemento de expresin. Obtenga la lista de los Subprocesos hermanos (otras


investigaciones) y guarde la variable utilizando la funcin getSiblingsProcessesId de la categora
Informacin del caso Actual.

El parmetro de la funcin es el identificador del proceso. Este (WfClassId) 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.

Copyright 2014 - Bizagi

1261

3. Agregue el operador FOR para recorrer la lista de los Subprocesos.

4. Obtenga el Id de cada Subproceso y utilcelo como primer parmetro de la funcin


CHelper.AbortProcess. 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.

Copyright 2014 - Bizagi

1262

//Obtener el id de los procesos hermanos.


var SiblingProcesses=CHelper.getSiblingProcessesId(Me,57);
//Recorra la lista
for(var Records=0; Records < SiblingProcesses.Count; Records++)
{
//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 thereAreOpenProcesses.
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(Me,CaseNumber)
Imagine un Gerente de proyectos. Las actividades necesarias para completar el proyecto son
planeadas en la tarea Planear proyecto.
El Subproceso Realizar Actividades es lanzado por cada actividad planeada. Simultneamente, una
actividad habilita al Gerente del Proyecto para monitorear el estado de cada actividad.

Copyright 2014 - Bizagi

1263

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
no se cierre el caso antes de completarlas.

Para validar que todas las actividades hayan terminado, usaremos la funcin thereAreOpenProcesses.
1. Vaya al cuarto paso del Asistente de Proceso y seleccione Acciones de la Actividad.
D clic en el monitor de actividades y cree una Expresin a la salida.

2. Cree un mdulo de expresin. Evale si hay actividades pendientes utilizando la funcin


thereAreOpenProcesses la cual se encuentra en la categora de Informacin del caso actual. Asigne
Me.Case.Id como segundo parmetro.
3. Cuando hay actividades pendientes, la funcin thereAreOpenProcesses retornar verdadero. En este
caso se deber lanzar una validacin. Incluya el mensaje a mostrar.

Copyright 2014 - Bizagi

1264

if(CHelper.thereAreOpenProcesses(Me.Case.Id)==true)
{
CHelper.ThrowValidationError("There are pending activities. You cannot
close the case");
}
Finalmente, guarde la expresin.

Obtener el WorkItem de una tarea especfica


Usted puede obtener el WorkItem relacionado a una tarea especfica utilizando la funcin
Me.Case.getWorkItem. 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 DueDate.

Copyright 2014 - Bizagi

1265

Para actualizar la duracin del temporizador, usted puede hacer uso de la funcin
Me.Case.getWorkItem.
Cree una expresin como una accin a la salida de la tarea desde donde pueda ser actualizada la
duracin del temporizador.
Utilice la funcin Me.Case.getWorkItem ingresando el id del evento de temporizacin como parmetro.
Para este ejemplo este id es 1289

Ahora aplique el mtodo .EstimatedSolution sobre el objeto de tipo WorkItem para definir la nueva
duracin del temporizador.

Copyright 2014 - Bizagi

1266

//Actualice la duracin del temporizador


Me.Case.getWorkItem[1289].EstimatedSolutionDate=<CustomerServiceRequest.Due
Date>;

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).
Si solo hay un usuario asignado, la sentencia ser Me.Assignees[0].attribute
Este grupo de funciones se encuentran disponibles bajo la categora Informacin de los asignados
actuales.

Copyright 2014 - Bizagi

1267

La informacin disponible para los asignados actuales es:


Propiedad

Descripcin

Id

Devuelve una coleccin que contiene los


ids de todos los asignados a una
actividad.

BossId

Devuelve una coleccin que contiene el


id de los jefes de todos los asignados a
una actividad.

FullName

Devuelve una coleccin que contiene el


nombre completo de todos los
asignados a una actividad.

Location.Name

Devuelve una coleccin que contiene la


ubicacin de todos los asignados a una
actividad.

Positionsde

Devuelve una coleccin que contiene las


posiciones de un asignado especifico a
una actividad.

Copyright 2014 - Bizagi

1268

Roles

Devuelve una coleccin que contiene los


roles de un asignado especifico a una
actividad.

Skills

Devuelve una coleccin que contiene los


skills de un asignado especifico a una
actividad.

UserName

Devuelve una coleccin que contiene el


nombre de usuario de un asignado
especifico a una actividad.

getUserProperties()

Devuelve una coleccin que contiene


una propiedad de usuario especfica de
todos los asignados a una actividad.

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 Me.Assignees[].Fullname 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 Proceso de Servicio al Cliente 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 AssigneesList.
Para construir esta lista cree una expresin como una accin a la entrada, en la actividad donde se
requiera.
Utilice la funcin Me.Assignees para navegar la lista de asignados.

Copyright 2014 - Bizagi

1269

Para cada asignado, cree un nuevo registro en la coleccin AssigneesList, utilizando la funcin
Me.newCollectionItem.

Finalmente utilice Me.Assignees[].FullName para obtener el nombre completo de cada asignado e


incluirlo como el nuevo registro de la coleccin.

Copyright 2014 - Bizagi

1270

//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.newCollectionItem("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 Me.Assignees[].Roles 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 Proceso de Servicio al Cliente 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 AssigneesList.

Copyright 2014 - Bizagi

1271

Para construir esta lista cree una expresin como una accin a la entrada, en la actividad donde se
requiera.
Utilice la funcin Me.Assignees para navegar la lista de asignados.

Para cada asignado cree un nuevo registro en la coleccin AssigneesList utilizando la funcin
Me.newCollectionItem. Utilice Me.Assignees[].FullName para obtener el nombre completo de cada
asignado e incluirlo como nuevo registro en la coleccin.

Copyright 2014 - Bizagi

1272

Ahora construya una cadena de texto con los roles de cada asignado. Utilice la funcin
Me.Assignees[].Roles para obtener la lista de roles.

Navegue la lista de roles y concatene sus nombres para obtener un texto nico por usuario.

Finalmente utilice el texto obtenido como el valor de la columna Roles del nuevo registro de la
coleccin. Posteriormente reinicie el texto.

Copyright 2014 - Bizagi

1273

//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.newCollectionItem("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:

Copyright 2014 - Bizagi

1274

Obtener propiedades de usuario


La funcin Me.Assignees[].getUserProperties 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 Proceso de Servicio al Cliente 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 AssigneesList.
Para construir esta lista cree una expresin como una accin a la entrada, en la actividad donde se
requiera.
Utilice la funcin Me.Assignees para navegar la lista de asignados.

Para cada asignado cree un nuevo registro en la coleccin AssigneesList utilizando la funcin
Me.newCollectionItem. Utilice Me.Assignees[].FullName para obtener el nombre completo de cada
asignado e incluirlo como nuevo registro en la coleccin.

Copyright 2014 - Bizagi

1275

Ahora obtenga la propiedad Career utilizando Me.Assignees[].getUserProperties() 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++)

Copyright 2014 - Bizagi

1276

{
//Por cada asignado cree un registro en la coleccin
NewAssignee=Me.newCollectionItem("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:

Obtener y utilizar 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 Informacin de la tarea actual.

Copyright 2014 - Bizagi

1277

La informacin disponible para la tarea actual es:


Propiedad

Descripcin

Id

Devuelve el identificador de la tarea


actual.

Name

Devuelve un String con el nombre de la


tarea actual.

DisplayName

Devuelve un String con el nombre visual


de la tarea actual.

EstimatedDuration

Devuelve la duracin ,en minutos, de la


tarea actual.

Ejemplo
El siguiente ejemplo ilustrar cmo utilizar estas funciones.

Obtener el nombre de la tarea actual


La funcin Nombre devuelve un string con el nombre de la tarea actual.
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 Estado. Este atributo debe ser actualizado cada vez que el proceso se mueva a
una actividad diferente.
Por ejemplo, si la solicitud se encuentra en la actividad Autorizar Solicitud, el estado debera ser En
aprobacin. As mismo, si la solicitud se encuentra en el Subproceso de Cotizaciones, el estado sera
Cotizando productos.

Copyright 2014 - Bizagi

1278

Para actualizar este estado usted necesita configurar una expresin en cada actividad. Sin embargo,
usted puede definir una nica expresin reutilizable (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
Me.Task.Name.
Cree una expresin como una accin a la entrada de la actividad Autorizar Solicitud.

Utilice la funcin Me.Task.Name para obtener el nombre de la tarea actual y definir el estado
correspondiente.

Copyright 2014 - Bizagi

1279

if (Me.Task.Name=="AuthorizeRequest")
{
<Process.Status>="In approval"
}
if (Me.Task.Name=="Quotations")
{
<Process.Status>="Quoting products"
}
Ahora invoque esta misma expresin desde el Subproceso de Cotizaciones.

Obtener y utilizar valores de un vocabulario


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 Miscelneo.

Copyright 2014 - Bizagi

1280

Obtener la definicin de un vocabulario


Para obtener el valor guardado de un vocabulario especfico utilice la funcin resolveVocabulary.
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 Nivel de Servicio Acordado 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
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.

Copyright 2014 - Bizagi

1281

En un elemento de expresin, use la funcin Me.Duration para asignar la duracin de la tarea.

Para asignar un valor a la Duracin, llame la funcin resolveVocabulary 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.

Copyright 2014 - Bizagi

1282

La siguiente imagen muestra la expresin completa:

Me.Duration=CHelper.resolveVocabulary(Me,"SLA");
Finalmente, d clic en Ok para guardar los cambios.

Obtener el siguiente valor de una secuencia


Para autogenerar nmeros en base a la definicin de una secuencia, usted debe utilizar la funcin
GetNextSeqValueStr.

Copyright 2014 - Bizagi

1283

La sintaxis de la funcin es:

CHelper.GetNextSeqValueStr("SequenceName")
Suponga que tiene un proceso de Matrcula de estudiantes 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 Configuracin y luego la opcin Secuencia)

En el cuarto paso del asistente, seleccione Acciones de la Actividad.


D clic en la tarea donde se va ha agregar la secuencia y cree una expresin.

Copyright 2014 - Bizagi

1284

Debemos asignar el valor de la secuencia en el atributo Nmero de Identificacin Interna, este


atributo pertenece a la entidad Aplicacin de Estudiante.

Llame la funcin GetNextSeqValueStr 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.

Copyright 2014 - Bizagi

1285

<StudentApplication.InternalIdentificationNumber>=CHelper.GetNextSeqValueSt
r("InternalIdentificationNumber");
Finalmente, d clic en Ok para guardar los cambios.

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


utilizar una funcin que busque el valor mencionado dependiendo del nivel de riesgo.
Vamos a utilizar la funcin getEntityAttrib. La funcin se encuentra en la categora Navegacin de
Datos.
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 2014 - Bizagi

1286

La sintaxis de la funcin es:

CHelper.getEntityAttrib("Entity","ValueToReturn","filter","")
La entidad ser la entidad paramtrica Riesgo.
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.
D clic en la tarea donde se va ha mostrar el lmite superior aprobado y cree una expresin Al
Guardar.

Copyright 2014 - Bizagi

1287

El puntaje del riesgo ingresado por el analista est guardado en el atributo Riesgo.
La cantidad mxima ser asignada al atributo Cantidad Mxima.

La expresin deber lucir de la siguiente forma:

Copyright 2014 - Bizagi

1288

// 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","MaximumApprov
edAmount",
"(LowerBound <="+RiskValue+") AND (UpperBound > "+RiskValue+")","");
D clic en Ok para guardar los cambios.
Cuando un Analista ingrese el puntaje de riesgo y d 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 GetValueAsCollection, 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.

Usted puede ejecutar este ejemplo utilizando la funcin Over XPath. El ejemplo solo tiene como
propsito brindar un ejemplo.

Copyright 2014 - Bizagi

1289

La funcin GetValueAsCollection se encuentra en la categora Navegacin de Datos.

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 2014 - Bizagi

1290

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>;

Copyright 2014 - Bizagi

1291

//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 Contact Center, se debe enviar una notificacin al jefe de la persona que trabaja en una

Copyright 2014 - Bizagi

1292

solicitud, en caso de que el tiempo para atenderlo se exceda. Usted necesita entonces conocer la
direccin de correo electrnico del jefe.
Para obtenerlo, usted puede utilizar la funcin CHelper.getAttrib. 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
Me.Case.WorkingCredential.UserProperties().

actual

utilizando

la

funcin

Utilice la funcin CHelper.getattrib() para obtener desde la entidad WFUser, la direccin de correo
electrnico del usuario deseado. En este caso almacene este valor en un atributo del modelo de datos
(BossEmail).

Copyright 2014 - Bizagi

1293

//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 CHelper.setAttrib. 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 2014 - Bizagi

1294

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 CHelper.setAttrib.

//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,"Requ
estPenalized",true);

Copyright 2014 - Bizagi

1295

Obtener propiedades de usuario


Bizagi provee un conjunto de informacin denominada Propiedades de Usuario que es relevante para
cada usuario individualmente. Esta informacin incluye nombre de usuario, direccin de correo
electrnico, dominio, roles, posiciones, usuario delegado, entre otros.
Usted puede crear propiedades de usuario adicionales para sus usuarios tales como fecha de
nacimiento, nmero de afiliacin a seguridad social, estado civil, o cualquier otra requerida por su
Procesos, que no est incluida entre la informacin por defecto de Bizagi.
Las propiedades de usuario pueden ser de tipos de datos simples o pueden estar relacionados con
entidades paramtricas o del sistema a travs de tipos de relacin uno a muchos o muchos a muchos.
Usted puede acceder a esta informacin desde expresiones para utilizarla como informacin del
Proceso.
Este artculo muestra cmo:
Obtener una propiedad de usuario de tipo de dato simple
Obtener una propiedad de usuario relacionada a una entidad a travs de un tipo de relacin uno a
muchos
Obtener una propiedad de usuario relacionada a una entidad a travs de un tipo de relacin
muchos a muchos

Obtener propiedades de usuario de tipo de dato simple


Las propiedades de usuario pueden ser de tipo de dato simple (nmero de identificacin, nmero de
tarjeta de crdito, nickname). En este caso usted puede acceder a esta informacin utilizando XPath
directamente.
Ejemplo
Se defini una propiedad de usuario para almacenar el nmero de identificacin de los usuarios.
Suponga que en un Proceso de Solicitud de Viaje, el nmero de identificacin del Solicitante es
necesario para reservar el vuelo. El valor de esta propiedad de usuario se puede obtener as:
IdentificacionSolicitante =
<SolicitudDeViaje.Solicitante.NumerodeIdentificacion>;

Obtener propiedades de usuario relacionadas a una entidad a travs


de relaciones de tipo uno a muchos
Las propiedades de usuario pueden estar relacionadas a una entidad a travs de un tipo de relacin
uno a muchos, es decir, la propiedad posee un valor, pero este puede ser seleccionado de una lista
(pas, tipo de contrato, oficina). En este caso usted puede acceder a su informacin utilizando XPath
directamente.
Ejemplo
Se defini una propiedad de usuario para almacenar el tipo de contrato de los usuarios. Suponga que
en un Proceso de Desvinculacin de personal, el tipo de contrato del Empleado es necesario para

Copyright 2014 - Bizagi

1296

reservar el vuelo. El valor de esta propiedad de usuario se puede obtener as:


TipodeContrato = <Desvinculacion.Empleado.TipodeContrato>;

Obtener propiedades de usuario relacionadas a una entidad a


travs de relaciones de tipo muchos a muchos
Las propiedades de usuario pueden estar relacionadas a una entidad a travs de un tipo de relacin
muchos a muchos, es decir, la propiedad posee varios valores (ciudades, roles, habilidades). En este
caso usted debe navegar el objeto de la propiedad para acceder a cada uno de sus valores.

Ejemplo
Se defini una propiedad de usuario para almacenar los idiomas que dominan los usuarios. Suponga
que en un Proceso de atencin de incidentes de IT, los idiomas que domina un agente son necesarios
para evaluar si este puede o no atender un ticket de soporte. Los valores de esta propiedad de
usuario se pueden obtener as:

IdiomasdelAgente =
CHelper.GetValueAsCollection(Me.Context.getXPath("Ticket.Agente.Idiomas"));
for(var i=0; i < IdiomasdelAgente.Count;i++)
{
Idioma = IdiomasdelAgente[i].getXPath("Nombre");
}

Obtener usuarios basados en componentes de la organizacin


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 getUsersForPosition.
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 getUsersForRole.
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)

Copyright 2014 - Bizagi

1297

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 getUsersForSkill.
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.

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.

Copyright 2014 - Bizagi

1298

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 Tcnicos
disponibles, la cual contiene los usuarios que tienen la posicin Tcnico de soporte.
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 d clic en la primera tarea

Copyright 2014 - Bizagi

1299

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
especfica.
Utilice el mdulo FOR para iterar sobre cada registro e la lista.
En el otro elemento expresin, incluya cada registro a la coleccin AvailableTechnitians.

Copyright 2014 - Bizagi

1300

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.

4. Obtenga una lista de usuarios con la posicin deseada utilizando la funcin Get users in Position de
la categora Usuarios. 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

Copyright 2014 - Bizagi

1301

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.

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 Available Technicians.
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.newCollectionItem("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 2014 - Bizagi

1302

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 Tcnicos
disponibles, la cual contiene los usuarios que tienen el rol Tcnico 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 d clic en la primera tarea
del proceso y cree una expresin Al entrar.

Copyright 2014 - Bizagi

1303

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 AvailableTechnitians.

Copyright 2014 - Bizagi

1304

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 2014 - Bizagi

1305

4. Obtenga una lista de usuarios con el rol deseado utilizando la funcin Get users in Role de la
categora Usuarios.

//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.

Copyright 2014 - Bizagi

1306

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 Available Technicians.
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.newCollectionItem("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 2014 - Bizagi

1307

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 Tcnicos
disponibles, la cual contiene los usuarios que tienen la habilidad IT y conocimiento de redes.
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 d clic en la primera tarea

Copyright 2014 - Bizagi

1308

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 AvailableTechnitians.

Copyright 2014 - Bizagi

1309

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 users in Skill de la
categora Usuarios.

//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).

Copyright 2014 - Bizagi

1310

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 Available Technicians.
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.newCollectionItem("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 2014 - Bizagi

1311

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
CHelper.getCaseUsers(). Esta funcin retorna una lista con los ids de los usuarios que han trabajado
en un caso particular.
El Nmero de Caso debe ingresarse como parmetro de entrada.
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 UsersLog (que se muestra en el siguiente modelo
de datos).

Copyright 2014 - Bizagi

1312

Para obtener esta lista de usuarios usted puede utilizar la funcin CHelper.getCaseUsers .
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 UsersLog.

//Obtenga los usuarios


var CaseUsers=CHelper.getCaseUsers(Me.Case.CaseNumber);

Copyright 2014 - Bizagi

1313

//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.newCollectionItem("Ticket.UsersLog");
NewRow.setXPath("Users",CaseUsers[i]);
}
La tabla resultante se muestra en el Portal de Trabajo de la siguiente manera:

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.

Copyright 2014 - Bizagi

1314

Para crear una secuencia siga los siguientes pasos:


1. Vaya a la vista de Mdulos y abra la pestaa de Configuracin, luego d clic en Secuencias.

2. En la nueva ventada, d clic en Adicionar para incluir una nueva secuencia.

Copyright 2014 - Bizagi

1315

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.
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.
D clic en Ok para guardar los cambios.

Copyright 2014 - Bizagi

1316

3. En el paso cuatro del Asistente seleccione la opcin Acciones de la Actividad.


D clic en la tarea donde se asignar la secuencia a un atributo, luego cree una expresin.

4. Cree una expresin para asignar el nmero de identificacin.


Vamos a asignar el valor del nmero de secuencia al atributo Nmero de Identificacin Interna. Utilice
la funcin Get next sequence value de la categora Miscelneo para obtener el siguiente nmero de la
secuencia.

Copyright 2014 - Bizagi

1317

La expresin debe quedar as:

//Asignar el siguiente nmero de la secuencia en un atributo.


<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

Copyright 2014 - Bizagi

1318

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.

Ejecutar eventos
La funcin setEvent 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 evento: El nombre del evento que ser ejecutado.
El primero y el ltimo de los parmetros sern fijos (Me and null).
La funcin setEvent se encuentra en la categora Proceso.

Ejemplo
Tomemos como ejemplo el proceso de Mesa de Ayuda. Una vez el caso es creado, se habilita un

Copyright 2014 - Bizagi

1319

evento que permite cerrar el caso en cualquier momento, tal como se muestra en el siguiente flujo de
proceso

La tarea Analizar y Resolver 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.

Copyright 2014 - Bizagi

1320

2. En la expresin, incluya en elemento de expresin.


Seleccione la funcin setEvent.

3. Valores de los parmetros de la funcin setEvent.


El Caseid se obtiene utilizando la funcin Me.Case.Id, la cual retorna el ID del caso actual.

Copyright 2014 - Bizagi

1321

El nombre del evento es Cerrar Caso.


Usted puede verificar el nombre en las propiedades del evento en el primer paso del asistente.

CHelper.setEvent(Me,Me.Case.Id,"CloseCase",null);
Guarde la expresin. Cuando d clic en el botn Cerrar Caso desde el Portal de Trabajo, el caso
quedar cerrado.

Usar .id con XPath


La sentencia .id despus de un XPath podra requerirse o no dependiendo de lo que usted desee
hacer.

Copyright 2014 - Bizagi

1322

Cuando se agregan elementos a una coleccin


Imagine un Proceso de Solicitud de Crdito Personal, donde hay varios productos en cada solicitud.
Hay una relacin uno a muchos entre la Entidad de Proceso Solicitud y la Entidad de coleccin
Productos.
La entidad uno se denomina Solicitud.
La entidad coleccin se denomina Productos.
La relacin es Solicitud_Productos.
Productos tiene un atributo llamado Valor.
Usted necesita agregar un nuevo producto a la coleccin con US$10.000 como valor. Utilice las
siguientes declaraciones:
USE:
var NuevoProducto =
Me.newCollectionItem(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 newCollectionItem llena el id del
atributo automticamente..

Cuando utilice un setXPath con asignacin directa


Cuando usted utiliza la declaracin setXPath, 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:

Copyright 2014 - Bizagi

1323

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 Abierto.
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;

Cuando se utilice setXPath en la funcin newCollectionItem


Cuando utilice la funcin newCollectionItem 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.

Copyright 2014 - Bizagi

1324

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 SolicituddeProductos.
La entidad coleccin se denomina Clientes.
La relacin de entidad relacionada es ClientePrincipal
La relacin es SolicituddeProductos_Clientes
Clientes tiene un atributo llamado Nombre
var
AgregarCliente=Me.newCollectionItem("SolicituddeProductos.SolicituddeProduc
tos_Clientes");
AgregarCliente.setXPath("NombreCliente",Me.getXPath("ClientePrincipal.Nombr
e"));
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.
Imagine que tiene una Poltica de Suscripcin Colectiva donde hay muchos vehculos para cada
solicitud. Usted necesita saber cuntos vehculos hay de un cierto tipo en una solicitud.
Hay una relacin uno a muchos entre la Entidad de Proceso Solicitud y la entidad coleccin Vehculos.
La entidad uno se denomina Solicitud.
La entidad coleccin se denomina Vehiculos.
La relacin es Solicitud_Vehiculos
Los Productos tienen un atributo denominado TipodeVehiculo 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 2014 - Bizagi

1325

Usar Me.Context
Esta funcin es til en reglas que manejan contextos diferentes a los de la Entidad de Proceso. Otros
usos de Me.Context son:
Cuando las reglas van a ser usadas en formas de Adicin o Edicin, incluyendo: reglas de visibilidad,
de edicin o de naturaleza obligatoria de atributos, el contexto de la expresin (punto de inicio de la
navegacin de datos) es la entidad de la coleccin (de una relacin uno a muchos) donde la regla se
evala.
Cuando las reglas van a ser usadas en formas anidadas, como reglas de visibilidad, edicin o de
naturaleza obligatoria de atributos.
Cuando las reglas van a ser usadas en un botn que est en una forma anidada o en en una forma
para agregar o editar registros de una tabla, el contexto de la expresin (punto de inicio de la
navegacin de datos) es la entidad de la coleccin (de una relacin uno a muchos) donde la regla se
evala.
Cuando las reglas van a ser usadas como reglas para filtrar informacin desde un combo o una
ventana de bsqueda, el contexto de la regla debe ser la entidad en donde el combo, o la ventana
de bsqueda, est localizado.

Ejemplo
En un Proceso de solicitud de crdito 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 verificado.
Las validaciones que son requeridas sern controladas desde la actividad de Anlisis de solicitantes,
con el fin de dar retroalimentacin inmediata al cliente y asegurar que solo casos vlidos llegan a la
actividad Verificar informacin de solicitantes.

La informacin en la actividad de Anlisis de solicitantes se muestra de la siguiente manera:

Copyright 2014 - Bizagi

1326

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:

Para configurar esta validacin usted debe utilizar una Validacin de forma. Como el contexto de la
forma donde se edita la informacin del cliente es diferente al de la Entidad de Proceso, se utiliza
Me.Context para comprobar que cada cliente cumple con las polticas de ingresos.
Estas validaciones se realizan teniendo en cuenta el siguiente modelo de datos.

Copyright 2014 - Bizagi

1327

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).
1. Vaya al tercer paso del asistente de procesos y d clic en la actividad Anlisis de solicitantes.

2. Vaya a la pestaa Avanzado de la coleccin de Clientes. Asuma que ya hemos configurado una
forma de edicin para esta coleccin.

Copyright 2014 - Bizagi

1328

3. D clic en el icono de expresin de la propiedad Expresin de validacin, bajo las opciones de


edicin, y cree una expresin de scripting.

4. En un elemento de expresin obtenga los valores a comparar (ingreso mximo, ingreso mnimo e

Copyright 2014 - Bizagi

1329

ingreso del cliente).

Valide si el ingreso del cliente es menor al ingreso mnimo. En este caso ser necesario mostrar un
mensaje de validacin.

Copyright 2014 - Bizagi

1330

Ahora valide si el ingreso del cliente es mayor al ingreso mximo. Utilice Me.Context para asignar el
indicador de los clientes cuyo ingreso debe ser verificado.

//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);
}

Mtodos para interfaces

Introduccin
La invocacin de servicios de un sistema externo se configura de una manera fcil y gil a travs del
Conector de servicios Web de Bizagi.
Para ms informacin sobre ello, consulte Invocar servicios externos desde Bizagi.
En escenarios ms sofisticados, donde la configuracin de un servicio Web de tipo SOAP no es posible
mediante el mapeo grfico, usted puede optar por realizar las invocaciones a travs de funciones
para: obtener, actualizar o manipular y transformar la informacin de Bizagi, con los mtodos que
ofrece la clase ayudante de XMLs.

Copyright 2014 - Bizagi

1331

Bizagi provee un set de mtodos que permiten este enfoque desde las reglas de negocio.
En Bizagi .NET, los mtodos del asistente XML helper los provee la clase CEntityXmlHelper y
consideran tanto: la informacin en XMLs (a travs del tipo de dato XmlDocument el cual es nativo
del framework de .NET), o a travs de cadenas (strings).
En Bizagi JEE, los mtodos del ayudante XML los provee la clase XMLHelper.

Antes de continuar
Tenga en cuenta que el uso de este mtodo comnmente requiere de habilidades tcnicas orientadas
a programar con uso de archivos XMLs y de sus transformaciones (XSLT), y que tambin exige
experiencia con Bizagi y el manejo con los scopes.
Ntese que estos mtodos a nivel general, podrn usualmente:
Recibir o retornar instancias de entidades en sus parmetros, de manera que antes de usar estos
mtodos, podr ser necesario el uso de la clase CEntityManager y sus mtodos.
Requerir de esquemas XML y de transformaciones previamente definidas a partir de las definiciones
de las entidades.
Para ms informacin sobre esta opcin, consulte los esquemas XML del modelo de datos de Bizagi.

Mtodos
Lo siguientes mtodos se clasifican por el tipo de informacin que manejan y por su objetivo.

Mtodos para consultar informacin directamente en entidades


Estos deben usarse principalmente cuando se trabaja con entidades de parametrizacin.
MTODO

PARMETROS
DE ENTRADA

PARMETR
OS DE
SALIDA

DESCRIPCIN

entityToXml

CEntity entity

XmlDocume
nt

Obtiene los valores de un registro


especfico que pertenece a una entidad.

entityToXml

CEntity entity,
bool
bIncludeNull

XmlDocume
nt

Obtiene valores de la entidad recibido


como parmetro; si se especifica, ste
incluye valores nulos (NULL) en el
resultado.

entityToXml

CEntity entity,
string
sSchemaPath

XmlDocume
nt

Obtiene valores de la entidad recibida


como parmetro con la estructura del
esquema
especificado.
El
segundo
parmetro es el camino del esquema
deseado (.xsd); este esquema define qu
informacin ser incluida o excluida de la
respuesta XML

Copyright 2014 - Bizagi

1332

entityToStringXml

CEntity entity,
string
SchemaContent

String

Obtiene la informacin de un registro que


pertenece a una entidad, en una cadena.
Sus parmetros son un objeto CEntity y
una cadena con el esquema que define los
datos requeridos como la respuesta.

entityToStringXmlwith
Path

CEntity entity,
string
sSchemaPath

String

Obtiene la informacin de un registro que


pertenece a una entidad, en una cadena.
Sus parmetros son un objeto CEntity y
una cadena con el camino de un
documento XSD que define los datos
requeridos como respuesta.

getEntities

XmlDocument
xEntitiesInfo

XmlDocume
nt

Obtiene la informacin de una entidad


como un documento XML. En el parmetro
XmlDocument la informacin de la entidad
que ser consultada es especificada,
definiendo posibles filtros (este XML es
similar al recibido el mtodo getEntities de
Bizagi en EntityManagerSOA).

getEntities

XmlDocument
xEntitiesInfo,
XmlDocument
xSchema

XmlDocume
nt

Obtiene la informacin de una entidad


como un documento XML. En el
documento XML, ste recibe como primer
parmetro la informacin de la entidad
que ser consultada, definiendo posible
filtros.
Este mtodo es usado para obtener la
informacin de una entidad como un
documento XML.
En el documento XML ste recibe como
primer parmetro la informacin de la
entidad que ser consultada, definiendo
posible filtros (este XML es similar al
recibido el mtodo getEntities de Bizagi en
EntityManagerSOA). El segundo parmetro
es un esquema que ayuda a ajustar la
respuesta en un documento XML y de este
modo simplifica la respuesta slo a los
datos deseados.

getEntitiesAsString

string
sXmlEntitiesInfo,
string
sXmlSchema

String

Obtiene la informacin de una entidad


como un string. Recibe como primer
parmetro la informacin de la entidad
que ser consultada, definiendo posible
filtros.
Este mtodo es usado para obtener la
informacin de una entidad como un
string con formato XML.
En el XML ste recibe como primer

Copyright 2014 - Bizagi

1333

parmetro la informacin de la entidad


que ser consultada, definiendo posible
filtros (este XML es similar al recibido el
mtodo
getEntities
de
Bizagi
en
EntityManagerSOA). El segundo parmetro
es un esquema que ayuda a ajustar la
respuesta en un string igualmente con
formato XML y de este modo simplifica la
respuesta slo a los datos deseados.
getEntitiesFromPathAs
String

string
sPathXMLEntities
, string
sPathXMLSchem
a

String

Obtiene la informacin de una entidad


como un string.
La diferencia con el mtodo anterior es
que, en vez de recibir los contenidos del
XML, ste recibe los caminos de los
archivos que contienen el XML que
especifica los filtros sobre las entidades y
el
esquema
de
la
respuesta,
respectivamente. La respuesta es un XML
en formato cadena

Mtodos para consultar la informacin del scope


Estos mtodos consideran la informacin que mantiene Bizagi en su scope.
MTODO

PARMETROS
DE ENTRADA

PARMETR
OS DE
SALIDA

DESCRIPCIN

entityToStringXmlWithS
copes

Me, string
sSchemaConte
nt, string
sXSLContent

String

Obtiene una cadena XML con los datos


cargados en el scope (no en las entidades).
El primer parmetro es el objeto Me, el
segundo es el contenido de esquema que
define los datos que sern extrados. Se
debe considerar que, cuando se trabaja
con scopes de una regla sin una entidad
definida, un esquema (XSD) tiene que ser
construido partiendo del nodo raz con el
nombre de la entidad de aplicacin, e ir
bajando en las relaciones hasta alcanzar la
entidad o entidades que se desean
consultar. Sin embargo, esto no se requiere
un XSD construido para el mdulo SistemaInterface de Bizagi Studio, porque el XPath
se especifica dentro de la parametrizacin
de interface, en el TaskEvent. El ltimo
parmetro es el contenido del XSL usado
para transformar el resultado (basado en el
XSD) y llegar al XML transformado. Si se
requiere transformar la respuesta, el ltimo

Copyright 2014 - Bizagi

1334

parmetro puede ser nulo o una cadena


vaca.
entityToStringXmlWithS
copesByidCase

int idCase,
string xsd,
string xsl

String

Obtiene una cadena XML con los datos


cargados en el scope (no en las
entidades).
El primer parmetro es el id del caso (muy
til cuando consultamos informacin de un
caso que no es el actual), el segundo es el
contenido de esquema que define los datos
que sern extrados. Se debe considerar
que, cuando se trabaja con scopes de una
regla sin una entidad definida, un esquema
(XSD) tiene que ser construido partiendo
del nodo raz con el nombre de la entidad
de aplicacin, e ir bajando en las relaciones
hasta alcanzar la entidad o entidades que
se desean consultar. Sin embargo, esto no
se requiere un XSD construido para el
mdulo Sistema-Interface de Bizagi Studio,
porque el XPath se especifica dentro de la
parametrizacin de interface, en el
TaskEvent. El ltimo parmetro es el
contenido del XSL usado para transformar
el resultado (basado en el XSD) y llegar al
XML transformado. Si se
requiere
transformar la respuesta, el ltimo
parmetro puede ser nulo o una cadena
vaca.

entityToStringXmlWithS
copesXmlByidCase

int idCase,
XmlDocument
xsd,
XmlDocument
xsl

String

Obtiene una cadena XML con los datos


cargados en el scope (no en las
entidades).
El primer parmetro es el id del caso (muy
til cuando consultamos informacin de un
caso que no es el actual), el segundo es el
contenido de esquema que define los datos
que sern extrados. Se debe considerar
que, cuando se trabaja con scopes de una
regla sin una entidad definida, un esquema
(XSD) tiene que ser construido partiendo
del nodo raz con el nombre de la entidad
de aplicacin, e ir bajando en las relaciones
hasta alcanzar la entidad o entidades que
se desean consultar. Sin embargo, esto no
se requiere un XSD construido para el
mdulo Sistema-Interface de Bizagi Studio,
porque el XPath se especifica dentro de la
parametrizacin de interface, en el
TaskEvent. El ltimo parmetro es el

Copyright 2014 - Bizagi

1335

contenido del XSL usado para transformar


el resultado (basado en el XSD) y llegar al
XML transformado. Si se
requiere
transformar la respuesta, el ltimo
parmetro puede ser nulo o una cadena
vaca.

Mtodos para insertar informacin directamente en entidades


Estos deben usarse principalmente cuando se trabaja con entidades de parametrizacin.
MTODO

PARMETROS
DE ENTRADA

PARMETR
OS DE
SALIDA

DESCRIPCIN

fromXmlToEntity

string sEntityInfo

CEntity

Actualiza en las entidades involucradas


que se definen en el parmetro de
entrada. El XML que recibe como
parmetro est en formato de cadena y
tiene la misma estructura que la
presentada para el mtodo saveEntity del
servicio web EntityManagerSOA.asmx. La
diferencia
es
que
el
elemento
BizAgiWSParam no est presente. La
respuesta es un CEntity de la entidad
especificada en la raz del XML introducido
como parmetro. Habrn ms mtodos
especializados
introducidos,
posteriormente, para insertar o actualizar
datos en el scope.

fromXmlToEntityAsXm
l

XmlDocument
xEntityInfo

CEntity

Actualiza en las entidades involucradas


que se definen en el parmetro de
entrada. El XML lo recibe como un
Documento XML y tiene la misma
estructura que la presentada para el
mtodo saveEntity del servicio web
EntityManagerSOA.asmx. La diferencia es
que el elemento BizAgiWSParam no est
presente. La respuesta es un CEntity de la
entidad especificada en la raz del XML
introducido como parmetro. Habrn ms
mtodos especializados
introducidos,
posteriormente, para insertar o actualizar
datos en el scope.

Mtodos para actualizar la informacin del scope


Estos mtodos consideran la informacin que mantiene Bizagi en su scope.

Copyright 2014 - Bizagi

1336

MTODO

PARMETROS
DE ENTRADA

PARMETR
OS DE
SALIDA

DESCRIPCIN

fromXmlToEntityWithSc
opes

Me, string
sEntityInfo

CEntity

Actualiza informacin en el scope usando


el XML dado como parmetro. El primer
parmetro es el objeto Me. El segundo
parmetro es el XML en formato de
cadena. Los XML para insertar o actualizar
estos
casos
tienen
las
mismas
caractersticas de aquellos del mtodo
saveEntity. Sin embargo, cuando se trabaja
con scopes, el XML debe ser construido
partiendo de la entidad de aplicacin, o
simplemente especificando en el nodo
Entidades (Entities) todos los elementos
que la entidad de contexto tiene, y desde
ah ir bajando en todas las entidades que
sern actualizadas.

fromXmlToEntityWithSc
opesAsXml

Me,
XmlDocument
xml

CEntity

Actualiza informacin en el scope usando


el XML dado como parmetro. El primer
parmetro es el objeto Me. El segundo
parmetro es el XML en un Documento
XML. Los XML para insertar o actualizar
estos
casos
tienen
las
mismas
caractersticas de aquellos del mtodo
saveEntity. Sin embargo, cuando se trabaja
con scopes, el XML debe ser construido
partiendo de la entidad de aplicacin, o
simplemente especificando en el nodo
Entidades (Entities) todos los elementos
que la entidad de contexto tiene, y desde
ah ir bajando en todas las entidades que
sern actualizadas.

fromXmlToEntityWithSc
opes

Me, string
sEntityInfo,
bool
bIngnoreKeyOr
BizKeyXmlAttri
bs

CEntity

Actualiza informacin en el scope usando


el XML dado como parmetro en una
cadena. Recibe un tercer parmetro
booleano. El primero es Me, el segundo es
el XML en formato de cadena y el tercer
parmetro, cuando es Verdadero, ignora
la llave o los atributos businessKey
definidos en el XML y siempre inserta. Esto
es til cuando un caso diferente es
obtenido
(con
el
mtodo
entityToStringXmlWithScopes)
y
ser
insertado en el caso actual. Si las llaves y
businessKeys no son ignoradas, entonces
los datos del caso actual sern asociados

Copyright 2014 - Bizagi

1337

al caso de donde la informacin fue


extrada.
fromXmlToEntityWithSc
opesAsXml

Me,
XmlDocument
xml, bool
bIgnoreKeyOrB
izKeyXmlAttribs

CEntity

Actualiza informacin en el scope usando


el XML dado como parmetro. Recibe un
tercer parmetro booleano. El primero es
Me, el segundo parmetro es el XML en un
Documento XML, y el tercer parmetro,
cuando es Verdadero, ignora la llave o los
atributos businessKey definidos en el XML
y siempre inserta. Esto es til cuando un
caso diferente es obtenido (con el mtodo
entityToStringXmlWithScopes)
y
ser
insertado en el caso actual. Si las llaves y
businessKeys no son ignoradas, entonces
los datos del caso actual sern asociados
al caso de donde la informacin fue
extrada.

Mtodos para manipular informacin (usando esquemas XML)


Estos mtodos permiten aplicar transformaciones XML a los datos.
MTODO

PARMETROS
DE ENTRADA

OUTPUT
PARAMETER

DESCRIPCIN

getEntitySchema

string
sEntityName

XmlDocume
nt

Obtiene el esquema de la entidad cuyo


nombre se recibe como parmetro. El
esquema es generado usando los
metadatos de la entidad.

getEntitySchemaAsEnti
ty

CEntity entity

XmlDocume
nt

Obtiene el esquema de la entidad sobre la


cual recibe una instancia de objeto CEntity
como parmetro. El esquema es
generado usando los metadatos de la
entidad.

getEntitySchema

string
sEntityName,
string
sSchemaName

XmlDocume
nt

Obtiene un esquema de la entidad cuyo


nombre se define en el parmetro. En
Bizagi Studio, las entidades son tambin
esquemas de repositorios por lo que el
segundo parmetro indica el nombre del
esquema deseado

getEntitySchemaAsEnti
ty

CEntity entity,
string
sSchemaName

XmlDocume
nt

Obtiene un esquema de la entidad cuyo


nombre se define en el parmetro
enviando una instancia del objecto CEntity.
En Bizagi Studio, las entidades son
tambin esquemas de repositorios por lo
que el segundo parmetro indica el

Copyright 2014 - Bizagi

1338

nombre del esquema deseado


getEntitySchema

string
sEntityName,
bool
bIncludeRelated
Entities, bool
bIncludeFacts

XmlDocume
nt

Obtiene un esquema de la entidad cuyo


nombre es introducido como primer
parmetro de este mtodo. El esquema es
generado usando los metadatos de la
entidad; sin embargo, a diferencia del
mtodo
getEntitySchema
descrito
inicialmente, el cual slo recibe el nombre
de la entidad, ste recibe dos parmetros
booleanos adicionales. El primero para
especificar si relaciones uno a uno son
incluidas y el otro para especificar si
relaciones uno a muchos y muchos a
muchos deberan ser incluidas.

getEntitySchemaAsEnti
ty

CEntity entity,
bool
bIncludeRelated
Entities, bool
bIncludeFacts

XmlDocume
nt

Obtiene un esquema de la entidad cuyo


nombre es introducido como primer
parmetro con una instancia de objeto
CEntity.
El esquema es generado usando los
metadatos de la entidad; sin embargo, a
diferencia del mtodo getEntitySchema
descrito inicialmente, el cual slo recibe el
nombre de la entidad, ste recibe dos
parmetros booleanos adicionales. El
primero para especificar si relaciones uno
a uno son incluidas y el otro para
especificar si relaciones uno a muchos y
muchos a muchos deberan ser incluidas.

transformXml

XmlDocument
xml,
XmlDocument
xsl

XmlDocume
nt

Aplica una transformacin usando XSLT


1.1, el primer parmetro es el documento
XML que ser transformado y el
documento XSL.

transformXmlAsString

string xml, string


xsl

String

Aplica una transformacin usando XSLT


1.1, el primer parmetro es una cadena
con formato XML, con el contenido que
ser transformado y el documento XSL.

transformXmlUsingPat
h

string sPathXml,
string sPathXsl

String

Aplica una transformacin usando XSLT


1.1, el primer parmetro es una cadena
con la ruta donde se encuentra al XML,
con el contenido que ser transformado y
la ruta del documento XSL.

transformXmlUsingCo
ntent

string
sXmlContent,
string sPathXsl

String

Aplica una transformacin usando XSLT


1.1, el primer parmetro es una cadena
con formato XML, con el contenido que
ser transformado y la ruta del

Copyright 2014 - Bizagi

1339

documento XSL.

Ejemplos de colecciones
Los siguientes artculos contienen informacin del manejo de colecciones en expresiones.
Adicionar elementos a una relacin
Eliminar elementos de una coleccin
Asociar elementos a una coleccin
Desasociar elementos de una coleccin
Adicionar registros a tablas dentro de tablas
Acceder al isimo registro de una coleccin
Guardar el valor total de una columna

Adicionar elementos a una relacin


Para crear registros dentro de una coleccin utilizando una regla de negocio, Bizagi ofrece una funcin
llamada newCollectionItem.
Visualice su coleccin como una tabla. Crear un nuevo registro se comprara con 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 newCollectionItem. Esta funcin est disponible en
la lista de funciones de la categora Colecciones.

Copyright 2014 - Bizagi

1340

La siguiente es la sintaxis de la funcin:

Me.newCollectionItem ("ProcessEntity.RelationshipToTheCollection")
Para manipular un nuevo registro (fila), este se debe asignar a una variable.

var Newrecord = Me.newCollectionItem


("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 columna, el cual es el nombre del atributo de la coleccin y
Valor, 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:
Se necesita incluir nuevas actividades al evento Crear nueva actividad. En el evento se ingresa la
informacin de la nueva tarea. Cuando se d clic en Siguiente, la informacin ingresada quedar

Copyright 2014 - Bizagi

1341

incluida automticamente en la coleccin Actividades. El subproceso Realizar Actividades ser


ejecutado para cada registro de la coleccin Actividades.

Para hacer esto, ejecute los siguientes pasos:


1. En el cuarto paso del Asistente, seleccione la opcin Acciones de la actividad.
D clic en el evento en el cual se agregarn las actividades del proyecto y cree una expresin A la
Salida.

Copyright 2014 - Bizagi

1342

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.

Copyright 2014 - Bizagi

1343

NewActivity=Me.newCollectionItem("ProjectAdministration.Activities");
La anterior lnea crea una nueva fila de Actividades. Luego de crear la fila, los valores de los atributos
pueden ser asignados:
NewActivity.setXPath("Description",<ProjectAdministration.NewActivityDescri
ption>);
NewActivity.setXPath("Responsible",<ProjectAdministration.NewActivityRepons
ible>);
NewActivity.setXPath("DueDate",<ProjectAdministration.NewActivityDueDate;);
La siguiente imagen muestra la representacin grfica de la representacin de la expresin.

Copyright 2014 - Bizagi

1344

Eliminar elementos de una coleccin


Visualice su coleccin como una tabla. La eliminacin de un tem es como borrar una fila.
Los registros de una coleccin pueden ser borrados (eliminados) o desasociados.
Cuando se elimina un tem, ste ser eliminado tanto de la coleccin como de la base de datos.
Cuando se desasocia un tem, ste ser retirado de la coleccin, se desconectar pero permanecer
en la base de datos .
Si usted definitivamente quiere eliminar un tem (o registro) tiene tres opciones:
Eliminar todos los tems de la coleccin: la eliminacin de todos los tems (registros) de una
coleccin se hace utilizando la funcin deleteAllCollectionItems. Slo tiene que especificar el XPath a
la coleccin y se eliminarn todos los registros.
Eliminar algunos tems de la coleccin: elimina algunos tems (uno o ms) de una coleccin, usando
la funcin deleteCollectionItems.
Es necesario especificar el XPath de la coleccin y como segundo parmetro el XPath filtrando los
elementos que desea eliminar.
Eliminar UN tem de coleccin: elimina solo UN tem (registro) de una coleccin utilizando la funcin
deleteCollectionItem .
Es necesario especificar el XPath de la coleccin y el XPath filtrando el nico tem que desea eliminar. Si
en este XPath filtrado se encuentra ms de registro, se presentar un error al usuario final.
Las funciones se encuentran en la categora Collection.
e

Copyright 2014 - Bizagi

1345

A continuacin, se muestra la sintaxis de las funciones.

Me.deleteAllCollectionItems("ProcessEntity.RelationshipToTheCollection")
Me.deleteCollectionItems("ProcessEntity.RelationshipToTheCollection",filtered
XPath)
Me.deleteCollectionItem("ProcessEntity.RelationshipToTheCollection",filtered
XPath)
Veamos un proceso de Administracin de proyectos para ilustrar cmo eliminar un tem 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.
Para hacer esto, ejecute los siguientes pasos:
1. En el cuarto paso del Asistente seleccione la opcin Acciones de la actividad.
D clic en el evento en el cual se eliminarn las actividades del proyecto y cree una expresin Al
Entrar.

Copyright 2014 - Bizagi

1346

2. Cree una expresin e ingrese el siguiente cdigo para remover la relacin:

D clic en Ok para guardar cambios.


A continuacin encontrar diferentes formas para remover elementos dependiendo de los
requerimientos del negocio.

Ejemplo

Resultado

if(<count(ProjectAdministration.Activities[Completed =

Copyright 2014 - Bizagi

Elimina la nica actividad completada de

1347

true])>==1)
la coleccin, y borra este registro de la
{
base de datos.
Me.deleteCollectionItem("ProjectAdministration.Activities"
, <ProjectAdministration.Activities[Completed = true]> );
}
Me.deleteCollectionItems("ProjectAdministration.Activitie
s", <ProjectAdministration.Activities[Completed = true]
>);

Elimina todas las actividades realizadas


de la coleccin y elimina estos registros
de la base de datos.

Me.deleteAllCollectionItems("ProjectAdministration.Activit Quita todos los elementos de la relacin y


ies");
tambin de la base de datos.

Asociar elementos a una coleccin


Asociar un elemento a una coleccin es conectar un registro existente de una tabla y compartirlo con
otra tabla.
El tem (registro) pertenece a ambas tablas, no se duplica, slo se comparte.
Si necesita mover un elemento de una coleccin a otra, puede hacerlo asociando el tem a la nueva
coleccin y se luego desasocindolo de la vieja coleccin. No es necesario duplicar y volver a crear el
tem.
Para asociar un elemento (o registro), tiene dos opciones:
Asociar algunos elementos a una coleccin: asocia o adjunta algunos tems (uno o ms registros) de
una coleccin a mediante la funcin attachCollectionItems. Es necesario especificar el XPath de la
coleccin y el XPath filtrando los tems que desea asociar.
Asociar UN elemento de la coleccin: asocia UN tem (registro) a una coleccin con la funcin
detachCollectionItem.
Es necesario especificar el XPath de la coleccin y el XPath filtrando el nico tem que se desea asociar.
Si en el filtro se encuentra ms de un tem la funcin presentar un error al usuario final.
Las funciones se encuentran en la categora Colecciones.

Copyright 2014 - Bizagi

1348

La sintaxis de la funcin es la siguiente:

Me.attachCollectionItem("ProcessEntity.RelationshipToTheCollection",filtered
XPath)
Me.attachCollectionItems("ProcessEntity.RelationshipToTheCollection",filtered
XPath)
Tomemos como ejemplo un proceso de un Colegio. A travs del ao, el director del saln actualiza las
calificaciones de los estudiantes y ve que quines estn aprobando y quines estn perdiendo. Hay
tres colecciones, la coleccin de Estudiantes, con la informacin actualizada de los estudiantes, la
coleccin Aprobados y la coleccin Perdiendo.
Las tres lo son colecciones de la misma entidad Maestra: Estudiantes.

Copyright 2014 - Bizagi

1349

Cuando se actualiza la coleccin estudiantes, queremos asociar a todos los estudiantes con un
promedio superior al 6 a la coleccin de Aprobados y todos los alumnos con promedio menor de 6 a
la coleccin Perdiendo.
Utilizamos la funcin attachCollectionItems para asociar los estudiantes de la coleccin Estudiantes a
la coleccin Aprobados o Perdiendo.

var average = 6;
Me.attachCollectionItems("School.Approvedstudents",

Copyright 2014 - Bizagi

1350

Me.getXPath("School.Students[Average >= "+ average +"]"));


Me.attachCollectionItems("School.Failedstudents",
Me.getXPath("School.Students[Average < "+ average +"]"));
A continuacin encontrar las diferentes maneras en que los tems pueden ser asociados de acuerdo a
las necesidades del negocio.

Ejemplo

Resultado

Me.attachCollectionItems("School.Approvedstudents",
Me.getXPath("School.Students[Average >= "+ average
+"]"));

Asocia los estudiantes con un promedio


mayor a 6 a la coleccin Aprobados.

or
Me.attachCollectionItems("School.Approvedstudents",
<School.Students[Average >= 6]>);
if(<count(School.Students[Average > 6])>==1)
{
Me.attachCollectionItem("School.Approvedstudents",
<School.Students[Average > 6]> );
}

Asocia UN estudiante cuyo promedio en


mayor a 6 a la coleccin Aprobados,
desde la coleccin Estudiantes.

Desasociar elementos de una coleccin


Visualice su coleccin como una tabla. Desasociar un elemento es desconectarlo de una fila de la tabla,
pero dejando los datos en la base de datos para ser utilizados por otra coleccin.

Copyright 2014 - Bizagi

1351

Los tems (registros) de una coleccin se pueden eliminar o desasociar.


Cuando se elimina un tem, ste ser eliminado la coleccin y de la base de datos.
Al desasociar un tem, ste se desconectar de la coleccin pero permanecer en la base de datos.
Cuando un tem es compartido por dos o ms colecciones, se recomienda desasociar en vez de
eliminar.
Si desasocia un tem (o registro) tiene tres opciones:
Desasociar todos los elementos de la coleccin: desconecta todos los tems (registros) de una
coleccin utilizando la funcin detachAllCollectionItems.
Slo se debe especificar el XPath a la coleccin y todos los registros sern desasociados.
Desasociar algunos artculos de la coleccin: desconectar algunos tems (uno o ms registros) de
una coleccin con la funcin detachCollectionItems.
Es necesario especificar el XPath de la coleccin y el XPath filtrando los elementos que desea
desasociar.
Desasociar UN tem de coleccin: desconectar UN tem (registro) de una coleccin con la funcin
detachCollectionItem.
Es necesario especificar el XPath de la coleccin y el XPath filtrando el nico elemento que desea
separar. Si en el filtro se encuentra ms de un tem la funcin presentar un error al usuario final.
Las funciones se encuentran en la categora Colecciones.

Copyright 2014 - Bizagi

1352

La sintaxis de las funcines es la siguiente :

Me.detachAllCollectionItems("ProcessEntity.RelationshipToTheCollection")
Me.detachCollectionItems("ProcessEntity.RelationshipToTheCollection",filtere
d XPath)
Me.detachCollectionItem("ProcessEntity.RelationshipToTheCollection",filtered
XPath)
Tomemos como ejemplo un proceso de un Colegio. A travs del ao, el director del saln actualiza las
calificaciones de los estudiantes y ve que quienes estn aprobando y que est perdiendo. Hay tres
colecciones, la coleccin de Estudiantes, con la informacin actualizada de los estudiantes, la coleccin
Aprobados y la coleccin Perdiendo.
Las tres son colecciones de la misma entidad Maestra: Estudiantes.

Copyright 2014 - Bizagi

1353

Cuando se actualiza la coleccin estudiantes, queremos ver de manera independiente dos colecciones:
una con aquellos que tiene un promedio mayor de 6 y otra con los que no.
Utilizamos la funcin detachcollectionItems para desconectar de la coleccin Perdiendo, los
estudiantes que ahora estn aprobando.
Note que no utilizamos la funcin deleteCollectionItems porque slo queremos desconectar los tems
de la coleccin, pero an guardarlos en la base de datos, ya que se pueden unir a la coleccin
Aprobados, y adems forman parte de la coleccin de los Estudiantes.

A continuacin encontrar las diferentes maneras en que los tems se pueden desasociar en funcin de

Copyright 2014 - Bizagi

1354

las necesidades de negocio.

Example

Result

if(<count(School.Approvedstudents[Average < 6])>==1)


{
Me.detachCollectionItem("School.Approvedstudents",
<School.Approvedstudents[Average < 6]> );
}

Desasocia solo los estudiantes cuyo


promedio esta debajo de 6 y pertenecen
a la coleccin Aprobados.

var average = 6;
Me.detachCollectionItems("School.Failedstudents",
Me.getXPath("School.Students[Average > "+ average
+"]"));

Desasocia a todos los estudiantes que


estaban perdiendo y ahora estn
aprobando. Los tems (estudiantes) sern
desconectados de la coleccin Perdiendo
pero seguirn presentes en la base de
datos.

or
Me.detachCollectionItems("School.Failedstudents",
<School.Students[Average > 6]>);
Me.detachAllCollectionItems("School.Failedstudents");
Me.detachAllCollectionItems("School.Approvedstudents")
;

Desasocia todos los tems de amabas


relaciones, pero los deja en la base de
datos.

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 la tabla 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 PurchaseRequest y la coleccin
ProductsRequested.
Hay una relacin uno-a-muchos entre la Entidad ProductsRequested y la entidad de coleccin
PossibleSuppliers.
La entidad de Proceso se se llama PurchaseRequest.
La entidad coleccin se llama ProductsRequested.
La segunda coleccin se llama PossibleSuppliers

Copyright 2014 - Bizagi

1355

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.

Copyright 2014 - Bizagi

1356

Lo primero que se debe hacer es agregar los Productos, es decir, la tabla externa:

ProdType = CHelper.getEntityAttrib("Producttype","idProducttype","Code =
'1'","")
Product = Me.newCollectionItem("PurchaseRequest.ProductsRequested")
Product.setXPath("Producttype",ProdType);
Product.setXPath("Quantity",10);
Una vez adicionados los producto, se realiza un Iterate Over Xpath para recorrer la coleccin de
productos y adicionar proveedores dentro de dicha coleccin.

Copyright 2014 - Bizagi

1357

Finalmente se adicionan los registros de la tabla paramtrica Proveedor a cada registro de la coleccin
de Productos.
La sentencia Me.newCollectionItem cambia, para que Me tome el valor de la variable que recorre los
productos en el Iterate.

Copyright 2014 - Bizagi

1358

Supplier = CEntityManager.GetEntity("Supplier").GetEntityList("","","","");
for(var i=0;i<Supplier.Length;i++)
{
NewSupplier= NewProducts.newCollectionItem("Possiblesuppliers");
NewSupplier.setXPath("Supplier",Supplier[i].SurrogateKeyValue);
}

Opcin 2
Otra manera de agregar registros a una tabla que se encuentra dentro de otra tabla, es utilizando un
newCollectionItem sobre una variable que contiene otro newCollectionItem. De esta manera no es
necesario utilizar una iteracin sobre XPath.
Se crea una expresin a la Entrada del proceso Solicitud de Compra para adicionar productos y
proveedores.
La siguiente es la lista de variables creadas en la expresin.

Copyright 2014 - Bizagi

1359

Lo primero que se debe hacer es agregar el producto, es decir, el registro de la tabla principal. Para
esto utilice el mtodo Me.newCollectionItem.

Ahora, desde la entidad paramtrica Supplier, obtenga la lista de proveedores que se agregarn a la
tabla interna.

Copyright 2014 - Bizagi

1360

Recorra la lista de proveedores y cree un registro en la tabla Possible suppliers por cada proveedor
de la lista.
Observe que la primera variable de Me.newCollectionItem cambia por la variable relacionada a la
tabla principal. (Product.newCollectionItem)

//Obtenga el producto desde la entidad paramtrica


ProdType = CHelper.getEntityAttrib("Producttype","idProducttype","Code =
'1'","")
//Agregue el producto a la tabla principal
Product = Me.newCollectionItem("PurchaseRequest.ProductsRequested")
Product.setXPath("Producttype",ProdType);
Product.setXPath("Quantity",10);
//Obtenga la lista de proveedores desde la entidad paramtrica
Supplier = CEntityManager.GetEntity("Supplier").GetEntityList("","","","");

Copyright 2014 - Bizagi

1361

//Por cada proveedor


for(var i=0;i<Supplier.Length;i++)
{
//Agregue un registro a la tabla interna
NewSupplier= Product.newCollectionItem("Possiblesuppliers");
NewSupplier.setXPath("Supplier",Supplier[i].SurrogateKeyValue);
}

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

Collection.get(index of the record). getXPath("Attribute")


Para asignar un valor

Collection.get(index of the record). setXPath("Attribute",value)

Tenga en cuenta que los ndices del los registros dentro de la coleccin, siempre inicia en
0.
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:

Copyright 2014 - Bizagi

1362

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.

2. El nmero aleatorio generado por el servicio externo se almacena en el atributo WinnerIndex.


Escriba la siguiente expresin para obtener el nombre del ganador de la coleccin de los clientes. Este
se almacena en el atributo WinnerName.

Copyright 2014 - Bizagi

1363

//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
Winner del ganador, el valor true.

Copyright 2014 - Bizagi

1364

//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 2014 - Bizagi

1365

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.

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 (Total Cost
Estimate).
La siguiente imagen muestra el modelo de datos para este ejemplo:
Hay una relacin uno-a-muchos entre la Entidad de Proceso, Solicitud y la coleccin
ProductsRequested.
La una de proceso se llama Solicitud (Request).
La entidad coleccin se llama ProductsRequested.

1. Cree una expresin Al Guardar para calcular el costo total cada vez que un producto se aada a la
tabla.
Para su expresin, Incluya un mdulo de asignacin.

Copyright 2014 - Bizagi

1366

2. Haga doble clic en el mdulo de asignacin de editar su contenido. Haga clic en Agregar para incluir
una nueva lnea (asignacin de la informacin):

Copyright 2014 - Bizagi

1367

3. En el combo de seleccin de variablem elija el atributo de su modelo de datos que almacenar el


total.

Copyright 2014 - Bizagi

1368

4. A continuacin, asegrese de asignar a su atributo de un XPath.


Seleccionar XPath 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 2014 - Bizagi

1369

5. Haga clic en Ok 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.

Manejo de archivos con expresiones

Introduccin
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

Copyright 2014 - Bizagi

1370

Validar los nombres de los archivos


Cargar un archivo utilizando la capa SOA

Los 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

Cargar un archivo utilizando una expresin


En Bizagi es posible adjuntar cualquier archivo en un atributo de tipo Archivo sin intervencin del
usuario final, utilizando una expresin para adjuntar el contenido del archivo (como arreglos estticos
de tipo SByte)
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 HistoryFile 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 FileData.
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)
FileName 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 2014 - Bizagi

1371

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.

Borrar archivo subido


En Bizagi es posible eliminar el contenido de cualquier atributo de tipo Archivo sin intervencin del
usuario final, utilizando una expresin.
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 HistoryFile el cual almacena documentos que
se agregan progresivamente durante el Proceso.

Copyright 2014 - Bizagi

1372

Para eliminar los archivos cargados utilice la siguiente sentencia:


Me.deleteAllCollectioItems("Request.HistoryFile",true);
NO USE la siguiente sentencia pues EL ARCHIVO SUBIDO NO SE ELIMINAR:
Me.setXPath("Request.HistoryFile", null)

Note que la expresin es similar a las utilizadas para eliminar 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.

Copyright 2014 - Bizagi

1373

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 Documents sern copiados en el atributo
DocumentsBackup para crear una copia de seguridad de los archivos subidos durante el proceso.
Estos atributos estn en la entidad de proceso (llamado Business Opportunity).

La expresin lucir de la siguiente manera:

//Tomar el arreglo de los archivos


var OriginalFile = Me.getXPath("BusinessOpportunity.Documents");
//Navegue a travs del arreglo

Copyright 2014 - Bizagi

1374

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
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
Documents. 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
DocumentsBackup.

Copiar el contenido de un archivo en una coleccin


Es posible copiar el contenido de una atributo de tipo archivo a otro del mismo tipo contenido en una
coleccin.
Imagine un proceso donde se cargan documentos a lo largo del proceso. El proceso mantiene un
registro de los archivos cargados; una coleccin almacena los archivos, la fecha de subida y los
usuarios que los subieron, como se muestra en la siguiente imagen.

Se utiliza un nico atributo de tipo archivo para cargar los documentos en cada una de las actividades
del proceso, de manera que cada vez que se finaliza una actividad, su contenido es copiado en un
atributo de la coleccin e inicializado para poder ser utilizado en la siguiente actividad.

Copyright 2014 - Bizagi

1375

El modelo de datos muestra el atributo de tipo archivo utilizado para cargar los documentos
(ActivityDocument) y la coleccin que mantiene los registros (Documents). Observe que esta posee
otro atributo de tipo archivo para almacenar los documentos (DocumentFile).

Para copiar los documentos desde el atributo tipo archivo a la coleccin, usted puede utilizar la
siguiente expresin:

Copyright 2014 - Bizagi

1376

//Cree un nuevo registro en la coleccin


var NewDocument= Me.addRelation("Process.Documents")
//Agregue la infomacin adicional al nuevo registro (fecha de subida y usuario)
NewDocument.setXPath("UploadDate", DateTime.Now)
NewDocument.setXPath("Uploadedby", Me.Case.WorkingCredential.UserId)
//Obtenga los datos del atributo tipo archivo utilizado para subir el documento
var OriginalFile = Me.getXPath("Process.ActivityDocument");
//Navegue el arreglo de archivos
for(var i=0; i < OriginalFile.size(); i++)
{
//Obtenga los datos del archivo
var FiletoCopy = OriginalFile.get(i);
var Name = FiletoCopy.getXPath("FileName");
var Data = FiletoCopy.getXPath("Data");
//Copie el archivo en el atributo tipo archivo de la coleccin
var NewFile = NewDocument.addRelation("DocumentFile");
NewFile.setXPath("FileName", Name);
NewFile.setXPath("Data", Data);
}
//Inicialice el atributo tipo archivo.
<Process.ActivityDocument>=null;

Copyright 2014 - Bizagi

1377

La expresin anterior crea un nuevo registro en la coleccin destino utilizando el mtodo addRelation.
Luego obtiene el arreglo de archivos almacenados en el atributo ActivityDocument y navega a travs
de este para obtener el nombre y datos del archivo a copiar.
Finalmente la informacin anterior es copiada en el atributo de la coleccin (DocumentFile). Observe
que Me.addRelation cambia en la primera variable a aquella que contiene la relacin a la coleccin.
(NewDocument.addRelation).

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 propiedad tamao (size).
En la siguiente imagen, se ha creado una expresin para contar el nmero de archivos adjuntos en el
atributo Documents de la entidad BusinessOpportunity. 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());
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.

Copyright 2014 - Bizagi

1378

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 2014 - Bizagi

1379

Obtener el nombre del archivo cargado


En muchas situaciones se 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 Documents (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.

Copyright 2014 - Bizagi

1380

//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 2014 - Bizagi

1381

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 Company Balance.xls.
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 BALANCE e incluya como valor
Company Balance.xls (el nombre deseado).

Copyright 2014 - Bizagi

1382

En la forma de la actividad donde se carga el archivo se debe definir las propiedades deseadas para
el archivo. D clic en el atributo archivo y en el 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 .xls 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 2014 - Bizagi

1383

// 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
vocabulary")
}

name

of

the

En el ejemplo anterior hemos guardado la definicin del vocabulario (nombre predefinido del archivo)
en la variable DesiredFileName. Luego obtenemos el nombre del archivo cargado en la actividad y lo
guardamos en la variable FileName. 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.

Copyright 2014 - Bizagi

1384

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.
Los 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. Esta informacin es 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 informacin es
esttica que se mantendr igual desde la creacin de la entidad en Bizagi Studio.

Copyright 2014 - Bizagi

1385

Ejemplo
Un archivo es cargado en la entidad Products (id 10043 en ENTITY). El nombre del atributo en Products
que guarda el archivo se llama Document (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:\BizAgi\Projects
\Project01\Docs\.
La ruta completa para acceder al archivo ser: C:\BizAgi\Projects\Project01\Docs\10043\0\205\10010\.
Si el archivo cargado se llama: OctoberBalances.xls, su archivo estar disponible en: C:\BizAgi\Projects
\Project01\Docs\10043\0\205\10010\OctoberBalances.xls.
Para conocer cmo obtener el fileName del proyecto dinmicamente, utilice una expresin getXPath
similar a la descrita en la seccin Cargar archivos utilizando expresiones.

Polticas
Las polticas son reglas de negocio dinmicas que permite a las organizaciones adaptarse a los
cambios de negocio en tiempo real, Las polticas promueven la autonoma de los dueos de proceso
de tal forma que puedan estar involucrados en el control de las reglas definidas por la organizacin.
Las regalas son aplicadas de acuerdo a las condiciones de negocio y del mercado y definen cmo se
deben manejar los casos.
Por esta razn, las polticas pueden ser manejadas por los usuarios finales desde el Portal de Trabajo.
Ellos pueden realizar cambios en los valores o en la lgica en tiempo real, de acuerdo a las
condiciones actuales del negocio.
Una poltica puede contener mltiples tems y son usados para:
Ejecutar una accin cuando se cumple una condicin: Evaluando condiciones simples de negocio,
se ejecutan acciones cuando se cumple una condicin. Estas reglas se basan en Si y Sino. En Bizagi,
estas reglas se conocen como Reglas de polticas.
Evaluar tablas de decisin: Evaluando una combinacin de condiciones de negocio para ejecutar
una accin basada en la interseccin de condiciones. En Bizagi, estas reglas se conocen como Tablas
de Decisin.
Evaluar rboles de decisin: Evaluando jerarquas dentro de los tems para organizar la ejecucin y
la lgica muchas veces. En Bizagi, estas reglas se conocen como Precondiciones.
Agrupar reglas de negocio: Organizando reglas de polticas que tienen propsitos similares para

Copyright 2014 - Bizagi

1386

que estn juntas. En Bizagi, estos grupos se conocen como Grupos PrRule.

Consideraciones
El vocabulario tiene las definiciones para obtener o asignar toda la informacin usada en las
polticas. La operacin de las polticas se basa en las definiciones del vocabulario, Por lo tanto, las
polticas pueden ser definidas una vez se haya creado el vocabulario.
Las polticas pueden ser usadas en un nico proceso, pero tambin se pueden reutilizar y compartir
entre procesos.
Las reglas son estructuradas de tal forma que una accin o un camino alternativo se ejecuta una vez
se haya cumplido una condicin.
Las polticas de Negocio, los grupos de reglas, las precondiciones y las tablas de decisin pueden
ser administradas y modificadas desde el Portal de Trabajo por los usuarios finales cuando sea
necesario. Para ms informacin, por favor consulte Administrando Polticas en el Portal de Trabajo.

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 cuarto paso del Asistente de Procesos de Bizagi y seleccione Acciones de la Actividad.

Copyright 2014 - Bizagi

1387

2. Haga clic sobre la figura donde la poltica ser creada y seleccione Al Entrar, Al Guardar o Al Salir
para crear la poltica.
Seleccione el tem Poltica.

3. D 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.

Copyright 2014 - Bizagi

1388

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 Adjuntar Archivo en la esquina inferior
derecha. Para eliminar un archivo d clic en el botn Quitar Elemento.

Copyright 2014 - Bizagi

1389

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 Administrador de la Poltica 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 y Precondiciones.

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 Reglas de Negocio y d clic
derecho sobre Polticas.
Seleccione Nueva Poltica.

Copyright 2014 - Bizagi

1390

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 eliminar
polticas.
D clic en el tem de la Poltica que desea crear. El Administrador de Polticas ser mostrado.

Copyright 2014 - Bizagi

1391

Cuando cree polticas desde el men de procesos, ests no estarn asociadas a ninguna tarea del
proceso.
Para asociar una poltica existente a una tarea especifica, vaya en el cuarto paso del Asistente de
Bizagi (Reglas de Negocio) y seleccione Acciones de la Actividad.
D clic en la figura donde se crear la poltica, seleccione Al Entrar, Al Guardar o Al Salir para crear la
poltica.
Seleccione el tem Poltica.

Copyright 2014 - Bizagi

1392

Las polticas existentes sern mostradas. Seleccione la que desea asociar, luego d clic en Ok.

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, y Grupo de
reglas.

Copyright 2014 - Bizagi

1393

D clic en el icono del tem deseado en la parte superior de la ventana.

Cada tipo de tem debe ser definido de diferentes maneras. El procedimiento necesario para crear
cada tipo de tem se describe en las siguientes secciones:
Reglas de polticas
Tablas de decisin
Grupo de reglas

Copyright 2014 - Bizagi

1394

Precondiciones y rboles de decisin

Editar y eliminar tems de una poltica


Seleccione la poltica y luego d clic en el cono Editar.

Para borrar un tem de una poltica seleccione el tem y d clic en el cono Eliminar.

Informacin de la poltica
Copyright 2014 - Bizagi

1395

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.

Vocabulario

Introduccin
Los Vocabularios 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):

Copyright 2014 - Bizagi

1396

De acuerdo a la naturaleza de la informacin guardada, el vocabulario se puede clasificar en:


Definiciones de constante: Guarda los valores que no dependen del modelo de datos y son
definidos directamente como valores constantes.
Definiciones 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.
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 Vocabulario de las Reglas de Negocio y d clic derecho en el tipo de
definicin que desea crear. D clic en nueva definicin.

Copyright 2014 - Bizagi

1397

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, un Grupo de reglas o una Precondici,

2. En cualquier tem de la poltica, podr acceder a los vocabularios desde el panel del lado izquierdo.

Copyright 2014 - Bizagi

1398

3. D clic derecho en el tipo de definicin que desea crear y luego d clic en Nueva Definicin.

Copyright 2014 - Bizagi

1399

Se abrir el asistente para la configuracin de la nueva definicin.

Crear un vocabulario desde una expresin


1. Desde el editor de expresiones, d clic en la opcin Vocabulario.

2. En la nueva ventana, seleccione Nuevo.

Copyright 2014 - Bizagi

1400

3. Seleccione el nivel en el cual se crear el vocabulario: Proceso, aplicacin o global.

Se abrir el asistente para la configuracin de la nueva definicin.

Copyright 2014 - Bizagi

1401

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

Tipo

Disponibilidad de un producto o servicio

Booleano

Fecha de entrega de un proyecto

Fecha

Tasas de inters

Decimal

Tiempo para setear en un evento temporizador

Entero

Mximo valor permitido para solicitar en un Crdito

Moneda

Texto a enviar en un correo electrnico

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 pueden ser usadas cuando se
configuran las Expresiones y las polticas.

Copyright 2014 - Bizagi

1402

2. D clic en el botn Siguiente y seleccione el tipo de dato deseado:

Copyright 2014 - Bizagi

1403

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:

4. Una vez se haya ingresado el valor, d clic en Finalizar.

Editar Definiciones de constante


Es posible modificar las definiciones de constantes 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).

Copyright 2014 - Bizagi

1404

D clic derecho en Definiciones de constantes y seleccione Editar lista de constantes...

2. La lista de definiciones se desplegar en la ventana Editar Lista de Constantes. Es posible editar la


lista o adicionar un nuevo registro oprimiendo Adicionar definicin de constate. Esto habilitar un
nuevo registro en la tabla.

Copyright 2014 - Bizagi

1405

3. D clic en Ok 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 Polticas de Negocio.

2. Seleccione el proceso donde la definicin fue creada y d doble clic sobre esta para modificarla.

Copyright 2014 - Bizagi

1406

La ventana de edicin se desplegar de acuerdo al tipo de dato seleccionado despus de dar clic en
el nombre
.

Copyright 2014 - Bizagi

1407

D clic en el botn Actualizar una vez haya editado el valor.

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.

Definicin de XPath
Las Definiciones XPath 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 cuando se definen Expresiones y Polticas; por lo
tanto, cuando se crean sus nombres deben ser lo ms claro posible para que sean entendidas
fcilmente.

Copyright 2014 - Bizagi

1408

Las Definiciones XPath pueden estar relacionadas con un atributo simple o con una coleccin. Cuando
se relacionan con atributos simples, las definiciones pueden ser usadas para obtener o asignar
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 se selecciona Nueva Definicin, se despliega una ventana para nombrar el definicin. El
nombre debe ser claro pues stas se usarn cuando se configuran las expresiones y polticas.

2. La nueva ventana se despliega para seleccionar el XPath. D clic en Siguiente cuando se haya
seleccionado el atributo.

Copyright 2014 - Bizagi

1409

3. En la nueva ventana seleccione el destino para la nueva Definicin. Si la definicin ser usada para
asignar valores al atributo, escoja Asignar un valor. por otra parte, si la definicin se usar para
obtener un valor ingresado o calculado seleccione Obtener un valor.
D clic en Finalizar cuando seleccione la opcin.

Copyright 2014 - Bizagi

1410

La definicin de XPath se ha creado.

Cmo crear Definiciones XPath relacionadas a colecciones


1. Cuando se selecciona una Nueva Definicin (vea la seccin Vocabulario) se despliega una ventana
para nombrar el XPath. El nombre debe ser claro pues stas se usan en expresiones y polticas.

Copyright 2014 - Bizagi

1411

2. La ventana para seleccionar el XPath del modelo de datos es mostrada. D clic en Siguiente cuando
el atributo haya sido seleccionado.

Copyright 2014 - Bizagi

1412

3. Seleccione la funcin para aplicar los registros contenidos en el atributo seleccionado.

4. En la siguiente ventana podr seleccionar si esta definicin ser usada para obtener o asignar un
valor.
Sin embargo, como seleccion una coleccin stas slo estn disponibles para obtener valores, el
nico uso permitido es obtener un valor.
D clic en Finalizar para crear la definicin de XPath.

Copyright 2014 - Bizagi

1413

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 se deben cumplir todas (Operador Y) o alguna (Operador O) de las
condiciones. La opcin predeterminada es el operador Y.

Copyright 2014 - Bizagi

1414

Para incluir condiciones mltiples, d clic en Adicionar condiciones de 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 tabla muestra los diferentes operadores disponibles de acuerdo al operador izquierdo.
Atributos

Operadores

Atributos numricos

Igual, Diferente, Menor que, Menor o igual que,


Mayor que, mayor o igual que

Atributos de texto

Igual, Diferente

D clic en el icono 'X' en la derecha de la condicin si desea eliminarla. Una ventana de confirmacin
se desplegar.

Copyright 2014 - Bizagi

1415

Todos los registros de la relacin sern retornados si no se especifica un filtro.

Cmo Editar / Borrar Definiciones XPath


1. Acceda al vocabulario desde el Mdulo de procesos o desde el mdulos de la aplicacin donde se
cre la definicin, Identifique la definicin del XPath y d clic derecho sobre ella.
Seleccione la opcin Editar definicin Borrar definicin de acuerdo a lo que requiera.

Si selecciona la opcin Editar, se abrir el editor de definiciones. Siga los mismos pasos explicados
para crear una definicin.

Copyright 2014 - Bizagi

1416

Si selecciona la opcin Eliminar, una ventana de confirmacin se mostrar. D clic en S para borrar.

Definiciones usadas dentro de Polticas NO pueden ser borradas.

Propiedades avanzadas de XPath

Crear vocabularios masivamente


Las Definiciones XPath pueden ser creadas masivamente por medio de la opcin Nuevo vocabulario
masivo. Este men le permite crear mltiples definiciones de una entidad de una manera rpida.
Para crear vocabulario masivo siga los pasos a continuacin:
1. Acceda a la opcin de Vocabulario desde la vista de Mdulos en Procesos o Aplicaciones. D clic
derecho en Definiciones Xpath y seleccione Nuevo vocabulario masivo.

2. Seleccione la entidad del modelo de datos para obtener sus atributos:

Copyright 2014 - Bizagi

1417

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 para ser creado como un vocabulario, desmarque (uncheck) el
checkbox Incluir en la ltima columna.

Copyright 2014 - Bizagi

1418

Todos los atributos por defecto se definirn como opciones para OBTENER valores. Esto puede
cambiarse a ASIGNAR o AMBOS.
D clic en Finalizar para crear los vocabularios.

Contexto de Vocabulario
Usted puede crear definiciones para acceder a informacin dentro de colecciones. El mtodo de
adicin explicado anteriormente le permite acceder a cualquier atributo con una relacin uno-a-uno o
una relacin de atributo. Cuando se usen dichas definiciones se manipular directamente la
informacin del atributo. Usted tambin puede referenciar relaciones uno-a-muchos (Colecciones). Sin
embargo, no podr acceder y manipular atributos dentro de la coleccin.
Para hacer esto, Bizagi provee un vocabulario conocido como Contexto de Vocabulario. Un contexto se
refiere a la posibilidad de navegacin del XPath en el modelo de datos. Con el Contexto de
Vocabulario, usted podr acceder a atributos dentro de 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
Definiciones XPath y seleccione la opcin Nuevo contexto de Vocabulario.

2. Le recomendamos nombrar el contexto con el nombre de la coleccin. En el presente ejemplo el


vocabulario ser Productos. De esta manera puede ser creada una poltica que evale todos los
productos del caso.

Copyright 2014 - Bizagi

1419

3. El Contexto de Vocabulario puede ser filtrado para obtener, por ejemplo, todos los productos que
deben ser entregados.
Cuando se crea vocabulario dentro del Contexto de Vocabulario, la ruta para navegar el modelo de
datos comenzar desde la entidad de contexto, en este caso Productos.

Copyright 2014 - Bizagi

1420

Reglas de polticas

Introduccin
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, Sino, Entonces.
Si contiene condiciones que pueden ser combinadas con mas de una condicin usando operadores
Y / O.
Entonces contiene las acciones a ser ejecutadas cuando la condicin Si se cumple
Sino contiene las acciones para ser ejecutadas cuando la condicin Si no se cumple. Sino puede
quedar vaca.

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 Acciones de la Actividad.

Copyright 2014 - Bizagi

1421

2. Seleccione el elemento en el flujo donde se crear la Poltica. Seleccione Al Entrar, Al Salir o Al


Salvar para crear la poltica.
Seleccione el elemento Poltica.

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.
D clic en Ok.

Copyright 2014 - Bizagi

1422

4. En el Administrador de Polticas seleccione Nueva regla de polticas.

5. Una nueva ventana se abrir donde puede crear o editar su poltica.

Copyright 2014 - Bizagi

1423

6. Incluya la condicin a ser evaluada. Arrastre la definicin de vocabulario a la caja de Si en la


izquierda.
D clic en Agregar condicin para incluir tantas condiciones como desee.

Copyright 2014 - Bizagi

1424

Las definiciones de vocabulario usadas para crear las condiciones Si y Sino solo pueden ser creadas
como Definiciones Constantes o XPath que OBTIENEN un valor.
7. Ingrese las acciones para ser llevadas acabo arrastrando el vocabulario a la caja Entonces y asigne
los valores requeridos.

Las acciones deben ser creadas como Definiciones Constantes o XPath que ASIGNAN un valor.
Por defecto la caja Sino est oculta. Puede ser habilitada seleccionando la opcin Usar Sino en la
esquina superior derecha.
Arrastre el vocabulario que aplique para su caso.

Copyright 2014 - Bizagi

1425

8. Cuando termine su Regla de Poltica, oprima Finalizar.


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: Incluya 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.

Copyright 2014 - Bizagi

1426

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 2014 - Bizagi

1427

Se necesita crear 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 Acciones de la Actividad.
D clic en la figura donde se va a crear la poltica y seleccione Al Salir.
Seleccione el elemento Poltica.

2. En el Administrador de Polticas, seleccione Nueva Regla de Poltica.

Copyright 2014 - Bizagi

1428

3. La Regla de Poltica se abrir para su creacin o edicin.

4. Incluya lo siguiente para poder evaluar:


En este caso, la condicin usar un Vocabulario, es decir, una Definicin XPath que obtenga el
nmero de registros en la coleccin Productos.
D clic derecho en Definiciones XPath y seleccione Nueva definicin.

Copyright 2014 - Bizagi

1429

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 Contar del
listado ubicado en la esquina superior derecha.
D clic en Siguiente.

Copyright 2014 - Bizagi

1430

La nueva definicin XPath ha sido creada y usted puede arrastrarla desde el men. Arrstrelo a la
primera condicin del Si.

Compararemos si el conteo de productos es igual a cero. De ser as el cliente ser penalizado. Si la


definicin XPath es igual a 0, no se habrn encontrado registros en la coleccin Productos y el cliente

Copyright 2014 - Bizagi

1431

debe ser penalizado.

5. Ingrese la accin cuando la condicin evaluada sea VERDADERA: el cliente ser penalizado. El
atributo Penalizado se le debe asignar VERDADERO.
Necesitamos crear una Definicin XPath que asigne un valor al atributo Penalizado. Repita el
procedimiento descrito y al finalizar seleccione la opcin para ASIGNAR un valor.

Copyright 2014 - Bizagi

1432

Cuando d clic en Siguiente, se le pedir seleccionar si la definicin ser usada para obtener o asignar
un valor. En este caso, vamos a asignar un valor, por lo tanto, seleccione esta opcin.

Arrastre la definicin a la caja de Entonces y asigne valor Verdadero.

Copyright 2014 - Bizagi

1433

D clic en Finalizar.
6. Defina un nombre, nombre visual y descripcin para la nueva poltica

Copyright 2014 - Bizagi

1434

La regla de poltica ha sido creada.

Tablas de decisin
Las Tablas de decisin permiten definir qu acciones ejecutar para cada valor o combinacin de
valores de una o ms definiciones.
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 Obtener y Asignar (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 2014 - Bizagi

1435

Para crear Tablas de Decisin siga este procedimiento:


1. En el cuarto paso del Asistente de Procesos y seleccione Acciones de la Actividad.

2. Seleccione el elemento en el flujo donde se crear la Poltica. Seleccione Al Entrar, Al Salir o Al


Salvar.
Seleccione el elemento Poltica.

Copyright 2014 - Bizagi

1436

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.
D clic en Ok.

4. En el Administrador de Polticas, seleccione Nueva tabla de decisin.

Copyright 2014 - Bizagi

1437

5. Se abrir una ventana en donde el usuario puede crear y editar las tablas de decisin.

6. Arrastre las definiciones, definiciones de contexto y funciones de libreras hacia la caja Condiciones.
Cada definicin se mostrar como una columna y conservar el color verde para las definiciones de
OBTENER y el azul para las de ASIGNAR. Debe especificar al menos una de las definiciones sea de
OBTENER o ASIGNAR.

Copyright 2014 - Bizagi

1438

7. D clic en Agregar Registro para incluir los valores de cada columna. D doble clic en una celda para
ingresar un valor. Los valores ingresados para ASIGNAR sern el resultado de la accin de una
evaluacin Verdadera de la condicin.
Incluya tantas filas como sea necesario.

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 2014 - Bizagi

1439

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 hayan incluido, d clic en Finalizar.

Copyright 2014 - Bizagi

1440

8. Se le pedir que incluya la siguiente informacin para la nueva Tabla de Decisin.


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: Incluya 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

Empleado?

Eligible?

< 500

SI/NO

NO

> 500 y < 3000

SI

SI

> 500 y < 3000

NO

NO

Copyright 2014 - Bizagi

1441

> 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 Acciones de la Actividad..
Haga clic en la forma en que se va a crear la poltica y seleccione Al Salir.
Seleccione el elemento Poltica.

2. En el Administrador de Polticas, seleccione Nueva tabla de decisin.

3. Se abrir una ventana donde el usuario puede crear y editar las tablas de decisin.

Copyright 2014 - Bizagi

1442

4. Arrastre y suelte las definiciones que deben ser evaluadas a partir de la lista en el rea de trabajo
para crear las columnas de la tabla.

5. Incluya los valores de cada fila por cada columna.

Copyright 2014 - Bizagi

1443

6. Cuando termine d clic en Finalizar. Se le pedir que incluya nombre, nombre visual y descripcin
para su tabla.

La Tabla de Decisin ha sido creada.

Precondiciones o rboles de decisin

Introduccin
Las Precondiciones contienen condiciones lgicas que permiten o restringen la ejecucin de los
elementos que se encuentran en una jerarqua inferior. Permiten definir una jerarqua de condiciones
para organizar la ejecucin de las acciones basadas en una lgica simple.
En otras palabras, las Precondiciones 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

Copyright 2014 - Bizagi

1444

inicia mediante la revisin de las condiciones y de acuerdo con el resultado que va a tomar cada
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 el fin de semana:
Si los padres estn de visita, el plan ser definitivamente 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, el cual ser responsable de la ltima validacin y ejecucin de la accin
requerida de acuerdo con el resultado de la validacin.

Copyright 2014 - Bizagi

1445

Para crear precondiciones, siga el siguiente procedimiento:


1. Vaya al cuarto paso del Asistente de Procesos y seleccione Acciones de la Actividad.

2. Seleccione el elemento en el flujo donde se crear la Poltica. Seleccione Al Entrar, Al Salir, Al

Copyright 2014 - Bizagi

1446

Salvar.
Seleccione el elemento Poltica.

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.
D clic en OK.

4. En el Administrador de Polticas seleccione Nueva precondicin.

Copyright 2014 - Bizagi

1447

5. La siguiente ventana se visualizar. A diferencia del editor de Reglas de Poltica, esta interfaz no tiene
la seccin Entonces y Sino.

6. Incluya la condicin a ser evaluada. Arrastre las definiciones del vocabulario a la caja Si.
Haga clic en el botn Agregar condicin para incluir las opciones que sean necesarias para evaluar la
regla.

Copyright 2014 - Bizagi

1448

7. Una vez que se han incluido las condiciones requeridas guarde los cambios haciendo clic en el
botn Finalizar.
La precondicin se muestra ahora en el Administrador de polticas.

Cuando posicione el cursor sobre la precondicin, se mostrar una vista rpida del contenido de la
misma.

Copyright 2014 - Bizagi

1449

8. Haga clic derecho en la precondicin para crear las ramas que sern evaluadas cuando la condicin
se cumpla.
De esta manera, se pueden crear una jerarqua de ramas (precondiciones) y elementos de accin
(reglas de poltica, tablas de decisin, o grupos de reglas).

Recordemos, que una precondicin por s 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:

Copyright 2014 - Bizagi

1450

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

Empleado?

Eligible?

< 500

SI/NO

NO

> 500 y < 3000

SI

SI

> 500 y < 3000

NO

NO

> 3000

SI/NO

SI

Copyright 2014 - Bizagi

1451

Esta situacin puede representarse en un rbol de decisin:

1. En el cuarto paso del Asistente de Procesos seleccione Acciones de la Actividad..


Haga clic en la forma en que la poltica se va a crear y seleccione Al Entrar, Al Guardar o Al Salir.
Seleccione el elemento Poltica.

2. En el Administrador de Polticas seleccione Nueva precondicin.

Copyright 2014 - Bizagi

1452

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 Finalizar.

4. Digite un nombre, un nombre visual y una descripcin. D clic en Finalizar.

Copyright 2014 - Bizagi

1453

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.

Copyright 2014 - Bizagi

1454

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 2014 - Bizagi

1455

7. Incluya las condiciones necesarias y la accin final. Escriba un nombre, un nombre para mostrar y
una descripcin y haga clic en Finalizar.

Copyright 2014 - Bizagi

1456

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 2014 - Bizagi

1457

En este punto ste es nuestro rbol de decisin.

9. Repita los pasos para todas las precondiciones.

Copyright 2014 - Bizagi

1458

.
Una vez que todos los elementos han sido creados, el rbol completo aparecer como a continuacin:

Copyright 2014 - Bizagi

1459

Grupo de reglas
Los Grupos de reglas organizan Polticas que tienen propsitos similares para mantenerlas juntas.
Cuando un grupo de reglas tiene que ver con una accin de la actividad, todas las polticas incluidas en
el grupo sern evaluadas.

Para crear un Grupo de reglas, siga el siguiente procedimiento:


1. En el cuarto paso del Asistente de Procesos seleccione Acciones de la Actividad.

Copyright 2014 - Bizagi

1460

2. Seleccione el elemento en el flujo donde se crear la Poltica. Seleccione Al Entrar, Al Salir o Al


Salvar.
Seleccione el elemento Poltica.

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.
D clic en Ok.

Copyright 2014 - Bizagi

1461

4. En el Administrador de Polticas seleccione Nuevo grupo de reglas.

5. El editor de Polticas se desplegar para crear la primera Poltica del grupo.


Encontrar dos botones en la parte inferior del ambiente de diseo: Descartar, que descarta los
cambios y Aplicar que guarda los cambios

Copyright 2014 - Bizagi

1462

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 Agregar condicin.

7. Una vez que se han incluido todas las reglas requeridas, los cambios se pueden guardar haciendo
clic en el botn Finalizar.

Copyright 2014 - Bizagi

1463

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:
El vocabulario puede ser reutilizado en todas las aplicaciones que forman parte del proyecto en el
que fueron creadas. 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:
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 ser reutilizadas en cualquiera de los elementos del proceso en el que fueron
creados. Se crean en el cuarto paso del Asistente de Procesos (Reglas de Negocio).
La siguiente imagen muestra donde las polticas de aplicacin se crean y se almacenan.

La siguiente imagen muestra dnde se almacenan las Polticas de Proceso.

Copyright 2014 - Bizagi

1464

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 bajo cada tipo de clasificacin.

Ejemplo de reusabilidad de Polticas


Para ilustrar cmo las polticas pueden ser reutilizadas, considere el siguiente proyecto que contiene

Copyright 2014 - Bizagi

1465

cuatro aplicaciones diferentes: Administracin, Finanzas, Marketing y Operaciones.

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.)

Copyright 2014 - Bizagi

1466

En la siguiente imagen podemos ver a la poltica Valid Approval en el proceso de solicitud de compra:

La PolticaValid Approval puede ser llamada tambin en el proceso Pago de Facturas:

Copyright 2014 - Bizagi

1467

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 2014 - Bizagi

1468

En las Polticas de proceso, podemos ver que la Poltica Suggested Number of Quotes creada en el
proceso de Cotizaciones estar disponible para cualquiera de las diferentes actividades del proceso.

El alcance de la reutilizacin est limitada al nivel de proceso. Por consiguiente, estn disponibles
como acciones a cualquiera de los elementos del proceso de Cotizacin.

Copyright 2014 - Bizagi

1469

Sin embargo, si vamos al proceso de Pago de Factura, la Poltica Suggested Number of Quotes no
estar disponible para su reutilizacin.

Validar mi regla de negocio

Introduccin
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.

Copyright 2014 - Bizagi

1470

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, es necesario
incluir una sentencia de en el cdigo de la regla y as identificar qu es exactamente (nivel de detalle)
lo que se quiere rastrear.
Esta lnea de comandos grabar en un registro independiente (un archivo.txt), 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 .txt 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 que ser rastreado puede ser un atributo seleccionado por una expresin de
navegacin XPath, 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.

Ejemplo
Copyright 2014 - Bizagi

1471

Suponga una compaa de Logstica y Transporte que tiene definido un proceso llamado Shipping
Process, 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 con base a un peso volumtrico real y
el costo por libra, el cual vara dependiendo del pas destino.

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 Quote
Shipment.
Incluya un Botn y asocie una expresin a l.

Copyright 2014 - Bizagi

1472

2. Incluya el cdigo en un mdulo de expresin como se muestra en la siguiente imagen:


Obtenga el costo por libra de la entidad RateTable 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.

3. Para incluir varias trazas utilice la funcin Trace de la categora Trazas.


Defina CostCalculation 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.
Vamos a utilizar variables y expresiones XPath en las trazas para asegurarnos que los valores se
recuperan correctamente.

Copyright 2014 - Bizagi

1473

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.

//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;

Copyright 2014 - Bizagi

1474

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
4. Ejecute el proceso y escriba los valores en los campos requeridos. D 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 CHelper.trace.
Por defecto, la ruta de la carpeta de trazas es:
C:\Bizagi\[bizagi_edition]\Projects\[project_name]\Trace\

Copyright 2014 - Bizagi

1475

6. Observe cmo se muestran las trazas.

Copiar desde en expresiones


Bizagi provee la funcionalidad Copiar desde para acelerar el desarrollo de expresiones.
Esta funcionalidad le permite fcil y rpidamente crear una nueva expresin al duplicar una ya
existente.
La funcionalidad Copiar desde insertar el cdigo de la expresin original (Expresin fuente) a la
expresin destino. Por lo tanto, si usted ya ha creado elementos en su nueva expresin al copiar una
expresin se sobrescribirn estos elementos.

Copyright 2014 - Bizagi

1476

La funcionalidad Copiar desde solo puede ser utilizada para expresiones que compartan el mismo
contexto. Por ejemplo, si usted utiliza esta funcionalidad en una expresin de Proceso, usted podr
copiar expresiones asociadas al mismo Proceso, a la aplicacin a la cual pertenece el Proceso o
expresiones globales; usted no podr copiar expresiones que pertenezcan a otro Proceso o
aplicacin. De manera similar, cuando se utiliza esta funcionalidad para una expresin a nivel de
Entidad, usted solo podr copiar expresiones asociadas con la misma entidad.

Ejemplo
En un proceso de atencin de quejas y reclamos se debe actualizar alguna informacin cada vez que el
Proceso ingresa a una actividad.
Esta informacin est relacionada al asignado actual, fecha de ingreso a la actividad y estado del caso.
La expresin definida en la primera actividad del Proceso para obtener dicha informacin es la
siguiente:

<Claim.Assignee> = Me.Case.WorkingCredential.UserId;
<Claim.ActivityOpeningDate> = DateTime.Now;
<Claim.Status> = "In review";

Copyright 2014 - Bizagi

1477

Esta misma expresin podr ser utilizada para actualizar la informacin en las dems actividades del
Proceso. Sin embargo, el valor del estado del caso cambia, por lo que sera conveniente crear una
copia de la expresin original en cada una de las actividades y modificar el valor del estado segn
corresponda.
Para hacerlo, vaya a otra actividad y cree una nueva expresin. Haga clic en el botn Copiar desde que
se encuentra a la izquierda del editor de Expresiones.
Una nueva ventana mostrar la lista de expresiones disponibles. Haga clic en la expresin deseada
para seleccionarla y luego en Ok.

La informacin se copia de manera exacta a la expresin original. Ahora usted puede modificar esta
nueva expresin segn lo requiera.

Copyright 2014 - Bizagi

1478

Cuando la expresin esta completa, gurdela y cirrela.

Reutilizar reglas de negocio

Introduccin
En Bizagi es posible reutilizar reglas de negocio para hacer la automatizacin del proceso ms
eficiente. Las 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.

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 Booleanas
Estas reglas solamente deben retornar Verdadero o Falso. Como vimos en la seccin anterior, las
reglas booleanas son utilizadas para:
o Reglas asociadas al flujo de secuencia (ruta del proceso)
o Reglas utilizadas para condiciones de atributos (campos en formas) para que sean visibles,

Copyright 2014 - Bizagi

1479

editables o requeridos.
Note la opcin Reusable (Reutilizable) en la esquina inferior izquierda. Si la regla es reutilizable,
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:
o Acciones al Entrar, al Salvar y al Salir.
o Validaciones de tablas de la forma.
o Botones y formas.
Estas reglas siempre son reutilizables. Dependiendo de donde se han creado, ests pueden ser usadas
por cualquier proceso dentro del proyecto, o por un proceso dentro de la misma aplicacin, o
solamente en el proceso donde fueron creadas.

Copyright 2014 - Bizagi

1480

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:
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.
Ejemplo.
Reglas de aplicacin:
Estas pueden ser reglas Booleanas o Scripting. Pueden ser accedidas y reutilizadas por todos los
procesos de una aplicacin. Usualmente realizan clculos que aplican para los procesos que
comparten el contexto. Es posible crear familias de reglas para ordenarlas.
Ejemplo
Reglas de entidad: estas pueden ser reglas Booleanas o Scripting. Pueden ser accedidas por
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.

Copyright 2014 - Bizagi

1481

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.

Copyright 2014 - Bizagi

1482

Ejemplo de una Regla Global/ Librera de reglas


Copyright 2014 - Bizagi

1483

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 escenarios 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 Mdulos, seleccione la opcin Reglas de negocio. d clic derecho en Expresiones de la
clasificacin de las Reglas de Negocio y d 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.

Copyright 2014 - Bizagi

1484

Vamos a utilizar esta regla en el Modelador de Formas de un proceso para definir el valor por defecto
o una fecha mnima o mxima.
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 2014 - Bizagi

1485

Ejemplo de una Regla de aplicacin


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. Por lo que se necesitan de reglas de visibilidad en varias formas del mismo proceso.
Note que esta regla tiene un contexto porque 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 Mdulos, seleccione la opcin Reglas de negocio. D clic derecho sobre Expresiones en la
Aplicacin donde quiere crear la regla. Seleccione Nueva Expresin.
Bizagi le preguntar si desea una regla 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.

Copyright 2014 - Bizagi

1486

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 2014 - Bizagi

1487

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 multiplicado por la cantidad.
Vamos a calcular esta cantidad utilizando una Expresin de Validacin al Editar. 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.

Copyright 2014 - Bizagi

1488

Seleccione Editar la Expresin de Validacin. 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 2014 - Bizagi

1489

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 subproceso Cotizaciones.

Copyright 2014 - Bizagi

1490

Cmo reutilizar una regla


Cuando una regla ya ha sido creada y se desea reutilizar, vaya al flujo de secuencia que quiere asociar
y abra el administrador de expresiones.
Seleccione Basado en el resultado de una expresin.

Copyright 2014 - Bizagi

1491

Esto desplegar las reglas para ser re-usadas en la pestaa Expresiones.


Seleccione la que desea y d clic en Ok.

Copyright 2014 - Bizagi

1492

Trabajos personalizados

Resumen
Esta seccin describe cmo crear y usar los Trabajos personalizados con Bizagi.
Algunas veces la ejecucin de un proceso necesita consultar informacin externa que permita realizar
varios procedimientos. Por ejemplo, algunos procesos necesitan tener informacin sobre precios,
tasas o cualquier valor que se encuentra en un sistema externo. Otro ejemplo es cuando un proceso
necesita un evento externo para iniciar una instancia de este.
Para atender esta necesidad, Bizagi ha desarrollado los Trabajos personalizados, que son una
secuencia ordenada de pasos que son ejecutados de acuerdo a una programacin, por ejemplo,
muchas veces en una fecha especfica, peridicamente (Cada minuto, cada hora, diario, semanal o
mensual) o durante un intervalo dado entre dos fechas.
Los trabajos son reglas de negocio que se pueden llevar a cabo peridicamente y su principal
caracterstica es que expresiones generales del proceso, no estn asociados a un caso especfico de
negocio.
Los elementos de un Trabajo personalizado son:
Propiedades generales: Nombre, Descripcin, Habilitado, etc.
Programacin: Determina cundo se llevar a cabo el trabajo y qu tan seguido.
Pasos: Las acciones que se llevarn a cabo:

Qu se debe hacer?
Para aprender cmo crear trabajos personalizados, considere los siguientes pasos
1. Crear las propiedades generales del Trabajo personalizado
2. Programar el Trabajo personalizado
3. Crear los pasos que el Trabajo personalizado va a ejecutar

Cuando un Trabajo no puede ser ejecutado o genera error, Bizagi lo deshabilita automticamente.

Ejemplo
Creamos un proceso llamado Ordenes de Compras. Una instancia de este proceso debe ser creada
cuando la cantidad disponible de cualquier producto sea menor o igual a 100, considere el siguiente
flujo para este proceso:

Copyright 2014 - Bizagi

1493

Se requiere tener un Trabajo Personalizado para buscar algn producto cuya cantidad sea menor o
igual a 100. Este trabajo ser creado en esta seccin

1. Crear las propiedades generales del Trabajo personalizado


El primer paso es crear los elementos primarios del trabajo personalizado, para realizar esto, siga los
pasos a continuacin
En el men de Bizagi, vaya a la Vista de Mdulos y abra la opcin Programador.

Copyright 2014 - Bizagi

1494

Haga clic derecho en Trabajos y seleccione Nuevo Trabajo.

Copyright 2014 - Bizagi

1495

Se muestra la ventana de Propiedades del trabajo, complete los campos para el nuevo trabajo

Propiedad

Descripcin

Nombre del
trabajo

Indica el nombre del trabajo. Este nombre puede tener hasta 15 caracteres. Este
campo no debe contener espacios, tildes, marcas o smbolos.

Descripcin

Ingrese una breve descripcin de lo que hace el trabajo.

Habilitada

Esta opcin le permite habilitar o deshabilitar la ejecucin del trabajo.

Prxima hora Indica la fecha y hora en la cual el trabajo ser ejecutado en la prxima vez. Esta
de ejecucin fecha se re-programa cada vez que se ejecuta el trabajo dependiendo de la
periodicidad indicada para el mismo.
Regla de
xito

Indica la regla de negocio que ser ejecutada una vez el trabajo haya finalizado
exitosamente cada uno de los pasos.

Regla de
fallo

Indica la regla de negocio que ser ejecutada cuando la ejecucin de alguno de


los pasos haya fallado.

Agregue o cree las Reglas de xito y fallo, para crear una Regla de Negocio, dirjase a Definicin de

Copyright 2014 - Bizagi

1496

Reglas de Negocio.
Haga clic en Aceptar para guardar los cambios.

2. Programar el Trabajo Personalizado


Una vez se crea el trabajo y tiene sus propiedades, debemos crear una programacin para este
trabajo con el fin de determinar la frecuencia de ejecucin. para realizar esto, siga los pasos a
continuacin:
Expanda el nodo con el nombre del trabajo que cre y haga clic derecho sobre Programaciones y
seleccione Nueva Programacin.

Se muestra la ventana de Propiedades de la programacin. Agregue la siguiente informacin:

Propiedad

Descripcin

Nombre

Indica el nombre de la programacin. El nombre puede tener 15 caracteres


como mximo. Este campo no debe contener espacios, tildes o smbolos.

Fecha de
inicio

Fecha en la que comenzar a ejecutar el trabajo

Recurrente

Indica si el trabajo se llevar a cabo una o varias veces dependiendo de la


frecuencia establecida. Para llevar a cabo el trabajo varias veces, marque esta
casilla.

Ocurre cada

En el primer campo, escriba la frecuencia con se llevar a cabo el trabajo de


acuerdo con la frecuencia indicada, y en el segundo campo, introduzca la
frecuencia (Ejemplo: Cada N semanas).

Copyright 2014 - Bizagi

1497

Haga clic en Aceptar para guardar los cambios.

3. Crear los pasos que el Trabajo personalizado va a ejecutar


El ltimo paso de la creacin de un trabajo personalizado es establecer la secuencia de pasos que se
van a ejecutar, usted puede crear tantos pasos como sea necesario, y esta actividad se repetir varias
veces de acuerdo a los pasos requeridos. Para realizar esta accin, por favor siga los siguientes
pasos:
Si est colapsado, expanda el nodo con el nombre del trabajo que ha creado, haga clic en Pasos y
seleccione Nuevo paso.

Se muestra la ventana de Propiedades del paso de la tarea, agregue la siguiente informacin:

Copyright 2014 - Bizagi

1498

Propiedad

Descripcin

Nombre

Escriba el nombre del paso. El nombre puede tener 15 caracteres como mximo.
Este campo no debe contener espacios, tildes o smbolos. Sugerencia: elija un
nombre que caracterice a la funcin o la frmula utilizada en la etapa.

Descripcin

Introduzca la informacin de la descripcin del paso de trabajo. Esto se hace con


el fin de ser capaces de entender la funcin de la etapa cuando se lee la
descripcin.

Orden

Indica el orden en que se lleva a cabo la etapa en relacin con los otros pasos
que forman parte del trabajo.

Ejecutar
como el
usuario

Este campo indica el usuario que va a ejecutar el trabajo. Como se trata de


puestos de trabajo que se ejecutan de forma automtica y son independientes
de los usuarios de los procesos , esta propiedad le permite configurar el usuario
que se registrar en los sistemas como el que lleva a cabo el trabajo. Si no
selecciona un usuario, el sistema registrar el administrador por defecto.

Paso Exitoso

Si se ejecuta en el xito paso indique lo que hay que hacer. Las opciones son
"Siguiente Paso" , "Salida con xito" o "Salida con Fallo" .

Paso Fallido

Si se ejecuta en el fracaso paso indique lo que debe hacerse. Las opciones son
"Siguiente Paso" , "Salida con xito" o "Salida con Fallo".

Regla

En este campo, seleccione la regla de negocio que desea llevar a cabo. Si desea
llamarla desde una regla de negocio, se puede transformar en un mtodo o en
un componente. Para crear una regla de negocio, consulte Definicin de reglas
de negocio.

Cdigo

Si desea incluir el cdigo directamente , haga clic en esta opcin e introduzca el


cdigo JScript.NET en el campo.

Haga clic en Aceptar para guardar los cambios.


Para este ejemplo, hemos creado la regla CreateCase, esta regla consta de un Expresin, como se
muestra en la siguiente imagen

Copyright 2014 - Bizagi

1499

La Expresin tiene el siguiente cdigo para determinar si alguno de los productos tiene menos de 100
unidades en inventario
var col =
CHelper.GetValueAsCollection(<PurchaseOrder.Details[Product.QuantityAvai
lable <= 100]>);
if(col.size() > 0)
{
var appEnt = CHelper.NewCase(1, 1);
}
El cdigo anterior se ver as

Copyright 2014 - Bizagi

1500

Haga clic en Ok para guardar los cambios.


Cuando el trabajo sea ejecutado (en nuestro caso a las 3:00 a.m. cada da), el trabajo ejecutar la
expresin anterior, solo cuando exista al menos un producto con menos de 100 unidades disponibles,
se crear una nueva instancia del proceso en el inbox del usuario y se debe ver as.

Trabajos personalizados en produccin


Cuando un proyecto se ha desplegado, algunos elementos como los Trabajos personalizados
permanecern editables en el entorno de desarrollo. Sin embargo, para evitar posibles problemas con
las implantaciones posteriores, Bizagi restringe los cambios en algunos de estos elementos. Por esta
razn, cuando un trabajo personalizado se encuentra produccin no ser posible eliminarlo. Todo lo
dems se mantendr editable (pasos de trabajo y la programacin).

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
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.

Copyright 2014 - Bizagi

1501

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.

Correos electrnicos automticos

Introduccin
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 derecho en la actividad que requiere un mensaje y seleccione Propiedades.
Marque la opcin Notificar, 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.

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. Las Notificaciones de Abortar

Copyright 2014 - Bizagi

1502

contienen informacin bsica sobre el caso abortado. Esta notificacin est habilitada 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 funcionen correctamente. Si no se
ha configurado duracin, Bizagi no ser capaz de determinar cuando se va a enviar una alarma.

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 Negocios. Seleccione la opcin de
Notificaciones en la parte izquierda de la nueva ventana.

2. D clic en Editar para abrir el mensaje predeterminado.

Copyright 2014 - Bizagi

1503

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 Ok.

Notificaciones creadas (no automticas)

Resumen
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 el cuarto paso del Asistente de
Proceso y se llaman Correo Electrnico. Estos se pueden enviar cuando una actividad es creada,
guardada o al salir (Accin Al Entrar, Al Guardar o Al Salir)

Cmo crear un correo electrnico


1. En el cuarto paso del Asistente de Proceso seleccione Acciones de Actividad. Una nueva ventana

Copyright 2014 - Bizagi

1504

mostrar el diagrama del proceso.

2. Seleccione la actividad donde se configurar el correo electrnico.


En la ventana Acciones de la actividad, 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 2014 - Bizagi

1505

4. Seleccione los destinatarios: Haga clic en el botn Para.


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 Enviar correo electrnico a una
cuenta 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.

Copyright 2014 - Bizagi

1506

5. Escriba un asunto y el contenido.


Cuando haya terminado, haga clic en Guardar.

Copyright 2014 - Bizagi

1507

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


Usted puede incluir toda la informacin de negocio en los mensajes de correo electrnico, si los
datos han sido guardados 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: navegando por el modelo de datos o el usando la opcin de Campo XPath.
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 (>).

Copyright 2014 - Bizagi

1508

Seleccione el atributo mediante la opcin Campo XPath


Haga clic en el botn de la barra de Campo XPath 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 2014 - Bizagi

1509

<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 Hipervnculo 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

Copyright 2014 - Bizagi

1510

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 usando el botn Campo de XPath.
El XPath puede estar en cualquier parte del cuerpo del correo electrnico.
El archivo ser enviado como un archivo adjunto.

Copyright 2014 - Bizagi

1511

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 Acciones de la Actividad 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 Correo Electrnico.

Copyright 2014 - Bizagi

1512

2. Seleccione los destinatarios.


Haga clic en Para e incluya la direccin de correo electrnico. En la nueva ventana, navegue por 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 Number> que incluya el identificador de caso en el Asunto.

Copyright 2014 - Bizagi

1513

Utilice los parntesis de diamante "<>" para incluir la informacin almacenada en el modelo de
datos. Por ejemplo, el nombre del solicitante.

Copyright 2014 - Bizagi

1514

Utilice la propiedad <Case Link> 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
Hipervnculo. Escriba el texto del hipervnculo y la direccin URL asociada.

Copyright 2014 - Bizagi

1515

Enve el tiquete electrnico como un archivo adjunto. Seleccione el atributo donde se almacena el
tiquete electrnico utilizando el mtodo de parntesis.

Copyright 2014 - Bizagi

1516

4. D clic en Guardar.
As se vera el correo recibido:

Incluir Tablas o colecciones

Introduccin
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 texto fijo o atributos del
modelo de datos sin relaciones uno-a-muchos, de manera similar a las tablas que se muestran
en la siguiente imagen:

Copyright 2014 - Bizagi

1517

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
la entrega de una solicitud de compra, una vez que haya sido aprobada.

Copyright 2014 - Bizagi

1518

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 Tabla 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.

2. Cree la fila de encabezado de las columnas en la primera fila de la tabla.

Copyright 2014 - Bizagi

1519

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 cortado en la pantalla.

Copyright 2014 - Bizagi

1520

4. Haga clic en Guardar cuando el correo electrnico se ha completado.

Copyright 2014 - Bizagi

1521

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, Solicitud, y la entidad Productos.

El correo recibido contiene una tabla como la que se muestra a continuacin:

Copyright 2014 - Bizagi

1522

1. Coloque el cursor donde desea incluir su tabla dinmica.


Haga clic en Tabla dinmica en la cinta de opciones.

3. Una nueva ventana mostrar las opciones para construir la tabla requerida. Hay cuatro pestaas
que definen la tabla: Datos de la Grilla, Encabezado, Estilo del contenido y Estilo de tabla. La
informacin contenida en la pestaa Datos de la Tabla es obligatoria; 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 Nombre del Fact (nombre de la relacin) que es el XPath de la Coleccin.
Haga clic en el botn Seleccionar para navegar por el modelo de datos y seleccionar la coleccin.

Copyright 2014 - Bizagi

1523

El XPath en este caso ser Request.Products.


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.
o Si la Forma ya ha sido creada, seleccinela haciendo doble clic en su nombre.
o Si la Forma requiere edicin, seleccione el nombre para resaltarlo y, a continuacin, haga clic en
el botn Editar. Una nueva ventana mostrar el diseador de Formas para su edicin.
o Si la Forma no se ha creado, haga clic en el botn Agregar. Una nueva ventana aparecer para
construirla.

Copyright 2014 - Bizagi

1524

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 encabezado en la pestaa Estilo de tabla.
Las propiedades del encabezado son:
o Fondo: Color del fondo del encabezado de la tabla.
o Alineacin: Alineacin de los valores de cada encabezado de la tabla.
o Fuente: Color, nombre, tamao y estilo de la fuente del encabezado de la tabla.

Estilo del contenido


En esta pestaa puede configurar los estilos del cuerpo del mensaje:
o Fondo: Color del fondo del cuerpo de la tabla.

Copyright 2014 - Bizagi

1525

o Alineacin: Alineacin de los valores de cada columna del cuerpo de la tabla.


o Fuente: Color, nombre, tamao y estilo de la fuente del cuerpo de la tabla.

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 Ok.

5. La tabla dinmica se incluir en el cuerpo del mensaje.


Si necesita editarla, d doble clic sobre sta y se abrirn sus propiedades.

Copyright 2014 - Bizagi

1526

Para borrarla borre su icono usando la tecla Borrar del teclado.

5. D clic en Guardar.

IMPORTANTE:
Cuando cree la forma de la tabla dinmica, el campo Es Reusable debe estar habilitado para poder
seleccionarla.

Copyright 2014 - Bizagi

1527

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 Mltiples Mensajes. Esto
crear una nueva pestaa sobre el campo Asunto, 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 Condiciones de Envo (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
pueda identificar qu mensajes de correo electrnico va enviar.

Copyright 2014 - Bizagi

1528

Ejemplo
Imagine 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 Acciones de Actividad en el cuarto paso 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 Correo Electrnico.

Copyright 2014 - Bizagi

1529

2. Seleccione el destinatario.
D clic en Para e incluya la direccin de correo electrnico. En este caso, seleccione el correo del
cliente.

3. Escriba un Asunto y el cuerpo del primer mensaje.

Copyright 2014 - Bizagi

1530

3. Marque la casilla de Mltiples Mensajes 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 2014 - Bizagi

1531

Condiciones de envo.

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.

Copyright 2014 - Bizagi

1532

7. D clic en Guardar.

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.

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 '<', seleccione Regla y digite dos puntos ':'.

Copyright 2014 - Bizagi

1533

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: '>'.

Copyright 2014 - Bizagi

1534

Las reglas tambin pueden ser incluidos en la plantilla haciendo clic en el botn Campo Expresin.
Se abrir una ventana de manera para que el usuario pueda crear una regla.

Si la regla ha sido creada previamente, haga clic en Cancelar y seleccione la expresin deseada.

Copyright 2014 - Bizagi

1535

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 Para.
Para agregar una direccin fija, haga clic en el botn Para, seleccione Enviar correo a una cuenta
fija y escriba las direcciones.

Copyright 2014 - Bizagi

1536

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 2014 - Bizagi

1537

Para agregar un atributo que contiene una direccin de correo electrnico, haga clic en el botn
Para. Seleccione la opcin Enviar correo a partir de una seleccin del modelo de datos y seleccione
el atributo en el lado izquierdo de la ventana.

Repita este procedimiento para cada direccin que necesite incluir. Note que las direcciones quedan
separadas por punto y coma.

Copyright 2014 - Bizagi

1538

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 en el campo Para del men de configuracin 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 Enviar correo a partir de una seleccin del modelo de datos y
seleccione el atributo de la coleccin.

Copyright 2014 - Bizagi

1539

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 en el men Seleccionar direccin e-mail. Las opciones
de filtro se activan como se muestra a continuacin.

Copyright 2014 - Bizagi

1540

Haga clic en Adicionar condicin de filtro para agregar una nueva condicin.

Copyright 2014 - Bizagi

1541

Seleccione el atributo de la coleccin en el argumento de la izquierda, especifique el operador y el


comparador.
Haga clic en Ok 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 Boda que tiene una relacin de uno a muchos con la entidad Invitados,
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 al cuarto paso 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.

Copyright 2014 - Bizagi

1542

2. Haga clic en el botn Para y marque la opcin Enviar correo a partir de una seleccin del modelo
de datos. 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 2014 - Bizagi

1543

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 Seleccionar direccin e-mail.
Seleccione la Coleccin de invitados y luego haga clic en el botn Agregar condicin de filtro.

Copyright 2014 - Bizagi

1544

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 Confirma
y se selecciona nicamente los que estn con el campo en Verdadero. D clic en la opcin Asignar
Filtro y seleccione el atributo que contiene las direcciones de correo.

Copyright 2014 - Bizagi

1545

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.

Copyright 2014 - Bizagi

1546

Cambio de contexto

Introduccin
En los mensajes de correo electrnico se puede cambiar el contexto de la plantilla de acuerdo con el
campo Para.
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 Para 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 campo Para 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 Boda que tiene una relacin de uno a muchos con la entidad Invitados 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.
Cuando los destinatarios en el campo Para se obtienen a travs atributos uno a uno el mensaje y las

Copyright 2014 - Bizagi

1547

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 Boda, pero tambin puede navegar el modelo de datos desde la entidad
muchos Invitados.
Si la navegacin se hace desde la entidad muchos, hay un cambio de contexto. El contexto cambia a
la entidad Muchos. En este caso, corresponde a Invitados. La entidad de Boda ya no es la entidad de
contexto.
Cuando se ha seleccionado Invitados en el campo Para, se puede escribir el contenido desde la
entidad Boda como contexto, o se puede escribir con la entidad Invitados como contexto. Sea cual
sea la ser el punto de partida para la navegacin por el modelo de datos en su correo.

Copyright 2014 - Bizagi

1548

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.
Usted desea incluir la siguiente informacin en el correo electrnico.
<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 Invitados. 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 2014 - Bizagi

1549

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 Contexto se activa cuando el campo Para contiene una coleccin.

Elija el contexto Invitados. 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.

Copyright 2014 - Bizagi

1550

De esta manera usted puede completar el mensaje deseado.

As es como se vern los correos:

Copyright 2014 - Bizagi

1551

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 Mltiples Mensajes e
incluya una nueva plantilla haciendo clic en la ltima pestaa.

Copyright 2014 - Bizagi

1552

Haga clic en la opcin Condiciones de Envo. Una nueva ventana aparecer. Como el campo Para
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 Invitados.

Copyright 2014 - Bizagi

1553

Las condiciones se establecern desde la entidad Invitados.

Copyright 2014 - Bizagi

1554

Escriba el asunto y el cuerpo para el segundo correo, dirigido a invitadas femeninas.

D clic en Guardar.
As se vern sus correos:

Copyright 2014 - Bizagi

1555

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 Enviar a
mltiples destinatarios.

El correo electrnico tambin se pueden enviar a los asignados actuales de la actividad. Para ello,
marque el cuadro Copiar al asignado actual. El mensaje se enviar a la direccin en el campo Para y

Copyright 2014 - Bizagi

1556

una copia ser enviada al asignado actual.

Configuracin de servidor de correo

Introduccin
Los procesos en Bizagi pueden enviar notificaciones (automticas y configuradas por el usuario)
mediante el uso de un servidor de correo electrnico que sea compatible con SMTP, como Lotus
Notes y Exchange, entre otros.
Para utilizar esta opcin, slo necesita especificar la ubicacin del 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 el servidor de correo electrnico que 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 Configuracin de Bizagi Studio, y haga clic en el botn Entrono.

Copyright 2014 - Bizagi

1557

A continuacin, introduzca los datos de los parmetros SMTP que se presentan en la seccin de
Popular, de acuerdo con las descripciones en la tabla siguiente.

Opciones de notificacin
Habilitar Email

Marque esta casilla si desea habilitar el envo de notificaciones (tanto para las
notificaciones automticas como las configuradas por el usuario)

Servidor SMTP

Introduzca el nombre o la direccin IP de su servidor de correo electrnico.


Tenga en cuenta que este servidor debe ser compatible con SMTP.

Cuenta STMP

Introduzca la cuenta de correo electrnico que ser el remitente de las


notificaciones.

Enviar copia a:

Especifique una direccin de correo para enviar copia de cada una de las
notificaciones enviadas.

Enviar copia oculta

Especifique una direccin de correo para enviar copia oculta de cada una de

Copyright 2014 - Bizagi

1558

a:

las notificaciones enviadas.

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).
Para ver ms informacin sobre las notificaciones a travs de esta opcin, consulte Definicin de
notificaciones.

Configuracin avanzada
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 encolamiento 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.

Instalacin de un SMTP local

Introduccin
Esta seccin ilustra cmo configurar el Servidor SMTP como servicio, que se provee por los
componentes de Internet Information Services (IIS).
Esta opcin es especialmente til para el envo de notificaciones por correo desde los procesos de
Bizagi en los siguientes escenarios:
Para utilizar este servicio como una opcin rpida para configurar las notificaciones en Bizagi,
especialmente para demos, prototipos giles, evaluacin del producto, etc.

Copyright 2014 - Bizagi

1559

Para configurar un servidor SMTP intermedio que le permita redireccionar las notificaciones desde
Bizagi hacia su servidor SMTP corporativo.
Esta opcin es recomendada para: utilizar acceso autenticado al servidor SMTP, utilizar
configuraciones avanzadas de SMTP como personalizar el numero de puerto diferente al 25 usado por
defecto y permitir continuidad a sus negocios de proceso en el eventual caso que su servidor SMTP se
encuentre temporalmente fuera de servicio, encolando las notificaciones en el IIS.
La siguiente seccin se enfoca en cmo instalar el Servidor SMTP en un sistema operativo Windows
Server 2008 o 2008 R2.

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 o Windows Server 2008 R2


El siguiente procedimiento aplica para la versin 7 de IIS, la cual es la versin disponible en una
instalacin de Windows Server 2008/2008 R2
1. Inicie el administrador del Servidor.
Para iniciar un asistente para esta instalacin, vaya a Inicio-> Herramientas administrativas->
Administrador del servidor.

Copyright 2014 - Bizagi

1560

2. Adicione los componentes.


Para adicionar el Servidor SMTP, seleccione la opcin de Adicionar en el tem de caractersticas.

Copyright 2014 - Bizagi

1561

3. Seleccione SMTP Server.


Marque la casilla del componente Smtp server y las herramientas de administracin Remote Server
Admin Tools.

Copyright 2014 - Bizagi

1562

Revise los componentes marcados, y d clic en Instalar para adicionar estas caractersticas.

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 2014 - Bizagi

1563

Para revisar, ubique el Servicio Simple Mail Transfer Protocol. Debe estar con estatus de iniciado:

En este punto ha sido instalado e iniciado el servicio local del servidor SMTP.

Qu sigue?
Para mayor informacin sobre cmo configurar Bizagi para utilizar este servicio SMTP, consulte la
Configuracin avanzada para el servidor de correo electrnico.

Configuracin avanzada de servidor de correo

Introduccin
Bizagi ofrece la posibilidad de utilizar un servidor de correo electrnico para enviar notificaciones

Copyright 2014 - Bizagi

1564

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 Entorno 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
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, 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 ejecutndose en plataforma 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.

Prerrequisitos
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 referencindo los componentes del
servicio.
Este servicio debe estar configurado e inicializado.

Copyright 2014 - Bizagi

1565

Para ver ms informacin acerca de cmo instalar este servicio, consulte Instalacin de un SMTP local.
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 2014 - Bizagi

1566

Para ms informacin sobre la inclusin de caractersticas de IIS vaya a Instalacin de IIS.

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 Inicio -> Herramientas administrativas -> Servicios de Internet Information Server
6.0.
Tenga en cuenta que en el Administrador de IIS 6.0 tambin aplica para los sistemas operativos que
tienen IIS 7.

Copyright 2014 - Bizagi

1567

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 2014 - Bizagi

1568

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
Nuevo-> Dominio.

4. Configuracin del dominio con el Asistente.


En la ventana New SMTP Domain Wizard, primero seleccione la opcin Remoto y haga clic en
Siguiente.

Copyright 2014 - Bizagi

1569

Para el campo Nombre, escriba el nombre DNS del dominio al que desea volver a enviar notificaciones
de correo electrnico.

Copyright 2014 - Bizagi

1570

D clic en Finalizar.
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 Route Domain de la ventana de propiedades, seleccione Forward all mail to Smart Host
(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 Allow incoming mail to be
relayed to this domain).
D clic en Ok.

Copyright 2014 - Bizagi

1571

Tenga en cuenta que hay opciones adicionales presentadas en este punto. Por ejemplo, dentro de
Outbound Security.. 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).

Plantillas de Documentos
Introduccin
Bizagi permite generar documentos a la medida en Word, Excel o formato PDF. A travs de las
plantillas de Documentos, usted podr definir y generar fcilmente documentos que contienen
informacin de los Procesos.
Se basan en plantillas construidas en Microsoft Word o Excel, que pueden almacenar y mostrar
diferentes tipos 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 tipo Archivo que se pueden descargar o ser enviados por correo en cualquier
momento durante el ciclo de vida del proceso.

Copyright 2014 - Bizagi

1572

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 expresin.

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 Generar.
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 Control de Plantilla 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.

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)

Cmo manejar la informacin editable?


Copyright 2014 - Bizagi

1573

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.

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, Microsoft Excel formato
.xlsx y archivos planes en cualquier extensin (e.g .dat, .csv, .xml).
Cree una o ms plantillas de Word (el formato del archivo debe ser. docx , .xlsx o .txt), 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.

[Foreach:PrescripcinMdica][NombreMedicamento]

Copyright 2014 - Bizagi

[Dsis]

1574

[Cantidad][End]
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

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.

Copyright 2014 - Bizagi

1575

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 2014 - Bizagi

1576

[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])

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.

Copyright 2014 - Bizagi

1577

En un documento se pueden incluir el mismo tag varias veces. Usted slo tendr que mapearlo una
vez.
Esto NO APLICA para tags a colecciones. Puede haber solo UN tag por cada [Foreach]

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 2014 - Bizagi

1578

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.

Copyright 2014 - Bizagi

1579

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 2014 - Bizagi

1580

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])

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.

Copyright 2014 - Bizagi

1581

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 2014 - Bizagi

1582

Crear plantilla de archivo plano


Para crear una plantilla de texto plano, siga los pasos que se describen a continuacin:
1. Abra Notepad e incluya el contenido de texto deseado.
La siguiente imagen muestra un ejemplo de una plantilla de factura en archivo de texto plano. En esta
incluimos la informacin del Cliente y una tabla con los productos adquiridos.

Copyright 2014 - Bizagi

1583

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.
En este caso, el nombre del cliente se referencia con el Tag [NombredelCliente].

Para hacer referencia a una coleccin debe utilizar las siguientes etiquetas:

Copyright 2014 - Bizagi

1584

[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 Tags
[Foreach:Products]. Todos los Tags escritos a partir de ste hasta el [End], son atributos de esta
coleccin. ([Producto], [Cantidad], [Precio])

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 archivo
.txt.

Copyright 2014 - Bizagi

1585

En un documento se puede incluir el mismo tag varias veces. Usted slo tendr que mapearlo una
vez.
Esto NO APLICA para tags a colecciones. Puede haber solo UN tag por cada [Foreach]

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 Generar que se muestra en una
actividad especfica.
Automaticamente, via expresiones, sin intervencin de los usuarios finales.

Incluir plantilla para generar manualmente


1. Cree un atributo de tipo de Archivo en el modelo de datos.

Copyright 2014 - Bizagi

1586

2. Inserte un control de Plantillas de documentos.


En la pestaa de Controles arrastre y suelte un Control de Plantilla de documento en el lugar donde
usted lo desee.

Copyright 2014 - Bizagi

1587

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 Fuente de
datos 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 Etiqueta del botn.

Copyright 2014 - Bizagi

1588

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 d 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 2014 - Bizagi

1589

Incluir plantilla para generar automticamente


1. Cree un atributo de tipo de Archivo en el modelo de datos.

Copyright 2014 - Bizagi

1590

2. Inserte en la forma un control Archivo.


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 Acciones de Actividad.


Seleccione la tarea donde el documento ser generado y escoja Template al Entrar, Guardar o al Salir.

Copyright 2014 - Bizagi

1591

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.

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.

Copyright 2014 - Bizagi

1592

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 Asistente de configuracin.

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 2014 - Bizagi

1593

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.

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.

Copyright 2014 - Bizagi

1594

En la nueva ventana, haga clic en el botn Buscar, seleccione la plantilla y haga clic en Siguiente.
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 Siguiente.

Copyright 2014 - Bizagi

1595

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 Finalizar.

Copyright 2014 - Bizagi

1596

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 Reemplazar los documentos existentes est deshabilitada y el usuario final hace clic

Copyright 2014 - Bizagi

1597

en Generar 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 Factura 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 Aadir mapeo para abrir el asistente.

Copyright 2014 - Bizagi

1598

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 2014 - Bizagi

1599

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 2014 - Bizagi

1600

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 2014 - Bizagi

1601

Generacin de un documento de Word


Una vez configurada la plantilla estar lista para generarse 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
Generar documento.

Copyright 2014 - Bizagi

1602

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 2014 - Bizagi

1603

Si se hubiera seleccionado PDF como formato de exportacin, el documento lucira asi:

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.

Copyright 2014 - Bizagi

1604

En la nueva ventana, haga clic en el botn Buscar, seleccione la plantilla y haga clic en Siguiente.
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 Siguiente.

Copyright 2014 - Bizagi

1605

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 Finalizar.

Copyright 2014 - Bizagi

1606

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 Reemplazar los documentos existentes est deshabilitada y el usuario final hace clic

Copyright 2014 - Bizagi

1607

en Generar 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 Factura 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 Aadir mapeo para abrir el asistente.

Copyright 2014 - Bizagi

1608

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 2014 - Bizagi

1609

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.

Copyright 2014 - Bizagi

1610

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 2014 - Bizagi

1611

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.

Copyright 2014 - Bizagi

1612

Generacin de un documento de Excel


Una vez configurada la plantilla estar lista para ser generada 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
Generar documento.

Copyright 2014 - Bizagi

1613

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.

Copyright 2014 - Bizagi

1614

Si se hubiera seleccionado PDF como formato de exportacin, el documento lucira asi:

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.

Configurar una plantilla de texto plano


Desde el Asistente de Configuracin siga estos pasos:
1. Cargue la plantilla txt.
Para cargar una plantilla haga clic en el icono de Adicin.

Copyright 2014 - Bizagi

1615

En la nueva ventana, haga clic en el botn Buscar, seleccione la plantilla y haga clic en Siguiente.
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 Siguiente.

Copyright 2014 - Bizagi

1616

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 Finalizar.

Copyright 2014 - Bizagi

1617

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 Reemplazar los documentos existentes est deshabilitada y el usuario final hace clic
en Generar varias veces, se generarn varias versiones del mismo documento. Cada copia se
nombrar con el nombre del documento seguido de un nmero secuencial.

Copyright 2014 - Bizagi

1618

Por ejemplo, si Factura 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 Aadir mapeo para abrir el asistente.

Copyright 2014 - Bizagi

1619

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 2014 - Bizagi

1620

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 2014 - Bizagi

1621

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 2014 - Bizagi

1622

Si usted selecciona Igual a la plantilla se mostrar un nuevo campo para ingresar la extensin
deseada.

Generacin de un documento de texto plano


Una vez configurada la plantilla estar lista para ser generada 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.

Copyright 2014 - Bizagi

1623

Incluya la informacin necesaria en los campos de la Forma. Cuando termine, haga clic en el botn
Generar documento.

Una vez generado el documento, haga clic en el link del archivo para abrirlo.

Copyright 2014 - Bizagi

1624

As luce el documento. Observe cmo se muestra la informacin introducida en la Forma.

Si se hubiera seleccionado PDF como formato de exportacin, el documento lucira asi:

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 Actualizar para seleccionar la plantilla ajustada.

Copyright 2014 - Bizagi

1625

Seleccione el archivo y, si es necesario, cambie el nombre de la plantilla.


Si hace clic en el vnculo Guardar una copia local usted podr guardar la versin original (antes de la
modificacin) de la plantilla actualizada, en su ordenador.

Cuando termine, haga clic en Siguiente y, a continuacin, haga clic en Finalizar.

Copyright 2014 - Bizagi

1626

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 Previa. 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 Eliminar.

Copyright 2014 - Bizagi

1627

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

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:

Copyright 2014 - Bizagi

1628

En la primera actividad de un Proceso de Ingreso de Personal, 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 2014 - Bizagi

1629

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.

Copyright 2014 - Bizagi

1630

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 Generar Documento.

Observe como luce el documento.

Copyright 2014 - Bizagi

1631

Mltiples Plantillas de documentos

Introduccin
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.

Copyright 2014 - Bizagi

1632

El asistente de configuracin se abrir. Para crear una nueva Plantilla de documentos, haga clic en el
icono de signo Ms 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 2014 - Bizagi

1633

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.

Copyright 2014 - Bizagi

1634

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 Ms. Un editor de Expresin booleana se mostrar.

Cree la condicin y haga clic en Finalizar.


Para nuestro documento de Factura se identifica el tipo de cliente con un atributo relacionado a una en
una entidad paramtrica llamada TypeofCustomer.

Copyright 2014 - Bizagi

1635

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.

Copyright 2014 - Bizagi

1636

Haga clic en el botn Generar documento.


La siguiente imagen muestra el documento generado para persona natural.

Copyright 2014 - Bizagi

1637

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.

Copyright 2014 - Bizagi

1638

Tenga en cuenta que los documentos se generan con base a las plantillas definidas para cada tipo de
cliente.

Funciones avanzadas de mapeo


En muchas ocasiones puede ser necesario incluir en plantillas de documentos colecciones filtradas, un
campo que muestre la fecha de hoy o una referencia a informacin especfica de un caso.
Bizagi ofrece la posibilidad de incluir este tipo de informacin en plantillas de documento a travs de
las funciones avanzadas que se encuentran en el Control de Mapeo del Asistente de Configuracin.
Para acceder a las funciones avanzadas expanda el Control de Mapeo.

Copyright 2014 - Bizagi

1639

Las funciones avanzadas se encuentran en el icono de herramientas a la derecha.


Hay cinco funciones disponibles para usar junto con el mapeo de los atributos hacia los Tags de la
plantilla:
Informacin caso: incluye el identificador 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.
Ordenar Coleccin: permite ordenar los registros de una tabla de acuerdo a los valores de una
columna especfica.
Atributos de proceso: Si existen atributos de proceso, esta opcin se habilita para mapearlos.
Atributos de tarea: Si existen atributos de tarea, esta opcin se habilita para mapearlos.
Para restaurar la ventana a su tamao original, haga clic en el icono en la esquina superior derecha.

Copyright 2014 - Bizagi

1640

Incluir la fecha de hoy


1. Despliegue las funciones avanzadas y arrastre la funcin Fecha de hoy. Sultela en medio de las dos
tablas.

Copyright 2014 - Bizagi

1641

2. Aparecer una nueva ventana. Desde all usted puede seleccionar el formato en el cual desee
mostrar la fecha en el documento. Haga clic en Ok cuando haya seleccionado un formato.

3. Mapee la funcin hacia el Tag de la plantilla que mostrar la fecha.

Copyright 2014 - Bizagi

1642

4. Restaure la ventana a su tamao original haciendo clic en el icono de la esquina superior derecha y
luego haga clic en Finalizar.

Incluir un filtro a una coleccin


1. Despliegue las funciones avanzadas y arrastre la funcin Filtro Colecciones. Sultela en medio de
las dos tablas.

Copyright 2014 - Bizagi

1643

2. Mapee la funcin con el atributo del modelo de datos donde se almacena la coleccin.
Esto abrir la funcionalidad de filtros de coleccin en la que puede incluir las condiciones para filtrar
los registros. Haga clic en Ok cuando haya incluido el filtro.

Copyright 2014 - Bizagi

1644

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 con una funcin en el
medio que va a filtrar los registros existentes de la tabla.

Copyright 2014 - Bizagi

1645

4. Restaure la ventana a su tamao original haciendo clic en el icono en la esquina superior derecha y
luego haga clic en Finalizar.

Incluir informacin del caso


1. Despliegue las funciones avanzadas y arrastre la funcin Informacin del caso. Sultela en medio de
las dos tablas.

Copyright 2014 - Bizagi

1646

2. Mapee la funcin hacia el Tag de la plantilla donde se deba guardar la informacin del caso.

Copyright 2014 - Bizagi

1647

3. Restaure la ventana a su tamao original haciendo clic en el icono en la esquina superior derecha y
haga clic en Finalizar.

Incluir un atributo de proceso o de tarea


1. Despliegue las funciones avanzadas y arrastre la funcin Atributo de proceso. Sultela en medio de
las dos tablas.
Recuerde que estas opciones solo se mostrarn si usted ya ha definido atributos de proceso o de
tarea.

Copyright 2014 - Bizagi

1648

2. Desde la nueva tabla mapee el atributo deseado hacia el Tag de la plantilla relacionado.

Copyright 2014 - Bizagi

1649

3. Restaure la ventana a su tamao original haciendo clic en el icono en la esquina superior derecha y
luego haga clic en Finalizar.

Ordenar una coleccin por una columna especfica


1. Despliegue las funciones avanzadas y arrastre la funcin Ordenar coleccin entre las dos tablas.

Copyright 2014 - Bizagi

1650

2. Mapee la funcin con el atributo del modelo de datos donde se almacena la coleccin.
Esto abrir la funcionalidad de ordenar coleccin, en la que se debe definir el atributo XPath por el
cual ordenar y el tipo de ordenamiento (ascendente o descendente). Haga clic en Ok cuando haya
finalizado.

Copyright 2014 - Bizagi

1651

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 con una funcin en el
medio que ordenar los registros existentes de la tabla.

Copyright 2014 - Bizagi

1652

4. Restaure la ventana a su tamao original haciendo clic en el icono en la esquina superior derecha y
luego haga clic en Finalizar.

Borrar una funcin


Para eliminar una funcin avanzada, haga clic sobre sta y oprima la tecla Suprimir del teclado. Todos
los mapeos se perdern.

Plantillas de documento con tablas dentro de tablas


En muchos casos usted puede tener la necesidad de generar plantillas de documentos que incluyen
registros mltiples asociados por cada registro de una tabla. Bizagi le permite generar documentos
con este tipo de informacin simplemente incluyendo tags adicionales en el template base.

Copyright 2014 - Bizagi

1653

Recuerde que para hacer referencia a una coleccin en una plantilla, usted debe utilizar los siguientes
tags:
[Foreach:NombreColeccion]: Indica el punto de partida de la coleccin.
[NombreAtributo]: Todos los atributos que se encuentren entre los tags Foreach y End, son atributos
especficos de la coleccin.
[End]: Indica el fin de la coleccin.
Para mostrar los mltiples registros, usted puede utilizar sentencias Foreach anidadas, es decir, una
sentencia Foreach dentro de otra. La sintaxis sera:

[Foreach:Collection1Name][Foreach:Collection2Name][End][End]

Ejemplo
La Universidad Agility utiliza Bizagi para gestionar los procesos de admisin de nuevos estudiantes. Al
final de este proceso, se debe generar un reporte consolidado que incluye la lista de candidatos
aceptados y rechazados, por cada programa acadmico.
Como se muestra en la siguiente imagen, la lista de programas acadmicos se incluye en el modelo de
datos como una coleccin denomidada Careers. Asi mismo, la lista de candidatos de cada programa
se denomina CareerCandidates. Observe que se trata de una coleccin dentro de una coleccin.

Copyright 2014 - Bizagi

1654

La informacin se presenta en el Portal de Trabajo de la siguiente manera. Por cada programa se


puede acceder a los candidatos asociados:

Para generar el reporte final utilizatemos una plantilla de documento. Siga los pasos que se describen
a continuacin:
1. Cree el template.
En este caso utilizaremos una plantilla de Word. Abra Microsoft Office Word e incluya la estructura y
formato del documento.

Copyright 2014 - Bizagi

1655

2. Referencia la informacin que se obtendr dinmicamente desde el modelo de datos de Bizagi.


Incluya los tags para obtener la informacin del modelo de datos del proceso.
Primero incluya los tags sencillos.

Copyright 2014 - Bizagi

1656

Ahora incluya los tags relacionados a la coleccin Career utilizando la sentencia [Foreach:Career].

Como los tags incluidos desde el Foreach hasta el End representan atributos de esta coleccin,
podemos utilizar una nueva sentencia Foreach para referenciar los mltiples candidatos de un
programa especfico.

Copyright 2014 - Bizagi

1657

Una vez se han incluido todos los atributos de la ltima coleccin, utilice la sentencia [End] dos veces,
para cerrar las referencias:

3. El mapeo se hace de la manera usual. Simplemente relacione cada coleccin padre con su tag
correspondiente. Haga lo mismo para sus atributos:

Copyright 2014 - Bizagi

1658

En el Portal de Trabajo se muestra la informacin.


Cuando se genera desde el Portal de Trabajo, el documento se ver de la siguiente manera:

Copyright 2014 - Bizagi

1659

Plantillas de documentos en tablas


Las plantillas de documentos tambin puede ser utilizadas a nivel de registro en tablas.
Usted puede generar plantillas de documentos de manera automtica para todos los registros
incluidos en ellas.

La configuracin de estos documentos es la misma que para documentos que no pertenecen a una
tabla. La diferencia radica en que el atributo de tipo archivo que almacenar los documentos para
cada registro, debe pertenecer a una coleccin. As mismo, el mapeo de datos se hace desde el
contexto de la coleccin.

Copyright 2014 - Bizagi

1660

Para crear documentos en tablas:


1. Defina cmo generar las plantillas de documento. Recuerde que usted puede generarlos
manualmente incluyendo un control de plantilla de documento en una forma, o automticamente
creando una accin de tipo plantilla.
Si se generan manualmente, el usuario final debe dar click EN CADA UNO de los registros de la tabla
para generar el documento.
Recomendamos generarlos de manera automtica.
2. Vaya al cuarto paso del Asistente de Proceso y seleccione Acciones de Actividad.
Seleccione la tarea donde el documento ser generado y escoja Template al Entrar, Guardar o al Salir.
3. Defina el atributo de tipo archivo que contendr el documento para cada registro. Para hacerlo,
vaya a la pestaa Mltiple del asistente de configuracin, y seleccinelo desde la coleccin deseada.

4. Configure las plantillas de documento. Esto se hace de la misma manera que para un nico
documento, solo tenga en cuenta que todo el mapeo de datos se hace desde el contexto de la
coleccin.

Ejemplo
Una compaa usa Bizagi para gestionar sus ordenes de compra. Cada orden de compra posee uno o
ms productos relacionados. Una vez llega una orden, se debe generar una orden de produccin para
cada producto relacionado, para su posterior impresin.
Para configurar la generacin de las ordenes de produccin, siga los pasos descritos a continuacin:
1. Cree una plantilla de documento como una accin a la entrada en la actividad donde se generarn
las ordenes de produccin.

Copyright 2014 - Bizagi

1661

2. Desde el asistente de configuracin, vaya a la pestaa Mltiple. Observe que a diferencia de la


pestaa nico, se pueden mapear colecciones.

3. Seleccione el atributo de tipo archivo que contendr el documento en la coleccin.

Copyright 2014 - Bizagi

1662

4. Seleccione la plantilla y asigne un nombre.

5. Mapee los datos normalmente. Tenga en cuenta que el mapeo se hace desde el contexto de la
coleccin.

Copyright 2014 - Bizagi

1663

6. Seleccione el formato en el que se generarn los documentos y d clic en OK para finalizar.

Desde el Portal de Trabajo ejecute la accin. Se generar automticamente una plantilla de documento
para cada registro de la tabla.

Copyright 2014 - Bizagi

1664

Integracin ECM

Introduccin
Bizagi soporta nativamente la integracin con sistemas ECM.

Copyright 2014 - Bizagi

1665

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.

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.

Prerrequisitos
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 servicios web soportados por Bizagi para CMIS 1.0, son aquellos tipo SOAP.
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.

Copyright 2014 - Bizagi

1666

Si usted utiliza Bizagi JEE edition, tenga en cuenta que SharePoint no se soporta en la integracin
ECM.

Lo que necesita en Bizagi


Dentro de la integracin ECM se llevan a cabo los siguientes pasos:
1. Configurar el ECM.
Este paso se realiza para asegurar que su sistema ECM ofrece y cumple con los servicios web CMIS 1.0
Para mayor informacin consulte Preconfigurar 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.

Preconfigurar 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 prerrequisito para la configuracin de la integracin
en Bizagi, como se describe en Integracin con ECM.

Configurar SharePoint como ECM

Introduccin
Bizagi soporta SharePoint como sistema ECM (Gestor documental) integrado, para el almacenamiento
de documentos adjuntos en los Procesos.
El siguiente artculo describe cmo preconfigurar SharePoint, para que se soporte como repositorio

Copyright 2014 - Bizagi

1667

ECM de Bizagi.

Prerrequisitos
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 complemento (add-on).
Los siguientes son prerrequisitos 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.
El SharePoint Store Service Application debe estar configurado y con al menos una llave de cifrado
creada.
Seguir los pasos descritos para verificar o configurar la activacin de la extensin CMIS para
SharePoint 2010 o 2007 (estos pasos no son necesarios en SharePoint 2013).

Configuracin de CMIS en SharePoint


En servidores SharePoint 2010 o 2007, el conector CMIS no est incluida o habilitada por defecto.
Para utilizar este mdulo en su servidor, 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 Inicio Todos los Programas- Microsoft
SharePoint 2010 Products):
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 (Manage Farm Solutions).
Esta opcin se accede usualmente desde SharePoint Central Administrator, y desde el men de
Configuracin del sistema (System Settings).
4. Seleccione spscmis.wsp y d clic sobre desplegar soluciones (Deploy Solutions).
5. Una vez que se haya desplegado el conector, vaya a la configuracin del sitio (Site Settings) y desde
las acciones de sitio (Site Actions), seleccione administrar las caractersticas del sitio (Manage Site
Features).
Asegrese de activar el productor CMIS:

Copyright 2014 - Bizagi

1668

Si desea verificar que el conector CMIS est operando y listo para ser usado por su servidor
SharePoint, puede utilizar un navegador para verificar que los servicios Web de CMIS estn
disponibles.
Para hacerlo, ingrese la siguiente direccin URL en un navegador:
http://[servidor]/[sites]/[su_sitio]/_vti_bin/cmis/soap/
RepositoryService.svc?wsdl
Al autenticarse, podr ver la definicin wsdl de estos servicios Web CMIS:

Copyright 2014 - Bizagi

1669

El conector CMIS de SharePoint puede tener algunos errores conocidos al configurar un sitio de
SharePoint el cul se ejecuta bajo un nmero de puerto diferente al 80 que normalmente se usa por
defecto.
Se recomienda verificar con el fabricante (Microsoft) si hay soluciones o recomendaciones en este
tipo de escenarios.

Para mayor detall y gua oficial del fabricante, consulte la documentacin de Microsoft sobre Instalar y
configurar el conector CMIS.

Preparacin de SharePoint como ECM


La siguiente configuracin se realiza desde el Sitio designado como productor (producer) para
preparar la estructura en SharePoint que servir como repositorio ECM de Bizagi.
Primero, asegrese de tener una librera asignada para el almacenamiento de documentos de Bizagi
(con carpetas adicionales y estructura interior que considere necesaria), y revise la siguiente
configuracin para esta librera:

1. Para la librera, habilite la administracin de tipos de contenido (content types).


Para hacerlo, vaya a su librera y d clic sobre la configuracin de la misma (Library Settings).

Ubique las opcione avanzadas (Advanced Settings ) en la categora de configuracin general (General
Settings):

Copyright 2014 - Bizagi

1670

Seleccione Si (Yes) a la pregunta de configuracin: Permitir administracin de tipos de contenido?


(Allow management of content types?).
Guarde estos cambios:

Copyright 2014 - Bizagi

1671

2. Para la librera, habilite el versionamiento y no obligue que se use la poltica de checkout.


Para hacerlo, vaya nuevamente a la configuracin de librera (Library Settings).
En la seccin de configuracin general (General Settings), d clic sobre configuracin de
Versionamiento (Versioning Settings).
Tenga presente configurar:
Create major versions (crear versiones mayores), a la pregunta Crear versiones cada vez que
se edite un documento de la librera? (Create a version each time you edit a file in this document
library?)
No, a la pregunta Obligar a un checkout de documentos antes de ser editados? (Require documents
to be checked out before they can be edited?)

Copyright 2014 - Bizagi

1672

Notas adicionales
Asegrese de que la autenticacin bsica no est habilitada en su portal de trabajo Bizagi (a nivel
del sitio IIS).
Asegrese de haber creado los tipos de contenidos que considere relevantes.
Esto lo podr hacer desde la opcin de galeras (Galleries ).
Tenga presente definir las columnas de sitio que desee (site columns), y definir los tipos de contenidos
para el sitio (site content types).

Copyright 2014 - Bizagi

1673

De manera similar, asigne estos tipos de contenido a su librera asignada como repositorio de Bizagi.
Esto lo podr hacer en las opciones de la librera (Library settings):

Copyright 2014 - Bizagi

1674

En este punto ya hemos configurado SharePoint con los prerrequisitos de la integracin. El paso
siguiente es la configuracin del ECM en Bizagi como se describe en Definir el ECM en Bizagi.

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:

Copyright 2014 - Bizagi

1675

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 2014 - Bizagi

1676

Notas y Consideraciones
Algunos repositorios de sistemas como Alfresco, soportan diferentes content types. Por ejemplo
D:BPM: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 prerrequisitos de la integracin. El paso
siguiente es la configuracin del ECM en Bizagi como se describe en Definir el ECM en Bizagi.

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.

Copyright 2014 - Bizagi

1677

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 prerrequisitos de la integracin. El paso
siguiente es la configuracin del ECM en Bizagi como se describe en Definir el ECM en Bizagi.

Definir el ECM en Bizagi

Introduccin
Una vez tenga definido su ECM, con la carpeta del repositorio y sus tipos de contenido (content-types),
podr configurarlo en Bizagi.
Para ms informacin sobre los prerrequisitos 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 2014 - Bizagi

1678

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 de Mdulos y seleccione Sistemas Externos
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 Sistemas Externos y luego en Nuevo sistema externo....

Ingrese su Nombre, Nombre visual y una breve Descripcin.


D clic en OK
D clic en el sistema que se acabo de crear y seleccione la opcin Nuevo repositorio.

Copyright 2014 - Bizagi

1679

Ingrese un Nombre (Nombre del conector), Nombre de visual y una breve Descripcin 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 2014 - Bizagi

1680

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.

Copyright 2014 - Bizagi

1681

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 Nueva
carpeta.

Copyright 2014 - Bizagi

1682

Asigne un nombre a su carpeta y d clic en el botn a la derecha para seleccionar la carpeta del ECM.

Copyright 2014 - Bizagi

1683

En este ejemplo, seleccionamos la carpeta ClientDocument dentro de la carpeta Bizagi de un


repositorio principal de Alfresco's:

La configuracin final debera ser similar a la que se muestra en la siguiente imagen:

Copyright 2014 - Bizagi

1684

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 Mdulo de entidades y edite la lista de atributos de estas entidades:

Copyright 2014 - Bizagi

1685

En nuestro ejemplo crearemos un nuevo atributo de tipo archivo en la entidad Client:

Copyright 2014 - Bizagi

1686

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 (Bizagi) 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:

Copyright 2014 - Bizagi

1687

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 Tipo de ECM. Usted tambin puede dar clic en Ver
Metadata para revisar la informacin esperada del contenido.

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 2014 - Bizagi

1688

D clic en Finalizar para guardar los cambios.


El atributo Client document 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.

Copyright 2014 - Bizagi

1689

En nuestro ejemplo, nuestra forma editada incluir ahora el atributo Client document, el cual se
configura automticamente con el control correspondiente en Bizagi:

Copyright 2014 - Bizagi

1690

Observe que este atributo utiliza el control iCarga de archivos 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)

Copyright 2014 - Bizagi

1691

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 2014 - Bizagi

1692

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 Siguiente (al finalizar la actividad) Bizagi finalizar la transaccin (har

Copyright 2014 - Bizagi

1693

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 2014 - Bizagi

1694

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 Editar para ingresar o modificar la metadata
del documento.

Copyright 2014 - Bizagi

1695

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 2014 - Bizagi

1696

Actualizar el document
D clic en Actualizar para cargar un remplazo para este documento (de manera similar como se
adjunto el documento inicialmente).
Bloquear / Desbloquear el documento
D clic en Bloquear 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 Desbloquear para liberar un documento previamente bloqueado.

Copyright 2014 - Bizagi

1697

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.

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 2014 - Bizagi

1698

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 MiEntidadDeProceso.MiAtributoTipoArchivo.
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:
MyProcessEntity.MyCollection.MyFileAttribute.
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>);

Copyright 2014 - Bizagi

1699

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
}
}

Integracin con aplicaciones


Introduccin
Bizagi provee una poderosa capa de integracin que soporta las diferentes posibilidades de
integracin para una solucin corporativa BPM.
En estos proyectos donde existe la necesidad de integrar aplicaciones o servicios existentes, la capa
de integracin de Bizagi presenta las siguientes mltiples opciones de integracin.

Copyright 2014 - Bizagi

1700

1. Invocacion de servicios basados en Web


Para integrar aplicaciones modernas y que estn diseadas bajo una arquitectura orientadas a
servicios, Bizagi ofrece un conector para servicios Web genrico (WS Connector), el cual se configura
fcilmente para consumir servicios REST o servicios Web (p.e servicios WCF, APIs RESTful, o cualquier
servicio SOAP expuesto en el Bus de integracin corporativo (ESB), o como servicio de la nube), de una
manera sncrona o asncrona.
Lo anterior se configura a travs de un asistente que le permite mapear grficamente los parmetros,
sin la necesidad de programacin.
Vea ms informacin acerca de esta opcin, en Invocar servicios externos desde Bizagi, donde podr
ver un ejemplo del conector consumiendo un servicio en el Bus de integracin de IBM WebSphere.

2. Integrar APIs o cdigo personalizado (conectores)


Bizagi brinda la posibilidad de extender la lgica detrs de las reglas de negocio permitiendole incluir
sus propios conectores.
Podr utilizar APIs especficos o conectores a sistemas externos (Clases EJB, JMS, etc) por medio de su

Copyright 2014 - Bizagi

1701

propio cdigo (p.e para conectarse a sistemas legados).


El concepto detrs de esta integracin es tener un componente separado en la tecnologa .NET o Java
como una librera de clase.
Vea ms informacin acerca de esta funcionalidad llamada Librera de componentes en Integrar APIs
o cdigo personalizado en Bizagi.

3. Opciones adicionales para integrar sus servidores o bases de datos


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.

3.1 Conectar a fuentes de datos externos


Bizagi presenta una poderosas tecnologa para la integracin a nivel de datos, en las cuales las
estructuras de datos (tablas) en una fuente de datos externa, se puede sincronizar con el modelo de
datos en Bizagi.
Esta tecnologa se conoce en Bizagi como Virtualizacin o Replicacin de datos, y promueve la
reusabilidad de estas estructuras de informacin existentes en la organizacin (p.e en sistemas
legados), evitando las islas de informacin o las sobrecargas administrativas para mantener la
informacin sincronizada.
La replicacin de Bizagi es til para importar automticamente las listas de informacin desde
cualquier fuente de datos como una tarea programada (a manera de solo lectura).
La Virtualizacin aplica para tablas de tipo transaccional, de manera que estos valores son buscados y
actualizados en tiempo real y se actualiza la informacin en ambas vas (desde Bizagi hacia la fuente y
viceversa).
Para mayor informacin acerca de integracin con fuentes de datos externos a travs de Replicacin y
Virtualizacin consulte la Integracin de datos.

3.2 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 la Integracin ECM.

3.3 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.

3.4 Usar opciones de seguridad/autenticacin avanzadas

Copyright 2014 - Bizagi

1702

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
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 el Inicio de sesin en el
Portal de Trabajo.

3.5 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 se soportan mediante 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.
Vea ms informacin acerca de Trabajos Personalizados en Bizagi.

Tambin es posible que las aplicaciones externas invoquen fcilmente las funcionalidades de los
procesos a travs del API de Bizagi.
El API de Bizagi sigue una arquitectura orientada a servicios (para promover mejores prcticas hacia
las capacidades de integracin y de diseo de un sistema), y su API se disponibiliza mediante la
capa SOA que provee una serie de servicios Web SOAP por defecto.
Cada proyecto en Bizagi presenta su funcionalidad del flujo y de consultas, ya publicada como
mtodos Web disponibles.
Esto significa que desde un aplicativo externo se puede disparar un evento de negocio en Bizagi,
controlado por otro sistema pra poder en Bizagi: iniciar Procesos, realizar una actividad, actualizar u
obtener la informacin de los Procesos o abortar las instancias de Procesos, entre otras.

Copyright 2014 - Bizagi

1703

Vea ms informacin acerca del API de Bizagi para aplicaciones externas.

Invocar servicios externos desde Bizagi

Introduccin
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:

En Bizagi, la configuracin de este tipo de integracin se realiza por medio de un conector genrico
llamado Web service connector, 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:

Copyright 2014 - Bizagi

1704

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).
El intercambio de informacin entre Bizagi y el servicio, sea configurado en un Bus ESB, en la nube o
directamente en disponibilizado por otro sistema, 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 (Web service connector) presenta una serie de pasos grficos en los cuales no se requiere de
programacin.

Considere
Para invocar servicios externos dentro de Procesos en Bizagi, se recomienda definir estos puntos de
integracin como Tareas de Servicio BPMN.

Copyright 2014 - Bizagi

1705

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.

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 (Definir interfaces de integracin).
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).

Copyright 2014 - Bizagi

1706

Estndares soportados por el conector de servicios Web


El Conector de servicios Web es un conector genrico y poderoso el cual consume cualquier servicio
Web, sea a travs del Bus corporativo (ESB), de la nube, o configurado directamente desde un sistema
externo.
En servicios Web de tipo SOAP, se soporta lo siguiente:
Servicios Web construdos en SOAP 1.1
Servicios Web construdos en SOAP 1.2
El mtodo Web para invocar servicios Web de tipo SOAP debe ser POST y se soporta autenticacin
tipo bsica (usuario, contrasea).
Al invocar servicios REST, se debe emplear formato XML para el envo y la recepcin de la informacin.

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.
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.

Invocar servicios Web (SOAP)

Introduccin
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 Invocar servicios REST.
La siguiente imagen ilustra este concepto:

Copyright 2014 - Bizagi

1707

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.

Bizagi tiene integracin con WebSphere Enterprise Service Bus de IBM, basados en el consumo de
servicios Web a travs de SOAP, los servicios expuestos con el WebSphere Enterprise Service Bus de
IBM deben tener endpoints HTTP, los servicios con endpoints JMS no estn soportados.

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.

Copyright 2014 - Bizagi

1708

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.
Para el segundo y tercer paso, usted podr utilizar el mapeo grfico o las opciones avanzadas para
incluir transformaciones personalizadas.
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 Solicitud de Licencia de Vacaciones en el cual un
empleado ingresa una solicitud de vacaciones y consulta el nmero de das disponibles para sus
vacaciones.
Este Proceso puede puede ser descargado desde las Plantillas gratuitas de Proceso en la Central de
Procesos.

Copyright 2014 - Bizagi

1709

Para esta configuracin, vaya al sexto paso del Asistente de Procesos y d clic en la opcin Definir
Interfaces.

Copyright 2014 - Bizagi

1710

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 das disponibles
de vacaciones en la cual Bizagi obtendr, desde otro sistema, el nmero de das de vacaciones
disponibles para ese empleado.

Copyright 2014 - Bizagi

1711

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 SOAP como el Tipo de servicio para esta invocacin.
Luego ingrese la URL del servicio Web, y d clic en el botn Go.
En este ejemplo utilizamos la URL: http://www.bizagi.com/ESB/ESBServices.asmx?wsdl
El sistema buscar y refrescar una lista de mtodos Web disponibles para ese servicio Web (desde el
archivo descriptor de lectura WSDL).

Para mejores prcticas orientadas a interoperabilidad, la URL de los servicios Web tipo SOAP debe
ser definida explcitamente con la terminacin ?wsdl (p.e http://www.bizagi.com/ESB/
ESBServices.asmx?wsdl).
De esta manera se asegura una correcta referencia al descriptor, cuando se tengan servicios no
construidos bajo la tecnologa de .NET.
Seleccione el mtodo Web a ser usado y asigne un Nombre de Interfaz para esta configuracin.

Copyright 2014 - Bizagi

1712

D clic en Siguiente.

Defina los Parmetros de Entrada


En el paso Datos a Enviar, 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 nombredeusuario del Solicitante al parmetro esperado de
nombredeusuario del servicio Web.

Copyright 2014 - Bizagi

1713

D clic en Siguiente.

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.

Cuando se mapean los parmetros de entrada a un servicio Web, usted cuenta con la posibilidad de

Copyright 2014 - Bizagi

1714

incluir archivos de transformacin personalizados (XSLTs). Para hacerlo, d clic sobre el cono de
Mapeo avanzado:

Para mayor informacin sobre su uso, consulte El mapeo avanzado.

Si uno o ms valores de salida corresponden a un identificador de una entidad paramtrica, habilite


la Llave de Negocio para dicha entidad de tal forma que Bizagi pueda cargar la referencia completa.
Para hacer esto, revise Llaves de Negocio.

Definir Parmetros de Salida


En el paso de Datos de Respuesta, el mapeo del resultado que retorna el servicio web, se configura de
forma similar al mapeo de las entradas.
Con esta configuracin, Bizagi actualizar automticamente la respuesta recibida, en el modelo de
datos del Proceso.
En este ejemplo, mapeamos el resultado nmero de das de vacaciones disponibles al atributo
NumberOfDaysAvailable.

Copyright 2014 - Bizagi

1715

D clic en Siguiente.

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.

Para mayor informacin consulte Caractersticas y funciones de mapeo.

Copyright 2014 - Bizagi

1716

Cuando se mapean los parmetros de salida de un servicio Web, usted cuenta con la posibilidad de
incluir archivos de transformacin personalizados (XSLTs). Para hacerlo, d clic sobre el cono de
Mapeo avanzado:

Para mayor informacin sobre su uso, consulte El mapeo avanzado.

Configure el manejo de Errores


Bizagi presenta una opcin para configurar manejo de errores de negocio.
Esto es especialmente 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.

Copyright 2014 - Bizagi

1717

D clic en Finalizar.
En este punto, la Tarea de Servicio Verificar Das Disponibles de Vacaciones en el Proceso de Solicitud
de Vacaciones, ha sido configurado para invocar un servicio Web externo SOAP.
Observe que cuando usted da clic en el botn Finalizar, la interfaz se crear (o actualizar)
automticamente en el mdulo de Sistemas (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 Sistemas (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

Copyright 2014 - Bizagi

1718

(til por ejemplo ante eventuales cambios como por ejemplo, si se mueven los servidores que
alberguen 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.
Para mayor informacin, consulte los Mtodos para interfaces.
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.

Invocar servicios desde el Bus de IBM WebSphere

Overview
El Bus de servicios empresariales de IBM WebSphere se ha convertido en un Bus de integracin
ampliamente adoptado en las instalaciones corporativas.
Bizagi se integra con el Bus de servicios Empresariales de IBM WebSphere, a travs del conector
genrico de servicios Web que Bizagi presenta, llamado WS Connector.

Qu necesita hacer?
Para configurar en Bizagi que los procesos invoquen servicios directamente manejados por el ESB de
IBM WebSphere, usted necesitar usar el conector de servicios Web de Bizagi.
El conector de servicios Web de Bizagi, le permite configurar los parmetros de entrada y salida por
medio de un mapeo grfico y una transformacin propia de funciones que no requieren de
programacin.

Copyright 2014 - Bizagi

1719

La configuracin requerida sigue los mismos pasos presentados en Invocar servicios Web (SOAP).

Ejemplo
Con el fin de mostrar el proceso de consumir servicios configurados en el Bus de integracin de IBM
WebSphere (ESB), usaremos como ejemplo un proceso sencillo para registrar clientes y direcciones.
Adems, Usaremos un bus de IBM con un servicio llamado AddressBookService que contiene dos
mtodos:
SaveAddress que es responsable de almacenar o actualizar una direccin en una base de datos.
FindAddress que es responsable de cargar una direccin basndose en un nombre.
Lo que haremos ser crear un cliente y revisar si tiene direcciones registradas.
Si existe una direccin asociada al cliente, el usuario puede usarla o actualizarla, de lo contrario, el
usuario puede crearla.
El proceso modelado es como se ve a continuacin:

En la actividad llamada Register Address, vamos a validar la existencia de una direccin asociada con el
cliente usando el mtodo FindAddress y en la actividad Save Address vamos a guardar la actualizacin
o registro de una direccin asociada a un cliente usando el mtodo SaveAddress.
El modelo de datos para este proceso se muestra a continuacin:

Copyright 2014 - Bizagi

1720

La entidad Address ser actualizada con el resultado del Servicio Web.

Observe que la entidad City es una entidad paramtrica.


Como nuestro servicio enva y recibe solamente el cdigo de la Ciudad, estableceremos que el
atributo code es la llave de negocio definiendo la unicidad de los registros en la entidad City (cada
ciudad tiene un cdigo nico).
Para definir Llaves de negocio en entidades de Bizagi, dirjase a Llaves de Negocio.
Para encontrar la direccin, hemos definido nuestra forma con un botn que ejecuta la interfaz.
Una vez el servicio retorna la respuesta, Bizagi mostrar la informacin de cada campo con la
informacin.
Si se debe registrar una nueva direccin, la actividad Save address se ve involucrada para ejecutar el
otro servicio.

Procedimiento
Vamos a mostrar el procedimiento que se lleva a cabo para configurar la invocacin del servicio
FindAddress.
1. Abra el conector de Servicios Web.
Para este caso en el cual el servicio web es invocado desde un botn, el conector de servicios Web se
abre desde Acciones y Validaciones dentro de la forma de la actividad Register Address.

Copyright 2014 - Bizagi

1721

2. Configure la informacin gethe service general information.


Seleccione SOAP como el tipo de servicio, escriba la URL del servicio y haga clic en Ir a URL para
mostrar los mtodos disponibles.

Copyright 2014 - Bizagi

1722

Seleccione el mtodo y haga clic en Siguiente.


3. Mapee los parmetros de entrada.
Arrastre los parmetros para mapear la informacin que Bizagi debe enviar al servicio FindAddress.
En nuestro ejemplo, enviamos el identificador del cliente que fue establecido como nombre de la
direccin para el parmetro Name.
Observe que el nombre del parmetro tiene un atributo XML llamado Value, en el cul necesitamos
enviar la informacin.
Haga clic en Siguiente.

Copyright 2014 - Bizagi

1723

4. Mapee los parmetros de salida.


Al igual que en el paso anterior, use la funcionalidad de arrastrar y soltar para mapear grficamente la
informacin de la respuesta del servicio la cual, actualizar el modelo de datos de Bizagi.
En nuestro ejemplo, almacenamos toda la informacin de las direcciones en nuestra entidad Address
(El usuario tiene una direccin asociada).

Observe que la informacin de entrada de la ciudad de la direccin es enviada como un cdigo de


texto.
Vamos a mapear el valor de Ciudad en el atributo Code en la entidad City de Bizagi lo que permite
hacer un enlace entre el registro de la ciudad que ya se tiene en Bizagi y que corresponde al cdigo.
De esta manera, no se crean nuevas ciudades.
Haga clic en Siguiente.

Copyright 2014 - Bizagi

1724

5. Defina el manjeo de errores.


Este paso es opcional
Usted puede definir un manejo de errores para este servicio y luego hacer clic en Finalizar.
En nuestro ejemplo, no definimos manejo de errores.
Para informacin sobre cmo definir el manejo de errores, dirjase a Manejo de Errores en Interface.

Copyright 2014 - Bizagi

1725

En este punto, hemos configurado la invocacin de un servicio del Bus de Servicios Empresariales de
IBM WebSphere desde un proceso en Bizagi.
Los mismos pasos deben ejecutarse para la invocacin del servicio SaveAddress, pero en vez de usar
el conector de los servicios Web desde un botn, lo configuramos en la actividad asncrona Save
Address.

Ejecucin
Una vez hayamos configurado la invocacin del servicio, ejecutamos el proceso:
Cuando se trabaja en la actividad Register Address Cuando se trabaja en la actividad FindAddress.

Copyright 2014 - Bizagi

1726

Cuando se trabaja en la actividad Save AddressCuando se trabaja en la actividad SaveAddress.

Ambos mtodos de del servicio son consumidos del WSDL publicado, manejado por el ESB de IBM
WebSphere:

Copyright 2014 - Bizagi

1727

Consideraciones
Los servicios Web disponibles en el Bus de Servicios Empresariales de IBM WebSphere deben ser
definidos con endpoints HTTP.
Otros endpoints como JMS no estn soportados.

Enviar y recibir archivos


Cuando se invocan servicios externos desde Bizagi, puede utilizar fcilmente las opciones del Conector
de servicios Web para:
Enviar archivos que estn almacenados en Bizagi, hacia un servicio Web.
Recibir archivos de la respuesta de un servicio Web y almacenarlos automticamente en Bizagi.
Los dos escenarios anteriores se contemplan por Bizagi haciendo uso del mapeo grfico para la
configuracin de la invocacin del servicio Web (sus parmetros de entrada y de salida).
Tenga en cuenta que los archivos en in Bizagi son almacenados en: atributos de tipo Archivo, o
atributos de tipo Imagen en el modelo de datos.

Consulte los artculos a continuacin para ver un ejemplo en ambos escenarios:


Envo de archivos desde Bizagi al servicio Web.
Recepcin de archivos en Bizagi enviados por el servicio Web.

Copyright 2014 - Bizagi

1728

Enviar archivos a un servicio Web


El siguiente ejemplo ilustra el mapeo a travs del Conector de servicios Web cuando se quieren enviar
archivos desde Bizagi a un servicio Web.
Para ms informacin, consulte Enviar y recibir archivos.

Envo de archivos desde Bizagi al servicio Web


Para ilustrar la configuracin en integraciones con servicios Web, cuando se involucran archivos que
estn almacenados en Bizagi, utilizaremos el proceso de Mesa de ayuda como ejemplo.
En este proceso, creamos una nueva actividad de servicio llamada Crear el registro del reporte en el
sistema A (Create reported case record in System A), la cual la adicionamos justo despus de que se
crea el ticket de soporte.
La actividad de servicio estar a cargo de enviar el archivo que adjunta el cliente (el cual contiene
detalle adicional relacionado al caso creado para la mesa de ayuda), hacia el sistema externo llamado
"System A".

Para configurar la invocacin al servicio Web, lanzamos el Conector de servicios Web desde el paso 6
llamado Integracin: Definir interfaces (Integrate --Define Integration Interfaces--), y configuramos la
actividad de servicio mediante los siguientes pasos:
1. Ingrese la informacin principal del servicio Web.
Despus de ingresar la URL del servicio, haga clic en Ir (Go) para seleccionar el mtodo Web. Haga clic
en Siguiente (Next).

Copyright 2014 - Bizagi

1729

2. Defina los parmetros de entrada.


Mapee la informacin que sale de Bizagi hacia el servicio Web.
En este escenario en el cual queremos enviar un archivo, asegrese de seleccionar la propiedad data
(la cual contiene los bytes) del tipo de atributo Archivo o Imagen.
En el ejemplo, mapeamos el archivo que est almacenado en Bizagi en el atributo CaseFile hacia los
parmetros del servicio Web.

Copyright 2014 - Bizagi

1730

Si necesita enviar el nombre fsico del archivo, entonces deber mapear tambin la propiedad
fileName hacia un parmetro de tipo cadena (string).
3. Defina los parmetros de salida.
Mapee los parmetros de la respuesta del servicio Web hacia los atributos del modelo de datos del
proceso (de esta manera la informacin se actualiza en Bizagi).
Para este ejemplo, nuestro servicio Web simplemente retorna una confirmacin del xito de la
operacin (un booleano que devuelve verdadero o falso).
En el ejemplo, mapeamos la respuesta al atributo RegisteredinSystemA:

Copyright 2014 - Bizagi

1731

4. Defina manejo de error opcional.


Para este ejemplo, no configuramos manejo de error adicional en caso de que haya una falla en la
invocacin.
D clic en Finalizar (Finish).

Copyright 2014 - Bizagi

1732

En este punto hemos finalizado, y al ejecutar el proceso podremos ver la invocacin!

Consideraciones adicionales
Cuando se mapean archivos a un servicio Web, considere lo siguiente:
1. Al mapear archivos hacia parmetros de tipo cadena (string), los archivos sern enviados al servicio
Web como una cadena codificada en base 64.
Por otra parte, cuando los archivos se mapean a arreglos de bytes (byte []), estos sern enviados
igualmente por Bizagi como un arreglo de bytes.
2. Los atributos de tipo Archivo en Bizagi pueden contener ms de un archivo adjunto. Por el contrario,
los atributos de tipo Imagen validan automticamente que se incluya mximo un archivo adjunto. Por lo
tanto, para los atributos de tipo archivo, ntese que:
Cuando haya ms de un archivo adjunto almacenado, y el servicio Web solamente espere recibir un
archivo, Bizagi enviar el primero de ellos (como se configura en el ejemplo de arriba).
Tenga en cuenta que si desea permitir 1 archivo mximo en los atributos de tipo archivo, puede
hacerlo a travs de las propiedades del control en cada forma donde sea editable el mismo.
Puede enviar ms de un archivo al servicio Web.
Esto lo har Bizagi de manera automtica, pero para este escenario deber tener en cuenta que que el
servicio Web debe recibir entre sus parmetros de entrada una coleccin de archivos (representados
como un arreglo de tipo "arreglo de bytes").
Deber asegurarse de mapear el tem que representa la coleccin para este escenario:

Copyright 2014 - Bizagi

1733

Ejecucin
En el portal de trabajo de Bizagi, creamos una nueva instancia para el proceso de Mesa de ayuda para
visualizar la invocacin al servicio Web donde le enviamos archivos desde Bizagi.

Copyright 2014 - Bizagi

1734

Ntese que adjuntamos un archivo en el atributo Case file en el caso nuevo de soporte.

Al hacer clic en Siguiente (Next), la actividad donde continua el flujo (despus de la invocacin al
servicio Web) mostrar la respuesta actualizada de la invocacin.
Ntese que el archivo es enviado existosamente al servicio Web dado que su respuesta notifica que

Copyright 2014 - Bizagi

1735

hubo registro (Registered in System A = true):

Recibir archivos desde servicios Web


El siguiente ejemplo ilustra el mapeo a travs del Conector de servicios Web cuando se quieren recibir
archivos en Bizagi que vienen de un servicio Web.
Para ms informacin, consulte Enviar y recibir archivos.

Recepcin de archivos en Bizagi enviados por el servicio Web


Para ilustrar la configuracin en integraciones con servicios Web, cuando reciben archivos para
almacenar en Bizagi, utilizaremos el proceso de Suscripcin de pliza de automviles como ejemplo.
En este proceso, creamos una nueva actividad de servicio llamada Buscar registro del cliente (Search
for client record), la cual la adicionamos justo despus de que se registra la informacin bsica del
cliente y el automvil.
La actividad de servicio estar a cargo de obtener del sistema externo la informacin del registro del
cliente como dueo de la pliza (el cual contiene detalle adicional y una foto del cliente).

Copyright 2014 - Bizagi

1736

Para configurar la invocacin al servicio Web, lanzamos el Conector de servicios Web desde el paso 6
llamado Integracin: Definir interfaces (Integrate --Define Integration Interfaces--), y configuramos la
actividad de servicio mediante los siguientes pasos:
1. Ingrese la informacin principal del servicio Web.
Despus de ingresar la URL del servicio, haga clic en Ir (Go) para seleccionar el mtodo Web. Haga clic
en Siguiente (Next).

Copyright 2014 - Bizagi

1737

2. Defina los parmetros de entrada.


Mapee la informacin que sale de Bizagi hacia el servicio Web.
En este escenario queremos obtener la informacin del dueo de la pliza, y por lo tanto, enviaremos
el tipo de documento y el nmero de documento del cliente.

Copyright 2014 - Bizagi

1738

3. Defina los parmetros de salida.


Mapee los parmetros de la respuesta del servicio Web hacia los atributos del modelo de datos del
proceso (de esta manera la informacin se actualiza en Bizagi).
Para este ejemplo, nuestro servicio Web retorna un archivo de imagen con la foto del cliente.
En el ejemplo, mapeamos la respuesta a la propiedad data del atributo Picture (la propiedad data
contiene los bytes).
Tenga en cuenta que el atributo llamado Picture es un atributo de tipo Imagen en nuestro modelo de
datos:

Copyright 2014 - Bizagi

1739

Tenga en cuenta que para asignar un nombre al archivo en Bizagi, deber mapear una cadena
(string) hacia el atributo fileName.
4. Defina manejo de error opcional.
Para este ejemplo, no configuramos manejo de error adicional en caso de que haya una falla en la
invocacin.
D clic en Finalizar (Finish).

Copyright 2014 - Bizagi

1740

En este punto hemos finalizado, y al ejecutar el proceso podremos ver la invocacin!

Consideraciones adicionales
Cuando se mapean archivos a Bizagi que provengan de un servicio Web, considere lo siguiente:
1. Se requiere que el servicio Web retorne un arreglo de bytes (byte []),
2. Los atributos de tipo Archivo en Bizagi pueden contener ms de un archivo adjunto. Por el contrario,
los atributos de tipo Imagen validan automticamente que se incluya mximo un archivo adjunto. Por lo
tanto, para los atributos de tipo archivo, ntese que:
Cuando haya ms de un archivo adjunto almacenado, y el servicio Web solamente espere recibir un
archivo, Bizagi enviar el primero de ellos (como se configura en el ejemplo de arriba).
Tenga en cuenta que si desea permitir 1 archivo mximo en los atributos de tipo archivo, puede
hacerlo a travs de las propiedades del control en cada forma donde sea editable el mismo.
Puede enviar ms de un archivo al servicio Web.
Esto lo har Bizagi de manera automtica, pero para este escenario deber tener en cuenta que que el
servicio Web debe retornar (en sus parmetros de salida) una coleccin de archivos (representados
como un arreglo de tipo "arreglo de bytes").
Deber asegurarse de mapear el tem que representa la coleccin para este escenario:

Copyright 2014 - Bizagi

1741

Ejecucin
En el portal de trabajo de Bizagi, creamos una nueva instancia para el proceso de Suscripcin de
pliza de automviles para visualizar la invocacin al servicio Web donde recibimos un archivo y lo
almacenamos en Bizagi.

Copyright 2014 - Bizagi

1742

Ingresamos el nmero del documento y seleccionamos el tipo de documento del dueo de la pliza:

Al hacer clic en Siguiente (Next), la actividad donde continua el flujo (despus de la invocacin al
servicio Web) mostrar la respuesta actualizada de la invocacin.
Ntese que el cliente fue encontrado en el sistema externo, dado que la respuesta del servicio Web
envia la foto del mismo (devuelve un archivo de imagen):

Copyright 2014 - Bizagi

1743

Invocar servicios REST

Introduccin
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.
Para la integracin con servicios Web de tipo SOAP, consulte Invocacin de servicios SOAP.
La siguiente imagen ilustra este concepto:

Copyright 2014 - Bizagi

1744

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.
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)

Copyright 2014 - Bizagi

1745

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 WSDL
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

Mtodo HTTP

Crear

PUT

Leer

GET

Actualizar

POST

Eliminar

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.

Prerrequisitos
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.
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,

Copyright 2014 - Bizagi

1746

Post, Put 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 prerrequisito 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 2014 - Bizagi

1747

En este ejemplo especfico, usaremos la Geocodificacin API 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 Vendedor en Bizagi:

Copyright 2014 - Bizagi

1748

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 Consultar
posicin de geocdigo.
Esto se hace desde el paso 6 del asistente de Proceso (Integracin) en la opcin Definir interfaces de
integracin:

Copyright 2014 - Bizagi

1749

En esta vista, demos clic en la Tarea de Servicio Consultar posicin de geocdigo 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:

Copyright 2014 - Bizagi

1750

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.

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, "{", "}".

Copyright 2014 - Bizagi

1751

Nuestra URL de Servicio final es: address={Value1}&sensor=true

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 Siguiente.

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:

Copyright 2014 - Bizagi

1752

Damos clic en Siguiente.

Cuando se mapean los parmetros de un servicio REST, usted cuenta con la posibilidad de incluir
archivos de transformacin personalizados (XSLTs). Para hacerlo, d clic sobre el cono de Mapeo
avanzado:

Para mayor informacin sobre su uso, consulte El mapeo avanzado.


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 POST o PUT, se muestra una ventana de configuracin adicional (Datos a
Enviar), para crear o actualizar un recurso.
La configuracin para este paso se hace de manera similar a lo descrito en la siguiente seccin

Copyright 2014 - Bizagi

1753

(Mapear la informacin de respuesta retornada por el servicio).

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.

Copyright 2014 - Bizagi

1754

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 Cargar XML de muestra en las opciones de importacin, para cargar la
estructura XML del archivo .XML (localizando la estructura XML que guardamos previamente):

Copyright 2014 - Bizagi

1755

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:

Copyright 2014 - Bizagi

1756

D clic en Siguiente.

Cuando se mapean los parmetros de un servicio REST, usted cuenta con la posibilidad de incluir
archivos de transformacin personalizados (XSLTs). Para hacerlo, d clic sobre el cono de Mapeo
avanzado:

Para mayor informacin sobre su uso, consulte El mapeo avanzado.

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 2014 - Bizagi

1757

D clic en Siguiente.

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:

Copyright 2014 - Bizagi

1758

En el Portal de Trabajo, creamos un nuevo caso del Proceso de Crear Vendedor e ingresamos la
direccin del vendedor en el campo de la tarea Registrar Informacin del Vendedor.
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 2014 - Bizagi

1759

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
(til por ejemplo ante eventuales cambios como por ejemplo, si se mueven los servidores que
alberguen servicios web externos).
Para mayor informacin, consulte Administracin de Interfaces.

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.

Copyright 2014 - Bizagi

1760

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 2014 - Bizagi

1761

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

Copyright 2014 - Bizagi

1762

selecciona y consume la respuestas en formato XML.

Caractersticas y funciones de mapeo

Introduccin
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 su
edicin .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 2014 - Bizagi

1763

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
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.

Copyright 2014 - Bizagi

1764

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.

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.

Copyright 2014 - Bizagi

1765

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.

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 Agregar Nodo 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 Nodo Raz y luego clic derecho en cualquier lugar de la tabla:

Copyright 2014 - Bizagi

1766

D clic derecho sobre el nodo raz para mostrar una lista de caractersticas asociadas.

Copyright 2014 - Bizagi

1767

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 info1 e info2:

Copyright 2014 - Bizagi

1768

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.

Copyright 2014 - Bizagi

1769

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 2014 - Bizagi

1770

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.

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:

Copyright 2014 - Bizagi

1771

Cargar XML de muestra


Esta opcin cargar toda la estructura XML desde un archivo de muestra .XML:

Copyright 2014 - Bizagi

1772

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
"An error occurred while parsing... ")

Exportar
Una vez cargada la estructura XML, usted puede guardar esta definicin para usos futuros:

Copyright 2014 - Bizagi

1773

Exportar a XSD
Esta opcin guardar la estructura XML actual como un archivo .XSD:

Copyright 2014 - Bizagi

1774

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.

Copyright 2014 - Bizagi

1775

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.

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 2014 - Bizagi

1776

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:

Copyright 2014 - Bizagi

1777

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 (param1).

Repita este paso para la entrada que usted ha escogido como param2.
Finalmente, seleccione la lnea de Salida 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 2014 - Bizagi

1778

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.

Copyright 2014 - Bizagi

1779

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 2014 - Bizagi

1780

Para los otros dos parmetros, la funcin espera un nmero que indica:
Parmetro de Inicio: 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".

Copyright 2014 - Bizagi

1781

Parmetro de Longitud: 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
Constante.
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 2014 - Bizagi

1782

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

Copyright 2014 - Bizagi

1783

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 Instancia 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 2014 - Bizagi

1784

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.

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.

Copyright 2014 - Bizagi

1785

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 2014 - Bizagi

1786

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 Tipo de servicio, su URL y mtodo.

D clic en Siguiente y especifique cualquier informacin de entrada para la invocacin:

Copyright 2014 - Bizagi

1787

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
pname se almacenar dentro de info1.

Copyright 2014 - Bizagi

1788

Observe que por defecto, Bizagi Anexar estos registros.


Si usted desea editar esta configuracin (aplica para Bizagi .NET) y especificar que los registros se
reemplazarn (use Reemplazar), d doble clic en el nombre de su coleccin:

Cuando cambie esta configuracin y d clic en OK. Usted notar que la etiqueta mostrar
automticamente la nueva configuracin.

Copyright 2014 - Bizagi

1789

Finalmente, configure el manejo de errores en caso de haber alguno (en este ejemplo saltaremos este
paso por lo que damos clic en Finalizar).

Copyright 2014 - Bizagi

1790

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).

Mapeo avanzado

Informacin General
La invocacin de servicios externos desde Bizagi se configura fcilmente utilizando el conector de
servicios Web.
Este conector brinda opciones amigables para definir grficamente el mapeo involucrado en los
puntos de integracin de los procesos.

Los puntos de integracin en los procesos se configuran usualmente mediante Actividades


Asncronas, para invocar servicios externos Web o de tipo REST.
Para ver ms informacin acerca de configurar estos puntos de integracin de manera que sean

Copyright 2014 - Bizagi

1791

ejecutados asncronamente, consulte Actividades Asncronas.


En escenarios ms sofisticados, el conector de servicios Web tambin permitir incluir y personalizar
un archivo de transformacin (XLST) para el mapeo de los parmetros.
Esto es til en escenarios donde hay necesidad de usar funciones de transformacin avanzadas (por
ejemplo, XSLT if, o namespace-alias, etc).

Para hacer uso de esta opcin, se utiliza el conector de servicios Web pero se especifica el uso del
modo Avanzado al hacer clic sobre este cono:

Ilustraremos como utilizar esta opcin adicional en Bizagi para incluir transformaciones y funciones
avanzadas.
Ntese que esta funcionalidad requiere de conocimiento avanzado en archivos XML (y XSD, XSLT).

Qu se necesita hacer
Para utilizar opciones avanzadas del mapeo en la invocacin de servicios externos, configuramos la
invocacin a travs del conector de servicios Web como cualquier otra configuracin.
Para este mapeo, que aplica tanto para los parmetros de entrada como los de salida, se lleva a cabo
los siguientes pasos:
1. Configure la URL del servicio y el mtodo Web.
Para el primer paso de configuracin no se requieren consideraciones especiales.
En este paso se especifica la URL del servicio (sea un servicio REST o servicio Web).
2. Al especificar el mapeo, cambie al modo avanzado.
D clic en el cono para cambiar al modo de mapeo avanzado.
3. Obtenga las definiciones de los esquemas y genere su propio archivo de transformacin.
En esta vista, podr obtener el XSD esquema que representa la informacin manejada tanto por Bizagi
como por el servicio externo.
Podr seleccionar estos esquemas y usarlos como insumo de informacin para generar su archivo de
transformacin personalizado (por ejemplo, podr hacer uso de Altova o del programa especializado
de su eleccin, que manipule y genere estas transformaciones).
4. Adjunte la transformacin de vuelta en la configuracin de la invocacin del servicio.
Una vez que tenga la transformacin, crguela en la configuracin. De esta manera, en ejecucin Bizagi
utilizar esa transformacin para preparar o manipular la informacin que se intercambia con el

Copyright 2014 - Bizagi

1792

servicio (sea una transformacin para el envo de datos y otra para actualizar la respuesta a Bizagi).
5. Complete la configuracin.
Repita el uso de mapeo avanzado para los parmetros de salida de su servicio, si ste lo amerita.
Finalmente, defina de manera opcional si hay algn manejo especfico de errores.

Ejemplo de mapeo avanzado


Para este ejemplo, vamos a utilizar un proceso sencillo de Bizagi en donde se consulta informacin del
cliente desde un servicio Web.
Este proceso en Bizagi maneja informacin de clientes que pueden ser tanto personas naturales como
personsas jurdicas.
Por lo tanto, al realizar la bsqueda del cliente, vamos a enviar la informacin que lo identifica
nicamente de manera diferente, con respecto a qu tipo de persona lo representa.

1. Configure la URL del servicio y el mtodo Web.


En este ejemplo se configura la invocacin a un servicio Web de tipo SOAP.
Seleccionamos el mtodo Web getCustomerPhoto:

Ntese que este mtodo de ejemplo recibe una cadena que contiene la identificacin del cliente, y
enva de vuelta la imagen que tiene para el registro del cliente en el sistema externo (asumiento que el
cliente existe).
D clic en Siguiente (next).

Copyright 2014 - Bizagi

1793

2. Al especificar el mapeo, cambie al modo avanzado.


Para los parmetros de entrada seleccionamos las opciones avanzadas (Advanced options) haciendo
clic sobre el cono ubicado en la parte superior derecha:

Una vez sobre el modo de mapeo avanzado, asegrese de seleccionar todos los atributos y campos
que se involucran en los parmetros de entrada del servicio Web.
En este punto significa exactamente seleccionar del panel izquierdo, la informacin que necesita
extraer de Bizagi.
En los parmetros de entrada, todos los campos definidos como parmetros de entrada del servicio
deben quedar marcados (del panel derecho).

Copyright 2014 - Bizagi

1794

Usted podr utilizar el mapeo grfico como punto de partida para su transformacin.
Sin embargo, los cambios que realice en el mapeo avanzado sern descartados si se devuelve al
mapeo grfico.
3. Obtenga las definiciones de los esquemas y genere su propio archivo de transformacin.
Habiendo seleccionado la informacin relevante, utilice el cono en la parte inferior de los pneles para
visualizar y obtener el esquema generado (el XSD).
De esta manera, se obtiene la definicin estructural de la informacin que se intercambiar entre el
servicio Web y Bizagi (en este caso, para los parmetros de entrada del servicio).

En la ventana emergente, copie el contenido del XSD y utilcelo para construir su archivo de

Copyright 2014 - Bizagi

1795

transformacin personalizado (un XSLT).


La siguiente imagen muestra el esquema que representa la informacin de Bizagi seleccionada:

Si se necesita enviar informacin en una cadena, que tenga dentro una estructura y contenido XML,
o para escapar caracteres reservados en XML (cuando se identifica que la informacin contenida
podr tener caracteres especiales como: las comillas dobles, el Ampersand, apstrofes, o los signos
de menor y mayor que), podr utilizar el elemento CDATA.
En los archivos de transformacin utilice el CDATA as:
<xsl:text disable-output-escaping="yes">&lt;![CDATA[</xsl:text>
<xsl:text disable-output-escaping="yes">]]&gt;</xsl:text>
para encapsular dentro la informacin que no haga parte del XML de afuera.
4. Adjunte la transformacin de vuelta en la configuracin de la invocacin del servicio.
Una vez que cuente con el archivo de transformacin, adjntelo a la configuracin de Bizagi.
En ejecucin, Bizagi utilizar esta definicin para preparar o manipular la informacin intercambiada
con el servicio (sea para el envo o recepcin de la misma).
En nuestro ejemplo, la transformacin que se contruy utiliza la funcin <xsl-if> para enviarle al
servicio Web la informacin apropiada (la identificacin del cliente):
Se enva lo contenido por el atributo llamado Legal name, (nombre legal) si el cliente registrado es
una persona jurdica.
Se enva lo contenido por el atributo llamado Identification, (identificacin) si el cliente registrado es
una persona natural.

Copyright 2014 - Bizagi

1796

Para adjuntar la transformacin, use el cono ubicado en la parte baja del panel intermedio, y crguela
desde un archivo:

Ntese que ver la transformacin en el panel intermedio.


Clic en Siguiente (next).

Copyright 2014 - Bizagi

1797

5. Complete la configuracin.
Repita el manejo de tranformaciones personalizadas para los parmetros de salida de ser necesario.
En nuestro ejemplo, no utilizamos una transformacin personalizada para la respuesta del servicio
Web.
Configuramos el mapeo de los parmetros de salida por medio del mapeo grfico, de manera que la
respuesta se almacene directamente en el modelo de datos de Bizagi como se ilustra:

Clic en Siguiente (next).


No definimos manejo especial para el error en este ejemplo, y por lo tanto, damos clic en Finalizar
(Finish ).
En este punto hemos configurado la invocacin a un servicio Web utilizando una transformacin
personalizada!

Manejo de Errores en Interfaces

Introduccin
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

Copyright 2014 - Bizagi

1798

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.
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 (Manejo de Errores) 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 Datos de Respuesta, consultamos la respuesta estructurada en XML del servicio Web
externo, ResponseBlackList, el cul se presenta como una tabla a la izquierda. El encabezado de la
tabla, BlackList915, referencia el nombre de los servicios Web externos.

Copyright 2014 - Bizagi

1799

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 Accin presenta las dos opciones: Mostrar un mensaje de error
o lanzar una transicin desde un evento BPMN.

Copyright 2014 - Bizagi

1800

La segunda opcin, Realizar Ajustes (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 Ajustes (como se muestra en la siguiente imagen).

Copyright 2014 - Bizagi

1801

Para este ejemplo, seleccionaremos la opcin Lanzar excepcin.

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, Datos de Respuesta, 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:
Cdigo de Error (ErrorCode): Cdigo del error que ocurri, de otra manera estar vaco.
Descripcin del Error (Error Description): Mensaje del error que ocurri, de otra manera estar vaco.
En nuestro ejemplo, el XPath se especificar como el nombre de la respuesta XML,ResponseBlackList,
seguido por el caracter slash (/) y por ltimo el nombre del elemento, ErrorCode, 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).

Copyright 2014 - Bizagi

1802

D clic en Agregar validacin de Error para validar la informacin retornada por el elemento
ErrorCode.
Cuando el valor del elemento ErrorCode difiere de "001", Bizagi debera mostrar el elemento
ErrorDescription contenido en esa misma estructura de respuesta (como ResponseBlackList/
ErrorDescription).

Copyright 2014 - Bizagi

1803

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 Lanzar Excepcin, 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.

Invocar desde actividades asncronas

Introduccin
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

Copyright 2014 - Bizagi

1804

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
administracin de Actividades Asncronas con un log correspondiente (para diagnosticar y revisar los
mensajes de error).

Copyright 2014 - Bizagi

1805

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 Propiedades.

Copyright 2014 - Bizagi

1806

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 2014 - Bizagi

1807

3. Habilite la propiedad Es Asncrona 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 se

Copyright 2014 - Bizagi

1808

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.

Integrar APIs o cdigo personalizado en Bizagi

Introduccin
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).

Copyright 2014 - Bizagi

1809

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 edicin .Net), los componentes en la Librera de Componentes

Copyright 2014 - Bizagi

1810

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.

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 .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 versiones Bizagi 10.x, el framework soportado de la aplicacin es .NET 4.0.

Ejemplo
Ilustraremos esto a travs de un Proceso de Solicitud de Crdito.

Copyright 2014 - Bizagi

1811

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 Negra.
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 2014 - Bizagi

1812

Observe que incluimos la referencia en nuestro componente.

Copyright 2014 - Bizagi

1813

Para la edicin Enteprise .Net construimos el proyecto de librera de clase como un montaje dll.

Copyright 2014 - Bizagi

1814

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 cargamos el
ensamblado MyCreditBureauComponent.dll y especificamos el nombre para el espacio del
componente.

Copyright 2014 - Bizagi

1815

Clic en Finalizar.
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 ensamblado
CreditBureau.dll.

Copyright 2014 - Bizagi

1816

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.

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.

Copyright 2014 - Bizagi

1817

Para hacerlo, vamos a la vista de Acciones de la Actividad desde nuestro Asistente de Procesos, y
seleccionamos la tarea de servicio Verificar Lista Negra. Incluimos una regla de negocio en este punto
del Proceso:

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.

Copyright 2014 - Bizagi

1818

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 Ejecutar Proceso:

Copyright 2014 - Bizagi

1819

Podemos ver que despus de la tarea de servicio Verificar Lista Negra, nuestra prxima Actividad ser
mostrar el resultado de la invocacin de los mtodos de nuestro componente:

Copyright 2014 - Bizagi

1820

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 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 versiones de Bizagi 10.x, 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 2014 - Bizagi

1821

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 Negra.
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.

Copyright 2014 - Bizagi

1822

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 2014 - Bizagi

1823

Ntese que el nombre de nuestro paquete es com.creditbcomponent, y observe que nuestra Clase es
pblica (denominada "Class1"). El mtodo que utilizaremos en este ejemplo se denomina
IsCustomerInBlackList.

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:


Nombre para mostrar (Display name): El nombre que se despliega para este componente en la
Librera.
Nombre (Name): El nombre nico del componente.
Descripcin: Una descripcin opcional.
Componente (archivo jar): El ensamblado del componente como tal.
Cargamos el archivo MyCreditBureauComponent.jar.

Copyright 2014 - Bizagi

1824

Package (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 Finalizar.
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 2014 - Bizagi

1825

Clic en Finalizar.

En este ejemplo no se requiere de informacin adicional principalmente porque nuestra API llamada
CreditBureau.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:

Copyright 2014 - Bizagi

1826

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 Negra. 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 2014 - Bizagi

1827

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")));

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 Ejecutar Proceso:

Copyright 2014 - Bizagi

1828

Podemos ver que despus de la tarea de servicio Verificar Lista Negra, nuestra prxima Actividad ser
mostrar el resultado de la invocacin de los mtodos de nuestro componente:

Copyright 2014 - Bizagi

1829

Si desea habilitar el modo debug para el ambiente de desarrollo, deber editar el archivo de
propiedades console-configuration.properties de la Consola administrativa JEE (el archivo se ubica
por defecto en C:\BizagiJEE\BizagiConsoleManagerJEE\config\console-configuration.properties).
Asegrese de incluir la siguiente linea:
jboss_debug=-Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=n
Tenga en cuenta:
1. Que el modo debug se habilita con la anterior linea en el puerto 8787 predefinido, el cual es
usado por defecto en la depuracin de errores por JBoss.
2. Que el servicio de JBoss lo inicia Bizagi como un proceso javax.exe cuyo comando refleja las
variables de entorno usadas por Bizagi:

Copyright 2014 - Bizagi

1830

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.

Copyright 2014 - Bizagi

1831

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 wsimport.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 nuestro componente adems de 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:/BizagiJEE/.
[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\system\layers\base\com

Copyright 2014 - Bizagi

1832

\bizagi\.
Esto significa, que el folder clibrary no deber existir antes de ejecutar los comandos.
Una vez que haya realizado la publicacin o usado el comando predeploy, deber editar el archivo
modules.xml que se encuentra en:
<JBOSS_HOME>\modules\system\layers\base\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="com.bizagi.clibrary">
<resources>
<resource-root path="[MI_COMPONENTE].jar"/>
<resource-root path="[REF_LIBRERIA1].jar"/>
<resource-root path="[REF_LIBRERIA2].jar"/>
</resources>
<dependencies>
<module name="[PACKAGE_REFERENCIADO_POR_LIBRERIAS_JEE]"/>
</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"/>

Copyright 2014 - Bizagi

1833

<resource-root path="commons-logging.jar"/>
<resource-root path="saaj.jar"/>
<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>
Nuestro componente se llama MiComponente.jar y dado que utiliza otras libreras, stas tambin se
incluyen en la definicin del mdulo:
Axis.jar
Jaxrpc.jar
Commons-discovery-0.2.jar
Commons-logging.jar
Saaj.jar
Wsdl4j.jar
Activation-1.1.jar
Log4j-1.2.17.jar

De manera similar, estas libreras de AXIS que referenciamos, tambin utilizan clases del package
javax.api del framework de JEE. Por este movio, esto se incluye bajo <dependencies>.
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

API de Bizagi para aplicaciones externas

Introduccin
Bizagi ofrece su funcionalidad para ser integrada directamente desde aplicaciones externas a travs de
un API orientada a servicios.
Tanto los procesos, como el modelo de datos de Bizagi, se encuentran disponibles para poder ser
utilizados a travs de servicios Web SOAP.
Estos servicios Web SOAP constituyen el API de Bizagi y no requieren de configuracin inicial para su
uso.
Dentro de estas opciones 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).

Copyright 2014 - Bizagi

1834

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.
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.

Copyright 2014 - Bizagi

1835

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 WorkflowEngineSOA.asmx?wsdl 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.
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.

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).

Copyright 2014 - Bizagi

1836

Mtodos para Manejar el Modelo de Datos (Entity Manager)


El Servicio Web EntityManagerSOA.asmx?wsdl 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.
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.

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 RenderSOA.asmx?wsdl 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.

URL de la Capa SOA y consideraciones

Introduccin
Cada proyecto en Bizagi posee servicios web SOAP construidos para exponer la funcionalidad de los

Copyright 2014 - Bizagi

1837

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
secciones.

Para Bizagi .NET


En los proyectos Bizagi que utilicen Microsoft IIS (Bizagi Entreprise .NET), 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:
http://localhost/CreditApplication/WebServices/EntityManagerSOA.asmx?wsdl

Para Bizagi JEE


En proyectos Bizagi que utilicen Bizagi 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:

Copyright 2014 - Bizagi

1838

http://localhost:8080/Bizagi-war/WebServices/EntityManagerSOA?wsdl

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 las ediciones Bizagi JEE y Bizagi.NET, lo mtodos de Capa SOA son aquellos que
poseen la terminacin "AsString" en su nombre (tales como createCasesAsString, getEntitiesAsString,
queryCasesAsString, performActivityAsString, saveEntityAsString, etc).
Adicionalmente, para Procesos Bizagi en plataformas .NET 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 <Entities> o <BizAgiWSResponse>, 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 CDATA 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 getActivitiesAsString:
<![CDATA[<BizAgiWSParam><domain>domain</domain><userName>admon</
userName><BizAgiWSParam>]]>
El siguiente ejemplo muestra el uso del elemento CDATA en una invocacin getEntities :
<BizAgiWSParam><EntityData><EntityName>Customer</EntityName><Filters><!
[CDATA[ Active=1 ]]></Filters>
</EntityData><BizAgiWSParam>

Copyright 2014 - Bizagi

1839

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.

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 ?wsdl.
Por ejemplo, si los Procesos Bizagi se ejecutan en una plataforma .NET, 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 ?wsdl:
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 la seguridad apropiada para invocar estos servicios Web (de manera que se acceda de
manera autorizada a estos servicios Web).
Por ejemplo, usted podr configurar una autenticacin HTTP a nivel del servidor BPM o incluir rangos
de direcciones IP vlidas para estos recursos.
Esto se hara en el IIS (para Bizagi .NET), o en el mismo servidor de Aplicacin JEE (para ediciones

Copyright 2014 - Bizagi

1840

Bizagi JEE ).

Esquemas del modelo de datos de Bizagi XML

Introduccin
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.
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 Esquemas XML.

Copyright 2014 - Bizagi

1841

2. En la ventana de esquemas XML de la entidad, d clic en el botn Generar para abir la ventana de
Seleccin de Datos del Esquema.

Copyright 2014 - Bizagi

1842

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.

Copyright 2014 - Bizagi

1843

4. Una vez finalizado, d clic en OK. 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 Editar ( o doble clic en el XSD).

Copyright 2014 - Bizagi

1844

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 Agregar.

Copyright 2014 - Bizagi

1845

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
Seleccionar Archivo).

Copyright 2014 - Bizagi

1846

3. Finalmente d clic en OK para guardar.


El archivo de transformacin asociado se mostrar:

Copyright 2014 - Bizagi

1847

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.

Servicios Web disponibles en 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 .NET
En proyectos que utilicen el IIS de Microsoft (Bizagi .NET), 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 JEE
En proyectos que utilicen Bizagi 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.

Copyright 2014 - Bizagi

1848

Ejemplo:
http://localhost:8080/Bizagi-war/WebServices/EntityManagerSOA?wsdl

Mtodos Web de WorkflowEngineSOA


Los mtodos Web publicados en WorkflowEngineSOA 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 .NET:
http://[nombre_servidor]/[proyecto_Bizagi]/WebServices/
WorkflowEngineSOA.asmx?wsdl

Copyright 2014 - Bizagi

1849

Copyright 2014 - Bizagi

1850

Para Bizagi 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.

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.

La descripcin en este artculo aplica tambin para el mtodo Web abortCases, el cual est
disponible en la edicin Bizagi .NET.
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>

Copyright 2014 - Bizagi

1851

<xs:element name="domain" type="xs:string"


minOccurs="0"/>
<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>

Copyright 2014 - Bizagi

1852

</case>
<case>
<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"/>

Copyright 2014 - Bizagi

1853

<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: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.

Copyright 2014 - Bizagi

1854

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).
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.

assignActivityAsString

Introduccin
Este mtodo se utiliza para reasignar las Actividades pendientes (Inbox) en Bizagi (desde una
aplicacin externa).

Copyright 2014 - Bizagi

1855

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.
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.

La descripcin en este artculo aplica tambin para el mtodo Web assignActivity, el cual est
disponible en la edicin Bizagi .NET.
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"/>

Copyright 2014 - Bizagi

1856

</xs:choice>
</xs:choice>
</xs:sequence>
</xs:complexType>
</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

Copyright 2014 - Bizagi

1857

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".
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 EvaluateRequest 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>

Copyright 2014 - Bizagi

1858

<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" />
<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

Copyright 2014 - Bizagi

1859

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
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" />

Copyright 2014 - Bizagi

1860

<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
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:

Copyright 2014 - Bizagi

1861

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.

La descripcin en este artculo aplica tambin para el mtodo Web createCases, el cual est
disponible en la edicin Bizagi .NET.
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>

Copyright 2014 - Bizagi

1862

<xs:element name="Case"
maxOccurs="unbounded">
<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 (Credit) .

Copyright 2014 - Bizagi

1863

Si desea ver un ejemplo completo con un caso de negocio para utilizar el mtodo
createCasesAsString, 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 attributeFormDefault="unqualified"
elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="processes">
<xs:complexType>

Copyright 2014 - Bizagi

1864

<xs:sequence>
<xs:element maxOccurs="unbounded" name="process">
<xs:complexType>
<xs:sequence>
<xs:element name="processId"
type="xs:integer" />
<xs:element minOccurs="0"
name="processRadNumber" type="xs:string" />
<xs:element minOccurs="0"
name="savedMessage">
<xs:complexType>
<xs:sequence>
<xs:element
name="Entities" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0"
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="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" />

Copyright 2014 - Bizagi

1865

<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 2014 - Bizagi

1866

<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>

Copyright 2014 - Bizagi

1867

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 2014 - Bizagi

1868

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 ProcessError.

Copyright 2014 - Bizagi

1869

Mtodos Web relacionados


Si desea completar y avanzar una Actividad especfica del Proceso (de las pendientes en el Inbox),
utilice los mtodos performActivityAsString o performActivity.
Para ms informacin, consulte performActivityAsString.

Copyright 2014 - Bizagi

1870

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.

La descripcin en este artculo aplica tambin para el mtodo Web getActivities, el cual est
disponible en la edicin Bizagi .NET.
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>

Copyright 2014 - Bizagi

1871

<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. 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).

Copyright 2014 - Bizagi

1872

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 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>

Copyright 2014 - Bizagi

1873

<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: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"

Copyright 2014 - Bizagi

1874

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"/>
<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"/>

Copyright 2014 - Bizagi

1875

<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, 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 2014 - Bizagi

1876

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.

Copyright 2014 - Bizagi

1877

Mtodos Web relacionados


Si desea obtener una lista de Eventos disponibles del Proceso, use el mtodo getEventsAsString o el
getEvents.
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 performActivityAsString o performActivity.

Copyright 2014 - Bizagi

1878

Para ms informacin sobre esta opcin, consulte performActivityAsString.

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"

Copyright 2014 - Bizagi

1879

xmlns: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 2014 - Bizagi

1880

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 getCategoriesAsString o
getCategories.
Para ms informacin sobre esta opcin, consulte getCategoriesAsString.

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.

La descripcin en este artculo aplica tambin para el mtodo Web getCases, el cual est disponible
en la edicin Bizagi .NET.
Para el mtodo getCases, el XML que se maneja en la solicitud (request) y en la respuesta (response)
son del tipo XmlDocument (nativa de .NET).
Para el mtodo getCasesAsString 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"?>

Copyright 2014 - Bizagi

1881

<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: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.

Copyright 2014 - Bizagi

1882

userName: Busca los casos cuyo usuario asignado sea el usuario que se indica en este elemento.
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"/>

Copyright 2014 - Bizagi

1883

<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="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

Copyright 2014 - Bizagi

1884

name="errorCode"/>
<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"/>

Copyright 2014 - Bizagi

1885

<xs:element name="taskCost" type="xs:unsignedByte"/


>
<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>

Copyright 2014 - Bizagi

1886

</xs:sequence>
</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.

Copyright 2014 - Bizagi

1887

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 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 2014 - Bizagi

1888

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 getCaseDataUsingSchemaAsString o
getCaseDataUsingXPathsAsString).
Para ms informacin sobre esta opcin, consulte EntityManagerSOA.

Copyright 2014 - Bizagi

1889

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.

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:

La descripcin en este artculo aplica tambin para el mtodo Web getCategories, el cual est
disponible en la edicin Bizagi .NET.
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

Copyright 2014 - Bizagi

1890

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="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">

Copyright 2014 - Bizagi

1891

<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.

Copyright 2014 - Bizagi

1892

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

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 getCategoriesAsString, 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:

Copyright 2014 - Bizagi

1893

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"

Copyright 2014 - Bizagi

1894

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>
<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 2014 - Bizagi

1895

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 getWorkflowClassesAsString o getWorkflowClasses.
Para ms informacin sobre esta opcin, consulte getWorkflowClassesAsString.
Tambin es factible que desee utilizar el mtodo getApplications 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 getCategories o
getCategoriesAsString. 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.

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.

La descripcin en este artculo aplica tambin para el mtodo Web getClosedActivities, el cual est
disponible en la edicin Bizagi .NET.
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).

Copyright 2014 - Bizagi

1896

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="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

Copyright 2014 - Bizagi

1897

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>
<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

Copyright 2014 - Bizagi

1898

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: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"/>

Copyright 2014 - Bizagi

1899

<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" 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.

Copyright 2014 - Bizagi

1900

workItemState: Estado en el que se encuentra la actividad.


workItemEntryDate: Fecha y hora cuando se ingresa por primera vez a la actividad.
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.

Copyright 2014 - Bizagi

1901

workflowClassHelpURL: URL de ayuda del proceso.


workflowClassDisplayOrder: Orden en el cual aparecer 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 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 2014 - Bizagi

1902

Mtodos Web relacionados


Para obtener un listado de Actividades abiertas, use los mtodos getActivitiesAsString o getActivities.
Para ms informacin sobre esta opcin, consulte getActivitiesAsString.

getEventsAsString

Introduccin
Este mtodo se se utiliza para obtener un listado de los Eventos disponibles en Bizagi (desde una

Copyright 2014 - Bizagi

1903

aplicacin externa).
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.

La descripcin en este artculo aplica tambin para el mtodo Web getEvents, el cual est
disponible en la edicin Bizagi .NET.
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

Copyright 2014 - Bizagi

1904

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
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"

Copyright 2014 - Bizagi

1905

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"/>
<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.

Copyright 2014 - Bizagi

1906

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.
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.

Copyright 2014 - Bizagi

1907

Mtodos Web relacionados


Para obtener un listado de Actividades pendientes de un caso en particular, use los mtodos
getActivitiesAsString o getActivities.
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 setEventAsString o setEvent.
Para ms informacin sobre esta opcin, consulte setEventAsString.

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 2014 - Bizagi

1908

Ntese que para la categora Travel (Viajes), encontramos 2 Procesos: Solicitud de viajes (Travel
Request) y Reporte de gastos (Expenses report).

La descripcin en este artculo aplica tambin para el mtodo Web getWorkflowClasses, el cual est
disponible en la edicin Bizagi .NET.
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>

Copyright 2014 - Bizagi

1909

<xs:sequence>
<xs:element name="category" type="xs:string"/>
</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"/>

Copyright 2014 - Bizagi

1910

<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>
</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;

Copyright 2014 - Bizagi

1911

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 getCategoriesAsString o getCategories 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
getWorkflowClassesFromCategoryName. 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.

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 2014 - Bizagi

1912

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 getWorkflowClassesAsString, 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).

Copyright 2014 - Bizagi

1913

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 2014 - Bizagi

1914

</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;

Copyright 2014 - Bizagi

1915

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 getCategoriesAsString o getCategories 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
getWorkflowClassesAsString o getWorkflowClasses. 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.

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 2014 - Bizagi

1916

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.

La descripcin en este artculo aplica tambin para el mtodo Web performActivity, el cual est
disponible en la edicin Bizagi .NET.
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>

Copyright 2014 - Bizagi

1917

</xs:element>
<xs:element name="Entities">
<xs:complexType/>
</xs:element>
</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 2014 - Bizagi

1918

Si desea ver un ejemplo completo con un caso de negocio para utilizar el mtodo
performActivityAsString, 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

Copyright 2014 - Bizagi

1919

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>
<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>

Copyright 2014 - Bizagi

1920

</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"/>
<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>

Copyright 2014 - Bizagi

1921

</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.
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.

Copyright 2014 - Bizagi

1922

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
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi:

Copyright 2014 - Bizagi

1923

Mtodos Web relacionados


Para obtener un listado de Actividades pendientes de un caso en particular, use los mtodos
getActivitiesAsString o getActivities.
Para ms informacin sobre esta opcin, consulte getActivityAsString.

Copyright 2014 - Bizagi

1924

If you wish to trigger a business Event instead (set the occurrence of a BPMN Intermediate Event), use
the setEventAsString or setEvent 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 saveActivityAsString or saveActivity
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
createCasesAsString o createCases.
Para ms informacin sobre esta opcin, consulte createCasesAsString.

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 Siguiente), como sucede con
el mtodo performActivityAsString. A su vez, este mtodo funciona al igual que cuando se da clic en
Guardar 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.

La descripcin en este artculo aplica tambin para el mtodo Web saveEntity, el cual est
disponible en la edicin Bizagi .NET.
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">

Copyright 2014 - Bizagi

1925

<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: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.

Copyright 2014 - Bizagi

1926

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>
<xs:element

Copyright 2014 - Bizagi

1927

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"/>
<xs:element name="ErrorMessage" type="xs:string"/>

Copyright 2014 - Bizagi

1928

</
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"/>
<xs:element name="taskCost" type="xs:integer"/>

Copyright 2014 - Bizagi

1929

<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.
processSolutionDate: Fecha de solucin (cierre) del caso.

Copyright 2014 - Bizagi

1930

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.
taskTransactional: Indica si la tarea es transaccional o no.

Copyright 2014 - Bizagi

1931

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;

Copyright 2014 - Bizagi

1932

Mtodos Web relacionados


Para obtener un listado de Actividades pendientes para un caso determindao, use los mtodos
getActivitiesAsString o getActivities.
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 2014 - Bizagi

1933

temporalmente un progreso), use los mtodos performActivityAsString o performActivity.


Para ms informacin sobre esta opcin, consulte performActivityAsString.

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.

La descripcin en este artculo aplica tambin para el mtodo Web setEvent, el cual est disponible
en la edicin Bizagi .NET.
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>

Copyright 2014 - Bizagi

1934

<xs:sequence>
<xs:element
name="EventData">
<xs: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.

Copyright 2014 - Bizagi

1935

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.
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).

Copyright 2014 - Bizagi

1936

Ntese que la informacin de negocio est contenida dentro del elemento Entities, dado que esta
informacin es opcional.

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"/>

Copyright 2014 - Bizagi

1937

<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"/>
<xs:element name="ErrorMessage" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</
xs:sequence>
</
xs:complexType>
</xs:element>

Copyright 2014 - Bizagi

1938

</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"/>
<xs:element name="taskCost" type="xs:integer"/>

Copyright 2014 - Bizagi

1939

<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>

Copyright 2014 - Bizagi

1940

</xs:sequence>
</xs:complexType>
</xs:element>
</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.

Copyright 2014 - Bizagi

1941

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.
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;

Copyright 2014 - Bizagi

1942

Copyright 2014 - Bizagi

1943

Mtodos Web relacionados


Si desea ejecutar una Actividad pendiente en cambio de un Evento, use los mtodos
performActivityAsString o performActivity.
Para ms informacin sobre esta opcin, consulte performActivityAsString.
Para obtener un listado de los Eventos disponibles para un caso determinado, use los mtodos
getEventsAsString o getEvents.
Para ms informacin sobre esta opcin, consulte getEventsString.

Mtodos Web de EntityManagerSOA


Los mtodos Web publicados en EntityManagerSOA 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 .NET:
http://[nombre_servidor]/[proyecto_Bizagi]/WebServices/
EntityManagerSOA.asmx?wsdl

Copyright 2014 - Bizagi

1944

Para Bizagi 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.

getCaseDataUsingSchemaAsString

Introduccin
Este mtodo se utiliza para obtener tanto informacin de negocio, como detalle general (por ejemplo,

Copyright 2014 - Bizagi

1945

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).

La descripcin en este artculo aplica tambin para el mtodo Web getCaseDataUsingSchema, el


cual est disponible en la edicin Bizagi .NET.
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).

La siguiente definicin aplica tambin para los mtodos getCaseDataUsingSchemaLiteAsString o


getCaseDataUsingSchemaLite.
La nica diferencia con respecto a estos mtodos, se basa en cmo Bizagi retorna la informacin de
los adjuntos.
Con getCaseDataUsingSchemaAsString, Bizagi retorna los adjuntos de Bizagi como cadenas
(string) en base 64 (si se incluyen estos atributos en el esquema).
Con getCaseDataUsingSchemaLiteAsString, 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

Copyright 2014 - Bizagi

1946

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.
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 getCasesAsString 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 getCaseDataUsingXPathsAsString o getCaseDataUsingXPaths.
Para ms informacin sobre esta opcin, consulte getCaseDataUsingXPathsAsString.

getCaseDataUsingXPathsAsString

Introduccin
Este mtodo se utiliza para obtener tanto informacin de negocio, como detalle general (por ejemplo,

Copyright 2014 - Bizagi

1947

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.

La descripcin en este artculo aplica tambin para el mtodo Web getCaseDataUsingXPath, el cual
est disponible en la edicin Bizagi .NET.
Para el mtodo getCaseDataUsingXPath, el XML que se maneja en la solicitud (request) y en la
respuesta (response) son del tipo XmlDocument (nativa de .NET).
Para el mtodo getCaseDataUsingXPathAsString 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>

Copyright 2014 - Bizagi

1948

<xs:attribute
name="XPath" type="xs:string" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</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 2014 - Bizagi

1949

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.

Copyright 2014 - Bizagi

1950

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

Formato XML

<

Operador menor-que

&lt;

>

Operador mayor-que

&gt;

"

Comilla doble

&quot;

'

Apstrofe, o comilla simple

&apos;

&

Ampersand

&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 2014 - Bizagi

1951

<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>

Copyright 2014 - Bizagi

1952

</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 getCasesAsString 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 getCaseDataUsingSchemaAsString o getCaseDataUsingSchema.
Para ms informacin sobre esta opcin, consulte getCaseDataUsingSchemaAsString.

getEntitiesAsString

Introduccin
Este mtodo se utiliza para consultar los registros en una Entidad del modelo de datos de Bizagi

Copyright 2014 - Bizagi

1953

(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 getEntitiesUsingSchemaAsString o getEntitiesUsingSchema.
Para ms informacin sobre ste y otros mtodos relacionados, consulte la seccin al final de este
artculo.

La descripcin en este artculo aplica tambin para el mtodo Web getEntities, el cual est
disponible en la edicin Bizagi .NET.
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>

Copyright 2014 - Bizagi

1954

</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: 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"?>

Copyright 2014 - Bizagi

1955

<BizAgiWSParam>
<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 AND:
<![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

Copyright 2014 - Bizagi

1956

Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi;

Ntese que los atributos que contienen valores nulos (NULL) 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 getEntitiesUsingSchemaAsString o
getEntitiesUsingSchema.
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.

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.

Copyright 2014 - Bizagi

1957

Si no desea utilizar un XSD, y no es necesario una profundidad de datos (navegando la informacin a


travs de atributos), use los mtodos getEntitiesAsString o getEntities.
Para ms informacin sobre ste y otros mtodos relacionados, consulte la seccin al final de este
artculo.

La descripcin en este artculo aplica tambin para el mtodo Web getEntitiesUsingSchema, el cual
est disponible en la edicin Bizagi .NET.
Para el mtodo getEntitiesUsingSchema, el XML que se maneja en la solicitud (request) y en la
respuesta (response) son del tipo XmlDocument (nativa de .NET).
Para el mtodo getEntitiesUsingSchemaAsString 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.

Copyright 2014 - Bizagi

1958

Parmetros de entrada
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>

Copyright 2014 - Bizagi

1959

</EntityData>
</BizAgiWSParam>
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 AND:
<![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.

Copyright 2014 - Bizagi

1960

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, en
donde;

Ntese que a diferencia del mtodo getEntitiesAsString, los atributos que contienen valores nulos
(NULL) 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 getEntitiesAsString o getEntities.
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
getEntitySchemaStr o getEntitySchema.
Para ms informacin sobre esta opcin, consulte getEntitySchemaStr.

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.

Copyright 2014 - Bizagi

1961

Este mtodo es til para posteriormente invocar otros mtodos como


getCaseDataUsingSchemaAsString o getEntitiesUsingSchemaAsString, donde se envia un esquema
como dato de entrada.
Para ms informacin sobre estos mtodos, consulte la seccin al final de este artculo.

La descripcin en este artculo aplica tambin para el mtodo Web getEntitySchema, el cual est
disponible en la edicin Bizagi .NET.
Para el mtodo getEntitySchema, el XML que se maneja en la solicitud (request) y en la respuesta
(response) son del tipo XmlDocument (nativa de .NET).
Para el mtodo getEntitySchemaStr 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:

Copyright 2014 - Bizagi

1962

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.

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 2014 - Bizagi

1963

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.

La descripcin en este artculo aplica tambin para el mtodo Web saveEntity, el cual est
disponible en la edicin Bizagi .NET.
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"?>
<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

Copyright 2014 - Bizagi

1964

presentan dos ejemplos, en el primero de ellos se actualiza informacin en entidades paramtricas y


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 (Country).
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 businessKey, 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 2014 - Bizagi

1965

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).

Es posible utilizar tambin el atributo businessKey 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=" DocumentNumber='123456' and DocumentType='Passport' ".

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 Bogot 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 dsbl seguido del nombre de la Entidad.
Por ejemplo, el atributo de la primera imagen que nos muestra dsblCity, 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).

Copyright 2014 - Bizagi

1966

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 idCase (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 2014 - Bizagi

1967

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 performActivityAsString o setEventAsString.
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
getEntitySchemaStr o getEntitySchema.
Para ms informacin sobre esta opcin, consulte getEntitySchemaStr.

Mtodos Web de QuerySOA


Los mtodos Web publicados en QuerySOA 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 .NET:
http://[nombre_servidor]/[proyecto_Bizagi]/WebServices/QuerySOA.asmx?wsdl

Copyright 2014 - Bizagi

1968

Para Bizagi 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.

Copyright 2014 - Bizagi

1969

QueryCasesAsString

Introduccin
Este mtodo se utiliza para obtener detalle de los casos de Procesos tanto con informacin de
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:

La descripcin en este artculo aplica tambin para el mtodo Web queryCases, el cual est
disponible en la edicin Bizagi .NET.
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).

Copyright 2014 - Bizagi

1970

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
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:

Copyright 2014 - Bizagi

1971

o 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.
o RadNumber: Permite filtrar para obtener un caso especfico.
o CreationDate: Permite filtrar de acuerdo a la fecha de creacin del caso.
o ExpiryDate: Permite filtrar de acuerdo a la fecha de vencimiento del caso.
o ExpiryDays: Permite filtrar de acuerdo al nmero de das que quedan para el vencimiento del caso.
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:

Copyright 2014 - Bizagi

1972

Estn en un estatus pendiente (Running).


Tengan una fecha de creacin (atributo OpeningDate) que sea posterior a Noviembre 1 de 2011.

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 (businessKey).
<?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.

Copyright 2014 - Bizagi

1973

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD:

Copyright 2014 - Bizagi

1974

Copyright 2014 - Bizagi

1975

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 2014 - Bizagi

1976

Mtodos Web relacionados


Si no requiere obtener informacin de negocio de los casos consultados, use los mtodos
getCasesAsString o getCases 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
getCaseDataUsingSchemaAsString o getCaseDataUsingXPathsAsString 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.

Copyright 2014 - Bizagi

1977

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 queryEntities, el cual est
disponible en la edicin Bizagi .NET.
Para el mtodo queryEntities, el XML que se maneja en la solicitud (request) y en la respuesta
(response) son del tipo XmlDocument (nativa de .NET).
Para el mtodo queryEntitiesAsString la misma estructura de XMLs se maneja, sin embargo este
parmetro es de tipo cadena (string).

Copyright 2014 - Bizagi

1978

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

Copyright 2014 - Bizagi

1979

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 2014 - Bizagi

1980

Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD:

Copyright 2014 - Bizagi

1981

Copyright 2014 - Bizagi

1982

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:

Copyright 2014 - Bizagi

1983

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 getEntitiesAsString o getEntities 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 2014 - Bizagi

1984

Mtodos Web de RenderSOA


Los mtodos Web publicados en RenderSOA 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 .NET:
http://[nombre_servidor]/[proyecto_Bizagi]/WebServices/RenderSOA.asmx?wsdl

Para Bizagi JEE:


En Servidores de Aplicaciones Weblogic y JBoss:
http://[nombre_servidor]:[puerto]/Bizagi-war/WebServices/RenderSOA?wsdl
En WebSphere:

Copyright 2014 - Bizagi

1985

http://[nombre_servidor]:[puerto]/Bizagi-war/RenderSOAImplService/
RenderSOAImplService.wsdl

Para informacin puntual sobre cada mtodo, consulte los sub artculos.

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 getActivityFormXML, el cual
est disponible en la edicin Bizagi .NET.
Para el mtodo getActivityFormXML, el XML que se maneja en la solicitud (request) y en la respuesta
(response) son del tipo XmlDocument (nativa de .NET).
Para el mtodo getActivityForm 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 2014 - Bizagi

1986

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.
Form: Contiene la informacin de la forma.
Tab: Indica que hay una pestaa en la forma.

Copyright 2014 - Bizagi

1987

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.
DisplayName: Nombre a mostrar de la tarea.
Description: Texto corto con alguna descripcin de la tarea.
Process: Datos del proceso.

Copyright 2014 - Bizagi

1988

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
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.

Copyright 2014 - Bizagi

1989

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 2014 - Bizagi

1990

Mtodos Web relacionados


Es posible que previamente se desee obtener la lista de Actividades disponibles a travs de los
mtodos getActivitiesAsString o getActivities, 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 GetFormById para presentar estas otras formas.
Para ms informacin sobre esta opcin, consulte getFormById.

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
GetActivityForm 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
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 getFormByIdXML, el cual est
disponible en la edicin Bizagi .NET.
Para el mtodo getFormByIdXML, el XML que se maneja en la solicitud (request) y en la respuesta
(response) son del tipo XmlDocument (nativa de .NET).
Para el mtodo getFormById 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 2014 - Bizagi

1991

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.

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.

Copyright 2014 - Bizagi

1992

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 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

Copyright 2014 - Bizagi

1993

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
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

Copyright 2014 - Bizagi

1994

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.
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 2014 - Bizagi

1995

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 2014 - Bizagi

1996

Nota: La descripcin en este artculo aplica tambin para el mtodo Web getQueryFormsXML, el cual
est disponible en la edicin Bizagi .NET.
Para el mtodo getQueryFormsXML, el XML que se maneja en la solicitud (request) y en la respuesta
(response) son del tipo XmlDocument (nativa de .NET).
Para el mtodo getQueryForms 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

Copyright 2014 - Bizagi

1997

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 buttons
Si/No.

Copyright 2014 - Bizagi

1998

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
debera mostrarse o no como requerido. Este se puede encontrar en todos los elementos de tipo

Copyright 2014 - Bizagi

1999

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.
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.

Copyright 2014 - Bizagi

2000

Ejemplo
Para ver un ejemplo de respuesta, consulte el XML en este enlace.

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.

La descripcin en este artculo aplica tambin para el mtodo Web getSummaryFormsXML, el cual
est disponible en la edicin Bizagi .NET.
Para el mtodo getSummaryFormsXML, el XML que se maneja en la solicitud (request) y en la
respuesta (response) son del tipo XmlDocument (nativa de .NET).
Para el mtodo getSummaryForms 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.
userName: Nombre del usuario Bizagi.

Copyright 2014 - Bizagi

2001

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).
YesNo: Este tipo de campo es usado para Atributos Booleanos y consiste en un par de radio buttons
Si/No.

Copyright 2014 - Bizagi

2002

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
debera mostrarse o no como requerido. Este se puede encontrar en todos los elementos de tipo

Copyright 2014 - Bizagi

2003

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.
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.

Copyright 2014 - Bizagi

2004

Ejemplo
Para ver un ejemplo de respuesta, consulte el XML en este enlace.

Usando llaves de negocio en XMLs

Introduccin
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 2014 - Bizagi

2005

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 TypeOfID relaciona al cliente con IdentificationType, de manera qe se
entiende que en la entidad IdentificationType 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 IdNumber , se utilizara el siguiente XML:

Copyright 2014 - Bizagi

2006

La llave de negocio y su valor debe ser especificado en el atributo businessKey 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.

Cargar un archivo o imagen utilizando capa SOA


A menudo, es necesario enviar archivos o imgenes 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 o imgenes 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 codificada en base-64, como el valor en el interior del
elemento del archivo.
El siguiente ejemplo de un XML enviado a Bizagi ilustra la idea:

El siguiente ejemplo de un XML enviado a Bizagi ilustra la idea:


En este caso, la entidad llamada Incident, se relaciona con la entidad de aplicacin con una relacin de

Copyright 2014 - Bizagi

2007

atributo llamada Incidente.


La entidad Incident tiene un atributo de tipo archivo llamado MyFile. Por lo tanto, para el atributo
MyFile, 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.

El manejo de atributos tipo archivos o atributos tipo imgenes es similar en Bizagi. La diferencia en
su notacin y manejo estructural en las integraciones, est en que un atributo tipo imagen alberga
como mximo una imagen, mientras que un atributo tipo archivo puede contener uno o ms
archivos.

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
if(openFileDialog1.ShowDialog() ==
System.Windows.Forms.DialogResult.OK)
{
//Obtenga el nombre del archivo
string file_name =
openFileDialog1.FileName.Substring(openFileDialog1.FileName.LastIndexOf("\
\") + 1);

Copyright 2014 - Bizagi

2008

//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();
}
}

Copyright 2014 - Bizagi

2009

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

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

Copyright 2014 - Bizagi

2010

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.

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: reglas de
asignacin, mtodo de asignacin y las precondiciones.

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 Adicionar condicin.

Copyright 2014 - Bizagi

2011

Las reglas de asignacin son construidas por operandos y operadores como se muestra en la
siguiente imagen:

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.

Copyright 2014 - Bizagi

2012

Operador de Comparacin
El Operador de Comparacin permite comparar la propiedad de usuario con un valor especfico.
Puede seleccionar entre Igual a o Diferente 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.
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.

Copyright 2014 - Bizagi

2013

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.
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.

Cuando el mtodo de asignacin retorna a ms de un candidato para asignacin, Bizagi evala si


alguno de estos usuarios ha trabajado previamente en el caso. De ser as, el usuario que cumpla las
condiciones y haya trabajado en el caso ser asignado.

Mtodo de Asignacin en Eventos


El evento no tiene un mtodo de Asignacin. El mtodo ser, por defecto, a Todos.

Copyright 2014 - Bizagi

2014

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 precondiciones. 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.

Copyright 2014 - Bizagi

2015

Las precondiciones son definidas por las expresiones que se configuran haciendo clic en la opcin
Seleccionar expresin. Puede definir expresiones booleanas o de scripting de acuerdo a sus
necesidades.

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:

Vamos a establecer las siguientes configuraciones:


Asigne la el Registro de solicitud a la persona que cre el caso.

Copyright 2014 - Bizagi

2016

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 Definir Participantes.

2. Seleccione la actividad deseada para definir sus participantes.

3. Una vez que la actividad se ha seleccionado, la ventana de asignacin se abrir.

Copyright 2014 - Bizagi

2017

Haga clic en Agregar condicin 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 Usuario de la


lista de propiedades del usuario.

La propiedad del usuario se comparar con una expresin que establece el ID de creador caso.
Seleccione Es igual en el campo del comparador y de Expresin como Valor.

Copyright 2014 - Bizagi

2018

Haga clic en seleccionar Expresin. El editor de expresiones se abrir, aqu se puede crear una regla
de negocio.

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 Creator y haga clic en Aceptar.

Copyright 2014 - Bizagi

2019

4. Para la Aprobacin de la solicitd repita el mismo procedimiento estipulado anteriormente pero en


este caso, seleccione la regla CurrentAssigneeBoss.

Las reglas CurrentAssigneBoss 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 Cargo de la lista de propiedades de usuario.

Copyright 2014 - Bizagi

2020

Seleccione Es igual en el campo de comparador y Valor de la Entidad en el campo de Valor.


Aqu el valor de la entidad es una posicin dentro de la organizacin. Seleccione Asistente
Administrativa 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 Nuevo. 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 2014 - Bizagi

2021

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 Por carga. Esto significa que la
actividad se le asignar el auxiliar administrativo con la menor carga de trabajo. Por ltimo, haga clic
en Aceptar.

Las actividades han sido configuradas. Tenga en cuenta que ninguna tiene el signo de exclamacin.

Copyright 2014 - Bizagi

2022

Asignaciones usando expresiones


Las Expresiones en las reglas de asignacin suelen ser necesarias cuando se debe evaluar condiciones
complejas y seleccionar usuarios que cumplan con las condiciones que se encuentran en dicha
expresin.
Para usar expresiones en una asignacin, se debe seleccionar la propiedad de User Id y la opcin de
Expresin.
La expresin creada debe devolver un arreglo de identificadores de los usuarios que cumplan con las
condiciones necesarias. La asignacin se evaluar sobre los ids de los usuarios retornados.

Ejemplo
En un proceso de contracacin de personal un solicitante ingresa la informacin de un nuevo cargo,
incluyendo descripcin del trabajo, salario, etc.
Las siguientes actividades que incluyen la creacin de requisitos y recoger documentos pueden ser
realizados por cualquier usuario cuyo jefe es el solicitante del proceso.
Por lo tanto tenemos que utilizar una expresin que encuentre todos los usuarios que comparten el
solicitante como jefe.
Supongamos que en la primera actividad se guarda el id del Solicitante en un atributo:
<Onboarding.Requester>
1 . En la definicin de ejecutantes, en el quinto paso del Asistente de Proceso, haga clic en la actividad
a definir.
2 . Seleccione User Id como la propiedad de la asignacin y seleccione Expresin como condicin.
Haga clic en Seleccionar Expresin.

3. Marque la opcin Basado en el resultado de una expresin.

Copyright 2014 - Bizagi

2023

4. Seleccione la opcin Nuevo.

5. Cree la siguiente expresin.

Copyright 2014 - Bizagi

2024

// Cree un arreglo
var Users = new ArrayList();
// Guarde en una variable el solicitante
var Requester = <Onboarding.Requester.Id>;
// Obtenga todos los usuarios cuyo jefe sea el solicitante
var SearchUsers =
CEntityManager.GetEntity("WFUser").GetEntityList("","","idBossUser = "+
Requester,"");
// Cuente los usuarios que cumplen con la condicin
var HowManyUsers = SearchUsers.Length;
if(HowManyUsers > 0)
{
// Agregue cada usuario al arreglo
for (var i=0; i < HowManyUsers; i++)
{
var idUser = SearchUsers[i].SurrogateKeyValue;
Users.Add(idUser);
}
}
Users;
6. De un nombre a la expresin.
Debe tener un aspecto como este.

Copyright 2014 - Bizagi

2025

Asignaciones de tareas utilizando pre condiciones


Usaremos el proceso de Mesa de Ayuda para demostrar cmo utilizar precondiciones para asignar
participantes al proceso.
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 Assist Report se asigna con base a estos atributos.

Dependiendo de la prioridad, la tarea Assist Report ser realizada por un miembro de un grupo

Copyright 2014 - Bizagi

2026

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 Definir Participantes.

2. Seleccione la actividad deseada para definir sus participantes. En este caso, seleccione Assist Report.

Copyright 2014 - Bizagi

2027

3. Una vez ha seleccionado la actividad, la ventana de participantes se desplegar. Marque la casilla


Usar precondiciones con el fin de activar el botn Adicionar Precondicin.

4. Haga clic en el enlace Seleccionar Expresin. El Administrador de Expresiones se abrir.

Copyright 2014 - Bizagi

2028

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.

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.

Copyright 2014 - Bizagi

2029

Por ltimo, seleccione el operador OR para que, si cualquiera de las dos condiciones se cumple, la
regla booleana retornar verdadero..

6. Haga clic en Finalizar. Ingrese un nombre para la expresin, en este caso ser Prioridad Media y
Baja.

7. Defina la regla de asignacin. Podemos identificar a qu grupo pertenece un usuario de apoyo a


travs de una funcin. Haga clic en Agregar condicin. Una nueva ventana aparecer.

Copyright 2014 - Bizagi

2030

La asignacin de esta tarea se basa en el rol del participante. Seleccione Rol de la lista de propiedades
de usuario.

Seleccione Es igual en el campo de comparacin y Valor de Entidad en el campo Valor.


Aqu el valor de la entidad es un Rol dentro de la organizacin. Seleccione Miembro Nivel 1 de la lista
del campo Valor.

Copyright 2014 - Bizagi

2031

Si el Rol no se ha creado, puede crearlo haciendo clic en el enlace Nuevo. 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 Por Carga 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.

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 Aadir precondicin. Una nueva pestaa, se crear.

Copyright 2014 - Bizagi

2032

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 Alta prioridad.

11. La regla de asignacin para esta condicin es similar a la anterior. La nica diferencia es que ahora
seleccionamos el Miembro Nivel 2 como Rol.

Copyright 2014 - Bizagi

2033

12. Por ltimo, seleccione Por Carga de la lista Mtodo de Asignacin. Note cmo las precondiciones
estn creadas, son mutuamente excluyentes y tienen sus reglas de asignacin..

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.

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:

Copyright 2014 - Bizagi

2034

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 Assignation User, en el m+odulo de Organizacin de Bizagi
Studio.
Si no hay usuarios en el grupo Assignation 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


En el Portal de Trabajo haga clic en Admin. A continuacin, seleccione Administrar asignacin de
usuario predeterminado.

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 Todas las Aplicaciones para
seleccionar un usuario por defecto para todas las aplicaciones creadas.

Copyright 2014 - Bizagi

2035

2. Para seleccionar un usuario para una Aplicacin en particular, haga clic en Seleccionar aplicacin (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 2014 - Bizagi

2036

4. Cuando la aplicacin o proceso est seleccionado, haga clic en el botn Nuevo Usuario, y busque el
usuario que se establecer como el usuario predeterminado.
Haga clic en Guardar cuando haya terminado.

Copyright 2014 - Bizagi

2037

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 Organizacin. A
continuacin, seleccione los Grupos de usuarios.

2. Haga clic derecho sobre Grupo de Asignacin por defecto y seleccione Propiedades. Este grupo se
crea de forma predeterminada.
Haga clic aqu para obtener informacin sobre cmo crear grupos de usuarios.

Copyright 2014 - Bizagi

2038

3. La posicin del Administrador est seleccionada por defecto en este grupo. Haga clic en el botn
Agregar o Quitar para modificar los usuarios incluidos.

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.

Copyright 2014 - Bizagi

2039

5. Seleccione la opcin de Negocios de la pestaa de Configuracin.

6. Seleccione la seccin Avanzado y luego asignar al Grupo de Usuarios por defecto, el grupo creado.
Puede asignar este grupo o cualquier grupo creado previamente.

Copyright 2014 - Bizagi

2040

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
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).

Copyright 2014 - Bizagi

2041

En la tercera pestaa, habilite la opcin: Omitir reglas de asignacin en los casos creados por este
usuario. Por ltimo, haga clic en Actualizar.

Reasignar trabajo

Introduccin
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

Copyright 2014 - Bizagi

2042

autoridad diferentes a las de l.


Estas condiciones de negocio se conocen como reasignacin (asignacin a otra persona con nivel de
autoridad igual o inferior) y escalamiento (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 Reasignacin 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.

Una vez damos clic sobre l, se abrir una nueva ventana que permitir buscar al usuario a asignar,
entre todos los usuarios de Bizagi.

Copyright 2014 - Bizagi

2043

Habilitar una tarea para reasignacin


Para activar la posibilidad de reasignacin para una tarea todo lo debe hacer es habilitar la
propiedad Reasignar 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 Editar
Proceso.

Copyright 2014 - Bizagi

2044

2. D clic derecho sobre la actividad a la cual se habilitar la reasignacin y seleccione la opcin


Propiedades.

Copyright 2014 - Bizagi

2045

3. En las propiedades bsicas, busque y active la propiedad Reasignar.

Copyright 2014 - Bizagi

2046

4. Cierre el diagrama para guardar los cambios.

Reasignar una tarea


Una vez habilitada la propiedad Reasignar, 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 2014 - Bizagi

2047

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 Reasignar que se encuentra a la izquierda del nombre del
usuario.

Copyright 2014 - Bizagi

2048

4. Se mostrar un mensaje de confirmacin.

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 2014 - Bizagi

2049

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.

Copyright 2014 - Bizagi

2050

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 Organizaciones y Configuracin de Usuario del Men de Usuarios.

Copyright 2014 - Bizagi

2051

Para mayor informacin acerca de cmo crear usuarios en Bizagi y cmo asignar componentes de
organizacin a usaurios, consulte Administracin de Usuarios.

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 Organizaciones en la vista de Mdulos.

Copyright 2014 - Bizagi

2052

2. D clic derecho en reas y seleccione la opcin Nueva rea

Copyright 2014 - Bizagi

2053

3. Se abrir una nueva ventana. Ingrese el nombre, nombre de mostrar y descripcin de la nueva rea.
En esta caso escribimos Departamento de Ventas.
D clic en OK.

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 Organizaciones en la vista de Mdulos y d clic en Organizacin.

Copyright 2014 - Bizagi

2054

2. D clic derecho en Cargos y seleccione la opcin Nuevo Cargo.

Copyright 2014 - Bizagi

2055

3. Se abrir una nueva ventana. Escriba el nombre, nombre de mostrar, descripcion y costo del nuevo
cargo. En este ejemplo escribimos Gerente de Ventas.
D clic en OK.

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 Nuevo Cargo.

Copyright 2014 - Bizagi

2056

Crearemos una dependencia para el Gerente de Ventas: El Agente de Ventas.


D clic derecho en el cargo Gerente de Ventas y seleccione la opcin Nuevo Cargo.

5.Escriba el nombre, nombre de mostrar, descripcin y costo del nuevo cargo. En este ejemplo
escribimos Agente de Ventas.
D clic en OK.

Copyright 2014 - Bizagi

2057

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 Organizaciones en la vista de Mdulos y d clic en Organizacin.

Copyright 2014 - Bizagi

2058

2. D clic en Lugares y seleccione la opcin Nuevo Lugar.

Copyright 2014 - Bizagi

2059

3. Se abrir una nueva ventana. Llene los campos requeridos. El nombre del lugar ser Nueva York.

Copyright 2014 - Bizagi

2060

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
Nuevo Lugar.
Crearemos las dependencias para la oficina de Nueva York: las sucursales de Miami y los Angeles.
D clic derecho en el lugar Nueva York, seleccione la opcin Nuevo Lugar y llene los campos
requeridos.

La vista final de los lugares se muestra en la siguiente imagen:

Copyright 2014 - Bizagi

2061

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 Organizaciones en la vista de Mdulos.

2. D clic derecho en Roles y seleccione la opcin Nuevo Rol

Copyright 2014 - Bizagi

2062

3. Se abrir una nueva ventana. Llene los campos requeridos. En esta caso el nombre del rol ser
Creador de Oportunidades de negocio.
D clic en OK.

Se crear el nuevo rol.

Copyright 2014 - Bizagi

2063

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 Organizaciones en la vista de Mdulos.

Copyright 2014 - Bizagi

2064

2. D clic derecho en Habilidades y seleccione la opcin Nueva Habilidad.

Copyright 2014 - Bizagi

2065

3. Se abrir una nueva ventana. Llene los campos requeridos. En esta caso el nombre de la habilidad
ser Conocimiento en primeros auxilios.
D clic en OK.

Se crear a nueva habilidad.

Copyright 2014 - Bizagi

2066

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 Asistente de Organizacin, vaya a la vista de Mdulos, seleccione el mdulo de
Organizaciones y d clic derecho en Organizaciones. Luego seleccione Editar Organizacin.

Copyright 2014 - Bizagi

2067

El Asistente de Organizaciones 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 Siguiente.

Copyright 2014 - Bizagi

2068

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 2014 - Bizagi

2069

Para agregar un registro, d clic en el botn Nuevo y e ingrese la informacin requerida.

Copyright 2014 - Bizagi

2070

Para editar un registro, seleccinelo y d clic en el botn Editar. Cambie la informacin.

Copyright 2014 - Bizagi

2071

Para eliminar un registro, seleccinelo y d clic en Eliminar, luego d clic en Si para confirmar.

Copyright 2014 - Bizagi

2072

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 2014 - Bizagi

2073

Copyright 2014 - Bizagi

2074

Finalmente d clic en Finalizar para guardar los cambios.

Propiedades de usuario

Introduccin
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 Mdulo de Organizaciones o a
travs del Asistente de Organizaciones.

Cmo crear propiedades de usuario


Para crear una propiedad de usuario desde el Mdulo de Organizaciones, d clic derecho sobre las

Copyright 2014 - Bizagi

2075

Propiedades de Usuario y seleccione la opcin Nueva Propiedad de Usuario.

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 Agregar.

Copyright 2014 - Bizagi

2076

Para crear una propiedad de usuario, se debe ingresar la siguiente informacin:

Copyright 2014 - Bizagi

2077

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

Copyright 2014 - Bizagi

2078

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 2014 - Bizagi

2079

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 Men de configuracin de nueva propiedad de usuario en el
Mdulo de Organizaciones. Tambin puede crearlas desde el Asistente de Organizaciones, como
mencionamos anteriormente, si lo prefiere.

2. Ingrese la informacin requerida.


Para la primera propiedad, salario, cree una propiedad de tipo moneda.
Seleccione Tipo de Dato Simple en la lista desplegable de Tipo de Relacin y luego seleccione Moneda
en la lista de Tipo de Datos.

Copyright 2014 - Bizagi

2080

3. Esta propiedad de usuario ser visible, editable y requerida por lo que activamos estas opciones.
D clic en Finalizar.

Copyright 2014 - Bizagi

2081

4. Para crear la propiedad de Tipo de Contrato abra el Men de configuracin de nueva propiedad de
usuario.
5. La propiedad de Tipo de Contrato tendr una relacin de uno a muchos con la entidad paramtrica
Tipo de Contrato.
La entidad paramtrica que contiene la informacin debe ser creada previamente.
Seleccione la opcin Uno a muchos en la lista desplegable de Tipo de Relacin y despus seleccione
Tipo de Contrato en la lista de Entidad Paramtrica/Sistema.

Copyright 2014 - Bizagi

2082

6. Esta propiedad de usuario ser visible, editable y requerida por lo que activamos estas opciones.
D clic en Finalizar.

Copyright 2014 - Bizagi

2083

La dos propiedades que acabamos de crear se muestran bajo el nodo de Propiedades de Usuario.

Copyright 2014 - Bizagi

2084

Si usted accede al Portal de Trabajo y va al men de Administracin de Usuarios ver las nuevas
propiedades disponibles para cada usuario.

Copyright 2014 - Bizagi

2085

Grupos de usuarios

Introduccin
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 Mdulos, d clic en el mdulo de Organizacin y luego d clic derecho en Grupos de
Usuario. Seleccione la opcin Nuevo Grupo de Usuario.

Copyright 2014 - Bizagi

2086

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
caractersticas requeridas.

Copyright 2014 - Bizagi

2087

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 Agregar 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]

Copyright 2014 - Bizagi

2088

Adicionalmente in el mismo grupo de usuarios, algunos empleados pueden ser excluidos utilizando la
opcin Excluir.
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 2014 - Bizagi

2089

Esquema de horarios de trabajo y calendarios

Introduccin
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.

Copyright 2014 - Bizagi

2090

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 Organizaciones y haga clic en la opcin Esquema de
horario de trabajo situado en la parte superior de la pantalla.

2. Se desplegar la ventana de Propiedades de horas de trabajo. Seleccione el esquema deseado de la


lista de esquemas de trabajo.

Copyright 2014 - Bizagi

2091

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 Propiedades de horas de trabajo, haga clic en Nuevo.

Copyright 2014 - Bizagi

2092

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 2014 - Bizagi

2093

3. Por ltimo, haga clic en Aceptar para guardar los cambios.

Editar un esquema de horario de trabajo existente


1. En las Propiedades de horas de trabajo 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.

Copyright 2014 - Bizagi

2094

2. Haga clic en el botn Editar Horario. 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 2014 - Bizagi

2095

3. Modifique el esquema de tiempo de acuerdo a sus necesidades, a continuacin, haga clic en el


botn Asignar y finalmente haga clic en Aceptar.

Copyright 2014 - Bizagi

2096

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 Organizacin y seleccione la opcin Editar Organizacin.

2. Seleccione el Esquema de horario de trabajo que desea asociar a la Organizacin.


Haga clic en Siguiente hasta llegar al ltimo paso del asistente.
Por ltimo, haga clic en Finalizar.

Copyright 2014 - Bizagi

2097

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 Admin en el Portal de Trabajo y seleccione Usuarios.

2. Busque el usuario especfico y haga clic en Editar.

Copyright 2014 - Bizagi

2098

3. Vaya a la pestaa Configuracion usuario. Usted encontrar la opcin Esquema de trabajo.


Seleccione el esquema que se desea aplicar al usuario y haga clic en Actualizar.

Copyright 2014 - Bizagi

2099

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 Esquema de das no laborales. 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 Organizaciones, y haga clic derecho en Esquema de das
no laborales y seleccione Nuevo esquema de das no laborales.

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.

Copyright 2014 - Bizagi

2100

3. Escriba un nombre para el esquema y haga clic en Adicionar para introducir la informacin de cada
da de fiesta. Puede incluir tantos das como sea necesario.

Copyright 2014 - Bizagi

2101

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 d clic
derecho en la ubicacin deseada. Seleccione propiedades y escoja el esquema correspondiente en la
lista de Esquemas de das no laborales.

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:

Copyright 2014 - Bizagi

2102

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.

Mltiples organizaciones

Introduccin
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.

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. Esto se hace al iniciar
cada caso. Cuando un usuario crea un caso se muestra un listado de Organizaciones para que se
seleccione una. Esto amarra el caso a la organizacin.
Slo los usuarios que pertenecen a la Organizacin se tendrn en cuenta en las reglas de asignacin
en todo el caso.

Copyright 2014 - Bizagi

2103

Crear una nueva organizacin


1. Para crear una nueva Organizacin d clic derecho en el nodo de Organizacin y seleccione Nueva
Organizacin.

2. Un nuevo asistente aparecer para ayudar a introducir toda la informacin de la Organizacin.

Copyright 2014 - Bizagi

2104

Como las posiciones y lugares son independientes para cada organizacin, stas deben definirse por
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.

Copyright 2014 - Bizagi

2105

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.

Las reglas de asignacin en proyectos con mltiples organizaciones distinguirn entre los usuarios.

Copyright 2014 - Bizagi

2106

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.

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 Organizaciones, haga clic en el nodo Grupo de Usuarios y seleccione la opcin Nuevo
grupo de usuarios.

Copyright 2014 - Bizagi

2107

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 Aceptar.

Copyright 2014 - Bizagi

2108

3. Otorgue permisos para creacin de casos al grupo de usuarios.


Vaya al mdulo de Seguridad y despliegue el men de Autorizacin.
Despliegue Nuevos casos y seleccione el proceso que se restringir a una sola organizacin.
Agregue el grupo de usuarios y asigne los permisos necesarios.

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.

Definicin de Seguridad
Es posible definir dos tipos diferentes de seguridad en sus proyectos:
Seguridad en Bizagi Studio
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 que
tenga que restringir los accesos a algunos recursos para evitar que los usuarios modifican un proceso,
que afectar a otros procesos, a su vez.
Seguridad en el Portal de trabajo
Bizagi le permite restringir el acceso a las diferentes reas de los procesos durante la ejecucin para
garantizar que las personas adecuadas tengan los privilegios necesarios y evitar acciones no
autorizadas.

Copyright 2014 - Bizagi

2109

Bizagi ofrece el mdulo de seguridad que le permite definir un esquema de permisos en algunos de
los elementos.

Seguridad en Bizagi Studio

Introduccin
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.
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.

Copyright 2014 - Bizagi

2110

La siguiente lista describe los recursos y las acciones relativas a cada uno de ellos.

Seguridad de Aplicaciones y Procesos


Recurso

Crear

Modificar

Control total

Nodo principal de Aplicaciones

Crear nuevas aplicaciones

n/a

n/a

Aplicaciones

Crear nuevos procesos y


Subprocesos

Es visible y
modificable

Crear, modificar
y gestionar la
seguridad

Procesos

n/a

Es visible y
modificable

Crear, modificar
y gestionar la
seguridad

Versiones de proceso

n/a

Es visible y
modificable

Crear, modificar
y gestionar la
seguridad

Los derechos de acceso se heredan. Si tiene permisos de Modificar 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.

Seguridad de Entidades

Copyright 2014 - Bizagi

2111

Recurso

Crear

Modificar

Control total

Nodo principal de
entidades

Crear nuevas entidades

n/a

n/a

Entidades de
Aplicacin

n/a

Es visible y modificable

Crear, modificar y
gestionar la seguridad

Entidades Maestras

n/a

Es visible y modificable

Crear, modificar y
gestionar la seguridad

Entidades Paramtricas

n/a

Es visible y modificable

Crear, modificar y
gestionar la seguridad

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


Recurso

Crear

Modificar

Control Total

Aplicaciones

n/a

Es visible y modificable

Crear, modificar y
gestionar la seguridad

Funciones globales

n/a

Es visible y modificable

Crear, modificar y
gestionar la seguridad

Expresiones globales

n/a

Es visible y modificable

Crear, modificar y
gestionar la seguridad

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
Seguridad de Bizagi Studio.
Los administradores podrn conceder derechos de todos los elementos que tienen seguridad (es
decir, autenticacin, autorizacin y LDAP) en Bizagi Studio.

Copyright 2014 - Bizagi

2112

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 Control total 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:

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.

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).

Copyright 2014 - Bizagi

2113

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 Archivo. Seccione la opcin
Seguridad de Bizagi Studio. Haga clic en Configurar.

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.

Copyright 2014 - Bizagi

2114

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 Incluir
slo para los usuarios que van a ser los administradores

Copyright 2014 - Bizagi

2115

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 Control total
sobre un elemento.
Daremos permiso de acceso a un proceso llamado Quejas y Reclamos.
1. Haga clic en el recurso que desea gestionar y seleccione Seguridad.

2. Una nueva ventana aparecer donde usted debe agregar un usuario o un grupo y seleccionar los
permisos o restricciones deseadas.

Copyright 2014 - Bizagi

2116

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
Mdulos.
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

Copyright 2014 - Bizagi

2117

Proceso, pero no estarn disponible para ser modificadas.

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 Agregar situado en la esquina
inferior izquierda. Esto abrir una ventana para introducir el nombre del grupo y una descripcin.
Cuando termine, haga clic en Aceptar.

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 Incluir junto a los usuarios que deben pertenecer al grupo.

Copyright 2014 - Bizagi

2118

IMPORTANTE: Los usuarios que se Excluyan 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 Aadir usuario / Aadir grupo. Busque y seleccione el usuario o grupo que desea aadir y
haga clic en Aceptar.
Asegrese de que Incluir est seleccionado para todos los miembros (usuarios y / o grupos) que
deben aadirse al grupo objetivo.

Copyright 2014 - Bizagi

2119

IMPORTANTE: El grupo de administradores no se puede aadir a cualquier otro grupo.

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.

Copyright 2014 - Bizagi

2120

Al mdulo de seguridad se accede exclusivamente desde la vista de Mdulos, seleccionando el Mdulo


de Seguridad.

Copyright 2014 - Bizagi

2121

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).

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 Seguridad.
2. En este mdulo, haga clic en el elemento de Autenticacin.

Copyright 2014 - Bizagi

2122

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 Actualizar.
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.
Con la autenticacin personalizada, puede desarrollar su propio componente que reemplaza los

Copyright 2014 - Bizagi

2123

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.

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
tiempos de sesin, el nmero de sesiones simultneas, el tiempo de caducidad de la contrasea, entre

Copyright 2014 - Bizagi

2124

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

Descripcin

Sesiones concurrentes

Si est activada, limita el nmero de sesiones abiertas para una cuenta.

Habilitar bloqueo de
cuentas

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).

Habilitar Login rpido

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.

Forzar cambio de
contrasea

Define si la contrasea debe ser cambiada despus del primer inicio de


sesin.

Validar historial de
contrasea

Define el nmero de contraseas nicas de una cuenta debe tener antes


de utilizar uno antigua.

Registrar eventos de
autenticacin

Define si el Portal de Trabajo debe crear un registro de auditora que


tienen todos los eventos de autenticacin.

Numero mximo de
intentos de ingreso

Establece un nmero mximo de intentos antes de que la cuenta est


bloqueada.

Tiempo de bloqueo de
contraseas

Defines the number of days before an account is locked (an account which
is not logged on).

Tiempo de expiracin de
Define el nmero de das antes de que una cuenta sea bloqueada.
la cuenta
Mximo tamao de
clave

Define el nmero mximo de caracteres para la contrasea sea vlida


(cero si la longitud mxima no es necesario).

Mnimo tamao de clave

Define el nmero mnimo de caracteres para que la contrasea sea


vlida.

La clave necesita
contener letras

Define si validar o no si la contrasea debe al menos una letra para ser


vlida.

La clave necesita
contener nmeros

Define si validar o no si la contrasea debe al menos un nmero para ser


vlida.

Mensaje de correo de

Define el cuerpo del correo que se enva cuando el usuario solicita

Copyright 2014 - Bizagi

2125

recordatorio de clave

recordatorio.

Asunto de recordatorio
de clave

Define el asunto del correo que se enva cuando el usuario solicita


recordatorio.

Tiempo de servicio para


solicitudes pendientes

Define el tiempo de servicio para procesar una solicitud pendiente.

Enviar correo cuando se


cree una solicitud
pendiente

Determina si se debe o no enviar una notificacin cuando un usuario


solicita el desbloqueo de una cuenta.

Mensaje de correo
cuando se enva la clave

Define el cuerpo del correo que se enva cuando una cuenta de usuario
se crea y la contrasea se enva al usuario.

Asunto del correo


cuando se enva la clave

Define el asunto del correo electrnico que se enva cuando una cuenta
de correo es creada y la contrasea se enva al usuario.

Tiempo de sesin

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).

Mensaje de correo de
recordatorio de clave

Define el cuerpo del correo que se enva al administrador cuando un


usuario solicita el desbloqueo de una cuenta.

Asunto de correo de
recordatorio de clave

Define el asunto del correo electrnico que se enva al administrador


cuando un usuario solicita el desbloqueo de una cuenta.

Usar pregunta secreta

Si esta opcin est activada, la pregunta secreta y campos de respuesta


son requieridos.

Cuenta de correo del


administrador

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.

Validar secuencia de
contrasear

Si est activado Bizagi valida secuencias en contrasea.

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
mquina de Windows en el lado del cliente (ya sea usando un dominio corporativo o un dominio local

Copyright 2014 - Bizagi

2126

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 Windows de la lista desplegable:

Haga clic en el botn Actualizar.


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 2014 - Bizagi

2127

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:

Copyright 2014 - Bizagi

2128

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 Intranet local y en el botn Sitios. A continuacin, haga clic en Opciones
avanzadas:

En esta ventana, agregue la direccin URL del Bizagi Portal (especifique la ubicacin y haga clic en
Agregar).
El navegador tomar este lugar como un sitio seguro (para poder trabajar con la configuracin de
inicio de sesin automtico).

Copyright 2014 - Bizagi

2129

Cierre el cuadro de dilogo. De vuelta a la zona de intranet local, haga clic en Nivel personalizado :

Copyright 2014 - Bizagi

2130

Busque la opcin Autenticacin de usuario, para definir el inicio de sesin automtico se activar
Automatic logon is enabled only in Intranet zone.
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.

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 2014 - Bizagi

2131

se almacenan en Bizagi).

Configuracin de la autenticacin LDAP


Para configurar LDAP como tipo de autenticacin, seleccione LDAP 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

Copyright 2014 - Bizagi

2132

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.

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.

Importar usuarios LDAP

Introduccin
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

Copyright 2014 - Bizagi

2133

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.
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.

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 Configuracin Bsica.
Para ello, primero active la sincronizacin del LDAP marcando la casilla Habilitado.

Copyright 2014 - Bizagi

2134

A continuacin, asegrese de llenar la conexin y la configuracin de importacin como se describe a


continuacin:

Configuracin
Conexin

Descripcin

LDAP URL

Especifique la ruta o URL para acceder al servidor LDAP


(formato de URL LDAP).

Dominio\usuario

Especifique un nombre de usuario y su dominio, para ser


utilizado como el usuario autenticado que realiza la
sincronizacin.

Clave

Especifique la contrasea de usuario del dominio utilizado


como el usuario autenticado que realiza la sincronizacin.

Hora de 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.

Configuraci FIltro
n de
importacin

Introduzca un filtro para importar slo las cuentas


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).

Identificador de cuenta
de usuario

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.

En este ejemplo, hemos creado todos estos valores:

Copyright 2014 - Bizagi

2135

2. Especificar de mapeo de atributos.


Pase a la siguiente pestaa llamada Mapeo de LDAP y asegrese de agregar las asignaciones
necesarias para los atributos de la WFUSER.
Para hacer esto, primero haga clic en el botn Agregar Mapeo.
Seleccione los atributos de la Entidad WFUSER y hgalas coincidir con un atributo LDAP, que tiene la
informacin entrante:

Copyright 2014 - Bizagi

2136

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 Valores por defecto y aada todos los valores predeterminados de
los atributos necesarios para su WFUSER.
Para hacer esto, primero haga clic en el botn Agregar Valor por defecto.
Seleccione los atributos de la Entidad WFUSER y asignarles un valor:

Copyright 2014 - Bizagi

2137

No especifique que el atributo Habilitado (enabled) 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 LDAP 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 Resultados de la prueba:

Copyright 2014 - Bizagi

2138

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.

Al sincronizar sus usuarios, Bizagi slo importar como "Activo", el nmero de usuarios soportados
por su licencia activa.

Copyright 2014 - Bizagi

2139

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
company

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).

description

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

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.

dc

Se refiere al componente del dominio, ya sea un componente, una


etiqueta o un nombre de dominio DNS.
Ejemplo: DC=cp, DC=com

DN - also
distinguishedName
givenName

DN es sencillamente el atributo LDAP ms importante. CN=Jay


Jamieson, OU= Newport,DC=cp,DC=com
Primer nombre.

name (nombre)

name = Guy Thomas. Exactamente el mismo que CN.

objectCategory

Define la categora de esquema del directorio activo. Por ejemplo,


objectClass = Person

objectClass

objectClass = User. Tambin usado para Computador (Computer),


organizationalUnit, y hasta container (contenedor). Contenedor de
alto nivel importante.

ou
physicalDeliveryOffice
Name
sAMAccountName

Define la unidad Organizacional.


Ejemplo: OU=Newport
Oficina! en la hoja de propiedad general del usuario.
sAMAccountName = guyt. Antiguo nombre de inicio de sesin de

Copyright 2014 - Bizagi

2140

Atributo LDAP

Ejemplo
NT 4.0, debe ser nico en el dominio. Puede confundirse con CN.

SN
st

street

telephone number

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

userAccountControl

Usado para deshabilitar una cuenta. Un valor de 514 deshabilita la


cuenta, mientras 512 alista la cuenta para inicio de sesin.

userPrincipalName

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.

La siguiente tabla muestra otros atributos que se encuentran en el intercambio:


Atributo de
Intercambio

Descripcin

homeMDB

Aqu es donde se pone el MailStore

legacyExchangeDN

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

mail

Un atributo fcil pero importante. Una simple direccin SMTP es todo


lo que se requiere billyn@ourdom.com

mailNickname

Normalmente es el mismo valor como en sAMAccountName, pero


puede ser diferente si as se desea. Requerido para contactos de
correo habilitados.

mDBUseDefaults

Otro campo directo, slo use el valor: Verdadero (True)

msExchHomeServerNa
me

Intercambia necesidades para saber cul servidor enva el correo.


Ejemplo:
/o=YourOrg/ou=First Administrative Group/cn=Configuration/
cn=Servers/cn=MailSrv

proxyAddresses

Como el nombre 'proxy' sugiere, es posible que un destinatario tenga


ms de una direccin de correo electrnico. Ntese la escritura en
plural de proxyAddresses.

Copyright 2014 - Bizagi

2141

Atributo de
Intercambio

Descripcin

targetAddress

SMTP:@ e-mail address. Note que SMTP es sensible a escritura en


maysculas o minsculas. Todo en letra mayscula significa la direccin
por defecto.

showInAddressBook

Muestra el contacto en la lista de direcciones global.

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.
Para ms informacin, consulte los temas:
Autenticacin personalizada.
Autenticacin mixta.

Autenticacin personalizada

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

Copyright 2014 - Bizagi

2142

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.

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 Autenticacin Personalizada como el tipo de autenticacin, seleccinela de lista
desplegable:

Haga clic en el botn Actualizar.


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:

Copyright 2014 - Bizagi

2143

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


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 Verdadero, Bizagi permitir el
acceso.

Copyright 2014 - Bizagi

2144

Autenticacin mixta
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.

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:

Copyright 2014 - Bizagi

2145

Haga clic en el botn Actualizar.


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.

Otro tipo de autenticacin: Seleccione el tipo de autenticacin que utilizar (Windows o


Personalizada).

Copyright 2014 - Bizagi

2146

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).

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

Copyright 2014 - Bizagi

2147

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 Autorizacin usted puede administrar los accesos de los siguientes items:
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;

Copyright 2014 - Bizagi

2148

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.

Entidades

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.
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.

Creacin de Casos

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-

Copyright 2014 - Bizagi

2149

mens del Portal de Trabajo. Estos permisos se


conceden para cada pgina individualmente.
IMPORTANTE: En el men de Analysis, los
permisos aplicados al men Todos los Reportes
se heredan para los sub-mens. Esto quiere
decir que si se restringe el acceso a Todos los
reportes 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.

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.

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: Analysis (Anlisis),
Management (Gestin), Director (Director) y Vacation Requester(Solicitante de Vacaciones). Los
siguientes permisos se seleccionan para estos roles:

Copyright 2014 - Bizagi

2150

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 Seguridad en la vista de mdulos.

2. Expanda las Opciones de Autorizacin. Luego vaya a la opcin Nuevos casos, seleccione la
aplicacin y Proceso donde se configurarn los permisos de acceso. Para este caso, la aplicacin es
Solicitud de Vacaciones y el Proceso es Solicitud de Licencia de Vacaciones.

Copyright 2014 - Bizagi

2151

3. Observe que se muestran nuevas opciones en el panel de la derecha. D clic en Agregar Rol de
Usuario para definir los roles autorizados para creacin de casos.
La misma configuracin aplica si se seleccionan Grupos de Usuarios dando clic en Agregar Grupo de
Usuarios.

Copyright 2014 - Bizagi

2152

4. En la nueva ventana seleccione el Rol a incluir, en la lista desplegable, y d clic en OK.

Copyright 2014 - Bizagi

2153

5. Como el Rol seleccionado debera estar habilitado para la creacin de casos, d clic en el Rol y
seleccione la opcin Permitir para Nuevo Caso.
D clic en OK.

Copyright 2014 - Bizagi

2154

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 2014 - Bizagi

2155

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 (Rejection Reason) 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 (Director) puede ver y modificar los valores de la entidad Razn de Rechazo
(Rejection Reason) , es decir, debe poseer privilegios de Control Total sobre la entidad.
El Rol de Gestin (Management) puede ver los valores de la entidad Razn de Rechazo (Rejection
Reason) pero no podr editarlos.
El Rol de Anlisis (Analysis) no podr ver ningn dato de la entidad Razn de Rechazo (Rejection
Reason) en absoluto.
Para configurar los permisos de acceso para entidades, siga el procedimiento descrito a continuacin:
1. Vaya al modulo de Seguridad en la vista de mdulos.

Copyright 2014 - Bizagi

2156

2. Expanda las Opciones de Autorizacin. Luego vaya a la opcin Entidades, seleccione la entidad a la
cual se configurarn los permisos de acceso. Para este caso, la entidad es Razn de Rechazo
(Rejection Reason).

3. Observe que se muestran nuevas opciones en el panel de la derecha. D clic en Agregar Rol de
Usuario para definir los roles.
La misma configuracin aplica si se seleccionan Grupos de Usuarios dando clic en Agregar Grupo de
Usuarios.

Copyright 2014 - Bizagi

2157

4. Incluya los Roles para definir los privilegios de acceso a la entidad. Para este caso incluya Director
(Director), Gestin (Management) y Anlisis (Analysis).

Copyright 2014 - Bizagi

2158

5. Para cada Rol o Grupo de Usuarios, permita o restrinja los permisos de acceso segn corresponda:
Para el Rol Director (Director) marque la opcin Permitir en la opcin Control Total. Esto conceder
control total de la entidad Razn de Rechazo (Rejection Reason) a los usuarios con Rol Director
(Director). Observe que las opciones Ver Datos, Modificar y Crear se activarn automticamente.

Copyright 2014 - Bizagi

2159

Para el Rol Gestin (Management) marque la opcin Permitir en la opcin Ver Datos. Esto permitir
consultar los valores de la entidad Razn de Rechazo (Rejection Reason) a los usuarios con Rol
Gestin (Management), pero no les permitir crear nuevos registros.

Copyright 2014 - Bizagi

2160

Para el Rol Anlisis (Analysis) marque la opcin Denegar en la opcin Control Total. Esto restringir a
los a los usuarios con Rol Anlisis (Analysis) el acceso a la entidad. Observe que las dems opciones
se deshabilitarn.

Copyright 2014 - Bizagi

2161

Cuando finalice d clic en OK 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 (Process Analysis
group) donde incluimos los Roles de Anlisis (Analysis) y (Gestin).

Copyright 2014 - Bizagi

2162

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 Seguridad en la vista de mdulos.

2. Expanda las Opciones de Autorizacin. Luego vaya a la opcin Consultas y seleccione la consulta a
la cual se configurarn los permisos de acceso. Para este caso, la consulta es Consulta de Vacaciones

Copyright 2014 - Bizagi

2163

(Vacations Query).

3. Observe que se muestran nuevas opciones en el panel de la derecha. D clic en Agregar Grupo de
Usuarios para administrar los permisos de acceso.

Copyright 2014 - Bizagi

2164

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 (Process Analysis Group).

5. Al grupo se le concedern permisos para Ver Datos, Exportar y Analizar la Consulta. D clic en el
grupo y seleccione Permitir en todas las opciones disponibles. Finalmente d clic en OK.

Copyright 2014 - Bizagi

2165

El procedimiento que acabamos de describir es similar para todos loe elementos en este Mdulo.

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.

Copyright 2014 - Bizagi

2166

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 Subprocesos): 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 2014 - Bizagi

2167

Caso Privado

Seguridad Como el Padre

Copyright 2014 - Bizagi

2168

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 BA Business Administrator. 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 2014 - Bizagi

2169

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 CHelper.getUsersForRole 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 Subprocesos 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.

Copyright 2014 - Bizagi

2170

1. En la vista de Mdulos ingrese a las propiedades del Proceso dando clic sobre su versin.

2. Seleccione la opcin Casos privados (Private cases) para restringir el acceso de los casos y d clic en
OK.

Copyright 2014 - Bizagi

2171

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.

Copyright 2014 - Bizagi

2172

//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 2014 - Bizagi

2173

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.

Copyright 2014 - Bizagi

2174

Si da clic en el Nmero de 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 Subprocesos


Los Subprocesos se pueden crear con Seguridad Como el Padre para que los usuarios que tengan

Copyright 2014 - Bizagi

2175

privilegios sobre el caso padre tengan tambin sobre el hijo (Subproceso) y viceversa. En el proceso
de Solicitud de Compras utilizado anteriormente, una vez el jefe aprueba la solicitud se abre un
Subproceso de Cotizaciones.

La persona encargada de hacer las cotizaciones, (un usuario llamado Quotations) ser asignada.
Dado que es un usuario asignado, podr ver el caso del Subproceso y su informacin en su bandeja
de Pendientes. El usuario Quotations 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.

Copyright 2014 - Bizagi

2176

2. En la ventana de Propiedades seleccione la seguridad Como el Padre.

Copyright 2014 - Bizagi

2177

Con esta informacin los usuarios privilegiados del Subproceso podrn tener acceso a toda su
informacin y a la informacin del caso padre.

Copyright 2014 - Bizagi

2178

Private security with Sub-Processes


Los Subprocesos 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 Subproceso.
En el proceso de Solicitud de Compras utilizado anteriormente, una vez el jefe aprueba la solicitud se
abre un Subproceso de Cotizaciones. La persona encargada de hacer las cotizaciones (usuario
Quotations), ser asignada. Dado que es un usuario asignado podr ver el caso del Subproceso y su
informacin en su bandeja de Pendientes. Como el Subproceso NO tiene seguridad Como el padre, el
usuario Quotations podr ver su actividad pendiente en la lista de pendientes. Sin embargo NO tendr
privilegios sobre el caso padre.

El usuario Quotations 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 2014 - Bizagi

2179

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.

Copyright 2014 - Bizagi

2180

//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 2014 - Bizagi

2181

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.

Copyright 2014 - Bizagi

2182

//Obtain list of all users in the 'Users with access' table


UserstoAdd=CHelper.CEntityManager.GetEntity("Userswithaccess").GetEntityLis
t("","","","");
//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);
}

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

Copyright 2014 - Bizagi

2183

dominios deben ser conocidos de antemano y deben ser enviados desde un sistema externo.

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
grantCaseAccess disponible en WorkflowEngineSOA.asmx, 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 revokeCaseAccess disponible en
WorkflowEngineSOA.asmx.
Para remover un usuario de la lista de usuarios privilegiados:

Copyright 2014 - Bizagi

CHelper.RevokeCaseAccess (int

2184

idCase, int idUser)


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:

Restringir acceso mvil a Procesos/Tareas


Por defecto, el acceso desde dispositivos moviles a todas las tareas y creacion de todos los Procesos,
se encuentra habilitado; cualquier tarea de cualquier Proceso puede ser ejecutada desde un dispositivo
mvil.
En algunos casos, puede que sea necesario restringir el acceso mvil a la creacin de casos de un
Proceso o a tareas especficas, debido a la complejidad de las interfaces de usuario. Bizagi le permite
definir qu Procesos y tareas pueden accederse desde dispositivos mviles:
Si el acceso mvil no
mviles en la lista de
Si el acceso mvil no
mviles en la lista de

se encuentra habilitado para un Proceso, este no se mostrar a los usuarios


creacin, y ninguna de sus tareas podr ejecutarse desde un dispositivo mvil.
se encuentra habilitado para una Tarea, esta no se mostrar a los usuarios
pendientes (Inbox).

La configuracin de estas restricciones se hace desde Bizagi Studio. No se requieren configuraciones


adicionales en los dispositivos mviles.

Restringir acceso mvil a un Proceso


Para restringir el acceso desde dispositivos mviles a un Proceso, abra Bizagi Studio y dirijase a la
vista de Mdulos.

Copyright 2014 - Bizagi

2185

Expanda el rbol de Procesos y haga clic derecho en la versin del Proceso que desee restringir.
Luego seleccione Propiedades.

Se mostrar la ventana de Propiedades del Proceso. Encuentre la casilla de verificacin Acceso mvil y
desactivela.

Copyright 2014 - Bizagi

2186

Una vez desabilitada esta opcin, el Proceso no se mostrar a los usuarios mviles en la lista de
creacin de casos y por lo tanto ninguna de sus tareas podr ser ejecutada desde dispositivos
mviles.

Restringir acceso mvil a una Tarea


Para restringir el acceso mvil a una Tarea, abra Bizagi Studio y dirjase al primer paso del Asistente de
Procesos (Modelar Proceso).
En el diagrama, haga clic derecho en la tarea que desee restringir. Encuentre la casilla de verificacin
Acceso mvil y desactivela.

Copyright 2014 - Bizagi

2187

Una vez desabilitada esta opcin, la Tarea no se mostrar a los usuarios mviles en la lista de tareas
pendientes y por lo tanto no podr ser ejecutada desde dispositivos mviles.

Encripcin en la base de datos

Introduccin
En algunos escenarios de negocio, se puede requerir incluir medidas adicionales de seguridad para
proteger la informacin.
Para esto, Bizagi ofrece la posibilidad de encriptar (cifrar) la informacin en la base de datos.
Algunos ejemplos de estos escenarios son:
Cuando existe informacin muy sensible que deba estar oculta para usuarios no deseados,
Especialmente, si muchos usuarios tienen acceso autorizado a la base de datos y su informacin.
Cuando se estn integrando fuentes de datos externas al proyecto (a travs de Virtualizacin y
Replicacin) y requiere otorgar una seguridad adicional para la informacin local almacenada en
Bizagi.
El cifrado de informacin en la Base de Datos, es llevado a cabo por Bizagi a travs de algoritmos de
cifrado configurados para el proyecto.
Esta seccin describe cmo usar esta caracterstica llamada Encripcin en la Base de Datos.

Copyright 2014 - Bizagi

2188

Cmo funciona?
Para habilitar Encripcin en la Base de Datos, necesitar especificar una llave (por ejemplo, un GUID de
32 caracteres) para el algoritmo de cifrado.
Esta llave es almacenada en un archivo en una ruta fsica con acceso restringido; solo usted conocer
la ubicacin del archivo.
Bizagi usar el algoritmo de Hashing de su eleccin para preparar la llave como un arreglo de bits
para el algoritmo de cifrado.
Tambin necesitar el algoritmo de cifrado que va a usar.

Algoritmos soportados de Hashing y Cifrado


La Encripcin en la base de datos de Bizagi, soporta los siguientes algoritmos:
Algoritmos de Hashing
SHA1
SHA2 256

Seleccione SHA2 256 para una mayor conversin de seguridad.


Seleccione SHA1 para que el rendimiento no se vea afectado por un procedimiento de conversin
ms sofisticado.
Algoritmos de Cifrado simtrico
DES
Triple DES 1
Triple DES 2
AES (recomendado)

Importante
Bizagi Ltd no es responsable de la llave definida para este propsito (Bizagi no almacena la llave y
usted escoge dnde almacenarla).
La llave definida esta solamente bajo su control, custodia y su debida proteccin. En consecuencia,
usted es el nico responsable de almacenar, custodiar, proteger y restringir el acceso a la llave.
Debido a lo anterior, usted debe tener un plan de contingencia o un backup en caso de perder la llave,
considerando que la informacin cifrada no puede ser recuperada en ningn momento por Bizagi sin
la llave.

Qu necesita hacer
Para usar la Encripcin en la Base de Datos, usted necesita ejecutar los siguientes pasos:
1. Autorizar los usuarios que pueden configurar la Encripcin en la base de datos
2. Establecer el algoritmo de cifrado y su llave
3. Configurar cul informacin debe ser cifrada

Copyright 2014 - Bizagi

2189

Procedimiento
1. Autorizar los usuarios que pueden configurar la Encripcin en la base de
datos
De manera predeterminada, los usuarios no estn autorizados para configurar la Encripcin en la base
de Datos
Para contar utilizar esta funcionalidad, necesitar asegurarse de que el Usuario Administrador de
Negocio est explcitamente autorizado para configurar los parmetros necesarios para el cifrado
(como los algoritmos y lo ms importante, la llave usada en el cifrado).

Primero, para verificar que esta funcionalidad est habilitada, asegrese de incluir la siguiente key en
el archivo de configuracin appsettings.xml del Bizagi Studio o del Management Console:
<add key="EncryptionSupport" value="AllowEncryption" />
Para autorizar usuarios, abra su proyecto a travs de Bizagi Studio.
Una vez abierto, existen dos maneras diferentes para otorgar permisos a un usuario para esta
funcionalidad: Estableciendo el usuario como un administrador o autorizando a un usuario para usar la
Encripcin en la base de datos.
Primera opcin: Estableciendo un usuario como un Administrador.
Esta opcin permitir al usuario usar la Encripcin en la Base de Datos, as como delegar este permiso
a otros usuarios.
Para hacer esto, lleve a cabo los siguientes pasos:
1. Navegue al mdulo Seguridad de Bizagi Studio, ubicado en la pestaa Archivo y Seguridad de Bizagi
Studio.
2. Haga Clic en la opcin Configurar.

Copyright 2014 - Bizagi

2190

3. Aada el usuario al grupo Administrators, haciendo clic en en el botn Aadir usuario.

4. Asegrese de marcar especficamente la casilla Incluir para especificar que este usuario tendr
privilegios de administrador.

Copyright 2014 - Bizagi

2191

5. Haga Clic en Cerrar para aplicar los cambios.

Tambin puede escoger aadir un grupo al grupo de Administradores, siguiendo los mismos pasos
anteriores pero usando el botn Aadir Grupo.
Segunda opcin: Autorizando a un usuario para usar la Encripcin de la Base de Datos.
Esta opcin permitir al usuario configurar la Encripcin de la Base de Datos.
Para hacer esto, lleve a cabo lo siguiente:
1. En la vista de Mdulos, seleccione el mdulo Entidades.
2. Haga clic derecho en el nodo raz Entidades y seleccione la opcin Seguridad:

Copyright 2014 - Bizagi

2192

3. Agregue el usuario haciendo clic en el botn Aadir Usuario.


Una vez incluido, asegrese de seleccionar Permitir al privilegio llamado Encriptar Datos:

4. Haga clic en Cerrar para aplicar los cambios.

Copyright 2014 - Bizagi

2193

Tambin puede escoger aadir un grupo al grupo de Administradores, siguiendo los mismos pasos
anteriores pero usando el botn Aadir Grupo.

2. Establezca el algoritmo de cifrado y su llave


Siga estos pasos para configurar el algoritmo de cifrado, el algoritmo de Hashing y la llave de cifrado.
2.1 Defina una llave para el algoritmo de cifrado a usar y gurdela en un archivo de texto plano.
Asegrese que este archivo est guardado en una ubicacin de red disponible con acceso restringido.
En nuestro ejemplo, la llave tiene 32 caracteres y fue tomada de un GUID auto-generado:

2.2 Habilite la Encripcin en la base de datos en Bizagi


Abra Bizagi Studio y seleccione la opcin Entorno, localizada en la pestaa Configuracin.

2.3 Seleccione la opcin Avanzadas ubicada en el panel izquierdo y desplcese hasta Cryptography
Options.
Recuerde que estas opciones se mostrarn para usuarios explcitamente autorizados para configurar
esta funcionalidad (Como se describi en el primer paso).

Copyright 2014 - Bizagi

2194

PROPIEDAD DE
CONFIGURACIN

DESCRIPCIN

Hashing algorithm

Seleccione el algoritmo de Hashing usado para convertir la llave en


un arreglo de bits. los algoritmos disponibles son: SHA1, SHA2 256.
Tenga en cuenta que SHA2 usar 256 bits (opuesto a SHA1 que usa
160) y por lo tanto, crear una definicin ms dispersa de la llave
(ms segura).

Encryption algorithm

Seleccione el algoritmo que ser usado por la llave establecida para


cifrar la informacin.
Las opciones disponibles son: DES, Triple DES 1, Triple DES 2, AES
(recomendado).

Key File location (URL)

Especifique la localizacin del archivo Llave.


Recuerde que este campo debe ser una URL accesible desde el
Servidor BPM. Puede especificar la URL como una de las opciones o
ejemplos a continuacin:
Una ruta local del Servidor BPM.
Una ruta a un servidor de archivos (p.ej, file://[your_file_server]/

Copyright 2014 - Bizagi

2195

KeyFiles/KeyFile.txt)
Una URL HTTP o HTTPS (p.ej., https://[HTTP_Server]/SslText/
KeyFile.txt)
Set Authentication Properties

Usuario

Password

Domain

Marque esta opcin para especificar las credenciales autorizadas


para acceder al archivo Llave.
Si esta opcin est desmarcada, Bizagi usar:
Para la configuracin, las credenciales del usuario autenticado del
Bizagi Studio.
Para la ejecucin, las credenciales usadas por el Servidor BPM
(p.ej, en IIS, la identidad definida por el pool de aplicaciones).
Ingrese el nombre del usuario autorizado para acceder al archivo
llave
(Aplica cuando est marcada la opcin Set Authentication
Properties).
Ingrese la contrasea del usuario autorizado para acceder al archivo
llave
(Aplica cuando est marcada la opcin Set Authentication
Properties).
Ingrese el dominio del usuario autorizado para acceder al archivo
llave
(Aplica cuando est marcada la opcin Set Authentication
Properties).

2.4 Haga Clic en Aceptar para aplicar los cambios.

3. Configurar cul informacin debe ser cifrada


Una vez haya configurado el algoritmo de cifrado y su llave, usted puede marcar cules atributos
desea que sean establecidos como informacin cifrada.
Para hacer esto, defina cada atributo marcando la opcin Cifrado:

Copyright 2014 - Bizagi

2196

Ejemplo
Para explicar cmo establecer o agregar un Atributo Cifrado, el proceso previamente creado en Mi
primer proceso (Vacation Request Process), ser usado para ilustrar esto paso.
Vamos a asumir que el nmero de das disponibles va a ser un atributo que solo puede ser consultado
a travs del portal de trabajo. Esta ser la condicin de negocio que hace necesario que Availabledays
sea un atributo cifrado.
Cualquier usuario con el usuario y la contrasea de la Base de Datos puede ver la tabla donde se
almacenan las solicitudes de vacaciones. (recuerde que las entidades creadas en el paso Modelo de
datos, crearn una tabla en la Base de datos configurada para Bizagi Studio.)

Copyright 2014 - Bizagi

2197

Sin establecer ningn atributo como cifrado, cualquier usuario, con las credenciales correctas, puede
ver toda la informacin en claro:

Esta es una situacin indeseada porque Availabledays ser un atributo que solo puede ser consultado
a travs del portal de trabajo y en este caso, el atributo puede ser consultado usando cualquier editor
de SQL que tenga la conexin a la Base de Datos.
Para resolver esta situacin, se definir el atributo Availabledays como cifrado, para hacer esto:
1. Vaya al paso 2 del asistente llamado "Modelo de Datos".

Copyright 2014 - Bizagi

2198

2. Haga clic derecho en la entidad donde ser agregado o establecido el atributo cifrado y seleccione
la opcin Editar Lista de Atributos.

3. Se mostrar la lista de Atributos de la entidad. Seleccione el atributos que requiere ser establecido
como cifrado.

Copyright 2014 - Bizagi

2199

4. Marque la opcin Cifrado, Esto ocultar los campos Valor por Defecto y Localizable si
corresponde.

Copyright 2014 - Bizagi

2200

5. Haga clic en Finalizar para guardar y aplicar los cambios.


6. Guarde el modelo de datos.

Cuando se agregan atributos a la lista, la opcin para cifrarlos estar disponible cuando el tipo de
datos seleccionado est disponible para ser cifrado.
En este punto, Bizagi habr modificado la tabla correspondiente para establecer el campo
seleccionado en los pasos anteriores como cifrado, si miramos en la Base de datos, la estructura de la
tabla ahora se ve as:

El atributo Availabledays era de tipo int antes del proceso de cifrado y ahora es de tipo image. Y lo
ms importante, la informacin no es visible para el usuario que se autentic en la Base de Datos.

El ejemplo anterior fue creado usando una Base de Datos SQL Server; el tipo de datos en una base
de datos Oracle ser BLOB.
Cuando se lanza el portal de trabajo, la informacin cifrada ser descifrada antes de ser presentada al
usuario, como se muestra en la siguiente imagen. De esta manera, hemos resuelto la situacin
potencialmente negativa que fue lanzada por la condicin de negocio:

Copyright 2014 - Bizagi

2201

Consideraciones
1. Tenga en cuenta que la Encripcin en la base de datos esta disponible para atributos en las
entidades Maestras o Paramtricas.
Esto quiere decir que no se puede cifrar las propiedades de la entidad WFUser o cualquier otra del
Sistema o de la Aplicacin.
2. Los tipos de datos soportados por la Encripcin de la base de datos son:
Tiny integer (8 bits)
Small integer (16 bits)
Integer (32 bits)
Big integer (64 bits)
Real (4 bytes)
Float (8 bytes)
Currency (16 bytes)
String (hasta 2000 caracteres)
Long Text
Date Time

3. Cuando se usa la Encripcin en la base de datos para atributos de su modelo de datos, las
siguientes acciones no son soportadas:
Usar el atributo como filtro para un control de bsqueda.
Incluir el atributo como una columna personalizada mostrada en el resumen de la informacin del
caso.

La Encripcin en la base de datos afecta el desempeo cuando se usa en listas desplegables que
muestran informacin de fuentes de datos externas. Por lo tanto, considere y evale
cuidadosamente su diseo de la interfaz grfica y use esta funcionalidad cuando sea necesario.

Copyright 2014 - Bizagi

2202

Definicin de la localizacin
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
Checo

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.

Copyright 2014 - Bizagi

2203

Abra el men de Configuracin de negocio y vaya a las opciones de localizacin. En la primera opcin,
seleccione de la lista desplegable, el idioma que desea definir como predeterminado .

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 Objetos internos 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 de mdulos y acceda al mdulo Portal de Trabajo. D
clic en la opcin Internos.

Copyright 2014 - Bizagi

2204

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.

Cuando se selecciona un idioma de la Cultura 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 Valor. Sin embargo, esta pantalla es nicamente para fines de referencia y no significa que se
haya elegido el idioma de visualizacin.

Copyright 2014 - Bizagi

2205

Usted puede buscar un recurso especifico introduciendo su nombre en el campo Nombre del recurso.

Recursos Extendidos
Para crear y localizar recursos extendidos, vaya al mdulo Portal de Trabajo y d clic sobre Extendidos.
Seleccione el elemento extendido que est asociado con la localizacin del recurso. Aqu puede aadir
los recursos extendidos junto con sus localizaciones correspondientes.

Copyright 2014 - Bizagi

2206

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.

Copyright 2014 - Bizagi

2207

Traduccin de objetos Bizagi


Los Objetos Bizagi 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.

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 2014 - Bizagi

2208

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 de Mdulos dando clic en la versin del Proceso y
seleccionando la opcin Propiedades.

Una nueva ventana mostrar sus propiedades. A la derecha del campo Nombre visual del proceso se
encuentra un icono de Globo conocido como Botn de localizacin de recursos. D clic en el icono
para abrir el men de localizacin y traducir el nombre del proceso al idioma(s) deseado(s).

Copyright 2014 - Bizagi

2209

La traduccin de la propiedad Nombre visual 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 de
Mdulos dando clic en la versin de Proceso y luego seleccionando la opcin Localizacin.

Copyright 2014 - Bizagi

2210

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: Men de Modelo de datos (segundo paso del asistente), Diseador de formas

Copyright 2014 - Bizagi

2211

(tercer paso del asistente) o la Vista de Mdulos.


Seleccione el atributo a traducir en la lista de atributos y d clic en el Botn de Localizacin de
recursos.

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 Botn de localizacin de recursos.

Copyright 2014 - Bizagi

2212

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 Botn de localizacin de recursos en el panel
de propiedades bsicas.

Nmero de caso personalizado


Bizagi por defecto, mantiene una secuencia interna de nmeros de caso y asigna el Nmero de 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.

Copyright 2014 - Bizagi

2213

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.

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 Configuracin y haga clic en Secuencias.

Copyright 2014 - Bizagi

2214

2. En la nueva ventana, haga clic en Adicionar para incluir una nueva secuencia.

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.

Copyright 2014 - Bizagi

2215

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.

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 Configuracin. Haga clic en Numeracin de casos.

Copyright 2014 - Bizagi

2216

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 Omisin (definido por
Bizagi), por Secuencia (que se obtiene a partir de una secuencia definida por el usuario) o Por regla
(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 Por secuencia o Por regla se
selecciona en el campo de Uso. Le permite definir un prefijo, la secuencia relacionada y un sufijo
para el nmero de casos.

Copyright 2014 - Bizagi

2217

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.
Seleccionamos Secuencia factura (secuencia previamente creada) en la lista desplegable.

Copyright 2014 - Bizagi

2218

Haga clic en Aceptar 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


Cuando el nmero de caso personalizado no se puede configurar por secuencia, ya que requiere un
procedimiento ms complejo, puede usar expresiones.

Copyright 2014 - Bizagi

2219

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: Incidentes, Quejas y reclamos y la Gestin de
oportunidades de venta. Usted desea identificar cada proceso con un nmero de caso que muestre el
proceso al que pertenece y el ao en que fue creado:
Incidentes: IM - "Secuencia" - "Ao"
Quejas y reclamos: CCM - "Secuencia" - "Ao"
Gestin de oportunidades de venta: 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 Numeracin de casos 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.
Asignar nmero de caso en - Creacin de Caso. El nmero de caso se asignar tan pronto como el
caso se crea.

Copyright 2014 - Bizagi

2220

3. En la configuracin cree la regla para evaluar cada proceso.


Haga clic en el cuadrado de la derecha para definir una nueva expresin.

Copyright 2014 - Bizagi

2221

En el editor de expresin incluye el siguiente cdigo:

//Obtener el ao actual en una variable


year=DateTime.Today.Year
//Identificar el proceso de acuerdo con su ID

Copyright 2014 - Bizagi

2222

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.

Cmo configurar Virtualizacin para entidades relacionadas

Introduccin
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.

Copyright 2014 - Bizagi

2223

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.

La siguiente seccin 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).

Copyright 2014 - Bizagi

2224

Ejemplo
En esta seccin 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.

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 2014 - Bizagi

2225

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 ejemplo implica dos pasos del Asistente para la virtualizacin
y las opciones avanzadas de virtualizacin.

Copyright 2014 - Bizagi

2226

Configurar la virtualizacin para el repositorio existente


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 2014 - Bizagi

2227

Incluya la informacin para nombrar y definir nuestro CRM como un "sistema externo" (external
system) en el proyecto Bizagi:

Copyright 2014 - Bizagi

2228

Especifique el detalle de la conexin para el proveedor de la conexin (Provider):

Copyright 2014 - Bizagi

2229

Bizagi presentar las tablas y vistas disponibles del CRM para su virtualizacin.
Seleccione (marque) las entidades a virtualizar y d clic en Siguiente.

Copyright 2014 - Bizagi

2230

En el siguiente paso no se define un filtro, ya que no se necesita en nuestro ejemplo. Haga clic en
Siguiente.

Copyright 2014 - Bizagi

2231

Bizagi crear las entidades correspondientes:

Copyright 2014 - Bizagi

2232

Cuando este proceso termine, haga clic en Finalizar (Finish).

Copyright 2014 - Bizagi

2233

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).

Copyright 2014 - Bizagi

2234

Asegrese que haya incluido un atributo de tipo referencia en la entidad de proceso (llamada "Product
Request"), a la entidad Custom

Copyright 2014 - Bizagi

2235

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.

Copyright 2014 - Bizagi

2236

De esta forma, un cliente tendr una o ms cuentas (registros en Customer_Accou). Para esta
definicin, incluiremos un atributo de tipo coleccin:

Copyright 2014 - Bizagi

2237

Bizagi incluir los atributos para representar esta relacin:

Copyright 2014 - Bizagi

2238

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 Sistema (System) y Proveedor (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 Adicionar atributo a la
virtualizacin ("Add attribute to virtual"):

Copyright 2014 - Bizagi

2239

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.

Copyright 2014 - Bizagi

2240

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.

En el ejemplo anterior, el atributo Customer es el que se cre automticamente por Bizagi al definir
la relacin 1-n (este atributo mantiene la relacin en Bizagi desde la entidad Customer_Account).
Se recomienda entonces que se elimine el atributo idCustomer, 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 Customer, 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 2014 - Bizagi

2241

Incluya el atributo Customer de su entidad de proceso en la forma de Solicitud de Registro.


De forma predeterminada, esto se representa como un control Search.

Copyright 2014 - Bizagi

2242

Para este control, establezca sus propiedades de bsqueda tales como: el atributo para mostrar, y la
forma que se abre (defina una nueva seleccionando Nueva forma):

Copyright 2014 - Bizagi

2243

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 MyCustomerSearchForm.

Guarde esta forma.


Incluya la coleccin Cuentas (Accounts) en la forma y edite las columnas que se muestran en la tabla:

Copyright 2014 - Bizagi

2244

Se incluyen los atributos Customer_Account: Nmero de cuenta, Fecha de creacin y el Balance.

Copyright 2014 - Bizagi

2245

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:

Copyright 2014 - Bizagi

2246

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 2014 - Bizagi

2247

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.

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:

Copyright 2014 - Bizagi

2248

Esto significa que en Bizagi, necesitaremos asegurar que para esa entidad, la llave de negocio
(businessKey) incluya estos 2 atributos:

Copyright 2014 - Bizagi

2249

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" si la llave est definida
en ese orden.

Columnas personalizadas
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

Copyright 2014 - Bizagi

2250

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 Subproceso: 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
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 Procesos 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 Personalizar columnas.

Copyright 2014 - Bizagi

2251

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 2014 - Bizagi

2252

3. Aparecer la ventana de Personalizacin de Columnas. Para incluir nuevas columnas, deshabilite la


opcin Utilizar configuracin por defecto y luego d clic en Agregar Vocabulario o Agregar Atributo
de acuerdo al tipo de informacin que desee incluir.

Cuando se agrega un atributo, usted encontrar la lista de columnas estndar tales como nmero de

Copyright 2014 - Bizagi

2253

caso, Categora, proceso, actividad, fecha de vencimiento, fecha de creacin 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 2014 - Bizagi

2254

Adicionalmente usted puede cambiar el orden en el que se muestran las columnas, utilizando los
iconos Arriba

o Abajo

Para eliminar columnas simplemente d clic en el atributo/vocabulario y luego d clic en el icono


Remover
icon.

Columnas a nivel de Subproceso


Biazgi tambin le permite configurar la informacin mostrada para un proceso, cuando este se accede
como Subproceso de otro proceso.
Por defecto la vista de los Subprocesos de un proceso se muestra desde el Portal de trabajo de la
siguiente manera:

Cuando se personalizan la columnas de un Subproceso, usted no puede eliminar las columnas de


informacin estndar (Nmero de caso y nombre del Subproceso), solamente incluir nueva
informacin.
Para configurar la vista de un proceso cuando se accede como un Subproceso, vaya al mdulo de

Copyright 2014 - Bizagi

2255

Procesos en Bizagi Studio y busque el Subproceso. D clic sobre el y seleccione la opcin Personalizar
columnas.
En la nueva ventana vaya a la pestaa de Subprocesos. 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 nmero de caso, proceso, actividad, fecha de creacin,
fecha de vencimiento de la tarea y fecha de vencimiento del proceso en el Inbox del Portal de
Trabajo. Suponga que solo deseamos mostrar las columnas de nmero de caso, nombre de la
actividad y nombre del proceso.
Para hacerlo, vaya a la opcin Aplicaciones, desde el mdulo de Procesos, y d clic derecho sobre ella.
Luego seleccione la opcin Personalizar columnas.

Copyright 2014 - Bizagi

2256

En la nueva ventana deshabilite la opcin Utilizar configuracin por defecto y luego d clic en Agregar
atributo.

Agregue los atributos deseados y d clic en Ok.

Copyright 2014 - Bizagi

2257

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 2014 - Bizagi

2258

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: Nmero de caso, fecha de apertura, prioridad y
asunto.
Las dems aplicaciones mantendrn la personalizacin global de aplicaciones configurada en el

Copyright 2014 - Bizagi

2259

ejemplo anterior.
Para hacerlo, vaya a la Aplicacin especfica (Mesa de ayuda), desde el mdulo de Procesos, y d clic
derecho sobre ella. Luego seleccione la opcin Personalizar columnas.

En la nueva ventana deshabilite la opcin Utilizar configuracin por defecto y luego d clic en Agregar
atributo.

Copyright 2014 - Bizagi

2260

Agregue los atributos deseados desde el modelo de datos de la aplicacin y d clic en Ok.

Copyright 2014 - Bizagi

2261

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 Subproceso


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 2014 - Bizagi

2262

proyecto es una instancia de un Subproceso (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 Subproceso.

Con el fin de proveer mayor informacin al gerente, es necesario utilizar columnas personalizadas a
nivel de Subproceso. Para hacerlo, vaya al Subproceso (realizar tarea ad-hoc), desde el mdulo de
Procesos, y d clic derecho sobre l. Luego seleccione la opcin Personalizar columnas.

Copyright 2014 - Bizagi

2263

En la nueva ventana, vaya a la pestaa de Subprocesos. Deshabilite la configuracin por defecto y


luego d clic sobre la opcin Agregar atributo.

Copyright 2014 - Bizagi

2264

Agregue los atributos deseados desde el modelo de datos del proceso y d clic en Ok.

Ahora los Subprocesos se mostrarn de la siguiente manera:

Copyright 2014 - Bizagi

2265

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.

Cmo hacer? ....


Consulte las secciones a continuacin para conocer acerca de cmo trabajar en situaciones tcnicas y
de modelado especficas durante la implementacin de su proyecto en Bizagi.

Temas de integracin
Consulte las secciones a continuacin para ver algunos ejemplos acerca de cmo integrar Bizagi con
otros sistemas.

Cmo integrar Bizagi con SAP

Introduccin
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 esta seccin, 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:

Copyright 2014 - Bizagi

2266

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:

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

Copyright 2014 - Bizagi

2267

Integrar Bizagi con SAP invocando servicios web de SAP

Overview
En esta seccin 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.
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 otro ejemplo enfocado en la 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:

Copyright 2014 - Bizagi

2268

En esta seccin, vamos a ilustrar especficamente a la creacin de una reserva de vuelo en SAP,
realizado desde Bizagi sin necesidad de programacin.
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).

Prerrequisitos
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

Copyright 2014 - Bizagi

2269

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).
2. Configurar el servicio web de invocacin.
La configuracin en Bizagi se realiza por medo del asistente de interfaces..

Ejemplo
El ejemplo de esta seccin 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.

Copyright 2014 - Bizagi

2270

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 2014 - Bizagi

2271

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
BAPI_FLIGHT_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.

Copyright 2014 - Bizagi

2272

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 (FLIGHT_LIST structure) que retorna SAP es:

Copyright 2014 - Bizagi

2273

De manera similar, se revisa tambin el detalle de la funcin BAPI_FLBOOKING_CREATEFROMDATA


que se invoca posteriormente para crear la reserva del vuelo en SAP.

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
Available Flights from SAP.
Para ello, vamos al sexto paso del Asistente de proceso en Bizagi Studio, Integrar y seleccionamos
Definir interfaces de integracin.

Copyright 2014 - Bizagi

2274

Seguidamente seleccionamos la tarea de servicio Get Available Flights from SAP 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 Siguiente.

Copyright 2014 - Bizagi

2275

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:

Copyright 2014 - Bizagi

2276

Tenga en cuenta que para usar las funciones Concat y Constant necesita maximizar la ventana de
configuracin
D clic en Siguiente una vez finalice su mapeo.
El mapeo de los parmetros de salida se hace como se muestra a continuacin:

Copyright 2014 - Bizagi

2277

En el ltimo paso, damos clic en Finalizar. (No necesitamos definir manejo de error en esta
invocacin).

Copyright 2014 - Bizagi

2278

De manera similar, la tarea de servicio Book flight in SAP se configura con la invocacin de la funcin
que crea la reserva de vuelo en SAP (BAPI_FLBOOKING_CREATEFROMDATA), 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 Ejecutar:

Copyright 2014 - Bizagi

2279

AL trabajar el proceso de Reserva de Vuelos la tarea de servicio Get available flights from SAP
obtendr y actualizacin en Bizagi los resultados de la consulta desde SAP:

Copyright 2014 - Bizagi

2280

Crear un proveedor en SAP desde Bizagi

Introduccin
En esta seccin 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 2014 - Bizagi

2281

Prerrequisitos
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 prerrequisitos, 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:

Copyright 2014 - Bizagi

2282

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 ejemplo 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 2014 - Bizagi

2283

En este punto, vamos a configurar la tarea de servicio Verify Provider in SAP 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 SOA como el tipo de servicio y la URL WSDL, luego clic en Go.
Seleccione el mtodo correspondiente y d clic en Siguiente.

Copyright 2014 - Bizagi

2284

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 2014 - Bizagi

2285

D clic en Siguiente.
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 d clic en Siguiente.

Copyright 2014 - Bizagi

2286

En el ltimo paso, hacemos clic en finalizar (el manejo de error lo toma Bizagi).

Copyright 2014 - Bizagi

2287

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 Vendor in SAP para que invoque la creacin
del proveedor en SAP.

Copyright 2014 - Bizagi

2288

Seleccione SOA como el tipo de servicio, ingrese la URL del servicio web y seleccione el mtodo
correspondiente.
D click en Siguiente.

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 2014 - Bizagi

2289

D clic en Siguiente.
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 d clic en Siguiente.

Copyright 2014 - Bizagi

2290

En el ltimo paso, hacemos clic en finalizar (el manejo de error lo toma Bizagi).

Copyright 2014 - Bizagi

2291

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.

Integrar Bizagi con SAP invocando directamente BAPI Wrappers

Introduccin
En esta seccin 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

Copyright 2014 - Bizagi

2292

wrappers de SAP para crear los registros y persistir la informacin.


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 esta seccin, 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.

Prerrequisitos
Para lograr esta integracin es necesario:
Tener las funciones BAPI wrappers disponibles en su sistema SAP, para poder invocarlas desde

Copyright 2014 - Bizagi

2293

Bizagi de manera que se pueda obtener informacin y/o crear registros en SAP.
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.

Deber asegurarse de utilizar el conector SAP.NET que se adece a las caractersticas de su sistema.
En el siguiente ejemplo, utilizamos los ensamblados sapnco.dll y sapnco_utils.dll en su versin 3.0
assemblies, los cuales a la fecha no se encuentran disponibles para un sistema de 32 bits (por lo
que en este ejemplo se configuran con Bizagi en un pool de aplicaciones de 32 bits).

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
Este ejemplo 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:

Copyright 2014 - Bizagi

2294

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 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
BAPI_FLBOOKING_CREATEFROMDATA, 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 2014 - Bizagi

2295

En la siguiente imagen, vemos la ventana de detalle que se muestra para nuestra funcion
BAPI_FLBOOKING_CREATEFROMDATA (crear una nueva reserva) y sus parmetros de importacin.

La estructura BAPISPONEW en detalle para la creacin de una reserva de vuelo es:

Copyright 2014 - Bizagi

2296

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.

De manera similar, revisamos el detalle de la funcin BAPI_FLIGHT_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.

Copyright 2014 - Bizagi

2297

Las libreras de "SAP.Net Connector" en su versin 3.0 son: sapnco.dll y sapnco_utils.dll, y quedan
ubicadas en la ruta escogida durante la ejecucin de instalacin del conector.

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 GetFlights() y CreateBooking(), cada una
para invocar la funcin de SAP que corresponde.
Su cdigo es:

Copyright 2014 - Bizagi

2298

SAPAccess.cs contiene la configuracin para la conexin al sistema SAP. Su cdigo es:

Copyright 2014 - Bizagi

2299

Copyright 2014 - Bizagi

2300

Ntese que el mtodo mencionado setConnection() 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 CreateFromData_Booking() utiliza la estructura BAPISPONEW y su
metadata y la tabla de retorno RETURN, como la habamos consultado a travs del Netweaver de SAP
en el paso anterior.

Tenga en cuenta que despus de invocar una funcin que crea datos en SAP, necesitamos llamar la
funcin BAPI wrapper BAPI_TRANSACTION_COMMIT para persistir la nueva informacin (hacer
commit).
Tambin se requiere cerrar el contexto actual (utilizando RfcSessionManager.EndContext()).
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 BizagiSAP.dll 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

Copyright 2014 - Bizagi

2301

denomina.

Adjuntamos la librera dll en esta nueva librera:

Copyright 2014 - Bizagi

2302

Asegrese de ingresar el namespace correspondiente para la librera, tal cual como se defini en el
cdigo en .Net:

Copyright 2014 - Bizagi

2303

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 sapnco y
sapnco_utils 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 2014 - Bizagi

2304

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
available flights from SAP (obtener vuelos disponibles de SAP) para invocar desde all el mtodo en
.Net que termina invocando la funcin BAPI wrapper BAPI_FLIGHT_GETLIST.
La otra expresin se configura en la tarea de servicio Book flight in SAP (reservar vuelo en SAP) para
terminar invocando la funcin BAPI wrapper BAPI_FLBOOKING_CREATEFROMDATA.
La creacin de la expresin se realiza desde el paso cuatro del Asistente de Proceso: Acciones de la
Actividad.

Para ilustrar esto, la accin de actividad en la salida de la tarea Book flight in SAP se muestra a
continuacin:

Copyright 2014 - Bizagi

2305

El mdulo expresin create booking contiene el siguiente cdigo que se utiliza para invocar el mtodo
de .Net (de nuestra clase de punto de entrada SAPController.cs):

Copyright 2014 - Bizagi

2306

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.Na
me>,
<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 d clic en Ejecutar para abrir el Portal de Trabajo:

Copyright 2014 - Bizagi

2307

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 2014 - Bizagi

2308

Cmo iniciar Procesos en Bizagi desde otras aplicaciones

Introduccin
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.
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 createCasesAsString 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 Edicin Enterprise. NET).
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 createCasesAsString, o createCases disponibles para Bizagi .NET, se

Copyright 2014 - Bizagi

2309

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.
Para ver ms detalles sobre la estructura de entrada y salida de createCasesAsString consulte
createCasesAsString.

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.

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 VacationRequest.

Copyright 2014 - Bizagi

2310

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>
<Process>VacationRequest</Process>
<Entities>
<VacationRequest>
<VacationStartingDate>2012-03-18T12:00:00-05:00</
VacationStartingDate>
<VacationEndingDate>2012-03-26T12:00:00-05:00</
VacationEndingDate>

Copyright 2014 - Bizagi

2311

<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>
</Entities>
</Case>
<Case>
<Process>VacationRequest</Process>
<Entities>
<VacationRequest>
<VacationStartingDate>2011-12-16T12:00:00-05:00</

Copyright 2014 - Bizagi

2312

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
createCasesAsString 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.

Copyright 2014 - Bizagi

2313

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);
//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

Copyright 2014 - Bizagi

2314

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 Register Vacation Request:

Cmo realizar Actividades Bizagi desde otras aplicaciones

Introduccin
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.

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 performActivityAsString, 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 la Edicin Enterprise. NET).
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 performActivityAsString,o performActivity disponibles para Bizagi .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.

Copyright 2014 - Bizagi

2315

Vea mayor informacin sobre la especificacin del mtodo web performActivityAsString.

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 Register Vacation Leave Request 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 VacationRequest.

Copyright 2014 - Bizagi

2316

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.

Copyright 2014 - Bizagi

2317

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 2014 - Bizagi

2318

<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
performActivityAsString o performActivity.

Copyright 2014 - Bizagi

2319

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>";

Copyright 2014 - Bizagi

2320

sXml += "<VacationEndingDate>" + sSEndingDate + "</


VacationEndingDate>";
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 (Register Vacation Request) al siguiente.
La siguiente actividad es Approve Vacation Request que mostrar la informacin enviada:

Copyright 2014 - Bizagi

2321

Cmo integrar Bizagi con Joomla!

Introduccin
En esta seccin 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 2014 - Bizagi

2322

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.

Copyright 2014 - Bizagi

2323

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 Default.php es como se muestra a continuacin:

Copyright 2014 - Bizagi

2324

Copyright 2014 - Bizagi

2325

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 ContactUsRequest, y el modelo de datos para este proceso tiene como
Entidad de Proceso una entidad llamada ContactUsRequest.
2. La entidad ContactUsRequest tiene principalmente estos atributos:
- ContactName (tipo texto)
- EmailAddress (tipo texto)
- Message (tipo texto)
- TelephoneNumber (tipo texto)

Copyright 2014 - Bizagi

2326

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: ContactName, EmailAddress, Message y TelephoneNumber se incluyen con
la propiedad de Editable en falso.

Copyright 2014 - Bizagi

2327

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 ContactUsApplication, y se instruyen su paso a paso
a continuacin.

1. Cree un nuevo proyecto en Visual Studio y seleccione ASP. NET Web Application para este tipo de
proyecto.

Copyright 2014 - Bizagi

2328

Para la aplicacin ContactUsApplication, se requiere una referencia web (web reference) en el proyecto
visual studio de la manera:
http://[su_servidor_Bizagi]/[su_proyecto_Bizagi]/webservices/workflowenginesoa.asmx
2. Cree entonces la referencia web correspondiente a los servicios web publicados por su proyecto
Bizagi.

Copyright 2014 - Bizagi

2329

Note

Copyright 2014 - Bizagi

2330

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 ContactUsApplication bajo el mtodo get de HTML. Por lo tanto, se requiere la
recuperacin de estos parmetros en el Default.aspx.cs, en su mtodo "Page_Load".
El archivo Default.aspx.cs debe quedar como se muestra a continuacin:

La invocacin del servicio web se realiza en una clase diferente, llamada WSController.cs.
Para crear la clase WSController, se debe agregar un nuevo elemento (add New Item) al proyecto tal
como se muestra:

Copyright 2014 - Bizagi

2331

Copyright 2014 - Bizagi

2332

El archivo WSController.cs debe quedar como se muestra a continuacin:

Copyright 2014 - Bizagi

2333

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 2014 - Bizagi

2334

desde el enlace (como http://[your_Bizagi_server]/[your_iis_application]/Default.aspx).


Para hacerlo, copie primero la carpeta del proyecto en Visual Studio en la carpeta C:\inetpub\wwwroot
\ de su servidor IIS.
Seguidamente, abra el administrador de IIS desde el comando Ejecutar como se muestra a
continuacin:

D 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.

Copyright 2014 - Bizagi

2335

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:
http:[su_servidor]:[puerto_apache]/Joomla_1.5.22-Stable-Full_Package/index.php?
option=com_contactus

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 Ejecutar:

Podemos ver la actividad pendiente en Bizagi, creada con Joomla!

Copyright 2014 - Bizagi

2336

Cmo ejecutar procedimientos almacenados desde Bizagi

Introduccin
En esta seccin 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:

Copyright 2014 - Bizagi

2337

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 2014 - Bizagi

2338

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 Personal Loan Request que tiene un subproceso llamado
Applicant Analysis que trabaja de la siguiente manera:
En este subproceso de Anlisis de Solicitantes, se realiza una tarea automtica de Importar Productos
Previos (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 Calcular la capacidad de pago (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:

Copyright 2014 - Bizagi

2339

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 Library 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 Oracle.DataAccess.

Copyright 2014 - Bizagi

2340

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: Controller.cs y


ImplementationProvider.cs.
ImplementationProvider.cs administra la conexin y los mtodos para ejecutar los procedimientos
almacenados.
Su cdigo es:

Copyright 2014 - Bizagi

2341

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 2014 - Bizagi

2342

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)
{

Copyright 2014 - Bizagi

2343

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.OracleParame
ter)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 Controller.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 2014 - Bizagi

2344

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,

Copyright 2014 - Bizagi

2345

Convert.ToInt32(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 Controller.cs se llama SPProvider.
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 Oracle.DataAccess.

Finalmente, hacemos build al proyecto y producimos nuestra salida que es el assmebly SPProvider.dll.
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 SPProvider, agregndolo
a travs de la funcionalidad de la Libreria de Componentes:

Copyright 2014 - Bizagi

2346

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 Namespace que corresponde al que definimos en el proyecto de Visual
Studio, como se seal en nuestro paso anterior (el Namespace de nuestro ejemplo es SPProvider).

Al final, nuestra Librera de Componentes registradas tendr:

Copyright 2014 - Bizagi

2347

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 getPreviousProducts, y se define en la tarea automtica Importar productos
previos (Import Previous Products) en la accin de actividad al Salir de la actividad.
La segunda regla se llama calculatePaymentCapacity, y se define en la tarea automtica Calcular
capacidad de pago (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 Acciones de la Actividad.

Copyright 2014 - Bizagi

2348

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 getPreviousProducts se define as:

Copyright 2014 - Bizagi

2349

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.newCollectionItem("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
Applicant's Products en una tabla.
Finalmente, nuestra regla calculatePaymentCapacity se define as:

Copyright 2014 - Bizagi

2350

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 PaymentCapacity (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!

Copyright 2014 - Bizagi

2351

Ejecucin
Para ver el ejemplo d clic en Ejecutar para abrir el Portal de Trabajo:

Al oprimir Siguiente en la actividad Include Initial Information, Bizagi ejecutar los procedimientos
almacenados y actualizar la informacin de respuesta.

Copyright 2014 - Bizagi

2352

Temas de inters general


Consulte las siguientes secciones para ver algunos ejemplos acerca de algunas facilidades que provee
Bizagi.

Cmo crear un backup de la base de datos de Bizagi

Introduccin
Cuando se trabaja con Bizagi Studio para automatizar los procesos, la base de datos del proyecto
almacena la informacin relevante a estos procesos y su implementacin (Bizagi siendo orientada al
modelo).
Lo que no es almacenado directamente sobre la base de datos son los documentos adjuntos al
proceso, que se almacenan en un servidor de archivos, o en un sistema ECM integrado a la solucin.
Por lo tanto usted podr crear un backup de la base de datos de su proyecto Bizagi para los
siguientes propsitos:
1. Como medida de contingencia, para contar con una imagen (snapshot) de su proyecto en cierto
estado.
Esta opcin es til y recomendada antes de llevar a cabo cambios significativos sobre su proyecto,
como por ejemplo una actualizacin de versin; escenarios en los cuales es til tener la posibilidad de
restaurar su proyecto a un estado previo.
2. Para recibir asistencia del equipo de soporte de Bizagi, dado que se podra entregar este medio
para realizar un diagnstico especfico (depuracin) a un inconveniente.
Esto posibilita un seguimiento ms eficiente a los issues que pueda tener en su proyecto.
3. Para poder fcilmente mover un proyecto de un servidor a otro, o hacer un clon del proyecto (aplica
cuando el proyecto se encuentra an en fases de automatizacin).
Mover un proyecto considera la posibilidad de configurar la arquitectura para trabajo colaborativo,
conservando el progreso de un proyecto que ha sido previamente trabajado en otro equipo,

Copyright 2014 - Bizagi

2353

localmente.

Este enfoque no debe usarse bajo ninguna circumstancia para otro fin diferente a los especificados
anteriormente.
Para publicar los procesos a un ambiente productivo, utilice el Deployment de Bizagi que le permite
manejar los ambientes de pruebas y produccin.
Bizagi ofrece un Deployment para publicar los procesos y aplicar los cambios de manera que se
manejen deployments incrementales (soporatando la mejora contnua y nuevas versiones de
proceso).

Para crear un backup de la base de datos de su proyecto Bizagi, consulte los siguientes enlaces:
Si su proyecto utiliza SQL Server, consulte Crear backup en SQL Server.
Si su proyecto utiliza Oracle, consulte Crear backup en Oracle.

Crear backups en SQL Server

Introduccin
Para crear un backup de una base de datos SQL Server para un proyecto de Bizagi, siga estos pasos.
Para informacin sobre los usos de este backup y detalles sobre la informacin que ste almacena,
consulte Cmo crear un backup de la base de datos de su proyecto Bizagi.

Prerrequisitos
Para los siguientes pasos, necesitar la herramienta SQL Server Management Studio.
Tenga en cuenta que esta herramienta las puede incluir al instalar la base de datos SQL Server.
En caso de que en la instalacin de su base de datos no haya incluido esta herramienta, tambien
puede instalarla y descargarla separadamente desde las pginas oficiales de Microsoft (sin costo).

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.

Copyright 2014 - Bizagi

2354

2. Ubique la Base de datos y d clic derecho sobre sta. Seleccione la opcin Backup... desde las
tareas:

Copyright 2014 - Bizagi

2355

3. Especifique que el backup se realice completo (modo FULL).

Copyright 2014 - Bizagi

2356

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 2014 - Bizagi

2357

4. Haga clic en OK cuando la operacin se haya completado:

Copyright 2014 - Bizagi

2358

El archivo .bak final tendr la informacin del backup.


Podr comprimir este archivo .bak a un .zip para reducir su tamao.
Para ver cmo restaurar este archivo .bak de vuelta, consulte Restaurar backups en SQL Server.

Crear backups en Oracle

Introduccin
Para crear un backup de una base de datos Oracle para un proyecto de Bizagi, siga estos pasos.
Para informacin sobre los usos de este backup y detalles sobre la informacin que ste almacena,
consulte Cmo crear un backup de la base de datos de su proyecto Bizagi.

Prerrequisitos

Copyright 2014 - Bizagi

2359

Cuando se usa una base de datos Oracle, las tareas de crear backups y restaurarlos, se realizan a
travs (y se mencionan como) de los utilitarios de Oracle de Import y Export.
Para usar los utilitarios Export o Import en Oracle, se requiere:
1. La misma versin del cliente para el export e import
Se requiere que la versin del cliente usado para el export sea igual a la versin instalada del cliente
usada para el import.
2. Sets de caracteres compatibles
Debe asegurarse que los sets de caracteres configurados en los clientes usados, sean los mismos o
que sean compatibles.
Esto es un requisito directamente el Export e Import de Oracle para mantener la integridad de la
informacin.
3. Configuracin del home de Oracle.
Si usted tiene una nica variable Oracle home, puede omitir este prerequisito.
Por otro lado si tiene ms de un cliente Oracle instalado desde donde se va a ejecutar el Export o
Import, deber asegurrse de que la variable de entorno ORACLE_HOME est definida adecuadamente
para apuntar al cliente de Oracle que utiliza Bizagi.

Recomendaciones
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).

Ejecutar el Export de DataPump (expdp)


Ilustraremos cmo utilizar el utilitario Export de DataPump 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. Consulte el directorio de backups
Para utilizar el Export de DataPump, necesitar especificar el directorio donde podr almacenar el
archivo dmp del backup.
Para hacerlo, primero conctese a su instancia de Oracle con el usuario BizagiAdmon a travs de

Copyright 2014 - Bizagi

2360

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.

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).

Si desea usar otro directorio y crearlo manualmente puede hacerlo mediante el comando a
continuacin:

Copyright 2014 - Bizagi

2361

Luego de tener a la mano el nombre del directorio que va a utilizar, desconctese de la sesin
BizagiAdmon en la instancia.
2. Abra una consola de comandos
Vaya a Inicio de Windows, y ejecute una consola de comandos DOS:

Copyright 2014 - Bizagi

2362

Seguidamente, navegue hacie la ruta del cliente de Oracle, y dentro de la carpeta bin:

3. Ejecute el Export de DataPump


Para ejecutar el Export tenga en cuenta que debe usar parmetros.
Para ello, ingrese la siguiente lnea:
expdp USERID=BizAgiAdmon/%SCHEMA_USER_PASSWORD% SCHEMAS=%

Copyright 2014 - Bizagi

2363

SCHEMA_USER_TO_EXPORT% DIRECTORY=%BIZAGI_BACKUP_PATH% DUMPFILE=%EXPORT_FILE


% LOGFILE=%EXPORT_LOG%
En el comando anterior, considere:
%SCHEMA_USER_PASSWORD% es la contrasea de este esquema de usuario con privilegios system
(BizAgiAdmon).
%SCHEMA_USER_TO_EXPORT% es el nombre del proyecto en Bizagi.
%BIZAGI_BACKUP_PATH% debe corresponder a "BizAgiBackupPath" por defecto, de acuerdo a lo
mencionado en el paso #1 (este parmtero define la ubicacin del backup).
%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.

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.

4. 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%".

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 prerrequisitos, 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.
El archivo .dmp final tendr la informacin del backup.
Podr comprimir este archivo .dmp a un .zip para reducir su tamao.
Para ver cmo restaurar este archivo .dmp de vuelta, consulte Restaurar backups en Oracle.

Cmo restaurar un backup de la base de datos de Bizagi

Overview
Cuando se trabaja con Bizagi Studio para automatizar los procesos, la base de datos del proyecto
almacena la informacin relevante a estos procesos y su implementacin (Bizagi siendo orientada al
modelo).
Lo que no es almacenado directamente sobre la base de datos son los documentos adjuntos al

Copyright 2014 - Bizagi

2364

proceso, que se almacenan en un servidor de archivos, o en un sistema ECM integrado a la solucin.


Por lo tanto usted podr restaurar un backup de la base de datos de su proyecto Bizagi para restaurar
el proyecto a un estado previo.
Para ms informacin sobre los usos de un backup de la base de datos con Bizagi, consulte Cmo
crear un backup de la base de datos de Bizagi.

Este enfoque no debe usarse bajo ninguna circumstancia para otro fin diferente a los especificados
en el enlace.
Para publicar los procesos a un ambiente productivo, utilice el Deployment de Bizagi que le permite
manejar los ambientes de pruebas y produccin.
Bizagi ofrece un Deployment para publicar los procesos y aplicar los cambios de manera que se
manejen deployments incrementales (soporatando la mejora contnua y nuevas versiones de
proceso).
Para restaurar un backup de la base de datos de su proyecto Bizagi, consulte los siguientes enlaces:
Si su proyecto utiliza SQL Server, consulte Restaurar un backup en SQL Server.
Si su proyecto utiliza Oracle, consulte Restaurar un backup en Oracle.

Restaurar backups en SQL Server

Introduccin
Para restaurar un backup de una base de datos SQL Server para un proyecto de Bizagi, siga estos
pasos.
Para informacin sobre los usos de este backup y detalles sobre la informacin que ste almacena,
consulte Cmo restaurar un backup de la base de datos de su proyecto Bizagi.

Prerrequisitos
Para los siguientes pasos, necesitar la herramienta SQL Server Management Studio.
Tenga en cuenta que esta herramienta las puede incluir al instalar la base de datos SQL Server.
En caso de que en la instalacin de su base de datos no haya incluido esta herramienta, tambien
puede instalarla y descargarla separadamente desde las pginas oficiales de Microsoft (sin costo).

Antes de comenzar
Para restaurar un backup se debe considerar:
1. Correspondencia en la intercalacin (collation).
Asegrse de que la instancia de SQL Server sobre la cul va a restaurar un backup, tenga la misma
configuracin de intercalacin de la instancia SQL Server de orgen sobre la cul se extrajo el backup.
Para revisar la intercalacin de su instancia SQL Server, puede hacer clic derecho sobre la instancia y
acceder a sus propiedades:

Copyright 2014 - Bizagi

2365

2. No tener conexiones activas.


Para completar una restauracin, SQL Server requieres que no existan conexiones activas en el
momento.
Se recomienda explcitamente que este tipo de tareas se coordine con otros miembros del equipo de
manera que el equipo conozca que se va a restaurar la base de datos de un proyecto, y que por
ejemplo, no est el proyecto en uso.
Si usted est ejecutando sus procesos sobre una plataforma de .NET, tenga en cuenta que es muy
probable que el servicio de Bizagi llamado Scheduler, est iniciado y con una conexin a la base de
datos.
Para detener este servicio, y cerrar esa conexin, utilice el panel de servicios de Windows.
Si usted est ejecutando sus procesos sobre una plataforma de JEE, entonces al detener el servicio de
JBoss, se detendr tambin el servicio Scheduler.

Restaurar un Backup
Restaure un backup .bak con los siguientes pasos:
1. Autentquese en su instancia de SQL Server (login) a travs de SQL Server Management Studio.

Copyright 2014 - Bizagi

2366

2. Ubique la Base de datos y d clic derecho sobre sta. Seleccione la opcin de Restaurar -> Base de
datos:

Copyright 2014 - Bizagi

2367

3. Especifique que la Base de datos ser restaurada desde un dispositivo.


Navegue hasta seleccionar el archivo .bak de origen:

Copyright 2014 - Bizagi

2368

Copyright 2014 - Bizagi

2369

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 Restaurar:

Copyright 2014 - Bizagi

2370

5. Vaya al tab de Opciones, y marque la opcin de Sobrescritura (Overwrite the existing database).

Copyright 2014 - Bizagi

2371

Asegrese de seleccionar el destino de los archivos usados por la Base de datos (.dat y .log).

Copyright 2014 - Bizagi

2372

Ntese que estos archivos se ubican por defecto en la siguiente ruta:


"C:\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 OK cuando la operacin de restauracin se haya completado.

Copyright 2014 - Bizagi

2373

Importante
Despus de restaurar un backup en un proyecto de Bizagi, se debe refrescar la memoria cach del
servidor Web.
Si su proyecto se ejecuta en una plataforma .NET, esto se logra ejecutando un IISReset, y reiniciando
el servicio Scheduler.
Si su proyecto se ejecuta en una plataforma JEE, entonces al re-iniciar el Servidor de aplicaciones
JEE, se iniciar automticamente el servicio Scheduler.

Copyright 2014 - Bizagi

2374

Restaurar backups en Oracle

Introduccin
Para restaurar un backup de una base de datos Oracle para un proyecto de Bizagi, siga estos pasos.
Para informacin sobre los usos de este backup y detalles sobre la informacin que ste almacena,
consulte Cmo restaurar un backup de la base de datos de su proyecto Bizagi.

Prerrequisitos
Cuando se usa una base de datos Oracle, las tareas de crear backups y restaurarlos, se realizan a
travs (y se mencionan como) de los utilitarios de Oracle de Import y Export.
Para usar los utilitarios Export o Import en Oracle, se requiere:
1. La misma versin del cliente para el export e import
Se requiere que la versin del cliente usado para el export sea igual a la versin instalada del cliente
usada para el import.
2. Sets de caracteres compatibles
Debe asegurarse que los sets de caracteres configurados en los clientes usados, sean los mismos o
que sean compatibles.
Esto es un requisito directamente el Export e Import de Oracle para mantener la integridad de la
informacin.
3. Configuracin del home de Oracle.
Si usted tiene una nica variable Oracle home, puede omitir este prerequisito.
Por otro lado si tiene ms de un cliente Oracle instalado desde donde se va a ejecutar el Export o
Import, deber asegurrse de que la variable de entorno ORACLE_HOME est definida adecuadamente
para apuntar al cliente de Oracle que utiliza Bizagi.

Recomendaciones
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).

Ejecutar el Import de DataPump (impdp)


Copyright 2014 - Bizagi

2375

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 prerrequisito de configuracin de la
instancia).

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.

Deber ser cauteloso al momento de garantizar que no hayan conexiones abiertas. Esto quiere decir
que podr verificar que conexiones abiertas hay con BizagiAdmon, mediante el comando:
SELECT s.sid, s.serial#, s.username FROM
gv$session s
JOIN gv$process p ON p.addr = s.paddr AND p.inst_id = s.inst_id
WHERE s.type != 'BACKGROUND' and s.username = '[su_esquema]'
As como tambin podr cerrarlas forzosamente (con el comando siguiente) pero bajo su
responsabilidad y con el control sobre qu sesiones se estn cerrando, y con previa validacin de
que no hayan usuarios trabajando en ese esquema de usuario o proyecto de Bizagi.
ALTER SYSTEM DISCONNECT SESSION '[sid],[serial#]' IMMEDIATE;
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%:%

Copyright 2014 - Bizagi

2376

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.

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%');

Copyright 2014 - Bizagi

2377

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).

Si desea usar otro directorio y crearlo manualmente puede hacerlo mediante el comando a
continuacin:

Copyright 2014 - Bizagi

2378

Luego de tener a la mano el nombre del directorio que va a utilizar, desconctese de la sesin
BizagiAdmon en la instancia.

5. Abra una consola de comandos


Vaya a Inicio de Windows, y ejecute una consola de comandos DOS:

Copyright 2014 - Bizagi

2379

Seguidamente, navegue hacia la ruta del cliente de Oracle, y dentro de la carpeta bin:

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 2014 - Bizagi

2380

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.

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.

El log quedar segn la definicin de "%IMPORT_LOG%".

Copyright 2014 - Bizagi

2381

El Import debe finalizar notificando que no hubo advertencias si quiera, y que se han habilitado los
constraints de Bizagi.

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 prerrequisitos, 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 check metadata:

Cmo mover o clonar un proyecto Bizagi

Introduccin
Cuando se trabaja con Bizagi Studio para automatizar los procesos, la base de datos del proyecto
almacena la informacin relevante a estos procesos y su implementacin (Bizagi siendo orientada al

Copyright 2014 - Bizagi

2382

modelo).
Lo que no es almacenado directamente sobre la base de datos son los documentos adjuntos al
proceso, que se almacenan en un servidor de archivos, o en un sistema ECM integrado a la solucin.
Por lo tanto con Bizagi, podr fcilmente:
Mover un proyecto desde un servidor a otro.
Mover un proyecto considera la posibilidad de configurar la arquitectura para trabajo colaborativo,
conservando el progreso de un proyecto que ha sido previamente trabajado en otro equipo,
localmente.
Clonar un proyecto para reutilizar la implementacin existente en un otro nuevo (como una plantilla
de punto de inicio).
Esta posibilidad de reutilizacin es solamente posible si el proyecto no ha tenido deployments previos
(cuando todava no ha habido una publicacin de los procesos al ambiente de pruebas o produccin).
Estas opciones de mover o clonar el proyecto aplican para proyectos en las etapas de automatizacin
(en etapas de desarrollo).
Para mover el proyecto en un ambiente productivo, Bizagi ofrece otras opciones desde el Bizagi
Management Console.

Este enfoque no debe usarse bajo ninguna circumstancia para publicar los procesos a un ambiente
productivo. Para este fin, utilice el Deployment de Bizagi que le permite manejar los ambientes de
pruebas y produccin.
Bizagi ofrece un Deployment para publicar los procesos y aplicar los cambios de manera que se
manejen deployments incrementales (soporatando la mejora contnua y nuevas versiones de
proceso).

Procedimiento
Copie un proyecto entero de Bizagi Studio hacia uno nuevo, realizando los siguientes pasos:

1. Crear un backup de la Base de datos.


Para ms informacin sobre este paso, consulte Cmo crear un backup de la base de datos de Bizagi.

2. Crear el nuevo proyecto de Bizagi.


Para ms informacin sobre este paso, consulte Crear un proyecto nuevo.

3. Restaurar el backup en la Base de datos del proyecto nuevo.


Para ms informacin sobre este paso, consulte Cmo restaurar un backup de la base de datos de
Bizagi.
Al finalizar, tendr un proyecto nuevo que reutiliza los procesos y su implementacin, ya almacenados
en una base de datos paralela, y que utiliza un Portal de trabajo y un servicio Scheduler aparte.
Si usted no desea clonar el proyecto sino moverlo, entonces la nica diferencia es que al final, podr
eliminar el proyecto original para dejar de utilizarlo.

Copyright 2014 - Bizagi

2383

Cmo cambiar la ubicacin de su proyecto Bizagi

Introduccin
Por defecto, los proyectos de Bizagi se crean en la ruta de proyectos: C:\Bizagi\..\Projects\.
En esta ruta es almacenada y referenciada la informacin relacionada con el proceso, el modelo de
datos, formas, reglas, actores e integraciones.
Cuando se requiere cambiar la ubicacin de su proyecto en el ambiente de desarrollo (mientras se
est en fases de automatizacin del proyecto), siga los pasos donde se contempla mover archivos y
actualizar su referenciacin.

Lo que debe hacerse


Para cambiar la ubicacin de su proyecto, considere los siguientes pasos:
1.
2.
3.
4.

Mover la carpeta del proyecto.


Actualizar las referencias a la base de datos.
Re-configurar el Portal de trabajo.
Re-configurar el Bizagi Studio.

Procedimiento
Como ejemplo, usaremos el proceso creado en Mi Primer proceso, para mostrar cmo cambiar la
ubicacin de un proyecto.

1. Mover la carpeta del proyecto


El primer paso es mover la ubicacin fsica del proyecto, para esto, se necesita desinstalar el servicio
del Programador que tiene una referencia explcita a esta ruta.
Para esto, siga estos pasos:
1.1 Inicie una consola del sistema con privilegios de administrador.
1.2 Dirjase a la ruta %SystemDrive%\Bizagi\Projects\[SuProyecto]\Scheduler y ejecute
BizAgi_YourProject_Scheduler_Service_UnInstall.bat

Copyright 2014 - Bizagi

2384

1.3 Copie la carpeta completa (manteniendo su estructura interna) de su proyecto (localizada en la


ruta %SystemDrive%\Bizagi\Projects\) y pguela en la nueva ubicacin.
En nuestro ejemplo, esta ruta ser E:\BizagiProjects\ y ser referenciada como [NEW_PATH] desde
este momento.
Recuerde tener privilegios de administrador para completar esta accin.

Copyright 2014 - Bizagi

2385

Si est usando SQL Server y los archivos de la base de datos estn almacenados en .\Database\,
necesitar detener temporalmente los servicios de la base de datos.

Es una buena practica crear backups de su proyecto como medida de contingencia (para poder
realizar rollback si el procedimiento falla).
1.4 Una vez haya movido la carpeta completa, puede reinstalar el servicio de Programador.
Para esto, abra el smbolo del sistema y en: [NEW_PATH]\[SuProyecto]\Scheduler, ejecute
BizAgi_YourProject_Scheduler_Service_Install.bat

Copyright 2014 - Bizagi

2386

2. Actualizar las referencias de la Base de Datos


Este paso solo es obligatorio si usa una base de datos de Microsoft SQL Server o si dentro de la
carpeta .\Database\ dentro de la ubicacin del proyecto, contiene los siguientes archivos de la base de
datos: [SuProyecto_dat].mdf y [SuProyecto_log].ldf .
Si usa Oracle o o los archivos de la base de datos no se encuentran en esta ruta, ignore este paso y
contine con el Paso 3.

Copyright 2014 - Bizagi

2387

2.1 Ejecute el siguiente script para dejar la Base de datos fuera de lnea (esto se puede realizar usando
la Consola de Microsoft SQL Server Management):
Use [master]
GO
Alter Database SuProyecto Set Offline

2.2 Ejecute el siguiente script para referenciar los archivos de la base de datos a su nueva ubicacin:
Alter Database SuProyecto
Modify File (
Name='SuProyecto_dat'
,FILENAME='[NEW_PATH]\SuProyecto\Database\SuProyecto_dat.mdf'
);
Alter Database SuProyecto
Modify File (
Name='SuProyecto_log'
,FILENAME='[NEW_PATH]\SuProyecto\Database\SuProyecto_log.ldf'
);

Copyright 2014 - Bizagi

2388

2.3 Vuelva a dejar en lnea la base de datos usando el siguiente query.


Use [master]
GO
Alter Database SuProyecto Set Online

Usted puede verificar que los archivos de la base de datos estn referenciados correctamente en su
respectiva ruta, ejecutando:
USE SuProyecto
GO
Select name, physical_name, state_desc
From SuProyecto.sys.master_files
Where database_id = DB_ID(N'SuProyecto');

Copyright 2014 - Bizagi

2389

3. Re-configurar el Portal de Trabajo


Vuelva a configurar el Portal de trabajo usando el Administrador del Internet Information Services.
Para hacer esto, puede usar la opcin Ejecutar y escriba:
inetmgr

3.1 Expanda el rbol localizado en el panel izquierdo del sitio web de su proyecto.
Haga clic en la opcin Configuracin Avanzada... (clic derecho en el sitio web de su proyecto y
encontrar esta opcin dentro de Administrar Aplicacin):

Copyright 2014 - Bizagi

2390

Tenga en cuenta que esta opcin tambin se encuentra en el panel derecho, una vez se ha
seleccionado el sitio web del proyecto:

3.2 En la configuracin avanzada, actualice el valor de Ruta Fsica para que apunte a [NEW_PATH]
\YourProject\WebApplication.
Haga clic en OK para guardar los cambios.

Copyright 2014 - Bizagi

2391

3.3 Reinicie el servicio de IIS.


Una vez se ha re-configurado, reinicie el IIS y sus servicios ya sea desde las opciones del
Administrador del IIS o abriendo el smbolo del sistema (con privilegios de administrador) y
ejecutando:
iisreset

Copyright 2014 - Bizagi

2392

4. Re-configurar el Bizagi Studio


Localice el proyecto desde su nueva ubicacin, asegrese de hacer lo siguiente:

Estos pasos aplican tambin para la configuracin de Bizagi Management Console.


4.1 Actualice el archivo de configuracin de los proyectos, ubicado en %SystemDrive%\ProgramData
\Bizagi\BizAgiProjects.xml.
Tenga en cuenta que la carpeta SystemDrive puede estar oculta (por defecto) en su sistema operativo
(para mostrarla, asegrese de habilitar la opcin "Mostrar archivos ocultos").
Bsque la ubicacin antigua del proyecto(%SystemDrive%\Bizagi\Projects\) y reemplcela con
[NEW_PATH].

Copyright 2014 - Bizagi

2393

4.2 Finalmente, reinicie el servicio llamado Bizagi Server Operations service para que el Bizagi Studio o
la Consola de Administracin tomen los cambios apropiadamente.
Esto se puede realizar a travs de la ventana de los servicios de Windows, ubicando el servicio y
seleccionando la opcin de Iniciar o Reiniciar:

Copyright 2014 - Bizagi

2394

Importante
Se recomienda siempre probar y verificar que el proyecto se comporta como se espera.
Una vez se ha movido el proyecto, compruebe la ejecucin del Portal de trabajo, el servicio del
Programador y todas las dems caractersticas involucradas como la Librera de Componentes,
localizacin o trazas.
Si necesita mover su servidor de produccin o las rutas del proyecto en produccin, consulte la
seccin de Administracin del sistema de Bizagi Engine.

Copyright 2014 - Bizagi

2395

Parte III
Bizagi Engine

Bizagi Engine

Complete su viaje BPM con Bizagi Engine. Esta poderosa aplicacin ejecuta sus procesos y los entrega
a los equipos de escritorio y mviles de todos los usuarios de negocio. Flexible para adaptarse a sus
necesidades, Bizagi Engine le permite iniciar progresiva, gil y tcticamente para luego extender sus
capacidades BPM en todos los departamentos, pases y zonas horarias.
Construido para el rendimiento
La Plataforma Bizagi BPM est diseada para las necesidades empresariales ms exigentes, capaz de
manejar proyectos BPM de misin crtica y alto rendimiento que abarcan miles de usuarios y millones
de casos.
Conozca sus objetivos de desempeo organizacional
Visualice sus objetivos de proceso, establezca prioridades y encuentre y corrija cualquier problema.
Mantngase al tanto de lo que realmente importa, todo desde su portal web personalizado.
Integracin con los recursos de TI
Bizagi Engine ofrece un soporte nico para plataformas JEE nativo o .NET, asegurando una integracin
perfecta y eficaz con sus inversiones de TI existentes.
Desempeo "Por encima de todo"
La Tecnologa de clustering de Bizagi permite que sus procesos continen funcionando normalmente,
no importa lo que pase.
Alcance el mejoramiento continuo
Obtenga profundos conocimientos de la organizacin con nuestros reportes predefinidos. Vea quin
est haciendo qu, cundo y dnde con nuestras grficas e intuitivas herramientas de seguimiento y
monitoreo. Bizagi Engine asegura que cada paso en el flujo del proceso se lleva a cabo exactamente
como debera.
Anticpese a los problemas y gestione el riesgo
Desempeos histrico y tendencias de datos estn al alcance de sus dedos. Identifique rpidamente
los cuellos de botella y problemas de recursos, antes de que se conviertan en un problema.
Administre por excepcin

Copyright 2014 - Bizagi

2397

Bizagi Engine levanta alarmas en el momento que haya excepciones a la regla. Acuerdos de Nivel de
Servicio o las cuestiones de incumplimiento son informados a las personas adecuadas en una forma
eficiente.
Bizagi presenta un Portal de Trabajo a los usuarios finales donde el modelo de Proceso, previamente
diseado y construido, es interpretado y ejecutado. El uso del Portal de Trabajo requiere un
navegador (intranet o Internet) y una cuenta registrada.
El Portal de Trabajo es el lugar donde los usuarios pueden acceder a las tareas asignadas o crear
nuevos casos de un Proceso dado, para controlar el procesamiento de los casos de acuerdo al diseo
de la lgica de negocio. Un caso es una instancia del proceso; Cuando un usuario final crea un nuevo
caso, habr creado una instancia del proceso. Todas las instancias son independientes entre ellas.
El Portal de Trabajo, resultado de 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 en tres secciones; Men principal,
rea de casos y rea de trabajo como se muestra en la siguiente imagen.

Para ms informacin visite Portal de Trabajo y sus caractersticas

Bizagi Engine - requerimientos de sistema


Introduccin
Bizagi presenta un portal de trabajo donde los usuarios finales trabajan en sus procesos corporativos.
Para que los usuarios finales accedan al Portal de trabajo, solo requieren de un navegador (sea por
acceso a intranet o Internet) y una cuenta registrada.
Los procesos previamente diseados y automatizados a travs de Bizagi Studio se configuran en, y son

Copyright 2014 - Bizagi

2398

potenciados por Bizagi Engine.

Portal de trabajo multiplataforma


Bizagi Engine soporta la ejecucin de procesos en una plataforma .NET o JEE.
Para ms informacin sobre los requerimientos de sistema para una plataforma .NET, consulte Bizagi
Engine ejecutndose sobre plataforma .NET.
Para ms informacin sobre los requerimientos de sistema para una plataforma JEE, consulte Bizagi
Engine ejecutndose sobre plataforma JEE.

Bizagi Engine ejecutndose sobre plataforma .NET

Bizagi Engine ejecuta sus procesos y los entrega a los dispositivos mviles y laptops de cada usuario
de negocio.
Bizagi Engine soporta una arquitectura de alta disponibilidad o una arquitectura estndar, como se
describe en los requerimientos de sistema a continuacin.
Siga los enlaces para revisar la arquitectura de sistema y sus requerimientos para una plataforma .NET:
Para ver los requerimientos de alta disponibilidad, consulte Alta disponibilidad .NET -requerimientos
de sistema
Para ver los requerimientos estndar, consulte Arquitectura estndar .NET -requerimientos de
sistema.

Alta disponibilidad .NET - requerimientos de sistema

Introduccin
Copyright 2014 - Bizagi

2399

Una arquitectura para alta disponibilidad est diseada para procesos de negocio de misin crtica
que deben estar en funcionamiento todo el tiempo (24/7).
Bizagi soporta una arquitectura para alta disponibilidad para la ejecucin de los procesos en una
plataforma .NET, con requerimientos de sistema que consideran lo siguiente:
Un clster de base de datos, para contar con capacidades de tolerancia a fallos en el servidor de
base de datos.
Un clster para el servidor BPM, para contar con balanceo de cargas.
Un balanceador de cargas, para coordinar las cargas hacia el clster de servidor BPM.

Puede descargar aqu un PDF que contiene casos de estudio de arquitectura de sistema con Bizagi, en
el cul se ilustra la configuracin utilizada por proyectos corporativos a gran escala, que manejan un
significativo volumen de datos.

Importante
Estos requerimientos aplican tanto para un ambiente de produccin como para un ambiente de
pruebas.
Lo anterior, teniendo en cuenta que se recomienda que un ambiente de pruebas se configure lo ms
similar posible a su ambiente de produccin.

Alta disponibilidad -requerimientos de sistema


Los siguientes requerimientos deben tomarse como lo mnimo requerido por el sistema.
Variables adicionales deben ser consideradas en cada proyecto, 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, tambin puede complementar la estimacin de hardware de su proyecto (p.e, para

Copyright 2014 - Bizagi

2400

determinar si necesita nodos adicionales para el clster BPM) usando nuestro Estimador de
dimensionamiento Bizagi.

SERVIDOR DE BASE DE DATOS


2 nodos para la base de datos (clster de tolerancia a fallos). Cada nodo con lo siguiente:

HARDWARE

SOFTWARE

RAM

16 GB

Disco duro

Dos discos de 80 GB - RAID 1

Procesador

De 64 bits.
4 cores
3GHz o superior

Recomendaciones
adicionales

Dos tarjetas de red - Dual port 1GB


Fuente de poder redundante

Motor de base de
datos

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
Oracle Database 10g R2

SERVIDOR BPM
2 nodos para el servidor BPM (clster de balanceo de cargas). Cada nodo con lo siguiente:

HARDWARE

RAM

16 GB

Disco duro

Dos discos de 80 GB - RAID 1

Procesador

De 64 bits.
4 cores
3GHz o superior

Recomendaciones
adicionales

Dos tarjetas de red - Dual port 1GB


Fuente de poder redundante

Sistema operativo

Windows
Windows
Windows
Windows

Servidor web

IIS
IIS
IIS
IIS
IIS

SOFTWARE

Server
Server
Server
Server

2012 (recomendado)
2008 R2
2008
2003 SP1 - 32 bits

8.5
8.0
7.5
7.0
6.0

Copyright 2014 - Bizagi

2401

SERVIDOR BPM

Componentes
adicionales

Bizagi Engine, que instala el framework de .NET


4.0 full (y este framework de .NET incluye otros
componentes necesarios como Visual C++ 2010,
2008 Redistribuble).
Oracle Data Provider para .NET (aplica para
proyectos que utilicen una base de datos Oracle).

BALANCEADOR DE CARGAS
Para el balanceo de cargas, Bizagi soporta tanto balanceadores en hardware o software (Bizagi no
provee como tal el balanceador de cargas).
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).

USUARIOS FINALES
HARDWARE
PARA EQUIPOS

HARDWARE
PARA MVILES

Resolucin de
pantalla

1024 x 768 o superior

Dispositivos

iOS 6 (iPad, iPhone)


Smartphones y tabletas Android (versin de Android 4.0
o superior)
Windows 8 tablet

Navegador

Internet Explorer 9 o superior (versin recomendada: IE


10).
Chrome 24 o superior (recomendado utilizar Chrome):
Safari 5 o superior
Firefox 19 o superior

SOFTWARE
Componentes
adicionales

Microsoft Silverlight, que se instala por los mismos


navegadores.
Utilizado para las consultas grficas.

No se soportan sistema operativos o configuracin de mquina en idioma turco.


Los equipos y servidores de los requerimientos mencionados, debern tener una configuracin
regional que no utilice idioma o cultura de Turqua (tr, tr-TR).

Copyright 2014 - Bizagi

2402

Importante
Para proyectos configurados sobre mquinas virtuales (p.e sobre VMWare, o servicios de plataforma e
infraestructura en la nube, como Azure, Amazon WS, etc), es muy importante asegurarse de tener un
host con muy buena velocidad de disco (tener especificacin de RPM alta).

Opcin de acceso por Internet


En proyectos donde se requiera habilitar a los usuarios finales para que trabajen en los procesos va
Internet desde cualquier dispositivo,
un servidor opcional se puede considerar para proveer las funciones de un proxy inverso.
El proxy inverso se configura en la DMZ y dichas funciones pueden establecerse desde una instancia
del servidor Apache HTTP, de manera que se permita el acceso a los procesos Bizagi mientras se
mantiene la seguridad de la infraestructura del servidor BPM.

Los requerimientos para esta opcin donde se considera un servidor Apache HTTP incluyen:

SERVIDOR PROXY
Disco duro
HARDWARE

SOFTWARE

1 GB

Recomendaciones
adicionales

Dos tarjetas de red - Dual port 1GB


Fuente de poder redundante

Apache HTTP Server.


Los requisitos para configurar una instancia de
Funcionalidad de proxy
Apache HTTP Server se pueden revisar en la pgina
inverso
oficial del proyecto Apache HTTP, de acuerdo a la
versin y plataforma especfica.

Copyright 2014 - Bizagi

2403

Arquitectura estndar .NET - requerimientos de sistema

Introduccin
Una arquitectura estndar est diseada para procesos de negocio que no necesiten estar
estrictamente bajo un esquema de alta disponibilidad.
Bizagi soporta una arquitectura estndar para la ejecucin de los procesos en una plataforma .NET,
con requerimientos de sistema que consideran lo siguiente:
Un solo nodo de servidor de base de datos, donde no se incluyan capacidades de tolerancia a
fallos.
Un solo nodo de servidor BPM, donde no se incluyan capacidades de balanceo de carga.

Puede descargar aqu un PDF que contiene casos de estudio de arquitectura de sistema con Bizagi, en
el cul se ilustra la configuracin utilizada por proyectos corporativos a gran escala, que manejan un
significativo volumen de datos.
Si considera que su solucin debe contemplar medidas de tolerancia a fallos o balanceo de cargas
para un esquema de alta disponibilidad, consulte la arquitectura descrita en Alta disponibilidad .NET requerimientos de sistema.

Importante
Estos requerimientos aplican tanto para un ambiente de produccin como para un ambiente de
pruebas.
Lo anterior, teniendo en cuenta que se recomienda que un ambiente de pruebas se configure lo ms
similar posible a su ambiente de produccin.

Copyright 2014 - Bizagi

2404

Arquitectura estndar - requerimientos de sistema


Los siguientes requerimientos deben tomarse como lo mnimo requerido por el sistema.
Se deben considerar Variables adicionales en cada proyecto, 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, tambin puede complementar la estimacin de hardware de su proyecto (p.e, para
determinar si necesita nodos adicionales y configurar un nodo BPM), usando nuestro Estimador de
dimensionamiento Bizagi.

SERVIDOR DE BASE DE DATOS

HARDWARE

RAM

16 GB

Disco duro

Dos discos de 80 GB - RAID 1


De 64 bits.
4 cores
3GHz o superior

Procesador

Recomendaciones
adicionales

SOFTWARE

Unidad de batera de respaldo

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
Oracle Database 10g R2

Motor de base de
datos

SERVIDOR BPM

HARDWARE

RAM

16 GB

Disco duro

Dos discos de 80 GB - RAID 1


De 64 bits.
4 cores
3GHz o superior

Procesador

Recomendaciones
adicionales

SOFTWARE

Sistema operativo

Unidad de batera de respaldo

Windows
Windows
Windows
Windows

Copyright 2014 - Bizagi

Server
Server
Server
Server

2012 (recomendado)
2008 R2
2008
2003 SP1 - 32 bits

2405

SERVIDOR BPM

Servidor web

IIS
IIS
IIS
IIS
IIS

8.5
8.0
7.5
7.0
6.0

Componentes
adicionales

Bizagi Engine, que instala el framework de .NET


4.0 full (y este framework de .NET incluye otros
componentes necesarios como Visual C++ 2010,
2008 Redistribuble).
Oracle Data Provider para .NET (aplica para
proyectos que utilicen una base de datos Oracle).

USUARIOS FINALES
HARDWARE
PARA EQUIPOS

HARDWARE
PARA MVILES

Resolucin de
pantalla

1024 x 768 o superior

Dispositivos

iOS 6 (iPad, iPhone)


Smartphones y tabletas Android (versin de Android 4.0
o superior)
Windows 8 tablet

Navegador

Internet Explorer 9 o superior (versin recomendada: IE


10).
Chrome 24 o superior (recomendado utilizar Chrome):
Safari 5 o superior
Firefox 19 o superior

SOFTWARE
Componentes
adicionales

Microsoft Silverlight, que se instala por los mismos


navegadores.
Utilizado para las consultas grficas.

No se soportan sistema operativos o configuracin de mquina en idioma turco.


Los equipos y servidores de los requerimientos mencionados, debern tener una configuracin
regional que no utilice idioma o cultura de Turqua (tr, tr-TR).

Importante
Para proyectos configurados sobre mquinas virtuales (p.e sobre VMWare, o servicios de plataforma e
infraestructura en la nube, como Azure, Amazon WS, etc), es muy importante asegurarse de tener un
host con muy buena velocidad de disco (tener especificacin de RPM alta).

Copyright 2014 - Bizagi

2406

Opcin de acceso por Internet


En proyectos donde se requiera habilitar a los usuarios finales para que trabajen en los procesos va
Internet desde cualquier dispositivo,
un servidor opcional se puede considerar para proveer las funciones de un proxy inverso.
El proxy inverso se configura en la DMZ y dichas funciones pueden establecerse desde una instancia
del servidor Apache HTTP, de manera que se permita el acceso a los procesos Bizagi mientras se
mantiene la seguridad de la infraestructura del servidor BPM.

Los requerimientos para esta opcin donde se considera un servidor Apache HTTP incluyen:

SERVIDOR PROXY
Disco duro
HARDWARE

SOFTWARE

1 GB

Recomendaciones
adicionales

Funcionalidad de proxy
inverso

Dos tarjetas de red - Dual port 1GB


Fuente de poder redundante
Apache HTTP Server.
Los requisitos para configurar una instancia de
Apache HTTP Server se pueden revisar en la pgina
oficial del proyecto Apache HTTP, de acuerdo a la
versin y plataforma especfica.

Copyright 2014 - Bizagi

2407

Bizagi Engine ejecutndose sobre plataforma JEE

Bizagi Engine ejecuta sus procesos y los entrega a los dispositivos mviles y laptops de cada usuario
de negocio.
Bizagi Engine soporta una arquitectura de alta disponibilidad o una arquitectura estndar, como se
describe en los requerimientos de sistema a continuacin.
Siga los enlaces para revisar la arquitectura de sistema y sus requerimientos para una plataforma JEE:
Para ver los requerimientos de alta disponibilidad, consulte Alta disponibilidad JEE -requerimientos
de sistema.
Para ver los requerimientos estndar, consulte Arquitectura estndar JEE -requerimientos de sistema.

Alta disponibilidad JEE - requerimientos de sistema

Introduccin
Una arquitectura para alta disponibilidad est diseada para procesos de negocio de misin crtica
que deben estar en funcionamiento todo el tiempo (24/7).
Bizagi soporta una arquitectura para alta disponibilidad para la ejecucin de los procesos en una
plataforma JEE, con requerimientos de sistema que consideran lo siguiente:
Un clster de base de datos, para contar con capacidades de tolerancia a fallos en el servidor de
base de datos.
Un clster para el servidor BPM, para contar con balanceo de cargas.
Un balanceador de cargas, para coordinar las cargas hacia el clster de servidor BPM.

Copyright 2014 - Bizagi

2408

Puede descargar aqu un PDF que contiene casos de estudio de arquitectura de sistema con Bizagi, en
el cul se ilustra la configuracin utilizada por proyectos corporativos a gran escala, que manejan un
significativo volumen de datos.

Importante
Estos requerimientos aplican tanto para un ambiente de produccin como para un ambiente de
pruebas.
Lo anterior, teniendo en cuenta que se recomienda que un ambiente de pruebas se configure lo ms
similar posible a su ambiente de produccin.

Alta disponibilidad -requerimientos de sistema


Los siguientes requerimientos deben tomarse como lo mnimo requerido por el sistema.
Se deben considerar Variables adicionales en cada proyecto, 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, tambin puede complementar la estimacin de hardware de su proyecto (p.e, para
determinar si necesita nodos adicionales para el clster BPM) usando nuestro Estimador de
dimensionamiento Bizagi.

SERVIDOR DE BASE DE DATOS


2 nodos para la base de datos (clster de tolerancia a fallos). Cada nodo con lo siguiente:
RAM

16 GB

Disco duro

Dos discos de 80 GB - RAID 1

HARDWARE

Copyright 2014 - Bizagi

2409

SERVIDOR DE BASE DE DATOS

SOFTWARE

Procesador

De 64 bits.
4 cores
3GHz o superior

Recomendaciones
adicionales

Dos tarjetas de red - Dual port 1GB


Fuente de poder redundante

Motor de base de
datos

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
Oracle Database 10g R2

SERVIDOR BPM
2 nodos para el servidor BPM (clster de balanceo de cargas). Cada nodo con lo siguiente:

HARDWARE

RAM

24 GB

Disco duro

Dos discos de 80 GB - RAID 1

Procesador

De 64 bits.
4 cores
3GHz o superior

Recomendaciones
adicionales

Dos tarjetas de red - Dual port 1GB


Fuente de poder redundante

Sistema operativo

Sistemas operativos soportados por la plataform de


Aplicaciones JEE Application que se utilice.
Algunos de estos sistemas operativos son:
SO Unix, como Solaris 9 o 10.
Red Hat Enterprise Linux 4 o 5
Ubuntu Server edition, versin 9.04
Windows Server 2012
Windows Server 2008 R2
Windows Server 2008
Windows Server 2003 SP1

Plataforma servidor de
aplicacin

WebSphere Application Server V7


Mayor informacin sobre los requerimientos de
WebSphere V7 se pueden consultar en el sitio oficial
de WebSphere Application Server V7
Weblogic 11g versin 10.3.6.0
Mayor informacin sobre los requerimientos de
Weblogic 11g se pueden consultar en el sitio oficial
de Oracle Weblogic.

SOFTWARE

Copyright 2014 - Bizagi

2410

SERVIDOR BPM
JBoss 6.2 EAP
Mayor informacin sobre los requerimientos de
JBoss 6.2 EAP se pueden consultar en el sitio oficial
de JBoss 6 EAP,
Componentes
adicionales

Bizagi Engine para plataformas JEE.


Cuando se utiliza Windows Server 2012, requerir
del framework 3.5 de .NET si utiliza una base de
datos SQL Server.

BALANCEADOR DE CARGAS
Para el balanceo de cargas, Bizagi soporta tanto balanceadores en hardware o software (Bizagi no
provee como tal el balanceador de cargas).
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).

USUARIOS FINALES
HARDWARE
PARA EQUIPOS

HARDWARE
PARA MVILES

Resolucin de
pantalla

1024 x 768 o superior

Dispositivos

iOS 6 (iPad, iPhone)


Smartphones y tabletas Android (versin de Android 4.0
o superior)
Windows 8 tablet

Navegador

Internet Explorer 9 o superior (versin recomendada: IE


10).
Chrome 24 o superior (recomendado utilizar Chrome):
Safari 5 o superior
Firefox 19 o superior

SOFTWARE
Componentes
adicionales

Microsoft Silverlight, que se instala por los mismos


navegadores.
Utilizado para las consultas grficas.

No se soportan sistemas operativos o configuracin de mquina en idioma turco.

Copyright 2014 - Bizagi

2411

Los equipos y servidores de los requerimientos mencionados, debern tener una configuracin
regional que no utilice idioma o cultura de Turqua (tr, tr-TR).

Importante
Para proyectos configurados sobre mquinas virtuales (p.e sobre VMWare, o servicios de plataforma e
infraestructura en la nube, como Azure, Amazon WS, etc), es muy importante asegurarse de tener un
host con muy buena velocidad de disco (tener especificacin de RPM alta).

Opcin de acceso por Internet


En proyectos donde se requiera habilitar a los usuarios finales para que trabajen en los procesos va
Internet desde cualquier dispositivo,
un servidor opcional se puede considerar para proveer las funciones de un proxy inverso.
El proxy inverso se configura en la DMZ y dichas funciones pueden establecerse desde una instancia
del servidor Apache HTTP, de manera que se permita el acceso a los procesos Bizagi mientras se
mantiene la seguridad de la infraestructura del servidor BPM.

Los requerimientos para esta opcin donde se considera un servidor Apache HTTP incluyen:

SERVIDOR PROXY
Disco duro
HARDWARE

1 GB

Recomendaciones
adicionales

Dos tarjetas de red - Dual port 1GB


Fuente de poder redundante

Copyright 2014 - Bizagi

2412

SERVIDOR PROXY

SOFTWARE

Funcionalidad de proxy
inverso

Apache HTTP Server.


Los requisitos para configurar una instancia de
Apache HTTP Server se pueden revisar en la pgina
oficial del proyecto Apache HTTP, de acuerdo a la
versin y plataforma especfica.

Arquitectura estndar JEE - requerimientos de sistema

Introduccin
Una arquitectura estndar est diseada para procesos de negocio que no necesiten estrictamente
estar bajo un esquema de alta disponibilidad.
Bizagi soporta una arquitectura estndar para la ejecucin de los procesos en una plataforma JEE, con
requerimientos de sistema que consideran lo siguiente:
Un servidor para la base de datos.
Un servidor dedicado como servidor BPM.

Puede descargar aqu un PDF que contiene casos de estudio de arquitectura de sistema con Bizagi, en
el cul se ilustra la configuracin utilizada por proyectos corporativos a gran escala, que manejan un
significativo volumen de datos.
Si considera que su solucin debe contemplar medidas de tolerancia a fallos o balanceo de cargas
para un esquema de alta disponibilidad, consulte la arquitectura descrita en Alta disponibilidad JEErequerimientos de sistema.

Copyright 2014 - Bizagi

2413

Importante
Estos requerimientos aplican tanto para un ambiente de produccin como para un ambiente de
pruebas.
Lo anterior, teniendo en cuenta que se recomienda que un ambiente de pruebas se configure lo ms
similar posible a su ambiente de produccin.

Arquitectura estndar -requerimientos de sistema


Los siguientes requerimientos deben tomarse como lo mnimo requerido por el sistema.
Se deben considerar Variables adicionales en cada proyecto, 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, tambin puede complementar la estimacin de hardware de su proyecto (p.e, para
determinar si necesita nodos adicionales y configurar un nodo BPM), usando nuestro Estimador de
dimensionamiento Bizagi.

SERVIDOR DE BASE DE DATOS

HARDWARE

RAM

16 GB

Disco duro

Dos discos de 80 GB - RAID 1


De 64 bits.
4 cores
3GHz o superior

Procesador

Recomendaciones
adicionales

SOFTWARE

Motor de base de
datos

Unidad de batera de respaldo

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
Oracle Database 10g R2

SERVIDOR BPM
RAM

24 GB

Disco duro

Dos discos de 80 GB - RAID 1

HARDWARE
Procesador

De 64 bits.
4 cores
3GHz o superior

Copyright 2014 - Bizagi

2414

SERVIDOR BPM
Recomendaciones
adicionales

Unidad de batera de respaldo

Sistema operativo

Sistemas operativos soportados por la plataform de


Aplicaciones JEE Application que se utilice.
Algunos de estos sistemas operativos son:
SO Unix, como Solaris 9 o 10.
Red Hat Enterprise Linux 4 o 5
Ubuntu Server edition, versin 9.04
Windows Server 2012
Windows Server 2008 R2
Windows Server 2008
Windows Server 2003 SP1

Plataforma servidor de
aplicacin

WebSphere Application Server V7


Mayor informacin sobre los requerimientos de
WebSphere V7 se pueden consultar en el sitio oficial
de WebSphere Application Server V7
Weblogic 11g versin 10.3.6.0
Mayor informacin sobre los requerimientos de
Weblogic 11g se pueden consultar en el sitio oficial
de Oracle Weblogic.
JBoss 6.2 EAP
Mayor informacin sobre los requerimientos de
JBoss 6.2 EAP se pueden consultar en el sitio oficial
de JBoss 6 EAP,

SOFTWARE

Componentes
adicionales

Bizagi Engine para plataformas JEE.


Cuando se utiliza Windows Server 2012, requerir
del framework 3.5 de .NET si utiliza una base de
datos SQL Server.

USUARIOS FINALES
HARDWARE
PARA EQUIPOS
HARDWARE
PARA MVILES

SOFTWARE

Resolucin de
pantalla

1024 x 768 o superior

Dispositivos

iOS 6 (iPad, iPhone)


Smartphones y tabletas Android (versin de Android 4.0
o superior)
Windows 8 tablet

Navegador

Internet Explorer 9 o superior (versin recomendada: IE


10).
Chrome 24 o superior (recomendado utilizar Chrome):
Safari 5 o superior
Firefox 19 o superior

Copyright 2014 - Bizagi

2415

USUARIOS FINALES
Componentes
adicionales

Microsoft Silverlight, que se instala por los mismos


navegadores.
Utilizado para las consultas grficas.

No se soportan sistema operativos o configuracin de mquina en idioma turco.


Los equipos y servidores de los requerimientos mencionados, debern tener una configuracin
regional que no utilice idioma o cultura de Turqua (tr, tr-TR).

Importante
Para proyectos configurados sobre mquinas virtuales (p.e sobre VMWare, o servicios de plataforma e
infraestructura en la nube, como Azure, Amazon WS, etc), es muy importante asegurarse de tener un
host con muy buena velocidad de disco (tener especificacin de RPM alta).

Opcin de acceso por Internet


En proyectos donde se requiera habilitar a los usuarios finales para que trabajen en los procesos va
Internet desde cualquier dispositivo,
un servidor opcional se puede considerar para proveer las funciones de un proxy inverso.
El proxy inverso se configura en la DMZ y dichas funciones pueden establecerse desde una instancia
del servidor Apache HTTP, de manera que se permita el acceso a los procesos Bizagi mientras se
mantiene la seguridad de la infraestructura del servidor BPM.

Copyright 2014 - Bizagi

2416

Los requerimientos para esta opcin donde se considera un servidor Apache HTTP incluyen:

SERVIDOR PROXY
HARDWARE

SOFTWARE

Disco duro

1 GB

Recomendaciones
adicionales

Fuente de poder redundante

Funcionalidad de proxy
inverso

Apache HTTP Server.


Los requisitos para configurar una instancia de
Apache HTTP Server se pueden revisar en la pgina
oficial del proyecto Apache HTTP, de acuerdo a la
versin y plataforma especfica.

Bizagi Engine - instalacin


Descargue el instalador de Bizagi Engine desde nuestro sitio oficial en bizagi.com, segn la plataforma
que desee utilizar para sus procesos Bizagi.

Si desea ejecutar sus procesos sobre una plataforma de .NET, descargue Bizagi Engine para .NET.
Para ver informacin acerca de la instalacin para esta plataforma consulte Bizagi Engine para .NET instalacin.

Copyright 2014 - Bizagi

2417

Si desea ejecutar sus procesos sobre una plataforma de JEE, descargue el instalador de Bizagi Engine
para JEE, segn el servidor de aplicaciones que desee utilizar (WebSphere, Weblogic, JBoss).
Para ver informacin acerca de la instalacin para esta plataforma consulte Bizagi Engine para JEE instalacin.

Bizagi Engine para .NET - instalacin

Dnde instalar Bizagi Engine?


Bizagi Engine debe ser instalado en el servidor que se designe como servidor BPM, donde se alberga
el Portal de trabajo de Bizagi.
Bizagi Engine es requerido para el ambiente de Pruebas o de Produccin, para que pueda realizar el
deployment de sus procesos en estos ambientes y presentar a los usuarios finales el Portal de trabajo.

Se recomienda enfticamente utilizar mnimo 3 servidores diferentes para sus 3 ambientes diferentes
del proyecto: Desarrollo, Pruebas y Produccin.
Si por algn motivo esto no es viable, y su servidor BPM del ambiente de Pruebas, es el mismo
servidor que utiliza para su ambiente de Desarrollo, no necesitar instalar Bizagi Engine all. No se
requiere instalar Bizagi Engine donde ya se tiene una instalacin de Bizagi Studio.

Antes de comenzar
Asegrese de que su mquina cumple con los requisitos presentados en Bizagi Engine Requerimientos del Sistema.
Tenga en cuenta que para instalar Bizagi con soporte nativo de 64 bits, necesitar tener instalado un
sistema operativo de 64 bits.

Copyright 2014 - Bizagi

2418

Instalar Bizagi Engine


Para instalar Bizagi Engine, siga los pasos presentados a continuacin.
1. Solicite el instalador de Bizagi Engine para plataformas .NET para instalar en su ambiente de
Pruebas o de Produccin.
2. Ejecute el instalador con permisos de administrador.

Seleccione el idioma para la instalacin (ingls o espaol).


3. haga clic en Siguiente en la ventana de instalacin.

Copyright 2014 - Bizagi

2419

4. Revise el acuerdo de la licencia de Bizagi Engine y haga clic en Siguiente.

Copyright 2014 - Bizagi

2420

5. Seleccione la base de datos a utilizar.


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

Copyright 2014 - Bizagi

2421

En caso de que usted quiera que Bizagi revise la correcta configuracin de su base de datos, puede
utilizar estas opciones:
1. Seleccione la opcin para incluir una instalacin de SQL Server Express 2008 Service pack 3,
seleccionando "Instalar SQL Server Express 2008 SP3"). Cuando se incluya el SQL Server Express
2008 SP3, las credenciales por defecto para acceder el servidor son:
LOGIN: sa
PASSWORD: Bizagi10GO
2. Verifique la configuracin de una instancia SQL Server ya instalada, seleccionando la opcin "Ya
tengo un Servidor SQL". Con dicha opcin, ingrese el Nombre de Usuario y la contrasea
(autenticacin SQL Server) para esta conexin, en la ventana que emerge. Despus de ingresar la
informacin, d clic en Login para verificar la conexin.

6. Haga clic en Siguiente si desea instalar Bizagi en su ruta predeterminada ("C:\Program Files\...")
De otra manera, para seleccionar una ubicacin diferente de la carpeta, haga clic en Buscar, y
seleccione la carpeta de su preferencia.

Copyright 2014 - Bizagi

2422

7. Inicie el proceso de instalacin


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

Copyright 2014 - Bizagi

2423

Bizagi instalar los componentes requeridos como: Framework 4.0 de .NET y Visual C++ 2010, 2008
Redistributable, si no se encuentran instalados previamente.
La siguiente ventana aparecer cuando la instalacin haya terminado.

Copyright 2014 - Bizagi

2424

Clic en el botn Finalizar.


Observe que esta instalacin puede requerir el reinicio del equipo (de ser notificado por su sistema).

Qu sigue?
Una vez que haya completado la instalacin, tendr listo el servidor BPM de su ambiente de Pruebas o
de Produccin para llevar a cabo el deployment de procesos.
Por ejemplo, a travs del deployment en un clic de Bizagi, podr fcilmente publicar los procesos
automatizados al ambiente final.
Para informacin acerca del deployment de procesos de Bizagi consulte Deployment de sus procesos.

Bizagi Engine para JEE - instalacin


Bizagi Engine presenta un archivo distribuble en cada uno de los diferentes servidores de aplicaciones
JEE soportados.
Descargue el archivo zip apropiado, segn el servidor de aplicaciones JEE que vaya utilizar para sus
procesos de Bizagi:
Para WebSphere, utilice: BizAgi-ear-Websphere-dist.zip
Para Weblogic, utilice: BizAgi-ear-Weblogic-dist.zip
Para JBoss, utilice: BizAgi-ear-JBoss-dist.zip

Copyright 2014 - Bizagi

2425

Una vez que descargue el archivo distribuble de Bizagi Engine para JEE, lo necesitar tanto para:
configurar su servidor de aplicaciones JEE para trabajar con Bizagi, como para configurar el portal de
trabajo de Bizagi.
Para mayor informacin sobre ello, consulte Configuracin de Bizagi Engine sobre plataforma JEE.

Para instalar Bizagi Management Console para una plataforma JEE, deber utilizar el instalador de
Bizagi Studio e instalar Bizagi JEE Plugin.
De esta manera, usted tendr una configuracin de Bizagi Management Consol que puede acceder a
la configuracin de su ambiente de pruebas o produccin.

Soporte multi idioma


El Portal de Trabajo de la Suite de Bizagi puede se presentado a los usuarios finales en cualquier
idioma. Esto incluye no solo el men del portal de Trabajo, sino tambin los procesos del cliente.

Mens multi idiomas para el Portal de trabajo


Bizagi posee diez idiomas pre definidos que pueden ser seleccionados para cambiar el idioma del
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
Checo
Tenga en cuenta que usted puede visualizar el Portal de trabajo en cualquier idioma. Los idiomas que
no fueron mencionados anteriormente requieren de ajustes adicionales para ser soportados
completamente.
Para aprender cmo localizar el Portal de Trabajo por favor visite: Localizacin del Portal de Trabajo.

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.

Copyright 2014 - Bizagi

2426

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.
Para aprender cmo localizar un proceso y sus componentes por favor visite: Localizacin de un
proceso y sus componentes.

Copyright 2014 - Bizagi

2427

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 el uso del producto, todos los textos
sern mostrados en el idioma escogido.

Copyright 2014 - Bizagi

2428

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.

Portal de Trabajo de Bizagi


Introduccin
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 Inbox, 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 2014 - Bizagi

2429

Para acceder al Portal de Trabajo d clic en el botn Ejecutar en la Cinta de Opciones de Bizagi Studio
o en el sptimo paso nmero Asistente de Procesos.

Copyright 2014 - Bizagi

2430

Para la Edicin JEE se tiene la opcin de dar clic sobre Ejecutar para visualizar cambios inmediatos
(a nivel de formas, reglas) en el Portal de Trabajo.
Para 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.
La diferencia entre la opcin de ejecucin y publicacin es:
La ejecucin despliega la aplicacin a JBoss en caliente tras refrescar la cach.
La publicacin reinicia el servicio de JBoss y vuelve a compilar el modelo de entidades.

Tanto la ejecucin como la publicacin, lanzarn un navegador con el Portal de Trabajo configurado
en la instalacin de JBoss por defecto.
Ntese que el archivo .ear generado del Portal ser ubicado en la ruta por defecto del proyecto
(por defecto en C:\Bizagi\Enterprise\Projects\[su_proyecto]\JEE\dist\).
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.

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: Men principal, rea de trabajo y el rea de casos.

Copyright 2014 - Bizagi

2431

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 Logout. Estas dos vistas son
Detalles y Cuadricula. Por defecto, la se mostrar la vista de Detalles as.

La vista Cuadrcula se muestra a continuacin.

Copyright 2014 - Bizagi

2432

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

Crear

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.

Inbox
OPCIN

Inbox

DESCRIPCIN
Muestra las actividades pendientes del usuario y
el estado de cada una. Los diferentes estados (a
tiempo, en riesgo y expirado) se representan con
diferentes colores para una fcil identificacin.

Reportes
Este men le da acceso a los informes de rendimiento de los procesos. Le recomendamos configurar

Copyright 2014 - Bizagi

2433

la seguridad de este men para garantizar que slo los usuarios adecuados tengan acceso a ella.
OPCIN

SUB-OPTION

BAM

Procesos

El BAM de procesos le permite


analizar el estado de casos activos.

Tareas

El BAM de tareas le permite analizar


el estado de actividades
pendientes.

Anlisis

DESCRIPCIN

Monitor de
recursos

El Monitor de Recursos le permite


analizar la carga y desempeo de
usuarios y grupos de trabajo.

Procesos

El Anlisis de Procesos presenta un


resumen de casos y actividades
cerrados.

Tareas

Sensores

Sensores

Mis Reportes

Mis Reportes

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.

Consultas
OPCIN

Consultas

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.

Admin
Las siguientes opciones deben ser manejadas por un administrador. Le recomendamos revisar las
opciones de seguridad para restringir el acceso basado en el perfil de sus usuarios.
OPCIN

Usuarios

DESCRIPCIN
Permite la administracin de los usuarios: creacin
o actualizacin. Para ms informacin por favor
referirse a Administracin de Usuarios.

Copyright 2014 - Bizagi

2434

OPCIN

DESCRIPCIN

Licencias

Permite la administracin de Licencias.

Entidades

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.

Casos

Permite reasignar las Actividades o abortar casos.

Alarmas

Permite generar alertas o alarmas cuando una


actividad va a expirar o ha expirado.

Cifrado de clave

Cifra las contraseas usadas en la base datos


para incrementar la seguridad del acceso a la
informacin.

Consola de actividades
asncronas
Solicitudes pendientes
de usuarios

Bsqueda en el
registro de
autenticacin
Polticas del negocio

Perfiles

Administrar asignacin
de usuario
predeterminado

Dimensiones

Maneja las actividades asncronas que han fallado.

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

Preferencias

Copyright 2014 - Bizagi

2435

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

DESCRIPCIN

Salir

Cierra la sesin actual en el Portal de Trabajo.

OPCIN

DESCRIPCIN

Acerca de

Acerca de

Muestra la versin actual de Bizagi.

Tamao de letra
OPCIN

DESCRIPCIN

Tamao

Permite al usuario cambiar el tamao de fuente


del Portal de Trabajo.

OPCIN

DESCRIPCIN

Buscar

Buscar

Permite buscar casos por su nmero de creacin.

rea de casos
El rea de casos permite al usuario final ver la distribucin de los casos en su Bandeja de entrada
ordenados por 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: Informacin de Procesos y Estado de casos.

Copyright 2014 - Bizagi

2436

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 Todos los casos, todos las actividades pendientes se mostrarn.

Copyright 2014 - Bizagi

2437

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.

Al hacer clic en un estado particular, se mostrarn los casos correspondientes en el rea de trabajo.

Copyright 2014 - Bizagi

2438

Puede filtrar su Inbox para mostrar los casos marcados como favoritos haciendo clic en el icono de
estrella.

Si hace clic en la opcin todos los casos, se mostrarn todas las actividades pendientes.

Copyright 2014 - Bizagi

2439

rea de trabajo
En esta seccin usted, como usuario final, puede administrar todos los casos que se le han asignado y
trabajar en ellos. El rea de trabajo muestra dos vistas:
Inbox: Muestra la lista de casos pendientes junto con su estado actual.

Actividades pendientes: Permite a los usuarios finales trabajar en sus casos pendientes.

Copyright 2014 - Bizagi

2440

Inbox
En esta vista usted puede ver la lista de tareas pendientes y su estado. Por defecto, se presenta la
siguiente informacin de cada caso:

Nmero de caso
Ruta
Proceso
Fecha de creacin
Fecha solucin
Actividad vence en

Identificador del caso


Aplicacin y categora a la que pertenece el caso.
Proceso al que pertenece la actividad
Fecha de creacin del caso
Fecha de solucin de la actividad
Fecha de expiracin 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.

Estado de la
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 expirado.

Esta informacin puede ser personalizada de acuerdo a sus necesidades. Para mayor informacin
consulte personalizar y parametrizar columnas.

Copyright 2014 - Bizagi

2441

El Inbox tambin puede mostrarse de dos maneras diferentes: en vista de Detalles y de Cuadricula.
Usted puede cambiar la forma de visualizacin en cualquier momento, seleccionando el icono de vista
situado debajo de la opcin Salir.

Vista de Cuadrcula
La vista de Cuadrcula muestra la informacin principal del Inbox en una tabla. Cada fila de la tabla es
una actividad pendiente. Puede hacer clic en el icono para obtener ms informacin sobre un caso
determinado, sin tener que acceder al mismo.

Para acceder y trabajar en un caso, d clic en el enlace Estado de la tarea.

Usted puede marcar un caso como Favorito dando clic en la estrella en la primera columna del caso
en cuestin.

Copyright 2014 - Bizagi

2442

Usted puede acceder a la consulta grfica dando clic en el icono junto a la estrella. En esta pantalla,
usted puede ver, de manera grfica, el camino seguido por el caso durante el proceso.

Para ver ms actividades, muvase a travs de las pginas haciendo clic en las pginas al final de la
pantalla.

Copyright 2014 - Bizagi

2443

Vista de Detalles
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 el log de Asignados del caso seleccionado en la pantalla de la derecha.

Para acceder al caso, d clic en Trabajar aqu.

Copyright 2014 - Bizagi

2444

Para marcar un caso como Favorito, d clic en la estrella en la esquina superior izquierda de la caja
del caso.

Para ver la consulta grfica, d clic en el icono de la esquina superior izquierda de la vista resumen.

Copyright 2014 - Bizagi

2445

Para ver ms actividades muvase a travs de las pginas haciendo clic en los nmeros de pgina al
final de la pantalla.

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.
En la vista de Cuadrcula, cada fila de la tabla es un caso pendiente. Usted puede trabajar en una
Actividad pendiente haciendo clic en el enlace de la columna Estado del caso.

Copyright 2014 - Bizagi

2446

En la vista Detalles, usted podr ver la informacin detallada de un caso en particular. Usted podr
navegar los casos pendientes en la pantalla de la izquierda. En esta vista, usted puede trabajar en una
Actividad pendiente seleccionando el botn Trabajar aqu del caso seleccionado.

Cuando el caso se abre, se distinguen los siguientes elementos:

Copyright 2014 - Bizagi

2447

La ventana se divide en las secciones:


Detalle de la actividad: Muestra informacin de la actividad actual.
Detalles del caso: Muestra informacin del caso actual.
Forma: Permite ver e ingresar la informacin requerida del caso.
Botones de accin: Permiten guardar la informacin del caso y avanzarlo.
Log de estado: Muestra el historial del caso.
Opciones de impresin: Permite imprimir la informacin que se muestra en la actividad.
Consulta grfica: Muestra el estado y desarrollo del caso de manera grfica.

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 descripcin. Tambin es posible saber el estado de la misma por el color a su lado
(verde, a tiempo; amarillo, en riesgo; rojo, expirado).

Copyright 2014 - Bizagi

2448

Detalles del Proceso


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 2014 - Bizagi

2449

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

Copyright 2014 - Bizagi

2450

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 para la actividad actual. Aqu, se deben diligenciar los campos
requeridos y ejecutar las tarea necesarias para completar la Actividad.

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. por
ejemplo, todos los controles en un contenedor dado pueden ser de solo lectura.

Copyright 2014 - Bizagi

2451

El asistente de Bizagi proporciona una validacin en lnea con el fin de mostrar las advertencias sobre
los campos requeridos o condiciones de negocio que se deben cumplir.

Botones de accin
Estos botones permiten realizar diferentes acciones para la actividad actual.

Copyright 2014 - Bizagi

2452

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.
Botones de Forma: Estos botones son definidos por el usuario y se utilizan para ejecutar
comportamientos personalizados. Para mayor informacin consulte Botones de Forma

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 2014 - Bizagi

2453

Copyright 2014 - Bizagi

2454

Haga clic en el botn Imprimir para completar la accin.

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 y Administracin

Para mayor informacin consulte Log de estado

Consulta grfica
La consulta grfica muestra de forma grfica la trayectoria que el caso se ha seguido, los usuarios
implicados y su estado.

Copyright 2014 - Bizagi

2455

Para mayor informacin vea Consulta grfica

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.

Copyright 2014 - Bizagi

2456

Log de estado por actividades


El Log de estado por actividades 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 2014 - Bizagi

2457

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.

Copyright 2014 - Bizagi

2458

Log de estado por entidades


El Log de estado por entidades muestra registro de las entidades que han sido modificados durante el
proceso.

Copyright 2014 - Bizagi

2459

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
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.

Copyright 2014 - Bizagi

2460

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 Propiedades
avanzadas.

Copyright 2014 - Bizagi

2461

Log de estado por usuario


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
o el nombre de usuario completa o parcialmente.

Copyright 2014 - Bizagi

2462

Log de administracin
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.

Copyright 2014 - Bizagi

2463

Es posible realizar dos acciones en este reporte:


Reasignacin de actividades identificadas por el icono . Cuando se despliega esta accin, la
informacin adicional mostrar el usuario inicial y el nuevo asignado.
Abortar casos identificado 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 consulta grfica. 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.

Copyright 2014 - Bizagi

2464

Al hacer clic en el icono de consulta grfica, se abrir una nueva ventana con las siguientes
funcionalidades.
D clic en una actividad para mostrar todos los usuarios que participaron en ella.

El botn Estado actual va a resaltar la actividad actual en verde.

Copyright 2014 - Bizagi

2465

Por cada Subproceso contenido en un caso, se puede tener acceso al anlisis grfico seleccionando
el subproceso y haciendo clic en el icono de la lupa en el men emergente.

Si hace clic en el botn Ruta muestra la ruta completa del proceso se mostrar con una lnea
naranja.

Copyright 2014 - Bizagi

2466

El asignado actual, la fecha de creacin y de solucin del caso se muestran en la esquina inferior
izquierda.

La consulta grfica 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).

Copyright 2014 - Bizagi

2467

Adems, es necesario habilitar el Silverlight Mime Type en el servidor web.

Inicio de sesin en el Portal de Trabajo


Un usuario debe estar autenticado para acceder al Portal de Trabajo. Por defecto, Bizagi tiene
habilitada la Autenticacin de Bizagi.
Con esta autenticacin, 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 dominio\admon.
Para pruebas rpida en el ambiente de desarrollo, la pgina de inicio de sesin no se mostrar a
menos que haya ms de un usuario.
Por lo tanto, tenga en cuenta que para poder acceder al Portal de Trabajo usted debe ser creado
como un usuario Bizagi.
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 Iniciar sesin 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.

Si todos los usuarios asignados pertenecen al mismo dominio, entonces el campo Dominio se
ocultar.

Copyright 2014 - Bizagi

2468

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 Cambiar contrasea, 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 Solicitudes Pendientes de usuario 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.

Copyright 2014 - Bizagi

2469

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 se mostrar el nombre de usuario y se debe introducir la contrasea
correspondiente.
Siempre pida cuenta y contrasea: Tanto el nombre de usuario y la contrasea tendrn que
introducidos cada vez que se conecte.

Copyright 2014 - Bizagi

2470

La visualizacin de estas opciones depende del tipo de Autenticacin y las opciones de Autenticacin.

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:
Internet Explorer \ Herramientas \ Opciones de Internet \ Privacidad \ Opciones Avanzadas \
Configuracin avanzada de privacidad

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 d clic de Login de Administrador.

Copyright 2014 - Bizagi

2471

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 olvida la contrasea de admon, habilite la
opcin Habilitar login rpido en las opciones de Autenticacin en Bizagi Studio. Cambie la contrasea
a travs de la Administracin del usuarios.

Copyright 2014 - Bizagi

2472

Escoger el idioma del Portal de Trabajo


El Portal de Trabajo se muestra en el idioma predeterminado que se defini en la Cultura global 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 Preferencias del Portal
de Trabajo.
Para hacerlo, vaya al Portal de Trabajo y d clic en Preferencias

Una ventana mostrar las preferencias personales del usuario. Seleccione su preferencia de idioma
desde la lista desplegable Idioma y d clic en Actualizar. Tenga en cuenta que slo se listan los
idiomas habilitados.

Copyright 2014 - Bizagi

2473

Reinicie el Portal de Trabajo para que lo cambios tengan efecto.

Administracin del Portal de Trabajo


En el Portal de Trabajo se encuentra el men de Administracin. Este men le permite acceder a varias
opciones para administrar los siguientes elementos Bizagi.

Los elementos de Bizagi que pueden ser administrados desde este men son:
OPCIN
Usuarios

DESCRIPCIN
Permite la administracin de los usuarios: creacin
o actualizacin. Para ms informacin por favor

Copyright 2014 - Bizagi

2474

OPCIN

DESCRIPCIN
referirse a Administracin de Usuarios.

Entidades

Polticas del negocio

Constructor de Temas

Bsqueda en el
registro de
autenticacin
Cifrado de clave

Solicitudes pendientes
de usuarios

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.
Administra las Polticas de negocio, Grupos de
polticas, precondiciones, Tablas de decisin y
Vocabularios, en tiempo real.
Permite definir y configurar la interfaz del Portal
de Trabajo. Personalizar colores y fuentes de
acuerdo a su imagen corporativa usando este
poderoso editor
Permite revisar el log de las autenticaciones
hechas por usuarios.

Cifra las contraseas usadas en la base datos


para incrementar la seguridad del acceso a la
informacin.
Despliega las solicitudes pendientes de las
cuentas de usuarios bloqueadas. Para ms
informacin refirase a Manejo cuentas
bloqueadas.

Casos

Permite reasignar las Actividades o abortar casos.

Consola de actividades
asncronas

Maneja las actividades asncronas que han fallado.

Administrar asignacin
de usuario
predeterminado

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

Permite la inclusin o borrado de los usuarios de:


Posiciones, roles, habilidades, grupos de usuario y
Organizacin. Para ms informacin refirase a
Perfiles.

Alarmas

Permite generar alertas o alarmas cuando una


actividad va a expirar o ha expirado.

Licencias

Permite la administracin de Licencias.

Copyright 2014 - Bizagi

2475

OPCIN
Dimensiones

DESCRIPCIN
Permite al usuario crear, editar y eliminar
Dimensiones

Este men permite modificar diferentes elementos que afectan a la funcionalidad y la ejecucin de los
procesos, se recomienda revisar las opciones de seguridad para restringir el acceso de acuerdo con
los perfiles de los usuarios.

Administracin de Casos
Los usuarios con privilegios de administrador pueden administrar los casos con el fin de balancear la
carga de trabajo, reducir tiempos de ciclo y eliminar informacin innecesaria.
En el men Admin del Portal de Trabajo encontrar la opcin Casos. Esta opcin le permite a los
usuarios administradores reasignar actividades o abortar casos.

Cmo abortar un caso


1. Vaya al men de administracin de casos 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 2014 - Bizagi

2476

2. Una vez ingresados los criterios, d clic en el botn Buscar.

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
resultados.

Copyright 2014 - Bizagi

2477

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 el caso de la lista habilitando la primera columna de la tabla:

Copyright 2014 - Bizagi

2478

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 Invalidar.

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 administracin de casos y busque el caso relacionado a la tarea que desea
reasignar. Usted puede utilizar distintos criterios de bsqueda como el nmero de creacin, asignado

Copyright 2014 - Bizagi

2479

actual, fecha de creacin o proceso.

2. Una vez ingresados los criterios, d clic en el botn Buscar.

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
resultados.

Copyright 2014 - Bizagi

2480

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:

Copyright 2014 - Bizagi

2481

4. D clic en el botn Reasignar que aparece en la parte inferior de la pantalla.

5. Se muestra una nueva ventana de bsqueda para encontrar el nuevo encargado de la actividad.
Ingrese la informacin y d clic en Buscar.

Copyright 2014 - Bizagi

2482

6. Se mostrar una lista de usuarios que cumplen con los criterios definidos. Identifique el usuario que
ser asignado dando clic en el botn Reasignar.

El caso estar asignado ahora al usuario seleccionado.

Copyright 2014 - Bizagi

2483

Administracin de usuarios

Introduccin
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 de negocio.
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 Admin del Portal de Trabajo se encuentra la opcin Usuarios. Esta opcin permite
la administracin de usuarios, ya sea actualizando existentes o creando nuevos.

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 Admin del Portal de Trabajo seleccione la opcin Usuarios. En la nueva pantalla, haga
clic en Nuevo usuario.

Copyright 2014 - Bizagi

2484

2. Se mostrar la ventana de administracin de usuarios. Incluya la informacin requerida en las cuatro


pestaas::
Informacin Bsica
Organizaciones
Configuracin usuario
Informacin Adicional.

En la pestaa de Informacin Bsica 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

Copyright 2014 - Bizagi

2485

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.

En la pestaa de Organizaciones 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 >>.

Copyright 2014 - Bizagi

2486

En la pestaa de Configuracin Usuario 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.
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

Copyright 2014 - Bizagi

2487

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 Informacin adicional slo se muestra cuando hay propiedades de usuario


personalizadas que no son requeridas, definidas en Bizagi Studio. En estas, usted puede incluir toda la
informacin relacionada a ellas.

Copyright 2014 - Bizagi

2488

3. Cuando haya terminado de introducir la informacin, haga clic en Agregar para guardar la
informacin del nuevo usuario.

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 Admin 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, se mostrarn todos los usuarios.

Copyright 2014 - Bizagi

2489

2. Haga clic en Buscar. Se mostrar una lista de los usuarios que cumplen los criterios de bsqueda,
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:
Editar: Muestra la pantalla de administracin de usuarios con el fin de modificar la informacin del
usuario.
Log: 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 Editar del usuario cuya informacin ser modificada.

Copyright 2014 - Bizagi

2490

4. La ventana de Administracin de usuarios se mostrar para hacer los cambios necesarios. Cuando
haya terminado, haga clic en Actualizar para guardarlos.

Copyright 2014 - Bizagi

2491

Manejo de Posiciones, Roles y Habilidades


Un administrador puede manejar los componentes organizacionales desde la opcin Perfiles en el
men Admin. Por cada componente, el administrador puede agregar o borrar usuarios.
Posicin
Rol
Habilidad
Grupo de usuarios
organizacin
1. Para administrar una propiedad especfica, haga clic en la opcin de men Admin en el men Portal
de Trabajo. A continuacin, seleccione la opcin Perfiles.

Copyright 2014 - Bizagi

2492

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
Administrar para administrar usuarios.

Copyright 2014 - Bizagi

2493

3. Una nueva ventana mostrar todos los usuarios del perfil seleccionado.
Seleccione Borrar o Nuevo usuario, dependiendo de la accin requerida.

Copyright 2014 - Bizagi

2494

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 Desbloquear
cuenta.

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 Admin en el men principal del Portal de Trabajo y seleccione Solicitudes pendientes de
usuarios para verlas.

Copyright 2014 - Bizagi

2495

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 2014 - Bizagi

2496

Puede generar contraseas de la cuenta de usuario haciendo clic Contrasea aleatoria.

Configuracin de Solicitudes pendientes


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.

Copyright 2014 - Bizagi

2497

Solo siga estos pasos:


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 Habilitar bloqueo de cuentas y compruebe
el encendido/apagado para activarla.
Haga clic en Actualizar para guardar los cambios.

Copyright 2014 - Bizagi

2498

2. Defina los intentos de inicio de sesin mximos.


Vaya a la opcin Nmero mximo de intentos de ingreso y escriba el nmero de intentos permitidos
antes de que la cuenta se bloquee.
Haga clic en Actualizar para guardar los cambios.

Copyright 2014 - Bizagi

2499

3. Defina el tiempo de bloqueo de contrasea.


Vaya a la opcin Tiempo de bloqueo de contraseas y escriba el nmero de das que una cuenta puede
estar inactiva antes de que se bloquee.
Haga clic en Actualizar 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 Tiempo de servicio para solicitudes pendientes y escriba el nmero mximo de horas en
las que el administrador debe responder a las solicitudes.
Haga clic en Actualizar para guardar los cambios.

Copyright 2014 - Bizagi

2500

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 Enviar correo cuando se cree solicitud
pendiente y compruebe el activado/desactivado para activarla.
Haga clic en Actualizar para guardar los cambios.

Copyright 2014 - Bizagi

2501

6. Cambie 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 Cuenta de correo del administrador
cuenta de correo y cambie la direccin de correo electrnico.
Haga clic en Actualizar 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 a:
El administrador, cuando un usuario enva una solicitud de desbloqueo. Personalice el mensaje en la
opcin Mensaje del correo en caso de una nueva solicitud.

Copyright 2014 - Bizagi

2502

El usuario, cuando la cuenta est desbloqueada

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.

Copyright 2014 - Bizagi

2503

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 Admin.

2. Busque el usuario para el cual se definir un usuario delegado. Ingrese los criterios necesarios y
luego d clic en Buscar.

Copyright 2014 - Bizagi

2504

3. D clic en la opcin Editar 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 Usuario Delegado.

Copyright 2014 - Bizagi

2505

5. D clic en Obtener Usuario para buscar el usuario delegado. Ingrese los criterios necesarios y d
clic en Buscar.

Copyright 2014 - Bizagi

2506

6. Seleccione el usuario delegado.

7. Finalmente habilite la opcin Habilitar delegacin para activar la delegacin.

Copyright 2014 - Bizagi

2507

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 Admnin seleccione la opcin Entidades. Una nueva ventana mostrar la lista de las
Entidades Paramtricas.

Copyright 2014 - Bizagi

2508

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.

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 Agregar.

Copyright 2014 - Bizagi

2509

4. Otra ventana aparecer para incluir la informacin de los atributos.

Los registros de las Entidades Paramtricas no se pueden eliminar. Por esta razn, tienen una
propiedad para Deshabilitar.
Los registros deshabilitados slo se mostrarn en los casos existentes (pendientes o cerrados) que los
referencian.

Copyright 2014 - Bizagi

2510

Llene la Forma con la informacin requerida y haga clic en Guardar.


Si no se desea guardar cambios d clic en Regresar (volver a la pantalla anterior).

Editar un registro de una Entidad Paramtrica


1. En el men Admin, seleccione la opcin Entidades. Una nueva ventana mostrar la lista de Entidades
Paramtricas.

Copyright 2014 - Bizagi

2511

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.

Copyright 2014 - Bizagi

2512

4. Se mostrar la informacin relativa al registro seleccionado.

Realice los cambios necesarios y haga clic en Guardar.


Si no se desea guardar cambios d clic en Regresar (volver a la pantalla anterior).

Copyright 2014 - Bizagi

2513

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 para poder mostrar, agregar o editar los registros como se
requiera. Para ms informacin referirse a Formas de administracin de entidades paramtricas.

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. Estas se manejan independientemente del proceso individual de tal manera que puedan ser
compartidas por otros procesos.
Puede administrar Polticas de negocio, Grupos de reglas, Precondiciones y Tablas de decisin cuando
sea necesario utilizando las facilidades del Vocabulario definido.

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 Admin.

Copyright 2014 - Bizagi

2514

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.
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 2014 - Bizagi

2515

Todo el vocabulario creado estar disponible en la pestaa de Componentes, 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.

Copyright 2014 - Bizagi

2516

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.

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 2014 - Bizagi

2517

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
Admin - Alarmas. 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 Admin y luego Alarmas.

Copyright 2014 - Bizagi

2518

2. Elija la Aplicaciones, Proceso y tarea en las que desee crear o editar la alarma y a continuacin, haga
clic en Alarmas>>.

3. En la pantalla del editor de alarmas se puede configurar los lapsos, las repeticiones y los tiempos:

Copyright 2014 - Bizagi

2519

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: 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:
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.

Copyright 2014 - Bizagi

2520

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.

Si selecciona la opcin Antes del vencimiento o Despus del vencimiento, debe definir el tiempo
antes o despus en la propiedad Lapso.

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 Cada Vez que se Cumpla el Tiempo Especificado. 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.

Para seleccionar el destinatario, puede determinar el perfil del destinatario seleccionado el Rol del
combo y luego haciendo clic en Adicionar destinatario.

Copyright 2014 - Bizagi

2521

Para eliminar destinatarios marque la casilla Destinatario y haga clic en Eliminar destinatarios
seleccionados.
Tambin puede configurar que la alarma se enve al usuario actual de la actividad marcando el campo
Enviar al asignado actual.

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 Editar o Eliminar. La lista de alarmas se actualizar
automticamente.

Consultas

Introduccin
Bizagi permite la definicin y personalizacin de Formas especiales para consultar la informacin
relacionada a los casos. Estas formas se denominan Consultas. 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
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
Anlisis 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 Consultas.

Copyright 2014 - Bizagi

2522

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 informacin 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
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.

Copyright 2014 - Bizagi

2523

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 Buscar.
Si el criterio definido no es el que desea, d clic en Limpiar.

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
En un Proceso de Gestin de Oportunidades de Venta queremos consultar la "Fecha de Creacin",

Copyright 2014 - Bizagi

2524

"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 General Query.
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 Desde y
Hasta.

3. Marque los atributos Fecha de Creacin", "Lead Source", "Ingreso Estimado" y "Etapa" para que

Copyright 2014 - Bizagi

2525

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.

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 Guardar Consulta, en
la parte inferior de la ventana, para guardar esta configuracin.

Copyright 2014 - Bizagi

2526

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.

Copyright 2014 - Bizagi

2527

Compartir una consulta guardada


Si usted quisiera compartir la consulta guardada con otros usuarios finales, d clic en el botn
Obtener Usuarios. Una nueva ventana se mostrar.

Esta ventana tiene dos pestaas:


La pestaa de Usuarios permite seleccionar usuarios por Nombre de usuario, dominio y nombre
completo.

Copyright 2014 - Bizagi

2528

De la lista de usuarios encontrados, seleccione los usuarios con los que desee compartir la Consulta y
d clic en el botn ">"
Luego d clic en el botn Compartir para permitir al grupo acceder a su Consulta.

Copyright 2014 - Bizagi

2529

La pestaa de Grupos permite la adicin de un grupo de usuarios para compartir la consulta. En la


lista de Nombre de Grupo se listan todos los grupos que han sido creados en la aplicacin. Para
agregar un Grupo, utilice el botn Agregar. Una vez que los grupos deseados han sido aadidos, d
clic en el botn Compartir. Si el usuario quisiera eliminar un grupo de la lista, solo debe
seleccionarlo y dar clic en el botn Eliminar.

Copyright 2014 - Bizagi

2530

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
"Opportunities 2011". Esta nueva consulta puede accederse desde una carpeta denominada General
Query 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.

Copyright 2014 - Bizagi

2531

Editar una Consulta guardada


1. D clic en el botn Editar que se encuentra a la derecha de la Consulta guardada.

2. Una nueva ventana se mostrar. Aqu usted puede modificar el Nombre, Descripcin, personas a
quien compartir la Consulta y los criterios de bsqueda segn lo requiera.

Copyright 2014 - Bizagi

2532

3. Usted puede guardar la consulta modificada como una nueva y mantener la versin original dando
clic en Guardar una Nueva, o actualizar la versin original dando clic en Actualizar.

Copyright 2014 - Bizagi

2533

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 Eliminar.

Copyright 2014 - Bizagi

2534

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 Anlisis
Grfico que aparece en la parte inferior de los resultados de la bsqueda.

Copyright 2014 - Bizagi

2535

2. Se abrir el Asistente de Anlisis Grfico.


En el paso 1 de este Asistente usted debe definir las Medidas. Estas Medidas representan cualquier
aspecto cuantificable o medible de la Consulta.
Para las medidas, se debe aplicar al menos una funcin agregada. Cuando se seleccione d clic en
Siguiente.
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.

Copyright 2014 - Bizagi

2536

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 2014 - Bizagi

2537

Para copiar dimensiones a la lista de dimensiones seleccionadas, arrstrelas desde el cuadro izquierdo
y sultelas en el cuadro derecho.

Copyright 2014 - Bizagi

2538

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:

Copyright 2014 - Bizagi

2539

Men de Grfico
Este men se divide en tres secciones. Cada seccin le permitir configurar y visualizar diferentes
caractersticas del Anlisis Grfico:

rea de Dimensiones y Medidas


En esta seccin usted puede agregar y remover medidas y dimensiones al grfico actual.

Copyright 2014 - Bizagi

2540

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.

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

Copyright 2014 - Bizagi

2541

1. En el elemento de dimensiones del anlisis grfico, d clic en la opcin Agregar. La ventana de


Adicin de Medidas se mostrar.

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 Agregar. La informacin es actualizada automticamente.

Copyright 2014 - Bizagi

2542

Agregar Dimensiones para llevar a cabo Anlisis Grfico


1. En el elemento de dimensiones del anlisis grfico, d clic en el botn Agregar. 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 Seleccionar Todo o seleccionando dimensiones dando clic en el cuadro de
marcacin que se encuentra a la izquierda de cada dimensin.

Copyright 2014 - Bizagi

2543

3. D clic en el botn Agregar. La informacin se actualiza automticamente.

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 las dimensiones y el clculo de la funcin agregada de la medida que representa.
Filtrar dimensiones en el anlisis grfico
Si usted desea mostrar solo valores especficos de una dimensin en el anlisis grfico, usted puede
filtrarlos.
1. En el elemento Dimensiones del anlisis grfico, d clic sobre la dimensin a filtrar. D clic en el
icono de filtro que aparecer.

Copyright 2014 - Bizagi

2544

2. Se abrir una nueva ventana. En esta usted encontrar todos los posibles valores para la dimensin.

Copyright 2014 - Bizagi

2545

3. Agregue los valores que se mostrar seleccionndolos y dando clic en el botn ">".

Copyright 2014 - Bizagi

2546

4. Finalmente d clic en el botn Aplicar Filtro. 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 2014 - Bizagi

2547

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.

Dependiendo el tipo de dimensin, automticamente se define el tipo de grfico. Normalmente se

Copyright 2014 - Bizagi

2548

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 2014 - Bizagi

2549

Cambiar la apariencia del Portal de Trabajo


Usted puede cambiar la apariencia del Portal de trabajo. Puede elegir entre los temas prediseados o
crear su propio tema.
Todos los colores y textos pueden ser personalizados, as como la imagen que aparece en la parte
superior, para adaptarse a la imagen corporativa deseada.

El Portal de Trabajo puede ser personalizado mediante el uso del Constructor de Temas de Bizagi.
Este poderoso editor le permite definir sus temas de tres maneras:
De una lista de temas prediseados disponibles en la lista de temas.
A partir de un color base.
O, basado en un tema seleccionado, cambiar cualquier tem especfico. (Personalice desde el fondo
del Portal de Trabajo hasta los bordes de la tabla en las Formas)
Para acceder al Constructor de temas vaya a las opciones de Administracin y seleccione la opcin
Constructor de Temas.

Copyright 2014 - Bizagi

2550

Constructor de Temas
El Constructor de Temas de Bizagi es un editor visual que permite definir y configurar el aspecto Portal
de Trabajo. Personalice los colores y tipos de letra de acuerdo a su imagen corporativa con este
poderoso editor.
El Constructor de Temas se divide en las siguientes secciones:
Panel Acciones: Desde este panel se pueden crear, guardar o restablecer temas.
Lista de temas: En esta seccin se muestra la lista de temas predefinidos o guardados, disponibles
para su publicacin.
Personalizar el tema: En esta seccin se ofrece un conjunto de opciones para personalizar los
diferentes componentes visuales del Portal de Trabajo.
rea de vista previa: En este rea se puede visualizar una vista previa de temas y cambios visuales
configurados.

Copyright 2014 - Bizagi

2551

Configurar un tema predefinido


1. Desde el Portal de Trabajo vaya a las opciones de Administracin y abra el Constructor de Temas.

2. En la lista de temas se encuentran los temas predefinidos o guardados, disponibles para su


publicacin.

Copyright 2014 - Bizagi

2552

3. Seleccione el tema deseado y haga clic en icono de verificacin para publicarlo.

Esto actualizar la apariencia de todos los usuarios del final del Portal de Trabajo.

Copyright 2014 - Bizagi

2553

Crear un tema a partir de un color base


1. Desde el Constructor de temas, vaya a la seccin de Personalizar su tema y haga clic en la opcin
Color base.

2. Se abrir una paleta de colores. Busque y seleccione el color que desee haciendo clic en l, o
introduciendo el cdigo de color.

Copyright 2014 - Bizagi

2554

D clic en Aplicar para previsualizar los cambios. El Constructor de temas es inteligente y definir los
colores predeterminados para los distintos componentes del Portal de Trabajo, que mejor contrasten
con el color base seleccionado.

3. Cuando est satisfecho con su tema, simplemente haga clic en Guardar para almacenarlo en la lista
de temas.

Copyright 2014 - Bizagi

2555

4. Reemplace el tema base o introduzca un nuevo nombre para crear una nuevo.

El nuevo tema estar ahora disponible en la lista de temas. Haga clic en el icono de verificacin para
publicarlo.

Copyright 2014 - Bizagi

2556

Esto actualizar la apariencia de todos los usuarios del final del Portal de Trabajo.

Personalizar componentes especficos


El Constructor de temas ofrece ms opciones para hacer posible la definicin sus temas ms
exigentes. Puede definir la configuracin de los colores para cada componente del Portal de Trabajo.
Para personalizar los componentes especficos slo debe que seleccionar un tema de base y cambiar
las propiedades de los diferentes componentes que desee.
Los siguientes son los componentes que se pueden personalizar. Estos se encuentran en bajo la

Copyright 2014 - Bizagi

2557

seccin de Personalizar su tema.

General
Comunes: Las reas que siempre se muestran.
Navegacin: Los campos de bsqueda y enlaces.
Contenido: El contenido general.
Men: Barra de men.
Bandeja de entrada: Barra de la Bandeja de entrada.
Pie de pgina: Pie de pgina del Portal de Trabajo.
Widgets: Widgets del formulario.
Botones: Botones del Portal de Trabajo.

Formas
Comunes: Contenedores globales y texto de los formularios.
Grupos: Contenedores de tipo grupo.
Pestaas: Contenedores de tipo pestaa.
Tablas: Tablas incluidas en las formas.
Entradas: Campos editables.

Fuentes
Familia de letra: Tipo de letra de los textos Portal de Trabajo.

Efectos especiales

Copyright 2014 - Bizagi

2558

Sombra del texto: Sombras de ttulos, nmeros de pgina y opciones del Portal de Trabajo.
Sombre de cajas: Sombras de cajas en el Portal de Trabajo.
Radio del borde: Suavizado de los bordes de las cajas y campos.

Iconos
Estilo de iconos portal de trabajo, puede ser skeuomorphic, plano o lineal.
Skeuomorphic:

Plano

Lineal

Espacio vertical
Espacio entre lneas del texto; puede ser normal o mnimo.
Normal

Mnimo

Copyright 2014 - Bizagi

2559

Comentarios del caso

Introduccin
Los Comentarios del caso presentan informacin complementaria para cada caso, que puede ser
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.
Esta caracterstica funciona como Twitter. Cualquier usuario con permisos de ver o trabajar en un caso,
puede escribir comentarios que pueden ser comentarios o informacin relevantes. Ser mostrada a
travs del ciclo de vida del caso, en el panel izquierdo, para todos los usuarios que accedan al caso
independiente del proceso en el que est.

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.

Copyright 2014 - Bizagi

2560

Haga clic en Comentar para publicar el comentario.

Copyright 2014 - Bizagi

2561

Las personas con acceso a la Forma Resumen podrn ver los comentarios y tambin incluir
comentarios propios:

Copyright 2014 - Bizagi

2562

La pestaa de comentarios estar visible para las personas con acceso al caso. Cuando un usuario
vea los comentarios del caso en una forma de resumen, la pestaa de comentarios ser mostrada
cunado haya al menos un comentario ingresado por un ejecutante. Si no se han agregado
comentarios por ejecutantes (los usuarios con actividades asignadas a ellos), la pestaa NO ser
visible. Tan pronto como un ejecutante agregue un comentario, cualquier usuario con acceso a la
forma de resumen puede ingresar comentarios y ver qu ha sido publicado.

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 d clic en el botn de Responder.

Copyright 2014 - Bizagi

2563

Haga clic en Comentar para publicar su respuesta.

Copyright 2014 - Bizagi

2564

Eliminar Comentarios de caso


Los comentarios pueden ser borrados por la persona que los escribi. Ponga el puntero del mouse
sobre el comentario para mostrar las acciones disponibles. Para borrar el comentario, d clic en el
cono de la papelera.

Copyright 2014 - Bizagi

2565

Seleccione Borrar para confirmar la eliminacin permanente del comentario.

Copyright 2014 - Bizagi

2566

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 Filtro en la pestaa Comentarios.

Copyright 2014 - Bizagi

2567

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 2014 - Bizagi

2568

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. En el caso de un
hilo de discusin, solo el creador del comentario inicial puede asignar una categora. Si un comentario
tiene varias respuestas, entonces solo el creador del primer comentario puede asignar el filtro.

Copyright 2014 - Bizagi

2569

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. Solo se mostrarn los
comentarios asignados a la categora seleccionada.

Copyright 2014 - Bizagi

2570

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. Se
mostrarn todos los comentarios creados para este caso.

Copyright 2014 - Bizagi

2571

Para borrar una categora asociada seleccione el icono de categora, situado a la derecha del
comentario. Seleccione la opcin Limpiar en la lista desplegable.
Recuerde que slo puede borrar Categoras de los comentarios hechos por usted o los de un hilo de
discusin iniciado por usted.

Copyright 2014 - Bizagi

2572

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 Preferencias.

Copyright 2014 - Bizagi

2573

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 Actualizar.

Copyright 2014 - Bizagi

2574

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.
La movilidad de Bizagi se basa en el concepto "disee una vez y ejecute en cualquier parte":
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.

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.
Si es necesario restringir la creacin de algn caso o de trabajo en alguna actividad desde un
mvil por favor refirase a Restringir acceso a mviles.
Para acceder a la aplicacin de Bizagi, siga los pasos a continuacin:
1. Para los dispositivos IOS vaya a la tienda de aplicaciones y busque Bizagi. La aplicacin es gratuita
para descargar.
Para dispositivos Android vaya a http://play.google.com y busque Bizagi. La aplicacin es gratuita para

Copyright 2014 - Bizagi

2575

descargar (aplica para versiones .Net).

Tenga en cuenta que la versin de la aplicacin instalada en el dispositivo mvil, debe ser igual
o superior a la versin de Bizagi instalada en el servidor donde se ejecuta un proyecto
especfico. De no ser as, este podra no ejecutarse de manera adecuada.

Copyright 2014 - Bizagi

2576

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.

Copyright 2014 - Bizagi

2577

Si el servidor de la aplicacin solo tiene un dominio activo, el login se realizar automticamente.


Si el servidor de la aplicacin tiene ms de un dominio activo, Bizagi mostrar una ventana para
seleccionar el dominio correspondiente.

Las opciones de Dominio no estn disponibles para Tabletas con sistema operativo Android. En
estos dispositivos el dominio debe ser ingresado manualmente.
Los smartphones Android muestran un mximo de tres dominios para seleccionar.
Tenga en cuenta que las cuatro propiedades necesarias se pueden obtener en el Portal de Trabajo:

Copyright 2014 - Bizagi

2578

Usted tambin puede acceder a una lista de ingresos anteriores del dispositivo (Historial de logins),
para acceder rpidamente a las aplicaciones relacionadas. La lista contiene la informacin del servidor
y el usuario.

Copyright 2014 - Bizagi

2579

El Historial de Logins se configura desde las opciones de configuracin de la aplicacin de Bizagi a


travs de las siguientes opciones:
Guardar historial: Habilita/Deshabilita el Historial de Logins.
Guardar contrasea: Define si la contrasea se solicita cuando un usuario accede a un login de la
lista.

El Historial de Login no esta disponible para Tabletas con sistema operativo Android.
Ahora tendr acceso a su Inbox y podr permanecer conectado con su trabajo.
iPhone:

Copyright 2014 - Bizagi

2580

Telfono Android

Copyright 2014 - Bizagi

2581

iPad:

Copyright 2014 - Bizagi

2582

Tableta Android:

Copyright 2014 - Bizagi

2583

Consideraciones para mviles

Restricciones actuales en smartphones iOS y Android


El modulo de administracin no esta presente en estos dispositivos.
En grillas solo se soporta la edicin en lnea; no es posible utilizar la adicin en lnea. Para adicionar
un registro es necesario asociar una forma de adicin.
En grillas, la funcionalidad de exportar a Excel y Pdf esta deshabilitada. Esta funcionalidad puede ser
modelada y activada, pero solo podr utilizarse en desktop.
La carga de archivos est limitada a los permisos del sistema operativo, es decir, se pueden tomar
fotos, subir imgenes, capturar audio, capturar video, siempre y cuando el sistema operativo lo
permita.
Los archivos cargados no se pueden enviar como adjuntos. Esta funcionalidad solo aplica por el
momento para desktops.
El control Impresin de archivos no realiza ninguna accin.
En los controles de Bsqueda no se pueden adicionar registros, solo se pueden buscar.
Las fechas se muestran en el formato del sistema operativo sin importar que se haya configurado
uno diferente. Pese a esto, la fecha es enviada al servidor en el formato requerido.
A diferencia del control Sugerencia del desktop, la funcin autocompletar funciona a partir de tres
caracteres.

Copyright 2014 - Bizagi

2584

Los controles tipo Radio solo se muestran en forma vertical (asi se configure horizontalmente), esto
debido al tamao del dispositivo y su facilidad de uso.

Restricciones actuales en Tablets


Tablets iOS y Android
El modulo de administracin no esta presente en estos dispositivos.
En grillas no se soporta la adicin y edicin en lnea debido a que estas solo muestran los cuatro
primeros campos.
En grillas la exportacin a Excel y Pdf esta deshabilitada. Esta funcionalidad puede ser modelada y
activada, pero solo podr utilizarse en desktop.
La carga de archivos est limitada a los permisos del sistema operativo, es decir, se pueden tomar
fotos, subir imgenes, capturar audio, capturar video, siempre y cuando el sistema operativo lo
permita.
Los archivos cargados no se pueden enviar como adjuntos. Esta funcionalidad solo aplica por el
momento para desktops.
El control Impresin de archivos no realiza ninguna accin.
En los controles de Bsqueda no se pueden adicionar registros, solo se pueden buscar.
Las fechas se muestran en el formato del sistema operativo sin importar que se haya configurado
uno diferente. Pese a esto, la fecha es enviada al servidor en el formato requerido.
A diferencia del control Sugerencia del desktop, la funcin autocompletar funciona a partir de 3
caracteres.

Tablets con Windows 8


No se soporta ningn tipo de control realizado en flash, Active divx, actionScript.
Por el momento, el control ECM no puede subir archivos, solo puede editar metadata.

Aplicacin de Windows 8
Bizagi posee una poderosa aplicacin para Windows 8 donde usted podr trabajar en sus casos.
Descargue la aplicacin desde la tienda de aplicaciones.

Copyright 2014 - Bizagi

2585

Abra la aplicacin e ingrese la ruta del proyecto y sus credenciales.

La opcin Historial de Login, muestra una lista, en la parte izquierda de la ventana, con todos los
inicios de sesin de cada usuario.

Copyright 2014 - Bizagi

2586

Usted podr acceder a todos los casos de su bandeja de entrada.

D clic en un caso para ver la informacin. Luego d clic en Trabajar aqu.

Copyright 2014 - Bizagi

2587

Cuando usted no tenga casos asignados su pantalla mostrar un mensaje;"No hay casos en la lista"
D clic en cualquier lugar de la pantalla y seleccione Nuevo para crear un caso.

Copyright 2014 - Bizagi

2588

Integracin con portales


Bizagi provee una arquitectura poderosa la cual ofrece una capa de servicios que permite fcilmente
hacer uso de sus interfaces grficas.
A travs de esta posibilidad, Bizagi soporta la integracin con portales al proveer un set de Web parts.
Si usted utiliza SharePoint para su portal corporativo, puede enriquecer su ambiente con las
capacidades BPM de Bizagi bajo esta solucin fcil y gil (sin la necesidad de programacin).
Las Web parts de Bizagi para SharePoint es una funcionalidad nativa del producto que le permite
directamente integrar Bizagi dentro de SharePoint sin tener que salir de su intranet.
Esta funcionalidad maneja automticamente la autenticacin integrada (capacidades Single Sign-On
Windows) y est disponible como un complemento descargable que se instala en su servidor
SharePoint.
Para ms informacin sobre esta configuracin, consulte Bizagi Web parts para SharePoint.

Copyright 2014 - Bizagi

2589

Bizagi Web parts para SharePoint

Introduccin
Bizagi ofrece sus Web parts para SharePoint para una integracin transparente entre Bizagi y
SharePoint.
Esta funcionalidad incluida por defecto en el producto provee poderosas opciones sin la necesidad de
programacin.
Las Web parts de Bizagi para SharePoint favorecen las implementaciones giles mediante una forma
fcil de embeber Bizagi dentro de SharePoint, incluyendo las capacidades de autenticacin integrada
(SSO) y presentando opciones de personalizacin para adaptar el portal de Bizagi a sus estndares
corporativos.
De esta manera, los usuarios finales trabajarn directamente en procesos de Bizagi sin tener que salir
de la intranet.

Copyright 2014 - Bizagi

2590

Copyright 2014 - Bizagi

2591

Las Web Parts se soportan en instalaciones de SharePoint 2010 o SharePoint 2013 (todas las ediciones
estn soportadas: Foundation, Standard y Enterprise).
Los Bizagi Web parts aplican para instalaciones de SharePoint On-Premise (con un esquema de
autenticacin Windows).

Qu se debe hacer?
Para utilizar los Bizagi Web parts para SharePoint, siga estos pasos:
1. Instale las Web parts en su servidor SharePoint.
La instalacin se realiza mediante un complemento para SharePoint disponible directamente en
bizagi.com.
Un administrador de SharePoint podr hacer el despliegue de las Web parts por medio de un archivo
WSP o a travs de un instalador.
Para mayor informacin, consulte la Instalacin de las Web parts.

2. Realice la configuracin central de las Web parts.


Una vez instaladas, como configuracin inicial solo deber ingresar los detalles de la conexin hacia su
portal de Bizagi.
Para mayor informacin, consulte la Configuracin de las Web parts.

3. Comience a utilizar las Web parts en sus pginas de SharePoint.


Una vez instaladas, su diseador Web de SharePoint podr empezar a incluir las Web parts
directamente en el contenido en SharePoint y configurar sus propiedades (etiquetado, apariencia,etc).
Para mayor informacin, consulte Propiedades de las Web parts.

Instalacin de las Web parts


La instalacin o actualizacin de Bizagi Web parts para SharePoint se puede realizar de dos maneras: a
travs de un instalador el cual gua el procedimiento, o haciendo un despliegue manual de las Web
parts desde un archivo WSP (Windos SharePoint file).
Para ms informacin sobre esta funcionalidad, consulte Bizagi Web parts para SharePoint.
Esta seccin describe cmo instalar o actualizar las Bizagi Web parts en una instalacin de SharePoint
a travs de las dos maneras.

Antes de comenzar
Se recomienda enfticamente que un administrador de SharePoint (un perfil con alto conocimiento y
experiencia en la administracin de SharePoint) sea quien lleve a cabo esta instalacin sobre su Web
farm.
Especialmente, cuando se opta por la opcin de desplegar el archivo WSP manualmente.
Prerrequisitos adicionales en SharePoint para utilizar los Bizagi Web parts son:
Asegurarse de contar con el servicio SharePoint Timer Services habilitado e iniciado.
Asegurarse de contar con el servicio SharePoint Administrator Services habilitado e iniciado.

Copyright 2014 - Bizagi

2592

Asegurarse de tener una cuenta de servicio con privilegios de administrador de Web farm.
Esta cuenta que se utilizar para la configuracin y conectividad con Bizagi debe:
o Ser una cuenta de dominio.
o Tener permisos de administrador sobre el Servidor BPM de Bizagi.
o Tener permiso de ejecucin sobre el Portal de trabajo de Bizagi.

Versiones soportadas
Las Web Parts se soportan en instalaciones de: SharePoint 2010 o SharePoint 2013.
Todas las ediciones estn soportadas (Foundation, Standard y Enterprise).
Las instalaciones de SharePoint deben ser "On-Premise".

Configuracin en Bizagi
Tenga en cuenta que este esquema se integra teniendo habilitada la autenticacin Windows (en
SharePoint y en Bizagi).
Autenticacin Windows habilitada en Bizagi:

Copyright 2014 - Bizagi

2593

La configuracin de autenticacin a nivel del IIS para el portal de Bizagi, deber tener tambin
deshabilitada la autenticacin tipo annima.
La configuracin requerida para el Portal de trabajo Bizagi a nivel del IIS deber ser como se ensea:

Instalacin de las Web parts


Consulte segn su caso, las 2 secciones a continuacin para las alternativas de instalacin: a partir de
un instalador, o mediante el despliegue manual del archivo WSP.

Tenga en cuenta que la instalacin de las Web parts reiniciar eventualmente sus servicio de
SharePoint.
Por lo tanto, asegrese de planear este paso y de ejecutarlo en un horario no laboral, de manera
que se tomen las medidas apropiadas para la instalacin.

Copyright 2014 - Bizagi

2594

1. Ejecutar el instalador de Web parts


Una vez se haya cumplido con los prerrequisitos, instalar las Web parts de Bizagi para SharePoint se
realiza de manera simple por medio de un instalador.
Para llevarlo a cabo siga estos pasos:
1. Descargue el complemento a manera de instalador de Bizagi Web parts para SharePoint
directamente desde www.bizagi.com.
Recuerde seleccionar el instalador apropiado segn su versin de SharePoint (2013 o 2010).
2. Descomprima el archivo y ejecute el ejecutable para la instalacin de las Web parts (el archivo
Bizagi.SharePoint.Installer2013.exe o Bizagi.SharePoint.Installer2010.exe ):

Un asistente lo guiar en el proceso de instalacin.


D clic en Siguiente (Next).

Copyright 2014 - Bizagi

2595

El instalador ejecutar una verificacin de prerrequisitos para garantizar que estos se cumplan.
Una vez que este paso sea exitoso, d clic en Siguiente (Next).

Copyright 2014 - Bizagi

2596

Igualmente el instalador validar si ya existe una instalacin de Bizagi Web parts.


Al instalarlo por primera vez, no se encontrar una solucin, y podr dar clic directamente en Siguiente
(Next).
Si usted est realizando una actualizacin a una versin ms nueva de Bizagi Web parts, entonces se le
presentar la opcin de escoger una actualizacin (upgrade).

Copyright 2014 - Bizagi

2597

Asegrese de leer y aceptar el acuerdo de usuario final (EULA).


Ntese que tambin puede utilizar el instalador para desinstalar las Bizagi Web parts.
Seleccione los sitios de SharePoint de su coleccin de sitios (o farm) en donde desea instalar las Bizagi
Web parts para SharePoint.

Copyright 2014 - Bizagi

2598

Asegrese de seleccionar tanto las casillas


Bizagi.SharePoint.Widgets.
D clic en Siguiente (Next).

de

Bizagi.SharePoint.WebpartsConfig como

Copyright 2014 - Bizagi

de

2599

Verifique las preferencias de instalacin que ha configurado mediante la pantalla de resumen.


D clic en Siguiente (Next) para iniciar con la instalacin.

Copyright 2014 - Bizagi

2600

Una vez que haya finalizado la instalacin, podr cerrar el asistente.

2. Desplegar manualmente las Web parts


Una vez se haya cumplido con los prerrequisitos, siga estos pasos:
1. Descargue el archivo WSP de despligue de las Web parts de Bizagi para SharePoint directamente
desde www.bizagi.com.
2. Copie el archivo .zip descargado hacia una ruta local de sus servidores SharePoint y descomprmalo
(se recomienda en un servidor que cuente con el rol de administracin central).
La ruta local donde queda este archivo WSP ser referenciada a partir de este momento como:
<BIZAGI_WSP_PATH>.
Ntese que esta accin resulta en la descompresin de 2 archivos WSP.
Para SharePoint 2013, estos son: Bizagi.SharePoint2013.wsp y Bizagi.SHP2013.FieldPass.wsp.
Para SharePoint 2010, estos son: Bizagi.SharePoint.wsp y Bizagi.SharePoint.FieldPass.wsp.

Copyright 2014 - Bizagi

2601

En este ejemplo, nuestra ruta <BIZAGI_WSP_PATH> se define como: C:\Installer\WSP.


3. Ejecute el Management Shell de SharePoint.
Asegrese de ejecutarlo como administrador local.

Copyright 2014 - Bizagi

2602

4. Ejecute el siguiente comando:


Add-SPSolution -LiteralPath <BIZAGI_WSP_PATH>\Bizagi.SharePoint.wsp

Una vez que sea existoso, ejecute tambin el comando:


Add-SPSolution -LiteralPath <BIZAGI_WSP_PATH>
\Bizagi.SharePoint.FieldPass.wsp

Si ya ha instalado previamente las Web parts de Bizagi para SharePoint, y lo que necesita es
actualizarlas (p.e aplicar una nueva versin), entonces ejecute el siguiente comando:
Update-SPSolution -Identity Bizagi.SharePoint.wsp -LiteralPath
<BIZAGI_WSP_PATH>\Bizagi.SharePoint.wsp -GACDeployment
Recuerde que antes deber sacar un respaldo del archivo bizagi.custom.styles.css, si all ha
ingresado personalizaciones a los estilos.

5. Ejecute el SharePoint Central Administration.

6. Navegue hacia la seccin de Configuracin del sistema (System settings), y vaya a las opciones de
Administracin de la Granja (Farm Management).
D clic en la opcin de Administrar soluciones de la granja: Manage farm solutions.

Copyright 2014 - Bizagi

2603

7. Realice el despliegue de las 2 soluciones:


Bizagi.SharePoint.wsp y Bizagi.SharePoint.Fieldpass.wsp.
Primero, haga clic en bizagi.sharepoint.wsp.

Seguidamente, haga clic en Deploy solution para desplegar la solucin,.

Copyright 2014 - Bizagi

2604

Asegrese de seleccionar los sitios especficos donde se quiere incluir las Web parts de Bizagi.
Una vez que haga clic en Ok, tenga en cuenta que el SharePoint Central Administration reiniciar los
pools de aplicaciones cuando se finalice el despliegue, para el sitio Web de SharePoint (lo cual
interrumpe el servicio de sus aplicaciones Web).

Seguidamente asegrese de repetir este paso para la solucin bizagi.sharepoint.fieldpass.wsp.


Esto significa, hacer clic sobre l, y despus sobre desplegar la solucin (Deploy solution) para
ejecutar o programar su despliegue hacia los sitios de SharePoint.
Puede verificar que la instalacin haya sido exitosa, siguiendo los pasos de la seccin a continuacin.

Copyright 2014 - Bizagi

2605

Verificar la instalacin
Puede verificar la correcta instalacin de las Web parts de Bizagi, navegando en su sitio de SharePoint
y revisando que los componentes usados por las Web parts de Bizagi se encuentren activos para su
coleccin de sitios.
Para ello, simplemente acceda desde un navegador a su sitio de SharePoint y vaya a la opcin de
caractersticas de la coleccin de sitios (Site collection features):

En
esta
opcin
se
deben
apreciar
2
caractersticas
de
Bizagi
instaladas:
Bizagi.SharePoint.WebPartsConfig (utilizada para la configuracin central de las Web parts), y
Bizagi.SharePoint.Widgets (el cual contiene las Web parts de Bizagi).

Copyright 2014 - Bizagi

2606

No se requieren acciones en estos pasos de verificacin.


Solo necesitar reactivar las Web parts (usando el botn de desactivar -Deactivate- y luego el de
activar -Activate), para forzar un refresco de informacin, cuando haya instalado un WSP
recientemente, y este archivo WSP contenga nuevas definiciones de Bizagi Web parts.
De manera similar, podr ir al listado de las Web parts que se encuentran disponibles en la galera de
Web parts de SharePoint.

Copyright 2014 - Bizagi

2607

En las Web parts, podr ordenar y filtrar el listado de acuerdo a los que pertenezcan al grupo Bizagi.
Deber ver un listado con los Web parts de Bizagi:

Copyright 2014 - Bizagi

2608

En este punto, hemos finalizado con la instalacin de las Web parts de Bizagi para SharePoint y hemos
verificado la instalacin exitosa de los mismos!
El siguiente paso consiste en realizar la configuracin central de las Web parts, y seguidamente su
diseador Web de SharePoint podr incluir las Web parts en las pginas.
Para ms informacin sobre la configuracin, consulte Configuracin las Web parts.

Configuracin de las Web parts


Esta seccin describe cmo configurar inicialmente las Web parts de Bizagi para SharePoint, una vez
que se haya llevado a cabo la instalacin.
Para ms informacin acerca de la funcionalidad y este paso de instalacin, consulte Instalando las
Web parts.

Lo que debe hacerse


Antes de comenzar a utilizar las Bizagi Web parts, asegrese de realizar la configuracin central (solo
se requiere una vez):. Para especificar los detalles de acuerdo a la conexin entre el servidor
SharePoint y el Portal de Trabajo de Bizagi.

Configuracin central de las Web parts


Los pasos de configuracin descritos a continuacin se llevan a cabo desde un navegador accediendo
al sitio de SharePoint.
1. Ubique la opcin Acciones del sitio (Site actions), y d clic sobre Configuracin del sitio (Site
settings).
Deber ver las Web parts de Bizagi bajo la categora Extensiones para SharePoint (SharePoint
Extensions).
D clic en Bizagi Configuration.

Copyright 2014 - Bizagi

2609

2. Ubique la lista de configuracin llamada Configuration list que se encuentra hacia la derecha, y d
clic sobre ella.
Ver una lista la cual podr tener 1 o ms tems.
3. Adicione un nuevo tem e ingrese los detalles de configuracin (por ej, datos de la conexin) como
se describe a continuacin:
Bizagi project name (Nombre del proyecto de Bizagi): El nombre que identifica al tem de
configuracin (para conectarse a un Portal de trabajo especfico).
Deber ser nico y descriptivo, para que represente fcilmente al proyecto el cul se va a integrar.
Bizagi project URL (URL del proyecto de Bizagi): La URL al Portal de trabajo de Bizagi.
Debe ser especificada como: http://[SERVIDOR_BPM]/[NOMBRE_PROYECTO]
Description (Descripcin): Una descripcin significativa.
Service account (Cuenta del servicio): El nombre de la cuenta utilizada para la conexin a Bizagi.
Considere que esta cuenta de servicio ser empleada en la configuracin y la ejecucin (a pesar de
que las credenciales del usuario en Windows tambin se utilicen para el acceso a el Inbox de Bizagi).
Service password (Contrasea del servicio): La contrasea de la cuenta de servicio usada en la
conexin.
Service domain (Dominio del servicio): El dominio al que pertenece la cuenta de servicio usada en
la conexin.

Copyright 2014 - Bizagi

2610

Haga clic en Guardar (Save) para finalizar con la configuracin central de las Web parts.

Cambios en la lista de configuracin muy probablemente requerirn ejecutar un reinicio de sus


servicios de SharePoint (IISReset).
Ntese que podr:
Usted puede modificar el tem mediante la opcin de editar tem (Edit Item), para administrar los
detalles de la conexin al Portal de Bizagi de su proyecto (editarlos en cualquier momento).
Usted puede optar por adicionar ms tems (si desea integrar ms de un proyecto o Portal de
trabajo de Bizagi).

Copyright 2014 - Bizagi

2611

Consideraciones adicionales
Siga las siguientes recomendaciones cuando utilice las Web parts.
1. Autenticacin Windows
Tenga presente que deber contar con autenticacin tipo Windows en su proyecto de Bizagi. Para ello,
asegrese de lo siguiente:
En Bizagi, deber estar seleccionada la autenticacin Windows:

En la configuracin del IIS, para la autenticacin, la annima deber estar deshabilitada y solamente
deber estar habilitada la tipo Windows:

Copyright 2014 - Bizagi

2612

2. Configuracin ptima en el IIS


Cuando se integra Bizagi para ser utilizado desde portales, se recomienda que se modifique la
configuracin del Portal de trabajo de Bizagi de manera que los recursos en el cach no se eliminen de
una manera muy frecuente, dado que los usuarios no estarn ingresando a Bizagi desde el Portal de
Bizagi con buena periodicidad (por ejemplo, diariamente).
Cuando el portal de Bizagi est configurado en el IIS, se recomienda editar el pool de aplicacin para
que no recicle estos recursos.
Esto significa:
Deshabilitar Recycling por medio de la propiedad Regular time interval que se puede asignar a
cero.
Editar la definicin de Idle Time-out en minutos, de manera que los hilos y el cache de la aplicacin
no se eliminen ante la ausencia de actividad en un periodo corto de tiempo (p.e dos das).

Copyright 2014 - Bizagi

2613

3. Consideraciones de Internet Explorer


Tenga en cuenta que para que las Web parts de Bizagi se muestren, deber utilizar los navegadores
soportados por Bizagi, como se indica en sus requerimientos.
Se soporta Internet Explorer en versiones 8 o superiores, e igualmente deber estar ejecutndose en
un modo de compatibilidad 8 o superior:

Copyright 2014 - Bizagi

2614

3. Configuracin para la funcionalidad de geolocalizacin


Si su proyecto de Bizagi habilita la funcionalidad de geolocalizacin, asegrese de realizar los
siguientes ajustes de configuracin a su sitio de SharePoint:
Edite el archivo web.config de su sitio SharePoint para incluir la siguiente cabecera personalizada
(dentro del elemento <customHeaders>):
<add name="X-UA-Compatible" value="IE=edge" />
Esto significa que deber ubicar el elemento <system.webServer>, y dentro de l, deber contener una
definicin similar a la ilustrada:

Copyright 2014 - Bizagi

2615

Guarde los cambios.


Tenga en cuenta que para que esta opcin funcione, NO deber contener la siguiente directriz en su
pgina master de SharePoint:
<meta http-equiv="X-UA-Compatible" content="IE=8"/>

Propiedades de las Web parts

Introduccin
Para
La
La
Para

comenzar a utilizar las Web parts de Bizagi asegrese de haber llevado a cabo:
instalacin el complemento de Bizagi en SharePoint.
configuracin central de las Web parts.
ms informacin, consulte Bizagi Web parts para SharePoint.

Integre Bizagi dentro de SharePoint


Utilice el poder del mejor BPM en su intranet, simplemente arrastrando las Web parts de Bizagi dentro
de su contenido de SharePoint.
Para comenzar a utilizar Bizagi (p.e, acceder al inbox, trabajar en las tareas pendientes o crear nuevas
solicitudes) directamente desde SharePoint, edite sus pginas para incluir las Web parts de Bizagi y
configurar sus propiedades.
Para hacerlo, su diseador Web de SharePoint tiene 2 posibilidades principales, como se describe a
continuacin a travs del conjunto de 7 Web parts diferentes que ofrece Bizagi.

Copyright 2014 - Bizagi

2616

La primera opcin: el portal de Bizagi como un todo (requiere de mnima


configuracin)
Realice una integracin Bizagi + SharePoint extremadamente gil al incluir una nica Web part llamada
Work portal (portal de trabajo), la cual presenta el portal de Bizagi como un todo, dentro del
contenido de SharePoint.
Esta opcin requiere de mnima configuracin, dado que lo que se hace a travs de esta, es embeber
el Portal de trabajo de Bizagi dentro de una pgina cualquiera.
Esta pgina puede ser una nueva o una existente, pero se recomienda para una mejor usabilidad, que
sea una nueva pgina:

Con este enfoque, puede por ejemplo complementar la integracin apoyndose en un enlace HTML a
esta pgina desde su pgina inicial (home):

Copyright 2014 - Bizagi

2617

Para mayor informacin y ejemplo sobre esta primera opcin, consulte El portal de trabajo como Web
part.

La segunda opcin: Web parts de Bizagi incluidas de manera separada (para


mayor flexibilidad)
Realice una integracin Bizagi + SharePoint extremadamente flexible al incluir varias Web parts (salvo
el de la primera opcin llamado Work portal) de manera separada.
Las otras Web parts disponibles componen a la Web part principal (Work portal), y por lo tanto estas
otras sern referidas como las Web parts especficas.

Copyright 2014 - Bizagi

2618

Estas Web parts especficas son: Activity Form (Forma de la actividad), My Inbox (Mis pendientes),
Case summary (Forma de Resumen del proceso) y Start Process list (Lista para iniciar procesos).
Adems, hay otra web part llamada Start Process button (Botn para iniciar de procesos), la cual
funciona como un atajo que se puede usar con cualquiera de estas 2 opciones presentadas.
La Web part Start Process button le permitir a sus usuarios iniciar instancias de proceso a un solo clic
de botn.

Para mayor informacin y ejemplo sobre esta primera opcin, consulte Opciones de personalizacin y
avanzadas.

Notas adicionales
Bizagi Web parts para SharePoint ofrecen la funcionalidad principal del Portal de trabajo de Bizagi (tal
como: la posibilidad de crear nuevos casos, ver los pendientes, y poder trabajar o completar las
mismas actividades).
Si un usuario requiere de funcionalidad adicional de Bizagi que no est contemplada en lo anterior,
entonces es necesario usar las opciones del Portal de trabajo directamente en Bizagi (como por
ejemplo, las opciones de administracin, de reportes y de consultas).

El portal de trabajo como Web part


El siguiente ejemplo ilustra y provee una gua sobre cmo integrar Bizagi en SharePoint a travs de la
Web part del portal de trabajo (de la manera ms gil y fcil).
Con esta opcin se presenta el portal de trabajo de Bizagi como un todo, dentro del contenido de
SharePoint con mnima configuracin.

Copyright 2014 - Bizagi

2619

Se puede incluir esta Web part en una pgina nueva o existente, sin embargo para una mayor
usabilidad, recomendamos incluirla en una pgina nueva.
Para mayor informacin acerca de opciones avanzadas (para mayor opciones y flexibilidad), consulte
Opciones de personalizacin y avanzadas.

Configurar el Work Portal como Web part


En el siguiente ejemplo, partiremos de tener la intranet corporativa como se ensea:

Copyright 2014 - Bizagi

2620

Lo que queremos, es integrar el Portal de trabajo de Bizagi directamente en SharePoint (una opcin es
directamente en esta pgina y otra opcin es en otra pgina, y referir a esa otra pgina a partir de un
enlace).
Para hacerlo directamente sobre esta pgina, editamos esta pgina para incluir la Web part llamada
Work portal , del set disponible de Bizagi Web parts para SharePoint
Ubicamos esta Web part desde la categora Bizagi para incluirla dentro de la pgina (en una zona
Web part identificada por SharePoint):

Una vez se haya incluido, la Web part se visualiza en modo de edicin y configuracin.
Podr apoyarse en la descripcin y texto de ayuda que se muestra:

Copyright 2014 - Bizagi

2621

Damos clic en la lista desplegable de sus opciones para ir a las opciones de editar la Web part (Edit
Web part).
Ntese que esta accin nos mostrar las propiedades (settings) de la Web part en un panel ubicado a
la derecha de la pantalla:

Copyright 2014 - Bizagi

2622

Dentro de estas propiedades, junto con aquellas que son propias de SharePoint para cualquier Web
part (p.e. propiedades de Apariencia), encontraremos:
GRUPO DE PROPIEDADES
(SETTINGS GROUP)
Bizagi Server settings
(propiedades del Servidor

PROPIEDAD
(SETTING)
Bizagi Server key

Copyright 2014 - Bizagi

DESCRIPCIN

Seleccione
de
desplegable, el

la
tem

lista
que

2623

Bizagi)

Bizagi Web part settings


(propiedades especficas de la
Web part)

representa la conexin al Portal


de trabajo de Bizagi (segn
definido en
la
lista
de
configuracin de Bizagi donde
se ingresaron los detalles de la
conexin).
Cases by page
(casos por pgina)

Defina
cuntos
casos
pendientes(paginados)
desea
que
aparezcan
para
los
usuarios en el Inbox.

Default view
(Vista por defecto)

Seleccione si desea mostrar por


defecto la vista de los casos
por: grilla o por detalle.

Show view toggler


(Mostrar el switch para cambio
de vista)

Al activarse, el Portal de trabajo


mostrar un cono para permitir
a los usuarios finales el cambio
de vista en cualquier momento:
cambiar a vista de grilla o de
detalles.

Para configurar la Web part:


Asegrese de asignar el valor correspondiente a la conexin de su proyecto, en la propiedad Bizagi
server key.
Puede optar por dejar los dems valores por defecto y dar clic en OK.
En este punto, ya hemos configurado el Work portal como una Bizagi Web part!
Una vez que se guarden los cambios en la pgina (y eventualmente se realice un check-in y una
publicacin del contenido), los usuarios finales harn log in una sola vez en SharePoint y podrn tener
acceso a su Inbox de Bizagi (as como se trabaja desde el Portal de Bizagi).
Para ms informacin sobre las funcionalidades y opciones del Portal de trabajo de Bizagi, consulte el
Portal de trabajo.

Copyright 2014 - Bizagi

2624

Copyright 2014 - Bizagi

2625

Recuerde que otra opcin ser usar una pgina dedicada a contener la web part del portal de Bizagi, y
emplear un enlace desde su home para ir a dicha pgina:

Copyright 2014 - Bizagi

2626

Qu sigue?
Ntese que puede optar por personalizar los estilos utilizados por el Web part.
Si no desea utilizar los estilos por defecto, consulte los Estilos en las Web parts.

Opciones de personalizacin y avanzadas


Esta seccin describe las opciones adicionales que podemos utilizar cuando se integra el Portal de
trabajo de Bizagi en SharePoint a travs de diversas Web parts especficas.
Estas opciones avanzadas le ofrecen al diseador Web de SharePoint mayor flexibilidad para:
Poder personalizar dnde se muestran exactamente cada una de las Web parts que hacen parte del
Portal de trabajo de Bizagi.
Decidir si desea que cierta parte de informacin no se muestre en determinadas pginas.

Copyright 2014 - Bizagi

2627

Copyright 2014 - Bizagi

2628

Ntese que en la imagen ejemplo de arriba, el inbox se presenta mostrando 5 casos (paginados).

Web parts especficas


Tenga en cuenta que al incluir las Web parts de Bizagi en pginas en SharePoint, puede optar por
incluirlas separadamente del set de 6 Web parts llamadas: Activity Form (Forma de la actividad), My
Inbox (Mis pendientes), Case summary (Forma de resumen), Start Process button (Botn para iniciar de
procesos), Start Process list (Lista para iniciar procesos).

Si se realiza de esta manera, podr construir el Portal de Bizagi manualmente (en vez de utilizar
directamente la Web part llamada Work portal , la cual ya es unificada a partir de las anteriores).
De la otra manera y si desea incluir automticamente el Portal de trabajo de Bizagi como un todo de
manera ms gil y fcil, consulte El portal de trabajo como Web part.

1. My Inbox (Mis pendientes)


Esta Web part muestra el listado de casos pendientes de un usuario (su Inbox).
En esta Web part, el usuario final visualiza una lista de sus actividades (de acuerdo a la fecha de
vencimiento de las mismas o de acuerdo a un proceso especfico).

Copyright 2014 - Bizagi

2629

Recuerde que el inbox de Bizagi se puede visualizar bajo 2 vistas diferentes: en grilla o por detalles, y
podr igualmente alternarlas:

Al hacer clic en una actividad pendiente de un caso, la Web part llamada Case summary mostrar la
informacin adicional.
Tenga en cuenta que esta Web part tiene algunas propiedades las cuales requieren de configuracin
adicional (como se describe en la siguiente seccin: Propiedades de las Web parts).

2. Activity form (Forma de actividad)


Esta Web part permite a los usuarios trabajar en las actividades pendientes (esto incluye tambin la

Copyright 2014 - Bizagi

2630

actividad relacionada con iniciar un proceso).


Esta Web part se muestra cuando un usuario da clic directamente en una actividad pendiente o cuando
crea un nuevo caso (sea por medio de las Web parts: Work Portal, Case summary, Start process
button o Start process list.
A travs de ella, el usuario ingresa la informacin de negocio correspondiente al caso, y guarda el
progreso o completa la actividad (Save o Next).
Para esta Web part especficamente, es posible configurar que se muestre como una ventana pop-up,
en una pgina diferente (especialmente til cuando se tienen formas extensas -con mucha
informacin-), o directamente en la misma pgina desde donde se da clic.

Tenga en cuenta que esta Web part tiene algunas propiedades las cuales requieren de configuracin
adicional (como se describe en la siguiente seccin: Propiedades de las Web parts).

3. Case summary (Forma de resumen)


Esta Web part provee a los usuarios finales la forma de resumen del caso, para que puedan decidir si
desean trabajar en dicho caso (haciendo clic en el botn de Trabajar en l).
Esta Web part es muy til para presentar informacin adicional de negocio, cuando los usuarios la
requieren para conocer ms sobre el caso y determinar si desean trabajar sobre el caso.
Esta es visible por defecto en el Inbox sobre la parte derecha de la pantalla, cuando se tiene la vista en
modo de detalles; y es visible en la vista en modo grilla cuando se da clic sobre el botn para trabajar
sobre el caso.

Copyright 2014 - Bizagi

2631

Al seleccionar y hacer clic para trabajar en el caso, la Web part llamada Activity form se mostrar.
Tenga en cuenta que esta Web part tiene algunas propiedades las cuales requieren de configuracin
adicional (como se describe en la siguiente seccin: Propiedades de las Web parts).

4. Start process list (Lista para iniciar procesos)


Esta Web part provee a los usuarios finales la lista de procesos a partir de los cuales pueden iniciar
nuevos casos.
Esta Web part presenta el listado de procesos junto con las opciones para filtrarlos, como por
ejemplo, para ver los procesos utilizados recientemente.
Esta Web part es especialmente til cuando los usuarios cuentan con varios tipos de procesos que
pueden iniciar, de lo contrario puede ser una mejor opcin utilizar directamente la Web part llamada
Start Process button.
Al seleccionar y hacer clic en el proceso a iniciar, la Web part llamada Activity form mostrar la
informacin adicional correspondiente a la primera actividad de ese proceso.

Copyright 2014 - Bizagi

2632

Tenga en cuenta que esta Web part tiene algunas propiedades las cuales requieren de configuracin
adicional (como se describe en la siguiente seccin: Propiedades de las Web parts).

5. Start process button (Botn para iniciar procesos)


Esta Web part provee a los usuarios finales la posibilidad de iniciar nuevos casos de un proceso
predefinido, haciendo tan solo un clic de botn.
Esta Web part presenta un botn con una etiqueta opcional, a travs del cual los usuarios tienen un
atajo, el cual es especialmente til cuando los usuarios normalmente crean casos de un solo tipo de
proceso.
De lo contrario, puede ser una mejor opcin utilizar la Web part llamada Start Process list.
Al hacer clic en el botn, la Web part llamada Activity form mostrar la informacin adicional
correspondiente a la primera actividad de ese proceso.

Tenga en cuenta que esta Web part tiene algunas propiedades las cuales requieren de configuracin
adicional (como se describe en la siguiente seccin: Propiedades de las Web parts).

Interaccin entre las Web parts


El siguiente diagrama ilustra cmo interactan las Web parts separadamente (las dependencias que
tienen entre s):

Copyright 2014 - Bizagi

2633

Propiedades de las Web parts


Para incluir Web parts en una pgina, tenga en cuenta que lo puede hacer tanto para pginas
existentes como para pginas nuevas. Si va a crear pginas nuevas para ello, se puede optar por
utilizar una Web part con un layout estilo "Header, Left column, Body" (encabezado, columna izquierda,
y cuerpo del documento):

Incluir las Web parts se realiza dando clic en las secciones demarcadas con Add Web part, y

Copyright 2014 - Bizagi

2634

seguidamente escogiendo de la categora Bizagi:

Para la configuracin de las Web parts de Bizagi, d clic en el cono de la lista desplegable y en la
opcin de editar la Web part (Edit Web part):

Copyright 2014 - Bizagi

2635

Seguidamente, configure las propiedades de las Web parts en el panel de Settings que aparece a la
derecha de la pgina en edicin.
La siguiente tabla lista las opciones de configuracin para estas Web parts:

GRUPO DE
PROPIEDADES
(SETTINGS
GROUP)

PROPIEDA
D
(SETTING)

DESCRIPCIN

APLICA PARA

Bizagi Server
settings
(propiedades
del Servidor
Bizagi)

Bizagi Server Seleccione de la lista desplegable, el tem que Todas las Web
key
representa la conexin al Portal de trabajo de parts de Bizagi.
Bizagi (segn definido en la lista de
configuracin de Bizagi donde se ingresaron los
detalles de la conexin).

Bizagi Form
settings
(propiedades
para las formas)

On-click
action
(accin
disparada al
hacer clic
sobre l)

Seleccione si desea abrir informacin adicional


dentro de una ventana pop-up (en cuyo caso,
no se requiere ms configuracin).
Tal informacin adicional corresponde a las
formas de las actividades (Web part llamada
Activity form), que se muestra cuando un
usuario desea trabajar en un caso pendiente, o
cuando se crea un nuevo caso.

Work portal,
Case summary,
Start process
list,
Start process
button.

Si no desea mostrar esta informacin como una


ventana pop-up, seleccione No (Show the form
activity action as pop-up? = No).
Seguidamente, especifique si desea abrir la
informacin adicionalen una pgina aparte
(Open another page).
Para abrirla en una pgina aparte, asegrese de
haber creado esa otra pgina y que sta incluya
la Web part llamada Activity form. Deber
especificar el nombre de esta otra pgina en la
propiedad.
Bizagi Web part
settings
(propiedades
especficas de la
Web part)

Cases by
page
(casos por
pgina)

Defina cuntos casos pendientes (paginados) Work portal,


desea que aparezcan para los usuarios en el My Inbox.
Inbox.

Default view
(Vista por
defecto)

Seleccione si desea mostrar por defecto la vista Work portal,


de los casos por: grilla o por detalle.
My Inbox.

Show view
toggler
(Mostrar el
switch para

Al activarse, el Portal de trabajo mostrar un Work portal,


cono para permitir a los usuarios finales el My Inbox.
cambio de vista en cualquier momento: cambiar
a vista de grilla o de detalles.

Copyright 2014 - Bizagi

2636

cambio de
vista)
Appearance,
Layout and
Advanced
(Apariencia,
layout y
avanzados)

Las propiedades de estos grupos son estndar Todas las Web


en SharePoint.
parts en
Al utilizar las Web parts de Bizagi, puede optar SharePoint.
por configurar de ellos, propiedades como: su
ttulo, ancho y alto, y si el ttulo y los bordes se
muestran o no ("Chrome type").
Por ejemplo, seleccione Chrome type =
None para especificar que no se muestre ttulo y
borde.

Una vez que se haya configurado la Web part, guarde los cambios editados.
Tenga en cuenta que se debe realizar la configuracin para cada una de las Web parts en la pgina, y
despus hacer el check-in de los cambios.
En la ilustracin de abajo, vemos un ejemplo usando 4 web parts de Bizagi: 3 de tipo Start process
button y una del Inbox:

Copyright 2014 - Bizagi

2637

Copyright 2014 - Bizagi

2638

En este punto, hemos finalizado la configuracin de Bizagi Web parts con opciones personalizadas!

Qu sigue?
Puede personalizar el estilo (colores y layout de diseo) de las Web parts.
Para ello, consulte Estilos en las Web parts.

Estilos en las Web parts

Introduccin
Bizagi Web parts para SharePoint proveen opciones poderosas de integracin sin la necesidad de
programar.
Esta es una funcionalidad incluida en el producto por defecto, que promueve una gil y fcil
integracin de Bizagi dentro de portales, con Web parts que incluyen un estilo por defecto compatible
con ambientes de SharePoint.
Para ms informacin, consulte Bizagi Web parts para SharePoint.
Si su sitio corporativo de SharePoint cuenta con lineamientos de apariencia especficos (p.e, una gua
explcita para la hoja de estilos) o si desea personalizar los estilos por defecto, lo puede realizar con
los pasos enumerados en esta seccin.

Importante
Las Web parts de Bizagi proveen unos estilos por defecto que van en sincrona con los estilos por
defecto de SharePoint y cumplen con las directrices de buenas prcticas en CSS para no afectar los
dems elementos en una pgina Web.
Dentro de la personalizacin de estilos empleados por la pgina maestra (master page and layout) de
su sitio, recuerde seguir buenas prcticas de CSS y revisar que sus estilos no afecten a los de Bizagi de
una manera no deseada.
No es responsabilidad de Bizagi que sus estilos afecten las Web parts de Bizagi de una manera no
controlada.

Cmo se muestran las Web parts?


Al incluir las Web parts de Bizagi (todas, salvo la Web part botn para iniciar casos), stas sern
incluidas en la pgina dentro de un elemento iframe de HTML.
Por lo tanto, los estilos del sitio como tal en SharePoint no afectan la visualizacin del contenido de
Bizagi al interior del iframe.
Para llevara a cabo las personalizaciones, siga las recomendaciones a continuacin.

Personalizacin de estilos
Para personalizar los estilos de las Web parts de Bizagi o incluir un tema diferente para adaptar Bizagi
a sus colores corporativos, edite el archivo bizagi.webpart.override.css ubicado en el servidor BPM de
su proyecto Bizagi. La ruta es:
[RUTA_PORTAL_BIZAGI]\jquery\overrides\css\desktop\portal\common\

Copyright 2014 - Bizagi

2639

(por defecto ubicado como C:\BizAgi\Enterprise\Projects\[SU_PROYECTO]\WebApplication\jquery


\overrides\css\desktop\portal\common\bizagi.webpart.override.css).
En dicho archivo, usted podr sobreescribir los estilos de las clases CSS definidas en las Web parts.
Las definiciones de estilos en este archivo llamado bizagi.custom.styles.css sobrescribirn la hoja de
estilos por defecto.
Guarde los cambios y cierre este archivo.
Podr tener definiciones similares a la siguiente imagen:

Copyright 2014 - Bizagi

2640

Copyright 2014 - Bizagi

2641

En este punto hemos configurado un estilo diferente al por defecto, en las Web parts de Bizagi!

Consideraciones
1. Ntese que para ver los cambios de estilo en las Web parts, debe limpiar el cach del navegador si
previamente ya haba cargado este sitio antes de los cambios.

Copyright 2014 - Bizagi

2642

2. Se recomienda realizar un backup al archivo bizagi.custom.styles.css antes de realizar actualizaciones


a nuevas versiones de Bizagi como medida de contingencia.
Una vez haya actualizado a la versin ms reciente, puede reemplazar este archivo con el backup que
tom.
Si desea hacer ajustes y personalizaciones al diseo en cuanto a cmo se muestran los Web parts
(propiedades bsicas de posicin, relacionadas al alto, ancho, u otros ajustes diferentes a colores),
consulte la Personalizacin del diseo.

Personalizacin del layout

Introduccin
Una vez que tenga las Web parts en el diseo de sus pginas, puede optar por personalizar ciertas
propiedades tanto para: utilizar colores diferentes a los asignados por defecto, o para realizar
algunos ajustes especficos de diseo en la apariencia general.
Esta seccin provee ejemplos y lineamientos para realizar ajustes personalizados en la apariencia
general de las Web parts, tales como sobrescribir sus dimensiones (alto o ancho), o cambiar otras
propiedades bsicas del diseo.

Importante
Antes de continuar, tenga en cuenta que se recomienda revisar Estilos de las Web parts donde se
describe cmo sobrescribir la definicin de estilos por defecto.
Tenga en cuenta que la ubicacin del archivo involucrado para ello, es el mismo que se usa para el
cambio de tema y color indicado en el enlace anterior (por defecto en C:\BizAgi\Enterprise\Projects
\[SU_PROYECTO]\WebApplication\jquery\overrides\css\desktop\portal\common
\bizagi.webpart.override.css).
Adems de lo anterior, recomendamos utilizar las herramientas de depuracin de Google Chrome
para inspeccionar los elementos HTML y las clases que se utilizan.
Esto implica que debe estar familiarizado con estas opciones provistas en Chrome al presionar la tecla

Copyright 2014 - Bizagi

2643

F12:

Estas opciones son fundamentales para ayudarlo a observar de cerca las propiedades y clases que
usan las Web parts de Bizagi.
Esto es de mayor utilidad especialmente cuando se adicionan las Web parts directamente en el
contenido enriquecido de sus pginas (cuando no se adicionan las Web parts en Web part zones
preasignadas e identificadas por SharePoint).

Personalizacin del Inbox


Para las Web parts que muestran el Inbox de Bizagi, usted puede personalizar su ancho y alto. Por
ejemplo, para que estas dimensiones se ajusten completamente a algn espacio determinado en la
pgina que sea menor a las dimensiones mnimas asignadas por Bizagi (por defecto).
Tenga en cuenta que el tamao mnimo del Inbox es de 400 pxeles y que podr sobreescribir esta
definicin al incluir las siguientes lneas:
//No utilizar un alto o ancho mnimo para el contenedor principal del
inbox, y tampoco usar bordes, para que el contenido se ajuste segn el
lmite
.ui-bizagi-sharepoint-webpart-parentdiv
{
min-width: 0px;
min-height: 0px;
border:0;
}
//Forzar un tamao fijo en la tabla de casos del inbox, y habilitar el
scroll si la informacin excede el alto asignado
.ui-bizagi-webpart-cases-view-container
{
height: 317px;
overflow-y:auto;

Copyright 2014 - Bizagi

2644

El inbox despliega automticamente la informacin tal como se ha definido para ser mostrada en el
inbox del portal de trabajo en Bizagi.
Recuerde que puede seleccionar qu informacin se muestra en el inbox, por medio de la
personalizacin de columnas.

Personalizacin para Start Process button


Especficamente para la Web part llamada Start Process button, ntese que es posible personalizar el
alto y el ancho del botn para iniciar casos.
Para ello puede utilizar las siguientes opciones:
//Ajustar de manera automtica el tamao del botn
#btnNewCase {
width: auto;
height: auto;
}
//Ajustar el tamao del contenedor (div) del botn
.ui-bizagi-sharepoint-createNewCaseButton{
min-height:0px;
min-width:0px;
overflow:hidden;
}

La personalizacin de los botones, puede hacerse en el archivo ubicado por defecto en C:\BizAgi
\Enterprise\Projects\[SU_PROYECTO]\WebApplication\jquery\overrides\css\desktop\sharepoint
\common\bizagi.webpart.override.css, dado que estos no quedan dentro de un iFrame.

Copyright 2014 - Bizagi

2645

Lineamientos
Siga estas recomendaciones cuando se deseen modificar las propiedades que afectan el layout, de
manera que usted pueda tener un mayor control sobre en qu lugares especficos se estn alterando
las propiedades por defecto.
1. Evite sobrescribir estilos generales para: todas las tablas (<table>, <tr>, <td>), divisiones (<div>) o
del cuerpo del HTML (<body>).
2. En lo posible defina las propiedades para las clases incluyendo explcitamente un contexto.
Especialmente cuando se tiene ms de un Web part de Bizagi y se quiere ajustar los estilos solo a uno
de ellos.
Entonces deber definir las personalizaciones para que apliquen nicamente a ciertas clases cuando
estn dentro de cierto elemento (referenciado por su Id).
En el ejemplo anterior, significara definir los estilos de la siguiente manera:
#[idElemento] .ui-bizagi-sharepoint-createNewCaseButton {
...
}
3. Considere previamente los estilos que pueden generar conflicto con aquellos que desea sobrescribir
en Bizagi y aquellos que estn dados por la pgina master en SharePoint.
4. Se recomienda enfticamente incluir las Web parts de Bizagi dentro de las Web part zones que
identifica SharePoint para el contenido de sus pginas.
De esta manera, SharePoint y sus opciones para el diseo de pginas, podrn manejar
adecuadamente las propiedades de estilo y edicin de apariencia en general.
Como recomendacin adicional, tambin se lista el ancho mnimo (y alto mnimo) que deben utilizar las
Web parts de Bizagi por defecto.

WEB PART

ANCHO MNIMO

ALTO MNIMO

Work portal

970 px

400 px

My Inbox, Case summary,


Activity form

264 px

400 px

Start process list, Start process


button

264 px

40 px

Uso de Web parts desde portales

Introduccin
La arquitectura de Bizagi ofrece un poderoso servicio grfico que promueve una reusabilidad fcil e
integracin con otras aplicaciones.
Esta reusabilidad esta reforzada con las capacidades provistas por los Web parts de Bizagi.
Esta seccin describe cmo reutilizar fcilmente los Web Parts de Bizagi, para que puedan ser
integrados en cualquier portal.
A travs de este enfoque, los usuarios finales pueden acceder al portal corporativo y desde all,

Copyright 2014 - Bizagi

2646

trabajar en sus casos de Bizagi.

Qu se necesita hacer
Los siguientes pasos se llevan a cabo para integrar los Web Parts de Bizagi dentro de su portal:
1. Asegrese de tener un mecanismo de autenticacin SSO para los portales.
Usted necesitar depender de un mecanismo de autenticacin de Single Sign-Onpara compartir la
autenticacin entre su portal y el Portal de Trabajo de Bizagi
2. Edite el contenido del portal para crear una instancia de los Web Parts de Bizagi.
Usted necesitar incluir cdigo en el contenido de su portal, de tal manera que se cree una instancia
de los Web Parts de Bizagi desde el cdigo javascript.

Copyright 2014 - Bizagi

2647

Antes de empezar
Considere lo siguiente para el enfoque de integracin presentado a continuacin:
Para integrar Bizagi directamente en el contenido de su portal a travs de los Web Parts, se debe
realizar estrictamente dentro de iframes de HTLM (o en pginas que solo tenga a Bizagi en su
contenido).
Esto es debido a que los Web Parts de Bizagi permiten incrustar la interfaz grfica de Bizagi la cual,
especifica su comportamiento. La inclusin de estos Web Parts en el contenido, est sujeta ser alterada
por el comportamiento y los estilos de la pgina que la contiene, esto no es recomendado.

Procedimiento
Para integrar los Web Parts de Bizagi, siga los siguientes pasos:

1. Asegrese de tener un mecanismo de autenticacin SSO para los portales.


Para enfocar y dar una gua en esta seccin, se requiere que use la autenticacin de Windows en su
portal y en el de Bizagi.
En su proyecto de Bizagi, asegrese de usar la autenticacin de Windows en el mdulo de Seguridad:

2. Edite el contenido del portal para crear una instancia de los Web Parts de
Bizagi.
Edite el contenido de su portal (esto puede ser realizado usando un IDE o el editor de su eleccin, o

Copyright 2014 - Bizagi

2648

directamente en el Mdulo de Administracin de su portal). Mientras est editando el contenido del


portal, siga estos pasos:
2.1 Invoque los Web Parts de Bizagi usando el siguiente cdigo de javascript:
function ManageIframe() {
var loc = window.location.toString();
var params = loc.split('?')[1];
var iframe = document.getElementById('internaliFrame');
var bizagiRenderUrl = "http://[BIZAGI_SERVER]/[BIZAGI_PROJECT]/jquery/
webparts/desktop/portal/pages/webpart.htm?type=[WEB_PART]";
iframe.src = bizagiRenderUrl + '&' + params;
}
window.onload = function () {
ManageIframe();
};
Observe que en el cdigo anterior, debe considerar asignar valores a:
[BIZAGI_SERVER]: Su servidor BPM donde el proyecto de Bizagi est configurado.
[BIZAGI_PROJECT]: Su proyecto de Bizagi.
[WEB_PART]: El nombre interno del Web Part. Para usar el Portal de Trabajo de Bizagi, este calor se
debe especificar como workportal.

El cdigo presentado, puede ser aadido dentro de una pgina creada en su Portal Corporativo o a
travs de un Archivo JS, para hacer la primera opcin, agregue el cdigo entre las siguientes
etiquetas HTML:
<script language="javascript" type="text/javascript">
// Agregue su cdigo javascript aqu
// ..
</script>
Para hace la segunda opcin, cree un archivo usando un Editor de Texto y gurdelo en la carpeta
Javascript de su Portal Corporativo con extensin .js.
2.2 Agregue el elemento iframe de HTML, el cul corresponde a la seccin donde se muestra el
contenido de los Web Parts de Bizagi.
Para hacer estTo do this, edit the web page's code where you will want to display Bizagi.
Establezca una localizacin dentro de su pgina web donde se representar el contenido de Bizagi y
agregue el siguiente cdigo HTML:
<div>
<iframe id="internaliFrame" style="width: 100%; height: 100%"
frameborder="0" src="">
</iframe>
</div>

Copyright 2014 - Bizagi

2649

Si desea cambiar el id del iframe presentado en el cdigo anterior, debe poner el mismo nombre
en el cdigo js que crea la instancia de Bizagi presentado en el paso 1.1, especficament en la lnea
var iframe = document.getElementById('internaliFrame');

Ejemplo
Para mostrar cmo crear una instancia de los Web Parts de Bizagi desde un portal externo, usaremos
un Portal de Intranet como ejemplo.
Se usa Autenticacin de Windows tanto como para el Portal como para nuestro proyecto de Bizagi.
Para ms informacin sobre la configuracin de la Autenticacin de Windows, dirjase a Autenticacin
de Windows.
En este porta, tenga en cuenta que creamos y manejados las pginas web directamente en el mdulo
de administrador.
Para este ejemplo, creamos una pgina llamada Bizagi BPM y vamos a crear una instancia de Bizagi
usando Web Parts en ella.
El primer paso presentado anteriormente, es editar el contenido del portal para mostrar el Web Part
de Bizagi.
En nuestro caso, desde el mdulo de Administracin, debemos editar la pgina Bizagi BPM. En la
siguiente imagen, usted ver las dos partes de este paso.

La parte 1. en la imagen aterior, corresponde al cdigo en js que crea una instancia de Bizagi
directamente en el portal, seleccionamos workportal como el tipo de Web Part. La parte 2.
corresponde al elemento donde el Web Part de Bizagi ser representado, usted es libre de

Copyright 2014 - Bizagi

2650

personalizar el ancho y el alto, as como tambin, la posicin del iframe. En este ejemplo, la pgina
se ver como una pgina con solo un ttulo (Bizagi BPM) y el iframe.
Recuerde que necesita agregar la URL de su proyecto de Bizagi para crear una instancia de los
servicios.

Una vez este paso se ha completado, nuestro portal corporativo con el Web Part de Bizagi, se ver as:

Como seleccionamos workportal en el tipo de Web Part, tenemos disponibles las mismas opciones
que en el Portal de Trabajo de Bizagi, dependiendo del tipo seleccionado, ser presentado de
diferentes maneras.

Copyright 2014 - Bizagi

2651

Detalle de las Web parts y personalizacin

Resumen
Bizagi ofrece los Web parts para dar una opcin de integracin poderosa sin necesidad de
programar.
Los Web parts son una caracterstica nativa que provee una rpida y fcil integracin de Bizagi en
portales y que incluyen una hoja de estilos predeterminada para los ambientes externos.
Si su sitio corporativo tiene guas de estilo especficas o si desea incluir personalizaciones adicionales,
usted puede personalizar las diferentes caractersticas de los Web parts de Bizagi.
Tambin, puede personalizar aquellas caractersticas que no estn definidas a travs de las
propiedades de los Web parts sino a travs de estilos web, por ejemplo: colores, ancho o hacer
ajustes especficos a la apariencia general de los mismos.
Este artculo provee una gua y unos ejemplos de cmo realizar ajustes especficos en toda la
apariencia, como sobrescribir los valores predeterminados de alto, ancho u otras propiedades del
diseo.

Importante
Para sobre escribir los estilos predeterminados, tenga en cuenta que los archivos css se encuentran de
manera predeterminada en la ruta: C:\BizAgi\Enterprise\Projects\[YOUR_PROJECT]\WebApplication
\jquery\overrides\css\desktop\portal\common\bizagi.webpart.override.css.
Adicionalmente, tenga en cuenta que recomendamos el uso de la herramienta de depuracin de
Google para inspeccionar cules elementos de HTML y cules clases desea ajustar y sobrescribir.
Esto quiere decir que se necesita que est familiarizado con las herramientas proporcionadas por la
tecla F12:

Estas opciones le ayudaran a ver ms de cerca las clases y propiedades incluidas en los Web parts de
Bizagi y es prctico cuando se agregan Web parts al contenido de sus pginas.

Copyright 2014 - Bizagi

2652

Personalizacin del Inbox


Cuando se muestra el Inbox de Bizagi, usted podr configurar tanto su ancho como su alto, de tal
forma que se ajuste completamente a un espacio asignado que sea ms pequeo que los valores
asignados por defecto.
Observe que el alto mnimo predeterminado del Inbox es de 400 pixeles y usted puede sobre escribir
esto incluyendo las siguientes lneas:
//No use altura o anchura mnima, ni bordes en el contenedor principal del
inbox, para que este se ajuste al espacio asignado
.ui-bizagi-sharepoint-webpart-parentdiv
{
min-width: 0px;
min-height: 0px;
border:0;
}
//Establezca el tamao dado de la tabla contenedora del inbox y muestre una
barra de desplazamiento si la informacin contenida supera esta altura
.ui-bizagi-webpart-cases-view-container
{
height: 317px;
overflow-y:auto;
}

El inbox mostrar automticamente la informacin de negocio como se haya establecido en el inbox


del portal de trabajo de Bizagi.
Recuerde que tambin puede seleccionar exactamente qu informacin quiere mostrar en el inbox
usando Columnas personalizadas.

Copyright 2014 - Bizagi

2653

Personalizacin de estilos de diseo


Siga la siguiente gua cuando vaya a modificar las propiedades del diseo, para tener un control
completo de dnde est modificando la apariencia.
1. Evite definir estilos generales que puedan afectar todas las tablas (<table>, <tr>, <td>), divisiones
(<div>) o contenidos del cuerpo de HTML (<body>).
2. Siempre intente definir propiedades para las clases usando un contexto especfico.
Esto significa que si est incluyendo ms de un Web part de Bizagi, deba asegurarse de que la
modificacin de estilos aplique para cada contenedor (p.ej, modificando clases solo cuando estn
dentro de elementos especficos).
En nuestro ejemplo, esto quiere decir que debe definir los estilos de esta manera:
#[id_Element] .ui-bizagi-sharepoint-createNewCaseButton {
...
}
Esto es til cuando, por ejemplo, usa ms de un Inbox de Bizagi a lo largo de los diferentes contenidos
del portal.
3. Considere cules estilos pueden generar conflictos con aquellos que quiere sobrescribir en Bizagi y
aquellos que sean de las pginas de su portal.
4. Es muy recomendado incluir los Web parts una zona del contenido de su pgina.
De esta manera, su portal y las opciones de diseo pueden manejar mejor la apariencia y los dems
ajustes.
Una recomendacin adicional es recordar el ancho y el alto mnimo de los Web parts de Bizagi como
se detallan a continuacin.

WEB PART

ANCHO MNIMO

ALTO MNIMO

Work portal

970 px

400 px

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

Copyright 2014 - Bizagi

2654

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 Reportes del Portal de Trabajo.

Los reportes se clasifican en:


BAM: Business Activity Monitoring o BAM 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 contadores y cronmetros.
Mis reportes: Permite acceder a sus informes guardados previamente. (por usuario).

BAM
Business Activity Monitoring 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 Recursos: permite analizar la carga de trabajo actual y el rendimiento de los usuarios
finales y los equipos de trabajo.

Copyright 2014 - Bizagi

2655

El tiempo de ejecucin real de un Proceso o Tarea se calcula con base en el Esquema Estndar de
horario de trabajo, sin importar que existan otros esquemas de horario.

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 2014 - Bizagi

2656

BAM de Tareas
Este reporte le permite analizar el estado actual de las tareas en curso. Puede realizar dos tipos de
anlisis:
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
casos que se vencen cada da.

Copyright 2014 - Bizagi

2657

Anlisis de Carga:. Cada tarea manual posee un resumen, oculto por defecto. Este resumen muestra
el nmero de casos que estn a tiempo, en riesgo y vencidos. Para mostrar el resumen, posicione el
puntero sobre una tarea.
Para acceder a la lista de casos asociados en cada estado, haga clic en el icono de lupa.

Copyright 2014 - Bizagi

2658

Cada diagrama contiene una tabla de tareas en la parte inferior. Para cada tarea se muestra el nmero
de casos a tiempo, en riesgo y vencidos.

Monitor de recursos
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: Para cada tarea en curso del proceso, el reporte presenta grficamente los
usuarios asignados y el estado de sus actividades pendientes.
Un grfico de barras muestra el nmero de casos que estn a tiempo, en riesgo y vencidos para cada
usuario.
Puede seleccionar una tarea especfica para analizarla independientemente, haciendo clic en el
diagrama de proceso.

Copyright 2014 - Bizagi

2659

Si ninguna actividad ha sido seleccionada, el informe mostrar todas las tareas abiertas del proceso
con sus asignados.

Copyright 2014 - Bizagi

2660

Puede filtrar el informe por cualquier Dimensin para mostrar la informacin de los usuarios que
cumplen con los criterios definidos.

Copyright 2014 - Bizagi

2661

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 se mostrar en blanco. Se debe
seleccionar al menos una dimensin con el fin de mostrar informacin. El sistema presenta un
informe individual para cada usuario. Usted puede ver grficamente, el estado de la tarea asignada
al usuario, en cada uno de los procesos.

Mi equipo: Este 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. De lo contrario, este
reporte NO se mostrar.
El reporte muestra un informe individual para cada usuario. Usted puede ver grficamente, el estado
de las tareas que el usuario tiene asignadas, especificando el proceso y la tarea.

Copyright 2014 - Bizagi

2662

Detalles de los casos


Haga clic en cualquier grfico para 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.

Copyright 2014 - Bizagi

2663

1. Haga clic en el nmero de caso para acceder a un caso especfico.

2. Haga clic en Vista para ver el estado del caso dentro del proceso y de su trayectoria.

Copyright 2014 - Bizagi

2664

3. Haga clic en Admin para acceder a la pgina de administracin de casos 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.

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: Anlisis de Procesos y Anlisis de
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.

El tiempo de ejecucin real de un Proceso o Tarea se calcula con base en el Esquema Standard de
horario de trabajo, sin importar que existan otros esquemas de horario.

Copyright 2014 - Bizagi

2665

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
promedio, duracin esperada, la desviacin estndar y el nmero de casos terminados a tiempo. Los
casos terminados NO incluyen los casos abortados.
El histograma de Duracin de casos compara la duracin promedio versus la duracin prevista de los
casos cerrados.
El grfico circular de Estado de Casos muestra el porcentaje de casos cerrados a tiempo en
comparacin con el porcentaje de casos cerrados cerrados vencidos.

Copyright 2014 - Bizagi

2666

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. Esta separa los casos cerrados
a tiempo de los casos cerrados vencidos.

Actividad de Proceso
Este reporte muestra un resumen que 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.
El histograma de actividad del proceso compara los casos abiertos, cerrados y abortados en un
periodo de tiempo.
El grfico de Tendencia muestra la tendencia de creacin de casos en un periodo de tiempo.

Copyright 2014 - Bizagi

2667

Ranking de activaciones
Un grfico de barras muestra el nmero de casos creados para todos los procesos del proyecto. El
grfico est ordenado descendentemente por nmero de creacin.

Caminos frecuentes
Este reporte muestra los caminos ms frecuentes de un proceso especfico. Esta opcin le permite

Copyright 2014 - Bizagi

2668

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 muestrab en este informe.
Bizagi identifica y muestra los caminos ms frecuentes en el proceso. Se calcula el porcentaje de casos
cerrados que pasaron por una ruta especfica, entre todos los casos cerrados para el proceso (los
casos no abortados).
En el ejemplo, se puede comprobar que el 64,8% de los casos han pasado por el camino marcado
(aprobado con anticipo y con reservas). De este resultado se puede inferir 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
Corporativas para todos los empleados que viajan.

Tambin puede verificar los otros caminos que se han utilizado con frecuencia y obtener su porcentaje
de uso. Bizagi resaltar cada uno de los caminos. En la siguiente imagen, el usuario puede comprobar
que el 35% de los casos no fueron aprobados.

Copyright 2014 - Bizagi

2669

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 pasaron por la tarea entre
todos casos cerrados).

Copyright 2014 - Bizagi

2670

Detalles de casos
Para obtener ms informacin sobre los casos incluidos en cada informe, haga clic en los grficos.
Esto 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.

Al hacer clic en el icono de Vista se desplegar la vista grfica del proceso, que le da acceso a la ruta
que sigui el caso.

Copyright 2014 - Bizagi

2671

D clic en la columna Admin para acceder a la pgina de Administracin del caso para reasignarlo o
abortarlo.

Sensores
Los Sensores son un conjunto de reportes que brindan informacin til para la mejora continua a sus
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: Cronmetros y Contadores.

Cronmetros
Los Cronmetros determinan el nmero de casos que han pasado a travs de una ruta especfica y el
tiempo les ha llevado a hacerlo. El tiempo se define a partir de la primera vez que el caso entra en la
tarea de partida, hasta el momento en que abandona 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.

El tiempo que le toma a un caso recorrer un camino especfico se calcula con base en el Esquema
Standard de horario de trabajo, sin importar que existan otros esquemas de horario.
Hay informes diferentes para cada Cronmetro:

Copyright 2014 - Bizagi

2672

Resumen Tiempo del ciclo: Esta tabla muestra el nmero de veces que se ha completado la ruta
seleccionada, el tiempo mnimo y mximo que llevo hacerlo y la duracin media. De acuerdo con el
SLA definido en el cronmetro, en la tabla se muestran el nmero de casos que cumplieron (a
tiempo) y el nmero de casos que no cumplieron (Atrasadas).

Nivel de servicio: Muestra el indicador del porcentaje de casos que cumplieron con la ruta en un
periodo de tiempo determinado. Se divide en das de cero a seis

Histograma de duracin: Este grfico muestra los das que las instancias del cronmetro tardaron
en ser completadas. Hay una lnea vertical que separa las instancias a tiempo de las retrasadas.

Copyright 2014 - Bizagi

2673

Tendencia de duraciones: Este grfico muestra el tiempo de duracin promedio del cronmetro, en
el rango de tiempo seleccionado.

Tendencia de activaciones vs cierres: El cronmetro, en el tiempo seleccionado, combina las


tendencias del nmero de activaciones y el nmero de cierres.

Copyright 2014 - Bizagi

2674

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 seleccionan para una tarea especfica en un proceso, con el fin de obtener el
nmero de veces que el flujo del proceso ha pasado por ella. Este sensor ser til para determinar los
ndices de re-procesamiento y bucles. Proporciona datos para optimizar los procesos, identificar
tendencias de activacin y recuentos.
Los contadores se calculan de dos maneras diferentes:
De acuerdo con la fecha de creacin del caso: Este reporte cuenta los casos que llegan a la tarea
seleccionada y que se han creado durante un perodo de tiempo especfico. Es decir, el contador
tiene en cuenta los casos que durante el periodo de tiempo elegido han 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, se
cuenta cualquier caso, ya sea creado antes o durante el perodo de tiempo elegido, que haya
activado la tarea seleccionada.

Copyright 2014 - Bizagi

2675

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 cada activacin ser tenida en cuenta. 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 total de casos.

Copyright 2014 - Bizagi

2676

Diagrama de conteos: Este histograma muestra el recuento total de todos los contadores del
proceso seleccionado.

Copyright 2014 - Bizagi

2677

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 se ha activado la tarea seleccionada y el
nmero de casos que incluyeron dicha tarea. Un caso podra activar la misma tarea ms de una vez,
y cada activacion ser tenida en cuenta. Por esto, 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 total de los casos.
Tendencia del contador: Este grfico muestra la tendencia del nmero de activaciones del contador.

Copyright 2014 - Bizagi

2678

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 Reportes. Seleccione la opcin Sensores.

Copyright 2014 - Bizagi

2679

2. En la ventana, haga clic en Editar sensores para crear uno nuevo.

3. En la parte izquierda de la pantalla, seleccione el proceso al que desea aadir el Sensor.

Copyright 2014 - Bizagi

2680

4. Haga clic en Nuevo Cronmetro o Nuevo Contador, de acuerdo con el sensor que desee crear.

5. Seleccione los puntos necesarios del proceso para el sensor.


Si va a crear un cronmetro defina dnde comienza y dnde termina.

Si va a crear un contador defina la tarea a contar.

Copyright 2014 - Bizagi

2681

6. Escriba un Nombre, Nombre visual y una descripcin para el sensor. Tambin incluya el SLA para
Cronmetros. Haga clic en Aplicar.

Cmo editar y eliminar Sensores


1. En el Portal de Trabajo, haga clic en el men Reportes. Seleccione la opcin Sensores.

Copyright 2014 - Bizagi

2682

2. En la ventana haga clic en Editar Sensores.

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 Editar o Eliminar.

Copyright 2014 - Bizagi

2683

4. Si est editando el sensor debe definir los nuevos puntos del proceso. Haga clic en Aplicar para
guardar los cambios.

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 Mis Reportes, bajo el men Reportes. Los
informes guardados estarn disponibles para cada usuario individualmente.

Guardar informes
En el informe que desee guardar, haga clic en Guardar reporte.

Copyright 2014 - Bizagi

2684

En la nueva ventana ingrese un nombre y descripcin para el informe.

Por ltimo, haga clic en Guardar.


Los reportes guardados se pueden acceder desde la opcin Mis Reportes. Recuerde que los informes
guardados slo son visibles para el usuario que los crea.

Copyright 2014 - Bizagi

2685

Editar y eliminar reportes guardados


Los reportes guardados se pueden editar y eliminar. En Mis Reportes, seleccione el informe que desee
editar o eliminar y haga clic en el botn Editar o Eliminar.
Si va a editar un informe, realice los cambios necesarios y haga clic en Guardar.

Si va a eliminar un informe, confirme esta accin haciendo clic en Eliminar, en la ventana emergente de
confirmacin.

Copyright 2014 - Bizagi

2686

Dimensiones
Una Dimensin es un conjunto de valores utilizados como filtro en los reportes. Los reportes BAM,
Anlisis y Sensores presentan informacin acerca de todos los casos de forma predeterminada, sin
embargo, los casos se pueden filtrar con respecto a una dimensin especifica.
Bizagi ofrece dos conjuntos de dimensiones:
Creados por defecto, presentes para todos los proyectos y procesos
Definidos 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: Lista 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 creen, las Dimensiones de Usuario se clasifican en:

Copyright 2014 - Bizagi

2687

Dimensiones fijas: Estas son las dimensiones que se crean en Bizagi Studio en tiempo de
desarrollo. Se mostrarn 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 elegibles como Dimensiones,
estos atributos slo pueden 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 pueden elegirse. Sin
embargo, las entradas o los gastos que son colecciones no son elegibles.

Copyright 2014 - Bizagi

2688

Los atributos booleanos: Los atributos que pueden tomar valor de verdadero o falso.

Las dimensiones se definen para cada proceso, por lo que slo se pueden 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, no se pueden cambiar en el
Portal de Trabajo.
1. En la vista de Mdulos vaya a el mdulo de Anlisis. En el item de Dimensiones, haga clic derecho y
seleccione Nueva dimensin.

Copyright 2014 - Bizagi

2689

2 .Seleccione un Nombre, Nombre visual y un proceso. Escriba una descripcin de la dimensin.

3. Elija el XPath para identificar los valores para filtro. Cuando termine, haga clic en Aceptar.

Copyright 2014 - Bizagi

2690

En el Portal de Trabajo
1. En el men Admin, haga clic en Dimensiones.

2. Haga clic en Nueva dimensin y escriba un nombre, nombre visual y seleccione el proceso al que
pertenece. Escriba una descripcin de la dimensin.

Copyright 2014 - Bizagi

2691

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 Editar o Eliminar.

Copyright 2014 - Bizagi

2692

Slo los usuarios que tengan los permisos necesarios pueden 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 necesite.

Copyright 2014 - Bizagi

2693

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 2014 - Bizagi

2694

Para mayor informacin acerca de cmo usar las dimensiones consulte Anlisis grfico

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 editarla, se mostrar un
mensaje de advertencia, para recordarle que la dimensin ya est en produccin y que cualquier
cambio podra afectar el entorno de produccin.

Licenciamiento explicado
Bizagi Engine se utiliza para ejecutar/automatizar Procesos. Bizagi Engine requiere de licenciamiento, y
le permite transformar sus procesos en ejecucin (workflows). La Suite BPM no ofrece capacidades
adicionales de modelado: se especializa en la ejecucin de procesos. Si nicamente est buscando
documentar y modelar sus procesos, slo necesita Bizagi Modeler.
El modelo de licenciamiento de Bizagi BPM Suite es muy sencillo: se basa en Licencias de Usuario.
Usted necesita una Licencia de Usuario independiente para cada usuario individual. Una Licencia de
Usuario 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 de Bizagi Engine. 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.
Bizagi BPM Suite est compuesta por tres productos: Bizagi Modeler, Bizagi Studio y Bizagi Engine.
Bizagi Modeler y Bizagi Studio pueden utilizarse de manera gratuita y sin licenciamiento. Bizagi Studio
soporta un mximo de veinte (20) Usuarios en ambientes de desarrollo y pruebas.
Bizagi Engine es el producto que requiere el licenciamiento de usuario descrito anteriormente, para
permitir a los usuarios finales participar en los procesos de negocio automatizados. Bizagi Engine se
encuentra disponible en dos ediciones: .NET y JEE, las cuales son similares en funcionalidad. La
diferencia es la plataforma en la cual corren.

Copyright 2014 - Bizagi

2695

Para informacin por favor lea nuestro Acuerdo de licencia de usuario final (EULA).

Bizagi Modeler
Bizagi Modeler 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.

Tipos de licencias

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 correo
electrnico con la llave de 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 habr 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 correo electrnico 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.

Copyright 2014 - Bizagi

2696

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 correo
electrnico 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.
La renovacin de la suscripcin le permite continuar utilizando Bizagi por un perodo adicional de 12
meses, incluyendo actualizaciones de producto y soporte. En caso de no renovar la suscripcin, su
sistema Bizagi dejar de funcionar automticamente en la fecha de expiracin, su mantenimiento ser
cancelado y no tendr ms acceso 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
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.
Cada licencia adquirida tiene una fecha de expiracin separada. Si desea unificar las fechas de
renovacin en una sola, por favor contacte su representante de ventas.
Al adquirir Usuarios adicionales para una instalacin existente usted debe comprar el mismo producto
y el mismo tipo de Licencia de Usuario 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.

Copyright 2014 - Bizagi

2697

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.

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 Licencias de Usuario necesarias para acceder o utilizar el Software de Servidor. La cantidad
de Licencias de Usuario 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. 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 correo electrnico con los siguientes pasos
en el proceso de solicitud.

Copyright 2014 - Bizagi

2698

Si requiere informacin adicional acerca de cualquiera de nuestros tipos de licencia o trminos, por
favor contctenos.

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.

Tenga en cuenta los siguientes conceptos relacionados a las licencias de Bizagi:


Cuando una clave de licencia se activa en un servidor de produccin (o computador) se crea lo
que llamamos una instalacin.
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. No se cobra el IVA 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 vez 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 Compras en el men principal.

Copyright 2014 - Bizagi

2699

2. Vaya a la pestaa Mi licencias, 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, Comprar usuarios adicionales (1).
La compra ser vinculada a la instalacin seleccionada.
En la compra de usuarios adicionales para una instalacin existente, debe comprar el mismo producto
y el mismo tipo de Licencias de Usuario (perpetuo, o suscripcin) que adquiri en primer lugar. Esto se
debe a las claves de licencia son especficas para cada tipo de licencia y no funcionar en una
diferente.

Copyright 2014 - Bizagi

2700

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 Renovar (2).
La compra ser vinculado a la instalacin seleccionada.
En la parte inferior de la pantalla hay un botn para Comprar licencias para nuevas instalaciones (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 Orden de compra.
Revise el producto y la cantidad requerida. Haga clic en Continuar para pasar a la siguiente etapa.

4. Actualice la informacin de cliente de ser necesario. D clic en Continuar.


IMPORTANTE: asegrese de ingresar la informacin exacta de su cliente incluyendo la direccin de
email, ya que esta informacin ser cifrada en la llave de la licencia y utilizada para crear una cuenta
online para soporte de producto.

Copyright 2014 - Bizagi

2701

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.

Copyright 2014 - Bizagi

2702

Clientes nuevos
1. En Bizagi Studio vaya a la pestaa Ayuda y seleccione el men Administracin de licencias.
Seleccione el botn Comprar ahora 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(los) producto(s) requerido(s).
Slo 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.

Copyright 2014 - Bizagi

2703

Administrar licencias
El modelo de licenciamiento de Bizagi BPM Suite es muy sencillo: se basa en Licencias de Usuario.
Usted necesita una Licencia de Usuario independiente para cada usuario individual. Una Licencia de
Usuario 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 de Bizagi Engine.
La compra tambin le da derecho a utilizar Bizagi libre de cargos en ambientes de desarrollo y
pruebas. Usted puede generar hasta (3) licencias para servidores de pruebas por cada licencia que
haya adquirido en produccin.
Bizagi tambin le permite administrar sus licencias para adaptarse fcilmente a los cambios en su
organizacin. Usted puede mover licencias de usuario a un nuevo servidor o a un servidor existente en
cualquier momento. Asi mismo, usted siempre podr llevar un registro de sus facturas.
En ese artculo explicaremos como:
Activar licencias
Mover licencias a un nuevo servidor o en un servidor existente
Mover licencias de llaves sin usar
Licencias para servidores de prueba
Ver y descargar facturas

Activacin de licencias
Slo se requieren licencias para Usuarios (participantes en procesos) en el ambiente de produccin.
Despus de comprar una licencia perpetua o suscripcin por primera vez, usted recibir un correo
electrnico con una llave para licenciarlos. El procedimiento para activar esta llave difiere ligeramente
entre ediciones:
Haga clic aca para ver cmo activar licencias en la edicin .NET
Haga clic aca para ver cmo activar licencias en la edicin JEE
Tenga en cuenta que cuando se activa una llave de licencia en el ambiente de produccin (o
computador), usted habr creado lo que llamamos una instalacin.

Licencias para servidores de prueba


Por defecto, Bizagi trae 20 usuarios por defecto para el entorno de pruebas. Si usted necesita ms
usuarios en sus ambientes de pruebas, puede generar licencias para este fin.
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.
SI usted tiene varias compras, las licencias se generarn PARA EL TOTAL de licencias compradas.
Tenga en cuenta que estas licencias no se pueden mover y por lo tanto se pueden aplicar una vez a un
servidor.

Copyright 2014 - Bizagi

2704

Para generar licencias para servidores de prueba:


1. Entre al Portal de Bizagi con sus credenciales y seleccione Compras en el men principal.
A continuacin, seleccione Licencias para servidores de prueba.

2. Haga clic en Generar Licencia.


Este procedimiento crear automticamente una licencia de pruebas con el mismo producto, mismo
nmero de usuarios y la fecha de expiracin de la original.

Copyright 2014 - Bizagi

2705

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.

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 existente su
empresa. Tenga en cuenta que para mover licencias es necesario que los servidores tengan EL MISMO
PRODUCTO.
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.
1. Entre al Portal de Bizagi con sus credenciales y seleccione Compras en el men principal.
A continuacin, seleccione Mover Licencias.

2. Identifique la licencia que desea mover y seleccione si ser a un Nuevo servidor o un Servidor
existente.
La imagen de arriba muestra dos licencias adquiridas. En este caso, es posible mover un nmero
menor al total de los usuarios licenciados para una o ambas licencias.

Copyright 2014 - Bizagi

2706

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.

Usted no recibir un correo electrnico de confirmacin. Sin embargo, una vez que el proceso de
mover las licencias haya terminado, puede comprobar el estado de stas en el men Mis
licencias.
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 Compras en el men principal.

Copyright 2014 - Bizagi

2707

A continuacin, seleccione Mover Licencias.

2. Identifique la licencia que desee mover de la seccin Llaves sin usar y seleccione un servidor de la
lista desplegable.
Haga clic en Mover esta licencia.

Copyright 2014 - Bizagi

2708

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 Mis licencias.
4. Actualice la Licencia de Bizagi Studio o Management Console.

Tenga en cuenta lo siguiente:


Los movimientos de licencias se realizan entre servidores que tienen el MISMO producto.
Usted no recibir un correo electrnico de confirmacin. Sin embargo, una vez que el proceso de
mover las licencias haya terminado, puede comprobar el estado de sus licencias en el men Mis
licencias.
Para todas las ediciones las llaves no utilizadas mueven todos los usuarios de la licencia.
Para mover licencias siempre se necesita conexin a Internet.

Copyright 2014 - Bizagi

2709

Ver y descargar facturas


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

Activacin de licencia

Consulte Activar Licencias JEE si ese es su caso.


Para activar licencias debe acceder a la opcin Administracin de licencias que se encuentra en la
pgina de Bienvenida a Bizagi o en la pestaa Ayuda, de Bizagi Studio o del Management Console.

Copyright 2014 - Bizagi

2710

Recuerde que cuando una clave de licencia se activa en un servidor de produccin (o


computadora) se crea lo que llamamos una instalacin.

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 la Edicin NET. o la Edicin JEE)
debe activar su renovacin o usuarios adicionales. Vaya a Administracin de Licencias y haga clic en el
botn Actualizar licencia.

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 Comprar ahora usted ser llevado al sitio
Contctenos, donde podr ingresar sus datos y un representante de ventas se comunicar con usted
en breve.

Copyright 2014 - Bizagi

2711

Licencia Primera vez


Una Licencia de Usuario es necesaria para cada persona ("Usuario") que acceda o use el Servidor del
Software. Una Licencia de Usuario 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 de Licencias. Una nueva ventana aparecer.
Seleccione la instalacin (servidor) que debe ser licenciada.
Si el servidor no aparece en la lista desplegable, escriba el nombre y haga clic en Conectar.

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

Copyright 2014 - Bizagi

2712

Haga clic en el botn Ingrese la llave de licencia y digite o pegue la llave de licencia en el espacio
suministrado.
Haga clic en OK para guardar los cambios.

Copyright 2014 - Bizagi

2713

Se mostrara la informacin de la licencia para el servidor.

Copyright 2014 - Bizagi

2714

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.

Activacin 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 utilizar Bizagi en un ambiente de produccin esta
restricciones deben ser removidas comprando una licencia (Licencia de Usuario perpetua o Licencia de
Usuario por suscripcin). Despus 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 conexin 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 Administracin de Licencia.

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

Copyright 2014 - Bizagi

2715

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

Activacin de licencia en la Enterprise JEE

Prerrequisitos
Los siguientes son prerrequisitos 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 Mquina Virtual de Java (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>.
Asegrese de haber configurado su servidor de aplicaciones JEE (WebSphere, Weblogic o JBoss).
Para ms informacin, consulte Configuracin del sistema Bizagi en la Enterprise JEE.
Si usted cuenta con una configuracin en clster, asegrese de que todos sus nodos hayan sido
configurados correctamente.

Copyright 2014 - Bizagi

2716

Consideracin cuando se usa clster


Antes de continuar, asegrese de que su licencia soporta un nmero de activaciones de acuerdo a los
nodos de su clster.
Contctenos si tiene dudas sobre su licencia de la edicin JEE.

Procedimiento
El siguiente procedimiento se debe desarrollar para cada uno de los servidores en su ambiente de
produccin.
Tenga en cuenta que para activar la licencia en una configuracin de clster, deber realizar los
siguientes pasos para cada uno de los nodos de su servidor.

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

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.

Copyright 2014 - Bizagi

2717

Si usted utiliza WebSphere, asegrese previamente de configurar la variable de entorno


JAVA_HOME para que referencie la JVM interna que utiliza WebSphere.
Para ello se recomienda ejecutar una consola de comando, y ejecutar set
JAVA_HOME=[ruta_JVM_WebSPhere] (o env en Linux).
De esta manera y con la variable temporalmente configurada, en la misma consola podr ejecutar
startconsole

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.

D clic en la opcin de Administracin de Licencia:

Copyright 2014 - Bizagi

2718

Licencia por primera vez


Ingrese el nombre del servidor o la IP y d clic en Conectar.

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 2014 - Bizagi

2719

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

Copyright 2014 - Bizagi

2720

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 .NET o JEE)
usted necesita activar su renovacin o usuarios adicionales. Vaya a Administracin de Licencias y d
clic en le botn Actualizar Licencia.

Detener el servicio JEEConsoleManager


Ahora que la licencia ha sido activada, este servicio iniciado con el usuario administrador ROOT se
puede detener.
Para detener 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 2014 - Bizagi

2721

Soporte a clientes
Bizagi ofrece 2 niveles de soporte: el Servicio de Soporte estndar incluido con sus licencias (sin SLAs)
y el Servicio de Soporte Premium (con SLAs) que se puede comprar por separado de acuerdo a sus
necesidades.

Servicio de Soporte Bsico


Para recibir soporte bsico usted debe tener un contrato de soporte de mantenimiento activo. El
mantenimiento incluye actualizaciones de producto y soporte bsico. El Soporte Bsico no ofrece
ningn nivel de servicio (SLA no) y permite a los clientes abrir tickets de soporte en Bizagi Portal
reportar bugs, errores o sugerencias para la mejora del producto. Los Tickets de Soporte tambin
pueden ser usados ?para hacer consultas simples con respecto a la funcionalidad del producto.
Si ha implementado procesos de negocio importantes o fundamentales en su organizacin, se
recomienda que opte por una de las opciones de soporte premium que se describen a continuacin,
con el fin de recibir soporte dentro de los SLAs que su negocio requiere.

Servicio de Soporte Premium


Este servicio fue diseado para aquellas empresas que requieren niveles de servicio y atencin
especial a sus incidentes. Este es un servicio opcional, cuyo objetivo es el de complementar el Soporte
Bsico incluido en el mantenimiento. El Servicio de Soporte Premium se basa en incidentes y se ofrece
en tres modalidades: Bronce, Plata y Oro, en funcin de su nivel de servicio (SLA) y los requisitos de
nmero de horas de soporte pre-pagados . Con el fin de tener acceso a este servicio, es necesario
tener un contrato de mantenimiento vigente y vlido para sus licencias Bizagi.

Copyright 2014 - Bizagi

2722

Los programas de soporte premium se diferencian del soporte bsico en el sentido de que incluyen
SLA y dedicacin de tiempo especfico por parte de nuestro equipo de soporte, el cual que depende
de la opcin seleccionada: Bronce y Plata (5x8) y Oro (7x24). Para enviar un incidente, el cliente debe
acceder a Portal de Bizagi y abrir un nuevo ticket, que contar con la presencia de acuerdo con las
condiciones del programa adquirido.
Si usted est interesado en conocer los Trminos, Condiciones y precios del servicio de Soporte
Premium completos, pngase en contacto con nosotros.

Cmo usar el Sitio de Soporte

Introduccin
Bizagi dispone de un Canal de Soporte para atender sus incidencias. A continuacin encontrar una
gua de las tareas bsicas que puede realizar en este canal como es la creacin de nuevos tickets,
preguntas o incidencias, as como la forma en que se debe realizar su seguimiento.

Tenga en cuenta que el sitio web es dinmico, y por lo tanto, es posible que algunas de
las imgenes que se ofrecen en este documento presentan algunos cambios,
manteniendo al mismo tiempo la filosofa y de las principales caractersticas del proceso
de creacin de tickets y la interaccin con l.
Ingreso al sitio de Soporte
Reporte de incidentes
Actualizacin de incidentes
Administracin y creacin de cuentas de soporte
Preguntas frecuentes de incidentes

Instrucciones de acceso al sitio de soporte Bizagi


En general la interaccin con el sitio es muy sencilla y auto explicativa. Sin embargo, se presentan a
continuacin las caractersticas ms importantes.

Ingreso al sitio
Para ingresar dirjase al sitio oficial de Bizagi (www.bizagi.com). Encontrar una pantalla similar a la
siguiente:

Copyright 2014 - Bizagi

2723

En la parte superior izquierda encontrar la opcin de Login que le permitir autenticarse como cliente
y acceder a nuestros servicios.
Cuando ingrese encontrar una pgina donde deber digitar el usuario y contrasea asignado. Si
todava no tiene un usuario y contrasea, podr solicitarlo al Gerente de Cuenta o enviando un correo
a support@bizagi.com

Copyright 2014 - Bizagi

2724

Si por alguna razn ha olvidado su contrasea puede usar la opcin de recordar la contrasea como
se explica en Cmo recuperar el nombre de usuario o la contrasea en caso de olvido?
Una vez ha ingresado, se redirigir al Portal de Clientes, en el cual podr acceder al sitio de Soporte.

Herramientas del Sitio de Soporte


Para reportar incidentes, se debe ingresar a la pgina de Soporte usando cualquiera de las siguientes
opciones:
Haciendo clic en el enlace Sitio de Soporte Seguro
Haciendo clic en la pestaa Soporte
En la pgina principal del sitio de Soporte encontrar las distintas opciones y recursos que ofrecemos
a nuestros clientes.

Copyright 2014 - Bizagi

2725

Reporte de incidencias o preguntas


El canal principal para la atencin de incidencias y preguntas es nuestro sitio de soporte, a travs de la
opcin Tickets de Soporte. Al ingresar encontrar las siguientes opciones:

Copyright 2014 - Bizagi

2726

Es muy importante para facilitar el seguimiento,y por ende, recibir un mejor servicio, que se reporte
una pregunta o incidente por ticket.
Para reportar una nueva incidencia o pregunta, haga clic en el botn Nuevo Ticket. Se solicitar la
siguiente informacin:
Asunto: Descripcin corta del incidente que sirva como una referencia rpida y resumida del reporte.
Prioridad: Se establecen los siguientes niveles de prioridad:
Alta. El incidente causa prdida completa del servicio. La operacin afectada es de misin crtica e
impacta totalmente al negocio y la situacin es considerada una emergencia. No hay workaround
disponible.
Media. El incidente causa una prdida severa del servicio. No est disponible ninguna alternativa o
workaround aceptable; sin embargo, la operacin puede continuar de un modo restringido. Este
tipo de problemas incluyen situaciones en las que es necesario reiniciar procesos frecuentemente y
se presentan problemas de performance (Ejemplo: Lentitud en la operacin) que causan una
degradacin del servicio pero que no hacen que el producto no se pueda utilizar.
Baja. El incidente causa un impacto menor sobre el negocio y puede requerir una alternativa o
workaround para restaurar la funcionalidad, sin embargo el producto se puede utilizar.
Mdulo. Componente objeto del reporte o pregunta.
Producto. Seleccione el producto de Bizagi sobre el que trate el reporte o pregunta.
Versin Exacta. Indique la versin exacta que est utilizando. Por ejemplo si eligi el producto Bizagi
9.1.x Enterprise .NET, la versin exacta podra ser: 9.1.9
Sistema Operativo. Indicar el sistema operativo de la mquina donde est instalado el producto para
el que se est reportando la incidencia o pregunta.
Base de datos. Motor de Base de datos usado. Entre las opciones estn las diferentes versiones de
Oracle y SQL Server soportadas por Bizagi

Copyright 2014 - Bizagi

2727

Entorno. Seleccionar el entorno donde se est presentando el inconveniente. Puede ser uno de los
siguientes
Desarrollo
Pruebas
Produccin
Enviar copia a. Cuando el ticket es creado, actualizado o cerrado se envan notificaciones. Si se desea
que se enve una copia de las notificaciones a buzones adicionales, lo puede hacer usando esta
opcin.
Descripcin del ticket. Descripcin completa de la pregunta o problema reportado. Para que la
atencin sea ms rpida y eficiente, se sugiere que la descripcin sea lo ms explicativa posible. Se
recomienda que la descripcin contenga :
Detalle del problema. Indicar cual es la situacin no deseada, desde cundo empez a presentarse
y antecedentes, si los hay, del problema. Acompaar en lo posible de imgenes y mensajes de
error.
Pasos para reproducirlo. Pasos que se deben seguir para reproducir el problema. Si considera que
el proceso o los pasos son complejos de entender o explicar, puede apoyarse de un documento
con imgenes
Explicacin de la prioridad. En caso de reportar incidentes con prioridad alta, indicar las razones
por las que el problema reportado es de tipo bloqueante para la operacin de la solucin. En
pruebas y desarrollo tambin indicar por qu es un tema que tiene relevancia para el xito del
proyecto.
Insumos. Los insumos ms frecuentemente solicitados por el equipo de Soporte son:
o Log de Eventos. Cuando el ticket reportado corresponda a un error que aparece en pantalla, sea
con el mensaje genrico de ambientes de produccin en el que se invita a contactar al
administrador, o sea al mensaje completo que aparece en desarrollo; los detalles del mensaje de
error estn en el log de eventos, por lo que es importante que cuando se haga este tipo de
errores se anexe el log de eventos del servidor web. Es recomendado que est en formato .evtx
o Backup de la Base de Datos. Para simplificar el ciclo de solucin de un ticket y cuando las
condiciones lo permitan, la base de datos se constituye en un insumo importante ya que permite,
por un lado, reproducir las condiciones exactas de la ocurrencia de un problema y por el otro,
facilita las tareas de anlisis y reproduccin de un incidente.
En la descripcin del ticket puede adjuntar un archivo. Si requiere adjuntar varios puede previamente
comprimirlos y adjuntar el archivo .rar o .zip resultante.
Una vez haya completado el registro del incidente, se debe presionar el botn Enviar que se
encuentra en la parte inferior de la pantalla. Recibir inmediatamente un correo de la direccin
admin@bizagi.com confirmando la recepcin del incidente.

Copyright 2014 - Bizagi

2728

Recomendaciones:

Copyright 2014 - Bizagi

2729

Para que no tenga inconvenientes con la recepcin de notificaciones, agregue la direccin


admin@bizagi.com dentro de las direcciones seguras. De esta forma se evita que las notificaciones
enviada por Soporte Bizagi queden en listas de correo no deseado y no reciba las actualizaciones
de los tickets.
El buzn admin@bizagi.com no es monitoreado y por lo tanto las respuestas o correos que envi a
dicho buzn, no sern atendidas.
Si tiene algn inconveniente con el registro o interaccin con la pgina de soporte, puede escribirle
al Gerente de Cuenta asignado para su empresa o enviar un correo a support@bizagi.com
Es muy importante tener en cuenta que el servicio de soporte ofrecido es sobre el producto y
no de las implementaciones que se hagan usndolo. En consecuencia, el registro de incidentes
se debe hacer en trminos de producto y no de implementacin o de negocio.

Actualizacin de incidentes
La actualizacin de los incidentes abiertos se debe hacer exclusivamente por la pgina, dado que es el
canal regular para la interaccin con el equipo de soporte.
Una vez se ha ingresado a la pgina de Tickets de Soporte encontrar, adems de la opcin de abrir
nuevos tickets, la opcin de consulta de tickets existentes.

Filtros y bsquedas
En esta pgina se tienen tres opciones de filtros:

Copyright 2014 - Bizagi

2730

Filtro de Estado. Permite filtrar los casos de acuerdo a su estado. Estas son las opciones:
o
o
o
o

Todos los Tickets


Abiertos y ltimos cerrados
Abiertos
Cerrados

Para usar el filtro se debe seleccionar en el combo una de las opciones y presionar el botn Consultar.
Filtro de Fechas. Al seleccionar la casilla de marcacin se despliegan la fecha inicio y fin. Una vez se
defina el rango, presione el botn Consultar para filtrar los datos.
Filtro por palabra clave. Mediante esta bsqueda se pueden filtrar los tickets que tengan dentro de
su asunto palabras y letras que sirvan para identificar rpidamente un ticket.

Actualizacin de Tickets
Una vez se haya identificado el ticket que se quiere actualizar se debe ingresar a l, haciendo click
sobre el asunto:

En cualquier momento durante el ciclo de vida de un ticket se puede enviar un nuevo comentario, el
cual ser recibido por nuestro equipo de soporte (excepto cuando ya est cerrado). Con los
comentarios siempre podr adjuntar nuevos archivos.

Copyright 2014 - Bizagi

2731

Siempre que nuestro equipo de soporte genere un nuevo comentario para algn ticket, se enviar una
notificacin al correo registrado y al correo que se indique en el campo Send copy to.

Copyright 2014 - Bizagi

2732

Cmo administrar cuentas de acceso a Soporte?


Para cada empresa existe un usuario que tiene la posibilidad de crear y administrar cuentas
adicionales para registrar incidentes. Normalmente ese usuario es con el que se realiza la compra de
licencias o es el primer usuario de la empresa al que se le dio acceso al sitio de Soporte.

Copyright 2014 - Bizagi

2733

Para administrar los usuarios se debe ingresar al portal y en el encontrar la opcin de


Administracin Usuarios. Al ingresar encontrara el listado de usuarios habilitados para ingresar al
sitio de Soporte. Podr en este punto o eliminar usuarios o crear usuarios adicionales.

Copyright 2014 - Bizagi

2734

Recomendaciones
El sitio est diseado para que cada cuenta sea independiente de otra a pesar de que
pertenezcan a la misma empresa. Es decir que los incidentes creados con una cuenta no son visibles
por otra.
Si se requiere que varias personas de la organizacin puedan administrar los tickets de una forma
centralizada nuestra recomendacin es crear una nica cuenta que pueda ser compartida por varios
usuarios, por ejemplo BizagiSupport@empresa.com y asociar dentro del sistema de correo de la
organizacin dicha cuenta a una lista de distribucin, de tal manera que todos los interesados que
estn en la lista podrn recibir todas las notificaciones del equipo de Soporte.

Preguntas frecuentes
Cmo consultar la vigencia del soporte de una versin del producto?
A medida que Bizagi va evolucionando y se liberan nuevas versiones de producto, las antiguas pierden
su vigencia y por ello se definen fechas en las que dichas versiones pierden el soporte. Esta
informacin se actualiza en nuestro sitio de soporte para que las organizaciones poder realizar la
respectiva planificacin. Para consultar dicha informacin puede entrar a travs del link que se resalta
en la siguiente imagen, desde la pantalla de consulta y radicacin de tickets:

Copyright 2014 - Bizagi

2735

Cmo cambiar mi contrasea?


Si necesita cambiar la contrasea de acceso al sitio o modificar cualquier otra informacin de la
cuenta, usted puede utilizar la opcin Editar mi cuenta que aparece en la parte superior del sitio una
vez autenticado:

Una vez seleccionada esta opcin, se mostrar una pantalla similar a la presentada a continuacin. All
usted puede cambiar su contrasea as como otros detalles de la cuenta.

Copyright 2014 - Bizagi

2736

Copyright 2014 - Bizagi

2737

Cmo recuperar el nombre de usuario o la contrasea en caso de olvido?


En caso de que haya olvidado el nombre del usuario o la contrasea para acceder al sitio de Soporte
de Bizagi, puede utilizar las opciones que estn disponibles en la pantalla de autenticacin:

Cuando selecciona la opcin de Recuperacin del nombre de usuario, se le solicitar la direccin de


correo asociada. Unos minutos ms tarde, recibir en su buzn de correo el nombre del usuario
registrado en nuestro sistema.
Si selecciona la opcin de Recuperacin de contrasea, le solicitar tambin el correo electrnico
asociado a la cuenta. En unos minutos recibir una clave por correo que deber digitar en la pantalla
que aparece luego del registr el correo electrnico.

Copyright 2014 - Bizagi

2738

Una vez se verifique la clave, podr cambiar su contrasea actual por una nueva.

Se usan herramientas adicionales aparte de la pgina?


El canal exclusivo para la interaccin en los tickets es la pgina de soporte, sin embargo, para facilitar
la atencin de un ticket abierto se utilizan herramientas adicionales como las siguientes:
Skype. Para las comunicaciones se usa esta herramienta y especficamente a travs de la cuenta
Skype Bizagi.support.
GotoMeeting. Es una herramienta de acceso remoto y conferencia que permite, a travs del
navegador, acceder a los ambientes de nuestros clientes o que ellos tengan acceso a nuestros
ambientes para trabajar en conjunto en el diagnstico y solucin de una incidencia.
ShareFile. Para compartir archivos normalmente se hace a travs de un sitio seguro:
Bizagi.Sharefile.com. Siempre que requiera enviar un archivo a Soporte Bizagi, se proporcionar a
travs de un post en el ticket el enlace correspondiente.

Copyright 2014 - Bizagi

2739

Parte IV
Recursos tiles

Recursos tiles
Glosario Bizagi

A - B - C - D - E - F - G - H - I - J - K - L - M - N - O - P - Q - R - S - T - U - V - W - X- Y - Z

Convenciones tipogrficas
Esta documentacin de producto incorpora las siguientes convenciones:
Un trmino es una palabra o frase que posee un significado especial. Cuando se define un trmino,
su nombre se resalta en negrilla.
Una referencia a otra definicin, seccin o ayuda se muestra subrayada y provee un enlace a su
ubicacin dentro de esta gua de usuario.
Una referencia a una figura (elemento), atributo, o constructor BPMN inicia con letra mayscula (ej.,
Subproceso).

A
Accin de actividad: Acciones definidas a la entrada, al guardar o a la salida de una actividad para
evaluar condiciones, validaciones, polticas, ejecutar expresiones, generar correos electrnicos y
plantillas de documento. Vea Asignaciones, clculos y validaciones.
Acciones de Forma: Funcionalidad de Bizagi que permite controlar el comportamiento de todos los
atributos incluidos en una Forma. Vea Acciones y Validaciones
Actividad asncrona: Tarea automtica que se ejecuta de manera independiente desde cualquier
servidor web, utilizada para llamar interfaces externas. Estas interfaces se utilizan para integracin
con sistemas del cliente. Vea Invocar servicios web desde actividades asncronas
Actividad de Llamada: Elemento BPMN que referencia una actividad o diagrama que se utiliza en
uno o ms Procesos. Las actividades de llamada en Bizagi se modelan como Subprocesos reusables.
Vea Subprocesos reusables
Actividad de compensacin: En el contexto de Subprocesos transaccionales, cuando una
transaccin no se ha completado de manera exitosa, se ejecutan actividades de compensacin para
retornar todas las actividades que ya han sido completadas dentro del Proceso, a su estado inicial.
Vea Subprocesos transaccionales

Copyright 2014 - Bizagi

2741

Actividad: Elemento BPMN que representa trabajo o tareas realizadas 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. Vea Propiedades de las tareas
Administrador Bizagi: Usuario final con permisos para administrar la seguridad de Bizagi Studio
Security. Vea Seguridad de Bizagi Studio
Administrador de negocio: Usuario con el rol de BA Business Administrator quien puede consultar
cualquier caso sin restricciones. Es decir, un Administrador de negocio se considera como un usuario
privilegiado a lo largo de todos los Procesos. Vea Seguridad del caso
Administrador de polticas: Asistente que permite crear y actualizar Polticas. Vea Crear una poltica
Alarma: Correo electrnico enviado a una persona especfica para informar el estado de una Tarea
y de esta manera se puedan ejecutar las acciones necesarias para completarla. Vea Definicin de
alarmas
Ambiente Bizagi: Aplicacin independiente de un proyecto Bizagi (que posee su propio Portal de
trabajo, Base de datos y servicio de Scheduler). Por defecto, Bizagi utiliza tres ambientes: Desarrollo,
pruebas y produccin. Vea Deployment de Procesos
Anlisis: Herramienta de anlisis que representa de manera grfica estadsticas de los casos
cerrados. Los anlisis se realizan desde dos perspectivas: De Proceso y de Actividad. Vea Anlisis.
Anotacin: Elemento BPMN que permite incluir informacin adicional en diagramas BPMN. Vea
Modelamiento para ejecucin
API (Application programming interface): Conjunto de instrucciones de programacin, rutinas y
protocolos implementados por una aplicacin, que permiten a otras aplicaciones comunicarse con
ella. Vea APIs de integracin
Aplicacin mvil Bizagi: Aplicacin que permite a dispositivos mviles acceder al Portal de Trabajo
de Bizagi. Vea Movilidad
Asistente de Organizacin: Asistente que permite crear y actualizar las caractersticas de la
organizacin. Vea Asistente de Organizacin
Asistente de Procesos: Asistente que gua al usuario a travs de los distintos pasos que se deben
seguir para convertir un diagrama de Proceso en una aplicacin ejecutable. Vea Vista del Asistente
Atributo de scope de actividad: Atributo que no pertenece al modelo de datos del Proceso y que
es utilizado para almacenar informacin temporalmente, por el tiempo que dura una actividad. Vea
Atributos temporales
Atributo de scope de Proceso: Atributo que no pertenece al modelo de datos del Proceso y que es
utilizado para almacenar informacin temporalmente, por el tiempo que dura un Proceso. Vea
Atributos temporales
Atributo de scope: Atributo temporal que no pertenece al modelo de datos del Proceso y que es

Copyright 2014 - Bizagi

2742

utilizado para almacenar informacin por un tiempo corto, sin ser guardada en una base de datos.
Vea Atributos temporales
Atributo: Propiedad que describe una entidad. Por ejemplo, un cliente tiene un nombre, un nmero
de seguridad social, un gnero y una edad. Vea Modelo de datos
Autenticacin mixta: Funcionalidad de Bizagi que permite utilizar dos tipos diferentes de
autenticacin en una solucin Bizagi. Vea Autenticacin mixta
Autenticacin personalizada: Funcionalidad de Bizagi que permite configurar componentes
definidos por el usuario, que se utilizarn en la autenticacin del Portal de trabajo. Vea Autenticacin
personalizada
Autenticacin Windows: Tipo de autenticacin donde el Portal de trabajo delega la autenticacin a
la mquina de Windows en el lado del cliente. Vea Autenticacin Windows
Autenticacin: Componente en el mdulo de seguridad de Bizagi que define la forma en la cual los
usuarios acceden al Portal de trabajo. La autenticacin puede ser definida como autenticacin Bizagi,
Windows, LDAP o avanzada. Vea Autenticacin
Automatizacin de Proceso: Pasos que se siguen para convertir un diagrama de Proceso en una
aplicacin ejecutable.
Autorizacin: Componente en el mdulo de seguridad de Bizagi que define accesos o restricciones
para los usuarios finales, en los mens del Portal de trabajo. Vea Autorizacin

B
Balanceador de carga: Mtodo computacional de redes utilizado para distribuir cargas de trabajo
entre mltiples recursos computacionales.
BAM (Business Activity Monitoring): Herramienta de anlisis para ver de manera grfica
informacin acerca de los casos en curso, mostrando el estado de los Procesos, Tareas y recursos.
Vea BAM
BAPI (Business Application Programming Interfaces): Conjunto de instrucciones de programacin,
rutinas y protocolos implementados por SAP, para permitir a otras aplicaciones comunicarse con l.
Vea Integrando Bizagi con SAP
Bizagi BPM Suite: Plataforma que integra Bizagi Modeler, Bizagi Studio y el Bizagi Engine, para
construir y ejecutar Procesos.
Bizagi Engine: Motor BPM que ejecuta en un navegador web, los proyectos configurados en Bizagi
Studio.
Bizagi Modeler: Solucin de Bizagi para diagramar, modelar, documentar y simular Procesos de
negocio bajo el estndar BPMN (Business Process Model and Notation). Vea Bizagi Modeler

Copyright 2014 - Bizagi

2743

Bizagi Studio - BAS: Herramienta de desarrollo y construccin de Bizagi utilizada para automatizar
los Procesos definidos a travs de una interfaz intuitiva y amigable.
Bizagi: La plataforma lder de Gestin de Procesos de negocio (BPMS) para automatizacin rpida y
flexible de Procesos. Vea Sitio oficial de Bizagi
Booleano: Tipo de dato o variable con solo dos posibles valores: Verdadero o falso
BPM (Business Process Management): Filosofa corporativa de gestin cuyo objetivo es proveer a
los directores de compaa y dueos de Proceso, los elementos correctos de informacin para
mejorar continuamente la efectividad y eficiencia de los negocios.
BPMN (Business Process Model and Notation): Notacin grfica estndar que describe los pasos
lgicos en un Proceso de negocio. Esta notacin ha sido especialmente diseada para coordinar la
secuencia de los Procesos y los mensajes que fluyen entre los participantes en las diferentes
actividades.

C
Cach: Almacenamiento temporal que permite acceder de manera rpida a datos e instrucciones
utilizados frecuentemente.
CAL (Client Access License): Licencia que da a un usuario el derecho a participar en un Proceso
ejecutable y a acceder a los servicios del servidor BPM de Bizagi. Vea Licenciamiento
Campos internos: Tipo especial de controles, utilizados en Formas de consulta, que permiten incluir
informacin relacionada a los casos, que no es parte del modelo de datos. Estos sirven como
criterios de bsqueda. Algunos campos internos son: Estado del caso (abierto, cerrado, abortado),
usuario actual, id del caso, creadores.
Capa SOA: Capa de Bizagi utilizada para exponer la funcionalidad de los Procesos para integracin
con aplicaciones externas. Vea Capa SOA.
Caso: Instancia especfica de un Proceso. Los casos se crean a travs del Portal de trabajo y son
independientes uno del otro. Cada caso realiza todas las etapas, actividades, validaciones y dems,
diseadas en Bizagi Studio.
CEntityManager: Clase utilizada en expresiones que contiene funciones tiles para obtener registros
e informacin general, almacenada directamente en la base de datos de Bizagi.
Check in de Proceso: Funcionalidad de Bizagi utilizada para evitar conflictos cuando los usuarios
trabajan al mismo tiempo en el mismo diagrama de Proceso. Vea Configurar el trabajo en equipo
CHelper: Clase utilizada en expresiones que contiene funciones tiles para obtener informacin y
ejecutar comandos en diferentes Procesos. Algunas de estas funcionalidades comprenden: la
posibilidad de hacer seguimiento a la ejecucin de reglas de manera personalizada, lanzar mensajes
de error, evaluar el valor de un atributo, entre otros.
Cluster: Grupo de computadores que trabajan en conjunto para mejorar el desempeo y la

Copyright 2014 - Bizagi

2744

disponibilidad. Vea Administracin de Clusters


Colaboracin: Definicin BPMN. Comunicacin entre Procesos a travs de flujos de mensaje. Vea
Colaboracin BPMN
Coleccin: Relacin uno a muchos entre dos entidades. Una entidad (entidad A) puede ser asociada
a cero, una o muchas instancias de otra entidad (entidad B). Sin embargo para una instancia de la
entidad B hay una y solo una instancia de la entidad A. Vea Tipos de relaciones
Columna personalizada: Funcionalidad de Bizagi que permite definir la informacin de cada
aplicacin o Proceso, que se mostrar en el Inbox, resultados de bsqueda, consultas y opciones de
administracin de casos. Vea Columnas personalizadas
COM (Component Object Model): Mtodo de la especificacin de Microsoft que define un
estndar binario para crear componentes de software que pueden interactuar. COM es la base para
otras tecnologas como OLE, ActiveX y Direct X.
Comentarios del caso: Informacin complementaria para cada caso que puede ser ingresada por el
usuario asignado o cualquiera con acceso a l. Los comentarios de caso se utilizan a lo largo del
ciclo de vida de los casos, para compartir informacin importante y ayudar a los participantes a
tomar las acciones apropiadas de acuerdo a ellos. Vea Comentarios del caso
Compuerta: Elemento BPMN utilizado para controlar la divergencia y convergencia de flujos de
secuencia. Las Compuertas determinan ramificaciones, bifurcaciones, combinaciones y uniones en el
Proceso. Vea Propiedades de las Compuertas
Condicin de Compuerta: Condicin que evala qu camino seguir, cuando un Proceso alcanza una
Compuerta exclusiva o inclusiva. Vea Ruta del Proceso
Condicin: Sentencia que debe cumplirse para que ocurra una accin.
Conector WS: Componente de Bizagi que promueve una fcil configuracin para invocar servicios
web externos. Este conector soporta tanto la invocacin de servicios SOAP como de servicios REST.
Constructor de temas: Editor visual que permite definir y configurar la apariencia del Portal de
trabajo. Vea Constructor de temas
Consulta de aplicacin: Consulta que permite buscar y consultar casos en Bizagi. Vea Consultas de
aplicacin
Consulta: Consulta de informacin relacionada a casos creados. Vea Consultas
Contador (anlisis): Sensor que permite obtener el nmero de veces que un flujo de Proceso ha
pasado a travs de una Tarea especfica en un Proceso. Vea Sensores
Contenedor: Componente visual de las Formas que permite agrupar la informacin que se muestra.
Vea Contenedores
Contexto: Punto de inicio del modelo de datos que determina cmo el usuario navega a travs del
conjunto de atributos y cmo la informacin es construida. Vea Contexto

Copyright 2014 - Bizagi

2745

Control de Forma: tem o elemento incluido en una Forma. Vea Controles de Forma
Cuello de botella: Paso de un Proceso que limita el desempeo o capacidad de todo el Proceso.
Vea Anlisis

D
Definicin constante: Definicin configurada por el usuario que adquiere valores fijos que no
dependen del modelo de datos. Estas definiciones pueden ser modificadas en Bizagi Studio (en el
ambiente de desarrollo) o en el Portal de Trabajo (para ambiente de produccin). Vea Definiciones
constantes
Definicin Get: Definicin Xpath utilizada para obtener un valor del modelo de datos. Vea
Definiciones XPath
Definicin Set: Definicin Xpath utilizada para asignar un valor al modelo de datos. Vea
Definiciones XPath
Definicin Xpath: Expresin que obtiene o actualiza valores del modelo de datos. A diferencia de
las definiciones constantes, las definiciones XPath deben ser asociadas a un Proceso o aplicacin.
Vea Definiciones XPath
Dependencia: Relacin existente entre dos objetos Bizagi. Por ejemplo, una entidad puede tener una
dependencia con una Forma si uno o ms de sus atributos estn incluidos en la Forma como
controles. Vea Objetos con deployment
Deploy: Proceso por el cual un proyecto Bizagi es llevado de un ambiente a otro. Vea Deployment
de Procesos
Deployment avanzado: Herramienta para realizar deployments de proyectos a escenarios
avanzados muy especficos. Vea Deployment avanzado
Dimensin: Conjunto de valores que son usados como filtros por todos los reportes Bizagi: BAM,
Anlisis y Sensores. Los reportes muestran informacin de todos los casos por defecto; sin
embargo, los casos mostrados pueden ser filtrados por una dimensin. Vea Dimensiones
Diseador de Formas: Editor donde se disea la interfaz de usuario de cada Tarea. Vea
Componentes del diseador de Formas
Dominio: Grupo de una red en el cual todas las cuentas de usuario, computadores, impresoras y
otros componentes de seguridad, se registran con una base de datos central de seguridad.

E
ECM (Enterprise Content Management): Conjunto de estrategias, mtodos y herramientas usadas
para organizar, almacenar y administrar documentos de una organizacin y sus contenidos.

Copyright 2014 - Bizagi

2746

Elemento de asignacin: Elemento utilizado en Expresiones para asignar valores a atributos en un


modelo de datos o a variables, a travs de una interfaz muy simple. Vea Elemento de asignacin
Elemento de expresin: Elemento utilizado para ingresar instrucciones en cdigo para realizar
cualquier tipo de Tarea. Las expresiones pueden realizar clculos y validaciones utilizando funciones
Xpath. Vea Elemento de expresin
Encripcin de Contrasea: Proceso de codificacin de contraseas de manera que solo las partes
autorizadas puedan leerlos, de esta manera se incrementa la seguridad. Vea Administracin del
Portal de trabajo
Enrutamiento de Proceso: Reglas de negocio que determinan el camino que debe seguir el
Proceso cuando alcance las dos Compuertas divergentes que requieren una expresin: Compuertas
exclusivas e inclusivas. Vea Ruta del Proceso
Entidad de aplicacin: Entidad que centraliza la informacin de un proyecto o un conjunto de
Procesos. Estas entidades administran todo el modelo de datos para todo el proyecto. Vea Tipos de
entidad
Entidad de Proceso: Entidad desde donde se acceden todos los datos del Proceso. Vea Entidad de
Proceso
Entidad de Sistema: Entidad que pertenece al modelo de datos interno de Bizagi e incluye
informacin relacionada a usuarios finales, reas, lugares, roles, habilidades entre otras. Vea Tipos
de entidad
Entidad maestra: Entidad de negocio que almacena informacin que es directa y exclusivamente
relacionada a cada caso de un Proceso. Vea Tipos de entidad
Entidad paramtrica: Entidad que almacena valores predefinidos, o valores parametrizables, que
son independientes de la ejecucin del Proceso. Durante un caso sus valores pueden ser utilizados,
pero no pueden ser modificados. Vea Tipos de entidad
Entidad: Objeto real o abstracto (personas, lugares, eventos, etc.) que puede ser identificado de
forma nica y que contiene informacin de inters para el negocio. Vea Modelo de datos
Esquema de das festivos: Esquema que define los das festivos o das de descanso que aplican
para cada Esquema de horario de trabajo. Vea Esquema de das festivos
Esquema de horario de trabajo: Funcionalidad de Bizagi que define el horario de trabajo de cada
organizacin y usuario. Vea Esquema de horario de trabajo
Esquemas de Replicacin: Configuracin que define la frecuencia y forma en que la informacin
replicada se actualiza, inserta o deshabilita en Bizagi desde un origen externo. Vea Replicacin
Evento de fin: Elemento BPMN. Indica el fin de un flujo de Proceso. Vea Evento de fin
Evento de inicio: Elemento BPMN. Indica el inicio de un flujo de Proceso. Vea Evento de inicio

Copyright 2014 - Bizagi

2747

Evento de seal: Elemento BPMN. Evento utilizado para comunicar Procesos entre s a travs del
envo y recepcin de seales y mensajes. Vea Colaboracin
Evento Intermedio: Elemento BPMN. Indica que algo sucede en algn lugar entre el inicio y el final
de un Proceso. Vea Evento intermedio
Eventos con interrupcin: Tipo de Evento adjunto a los bordes de una actividad. Cuando se
dispara, interrumpe la ejecucin de la actividad a la cual se encuentra adjunto y continua con un flujo
de Proceso alterno.
Expresin script booleanas: Expresin condicional compleja que evala un conjunto de condiciones
y devuelve un valor booleano (verdadero o falso). Vea Script booelana
Expresin booleana: Expresin condicional que evala un conjunto de condiciones y devuelve un
valor booleano (verdadero o falso). Vea expresiones booleanas.
Expresin: Mdulo que permite definir reglas de control (enrutamiento), validaciones, clculos,
funciones y asignacin de usuarios. Hay cuatro tipos de expresiones: Expresiones booleanas, script
booleanas, expresiones de script y expresiones de script de usuarios. Las expresiones de script se
crean utilizando cdigo Bizagi para validar y calcular requerimientos de negocio. Vea Definicin de
reglas de negocio.

F
Figura: Trmino utilizado para referirse a elementos BPMN.
Forma anidada: Forma incluida dentro de otra Forma. Las Formas anidadas se crean en la entidad
que contiene su informacin y no directamente en el Proceso. Vea Formas de entidad
Forma de administracin de entidad: Formas para la administracin de entidades paramtricas en
el Portal de trabajo. Permiten mostrar, agregar y editar registros de entidades paramtricas. Vea
Formas administrables para entidades paramtricas
Forma de consulta: Forma que contiene criterios de bsqueda para consultar casos creados. Vea
Formas de consulta
Forma de entidad: Forma que no es creada directamente en el Proceso sino en la entidad que
contiene la informacin y que puede ser reutilizada en varias formas de un Proceso. Vea Formas de
entidad
Forma de resumen: Forma relacionada a un Proceso que muestra informacin resumida de un caso
sin necesidad de acceder al mismo. Vea Formas globales y de resumen
Forma Global: Forma relacionada a un Proceso que muestra informacin resumida de un caso,
cuando un usuario no posee actividades pendientes en l o cuando el caso est cerrado. Vea
Formas globales y de resumen
Formas: Interfaz de usuario que muestra la informacin del Proceso a usuarios finales, para que
ellos interacten con la herramienta y realicen sus actividades pendientes. Vea Crear la interfaz de

Copyright 2014 - Bizagi

2748

usuario
Funcin Xpath: Funcin que permite realizar operaciones y clculos sobre colecciones de manera
fcil e intuitiva. Vea Funciones Xpath

G
Grilla: Control de Forma utilizado para mostrar informacin contenida en colecciones. Tambin se
conoce como Tabla. Vea Tablas
Grupo de seguridad de Bizagi Studio: Grupo de usuarios con derechos de acceso especficos al
Portal de trabajo, mens del Portal de trabajo, privilegios de los Procesos, entidades y reglas
globales de Proceso. Vea Grupos de seguridad Bizagi
Grupo de usuarios: Grupos que combinan propiedades de usuario para encontrar usuarios finales
que cumplan con todas ellas. Los grupos de usuarios se crean para conceder o restringir permisos
de acceso a los mens del Portal de trabajo. Vea Grupos de usuarios
Grupo: Contenedor de Forma utilizado para mostrar informacin en bloques, organizndola
visualmente en pequeos conjuntos de informacin relacionada. Vea Contenedores
Grupos de reglas: Grupos de reglas de poltica con propsitos similares. Cuando un Grupo de
reglas se relaciona a una Accione de actividad, todas las polticas incluidas en el grupo se evaluarn,
Vea Grupos de regla

H
I
IIS (Internet information services): Servidor web extensible creado por Microsoft para uso con la
familia Windows NT. Vea Instalacin de IIS
Inbox: Lista de todas las actividades pendientes. Los Inbox son independientes para cada usuario
final, es decir, cada Inbox muestra exclusivamente los casos que un usuario particular tiene
asignados. Vea Men principal
Inline (adicin/edicin): Propiedad de las tablas que permite agregar/editar registros sin
necesidad de utilizar una Forma de adicin/edicin. Vea Tablas
Instancia de Subproceso: Ocurrencia especfica de un Subproceso mltiple. Vea Conceptos del
Subproceso mltiple
Iteracin sobre fact (Elemento): Elemento que puede ser incluido en expresiones para realizar
iteraciones (o ciclos) sobre una relacin uno a muchos. Utilizada UNICAMENTE cuando una relacin
no puede accederse directamente a travs del modelo de datos utilizando Xpath. Vea Iteracin
sobre fact

Copyright 2014 - Bizagi

2749

Iteracin sobre Xpath (Elemento): Elemento que puede ser incluido en expresiones para realizar
iteraciones (o ciclos) sobre una coleccin Xpath, es decir, una relacin uno a muchos. Vea Iteracin
sobre Xpath

J
JBOSS: Servidor de aplicacin escrito en Java que puede almacenar componentes de negocio
desarrollados en Java.
JDBC: API para el lenguaje de programacin Java que define cmo un cliente debe acceder una
base de datos.
Job de alarma: Trabajo programado asociado a alarmas o notificaciones que se envan cuando una
actividad est prxima a vencer, vence o ya ha vencido. Vea Administrar trabajos programados
Job de espera: Trabajo programado asociado a Actividades de Proceso tales como timers o
reintentos asncronos. Vea Administrar trabajos programados
Job de sistema: Trabajo programado asociado a tareas de mantenimiento del sistema que Bizagi
realiza de manera automtica con el fin de asegurar un estado adecuado del sistema. Vea
Administrar trabajos programados
Job de usuario: Trabajo programado asociado a tareas definidas por el usuario. Vea Administrar
trabajos programados
Job: Trabajo programado para ejecutar acciones independientes del flujo de trabajo,
peridicamente. Ejecutado por el servicio de Scheduler. Vea Administrar trabajos programados
JSON (JavaScript Object Notation): Formato estndar abierto que utiliza texto legible para
intercambiar datos.
JTA (Java Transaction API): API para el lenguaje de programacin Java que establece un conjunto
de interfaces para permitir transacciones entre los elementos involucrados en un ambiente Java.

K
KPI (Key performance indicator): Medida de desempeo de un Proceso.

L
Lane: Elemento BPMN utilizado para diferenciar elementos como roles internos, posiciones,
departamentos, etc. Representan reas funcionales que pueden ser responsables de las Tareas. Vea
Propiedades de Swimlanes
Layout: Componente del diseador de Formas que permite manipular el diseo de una Forma,
especficamente, la separacin del contenido en diferentes columnas. La pestaa de layout define el

Copyright 2014 - Bizagi

2750

porcentaje por el cual distribuir el espacio disponible en el rea de trabajo. Vea Layouts
LDAP (Lightweight Directory Access Protocol): Conjunto de protocolos para acceder y mantener
directorios de informacin sobre un protocolo de internet.
Librera de componentes: Repositorio de componentes personalizados que pueden ser
referenciados desde Bizagi. Vea Librera de componentes
Llave de negocio: Atributo o atributos, definidos por el usuario, que identifican de manera nica un
registro de una. Vea Llaves de negocio
Llave fornea: Atributo o atributos en una entidad que identifican de manera nica un registro de
otra entidad.
Llave surrogada: Nmeros consecutivos de fila generados de manera automtica que identifican de
manera nica cada registro de una entidad. No posee conexin a los atributos en la fila,
simplemente la hace nica. Vea Modelo de datos
Lugar: Componente de la organizacin que refiere una ubicacin geogrfica. Esta seccin tambin
define oficinas o sucursales, si aplican. En Bizagi, un usuario pertenece a un lugar. Vea Organizacin
Localizacin: Propiedad de los objetos Bizagi que permite su traduccin a cualquier idioma. Vea
Localizar Procesos y sus componentes

M
Management Console: Aplicacin utilizada para administrar los ambientes de Produccin o
Pruebas. Entre las actividades de mantenimiento que se pueden realizar desde el management
console se encuentran: hacer seguimiento a trabajos programados, cambiar el servidor SMTP para
notificaciones, configurar trazas de ejecucin, revisar parmetros de conexin configurados para
integracin con sistemas externos, o administrar licencias y clusters en ambiente de produccin,
entre otros. Vea Management Console
Mapeo: Proceso por el cual un objeto Bizagi se relaciona a un elemento del Modelo de datos de un
Proceso.
Metadatos: Datos ingresados en cada instancia del caso relacionados a cada atributo.
Mtodo de asignacin: Mtodo que define cmo Bizagi asigna una Tarea (por carga, a todos,
secuencial, primer usuario disponible). Vea Componentes de asignacin de trabajo
Milestone: Elemento BPMN. Sub-particin dentro del Proceso que indica diferentes etapas o fases
durante el Proceso. Vea Propiedades de Swimlanes
Modelo de datos: Estructura de datos de negocio que los Procesos requieren para su ejecucin. La
manera en que se defina el modelo de datos en Bizagi define especficamente cmo se almacenan y
acceden los datos. Vea Modelo de datos

Copyright 2014 - Bizagi

2751

Motor de base de datos: Componente de Software utilizado para crear, leer, actualizar y eliminar
datos de una base de datos.
Motor de dependencias: Servicio que detecta entidades, formas, reglas, etc, que estn siendo
usadas por el Proceso al cual se realizar un deployment, de manera que estos se lleven al ambiente
destino de manera automtica. Vea Objetos con deployment
Motor de Workflow: Aplicacin de software que interpreta y ejecuta los pasos y reglas de negocio
definidas en un Workflow.
Movilidad: Funcionalidad de Bizagi que provee compatibilidad con cada plataforma mvil,
ofreciendo un experiencia de usuario optimizada para dispositivos mviles. Vea Movilidad

N
Notificacin automtica: Mensaje de correo electrnico predefinido que se enva automticamente
para informar cundo una actividad ha sido asignada, un caso ha sido abortado o una Tarea se
encuentra retrasada. Vea Notificaciones automticas

O
Obsoleto: Funcionalidad o caracterstica que ya no es soportada por Bizagi. Las funcionalidades
obsoletas continuarn funcionando en el futuro, pero no estarn disponibles para su uso.
OLAP (Online analytical processing): Tecnologa utilizada para recolectar, administrar y procesar
datos multidimensionales y proveer acceso rpido a estos para propsitos analticos.
One-click deployment: Herramienta para realizar Deployments de Procesos de manera fcil e
intuitiva a travs de un asistente. Vea Deployment de Procesos
Organizacin: Funcionalidad de Bizagi que permite definir una estructura jerrquica de la compaa
y la asociacin entre las distintas personas o reas de las cuales consiste. Vea Organizacin
Origen de datos: Referencia a un objeto o elemento del Modelo de datos.

P
Participante: Usuario que realiza una actividad. Vea Asignacin de trabajo
Paso: Trmino utilizado para referirse a una Tarea, Evento, Compuerta o Proceso especfico.
Patrn Ad hoc: Patrn de modelamiento utilizado para modelar situaciones que involucran Procesos
no estructurados (Ad Hoc) en lugar de Procesos de negocio bien definidos. Vea Procesos Ad Hoc
Plantilla de documento: Funcionalidad que permite generar documentos en formato Word, Excel o
PDF con informacin del Proceso. Vea Plantillas de documento

Copyright 2014 - Bizagi

2752

Pool: Elemento BPMN. Contenedor de un nico Proceso (contiene los flujos de secuencia entre
actividades). Vea Propiedades de Swimlanes
Precondicin: Condicin lgica que permite o restringe la ejecucin de elementos que se
encuentran en un nivel de jerarqua ms bajo. Permite definir una condicin de jerarqua para
organizar la ejecucin de acciones basadas en una lgica simple. Vea Precondiciones
Process Central: Conjunto de plantillas de Proceso listas para ejecutar. Descrguelas, aprenda,
explore y adapte los Procesos a las necesidades particulares de su compaa. Vea Process Central
Proceso padre: Proceso desde el cual un Subproceso especfico se crea o lanza.
Propiedad de usuario: Informacin relevante a cada usuario de manera individual. Este incluye el
nombre, direccin de correo electrnico, dominio, rol, posicin, usuario delegado y cualquier otra
que el usuario desee definir. Vea Propiedades de usuario

Q
R
Regla de asignacin: Regla que determina el usuario especfico o usuarios que estn habilitados
para llevar a cabo una actividad especfica. Vea Componentes de asignacin de trabajo
Regla de negocio: Condiciones, estndares o reglas que deben cumplirse y que son controladas
por la organizacin en el flujo del Proceso. Las reglas de negocio pueden ser creadas como
Expresiones o Polticas. Vea Definicin de reglas de negocio
Regla de poltica: Poltica que evala condiciones de negocio simples; una condicin se ejecuta
cuando se cumple una condicin. Estas reglas se basan en operadores lgicos Si, Sino y Entonces.
Vea Reglas de Poltica
Regla de visibilidad: Conjunto de condiciones que deben cumplirse con el fin de mostrar un Control
en una Forma. Vea Visible, editable y requerido usando expresiones
Relacin muchos a muchos: Relacin entre dos entidades donde una instancia de una entidad
(entidad A) se asocia con una, cero o muchas instancias de otra entidad (entidad B), y una instancia
de la entidad B se asocia con una, cero o muchas instancias de la entidad A. Vea Tipos de relaciones
Relacin uno a muchos: Tipo de relacin donde una entidad (entidad A) puede estar asociada con
cero, una o muchas instancias de otra entidad (entidad B). Sin embargo, para una instancia de la
entidad B, hay solo una instancia de la entidad A. Vea Tipos de relaciones
Relacin uno a uno: Tipo de relacin donde hay una nica correspondencia entre dos entidades, es
decir, cada registro de una entidad (entidad A) est asociada con un nico registro de otra entidad
(entidad B) y vice versa. Vea Tipos de relaciones

Copyright 2014 - Bizagi

2753

Release candidate: Opcin que permite marcar versiones de Proceso que no estn en su forma final
y que sern usadas para comprobar si han surgido problemas crticos durante el periodo de
desarrollo previo. Bizagi tendr sus proyectos bloqueados en ambiente de desarrollo. Vea Usando
Release candidate
Replicacin: Mecanismo de integracin a nivel de datos que permite conectar el Modelo de datos
del Proceso a fuentes de datos externas. Con la Replicacin, Bizag sincroniza sus entidades con los
datos de la fuente externa peridicamente (como una tarea programada) y por lo tanto, mantiene
una copia actualizada de la informacin almacenada en la tabla externa. Vea Replicacin
Repositorio ECM: Plataforma de almacenamiento centralizado para los documentos de la
organizacin y su contenido.

S
Secuencia: Contador que se incrementa en un valor definido en cada invocacin. Las secuencias se
utilizan frecuentemente para garantizar valores nicos, en atributos asociados a un caso especfico o
a nmeros de caso personalizados. Vea Definir y usar secuencias
Seguridad de Bizagi Studio: Mdulo de Bizagi que permite administrar los derechos de acceso al
Portal de trabajo, mens del Portal de trabajo, privilegios de los Procesos, entidades y reglas de
negocio globales. Vea Seguridad de Bizagi Studio
Seguridad del caso: Mdulo de administracin que permite administrar los privilegios de acceso de
los usuarios, a la informacin de los casos. Vea Seguridad de casos
Sensor (anlisis): Conjunto de indicadores que permiten revisar y controlar el tiempo y nmero de
casos entre dos Tareas de una Proceso, el nmero de activaciones de una Tarea especfica y
establecer comparaciones de SLA (Acuerdos de nivel de servicio). Vea Sensores
Servicio web: Software que provee los medios de interaccin entre dispositivos electrnicos en la
web.
Servidor: Sistema que provee servicios a otras aplicaciones (y sus usuarios) en el mismo u otros
computadores (servicio de red).
Servidor BPM: El servidor BPM en la arquitectura de sistema de Bizagi es el servidor que alberga el
Portal de trabajo. El servidor BPM contar con un servicio auxiliar de Bizagi (llamado Scheduler), el
cual ejecuta tareas orientadas a la administracin del sistema, o trabajos offline y asncronos. El
portal de trabajo se configura sobre una instancia de servidor web (si utiliza una plataforma de
.NET) o sobre un servidor de aplicaciones JEE como WebSphere, Weblogic o JBoss (si utiliza una
plataforma JEE).
Simulacin de Procesos: Funcionalidad de Bizagis que permite evaluar cambios a Procesos antes
de su implementacin en la vida real. Vea Simulacin

Copyright 2014 - Bizagi

2754

SMTP (Simple Mail Transfer Protocol): Protocolo de comunicacin estndar para enviar mensajes
a lo largo de protocolos de internet. Vea Instalacin un Servidor SMTP local
SOAP (Simple Object Access Protocol): Protocolo basado en la especificacin XML para
intercambiar informacin estructurada en la implementacin de Servicios Web en redes de
computadores.
Solicitudes pendientes de usuario: Solicitud creada al administrador del Portal de trabajo para
desbloquear cuentas de usuario cuando estas han excedido el nmero mximo de intentos de
conexin fallidas o se ha cumplido el tiempo lmite de inactividad de la cuenta. Vea Cuentas
bloqueadas
Stopwatch: Sensor que permite obtener el nmero de veces que un flujo de Proceso ha pasado a
travs de un camino especfico y el tiempo que le ha tomado hacerlo. Vea Sensores
Subproceso embebido: Elemento BPMN. Conjunto de actividades que son dependientes del
Proceso padre; comparten la misma informacin o datos. Tienen un objetivo claro y por lo tanto,
pueden ser definidos con un comienzo y un fin. Vea Subproceso embebido
Subproceso mltiple: Elemento BPMN. Tipo de Subproceso que permite la creacin de mltiples
ocurrencias o instancias del mismo Subproceso. Vea Subprocesos mltiples
Subproceso reusable: Elemento BPMN. Conjunto de Actividades que son independientes del
Proceso padre y que pueden ser invocados desde uno o varios Procesos. En BPMN, un Subproceso
reusable recibe el nombre de Actividad de Llamada Vea Subprocesos reusables
Subproceso: Elemento BPMN. Actividad que incluye figuras y elementos dentro de este. Un
Subprocesos es un Proceso en s mismo, cuya funcionalidad es ser parte de un Proceso ms
extenso. Vea Subprocesos
Subproceso transaccional: Elemento BPMN. Subproceso cuyo comportamiento es controlado a
travs de un protocolo de transaccin. Incluye los tres resultados bsicos de una transaccin:
Finalizacin exitosa, finalizacin fallida y cancelacin. Vea Subprocesos transaccionales

T
Tabla de decisin: Precisa y compacta forma de modelar lgicas complicadas en Bizagi. Asocia
condiciones con acciones a realizar, usando constantes o definiciones Xpath (vocabularios). Vea
Tablas de decisin
Tabla: Control de Forma utilizado para mostrar informacin contenida en colecciones. Vea Tablas
Tag (Tag de template): Referencia a un objeto del modelo de datos de un Proceso que es utilizada
en Plantillas de documento para mostrar informacin del Proceso. Vea Plantillas de documento
Tarea: Elemento BPMN. Actividad que no puede ser desglosada en niveles ms bajos de detalle. Es
realizada por una persona y/o aplicacin. Vea Modelado para ejecucin
Tiempo de ciclo: Medida de capacidad del Proceso. Tiempo total desde el inicio hasta el final de un

Copyright 2014 - Bizagi

2755

Proceso.
Token: Constructor descriptivo usado para ilustrar cmo se comporta el flujo de un Proceso en
tiempo de ejecucin. El concepto de token se utiliza para explicar algunos de los comportamientos
de un modelo BPMN. El desempeo del Proceso se representa describiendo la manera como un
token viaja (o no viaja) a travs de los caminos disponibles del flujo y sus objetos (Eventos,
Actividades y Compuertas)
Totalizador: Propiedad de las columnas de una tabla que permite obtener un valor nico al aplicar
una funcin de agregacin a los valores de la columna. Las posibles funciones de agregacin son:
Cuenta, max, min, promedio, sum. Vea Totalizadores
Traza: Funcionalidad de Bizagi que permite dar seguimiento a la ejecucin de un Proceso y a los
objetos y componentes que constituyen el Portal de trabajo. Vea Diagnstico y control de errores

U
UI: Interfaz de usuario.
Usuario asignado por defecto: Usuario al cual se asigna una Tarea o Evento cuando las condiciones
establecidas en las reglas de asignacin no se cumplen por ningn usuario. Vea Cuando ningn
usuario cumple las condiciones de asignacin
Usuario delegado: Usuario definido para estar a cargo de atender los casos asignados a un usuario
especfico, cuando este usuario no est disponible. Vea Usuario delegado

V
Validacin de Integridad de datos: Validacin realizada por Bizagi con el fin de asegurar la
integridad, precisin y consistencia de los datos antes de llevar un proyecto al ambiente de pruebas
o produccin. Vea Objetos con deployment
Validaciones de Forma: Funcionalidad de Bizagi que permite validar condiciones de negocio en
Formas para asegurar la validez e integridad de los datos al momento de ser ingresados por los
usuarios finales. Vea Acciones y Validaciones
Virtualizacin: Mecanismo de integracin a nivel de datos que permite conectar el modelo de
datos del Proceso a fuentes de datos externas. Con la Virtualizacin, los Procesos en Bizagi pueden
acceder a la informacin almacenada a lo largo de mltiples fuentes de datos (RDBMS, XMLs etc.), y
presentarla como parte de la informacin de negocio. Vea Virtualizacin
Vocabulario: Definicin que obtiene o asigna informacin usada en expresiones y polticas. La
principal ventaja de los vocabularios es que sus valores pueden ser fcilmente modificados por los
usuarios finales en el Portal de trabajo, permitiendo flexibilidad y adaptabilidad a las cambiantes
condiciones de negocio. Vea Vocabularios

W
Copyright 2014 - Bizagi

2756

WFUser: Tipo de entidad del sistema que contiene informacin de los usuarios Bizagi.
Widget store: Tienda de Bizagi donde se pueden descargar Widgets predefinidos. Vea Personalizar
la interfaz de usuario
Widget: Control especializado de Formas con propiedades predefinidas orientado a requerimientos
especficos de negocio. Los Widgets son tiles para escenarios en los cuales se requiere
personalizar la interfaz de usuario y usar funcionalidades extendidas (i.e., mostrar un grfico de
estadsticas, usar un Google map, o cualquier otra cosa que no se considere en los controles de
Bizagi). Vea Personalizar la interfaz de usuario
Work Portal: Interfaz de usuario donde los usuarios finales crean nuevos casos y tienen acceso a los
que han sido asignados, para realizar las actividades de acuerdo a lo diseado. Vea Portal de
trabajo

X
Xpath: Lenguaje usado para navegar a travs de los elementos y atributos del Modelo de datos de
Bizagi.

Y
Z

Copyright 2014 - Bizagi

2757

S-ar putea să vă placă și