Dos Ideas. - Contribuciones del usuario [es]

Integración de Maven con IDEs

2013-03-19T18:28:36Z

Shichibukai: /* Mas Detalles */

== Eclipse ==

Existen 2 plugins disponibles para Eclipse, pero solo uno se encuentra estable.

=== M2Eclipse ===

Provee las siguientes características:

* Crear builds desde Eclipse.
* Configuración de las dependencias del proyecto desde el pom.xml
* Descarga automática de dependencias desde repositorios remotos de Maven.
* Editor gráfico del POM, incluyendo agregado de dependencias con Autocomplete.
* Wizards para la creación de proyectos Maven y para la conversión de proyectos sin Maven.

Update site: http://m2eclipse.sonatype.org/sites/m2e

Para poder montar un proyecto en Eclipse, primero deberemos generar los archivos de configuración para el IDE. Esto realiza invocando la tarea:

mvn eclipse:eclipse

Una vez ejecutada correctamente, el proyecto se puede montar en Eclipse accediendo a: File -> Import y en esa ventana General -> Existing Projects into Workspace.

En caso que se vaya a trabajar con varios projectos en simultáneo (a través de un POM multiproyecto), es necesario realizar un paso previo para que el plugin de eclipse pueda interpretar correctamente las dependencias.

mvn install
mvn eclipse:eclipse

== NetBeans ==

== Mas Detalles ==
* [http://m2eclipse.sonatype.org/ M2Eclipse Home Page]
* [[Maven]]

Integración de Maven con IDEs

2013-03-19T18:27:47Z

Shichibukai: /* Mas Detalles */

Javadump

2013-03-19T18:25:22Z

Shichibukai: Leer un javadump desde el notepad

'''Javadump''' es la información estructurada de la jvm en un instante determinado, en la cual registra el vuelco de memoria, los thread de la JVM y el estado de cada thread.
Esta información es la que utilizaremos cuando queremos analizar algún problema de perfomance, pergem o simplemente ver como se comporta nuestra aplicación en la JVM.
Existen varias herramientas para leer el javadump que varía según el entorno en la que se genera el javadump (Windows, AIX, etc), en este post vamos a analizar el javadump desde el notepad.

==Información del thread==
Dentro del javadump, tenemos una sección (thread Details/All Thread Details) en donde se detalla cada thread que se encuentra corriendo dentro de la JVM.
<code>
"Java2D Disposer" J9VMthread:0x00000001193E8A00, j9thread_t:0x00000001179DD300, java/lang/thread:0x0700000003B84360,
state:CW, prio=10
(native thread ID:0x904F3, native priority:0xA, native policy:UNKNOWN)
Java callstack:
at java/lang/Object.wait(Native Method)
at java/lang/Object.wait(Object.java:196(Compiled Code))
at java/lang/ref/ReferenceQueue.remove(ReferenceQueue.java:102(Compiled Code))
at java/lang/ref/ReferenceQueue.remove(ReferenceQueue.java:79(Compiled Code))
</code>

Por cada thread tenemos la siguiente información:
*'''Nombre:''' En caso de estar en un servidor de aplicaciones, es el identificador que asigna el servidor de aplicaciones al thread. Ej.:Java2D Disposer
*'''Estado:''' estado actual del thread. Ej.: CW. Los estados pueden ser:
**R - Runnable - El thread puede tiene todos los recursos para ejecutarse.
**CW - Condition Wait - El thread se encuentra en espera de algún evento, ej:
***Esperando por una operación E/S.
***El thread ejecuta el metodo wait() de un monitor y espera el evento notify().
***El thread espera para sincronizarse con otro hilo, invocando al metodo join()
***El thread espera por ejecutar el metodo sleep()
**S – Suspended – el thread fue suspendido por otro thread.
**Z – Zombie – el thread fue eliminado.
**P – Parked – el thread fue puesto en ese estado por la nueva api de concurrencia (java.util.concurrent).
**B – Blocked – el thread esta esperando para obtener acceso a la región critica (luego de pasar por el wait()) que posee otro hilo.
*'''Prioridad:''' prioridad del thread (mientra más alto más prioritario), cada prioridad de Java es mapeado a la prioridad del Sistema Operativo. Ej.: prio=10
*'''Stacktrace:''' El stack trace de la invocación realizada por el thread. Ej.:
<code>
Java callstack:
at java/lang/Object.wait(Native Method)
at java/lang/Object.wait(Object.java:196(Compiled Code))
at java/lang/ref/ReferenceQueue.remove(ReferenceQueue.java:102(Compiled Code))
at java/lang/ref/ReferenceQueue.remove(ReferenceQueue.java:79(Compiled Code))
</code>

==Monitores/Locks==
Los monitores es el mecanismo que utiliza Java para sincronizar los thread cuando quieren acceder a un recurso compartido. Para entender mejor como funciona el mecanismo de sincronización podemos leer el [http://docs.oracle.com/javase/tutorial/essential/concurrency/locksync.html tutorial de java sobre los monitores].
Dentro del javadump, tenemos la información de los thread que estan a la espera de un monitor (lock), esta información nos puede ser útil para detectar deadlock o mucho thread compitiendo por el mismo recuros.
Ej.:
<code>
NULL ------------------------------------------------------------------------
0SECTION LOCKS subcomponent dump routine
NULL ===============================
NULL
1LKPOOLINFO Monitor pool info:
2LKPOOLTOTAL Current total number of monitors: 1358
NULL
1LKMONPOOLDUMP Monitor Pool Dump (flat & inflated object-monitors):
2LKMONINUSE sys_mon_t:0x000000011D560258 infl_mon_t: 0x000000011D560298:
3LKMONOBJECT weblogic/utils/classloaders/ChangeAwareClassLoader@0x0700000001858578/0x0700000001858590:
owner "[ACTIVE] ExecuteThread: '348' for queue: 'weblogic.kernel.Default (self-tuning)'" (0x0000000140298F00),
entry count 2
3LKWAITERQ Waiting to enter:
3LKWAITER "[ACTIVE] ExecuteThread: '9' for queue: 'weblogic.kernel.Default (self-tuning)'" (0x000000011E5DED00)
3LKWAITER "[ACTIVE] ExecuteThread: '12' for queue: 'weblogic.kernel.Default (self-tuning)'" (0x000000011E942B00)
3LKWAITER "[ACTIVE] ExecuteThread: '17' for queue: 'weblogic.kernel.Default (self-tuning)'" (0x00000001213EE700)
3LKWAITER "[ACTIVE] ExecuteThread: '41' for queue: 'weblogic.kernel.Default (self-tuning)'" (0x000000012175A400)
</code>

En el ejemplo vemos que los threads se encuentran esperando que se libere la instancia '''weblogic/utils/classloaders/ChangeAwareClassLoader@0x0700000001858578/0x0700000001858590''' cuyo dueño es '''[ACTIVE] ExecuteThread: '348' '''

==Ver también==
* [http://docs.oracle.com/javase/tutorial/essential/concurrency/index.html Tutorial Java sobre concurrencia]
* [http://javaeesupportpatterns.blogspot.com.ar/2011/11/how-to-analyze-thread-dump-part-1.html Como analizar el "thread dump"]
* [http://publib.boulder.ibm.com/infocenter/realtime/v1r0/index.jsp?topic=%2Fcom.ibm.rt.doc.10%2Fdiag%2Ftools%2Fjavadump_tags_threads.html Interpretando el javadump en el IBM WebSphere]

[[Category:Java]]

Java

2013-03-19T18:02:35Z

Shichibukai: /* Cuestiones generales de Java */

[[Category:Java]]
Java es un lenguaje de programación, aunque también se suele hacer referencia con este nombre a toda una plataforma para el desarrollo de aplicaciones. Hay un buen [http://es.wikipedia.org/wiki/Java_%28Sun%29 resumen de Java en la wikipedia].

Al desarrollar un sistema se suele basar en una [[Arquitectura De Software]] para crear los componentes.

Java se caracteriza por una enorme cantidad de proyectos libres.

== Algunas tecnologías Java ==
=== Frameworks de base===
* [[Spring Framework]]
* [[Terracotta]]
* [[EJB]]
* [[Restlet]]

===Acceso a datos===
* [[Hibernate]]
* [[Apache Lucene]]

===Frameworks de presentación===
* [[Apache Tiles]]
* [[Struts]]
* [[JSF]]
* [[JSTL]]
* [[GWT]]
* [[SiteMesh 2]]

===Librerías===
* [[Google Guava]]
* [[Jawr]]

===Mensajeria===
* [[JMS]]

===Web Services===
* [[Web Service]]
* [[Web Service Con Spring]]

===Ejecuciones batch y programadas===
* [[Quartz]]
* [[Spring Batch]]

===Seguridad===
* [[Spring Security]]

===Cuestiones generales de Java===
* [[Validaciones de XML contra XSD En Java]]
* [[Fechas En Java]]
* [[Numeros En Java]]
* [[Encoding En Java]]
* [[Serializacion De Objetos En Java]]
* [[Log4J]]
* [[SLF4J]]
* [[Cache De Objetos Java]]
* [[Exportacion Hacia Archivos]]
* [[Javadump]]

Archivo:ConsumirWS NET conJava Solucion.jpg

2012-06-22T14:25:33Z

Shichibukai: subida una nueva versión de «Archivo:ConsumirWS NET conJava Solucion.jpg»

Solucion para consumir un WS en .Net con clientes Java utilizando un Aqualogic

Archivo:ConsumirWS NET conJava Solucion.jpg

2012-06-22T13:31:17Z

Shichibukai: subida una nueva versión de «Archivo:ConsumirWS NET conJava Solucion.jpg»

Solucion para consumir un WS en .Net con clientes Java utilizando un Aqualogic

Consumir Web Service .NET con clientes Java mediante Aqualogic

2012-06-22T13:21:08Z

Shichibukai: /* Solución */

== Contexto ==
Consumir un Webservice realizado en .NET utilizando DataSet, a la cual no tenemos posibilidad de modificar el contrato (WSDL).

[[Archivo:consumirWS_NET_con_Java_contexto.jpg]]

En el WSDL, como respuesta de operación tenemos:
<code xml>
...
...
<s:element name="BuscarAlumnoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="BuscarAlumnoResult">
<s:complexType>
<s:sequence>
<s:element ref="s:schema" />
<s:any />
</s:sequence>
</s:complexType>
...
...
</code>
Cuando al consumir el WebService nos responde:
<code xml>
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:Locale="">
...
...
</xs:schema>
<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<NewDataSet xmlns="">
<Table diffgr:id="Table1" msdata:rowOrder="0">
<Legajo>123456</legajo>
<Nombre>Mickey</Nombre>
<Apellido>Mouse</Apellido>
</Table>
...
</NewDataSet>
</diffgr:diffgram>
...
...
</code>

== Problema ==
Si queremos consumir el WSDL desde un cliente java, al quere mapear el WSDL (por ejemplo con jaxb) nos dará el siguiente error:

'''[ERROR] undefined element declaration 's:schema' '''

=== Explicación ===
Observando el WSDL, podemos ver que al generar la clase que representan a la respuesta de la operación (BuscarAlumnoResponse), jaxb desconoce como resolver
<code xml>
<s:element ref="s:schema" />
<s:any />
</code>
Lo que nos esta diciendo el WSDL es que la operación buscarAlumno, tiene como respuesta un elemento schema y cualquier tipo de objeto como respuesta.
Como vemos en el contrato del servicio, no esta definido realmente el tipo de respuesta (no lo sabemos hasta el momento de ejecutar la operación) lo que nos dificulta la creación del cliente.

=== Solución ===
Una posible solución es utilizar un [[AquaLogic| Aqualogic Service Bus]], para consumir el webservice y exponerlo en un contrato amigable.

[[Archivo:consumirWS_NET_conJava_Solucion.jpg]]

En el Aqualogic, generaremos un proyecto en el cual business sea consumidor del webservice .NET y el proxy es en contrato que expondremos a los clientes Java, para esto último utilizaremos un XSLT para transformar la respuesta del webservice.

Los pasos serían:

==== 1. Definir el nuevo contrato de la operación a exponer ====
En nuestro caso solo modificaremos la respuesta de la operación:
<code xml>
...
...
<s:element name="BuscarAlumnoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="BuscarAlumnoResult">
<s:complexType>
<s:sequence>
<s:element name="alumnos" type="tns:Alumno" minOccurs="0" maxOccurs="unbounded" />
</s:sequence>
</s:complexType>
</s:element>
</s:sequence>
</s:complexType>
</s:element>

<s:complexType name="Alumno" >
<s:sequence>
<s:element name="legajo" type="s:string" minOccurs="0"/>
<s:element name="nombre" type="s:string" minOccurs="0"/>
<s:element name="apellido" type="s:string" minOccurs="0"/>
</s:sequence>
</s:complexType>
...
...
</code>
==== 2. Generar un XSLT ====
Generaremos un XSLT para transformar la respuesta del servicio .NET al nuevo WSDL que expondremos:
<code xml>
<?xml version="1.0" encoding="UTF-8" ?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:dosideas="http://dosideas.com/dataset">
<xsl:output method="xml" encoding="UTF-8" indent="yes"/>
<xsl:template match="*">
<xsl:for-each select="current()/*/*[2]/*">
<xsl:element name="dosideas:BuscarAlumnoResult" namespace="http://dosideas.com/dataset" >
<xsl:for-each select="current()/*">
<xsl:element name="dosideas:alumnos" namespace="http://dosideas.com/dataset">
<xsl:for-each select="current()/*">
<xsl:element name="dosideas:{local-name()}" namespace="http://dosideas.com/dataset">
<xsl:apply-templates/>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</code>
==== 3. Exponer el servicio en el Aqualogic Service Bus ====
Con los WSDL y XSLT generados, realizaremos los siguientes pasos:
3.1 Subir el WSDL del servicio .NET

3.2 Subir el nuevo WSDL del servicio.

3.3 Subir el XSLT para transformar la respuesta.

3.4 Crear un Business Service para consumir el servicio .NET

3.5 Crear un Proxy Service que consuma el Business Service y exponga el resultado según el nuevo contrato.

3.6 Configurar el Proxy Service (Message Flow) para modificar la respuesta del Business Service.

*3.6.1 Editar el Route que apunta al Business Service creado y en el Response Action, agregamos una acción de replace, donde:
**'''XPath:''' //dosideas:BuscarAlumnoResponse
**'''Expression:''' <EL XSLT>

*3.6.2 Al Proxy, agregarle un PipelinePair, con un Stage en el Response.
*3.6.3 En el Stage del Response:
**'''XPath:''' . (El carácter punto)
**'''Variable:''' body
**'''Expression:''' $body
**'''Replace entire node'''

== Ver también ==
* [[AquaLogic]]
* [http://www.bea.com/aqualogic/ Web oficial de AquaLogic]
* [[Spring Web Services]]

Consumir Web Service .NET con clientes Java mediante Aqualogic

2012-06-22T13:20:20Z

Shichibukai: /* Solución */

== Contexto ==
Consumir un Webservice realizado en .NET utilizando DataSet, a la cual no tenemos posibilidad de modificar el contrato (WSDL).

[[Archivo:consumirWS_NET_con_Java_contexto.jpg]]

En el WSDL, como respuesta de operación tenemos:
<code xml>
...
...
<s:element name="BuscarAlumnoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="BuscarAlumnoResult">
<s:complexType>
<s:sequence>
<s:element ref="s:schema" />
<s:any />
</s:sequence>
</s:complexType>
...
...
</code>
Cuando al consumir el WebService nos responde:
<code xml>
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:Locale="">
...
...
</xs:schema>
<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<NewDataSet xmlns="">
<Table diffgr:id="Table1" msdata:rowOrder="0">
<Legajo>123456</legajo>
<Nombre>Mickey</Nombre>
<Apellido>Mouse</Apellido>
</Table>
...
</NewDataSet>
</diffgr:diffgram>
...
...
</code>

== Problema ==
Si queremos consumir el WSDL desde un cliente java, al quere mapear el WSDL (por ejemplo con jaxb) nos dará el siguiente error:

'''[ERROR] undefined element declaration 's:schema' '''

=== Explicación ===
Observando el WSDL, podemos ver que al generar la clase que representan a la respuesta de la operación (BuscarAlumnoResponse), jaxb desconoce como resolver
<code xml>
<s:element ref="s:schema" />
<s:any />
</code>
Lo que nos esta diciendo el WSDL es que la operación buscarAlumno, tiene como respuesta un elemento schema y cualquier tipo de objeto como respuesta.
Como vemos en el contrato del servicio, no esta definido realmente el tipo de respuesta (no lo sabemos hasta el momento de ejecutar la operación) lo que nos dificulta la creación del cliente.

=== Solución ===
Una posible solución es utilizar un [[AquaLogic| Aqualogic Service Bus]], para consumir el webservice y exponerlo en un contrato amigable.

[[Archivo:consumirWS_NET_conJava_Solucion.jpg | 800px]]

En el Aqualogic, generaremos un proyecto en el cual business sea consumidor del webservice .NET y el proxy es en contrato que expondremos a los clientes Java, para esto último utilizaremos un XSLT para transformar la respuesta del webservice.

Los pasos serían:

==== 1. Definir el nuevo contrato de la operación a exponer ====
En nuestro caso solo modificaremos la respuesta de la operación:
<code xml>
...
...
<s:element name="BuscarAlumnoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="BuscarAlumnoResult">
<s:complexType>
<s:sequence>
<s:element name="alumnos" type="tns:Alumno" minOccurs="0" maxOccurs="unbounded" />
</s:sequence>
</s:complexType>
</s:element>
</s:sequence>
</s:complexType>
</s:element>

<s:complexType name="Alumno" >
<s:sequence>
<s:element name="legajo" type="s:string" minOccurs="0"/>
<s:element name="nombre" type="s:string" minOccurs="0"/>
<s:element name="apellido" type="s:string" minOccurs="0"/>
</s:sequence>
</s:complexType>
...
...
</code>
==== 2. Generar un XSLT ====
Generaremos un XSLT para transformar la respuesta del servicio .NET al nuevo WSDL que expondremos:
<code xml>
<?xml version="1.0" encoding="UTF-8" ?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:dosideas="http://dosideas.com/dataset">
<xsl:output method="xml" encoding="UTF-8" indent="yes"/>
<xsl:template match="*">
<xsl:for-each select="current()/*/*[2]/*">
<xsl:element name="dosideas:BuscarAlumnoResult" namespace="http://dosideas.com/dataset" >
<xsl:for-each select="current()/*">
<xsl:element name="dosideas:alumnos" namespace="http://dosideas.com/dataset">
<xsl:for-each select="current()/*">
<xsl:element name="dosideas:{local-name()}" namespace="http://dosideas.com/dataset">
<xsl:apply-templates/>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</code>
==== 3. Exponer el servicio en el Aqualogic Service Bus ====
Con los WSDL y XSLT generados, realizaremos los siguientes pasos:
3.1 Subir el WSDL del servicio .NET

3.2 Subir el nuevo WSDL del servicio.

3.3 Subir el XSLT para transformar la respuesta.

3.4 Crear un Business Service para consumir el servicio .NET

3.5 Crear un Proxy Service que consuma el Business Service y exponga el resultado según el nuevo contrato.

3.6 Configurar el Proxy Service (Message Flow) para modificar la respuesta del Business Service.

*3.6.1 Editar el Route que apunta al Business Service creado y en el Response Action, agregamos una acción de replace, donde:
**'''XPath:''' //dosideas:BuscarAlumnoResponse
**'''Expression:''' <EL XSLT>

*3.6.2 Al Proxy, agregarle un PipelinePair, con un Stage en el Response.
*3.6.3 En el Stage del Response:
**'''XPath:''' . (El carácter punto)
**'''Variable:''' body
**'''Expression:''' $body
**'''Replace entire node'''

== Ver también ==
* [[AquaLogic]]
* [http://www.bea.com/aqualogic/ Web oficial de AquaLogic]
* [[Spring Web Services]]

Consumir Web Service .NET con clientes Java mediante Aqualogic

2012-06-22T13:18:33Z

Shichibukai: /* Solución */

Consumir Web Service .NET con clientes Java mediante Aqualogic

2012-06-22T13:18:12Z

Shichibukai: /* Solución */

== Contexto ==
Consumir un Webservice realizado en .NET utilizando DataSet, a la cual no tenemos posibilidad de modificar el contrato (WSDL).

[[Archivo:consumirWS_NET_con_Java_contexto.jpg]]

En el WSDL, como respuesta de operación tenemos:
<code xml>
...
...
<s:element name="BuscarAlumnoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="BuscarAlumnoResult">
<s:complexType>
<s:sequence>
<s:element ref="s:schema" />
<s:any />
</s:sequence>
</s:complexType>
...
...
</code>
Cuando al consumir el WebService nos responde:
<code xml>
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:Locale="">
...
...
</xs:schema>
<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<NewDataSet xmlns="">
<Table diffgr:id="Table1" msdata:rowOrder="0">
<Legajo>123456</legajo>
<Nombre>Mickey</Nombre>
<Apellido>Mouse</Apellido>
</Table>
...
</NewDataSet>
</diffgr:diffgram>
...
...
</code>

== Problema ==
Si queremos consumir el WSDL desde un cliente java, al quere mapear el WSDL (por ejemplo con jaxb) nos dará el siguiente error:

'''[ERROR] undefined element declaration 's:schema' '''

=== Explicación ===
Observando el WSDL, podemos ver que al generar la clase que representan a la respuesta de la operación (BuscarAlumnoResponse), jaxb desconoce como resolver
<code xml>
<s:element ref="s:schema" />
<s:any />
</code>
Lo que nos esta diciendo el WSDL es que la operación buscarAlumno, tiene como respuesta un elemento schema y cualquier tipo de objeto como respuesta.
Como vemos en el contrato del servicio, no esta definido realmente el tipo de respuesta (no lo sabemos hasta el momento de ejecutar la operación) lo que nos dificulta la creación del cliente.

=== Solución ===
Una posible solución es utilizar un [[AquaLogic| Aqualogic Service Bus]], para consumir el webservice y exponerlo en un contrato amigable.

[[Archivo:consumirWS_NET_conJava_Solucion.jpg | 800px]]

En el Aqualogic, generaremos un proyecto en el cual business sea consumidor del webservice .NET y el proxy es en contrato que expondremos a los clientes Java, para esto último utilizaremos un XSLT para transformar la respuesta del webservice.

Los pasos serían:

==== 1. Definir el nuevo contrato de la operación a exponer ====
En nuestro caso solo modificaremos la respuesta de la operación:
<code xml>
...
...
<s:element name="BuscarAlumnoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="BuscarAlumnoResult">
<s:complexType>
<s:sequence>
<s:element name="alumnos" type="tns:Alumno" minOccurs="0" maxOccurs="unbounded" />
</s:sequence>
</s:complexType>
</s:element>
</s:sequence>
</s:complexType>
</s:element>

<s:complexType name="Alumno" >
<s:sequence>
<s:element name="legajo" type="s:string" minOccurs="0"/>
<s:element name="nombre" type="s:string" minOccurs="0"/>
<s:element name="apellido" type="s:string" minOccurs="0"/>
</s:sequence>
</s:complexType>
...
...
</code>
==== 2. Generar un XSLT ====
Generaremos un XSLT para transformar la respuesta del servicio .NET al nuevo WSDL que expondremos:
<code xml>
<?xml version="1.0" encoding="UTF-8" ?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:dosideas="http://dosideas.com/dataset">
<xsl:output method="xml" encoding="UTF-8" indent="yes"/>
<xsl:template match="*">
<xsl:for-each select="current()/*/*[2]/*">
<xsl:element name="dosideas:BuscarAlumnoResult" namespace="http://dosideas.com/dataset" >
<xsl:for-each select="current()/*">
<xsl:element name="dosideas:alumnos" namespace="http://dosideas.com/dataset">
<xsl:for-each select="current()/*">
<xsl:element name="dosideas:{local-name()}" namespace="http://dosideas.com/dataset">
<xsl:apply-templates/>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</code>
==== 3. Exponer el servicio en el Aqualogic Service Bus ====
Con los WSDL y XSLT generados, realizaremos los siguientes pasos:
3.1 Subir el WSDL del servicio .NET

3.2 Subir el nuevo WSDL del servicio.

3.3 Subir el XSLT para transformar la respuesta.

3.4 Crear un Business Service para consumir el servicio .NET

3.5 Crear un Proxy Service que consuma el Business Service y exponga el resultado según el nuevo contrato.

3.6 Configurar el Proxy Service (Message Flow) para modificar la respuesta del Business Service.

*3.6.1 Editar el Route que apunta al Business Service creado y en el Response Action, agregamos una acción de replace, donde:
**'''XPath:''' //dosideas:BuscarAlumnoResponse
**'''Expression:''' <EL XSLT>

*3.6.2 Al Proxy, agregarle un PipelinePair, con un Stage en el Response.
*3.6.3 En el Stage del Response:
**'''XPath:''' . (El carácter punto)
**'''Variable:''' body
**'''Expression:''' $body
**'''Replace entire node'''

== Ver también ==
* [[AquaLogic]]
* [http://www.bea.com/aqualogic/ Web oficial de AquaLogic]
* [[Spring Web Services]]

Archivo:ConsumirWS NET conJava Solucion.jpg

2012-06-22T13:16:53Z

Shichibukai: Solucion para consumir un WS en .Net con clientes Java utilizando un Aqualogic

Solucion para consumir un WS en .Net con clientes Java utilizando un Aqualogic

Consumir Web Service .NET con clientes Java mediante Aqualogic

2012-06-22T13:15:09Z

Shichibukai: /* Contexto */

== Contexto ==
Consumir un Webservice realizado en .NET utilizando DataSet, a la cual no tenemos posibilidad de modificar el contrato (WSDL).

[[Archivo:consumirWS_NET_con_Java_contexto.jpg]]

En el WSDL, como respuesta de operación tenemos:
<code xml>
...
...
<s:element name="BuscarAlumnoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="BuscarAlumnoResult">
<s:complexType>
<s:sequence>
<s:element ref="s:schema" />
<s:any />
</s:sequence>
</s:complexType>
...
...
</code>
Cuando al consumir el WebService nos responde:
<code xml>
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:Locale="">
...
...
</xs:schema>
<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<NewDataSet xmlns="">
<Table diffgr:id="Table1" msdata:rowOrder="0">
<Legajo>123456</legajo>
<Nombre>Mickey</Nombre>
<Apellido>Mouse</Apellido>
</Table>
...
</NewDataSet>
</diffgr:diffgram>
...
...
</code>

== Problema ==
Si queremos consumir el WSDL desde un cliente java, al quere mapear el WSDL (por ejemplo con jaxb) nos dará el siguiente error:

'''[ERROR] undefined element declaration 's:schema' '''

=== Explicación ===
Observando el WSDL, podemos ver que al generar la clase que representan a la respuesta de la operación (BuscarAlumnoResponse), jaxb desconoce como resolver
<code xml>
<s:element ref="s:schema" />
<s:any />
</code>
Lo que nos esta diciendo el WSDL es que la operación buscarAlumno, tiene como respuesta un elemento schema y cualquier tipo de objeto como respuesta.
Como vemos en el contrato del servicio, no esta definido realmente el tipo de respuesta (no lo sabemos hasta el momento de ejecutar la operación) lo que nos dificulta la creación del cliente.

=== Solución ===
Una posible solución es utilizar un [[AquaLogic| Aqualogic Service Bus]], para consumir el webservice y exponerlo en un contrato amigable.

En el Aqualogic, generaremos un proyecto en el cual business sea consumidor del webservice .NET y el proxy es en contrato que expondremos a los clientes Java, para esto último utilizaremos un XSLT para transformar la respuesta del webservice.

Los pasos serían:

==== 1. Definir el nuevo contrato de la operación a exponer ====
En nuestro caso solo modificaremos la respuesta de la operación:
<code xml>
...
...
<s:element name="BuscarAlumnoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="BuscarAlumnoResult">
<s:complexType>
<s:sequence>
<s:element name="alumnos" type="tns:Alumno" minOccurs="0" maxOccurs="unbounded" />
</s:sequence>
</s:complexType>
</s:element>
</s:sequence>
</s:complexType>
</s:element>

<s:complexType name="Alumno" >
<s:sequence>
<s:element name="legajo" type="s:string" minOccurs="0"/>
<s:element name="nombre" type="s:string" minOccurs="0"/>
<s:element name="apellido" type="s:string" minOccurs="0"/>
</s:sequence>
</s:complexType>
...
...
</code>
==== 2. Generar un XSLT ====
Generaremos un XSLT para transformar la respuesta del servicio .NET al nuevo WSDL que expondremos:
<code xml>
<?xml version="1.0" encoding="UTF-8" ?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:dosideas="http://dosideas.com/dataset">
<xsl:output method="xml" encoding="UTF-8" indent="yes"/>
<xsl:template match="*">
<xsl:for-each select="current()/*/*[2]/*">
<xsl:element name="dosideas:BuscarAlumnoResult" namespace="http://dosideas.com/dataset" >
<xsl:for-each select="current()/*">
<xsl:element name="dosideas:alumnos" namespace="http://dosideas.com/dataset">
<xsl:for-each select="current()/*">
<xsl:element name="dosideas:{local-name()}" namespace="http://dosideas.com/dataset">
<xsl:apply-templates/>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</code>
==== 3. Exponer el servicio en el Aqualogic Service Bus ====
Con los WSDL y XSLT generados, realizaremos los siguientes pasos:
3.1 Subir el WSDL del servicio .NET

3.2 Subir el nuevo WSDL del servicio.

3.3 Subir el XSLT para transformar la respuesta.

3.4 Crear un Business Service para consumir el servicio .NET

3.5 Crear un Proxy Service que consuma el Business Service y exponga el resultado según el nuevo contrato.

3.6 Configurar el Proxy Service (Message Flow) para modificar la respuesta del Business Service.

*3.6.1 Editar el Route que apunta al Business Service creado y en el Response Action, agregamos una acción de replace, donde:
**'''XPath:''' //dosideas:BuscarAlumnoResponse
**'''Expression:''' <EL XSLT>

*3.6.2 Al Proxy, agregarle un PipelinePair, con un Stage en el Response.
*3.6.3 En el Stage del Response:
**'''XPath:''' . (El carácter punto)
**'''Variable:''' body
**'''Expression:''' $body
**'''Replace entire node'''

== Ver también ==
* [[AquaLogic]]
* [http://www.bea.com/aqualogic/ Web oficial de AquaLogic]
* [[Spring Web Services]]

Archivo:ConsumirWS NET con Java contexto.jpg

2012-06-22T13:14:28Z

Shichibukai: Consumir un Webservice realizado en .NET utilizando DataSet, a la cual no tenemos posibilidad de modificar el contrato (WSDL).

Consumir un Webservice realizado en .NET utilizando DataSet, a la cual no tenemos posibilidad de modificar el contrato (WSDL).

Consumir Web Service .NET con clientes Java mediante Aqualogic

2012-06-22T13:02:08Z

Shichibukai: /* Problema */

== Contexto ==
Consumir un Webservice realizado en .NET utilizando DataSet, a la cual no tenemos posibilidad de modificar el contrato (WSDL).
En el WSDL, como respuesta de operación tenemos:
<code xml>
...
...
<s:element name="BuscarAlumnoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="BuscarAlumnoResult">
<s:complexType>
<s:sequence>
<s:element ref="s:schema" />
<s:any />
</s:sequence>
</s:complexType>
...
...
</code>
Cuando al consumir el WebService nos responde:
<code xml>
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:Locale="">
...
...
</xs:schema>
<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<NewDataSet xmlns="">
<Table diffgr:id="Table1" msdata:rowOrder="0">
<Legajo>123456</legajo>
<Nombre>Mickey</Nombre>
<Apellido>Mouse</Apellido>
</Table>
...
</NewDataSet>
</diffgr:diffgram>
...
...
</code>
== Problema ==
Si queremos consumir el WSDL desde un cliente java, al quere mapear el WSDL (por ejemplo con jaxb) nos dará el siguiente error:

'''[ERROR] undefined element declaration 's:schema' '''

=== Explicación ===
Observando el WSDL, podemos ver que al generar la clase que representan a la respuesta de la operación (BuscarAlumnoResponse), jaxb desconoce como resolver
<code xml>
<s:element ref="s:schema" />
<s:any />
</code>
Lo que nos esta diciendo el WSDL es que la operación buscarAlumno, tiene como respuesta un elemento schema y cualquier tipo de objeto como respuesta.
Como vemos en el contrato del servicio, no esta definido realmente el tipo de respuesta (no lo sabemos hasta el momento de ejecutar la operación) lo que nos dificulta la creación del cliente.

=== Solución ===
Una posible solución es utilizar un [[AquaLogic| Aqualogic Service Bus]], para consumir el webservice y exponerlo en un contrato amigable.

En el Aqualogic, generaremos un proyecto en el cual business sea consumidor del webservice .NET y el proxy es en contrato que expondremos a los clientes Java, para esto último utilizaremos un XSLT para transformar la respuesta del webservice.

Los pasos serían:

==== 1. Definir el nuevo contrato de la operación a exponer ====
En nuestro caso solo modificaremos la respuesta de la operación:
<code xml>
...
...
<s:element name="BuscarAlumnoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="BuscarAlumnoResult">
<s:complexType>
<s:sequence>
<s:element name="alumnos" type="tns:Alumno" minOccurs="0" maxOccurs="unbounded" />
</s:sequence>
</s:complexType>
</s:element>
</s:sequence>
</s:complexType>
</s:element>

<s:complexType name="Alumno" >
<s:sequence>
<s:element name="legajo" type="s:string" minOccurs="0"/>
<s:element name="nombre" type="s:string" minOccurs="0"/>
<s:element name="apellido" type="s:string" minOccurs="0"/>
</s:sequence>
</s:complexType>
...
...
</code>
==== 2. Generar un XSLT ====
Generaremos un XSLT para transformar la respuesta del servicio .NET al nuevo WSDL que expondremos:
<code xml>
<?xml version="1.0" encoding="UTF-8" ?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:dosideas="http://dosideas.com/dataset">
<xsl:output method="xml" encoding="UTF-8" indent="yes"/>
<xsl:template match="*">
<xsl:for-each select="current()/*/*[2]/*">
<xsl:element name="dosideas:BuscarAlumnoResult" namespace="http://dosideas.com/dataset" >
<xsl:for-each select="current()/*">
<xsl:element name="dosideas:alumnos" namespace="http://dosideas.com/dataset">
<xsl:for-each select="current()/*">
<xsl:element name="dosideas:{local-name()}" namespace="http://dosideas.com/dataset">
<xsl:apply-templates/>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</code>
==== 3. Exponer el servicio en el Aqualogic Service Bus ====
Con los WSDL y XSLT generados, realizaremos los siguientes pasos:
3.1 Subir el WSDL del servicio .NET

3.2 Subir el nuevo WSDL del servicio.

3.3 Subir el XSLT para transformar la respuesta.

3.4 Crear un Business Service para consumir el servicio .NET

3.5 Crear un Proxy Service que consuma el Business Service y exponga el resultado según el nuevo contrato.

3.6 Configurar el Proxy Service (Message Flow) para modificar la respuesta del Business Service.

*3.6.1 Editar el Route que apunta al Business Service creado y en el Response Action, agregamos una acción de replace, donde:
**'''XPath:''' //dosideas:BuscarAlumnoResponse
**'''Expression:''' <EL XSLT>

*3.6.2 Al Proxy, agregarle un PipelinePair, con un Stage en el Response.
*3.6.3 En el Stage del Response:
**'''XPath:''' . (El carácter punto)
**'''Variable:''' body
**'''Expression:''' $body
**'''Replace entire node'''

== Ver también ==
* [[AquaLogic]]
* [http://www.bea.com/aqualogic/ Web oficial de AquaLogic]
* [[Spring Web Services]]

Consumir Web Service .NET con clientes Java mediante Aqualogic

2012-06-22T12:50:13Z

Shichibukai: /* 3. Exponer el servicio en el Aqualogic Service Bus */

== Contexto ==
Consumir un Webservice realizado en .NET utilizando DataSet, a la cual no tenemos posibilidad de modificar el contrato (WSDL).
En el WSDL, como respuesta de operación tenemos:
<code xml>
...
...
<s:element name="BuscarAlumnoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="BuscarAlumnoResult">
<s:complexType>
<s:sequence>
<s:element ref="s:schema" />
<s:any />
</s:sequence>
</s:complexType>
...
...
</code>
Cuando al consumir el WebService nos responde:
<code xml>
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:Locale="">
...
...
</xs:schema>
<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<NewDataSet xmlns="">
<Table diffgr:id="Table1" msdata:rowOrder="0">
<Legajo>123456</legajo>
<Nombre>Mickey</Nombre>
<Apellido>Mouse</Apellido>
</Table>
...
</NewDataSet>
</diffgr:diffgram>
...
...
</code>
== Problema ==
Si queremos consumir el WSDL desde un cliente java, al quere mapear el WSDL (por ejemplo con jaxb) nos dará el siguiente error:
[ERROR] undefined element declaration 's:schema'

=== Explicación ===
Observando el WSDL, podemos ver que al generar la clase que representan a la respuesta de la operación (BuscarAlumnoResponse), jaxb desconoce como resolver
<code xml>
<s:element ref="s:schema" />
<s:any />
</code>
Lo que nos esta diciendo el WSDL es que la operación buscarAlumno, tiene como respuesta un elemento schema y cualquier tipo de objeto como respuesta.
Como vemos en el contrato del servicio, no esta definido realmente el tipo de respuesta (no lo sabemos hasta el momento de ejecutar la operación) lo que nos dificulta la creación del cliente.

=== Solución ===
Una posible solución es utilizar un [[AquaLogic| Aqualogic Service Bus]], para consumir el webservice y exponerlo en un contrato amigable.

En el Aqualogic, generaremos un proyecto en el cual business sea consumidor del webservice .NET y el proxy es en contrato que expondremos a los clientes Java, para esto último utilizaremos un XSLT para transformar la respuesta del webservice.

Los pasos serían:

==== 1. Definir el nuevo contrato de la operación a exponer ====
En nuestro caso solo modificaremos la respuesta de la operación:
<code xml>
...
...
<s:element name="BuscarAlumnoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="BuscarAlumnoResult">
<s:complexType>
<s:sequence>
<s:element name="alumnos" type="tns:Alumno" minOccurs="0" maxOccurs="unbounded" />
</s:sequence>
</s:complexType>
</s:element>
</s:sequence>
</s:complexType>
</s:element>

<s:complexType name="Alumno" >
<s:sequence>
<s:element name="legajo" type="s:string" minOccurs="0"/>
<s:element name="nombre" type="s:string" minOccurs="0"/>
<s:element name="apellido" type="s:string" minOccurs="0"/>
</s:sequence>
</s:complexType>
...
...
</code>
==== 2. Generar un XSLT ====
Generaremos un XSLT para transformar la respuesta del servicio .NET al nuevo WSDL que expondremos:
<code xml>
<?xml version="1.0" encoding="UTF-8" ?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:dosideas="http://dosideas.com/dataset">
<xsl:output method="xml" encoding="UTF-8" indent="yes"/>
<xsl:template match="*">
<xsl:for-each select="current()/*/*[2]/*">
<xsl:element name="dosideas:BuscarAlumnoResult" namespace="http://dosideas.com/dataset" >
<xsl:for-each select="current()/*">
<xsl:element name="dosideas:alumnos" namespace="http://dosideas.com/dataset">
<xsl:for-each select="current()/*">
<xsl:element name="dosideas:{local-name()}" namespace="http://dosideas.com/dataset">
<xsl:apply-templates/>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</code>
==== 3. Exponer el servicio en el Aqualogic Service Bus ====
Con los WSDL y XSLT generados, realizaremos los siguientes pasos:
3.1 Subir el WSDL del servicio .NET

3.2 Subir el nuevo WSDL del servicio.

3.3 Subir el XSLT para transformar la respuesta.

3.4 Crear un Business Service para consumir el servicio .NET

3.5 Crear un Proxy Service que consuma el Business Service y exponga el resultado según el nuevo contrato.

3.6 Configurar el Proxy Service (Message Flow) para modificar la respuesta del Business Service.

*3.6.1 Editar el Route que apunta al Business Service creado y en el Response Action, agregamos una acción de replace, donde:
**'''XPath:''' //dosideas:BuscarAlumnoResponse
**'''Expression:''' <EL XSLT>

*3.6.2 Al Proxy, agregarle un PipelinePair, con un Stage en el Response.
*3.6.3 En el Stage del Response:
**'''XPath:''' . (El carácter punto)
**'''Variable:''' body
**'''Expression:''' $body
**'''Replace entire node'''

== Ver también ==
* [[AquaLogic]]
* [http://www.bea.com/aqualogic/ Web oficial de AquaLogic]
* [[Spring Web Services]]

Consumir Web Service .NET con clientes Java mediante Aqualogic

2012-06-22T12:49:54Z

Shichibukai: /* 3. Exponer el servicio en el Aqualogic Service Bus */

== Contexto ==
Consumir un Webservice realizado en .NET utilizando DataSet, a la cual no tenemos posibilidad de modificar el contrato (WSDL).
En el WSDL, como respuesta de operación tenemos:
<code xml>
...
...
<s:element name="BuscarAlumnoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="BuscarAlumnoResult">
<s:complexType>
<s:sequence>
<s:element ref="s:schema" />
<s:any />
</s:sequence>
</s:complexType>
...
...
</code>
Cuando al consumir el WebService nos responde:
<code xml>
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:Locale="">
...
...
</xs:schema>
<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<NewDataSet xmlns="">
<Table diffgr:id="Table1" msdata:rowOrder="0">
<Legajo>123456</legajo>
<Nombre>Mickey</Nombre>
<Apellido>Mouse</Apellido>
</Table>
...
</NewDataSet>
</diffgr:diffgram>
...
...
</code>
== Problema ==
Si queremos consumir el WSDL desde un cliente java, al quere mapear el WSDL (por ejemplo con jaxb) nos dará el siguiente error:
[ERROR] undefined element declaration 's:schema'

=== Explicación ===
Observando el WSDL, podemos ver que al generar la clase que representan a la respuesta de la operación (BuscarAlumnoResponse), jaxb desconoce como resolver
<code xml>
<s:element ref="s:schema" />
<s:any />
</code>
Lo que nos esta diciendo el WSDL es que la operación buscarAlumno, tiene como respuesta un elemento schema y cualquier tipo de objeto como respuesta.
Como vemos en el contrato del servicio, no esta definido realmente el tipo de respuesta (no lo sabemos hasta el momento de ejecutar la operación) lo que nos dificulta la creación del cliente.

=== Solución ===
Una posible solución es utilizar un [[AquaLogic| Aqualogic Service Bus]], para consumir el webservice y exponerlo en un contrato amigable.

En el Aqualogic, generaremos un proyecto en el cual business sea consumidor del webservice .NET y el proxy es en contrato que expondremos a los clientes Java, para esto último utilizaremos un XSLT para transformar la respuesta del webservice.

Los pasos serían:

==== 1. Definir el nuevo contrato de la operación a exponer ====
En nuestro caso solo modificaremos la respuesta de la operación:
<code xml>
...
...
<s:element name="BuscarAlumnoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="BuscarAlumnoResult">
<s:complexType>
<s:sequence>
<s:element name="alumnos" type="tns:Alumno" minOccurs="0" maxOccurs="unbounded" />
</s:sequence>
</s:complexType>
</s:element>
</s:sequence>
</s:complexType>
</s:element>

<s:complexType name="Alumno" >
<s:sequence>
<s:element name="legajo" type="s:string" minOccurs="0"/>
<s:element name="nombre" type="s:string" minOccurs="0"/>
<s:element name="apellido" type="s:string" minOccurs="0"/>
</s:sequence>
</s:complexType>
...
...
</code>
==== 2. Generar un XSLT ====
Generaremos un XSLT para transformar la respuesta del servicio .NET al nuevo WSDL que expondremos:
<code xml>
<?xml version="1.0" encoding="UTF-8" ?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:dosideas="http://dosideas.com/dataset">
<xsl:output method="xml" encoding="UTF-8" indent="yes"/>
<xsl:template match="*">
<xsl:for-each select="current()/*/*[2]/*">
<xsl:element name="dosideas:BuscarAlumnoResult" namespace="http://dosideas.com/dataset" >
<xsl:for-each select="current()/*">
<xsl:element name="dosideas:alumnos" namespace="http://dosideas.com/dataset">
<xsl:for-each select="current()/*">
<xsl:element name="dosideas:{local-name()}" namespace="http://dosideas.com/dataset">
<xsl:apply-templates/>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</code>
==== 3. Exponer el servicio en el Aqualogic Service Bus ====
Con los WSDL y XSLT generados, realizaremos los siguientes pasos:
3.1 Subir el WSDL del servicio .NET
3.2 Subir el nuevo WSDL del servicio.
3.3 Subir el XSLT para transformar la respuesta.
3.4 Crear un Business Service para consumir el servicio .NET
3.5 Crear un Proxy Service que consuma el Business Service y exponga el resultado según el nuevo contrato.
3.6 Configurar el Proxy Service (Message Flow) para modificar la respuesta del Business Service.

*3.6.1 Editar el Route que apunta al Business Service creado y en el Response Action, agregamos una acción de replace, donde:
**'''XPath:''' //dosideas:BuscarAlumnoResponse
**'''Expression:''' <EL XSLT>

*3.6.2 Al Proxy, agregarle un PipelinePair, con un Stage en el Response.
*3.6.3 En el Stage del Response:
**'''XPath:''' . (El carácter punto)
**'''Variable:''' body
**'''Expression:''' $body
**'''Replace entire node'''

== Ver también ==
* [[AquaLogic]]
* [http://www.bea.com/aqualogic/ Web oficial de AquaLogic]
* [[Spring Web Services]]

Consumir Web Service .NET con clientes Java mediante Aqualogic

2012-06-22T12:48:39Z

Shichibukai: Página creada con '== Contexto == Consumir un Webservice realizado en .NET utilizando DataSet, a la cual no tenemos posibilidad de modificar el contrato (WSDL). En el WSDL, como respuesta de opera…'

== Contexto ==
Consumir un Webservice realizado en .NET utilizando DataSet, a la cual no tenemos posibilidad de modificar el contrato (WSDL).
En el WSDL, como respuesta de operación tenemos:
<code xml>
...
...
<s:element name="BuscarAlumnoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="BuscarAlumnoResult">
<s:complexType>
<s:sequence>
<s:element ref="s:schema" />
<s:any />
</s:sequence>
</s:complexType>
...
...
</code>
Cuando al consumir el WebService nos responde:
<code xml>
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:Locale="">
...
...
</xs:schema>
<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<NewDataSet xmlns="">
<Table diffgr:id="Table1" msdata:rowOrder="0">
<Legajo>123456</legajo>
<Nombre>Mickey</Nombre>
<Apellido>Mouse</Apellido>
</Table>
...
</NewDataSet>
</diffgr:diffgram>
...
...
</code>
== Problema ==
Si queremos consumir el WSDL desde un cliente java, al quere mapear el WSDL (por ejemplo con jaxb) nos dará el siguiente error:
[ERROR] undefined element declaration 's:schema'

=== Explicación ===
Observando el WSDL, podemos ver que al generar la clase que representan a la respuesta de la operación (BuscarAlumnoResponse), jaxb desconoce como resolver
<code xml>
<s:element ref="s:schema" />
<s:any />
</code>
Lo que nos esta diciendo el WSDL es que la operación buscarAlumno, tiene como respuesta un elemento schema y cualquier tipo de objeto como respuesta.
Como vemos en el contrato del servicio, no esta definido realmente el tipo de respuesta (no lo sabemos hasta el momento de ejecutar la operación) lo que nos dificulta la creación del cliente.

=== Solución ===
Una posible solución es utilizar un [[AquaLogic| Aqualogic Service Bus]], para consumir el webservice y exponerlo en un contrato amigable.

En el Aqualogic, generaremos un proyecto en el cual business sea consumidor del webservice .NET y el proxy es en contrato que expondremos a los clientes Java, para esto último utilizaremos un XSLT para transformar la respuesta del webservice.

Los pasos serían:

==== 1. Definir el nuevo contrato de la operación a exponer ====
En nuestro caso solo modificaremos la respuesta de la operación:
<code xml>
...
...
<s:element name="BuscarAlumnoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="BuscarAlumnoResult">
<s:complexType>
<s:sequence>
<s:element name="alumnos" type="tns:Alumno" minOccurs="0" maxOccurs="unbounded" />
</s:sequence>
</s:complexType>
</s:element>
</s:sequence>
</s:complexType>
</s:element>

<s:complexType name="Alumno" >
<s:sequence>
<s:element name="legajo" type="s:string" minOccurs="0"/>
<s:element name="nombre" type="s:string" minOccurs="0"/>
<s:element name="apellido" type="s:string" minOccurs="0"/>
</s:sequence>
</s:complexType>
...
...
</code>
==== 2. Generar un XSLT ====
Generaremos un XSLT para transformar la respuesta del servicio .NET al nuevo WSDL que expondremos:
<code xml>
<?xml version="1.0" encoding="UTF-8" ?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:dosideas="http://dosideas.com/dataset">
<xsl:output method="xml" encoding="UTF-8" indent="yes"/>
<xsl:template match="*">
<xsl:for-each select="current()/*/*[2]/*">
<xsl:element name="dosideas:BuscarAlumnoResult" namespace="http://dosideas.com/dataset" >
<xsl:for-each select="current()/*">
<xsl:element name="dosideas:alumnos" namespace="http://dosideas.com/dataset">
<xsl:for-each select="current()/*">
<xsl:element name="dosideas:{local-name()}" namespace="http://dosideas.com/dataset">
<xsl:apply-templates/>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</code>
==== 3. Exponer el servicio en el Aqualogic Service Bus ====
Con los WSDL y XSLT generados, realizaremos los siguientes pasos:
3.1 Subir el WSDL del servicio .NET

3.2 Subir el nuevo WSDL del servicio.

3.3 Subir el XSLT para transformar la respuesta.

3.4 Crear un Business Service para consumir el servicio .NET

3.5 Crear un Proxy Service que consuma el Business Service y exponga el resultado según el nuevo contrato.

3.6 Configurar el Proxy Service (Message Flow) para modificar la respuesta del Business Service.

*3.6.1 Editar el Route que apunta al Business Service creado y en el Response Action, agregamos una acción de replace, donde:
'''XPath:''' //dosideas:BuscarAlumnoResponse
'''Expression:''' <EL XSLT>

*3.6.2 Al Proxy, agregarle un PipelinePair, con un Stage en el Response.
*3.6.3 En el Stage del Response:
**'''XPath:''' . (El carácter punto)
**'''Variable:''' body
**'''Expression:''' $body
**'''Replace entire node'''

== Ver también ==
* [[AquaLogic]]
* [http://www.bea.com/aqualogic/ Web oficial de AquaLogic]
* [[Spring Web Services]]

AquaLogic

2012-06-22T12:22:09Z

Shichibukai: /* Ver también */

[[Category:AquaLogic]]
AquaLogic es una suite de software de BEA Systems, orientada a administrar una Arquitectura Orientada a Servicios (SOA).

AquaLogic incluye los siguientes productos:
* AquaLogic [[BPM]]: herramientas para la Administración de Procesos de Negocios (BPM).
* Aqualogic User Interaction: herramientas para la creación de portales, comunidades colaborativas, aplicaciones compuestas, y otras aplicaciones que usan una arquitectura de servicios.
* AquaLogic Enterprise Repository, administra los meta-datos de cualquier software, como procesos de negocio, [[Web Service]], patrones, frameworks, aplicaciones y componentes. Muestra las relaciones e interdependencias entre ellos.
* AquaLogic Service Bus (actualmente conocido como Oracle Service Bus), es un Enterprise Service Bus (ESB). Permite la interacción entre servicios, transformaciones y más.
* AquaLogic Data Services Platform, brinda herramientas para crear y administrar distintos servicios de datos. Utiliza el lenguaje [[XQuery]] para componer datos y transformarlos entre varios orígenes de datos, incluyendo [[Base De Datos]] relaciones y [[Web Service]].

== Ver también ==
* [[WebLogic]]
* [[Colas De Mensajes Con AquaLogic]]
* [[Consumir Web Service .NET con clientes Java mediante Aqualogic]]
* [http://www.bea.com/aqualogic/ Web oficial de AquaLogic]

BEA Aqualogic BPM 5.7 (Fuego)

2012-01-06T11:58:24Z

Shichibukai: /* Creamos la conexión al FDI */

===Comunicando con Base de Datos con PBL (Process Business Language)===

Para ejecutar comandos SQL en Aqualogic BPM 5.7 hay que seguir los siguientes pasos:

====Primer paso====

Se debe crear nuevo "External Resource", haciendo click derecho en el directorio del proyecto "External Resources", del tipo "SQL Database". Los campos se deben completar con la información de la base de datos que queremos consultar y con un nombre significativo.

====Segundo paso====

Se debe crear un nuevo "BPM Object", haciendo click derecho sobre el modulo deseado en el directorio de "Catalog", y luego crear un método en nuestro objeto, haciendo click derecho sobre el objeto y seleccionando la opción "New Method". Ahora se debe editar el nuevo método, expandiendo el objeto bpm y haciendo doble click sobre el nombre del método creado. Ahora podemos editarlo e incluir el código necesario para comunicarnos con la BD a través de una clase propia de Fuego, un ejemplo de implementación puede ser el siguiente:

<code java>
String queryAEjecutar ="SELECT campo1, campo2, campo3 FROM nombreTabla WHERE nombreColumna in (?,?)";

String nombreDeLaBDCreada = "NombreBD";

String[] arrayDeParametros = {"valor1", "valor2"};

Iterator <Any[Any]> iterator = DynamicSQL.executeQuery(sentence : queryAEjecutar, implname : nombreDeLaBDCreada, inParameters : arrayDeParametros);
</code>

Como se puede observar, el resultado de realizar la consulta va a ser un iterador, que luego puede ser recorrido con un "foreach".

<code java>
foreach (e in iterator) {

logMessage("campo1: "+e["campo1"], severity : INFO);

logMessage("campo2: "+e["campo2"], severity : INFO);

logMessage("campo3: "+e["campo3"], severity : INFO);

logMessage("nombreColumna: "+e["nombreColumna"], severity : INFO);

}
</code>

=== Versionando con CVS ===
El producto Aqualogic BPM 5.7 incluye un cliente de CVS que permite agregar, remover, actualizar en un repositorio CVS.

==== Configurar el cliente CVS ====
* Levantar el Studio BPM.
* File -> Preference ->Default Version Control
** Version Control Manger: CVS
** Host: host del servidor CVS
** User Name: usuario del CVS
** User Password: password del usuario CVS
** path: ruta dentro del repositorio donde se guardará el proyecto.

==== Subir el proyecto al CVS ====
* Levantar el Studio BPM.
* Abrir el proyecto a versionar.
* File -> Project Preference -> Project Version Control.
** Version Control Manager: CVS (nos carga la información ingresada en el punto anterior).
* File -> VCS -> Store project in repository
** Path: directorio en el que se creará el proyecto en el repositorio.
** Si es la primera vez que se sube un proyecto de Aqualogic BPM, pedirá que se ingrese la ruta del directorio donde se creará el "common catalog"
*** Common catalog: Es un catalogo de componente, el cual puede ser compartido por otros proyectos de Aqualogic BPM.
En el repositorio quedarán creados 2 directorios, el del proyecto y el del common catalog, ademas se crearán 2 alias en el CVS que apuntan al proyecto y al common catalog.

==== Obtener el proyecto del CVS ====
* Levantar el Studio BPM.
* File -> Project Preference -> Project Version Control.
* File -> Import -> Project -> from Repository.
** Version Control Manager: CVS
** En la siguiente pantalla, seleccionar el proyecto del repositorio.

==== Trabajar con proyectos versionados ====
Aqualogic BPM 5.7, posee una política restrictiva de edición para los proyecto versionados.
La política, consiste en que todo el proyecto se encuentra en modo lectura y solo un usuario puede editar un determinado archivo versionado (Ej.: un proceso).
===== Editar un procesos =====
* Seleccionar el proceso a editar.
* Menú contextual -> VCS -> edit.
Esto habilita al usuario a modificar el proceso. En caso de que exitiera otro usuario modificando el proceso nos aparecerá un mensaje de error.

===== Grabar los cambios realizados en un proceso =====
* Seleccionar el proceso que se esta editando.
* Menú contextual -> VCS -> commit.
Este paso es importante, debido a que si se libera la edición del proceso sin realizar el commit se perderán los cambios.

===== Liberar la edición del proceso =====
* Seleccionar el proceso que se esta editando.
* Menú contextual -> VCS -> unedit.

===Pasaje de Parametros===

Para pasar parámetros al proceso desde una actividad de creación (aquellas que dan inicio al proceso) que tenga asociada un ScreenFlow, hay que seguir los siguientes pasos.

El primer paso es decirle al proceso que va a recibir parametros de la siguiente manera:

* Doble click en la tarea "begin" y luego en "Argument Mapping"
[[Archivo:Imagen 1.jpg]]
* Click en el botón que parece una flecha violeta hacia abajo y ahí agregamos el nombre del parametro que va a recibir. Es recomendable utilizar nombres descriptivos ya que sino se puede volver bastante confuso.
[[Archivo:Imagen 2.jpg]]
* Ahora lo único que falta es mapear el parámetro a una variable del proceso (puede ser creada en la misma pantalla haciendo click sobre el botón que está al lado del de crear parametros)
[[Archivo:Imagen 3.jpg]]

El segundo paso es realizar un proceso similar al primer paso, con la diferencia que debe hacerce en la tarea "end" del ScreenFlow asociado a la actividad de creación.

El tercer paso es mapear las salidas del ScreenFlow con las Entradas del proceso de la siguiente manera:

* Doble click en la actividad que tiene asociada el ScreenFlow, luego en "Argument Mapping" y luego en la barra de la izquiera seleccionar "NombreDelScreenFlow Out"
[[Archivo:Imagen 4.jpg]]
* Luego solo basta con mapear los argumentos, seleccionando los nombres
[[Archivo:Imagen 5.jpg]]

===Incluir un jar y utilizarlo===
Una vez que tenemos creado nuestro proyecto BPM podemos llegar a necesitar utilizar ciertas clases de java, tanto para modelar entidades como para invocar servicios externos a nuestro proyecto.

En el caso que necesitemos incluír alguna librería al proyecto BPM los pasos a realizar son los siguientes:

* En "Recursos externos" hacer botón derecho y seleccionar la opción "Nuevo recurso externo".
* Seleccionar un nombre y en tipo seleccionar "Biblioteca de clase Java".
* Le damos clic al botón "Agregar" y buscamos el jar correspondiente que vamos a querer incluír.
* Aceptar.

Finalizado estos pasos vamos a ver que se agregó a "Recursos externos" la librería que acabamos de incluir. Lo siguiente va a ser crear un módulo desde el cual invocar a las clases de nuestro jar. Para esto tenemos que hacer lo siguiente:

* En "Catálogo" hacemos botón derecho y seleccionamos la opción "Crear módulo".
* Le ponemos un nombre y le damos Aceptar.
* Realizado esto, veremos que se agregó un módulo al Catálogo. Lo que tenemos que hacer ahora es indicarle a ese módulo que contenga la configuración de nuestro jar. Para esto hacemos clic derecho sobre el módulo > Componente de catálogo > Java.
* Seleccionamos la opción "Usar una configuración existente" (está marcada por defecto) y en el combo seleccionamos nuestro recurso externo que agregamos antes.
* Luego, seleccionaremos las clases Java que quiero incluír en mi módulo.
* Se hará la carga de clases automáticamente.
* Finalizado esto deberíamos ver dentro de "Catálogo" nuestro módulo nuevo y al amplicar su contenido ver el árbol de las clases que incluímos en él.

Para poder usar estas clases que incluímos, dentro de una actividad se podrán crear instancias de esta forma:

<code java>ClaseDeMiBiblioteca instancia = new ClaseDeMiBiblioteca();</code>

e invocar a sus métodos de esta forma:

<code java>ObjetoRespuesta respuesta = (ObjetoRespuesta) instancia.metodo(arg1 : parametroAEnviar);</code>

===Tratamiento de excepciones de servicios externos===
Puede suceder que, al momento de invocar algún servicio externo a nuestro proyecto de BPM, este retorne como respuesta una excepción. Para poder darle un comportamiento a nuestro proceso en BPM se puede utilizar una transición del tipo "Excepción" entre dos actividades.

Para dar un ejemplo concreto vamos a imaginarnos 2 actividades a las que llamaremos "Inicio" y "Comportamiento correcto". La actividad "Inicio" invocará a un servicio, y si sale todo bien, se pasará luego a la actividad "Comportamiento correcto".

[[Archivo:1.jpg]]

Ahora, puede suceder que cuando "Inicio" invoca al servicio, éste devuelva una Excepción. ¿Qué hacemos en ese caso? Creamos una actividad (en nuestro ejemplo es "Comportamiento excepción"), la cual nuestro sistema ejecutará en caso de que el servicio falle, y le asociamos una transición entre "Inicio" y esta nueva actividad de esta forma:

[[Archivo:2.jpg]]

Para crear dicha transición, debemos crear la actividad a la cual asociarla, dale doble clic y luego seleccionar como tipo de transición aquella que dice "Excepción". Para indicarle para qué tipo de Excepción queremos que se siga dicho flujo, en "Nombre de excepción" deberemos cargar la clase con la excepción que puede llegar.

Si queremos obtener el mensaje de la excepción, podemos utilizar la variable predefinida por BPM '''lastException''' en la cual se guarda la ultima excepción ocurrida en la instancia.

===Creación de Instancias mediante PBL===
Para crear instancias de procesos mediante PBL se utiliza el siguiente código:
<code java>
logMessage("DOS_IDEAS: Creando la instancia ConsumidorProceso", severity : Severity.DEBUG);

String mensaje = "Este es un mensaje creado por el productor a las " + 'now';
ProcessInstance.create(processId : ProcessInstance.organization + "/" + ProcessInstance.organizationalUnit + "/ConsumidorProceso",
arguments : { "mensaje_InArgument" : mensaje }, argumentsSetName : "BeginIn");
</code>
Donde:
* '''processId''' es el identificador (no el nombre) del proceso que queremos crear, en nuestro caso vamos a crear el proceso "ConsumidorProceso".
* '''arguments''' es el array de argumentos de entrada que se definio en el proceso.

En el siguiente link podemos descargarnos un ejemplo del svn:
[https://dosideas-aplicaciones-modelo.googlecode.com/svn/BPM_Ejemplos/trunk/CrearInstanciaConPBL.fpr.exp Crear Instancia mediante PBL]

===Manipulación de Instancias mediante PAPI===
Aqualogic BPM 5.7, provee una API para trabajar con el FDI. Esta API se la conoce como PAPI.
Una de las cosas que nos permite realizar es obtener una instancia de BPM y manipular dicha instancia.
En el siguiente link podemos descargarnos un ejemplo del svn: [https://dosideas-aplicaciones-modelo.googlecode.com/svn/BPM_Ejemplos/trunk/ManipularInstancias.fpr.exp Manipular instancia por FDI].

A continuación tenemos un ejemplo de como abortar una instancia:
<code java>
logMessage("DOS_IDEAS: Cerrando instancia con nombre [" + identificador + "]", severity : Severity.DEBUG);

ProcessService processService = ProcessService();
try {
processService.connectTo(url : Fuego.Server.directoryURL, user : "tester", password : "tester");

Instance[] instances = { };
InstanceFilter instanciaFilter = InstanceFilter();
instanciaFilter.create(processService : processService);

SearchScope searchScope = SearchScope(participantScope : ParticipantScope.ALL,
statusScope : StatusScope.ONLY_INPROCESS);
instanciaFilter.searchScope = searchScope;
instanciaFilter.addAttributeTo(variable : "identificador", comparator : Comparison.IS,
value : unaVariable);

instances = processService.getInstancesByFilter(filter : instanciaFilter);

foreach (unaInstancia in instances) {
logMessage("DOS_IDEAS: Cerrando: " + unaInstancia, severity : Severity.DEBUG);

unaInstancia.abort();

logMessage("DOS_IDEAS: Instancia cerrada exitosamente", severity : Severity.DEBUG);
}
}
catch (Java.Lang.Exception ex) {
logMessage("DOS_IDEAS: Error al abortar instancia [" + identificador + "]: " + ex.message, severity : Severity.DEBUG);
}
finally {
processService.disconnectFrom();
}
</code>

====Creamos la conexión al FDI====
Se debe proveer un usuario y password existente en la aplicación y '''que tenga los permisos para poder manipular la instancia'''. Si el usuario no posee permisos para manipular la instancia, al realizar la busqueda posiblemente no tenga visibilidad de la instancia.
En caso de que se este utilizando el Studio, el password es el mismo que el user.
<code java>
ProcessService processService = ProcessService();
processService.connectTo(url : Fuego.Server.directoryURL, user : "tester", password : "tester");
</code>
La conexión debe ser finalizada mediante el método disconnectFrom
<code java>
processService.disconnectFrom();
</code>

====Creamos el filtro====
Crea un filtro para buscar las instancias en el FDI.
<code java>
InstanceFilter instanciaFilter = InstanceFilter();
instanciaFilter.create(processService : processService);
</code>

Agregamos al filtro, la condición de que obtenga la instancia de todos los participantes y que se encuentren en proceso.
<code java>
SearchScope searchScope = SearchScope(participantScope : ParticipantScope.ALL,
statusScope : StatusScope.ONLY_INPROCESS);
instanciaFilter.searchScope = searchScope;
</code>
El alcance de los participantes pueden ser:
* '''ALL''': todos los participantes.
* '''ALL_IN_ROLE''': todas las instancias del rol.
* '''PARTICIPANT''': todas las instancias del participante.
* '''PARTICIPANT_ROLE''': todas las intancias de los roles del participante.

Agregamos un filtro, para que filtre las instancia cuya '''variable externa''' identificador tenga el valor de unaVariable

<code java>
instanciaFilter.addAttributeTo(variable : "identificador", comparator : Comparison.IS, value : unaVariable);
</code>

====Obtenemos las instancias====
Obtenemos el listado de instancia que concuerdan con el filtro instanciaFilter
<code java>
Instance[] instances = processService.getInstancesByFilter(filter : instanciaFilter);
</code>

====Manipulamos las instancias obtenidas====
Recorremos la lista de instancias obtenidas y en nuestro caso las abortamos.
<code java>
foreach (unaInstancia in instances) {
unaInstancia.abort();
}
</code>
Las posibles acciones que podemos realizar sobre una instancia son:
* '''abort''': Cancela la instancia.
* '''suspend''': Suspende la instancia.
* '''select''': Selecciona la instancia.
* '''reasign''': Reasigna la instancia a un participante.

=== Ver también ===
* [[Oracle BPM]]

[[Category:Oracle]]

BEA Aqualogic BPM 5.7 (Fuego)

2011-12-26T18:25:54Z

Shichibukai: /* Tratamiento de excepciones de servicios externos */

===Comunicando con Base de Datos con PBL (Process Business Language)===

Para ejecutar comandos SQL en Aqualogic BPM 5.7 hay que seguir los siguientes pasos:

====Primer paso====

Se debe crear nuevo "External Resource", haciendo click derecho en el directorio del proyecto "External Resources", del tipo "SQL Database". Los campos se deben completar con la información de la base de datos que queremos consultar y con un nombre significativo.

====Segundo paso====

Se debe crear un nuevo "BPM Object", haciendo click derecho sobre el modulo deseado en el directorio de "Catalog", y luego crear un método en nuestro objeto, haciendo click derecho sobre el objeto y seleccionando la opción "New Method". Ahora se debe editar el nuevo método, expandiendo el objeto bpm y haciendo doble click sobre el nombre del método creado. Ahora podemos editarlo e incluir el código necesario para comunicarnos con la BD a través de una clase propia de Fuego, un ejemplo de implementación puede ser el siguiente:

<code java>
String queryAEjecutar ="SELECT campo1, campo2, campo3 FROM nombreTabla WHERE nombreColumna in (?,?)";

String nombreDeLaBDCreada = "NombreBD";

String[] arrayDeParametros = {"valor1", "valor2"};

Iterator <Any[Any]> iterator = DynamicSQL.executeQuery(sentence : queryAEjecutar, implname : nombreDeLaBDCreada, inParameters : arrayDeParametros);
</code>

Como se puede observar, el resultado de realizar la consulta va a ser un iterador, que luego puede ser recorrido con un "foreach".

<code java>
foreach (e in iterator) {

logMessage("campo1: "+e["campo1"], severity : INFO);

logMessage("campo2: "+e["campo2"], severity : INFO);

logMessage("campo3: "+e["campo3"], severity : INFO);

logMessage("nombreColumna: "+e["nombreColumna"], severity : INFO);

}
</code>

=== Versionando con CVS ===
El producto Aqualogic BPM 5.7 incluye un cliente de CVS que permite agregar, remover, actualizar en un repositorio CVS.

==== Configurar el cliente CVS ====
* Levantar el Studio BPM.
* File -> Preference ->Default Version Control
** Version Control Manger: CVS
** Host: host del servidor CVS
** User Name: usuario del CVS
** User Password: password del usuario CVS
** path: ruta dentro del repositorio donde se guardará el proyecto.

==== Subir el proyecto al CVS ====
* Levantar el Studio BPM.
* Abrir el proyecto a versionar.
* File -> Project Preference -> Project Version Control.
** Version Control Manager: CVS (nos carga la información ingresada en el punto anterior).
* File -> VCS -> Store project in repository
** Path: directorio en el que se creará el proyecto en el repositorio.
** Si es la primera vez que se sube un proyecto de Aqualogic BPM, pedirá que se ingrese la ruta del directorio donde se creará el "common catalog"
*** Common catalog: Es un catalogo de componente, el cual puede ser compartido por otros proyectos de Aqualogic BPM.
En el repositorio quedarán creados 2 directorios, el del proyecto y el del common catalog, ademas se crearán 2 alias en el CVS que apuntan al proyecto y al common catalog.

==== Obtener el proyecto del CVS ====
* Levantar el Studio BPM.
* File -> Project Preference -> Project Version Control.
* File -> Import -> Project -> from Repository.
** Version Control Manager: CVS
** En la siguiente pantalla, seleccionar el proyecto del repositorio.

==== Trabajar con proyectos versionados ====
Aqualogic BPM 5.7, posee una política restrictiva de edición para los proyecto versionados.
La política, consiste en que todo el proyecto se encuentra en modo lectura y solo un usuario puede editar un determinado archivo versionado (Ej.: un proceso).
===== Editar un procesos =====
* Seleccionar el proceso a editar.
* Menú contextual -> VCS -> edit.
Esto habilita al usuario a modificar el proceso. En caso de que exitiera otro usuario modificando el proceso nos aparecerá un mensaje de error.

===== Grabar los cambios realizados en un proceso =====
* Seleccionar el proceso que se esta editando.
* Menú contextual -> VCS -> commit.
Este paso es importante, debido a que si se libera la edición del proceso sin realizar el commit se perderán los cambios.

===== Liberar la edición del proceso =====
* Seleccionar el proceso que se esta editando.
* Menú contextual -> VCS -> unedit.

===Pasaje de Parametros===

Para pasar parámetros al proceso desde una actividad de creación (aquellas que dan inicio al proceso) que tenga asociada un ScreenFlow, hay que seguir los siguientes pasos.

El primer paso es decirle al proceso que va a recibir parametros de la siguiente manera:

* Doble click en la tarea "begin" y luego en "Argument Mapping"
[[Archivo:Imagen 1.jpg]]
* Click en el botón que parece una flecha violeta hacia abajo y ahí agregamos el nombre del parametro que va a recibir. Es recomendable utilizar nombres descriptivos ya que sino se puede volver bastante confuso.
[[Archivo:Imagen 2.jpg]]
* Ahora lo único que falta es mapear el parámetro a una variable del proceso (puede ser creada en la misma pantalla haciendo click sobre el botón que está al lado del de crear parametros)
[[Archivo:Imagen 3.jpg]]

El segundo paso es realizar un proceso similar al primer paso, con la diferencia que debe hacerce en la tarea "end" del ScreenFlow asociado a la actividad de creación.

El tercer paso es mapear las salidas del ScreenFlow con las Entradas del proceso de la siguiente manera:

* Doble click en la actividad que tiene asociada el ScreenFlow, luego en "Argument Mapping" y luego en la barra de la izquiera seleccionar "NombreDelScreenFlow Out"
[[Archivo:Imagen 4.jpg]]
* Luego solo basta con mapear los argumentos, seleccionando los nombres
[[Archivo:Imagen 5.jpg]]

===Incluir un jar y utilizarlo===
Una vez que tenemos creado nuestro proyecto BPM podemos llegar a necesitar utilizar ciertas clases de java, tanto para modelar entidades como para invocar servicios externos a nuestro proyecto.

En el caso que necesitemos incluír alguna librería al proyecto BPM los pasos a realizar son los siguientes:

* En "Recursos externos" hacer botón derecho y seleccionar la opción "Nuevo recurso externo".
* Seleccionar un nombre y en tipo seleccionar "Biblioteca de clase Java".
* Le damos clic al botón "Agregar" y buscamos el jar correspondiente que vamos a querer incluír.
* Aceptar.

Finalizado estos pasos vamos a ver que se agregó a "Recursos externos" la librería que acabamos de incluir. Lo siguiente va a ser crear un módulo desde el cual invocar a las clases de nuestro jar. Para esto tenemos que hacer lo siguiente:

* En "Catálogo" hacemos botón derecho y seleccionamos la opción "Crear módulo".
* Le ponemos un nombre y le damos Aceptar.
* Realizado esto, veremos que se agregó un módulo al Catálogo. Lo que tenemos que hacer ahora es indicarle a ese módulo que contenga la configuración de nuestro jar. Para esto hacemos clic derecho sobre el módulo > Componente de catálogo > Java.
* Seleccionamos la opción "Usar una configuración existente" (está marcada por defecto) y en el combo seleccionamos nuestro recurso externo que agregamos antes.
* Luego, seleccionaremos las clases Java que quiero incluír en mi módulo.
* Se hará la carga de clases automáticamente.
* Finalizado esto deberíamos ver dentro de "Catálogo" nuestro módulo nuevo y al amplicar su contenido ver el árbol de las clases que incluímos en él.

Para poder usar estas clases que incluímos, dentro de una actividad se podrán crear instancias de esta forma:

<code java>ClaseDeMiBiblioteca instancia = new ClaseDeMiBiblioteca();</code>

e invocar a sus métodos de esta forma:

<code java>ObjetoRespuesta respuesta = (ObjetoRespuesta) instancia.metodo(arg1 : parametroAEnviar);</code>

===Tratamiento de excepciones de servicios externos===
Puede suceder que, al momento de invocar algún servicio externo a nuestro proyecto de BPM, este retorne como respuesta una excepción. Para poder darle un comportamiento a nuestro proceso en BPM se puede utilizar una transición del tipo "Excepción" entre dos actividades.

Para dar un ejemplo concreto vamos a imaginarnos 2 actividades a las que llamaremos "Inicio" y "Comportamiento correcto". La actividad "Inicio" invocará a un servicio, y si sale todo bien, se pasará luego a la actividad "Comportamiento correcto".

[[Archivo:1.jpg]]

Ahora, puede suceder que cuando "Inicio" invoca al servicio, éste devuelva una Excepción. ¿Qué hacemos en ese caso? Creamos una actividad (en nuestro ejemplo es "Comportamiento excepción"), la cual nuestro sistema ejecutará en caso de que el servicio falle, y le asociamos una transición entre "Inicio" y esta nueva actividad de esta forma:

[[Archivo:2.jpg]]

Para crear dicha transición, debemos crear la actividad a la cual asociarla, dale doble clic y luego seleccionar como tipo de transición aquella que dice "Excepción". Para indicarle para qué tipo de Excepción queremos que se siga dicho flujo, en "Nombre de excepción" deberemos cargar la clase con la excepción que puede llegar.

Si queremos obtener el mensaje de la excepción, podemos utilizar la variable predefinida por BPM '''lastException''' en la cual se guarda la ultima excepción ocurrida en la instancia.

===Creación de Instancias mediante PBL===
Para crear instancias de procesos mediante PBL se utiliza el siguiente código:
<code java>
logMessage("DOS_IDEAS: Creando la instancia ConsumidorProceso", severity : Severity.DEBUG);

String mensaje = "Este es un mensaje creado por el productor a las " + 'now';
ProcessInstance.create(processId : ProcessInstance.organization + "/" + ProcessInstance.organizationalUnit + "/ConsumidorProceso",
arguments : { "mensaje_InArgument" : mensaje }, argumentsSetName : "BeginIn");
</code>
Donde:
* '''processId''' es el identificador (no el nombre) del proceso que queremos crear, en nuestro caso vamos a crear el proceso "ConsumidorProceso".
* '''arguments''' es el array de argumentos de entrada que se definio en el proceso.

En el siguiente link podemos descargarnos un ejemplo del svn:
[https://dosideas-aplicaciones-modelo.googlecode.com/svn/BPM_Ejemplos/trunk/CrearInstanciaConPBL.fpr.exp Crear Instancia mediante PBL]

===Manipulación de Instancias mediante PAPI===
Aqualogic BPM 5.7, provee una API para trabajar con el FDI. Esta API se la conoce como PAPI.
Una de las cosas que nos permite realizar es obtener una instancia de BPM y manipular dicha instancia.
En el siguiente link podemos descargarnos un ejemplo del svn: [https://dosideas-aplicaciones-modelo.googlecode.com/svn/BPM_Ejemplos/trunk/ManipularInstancias.fpr.exp Manipular instancia por FDI].

A continuación tenemos un ejemplo de como abortar una instancia:
<code java>
logMessage("DOS_IDEAS: Cerrando instancia con nombre [" + identificador + "]", severity : Severity.DEBUG);

ProcessService processService = ProcessService();
try {
processService.connectTo(url : Fuego.Server.directoryURL, user : "tester", password : "tester");

Instance[] instances = { };
InstanceFilter instanciaFilter = InstanceFilter();
instanciaFilter.create(processService : processService);

SearchScope searchScope = SearchScope(participantScope : ParticipantScope.ALL,
statusScope : StatusScope.ONLY_INPROCESS);
instanciaFilter.searchScope = searchScope;
instanciaFilter.addAttributeTo(variable : "identificador", comparator : Comparison.IS,
value : unaVariable);

instances = processService.getInstancesByFilter(filter : instanciaFilter);

foreach (unaInstancia in instances) {
logMessage("DOS_IDEAS: Cerrando: " + unaInstancia, severity : Severity.DEBUG);

unaInstancia.abort();

logMessage("DOS_IDEAS: Instancia cerrada exitosamente", severity : Severity.DEBUG);
}
}
catch (Java.Lang.Exception ex) {
logMessage("DOS_IDEAS: Error al abortar instancia [" + identificador + "]: " + ex.message, severity : Severity.DEBUG);
}
finally {
processService.disconnectFrom();
}
</code>

====Creamos la conexión al FDI====
Se debe provee un usuario y password existente en la aplicación y que tenga los permisos para poder manipular la instancia.
En caso de que se este utilizando el Studio, el password es el mismo que el user.
<code java>
ProcessService processService = ProcessService();
processService.connectTo(url : Fuego.Server.directoryURL, user : "tester", password : "tester");
</code>
La conexión debe ser finalizada mediante el método disconnectFrom
<code java>
processService.disconnectFrom();
</code>

====Creamos el filtro====
Crea un filtro para buscar las instancias en el FDI.
<code java>
InstanceFilter instanciaFilter = InstanceFilter();
instanciaFilter.create(processService : processService);
</code>

Agregamos al filtro, la condición de que obtenga la instancia de todos los participantes y que se encuentren en proceso.
<code java>
SearchScope searchScope = SearchScope(participantScope : ParticipantScope.ALL,
statusScope : StatusScope.ONLY_INPROCESS);
instanciaFilter.searchScope = searchScope;
</code>
El alcance de los participantes pueden ser:
* '''ALL''': todos los participantes.
* '''ALL_IN_ROLE''': todas las instancias del rol.
* '''PARTICIPANT''': todas las instancias del participante.
* '''PARTICIPANT_ROLE''': todas las intancias de los roles del participante.

Agregamos un filtro, para que filtre las instancia cuya '''variable externa''' identificador tenga el valor de unaVariable

<code java>
instanciaFilter.addAttributeTo(variable : "identificador", comparator : Comparison.IS, value : unaVariable);
</code>

====Obtenemos las instancias====
Obtenemos el listado de instancia que concuerdan con el filtro instanciaFilter
<code java>
Instance[] instances = processService.getInstancesByFilter(filter : instanciaFilter);
</code>

====Manipulamos las instancias obtenidas====
Recorremos la lista de instancias obtenidas y en nuestro caso las abortamos.
<code java>
foreach (unaInstancia in instances) {
unaInstancia.abort();
}
</code>
Las posibles acciones que podemos realizar sobre una instancia son:
* '''abort''': Cancela la instancia.
* '''suspend''': Suspende la instancia.
* '''select''': Selecciona la instancia.
* '''reasign''': Reasigna la instancia a un participante.

=== Ver también ===
* [[Oracle BPM]]

[[Category:Oracle]]

BEA Aqualogic BPM 5.7 (Fuego)

2011-12-26T18:11:31Z

Shichibukai: /* Manipulación de Instancias mediante PAPI */

===Comunicando con Base de Datos con PBL (Process Business Language)===

Para ejecutar comandos SQL en Aqualogic BPM 5.7 hay que seguir los siguientes pasos:

====Primer paso====

Se debe crear nuevo "External Resource", haciendo click derecho en el directorio del proyecto "External Resources", del tipo "SQL Database". Los campos se deben completar con la información de la base de datos que queremos consultar y con un nombre significativo.

====Segundo paso====

Se debe crear un nuevo "BPM Object", haciendo click derecho sobre el modulo deseado en el directorio de "Catalog", y luego crear un método en nuestro objeto, haciendo click derecho sobre el objeto y seleccionando la opción "New Method". Ahora se debe editar el nuevo método, expandiendo el objeto bpm y haciendo doble click sobre el nombre del método creado. Ahora podemos editarlo e incluir el código necesario para comunicarnos con la BD a través de una clase propia de Fuego, un ejemplo de implementación puede ser el siguiente:

<code java>
String queryAEjecutar ="SELECT campo1, campo2, campo3 FROM nombreTabla WHERE nombreColumna in (?,?)";

String nombreDeLaBDCreada = "NombreBD";

String[] arrayDeParametros = {"valor1", "valor2"};

Iterator <Any[Any]> iterator = DynamicSQL.executeQuery(sentence : queryAEjecutar, implname : nombreDeLaBDCreada, inParameters : arrayDeParametros);
</code>

Como se puede observar, el resultado de realizar la consulta va a ser un iterador, que luego puede ser recorrido con un "foreach".

<code java>
foreach (e in iterator) {

logMessage("campo1: "+e["campo1"], severity : INFO);

logMessage("campo2: "+e["campo2"], severity : INFO);

logMessage("campo3: "+e["campo3"], severity : INFO);

logMessage("nombreColumna: "+e["nombreColumna"], severity : INFO);

}
</code>

=== Versionando con CVS ===
El producto Aqualogic BPM 5.7 incluye un cliente de CVS que permite agregar, remover, actualizar en un repositorio CVS.

==== Configurar el cliente CVS ====
* Levantar el Studio BPM.
* File -> Preference ->Default Version Control
** Version Control Manger: CVS
** Host: host del servidor CVS
** User Name: usuario del CVS
** User Password: password del usuario CVS
** path: ruta dentro del repositorio donde se guardará el proyecto.

==== Subir el proyecto al CVS ====
* Levantar el Studio BPM.
* Abrir el proyecto a versionar.
* File -> Project Preference -> Project Version Control.
** Version Control Manager: CVS (nos carga la información ingresada en el punto anterior).
* File -> VCS -> Store project in repository
** Path: directorio en el que se creará el proyecto en el repositorio.
** Si es la primera vez que se sube un proyecto de Aqualogic BPM, pedirá que se ingrese la ruta del directorio donde se creará el "common catalog"
*** Common catalog: Es un catalogo de componente, el cual puede ser compartido por otros proyectos de Aqualogic BPM.
En el repositorio quedarán creados 2 directorios, el del proyecto y el del common catalog, ademas se crearán 2 alias en el CVS que apuntan al proyecto y al common catalog.

==== Obtener el proyecto del CVS ====
* Levantar el Studio BPM.
* File -> Project Preference -> Project Version Control.
* File -> Import -> Project -> from Repository.
** Version Control Manager: CVS
** En la siguiente pantalla, seleccionar el proyecto del repositorio.

==== Trabajar con proyectos versionados ====
Aqualogic BPM 5.7, posee una política restrictiva de edición para los proyecto versionados.
La política, consiste en que todo el proyecto se encuentra en modo lectura y solo un usuario puede editar un determinado archivo versionado (Ej.: un proceso).
===== Editar un procesos =====
* Seleccionar el proceso a editar.
* Menú contextual -> VCS -> edit.
Esto habilita al usuario a modificar el proceso. En caso de que exitiera otro usuario modificando el proceso nos aparecerá un mensaje de error.

===== Grabar los cambios realizados en un proceso =====
* Seleccionar el proceso que se esta editando.
* Menú contextual -> VCS -> commit.
Este paso es importante, debido a que si se libera la edición del proceso sin realizar el commit se perderán los cambios.

===== Liberar la edición del proceso =====
* Seleccionar el proceso que se esta editando.
* Menú contextual -> VCS -> unedit.

===Pasaje de Parametros===

Para pasar parámetros al proceso desde una actividad de creación (aquellas que dan inicio al proceso) que tenga asociada un ScreenFlow, hay que seguir los siguientes pasos.

El primer paso es decirle al proceso que va a recibir parametros de la siguiente manera:

* Doble click en la tarea "begin" y luego en "Argument Mapping"
[[Archivo:Imagen 1.jpg]]
* Click en el botón que parece una flecha violeta hacia abajo y ahí agregamos el nombre del parametro que va a recibir. Es recomendable utilizar nombres descriptivos ya que sino se puede volver bastante confuso.
[[Archivo:Imagen 2.jpg]]
* Ahora lo único que falta es mapear el parámetro a una variable del proceso (puede ser creada en la misma pantalla haciendo click sobre el botón que está al lado del de crear parametros)
[[Archivo:Imagen 3.jpg]]

El segundo paso es realizar un proceso similar al primer paso, con la diferencia que debe hacerce en la tarea "end" del ScreenFlow asociado a la actividad de creación.

El tercer paso es mapear las salidas del ScreenFlow con las Entradas del proceso de la siguiente manera:

* Doble click en la actividad que tiene asociada el ScreenFlow, luego en "Argument Mapping" y luego en la barra de la izquiera seleccionar "NombreDelScreenFlow Out"
[[Archivo:Imagen 4.jpg]]
* Luego solo basta con mapear los argumentos, seleccionando los nombres
[[Archivo:Imagen 5.jpg]]

===Incluir un jar y utilizarlo===
Una vez que tenemos creado nuestro proyecto BPM podemos llegar a necesitar utilizar ciertas clases de java, tanto para modelar entidades como para invocar servicios externos a nuestro proyecto.

En el caso que necesitemos incluír alguna librería al proyecto BPM los pasos a realizar son los siguientes:

* En "Recursos externos" hacer botón derecho y seleccionar la opción "Nuevo recurso externo".
* Seleccionar un nombre y en tipo seleccionar "Biblioteca de clase Java".
* Le damos clic al botón "Agregar" y buscamos el jar correspondiente que vamos a querer incluír.
* Aceptar.

Finalizado estos pasos vamos a ver que se agregó a "Recursos externos" la librería que acabamos de incluir. Lo siguiente va a ser crear un módulo desde el cual invocar a las clases de nuestro jar. Para esto tenemos que hacer lo siguiente:

* En "Catálogo" hacemos botón derecho y seleccionamos la opción "Crear módulo".
* Le ponemos un nombre y le damos Aceptar.
* Realizado esto, veremos que se agregó un módulo al Catálogo. Lo que tenemos que hacer ahora es indicarle a ese módulo que contenga la configuración de nuestro jar. Para esto hacemos clic derecho sobre el módulo > Componente de catálogo > Java.
* Seleccionamos la opción "Usar una configuración existente" (está marcada por defecto) y en el combo seleccionamos nuestro recurso externo que agregamos antes.
* Luego, seleccionaremos las clases Java que quiero incluír en mi módulo.
* Se hará la carga de clases automáticamente.
* Finalizado esto deberíamos ver dentro de "Catálogo" nuestro módulo nuevo y al amplicar su contenido ver el árbol de las clases que incluímos en él.

Para poder usar estas clases que incluímos, dentro de una actividad se podrán crear instancias de esta forma:

<code java>ClaseDeMiBiblioteca instancia = new ClaseDeMiBiblioteca();</code>

e invocar a sus métodos de esta forma:

<code java>ObjetoRespuesta respuesta = (ObjetoRespuesta) instancia.metodo(arg1 : parametroAEnviar);</code>

===Tratamiento de excepciones de servicios externos===
Puede suceder que, al momento de invocar algún servicio externo a nuestro proyecto de BPM, este retorne como respuesta una excepción. Para poder darle un comportamiento a nuestro proceso en BPM se puede utilizar una transición del tipo "Excepción" entre dos actividades.

Para dar un ejemplo concreto vamos a imaginarnos 2 actividades a las que llamaremos "Inicio" y "Comportamiento correcto". La actividad "Inicio" invocará a un servicio, y si sale todo bien, se pasará luego a la actividad "Comportamiento correcto".

[[Archivo:1.jpg]]

Ahora, puede suceder que cuando "Inicio" invoca al servicio, éste devuelva una Excepción. ¿Qué hacemos en ese caso? Creamos una actividad (en nuestro ejemplo es "Comportamiento excepción"), la cual nuestro sistema ejecutará en caso de que el servicio falle, y le asociamos una transición entre "Inicio" y esta nueva actividad de esta forma:

[[Archivo:2.jpg]]

Para crear dicha transición, debemos crear la actividad a la cual asociarla, dale doble clic y luego seleccionar como tipo de transición aquella que dice "Excepción". Para indicarle para qué tipo de Excepción queremos que se siga dicho flujo, en "Nombre de excepción" deberemos cargar la clase con la excepción que puede llegar.
===Creación de Instancias mediante PBL===
Para crear instancias de procesos mediante PBL se utiliza el siguiente código:
<code java>
logMessage("DOS_IDEAS: Creando la instancia ConsumidorProceso", severity : Severity.DEBUG);

String mensaje = "Este es un mensaje creado por el productor a las " + 'now';
ProcessInstance.create(processId : ProcessInstance.organization + "/" + ProcessInstance.organizationalUnit + "/ConsumidorProceso",
arguments : { "mensaje_InArgument" : mensaje }, argumentsSetName : "BeginIn");
</code>
Donde:
* '''processId''' es el identificador (no el nombre) del proceso que queremos crear, en nuestro caso vamos a crear el proceso "ConsumidorProceso".
* '''arguments''' es el array de argumentos de entrada que se definio en el proceso.

En el siguiente link podemos descargarnos un ejemplo del svn:
[https://dosideas-aplicaciones-modelo.googlecode.com/svn/BPM_Ejemplos/trunk/CrearInstanciaConPBL.fpr.exp Crear Instancia mediante PBL]

===Manipulación de Instancias mediante PAPI===
Aqualogic BPM 5.7, provee una API para trabajar con el FDI. Esta API se la conoce como PAPI.
Una de las cosas que nos permite realizar es obtener una instancia de BPM y manipular dicha instancia.
En el siguiente link podemos descargarnos un ejemplo del svn: [https://dosideas-aplicaciones-modelo.googlecode.com/svn/BPM_Ejemplos/trunk/ManipularInstancias.fpr.exp Manipular instancia por FDI].

A continuación tenemos un ejemplo de como abortar una instancia:
<code java>
logMessage("DOS_IDEAS: Cerrando instancia con nombre [" + identificador + "]", severity : Severity.DEBUG);

ProcessService processService = ProcessService();
try {
processService.connectTo(url : Fuego.Server.directoryURL, user : "tester", password : "tester");

Instance[] instances = { };
InstanceFilter instanciaFilter = InstanceFilter();
instanciaFilter.create(processService : processService);

SearchScope searchScope = SearchScope(participantScope : ParticipantScope.ALL,
statusScope : StatusScope.ONLY_INPROCESS);
instanciaFilter.searchScope = searchScope;
instanciaFilter.addAttributeTo(variable : "identificador", comparator : Comparison.IS,
value : unaVariable);

instances = processService.getInstancesByFilter(filter : instanciaFilter);

foreach (unaInstancia in instances) {
logMessage("DOS_IDEAS: Cerrando: " + unaInstancia, severity : Severity.DEBUG);

unaInstancia.abort();

logMessage("DOS_IDEAS: Instancia cerrada exitosamente", severity : Severity.DEBUG);
}
}
catch (Java.Lang.Exception ex) {
logMessage("DOS_IDEAS: Error al abortar instancia [" + identificador + "]: " + ex.message, severity : Severity.DEBUG);
}
finally {
processService.disconnectFrom();
}
</code>

====Creamos la conexión al FDI====
Se debe provee un usuario y password existente en la aplicación y que tenga los permisos para poder manipular la instancia.
En caso de que se este utilizando el Studio, el password es el mismo que el user.
<code java>
ProcessService processService = ProcessService();
processService.connectTo(url : Fuego.Server.directoryURL, user : "tester", password : "tester");
</code>
La conexión debe ser finalizada mediante el método disconnectFrom
<code java>
processService.disconnectFrom();
</code>

====Creamos el filtro====
Crea un filtro para buscar las instancias en el FDI.
<code java>
InstanceFilter instanciaFilter = InstanceFilter();
instanciaFilter.create(processService : processService);
</code>

Agregamos al filtro, la condición de que obtenga la instancia de todos los participantes y que se encuentren en proceso.
<code java>
SearchScope searchScope = SearchScope(participantScope : ParticipantScope.ALL,
statusScope : StatusScope.ONLY_INPROCESS);
instanciaFilter.searchScope = searchScope;
</code>
El alcance de los participantes pueden ser:
* '''ALL''': todos los participantes.
* '''ALL_IN_ROLE''': todas las instancias del rol.
* '''PARTICIPANT''': todas las instancias del participante.
* '''PARTICIPANT_ROLE''': todas las intancias de los roles del participante.

Agregamos un filtro, para que filtre las instancia cuya '''variable externa''' identificador tenga el valor de unaVariable

<code java>
instanciaFilter.addAttributeTo(variable : "identificador", comparator : Comparison.IS, value : unaVariable);
</code>

====Obtenemos las instancias====
Obtenemos el listado de instancia que concuerdan con el filtro instanciaFilter
<code java>
Instance[] instances = processService.getInstancesByFilter(filter : instanciaFilter);
</code>

====Manipulamos las instancias obtenidas====
Recorremos la lista de instancias obtenidas y en nuestro caso las abortamos.
<code java>
foreach (unaInstancia in instances) {
unaInstancia.abort();
}
</code>
Las posibles acciones que podemos realizar sobre una instancia son:
* '''abort''': Cancela la instancia.
* '''suspend''': Suspende la instancia.
* '''select''': Selecciona la instancia.
* '''reasign''': Reasigna la instancia a un participante.

=== Ver también ===
* [[Oracle BPM]]

[[Category:Oracle]]

BEA Aqualogic BPM 5.7 (Fuego)

2011-12-26T18:10:46Z

Shichibukai: /* Manipulación de Instancias mediante PAPI */

===Comunicando con Base de Datos con PBL (Process Business Language)===

Para ejecutar comandos SQL en Aqualogic BPM 5.7 hay que seguir los siguientes pasos:

====Primer paso====

Se debe crear nuevo "External Resource", haciendo click derecho en el directorio del proyecto "External Resources", del tipo "SQL Database". Los campos se deben completar con la información de la base de datos que queremos consultar y con un nombre significativo.

====Segundo paso====

Se debe crear un nuevo "BPM Object", haciendo click derecho sobre el modulo deseado en el directorio de "Catalog", y luego crear un método en nuestro objeto, haciendo click derecho sobre el objeto y seleccionando la opción "New Method". Ahora se debe editar el nuevo método, expandiendo el objeto bpm y haciendo doble click sobre el nombre del método creado. Ahora podemos editarlo e incluir el código necesario para comunicarnos con la BD a través de una clase propia de Fuego, un ejemplo de implementación puede ser el siguiente:

<code java>
String queryAEjecutar ="SELECT campo1, campo2, campo3 FROM nombreTabla WHERE nombreColumna in (?,?)";

String nombreDeLaBDCreada = "NombreBD";

String[] arrayDeParametros = {"valor1", "valor2"};

Iterator <Any[Any]> iterator = DynamicSQL.executeQuery(sentence : queryAEjecutar, implname : nombreDeLaBDCreada, inParameters : arrayDeParametros);
</code>

Como se puede observar, el resultado de realizar la consulta va a ser un iterador, que luego puede ser recorrido con un "foreach".

<code java>
foreach (e in iterator) {

logMessage("campo1: "+e["campo1"], severity : INFO);

logMessage("campo2: "+e["campo2"], severity : INFO);

logMessage("campo3: "+e["campo3"], severity : INFO);

logMessage("nombreColumna: "+e["nombreColumna"], severity : INFO);

}
</code>

=== Versionando con CVS ===
El producto Aqualogic BPM 5.7 incluye un cliente de CVS que permite agregar, remover, actualizar en un repositorio CVS.

==== Configurar el cliente CVS ====
* Levantar el Studio BPM.
* File -> Preference ->Default Version Control
** Version Control Manger: CVS
** Host: host del servidor CVS
** User Name: usuario del CVS
** User Password: password del usuario CVS
** path: ruta dentro del repositorio donde se guardará el proyecto.

==== Subir el proyecto al CVS ====
* Levantar el Studio BPM.
* Abrir el proyecto a versionar.
* File -> Project Preference -> Project Version Control.
** Version Control Manager: CVS (nos carga la información ingresada en el punto anterior).
* File -> VCS -> Store project in repository
** Path: directorio en el que se creará el proyecto en el repositorio.
** Si es la primera vez que se sube un proyecto de Aqualogic BPM, pedirá que se ingrese la ruta del directorio donde se creará el "common catalog"
*** Common catalog: Es un catalogo de componente, el cual puede ser compartido por otros proyectos de Aqualogic BPM.
En el repositorio quedarán creados 2 directorios, el del proyecto y el del common catalog, ademas se crearán 2 alias en el CVS que apuntan al proyecto y al common catalog.

==== Obtener el proyecto del CVS ====
* Levantar el Studio BPM.
* File -> Project Preference -> Project Version Control.
* File -> Import -> Project -> from Repository.
** Version Control Manager: CVS
** En la siguiente pantalla, seleccionar el proyecto del repositorio.

==== Trabajar con proyectos versionados ====
Aqualogic BPM 5.7, posee una política restrictiva de edición para los proyecto versionados.
La política, consiste en que todo el proyecto se encuentra en modo lectura y solo un usuario puede editar un determinado archivo versionado (Ej.: un proceso).
===== Editar un procesos =====
* Seleccionar el proceso a editar.
* Menú contextual -> VCS -> edit.
Esto habilita al usuario a modificar el proceso. En caso de que exitiera otro usuario modificando el proceso nos aparecerá un mensaje de error.

===== Grabar los cambios realizados en un proceso =====
* Seleccionar el proceso que se esta editando.
* Menú contextual -> VCS -> commit.
Este paso es importante, debido a que si se libera la edición del proceso sin realizar el commit se perderán los cambios.

===== Liberar la edición del proceso =====
* Seleccionar el proceso que se esta editando.
* Menú contextual -> VCS -> unedit.

===Pasaje de Parametros===

Para pasar parámetros al proceso desde una actividad de creación (aquellas que dan inicio al proceso) que tenga asociada un ScreenFlow, hay que seguir los siguientes pasos.

El primer paso es decirle al proceso que va a recibir parametros de la siguiente manera:

* Doble click en la tarea "begin" y luego en "Argument Mapping"
[[Archivo:Imagen 1.jpg]]
* Click en el botón que parece una flecha violeta hacia abajo y ahí agregamos el nombre del parametro que va a recibir. Es recomendable utilizar nombres descriptivos ya que sino se puede volver bastante confuso.
[[Archivo:Imagen 2.jpg]]
* Ahora lo único que falta es mapear el parámetro a una variable del proceso (puede ser creada en la misma pantalla haciendo click sobre el botón que está al lado del de crear parametros)
[[Archivo:Imagen 3.jpg]]

El segundo paso es realizar un proceso similar al primer paso, con la diferencia que debe hacerce en la tarea "end" del ScreenFlow asociado a la actividad de creación.

El tercer paso es mapear las salidas del ScreenFlow con las Entradas del proceso de la siguiente manera:

* Doble click en la actividad que tiene asociada el ScreenFlow, luego en "Argument Mapping" y luego en la barra de la izquiera seleccionar "NombreDelScreenFlow Out"
[[Archivo:Imagen 4.jpg]]
* Luego solo basta con mapear los argumentos, seleccionando los nombres
[[Archivo:Imagen 5.jpg]]

===Incluir un jar y utilizarlo===
Una vez que tenemos creado nuestro proyecto BPM podemos llegar a necesitar utilizar ciertas clases de java, tanto para modelar entidades como para invocar servicios externos a nuestro proyecto.

En el caso que necesitemos incluír alguna librería al proyecto BPM los pasos a realizar son los siguientes:

* En "Recursos externos" hacer botón derecho y seleccionar la opción "Nuevo recurso externo".
* Seleccionar un nombre y en tipo seleccionar "Biblioteca de clase Java".
* Le damos clic al botón "Agregar" y buscamos el jar correspondiente que vamos a querer incluír.
* Aceptar.

Finalizado estos pasos vamos a ver que se agregó a "Recursos externos" la librería que acabamos de incluir. Lo siguiente va a ser crear un módulo desde el cual invocar a las clases de nuestro jar. Para esto tenemos que hacer lo siguiente:

* En "Catálogo" hacemos botón derecho y seleccionamos la opción "Crear módulo".
* Le ponemos un nombre y le damos Aceptar.
* Realizado esto, veremos que se agregó un módulo al Catálogo. Lo que tenemos que hacer ahora es indicarle a ese módulo que contenga la configuración de nuestro jar. Para esto hacemos clic derecho sobre el módulo > Componente de catálogo > Java.
* Seleccionamos la opción "Usar una configuración existente" (está marcada por defecto) y en el combo seleccionamos nuestro recurso externo que agregamos antes.
* Luego, seleccionaremos las clases Java que quiero incluír en mi módulo.
* Se hará la carga de clases automáticamente.
* Finalizado esto deberíamos ver dentro de "Catálogo" nuestro módulo nuevo y al amplicar su contenido ver el árbol de las clases que incluímos en él.

Para poder usar estas clases que incluímos, dentro de una actividad se podrán crear instancias de esta forma:

<code java>ClaseDeMiBiblioteca instancia = new ClaseDeMiBiblioteca();</code>

e invocar a sus métodos de esta forma:

<code java>ObjetoRespuesta respuesta = (ObjetoRespuesta) instancia.metodo(arg1 : parametroAEnviar);</code>

===Tratamiento de excepciones de servicios externos===
Puede suceder que, al momento de invocar algún servicio externo a nuestro proyecto de BPM, este retorne como respuesta una excepción. Para poder darle un comportamiento a nuestro proceso en BPM se puede utilizar una transición del tipo "Excepción" entre dos actividades.

Para dar un ejemplo concreto vamos a imaginarnos 2 actividades a las que llamaremos "Inicio" y "Comportamiento correcto". La actividad "Inicio" invocará a un servicio, y si sale todo bien, se pasará luego a la actividad "Comportamiento correcto".

[[Archivo:1.jpg]]

Ahora, puede suceder que cuando "Inicio" invoca al servicio, éste devuelva una Excepción. ¿Qué hacemos en ese caso? Creamos una actividad (en nuestro ejemplo es "Comportamiento excepción"), la cual nuestro sistema ejecutará en caso de que el servicio falle, y le asociamos una transición entre "Inicio" y esta nueva actividad de esta forma:

[[Archivo:2.jpg]]

Para crear dicha transición, debemos crear la actividad a la cual asociarla, dale doble clic y luego seleccionar como tipo de transición aquella que dice "Excepción". Para indicarle para qué tipo de Excepción queremos que se siga dicho flujo, en "Nombre de excepción" deberemos cargar la clase con la excepción que puede llegar.
===Creación de Instancias mediante PBL===
Para crear instancias de procesos mediante PBL se utiliza el siguiente código:
<code java>
logMessage("DOS_IDEAS: Creando la instancia ConsumidorProceso", severity : Severity.DEBUG);

String mensaje = "Este es un mensaje creado por el productor a las " + 'now';
ProcessInstance.create(processId : ProcessInstance.organization + "/" + ProcessInstance.organizationalUnit + "/ConsumidorProceso",
arguments : { "mensaje_InArgument" : mensaje }, argumentsSetName : "BeginIn");
</code>
Donde:
* '''processId''' es el identificador (no el nombre) del proceso que queremos crear, en nuestro caso vamos a crear el proceso "ConsumidorProceso".
* '''arguments''' es el array de argumentos de entrada que se definio en el proceso.

En el siguiente link podemos descargarnos un ejemplo del svn:
[https://dosideas-aplicaciones-modelo.googlecode.com/svn/BPM_Ejemplos/trunk/CrearInstanciaConPBL.fpr.exp Crear Instancia mediante PBL]

===Manipulación de Instancias mediante PAPI===
Aqualogic BPM 5.7, provee una API para trabajar con el FDI. Esta API se la conoce como PAPI.
Una de las cosas que nos permite realizar es obtener una instancia de BPM y manipular dicha instancia.
En el siguiente link podemos descargarnos un ejemplo del svn: [https://dosideas-aplicaciones-modelo.googlecode.com/svn/BPM_Ejemplos/trunk/ManipularInstancias.fpr.exp Ejemplo para manipular instancia por FDI]
A continuación tenemos un ejemplo de como abortar una instancia:
<code java>
logMessage("DOS_IDEAS: Cerrando instancia con nombre [" + identificador + "]", severity : Severity.DEBUG);

ProcessService processService = ProcessService();
try {
processService.connectTo(url : Fuego.Server.directoryURL, user : "tester", password : "tester");

Instance[] instances = { };
InstanceFilter instanciaFilter = InstanceFilter();
instanciaFilter.create(processService : processService);

SearchScope searchScope = SearchScope(participantScope : ParticipantScope.ALL,
statusScope : StatusScope.ONLY_INPROCESS);
instanciaFilter.searchScope = searchScope;
instanciaFilter.addAttributeTo(variable : "identificador", comparator : Comparison.IS,
value : unaVariable);

instances = processService.getInstancesByFilter(filter : instanciaFilter);

foreach (unaInstancia in instances) {
logMessage("DOS_IDEAS: Cerrando: " + unaInstancia, severity : Severity.DEBUG);

unaInstancia.abort();

logMessage("DOS_IDEAS: Instancia cerrada exitosamente", severity : Severity.DEBUG);
}
}
catch (Java.Lang.Exception ex) {
logMessage("DOS_IDEAS: Error al abortar instancia [" + identificador + "]: " + ex.message, severity : Severity.DEBUG);
}
finally {
processService.disconnectFrom();
}
</code>

====Creamos la conexión al FDI====
Se debe provee un usuario y password existente en la aplicación y que tenga los permisos para poder manipular la instancia.
En caso de que se este utilizando el Studio, el password es el mismo que el user.
<code java>
ProcessService processService = ProcessService();
processService.connectTo(url : Fuego.Server.directoryURL, user : "tester", password : "tester");
</code>
La conexión debe ser finalizada mediante el método disconnectFrom
<code java>
processService.disconnectFrom();
</code>

====Creamos el filtro====
Crea un filtro para buscar las instancias en el FDI.
<code java>
InstanceFilter instanciaFilter = InstanceFilter();
instanciaFilter.create(processService : processService);
</code>

Agregamos al filtro, la condición de que obtenga la instancia de todos los participantes y que se encuentren en proceso.
<code java>
SearchScope searchScope = SearchScope(participantScope : ParticipantScope.ALL,
statusScope : StatusScope.ONLY_INPROCESS);
instanciaFilter.searchScope = searchScope;
</code>
El alcance de los participantes pueden ser:
* '''ALL''': todos los participantes.
* '''ALL_IN_ROLE''': todas las instancias del rol.
* '''PARTICIPANT''': todas las instancias del participante.
* '''PARTICIPANT_ROLE''': todas las intancias de los roles del participante.

Agregamos un filtro, para que filtre las instancia cuya '''variable externa''' identificador tenga el valor de unaVariable

<code java>
instanciaFilter.addAttributeTo(variable : "identificador", comparator : Comparison.IS, value : unaVariable);
</code>

====Obtenemos las instancias====
Obtenemos el listado de instancia que concuerdan con el filtro instanciaFilter
<code java>
Instance[] instances = processService.getInstancesByFilter(filter : instanciaFilter);
</code>

====Manipulamos las instancias obtenidas====
Recorremos la lista de instancias obtenidas y en nuestro caso las abortamos.
<code java>
foreach (unaInstancia in instances) {
unaInstancia.abort();
}
</code>
Las posibles acciones que podemos realizar sobre una instancia son:
* '''abort''': Cancela la instancia.
* '''suspend''': Suspende la instancia.
* '''select''': Selecciona la instancia.
* '''reasign''': Reasigna la instancia a un participante.

=== Ver también ===
* [[Oracle BPM]]

[[Category:Oracle]]

BEA Aqualogic BPM 5.7 (Fuego)

2011-12-26T18:06:30Z

Shichibukai:

===Comunicando con Base de Datos con PBL (Process Business Language)===

Para ejecutar comandos SQL en Aqualogic BPM 5.7 hay que seguir los siguientes pasos:

====Primer paso====

Se debe crear nuevo "External Resource", haciendo click derecho en el directorio del proyecto "External Resources", del tipo "SQL Database". Los campos se deben completar con la información de la base de datos que queremos consultar y con un nombre significativo.

====Segundo paso====

Se debe crear un nuevo "BPM Object", haciendo click derecho sobre el modulo deseado en el directorio de "Catalog", y luego crear un método en nuestro objeto, haciendo click derecho sobre el objeto y seleccionando la opción "New Method". Ahora se debe editar el nuevo método, expandiendo el objeto bpm y haciendo doble click sobre el nombre del método creado. Ahora podemos editarlo e incluir el código necesario para comunicarnos con la BD a través de una clase propia de Fuego, un ejemplo de implementación puede ser el siguiente:

<code java>
String queryAEjecutar ="SELECT campo1, campo2, campo3 FROM nombreTabla WHERE nombreColumna in (?,?)";

String nombreDeLaBDCreada = "NombreBD";

String[] arrayDeParametros = {"valor1", "valor2"};

Iterator <Any[Any]> iterator = DynamicSQL.executeQuery(sentence : queryAEjecutar, implname : nombreDeLaBDCreada, inParameters : arrayDeParametros);
</code>

Como se puede observar, el resultado de realizar la consulta va a ser un iterador, que luego puede ser recorrido con un "foreach".

<code java>
foreach (e in iterator) {

logMessage("campo1: "+e["campo1"], severity : INFO);

logMessage("campo2: "+e["campo2"], severity : INFO);

logMessage("campo3: "+e["campo3"], severity : INFO);

logMessage("nombreColumna: "+e["nombreColumna"], severity : INFO);

}
</code>

=== Versionando con CVS ===
El producto Aqualogic BPM 5.7 incluye un cliente de CVS que permite agregar, remover, actualizar en un repositorio CVS.

==== Configurar el cliente CVS ====
* Levantar el Studio BPM.
* File -> Preference ->Default Version Control
** Version Control Manger: CVS
** Host: host del servidor CVS
** User Name: usuario del CVS
** User Password: password del usuario CVS
** path: ruta dentro del repositorio donde se guardará el proyecto.

==== Subir el proyecto al CVS ====
* Levantar el Studio BPM.
* Abrir el proyecto a versionar.
* File -> Project Preference -> Project Version Control.
** Version Control Manager: CVS (nos carga la información ingresada en el punto anterior).
* File -> VCS -> Store project in repository
** Path: directorio en el que se creará el proyecto en el repositorio.
** Si es la primera vez que se sube un proyecto de Aqualogic BPM, pedirá que se ingrese la ruta del directorio donde se creará el "common catalog"
*** Common catalog: Es un catalogo de componente, el cual puede ser compartido por otros proyectos de Aqualogic BPM.
En el repositorio quedarán creados 2 directorios, el del proyecto y el del common catalog, ademas se crearán 2 alias en el CVS que apuntan al proyecto y al common catalog.

==== Obtener el proyecto del CVS ====
* Levantar el Studio BPM.
* File -> Project Preference -> Project Version Control.
* File -> Import -> Project -> from Repository.
** Version Control Manager: CVS
** En la siguiente pantalla, seleccionar el proyecto del repositorio.

==== Trabajar con proyectos versionados ====
Aqualogic BPM 5.7, posee una política restrictiva de edición para los proyecto versionados.
La política, consiste en que todo el proyecto se encuentra en modo lectura y solo un usuario puede editar un determinado archivo versionado (Ej.: un proceso).
===== Editar un procesos =====
* Seleccionar el proceso a editar.
* Menú contextual -> VCS -> edit.
Esto habilita al usuario a modificar el proceso. En caso de que exitiera otro usuario modificando el proceso nos aparecerá un mensaje de error.

===== Grabar los cambios realizados en un proceso =====
* Seleccionar el proceso que se esta editando.
* Menú contextual -> VCS -> commit.
Este paso es importante, debido a que si se libera la edición del proceso sin realizar el commit se perderán los cambios.

===== Liberar la edición del proceso =====
* Seleccionar el proceso que se esta editando.
* Menú contextual -> VCS -> unedit.

===Pasaje de Parametros===

Para pasar parámetros al proceso desde una actividad de creación (aquellas que dan inicio al proceso) que tenga asociada un ScreenFlow, hay que seguir los siguientes pasos.

El primer paso es decirle al proceso que va a recibir parametros de la siguiente manera:

* Doble click en la tarea "begin" y luego en "Argument Mapping"
[[Archivo:Imagen 1.jpg]]
* Click en el botón que parece una flecha violeta hacia abajo y ahí agregamos el nombre del parametro que va a recibir. Es recomendable utilizar nombres descriptivos ya que sino se puede volver bastante confuso.
[[Archivo:Imagen 2.jpg]]
* Ahora lo único que falta es mapear el parámetro a una variable del proceso (puede ser creada en la misma pantalla haciendo click sobre el botón que está al lado del de crear parametros)
[[Archivo:Imagen 3.jpg]]

El segundo paso es realizar un proceso similar al primer paso, con la diferencia que debe hacerce en la tarea "end" del ScreenFlow asociado a la actividad de creación.

El tercer paso es mapear las salidas del ScreenFlow con las Entradas del proceso de la siguiente manera:

* Doble click en la actividad que tiene asociada el ScreenFlow, luego en "Argument Mapping" y luego en la barra de la izquiera seleccionar "NombreDelScreenFlow Out"
[[Archivo:Imagen 4.jpg]]
* Luego solo basta con mapear los argumentos, seleccionando los nombres
[[Archivo:Imagen 5.jpg]]

===Incluir un jar y utilizarlo===
Una vez que tenemos creado nuestro proyecto BPM podemos llegar a necesitar utilizar ciertas clases de java, tanto para modelar entidades como para invocar servicios externos a nuestro proyecto.

En el caso que necesitemos incluír alguna librería al proyecto BPM los pasos a realizar son los siguientes:

* En "Recursos externos" hacer botón derecho y seleccionar la opción "Nuevo recurso externo".
* Seleccionar un nombre y en tipo seleccionar "Biblioteca de clase Java".
* Le damos clic al botón "Agregar" y buscamos el jar correspondiente que vamos a querer incluír.
* Aceptar.

Finalizado estos pasos vamos a ver que se agregó a "Recursos externos" la librería que acabamos de incluir. Lo siguiente va a ser crear un módulo desde el cual invocar a las clases de nuestro jar. Para esto tenemos que hacer lo siguiente:

* En "Catálogo" hacemos botón derecho y seleccionamos la opción "Crear módulo".
* Le ponemos un nombre y le damos Aceptar.
* Realizado esto, veremos que se agregó un módulo al Catálogo. Lo que tenemos que hacer ahora es indicarle a ese módulo que contenga la configuración de nuestro jar. Para esto hacemos clic derecho sobre el módulo > Componente de catálogo > Java.
* Seleccionamos la opción "Usar una configuración existente" (está marcada por defecto) y en el combo seleccionamos nuestro recurso externo que agregamos antes.
* Luego, seleccionaremos las clases Java que quiero incluír en mi módulo.
* Se hará la carga de clases automáticamente.
* Finalizado esto deberíamos ver dentro de "Catálogo" nuestro módulo nuevo y al amplicar su contenido ver el árbol de las clases que incluímos en él.

Para poder usar estas clases que incluímos, dentro de una actividad se podrán crear instancias de esta forma:

<code java>ClaseDeMiBiblioteca instancia = new ClaseDeMiBiblioteca();</code>

e invocar a sus métodos de esta forma:

<code java>ObjetoRespuesta respuesta = (ObjetoRespuesta) instancia.metodo(arg1 : parametroAEnviar);</code>

===Tratamiento de excepciones de servicios externos===
Puede suceder que, al momento de invocar algún servicio externo a nuestro proyecto de BPM, este retorne como respuesta una excepción. Para poder darle un comportamiento a nuestro proceso en BPM se puede utilizar una transición del tipo "Excepción" entre dos actividades.

Para dar un ejemplo concreto vamos a imaginarnos 2 actividades a las que llamaremos "Inicio" y "Comportamiento correcto". La actividad "Inicio" invocará a un servicio, y si sale todo bien, se pasará luego a la actividad "Comportamiento correcto".

[[Archivo:1.jpg]]

Ahora, puede suceder que cuando "Inicio" invoca al servicio, éste devuelva una Excepción. ¿Qué hacemos en ese caso? Creamos una actividad (en nuestro ejemplo es "Comportamiento excepción"), la cual nuestro sistema ejecutará en caso de que el servicio falle, y le asociamos una transición entre "Inicio" y esta nueva actividad de esta forma:

[[Archivo:2.jpg]]

Para crear dicha transición, debemos crear la actividad a la cual asociarla, dale doble clic y luego seleccionar como tipo de transición aquella que dice "Excepción". Para indicarle para qué tipo de Excepción queremos que se siga dicho flujo, en "Nombre de excepción" deberemos cargar la clase con la excepción que puede llegar.
===Creación de Instancias mediante PBL===
Para crear instancias de procesos mediante PBL se utiliza el siguiente código:
<code java>
logMessage("DOS_IDEAS: Creando la instancia ConsumidorProceso", severity : Severity.DEBUG);

String mensaje = "Este es un mensaje creado por el productor a las " + 'now';
ProcessInstance.create(processId : ProcessInstance.organization + "/" + ProcessInstance.organizationalUnit + "/ConsumidorProceso",
arguments : { "mensaje_InArgument" : mensaje }, argumentsSetName : "BeginIn");
</code>
Donde:
* '''processId''' es el identificador (no el nombre) del proceso que queremos crear, en nuestro caso vamos a crear el proceso "ConsumidorProceso".
* '''arguments''' es el array de argumentos de entrada que se definio en el proceso.

En el siguiente link podemos descargarnos un ejemplo del svn:
[https://dosideas-aplicaciones-modelo.googlecode.com/svn/BPM_Ejemplos/trunk/CrearInstanciaConPBL.fpr.exp Crear Instancia mediante PBL]

===Manipulación de Instancias mediante PAPI===
Aqualogic BPM 5.7, provee una API para trabajar con el FDI. Esta API se la conoce como PAPI.
Una de las cosas que nos permite realizar es obtener una instancia de BPM y manipular dicha instancia.
A continuación tenemos un ejemplo de como abortar una instancia:
<code java>
logMessage("DOS_IDEAS: Cerrando instancia con nombre [" + identificador + "]", severity : Severity.DEBUG);

ProcessService processService = ProcessService();
try {
processService.connectTo(url : Fuego.Server.directoryURL, user : "tester", password : "tester");

Instance[] instances = { };
InstanceFilter instanciaFilter = InstanceFilter();
instanciaFilter.create(processService : processService);

SearchScope searchScope = SearchScope(participantScope : ParticipantScope.ALL,
statusScope : StatusScope.ONLY_INPROCESS);
instanciaFilter.searchScope = searchScope;
instanciaFilter.addAttributeTo(variable : "identificador", comparator : Comparison.IS,
value : unaVariable);

instances = processService.getInstancesByFilter(filter : instanciaFilter);

foreach (unaInstancia in instances) {
logMessage("DOS_IDEAS: Cerrando: " + unaInstancia, severity : Severity.DEBUG);

unaInstancia.abort();

logMessage("DOS_IDEAS: Instancia cerrada exitosamente", severity : Severity.DEBUG);
}
}
catch (Java.Lang.Exception ex) {
logMessage("DOS_IDEAS: Error al abortar instancia [" + identificador + "]: " + ex.message, severity : Severity.DEBUG);
}
finally {
processService.disconnectFrom();
}
</code>

====Creamos la conexión al FDI====
Se debe provee un usuario y password existente en la aplicación y que tenga los permisos para poder manipular la instancia.
En caso de que se este utilizando el Studio, el password es el mismo que el user.
<code java>
ProcessService processService = ProcessService();
processService.connectTo(url : Fuego.Server.directoryURL, user : "tester", password : "tester");
</code>
La conexión debe ser finalizada mediante el método disconnectFrom
<code java>
processService.disconnectFrom();
</code>

====Creamos el filtro====
Crea un filtro para buscar las instancias en el FDI.
<code java>
InstanceFilter instanciaFilter = InstanceFilter();
instanciaFilter.create(processService : processService);
</code>

Agregamos al filtro, la condición de que obtenga la instancia de todos los participantes y que se encuentren en proceso.
<code java>
SearchScope searchScope = SearchScope(participantScope : ParticipantScope.ALL,
statusScope : StatusScope.ONLY_INPROCESS);
instanciaFilter.searchScope = searchScope;
</code>
El alcance de los participantes pueden ser:
* '''ALL''': todos los participantes.
* '''ALL_IN_ROLE''': todas las instancias del rol.
* '''PARTICIPANT''': todas las instancias del participante.
* '''PARTICIPANT_ROLE''': todas las intancias de los roles del participante.

Agregamos un filtro, para que filtre las instancia cuya '''variable externa''' identificador tenga el valor de unaVariable

<code java>
instanciaFilter.addAttributeTo(variable : "identificador", comparator : Comparison.IS, value : unaVariable);
</code>

====Obtenemos las instancias====
Obtenemos el listado de instancia que concuerdan con el filtro instanciaFilter
<code java>
Instance[] instances = processService.getInstancesByFilter(filter : instanciaFilter);
</code>

====Manipulamos las instancias obtenidas====
Recorremos la lista de instancias obtenidas y en nuestro caso las abortamos.
<code java>
foreach (unaInstancia in instances) {
unaInstancia.abort();
}
</code>
Las posibles acciones que podemos realizar sobre una instancia son:
* '''abort''': Cancela la instancia.
* '''suspend''': Suspende la instancia.
* '''select''': Selecciona la instancia.
* '''reasign''': Reasigna la instancia a un participante.
=== Ver también ===
* [[Oracle BPM]]

[[Category:Oracle]]

BEA Aqualogic BPM 5.7 (Fuego)

2011-12-26T15:08:10Z

Shichibukai: /* Creación de Instancias mediante PBL */

===Comunicando con Base de Datos con PBL (Process Business Language)===

Para ejecutar comandos SQL en Aqualogic BPM 5.7 hay que seguir los siguientes pasos:

====Primer paso====

Se debe crear nuevo "External Resource", haciendo click derecho en el directorio del proyecto "External Resources", del tipo "SQL Database". Los campos se deben completar con la información de la base de datos que queremos consultar y con un nombre significativo.

====Segundo paso====

Se debe crear un nuevo "BPM Object", haciendo click derecho sobre el modulo deseado en el directorio de "Catalog", y luego crear un método en nuestro objeto, haciendo click derecho sobre el objeto y seleccionando la opción "New Method". Ahora se debe editar el nuevo método, expandiendo el objeto bpm y haciendo doble click sobre el nombre del método creado. Ahora podemos editarlo e incluir el código necesario para comunicarnos con la BD a través de una clase propia de Fuego, un ejemplo de implementación puede ser el siguiente:

<code java>
String queryAEjecutar ="SELECT campo1, campo2, campo3 FROM nombreTabla WHERE nombreColumna in (?,?)";

String nombreDeLaBDCreada = "NombreBD";

String[] arrayDeParametros = {"valor1", "valor2"};

Iterator <Any[Any]> iterator = DynamicSQL.executeQuery(sentence : queryAEjecutar, implname : nombreDeLaBDCreada, inParameters : arrayDeParametros);
</code>

Como se puede observar, el resultado de realizar la consulta va a ser un iterador, que luego puede ser recorrido con un "foreach".

<code java>
foreach (e in iterator) {

logMessage("campo1: "+e["campo1"], severity : INFO);

logMessage("campo2: "+e["campo2"], severity : INFO);

logMessage("campo3: "+e["campo3"], severity : INFO);

logMessage("nombreColumna: "+e["nombreColumna"], severity : INFO);

}
</code>

=== Versionando con CVS ===
El producto Aqualogic BPM 5.7 incluye un cliente de CVS que permite agregar, remover, actualizar en un repositorio CVS.

==== Configurar el cliente CVS ====
* Levantar el Studio BPM.
* File -> Preference ->Default Version Control
** Version Control Manger: CVS
** Host: host del servidor CVS
** User Name: usuario del CVS
** User Password: password del usuario CVS
** path: ruta dentro del repositorio donde se guardará el proyecto.

==== Subir el proyecto al CVS ====
* Levantar el Studio BPM.
* Abrir el proyecto a versionar.
* File -> Project Preference -> Project Version Control.
** Version Control Manager: CVS (nos carga la información ingresada en el punto anterior).
* File -> VCS -> Store project in repository
** Path: directorio en el que se creará el proyecto en el repositorio.
** Si es la primera vez que se sube un proyecto de Aqualogic BPM, pedirá que se ingrese la ruta del directorio donde se creará el "common catalog"
*** Common catalog: Es un catalogo de componente, el cual puede ser compartido por otros proyectos de Aqualogic BPM.
En el repositorio quedarán creados 2 directorios, el del proyecto y el del common catalog, ademas se crearán 2 alias en el CVS que apuntan al proyecto y al common catalog.

==== Obtener el proyecto del CVS ====
* Levantar el Studio BPM.
* File -> Project Preference -> Project Version Control.
* File -> Import -> Project -> from Repository.
** Version Control Manager: CVS
** En la siguiente pantalla, seleccionar el proyecto del repositorio.

==== Trabajar con proyectos versionados ====
Aqualogic BPM 5.7, posee una política restrictiva de edición para los proyecto versionados.
La política, consiste en que todo el proyecto se encuentra en modo lectura y solo un usuario puede editar un determinado archivo versionado (Ej.: un proceso).
===== Editar un procesos =====
* Seleccionar el proceso a editar.
* Menú contextual -> VCS -> edit.
Esto habilita al usuario a modificar el proceso. En caso de que exitiera otro usuario modificando el proceso nos aparecerá un mensaje de error.

===== Grabar los cambios realizados en un proceso =====
* Seleccionar el proceso que se esta editando.
* Menú contextual -> VCS -> commit.
Este paso es importante, debido a que si se libera la edición del proceso sin realizar el commit se perderán los cambios.

===== Liberar la edición del proceso =====
* Seleccionar el proceso que se esta editando.
* Menú contextual -> VCS -> unedit.

===Pasaje de Parametros===

Para pasar parámetros al proceso desde una actividad de creación (aquellas que dan inicio al proceso) que tenga asociada un ScreenFlow, hay que seguir los siguientes pasos.

El primer paso es decirle al proceso que va a recibir parametros de la siguiente manera:

* Doble click en la tarea "begin" y luego en "Argument Mapping"
[[Archivo:Imagen 1.jpg]]
* Click en el botón que parece una flecha violeta hacia abajo y ahí agregamos el nombre del parametro que va a recibir. Es recomendable utilizar nombres descriptivos ya que sino se puede volver bastante confuso.
[[Archivo:Imagen 2.jpg]]
* Ahora lo único que falta es mapear el parámetro a una variable del proceso (puede ser creada en la misma pantalla haciendo click sobre el botón que está al lado del de crear parametros)
[[Archivo:Imagen 3.jpg]]

El segundo paso es realizar un proceso similar al primer paso, con la diferencia que debe hacerce en la tarea "end" del ScreenFlow asociado a la actividad de creación.

El tercer paso es mapear las salidas del ScreenFlow con las Entradas del proceso de la siguiente manera:

* Doble click en la actividad que tiene asociada el ScreenFlow, luego en "Argument Mapping" y luego en la barra de la izquiera seleccionar "NombreDelScreenFlow Out"
[[Archivo:Imagen 4.jpg]]
* Luego solo basta con mapear los argumentos, seleccionando los nombres
[[Archivo:Imagen 5.jpg]]

===Incluir un jar y utilizarlo===
Una vez que tenemos creado nuestro proyecto BPM podemos llegar a necesitar utilizar ciertas clases de java, tanto para modelar entidades como para invocar servicios externos a nuestro proyecto.

En el caso que necesitemos incluír alguna librería al proyecto BPM los pasos a realizar son los siguientes:

* En "Recursos externos" hacer botón derecho y seleccionar la opción "Nuevo recurso externo".
* Seleccionar un nombre y en tipo seleccionar "Biblioteca de clase Java".
* Le damos clic al botón "Agregar" y buscamos el jar correspondiente que vamos a querer incluír.
* Aceptar.

Finalizado estos pasos vamos a ver que se agregó a "Recursos externos" la librería que acabamos de incluir. Lo siguiente va a ser crear un módulo desde el cual invocar a las clases de nuestro jar. Para esto tenemos que hacer lo siguiente:

* En "Catálogo" hacemos botón derecho y seleccionamos la opción "Crear módulo".
* Le ponemos un nombre y le damos Aceptar.
* Realizado esto, veremos que se agregó un módulo al Catálogo. Lo que tenemos que hacer ahora es indicarle a ese módulo que contenga la configuración de nuestro jar. Para esto hacemos clic derecho sobre el módulo > Componente de catálogo > Java.
* Seleccionamos la opción "Usar una configuración existente" (está marcada por defecto) y en el combo seleccionamos nuestro recurso externo que agregamos antes.
* Luego, seleccionaremos las clases Java que quiero incluír en mi módulo.
* Se hará la carga de clases automáticamente.
* Finalizado esto deberíamos ver dentro de "Catálogo" nuestro módulo nuevo y al amplicar su contenido ver el árbol de las clases que incluímos en él.

Para poder usar estas clases que incluímos, dentro de una actividad se podrán crear instancias de esta forma:

<code java>ClaseDeMiBiblioteca instancia = new ClaseDeMiBiblioteca();</code>

e invocar a sus métodos de esta forma:

<code java>ObjetoRespuesta respuesta = (ObjetoRespuesta) instancia.metodo(arg1 : parametroAEnviar);</code>

===Tratamiento de excepciones de servicios externos===
Puede suceder que, al momento de invocar algún servicio externo a nuestro proyecto de BPM, este retorne como respuesta una excepción. Para poder darle un comportamiento a nuestro proceso en BPM se puede utilizar una transición del tipo "Excepción" entre dos actividades.

Para dar un ejemplo concreto vamos a imaginarnos 2 actividades a las que llamaremos "Inicio" y "Comportamiento correcto". La actividad "Inicio" invocará a un servicio, y si sale todo bien, se pasará luego a la actividad "Comportamiento correcto".

[[Archivo:1.jpg]]

Ahora, puede suceder que cuando "Inicio" invoca al servicio, éste devuelva una Excepción. ¿Qué hacemos en ese caso? Creamos una actividad (en nuestro ejemplo es "Comportamiento excepción"), la cual nuestro sistema ejecutará en caso de que el servicio falle, y le asociamos una transición entre "Inicio" y esta nueva actividad de esta forma:

[[Archivo:2.jpg]]

Para crear dicha transición, debemos crear la actividad a la cual asociarla, dale doble clic y luego seleccionar como tipo de transición aquella que dice "Excepción". Para indicarle para qué tipo de Excepción queremos que se siga dicho flujo, en "Nombre de excepción" deberemos cargar la clase con la excepción que puede llegar.
===Creación de Instancias mediante PBL===
Para crear instancias de procesos mediante PBL se utiliza el siguiente código:
<code java>
logMessage("DOS_IDEAS: Creando la instancia ConsumidorProceso", severity : Severity.DEBUG);

String mensaje = "Este es un mensaje creado por el productor a las " + 'now';
ProcessInstance.create(processId : ProcessInstance.organization + "/" + ProcessInstance.organizationalUnit + "/ConsumidorProceso",
arguments : { "mensaje_InArgument" : mensaje }, argumentsSetName : "BeginIn");
</code>
Donde:
* '''processId''' es el identificador (no el nombre) del proceso que queremos crear, en nuestro caso vamos a crear el proceso "ConsumidorProceso".
* '''arguments''' es el array de argumentos de entrada que se definio en el proceso.

En el siguiente link podemos descargarnos un ejemplo del svn:
[https://dosideas-aplicaciones-modelo.googlecode.com/svn/BPM_Ejemplos/trunk/CrearInstanciaConPBL.fpr.exp Crear Instancia mediante PBL]

=== Ver también ===
* [[Oracle BPM]]

[[Category:Oracle]]

BEA Aqualogic BPM 5.7 (Fuego)

2011-12-26T15:04:33Z

Shichibukai: /* Creación de Instancias mediante PBL */

===Comunicando con Base de Datos con PBL (Process Business Language)===

Para ejecutar comandos SQL en Aqualogic BPM 5.7 hay que seguir los siguientes pasos:

====Primer paso====

Se debe crear nuevo "External Resource", haciendo click derecho en el directorio del proyecto "External Resources", del tipo "SQL Database". Los campos se deben completar con la información de la base de datos que queremos consultar y con un nombre significativo.

====Segundo paso====

Se debe crear un nuevo "BPM Object", haciendo click derecho sobre el modulo deseado en el directorio de "Catalog", y luego crear un método en nuestro objeto, haciendo click derecho sobre el objeto y seleccionando la opción "New Method". Ahora se debe editar el nuevo método, expandiendo el objeto bpm y haciendo doble click sobre el nombre del método creado. Ahora podemos editarlo e incluir el código necesario para comunicarnos con la BD a través de una clase propia de Fuego, un ejemplo de implementación puede ser el siguiente:

<code java>
String queryAEjecutar ="SELECT campo1, campo2, campo3 FROM nombreTabla WHERE nombreColumna in (?,?)";

String nombreDeLaBDCreada = "NombreBD";

String[] arrayDeParametros = {"valor1", "valor2"};

Iterator <Any[Any]> iterator = DynamicSQL.executeQuery(sentence : queryAEjecutar, implname : nombreDeLaBDCreada, inParameters : arrayDeParametros);
</code>

Como se puede observar, el resultado de realizar la consulta va a ser un iterador, que luego puede ser recorrido con un "foreach".

<code java>
foreach (e in iterator) {

logMessage("campo1: "+e["campo1"], severity : INFO);

logMessage("campo2: "+e["campo2"], severity : INFO);

logMessage("campo3: "+e["campo3"], severity : INFO);

logMessage("nombreColumna: "+e["nombreColumna"], severity : INFO);

}
</code>

=== Versionando con CVS ===
El producto Aqualogic BPM 5.7 incluye un cliente de CVS que permite agregar, remover, actualizar en un repositorio CVS.

==== Configurar el cliente CVS ====
* Levantar el Studio BPM.
* File -> Preference ->Default Version Control
** Version Control Manger: CVS
** Host: host del servidor CVS
** User Name: usuario del CVS
** User Password: password del usuario CVS
** path: ruta dentro del repositorio donde se guardará el proyecto.

==== Subir el proyecto al CVS ====
* Levantar el Studio BPM.
* Abrir el proyecto a versionar.
* File -> Project Preference -> Project Version Control.
** Version Control Manager: CVS (nos carga la información ingresada en el punto anterior).
* File -> VCS -> Store project in repository
** Path: directorio en el que se creará el proyecto en el repositorio.
** Si es la primera vez que se sube un proyecto de Aqualogic BPM, pedirá que se ingrese la ruta del directorio donde se creará el "common catalog"
*** Common catalog: Es un catalogo de componente, el cual puede ser compartido por otros proyectos de Aqualogic BPM.
En el repositorio quedarán creados 2 directorios, el del proyecto y el del common catalog, ademas se crearán 2 alias en el CVS que apuntan al proyecto y al common catalog.

==== Obtener el proyecto del CVS ====
* Levantar el Studio BPM.
* File -> Project Preference -> Project Version Control.
* File -> Import -> Project -> from Repository.
** Version Control Manager: CVS
** En la siguiente pantalla, seleccionar el proyecto del repositorio.

==== Trabajar con proyectos versionados ====
Aqualogic BPM 5.7, posee una política restrictiva de edición para los proyecto versionados.
La política, consiste en que todo el proyecto se encuentra en modo lectura y solo un usuario puede editar un determinado archivo versionado (Ej.: un proceso).
===== Editar un procesos =====
* Seleccionar el proceso a editar.
* Menú contextual -> VCS -> edit.
Esto habilita al usuario a modificar el proceso. En caso de que exitiera otro usuario modificando el proceso nos aparecerá un mensaje de error.

===== Grabar los cambios realizados en un proceso =====
* Seleccionar el proceso que se esta editando.
* Menú contextual -> VCS -> commit.
Este paso es importante, debido a que si se libera la edición del proceso sin realizar el commit se perderán los cambios.

===== Liberar la edición del proceso =====
* Seleccionar el proceso que se esta editando.
* Menú contextual -> VCS -> unedit.

===Pasaje de Parametros===

Para pasar parámetros al proceso desde una actividad de creación (aquellas que dan inicio al proceso) que tenga asociada un ScreenFlow, hay que seguir los siguientes pasos.

El primer paso es decirle al proceso que va a recibir parametros de la siguiente manera:

* Doble click en la tarea "begin" y luego en "Argument Mapping"
[[Archivo:Imagen 1.jpg]]
* Click en el botón que parece una flecha violeta hacia abajo y ahí agregamos el nombre del parametro que va a recibir. Es recomendable utilizar nombres descriptivos ya que sino se puede volver bastante confuso.
[[Archivo:Imagen 2.jpg]]
* Ahora lo único que falta es mapear el parámetro a una variable del proceso (puede ser creada en la misma pantalla haciendo click sobre el botón que está al lado del de crear parametros)
[[Archivo:Imagen 3.jpg]]

El segundo paso es realizar un proceso similar al primer paso, con la diferencia que debe hacerce en la tarea "end" del ScreenFlow asociado a la actividad de creación.

El tercer paso es mapear las salidas del ScreenFlow con las Entradas del proceso de la siguiente manera:

* Doble click en la actividad que tiene asociada el ScreenFlow, luego en "Argument Mapping" y luego en la barra de la izquiera seleccionar "NombreDelScreenFlow Out"
[[Archivo:Imagen 4.jpg]]
* Luego solo basta con mapear los argumentos, seleccionando los nombres
[[Archivo:Imagen 5.jpg]]

===Incluir un jar y utilizarlo===
Una vez que tenemos creado nuestro proyecto BPM podemos llegar a necesitar utilizar ciertas clases de java, tanto para modelar entidades como para invocar servicios externos a nuestro proyecto.

En el caso que necesitemos incluír alguna librería al proyecto BPM los pasos a realizar son los siguientes:

* En "Recursos externos" hacer botón derecho y seleccionar la opción "Nuevo recurso externo".
* Seleccionar un nombre y en tipo seleccionar "Biblioteca de clase Java".
* Le damos clic al botón "Agregar" y buscamos el jar correspondiente que vamos a querer incluír.
* Aceptar.

Finalizado estos pasos vamos a ver que se agregó a "Recursos externos" la librería que acabamos de incluir. Lo siguiente va a ser crear un módulo desde el cual invocar a las clases de nuestro jar. Para esto tenemos que hacer lo siguiente:

* En "Catálogo" hacemos botón derecho y seleccionamos la opción "Crear módulo".
* Le ponemos un nombre y le damos Aceptar.
* Realizado esto, veremos que se agregó un módulo al Catálogo. Lo que tenemos que hacer ahora es indicarle a ese módulo que contenga la configuración de nuestro jar. Para esto hacemos clic derecho sobre el módulo > Componente de catálogo > Java.
* Seleccionamos la opción "Usar una configuración existente" (está marcada por defecto) y en el combo seleccionamos nuestro recurso externo que agregamos antes.
* Luego, seleccionaremos las clases Java que quiero incluír en mi módulo.
* Se hará la carga de clases automáticamente.
* Finalizado esto deberíamos ver dentro de "Catálogo" nuestro módulo nuevo y al amplicar su contenido ver el árbol de las clases que incluímos en él.

Para poder usar estas clases que incluímos, dentro de una actividad se podrán crear instancias de esta forma:

<code java>ClaseDeMiBiblioteca instancia = new ClaseDeMiBiblioteca();</code>

e invocar a sus métodos de esta forma:

<code java>ObjetoRespuesta respuesta = (ObjetoRespuesta) instancia.metodo(arg1 : parametroAEnviar);</code>

===Tratamiento de excepciones de servicios externos===
Puede suceder que, al momento de invocar algún servicio externo a nuestro proyecto de BPM, este retorne como respuesta una excepción. Para poder darle un comportamiento a nuestro proceso en BPM se puede utilizar una transición del tipo "Excepción" entre dos actividades.

Para dar un ejemplo concreto vamos a imaginarnos 2 actividades a las que llamaremos "Inicio" y "Comportamiento correcto". La actividad "Inicio" invocará a un servicio, y si sale todo bien, se pasará luego a la actividad "Comportamiento correcto".

[[Archivo:1.jpg]]

Ahora, puede suceder que cuando "Inicio" invoca al servicio, éste devuelva una Excepción. ¿Qué hacemos en ese caso? Creamos una actividad (en nuestro ejemplo es "Comportamiento excepción"), la cual nuestro sistema ejecutará en caso de que el servicio falle, y le asociamos una transición entre "Inicio" y esta nueva actividad de esta forma:

[[Archivo:2.jpg]]

Para crear dicha transición, debemos crear la actividad a la cual asociarla, dale doble clic y luego seleccionar como tipo de transición aquella que dice "Excepción". Para indicarle para qué tipo de Excepción queremos que se siga dicho flujo, en "Nombre de excepción" deberemos cargar la clase con la excepción que puede llegar.
===Creación de Instancias mediante PBL===
Para crear instancias de procesos mediante PBL se utiliza el siguiente código:
<code java>
logMessage("DOS_IDEAS: Creando la instancia ConsumidorProceso", severity : Severity.DEBUG);

String mensaje = "Este es un mensaje creado por el productor a las " + 'now';
ProcessInstance.create(processId : ProcessInstance.organization + "/" + ProcessInstance.organizationalUnit + "/ConsumidorProceso",
arguments : { "mensaje_InArgument" : mensaje }, argumentsSetName : "BeginIn");
</code>
Donde:
* '''processId''' es el identificador (no el nombre) del proceso que queremos crear, en nuestro caso vamos a crear el proceso "ConsumidorProceso".
* '''arguments''' es el array de argumentos de entrada que se definio en el proceso.

En el siguiente link podemos descargarnos un ejemplo del svn:
[https://dosideas-aplicaciones-modelo.googlecode.com/svn/BPM_Ejemplos/trunk/CrearInstanciaConPBL.fpr Crear Instancia mediante PBL]

=== Ver también ===
* [[Oracle BPM]]

[[Category:Oracle]]

BEA Aqualogic BPM 5.7 (Fuego)

2011-12-26T15:03:49Z

Shichibukai: /* Creación de Instancias mediante PBL */

===Comunicando con Base de Datos con PBL (Process Business Language)===

Para ejecutar comandos SQL en Aqualogic BPM 5.7 hay que seguir los siguientes pasos:

====Primer paso====

Se debe crear nuevo "External Resource", haciendo click derecho en el directorio del proyecto "External Resources", del tipo "SQL Database". Los campos se deben completar con la información de la base de datos que queremos consultar y con un nombre significativo.

====Segundo paso====

Se debe crear un nuevo "BPM Object", haciendo click derecho sobre el modulo deseado en el directorio de "Catalog", y luego crear un método en nuestro objeto, haciendo click derecho sobre el objeto y seleccionando la opción "New Method". Ahora se debe editar el nuevo método, expandiendo el objeto bpm y haciendo doble click sobre el nombre del método creado. Ahora podemos editarlo e incluir el código necesario para comunicarnos con la BD a través de una clase propia de Fuego, un ejemplo de implementación puede ser el siguiente:

<code java>
String queryAEjecutar ="SELECT campo1, campo2, campo3 FROM nombreTabla WHERE nombreColumna in (?,?)";

String nombreDeLaBDCreada = "NombreBD";

String[] arrayDeParametros = {"valor1", "valor2"};

Iterator <Any[Any]> iterator = DynamicSQL.executeQuery(sentence : queryAEjecutar, implname : nombreDeLaBDCreada, inParameters : arrayDeParametros);
</code>

Como se puede observar, el resultado de realizar la consulta va a ser un iterador, que luego puede ser recorrido con un "foreach".

<code java>
foreach (e in iterator) {

logMessage("campo1: "+e["campo1"], severity : INFO);

logMessage("campo2: "+e["campo2"], severity : INFO);

logMessage("campo3: "+e["campo3"], severity : INFO);

logMessage("nombreColumna: "+e["nombreColumna"], severity : INFO);

}
</code>

=== Versionando con CVS ===
El producto Aqualogic BPM 5.7 incluye un cliente de CVS que permite agregar, remover, actualizar en un repositorio CVS.

==== Configurar el cliente CVS ====
* Levantar el Studio BPM.
* File -> Preference ->Default Version Control
** Version Control Manger: CVS
** Host: host del servidor CVS
** User Name: usuario del CVS
** User Password: password del usuario CVS
** path: ruta dentro del repositorio donde se guardará el proyecto.

==== Subir el proyecto al CVS ====
* Levantar el Studio BPM.
* Abrir el proyecto a versionar.
* File -> Project Preference -> Project Version Control.
** Version Control Manager: CVS (nos carga la información ingresada en el punto anterior).
* File -> VCS -> Store project in repository
** Path: directorio en el que se creará el proyecto en el repositorio.
** Si es la primera vez que se sube un proyecto de Aqualogic BPM, pedirá que se ingrese la ruta del directorio donde se creará el "common catalog"
*** Common catalog: Es un catalogo de componente, el cual puede ser compartido por otros proyectos de Aqualogic BPM.
En el repositorio quedarán creados 2 directorios, el del proyecto y el del common catalog, ademas se crearán 2 alias en el CVS que apuntan al proyecto y al common catalog.

==== Obtener el proyecto del CVS ====
* Levantar el Studio BPM.
* File -> Project Preference -> Project Version Control.
* File -> Import -> Project -> from Repository.
** Version Control Manager: CVS
** En la siguiente pantalla, seleccionar el proyecto del repositorio.

==== Trabajar con proyectos versionados ====
Aqualogic BPM 5.7, posee una política restrictiva de edición para los proyecto versionados.
La política, consiste en que todo el proyecto se encuentra en modo lectura y solo un usuario puede editar un determinado archivo versionado (Ej.: un proceso).
===== Editar un procesos =====
* Seleccionar el proceso a editar.
* Menú contextual -> VCS -> edit.
Esto habilita al usuario a modificar el proceso. En caso de que exitiera otro usuario modificando el proceso nos aparecerá un mensaje de error.

===== Grabar los cambios realizados en un proceso =====
* Seleccionar el proceso que se esta editando.
* Menú contextual -> VCS -> commit.
Este paso es importante, debido a que si se libera la edición del proceso sin realizar el commit se perderán los cambios.

===== Liberar la edición del proceso =====
* Seleccionar el proceso que se esta editando.
* Menú contextual -> VCS -> unedit.

===Pasaje de Parametros===

Para pasar parámetros al proceso desde una actividad de creación (aquellas que dan inicio al proceso) que tenga asociada un ScreenFlow, hay que seguir los siguientes pasos.

El primer paso es decirle al proceso que va a recibir parametros de la siguiente manera:

* Doble click en la tarea "begin" y luego en "Argument Mapping"
[[Archivo:Imagen 1.jpg]]
* Click en el botón que parece una flecha violeta hacia abajo y ahí agregamos el nombre del parametro que va a recibir. Es recomendable utilizar nombres descriptivos ya que sino se puede volver bastante confuso.
[[Archivo:Imagen 2.jpg]]
* Ahora lo único que falta es mapear el parámetro a una variable del proceso (puede ser creada en la misma pantalla haciendo click sobre el botón que está al lado del de crear parametros)
[[Archivo:Imagen 3.jpg]]

El segundo paso es realizar un proceso similar al primer paso, con la diferencia que debe hacerce en la tarea "end" del ScreenFlow asociado a la actividad de creación.

El tercer paso es mapear las salidas del ScreenFlow con las Entradas del proceso de la siguiente manera:

* Doble click en la actividad que tiene asociada el ScreenFlow, luego en "Argument Mapping" y luego en la barra de la izquiera seleccionar "NombreDelScreenFlow Out"
[[Archivo:Imagen 4.jpg]]
* Luego solo basta con mapear los argumentos, seleccionando los nombres
[[Archivo:Imagen 5.jpg]]

===Incluir un jar y utilizarlo===
Una vez que tenemos creado nuestro proyecto BPM podemos llegar a necesitar utilizar ciertas clases de java, tanto para modelar entidades como para invocar servicios externos a nuestro proyecto.

En el caso que necesitemos incluír alguna librería al proyecto BPM los pasos a realizar son los siguientes:

* En "Recursos externos" hacer botón derecho y seleccionar la opción "Nuevo recurso externo".
* Seleccionar un nombre y en tipo seleccionar "Biblioteca de clase Java".
* Le damos clic al botón "Agregar" y buscamos el jar correspondiente que vamos a querer incluír.
* Aceptar.

Finalizado estos pasos vamos a ver que se agregó a "Recursos externos" la librería que acabamos de incluir. Lo siguiente va a ser crear un módulo desde el cual invocar a las clases de nuestro jar. Para esto tenemos que hacer lo siguiente:

* En "Catálogo" hacemos botón derecho y seleccionamos la opción "Crear módulo".
* Le ponemos un nombre y le damos Aceptar.
* Realizado esto, veremos que se agregó un módulo al Catálogo. Lo que tenemos que hacer ahora es indicarle a ese módulo que contenga la configuración de nuestro jar. Para esto hacemos clic derecho sobre el módulo > Componente de catálogo > Java.
* Seleccionamos la opción "Usar una configuración existente" (está marcada por defecto) y en el combo seleccionamos nuestro recurso externo que agregamos antes.
* Luego, seleccionaremos las clases Java que quiero incluír en mi módulo.
* Se hará la carga de clases automáticamente.
* Finalizado esto deberíamos ver dentro de "Catálogo" nuestro módulo nuevo y al amplicar su contenido ver el árbol de las clases que incluímos en él.

Para poder usar estas clases que incluímos, dentro de una actividad se podrán crear instancias de esta forma:

<code java>ClaseDeMiBiblioteca instancia = new ClaseDeMiBiblioteca();</code>

e invocar a sus métodos de esta forma:

<code java>ObjetoRespuesta respuesta = (ObjetoRespuesta) instancia.metodo(arg1 : parametroAEnviar);</code>

===Tratamiento de excepciones de servicios externos===
Puede suceder que, al momento de invocar algún servicio externo a nuestro proyecto de BPM, este retorne como respuesta una excepción. Para poder darle un comportamiento a nuestro proceso en BPM se puede utilizar una transición del tipo "Excepción" entre dos actividades.

Para dar un ejemplo concreto vamos a imaginarnos 2 actividades a las que llamaremos "Inicio" y "Comportamiento correcto". La actividad "Inicio" invocará a un servicio, y si sale todo bien, se pasará luego a la actividad "Comportamiento correcto".

[[Archivo:1.jpg]]

Ahora, puede suceder que cuando "Inicio" invoca al servicio, éste devuelva una Excepción. ¿Qué hacemos en ese caso? Creamos una actividad (en nuestro ejemplo es "Comportamiento excepción"), la cual nuestro sistema ejecutará en caso de que el servicio falle, y le asociamos una transición entre "Inicio" y esta nueva actividad de esta forma:

[[Archivo:2.jpg]]

Para crear dicha transición, debemos crear la actividad a la cual asociarla, dale doble clic y luego seleccionar como tipo de transición aquella que dice "Excepción". Para indicarle para qué tipo de Excepción queremos que se siga dicho flujo, en "Nombre de excepción" deberemos cargar la clase con la excepción que puede llegar.
===Creación de Instancias mediante PBL===
Para crear instancias de procesos mediante PBL se utiliza el siguiente código:
<code java>
logMessage("DOS_IDEAS: Creando la instancia ConsumidorProceso", severity : Severity.DEBUG);

String mensaje = "Este es un mensaje creado por el productor a las " + 'now';
ProcessInstance.create(processId : ProcessInstance.organization + "/" + ProcessInstance.organizationalUnit + "/ConsumidorProceso",
arguments : { "mensaje_InArgument" : mensaje }, argumentsSetName : "BeginIn");
</code>
Donde:
* '''processId''' es el identificador (no el nombre) del proceso que queremos crear, en nuestro caso vamos a crear el proceso "ConsumidorProceso".
* '''arguments''' es el array de argumentos de entrada que se definio en el proceso.

En el siguiente link podemos descargarnos un ejemplo del svn:
[[https://dosideas-aplicaciones-modelo.googlecode.com/svn/BPM_Ejemplos/trunk/CrearInstanciaConPBL.fpr Crear Instancia mediante PBL]]

=== Ver también ===
* [[Oracle BPM]]

[[Category:Oracle]]

BEA Aqualogic BPM 5.7 (Fuego)

2011-12-26T13:53:39Z

Shichibukai:

Selenium con DSL

2011-04-29T13:06:39Z

Shichibukai: /* Creando un test */

[[Selenium]] es una herramienta para pruebas de aplicaciones web. Quién tuvo la posibilidad de utilizarla, sabrá lo poderosa que es la herramienta, la cuál tiene diversas funciones para ejecutar con nuestra aplicación web.
Puede ocurrir, que nuestros test de [[Selenium]] se vayan complejizando a medida que nuestra aplicación crece, por lo que esta es una posible solución, combinando el poder de [[Selenium]] con un enfoque [[DSL]].

== Ejemplo ==
A continuación mostramos una propuesta de como encarar un test de [[Selenium]]con [[DSL]]. Para el ejemplo, suponemos un sistema de biblioteca, con las siguientes pantallas y su navegación.
Se puede observar que pare este sistemas planteamos dos roles de usuario, el Bibliotecario y el Socio.

[[Archivo:reservaLibro.jpg]]

=== Creando un test ===
En el siguiente test, vamos a probar la funcionalidad de la reserva de libro.
Para escribir el siguiente test, se utilizó una sintaxis acotada y simple con las siguientes reglas:

* '''ir'''''<NombreDeLaPagina>'': Los métodos que comiencen con el prefijo “ir”, nos retorna el nuevo contexto (página).
* '''verificar'''''<Descripción>'': Los métodos que comiencen con el prefijo "verificar", poseen los "assert" para comprobar alguna acción realizada en la página, este método siempre retona la misma página (this).
* '''ingresarComo'''''<Nombre del Rol>'': Rol con el que se probará el sistema.
* '''aceptar, cancelar, volver, buscar''': Son nombre de las acciones básica que se realizan en un página y pueden (o nó) devolver otra página.
* ''<acciones propias de la página>'' : Estos métodos realizan acciones sobre el sistema sin ir a otra página. Ej.: reservar

==== ReservaSeleniumDslTest ====
<code java>
package com.test.dsl;

import org.junit.AfterClass;
import org.junit.Assert;
import org.junit.BeforeClass;
import org.junit.Test;

public class ReservaSeleniumDslTest {

@BeforeClass
public static void setUpClass() throws Exception {
Usuario.inicializar();
}

@AfterClass
public static void tearDownClass() throws Exception {
Usuario.finalizar();
}

@Test
public void comoBibliotecarioQuieroRealizarUnaReserva() {
Usuario.ingresaComoBibliotecario()
.irReservaDeLibro()
.reservar()
.aceptar()
.verificarReserva()
.aceptar()
.salir();
}
}
</code>

De esta forma, escribimos el test de manera que al leer los métodos a los que se invoca, se entiende paso a paso lo que el test realiza, sin confundirnos con la implementación. Utilizando los patrones "method chaining" , "builder", "Page object" ayuda a realizar una abstracción de la implementación.

Si lo hubieramos realizado solo con selenium, el mismo test quedaría de la siguiente forma:

==== ReservaSeleniumTest ====

<code java>
@Test
public void comoBibliotecarioQuieroRealizarUnaReserva() {
//Ingresar
selenium.open("");
selenium.waitForPageToLoad(TIEMPO_ESPERA);
selenium.type("username", username);
selenium.type("password", password);
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA);
//ir Pagina reserva de Libro
selenium.click("link=ReservaLibro");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
//reservar
selenium.type("libro", "El señor de los anillos");
selenium.type("codSocio", "0001");
selenium.type("fechaHasta", "2011-01-01");
//Aceptar
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA)
//verficiar
Assert.assertTrue(selenium.isTextPresent("El señor de los anillos"));
Assert.assertTrue(selenium.isTextPresent("0001"));
Assert.assertTrue(selenium.isTextPresent("2011-01-01"));
//aceptar para volver a la home
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA)
//salir
selenium.click("link=logout");
}
</code>

A continuación las implementaciones de las clases utilizadas en el test.

==== Usuario ====

<code java>
package com.test.dsl;

import org.openqa.selenium.server.SeleniumServer;

import com.test.dsl.pagina.HomeBibliotecario;
import com.test.dsl.pagina.HomeUsuario;
import com.thoughtworks.selenium.DefaultSelenium;
import com.thoughtworks.selenium.Selenium;

public class Usuario {

public static final String TIEMPO_ESPERA = "90000";
public static final String VELOCIDAD_CERO = "0";
public static final String VELOCIDAD_TEST = "350";

private static SeleniumServer seleniumServer;
private static Selenium selenium ;

public static void inicializar() throws Exception {
seleniumServer = new SeleniumServer();
seleniumServer.start();
selenium = new DefaultSelenium("localhost", 4444, "*chrome", "http://localhost:8585/");
selenium.start();
}

public static void finalizar() {
selenium.stop();
seleniumServer.stop();
}

public static HomeBibliotecario ingresaComoBibliotecario() {
Usuario.login("bibliotecario_test","123456");
return new HomeBibliotecario(selenium);
}

public static HomeUsuario ingresaComoUsuario() {
Usuario.login("usuario_test","123456");
return new HomeUsuario(selenium);
}

private static void login(String username, String password) {
selenium.open("");
selenium.waitForPageToLoad(TIEMPO_ESPERA);
selenium.type("username", username);
selenium.type("password", password);
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA);

}
}

</code>

Esta clase es la que determina con que rol vamos a probar la aplicación.
El método '''ingresarComoBibliotecario''' instancia y devuelve un objeto de la clase '''HomeBibliotecario''' cuya implementación es:

==== HomeBibliotecario ====
<code java>
package com.test.dsl.pagina;

import com.test.dsl.Usuario;
import com.thoughtworks.selenium.Selenium;

public class HomeBibliotecario {

private Selenium selenium;

public HomeBibliotecario(Selenium selenium) {
this.selenium = selenium;
}

public ReservaDeLibro irReservaDeLibro() {
selenium.click("link=ReservaLibro");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
return new ReservaDeLibro(selenium);
}

public void salir() {
selenium.click("link=logout");
}
}
</code>

Volvemos a utilizar el patrón builder y el método ingresar denuncia devuelve un objeto de la clase AltaDenuncia. De esta manera, cada clase representa a una pantalla de la aplicación, y expone cada funcionalidad que la misma ofrece. AltaDenuncia sería así:
Volvemos a utilizar el patrón method chaining y el método '''irReservaDeLibro''' devuelve un objeto de la clase '''ReservaDeLibro'''. De esta manera, cada clase representa a una pantalla de la aplicación (page object), y expone cada funcionalidad que la misma ofrece (acciones que puedo realizar en la página y páginas a la que puedo acceder)

==== ReservaDeLibro ====
<code java>
package com.test.dsl.pagina;

import com.test.dsl.Usuario;
import com.thoughtworks.selenium.Selenium;

public class ReservaDeLibro {

private Selenium selenium;

public ReservaDeLibro(Selenium selenium) {
this.selenium = selenium;
}

public ReservaDeLibro reservar() {
selenium.type("libro", "El señor de los anillos");
selenium.type("codSocio", "0001");
selenium.type("fechaHasta", "2011-01-01");
return this;
}

public ComprobanteDeLibro aceptar() {
selenium.click("submitbutton");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
return new ComprobanteDeLibro(selenium);
}
}
</code>

==== ComprobanteDeLibro ====
<code java>
package com.test.dsl.pagina;

import org.junit.Assert;

import com.test.dsl.Usuario;
import com.thoughtworks.selenium.Selenium;

public class ComprobanteDeLibro {
private Selenium selenium;

public ComprobanteDeLibro(Selenium selenium) {
this.selenium = selenium;
}

public ComprobanteDeLibro verificarReserva() {
Assert.assertTrue(selenium.isTextPresent("El señor de los anillos"));
Assert.assertTrue(selenium.isTextPresent("0001"));
Assert.assertTrue(selenium.isTextPresent("2011-01-01"));
return this;
}

public HomeBibliotecario aceptar() {
selenium.click("submitbutton");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
return new HomeBibliotecario(selenium);
}
}

</code>

Tanto el aceptar (como el cancelar en ReservaDeLibro), devuelven la home del bibliotecario.

== Conclusiones ==

El resultado de hacer los test de esta manera, es la facilidad de escritura y mantenimiento del test en si mismo. A su vez, se podría diseñar las clases a utilizar en el DSL a conveniencia.

== Enlaces ==
[[DSL]]

[[Selenium]]

[http://code.google.com/p/selenium/wiki/PageObjects Page Objects]

[http://www.slideshare.net/alimenkou/dsl-page-object-and-selenium-a-way-to-reliable-functional-tests Diapositiva de Dsl+Page Object + Selenium]

Selenium con DSL

2011-04-29T13:04:46Z

Shichibukai: /* Enlaces */

[[Selenium]] es una herramienta para pruebas de aplicaciones web. Quién tuvo la posibilidad de utilizarla, sabrá lo poderosa que es la herramienta, la cuál tiene diversas funciones para ejecutar con nuestra aplicación web.
Puede ocurrir, que nuestros test de [[Selenium]] se vayan complejizando a medida que nuestra aplicación crece, por lo que esta es una posible solución, combinando el poder de [[Selenium]] con un enfoque [[DSL]].

== Ejemplo ==
A continuación mostramos una propuesta de como encarar un test de [[Selenium]]con [[DSL]]. Para el ejemplo, suponemos un sistema de biblioteca, con las siguientes pantallas y su navegación.
Se puede observar que pare este sistemas planteamos dos roles de usuario, el Bibliotecario y el Socio.

[[Archivo:reservaLibro.jpg]]

=== Creando un test ===
En el siguiente test, vamos a probar la funcionalidad de la reserva de libro.
Para escribir el siguiente test, se utilizó una sintaxis acotada y simple con las siguientes reglas:

* '''ir'''''<NombreDeLaPagina>'': Los métodos que comiencen con el prefijo “ir”, nos retorna el nuevo contexto (página).
* '''verificar'''''<Descripción>'': Los métodos que comiencen con el prefijo "verificar", poseen los “assert” para comprobar alguna acción realizada en la página, este método siempre retona la misma página (this).
* '''ingresarComo'''''<Nombre del Rol>'': Rol con el que se probará el sistema.
* '''aceptar, cancelar, volver, buscar''': Son nombre de las acciones básica que se realizan en un página y pueden (o nó) devolver otra página.
* ''<acciones propias de la página>'' : Estos métodos realizan acciones sobre el sistema sin ir a otra página. Ej.: reservar

==== ReservaSeleniumDslTest ====
<code java>
package com.test.dsl;

import org.junit.AfterClass;
import org.junit.Assert;
import org.junit.BeforeClass;
import org.junit.Test;

public class ReservaSeleniumDslTest {

@BeforeClass
public static void setUpClass() throws Exception {
Usuario.inicializar();
}

@AfterClass
public static void tearDownClass() throws Exception {
Usuario.finalizar();
}

@Test
public void comoBibliotecarioQuieroRealizarUnaReserva() {
Usuario.ingresaComoBibliotecario()
.irReservaDeLibro()
.reservar()
.aceptar()
.verificarReserva()
.aceptar()
.salir();
}
}
</code>

De esta forma, escribimos el test de manera que al leer los métodos a los que se invoca, se entiende paso a paso lo que el test realiza, sin confundirnos con la implementación. Utilizando los patrones "method chaining" , "builder", "Page object" ayuda a realizar una abstracción de la implementación.

Si lo hubieramos realizado solo con selenium, el mismo test quedaría de la siguiente forma:

==== ReservaSeleniumTest ====

<code java>
@Test
public void comoBibliotecarioQuieroRealizarUnaReserva() {
//Ingresar
selenium.open("");
selenium.waitForPageToLoad(TIEMPO_ESPERA);
selenium.type("username", username);
selenium.type("password", password);
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA);
//ir Pagina reserva de Libro
selenium.click("link=ReservaLibro");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
//reservar
selenium.type("libro", "El señor de los anillos");
selenium.type("codSocio", "0001");
selenium.type("fechaHasta", "2011-01-01");
//Aceptar
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA)
//verficiar
Assert.assertTrue(selenium.isTextPresent("El señor de los anillos"));
Assert.assertTrue(selenium.isTextPresent("0001"));
Assert.assertTrue(selenium.isTextPresent("2011-01-01"));
//aceptar para volver a la home
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA)
//salir
selenium.click("link=logout");
}
</code>

A continuación las implementaciones de las clases utilizadas en el test.

==== Usuario ====

<code java>
package com.test.dsl;

import org.openqa.selenium.server.SeleniumServer;

import com.test.dsl.pagina.HomeBibliotecario;
import com.test.dsl.pagina.HomeUsuario;
import com.thoughtworks.selenium.DefaultSelenium;
import com.thoughtworks.selenium.Selenium;

public class Usuario {

public static final String TIEMPO_ESPERA = "90000";
public static final String VELOCIDAD_CERO = "0";
public static final String VELOCIDAD_TEST = "350";

private static SeleniumServer seleniumServer;
private static Selenium selenium ;

public static void inicializar() throws Exception {
seleniumServer = new SeleniumServer();
seleniumServer.start();
selenium = new DefaultSelenium("localhost", 4444, "*chrome", "http://localhost:8585/");
selenium.start();
}

public static void finalizar() {
selenium.stop();
seleniumServer.stop();
}

public static HomeBibliotecario ingresaComoBibliotecario() {
Usuario.login("bibliotecario_test","123456");
return new HomeBibliotecario(selenium);
}

public static HomeUsuario ingresaComoUsuario() {
Usuario.login("usuario_test","123456");
return new HomeUsuario(selenium);
}

private static void login(String username, String password) {
selenium.open("");
selenium.waitForPageToLoad(TIEMPO_ESPERA);
selenium.type("username", username);
selenium.type("password", password);
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA);

}
}

</code>

Esta clase es la que determina con que rol vamos a probar la aplicación.
El método '''ingresarComoBibliotecario''' instancia y devuelve un objeto de la clase '''HomeBibliotecario''' cuya implementación es:

==== HomeBibliotecario ====
<code java>
package com.test.dsl.pagina;

import com.test.dsl.Usuario;
import com.thoughtworks.selenium.Selenium;

public class HomeBibliotecario {

private Selenium selenium;

public HomeBibliotecario(Selenium selenium) {
this.selenium = selenium;
}

public ReservaDeLibro irReservaDeLibro() {
selenium.click("link=ReservaLibro");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
return new ReservaDeLibro(selenium);
}

public void salir() {
selenium.click("link=logout");
}
}
</code>

Volvemos a utilizar el patrón builder y el método ingresar denuncia devuelve un objeto de la clase AltaDenuncia. De esta manera, cada clase representa a una pantalla de la aplicación, y expone cada funcionalidad que la misma ofrece. AltaDenuncia sería así:
Volvemos a utilizar el patrón method chaining y el método '''irReservaDeLibro''' devuelve un objeto de la clase '''ReservaDeLibro'''. De esta manera, cada clase representa a una pantalla de la aplicación (page object), y expone cada funcionalidad que la misma ofrece (acciones que puedo realizar en la página y páginas a la que puedo acceder)

==== ReservaDeLibro ====
<code java>
package com.test.dsl.pagina;

import com.test.dsl.Usuario;
import com.thoughtworks.selenium.Selenium;

public class ReservaDeLibro {

private Selenium selenium;

public ReservaDeLibro(Selenium selenium) {
this.selenium = selenium;
}

public ReservaDeLibro reservar() {
selenium.type("libro", "El señor de los anillos");
selenium.type("codSocio", "0001");
selenium.type("fechaHasta", "2011-01-01");
return this;
}

public ComprobanteDeLibro aceptar() {
selenium.click("submitbutton");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
return new ComprobanteDeLibro(selenium);
}
}
</code>

==== ComprobanteDeLibro ====
<code java>
package com.test.dsl.pagina;

import org.junit.Assert;

import com.test.dsl.Usuario;
import com.thoughtworks.selenium.Selenium;

public class ComprobanteDeLibro {
private Selenium selenium;

public ComprobanteDeLibro(Selenium selenium) {
this.selenium = selenium;
}

public ComprobanteDeLibro verificarReserva() {
Assert.assertTrue(selenium.isTextPresent("El señor de los anillos"));
Assert.assertTrue(selenium.isTextPresent("0001"));
Assert.assertTrue(selenium.isTextPresent("2011-01-01"));
return this;
}

public HomeBibliotecario aceptar() {
selenium.click("submitbutton");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
return new HomeBibliotecario(selenium);
}
}

</code>

Tanto el aceptar (como el cancelar en ReservaDeLibro), devuelven la home del bibliotecario.

== Conclusiones ==

El resultado de hacer los test de esta manera, es la facilidad de escritura y mantenimiento del test en si mismo. A su vez, se podría diseñar las clases a utilizar en el DSL a conveniencia.

== Enlaces ==
[[DSL]]

[[Selenium]]

[http://code.google.com/p/selenium/wiki/PageObjects Page Objects]

[http://www.slideshare.net/alimenkou/dsl-page-object-and-selenium-a-way-to-reliable-functional-tests Diapositiva de Dsl+Page Object + Selenium]

Selenium con DSL

2011-04-29T13:03:48Z

Shichibukai:

[[Selenium]] es una herramienta para pruebas de aplicaciones web. Quién tuvo la posibilidad de utilizarla, sabrá lo poderosa que es la herramienta, la cuál tiene diversas funciones para ejecutar con nuestra aplicación web.
Puede ocurrir, que nuestros test de [[Selenium]] se vayan complejizando a medida que nuestra aplicación crece, por lo que esta es una posible solución, combinando el poder de [[Selenium]] con un enfoque [[DSL]].

== Ejemplo ==
A continuación mostramos una propuesta de como encarar un test de [[Selenium]]con [[DSL]]. Para el ejemplo, suponemos un sistema de biblioteca, con las siguientes pantallas y su navegación.
Se puede observar que pare este sistemas planteamos dos roles de usuario, el Bibliotecario y el Socio.

[[Archivo:reservaLibro.jpg]]

=== Creando un test ===
En el siguiente test, vamos a probar la funcionalidad de la reserva de libro.
Para escribir el siguiente test, se utilizó una sintaxis acotada y simple con las siguientes reglas:

* '''ir'''''<NombreDeLaPagina>'': Los métodos que comiencen con el prefijo “ir”, nos retorna el nuevo contexto (página).
* '''verificar'''''<Descripción>'': Los métodos que comiencen con el prefijo "verificar", poseen los “assert” para comprobar alguna acción realizada en la página, este método siempre retona la misma página (this).
* '''ingresarComo'''''<Nombre del Rol>'': Rol con el que se probará el sistema.
* '''aceptar, cancelar, volver, buscar''': Son nombre de las acciones básica que se realizan en un página y pueden (o nó) devolver otra página.
* ''<acciones propias de la página>'' : Estos métodos realizan acciones sobre el sistema sin ir a otra página. Ej.: reservar

==== ReservaSeleniumDslTest ====
<code java>
package com.test.dsl;

import org.junit.AfterClass;
import org.junit.Assert;
import org.junit.BeforeClass;
import org.junit.Test;

public class ReservaSeleniumDslTest {

@BeforeClass
public static void setUpClass() throws Exception {
Usuario.inicializar();
}

@AfterClass
public static void tearDownClass() throws Exception {
Usuario.finalizar();
}

@Test
public void comoBibliotecarioQuieroRealizarUnaReserva() {
Usuario.ingresaComoBibliotecario()
.irReservaDeLibro()
.reservar()
.aceptar()
.verificarReserva()
.aceptar()
.salir();
}
}
</code>

De esta forma, escribimos el test de manera que al leer los métodos a los que se invoca, se entiende paso a paso lo que el test realiza, sin confundirnos con la implementación. Utilizando los patrones "method chaining" , "builder", "Page object" ayuda a realizar una abstracción de la implementación.

Si lo hubieramos realizado solo con selenium, el mismo test quedaría de la siguiente forma:

==== ReservaSeleniumTest ====

<code java>
@Test
public void comoBibliotecarioQuieroRealizarUnaReserva() {
//Ingresar
selenium.open("");
selenium.waitForPageToLoad(TIEMPO_ESPERA);
selenium.type("username", username);
selenium.type("password", password);
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA);
//ir Pagina reserva de Libro
selenium.click("link=ReservaLibro");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
//reservar
selenium.type("libro", "El señor de los anillos");
selenium.type("codSocio", "0001");
selenium.type("fechaHasta", "2011-01-01");
//Aceptar
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA)
//verficiar
Assert.assertTrue(selenium.isTextPresent("El señor de los anillos"));
Assert.assertTrue(selenium.isTextPresent("0001"));
Assert.assertTrue(selenium.isTextPresent("2011-01-01"));
//aceptar para volver a la home
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA)
//salir
selenium.click("link=logout");
}
</code>

A continuación las implementaciones de las clases utilizadas en el test.

==== Usuario ====

<code java>
package com.test.dsl;

import org.openqa.selenium.server.SeleniumServer;

import com.test.dsl.pagina.HomeBibliotecario;
import com.test.dsl.pagina.HomeUsuario;
import com.thoughtworks.selenium.DefaultSelenium;
import com.thoughtworks.selenium.Selenium;

public class Usuario {

public static final String TIEMPO_ESPERA = "90000";
public static final String VELOCIDAD_CERO = "0";
public static final String VELOCIDAD_TEST = "350";

private static SeleniumServer seleniumServer;
private static Selenium selenium ;

public static void inicializar() throws Exception {
seleniumServer = new SeleniumServer();
seleniumServer.start();
selenium = new DefaultSelenium("localhost", 4444, "*chrome", "http://localhost:8585/");
selenium.start();
}

public static void finalizar() {
selenium.stop();
seleniumServer.stop();
}

public static HomeBibliotecario ingresaComoBibliotecario() {
Usuario.login("bibliotecario_test","123456");
return new HomeBibliotecario(selenium);
}

public static HomeUsuario ingresaComoUsuario() {
Usuario.login("usuario_test","123456");
return new HomeUsuario(selenium);
}

private static void login(String username, String password) {
selenium.open("");
selenium.waitForPageToLoad(TIEMPO_ESPERA);
selenium.type("username", username);
selenium.type("password", password);
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA);

}
}

</code>

Esta clase es la que determina con que rol vamos a probar la aplicación.
El método '''ingresarComoBibliotecario''' instancia y devuelve un objeto de la clase '''HomeBibliotecario''' cuya implementación es:

==== HomeBibliotecario ====
<code java>
package com.test.dsl.pagina;

import com.test.dsl.Usuario;
import com.thoughtworks.selenium.Selenium;

public class HomeBibliotecario {

private Selenium selenium;

public HomeBibliotecario(Selenium selenium) {
this.selenium = selenium;
}

public ReservaDeLibro irReservaDeLibro() {
selenium.click("link=ReservaLibro");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
return new ReservaDeLibro(selenium);
}

public void salir() {
selenium.click("link=logout");
}
}
</code>

Volvemos a utilizar el patrón builder y el método ingresar denuncia devuelve un objeto de la clase AltaDenuncia. De esta manera, cada clase representa a una pantalla de la aplicación, y expone cada funcionalidad que la misma ofrece. AltaDenuncia sería así:
Volvemos a utilizar el patrón method chaining y el método '''irReservaDeLibro''' devuelve un objeto de la clase '''ReservaDeLibro'''. De esta manera, cada clase representa a una pantalla de la aplicación (page object), y expone cada funcionalidad que la misma ofrece (acciones que puedo realizar en la página y páginas a la que puedo acceder)

==== ReservaDeLibro ====
<code java>
package com.test.dsl.pagina;

import com.test.dsl.Usuario;
import com.thoughtworks.selenium.Selenium;

public class ReservaDeLibro {

private Selenium selenium;

public ReservaDeLibro(Selenium selenium) {
this.selenium = selenium;
}

public ReservaDeLibro reservar() {
selenium.type("libro", "El señor de los anillos");
selenium.type("codSocio", "0001");
selenium.type("fechaHasta", "2011-01-01");
return this;
}

public ComprobanteDeLibro aceptar() {
selenium.click("submitbutton");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
return new ComprobanteDeLibro(selenium);
}
}
</code>

==== ComprobanteDeLibro ====
<code java>
package com.test.dsl.pagina;

import org.junit.Assert;

import com.test.dsl.Usuario;
import com.thoughtworks.selenium.Selenium;

public class ComprobanteDeLibro {
private Selenium selenium;

public ComprobanteDeLibro(Selenium selenium) {
this.selenium = selenium;
}

public ComprobanteDeLibro verificarReserva() {
Assert.assertTrue(selenium.isTextPresent("El señor de los anillos"));
Assert.assertTrue(selenium.isTextPresent("0001"));
Assert.assertTrue(selenium.isTextPresent("2011-01-01"));
return this;
}

public HomeBibliotecario aceptar() {
selenium.click("submitbutton");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
return new HomeBibliotecario(selenium);
}
}

</code>

Tanto el aceptar (como el cancelar en ReservaDeLibro), devuelven la home del bibliotecario.

== Conclusiones ==

El resultado de hacer los test de esta manera, es la facilidad de escritura y mantenimiento del test en si mismo. A su vez, se podría diseñar las clases a utilizar en el DSL a conveniencia.

== Enlaces ==
[http://code.google.com/p/selenium/wiki/PageObjects Page Objects]
[http://www.slideshare.net/alimenkou/dsl-page-object-and-selenium-a-way-to-reliable-functional-tests Diapositiva de Dsl+Page Object + Selenium]

Selenium con DSL

2011-04-29T12:47:53Z

Shichibukai: /* ReservaSeleniumTest */

[[Selenium]] es una herramienta para pruebas de aplicaciones web. Quién tuvo la posibilidad de utilizarla, sabrá lo poderosa que es la herramienta, la cuál tiene diversas funciones para ejecutar con nuestra aplicación web.
Puede ocurrir, que nuestros test de [[Selenium]] se vayan complejizando a medida que nuestra aplicación crece, por lo que esta es una posible solución, combinando el poder de [[Selenium]] con un enfoque [[DSL]].

== Ejemplo ==
A continuación mostramos una propuesta de como encarar un test de [[Selenium]]con [[DSL]]. Para el ejemplo, suponemos un sistema de biblioteca, con las siguientes pantallas y su navegación.
Se puede observar que pare este sistemas planteamos dos roles de usuario, el Bibliotecario y el Socio.

[[Archivo:reservaLibro.jpg]]

=== Creando un test ===
En el siguiente test, vamos a probar la funcionalidad de la reserva de libro.
Para escribir el siguiente test, se utilizó una sintaxis acotada y simple con las siguientes reglas:

* '''ir'''''<NombreDeLaPagina>'': Los métodos que comiencen con el prefijo “ir”, nos retorna el nuevo contexto (página).
* '''verificar'''''<Descripción>'': Los métodos que comiencen con el prefijo "verificar", poseen los “assert” para comprobar alguna acción realizada en la página, este método siempre retona la misma página (this).
* '''ingresarComo'''''<Nombre del Rol>'': Rol con el que se probará el sistema.
* '''aceptar, cancelar, volver, buscar''': Son nombre de las acciones básica que se realizan en un página y pueden (o nó) devolver otra página.
* ''<acciones propias de la página>'' : Estos métodos realizan acciones sobre el sistema sin ir a otra página. Ej.: reservar

==== ReservaSeleniumDslTest ====
<code java>
package com.test.dsl;

import org.junit.AfterClass;
import org.junit.Assert;
import org.junit.BeforeClass;
import org.junit.Test;

public class ReservaSeleniumDslTest {

@BeforeClass
public static void setUpClass() throws Exception {
Usuario.inicializar();
}

@AfterClass
public static void tearDownClass() throws Exception {
Usuario.finalizar();
}

@Test
public void comoBibliotecarioQuieroRealizarUnaReserva() {
Usuario.ingresaComoBibliotecario()
.irReservaDeLibro()
.reservar()
.aceptar()
.verificarReserva()
.aceptar()
.salir();
}
}
</code>

De esta forma, escribimos el test de manera que al leer los métodos a los que se invoca, se entiende paso a paso lo que el test realiza, sin confundirnos con la implementación. Utilizando los patrones "method chaining" , "builder", "Page object" ayuda a realizar una abstracción de la implementación.

Si lo hubieramos realizado solo con selenium, el mismo test quedaría de la siguiente forma:

==== ReservaSeleniumTest ====

<code java>
@Test
public void comoBibliotecarioQuieroRealizarUnaReserva() {
//Ingresar
selenium.open("");
selenium.waitForPageToLoad(TIEMPO_ESPERA);
selenium.type("username", username);
selenium.type("password", password);
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA);
//ir Pagina reserva de Libro
selenium.click("link=ReservaLibro");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
//reservar
selenium.type("libro", "El señor de los anillos");
selenium.type("codSocio", "0001");
selenium.type("fechaHasta", "2011-01-01");
//Aceptar
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA)
//verficiar
Assert.assertTrue(selenium.isTextPresent("El señor de los anillos"));
Assert.assertTrue(selenium.isTextPresent("0001"));
Assert.assertTrue(selenium.isTextPresent("2011-01-01"));
//aceptar para volver a la home
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA)
//salir
selenium.click("link=logout");
}
</code>

A continuación las implementaciones de las clases utilizadas en el test.

==== Usuario ====

<code java>
package com.test.dsl;

import org.openqa.selenium.server.SeleniumServer;

import com.test.dsl.pagina.HomeBibliotecario;
import com.test.dsl.pagina.HomeUsuario;
import com.thoughtworks.selenium.DefaultSelenium;
import com.thoughtworks.selenium.Selenium;

public class Usuario {

public static final String TIEMPO_ESPERA = "90000";
public static final String VELOCIDAD_CERO = "0";
public static final String VELOCIDAD_TEST = "350";

private static SeleniumServer seleniumServer;
private static Selenium selenium ;

public static void inicializar() throws Exception {
seleniumServer = new SeleniumServer();
seleniumServer.start();
selenium = new DefaultSelenium("localhost", 4444, "*chrome", "http://localhost:8585/");
selenium.start();
}

public static void finalizar() {
selenium.stop();
seleniumServer.stop();
}

public static HomeBibliotecario ingresaComoBibliotecario() {
Usuario.login("bibliotecario_test","123456");
return new HomeBibliotecario(selenium);
}

public static HomeUsuario ingresaComoUsuario() {
Usuario.login("usuario_test","123456");
return new HomeUsuario(selenium);
}

private static void login(String username, String password) {
selenium.open("");
selenium.waitForPageToLoad(TIEMPO_ESPERA);
selenium.type("username", username);
selenium.type("password", password);
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA);

}
}

</code>

Esta clase es la que determina con que rol vamos a probar la aplicación.
El método '''ingresarComoBibliotecario''' instancia y devuelve un objeto de la clase '''HomeBibliotecario''' cuya implementación es:

==== HomeBibliotecario ====
<code java>
package com.test.dsl.pagina;

import com.test.dsl.Usuario;
import com.thoughtworks.selenium.Selenium;

public class HomeBibliotecario {

private Selenium selenium;

public HomeBibliotecario(Selenium selenium) {
this.selenium = selenium;
}

public ReservaDeLibro irReservaDeLibro() {
selenium.click("link=ReservaLibro");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
return new ReservaDeLibro(selenium);
}

public void salir() {
selenium.click("link=logout");
}
}
</code>

Volvemos a utilizar el patrón builder y el método ingresar denuncia devuelve un objeto de la clase AltaDenuncia. De esta manera, cada clase representa a una pantalla de la aplicación, y expone cada funcionalidad que la misma ofrece. AltaDenuncia sería así:
Volvemos a utilizar el patrón method chaining y el método '''irReservaDeLibro''' devuelve un objeto de la clase '''ReservaDeLibro'''. De esta manera, cada clase representa a una pantalla de la aplicación (page object), y expone cada funcionalidad que la misma ofrece (acciones que puedo realizar en la página y páginas a la que puedo acceder)

==== ReservaDeLibro ====
<code java>
package com.test.dsl.pagina;

import com.test.dsl.Usuario;
import com.thoughtworks.selenium.Selenium;

public class ReservaDeLibro {

private Selenium selenium;

public ReservaDeLibro(Selenium selenium) {
this.selenium = selenium;
}

public ReservaDeLibro reservar() {
selenium.type("libro", "El señor de los anillos");
selenium.type("codSocio", "0001");
selenium.type("fechaHasta", "2011-01-01");
return this;
}

public ComprobanteDeLibro aceptar() {
selenium.click("submitbutton");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
return new ComprobanteDeLibro(selenium);
}
}
</code>

==== ComprobanteDeLibro ====
<code java>
package com.test.dsl.pagina;

import org.junit.Assert;

import com.test.dsl.Usuario;
import com.thoughtworks.selenium.Selenium;

public class ComprobanteDeLibro {
private Selenium selenium;

public ComprobanteDeLibro(Selenium selenium) {
this.selenium = selenium;
}

public ComprobanteDeLibro verificarReserva() {
Assert.assertTrue(selenium.isTextPresent("El señor de los anillos"));
Assert.assertTrue(selenium.isTextPresent("0001"));
Assert.assertTrue(selenium.isTextPresent("2011-01-01"));
return this;
}

public HomeBibliotecario aceptar() {
selenium.click("submitbutton");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
return new HomeBibliotecario(selenium);
}
}

</code>

Tanto el aceptar (como el cancelar en ReservaDeLibro), devuelven la home del bibliotecario.

== Conclusiones ==

El resultado de hacer los test de esta manera, es la facilidad de escritura y mantenimiento del test en si mismo. A su vez, se podría diseñar las clases a utilizar en el DSL a conveniencia.

Selenium con DSL

2011-04-29T12:47:23Z

Shichibukai: /* Creando un test */

[[Selenium]] es una herramienta para pruebas de aplicaciones web. Quién tuvo la posibilidad de utilizarla, sabrá lo poderosa que es la herramienta, la cuál tiene diversas funciones para ejecutar con nuestra aplicación web.
Puede ocurrir, que nuestros test de [[Selenium]] se vayan complejizando a medida que nuestra aplicación crece, por lo que esta es una posible solución, combinando el poder de [[Selenium]] con un enfoque [[DSL]].

== Ejemplo ==
A continuación mostramos una propuesta de como encarar un test de [[Selenium]]con [[DSL]]. Para el ejemplo, suponemos un sistema de biblioteca, con las siguientes pantallas y su navegación.
Se puede observar que pare este sistemas planteamos dos roles de usuario, el Bibliotecario y el Socio.

[[Archivo:reservaLibro.jpg]]

=== Creando un test ===
En el siguiente test, vamos a probar la funcionalidad de la reserva de libro.
Para escribir el siguiente test, se utilizó una sintaxis acotada y simple con las siguientes reglas:

* '''ir'''''<NombreDeLaPagina>'': Los métodos que comiencen con el prefijo “ir”, nos retorna el nuevo contexto (página).
* '''verificar'''''<Descripción>'': Los métodos que comiencen con el prefijo "verificar", poseen los “assert” para comprobar alguna acción realizada en la página, este método siempre retona la misma página (this).
* '''ingresarComo'''''<Nombre del Rol>'': Rol con el que se probará el sistema.
* '''aceptar, cancelar, volver, buscar''': Son nombre de las acciones básica que se realizan en un página y pueden (o nó) devolver otra página.
* ''<acciones propias de la página>'' : Estos métodos realizan acciones sobre el sistema sin ir a otra página. Ej.: reservar

==== ReservaSeleniumDslTest ====
<code java>
package com.test.dsl;

import org.junit.AfterClass;
import org.junit.Assert;
import org.junit.BeforeClass;
import org.junit.Test;

public class ReservaSeleniumDslTest {

@BeforeClass
public static void setUpClass() throws Exception {
Usuario.inicializar();
}

@AfterClass
public static void tearDownClass() throws Exception {
Usuario.finalizar();
}

@Test
public void comoBibliotecarioQuieroRealizarUnaReserva() {
Usuario.ingresaComoBibliotecario()
.irReservaDeLibro()
.reservar()
.aceptar()
.verificarReserva()
.aceptar()
.salir();
}
}
</code>

De esta forma, escribimos el test de manera que al leer los métodos a los que se invoca, se entiende paso a paso lo que el test realiza, sin confundirnos con la implementación. Utilizando los patrones "method chaining" , "builder", "Page object" ayuda a realizar una abstracción de la implementación.

Si lo hubieramos realizado solo con selenium, el mismo test quedaría de la siguiente forma:

==== ReservaSeleniumTest ====

<code java>
@Test
public void comoBibliotecarioQuieroRealizarUnaReserva() {
//Ingresar
selenium.open("");
selenium.waitForPageToLoad(TIEMPO_ESPERA);
selenium.type("username", username);
selenium.type("password", password);
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA);
//ir Pagina reserva de Libro
selenium.click("link=ReservaLibro");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
//reservar
selenium.type("libro", "El señor de los anillos");
selenium.type("codSocio", "0001");
selenium.type("fechaHasta", "2011-01-01");
//Aceptar
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA)
//verficiar
Assert.assertTrue(selenium.isTextPresent("El señor de los anillos"));
Assert.assertTrue(selenium.isTextPresent("0001"));
Assert.assertTrue(selenium.isTextPresent("2011-01-01"));
//aceptar para volver a la home
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA)
//salir
selenium.click("link=logout"); }
</code>

A continuación las implementaciones de las clases utilizadas en el test.

==== Usuario ====

<code java>
package com.test.dsl;

import org.openqa.selenium.server.SeleniumServer;

import com.test.dsl.pagina.HomeBibliotecario;
import com.test.dsl.pagina.HomeUsuario;
import com.thoughtworks.selenium.DefaultSelenium;
import com.thoughtworks.selenium.Selenium;

public class Usuario {

public static final String TIEMPO_ESPERA = "90000";
public static final String VELOCIDAD_CERO = "0";
public static final String VELOCIDAD_TEST = "350";

private static SeleniumServer seleniumServer;
private static Selenium selenium ;

public static void inicializar() throws Exception {
seleniumServer = new SeleniumServer();
seleniumServer.start();
selenium = new DefaultSelenium("localhost", 4444, "*chrome", "http://localhost:8585/");
selenium.start();
}

public static void finalizar() {
selenium.stop();
seleniumServer.stop();
}

public static HomeBibliotecario ingresaComoBibliotecario() {
Usuario.login("bibliotecario_test","123456");
return new HomeBibliotecario(selenium);
}

public static HomeUsuario ingresaComoUsuario() {
Usuario.login("usuario_test","123456");
return new HomeUsuario(selenium);
}

private static void login(String username, String password) {
selenium.open("");
selenium.waitForPageToLoad(TIEMPO_ESPERA);
selenium.type("username", username);
selenium.type("password", password);
selenium.click("submitbutton");
selenium.waitForPageToLoad(TIEMPO_ESPERA);

}
}

</code>

Esta clase es la que determina con que rol vamos a probar la aplicación.
El método '''ingresarComoBibliotecario''' instancia y devuelve un objeto de la clase '''HomeBibliotecario''' cuya implementación es:

==== HomeBibliotecario ====
<code java>
package com.test.dsl.pagina;

import com.test.dsl.Usuario;
import com.thoughtworks.selenium.Selenium;

public class HomeBibliotecario {

private Selenium selenium;

public HomeBibliotecario(Selenium selenium) {
this.selenium = selenium;
}

public ReservaDeLibro irReservaDeLibro() {
selenium.click("link=ReservaLibro");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
return new ReservaDeLibro(selenium);
}

public void salir() {
selenium.click("link=logout");
}
}
</code>

Volvemos a utilizar el patrón builder y el método ingresar denuncia devuelve un objeto de la clase AltaDenuncia. De esta manera, cada clase representa a una pantalla de la aplicación, y expone cada funcionalidad que la misma ofrece. AltaDenuncia sería así:
Volvemos a utilizar el patrón method chaining y el método '''irReservaDeLibro''' devuelve un objeto de la clase '''ReservaDeLibro'''. De esta manera, cada clase representa a una pantalla de la aplicación (page object), y expone cada funcionalidad que la misma ofrece (acciones que puedo realizar en la página y páginas a la que puedo acceder)

==== ReservaDeLibro ====
<code java>
package com.test.dsl.pagina;

import com.test.dsl.Usuario;
import com.thoughtworks.selenium.Selenium;

public class ReservaDeLibro {

private Selenium selenium;

public ReservaDeLibro(Selenium selenium) {
this.selenium = selenium;
}

public ReservaDeLibro reservar() {
selenium.type("libro", "El señor de los anillos");
selenium.type("codSocio", "0001");
selenium.type("fechaHasta", "2011-01-01");
return this;
}

public ComprobanteDeLibro aceptar() {
selenium.click("submitbutton");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
return new ComprobanteDeLibro(selenium);
}
}
</code>

==== ComprobanteDeLibro ====
<code java>
package com.test.dsl.pagina;

import org.junit.Assert;

import com.test.dsl.Usuario;
import com.thoughtworks.selenium.Selenium;

public class ComprobanteDeLibro {
private Selenium selenium;

public ComprobanteDeLibro(Selenium selenium) {
this.selenium = selenium;
}

public ComprobanteDeLibro verificarReserva() {
Assert.assertTrue(selenium.isTextPresent("El señor de los anillos"));
Assert.assertTrue(selenium.isTextPresent("0001"));
Assert.assertTrue(selenium.isTextPresent("2011-01-01"));
return this;
}

public HomeBibliotecario aceptar() {
selenium.click("submitbutton");
selenium.waitForPageToLoad(Usuario.TIEMPO_ESPERA);
return new HomeBibliotecario(selenium);
}
}

</code>

Tanto el aceptar (como el cancelar en ReservaDeLibro), devuelven la home del bibliotecario.

== Conclusiones ==

El resultado de hacer los test de esta manera, es la facilidad de escritura y mantenimiento del test en si mismo. A su vez, se podría diseñar las clases a utilizar en el DSL a conveniencia.

Archivo:ReservaLibro.jpg

2011-04-29T12:41:34Z

Shichibukai: subida una nueva versión de «Archivo:ReservaLibro.jpg»

Diagrama de navegación de un sistema simple de biblioteca, para el ejemplo de selenium con dsl.

Archivo:ReservaLibro.jpg

2011-04-29T12:38:17Z

Shichibukai: Diagrama de navegación de un sistema simple de biblioteca, para el ejemplo de selenium con dsl.

Diagrama de navegación de un sistema simple de biblioteca, para el ejemplo de selenium con dsl.