FileMaker 10. Guide ODBC et JDBC

Transcription

1 FileMaker 10 Guide ODBC et JDBC

2 FileMaker, Inc. Tous droits réservés. FileMaker, Inc Patrick Henry Drive Santa Clara, California 95054, Etats-Unis FileMaker, le logo en forme de dossier, Bento et le logo Bento sont des marques commerciales ou des marques déposées de FileMaker, Inc. aux Etats-Unis et dans d autres pays. Mac et le logo Mac sont la propriété d Apple Inc., et sont enregistrés aux Etats-Unis et dans d autres pays. Toutes les autres marques sont la propriété de leurs détenteurs respectifs. La documentation de FileMaker est protégée par la législation sur les droits d auteur. Vous nfêtes pas autorisé à créer des copies supplémentaires ni à distribuer cette documentation sans lfaccord écrit de FileMaker. Vous devez posséder une copie sous licence valide de FileMaker pour utiliser cette documentation. Toutes les personnes, sociétés, adresses et URL citées dans les exemples sont fictives et toute ressemblance avec des personnes, des sociétés, des adresses et des URL existantes ne serait que pure coïncidence. La liste des auteurs est disponible dans les documents Remerciements fournis avec ce logiciel. Les produits et URL tiers sont mentionnés à titre indicatif uniquement, et non pas à titre de recommandation. FileMaker, Inc. se dégage de toute responsabilité concernant les performances de ces produits. Pour plus de détails, consultez notre site Web à l adresse Edition : 01

3 Table des matières Chapitre 1 Introduction A propos de ce guide 7 Utilisation d une base de données FileMaker en tant que source de données 7 Accès à une base de données FileMaker Pro hébergée 8 Limites avec des outils tiers 8 Configuration requise pour une utilisation en réseau 9 Mise à jour de fichiers à partir de versions antérieures 9 Installation des pilotes actuels 9 Chapitre 2 Installation des pilotes clients ODBC et JDBC pour FileMaker Respect du contrat de licence 11 Configurations matérielles et logicielles requises 11 Configuration requise pour le pilote client ODBC (Windows) 11 Configuration requise pour le pilote client ODBC (Mac OS) 11 Configuration requise pour le pilote client JDBC 12 Configuration requise pour une utilisation en réseau 12 Installation du pilote client ODBC (Windows) 12 Installation du pilote client ODBC (Mac OS) 13 Installation du pilote client JDBC (Windows et Mac OS) 13 Configuration des pilotes clients 14 Etape suivante 14 Chapitre 3 Utilisation d ODBC pour partager des données FileMaker A propos d ODBC 15 Utilisation du pilote client ODBC 16 Présentation de l accès à un fichier de base de données FileMaker 17 Accès à un fichier de base de données FileMaker depuis une application Windows 17 Spécification des propriétés de pilote client ODBC pour une source de données FileMaker (Windows) 17 Vérification de l accès via ODBC (Windows) 19 Accès à un fichier de base de données FileMaker depuis une application Mac OS 20 Configuration du pilote client ODBC (Mac OS) 20 Spécification des propriétés du pilote client ODBC pour une source de données FileMaker (Mac OS) 20 Chapitre 4 Utilisation de JBC pour partager des données FileMaker A propos de JDBC 21

4 4 Guide ODBC et JDBC FileMaker Utilisation du pilote client JDBC 21 A propos du pilote client JDBC 21 Utilisation d une URL JDBC pour la connexion à une base de données 22 Spécification des propriétés du pilote dans le sous-nom de l URL 23 Vérification de l accès via JDBC 25 Chapitre 5 Standards pris en charge Prise en charge des caractères Unicode 27 instructions SQL 27 SELECT, instruction 27 clauses SQL 28 Clause FROM 29 Clause WHERE 29 Clause GROUP BY 29 Clause HAVING 30 Opérateur UNION 30 Clause ORDER BY 30 Clause FOR UPDATE 31 DELETE 33 INSERT 33 UPDATE 34 CREATE TABLE 35 ALTER TABLE 35 CREATE INDEX 35 DROP INDEX, instruction 36 Fonctions statistiques SQL 36 Expressions SQL 37 Noms de rubriques 37 Constantes et littéraux 37 Notification en virgule flottante/scientifique 38 Opérateurs numériques 38 Opérateurs de caractères 38 Opérateurs de dates 39 opérateurs relationnels ; 39 Opérateurs logiques 40 Fonctions 41 Ordre de priorité des opérateurs 42 Fonctions de catalogue ODBC 43 Fonctions de métadonnées JDBC 43 Mots-clés SQL réservés 44

5 Table des matières 5 Chapitre 6 Correspondances entre les rubriques FileMaker et les types de données ODBC Chapitre 7 Correspondances entre les rubriques FileMaker et les types de données JDBC Chapitre 8 Messages d erreur ODBC et JDBC Messages d erreur ODBC 51 Messages d erreur du pilote ODBC 51 Messages d erreur du gestionnaire de pilotes ODBC 51 Messages d erreur du client SequeLink 51 Messages d erreur du serveur SequeLink 52 Messages d erreur de la source de données 52 Messages d erreur JDBC 52 Messages d erreur du pilote JDBC 52 Messages d erreur du serveur SequeLink 52 Messages d erreur de la source de données 53 Index 55

6 6 Guide ODBC et JDBC FileMaker

7 Chapitre 1 Introduction Ce guide décrit des concepts et contient des informations qui vous aideront à partager des données FileMaker avec d autres applications à l aide d ODBC (Open Database Connectivity) et de JDBC (Java Database Connectivity). Il explique également comment les pilotes clients ODBC et JDBC utilisés avec FileMaker Pro et FileMaker Server Advanced prennent en charge les standards de l industrie pour ODBC, JDBC et SQL (Structured Query Language). Vous pouvez utiliser FileMaker Pro, FileMaker Pro Advanced ou FileMaker Server Advanced pour créer et tester votre solution. Vous pouvez ensuite partager votre solution de base de données FileMaker en tant que source de données avec des applications compatibles ODBC et JDBC. Vous devez installer les pilotes ODBC et JDBC de FileMaker sur la machine sur laquelle votre application tierce est installée. Important Ce guide décrit l utilisation du logiciel FileMaker en tant que source de données. Pour des informations étape par étape sur l utilisation de FileMaker Pro en tant qu application cliente, consultez l Aide de FileMaker Pro. Le tableau suivant fournit un aperçu de l utilisation d ODBC et de JDBC avec le logiciel FileMaker. Que voulez-vous faire? Comment le faire? Utiliser FileMaker Pro en tant que source de données/partager des données FileMaker Pro 1. Requêtes SQL 2. ODBC et JDBC Consultez le document Ce guide Utiliser FileMaker Pro en tant que client ODBC/ accéder aux données ODBC 1. De façon interactive via le graphe de liens 2. Unique, statique via importation ODBC ou menu Fichier > Ouvrir. Également, l action de script Importer enregistrements et l action de script Exécuter SQL. Aide FileMaker Pro A propos de ce guide 1 Pour plus d informations sur l utilisation d ODBC et de JDBC avec les versions antérieures de FileMaker Pro, consultez le site 1 Ce guide part de l hypothèse que vous êtes familiarisé avec les principes d utilisation de base d ODBC et de JDBC et de construction de requêtes SQL. Pour plus d informations, consultez un livre spécialisé. 1 Ce guide parle indifféremment de «FileMaker Pro» pour faire référence à FileMaker Pro et à FileMaker Pro Advanced, sauf quand il décrit des fonctions propres à FileMaker Pro Advanced. Remarque Vous pouvez télécharger la version PDF de la documentation de FileMaker à l adresse suivante : Toutes les mises à jour de ce document sont également disponibles sur le site Web. Utilisation d une base de données FileMaker en tant que source de données ODBC et JDBC sont des interfaces de programmation d applications (API). Ces API offrent aux applications clientes un langage commun pour communiquer avec une multitude de sources de données et de services de base de données, notamment FileMaker Pro et FileMaker Server Advanced.

8 8 Guide ODBC et JDBC FileMaker Toutes les applications qui prennent en charge ODBC et JDBC reconnaissent un sous-ensemble fondamental d instructions SQL. Avec SQL, vous pouvez utiliser d autres applications (telles que des tableurs, des traitements de texte et des outils de génération de rapports) pour voir, analyser et modifier des données FileMaker. Les instructions SQL transitent par les interfaces ODBC et JDBC jusqu à l hôte FileMaker de la source de données ; elles exécutent des requêtes du type SELECT first_name, last_name FROM customers WHERE city= Paris et effectuent des mises à jour telles que la création d un nouvel enregistrement sous la forme INSERT INTO customers (first_name, last_name) VALUES ( Jeanne, Martin ). Accès à une base de données FileMaker Pro hébergée Avec FileMaker Server Advanced ou FileMaker Pro, vous pouvez héberger un fichier de base de données FileMaker en tant que source de données et partager vos données avec d autres applications à l aide d ODBC et de JDBC. Le tableau suivant décrit les possibilités offertes par chaque produit FileMaker. Ce produit FileMaker FileMaker Server Advanced FileMaker Pro Permet Jusqu à 50 connexions et prend en charge l accès local (même ordinateur) et l accès distant (pour les systèmes intermédiaires tels que les serveurs Web et pour l accès aux clients distants à partir d applications de bureautique). Jusqu à neuf connexions et ne prend en charge que l accès local (même ordinateur). Les modules ODBC et JDBC dont vous avez besoin pour partager vos données avec d autres applications sont installés avec FileMaker Server Advanced et FileMaker Pro. Pour accéder à un fichier de base de données FileMaker hébergé, vous devez installer le pilote client ODBC ou JDBC correspondant. Installez le pilote client sur la machine sur laquelle est installée l application tierce. Pour plus d informations sur l installation des fichiers du pilote requis pour accéder à une source de données FileMaker, reportez-vous au chapitre 2, «Installation des pilotes clients ODBC et JDBC pour FileMaker». Si votre solution de base de données FileMaker utilise plusieurs fichiers de base de données FileMaker, tous ces fichiers devront être enregistrés sur le même ordinateur. Le Chapitre 5, «Standards pris en charge» décrit les instructions SQL que les pilotes clients ODBC et JDBC prennent en charge quand ils sont utilisés avec FileMaker Pro et FileMaker Server Advanced. Important Si vous désactivez le partage ODBC/JDBC après l avoir activé, une source de données hébergée par FileMaker ServerAdvanced ou FileMaker Pro cesse immédiatement d être disponible. L administrateur de base de données n a pas la possibilité d avertir les applications clientes ODBC et JDBC quant à la disponibilité de la source de données (il ne peut communiquer qu avec des clients de fichiers de base de données FileMaker). Aucune erreur n est signalée et l application cliente doit avertir les utilisateurs que la source de données n est plus disponible et que les transactions ne peuvent pas être effectuées. Si une application cliente tente de se connecter à un fichier de base de données FileMaker qui n est pas disponible, un message explique que la connexion a échoué. Limites avec des outils tiers 1 Assistant de requêtes Microsoft : vous ne pouvez pas accéder à une source de données FileMaker dont les noms de tables ou de colonnes contiennent des caractères au format ASCII accentués ou à deux octets. Utilisez plutôt Microsoft Query et saisissez manuellement les caractères situés entre guillemets doubles. 1 Microsoft Access : vous ne pouvez pas accéder à une source de données FileMaker dont les noms de tables ou de colonnes contiennent des caractères au format ASCII accentués ou à deux octets.

9 Chapitre 1 Introduction 9 Configuration requise pour une utilisation en réseau Vous devez disposer d un réseau TCP/IP pour utiliser FileMaker Server Advanced pour héberger un fichier de base de données FileMaker en tant que source de données par l intermédiaire d un réseau. FileMaker Pro ne prend en charge que l accès local (même ordinateur). Mise à jour de fichiers à partir de versions antérieures Installation des pilotes actuels Si vous avez installé un pilote d une version antérieure à FileMaker Server 9 Advanced ou FileMaker Pro 9, vous devez désinstaller ce pilote et installer celui de la version 10. Pour plus d informations, reportez-vous au chapitre 2, «Installation des pilotes clients ODBC et JDBC pour FileMaker». Remarque Vous devez créer une source de données pour chaque fichier de base de données FileMaker auquel vous souhaitez accéder en tant que source de données. Si vous avez déjà configuré un accès via une source de données qui admet que les tables soient situées dans différents fichiers de base de données FileMaker, vous devez consolider ces tables sous la forme d un fichier de base de données unique (ou créer plusieurs sources de données).

10 10 Guide ODBC et JDBC FileMaker

11 Chapitre 2 Installation des pilotes clients ODBC et JDBC pour FileMaker Ces instructions vous aident à installer les pilotes nécessaires pour accéder à une source de données FileMaker tierce et à des applications personnalisées via ODBC (Open Database Connectivity) et JDBC (Java Database Connectivity). Les pilotes clients sont disponibles sur votre CD FileMaker pour une installation distincte ou peuvent être téléchargés par voie électronique dans le dossier \xdbc. Les dernières versions des pilotes clients sont également disponibles sur le site : Si vous devez héberger un fichier de base de données FileMaker à l aide de FileMaker Server Advanced, mettez les pilotes clients à la disposition des utilisateurs distants. Après avoir installé le pilote client requis, vous pouvez configurer le pilote pour accéder à une source de données FileMaker et construire des requêtes SQL (Structured Query Language) pour interagir avec les données. Respect du contrat de licence Les pilotes clients ODBC et JDBC sont la partie du logiciel FileMaker qui permet à des applications tierces ou personnalisées d accéder aux fichiers FileMaker en tant que source de données ODBC ou JDBC. Configurations matérielles et logicielles requises Pour installer et utiliser les pilotes clients ODBC et JDBC, vous devez être équipé au minimum du matériel et des logiciels suivants : Configuration requise pour le pilote client ODBC (Windows) 1 Pentium 300 MHz ou supérieur ; 1 quantité totale de RAM de 64 Mo pour Windows 2000 et de 128 Mo pour Windows XP ; 1 Microsoft Data Access Components (MDAC) 2.8 SP1 1 Windows MDAC 6.0 pour Vista Configuration requise pour le pilote client ODBC (Mac OS) 1 Apple G3 ou plus rapide (pas de carte de mise à jour G3) Mo de RAM 1 Mac OS X ou 10.4 (le logiciel peut fonctionner avec des versions plus récentes certifiées par FileMaker)

12 12 Guide ODBC et JDBC FileMaker Configuration requise pour le pilote client JDBC Applications utilisant Nécessitent API JDBC 1.22 JVM (Java Virtual Machine) compatible avec le JDK 1.2 API JDBC 2.0 centrale JVM compatible avec le JDK 1.3 Package optionnel JDBC 2.0 JVM compatible avec le JDK 1.3 Vous devez également disposer des API suivantes, qui sont fournies avec le client SequeLink Java : 1 Package optionnel JDBC JNDI JTA API JCA JDK 1.3 API JDBC 3.0 JDK 1.4 ou 1.5 Pour savoir quelle version de Java vous exécutez, ouvrez une fenêtre de commande (Windows) ou une fenêtre Terminal (Mac OS) et tapez java -version. Configuration requise pour une utilisation en réseau Si vous devez accéder à une source de données FileMaker hébergée sur un autre ordinateur, vous devez disposer d un accès réseau via TCP/IP. Installation du pilote client ODBC (Windows) Si vous avez déjà installé le pilote client ODBC sous Windows, désinstallez-le via Ajout/Suppression de programmes avant d installer une version mise à jour. Pour installer le pilote client ODBC Vous devez disposer de MDAC 2.8 SP1 (disponible sur pour installer le pilote client ODBC. 1. Dans le dossier \xdbc\odbc Client Driver Installer, double-cliquez sur setup. La fenêtre DataDirect SequeLink for ODBC InstallShield Wizard apparaît. 2. Installez le pilote client ODBC en suivant les instructions affichées à l écran. Les éléments Data Source SyncTool, Data Source SyncTool Administrator et SequeLink Online Books ne sont pas inclus dans l installation par défaut. Vous n en avez pas besoin pour utiliser le pilote client ODBC. Par défaut, le pilote client ODBC est installé dans le dossier suivant : C:\Program Files\DataDirect\slodbc55. Vous pouvez sélectionner un autre lecteur ou un autre dossier si vous le souhaitez. 3. Lorsque vous avez terminé l installation, cliquez sur Terminer. Le pilote client ODBC, DataDirect 32-BIT SequeLink 5.5, est maintenant prêt et vous pouvez le configurer pour accéder à une source de données FileMaker. Remarque Si vous rencontrez des problèmes en l installant directement, installez-le à l aide de l icône Ajout/Suppression de programmes de Windows (choisissez Démarrer > Panneau de configuration > Ajout/Suppression de programmes).

13 Chapitre 2 Installation des pilotes clients ODBC et JDBC pour FileMaker 13 Installation du pilote client ODBC (Mac OS) Si vous avez déjà installé le pilote client ODBC pour Mac OS, désinstallez-le avant d installer une version mise à jour. Pour installer le pilote client ODBC Dans le dossier /xdbc/odbc Client Driver Installer, copiez le fichier SequeLink.bundle dans votre bibliothèque système ou utilisateur. Si le dossier /ODBC n existe pas sur votre machine, créez-le manuellement. Bibliothèq ue Copiez le fichier SequeLink.bundle dans ce dossier : Utilisez ce chemin d accès au pilote pendant la configuration : Système /Bibliothèque/ODBC /Bibliothèque/ODBC/SequeLink.bundle/Contents/MacOS/ivslk20.dylib Utilisateur /Utilisateurs/<utilisateur>/ Bibliothèque/ODBC /Utilisateurs/<utilisateur>/Bibliothèque/ODBC/SequeLink.bundle/Contents/ MacOS/ivslk20.dylib Remarque Si vous avez ouvert une session à l aide d un compte disposant des droits d administrateurs, aucune modification des autorisations n est nécessaire après la création du dossier /ODBC. Le dossier ODBC doit disposer des autorisations suivantes : 1 Appartient au groupe admin, root 1 Autorisations de lecture, d écriture et d exécution pour root et admin 1 Autorisations de lecture et d exécution pour tous les autres comptes Ce pilote client a été testé avec ODBC Administrator (disponible avec Mac OS ) et ODBC Administrator 1.1 (disponible avec Mac OS ). Important Utilisez l administrateur ODBC fourni avec le logiciel de gestion de pilotes ODBC recommandé pour votre application cliente. Installation du pilote client JDBC (Windows et Mac OS) Le programme d installation et le pilote client JDBC fonctionnent sur Windows et Mac OS. Vous devez disposer d un accès en écriture sur le dossier d installation du pilote client JDBC. Par défaut, le dossier contenant le programme d installation est le dossier d installation. Si vous avez déjà installé le pilote client JDBC pour Windows, désinstallez-le avant d installer une version mise à jour. Pour installer le pilote client JDBC 1. Ouvrez le dossier \xdbc\jdbc Client Driver Installer, puis double-cliquez sur sljcinstaller.jar. La fenêtre DataDirect SequeLink for JDBC 5.5 Installer apparaît. Remarque Votre environnement Java Runtime doit être associé aux fichiers d archive.jar. D autres applications peuvent également être associées aux fichiers d archive.jar, telles que WinZip ou Stuffit. Dans ce cas, elles peuvent empêcher l ouverture du programme d installation JDBC. Si la fenêtre du programme d installation ne s ouvre pas, ouvrez une fenêtre de commande (Windows) ou une Terminal (Mac OS) et utilisez à la place le dossier JDBC Client Driver. De là, vous pouvez démarrer le programme d installation en saisissant la commande suivante : java -jar sljcinstaller.jar.

14 14 Guide ODBC et JDBC FileMaker 2. Cliquez sur Suivant. Lisez le contrat de licence. 3. Si vous jugez le contrat de licence acceptable, sélectionnez J accepte les termes du contrat de licence, puis cliquez sur Suivant. Une fenêtre contenant les options d installation apparaît. 4. Sélectionnez Install Developer s Tools. Les outils incluent JDBCTest, qui vous aide à vérifier vos connexions JDBC. 5. Entrez un répertoire d installation dans Install Directory. 1 Windows : entrez un chemin incluant votre fichier Java exécutable (java.exe). 1 Mac OS : entrez /Bibliothèque/Java/Extensions (ou un autre emplacement inclus dans la variable ClassPath de votre application Java). 6. Cliquez sur Suivant. 7. Confirmez vos choix d installation, puis cliquez sur Installer. 8. Lorsque vous avez terminé l installation, cliquez sur Terminer. Le pilote client JDBC est désormais disponible pour configurer l accès à une source de données FileMaker. Configuration des pilotes clients Avant d utiliser une application cliente pour accéder à une source de données FileMaker, vous devez configurer un pilote client pour la source de données. Les paramètres de configuration identifient le pilote client que vous utilisez, l emplacement de la source de données et la manière dont vous souhaitez vous connecter. Important Quand vous configurez un pilote client, vous devez spécifier 2399 pour le port. Pour ODBC (Windows), vous devez spécifier ce port dans l Administrateur de source de données ODBC. Pour ODBC (Mac OS), vous devez spécifier ce port dans l Administrateur ODBC. Pour JDBC, vous devez indiquer le port dans l URL JDBC. Pour plus d informations (en langue anglaise) sur le pilote client ODBC pour Windows, choisissez le menu Démarrer de Windows Programmes > DataDirect SequeLink for ODBC 5.5 > Driver Help. Remarque Certaines des fonctionnalités décrites par le système d aide, qui est fourni par DataDirect Technologies, dépassent le cadre de l utilisation des pilotes clients ODBC et JDBC pour accéder à des sources de données FileMaker. Etape suivante Après avoir installé et configuré un pilote client, vous pouvez construire et exécuter des requêtes SQL pour accéder à une source de données FileMaker. Les applications clientes emploient parfois une terminologie différente pour l accès à une source de données via ODBC. De nombreuses applications contiennent des éléments de menu portant des noms tels que Obtenir des données externes ou Requête SQL. Pour plus de détails, consultez la documentation ou l aide fournies avec votre application.

15 Chapitre 3 Utilisation d ODBC pour partager des données FileMaker Utilisez le pilote client ODBC pour vous connecter à une source de données FileMaker à partir d une autre application. L application qui utilise le pilote client ODBC peut accéder directement aux données d un fichier de base de données FileMaker. 1 Windows : le pilote client FileMaker ODBC s appelle DataDirect 32-BIT SequeLink Mac OS : le pilote client FileMaker ODBC s appelle ivslk20.dylib. Remarque Vous pouvez également utiliser FileMaker Pro en tant qu application cliente et la faire interagir avec les enregistrements d une autre source de données via ODBC à l aide de SQL. Pour plus d informations sur l accès à une source de données externe via ODBC, consultez l Aide de FileMaker Pro. A propos d ODBC ODBC est une API qui permet aux applications d accéder à des données provenant de divers systèmes de gestion de bases de données. ODBC offre aux applications clientes un langage commun permettant d interagir avec des sources de données et des services de base de données. Toutes les applications qui prennent en charge ODBC reconnaissent un sous-ensemble commun d instructions. SQL permet d utiliser d autres applications (telles que des tableurs, des traitements de texte et des outils de génération de rapports) pour voir, analyser et modifier des données FileMaker. Pour connaître les instructions, fonctions et expressions SQL prises en charge par le pilote client ODBC, consultez la rubrique chapitre 5, «Standards pris en charge». Votre application peut communiquer directement avec un fichier de base de données FileMaker en utilisant le pilote client ODBC. Les instructions SQL sont transmises à l hôte FileMaker du fichier de base de données et les réponses vous sont ensuite communiquées. Si vous utilisez FileMaker Server Advanced pour héberger un fichier de base de données en tant que source de données, le fichier de base de données peut être situé sur une autre machine (la machine serveur) connectée au réseau, votre application cliente étant placée sur votre machine (la machine cliente). Il s agit d une configuration client/serveur.

16 16 Guide ODBC et JDBC FileMaker Application cliente Gestionnaire de pilotes Oracle Pilote ODBC Pilote ODBC SQL Server Pilote client ODBC Oracle Microsoft SQL Server FileMaker Utilisation du pilote client ODBC Vous pouvez utiliser le pilote client ODBC avec n importe quelle application compatible ODBC. En partageant votre fichier de base de données FileMaker en tant que source de données, vous pouvez : 1 effectuer des fusions-publipostages avec Microsoft Word ; 1 créer des graphiques avec Microsoft Excel ; 1 déplacer des données FileMaker vers un SGBD tel que Microsoft SQL Server ; 1 analyser vos données FileMaker à l aide d outils de requête ou de génération de rapports pour créer des graphiques, définir des requêtes personnalisées et effectuer des analyses avec recherche d antécédents ; 1 créer une application Microsoft Visual Basic partageant des informations avec FileMaker Pro. Pour partager un fichier de base de données FileMaker en tant que source de données, utilisez FileMaker Pro pour définir les comptes qui auront besoin d accéder au fichier de base de données. Ensuite, contrôlez l accès au fichier de base de données en affectant des jeux de privilèges aux comptes, notamment le privilège étendu Accès via ODBC/JDBC. Enfin, activez le partage de données via ODBC/JDBC sur l application hôte FileMaker Server Advanced ou FileMaker Pro. Pour plus d informations, consultez l aide de FileMaker Pro ou de FileMaker Server. Important Le pilote client ODBC remplace le pilote ODBC FileMaker Pro fourni avec une version antérieure de FileMaker. Si vous avez déjà configuré l accès à une source de données FileMaker à l aide de l ancien pilote, vous devez redéfinir l accès en utilisant et configurant le nouveau pilote. Remarque Vous pouvez utiliser le Moniteur d activité sous Mac OS ou le Gestionnaire des tâches sous Windows pour vérifier l état du processus ddfmsoc afin de confirmer que le serveur SequeLink est en cours d exécution. Une fois le processus lancé, il prend le nom FMSocket_SL55 et les événements sont consignés sous ce nom. Le processus du serveur SequeLink est distinct du processus FileMaker Server.

17 Chapitre 3 Utilisation d ODBC pour partager des données FileMaker 17 Présentation de l accès à un fichier de base de données FileMaker A partir d une application compatible ODBC, vous pouvez construire des requêtes SQL pour accéder à un fichier de base de données FileMaker. Le pilote client ODBC doit être installé sur l ordinateur qui génère la requête SQL. Pour accéder à un fichier de base de données FileMaker : 1. Dans FileMaker Pro, vérifiez les jeux de privilèges que vous avez affectés aux comptes qui accéderont au fichier de base de données. Les comptes qui ont besoin d un accès doivent employer un jeu de privilèges incluant le privilège étendu Accès via ODBC/JDBC. 2. Activez le partage de données via ODBC/JDBC sur l application hôte FileMakerServer Advanced (via la console Admin de FileMaker Server) ou FileMakerPro. Console Admin de FileMaker Server : cliquez sur ODBC/JDBC, puis sélectionnez Activer ODBC/JDBC. FileMaker Pro : choisissez le menu Fichier > Partage > ODBC/JDBC et paramétrez l option Partage ODBC/JDBC sur Activé. 3. Assurez-vous que le fichier de base de données FileMaker auquel vous voulez accéder est hébergé et disponible. Si votre solution de base de données FileMaker utilise plusieurs fichiers de base de données FileMaker, tous ces fichiers devront être enregistrés sur le même ordinateur. 4. Connectez-vous à la source de données FileMaker. 5. Créez et exécutez une requête SQL dans l application cliente. Chaque fichier de base de données FileMaker ouvert et configuré pour l accès constitue une source de données distincte (vous devez créer une source de données pour chaque fichier de données FileMaker auquel vous souhaitez accéder en tant que source de données). Chaque base de données peut contenir une ou plusieurs tables. Les rubriques FileMaker sont représentées sous forme de colonnes. Le nom complet de la rubrique, avec les caractères non alphanumériques qu il contient éventuellement, s affiche en tant que nom de colonne. Remarque Sous Windows, Microsoft Access ne peut pas importer plus de 32 rubriques à la fois d un fichier de base de données FileMaker via ODBC. Si votre fichier de base de données contient plus de 32 rubriques, importez-les par incréments de 32. Accès à un fichier de base de données FileMaker depuis une application Windows Spécification des propriétés de pilote client ODBC pour une source de données FileMaker (Windows) Créez une source de données pour chaque fichier de base de données FileMaker auquel vous souhaitez accéder en tant que source de données. La source de données identifie le pilote client ODBC FileMaker, l emplacement de l application hôte FileMaker et le fichier de base de données FileMaker auquel vous accédez en tant que source de données.

18 18 Guide ODBC et JDBC FileMaker Pour configurer ou modifier les propriétés du pilote ODBC : 1. Ouvrez l Administrateur de sources de données ODBC depuis le Panneau de configuration. Dans le Panneau de configuration de Windows, choisissez Outils d administration > Sources de données (ODBC). Sous Windows XP, l option Outils d administration apparaît dans la catégorie Performances et maintenance. Sous Windows Vista, l option Outils d administration apparaît dans la catégorie Système et maintenance. 2. Cliquez sur l onglet System DSN (Sources de données système). Si vous avez configuré votre source de données en tant que source de données utilisateur ou fichier, cliquez sur l onglet correspondant. 3. Cliquez sur Add (Ajouter). Remarque Si vous modifiez les propriétés d une source de données existante, sélectionnez cette source, cliquez sur Configure (Configurer) et passez à l étape Sélectionnez DataDirect 32-BIT SequeLink 5.5 dans la liste de pilotes. Si le pilote ne figure pas dans la liste Administrateur de sources de données ODBC, recherchez l entrée (par défaut) de la clé de registre HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI\ODBC Drivers à l aide de Regedit (choisissez Démarrer > Exécuter > Regedit). La colonne Données de cette entrée doit contenir (valeur non définie). Si, au lieu de cela, vous voyez une chaîne vide, cliquez avec le bouton droit de la souris sur (par défaut), choisissez Supprimer, puis cliquez sur Oui pour confirmer. Cette opération réinitialise l entrée sur (valeur non définie). Désinstallez votre pilote client ODBC et réinstallez-le pour le voir dans l Admnistrateur de sources de données ODBC. 5. Cliquez sur Terminer. Cette opération affiche la boîte de dialogue DataDirect SequeLink for ODBC Setup (Configuration de DataDirect SequeLink pour ODBC) avec l onglet General (Général) sélectionné. 6. Dans la zone Data Source Name (Nom de source de données), entrez un nom aisément identifiable par les autres utilisateurs accédant à la source de données FileMaker Pro. Vous pouvez décrire cette source de données dans la zone facultative Description (Description). Assurez-vous que l option Use LDAP (Utiliser LDAp) est désélectionnée. Le pilote client ODBC n inclut pas de.dll de conversion. Par conséquent, même si vous cliquez sur Translate (Convertir), vous ne pourrez pas configurer de convertisseur ODBC). 7. Pour SequeLink Server Host (Hôte serveur SequeLink), entrez l emplacement de votre source de données. Si vous vous connectez à un fichier de base de données FileMaker hébergé par FileMaker Pro sur votre machine locale, tapez localhost (ou ). Si vous vous connectez à un fichier de base de données FileMaker hébergé par FileMaker Server Advanced par l intermédiaire d un réseau, tapez l adresse IP du serveur FileMaker. 8. Dans la zone SequeLink Server Port (Port serveur SequeLink), tapez Important Quand vous configurez un pilote client, vous devez spécifier 2399 pour le port serveur SequeLink. 9. Dans la zone Server Data Source (Source de données serveur), entrez le nom du fichier de base de données FileMaker que vous utilisez comme source de données (n indiquez pas l extension du nom du fichier).

19 Chapitre 3 Utilisation d ODBC pour partager des données FileMaker Si vous avez activé le partage via ODBC/JDBC dans l application hôte, cliquez sur le bouton situé à droite de la zone Source de données serveur pour afficher les noms des fichiers de base de données FileMaker actuellement ouverts, parmi lesquels vous pouvez choisir. Si le nom de votre base de données contient des espaces, remplacez-les par le caractère %20. Par exemple, MY%20DATABASE. 11. Cliquez sur OK pour enregistrer vos informations de source de données. Si vous partagez un autre fichier de base de données FileMaker, revenez à l étape 3 et configurez ce fichier en tant que source de données. 12. Cliquez sur OK pour refermer la boîte de dialogue ODBC Database Administrator (Administrateur de sources de données ODBC). Vérification de l accès via ODBC (Windows) Pour vérifier que vous avez configuré correctement le pilote client ODBC pour accéder à la source de données FileMaker : 1. Ouvrez la fenêtre ODBC Database Administrator (Administrateur de sources de données ODBC) à partir du Panneau de configuration. Dans le Panneau de configuration de Windows, choisissez Outils d administration > Sources de données (ODBC). Sous Windows XP, l option Outils d administration apparaît dans la catégorie Performances et maintenance. 2. Cliquez sur l onglet System DSN (Sources de données système). Si vous avez configuré votre source de données en tant que source de données utilisateur ou fichier, cliquez sur l onglet correspondant. 3. Sélectionnez la source de données FileMaker que vous avez configurée précédemment. Le nom que vous aviez entré pour la source de donnée apparaît sous Name (Nom) et DataDirect 32-BIT SequeLink 5.5 apparaît sous Driver (Pilote). 4. Cliquez sur Configurer. La boîte de dialogue DataDirect SequeLink for ODBC Setup (Configuration de DataDirect SequeLink pour ODBC) apparaît. 5. Cliquez sur Test Connect (Tester la connexion). Le système vous demande d entrer un nom de compte FileMaker (dans Database User Name (Nom d utilisateur de base de données)) et un mot de passe (dans Database Password (Mot de passe de base de données)). Si la connexion fonctionne correctement, le message Connection test was successful (Le test de connexion a réussi) s affiche. Si la connexion échoue : 1 Assurez-vous que le fichier de base de données FileMaker est hébergé et disponible. 1 Mettez à jour ou corrigez vos informations de connexion. 1 Assurez-vous que votre compte FileMaker emploie un jeu de privilèges incluant le privilège étendu Accès via ODBC/JDBC. 1 Vérifiez que l application hôte FileMaker Pro ou FileMaker Server a été configurée pour partager des fichiers via ODBC/JDBC.

20 20 Guide ODBC et JDBC FileMaker Accès à un fichier de base de données FileMaker depuis une application Mac OS Les applications personnalisées doivent être créées avec la version des en-têtes et des bibliothèques ODBC. Les applications créées avec la version 3.51 risquent de ne pas parvenir à charger le pilote client. Configuration du pilote client ODBC (Mac OS) Configurez le pilote client à l aide de l administrateur ODBC fourni avec le logiciel de gestion de pilotes ODBC recommandé pour votre application cliente. Ce pilote client a été testé avec ODBC Administrator (disponible avec Mac OS ) et ODBC Administrator 1.1 (disponible avec Mac OS ). Au moment de configurer le pilote client, il vous sera demandé de fournir une brève description, ainsi que le chemin d accès au fichier du pilote : Si vous avez copié SequeLink.bundle dans cette bibliothèque : Utilisez ce chemin d accès au pilote pendant la configuration : /Bibliothèque/ODBC /Utilisateurs/<utilisateur>/ Bibliothèque/ODBC /Bibliothèque/ODBC/SequeLink.bundle/Contents/MacOS/ivslk20.dylib /Utilisateurs/<utilisateur>/Bibliothèque/ODBC/SequeLink.bundle/Contents/MacOS/ ivslk20.dylib L administrateur ODBC vous permet également de définir de façon facultative les mots-clés, ainsi que le chemin d accès au fichier de configuration. Par contre, le pilote client n a pas besoin de ces informations. Spécification des propriétés du pilote client ODBC pour une source de données FileMaker (Mac OS) Créez une source de données pour chaque fichier de base de données FileMaker auquel vous souhaitez accéder en tant que source de données. La source de données identifie le pilote client ODBC FileMaker, l emplacement de l application hôte FileMaker et le fichier de base de données FileMaker auquel vous accédez en tant que source de données. Important Le pilote client ODBC pour Mac OS ne prend pas en charge les caractères ASCII accentués, à deux octets ou japonais dans les noms des bases de données ou des tables. Si votre fichier de base de données FileMaker utilise ces caractères, créez une deuxième base de données et utilisez uniquement des caractères ASCII pour les noms du fichier et des tables. Dans cette deuxième base de données, créez une référence de source de données qui pointe vers les données de votre fichier de base de données d origine. Partagez ces deux fichiers avec ODBC/JDBC, mais utilisez le deuxième fichier de base de données au moment de définir votre source de données. De même, vous devrez indiquer les valeurs des mots-clés relatives à la source de données : Mot-clé Hôte Valeur Si vous vous connectez à un fichier de base de données FileMaker hébergé par FileMaker Pro sur votre machine locale, tapez localhost (ou ). Si vous vous connectez à un fichier de base de données FileMaker hébergé par FileMaker Server Advanced par l intermédiaire d un réseau, tapez l adresse IP ou le nom d hôte du serveur FileMaker. Port Tapez ServerDataSource Entrez le nom du fichier de base de données FileMaker que vous utilisez comme source de données (n indiquez pas l extension du nom du fichier). Si le nom de votre base de données contient des espaces, remplacez-les par le caractère %20. Par exemple, ServerDataDource=MA%20BASE. Les caractères à deux octets ne sont pas pris en charge.