Differences

This shows you the differences between two versions of the page.

--- es:database_adaptor [2019/10/08 14:34]
tast [Gestión de Variables en el Adaptador de Base Datos]
+++ es:database_adaptor [2025/04/03 13:55] (current)
ale
@@ Line 8: / Line 8: @@
 ===== Parámetros de Inicialización =====
-  * **Host:** El parámetro Host representa la dirección IP o el nombre DNS de la máquina donde reside la base de datos.
+  * **DbType:** indica el proveedor o tipo de base de datos a la que queremos conectarnos.
-  * **Port:** El número de puerto que escucha las conexiones entrantes a la base de datos.
+  * **Host:** el parámetro Host representa la dirección IP o el nombre DNS de la máquina donde reside la base de datos.
-  * **DbName:** Nombre del servicio de instancia o base de datos.
+  * **Port:** el número de puerto que escucha las conexiones entrantes a la base de datos.
-  * **User:** Nombre usuario.
+  * **Ssl:** cuando marcamos el checkbox, se activa el protocolo de seguridad.
-  * **Passwd:** Contraseña del usuario.
+  * **DbName:** nombre del servicio de instancia o base de datos.
-  * **DbType:** Indica el proveedor o tipo de base de datos a la que queremos conectarnos.
+  * **User:** nombre usuario.
+  * **Password:** contraseña del usuario.
 ===== Funciones =====
-  * **connect_DB():** Intenta la conexión a la base de datos configurada. En las propiedades del objeto (Adaptador de base de datos) están los campos de parámetros donde se configura la dirección de conexión. Devuelve verdadero (Mensaje de acceso con éxito en el log) si tiene éxito o falso (Mensaje de error y la causa en log) en el caso contrario.
+  * **connect_DB():** intenta la conexión a la base de datos configurada. En las propiedades del objeto (Adaptador de base de datos) están los campos de parámetros donde se configura la dirección de conexión. Devuelve verdadero (Mensaje de acceso con éxito en el log) si tiene éxito o falso (Mensaje de error y la causa en log) en el caso contrario.
-  * **dBExecuteStatement(statement):** Ejecuta la sentencia SQL que está contenida en el parámetro (statement). Permite al usuario modificar los datos de la base de datos de destino. Puede escribir sentencias SQL, Insertar, Eliminar, Actualizar y Fusionar en el parámetro de sentencias y ejecutarlas. La función sustituirá las variables por sus valores en el tiempo de ejecución, esto devuelve un TastInteger con el número de filas que han sido afectadas por la sentencia (Parámetro de entrada (“La sentencia a ejecutar, por ejemplo, INSERT INTO x (a, b, c) VALUES (d, e, f)”), parámetro de salida (Integer con los resultados)).
+  * **dBExecuteStatement(statement):** ejecuta la sentencia SQL que está contenida en el parámetro (statement). Permite al usuario modificar los datos de la base de datos de destino. Puede escribir sentencias SQL, Insertar, Eliminar, Actualizar y Fusionar en el parámetro de sentencias y ejecutarlas. La función sustituirá las variables por sus valores en el tiempo de ejecución, esto devuelve un TastInteger con el número de filas que han sido afectadas por la sentencia. (Parámetro de entrada: La sentencia a ejecutar, por ejemplo: ”INSERT INTO x (a, b, c) VALUES (d, e, f)”), Parámetro de salida: Integer con los resultados).
-  * **dBGetQueryData(Query):** Ejecuta la instrucción SQL Select contenida en el parámetro Query y devuelve los resultados como una variable TastTableData al procedimiento, lo que permite el acceso y el trabajo con los datos en los pasos posteriores del diagrama. El parámetro Query contiene la instrucción Select que se ejecutará en la base de datos. Es posible utilizar variables creadas en el diagrama dentro del parámetro Query, la función sustituirá los valores de las variables en tiempo de ejecución (Parámetro de entrada (Query), parámetro de salida (OutputTable)).
+  * **dBExecuteStatementFromFile:** ejecuta las sentencias que se encuentran en el fichero cuya ruta se encuentra definida en el Parámetro PathToFileWithStatements. Devuelve un entero con el número total de sentencias ejecutadas.
-  * **disconnect_DB():** Intenta desconectarte de la base de datos. Devuelve verdadero si tiene éxito o falso en caso contrario. (Como en el connectDB() vendrá un mensaje de error o de éxito dependiendo de si fue error o éxito).
+  * **dBGetQueryData(Query):** ejecuta la instrucción SQL Select contenida en el parámetro Query y devuelve los resultados como una variable TastTableData al procedimiento, lo que permite el acceso y el trabajo con los datos en los pasos posteriores del diagrama. El parámetro Query contiene la instrucción Select que se ejecutará en la base de datos. Es posible utilizar variables creadas en el diagrama dentro del parámetro Query, la función sustituirá los valores de las variables en tiempo de ejecución (Parámetro de entrada (Query), parámetro de salida (OutputTable)).
-  * **getNumColumns():** Devuelve el número de columnas contenidas en TastTableData que se generó mediante la ejecución de la función dBGetQueryData. Requiere la ejecución de la función dBGetQueryData en los pasos anteriores del diagrama. (No necesita parámetro de entrada, ya que es una función que te devuelve el número de columnas de la tabla que indiques con TastTableData).
+  * **disconnect_DB():** intenta desconectarte de la base de datos. Devuelve verdadero si tiene éxito o falso en caso contrario. (Como en el connectDB() vendrá un mensaje de error o de éxito dependiendo de si fue error o éxito).
+  * **getNumColumns():** devuelve el número de columnas contenidas en TastTableData que se generó mediante la ejecución de la función dBGetQueryData. Requiere la ejecución de la función dBGetQueryData en los pasos anteriores del diagrama. (No necesita parámetro de entrada, ya que es una función que te devuelve el número de columnas de la tabla que indiques con TastTableData).
-  * **getNumRows():** Devuelve el número de filas contenidas en TastTableData que se generó mediante la ejecución de la función dBGetQueryData. Requiere la ejecución de la función dBGetQueryData en los pasos anteriores del diagrama. (No necesita parámetro de entrada, ya que es una función que te devuelve el número de filas de la tabla que indiques con TastTableData).
+  * **getNumRows():** devuelve el número de filas contenidas en TastTableData que se generó mediante la ejecución de la función dBGetQueryData. Requiere la ejecución de la función dBGetQueryData en los pasos anteriores del diagrama. (No necesita parámetro de entrada, ya que es una función que te devuelve el número de filas de la tabla que indiques con TastTableData).
-  * **getTableValue(row, col):** Devuelve el valor contenido en la celda indicada por los parámetros Fila y Columna. Requiere la ejecución de la función dBGetQueryData en los pasos anteriores del diagrama. (Los parámetros de entrada serían la columna y la fila de la cual deseas obtener la información, y la salida, contendría dicha información).
+  * **getOraError():** proporciona el código de error ORA de la consulta SQL ejecutada.
-  * **tableRecorCount(tableName, whereClausule):** Realiza una consulta SQL utilizando la función SQL Count (*). El parámetro de entrada tableName representa el nombre de la tabla o vista que se utilizará para la consulta, y el parámetro de entrada whereClausule representa la cláusula SQL donde debemos aplicar. Devuelve el número de filas contadas por la sentencia.\\ \\
+  * **getSQLSTATE():** proporciona el estado SQL.
+  * **getTableValue(row, col):** devuelve el valor contenido en la celda indicada por los parámetros Fila y Columna. Requiere la ejecución de la función dBGetQueryData en los pasos anteriores del diagrama. (Los parámetros de entrada serían la columna y la fila de la cual deseas obtener la información, y la salida, contendría dicha información).
-=====Gestión de Variables en el Adaptador de Base Datos =====
+  * **tableRecorCount(tableName, whereClausule):** realiza una consulta SQL utilizando la función SQL Count (*). El parámetro de entrada tableName representa el nombre de la tabla o vista que se utilizará para la consulta, y el parámetro de entrada whereClausule representa la cláusula SQL donde debemos aplicar. Devuelve el número de filas contadas por la sentencia.
-La gestión de variables en el Adaptador de Base de Datos es un tema importante, especialmente en cómo se manejan las variables dentro de la función predefinida de la consulta.\\
+  * **transfromSelectIntoInsert:** transforma el resultado del select que se introduce como parámetro en un insert.\\ \\
-  * En lugar de soportar parámetros, es mejor sustituirlos usando esta sintáxis, siendo Data la variable a reemplazar, '"+ #Data +"'. (cita simple, cita doble). Por ejemplo:\\ \\ SELECT '“+ #Data +”' FROM dual
-  * Además, las consultas han utilizado a menudo un alias que se incluye entre comillas. Por ejemplo:\\ \\ SELECT domain FROM dual as “Domain”
-  * Si se manipulan consultas complejas, con varios alias en los que se quieren sustituir varias variables, funciona construyendo en un javascript la consulta completa, siendo necesario saltar las comillas “” de los alias con este símbolo: \. Por ejemplo:\\ \\ SELECT domain FROM dual as \ “Domain” \
+=====Gestión de Variables en el Adaptador de Base Datos =====
+La gestión de variables en el Adaptador de Base de Datos es un tema importante, especialmente en cómo se manejan las variables dentro de la función predefinida de la consulta.\\
+  * En lugar de soportar parámetros, es mejor sustituirlos usando esta sintáxis, siendo Data la variable a reemplazar, '"+ #Data +"' (cita simple, cita doble).\\ \\ Por ejemplo:\\ \\ SELECT '“+ #Data +”' FROM dual
+  * Además, las consultas han utilizado a menudo un alias que se incluye entre comillas.\\ \\  Por ejemplo:\\ \\ SELECT domain FROM dual as “Domain”
+  * Si se manipulan consultas complejas, con varios alias en los que se quieren sustituir varias variables, funciona construyendo en un javascript la consulta completa, siendo necesario saltar las comillas “” de los alias con este símbolo: \ \\ \\ Por ejemplo:\\ \\ SELECT domain FROM dual as \ “Domain” \

TAST DokuWiki

User Tools

Site Tools

Differences

Page Tools