Documente Academic
Documente Profesional
Documente Cultură
Gua de Usuario
Tabla de Contenido
13
................................................................................................................................... 14
................................................................................................................................... 19
Entrenamiento y soporte
................................................................................................................................... 22
Arquitectura
................................................................................................................................... 23
Central de Procesos
................................................................................................................................... 33
Instalacin de ..........................................................................................................................................................
servicios web para la Central de Procesos
38
47
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
................................................................................................................................... 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
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
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
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
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
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
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
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 la localizacin
................................................................................................................................... 2203
Traducir los ..........................................................................................................................................................
objetos del Portal de Trabajo
2204
Localizar los..........................................................................................................................................................
procesos y sus componentes
2208
................................................................................................................................... 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
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
................................................................................................................................... 2426
Movilidad
................................................................................................................................... 2575
Consideraciones
..........................................................................................................................................................
para mviles
2584
Aplicacin de
..........................................................................................................................................................
Windows 8
2585
10
................................................................................................................................... 2654
BAM
..........................................................................................................................................................
Anlisis
..........................................................................................................................................................
Sensores ..........................................................................................................................................................
Mis Reportes
..........................................................................................................................................................
Dimensiones..........................................................................................................................................................
2655
2665
2672
2684
2687
2741
................................................................................................................................... 2741
11
Parte I
Bienvenido a Bizagi BPM Suite V10.5
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.
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.
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.
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.
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
17
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.
18
Productos relacionados
19
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.
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.
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.
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
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.
24
25
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
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.
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
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.
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.
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).
30
Ambiente de produccin
La configuracin del ambiente de produccin en Bizagi soporta clsteres.
31
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.
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.
33
Antes de empezar asegrese que tiene instalada la LTIMA versin de Bizagi. Tambin es
necesario contar con conexin a Internet.
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.
35
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.
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.
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
38
39
Tenga en cuenta que algunos programas como Skype pueden entrar en conflicto con el IIS al momento
de iniciar el Sitio Web por Defecto.
40
41
42
43
3. En la propiedad URL del Servicio Web, cambie www.Bizagi.com por el nombre de su mquina o
simplemente escriba localhost.
44
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.
47
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.
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).
50
R
E
Servidor web
Framework
Versin 4.0 del framework .NET que instala Bizagi Studio. El framework incluye
otros componentes como Visual C++ 2010, 2008 redistribuble.
Navegador
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.
51
8 GB
Disco duro
80 GB de espacio libre
HARDWARE
SOFTWARE
Motor de base de
datos
SERVIDOR BPM
RAM
8 GB
Disco duro
40 GB de espacio libre
HARDWARE
Sistema operativo
SOFTWARE
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
52
HARDWARE
RAM
4 GB mnima.
Recomendado: 6 GB.
Disco duro
10 GB de espacio libre
Resolucin de
pantalla
Sistema operativo
Navegador
Componentes
adicionales
SOFTWARE
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.
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.
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.
NMERO
11.0.2100 o superior
10.50.2500 o superior
54
10.00.2531 o superior
9.00.3042 o superior
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.
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
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):
56
Luego, en las opciones de Seguridad, asegrese de est marcado Autenticacin SQL Server y
Windows.
57
2. TCP/IP protocol
Ejecute el SQL Server Configuration Manager.
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:
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.
60
Para permitir conexiones remotas, en el tem Conexiones, revise la propiedad Permitir conexiones
remotas a este servidor:
61
62
Verifique que este login de usuario est habilitado y permitido para conectarse, bajo sus opciones
de Status:
63
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.
64
TIPO DE LOGIN
DE USUARIO /
PERFIL
PERMISOS
OBJETIVO / DESCRIPCIN
Administrador
del sistema
(opcional)
Rol de servidor:
sysadmin
Administrador
de procesos
Analista de
procesos
(opcional)
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:
66
Verifique que este login de usuario est habilitado y permitido para conectarse, bajo sus opciones
de Status:
67
D clic en Ok.
68
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'
69
use [tempdb]
exec sp_helprotect NULL, 'process_admin_user'
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'
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
71
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.
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).
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:
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:
74
75
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
77
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.
78
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
79
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
8.0
7.5
7.0
6.0
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
APLICA PARA...
.NET Extensibility
ASP.NET
80
ASP.NET 4.5
Static Content
Performance Features
Windows authentication
Security
81
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.
83
84
85
86
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.
88
89
90
91
92
Esta opcin inicia un asistente para configurar el IIS seleccionando los tems y componentes.
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.
94
4. Seleccione los servicios de rol requeridos por Bizagi para el componente del servidor Web (IIS).
95
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.
97
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.
98
99
100
Ntese que esto puede tardar algunos minutos, estos cambios muy posiblemente requieran reiniciar la
mquina.
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.
101
102
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/
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.
104
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.
105
106
107
Cuando se incluya el SQL Server Express 2008 SP3, las credenciales por defecto para acceder el
servidor son:
LOGIN: sa
PASSWORD: Bizagi10GO
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.
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.
110
111
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.
113
Qu sigue?
Usted podr empezar a utilizar Bizagi Studio usando la opcin de Iniciar Bizagi Studio, o desde los
accesos directos.
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.
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
115
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.
Introduccin
Cree un nuevo proyecto Bizagi para iniciar con la automatizacin de sus Procesos.
116
Crear el proyecto
Siga estos pasos:
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).
117
Si su cuenta no posee estos permisos, entonces podr ingresar las credenciales de una cuenta
autorizada que s cumpla con stas condiciones:
118
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
120
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:
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).
122
Si su cuenta no posee estos permisos, entonces podr ingresar las credenciales de una cuenta
autorizada que s cumpla con stas condiciones:
123
124
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).
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:
126
127
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.
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.
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.
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:
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).
131
Si su cuenta no posee estos permisos, entonces podr ingresar las credenciales de una cuenta
autorizada que s cumpla con stas condiciones:
132
Cuando Bizagi detecte que el plugin est instalado, este paso no sern necesario.
133
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:
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:
135
136
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.
138
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\...).
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
139
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.
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).
141
Server:
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.
142
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.
144
Seleccione el servidor central BPM que almacena el proyecto y seleccione el nombre el proyecto.
Haga clic en Finalizar.
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).
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.
147
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
149
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.
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.
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.
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.
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.
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).
153
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.
154
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.
155
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):
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:
157
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:
159
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.
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.
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
162
OPCIN DE MEN
DESCRIPCIN
Nuevo Proyecto
Proyectos
Recientes
Importar Plantillas
Salir
Pestaa de Inicio
163
DESCRIPCIN
Mdulos / Asistente
Ejecutar
Buscar
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.
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.
165
Pestaa de Herramientas
OPCIN DE MEN
DESCRIPCIN
Campos de Usuario
Scripting
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
Librera de Componentes
Pestaa de Configuracin
OPCIN DE MEN
DESCRIPCIN
Entorno
Negocios
Seguimiento
Servidor Web
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
Foros de Soporte
Central de Procesos
Comunidad
Comentarios
Comentarle a un amigo
Acerca de
DESCRIPCIN
Notas de la Versin
Administracin de Licencias
Acerca de
168
Estilo e Idioma
OPCIN DE
MEN
Estilo
Idioma
SUB OPCIN
DESCRIPCIN
Control de
Ocultar/
Mostrar
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.
169
170
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.
171
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.
172
173
ELEMENTO
OPCIONES
174
Todas las
Aplicaciones
Aplicacin
Procesos
(Categora por
defecto)
Nombre del
Proceso
Versin del
Proceso
175
Elementos de la
Versin
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.
176
177
ELEMENTO
OPCIONES
DESCRIPCIN
SUB-OPCIONES
Atributos
Formas
Elementos
que aplican
a todos los
mens
178
Valores (no
disponibles en el
Sistema)
Consultas (no
disponibles en el
Sistema)
Aplicacin
Propiedades
Generales
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.
179
Propiedades
Generales
Maestra
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
180
Expresiones
Sistema
Propiedades
Generales
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).
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.
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.
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.
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.
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.
185
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)
187
OPCIN
DESCRIPCIN
Habilitar Email
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
Enviar copia de
Email 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).
188
DESCRIPCIN
OPCIONES DE SCHEDULER
Intervalo
OPCIONES DE UPLOAD
Directorio de Upload
189
OPCIN
DESCRIPCIN
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
Habilitar
registro
relaciones M-M
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
190
OPCIN
DESCRIPCIN
pendientes en el caso en cuestin.
Tipo de Proveedor
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.
191
), eliminar el parmetro.
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:
192
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.
193
DESCRIPCIN
Opciones de localizacin
Cultura global
Formato de Moneda
Dgitos decimales
Smbolo de moneda
Separador decimal
194
ELEMENTO
Separados de miles
DESCRIPCIN
Define el caracter separador de miles.
Zona horaria
Zona horaria servidor
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.
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
Alarmas de tareas
Alarmas de Procesos
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
197
ELEMENTO
DESCRIPCIN
Agrupar casos por nmero de caso Agrupa los casos en el Inbox por nmero de caso
Preferencias de usuario
Forma de preferencias de usuario
Opciones de descarga
Ver contenido de archivo como
Tipos de contenido
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.
198
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:
199
DESCRIPCIN
EntityManager
Interfaces
LDAP
Registra la ejecucin de la
200
Reglas y expresiones
Scheduler
Workflow
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).
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.
203
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 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.
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
205
Tipos de Traces
Los siguientes Traces se registran en un orden cronolgico.
Orden
cronolgico
Tipo de Trace
Descripcin
206
207
208
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.
209
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.
210
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:
211
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.
212
Una vez ejecute el proceso desde Bizagi Studio, se cargar en el navegador la URL del Portal de
Trabajo:
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:
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:
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.
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:
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
218
219
220
221
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.
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.
223
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.
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.
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.
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
227
Compra.
228
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.
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.
230
231
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.
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
Tarea de
Servicio
Tarea de
Recepcin
Tarea de Envo
NOTACIN
Tarea Manual
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
NOTACIN
234
Subproceso
Embebido
Subproceso
Reusable
Subproceso
transaccional
Subproceso
mltiple
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
Compuerta Basada
en Eventos
235
Compuerta
Compleja
Compuerta Inclusiva
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
NOTACIN
236
Evento de Inicio de
Mensaje
Evento de Inicio de
Temporizacin
Evento de Inicio de
Seal
Eventos Intermedios
ELEMENTO
DESCRIPCIN
Evento Intermedio
Simple
NOTACIN
Evento de Mensaje
Evento de
Temporizacin
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
237
Evento de Seal
Evento
Temporizador
DESCRIPCIN
NOTACIN
Evento de Error
Evento de
Cancelacin
238
Evento de
Compensacin
Eventos de Finalizacin
ELEMENTO
Finalizacin simple
DESCRIPCIN
NOTACIN
Finalizacin de
Mensaje
Finalizacin de Error
Finalizacin de
Cancelacin
Finalizacin de Seal
Finalizacin Terminal
Artefactos
ELEMENTO
DESCRIPCIN
NOTACIN
239
Grupo
Anotacin
Objetos de datos
Contenedor (Pool)
DESCRIPCIN
NOTACIN
Carril (Lane)
Fase
Conectores
ELEMENTO
DESCRIPCIN
Flujo de Secuencia
Asociacin
NOTACIN
240
Flujo de Mensaje
Usted puede encontrar ms informacin acerca de modelado y automatizacin en nuestra ayuda del
Bizagi Modeler.
Descargue nuestro Poster de BPMN 2.0
241
PROPIEDAD
DESCRIPCIN
Nombre de Mostrar
Nombre
Descripcin
Texto de Ayuda
URL de Ayuda
Categora
242
Tipo de Acceso
Orden
Forma Global
Forma de Resumen
Habilitar Alarmas
Habilitar Notificaciones
Versin
Estado
CONSIDERACIONES
PROPIEDADES
243
la base de datos.
Descripcin:
Muestra
adicional sobre la tarea.
informacin
244
informacin
245
informacin
246
la base de datos.
Descripcin:
Muestra
adicional sobre la tarea.
informacin
ELEMENTO
Compuerta
Exclusiva
CONSIDERACIONES
Compuerta
basada en
eventos.
Compuerta
Paralela
PROPIEDADES
Descripcin:
Muestra
informacin
adicional sobre la compuerta.
247
ELEMENTO
CONSIDERACIONES
PROPIEDADES
Compuerta
compleja
Descripcin:
Muestra
informacin
adicional sobre la compuerta.
Compuerta
inclusiva
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
pueden
248
ELEMENTO
CONSIDERACIONES
PROPIEDADES
Evento de
Inicio
Evento de
Inicio de
Mensaje
CONSIDERACIONES
PROPIEDADES
249
ELEMENTO
CONSIDERACIONES
PROPIEDADES
Evento de
Inicio de
Temporizaci
n
Evento de
Inicio de
Seal
CONSIDERACIONES
PROPIEDADES
Propiedades bsicas
Evento
Intermedio
Ninguna.
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.
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.
251
ELEMENTO
CONSIDERACIONES
PROPIEDADES
Evento
Temporizacin
Evento de
enlace
252
ELEMENTO
CONSIDERACIONES
PROPIEDADES
Evento de
Seal
CONSIDERACIONES
PROPIEDADES
Propiedades bsicas
Evento de
Temporizacin
Evento de
Error
253
ELEMENTO
CONSIDERACIONES
PROPIEDADES
en la base de datos.
Evento de
Cancelacin
Propiedades bsicas
Nombre visual: Es el nombre del
evento que se muestra en el Portal
de Trabajo.
Nombre: Es el nombre del evento
en la base de datos.
Descripcin: Muestra informacin
adicional sobre el evento.
Evento de
Compensacin
CONSIDERACIONES
PROPIEDADES
254
ELEMENTO
CONSIDERACIONES
PROPIEDADES
Nombre: Es el nombre
evento en la base de datos.
del
Descripcin:
Muestra
informacin adicional sobre el
evento.
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.
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
del
Descripcin:
Muestra
informacin adicional sobre el
evento.
del
Descripcin:
Muestra
informacin adicional sobre el
evento.
256
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)
contenido
de
un
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.
258
ELEMENTO
CONSIDERACIONES
PROPIEDADES
del carril (lane) que se muestra
en el Portal de Trabajo.
Carril (Lane)
Fase (Milestone)
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.
CONSIDERACIONES
PROPIEDADES
La
lnea
normal
se
utiliza
para
259
ELEMENTO
CONSIDERACIONES
PROPIEDADES
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
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.
261
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
como
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
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
Subproceso
263
ELEMENTO
CONSIDERACIONES
PROPIEDADES
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
Subprocesos Embebidos
Para mostrar cmo transformar una tarea en un Subproceso Embebido, utilizaremos el siguiente
diagrama:
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.
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.
266
4. Ingrese el nombre del Nuevo proceso o seleccione un proceso existente desde la lista desplegable,
luego d clic en Finalizar.
267
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.
268
7. Cuando termine, clic en Cerrar. Luego seleccione la opcin S en la ventana de confirmacin para
guardar el modelo.
269
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:
270
2. Clic derecho sobre la actividad que desea convertir en el Subproceso Reutilizable, en este caso, la
271
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.
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.
273
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.
274
275
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.
276
3. Cree una expresin como una accin a la entrada del Subproceso (presionando la tecla shift
mientras hace clic sobre el Subproceso).
277
4. Finalmente asocie la instancia de la entidad del Subproceso, al atributo en la entidad del proceso
padre utilizado para referenciarlo.
278
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>
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.
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.
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.
281
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.
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.
282
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.
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).
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.
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.
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.
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.
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.
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.
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.
290
5. Para utilizar la configuracin Bsica del Subproceso Mltiple d clic en Siguiente sin marcar la
opcin de Configuracin Avanzada.
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.
292
7. Clic en Finalizar
293
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.
294
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).
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:
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.
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.
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.
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.
300
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.
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:
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.
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.
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.
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.
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.
308
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.
310
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.
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.
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.
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.
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
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.
317
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.
319
320
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.
322
La tarea de compensacin es creada automticamente. Realice la misma operacin para las otras dos
actividades.
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.
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.
325
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.
327
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.
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.
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.
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.
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.
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.
333
334
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.
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.
337
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
339
Tareas Manuales
Subprocesos
Eventos de temporizacin
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.
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.
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.
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
344
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.
345
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.
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).
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.
348
6. La ventana con la Lista de Atributos aparecer para que pueda ingresar todos los atributos a la
nueva Entidad Paramtrica.
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.
350
Usted puede incluir atributos adicionales en cualquier momento, de la misma forma como se realiz
en el ejemplo.
351
OPCIONES
DESCRIPCIN
Entidad
Relacin
Agregar
Entidad
Zoom
Opciones de Zoom
Mostrar cuadrcula
Nueva
Mostrar/Ocultar
Maestra/Paramtrica/Sistema
352
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.
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
353
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
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
Moneda
Fecha-Hora
Almacena un atributo que puede ser una fecha o una fecha con hora.
Entero
Texto
356
Entero largo
Texto extendido
Archivo
Flotante
Imagen
Galera de imgenes
Real
Entero corto
Todos los tipos de atributos tienen propiedades adicionales (adicionalmente al nombre visual, nombre
y tipo) que pueden ser ingresados por el usuario o pueden ser dejados en blanco.
Al final de la ventana Lista de Atributos, clic en la opcin Avanzado/Ocultar. Esto mostrar una ventana
pequea par incluir la siguiente informacin:
PROPIEDAD
DESCRIPCIN
Descripcin
Texto de Ayuda
Longitud
Carpeta ECM
357
Localizable
Cifrado
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.
359
2. bajo la opcin Uploads incluya la ruta fsica del directorio donde desea guardar los documentos.
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
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.
Para crear una relacin uno a uno abra el segundo paso del Asistente de Proceso: Modelar Datos.
362
363
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.
365
366
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.
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.
368
369
370
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.
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.
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.
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.
375
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.
377
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.
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.
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.
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
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.
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.
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.
384
385
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).
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
388
9i
10g R1
10g R2
11g R1
11g R2
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.
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
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).
390
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.
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.
392
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).
393
394
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.
395
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.
396
397
398
Opciones de programacin
Descripcin
Habilitar la programacin
para la Replicacin.
Periodicidad
399
Frecuencia diaria
Comienzo
400
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).
401
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.
403
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
404
2. Definir el sistema
Para definir el sistema a utilizar en la integracin, d clic derecho en Sistema y seleccione la opcin
Nuevo Sistema.
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.
406
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.
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.
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.
409
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.
410
411
412
Descripcin
Periodicidad
413
Frecuencia diaria
Inicio
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.
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.
415
Esto significa que cuando el esquema de replicacin se ejecute, este sincronizar la informacin de las
416
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:
417
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.
418
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.
419
IProviderVirtualDA2
IReplicationEntDA.
IParameter
IDatabaseConstants
Descripcin
obj Provider
htMetadata
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
420
arrsColList
RETURNED DataSet
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.
421
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,
422
IProviderVirtualDA2.AddParameter(Vision.DA.IParameter
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,
423
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;
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++;
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 ==
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");
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);
429
return ds;
}
public void executeNonQueryMySQL(string sSQL)
{
MySqlCommand command;
command = new MySqlCommand(sSQL, this.getConnection());
command.ExecuteNonQuery();
}
}
}
public CMySQLReplication()
{
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
431
System;
System.Data;
Vision.Defs;
Vision.DA;
432
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
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;
}
}
435
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;
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;
}
}
}
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
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; } }
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>
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>
442
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
444
}
}
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.
2. Ingrese el Nombre, Nombre Visual y Descripcin para el nuevo sistema y seleccione el checkbox de
445
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).
446
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. .
448
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.
450
11. D clic derecho sobre el nuevo elemento de la clase de la entidad y seleccione la opcin Nueva
Programacin de Replicacin.
451
Seleccione la pestaa Props. Calendario y configure la frecuencia con que la informacin ser replicada
desde la fuente de datos.
452
Descripcin
Periodicidad
453
Inicio
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
454
En la ventana Editar Atributo, escriba el nombre del atributo externo y haga clic en Ok.
455
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.
456
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).
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:
458
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:
460
461
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).
462
La caracterstica Probar proveedor necesita tener IIS (Internet Information Services), ya que es usado
463
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".
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.
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.
465
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).
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.
467
468
Usted puede probar el filtro utilizando la opcin Probar Filtro de la fuente para obtener los valores de
la fuente:
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.
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).
470
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:
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:
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
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
Oracle
9i
10g R1
10g R2
11g R1
11g R2
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.
474
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.
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).
475
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.
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.
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.
478
479
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.
480
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.
482
D clic en Siguiente.
Bizagi crear las entidades y las componentes de configuracin necesarios.
483
484
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:
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.
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
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
488
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:
2. Definir el sistema
Para definir el sistema a utilizar en la integracin, d clic derecho en Sistema y seleccione la opcin
Nuevo Sistema.
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.
490
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.
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.
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.
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.
494
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.
495
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.
497
La tabla Empleado se debe mapear para la Virtualizacin (Adicionada como la entidad Empleado):
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.
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:
499
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.
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.
501
Descripcin
obj Provider
htMetadata
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
502
Descripcin
sEntSource
arrsColList
RETURNED DataSet
Descripcin
sEntSource
arrsKeyColumns
arroKeyValues
arrsColList
RETURNED DataSet
Descripcin
sEntSource
arrsKeyColumns
arrsColList
sFilterText
bFillSchema
iTopReturnRows
RETURNED DataSet
503
sAttrSource)
Parmetros
Descripcin
sEntSource
arrsKeyColumns
arroKeyValues
sAttrSource
RETURNED Object
Descripcin
sEntSource
arrsKeyColumns
arroKeyValues
arrsColList
RETURNED bool
Descripcin
sEntSource
sColumn
oValue
arrsKeyColumns
arroKeyValues
RETURNED int
Descripcin
504
sEntSource
htAddCols
arrsKeyColumns
arroKeyValues
arrsAutoColumns
RETURNED
Hashtable
Descripcin
sEntSource
arrsKeyColumns
arroKeyValues
htUpdateCols
arrsAutoColumns
RETURNED
Hashtable
Descripcin
sEntSource
arrsKeyColumns
arroKeyValues
RETURNED bool
505
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.
506
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,
507
IProviderVirtualDA2.AddParameter(Vision.DA.IParameter
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,
508
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;
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++;
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 ==
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");
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);
514
return ds;
}
public void executeNonQueryMySQL(string sSQL)
{
MySqlCommand command;
command = new MySqlCommand(sSQL, this.getConnection());
command.ExecuteNonQuery();
}
}
}
/// <summary>
/// Connection with the virtual System
/// </summary>
protected CMySQLProvider m_objSystem;
public CMySQLEntity()
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(" ) ");
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
517
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;*/
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
520
implemented.");
}
#endregion
}
}
System;
System.Data;
Vision.Defs;
Vision.DA;
521
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;
}
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;
}
}
524
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;
526
case EDataType.NVarChar:
oDbType = SqlDbType.NVarChar;
break;
case EDataType.NText:
oDbType = SqlDbType.NText;
break;
default:
break;
}
return oDbType;
}
}
}
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();
527
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
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
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;
531
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).
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.
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.
534
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).
535
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 .
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.
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..
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.
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.
541
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).
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.
En las entidades maestras creadas, d clic en Valores para consultar sus registros.
El rea de trabajo de Bizagi mostrar los valores sincronizados.
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:
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.
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.
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).
546
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".
548
Una entidad que ha sido configurada apropiadamente, mostrar OK en cada operacin de verificacin.
549
Aunque la entidad haya sido removida de la virtualizacin, esta puede ser utilizada, y los valores que
se encontraban seguirn siendo los mismos.
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.
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.
552
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.
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.
555
Lineamientos generales
El siguiente articulo enumera las mejores practicas que se deben utilizar (o planear usar) con la
Virtualizacin o Replicacin de 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:
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.
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.
558
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
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?
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.
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).
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.
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
561
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
BIT
Boolean
Nmeros Aproximados
FLOAT
Float
REAL
Real
Fecha y Hora
DATETIME
Date-time
SMALLDATETIME
No soportado
Textos Binarios
BINARY
No soportado
562
No soportado
IMAGE
No soportado
Caracteres de Texto Unicode
NCHAR
NVARCHAR
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
String
NCHAR
NVARCHAR
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
563
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.
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:
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.
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.
567
568
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.
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.
571
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.
572
573
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
575
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.
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.
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.
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.
579
7. Arrastre y suelte los controles para el ltimo grupo: Direccin de entrega, Ciudad de entrega y
Fecha de Entrega.
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.
581
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.
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.
SUB OPCIN
DESCRIPCIN
Deshacer
Rehacer
Check-out
Forma
Guardar
Copiar Desde
584
SUB OPCIN
DESCRIPCIN
copiar su contenido exacto.
Copiar Formato
Propiedades
Mostrar
Alertas
Validacin
Acciones y
Validaciones
Convertir a
Eliminar
Renombrar
Controles
Visible
Editable
Requerido
Idiomas
Seleccionar Idioma
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.
585
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.
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.
588
589
590
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%
592
Cuando se incluye un layout, regrese a la pestaa de Datos o Control para poder arrastrar controles
dentro de l.
593
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).
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.
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.
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 (
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.
598
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
Botn
Combo
Fecha
Plantillas de Documentos
599
CONTROL
DESCRIPCIN
caracteres, tablas, etc.
Archivos
Archivos ECM
Impresin de archivos
Vnculo a Forma
Geolocalizacin
Tabla agrupada
Oculto
Imagen
Etiqueta
Vnculo
Lista
Moneda
Nmero
Radio
Campo de Bsqueda
600
CONTROL
DESCRIPCIN
Sugerencia
Tabla
Cuadro de Texto
Si/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).
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.
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
603
PROPIEDAD
DESCRIPCIN
Entidad principal
Entidad 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:
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.
605
606
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
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.
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.
610
611
612
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.
614
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:
615
Pestaa Bsico
PROPIEDAD
DESCRIPCIN
Atributo de Mostrar
Atributo Adicional
Pestaa Avanzado
PROPIEDAD
DESCRIPCIN
Actualizar al Cambio
Ordenar por
Atributo
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.
617
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.
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
620
PROPIEDAD
DESCRIPCIN
Atributo de Mostrar
Atributo Adicional
Pestaa Avanzado
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
Ordenar por
Atributo
Filtro
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).
623
Fecha
Uso
Presenta un calendario a los usuarios finales para seleccionar una fecha fija. El tiempo en horas y
624
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
Mostrar Hora
625
Note que usted puede seleccionar diferentes configuraciones predefinidas para los formatos de hora y
fecha ya sea en formato corto o largo.
626
Pestaa Avanzado
PROPIEDAD
DESCRIPCIN
Valor Mnimo
Valor Mximo
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.
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.
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.
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
630
PROPIEDAD
DESCRIPCIN
Permitir Borrar
Mximo de Archivos
Extensiones Vlidas
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
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.
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.
632
4. En la propiedad de Extensiones Vlidas escriba pdf para restringir los archivos adjuntos a formato
pdf.
633
634
635
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.
) 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
637
PROPIEDAD
DESCRIPCIN
Mximo de Archivos
Extensiones Vlidas
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
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
Propiedades
Las siguientes son propiedades exclusivas del control Impresin de archivos:
Pestaa Bsico
PROPIEDAD
DESCRIPCIN
Origen
Pestaa de Formato
639
PROPIEDAD
DESCRIPCIN
Alineacin
horizontal
Define la alineacin del botn. Las opciones posibles son: derecha, izquierda,
justificado y centrado.
Formato
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.
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.
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.
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.
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
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.
645
3. Crearemos una nueva forma. Si su forma ha sido creada previamente, seleccinela en la lista.
D clic en la opcin Nueva Forma.
646
forma.
Guarde la forma y cierre la ventana..
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
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.
649
650
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.
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.
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.
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.
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.
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
Formato
Formato de
encabezado
Pestaa Avanzado
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
Validaciones
tabla
de Le permite crear reglas de validacin para este control, que sern verificadas
en tiempo de ejecucin.
Opciones
Borrado
Opciones
Adicin
Opciones de Fila
657
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
658
PROPIEDAD
DESCRIPCIN
Visible
Editable
Requerido
Celda editable
Celda visible
Pestaa Formato
PROPIEDAD
DESCRIPCIN
Alineacin
horizontal de ttulo
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
Pestaa Avanzado
659
PROPIEDAD
DESCRIPCIN
Grupo
Totalizador
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.
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.
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.
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.
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
Pestaa Avanzado
PROPIEDAD
DESCRIPCIN
Extensiones Vlidas
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
664
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.
665
666
667
668
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.
670
671
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.
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.
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.
673
2. Vaya a la pestaa Bsico en las propiedades del control y seleccione URL en las propiedades de
Ejecucin.
674
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
Atributo Adicional
676
Pestaa Avanzado
PROPIEDAD
DESCRIPCIN
Actualizar al Cambio
Ordenar por
Atributo
Filtro
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).
678
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.
680
681
Moneda
Uso
Muestra montos monetarios en la forma.
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
Propiedades
Las siguientes son propiedades exclusivas para el control Moneda:
Pestaa de Formato
PROPIEDAD
DESCRIPCIN
Permitir Decimales
Posiciones
Decimales
Pestaa Avanzado
PROPIEDAD
DESCRIPCIN
Valor Mnimo
Valor Mximo
683
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.
684
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
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
Posiciones
Decimales
Pestaa Avanzado
686
PROPIEDAD
DESCRIPCIN
Vuelva a escribir
Valor Mnimo
Valor Mximo
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.
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
688
PROPIEDAD
DESCRIPCIN
Atributo de Mostrar
Atributo Adicional
Pestaa Avanzado
689
PROPIEDAD
DESCRIPCIN
Actualizar al Cambio
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.
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.
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.
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.
692
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.
694
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.
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.
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
Expresin de
validacin
Pestaa Avanzado
697
PROPIEDAD
DESCRIPCIN
Ordenar
Filtro
Validaciones de
tabla
Permite crear reglas de validacin para este control, que sern verificadas en
tiempo de ejecucin.
Opciones de
Borrado
Opciones de
Adicin
Opciones de Fila
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
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.
699
4. Incluya la informacin a mostrar en la Forma. Defina los controles como editables y requeridos
segn lo necesite.
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
701
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.
703
Propiedades
Las siguientes son propiedades exclusivas del control de Bsqueda:
Pestaa Bsico
PROPIEDAD
DESCRIPCIN
Forma de Bsqueda
Atributo de Mostrar
Pestaa Avanzado
704
PROPIEDAD
DESCRIPCIN
Actualizar al Cambio
Permitir Limpiar
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
Permitir
registros
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)
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).
706
707
4. Habilite la opcin de Nuevos Registros y seleccione una Forma de Adicin de Registros (Agregar
Cliente).
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.
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.
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.
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.
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.
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.
714
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.
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.
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.
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
Atributo adicional
Pestaa Avanzado
719
PROPIEDAD
DESCRIPCIN
Actualizar al Cambio
Permitir Bsqueda
Completa
Permitir Limpiar
Mximo de
Registros
Mnimo de
caracteres
Ordenar por
Filtro
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).
721
3. D clic derecho sobre el control y seleccione Convertir a. Luego seleccione la opcin Sugerencia.
722
4. En las propiedades Bsicas del control Sugerencia, seleccione el atributo de visualizacin deseado.
En esta caso ser el nombre del Cliente.
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.
724
7. Cree una accin para actualizar los datos del cliente, cuando este sea seleccionado. Utilice el
comando Refrescar para hacerlo.
725
8. En las propiedades Avanzadas del control habilite las propiedades Permitir bsqueda completa y
Permitir borrar.
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.
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
Activar exportar a
Excel
Activar exportar a
PDF
728
Pestaa de Formato
PROPIEDAD
DESCRIPCIN
Orientacin
Formato
Formato de
cabecera
729
Pestaa Avanzado
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
Validaciones de
tabla
Le permite crear reglas de validacin para este control, que sern verificadas
en tiempo de ejecucin.
Opciones de
Borrado
Opciones de
Adicin
Opciones de Fila
731
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.
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.
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
Editable
Requerido
Celda editable
Celda visible
Pestaa Formato
734
PROPIEDAD
DESCRIPCIN
Alineacin de
columna horizontal
Permite alinear el texto dentro de las columnas. Las opciones disponibles son:
derecha, izquierda, justificada y centrada.
Ancho de columna
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.
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.
736
2. En la nueva ventana, seleccione la columna Precio Total y vaya a las Propiedades Avanzadas.
737
4. Opcionalmente puede dar formato al valor totalizado. Cambie su tamao de fuente, color y fondo
segn lo desee.
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
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.
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.
741
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.
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.
744
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.
746
ventana emergente independiente. Esto es muy til cuando la informacin a ingresar es compleja, larga
o requiere validaciones.
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.
748
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.
749
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.
751
752
2. En la pestaa Bsico busque las propiedades Exportar a Excel y Exportar a PDF. Habilite la opcin
deseada.
Usted puede habilitar ambas.
753
754
755
756
757
Ancho de columnas
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.
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.
760
Propiedades
Las siguientes son propiedades exclusivas para el control tipo cuadro de texto:
Pestaa Bsico
PROPIEDAD
DESCRIPCIN
Es extendido
Longitud Mxima
Pestaa Avanzado
761
PROPIEDAD
DESCRIPCIN
Vuelva a escribir
Expresin Regular
Una expresin regular es un texto especial (con una sintaxis definida) utilizado
para identificar un patrn de caracteres o un caracter particular y validar el
contenido ingresado en un control de cuadro de texto. Esta funcionalidad no
pretende reemplazar el texto ingresado. Si el texto no cumple con la
expresin regular, el control se dejar en blanco.
Expresin: Define la expresin que valida el contenido ingresado en el
control de cuadro de texto.
Mensaje de Validacin: Define el mensaje de validacin que se mostrar
en caso de que el texto ingresado no cumpla con las condiciones de la
expresin.
Ejemplo
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
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.
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.
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".
765
Pestaa Avanzado
PROPIEDAD
DESCRIPCIN
Actualizar al Cambio
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.
766
2. En la forma inserte el atributo Aceptar Polticas. Bizagi interpretar este atributo como un control Si/
No en la forma.
767
768
Para cada control existen tres grupos de propiedades organizadas en pestaas: Bsico, Formato y
Avanzado.
PESTAA BSICO
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.
769
PESTAA FORMATO
Aplica a la mayora de los controles de la
forma y le permite personalizar la
apariencia del control en la forma.
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 Layout
771
PESTAA AVANZADO
Aplica a cada control individualmente y permitir la configuracin de comportamientos avanzados
para cada uno.
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
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
774
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.
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.
776
4. Cree una nueva condicin donde el Centro de costo a mostrar sea Administracin.
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
778
) en la pestaa Avanzado.
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.
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.
781
782
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.
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.
784
785
786
Ahora ingrese un valor mayor a diez veces el ingreso mensual del solicitante. Al intentar avanzar la
actividad, se mostrar el siguiente mensaje.
787
1. En el diseador de formas, vaya a las propiedades del control Fecha de Salida y abra la pestaa
Avanzado.
788
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;
790
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
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
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.
Las validaciones pueden evaluar contadores, que contarn el nmero de registros que cumplen con
una condicin en la tabla, o atributos directamente.
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:
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
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
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):
798
799
800
801
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.
).
803
804
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
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)
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.
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.
808
D clic sobre ella para ir a la Tienda de Widgets de Bizagi (se requiere conexin a Internet):
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.
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).
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.
812
813
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.
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:
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.
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.
818
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.
819
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.
820
821
Operador
Descripcin
Aplica a controles
cambia a
es diferente a
est vaco
Combo,
Combo
cascada, Lista, Radio,
Bsqueda,
Sugerencia, Moneda,
Nmero, Fecha
no est vaco
Combo,
Combo
cascada, Lista, Radio,
Bsqueda,
Sugerencia, Moneda,
Nmero, Fecha
cambia
822
Bsqueda,
Sugerencia, Moneda,
Nmero,
Fecha,
Archivo
no contiene
contiene
comienza con
no comienza con
es
un
correo Evala si el valor de un control es Cuadro de texto
electrnico invlido un correo electrnico invlido.
menor que
Moneda,
menor o igual
Moneda,
mayor que
Moneda,
Moneda,
ha eliminado
registro
clic
es verdadero
es falso
ha cargado
archivo
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.
824
Comportamiento
Cambia el color de un control.
Cambia el color de la fuente de un
control.
Muestra u oculta un control.
Cambiar
la
configuracin
editabilidad de un control.
de
Contraer
Contrae/Expande un grupo.
Ejecutar regla
825
Ejecutar interfaz
Limpiar datos para
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.
826
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.
827
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)
828
2. Incluya la condicin. D clic en Agregar una condicin y seleccione el control, operador y argumento
as:
Cundo Solicitar Vacaciones cambie a verdadero.
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.
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.
831
832
2. Incluya la condicin. D clic en Agregar una condicin y seleccione el control, operador y argumento
as:
Cundo Solicitar Vacaciones cambie a verdadero.
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.
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.
835
836
837
2. Cree una Accin utilizando unicamente el Panel como control. El Panel agrupa los controles que
contiene.
838
839
840
4. Agregue la accin alterna (Si no) para regresar el control a su estado original.
841
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:
842
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.
843
2. Incluya la condicin.
D clic en Agregar una condicin y seleccione el control, operador y argumento as:
Cundo Jefe est vaco.
844
4. Defina la accin alterna (Si no), que se ejecutar cuando no se cumpla la condicin.
Definir valor para Requiere aprobacin a verdadero.
845
846
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.
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.
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.
849
850
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.
851
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.
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.
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
855
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.
857
858
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.
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.
Colapsar un grupo
Usted puede manipular grupos utilizando acciones, para expandirlos o colapsarlos de acuerdo a
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.
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.
863
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.
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
866
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.
868
4. En el Portal de Trabajo llenar la tabla de Producto. hasta que el costo Total se vuelve rojo.
6. Observe cmo el costo Total se actualiza tan pronto como se elimina la fila.
869
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
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.
872
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 .
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).
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.
876
Observe de nuevo que estamos haciendo referencia a las columnas de la coleccin Productos.
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.
878
1. Cree la Accin.
En el diseador de Formas seleccione Acciones y Validaciones y agregue una nueva accin.
879
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.
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.
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.
883
884
Condiciones (Si)
D clic en Agregar una condicin. Se mostrar una nueva fila para ingresar la condicin.
885
Operador
Descripcin
Aplica a controles
cambia a
es diferente a
est vaco
Combo,
Combo
cascada, Lista, Radio,
Bsqueda,
Sugerencia, Moneda,
Nmero, Fecha
no est vaco
Combo,
Combo
cascada, Lista, Radio,
Bsqueda,
Sugerencia, Moneda,
Nmero, Fecha
cambia
886
Sugerencia, Moneda,
Nmero,
Fecha,
Archivo
no contiene
contiene
comienza con
no comienza con
es
un
correo Evala si el valor de un control es Cuadro de texto
electrnico invlido un correo electrnico invlido.
menor que
Moneda,
menor o igual
Moneda,
mayor que
Moneda,
Moneda,
ha eliminado
registro
clic
es verdadero
es falso
ha cargado
archivo
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.
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).
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.
889
890
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.
892
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.
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.
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.
895
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.
897
3. Dentro del bloque defina las dos condiciones relacionadas a la poltica para solicitantes jvenes:
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:
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.
900
10. En el cuadro Entonces defina una accin para asignar FALSO al control Crdito Aprobado.
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.
901
902
903
904
PROPIEDAD
DESCRIPCIN
Acciones
Visible
Define la visibilidad del botn. Esta tambin puede ser determinada por una
expresin.
Formato
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.
906
3. D clic en el icono de Eliminar (que aparecer en la esquina superior derecha del botn) para
eliminarlo.
Ejemplo
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.
908
4. Ahora defina la regla asociada a la ejecucin del botn, dando clic en el icono de expresin.
909
910
6. Repita los pasos 2-5 para crear un nuevo botn denominado Rechazar. En la expresin asigne el
valor FALSO al atributo.
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.
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.
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.
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.
915
916
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.
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.
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.
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.
921
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
923
son creadas directamente en el Proceso sino en la entidad que contiene su informacin, es decir, en la
entidad de contexto.
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.
925
4. Regrese a la forma de la actividad, arrastre y suelte la nueva forma para ser reutilizada.
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.
927
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.
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.
930
931
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.
932
2. Modifique cualquiera de las Formas de Mostrar, Adicin o Edicin dando clic sobre el botn
correspondiente de Edicin.
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
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.
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.
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.
937
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)
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).
940
941
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.
943
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.
945
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.
946
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.
948
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.
950
3. Una vez definidas, seleccione las consultas que se asociarn al Proceso y luego d clic en OK.
951
D clic en el botn Editar para abrir el Modelador de Formas y modificar los controles y propiedades
necesarias de la forma.
952
953
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.
2. Seleccione Interno en el Tipo de Campo dentro de las propiedades de Informacin Bsica del
cuadro de texto.
954
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.
Nombre de
campo Interno
Descripcin
Aplicacin
(Application)
Incluir el
resultado de
las consultas
956
Nombre de
campo Interno
Descripcin
Nmero de
Radicacin (Case
Rad Number)
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.
957
Nombre de
campo Interno
Descripcin
Incluir el
resultado de
las consultas
Cargo del
Creador (Creator
- Position)
Nombre de
campo Interno
Descripcin
Incluir el
resultado de
las consultas
Identificado del
Usuario
Encargado
(Current User)
958
Nombre de
campo Interno
Descripcin
Incluir el
resultado de
las consultas
Nombre de
usuario del
usuario
encargado
(Current User Username)
Cargo del
usuario
encargado
(Current User Position)
Actividad
realizada
(Previous Task)
NO
Identificador de
encargado
anterior
(Previous User)
NO
Nombre
completo de
encargado
anterior
NO
959
Nombre de
campo Interno
Descripcin
Incluir el
resultado de
las consultas
Nombre de
usuario de
encargado
anterior
(Previous User
Username)
Cargo de
encargado
anterior
(Previous User Position)
NO
NO
Proceso
(Process)
Fecha de
creacin de la
actividad (Task
Entry Date)
Fecha de
vencimiento de
la actividad
(Task Expiry
Date)
960
Nombre de
campo Interno
Descripcin
Incluir el
resultado de
las consultas
Estado de la
tarea (Task
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.
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.
962
963
D clic en el botn Editar para abrir el Modelador de Formas y modificar los controles y propiedades
necesarias de la forma.
964
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.
965
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.
966
4. En la nueva ventana, habilite la opcin Utilizar Forma Global y seleccione la forma creada
anteriormente en la lista desplegable.
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.
968
La Forma de Resumen tambin aparece cuando los usuarios avanzan un caso y no poseen ms
actividades pendientes en l.
969
3. En la nueva ventana, habilite la opcin Utilizar Forma de Resumen y seleccione la forma creada
anteriormente en la lista desplegable.
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.
971
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:
972
973
974
975
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.
976
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.
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:
978
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.
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.
980
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.
982
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).
984
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>
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.
<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
987
Descripcin
Ejemplo
Igual
<PurchaseRequest.Quotation[Selected = true]>
!=
No igual
<PurchaseRequest.Quotation[Selected != true]>
988
>
Mayor que
<PurchaseRequest.ProductsRequestedforPurchase[TotalPrice
1000]>
>
<
Menor que
<PurchaseRequest.ProductsRequestedforPurchase[UnitPrice
1000]>
<
>=
<=
AND
OR
Es verdadero
defecto)
!
Es falso
(por <PurchaseRequest.ProductsRequestedforPurchase[QuotationsRe
quested]>
<PurchaseRequest.ProductsRequestedforPurchase[
!QuotationsRequested]>
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:
+"]", value)
Me.setXPath
989
>
"+
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 +"]")
!=
true
OR
990
991
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
Funciones
Reglas de Librera
993
Vocabulario
Variables
Formato
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
994
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.
995
996
997
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
Avg
998
<count(XPath)>
Empty
Equals
Exist
Greater than
Is False
Is not Empty
Is not Null
Is Null
Is True
Less than
999
Max
Min
Not equals
Or
Sum
Funciones Avanzadas
FUNCIN
DESCRIPCIN
SINTAXIS
1000
coleccin
Asociar items a
una coleccin
item)
Me.attachCollectionItems("XPath",
items)
Desasociar item
de una coleccin
Desasociar items
de una coleccin
Desasociar todos
los items de una
coleccin
Eliminar un item
de una coleccin
Eliminar items de
una coleccin
Permite la
ms items
elementos
de la base
1001
coleccin
Distinct-values
Get
value
collection
as
<distinct-values(XPath)>
El XPath debe ser una coleccin
que navegue hasta un atributo
por el que se pueda hacer un
filtro de valores distintos.
CHelper.GetValueAsCollection(<X
Path>)
El XPath debe ser una coleccin
Sort
Add relation
DEPRECADO
Remove relation
DEPRECADO
Funciones matemticas
FUNCIN
Abs
DESCRIPCIN
SINTAXIS
1002
Average
Ceiling
Exp
Floor
IsNaN
Ln
Log10
Max
1003
real, flotante).
Los parmetros pueden ser Xpaths,
variables o nmeros y deben estar
contenidos entre braquets []
Min
Module
Percentage
Pow
Quotient
Rand(to,from
)
Rand()
Round
CHelper.Math.Module(Number,D
ivisor)
1004
Truncate
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-
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)>;
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")
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)>){
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 (').
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)>;
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.
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");
}
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>)
1011
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
<>
Diferente
>
>=
<
<=
BETWEEN
Entre
IN ()
En
AND
OR
1012
IS NULL
Igual a nulo
"CityName IS NULL"
IS NOT
NULL
Diferente de nulo
1013
var Entity =
CEntityManager.GetEntity("Entity").GetEntityList("Attribute","Filter","","");
for(var i=0; i< Entity.Length;i++)
{
//Obtenga el valor del atributo del registro
La siguiente imagen muestra la lista de exmenes mdicos que deben ser cargados dentro de la
coleccin.
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.
1015
{
//Agregue cada examen a la coleccin
Test =
Me.newCollectionItem("Request.Applicant.ApplicantTests");
Test.setXPath("MedicalTest",Test[Counter].SurrogateKeyValue);
}
}
La siguiente imagen muestra la lista de exmenes mdicos que deben ser cargados dentro de la
coleccin, aquellos marcados como requeridos.
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.
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);
}
}
1018
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.
1020
Puede buscar todas las palabras en la expresin que coinciden con la palabra ingresada dando clic en
Buscar todos.
1021
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.
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.
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.
1024
1025
1026
1027
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.
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.
1029
1030
Navegue el modelo de datos hasta que se alcance el atributo deseado, en este caso Total Cost
Estimate. D clic en Ok.
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.
1032
1033
1034
Una nueva ventana mostrar las entidades maestras y paramtricas del proyecto.
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. .
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.
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
Booleano
Despus, en el lado derecho del condicional, ingrese el valor contra el cual se va a hacer la
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.
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:
1039
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:
1041
1042
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.
1044
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
1045
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.
1046
1047
4. Finalmente utilice el resultado de la variable para asignar la edad del cliente en el modelo de datos.
1048
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.
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.
1050
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.
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.
1053
1054
D clic en Siguiente.
7. Seleccione el mtodo Web de los mtodos proporcionados por el servicio Web. D clic en
Siguiente.
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).
1056
1057
1058
1059
1060
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.
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.
1063
//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,"");
1064
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);
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.
1066
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.
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.
1068
1069
1070
1071
1072
1073
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.
1074
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.
1075
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.
1076
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.
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.
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
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.
1081
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.
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.
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.
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.
1085
1086
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.
1088
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
1089
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.
1090
1091
1092
1093
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.
1094
1095
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.
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.
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
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.
1100
1101
Script booleano
Introduccin
Las Expresiones booleanas son expresiones condicionales que retornan un valor booleano cuando se
1102
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
1104
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.
1106
1107
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.
1109
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.
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.
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.
1112
1113
4. Configure las condiciones requeridas. En este caso nuestra condicin se relaciona con el atributo de
pas destino..
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
1115
Seleccione Brasil o Estados Unidos y observe cmo el control queda disponible para edicin.
1116
1. En la forma, d clic sobre Declared Value. Sus propiedades se desplegarn en el Panel izquierdo.
1117
3. Seleccione la ltima opcin: Expresin. Para crear una nueva expresin, d clic en Nueva.
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.
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.
1120
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.
1121
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.
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.
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.
1124
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
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.
1126
1127
1128
//Evaluar si es aire
if (<Shipping.TransportationMean.Code>==AirCode)
{
//Evaluar origen destino
if (<Shipping.CountryFrom.Code>==BrazilCode &&
<Shipping.CountryTo.Code>==USACode)
{
//Return true
true;
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.
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
1131
Los estados posibles para las tareas son: En progreso, completa, cancelada o vencida.
1132
3. D clic en la celda Fecha lmite. Aparecer un nuevo men contextual en la parte izquierda de la
pantalla.
1133
6. Incluya las precondiciones relacionadas al valor del estado de la tarea que habilitarn la celda para
su edicin.
1134
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.
1136
6. Incluya las precondiciones relacionadas al valor del estado de la tarea, que habilitarn la
visualizacin de la celda.
1137
1138
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.
1139
1140
1141
1142
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.
1143
2. Seleccione el icono de expresin en el valor Mnimo del rango de fechas de la pestaa Avanzado.
1144
1145
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
Aire
70
Mar
94
Tierra
100
1147
1148
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.
1149
if (<Shipping.TransportationMean>==AirCode)
{
70;
}
if (<Shipping.TransportationMean>==MaritimeCode)
{
94;
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.
Consideraciones
No se soportan filtros dentro de filtros.
1151
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.
1152
1153
1154
4. Defina el texto para cada condicin. Observe que en este caso utilizamos sentencias AND para
enlazar las sub-condiciones de cada una.
1155
Filterstring;
D clic en OK para guardar los cambios.
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.
1157
1158
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.
1160
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.
1162
//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.
1163
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.
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.
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.
1166
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.
1167
1168
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
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.
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
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.
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>)
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.
1173
1174
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.
1176
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.
1178
1179
1180
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.
1182
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.
1183
1184
Una constante ha sido definida anteriormente para este caso (BookingDuration). Esta constante puede
ser modificada en el Portal de Trabajo en cualquier momento.
1185
1186
1187
3. Para definir la duracin de la tarea, utilice la funcin Fecha estimada de solucin del caso, en la
categora Fecha & Hora
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.
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:
1189
1190
1191
Asigne la fecha de hoy al atributo utilizando la funcin Today de la categora Fechas y tiempos.
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 =).
1193
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.
1194
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:
1196
Utilice como parmetro de entrada la fecha de regreso (ReturningDate) del modelo de datos.
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.
CHelper.IsWorkingDayForUser(idUser,dtDate)
Cree una expresin como una accin A la Salida de la actividad Registrar solicitud.
1198
1199
if (CHelper.IsWorkingDayForUser(Creator,<TravelRequest.LeavingDate>)
==false)
{
CHelper.ThrowValidationError("Depart day is non working.");
}
CHelper.IsWorkingMinute(Me,dtDate)
Cree una expresin como una accin a la salida de la tarea donde se programa la reunin.
1200
1201
2. Declare las variables fecha de inicio y fecha final dando clic en la opcin Variables y luego seleccione
la opcin Nuevo.
1202
llamado
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.
Luego de que la expresin ejecute el clculo, el valor podr observarse en el campo Number of
business days requested.
1204
2. Declare las variables StartDate y FinalDate, dando clic en la opcin Variables y luego seleccione la
opcin Nuevo.
1205
llamado
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;
1207
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.
1208
Seleccione la actividad donde se ejecutar esta accin y cree una expresin Al Guardar de la misma.
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.
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:
1210
1211
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).
1212
1. Defina una expresin en la actividad donde se quiere calcular la edad del empleado.
1213
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)
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:
1216
//Validacin de cumpleaos
if (BirthDate<TodayDate)
{
//Calculo de la edad
<VacationRequest.Employee.Age>=YearToday-YearBirth;
}
CHelper.Math.
Las funciones matemticas se encuentran dentro de la categora Matemticas del Editor de funciones.
1217
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.
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:
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.
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
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:
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:
1220
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:
1221
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:
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:
1223
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
1224
que una colonia necesita para lograr un crecimiento esperado se calcula mediante la siguiente
expresin:
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.
1225
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:
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
1226
Min
Esta funcin devuelve el valor mnimo entre dos nmeros.
CHelper.Math.Min([Number1,Number2])
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:
Module
Esta funcin devuelve el residuo de una divisin.
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.
Percentage
Esta funcin devuelve el equivalente en porcentaje de un nmero.
CHelper.Math.Percentage(Number)
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:
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.
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:
Quotient
Esta funcin devuelve la porcin entera de una divisin.
CHelper.Math.Quotient(Dividend,Divisor)
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:
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:
Rand()
Esta funcin devuelve un decimal aleatorio entre 0.0 a 1.0, y no tiene parmetros.
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:
1234
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:
1235
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 :
1236
1237
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.
1239
1240
2. Aplique el mtodo .ToUpper para concatenar la cadena de texto y asignar el resultado en el atributo
objetivo.
1241
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.
1242
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.
1243
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.
1244
1245
Los siguientes son los mtodos disponibles para el usuario actual asignado:
Propiedades
Descripcin
1246
AreaName
FullName
IsInPosition
IsInRole
IsInSkill
UserId
UserProperties
Ejemplo
El siguiente ejemplo ilustra cmo utilizar las funciones anteriores:
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.
1247
1248
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.
1249
1250
Me.Case
Este grupo de funciones se encuentran disponibles bajo la categora Informacin del caso actual.
1251
Propiedad
Descripcin
CaseId
CaseNumber
Creationdate
ParentProcessId
ProcessState
SolutionDate
getChildProcesses
getWorkItem()
1252
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
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.
1253
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.
1254
CHelper.setEvent(Me,Me.Case.ParentProcessId,"CloseSelection",null);
Finalmente guarde la expresin.
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.
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:
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.
1257
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.
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.
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.
1260
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.
1261
1262
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.
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.
1264
if(CHelper.thereAreOpenProcesses(Me.Case.Id)==true)
{
CHelper.ThrowValidationError("There are pending activities. You cannot
close the case");
}
Finalmente, guarde la expresin.
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.
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.
1266
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.
1267
Descripcin
Id
BossId
FullName
Location.Name
Positionsde
1268
Roles
Skills
UserName
getUserProperties()
Ejemplos
Los siguientes ejemplos ilustrarn cmo utilizar estas funciones::
Obtener el nombre completo de los asignados actuales
Obtener los roles de los asignados actuales
Obtener propiedades de usuario
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.
1269
Para cada asignado, cree un nuevo registro en la coleccin AssigneesList, utilizando la funcin
Me.newCollectionItem.
1270
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.
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.
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.
1273
1274
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.
1275
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:
Me.Task
Este grupo de funciones se encuentran disponibles bajo la categora Informacin de la tarea actual.
1277
Descripcin
Id
Name
DisplayName
EstimatedDuration
Ejemplo
El siguiente ejemplo ilustrar cmo utilizar estas funciones.
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.
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.
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.
1280
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.
1281
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.
1282
Me.Duration=CHelper.resolveVocabulary(Me,"SLA");
Finalmente, d clic en Ok para guardar los cambios.
1283
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)
1284
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.
1285
<StudentApplication.InternalIdentificationNumber>=CHelper.GetNextSeqValueSt
r("InternalIdentificationNumber");
Finalmente, d clic en Ok para guardar los cambios.
1286
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.
1287
El puntaje del riesgo ingresado por el analista est guardado en el atributo Riesgo.
La cantidad mxima ser asignada al atributo Cantidad Mxima.
1288
Usted puede ejecutar este ejemplo utilizando la funcin Over XPath. El ejemplo solo tiene como
propsito brindar un ejemplo.
1289
CHelper.GetValueAsCollection("Collection")
Los parmetros de la funcin son: el XPath de la coleccin obtenido, en este caso ser la coleccin
1290
Productos Solicitados.
Cree una expresin Al guardar de la tarea donde se va a realizar el clculo.
var Collection=<PurchaseRequest.Products>;
1291
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:
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).
1293
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.
1295
1296
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");
}
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)
1297
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.
1298
1. En el cuarto paso del asistente, seleccione Acciones de la Actividad. Luego d clic en la primera tarea
1299
1300
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
1301
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.
1302
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.
1303
1304
1305
4. Obtenga una lista de usuarios con el rol deseado utilizando la funcin Get users in Role de la
categora Usuarios.
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.
1307
1. En el cuarto paso del asistente, seleccione Acciones de la Actividad. Luego d clic en la primera tarea
1308
1309
4. Obtenga una lista de usuarios con la posicin deseada utilizando la funcin Get users in Skill de la
categora Usuarios.
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.
1311
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).
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.
1313
1314
1315
1316
1317
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
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.
1320
1321
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.
1322
1323
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"))
;
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.
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.
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.
1328
4. En un elemento de expresin obtenga los valores a comparar (ingreso mximo, ingreso mnimo e
1329
Valide si el ingreso del cliente es menor al ingreso mnimo. En este caso ser necesario mostrar un
mensaje de validacin.
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.
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.
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.
PARMETROS
DE ENTRADA
PARMETR
OS DE
SALIDA
DESCRIPCIN
entityToXml
CEntity entity
XmlDocume
nt
entityToXml
CEntity entity,
bool
bIncludeNull
XmlDocume
nt
entityToXml
CEntity entity,
string
sSchemaPath
XmlDocume
nt
1332
entityToStringXml
CEntity entity,
string
SchemaContent
String
entityToStringXmlwith
Path
CEntity entity,
string
sSchemaPath
String
getEntities
XmlDocument
xEntitiesInfo
XmlDocume
nt
getEntities
XmlDocument
xEntitiesInfo,
XmlDocument
xSchema
XmlDocume
nt
getEntitiesAsString
string
sXmlEntitiesInfo,
string
sXmlSchema
String
1333
string
sPathXMLEntities
, string
sPathXMLSchem
a
String
PARMETROS
DE ENTRADA
PARMETR
OS DE
SALIDA
DESCRIPCIN
entityToStringXmlWithS
copes
Me, string
sSchemaConte
nt, string
sXSLContent
String
1334
int idCase,
string xsd,
string xsl
String
entityToStringXmlWithS
copesXmlByidCase
int idCase,
XmlDocument
xsd,
XmlDocument
xsl
String
1335
PARMETROS
DE ENTRADA
PARMETR
OS DE
SALIDA
DESCRIPCIN
fromXmlToEntity
string sEntityInfo
CEntity
fromXmlToEntityAsXm
l
XmlDocument
xEntityInfo
CEntity
1336
MTODO
PARMETROS
DE ENTRADA
PARMETR
OS DE
SALIDA
DESCRIPCIN
fromXmlToEntityWithSc
opes
Me, string
sEntityInfo
CEntity
fromXmlToEntityWithSc
opesAsXml
Me,
XmlDocument
xml
CEntity
fromXmlToEntityWithSc
opes
Me, string
sEntityInfo,
bool
bIngnoreKeyOr
BizKeyXmlAttri
bs
CEntity
1337
Me,
XmlDocument
xml, bool
bIgnoreKeyOrB
izKeyXmlAttribs
CEntity
PARMETROS
DE ENTRADA
OUTPUT
PARAMETER
DESCRIPCIN
getEntitySchema
string
sEntityName
XmlDocume
nt
getEntitySchemaAsEnti
ty
CEntity entity
XmlDocume
nt
getEntitySchema
string
sEntityName,
string
sSchemaName
XmlDocume
nt
getEntitySchemaAsEnti
ty
CEntity entity,
string
sSchemaName
XmlDocume
nt
1338
string
sEntityName,
bool
bIncludeRelated
Entities, bool
bIncludeFacts
XmlDocume
nt
getEntitySchemaAsEnti
ty
CEntity entity,
bool
bIncludeRelated
Entities, bool
bIncludeFacts
XmlDocume
nt
transformXml
XmlDocument
xml,
XmlDocument
xsl
XmlDocume
nt
transformXmlAsString
String
transformXmlUsingPat
h
string sPathXml,
string sPathXsl
String
transformXmlUsingCo
ntent
string
sXmlContent,
string sPathXsl
String
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
1340
Me.newCollectionItem ("ProcessEntity.RelationshipToTheCollection")
Para manipular un nuevo registro (fila), este se debe asignar a una variable.
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
1341
1342
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.
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.
1344
1345
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.
1346
Ejemplo
Resultado
if(<count(ProjectAdministration.Activities[Completed =
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]
>);
1348
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.
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",
1350
Ejemplo
Resultado
Me.attachCollectionItems("School.Approvedstudents",
Me.getXPath("School.Students[Average >= "+ average
+"]"));
or
Me.attachCollectionItems("School.Approvedstudents",
<School.Students[Average >= 6]>);
if(<count(School.Students[Average > 6])>==1)
{
Me.attachCollectionItem("School.Approvedstudents",
<School.Students[Average > 6]> );
}
1351
1352
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.
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
1354
Example
Result
var average = 6;
Me.detachCollectionItems("School.Failedstudents",
Me.getXPath("School.Students[Average > "+ average
+"]"));
or
Me.detachCollectionItems("School.Failedstudents",
<School.Students[Average > 6]>);
Me.detachAllCollectionItems("School.Failedstudents");
Me.detachAllCollectionItems("School.Approvedstudents")
;
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.
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.
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.
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.
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.
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)
1361
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:
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.
1363
3. Ahora, para identificar al cliente como un ganador use la siguiente lnea. Esto asignar al atributo
Winner del ganador, el valor true.
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.
1365
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.
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):
1367
1368
1369
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
1370
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
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.
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:
1372
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.
1373
1374
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.
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:
1376
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).
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.
1379
1380
1381
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.
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.
1384
\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.
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
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.
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.
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.
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.
1390
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.
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.
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.
1393
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
1394
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):
1396
Crear Vocabularios
Vocabularios pueden ser creados de dos formas: desde el mdulo de Procesos o cuando se crea una
poltica.
1397
2. En cualquier tem de la poltica, podr acceder a los vocabularios desde el panel del lado izquierdo.
1398
3. D clic derecho en el tipo de definicin que desea crear y luego d clic en Nueva Definicin.
1399
1400
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
Booleano
Fecha
Tasas de inters
Decimal
Entero
Moneda
Texto
1402
1403
1404
1405
2. Seleccione el proceso donde la definicin fue creada y d doble clic sobre esta para modificarla.
1406
La ventana de edicin se desplegar de acuerdo al tipo de dato seleccionado despus de dar clic en
el nombre
.
1407
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.
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
2. La nueva ventana se despliega para seleccionar el XPath. D clic en Siguiente cuando se haya
seleccionado el atributo.
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.
1410
1411
2. La ventana para seleccionar el XPath del modelo de datos es mostrada. D clic en Siguiente cuando
el atributo haya sido seleccionado.
1412
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.
1413
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
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.
1415
Si selecciona la opcin Editar, se abrir el editor de definiciones. Siga los mismos pasos explicados
para crear una definicin.
1416
Si selecciona la opcin Eliminar, una ventana de confirmacin se mostrar. D clic en S para borrar.
1417
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.
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.
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.
1421
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.
1422
1423
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.
1425
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.
1427
1428
1429
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.
1430
La nueva definicin XPath ha sido creada y usted puede arrastrarla desde el men. Arrstrelo a la
primera condicin del Si.
1431
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.
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.
1433
D clic en Finalizar.
6. Defina un nombre, nombre visual y descripcin para la nueva poltica
1434
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.
1435
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.
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.
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.
1439
Si desea definir un operador "Entre" deber definir la misma columna dos veces e introduzca los
operadores necesarios para cada valor.
1440
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
SI
SI
NO
NO
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.
3. Se abrir una ventana donde el usuario puede crear y editar las tablas de decisin.
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.
1443
6. Cuando termine d clic en Finalizar. Se le pedir que incluya nombre, nombre visual y descripcin
para su tabla.
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
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.
1445
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.
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.
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.
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:
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
SI
SI
NO
NO
> 3000
SI/NO
SI
1451
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.
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.
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.
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.
1456
8. Repita los pasos anteriores para todas las Reglas de poltica. En este ejemplo tenemos dos reglas
ms:
1457
1458
.
Una vez que todos los elementos han sido creados, el rbol completo aparecer como a continuacin:
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.
1460
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.
1461
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.
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.
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.
1465
1466
En la siguiente imagen podemos ver a la poltica Valid Approval en el proceso de solicitud de compra:
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.
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.
1469
Sin embargo, si vamos al proceso de Pago de Factura, la Poltica Suggested Number of Quotes no
estar disponible para su reutilizacin.
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.
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.
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.
1472
1473
1474
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\
1475
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";
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.
1478
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.
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.
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.
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.
1482
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.
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.
1485
1486
1487
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.
1489
1490
1491
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:
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
1494
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
Habilitada
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
Agregue o cree las Reglas de xito y fallo, para crear una Regla de Negocio, dirjase a Definicin de
1496
Reglas de Negocio.
Haga clic en Aceptar para guardar los cambios.
Propiedad
Descripcin
Nombre
Fecha de
inicio
Recurrente
Ocurre cada
1497
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
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
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
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
1500
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.
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.
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
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.
1503
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)
1504
1505
1506
1507
1508
1509
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
1510
1511
1512
1513
Utilice los parntesis de diamante "<>" para incluir la informacin almacenada en el modelo de
datos. Por ejemplo, el nombre del solicitante.
1514
Utilice la propiedad <Case Link> para incluir un enlace al caso en el cuerpo del mensaje.
1515
Enve el tiquete electrnico como un archivo adjunto. Seleccione el atributo donde se almacena el
tiquete electrnico utilizando el mtodo de parntesis.
1516
4. D clic en Guardar.
As se vera el correo recibido:
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:
1517
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
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.
1519
1520
1521
1522
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.
1523
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.
1525
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.
1526
5. D clic en Guardar.
IMPORTANTE:
Cuando cree la forma de la tabla dinmica, el campo Es Reusable debe estar habilitado para poder
seleccionarla.
1527
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.
1529
2. Seleccione el destinatario.
D clic en Para e incluya la direccin de correo electrnico. En este caso, seleccione el correo del
cliente.
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.
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.
1532
7. D clic en Guardar.
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: '>'.
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.
1535
1536
Repita este procedimiento para cada direccin, separadas por punto y coma.
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.
1538
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.
1540
Haga clic en Adicionar condicin de filtro para agregar una nueva condicin.
1541
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.
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.
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.
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.
1545
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
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.
1548
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.
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.
1550
1551
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.
1553
1554
D clic en Guardar.
As se vern sus correos:
1555
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
1556
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).
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
Cuenta STMP
Enviar copia a:
Especifique una direccin de correo para enviar copia de cada una de las
notificaciones enviadas.
Especifique una direccin de correo para enviar copia oculta de cada una de
1558
a:
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.
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.
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.
1560
1561
1562
Revise los componentes marcados, y d clic en Instalar para adicionar estas caractersticas.
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.
Introduccin
Bizagi ofrece la posibilidad de utilizar un servidor de correo electrnico para enviar notificaciones
1564
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.
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.
1566
1567
1568
1569
Para el campo Nombre, escriba el nombre DNS del dominio al que desea volver a enviar notificaciones
de correo electrnico.
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.
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.
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.
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)
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]
[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
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.
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:
1576
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.
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]
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.
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].
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.
1581
4. Guarde su plantilla.
Una vez que haya definido el formato y cuerpo del libro, gurdelo como un libro estndar de Excel
.xlsx.
1582
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:
1584
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.
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]
1586
1587
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.
1588
1589
1590
1591
1592
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.
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.
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.
1596
Si la propiedad Reemplazar los documentos existentes est deshabilitada y el usuario final hace clic
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.
1598
1599
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
1601
1602
Una vez generado, haga clic en el enlace del documento para abrirlo.
1603
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.
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.
1606
Si la propiedad Reemplazar los documentos existentes est deshabilitada y el usuario final hace clic
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.
1608
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.
1610
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.
1612
1613
Una vez generado, haga clic en el enlace del documento para abrirlo.
1614
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.
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.
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.
1617
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.
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.
1619
1620
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
1622
Si usted selecciona Igual a la plantilla se mostrar un nuevo campo para ingresar la extensin
deseada.
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.
1624
1625
1626
1627
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.
1628
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.
1629
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.
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.
1631
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.
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.
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.
1634
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.
1636
1637
Haga clic en el botn Generar documento. La siguiente imagen muestra el documento generado para
persona jurdica.
1638
Tenga en cuenta que los documentos se generan con base a las plantillas definidas para cada tipo de
cliente.
1639
1640
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.
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.
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.
1644
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.
1646
2. Mapee la funcin hacia el Tag de la plantilla donde se deba guardar la informacin del caso.
1647
3. Restaure la ventana a su tamao original haciendo clic en el icono en la esquina superior derecha y
haga clic en Finalizar.
1648
2. Desde la nueva tabla mapee el atributo deseado hacia el Tag de la plantilla relacionado.
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.
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.
1651
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.
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.
1654
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.
1655
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.
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:
1658
1659
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.
1660
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.
1661
1662
5. Mapee los datos normalmente. Tenga en cuenta que el mapeo se hace desde el contexto de la
coleccin.
1663
Desde el Portal de Trabajo ejecute la accin. Se generar automticamente una plantilla de documento
para cada registro de la tabla.
1664
Integracin ECM
Introduccin
Bizagi soporta nativamente la integracin con sistemas ECM.
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.
1666
Si usted utiliza Bizagi JEE edition, tenga en cuenta que SharePoint no se soporta en la integracin
ECM.
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.
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
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).
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:
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:
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.
Ubique las opcione avanzadas (Advanced Settings ) en la categora de configuracin general (General
Settings):
1670
1671
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).
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):
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.
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:
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:
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.
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.
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.
1678
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.
1680
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.
1682
Asigne un nombre a su carpeta y d clic en el botn a la derecha para seleccionar la carpeta del ECM.
1683
1684
1685
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:
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.
1688
1689
En nuestro ejemplo, nuestra forma editada incluir ahora el atributo Client document, el cual se
configura automticamente con el control correspondiente en Bizagi:
1690
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.
1692
1693
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:
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.
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.
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.
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.
1698
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>);
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
}
}
1700
1701
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.
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.
1703
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).
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.
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.
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).
1706
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.
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:
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.
1708
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.
1709
Para esta configuracin, vaya al sexto paso del Asistente de Procesos y d clic en la opcin Definir
Interfaces.
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.
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.
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.
1712
D clic en Siguiente.
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.
Cuando se mapean los parmetros de entrada a un servicio Web, usted cuenta con la posibilidad de
1714
incluir archivos de transformacin personalizados (XSLTs). Para hacerlo, d clic sobre el cono de
Mapeo avanzado:
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.
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:
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
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.
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.
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:
1720
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.
1721
1722
1723
1724
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.
1726
Ambos mtodos de del servicio son consumidos del WSDL publicado, manejado por el ESB de IBM
WebSphere:
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.
1728
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).
1729
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:
1731
1732
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:
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.
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
1735
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).
1737
1738
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).
1740
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:
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.
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):
1743
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:
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).
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.
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,
1746
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/.
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:
1748
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).
1749
En esta vista, demos clic en la Tarea de Servicio Consultar posicin de geocdigo para crear la
invocacin de la interfaz.
1750
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, "{", "}".
1751
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.
1752
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:
1753
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.
1754
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:
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:
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:
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
1759
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.
1760
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.
1761
1762
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.
1763
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.
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.
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).
1766
D clic derecho sobre el nodo raz para mostrar una lista de caractersticas asociadas.
1767
1768
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:
1770
Cualquier estructura definida previamente se eliminar cuando se importa una nueva definicin de
estructura.
1771
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:
1773
Exportar a XSD
Esta opcin guardar la estructura XML actual como un archivo .XSD:
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.
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.
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:
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
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.
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).
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".
1781
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
1782
Usted puede arrastrar el tringulo de conexin saliente de la caja Constante y soltarlo en el atributo
deseado.
Instancia Vaca
1783
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).
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.
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
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.
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.
1788
Cuando cambie esta configuracin y d clic en OK. Usted notar que la etiqueta mostrar
automticamente la nueva configuracin.
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).
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.
1791
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
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.
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).
1793
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).
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
1795
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"><![CDATA[</xsl:text>
<xsl:text disable-output-escaping="yes">]]></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.
1796
Para adjuntar la transformacin, use el cono ubicado en la parte baja del panel intermedio, y crguela
desde un archivo:
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:
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
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.
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.
1799
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).
1801
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).
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.
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.
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).
1805
1806
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
1808
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).
1809
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
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.
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.
Ejemplo
Ilustraremos esto a travs de un Proceso de Solicitud de Crdito.
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.
1812
1813
Para la edicin Enteprise .Net construimos el proyecto de librera de clase como un montaje dll.
1814
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.
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.
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.
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:
1818
Ejecucin
Para ver este ejemplo funcionando, ejecutaremos nuestro Proceso en el Portal de Trabajo de Bizagi,
dando clic en la opcin Ejecutar Proceso:
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:
1820
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.
Ejemplo
Ilustraremos esto a travs de un Proceso de Solicitud de Crdito.
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.
1822
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.
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:
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:
1826
1827
Ejecucin
Para ver este ejemplo funcionando, ejecutaremos nuestro Proceso en el Portal de Trabajo de Bizagi,
dando clic en la opcin Ejecutar Proceso:
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:
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:
1830
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.
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.
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
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\
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
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).
1834
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.
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).
1836
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).
Introduccin
Cada proyecto en Bizagi posee servicios web SOAP construidos para exponer la funcionalidad de los
1837
1838
http://localhost:8080/Bizagi-war/WebServices/EntityManagerSOA?wsdl
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>
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.
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
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
1840
Bizagi JEE ).
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.
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.
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.
1843
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.
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).
1846
1847
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.
1848
Ejemplo:
http://localhost:8080/Bizagi-war/WebServices/EntityManagerSOA?wsdl
1849
1850
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>
1851
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>
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"/>
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.
1854
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).
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"/>
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
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>
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
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" />
1860
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:
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>
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) .
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>
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" />
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" />
1866
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.
1868
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.
1869
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>
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).
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>
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"
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"/>
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.
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.
1877
1878
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"
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:
1880
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"?>
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.
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"/>
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
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"/>
1885
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.
1887
Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi
pra el caso identificado como 9001:
1888
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
1890
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">
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.
1892
Ntese que la categora llamada Travel es la nica que figura dentro de la aplicacin Travel.
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:
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"
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;
1895
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).
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
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
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"/>
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.
1900
1901
Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi;
1902
getEventsAsString
Introduccin
Este mtodo se se utiliza para obtener un listado de los Eventos disponibles en Bizagi (desde una
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
1904
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"
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.
1906
Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi.
1907
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):
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>
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"/>
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;
1911
Ntese que dentro de la categora de Travel (Viajes), tenemos 2 Procesos: Travel Request (Solicitud de
Viaje) y Expenses report (Reporte de gastos).
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).
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).
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>
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;
1915
Ntese que para la categora Travel (Viajes), encontramos 2 Procesos diferentes: Travel request
(Solicitud de viaje) y Expenses report (Reporte de gastos).
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
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>
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.
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
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>
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>
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.
1922
Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi:
1923
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">
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.
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
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"/>
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"/>
1929
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.
1930
1931
Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi;
1932
1933
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>
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.
1935
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).
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"/>
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>
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"/>
1939
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.
1941
Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi;
1942
1943
1944
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,
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).
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
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;
getCaseDataUsingXPathsAsString
Introduccin
Este mtodo se utiliza para obtener tanto informacin de negocio, como detalle general (por ejemplo,
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>
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:
1949
1950
Descripcin
Formato XML
<
Operador menor-que
<
>
Operador mayor-que
>
"
Comilla doble
"
'
'
&
Ampersand
&
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">
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>
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:
getEntitiesAsString
Introduccin
Este mtodo se utiliza para consultar los registros en una Entidad del modelo de datos de Bizagi
1953
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>
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
<=
>=
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"?>
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
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.
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.
1957
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.
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
<=
>=
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>
1959
</EntityData>
</BizAgiWSParam>
En el segundo parmetro se envia:
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.
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.
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.
1961
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).
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:
1962
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
1963
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
1964
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):
1965
Para ms informacin sobre el uso de llaves de negocio, consulte Usando llaves de negocio en XMLs.
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).
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):
1967
1968
Para informacin puntual sobre cada mtodo, consulte los sub artculos.
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).
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).
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:
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:
1972
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.
1973
Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD:
1974
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;
1976
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).
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).
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
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.
1980
Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD:
1981
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:
1983
1984
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:
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.
1987
1988
1989
Ejemplo
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocacin de este mtodo en Bizagi:
1990
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:
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.
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
1993
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.
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.
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
1997
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.
1998
1999
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.
2001
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.
2002
2003
2004
Ejemplo
Para ver un ejemplo de respuesta, consulte el XML en este enlace.
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.
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.
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.
Ejemplo
Por ejemplo, si un cliente fuera buscado nicamente por su IdNumber , se utilizara el siguiente XML:
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.
2007
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.
2008
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
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.
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.
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.
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.
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.
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.
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.
2016
2017
Haga clic en Agregar condicin para incluir una condicin donde seleccionaremos las propiedades que
el usuario debe cumplir para ser asignado.
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.
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.
2019
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.
2020
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.
2021
Las actividades han sido configuradas. Tenga en cuenta que ninguna tiene el signo de exclamacin.
2022
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.
2023
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.
2025
Dependiendo de la prioridad, la tarea Assist Report ser realizada por un miembro de un grupo
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.
2027
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.
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.
2030
La asignacin de esta tarea se basa en el rol del participante. Seleccione Rol de la lista de propiedades
de usuario.
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.
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.
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.
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).
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.
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).
.
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.
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.
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.
2039
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.
2040
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
2042
Una vez damos clic sobre l, se abrir una nueva ventana que permitir buscar al usuario a asignar,
entre todos los usuarios de Bizagi.
2043
2044
2045
2046
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.
2048
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).
2049
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.
2050
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.
2051
Para mayor informacin acerca de cmo crear usuarios en Bizagi y cmo asignar componentes de
organizacin a usaurios, consulte Administracin de Usuarios.
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.
2052
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.
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.
2054
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.
2056
5.Escriba el nombre, nombre de mostrar, descripcin y costo del nuevo cargo. En este ejemplo
escribimos Agente de Ventas.
D clic en OK.
2057
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.
2058
2059
3. Se abrir una nueva ventana. Llene los campos requeridos. El nombre del lugar ser Nueva York.
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.
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.
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.
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.
2064
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.
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.
2067
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.
2069
2070
2071
Para eliminar un registro, seleccinelo y d clic en Eliminar, luego d clic en Si para confirmar.
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.
2073
2074
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.
2075
2076
2077
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).
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.
2080
3. Esta propiedad de usuario ser visible, editable y requerida por lo que activamos estas opciones.
D clic en Finalizar.
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.
2082
6. Esta propiedad de usuario ser visible, editable y requerida por lo que activamos estas opciones.
D clic en Finalizar.
2083
La dos propiedades que acabamos de crear se muestran bajo el nodo de Propiedades de Usuario.
2084
Si usted accede al Portal de Trabajo y va al men de Administracin de Usuarios ver las nuevas
propiedades disponibles para cada usuario.
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
+ rea: Presidencia
D clic aqui para ms informacin acerca de cmo conceder permisos a Grupos de usuarios.
2086
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.
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]
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]
2089
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.
2090
2091
Cuando una organizacin requiere de un esquema de tiempo personalizado, puede crear uno nuevo o
editar los existentes.
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
2093
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.
2095
2096
2097
2098
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.
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.
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.
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:
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.
2103
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.
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.
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.
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.
2108
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.
2109
Bizagi ofrece el mdulo de seguridad que le permite definir un esquema de permisos en algunos de
los elementos.
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.
2110
La siguiente lista describe los recursos y las acciones relativas a cada uno de ellos.
Crear
Modificar
Control total
n/a
n/a
Aplicaciones
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
2111
Recurso
Crear
Modificar
Control total
Nodo principal de
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.
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.
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.
2113
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.
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
2115
2. Una nueva ventana aparecer donde usted debe agregar un usuario o un grupo y seleccionar los
permisos o restricciones deseadas.
2116
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
2117
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.
2118
IMPORTANTE: Los usuarios que se Excluyan sern considerados como no pertenecientes al grupo.
2119
2120
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).
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.
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
2123
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
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
Habilitar bloqueo de
cuentas
Forzar cambio de
contrasea
Validar historial de
contrasea
Registrar eventos de
autenticacin
Numero mximo de
intentos de ingreso
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
La clave necesita
contener letras
La clave necesita
contener nmeros
Mensaje de correo de
2125
recordatorio de clave
recordatorio.
Asunto de recordatorio
de clave
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.
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
Mensaje de correo de
recordatorio de clave
Asunto de correo de
recordatorio de clave
Validar secuencia de
contrasear
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
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) .
2127
2128
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).
2129
Cierre el cuadro de dilogo. De vuelta a la zona de intranet local, haga clic en Nivel personalizado :
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/.
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
2131
se almacenan en Bizagi).
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).
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.
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
2133
contrasea).
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.
2134
Configuracin
Conexin
Descripcin
LDAP URL
Dominio\usuario
Clave
Hora de sincronizacin
Configuraci FIltro
n de
importacin
Dominio
Identificador de cuenta
de usuario
2135
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:
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:
2138
Al sincronizar sus usuarios, Bizagi slo importar como "Activo", el nmero de usuarios soportados
por su licencia activa.
2139
Ejemplo
cn
company
description
displayName
dc
DN - also
distinguishedName
givenName
name (nombre)
objectCategory
objectClass
ou
physicalDeliveryOffice
Name
sAMAccountName
2140
Atributo LDAP
Ejemplo
NT 4.0, debe ser nico en el dominio. Puede confundirse con CN.
SN
st
street
telephone number
userAccountControl
userPrincipalName
Descripcin
homeMDB
legacyExchangeDN
mailNickname
mDBUseDefaults
msExchHomeServerNa
me
proxyAddresses
2141
Atributo de
Intercambio
Descripcin
targetAddress
showInAddressBook
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
2142
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.
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.
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.
2145
2146
2147
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
2148
Entidades
Administracin
Creacin de Casos
Pginas
2149
Consultas
Vocabularios
2150
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.
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.
2152
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.
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.
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.
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.
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).
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.
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.
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.
2161
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
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.
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.
2165
El procedimiento que acabamos de describir es similar para todos loe elementos en este Mdulo.
2166
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.
2167
Caso Privado
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.
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
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.
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.
2172
2173
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.
2174
Similarmente el usuario jefe (Boss), a quien se concedieron permisos previamente como es supervisor
del credor del caso, tambin tendr acceso.
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.
2176
2177
Con esta informacin los usuarios privilegiados del Subproceso podrn tener acceso a toda su
informacin y a la informacin del caso padre.
2178
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.
2180
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.
2182
2183
dominios deben ser conocidos de antemano y deben ser enviados desde un sistema externo.
CHelper.GrantCaseAccess (int
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:
CHelper.RevokeCaseAccess (int
2184
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.
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.
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.
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.
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.
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
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.
2190
4. Asegrese de marcar especficamente la casilla Incluir para especificar que este usuario tendr
privilegios de administrador.
2191
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:
2192
2193
Tambin puede escoger aadir un grupo al grupo de Administradores, siguiendo los mismos pasos
anteriores pero usando el botn Aadir Grupo.
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).
2194
PROPIEDAD DE
CONFIGURACIN
DESCRIPCIN
Hashing algorithm
Encryption algorithm
2195
KeyFiles/KeyFile.txt)
Una URL HTTP o HTTPS (p.ej., https://[HTTP_Server]/SslText/
KeyFile.txt)
Set Authentication Properties
Usuario
Password
Domain
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.)
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".
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.
2199
4. Marque la opcin Cifrado, Esto ocultar los campos Valor por Defecto y Localizable si
corresponde.
2200
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:
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.
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
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 .
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.
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.
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.
2207
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.
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).
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.
2210
Una nueva ventana mostrar el diagrama de proceso. Seleccione un elemento para traducir sus
propiedades principales.
2211
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.
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.
2213
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.
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.
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.
2216
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.
2218
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:
2220
2221
2222
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.
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).
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).
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.
La configuracin que se muestra en este ejemplo implica dos pasos del Asistente para la virtualizacin
y las opciones avanzadas de virtualizacin.
2226
Seleccione virtualizacin para iniciar el asistente que permitir configurar fcilmente la informacin
relacionada a nuestra conexin al CRM:
2227
Incluya la informacin para nombrar y definir nuestro CRM como un "sistema externo" (external
system) en el proyecto Bizagi:
2228
2229
Bizagi presentar las tablas y vistas disponibles del CRM para su virtualizacin.
Seleccione (marque) las entidades a virtualizar y d clic en Siguiente.
2230
En el siguiente paso no se define un filtro, ya que no se necesita en nuestro ejemplo. Haga clic en
Siguiente.
2231
2232
2233
2234
Asegrese que haya incluido un atributo de tipo referencia en la entidad de proceso (llamada "Product
Request"), a la entidad Custom
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.
2236
De esta forma, un cliente tendr una o ms cuentas (registros en Customer_Accou). Para esta
definicin, incluiremos un atributo de tipo coleccin:
2237
2238
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.
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.
2241
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):
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.
2244
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:
2246
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
2247
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:
2248
Esto significa que en Bizagi, necesitaremos asegurar que para esa entidad, la llave de negocio
(businessKey) incluya estos 2 atributos:
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
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.
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.
2252
Cuando se agrega un atributo, usted encontrar la lista de columnas estndar tales como nmero de
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.
2254
Adicionalmente usted puede cambiar el orden en el que se muestran las columnas, utilizando los
iconos Arriba
o Abajo
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.
2256
En la nueva ventana deshabilite la opcin Utilizar configuracin por defecto y luego d clic en Agregar
atributo.
2257
2258
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.
2260
Agregue los atributos deseados desde el modelo de datos de la aplicacin y d clic en Ok.
2261
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.
2263
2264
Agregue los atributos deseados desde el modelo de datos del proceso y d clic en Ok.
2265
Temas de integracin
Consulte las secciones a continuacin para ver algunos ejemplos acerca de cmo integrar Bizagi con
otros sistemas.
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.
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
2267
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:
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
2269
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.
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):
2271
2272
La estructura del listado de vuelos (FLIGHT_LIST structure) que retorna SAP es:
2273
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.
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.
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:
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:
2277
En el ltimo paso, damos clic en Finalizar. (No necesitamos definir manejo de error en esta
invocacin).
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:
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:
2280
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:
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.
Ejemplo
El proceso en Bizagi que crea el proveedor en SAP, se describe a continuacin:
2282
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.
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.
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.
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.
2286
En el ltimo paso, hacemos clic en finalizar (el manejo de error lo toma Bizagi).
2287
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.
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.
2290
En el ltimo paso, hacemos clic en finalizar (el manejo de error lo toma Bizagi).
2291
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
2292
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
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).
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:
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:
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.
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.
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:
2298
2299
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.
Creamos una nueva librera de componentes y definimos informacin como por ejemplo, cmo se
2301
denomina.
2302
Asegrese de ingresar el namespace correspondiente para la librera, tal cual como se defini en el
cdigo en .Net:
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:
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:
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):
2306
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:
2307
2308
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.
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.
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.
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.
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.
2313
Verificacin en el Portal
2314
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.
2315
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.
2316
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>
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.
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.
2320
2321
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.
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.
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.
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.
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:
2324
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.
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.
2327
1. Cree un nuevo proyecto en Visual Studio y seleccione ASP. NET Web Application para este tipo de
proyecto.
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.
2329
Note
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:
2331
2332
2333
Finalmente, monte estos archivos en su servidor IIS como una aplicacin para que pueda ser accesada
2334
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.
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:
2336
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:
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.
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:
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)
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).
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();
2342
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:
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,
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).
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).
2347
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:
2349
2350
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.
2352
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,
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.
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.
2354
2. Ubique la Base de datos y d clic derecho sobre sta. Seleccione la opcin Backup... desde las
tareas:
2355
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.
2357
2358
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
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).
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:
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:
2362
Seguidamente, navegue hacie la ruta del cliente de Oracle, y dentro de la carpeta bin:
2363
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.
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
2364
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.
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:
2365
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.
2366
2. Ubique la Base de datos y d clic derecho sobre sta. Seleccione la opcin de Restaurar -> Base de
datos:
2367
2368
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:
2370
5. Vaya al tab de Opciones, y marque la opcin de Sobrescritura (Overwrite the existing database).
2371
Asegrese de seleccionar el destino de los archivos usados por la Base de datos (.dat y .log).
2372
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.
2374
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).
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%:%
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.
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:
2378
Luego de tener a la mano el nombre del directorio que va a utilizar, desconctese de la sesin
BizagiAdmon en la instancia.
2379
Seguidamente, navegue hacia la ruta del cliente de Oracle, y dentro de la carpeta bin:
2380
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.
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.
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
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:
2383
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.
Procedimiento
Como ejemplo, usaremos el proceso creado en Mi Primer proceso, para mostrar cmo cambiar la
ubicacin de un proyecto.
2384
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
2386
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'
);
2388
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');
2389
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):
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.
2391
2392
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:
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.
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
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.
2398
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.
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.
2400
determinar si necesita nodos adicionales para el clster BPM) usando nuestro Estimador de
dimensionamiento Bizagi.
HARDWARE
SOFTWARE
RAM
16 GB
Disco duro
Procesador
De 64 bits.
4 cores
3GHz o superior
Recomendaciones
adicionales
Motor de base de
datos
SERVIDOR BPM
2 nodos para el servidor BPM (clster de balanceo de cargas). Cada nodo con lo siguiente:
HARDWARE
RAM
16 GB
Disco duro
Procesador
De 64 bits.
4 cores
3GHz o superior
Recomendaciones
adicionales
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
2401
SERVIDOR BPM
Componentes
adicionales
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
Dispositivos
Navegador
SOFTWARE
Componentes
adicionales
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).
Los requerimientos para esta opcin donde se considera un servidor Apache HTTP incluyen:
SERVIDOR PROXY
Disco duro
HARDWARE
SOFTWARE
1 GB
Recomendaciones
adicionales
2403
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.
2404
HARDWARE
RAM
16 GB
Disco duro
Procesador
Recomendaciones
adicionales
SOFTWARE
Motor de base de
datos
SERVIDOR BPM
HARDWARE
RAM
16 GB
Disco duro
Procesador
Recomendaciones
adicionales
SOFTWARE
Sistema operativo
Windows
Windows
Windows
Windows
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
USUARIOS FINALES
HARDWARE
PARA EQUIPOS
HARDWARE
PARA MVILES
Resolucin de
pantalla
Dispositivos
Navegador
SOFTWARE
Componentes
adicionales
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).
2406
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
2407
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.
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.
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.
16 GB
Disco duro
HARDWARE
2409
SOFTWARE
Procesador
De 64 bits.
4 cores
3GHz o superior
Recomendaciones
adicionales
Motor de base de
datos
SERVIDOR BPM
2 nodos para el servidor BPM (clster de balanceo de cargas). Cada nodo con lo siguiente:
HARDWARE
RAM
24 GB
Disco duro
Procesador
De 64 bits.
4 cores
3GHz o superior
Recomendaciones
adicionales
Sistema operativo
Plataforma servidor de
aplicacin
SOFTWARE
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
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
Dispositivos
Navegador
SOFTWARE
Componentes
adicionales
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).
Los requerimientos para esta opcin donde se considera un servidor Apache HTTP incluyen:
SERVIDOR PROXY
Disco duro
HARDWARE
1 GB
Recomendaciones
adicionales
2412
SERVIDOR PROXY
SOFTWARE
Funcionalidad de proxy
inverso
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.
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.
HARDWARE
RAM
16 GB
Disco duro
Procesador
Recomendaciones
adicionales
SOFTWARE
Motor de base de
datos
SERVIDOR BPM
RAM
24 GB
Disco duro
HARDWARE
Procesador
De 64 bits.
4 cores
3GHz o superior
2414
SERVIDOR BPM
Recomendaciones
adicionales
Sistema operativo
Plataforma servidor de
aplicacin
SOFTWARE
Componentes
adicionales
USUARIOS FINALES
HARDWARE
PARA EQUIPOS
HARDWARE
PARA MVILES
SOFTWARE
Resolucin de
pantalla
Dispositivos
Navegador
2415
USUARIOS FINALES
Componentes
adicionales
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).
2416
Los requerimientos para esta opcin donde se considera un servidor Apache HTTP incluyen:
SERVIDOR PROXY
HARDWARE
SOFTWARE
Disco duro
1 GB
Recomendaciones
adicionales
Funcionalidad de proxy
inverso
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.
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.
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.
2418
2419
2420
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.
2422
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.
2424
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.
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.
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.
2427
2428
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.
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.
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.
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
2433
la seguridad de este men para garantizar que slo los usuarios adecuados tengan acceso a ella.
OPCIN
SUB-OPTION
BAM
Procesos
Tareas
Anlisis
DESCRIPCIN
Monitor de
recursos
Procesos
Tareas
Sensores
Sensores
Mis Reportes
Mis Reportes
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.
2434
OPCIN
DESCRIPCIN
Licencias
Entidades
Casos
Alarmas
Cifrado de clave
Consola de actividades
asncronas
Solicitudes pendientes
de usuarios
Bsqueda en el
registro de
autenticacin
Polticas del negocio
Perfiles
Administrar asignacin
de usuario
predeterminado
Dimensiones
Preferencias
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
OPCIN
DESCRIPCIN
Acerca de
Acerca de
Tamao de letra
OPCIN
DESCRIPCIN
Tamao
OPCIN
DESCRIPCIN
Buscar
Buscar
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.
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.
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.
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.
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.
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
Estado de la
Actividad
Esta informacin puede ser personalizada de acuerdo a sus necesidades. Para mayor informacin
consulte personalizar y parametrizar columnas.
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.
Usted puede marcar un caso como Favorito dando clic en la estrella en la primera columna del caso
en cuestin.
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.
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.
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.
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.
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.
2447
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).
2448
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.
2449
Asignados
En esta pestaa puede ver los usuarios asignados a las diferentes actividades del caso.
Eventos
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.
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.
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.
2453
2454
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
Consulta grfica
La consulta grfica muestra de forma grfica la trayectoria que el caso se ha seguido, los usuarios
implicados y su estado.
2455
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.
2456
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.
2458
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.
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.
2461
En este reporte, la informacin tambin se pueden filtrar por entidad o atributo, incluyendo el atributo
o el nombre de usuario completa o parcialmente.
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.
2463
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.
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.
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.
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).
2467
Si todos los usuarios asignados pertenecen al mismo dominio, entonces el campo Dominio se
ocultar.
2468
2469
2470
La visualizacin de estas opciones depende del tipo de Autenticacin y las opciones de Autenticacin.
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.
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.
2472
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.
2473
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
2474
OPCIN
DESCRIPCIN
referirse a Administracin de Usuarios.
Entidades
Constructor de Temas
Bsqueda en el
registro de
autenticacin
Cifrado de clave
Solicitudes pendientes
de usuarios
Casos
Consola de actividades
asncronas
Administrar asignacin
de usuario
predeterminado
Perfiles
Alarmas
Licencias
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.
2476
2477
Si se encuentran registros que cumplan con los criterios se mostrar una lista con todos los casos,
tal como se muestra a continuacin:
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.
2479
2480
Si se encuentran registros que cumplan con los criterios se mostrar una lista con todos los casos,
tal como se muestra a continuacin:
2481
5. Se muestra una nueva ventana de bsqueda para encontrar el nuevo encargado de la actividad.
Ingrese la informacin y d clic en Buscar.
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.
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.
2484
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.
2486
2487
2488
3. Cuando haya terminado de introducir la informacin, haga clic en Agregar para guardar la
informacin del nuevo usuario.
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.
2490
4. La ventana de Administracin de usuarios se mostrar para hacer los cambios necesarios. Cuando
haya terminado, haga clic en Actualizar para guardarlos.
2491
2492
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.
2493
3. Una nueva ventana mostrar todos los usuarios del perfil seleccionado.
Seleccione Borrar o Nuevo usuario, dependiendo de la accin requerida.
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.
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.
2496
2497
2498
2499
2500
2501
2502
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.
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.
2. Busque el usuario para el cual se definir un usuario delegado. Ingrese los criterios necesarios y
luego d clic en Buscar.
2504
2505
5. D clic en Obtener Usuario para buscar el usuario delegado. Ingrese los criterios necesarios y d
clic en Buscar.
2506
2507
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.
2509
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.
2510
2511
3. Una ventana mostrar la informacin detallada de la entidad. Para editar (o ver) un registro
existente, haga clic en Ver.
2512
2513
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.
2514
3. Una nueva ventana se mostrar de acuerdo con el tem de la Poltica seleccionada, con el fin de
permitir los cambios necesarios.
2515
Todo el vocabulario creado estar disponible en la pestaa de Componentes, para modificar las
condiciones y acciones.
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.
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.
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:
2519
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.
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.
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.
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.
2522
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",
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
2525
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.
2526
2527
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.
2529
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.
2531
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.
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.
2533
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.
2535
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.
2537
Para copiar dimensiones a la lista de dimensiones seleccionadas, arrstrelas desde el cuadro izquierdo
y sultelas en el cuadro derecho.
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:
2539
Men de Grfico
Este men se divide en tres secciones. Cada seccin le permitir configurar y visualizar diferentes
caractersticas del Anlisis Grfico:
2540
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
2541
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.
2542
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.
2543
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.
2544
2. Se abrir una nueva ventana. En esta usted encontrar todos los posibles valores para la dimensin.
2545
3. Agregue los valores que se mostrar seleccionndolos y dando clic en el botn ">".
2546
Men de configuracin
Este men brinda funciones para guardar el anlisis, exportarlo a Excel as como mostrar los
resultados en tablas o grficos.
2547
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.
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 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.
2549
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.
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.
2551
2552
Esto actualizar la apariencia de todos los usuarios del final del Portal de Trabajo.
2553
2. Se abrir una paleta de colores. Busque y seleccione el color que desee haciendo clic en l, o
introduciendo el cdigo de color.
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.
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.
2556
Esto actualizar la apariencia de todos los usuarios del final del Portal de Trabajo.
2557
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
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
2559
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.
2560
2561
Las personas con acceso a la Forma Resumen podrn ver los comentarios y tambin incluir
comentarios propios:
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.
2563
2564
2565
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.
2567
2568
Las categoras pueden ser editadas por cualquier usuario con acceso a los comentarios. Es
recomendable estandarizar sus categoras y evitar su modificacin.
2569
2570
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.
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.
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.
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
2575
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.
2576
2577
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:
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.
2579
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:
2580
Telfono Android
2581
iPad:
2582
Tableta Android:
2583
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.
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.
2585
La opcin Historial de Login, muestra una lista, en la parte izquierda de la ventana, con todos los
inicios de sesin de cada usuario.
2586
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.
2588
2589
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.
2590
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.
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.
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:
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:
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.
2594
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).
2596
2597
2598
de
Bizagi.SharePoint.WebpartsConfig como
de
2599
2600
2601
2602
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.
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.
2603
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).
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).
2606
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:
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.
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.
2610
Haga clic en Guardar (Save) para finalizar con la configuracin central de las Web parts.
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:
2612
2613
2614
2615
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.
2616
Con este enfoque, puede por ejemplo complementar la integracin apoyndose en un enlace HTML a
esta pgina desde su pgina inicial (home):
2617
Para mayor informacin y ejemplo sobre esta primera opcin, consulte El portal de trabajo como Web
part.
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).
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.
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:
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:
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
DESCRIPCIN
Seleccione
de
desplegable, el
la
tem
lista
que
2623
Bizagi)
Defina
cuntos
casos
pendientes(paginados)
desea
que
aparezcan
para
los
usuarios en el Inbox.
Default view
(Vista por defecto)
2624
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:
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.
2627
2628
Ntese que en la imagen ejemplo de arriba, el inbox se presenta mostrando 5 casos (paginados).
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.
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).
2630
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).
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).
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).
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).
2633
Incluir las Web parts se realiza dando clic en las secciones demarcadas con Add Web part, y
2634
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):
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)
Work portal,
Case summary,
Start process
list,
Start process
button.
Cases by
page
(casos por
pgina)
Default view
(Vista por
defecto)
Show view
toggler
(Mostrar el
switch para
2636
cambio de
vista)
Appearance,
Layout and
Advanced
(Apariencia,
layout y
avanzados)
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:
2637
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.
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.
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\
2639
2640
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.
2642
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
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).
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.
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.
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
264 px
400 px
264 px
40 px
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,
2646
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.
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:
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
2648
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>
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
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.
2651
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.
2652
2653
WEB PART
ANCHO MNIMO
ALTO MNIMO
Work portal
970 px
400 px
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.
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.
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.
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.
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.
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.
2659
Si ninguna actividad ha sido seleccionada, el informe mostrar todas las tareas abiertas del proceso
con sus asignados.
2660
Puede filtrar el informe por cualquier Dimensin para mostrar la informacin de los usuarios que
cumplen con los criterios definidos.
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.
2662
2663
2. Haga clic en Vista para ver el estado del caso dentro del proceso y de su trayectoria.
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.
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.
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.
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
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.
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).
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.
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:
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.
2673
Tendencia de duraciones: Este grfico muestra el tiempo de duracin promedio del cronmetro, en
el rango de tiempo seleccionado.
2674
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.
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.
2676
Diagrama de conteos: Este histograma muestra el recuento total de todos los contadores del
proceso seleccionado.
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.
2678
2679
2680
4. Haga clic en Nuevo Cronmetro o Nuevo Contador, de acuerdo con el sensor que desee crear.
2681
6. Escriba un Nombre, Nombre visual y una descripcin para el sensor. Tambin incluya el SLA para
Cronmetros. Haga clic en Aplicar.
2682
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.
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.
2684
2685
Si va a eliminar un informe, confirme esta accin haciendo clic en Eliminar, en la ventana emergente de
confirmacin.
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.
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.
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.
2689
3. Elija el XPath para identificar los valores para filtro. Cuando termine, haga clic en Aceptar.
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.
2691
3. Elija el XPath para identificar de donde se tomar el filtro. Cuando termine, haga clic en Aceptar.
2692
Slo los usuarios que tengan los permisos necesarios pueden crear, editar y borrar Dimensiones en
el Portal de Trabajo.
Puede seleccionar tantas dimensiones como se desee. Un rbol se mostrar con las dimensiones
organizadas jerrquicamente para seleccionar las que necesite.
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.
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.
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
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.
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.
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.
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.
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.
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.
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.
2700
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.
2701
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.
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.
2704
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.
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.
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.
2707
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.
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.
2709
Activacin de licencia
2710
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.
2711
La primera vez que introduzca la clave no habr informacin y ver un mensaje: "Servidor licenciado
para propsitos de desarrollo y pruebas solamente".
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.
2713
2714
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.
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.
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.
2716
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.
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.
2717
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.
2718
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".
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.
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.
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.
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.
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
Ingreso al sitio
Para ingresar dirjase al sitio oficial de Bizagi (www.bizagi.com). Encontrar una pantalla similar a la
siguiente:
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
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.
2725
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
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.
2728
Recomendaciones:
2729
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:
2730
Filtro de Estado. Permite filtrar los casos de acuerdo a su estado. Estas son las opciones:
o
o
o
o
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.
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.
2732
2733
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:
2735
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.
2736
2737
2738
Una vez se verifique la clave, podr cambiar su contrasea actual por una nueva.
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
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
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
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
2744
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.
2746
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
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
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
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
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
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
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
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
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
2757