FileMaker 8 Installation des pilotes clients ODBC et JDBC pour FileMaker 8
2004-2005 FileMaker, Inc. Tous droits réservés. FileMaker, Inc. 5201 Patrick Henry Drive Santa Clara, California 95054, Etats-Unis FileMaker est une marque commerciale de FileMaker, Inc., déposée aux Etats-Unis et dans d autres pays, et ScriptMaker et le logo du dossier sont des marques de FileMaker, Inc. La documentation de FileMaker est protégée par les lois sur les droits d auteur. Vous n êtes pas autorisé à créer des copies supplémentaires ou à distribuer cette documentation sans l accord écrit de FileMaker. Vous devez posséder une copie sous licence valide de FileMaker pour utiliser cette documentation. Toutes les personnes et sociétés citées dans les exemples sont fictives, et toute ressemblance avec des personnes et des sociétés existantes ne serait que pure coïncidence. La liste des auteurs est disponible dans le document Remerciements fourni avec ce logiciel. Pour plus d informations, rendez-vous sur notre site Web à l adresse www.filemaker.com. Edition : 01
Table des matières Installation des pilotes clients ODBC et JDBC pour FileMaker 8 Support clientèle 5 Respect du contrat de licence 5 Configurations matérielles et logicielles requises 5 Configuration requise pour le pilote client ODBC (Windows) 5 Configuration requise pour le pilote client ODBC (Mac OS) 6 Configuration requise pour le pilote client JDBC 6 Configuration requise pour une utilisation en réseau 6 Utilisation d ODBC et de JDBC avec FileMaker 6 Installation des pilotes clients 7 Installation du pilote client ODBC (Windows) 7 Installation du pilote client ODBC (Mac OS) 8 Installation du pilote client JDBC (Windows et Mac OS) 8 Configuration des pilotes clients 9 Etape suivante 9
4 Installation des pilotes clients ODBC et JDBC pour FileMaker
Installation des pilotes clients ODBC et JDBC pour FileMaker 8 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). Après avoir installé le pilote client requis, vous pouvez le configurer pour accéder à une source de données FileMaker et construire des requêtes SQL (Structured Query Language) afin d interagir avec les données. Ce guide parle de «FileMaker Server» pour désigner FileMaker Server 8 Advanced, qui permet de partager des fichiers de base de données FileMaker avec d autres applications à l aide d ODBC et de JDBC. Important Vous pouvez télécharger les dernières versions des pilotes clients et les fichiers PDF de la documentation de FileMaker 8 ODBC et JDBC à l adresse www.filemaker.com/odbc. Les mises à jour de ce document sont également disponibles sur le site Web. Support clientèle Pour plus d informations sur le support technique et le service clientèle, rendez-vous sur l un des sites suivants : www.filemaker.com (Amérique du Nord) www.filemaker.com/intl (clients ne résidant pas en Amérique du Nord) Sur le site Web, vous trouverez le dossier d assistance technique FileMaker, dans lequel sont présentées toutes les options disponibles (clients résidant en Amérique du Nord). Ce site vous propose également des liens renvoyant aux sites internationaux de FileMaker, des réponses aux questions les plus fréquentes et un accès à la base de connaissances et d informations techniques, TechInfo, utilisée par les membres du service d assistance technique. Les clients résidant en Amérique du Nord peuvent aussi composer le 1-800-965-9090 pour obtenir des détails au sujet des diverses options disponibles. 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 à FileMaker Pro ou à FileMaker Server en tant que source de données ODBC ou JDBC. Vous ne pouvez copier et distribuer les pilotes clients que pour les utiliser avec le logiciel FileMaker. 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.6, 2.7 ou 2.8.
6 Installation des pilotes clients ODBC et JDBC pour FileMaker Configuration requise pour le pilote client ODBC (Mac OS) 1 Apple G3 ou supérieur (pas de carte de mise à niveau G3) ; 1 128 Mo de RAM ; 1 Mac OS X 10.3.9 ou 10.4 (le logiciel peut fonctionner avec des versions plus récentes certifiées par 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 2.0 1 JNDI 1.2 1 JTA 1.0.1 API JCA JDK 1.3 API JDBC 3.0 JDK 1.4 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 Pour 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. Utilisation d ODBC et de JDBC avec FileMaker ODBC et JDBC sont des interfaces de programmation d applications (API). Ces API offrent aux applications clientes un langage commun permettant de communiquer avec une multitude de sources de données et de services de base de données, notamment FileMaker. Toutes les applications qui prennent en charge ODBC et JDBC reconnaissent un sous-ensemble fondamental d instructions SQL. SQL est amené via les interfaces ODBC JDBC vers l hôte FileMaker de la source de données. 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 afficher, analyser et modifier des données FileMaker.
Installation des pilotes clients ODBC et JDBC pour FileMaker 7 Installation des pilotes clients Les pilotes clients sont disponibles via des programmes d installation distincts sur le CD Publication Web de FileMaker Server et sur le CD de FileMaker Pro, dans les dossiers \xdbc\odbc Client Driver Installer et \xdbc\jdbc Client Driver Installer. Vous pouvez aussi télécharger la dernière version des pilotes clients à l adresse www.filemaker.com/odbc. Si vous travaillez en environnement de réseau, votre administrateur de base de données peut avoir placé les programmes d installation à un endroit du réseau auquel vous avez accès. Installation du pilote client ODBC (Windows) Si vous avez déjà installé le pilote client ODBC pour Windows, désinstallez-le avant d installer une version mise à jour. Pour installer le pilote client ODBC Vous devez disposer de MDAC 2.6, 2.7 ou 2.8 (disponible sur www.microsoft.com) pour installer le pilote client ODBC. 1. Dans le dossier \ODBC Client Driver, double-cliquez sur setup. La fenêtre DataDirect SequeLink for ODBC 5.4 - 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\slodbc54. 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.4, 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 installant le pilote directement, installez-le à l aide de l îcone Ajouter ou supprimer des programmes de Windows (choisissez Démarrer > Panneau de configuration > Ajouter ou supprimer des programmes). Remarque Si le pilote ne figure pas dans la liste Administrateur de source 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.
8 Installation des pilotes clients ODBC et JDBC pour FileMaker 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 /ODBC Client Driver, 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èque 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/ ivslk18.dylib Utilisateur /Utilisateurs/<utilisateur>/ Bibliothèque/ODBC /Utilisateurs/<utilisateur>/Bibliothèque/ODBC/ ODBCSequeLink.bundle/Contents/MacOS/ivslk18.dylib Le pilote client a été testé avec les gestionnaires de pilotes iodbc suivants : 1 OpenLink ODBC Administrator 3.52.1 (disponible auprès de OpenLink Software) ; 1 Apple ODBC Administrator 1.0.1 (disponible avec Mac OS 10.3). Important Utilisez l administrateur ODBC fourni avec le logiciel de gestion de pilotes iodbc recommandé pour votre application cliente. L administrateur OpenLink ODBC est fourni avec la version ODBC-JDBC Lite Bridge, disponible sur le site Web d OpenLink. 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. Dans le dossier /JDBC Client Driver, double-cliquez sur le fichier sljcinstaller.jar. La fenêtre DataDirect SequeLink for JDBC 5.4 Installer apparaît. 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.
Installation des pilotes clients ODBC et JDBC pour FileMaker 9 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 spécifiez le port dans OpenLink ODBC Administrator ou Apple ODBC Administrator. Pour JDBC, vous devez indiquer le port dans l URL JDBC. Pour plus d informations sur la configuration d un pilote client et la vérification de l accès à votre source de données FileMaker, consultez le Guide du développeur ODBC et JDBC FileMaker, disponible sous forme de fichier PDF sur votre CD dans le sous-dossier \xdbc\documentation électronique, dans le sous-dossier \Extras en français\documentation électronique dans lequel vous avez installé FileMaker Server, et à l adresse www.filemaker.com/odbc. Si vous travaillez en environnement de réseau, contactez votre administrateur de base de données pour obtenir une copie du document. Pour plus d informations (en langue anglaise) sur le pilote client ODBC pour Windows, choisissez dans Windows le menu Démarrer > Programmes > DataDirect SequeLink for ODBC 5.4 > 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 fournie avec votre application.