Ver código fuente

<keywords content="keywords">agregar, expresion, if, while, for, funcion, servicio web, expresion booleana, iteracion sobre fact, iteracion sobre xpath</keywords>&nbsp;<br>
<div class="Section1">
== Agregando Módulos en Reglas  ==

Los módulos son opciones que le permiten establecer comportamientos específicos, características y condiciones para una regla de negocio. Para agregar módulos, haga clic derecho sobre la línea vertical correspondiente para desplegar una lista con las siguientes opciones: 

<br>[[Image:Bulletazul.gif]] [[Agregando Modulos en Reglas#expresion|Adicionar Expresión (Add Expression)]] 

[[Image:Bulletazul.gif]] [[If y Modulos de Funcion|Adicionar If (Add If)]] 

[[Image:Bulletazul.gif]] [[Modulos: For While y Servicio Web#while|Adicionar While (Add While)]] 

[[Image:Bulletazul.gif]] [[Modulos: For While y Servicio Web#for|Adicionar For (Addd For)]] 

[[Image:Bulletazul.gif]] [[If y Modulos de Funcion#funcion|Adicionar Función (Add Function)]] 

[[Image:Bulletazul.gif]] [[Modulos: For While y Servicio Web#Servicio_Web|Adicionar Servicio Web (Add Web Service)]] 

[[Image:Bulletazul.gif]]&nbsp;[[Adicionar_Asignacion|Adicionar Asignación]]

[[Image:Bulletazul.gif]] [[Agregando Modulos en Reglas#expresion_booleana|Adicionar Expresión Booleana (Boolean Expression)]] 

[[Image:Bulletazul.gif]] [[Iterar sobre Fact o XPath#iterar_sobre_relacion|Adicionar Iteración sobre una Relación (Add Iteration Over Fact)]] 

[[Image:Bulletazul.gif]] [[Iterar sobre Fact o XPath#iterar_sobre_xpath|Adicionar Iteración sobre un Xpath (Add Iteration Over Xpath)]] 

<br>

Cuando se trabaja con los módulos, el código asociado con la lógica expresada en el diseño es creado automáticamente en la vista Código (Code View). 

<br>

[[Image:Adding Modules Image 1.jpg|center]]<br>
<div class="Section2">
<span id="expresion_booleana"></span>

== Expresión Booleana (Boolean Expression)  ==

Este módulo permite al usuario incluir expresiones Booleanas o condicionales. Recuerde que las condiciones son satisfechas o no satisfechas si ellas pueden resultar en una respuesta verdadera (true) o una falsa (false) cuando son evaluadas. 

<br>

Haga clic derecho sobre el diagrama para desplegar la lista de opciones descritas abajo asociadas con este módulo: 

<br>

[[Image:Bulletrojo.gif]] <u>Editar Descripción (Edit Description)</u>: Hace cambios al nombre dado al diagrama. 

[[Image:Bulletrojo.gif]] <u>Propiedades (Properties)</u>: Permite al usuario definir la condición. La ventana Expresión de Entidad (Entity Expression) aparece para que el usuario agregue la condición. Expresiones complejas pueden ser incluidas. 

[[Image:Bulletrojo.gif]] <u>Remover (Remove)</u>: Esta opción permite al usuario eliminar el módulo completo. 

<br>

[[Image:Adding Modules Image 4.png|center]] 

=== ¿Cómo Agregar una Expresión Booleana?  ===

1.<span>&nbsp;&nbsp;&nbsp;&nbsp; Haga clic derecho sobre la línea vertical de la regla y seleccione la opción </span>'''Adicionar Expresión Booleana (Add Boolean Expression)'''; una ventana Condición-Descripción (Condition-Description) aparecerá para que el usuario nombre la Expresión Booleana. 

[[Image:Adding Modules Image 2.jpg|center]] 

<br>

[[Image:Adding Modules Image 3.jpg|center]] 

<br>

2.<span>&nbsp;&nbsp;&nbsp;&nbsp; </span>Haga clic derecho sobre la Expresión Booleana y seleccione la opción '''Propiedades (Properties)''' para establecer sus características. La ventana Expresión de Entidad (Entity Expression) luego aparecerá. 

[[Image:Adding Modules Image 4.png|center]] 

<br><span id="expresion_de_entidad"></span>

3.<span>&nbsp;&nbsp;&nbsp;&nbsp; Las condiciones de la Expresión Booleana son definidas en la ventana </span>Expresión de Entidad (Entity Expression). 

<br>

a.<span>&nbsp;&nbsp;&nbsp;&nbsp; </span>En el primer campo, seleccione el objeto a ser evaluado. El combo ofrece las siguientes opciones: 

[[Image:Adding Modules Image 5.jpg|center]] 

<br>

[[Image:Bulletazul.gif]] Lista de atributos de la [[Contexto|<u>Entidad de Contexto</u>]]: permite al usuario seleccionar cualquiera de los atributos en la Entidad de Contexto.&nbsp;En este ejemplo, estas son los cuatro primeros atributos mostrados en la imagen de arriba. 

<br><span id="seleccionar_item"></span>
[[Image:Bulletazul.gif]] Seleccionar Atributo (Select Attribute): permite al usuario seleccionar un atributo relacionado al a Entidad de Contexto. Si el usuario selecciona esta opción, la ventana '''Seleccionar Item (Select Item) '''aparecerá con un árbol para que se seleccione un ítem. 

&nbsp; 

[[Image:Adding Modules Image 6.jpg|center]]&nbsp; 

[[Image:Bulletazul.gif]] Escribir Expresión (Write Expression): permite al usuario ingresar una expresión directamente usando navegación por [[Usando XPath|XPath]]. Si el usuario elige esta opción, un cuadro de texto aparecerá a la derecha del combo para el que el usuario escriba la expresión. 

&nbsp; 

[[Image:Business Rules6 Image007.jpg|center|Image:Business_Rules6_Image007.jpg]] 

&nbsp; 

[[Image:Bulletazul.gif]] Seleccionar un Vocabulario (Select from vocabulary): permite al usuario seleccionar las definiciones "Get" del vocabulario usado en las políticas. Si el usuario selecciona esta opción, la ventana para seleccionar ítem aparecerá presentando todas las definiciones GET del proceso seleccionado. 

&nbsp; 

[[Image:Business Rules6 Image008.jpg|center|Image:Business_Rules6_Image008.jpg]] 

<br>

<span style="display: none">b.<span>&nbsp;&nbsp;&nbsp;&nbsp; </span></span>Si el usuario elige un atributo en el paso previo, otro combo aparecerá presentando varias opciones dependiendo del tipo de atributo seleccionado, incluyendo: 

<br>

<br>
<div align="center">
{| class="wikiTables FCK__ShowTableBorders" border="0" cellspacing="0" cellpadding="0" width="60%"
|-
| width="181" | 
'''<span>Atributos/Definiciones</span>'''

| width="280" | 
'''<span>Operadores</span>'''

|- class="rowcolorgray"
| valign="top" width="181" | 
<span>Numerical (Numérico)</span>

| valign="top" width="280" | 
<span>Igual, Diferente, Menor que, Menor o igual a, Mayor que, Mayor o igual a, Vacío, Lleno.</span>

|-
| valign="top" width="181" | 
<span>Text (Texto)</span>

| valign="top" width="280" | 
<span>Igual, Diferente, Vacío, Lleno, Contiene, No Contiene, Empieza con, No Empieza con.</span>

|- class="rowcolorgray"
| valign="top" width="181" | 
<span>Boolean (Booleano)</span>

| valign="top" width="280" | 
<span>Vacío, Lleno, Igual a Sí, Igual a No.</span>

|}
</div><br>
&nbsp; 

[[Image:Business Rules6 Image009.jpg|center|Image:Business_Rules6_Image009.jpg]] 

&nbsp; 

c.<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Si la selección del usuario requiere la inclusión de otro argumento, otro combo aparecerá ofreciendo las siguientes opciones: 

<br>

[[Image:Bulletazul.gif]]&nbsp;&nbsp; <u>Ingrese Número (Enter Number)</u>: Permite al usuario ingresar un número constante, únicamente disponible para atributos numéricos. 

&nbsp;&nbsp;&nbsp; <u>Ingrese Texto (Enter Text)</u>: Permite al usuario escribir en un texto, únicamente disponible para atributos de tipo String (cadena). 

&nbsp;&nbsp;&nbsp; <u>Ingrese Fecha (Enter Date or Date and Time)</u>: Permite al usuario ingresar una fecha constante, o fecha y hora, únicamente disponible para atributo de tipo fecha. 

<br>

[[Image:Bulletazul.gif]] <u>Seleccionar Campo (Select Field)</u>: Cuando el usuario elige esta opción, la ventana Seleccionar Item aparecerá, en donde el usuario puede seleccionar los atributos del modelo de datos. 

&nbsp; <u>Lista de Variables (List of Variables)</u>: Permite al usuario seleccionar cualquiera de las variables declaradas en el módulo inicio (Start). 

&nbsp; 

[[Image:Bulletazul.gif]] <u>Seleccionar Valor de Entidad (Select Entity Value)</u>: Permite al usuario seleccionar el valor del atributo evaluado cuando esta reaccionando con una entidad de parametrización. 

[[Image:Bulletazul.gif]] <u>Seleccionar Definición (Select Definition)</u>: Permite al usuario seleccionar las definiciones "Get" del vocabulario usado en las políticas. Si el usuario selecciona esta opción, la ventana Select Item aparecerá presentando todas las definiciones GET del proceso seleccionado. 

<br>

4.<span>&nbsp;&nbsp; </span>Si el usuario necesita agregar otra condición, el botón '''Y (And)''' permite al usuario incluirla por medio del operador lógico '''Y (And)''' u '''O (Or)'''. En el caso que las condiciones tengan que ser agrupadas con paréntesis, haga clic sobre el botón '''Vincular (Link)''', el cual anidará la condición con la que lo precede. Para borrar condiciones, haga clic sobre el botón '''Borrar (Delete)''' para eliminarlas una a la vez. 

<span lang="ES-CO">[[Image:Adding Modules Image 7.png|center]]&nbsp;</span><span style="color: rgb(255,0,0)"><span lang="ES-CO"> </span></span>
<div align="center">
{| class="MsoNormalTable" border="1" cellspacing="0" cellpadding="0" width="405"
|-
| valign="top" width="100%" | 
'''<span>Ejemplo</span>'''<span>: Un análisis de Préstamo es requerido para el proceso Solicitud de Préstamo cuando la cantidad solicitada por el cliente es mayor a 1000 o que la cantidad solicitada sea mayor al valor pre-aprobado.</span>

|}
</div>
<br>

[[Image:Business Rules6 Image010.jpg|center|Image:Business_Rules6_Image010.jpg]] 

&nbsp; 
<div align="center">
{| class="MsoNormalTable" border="1" cellspacing="0" cellpadding="0" width="405"
|-
| valign="top" width="100%" | 
<span>El valor Máximo esta en el Vocabulario, ya que este debe ser administrable.</span>

|}
</div>
&nbsp; 

[[Image:Adding Modules Image 9.png|center]]&nbsp; 

[[Image:Business Rules6 Image013.jpg|center|Image:Business_Rules6_Image013.jpg]] 

&nbsp;<br>
<div class="Section3">
<br><span id="expresion"></span>

== Expression (Expresión)<br> ==

Este módulo ofrece la posibilidad para agregar código directamente. 

Al final de cada sentencia en la regla <span style="color: rgb(255,0,0)">SIEMPRE SE DEBE FINALIZAR CON UN PUNTO Y COMA </span>'''<span style="color: rgb(255,0,0)">(&nbsp;; )</span>'''<br>

Haga clic derecho sobre el diagrama para ver las opciones asociadas al módulo, descritas en detalle a continuación. 

[[Image:Bulletrojo.gif]] <u>Editar Descripción (Edit Description)</u>: Hace cambios al nombre dado al diagrama. 

[[Image:Bulletrojo.gif]] <u>Propiedades (Properties)</u>: Esta opción despliega una ventana para que usted escriba el código directamente. 

[[Image:Bulletrojo.gif]] <u>Remover (Remove)</u>: Esta opción permite al usuario eliminar el módulo completo. 

[[Image:Adding Modules Image 10.png|center]]<br>

=== ¿Cómo Agregar una Expresión?<br> ===

1.<span>&nbsp; Haga clic derecho sobre la línea vertical de la regla y seleccione la opción </span>'''Adiconar Expresión (Add Expression)'''; la ventana '''Expresión - Descripción (Expression-Description)''' aparecerá para que el usuario nombre la Expresión. 

[[Image:Adding Modules Image 11.png|center]] 

<br>

[[Image:Adding Modules Image 12.jpg|center]] 

<br><span id="editar_expresion"></span>
2.<span>&nbsp;&nbsp;&nbsp;&nbsp; </span>Haga clic derecho sobre el módulo Expression y seleccione la opción '''Propiedades (Properties)''' para establecer sus características. La ventana Expresión (Expression) emergerá. 

&nbsp; [[Image:Adding Modules Image 13.png|center]] 

<br>

[[Image:Business Rules6 Image015.jpg|center|Image:Business_Rules6_Image015.jpg]]<br>

El código debe ser escrito directamente en esta ventana. 

&nbsp; 

[[Image:Bulletazul.gif]] Para hacer uso de los atributos del modelo entidad relación, Bizagi usa "intellisense" para que sin mayor esfuerzo se construyan las reglas. Para ingresar al atributo deseado, escriba el símbolo "&lt;". Una lista luego aparecerá con todos los atributos de la Entidad de Contexto donde el usuario seleccionará una. En el caso en que el atributo que busca el usuario sea otra entidad relacionada a esta, el usuario debe seleccionar el atributo relacionado a la otra entidad (también llamado como Llave Foránea). El usuario debe escribir el Símbolo "." y una lista aparecerá para que el usuario seleccione el atributo deseado de la entidad relacionada. Este procedimiento puede ser repetido una y otra vez. Finalmente, cuando el usuario encuentra el nombre del atributo que esta buscando, escriba el símbolo "&gt;". 
<div align="center">
{| class="MsoNormalTable" border="1" cellspacing="0" cellpadding="0" width="405"
|-
| valign="top" width="100%" | 
'''<span>Ejemplo</span>'''<span>: Las siguientes figuras indican cómo obtener el nombre de un atributo específico. El atributo '''Approved''' fue encontrado en la entidad relacionada '''Request''' usando '''idRequest'''.</span>

|}
</div>
&nbsp; 

[[Image:Adding Modules Image 14.png|center]]<br>

[[Image:Adding Modules Image 15.png|center]]<br>

El usuario puede también usar expresiones Xpath, atributos de actividad o proceso y variables en las expresiones. 

Para usar una variable que ha sido declarada en el módulo de Inicio (Start), haga clic sobre el botón Opciones (Options) y seleccione la variable. 

<span style="color: rgb(255,0,0)">[[Image:Adding Modules Image 16.png|center]] </span>

<br>

Los operadores que pueden ser usados en el módulo Expressions son: 

<br>
<div align="center">
{| class="wikiTables FCK__ShowTableBorders" border="0" cellspacing="0" cellpadding="0" width="60%"
|-
| width="71" | 
'''<span>Atributos</span>'''

| 
'''<span>Operador</span>'''

| width="251" | 
'''<span>Fórmula</span>'''

|- class="rowcolorgray"
| width="71" | 
<span>=</span>

| 
<span>Asignación</span>

| width="251" | 
<span>&lt;idRequest.idClient.idCity&gt; = 1</span>

|-
| width="71" | 
<span>+</span>

| 
<span>Adición</span>

| width="251" | 
<span>nDays = &lt;idRequirement.DaysTask&gt; + 1;</span>

|- class="rowcolorgray"
| width="71" | 
<span>*</span>

| 
<span>Multiplicación</span>

| width="251" | 
<span>&lt;idRequest.Interest&gt; = &lt;idRequest.Interes&gt; * 3;</span>

|-
| width="71" | 
<span>-</span>

| 
<span>Sustracción</span>

| width="251" | 
<span>nDays = &lt;idRequirement.DaysTask&gt; - 1;</span>

|- class="rowcolorgray"
| width="71" | 
<span>/</span>

| 
<span>Dividido por</span>

| width="251" | 
<span>nDays = &lt;idRequirementDaysTask&gt; /3&nbsp;;</span>

|-
| width="71" | 
<span>==</span>

| 
<span>Igual a&nbsp;</span>

| width="251" | 
<span>&lt;idRequest.idClient.idCity&gt; == 1</span>

|- class="rowcolorgray"
| width="71" | 
<span>!=</span>

| 
<span>No es igual a</span>

| width="251" | 
<span>&lt;idRequest.idClient.idCity&gt;&nbsp;!= 1</span>

|-
| width="71" | 
<span>&gt;&nbsp;</span>

| 
<span>Mayor que &nbsp;&nbsp;</span>

| width="251" | 
<span>&lt;idRequirement.DaysTask&gt; &gt; 3</span>

|- class="rowcolorgray"
| width="71" | 
<span>&lt;&nbsp;</span>

| 
<span>Menor que</span>

| width="251" | 
<span>&lt;idRequirement.DaysTask&gt; &lt; 3</span>

|-
| width="71" | 
<span>&gt;=</span>

| 
<span>Mayor o igual a</span>

| width="251" | 
<span>&lt;idRequirement.DaysTask&gt; &gt;= 3</span>

|- class="rowcolorgray"
| width="71" | 
<span>&lt;=</span>

| 
<span>Menor o igual a</span>

| width="251" | 
<span>&lt;idRequirement.DaysTask&gt; &lt;= 3</span>

|-
| width="71" | 
<span>&amp;&amp;</span>

| 
<span>AND</span>

| width="251" | 
<span>&lt;idRequirement.idConcept&gt; == 1 &amp;&amp;</span> 

<span>&lt;idRequirement.DaysTask&gt; &gt; 3</span>

|- class="rowcolorgray"
| width="71" | 
<span>&#124;&#124;</span>

| 
<span>OR</span>

| width="251" | 
<span>&lt;idRequirement.DaysTask&gt; &gt;= 3 &nbsp;&#124;&#124; &nbsp;&lt;idRequirement.idConcept&gt;&nbsp;!= 1</span>

|}

<br>
</div></div><div align="center">
{| style="width: 435px; height: 96px" class="MsoNormalTableNota" border="1" cellspacing="0" cellpadding="0"
|-
| valign="top" width="100%" | 
'''<span>Nota:</span>'''<span> Los nombre de los atributos de entidades deben estar escritos empezando desde el Contexto de Entidad. Esto es, el atributo debería pertenecer a una entidad que está de alguna manera relacionado a la Entidad de Contexto.</span>

|}
</div>
<span lang="ES-CO">&nbsp;</span> 
<div align="center">
{| class="MsoNormalTable" border="1" cellspacing="0" cellpadding="0" width="405"
|-
| valign="top" width="100%" | 
'''<span>Ejemplo</span>'''<span>: Durante el proceso de Solicitud de Préstamo, el ingreso del Cliente y la información de gastos es requerida. Para prevenir errores en la suma, los gastos e ingresos del Cliente deben ser sumados. El ingreso total es igual a la suma del Ingreso más otro ingreso y los gastos totales igual a Gastos, más gastos financieros más otros gastos.</span>

|}
</div>
&nbsp; 

Así es como la pantalla se vería:<br>

[[Image:Adding Modules Image 17.png|center]] 

<br>

Esta sería la vista de diseño de la regla que hace los cálculos:<br>

[[Image:Adding Modules Image 18.png|center]]<br>

Así es como en la regla el botón se vería: 

(Tenga en cuenta que esto es teniendo la entidad Client como la entidad de contexto) 

[[Image:Adding Modules Image 19.png|center]] 

<br>

Así es como la regla executing On Exit de la actividad se vería 

(Tenga en cuenta que esto es teniendo a la entidad de aplicación como la entidad de contexto) 

[[Image:Adding Modules Image 20.png|center]]<br>

<div align="center">
{|class="MsoNormalTableAlert" cellspacing="0" cellpadding="0" width="456" border="1"
|-
| valign="top" width="100%" | 
'''<span>Alerta:</span>'''<span> Cuando termina una expresion que retorna un valor y éste es '''Undefined''', la expresión realmente retornará la ÚLTIMA línea de asignación que NO sea Undefined. Por ejemplo, una varibala contiene una suma:
var SUMA = <Attributo1> + <Atributo2>;
SUMA;
Si la variable sume es Undefined, la regla retornará la última línea que fue asignada que no fuese Undefined.
.</span>
|}
</div>


== &nbsp; Información Relacionada  ==

*[[Expresiones|Expresiones]] 
*[[Usando XPath|¿Cómo construir expresiones XPath?]]

<br>
<div><div></div></div></div></div>
<comments />