FileMaker 10. Guía ODBC y JDBC

FileMaker 10 Guía ODBC y JDBC

2004-2009 FileMaker, Inc. Reservados todos los derechos. FileMaker, Inc. 5201 Patrick Henry Drive Santa Clara, California 95054 FileMaker y el logotipo de la carpeta de archivos, Bento y el logotipo de Bento son marcas registradas de FileMaker, Inc., en EE. UU. y en otros países. Mac y el logotipo de Mac son propiedad de Apple Inc. registradas en EE.UU. y otros países. Las demás marcas comerciales pertenecen a sus respectivos propietarios. La documentación de FileMaker está protegida por derechos de autor. Se prohíbe la realización de copias o la distribución de esta documentación sin el consentimiento por escrito de FileMaker. Esta documentación sólo puede utilizarse con una copia del software de FileMaker que tenga una licencia válida. Las personas y compañías, direcciones de correo electrónico y direcciones URL mencionadas en los ejemplos son puramente ficticias, y cualquier parecido con personas, compañías, direcciones de correo electrónico y direcciones URL reales es mera coincidencia. Los créditos aparecen en los documentos Agradecimientos que acompañan a este software. La mención de productos y direcciones URL de terceros es meramente informativa y no representa ningún tipo de garantía ni recomendación. FileMaker, Inc. no asume ninguna responsabilidad respecto al rendimiento de estos productos. Para más información, visite nuestra página Web en www.filemaker.es. Edición: 01

Índice Capítulo 1 Introducción Acerca de esta guía 7 Uso de una base de datos de FileMaker como origen de datos 8 Acceder a una base de datos alojada de FileMaker Pro 8 Limitaciones con herramientas de otros fabricantes 8 Requisitos de red 9 Actualización de archivos de versiones anteriores 9 Instalar controladores actuales 9 Capítulo 2 Instalación de los controladores de clientes ODBC y JDBC de FileMaker Cumplimiento del contrato de licencia 11 Requisitos de hardware y software 11 requisitos del controlador de cliente ODBC (Windows) 11 requisitos del controlador de cliente ODBC (Mac OS) 11 Requisitos del controlador de cliente JDBC 12 Requisitos de red 12 Instalación del controlador de cliente ODBC (Windows) 12 Instalación del controlador de cliente ODBC (Mac OS) 13 Instalación del controlador de cliente JDBC (Windows y Mac OS) 13 Configuración de controladores de cliente 14 Por dónde seguir 14 Capítulo 3 Uso de ODBC para compartir datos de FileMaker Acerca de ODBC 15 Uso del controlador de cliente ODBC 16 Introducción al acceso a un archivo de base de datos de FileMaker 16 Acceso al archivo de base de datos FileMaker desde una aplicación Windows. 17 Especificación de las propiedades del controlador de cliente ODBC para un DSN de FileMaker (Windows) 17 Verificación del acceso mediante ODBC (Windows) 19 Acceso al archivo de base de datos FileMaker desde una aplicación Mac OS 19 Configuración del controlador de cliente ODBC (Mac OS) 19 Especificación de las propiedades del controlador de cliente ODBC para una DSN de FileMaker (Mac OS) 20 Capítulo 4 Uso de JDBC para compartir datos de FileMaker Acerca de JDBC 21

4 Guía de ODBC y JDBC de FileMaker Uso del controlador de cliente JDBC 21 Acerca del controlador de cliente JDBC 21 Uso de una URL de JDBC para conectarse a la base de datos 22 Especificación de propiedades en el subnombre de la URL 24 Verificación del acceso mediante JDBC 25 Capítulo 5 Estándares admitidos Compatibilidad con caracteres Unicode 27 secuencias SQL 27 Secuencia SELECT 27 cláusulas SQL 28 Cláusula FROM 29 Cláusula WHERE 29 Cláusula GROUP BY 29 Cláusula HAVING 30 Operador UNION 30 Cláusula ORDER BY 30 Cláusula FOR UPDATE 31 Secuencia DELETE 33 Secuencia INSERT 33 Secuencia UPDATE 34 Secuencia CREATE TABLE 35 Secuencia ALTER TABLE 35 Secuencia CREATE INDEX 35 Secuencia DROP INDEX 36 Funciones de agregación SQL 36 Expresiones SQL 37 Nombres de campo 37 Constantes y literales 37 Notación exponencial/científica 38 Operadores numéricos 38 Operadores de caracteres 38 Operadores de fecha 39 Operadores relacionales 39 Operadores lógicos 40 Funciones 41 Prioridad de operadores 43 Funciones de catálogo de ODBC 43 Funciones de metadatos de JDBC 43 Palabras clave de SQL reservadas 44

Índice 5 Capítulo 6 Asignación de campos de FileMaker a tipos de datos ODBC Capítulo 7 Asignación de campos de FileMaker a tipos de datos JDBC Capítulo 8 Mensajes de error de ODBC y JDBC Mensajes de error de ODBC 51 mensajes de error del controlador ODBC 51 Mensajes de error del administrador de controladores ODBC 51 Mensajes de error del cliente de SequeLink 51 Mensajes de error del servidor de SequeLink 52 Mensajes de error del origen de datos 52 Mensajes de error de JDBC 52 mensajes de error del controlador JDBC 52 Mensajes de error del servidor de SequeLink 52 Mensajes de error del origen de datos 53 Índice 55

6 Guía de ODBC y JDBC de FileMaker

Capítulo 1 Introducción Esta guía explica conceptos y detalles para ayudarle a compartir datos de FileMaker con otras aplicaciones utilizando ODBC (Open Database Connectivity, Conectividad abierta de bases de datos) y JDBC (Java Database Connectivity, Conectividad de bases de datos de Java). Esta guía también documenta el modo en que los controladores de clientes ODBC y JDBC, cuando se utilizan con FileMaker Pro y FileMaker Server Advanced, admiten los estándares de la industria para ODBC, JDBC y SQL (Structured Query Language, Lenguaje de consulta estructurado). Puede utilizar FileMaker Pro, FileMaker Pro Advanced o FileMaker Server Advanced para crear y probar su solución de base de datos. Así puede utilizar la solución de base de datos de FileMaker como fuente de datos con aplicaciones compatibles con ODBC y JDBC. Debe instalar los controladores ODBC y JDBC de FileMaker en el equipo en el que esté instalada la aplicación de otro fabricante. Importante Esta guía describe la utilización del software FileMaker como fuente de datos. Para obtener información paso a paso sobre el uso de FileMaker Pro como aplicación cliente de ODBC, consulte la Ayuda de FileMaker Pro. La siguiente tabla proporciona una introducción sobre el uso de ODBC y JDBC con el software FileMaker. Cómo desea realizar esta tarea? Cómo lo va a hacer? Consulte Utilizar FileMaker Pro como fuente de datos/ compartir datos de FileMaker Pro 1. Consultas SQL 2. ODBC y JDBC Esta guía Utilizar FileMaker Pro como un cliente de ODBC/acceder a datos ODBC 1. De forma interactiva a través del gráfico de relaciones 2. Importación estática única mediante ODBC o menú Archivo > Abrir. Asimismo, el paso de guión Importar registros y el paso de guión Ejecutar SQL Ayuda de FileMaker Pro Acerca de esta guía 1 Para obtener información sobre la utilización de ODBC y JDBC con versiones anteriores de FileMaker Pro, consulte www.filemaker.es/documentation. 1 En esta guía se asume que conoce los conceptos básicos del uso de ODBC y JDBC, así como con la creación de consultas SQL. Deberá consultar otra publicación para obtener más información sobre estos temas. 1 Esta guía utiliza FileMaker Pro para hacer referencia tanto a FileMaker Pro como a FileMaker Pro Advanced, a no ser que se describan funcionalidades específicas de FileMaker Pro Advanced. Nota Puede descargar archivos PDF de la documentación de FileMaker desde www.filemaker.es/documentation. En este sitio Web también dispone de actualizaciones de este documento.

8 Guía de ODBC y JDBC de FileMaker Uso de una base de datos de FileMaker como origen de datos ODBC y JDBC son interfaces de programación de aplicaciones (API). Estas API ofrecen a las aplicaciones cliente un lenguaje común para interactuar con diversos orígenes de datos y servicios de base de datos, incluidos FileMaker Pro y FileMaker Server Advanced. Todas las aplicaciones compatibles con ODBC y JDBC reconocen un subconjunto básico de secuencias SQL. Si trabaja con SQL, puede utilizar otras aplicaciones (como hojas de cálculo, procesadores de texto y herramientas de generación de informes) para ver, analizar y modificar datos de FileMaker. SQL se pasa a través de las interfaces ODBC y JDBC al anfitrión FileMaker del origen de datos, realizando consultas como SELECT nombre, apellidos FROM clientes WHERE ciudad='parís' y realizando actualizaciones como la creación de un nuevo registro con INSERT INTO clientes (nombre, apellido) VALUES ('Jane','Smith'). Acceder a una base de datos alojada de FileMaker Pro Tanto con FileMaker Server Advanced como con FileMaker Pro, puede alojar un archivo de base de datos de FileMaker como origen de datos, compartiendo sus datos con otras aplicaciones mediante ODBC y JDBC. La siguiente tabla describe lo que permite cada producto de FileMaker. Este producto de FileMaker FileMaker Server Advanced FileMaker Pro Permite Hasta 50 conexiones y acceso local (el mismo equipo) y remoto (tanto para programas intermedios como servidores Web como para el acceso de clientes remotos desde aplicaciones de productividad de escritorio). Hasta nueve conexiones y sólo acceso local (el mismo equipo). Los componentes de los plug-in ODBC y JDBC necesarios para compartir datos con otras aplicaciones se instalan con FileMaker Server Advanced y FileMaker Pro. Para acceder a un archivo de base de datos de FileMaker hospedado, es necesario instalar el controlador de cliente de ODBC o JDBC correspondiente. Instale el controlador de cliente en el equipo en el que esté instalada la aplicación de otro fabricante. Consulte capítulo 2, Instalación de los controladores de clientes ODBC y JDBC de FileMaker para obtener información sobre cómo instalar los archivos del controlador necesarios para acceder a un origen de datos de FileMaker. Si la solución de base de datos FileMaker utiliza más de un archivo de base de datos FileMaker, todos los archivos de base de datos deben estar en el mismo equipo. El Capítulo 5, Estándares admitidos, describe las secuencias de SQL que admiten los controladores de clientes ODBC y JDBC cuando se utilizan con FileMaker Pro y FileMaker Server Advanced. Importante Si desactiva la compartición de ODBC/JDBC después de que haya estado activada, las fuentes de datos hospedadas por FileMaker Server Advanced o FileMaker Pro dejarán inmediatamente de estar disponibles. El administrador de la base de datos no tiene capacidad para alertar a las aplicaciones cliente de ODBC y JDBC sobre la disponibilidad del origen de datos (el administrador sólo se puede comunicar con los clientes del archivo de base de datos de FileMaker). No se informa de ningún error y la aplicación cliente debe notificar a los usuarios que el origen de datos no está disponible y que no se pueden completar las transacciones. Si la aplicación cliente intenta conectarse a un archivo de base de datos de FileMaker que no está disponible, un mensaje explica que la conexión ha fallado. Limitaciones con herramientas de otros fabricantes 1 Asistente para consultas de Microsoft: No se puede acceder a ninguna fuente de datos o nombres de columnas de Filemaker con caracteres ASCII superiores o de dos bytes. En su lugar, utilice Microsoft Query e introduzca manualmente los caracteres escritos entre comillas dobles. 1 Microsoft Access: No se puede acceder a ninguna fuente de datos o nombres de columnas de Filemaker con caracteres ASCII superiores o de dos bytes.

Capítulo 1 Introducción 9 Requisitos de red Necesita una red TCP/IP al utilizar FileMaker Server Advanced si desea alojar un archivo de base de datos de FileMaker como origen de datos a través de una red. FileMaker Pro sólo admite el acceso local (el mismo equipo). Actualización de archivos de versiones anteriores Instalar controladores actuales Si instaló un controlador de una versión anterior a FileMaker Server 9 Advanced o FileMaker Pro 9, debe desinstalar el controlador anterior e instalar el de la versión 10. Para obtener más información, consulte el capítulo 2, Instalación de los controladores de clientes ODBC y JDBC de FileMaker. Nota Tiene que crear un DSN para cada archivo de base de datos de FileMaker al que desee acceder como origen de datos. Si había configurado previamente el acceso a través de un DSN que permitía que las tablas se difundieran entre varios archivos de base de datos de FileMaker, deberá consolidar estas tablas en un único archivo de base de datos (o bien crear varios DSN).

10 Guía de ODBC y JDBC de FileMaker

Capítulo 2 Instalación de los controladores de clientes ODBC y JDBC de FileMaker Estas instrucciones le ayudan a instalar los controladores necesarios para acceder a fuentes de datos de FileMaker de aplicaciones de otros fabricantes y personalizadas a través de ODBC (Open Database Connectivity, Conectividad abierta de bases de datos) y JDBC (Java Database Connectivity, Conectividad de bases de datos Java). Los controladores de cliente se obtienen mediante una instalación independiente en el CD de FileMaker o descargándolos electrónicamente en la carpeta \xdbc. Las últimas versiones de los controladores de cliente también están disponibles en www.filemaker.es/support/technologies. Si va a alojar un archivo de base de datos de FileMaker mediante FileMaker Server Advanced, ponga los controladores de cliente a disposición de los usuarios remotos. Tras instalar el controlador de cliente necesario, puede configurarlo para tener acceso a fuentes de datos de FileMaker y crear consultas SQL (Structured Query Language, Lenguaje de consulta estructurado) para interactuar con los datos. Cumplimiento del contrato de licencia Los controladores de clientes ODBC y JDBC son las partes de controladores del software de FileMaker que permiten a las aplicaciones personalizadas o de otros fabricantes acceder a los archivos de FileMaker como origen de datos ODBC o JDBC. Requisitos de hardware y software Para instalar y utilizar los controladores de clientes ODBC y JDBC se necesita, como mínimo, el siguiente equipo y software: requisitos del controlador de cliente ODBC (Windows) 1 Pentium a 300 MHz o superior 1 64 MB de memoria RAM para Windows 2000, 128 MB de memoria RAM para Windows XP 1 Microsoft Data Access Components (MDAC) 2.8 SP1 1 Windows MDAC 6.0 para Vista requisitos del controlador de cliente ODBC (Mac OS) 1 Apple G3 o superior (no se admiten las tarjetas de actualización G3) 1 128 MB de memoria RAM total 1 Mac OS X 10.3.9 o 10.4 (el software también puede funcionar con versiones posteriores certificadas por FileMaker)

12 Guía de ODBC y JDBC de FileMaker Requisitos del controlador de cliente JDBC Las aplicaciones que utilicen Requieren JDBC 1,22 API JVM (Java Virtual Machine, Máquina virtual Java) compatible con JDK 1.2 JDBC 2.0 Core API JVM compatible con JDK 1.3 Paquete opcional de JDBC 2.0 JVM compatible con JDK 1.3 Las siguientes API también son necesarias y se suministran con el cliente Java SequeLink: 1 Paquete opcional de JDBC 2.0 1 JNDI 1.2 1 JTA 1.0.1 JCA API JDK 1,3 JDBC 3.0 API JDK 1.4 o 1.5 Para averiguar la versión de Java que se utiliza, abra una ventana de comandos (Windows) o la ventana Terminal (Mac OS) y escriba java -version. Requisitos de red Si va a acceder a un origen de datos de FileMaker alojado en otro equipo, necesitará acceso de red a través de TCP/IP. Instalación del controlador de cliente ODBC (Windows) Si ha instalado previamente el controlador de cliente ODBC para Windows, desinstálelo con Agregar o eliminar programas antes de instalar una versión actualizada. Para instalar el controlador de cliente ODBC: Para instalar el controlador de cliente ODBC, necesita MDAC 2.8 SP1 (disponible en www.microsoft.com). 1. En la carpeta del Instalador del controlador de cliente \xdbc\odbc, haga doble clic en setup. Aparece DataDirect SequeLink para ODBC 5,5 - Asistente de InstallShield. 2. Siga las instrucciones en pantalla para instalar el controlador de cliente ODBC. La Herramienta de sincronización de fuentes de datos, el Administrador de la herramienta de sincronización de fuentes de datos y los Libros en línea SequeLink no aparecen seleccionados como parte de la instalación predeterminada, ya que no se necesitan para utilizar el controlador de cliente ODBC. De forma predeterminada, el controlador de cliente ODBC se instalará en esta carpeta: C:\Archivos de programa\datadirect\slodbc55. Si lo desea, puede elegir otra unidad u otra carpeta. 3. Una vez completada la instalación, haga clic en Finalizar. Ya puede configurar el controlador de cliente ODBC, DataDirect 32-BIT SequeLink 5,5, para acceder a fuentes de datos de FileMaker. Nota Si surgen problemas al realizar la instalación directamente, instale el controlador a través de Agregar o quitar programas de Windows (seleccione menú Inicio > Panel de control > Agregar o quitar programas).

Capítulo 2 Instalación de los controladores de clientes ODBC y JDBC de FileMaker 13 Instalación del controlador de cliente ODBC (Mac OS) Si se ha instalado previamente el controlador de cliente ODBC para Mac OS, primero hay que desinstalarlo antes de instalar una versión actualizada. Para instalar el controlador de cliente ODBC: En la carpeta Instalador del controlador de cliente /xdbc/odbc, copie el archivo SequeLink.bundle en la biblioteca de sistema o de usuario. Si no hay ninguna carpeta /ODBC, cree una manualmente: Copie SequeLink.bundle Biblioteca en esta carpeta: Use esta ruta del controlador durante la configuración: Sistema /Biblioteca/ODBC /Biblioteca/ODBC/SequeLink.bundle/Contents/MacOS/ivslk20.dylib Usuario /Usuarios/<usuario>/Biblioteca/ ODBC /Usuarios/<usuario>/Biblioteca/ODBC/SequeLink.bundle/Contents/MacOS/ ivslk20.dylib Nota Si ha iniciado sesión con una cuenta que tiene privilegios de administrador, no es necesario realizar ningún cambio en los permisos después de crear la carpeta /ODBC. La carpeta ODBC debe tener los siguientes permisos: 1 Propiedad del grupo raíz del administrador 1 Permisos de lectura/escritura/ejecución para raíz y administrador 1 Permisos de lectura/ejecución para otras cuentas Este controlador de cliente se ha probado con el Administrador de ODBC 1.0.2 (disponible con Mac OS 10.4.11) y con el Administrador de ODBC 1.1 (disponible con Mac OS 10.5.4). Importante Use el Administrador de ODBC incluido en el software del administrador de controladores ODBC recomendado para la aplicación cliente. Instalación del controlador de cliente JDBC (Windows y Mac OS) El programa de instalación y el controlador de cliente JDBC funcionan tanto en Windows como en Mac OS. Debe tener acceso de escritura a la carpeta en la que instale el controlador de cliente JDBC. De forma predeterminada, la carpeta que contiene el programa de instalación es la carpeta de instalación. Si se ha instalado previamente el controlador de cliente JDBC, primero hay que desinstalarlo antes de instalar una versión actualizada. Para instalar el controlador de cliente JDBC: 1. Abra la carpeta del Instalador del controlador de cliente \xdbc\jdbc y haga doble clic en sljcinstaller.jar. Aparece la ventana Instalador de DataDirect SequeLink para JDBC 5,5. Nota El entorno de ejecución de Java debe estar asociado con archivos.jar. Es posible que otras aplicaciones, como WinZip o Stuffit, también estén asociadas con archivos.jar. Si es así, pueden impedir que se abra el instalador de JDBC. Si no se abre la ventana del instalador, abra una ventana de comandos (Windows) o la ventana Terminal (Mac OS) y cambie a la carpeta del controlador de cliente JDBC. Podrá iniciar el instalador desde ella, escribiendo el siguiente comando: java -jar sljcinstaller.jar.

14 Guía de ODBC y JDBC de FileMaker 2. Haga clic en Siguiente. Revise el contrato de licencia. 3. Si el contrato de licencia le parece aceptable, seleccione Acepto los términos del contrato de licencia y haga clic en Siguiente. Aparece una ventana con las opciones de instalación. 4. Seleccione Instalar herramientas del desarrollador. Entre estas herramientas se encuentra JDBCTest, que le ayuda a comprobar las conexiones de JDBC. 5. Introduzca un Directorio de instalación. 1 Windows: Introduzca una ruta que incluya el archivo ejecutable de Java (java.exe). 1 Mac OS: Introduzca /Library/Java/Extensions (o cualquier otra ubicación incluida en la ruta de clase de la aplicación Java). 6. Haga clic en Siguiente. 7. Confirme las opciones de instalación y haga clic en Instalar. 8. Una vez completada la instalación, haga clic en Finalizar. Ya puede configurar el controlador de cliente JDBC para acceder a las fuentes de datos de FileMaker. Configuración de controladores de cliente Antes de utilizar una aplicación cliente para acceder a fuentes de datos de FileMaker, hay que configurar un controlador de cliente para el origen de datos. Los valores de la configuración identifican el controlador de cliente que se utiliza, la ubicación del origen de datos y los detalles referentes a la forma de conexión. Importante Al configurar un controlador de cliente de FileMaker, debe especificar 2399 como puerto. Para ODBC (Windows), especificará el puerto en el Administrador de orígenes de datos ODBC. Para ODBC (Mac OS), especificará el puerto en el Administrador de ODBC. Para JDBC, especificará el puerto en la URL de JDBC. Para obtener más información sobre el controlador de cliente ODBC en Windows, seleccione el menú Inicio de Windows > Programas > DataDirect SequeLink para ODBC 5,5 > Ayuda del controlador. Nota El sistema de Ayuda que proporciona DataDirect Technologies describe algunas funciones que están fuera del ámbito de la utilización de controladores de cliente ODBC y JDBC para acceder a fuentes de datos de FileMaker. Por dónde seguir Tras instalar y configurar un controlador de cliente, puede construir y ejecutar consultas SQL para acceder a fuentes de datos de FileMaker. Las aplicaciones cliente a veces utilizan otra terminología para acceder a fuentes de datos a través de ODBC. Muchas aplicaciones tienen elementos de menú con nombres como Obtener datos externos o Consulta SQL. Para obtener más detalles, consulte la documentación o la Ayuda incluida con la aplicación.

Capítulo 3 Uso de ODBC para compartir datos de FileMaker El controlador de cliente de ODBC se utiliza para conectarse con un origen de datos de FileMaker desde otra aplicación. La aplicación que utiliza el controlador de cliente ODBC puede acceder directamente a los datos del archivo de base de datos de FileMaker. 1 Windows: El controlador de cliente ODBC de FileMaker es DataDirect 32-BIT SequeLink 5.5. 1 Mac OS: El controlador de cliente ODBC de FileMaker es ivslk20.dylib. Nota Puede utilizar también FileMaker Pro como aplicación cliente, interactuando con registros procedentes de otras fuentes de datos mediante ODBC usando SQL. Consulte la ayuda de FileMaker Pro para obtener información sobre cómo acceder a un origen de datos externos a través de ODBC. Acerca de ODBC ODBC es una API que permite a las aplicaciones acceder a datos de muchos sistemas de gestión de bases de datos. ODBC ofrece a las aplicaciones cliente un lenguaje común para interactuar con fuentes de datos y servicios de base de datos. Todas las aplicaciones que admiten ODBC reconocen un subconjunto común de secuencias. SQL le permite utilizar otras aplicaciones (como hojas de cálculo, procesadores de texto y herramientas de generación de informes) para ver, analizar y modificar datos de FileMaker. Consulte capítulo 5, Estándares admitidos, para ver las secuencias SQL, las funciones y las expresiones que admite el controlador de cliente ODBC. La aplicación puede comunicarse directamente con un archivo de base de datos de FileMaker usando el controlador de cliente ODBC. Las secuencias SQL se envían al anfitrión de FileMaker del archivo de la base de datos y luego se devuelven los resultados. Si utiliza FileMaker Server Advanced para alojar un archivo de base de datos de FileMaker como origen de datos, este archivo puede estar ubicado en otro equipo (el equipo servidor) conectado a la red mientras la aplicación cliente se aloja en su equipo (el equipo cliente). Esto es lo que se denomina una configuración cliente/servidor. Aplicación cliente Administrador de controladores Oracle ODBC de Oracle Controlador ODBC de SQL Server Controlador de cliente ODBC Oracle Microsoft SQL Server FileMaker

16 Guía de ODBC y JDBC de FileMaker Uso del controlador de cliente ODBC Puede utilizar el controlador de cliente ODBC con cualquier aplicación compatible con ODBC. Compartiendo el archivo de base de datos de FileMaker como origen de datos, puede: 1 realizar la fusión de correspondencia con Microsoft Word 1 crear gráficos con Microsoft Excel 1 mover datos de FileMaker a un DBMS, como Microsoft SQL Server 1 analizar en mayor medida los datos de FileMaker con herramientas de consultas o de generación de informes para crear gráficos o consultas ad hoc y ejecutar análisis de desglose 1 crear una aplicación de Microsoft Visual Basic que comparta información con FileMaker Pro Para compartir un archivo de base de datos de FileMaker como origen de datos, utilice FileMaker Pro para definir cuentas que necesiten acceder al archivo de base de datos. A continuación, puede controlar el acceso al archivo de base de datos asignando conjuntos de privilegios a las cuentas, incluido el privilegio ampliado de acceso mediante ODBC/JDBC. Finalmente, active la aplicación anfitriona FileMaker Server Advanced o FileMaker Pro para compartir datos mediante ODBC/JDBC. Para obtener más información, consulte la Ayuda de FileMaker Pro o FileMaker Server. Importante El controlador de cliente ODBC sustituye el controlador ODBC de FileMaker Pro publicado con una versión anterior de FileMaker. Si ha configurado previamente el acceso a un origen de datos de FileMaker usando el controlador antiguo, deberá volver a definir el acceso usando y configurando el nuevo controlador. Nota Para confirmar que el servidor SequeLink se está ejecutando, puede utilizar el Monitor de actividad en Mac OS o el Administrador de tareas en Windows para comprobar el estado del proceso ddfmsoc. Cuando se inicia el proceso, se llama FMSocket_SL55, y los eventos se registran con ese nombre. El proceso de SequeLink Server es independiente del proceso de FileMaker Server. Introducción al acceso a un archivo de base de datos de FileMaker Desde una aplicación compatible con ODBC, puede definir consultas SQL para acceder a un archivo de base de datos FileMaker. El controlador de cliente ODBC debe estar instalado en el equipo que genera la consulta SQL. Para acceder a un archivo de base de datos de FileMaker: 1. En FileMaker Pro, revise los conjuntos de privilegios que ha asignado a las cuentas que accederán al archivo de base de datos. Las cuentas que precisen acceso deben utilizar un conjunto de privilegios con el privilegio ampliado Acceso mediante ODBC/JDBC. 2. Active FileMaker Server Advanced (mediante la consola de administración de FileMaker Server) o la aplicación anfitriona FileMaker Pro para compartir datos mediante ODBC/JDBC. Consola de administración de FileMaker Server: Haga clic en ODBC/JDBC y seleccione Activar ODBC/JDBC. FileMaker Pro: Seleccione el menú Archivo > Compartir > ODBC/JDBC y establezca ODBC/JDBC Sharing en On.

Capítulo 3 Uso de ODBC para compartir datos de FileMaker 17 3. Asegúrese de que el archivo de base de datos FileMaker al que quiere acceder está hospedado y está disponible. Si la solución de base de datos FileMaker utiliza más de un archivo de base de datos FileMaker, todos los archivos de base de datos deben estar en el mismo equipo. 4. Conecte con el origen de datos de FileMaker. 5. Defina y ejecute una consulta SQL en la aplicación cliente. Cada archivo de base de datos de FileMaker que esté abierto y configurado para el acceso es una fuente de datos independiente (cree una DSN para cada archivo de base de datos de FileMaker al que desee acceder como fuente de datos). Cada base de datos puede tener una o más tablas. Los campos de FileMaker se representan como columnas. El nombre de campo completo, incluyendo todos los caracteres no alfanuméricos, aparece como nombre de columna. Nota En Windows, Microsoft Access puede importar sólo 32 campos o menos de una vez desde un archivo de base de datos de FileMaker mediante ODBC. Si el archivo de base de datos tiene más de 32 campos, impórtelos en incrementos de 32. Acceso al archivo de base de datos FileMaker desde una aplicación Windows. Especificación de las propiedades del controlador de cliente ODBC para un DSN de FileMaker (Windows) Cree un DSN para cada archivo de base de datos de FileMaker al que desee acceder como origen de datos. El DSN identifica el controlador de cliente ODBC de FileMaker, la ubicación de la aplicación anfitriona de FileMaker y el archivo de base de datos de FileMaker al que está accediendo como origen de datos. Para configurar o cambiar las propiedades del controlador de cliente de ODBC: 1. Abra el panel de control Administrador de orígenes de datos ODBC. En el Panel de control de Windows, seleccione Herramientas administrativas > Orígenes de datos (ODBC). En Windows XP, Herramientas administrativas aparece en la categoría Rendimiento y mantenimiento. En Windows Vista, Herramientas administrativas aparece en la categoría Sistema y mantenimiento. 2. Haga clic en la pestaña DSN de sistema. Si ha configurado el origen de datos como DSN de usuario o DSN de archivo, haga clic en la pestaña correspondiente. 3. Haga clic en Agregar. Nota Si está modificando las propiedades de un origen de datos existente, seleccione el origen de datos, haga clic en Configurar y continúe con el paso 6.

18 Guía de ODBC y JDBC de FileMaker 4. Seleccione DataDirect 32-BIT SequeLink 5,5 en la lista de controladores. Si el controlador no aparece en la lista del Administrador de orígenes de datos ODBC, busque la entrada (predeterminada) de la clave del registro HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI\ODBC Drivers mediante Regedit (seleccione menú Inicio > Ejecutar > Regedit). Los datos de esta entrada deben ser (valor no establecido). Si, en cambio, ve una cadena en blanco, haga clic con el botón derecho en (Predeterminado), seleccione Eliminar, y haga clic en Sí para confirmar. Así, la entrada se restablece como (valor no establecido). Desinstale y vuelva a instalar el controlador de cliente ODBC para verlo en el Administrador de fuentes de datos ODBC. 5. Haga clic en Finalizar. Aparece el cuadro de diálogo Configuración de DataDirect SequeLink para ODBC, con la pestaña General seleccionada. 6. En Nombre de origen de datos, escriba un nombre significativo para los demás usuarios que accedan al origen de datos de FileMaker. Si lo desea, puede introducir una Descripción. Asegúrese de que Usar LDAP no está marcado. El controlador de cliente ODBC no incluye ningún archivo.dll de traductor, por lo que hacer clic en Traductor no le permitirá configurar un convertidor de ODBC. 7. En SequeLink Server Host, escriba la ubicación del origen de datos. Si se está conectando a un archivo de base de datos de FileMaker hospedado por FileMaker Pro en el equipo local, escriba localhost (o 127.0.0.1). Si se está conectando a un archivo de base de datos de FileMaker hospedado por FileMaker Server Advanced a través de una red, escriba la dirección IP de FileMaker Server. 8. En SequeLink Server Port, escriba 2399. Importante Al configurar un origen de datos de FileMaker, debe especificar 2399 en SequeLink Server Port. 9. En Origen de datos del servidor, escriba el nombre de archivo de la base de datos de FileMaker que esté utilizando como origen de datos (no escriba la extensión del nombre de archivo). 10. Si se ha activado la compartición mediante ODBC/JDBC en la aplicación anfitriona, haga clic en el botón situado a la derecha de Origen de datos del servidor para mostrar los nombres de archivo de los archivos de base de datos de FileMaker actualmente abiertos para poder seleccionar entre ellos. Si el nombre de la base de datos contiene espacios, sustitúyalos por los caracteres de transferencia %20. Por ejemplo, MY%20DATABASE. 11. Haga clic en Aceptar para guardar la información del origen de datos. Si está compartiendo otro archivo de base de datos de FileMaker, vuelva al paso 3 y configure el archivo de base de datos como origen de datos. 12. Haga clic en Aceptar para cerrar el cuadro de diálogo Administrador de fuentes de datos ODBC.

Capítulo 3 Uso de ODBC para compartir datos de FileMaker 19 Verificación del acceso mediante ODBC (Windows) Para verificar que ha configurado correctamente el controlador de cliente de ODBC para acceder al origen de datos de FileMaker: 1. Abra el panel de control Administrador de fuentes de datos ODBC. En el Panel de control de Windows, seleccione Herramientas administrativas > Orígenes de datos (ODBC). En Windows XP, Herramientas administrativas aparece en la categoría Rendimiento y mantenimiento. 2. Haga clic en la pestaña DSN de sistema. Si ha configurado el origen de datos como DSN de usuario o DSN de archivo, haga clic en la pestaña correspondiente. 3. Elija el origen de datos de FileMaker que configuró previamente. El nombre del origen de datos que introdujo originalmente aparece debajo de Nombre y DataDirect 32-BIT SequeLink 5.5 aparece como Controlador. 4. Haga clic en Configurar. Aparece el cuadro de diálogo Configuración de DataDirect SequeLink para ODBC. 5. Haga clic en Probar conexión. Se le pedirá que introduzca su nombre de cuenta de FileMaker (en Nombre de usuario de base de datos) y su contraseña (en Contraseña de base de datos). Si la conexión es correcta, recibirá el mensaje La prueba de conexión se realizó correctamente. Si la conexión falla: 1 Asegúrese de que el archivo de base de datos de FileMaker está hospedado y disponible. 1 Actualice o corrija la información de la conexión. 1 Asegúrese de que la cuenta de FileMaker utiliza un conjunto de privilegios con el privilegio ampliado Acceso mediante ODBC/JDBC. 1 Verifique que la aplicación anfitriona FileMaker Pro o FileMaker Server se ha configurado para la compartición mediante ODBC/JDBC. Acceso al archivo de base de datos FileMaker desde una aplicación Mac OS Si construye aplicaciones personalizadas, utilice la versión 3.52.1 de las cabeceras y bibliotecas ODBC. Es posible que las aplicaciones construidas con la versión 3.51 no puedan cargar el controlador de cliente. Configuración del controlador de cliente ODBC (Mac OS) Configure el controlador de cliente con el administrador ODBC incluido en el software del administrador del controlador ODBC recomendado por la aplicación cliente. Este controlador de cliente se ha probado con el Administrador de ODBC 1.0.2 (disponible con Mac OS 10.4.11) y con el Administrador de ODBC 1.1 (disponible con Mac OS 10.5.4).

20 Guía de ODBC y JDBC de FileMaker Al configurar el controlador de cliente, se le pedirá que proporcione una breve descripción y la ruta de acceso al archivo de controlador: Si ha copiado SequeLink.bundle en esta biblioteca: /Biblioteca/ODBC /Usuarios/<usuario>/Biblioteca/ODBC Use esta ruta del controlador durante la configuración: /Biblioteca/ODBC/SequeLink.bundle/Contents/MacOS/ivslk20.dylib /Usuarios/<usuario>/Biblioteca/ODBC/SequeLink.bundle/Contents/MacOS/ ivslk20.dylib El administrador ODBC también le permite definir opcionalmente palabras clave y una ruta de configuración de archivo, pero el controlador de cliente no necesita tal información. Especificación de las propiedades del controlador de cliente ODBC para una DSN de FileMaker (Mac OS) Cree un DSN para cada archivo de base de datos de FileMaker al que desee acceder como origen de datos. El DSN identifica el controlador de cliente ODBC de FileMaker, la ubicación de la aplicación anfitriona de FileMaker y el archivo de base de datos de FileMaker al que está accediendo como origen de datos. Importante El controlador de cliente ODBC para Mac OS no admite los caracteres ASCII superiores, de dos bytes o caracteres japoneses en nombres de bases de datos o nombres de tablas. Si el archivo de base de datos FileMaker utiliza estos caracteres, cree una segunda base de datos y utilice sólo caracteres ASCII para el nombre de archivo y nombres de tabla. En la segunda base de datos, cree una referencia de base de datos que apunte a los datos en el archivo de base de datos original. Comparta ambos archivos con ODBC/JDBC, pero utilice el segundo archivo de base de datos cuando defina el DSN. Además, tendrá que especificar estos valores de palabras clave para el DSN: Palabra clave Anfitrión Valor Si se está conectando a un archivo de base de datos de FileMaker hospedado por FileMaker Pro en el equipo local, escriba localhost (o 127.0.0.1). Si está conectándose a un archivo de base de datos de FileMaker hospedado por FileMaker Server Advanced en una red, escriba la dirección IP o el nombre del anfitrión de FileMaker Server. Puerto Escriba 2399. ServerDataSource Escriba el nombre del archivo de base de datos de FileMaker que esté utilizando como origen de datos (no escriba la extensión). Si el nombre de la base de datos contiene espacios, sustitúyalos por los caracteres de transferencia %20. Por ejemplo, ServerDataDource=MY%20DATABASE. No se admiten los caracteres de dos bytes.