Introducción
El siguiente ejemplo utiliza la funcionalidad de Librería de Componentes para registrar un componente personalizado que utiliza una API externa.
Para más información sobre esta opción en Bizagi, consulte Componentes personalizados.
¿Qué se necesita en Bizagi?
Para utilizar la funcionalidad de Librería de Componentes, siga estos pasos:
1.Construya su componente (una salida compilada).
2.Registre el componente en Bizagi.
3.Cree la regla de negocio que invoca el componente.
Compatibilidad con el framework
Al desarrollar un componente, usted debe asegurarse de que esté compilado y funcione con el framework compatible con Bizagi.
En las versiones 11.x de Bizagi, el framework utilizado es .NET Framework versión 4.8.
Si usted está trabajando con versiones superiores de .NET, una alternativa para garantizar la compatibilidad es utilizar .NET Standard versión 2.0.
Ejemplo
Este ejemplo utiliza un Proceso de Solicitud de Crédito.
En este ejemplo simplificado, la tarea Verificar Lista Negra valida que el solicitante no esté reportado en una lista negra central.
En esta tarea de servicio, cree una regla de negocio que acceda al componente personalizado para utilizar la API externa. A través de esta API, la regla invoca un método que devuelve si el id del solicitante está incluido en la lista negra (verdadero o falso).
Los siguientes pasos ilustran cómo utilizar la funcionalidad de Librería de Componentes.
Construir el componente (una salida compilada)
Desarrolle el componente como un proyecto de librería de clases.
El componente de ejemplo, MyCreditBureauComponent, utiliza CreditBureau.dll, que representa una API de ejemplo.
Incluya la referencia en el componente.
Compile el proyecto de librería de clases como un ensamblado .dll
El nombre del espacio del componente es MyCreditBureauComponent, y su clase pública se llama “Class1”. Este ejemplo utiliza el método IsCustomerInBlackList.
Registrar el componente en Bizagi
Después de compilar el ensamblado del componente en el paso anterior, utilice el archivo de salida MyCreditBureauComponent.dll para registrar el componente en la Librería de Componentes de Bizagi.
En Bizagi Studio, vaya a Herramientas y agregue un nuevo componente:
Busque MyCreditBureauComponent.dll y haga clic en Abrir para cargar el ensamblado:
Una vez ha añadido el componente, asígnele un nombre y una descripción.
Como este componente referencia y utiliza otra librería de clases (la API), registre e incluya también esta API en la librería de componentes.
Repita los pasos para añadir un componente, esta vez para el ensamblado CreditBureau.dll
Al finalizar estos pasos, los dos ensamblados deben aparecer como dos componentes separados:
Crear la regla de negocio que invoca el componente
Después de registrar el componente en la librería de componentes, cree una regla de negocio que invoque el método del componente.
|
Para simplificar, el siguiente ejemplo muestra cómo invocar este componente directamente desde una regla de negocio.
Sin embargo, para mejorar la mantenibilidad de su solución, cree una regla global (una regla de librería) que reciba parámetros de entrada, invoque el componente y devuelva parámetros de salida. De esta manera, las reglas de negocio llaman a esta regla global y usted mantiene en Bizagi un único punto acoplado al componente.
Los miembros de su equipo que trabajen en el mismo proyecto solo necesitan saber qué regla global utilizar.
Para mayor información sobre reglas globales, consulte la Reutilización de reglas de negocio. |
Vaya a la vista de Acciones de la Actividad en el Asistente de Procesos, y seleccione la tarea de servicio Verificar Lista Negra. Añada una regla de negocio en este punto del Proceso::
En la expresión, invoque el método de MyCreditBureauComponent con la siguiente sintaxis:
Class.Method
La clase no está definida como una clase estática, por lo que debe crear una instancia antes de invocar sus métodos. En este ejemplo, la expresión completa invoca el método IsCustomerInBlackList mediante las siguientes acciones: por:
•Enviar el id del Solicitante.
•Almacenar el resultado del método en el atributo de tipo booleano CreditRequest.InBlackList
Este es el contenido de la expresión:
var temp = new Class1();
Me.setXPath("CreditRequest.InBlackList",temp.IsCustomerInBlackList(Me.getXPath("CreditRequest.ApplicantId")));
El componente personalizado está listo para utilizarse mediante la funcionalidad de Librería de Componentes en Bizagi.
Ejecución
Para ver este ejemplo en funcionamiento, ejecute el Proceso en el Portal de Trabajo de Bizagi haciendo clic en el botón Portal de Trabajo:
Después de la tarea de servicio Verificar Lista Negra, la siguiente Actividad muestra el resultado de la invocación del método del componente:
Last Updated 21/10/2026 12:44:13 p. m.