Installation des pilotes clients ODBC et JDBC pour FileMaker 8

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.
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 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.
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
Respect du contrat de licence
Configurations matérielles et logicielles requises
Configuration requise pour le pilote client ODBC (Windows)
Configuration requise pour le pilote client ODBC (Mac OS)
Configuration requise pour le pilote client JDBC
Configuration requise pour une utilisation en réseau
Utilisation d’ODBC et de JDBC avec FileMaker
Installation des pilotes clients
Installation du pilote client ODBC (Windows)
Installation du pilote client ODBC (Mac OS)
Installation du pilote client JDBC (Windows et Mac OS)
Configuration des pilotes clients
Etape suivante
5
5
5
5
6
6
6
6
7
7
8
8
9
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
1
1
Pentium 300 MHz ou supérieur ;
quantité totale de RAM de 64 Mo pour Windows 2000 et de 128 Mo pour Windows XP ;
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
1
1
Apple G3 ou supérieur (pas de carte de mise à niveau G3) ;
128 Mo de RAM ;
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 :
Système
/Bibliothèque/ODBC
Utilisateur /Utilisateurs/<utilisateur>/
Bibliothèque/ODBC
Utilisez ce chemin d’accès au pilote pendant la configuration :
/Bibliothèque/ODBC/SequeLink.bundle/Contents/MacOS/
ivslk18.dylib
/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
1
OpenLink ODBC Administrator 3.52.1 (disponible auprès de OpenLink Software) ;
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
1
Windows : Entrez un chemin incluant votre fichier Java exécutable (java.exe).
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.