Adaptador de Base de Datos

En el proceso de inicialización, el Adaptador de Base de Datos solicita los datos necesarios para establecer la conexión con la base de datos de destino e intenta establecer la conexión. Si falla, el proceso se cancela.

• Host: El parámetro Host representa la dirección IP o el nombre DNS de la máquina donde reside la base de datos.
• Port: El número de puerto que escucha las conexiones entrantes a la base de datos.
• DbName: Nombre del servicio de instancia o base de datos.
• User: Nombre usuario.
• Password: Contraseña del usuario.
• DbType: Indica el proveedor o tipo de base de datos a la que queremos conectarnos.

• 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).

• 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)).

• 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).

• 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).

• 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.

• 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” \