SQL Activity

Parent Previous Next

La actividad SQLActivity permite  ejecutar sentencias SQL en cualquier base de datos que cuente con un driver OLEDB u ODBC.

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

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.



Otra funcionalidad ofrecida por SQL Activity - que tiene precedencia sobre las tres opciones descriptas en este punto - es permitir obtener una 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 SQL Activity permitirá realizar un mapeo desde el origen correspondiente hacia un valor de entrada de la actividad, destinado a recibir la cadena de conexión como se indica en la en la siguiente figura:


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.


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