Sql Command
Nombre del elemento: Sql Command
Categoría: Programming
Descripción: Representa una instrucción Transact-SQL o un procedimiento almacenado para ejecutar en una base de datos de SQL Server.
Funcionalidad: Este módulo de extensión permite realizar transacciones SQL en una base de datos. Por ejemplo, ejecutar un procedimiento almacenado para obtener una dirección asociada a un RUT específico.
Para su configuración se debe tener en cuenta los siguientes parámetros:
Configuración de Sql Command (Requerido)
Nombre: Descriptor único de caja de configuración con fines de identificar nombre en el flujo
[Sincronizar la ejecución de la acción con la visualización de los mensajes por el cliente.] Para asegurar la sincronización de la ejecución de la transacción antes de la visualización de cualquier mensaje, por favor selecciona la opción 'Sí' en el aplicativo Lynn.
[Una expresión para definir la cadena de conexión a la base de datos SQL sin la contraseña.] Campo String Expresión en donde debe ingresar la cadena de conexión correspondiente al acceso de la base de datos.
Nota: Es crucial destacar que en el campo anterior se debe ingresar la cadena de conexión excluyendo la contraseña de acceso a la base de datos
[La contraseña de conexión a la base de datos] Campo que permite introducir la contraseña asociada a la conexión de la base de datos.
[Una expresión para definir la consulta a ejecutar.] Campo String Expresión en donde podrá ingresar los comandos de consulta que desee ejecutar en la transacción seleccionada.
[El tipo de comando SQL.]
- StoredProcedure: Permite realizar consulta asociada a un procedimiento almacenado
- Text: Permite especificar el formato de la transacción en formato plano.
[El tipo de ejecución del comando SQL.]
- ExecuteNonQuery: No devuelve datos: solo el número de filas afectadas por una inserción, actualización o eliminación.
- ExecuteReader: Devuelve un objeto que puede iterar sobre todo el conjunto de resultados manteniendo solo un registro en la memoria a la vez.
- ExecuteScalar: Solo devuelve el valor de la primera columna de la primera fila de su consulta.
[Una lista de Entidades para definir los parámetros.] Campo que permite ingresar listado con entidades de entrada a utilizar dentro de la consulta a realizar.
[Una lista de entidades para definir los parámetros de salida.] Campo que permite ingresar listado con entidades de salida a utilizar dentro de la consulta a realizar.
[Entidad donde se depositará el resultado de la consulta en formato json.] Lista desplegable con entidades creadas en el aplicativo Lynn en donde se almacenará en formato Json el resultado de la consulta.
[La intención de ejecutar por error. El flujo de acción se interrumpirá y la descripción del error se pasará a la intención seleccionada con el nombre: 'Sql_Command_Error'.] Caja de selección donde se identifica la intención que se activara en caso de presentarse un error.
Ejemplo:
-- Precondiciones:
Es imprescindible disponer de una conexión activa a la base de datos y asegurarse de que las credenciales estén vigentes y sean válidas
--Entrada:
Nombre: PruebaSqlC
Sincronizar la ejecución de la acción con la visualización de los mensajes por el cliente: No
Una expresión para definir la cadena de conexión a la base de datos SQL sin la contraseña:
data source = ServidorSQL; initial catalog = BaseDatos; user id = Usuario;
La contaseña de conexion a la base de datos: XXXXXXXXX
Una expresión para definir la consulta a ejecutar: EXEC sp_consultarut
El tipo de comando SQL: StoredProcedure
El tipo de ejecución del comando SQL: ExecuteNonQuery
Una lista de Entidades para definir los parámetros: @rut
Una lista de entidades para definir los parámetros de salida: @rut
Entidad donde se depositará el resultado de la consulta en formato json: resultadoprueba
La intención de ejecutar por error. El flujo de acción se interrumpirá y la descripción del error se pasará a la intención seleccionada con el nombre: 'Sql_Command_Error': Error_Handler
-- Resultado:
Cuando el usuario ingrese el Rut solicitado en el procedimiento almacenado, se podrá obtener, por ejemplo, la dirección asociada a dicho Rut.