Ver código fuente

<keywords content="keywords">
getXPath, setXPath, Me.getXPath, Me.setXPath, addRelation 
</keywords>&nbsp; 

= ¿Cómo Construir Expresiones XPath?  =

Bizagi como una herramienta BPM esta destinada a ser muy intuitiva y a permitir la&nbsp;automatización ágil de los procesos de negocio y sus subsecuentes modificaciones con una el objetivo de tener un mejoramiento continuo. 

Con este objetivo en mente, Bizagi presenta el concepto de XPath, el cual es un mecanismo para estandarizar el lenguaje en la herramienta y hace el manejo de reglas del negocio sea más intuitivo para todos los involucrados. 

El estándar XPath es el resultado del esfuerzo para construir un lenguaje de navegación en XML que sea facil de usar, el cual es útil para llevar acabo tareas complejas. Bizagi incorporó este estándar es su lenguaje, permitiendo al usuario llevar acabo tareas comunes sobre Entidades de Negocio, así como asignaciones, consultas, y navegación sobre entidades de negocio. 

Adicionalmente, XPath ofrece la posibilidad de llevar a cabo operaciones por medio de las funciones que este posee y establece condiciones de forma intuitiva para obtener datos de forma filtrada. 

<br> 

== Obtener información con XPath  ==

<span style="color: rgb(0,0,128)">'''&lt; XPath expression &gt;'''</span><br> 

<span lang="ES-CO">Las expresiones XPath están escritas entre&nbsp; '&lt;' y '&gt;'.</span> 

<span lang="ES-CO">Estas SIEMPRE empiezan con la Entidad de Proceso como el primer atributo y navegan el modelo de datos usando puntos entre los atributos.</span> 

<br> 

[[Image:Business Rules2 Image001.jpg|center]] 

<br> 

La imagen de arriba será usada como guía para mostrar las Expresiones Xpath. 

Una Solicitud de Crédito tiene una Entidad de Proceso llamada '''Solicitud (Request)'''. A partir de esta entidad se realiza la navegación del modelo de datos, usando XPath. 

Cada Solicitud tiene un '''Cliente '''y varias '''Garantías '''(Esta es una relación uno a muchos, o colección). 

Utilizando XPath usted puede obtener el valor almacenado en un atributo o asignarle uno. 

<br> 

Para los siguiente ejemplos utilizaremos una variabe denominada VariableEjemplo para almacenar el valor de un atributo. 

[[Image:Bulletazul.gif]] Para obtener el Valor de la Solicitud, use la expresión: &nbsp; 

'''<span>&lt;Request.TotalValueRequest&gt;</span>''' <br> 

<br> 

[[Image:Bulletazul.gif]] Para obtener el nombre del cliente asociado a la solicitud, utilice la expresión: 

'''<span>&lt;Request.Clients.Name&gt;</span>''' 

<br>[[Image:Bulletazul.gif]] Para encontrar el identificador del Cliente que hace la Solicitud, use la expresión: &nbsp; 

'''<span>&lt;Request.Clients.id&gt;</span>''' 

<br> En este caso, usted tiene que usar el atributo id para poder obtener el identificador de la entidad, ya que la expresión &lt;Request.Clients&gt; se refiere al Cliente de la Solicitud, y no a su identificador. Todas las entidades de Bizagi tienen un atributo "escondido" llamado id, que esta relacionado a la llave de la entidad. <br> 

<br> 

== Asignar valores con XPath  ==

La forma más fácil para asignar un valor a un elemento es usando el operador "=". 

<br> 

<span>[[Image:Bulletazul.gif]] &lt;Client.Name&gt;= "Peter"</span><span lang="ES-CO">&nbsp; Asigna el nombre "Peter" al cliente</span> 

<br> 

<span>[[Image:Bulletazul.gif]] &lt;Request.TotalValueRequested&gt; = 1000</span><span lang="ES-CO">&nbsp; Asigna 1,000 al Valor Total Solicitado</span> 

<br> 

=== Ejemplos  ===

De acuerdo a cómo se escriba un XPath usted puede obtener el valor de un atributo o asignarle uno. 

<br> 

*Variable = &lt;BusinessEntity.Attribute&gt;

Almacena el atributo en la Variable 

<br> 

*&lt;BusinessEntity.Attribute&gt; = Variable

Asigna el valor de la Variable al atributo. 

<br> 

El diagrama muestra las relaciones que existen&nbsp;entre cuatro entidades en las que se pueden usar las siguientes expresiones XPath:<br> 

<span lang="ES-CO">&nbsp;</span> 
<div><div align="center">
{| width="70%" cellspacing="0" cellpadding="0" border="0" class="wikiTables FCK__ShowTableBorders"
|-
| width="60%" | 
'''<span>Xpath</span>''' 

| width="40%" | 
'''Significado''' 

|- class="rowcolorgray"
| width="149" valign="top" | 
<span>&lt;Request.RequestAuthorization&gt;</span> 

| width="310" valign="top" | 
<span lang="ES-CO">Cuando RequestAuthorization es un tipo de atributo booleano la expresión es verdadera o falsa (true ó false) y se interpreta como La solicitud es aprobada?</span> 

|-
| width="149" valign="top" | 
<span>&lt;Request.Clients.Age&gt; </span> 

| width="310" valign="top" | 
<span lang="ES-CO">La edad del cliente (Age) es un atributo de tipo entero.</span> 

|- class="rowcolorgray"
| width="149" valign="top" | 
<span>&lt;Request.TotalValueRequested&gt; </span> 

| width="310" valign="top" | 
<span>TotalValueRequested es un atributo de tipo moneda. La expresión es el monto Total de la Solicitud</span> 

|}
</div></div> 
<br> Para acceder a la información dentro de las entidades que tienen una relación de uno a muchos (1:N), es necesario usar el nombre de la relación, o Fact. Si hay una relación de uno a muchos, la expresión XPath representará un conjunto de valores. 

<br> 

Guarantees es el nombre del fact entre la Solicitud (Request) y las Garantias (Guarantees). 
<div><span lang="ES-CO">&nbsp;</span> </div><div><div align="center">
{| width="550" cellspacing="0" cellpadding="0" border="0" class="wikiTables FCK__ShowTableBorders"
|-
| width="149" | 
'''<span>Xpath</span>''' 

| width="310" | 
'''Significado''' 

|- class="rowcolorgray"
| width="149" valign="top" | 
<span>&lt;Request.Guarantees&gt;</span> 

| width="310" valign="top" | 
<span lang="ES-CO">Conjunto de garantías de la solicitud</span> 

|-
| width="149" valign="top" | 
<span>&lt;Request.Guarantees.GuaranteedValue&gt;</span> 

| width="310" valign="top" | 
<span lang="ES-CO">Conjunto de valores de todas las garantías de la solicitud</span> 

|- class="rowcolorgray"
| width="149" valign="top" | 
<span>&lt;Request.Guarantees.Type.Code&gt;</span> 

| width="310" valign="top" | 
<span>Código de todas las garantías de la solicitud</span> 

|}
</div></div> 
<br> 

<br> 

== Acceder a colecciones con XPath  ==

Para acceder a información almacenada en las entidades que tienen relaciones 1-N, es necesario utilizar el nombre de la [[Relaciones y Colecciones|<u>relación o Fact</u>]]. El nombre de la relación es utilizado para navegar desde la entidadd del proceso a la coleción. Si hay una relación 1-N,la expresión XPath representará un conjunto de valores. 

El nombre de la relación es la mostradda en la flecha que conecta las dos entidades en las “Guarantees”, y es utilizada para acceder a la colección. En este caso accede a todas las garantias de la solicitud. 

<br> 

*VariableEjemplo ='''&lt;Request.Guarantees&gt;'''

Obtiene todas las garantias de la solicitud. 

<br> 

*VariableEjemplo = '''&lt;Request.Guarantees.GuaranteedValue&gt;'''

<br> 

Adicionalmente, el atributo GaranteedValue se especificó, lo cual retornará una colección de valores a las Garantias de la Solicitud.Por lo tanto ExampleVariable almacenará una colección de todos los GuaranteedValues de las Garantias relacionadas a la Solicitud. 

<br> 

=== Filtrar colecciones utilizando XPath  ===

Las colecciones pueden ser filtradas para obtener conjuntos de valores mas pequeños para manipular. Los filtros son una poderosa herramiento que restringe el número de elementos que se representan en una expresión XPath. [[Filtro|<u>Filtro</u>]] 

<br> <span style="color: rgb(0,0,128)">'''&lt;BusinessEntity.Fact[Filter]&gt;'''</span><br> 

<br> Los filtros se escriben entre llaves: '[' ']' 

Cuando se filtra una colección, los atributos dentro de las llaves pertenecen a la entidad de la colección. De nuevo usted puede navegar a través de ellos utilizando un punto y asignando condiciones tales como mayor que o igual a , para obtener el conjunto deseado de valores. 

<br> Los siguientes son ejemplos de filtros en nuestra colección de Garantías: 

<span lang="ES-CO">&nbsp;</span> 
<div><div align="center">
{| width="70%" cellspacing="0" cellpadding="0" border="0" class="wikiTables FCK__ShowTableBorders"
|-
| 
'''<span>Expresión</span>''' 

| 
'''Significado''' 

|- class="rowcolorgray"
| valign="top" | 
&lt;Request.Guarantees[Type.Type = 'Mortgage']&gt; 

| valign="top" | 
<span lang="ES-CO">Conjunto de Garantías de tipo Hipoteca </span> 

|-
| valign="top" | 
<span>&lt;Request.Guarantees[GuaranteedValue &gt; 10000 AND GuaranteedValue &lt; 15000]&gt; </span> 

| valign="top" | 
Conjunto de garantías con valores entre 10000 y 15000 

|}
</div></div><div align="center"></div><div align="center"></div><div align="center"></div><div align="center"></div><div></div><div></div><div></div><div></div> 
<br> 
<div><div align="center">
{| width="456" cellspacing="0" cellpadding="0" border="1" class="MsoNormalTableNota"
|-
| width="100%" valign="top" | 
'''<span lang="ES-CO">Nota:</span>'''<span lang="ES-CO">&nbsp; En las expresiones XPath el atributo "id" es usado para comparar valores contra identificadores de atributos, o llaves foráneas.&nbsp;</span> 

<span lang="ES-CO">El filtro CORRECTO compara los valores del identificador con un número </span><br> 

'''<span lang="ES-CO">&lt;Request.Guarantees[Type.id= 1]&gt;</span>''' 

|}
</div></div> 
<br> [[Image:Bulletazul.gif]] Asignación masiva de valores:Para asignar un valor a varios ítems de una colección. 

'''&lt;Request.Guarantees[Type.Type = 'Mortgage'].Value&gt; = 5000&nbsp;''' 

Todas las Garantías de Hipoteca tendrán un valor de 5000 

<br> 

[[Filtro|<u>Consulte FILTROS para mayor informacion y ejemplos de como filtrar colecciones</u>]] 

[[Funciones XPath|<u>Consulte Funciones XPath para mayor información sobre cálculos de XPath</u>]] 

[[Iterar sobre Fact o XPath#Iteraci.C3.B3n_sobre_un_Xpath|<u>Consulte&nbsp; Iterar sobre XPath para mayor información sobre cómo iterar(recorrer cada registro) sobre colecciones.</u>]]<br> <br> 

== Funciones getXPath y setXPath  ==

Ademas de las llaves, usted también puede navegar a través del modelo de datos para obtener un conjunto de valores utilizando Xpath con las siguientes funciones (El Xpath debe ir entre comillas):<br> 

'''Me.getXPath("XPath")<br>''' 

'''Me.setXPath(''''''"XPath",value)'''<br> 

Usted puede utilizar &lt; &gt; llaves o las funciones mencionadas indistintamente.<br> 

<br> 

Las siguientes expresiones son equivalentes:<br> 

VariableEjemplo = '''&lt;Request.Clients.Age&gt;'''<br> 

VariableEjemplo = '''Me.getXPath("Request.Clients.Age")'''<br> 

<br> 

'''&lt;Request.Clients.Age&gt;''' = VariableEjemplo<br> 

'''Me.setXPath("Request.Clients.Age",VariableEjemplo)'''<br> 

<br> 

== Funciones getXPath y setXPath <br> ==

Además de la navegación XPath usando brackets de diamante es posible también recorrer el modelo de datos son las siguientes funciones (el XPath debe estar entre comillas dobles):<br>

<br>

'''Me.getXPath("XPath")'''

'''Me.setXPath('"XPath",value)'''

Usted puede usar los brackets de diamante o la función indistinamente.

<br>

Las siguientes expresiones son exactamente equivalentes:

VariableEjemplo= '''&lt;Request.Clients.Age&gt;'''

VariableEjemplo = '''Me.getXPath("Request.Clients.Age")'''

<br>'''&lt;Request.Clients.Age&gt;''' = VariableEjemplo

'''Me.setXPath("Request.Clients.Age",VariableEjemplo)'''<br>

<br>

=== Usando setXPath y getXPath en colecciones<br> ===

Cuando las colecciones deben ser filtradas utilizando '''variables '''es NECESARIO utilizar las funciones'''setXPath ''' y '''getXPath '''. En esos filtros las llaves no pueden ser utilizadas. '&lt; &gt;' . 

<br> 

A continuación se muestra cómo se deben utilizar las variables:<br> 

'''Me.getXPath("BusinessEntity.Fact[AttributeName= "+ variable +"]") '''<br> 

<br> 

[[Image:Bulletazul.gif]] Utilizando con un ejemplo anterior, si el tipo de Garantía fue almacenado en una variale, la asignación masiva de un valor a todas las garantias de ese tipo sería: 

var GuaranteeType = 'Mortgage'<br> 

'''Me.setXPath("Request.Guarantees[Type.Type = "+ GuaranteeType +"].Value",5000) '''<br> 

<br> 



[[Filtro|Consulte FILTROS para mayor informacion y ejemplos de como filtrar colecciones ]]<br><br>

== Agregar elementos a una relación  ==

Para crear nuevas filas en una grilla (insertar registros en una colección) dentro de una regla de negocio, Bizagi cuenta con una función denominada "addRelation" en el objeto ''Me''. 

<br> Por ejemplo, la siguiente sentencia se utiliza en una regla para agregar un nuevo registro a la entidad GuaranteeRequest: 

<br>'''Me.addRelation(“Request.Guarantees”);''' 

La línea de arriba creará una nueva fila de GuaranteeRequest. Una vez la nueva fila se crea, los valores para los atributos de la entidad GuaranteeRequest se pueden setear: 

<br>'''var newGuarantee= Me.addRelation(“idRequest.Guarantees”);<br>newGuarantee.setXPath(“Value”,5000);''' 

<br>A continuación se presentan los elementos de la sentencia addRelation:<br>&nbsp; 
<div><div align="center">
{| width="504" cellspacing="0" cellpadding="0" border="0" class="wikiTables FCK__ShowTableBorders"
|-
| width="149" | 
'''<span>Elemento</span>''' 

| width="310" | 
'''Descripción''' 

|- class="rowcolorgray"
| width="149" valign="top" | 
<span>newGuarantee</span> 

| width="310" valign="top" | 
Variable que tiene la nueva garantía 

|-
| width="149" valign="top" | 
Me 

| width="310" valign="top" | 
Contexto de la la entidad usada en addRelation. Cuando Me es usado, la expresión XPath comienza con la entidad de la aplicación. 

|- class="rowcolorgray"
| width="149" valign="top" | 
idRequest.Guarantees 

| width="310" valign="top" | 
XPath de la relación sobre la cual el elemento es agregado. 

Guarantees es el nombre del Fact que relaciona la entidad Request y la entidad Guarantees, en la relación de uno a muchos (1:N) 

|}
</div></div> 
<br> 
<div align="center">
{| width="431" cellspacing="0" cellpadding="0" border="1" class="MsoNormalTableNota"
|-
| width="100%" valign="top" | 
<span>'''Nota:''' Como se enseña en el ejemplo anterior, nótese que se utilizan los métodos .setXPath y .getXPath para asignar u obtener los valores del nuevo registro creado.
Por ejemplo, se puede obtener el Id asignado automáticamente (surrogate key), por medio de: '''''newGuarantee.getXPath("id");'''''.</span> 

|}
</div> 
<br> 

La función addRelation puede ser también usada para agregar elementos a una relación de muchos a muchos (NxM), identificando la llave foránea del elemento a agregar:<br><br>'''var newGuarantee = Me.addRelation(“Request.Guarantees”, 18);'''<br> 

En este caso, la garantía 18 será agregada a la relación Request_GuaranteeReq.&nbsp; 

&nbsp; 
<div align="center">
{| width="405" cellspacing="0" cellpadding="0" border="1" class="MsoNormalTable"
|-
| width="100%" valign="top" | 
'''<span>Ejemplo: </span>'''<span>En un proceso de Solicitud de Compra, un usuario crea la solicitud y luego el jefe tiene que aprobarla. La solicitud puede necesitar cambios, ser aprobada o rechazada. Las Observaciones de la aprobación son una colección, relacionadas a la solicitud. Se debe crear un registro de esta aprobación para que el jefe pueda ingresar sus observaciones.</span> 

|}
</div> 
&nbsp;&nbsp;[[Image:Business Rules2 Image007.jpg|center]] 

&nbsp;&nbsp;[[Image:Update BR Image 2.png|center]]<br> 

<br> 
<div align="center">
{| width="405" cellspacing="0" cellpadding="0" border="1" class="MsoNormalTable"
|-
| width="100%" valign="top" | 
'''<span>Ejemplo: </span>'''<span>En un proceso de Inventario, todos los productos tienen que ser subidos desde una Tabla de entidad paramétrica a una tabla con una relación de uno a muchos en el caso de Inventarios.</span> 

|}
</div> 
<br>El siguiente es el modelo de datos del ejemplo. Note que Inventario es la Entidad de Proceso Principal y tiene una relación de uno a muchos con Productos. Sin embargo, el nombre del fact es Office Supplies (material de oficina). 

<br> 

[[Image:Business Rules5 Image001.jpg|center]] 

1. Agregue una evento de entrada (On Enter) en la primera actividad del proceso. 

<br>[[Image:Business Rules4 Image014.jpg|center]] 

2. Cree la Expresión. 

La entidad Paramétrica debe ser invocada usando [[Object Model: EntityManager|<u>CentityManager</u>]], guardando el arreglo en una variable. Esto se hace porque no hay relación entre los datos del caso y la entidad que contiene toda la información de los productos al momento de crear el caso.<br> 

Cuando todos los productos son guardados en la variable ''Products'', navegue a través del arreglo agregando cada producto a la relación. 

Esto se hace usando la función addRelation. 

Finalmente, agregue el Producto a la relación usando la función <u>setXPath</u>. El objeto producto (ProductID) debe ser fijado en el atributo que relaciona al Producto con la Entidad Paramétrica Supply (Materiales). 

<br> 

[[Image:Business Rules4 Image013.jpg|center]] 

<br> 

3. Así luciría la interfaz del usuario 

<br> 

[[Image:Business Rules4 Image018.jpg|center]] 

<br> 

== Información avanzada  ==

Si el usuario está trabajando con colecciones y se debe asignar un valor a un registro en especial, en este caso a una sola Garantía, lo primero es seleccionar dicho registro, el n-ésimo para este ejemplo. 

Asuma que en la expresión (o regla) se tiene una variable ''var TotalRows'' (Total de filas) que guarda el número total de registros que tiene la colección. 

*La siguiente expresión accede al registro n-ésimo, en este caso al registro correspondiente al número total de filas (TotalRows).

Se debe enviar a la expresión el registro n-ésimo -1 ya que la expresión cuenta la colección como si comenzara en el registro cero (0). 

'''Guarantees.get(TotalRows-1).setXPath("Value", 30000)'''<br> <br> 

*La siguiente expresión accede al n-ésimo registro filtrando la colección. En este caso, esta expresión accede al primer registro como la fila 1(uno). El usuario debe enviar el n-ésimo registro, no el n-esimo-1 como en la expresión anterior.

'''Me.setXPath("Request.Guarantees["+TotalRows+"].Value",30000)'''

<br> 

== Artículos relacionados  ==

*[[Funciones XPath|<u>Funciones Xpath</u>]] 
*[[Iterar sobre Fact o XPath#iterar_sobre_xpath|<u>Iterar sobre XPath</u>]] 
*[[Filtro|<u>Filtrar XPath</u>]]<u>&nbsp;</u> 
*[[Ejemplo get y set XPath|<u>Ejemplo setXPath y getXPath</u>]] 
*[[Ejemplo Me.Context|<u>Ejemplo Me.Context</u>]]<span> </span>

<comments />