Configure query to iterate

Al seleccionar la opción "Configure query to iterate" disponible en el menú desplegable que se presenta al hacer clic con el botón derecho sobre una actividad del tipo "ForEachFromSQLActivity" es posible determinar la sentencia SQL a ejecutar así como el elemento de la estructura devuelta por dicha sentencia sobre el cual iterar y de esa manera poder ejecutar las actividades contenidas tantas veces como dicho elemento exista.

Cnn String Source

Permite seleccionar el lugar de donde se tomará la cadena de conexión en tiempo de ejecución de la actividad. Las opciones disponibles son:

From Activity

En tiempo de ejecución utilizará la cadena de conexión configurada en el campo "Connection String".
En este caso la conexión a la base de datos especificada se abre al momento de comenzar a ejecutar la actividad y se cierra una vez finalizada la ejecución de la misma

From Configuration File

En tiempo de ejecución utilizará una cadena de conexión definida en la sección <connectionStrings> del archivo web.config de BIZUIT Event Manager Server. En caso de seleccionar esta opción, el valor del campo "Config Name" debe ser un nombre de alguna cadena de conexión configurada en dicho archivo. Nota: Al depurar 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)

En este caso la conexión a la base de datos especificada se abre al momento de comenzar a ejecutar la actividad y se cierra una vez finalizada la ejecución de la misma.

From Connection Pool

En tiempo de ejecución utilizará la cadena de conexión de el pool de conexiones seleccionado en el cuadro desplegable "Pooled Connection". En este caso y a diferencia de las dos opciones anteriores la conexión a la base de datos especificada se abre al momento de comenzar a ejecutar la reacción y se cierra una vez finalizada la ejecución de la reacción. Nota:En caso de utilizar esta opción y la característica de "Connection Pooling" en la reacción se encuentra deshabilitada, al momento de ejecutar la actividad recibirá el siguiente mensaje: "Connection pool could not be created or workflow was not configured to create a connection pool". En cuyo caso deberá activar la característica de "Connection Pooling" en la reacción o seleccionar otra opción.

Connection String

Cadena de conexión a la base de datos que se utilizará. El formato de la cadena de conexión se debe corresponder con la opción seleccionada en la lista desplegable "Data provider". Visitando este sitio encontrará las distintas formas de especificar una cadena de conexión en función del tipo de proveedor y base de datos.

El botón permite configurar la cadena de conexión utilizando el asistente provisto por la plataforma Windows:

Pooled Connection

En caso que el campo Cnn String Source se encuentre configurado en la opción "From Pooled Connection", permite especificar el pool de conexión a utilizar en tiempo de ejecución. Ver "Configure Database Connection Pool".

Config Name

En caso que el campo Cnn String Source se encuentre configurado en la opción "From Configuration File", 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.Nota: Al depurar 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. Nota: Esta opción sólo está disponible en caso que el valor del campo DataBase Type sea SQL Server.

DataBase Type

Proveedor de base de datos que se consultará para la obtención de datos. Los tipos disponibles son:

SQL Server	Utilice esta opción cuando deba conectarse con una BD SQL Server. Utilizando esta opción se utiliza el driver nativo de SQL Server para la plataforma .NET optimizando su acceso.
OLEDB Provider	Utilice esta opción cuando deba conectarse con bases de datos distintas a SQL Server que cuenten con un driver OLEDB disponible. Tenga en cuenta que la cadena de conexión ingresada deberá tener la forma prevista por OLEDB.
ODBC Provider	Utilice esta opción cuando deba conectarse con bases de datos distintas a SQL Server que cuenten con un driver ODBC disponible. Tenga en cuenta que la cadena de conexión ingresada deberá tener la forma prevista por ODBC.

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.

Nota: Cuando deba llamar a un procedimiento almacenado conectándose mediante un driver ODBC u OLEDB, deberá llamarlo mediante texto. En estos casos la sintaxis general para la llamada a un procedimiento almacenado es la siguiente:

{ call NOMBRE_PROCEDIMIENTO (@param1, @param2, …) }

Donde NOMBRE_PROCEDIMIENTO es el nombre del procedimiento almacenado y @param1, @param2, etc. son los parámetros del mismo. Debe utilizar las llaves, tal como se muestra en el ejemplo.

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.

Test Command

Para verificar la correcta configuración de la actividad es requerido presionar el botón “Test Command” que mostrará a estructura de resultado necesaria para poder determinar el elemento sobre el cual iterar.

Clear

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

Results Structure

Permite seleccionar el elemento de la estructura devuelta por la sentencia SQL sobre el cual iterar. Al hacer doble clic sobre el nodo repetitivo (marcado en negrita) de la estructura se configura la iteración.

Iteration XPath

Permite visualizar el elemento repetitivo de la estructura sobre el cual iterar.

Anterior / Siguiente