DataApplicationBlock Activity

La actividad DataApplicationBlockActivity permite enviar sentencias SQL y ejecutar procedimientos almacenados sobre distintos motores de bases de datos sin cambiar la configuración de la actividad.

Esta actividad utiliza el framework de acceso a datos "Data Access Application Block" provisto por Microsoft, lo que permite configurar sentencias SQL ANSI o llamadas a procedimientos almacenados sobre bases de datos Oracle y SQLServer de manera indistinta. A diferencia de la actividad "SQLActivity", esta actividad no requiere modificar la sentencia SQL o la sintaxis de ejecución de procedimientos almacenados configurada cuando sea necesario conectarse a otro motor de base de datos, solo es necesario modificar la cadena de conexión configurada en la actividad. Esto siempre y cuando la sentencia SQL configurada respete el estandard ANSI.

Al hacer doble click sobre la actividad colocada en el diseñador de reacciones se accede al primer paso del asistente de configuración de actividades.

Cnn String Source

No configurable. Indica que la cadena de conexión se tomará de un archivo de configuración

Config Name

Permite especificar el nombre de la cadena de conexión definida en la sección <connectionStrings> del archivo web.config de BIZUIT Event Manager Server a utilizar en tiempo de ejecución. Si la cadena de conexión se encuentra configurada para conectarse con una base de datos SQL Server y se desea conectar con una base de datos Oracle, bastará con cambiar dicha cadena de conexión y la actividad tomará la nueva configuración. La cadena de conexión seleccionada debe incluir el atributo provider name como se indica a continuación:

Es posible obtener el nombre de la cadena de conexión a partir de un origen (parámetro, variable o resultado de la ejecución de una actividad anterior). Para ello debe seleccionar el origen antes de realizar los mapeos de entrada, y se permitirá realizar un mapeo desde el origen correspondiente hacia un valor de entrada de la actividad, destinado a recibir el nombre de la cadena de conexión como se indica en la en la siguiente figura:

Nota: Al diseñar la reacción en BIZUIT Designer será necesario incluir la cadena de conexión en la sección <connectionStrings> del archivo Tycon.BIZUIT.Designer.exe.config ubicado en el directorio de instalación de BIZUIT Designer (por defecto: C:\Program Files\Tycon S.A\Bizuit Designer 2.5.8)

Command Type

Permite definir si se enviará una sentencia SQL o se ejecutará un procedimiento almacenado de la base de datos configurada:

Text	Permite indicar que se enviará una sentencia SQL
Stored Procedure	Permite indicar que se ejecutará una llamada a un procedimiento almacenado de la base de datos configurada (opción "Stored Procedure"), en cuyo caso el cuadro de texto Command Text se transforma en una lista desplegable conteniendo todos los procedimientos almacenados configurados en la base de datos y desde la cual es posible seleccionar el procedimiento a ejecutar.

Command Text

Si en el campo Command Type se seleccionó la opción "Text", se debe ingresar la sentencia SQL a ejecutar sobre la base de datos configurada, en caso de requerir enviar parámetros a la sentencia, los mismos deben ser especificados anteponiendo el caracter arroba (@). Por ejemplo: Select * from customers where CustomerId Like @IdCliente + '%'

Si en el campo Command Type se seleccionó la opción "Stored Procedure" se debe seleccionar de la lista desplegable que contiene todos los procedimientos almacenados configurados en la base de datos el procedimiento a ejecutar.

Parameters

Indica los parámetros requeridos por la sentencia SQL o procedimiento almacenado a ejecutar:

Parameter Name

Si en el campo Command Text se seleccionó un procedimiento almacenado que recibe parámetros, la lista de parámetros se poblará automáticamente con dichos parámetros.

Si en el campo Command Text se ingresó una sentencia SQL con parámetros (especificados anteponiendo el caracter arroba (@). Por ejemplo: Select * from customers where CustomerId Like @IdCliente + '%'),la lista de parámetros se poblará con los parámetros configurados en dicha sentencia.

Parameter Default Value

Para verificar la correcta configuración de la actividad será necesario presionar el botón "Test Command" para lo cual es requerido colocar valores por defecto en los parámetros de manera que la actividad pueda ser testeada.

Is Output Parameter

Permite indicar si el parámetro es de salida, devolviendo valores en el mismo.

What does this statement returns?

Permite definir si la sentencia SQL o procedimiento almacenado a ejecutar devuelve o no resultados (opción "Nothing"), y en caso de devolverlos si lo hace mediante un conjunto de resultados (opción "Records" o mediante parámetros de salida (opción "Output Parameters").

Call this Command Multiple Times

Permite configurar si la sentencia SQL o procedimiento almacenado se ejecutará más de una vez, en cuyo caso al momento de realizar el mapeo de datos de entrada en el paso 4 del asistente de configuración de actividades, se añadirá un nodo repetitivo a la estructura de datos de entrada de la actividad que permitirá realizar el mapeo repetitivo necesario. Ver Mapeos

Test Command

Para verificar la correcta configuración de la actividad es requerido presionar el botón “Test Command” que mostrará en pantalla el resultado de la ejecución o un mensaje de error en caso de fallo y además permitirá inferir de manera automática el esquema de salida de la actividad.

Clear

Permite borrar la configuración realizada para ingresar una nueva configuración.

Al presionar “Next >” se accederá al paso 3 en el cual podrá definir los origenes de datos desde los cuales obtener el valor de los parámetros requeridos por la sentencia SQL configurada.

Anterior / Siguiente