Ver código fuente

<keywords content="keywords">iterar sobre fact, encontrar valor relacion, encontrar informacion, contar entradas, modificar informacion, actualizar informacion, adicionar valores, eliminar entradas, adicionar entradas</keywords>&nbsp; 

== Usar Iteración sobre una relación  ==
Este módulo puede usarse para realizar iteraciones sobre una relación uno-a-muchos '''EXCLUSIVAMENTE''' cuando la relación no se puede acceder directamente a través del modelo de datos, con el XPath. 

Este módulo permite acceder a cada uno de los registros de una relación (también conocido como un fact) para evaluarlos. También permite realizar operaciones tales como modificar la información de los registros, buscar información, contar registros, etc. 

El ejemplo más común para esto es cuando se necesita acceder a una relación uno a muchos entre dos tablas paramétricas. Por ejemplo, la entidad Proveedor tiene una colección de productos que éste provee. Entonces, si el usuario quisiera iterar sobre los productos de los proveedores, ambas siendo entidades paramétricas sin relación directa al caso, el usuario debe usar Iteración sobre una relación. 


[[Image:IterateOverFact2.jpg|center]] 



=== Ejemplo ===
Utilizando la imagen de arriba, imagínese un proceso de solicitud de compra, en donde algunas cotizaciones  deben ser solicitadas y luego comprar la mejor oferta.

El proceso tiene una entidad de paramétrica con los proveedores de la empresa y una entidad paramétrica con todos los productos que se pueden comprar. Cada proveedor ofrece muchos productos, por lo tanto, existe una relación uno a muchos entre los proveedores y productos.

Algunos productos tienen descuentos. En el proceso, cuando un usuario está en la actividad Cotización,  es necesario que él / ella vea los proveedores que están dando los descuentos.  Para mostrar a los proveedores de los productos con descuentos, es necesario tener una expresión en donde se recorren todos los productos y se identifican aquellos con descuento para luego mostrarlos en el portal de trabajo.

1. En el paso número 4 del Asistente de Procesos, se crea la expresión al Entrar.

Esta expresión itera sobre los productos y luego se adiciona los Proveedores sugeridos para ser mostrados en el Portal de Trabajo.


[[Image:IterateOverFact3.jpg|center]] 


2. Construya la expresión
Lo primero que se debe hacer es declarar todas las variables que vayan a ser usadas en la expresión.

La variable Productos será usada para Iterar sobre la relación.

Con el fin de Iterar sobre los productos, vamos a necesitar la '''LLAVE'''. Esta llave es el identificador de cada proveedor en la entidad de los productos. Entonces, tenemos que conseguir primero el Proveedor y tener todas sus llaves, para entrar a la Iterar sobre la relación con cada una. <br> Ya que los proveedores no está relacionada aa modelo de datos, tiene que ser utilizado con CEntityManager.

Suppliers = CEntityManager.GetEntity("Supplier").GetEntityList("","","",""); 

Entonces, para cada Proveedor, vamos a conseguir el SurrogateKeyVale, que es la llave que usaremos. Usando la variable declarada antes, obtendremos la LLAVE:<br>SurrogateKey = Suppliers[Count].SurrogateKeyValue;

Teniendo la LLAVE podemos hacer la Iteración sobre la relación

Luego, podemos recorrer cada uno de los productos del Proveedor de la LLAVE seleccionada. Para acceder al descuento del producto usaremos:

'''Products.Attributes["Discount"].Value'''

Si el producto accedido tiene descuento, entonces lo añadiremos en un arreglo (Array). El arreglo debe ser declarado antes, en este caso será SupplierArray as '''new ArrayList () '''


Finalmente, teniendo todos los proveedores que tienen descuento en el arreglo, usando una expresión FOR adicionamos uno a uno los proveedores a la colección Quotation.SuggestedSuppliers usando la función <u>'''[[Using Xpath#Add_elements_to_a_relationship|Me.addRelation]]'''</u>.


[[Image:IterateOverFact.jpg|center]] 


De esta forma se verán los Proveedores sugeridos en el Portal de Trabajo


[[Image:IterateOverFact1.jpg|center]] 


=== Cómo Encontrar Información en una Relación  ===

<br>

[[Image:Bulletazul.gif]] Para encontrar entradas en una relación que satisface una condición, se puede usar un "if" dentro de la Iteración sobre el Fact o Relación, que contiene una o más expresiones tales como: 

<br>[[Image:Business Rules2 Image009.jpg|center]] 



'''<span>VariableToIterate.Attributes[“Atributo”].Value Operador Valor</span>''' 

<span>En este caso: Products.Attributes["Approved"].Value == true</span><br>

[[Image:Business Rules8 Image010.jpg|center]] 

'''<span>Valor (Value)</span>''': Valor usado para comparar el atributo desde la grilla. Puede ser el valor de un atributo, una variable o una constante. El tipo de valor debe ser tomado en consideración. 

'''<span>Operador (Operator</span>'''): Lo siguiente puede usarse como operadores: 

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

| width="24%" | 
'''<span>Nombre</span>'''

| width="56%" | 
'''<span>Ejemplo</span>'''

|- class="rowcolorgray"
| width="18%" | 
<span>==</span>

| width="24%" | 
<span>Igual a Comparativo</span>

| width="56%" | 
<span>vble.Attributes[“Balance”].Value == 600</span>

|-
| width="18%" | 
<span>&lt;&gt;</span>

| width="24%" | 
<span>Diferente a</span>

| width="56%" | 
<span>vble.Attributes[“idClient”].Value &lt;&gt; &lt;idClient&gt;</span>

|- class="rowcolorgray"
| width="18%" | 
<span>&gt; </span>

| width="24%" | 
<span>Mayor que</span>

| width="56%" | 
<span>vble.Attributes[“Balance”].Value &gt; 600</span>

|-
| width="18%" | 
<span>&lt; </span>

| width="24%" | 
<span>Menor que</span>

| width="56%" | 
<span>vble.Attributes[“Balance”].Value &lt; 600</span>

|- class="rowcolorgray"
| width="18%" | 
<span>&gt;=</span>

| width="24%" | 
<span>Mayor o igual que</span>

| width="56%" | 
<span>vble.Attributes[“Balance”].Value &gt;= 600</span>

|-
| width="18%" | 
<span>&lt;=</span>

| width="24%" | 
<span>Menor o igual que</span>

| width="56%" | 
<span>vble.Attributes[“balance”].Value &lt;= 60</span>

|}
</div>
=== Cómo Contar las Entradas de una Relación  ===

<br>

[[Image:Bulletazul.gif]] Para contar las entradas de una relación, se puede: Crear una expresión en la Iteración (Iterate Over Fact) 

La expresión puede ser creada usando una variable que hará la cuenta como se muestra a continuación: 

'''<span>Count = Count +</span>''''''<span>1</span>''''''<span>;</span>''' 

No olvide declarar la variable Count al principio de la regla. 

<br>

[[Image:Business Rules8 Image011.jpg|center|Image:Business_Rules8_Image011.jpg]] 

<br>

[[Image:Bulletazul.gif]] Para contar las entradas de una relación que satisface una condición 

<br>

[[Image:Business Rules8 Image012.jpg|center|Image:Business_Rules8_Image012.jpg]] 

[[Image:Bulletazul.gif]] Se puede también usar una expresión sin usar la Iteración sobre Fact (Relación) que contiene la siguiente función: 

<span>Count=CEntityManager.GetEntity("'''EntityName'''",&lt;'''idEntityName'''&gt;).Facts["FactName"].ChildEntities.Count</span> 

'''<span>EntityName</span>''': Nombre de la entidad que contiene la relación (Entity One). 

'''<span>idEntityName</span>''': Introduzca la llave foránea que identifica cada una de las entradas de la entidad N con la entidad relacionada. 

'''<span>FactName</span>''': Nombre de la relación. 

<br>

[[Image:Business Rules8 Image013.jpg|center|Image:Business_Rules8_Image013.jpg]] 

&nbsp; 

=== Cómo Modificar Información en una Relación  ===

<br>

[[Image:Bulletazul.gif]] Para modificar las entradas de una Relación, se puede usar una Expresión que contenga lo siguiente en la Iteración sobre Fact. 

'''<span>vble</span>'''<span>.Attributes['''“Attribute1'''”].Value = '''value1''';</span> 

'''<span>vble</span>'''<span>.Attributes['''“Attribute2”'''].Value = '''value2''';</span> 

'''<span>vble</span>'''<span>.Attributes['''“AttributeN”'''].Value = '''valueN''';</span> 

'''<span>vble</span>'''<span>.Update();</span> 

'''<span>vble</span>''': El nombre de la variable usada para el ciclo de Iterar sobre Fact. 

'''<span>Attribute1…n</span>''': Nombre de cada uno de los atributos que serán modificados en la entidad N. 

'''<span>Value1…n</span>''': Valor que tomará la entrada. Puede ser el valor de un atributo, una variable o una constante. El tipo de valor debe tomarse en consideración. 

<br>

<span style="background: silver 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial">[[Image:Business Rules8 Image014.jpg|center|Image:Business_Rules8_Image014.jpg]]</span> 

<br>

Se puede usar también: 

<br>

<span>setAttrib("'''EntityName'''", '''vble'''.SurrogateKeyValue, '''“Attribute1”''', '''value1''');</span> 

<span>setAttrib("'''EntityName'''", '''vble'''.SurrogateKeyValue, '''“Attribute2”''', '''value2''');</span> 

<span>setAttrib("'''EntityName'''", '''vble'''.SurrogateKeyValue, '''“AttributeN”''', '''valueN''');</span> 

<br>

'''<span>EntityName</span>''': Is el nombre de la entidad N. 

<br>

[[Image:Bulletazul.gif]] Para modificar las entradas de una relación que satisface una condición: 

<br>

<span>[[Image:Business Rules8 Image015.jpg|center|Image:Business_Rules8_Image015.jpg]]</span> 

=== Adicionar el Valor de un Atributo (Columna) de una Relación por Filas  ===

<br>

[[Image:Bulletazul.gif]] Para sumar todas las entradas existentes de la relación, use una Expresión en la Iteración sobre Fact. 

'''<span>sum</span>'''<span>= '''sum''' + '''vble'''.Attributes["'''Attribute'''"].Value;</span> 

No olvide declarar la variable al principio de la regla. 

<br>

[[Image:Business Rules8 Image016.jpg|center|Image:Business_Rules8_Image016.jpg]] 

<br>

[[Image:Bulletazul.gif]] Sume las entradas que satisfacen una condición. 

<br>

[[Image:Business Rules8 Image017.jpg|center|Image:Business_Rules8_Image017.jpg]] 

<br>

Se puede almacenar el valor de la suma en un atributo adicionando una expresión al final del ciclo: 

<span>&lt;'''AttribName'''&gt; = '''Sum''';</span> 

'''<span>vble</span>''': El nombre de la variable usada para el ciclo de Iteración sobre Fact. <br>

'''<span>Attribute</span>''': Nombre del atributo de la entidad N que contiene el valor que será sumado. 

'''<span>AttribName</span>''': Atributo donde se quisiera grabar el valor total de la suma. 

<br>

=== Eliminar Entradas de una Relación  ===

<br>

[[Image:Bulletazul.gif]] Para eliminar las entradas que satisfacen una condición, use una expresión en la Iteración sobre Fact. 

'''<span>vble</span>'''<span>.Delete();</span> 

<br>

[[Image:Business Rules8 Image018.jpg|center|Image:Business_Rules8_Image018.jpg]] 

<br>'''<span>vble</span>''': El nombre de la variable usada para el ciclo de Iteración sobre Fact.<br>

=== Adicionar Entradas a una Relación  ===

<br>

No se puede usar el módulo de Iteración sobre Fact cuando una relación no tiene entradas. Por lo tanta, para adicionar entradas a la relación, se puede usar las siguientes expresiones. 

<br>

[[Image:Bulletazul.gif]] Adicionar una entrada en blanco a una Relación. 

<br>

Declarar la variable <span>o'''EntEntityName'''</span> 

<span>oEnt'''EntityName''' = CEntityManager.GetEntity("'''EntityName'''");</span> 

<span>oEnt'''EntityName'''.Attributes["'''idEntityKey'''"].Value = &lt;idOtherEntityKeyRelatedPV&gt;;</span> 

<span>oEntEntityName.Add();</span> 

[[Image:Business Rules8 Image019.jpg|center|Image:Business_Rules8_Image019.jpg]] 

<br>

[[Image:Bulletazul.gif]] Adicionar una entrada en una entidad con valores en los atributos: 

<br>

[[Image:Business Rules8 Image020.jpg|center|Image:Business_Rules8_Image020.jpg]] 

<br>

Declare la variable '''<span>oEntEntityName</span>''' 

<br>

<span>oEnt'''EntityName''' = CEntityManager.GetEntity("'''EntityName'''");</span> 

<span>oEnt'''EntityName'''.Attributes["'''idEntityKey'''"].Value = &lt;'''idOtherEntityKeyRelatedPV'''&gt;;</span> 

<span>oEnt'''EntityName'''.Attributes["'''Attribute1'''"].Value = '''value1''';</span> 

<span>oEnt'''EntityName'''.Attributes["'''Attribute2'''"].Value = '''value2''';</span> 

<span>oEnt'''EntityName'''.Attributes["'''AttributeN'''"].Value = '''valueN''';</span> 

<span>oEnt'''EntityName'''.Add();</span> 

<br>

Si se quiere grabar la id de la entrada que ha creado, reemplace la última línea con: 

<br>

[[Image:Bulletazul.gif]] Para grabarla en una variable: 

'''<span>id</span>''' = <span>oEnt'''EntityName'''.Add()</span>; donde id es una variable que debe ser declarada 

[[Image:Bulletazul.gif]] Para grabarla en un atributo: 

<span>&lt;AttributePath&gt; = oEnt'''EntityName'''.Add();</span> 

<br>

'''<span>EntityName</span>''': Nombre de la entidad N a la que se quiere adicionar las entradas. 

'''<span>idEntityKey</span>''': Llave Primaria de la entidad N donde se quiere grabar las entradas. 

'''<span>idOtherEntityKeyRelatedPV</span>''': Introduzca el camino del atributo que contiene el valor de la llave foránea que identifica cada una de las entradas de la entidad n con la entidad relacionada. 

'''<span>Attribute1…n</span>''': Nombre de cada uno de los atributos que serán modificados en la entidad N. 

'''<span>Value1…n</span>''': Valor que tomará la entrada. Puede ser el valor de un atributo, una variable o una constante. El tipo de valor debe ser tenido en consideración.<br>

<br>
<div align="center">
{| class="MsoNormalTableNote" border="1" cellspacing="0" cellpadding="0" width="456"
|-
| valign="top" width="100%" | 
'''<span>Nota:</span>'''<span> Es muy importante mencionar que el EntityManager debería ser utilizado únicamente para obtener y trabajar con Entidades que no se encuentran relacionadas con el caso y que '''No''' se pueden acceder directamente navegando por el modelo de datos con XPath.</span> Esto se debe a que el EntityManager no obtiene la información desde el Scope que maneja Bizagi, sino directamente desde la base de datos.&nbsp;De esta forma, la información que aún no ha sido persistida en la base de datos no podrá ser encontrada por el EntityManager.

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

== Información Relacionada  ==

*[[Iterar sobre Fact o XPath|Iterar sobre Relación (Fact)]] 
*[[Iterar sobre Fact o XPath#Iteration_over_Xpath|Iterar sobre XPath]][[Iterar sobre Fact o XPath|<br>]]
</div>
<comments />