Cómo usar una base de datos externa

en Creador OPEN
Si bien la plataforma Creador OPEN incluye un motor de base de datos similar a SQL que nos
permite crear y manipular tablas por proyectos de una manera simple y fácil, en muchas ocasiones
necesitaremos utilizar bases de datos de clientes ya existentes, tales como SQL Server, mySQL,
postgres, Oracle y otras. En este documento, les explicaré cómo hacerlo.

Primer Paso:
Crear un datasource en el Administrador de Bluedragon

Un datasource corresponde a un identificador que asignamos a los datos de configuración para la

conexión de una base de datos externa. La definición de esta, se debe especificar en el panel
administrativo de Open Bluedragon, que es el motor de Coldfusion que incorpora el bundle de
Creador OPEN.

Asegurándonos que nuestro servidor ya se encuentra en funcionamiento, abrimos nuestro

navegador y escribimos la siguiente url:

http://127.0.0.1:8080/openbd/bluedragon/administrator/login.cfm

Si no hemos cambiado la contraseña, la clave predeterminada será admin.

Luego de ingresar, desde el panel izquierdo, seleccionamos la opción Datasources, y en la nueva

página que se nos abrirá, definimos un nombre a nuestra nueva conexión y seleccionamos el tipo
de servidor al que nos queremos conectar:
(en este ejemplo lo haremos a Microsoft SQL Server)

Presionamos Add Datasource, configuramos los datos que nos aparecerán en pantalla, tales como
nombre de la base de datos (Database name), IP servidor base de datos (Database server), puerto
servidor (Database port), nombre de usuario (User Name), clave (Password) y una descripción
opcional. Al finalizar presionamos Submit. Para revisar, presionamos el botón Verify All
Datasources y si todo va bien el sistema nos lo indicará en verde.
Nota: Si el driver para nuestra base de datos no aparece en el listado, deberemos buscar el driver
JDBC para ella, y colocarlo en la carpeta /openbd/WEB-INF/lib/ (reiniciar CreadorOPEN), y luego
seleccionar en Database Type la alternativa Other.

Segundo Paso:
Definir el modelo en Concepto WAP

Una vez que ya hemos definido nuestro datasource, estamos listos para definir los modelos
(tablas) que vamos a utilizar con ella, en ConceptoWAP.

Para esto, en nuestro diagrama de Concepto definimos un hijo del nodo Modelos, con el nombre
de la tabla que está en el servidor al cual nos conectaremos (nótese que la tabla debe existir
previamente en el servidor de destino), especificar el atributo ds con el nombre de nuestro
datasource como valor, y especificar como hijos las columnas que contiene esa tabla y que
queremos manipular en Concepto.

Por ejemplo:

Considerando el ejemplo del primer paso, tenemos un servidor SQL server configurado como
datasource miSQL, que contiene una tabla llamada administracionGeneral y contiene 20
columnas, pero de las cuales solo nos interesa Nombre, Apellido, Usuario y Clave. El diagrama de
Concepto WAP se vería así:

Nota: Tanto los nombres de la tabla como de las columnas, deben corresponder exactamente a
la definición de ella en el servidor SQL (o del tipo que se haya definido en el datasource) de
destino, incluyendo las mayúsculas y minúsculas.

Concepto solo considerará como existentes las columnas definidas en el modelo, aún cuando la
tabla en el servidor remoto contenga más columnas, por lo que hay que fijarse bien en esta parte.

Un mismo diagrama de Concepto puede utilizar diferentes modelos con diferentes datasources y
modelos internos, y respetar todos los comandos estándares de manejo de modelos.
Tercer Paso:
Utilizando comandos SQL directos sobre un datasource

Si bien podemos una vez definidos los pasos anteriores, consultar y modificar nuestra tabla
remota con los comandos de uso fácil de modelos de ConceptoWAP, también existe una forma de
ejecutar directamente un comando SQL sobre la tabla remota, y esto es utilizando el comando:
Evaluar etiqueta, “cfquery”, con los atributos name y datasource, y como nodo hijo, el comando.

A continuación un ejemplo:

Esta forma de uso, permite ejecutar procedimientos de almacenado y cualquier consulta a

cualquier tabla como comando directo hacia el servidor de destino, dejando el resultado de su
ejecución en la variable definida en el atributo name (en este caso miconsulta).

Es importante notar que para ejecutar este comando, no es necesario definir el modelo en
ConceptoWAP, y basta solo definir el datasource en Bluedragon.