Filemaker Pro 13 Manuel utilisateur

FileMaker 13
®
Guide ODBC et JDBC
© 2004-2013 FileMaker, Inc. Tous droits réservés.
FileMaker, Inc.
5201 Patrick Henry Drive
Santa Clara, Californie 95054
FileMaker et Bento sont des marques commerciales de FileMaker, Inc. déposées aux Etats-Unis et dans d'autres pays. Le
logo en forme de dossier, FileMaker WebDirect et le logo Bento sont des marques commerciales de FileMaker, Inc. 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 n'êtes pas autorisé à créer des
copies supplémentaires ni à 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, sociétés, adresses email et URL citées dans les exemples sont fictives et toute ressemblance avec
des personnes, des sociétés, des adresses email ou 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 tiers et les adresses URL 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 http://www.filemaker.fr.
Edition : 01
Table des matières
Chapitre 1
Introduction
A propos de ce guide
A propos d'ODBC et de JDBC
Utilisation du logiciel FileMaker comme application cliente ODBC
Importation de données ODBC
Ajout de tables ODBC au graphe de liens
Utilisation d’une base de données FileMaker en tant que source de données
Accès à une base de données FileMaker Pro hébergée
Limites avec des outils tiers
Configuration requise pour une utilisation en réseau
Mise à jour de fichiers à partir de versions antérieures
Installation des pilotes actuels
Chapitre 2
Accès aux sources de données SQL externes
Importation de données ODBC
Exécution d'instructions SQL pour interagir avec des sources de données via ODBC
Utilisation de tables ODBC dans le graphe de liens
Sources de données prises en charge dans FileMaker 13
Ajout de tables ODBC au graphe de liens
Chapitre 3
Installation de pilotes clients FileMaker ODBC
Configurations matérielles et logicielles requises
Configuration requise pour le pilote client ODBC (Windows)
Configuration requise pour le pilote client ODBC (OS X)
Configuration requise pour une utilisation en réseau
Présentation de l'architecture du pilote client ODBC
Installation du pilote client ODBC (Windows)
Configuration des pilotes clients (Windows)
Ouverture de l'administrateur ODBC (Windows)
Configuration de la source de données (Windows)
Installation du pilote client ODBC (OS X)
Configuration des pilotes clients (OS X)
Etape suivante
Chapitre 4
Utilisation d’ODBC pour partager des données FileMaker
A propos d’ODBC
Utilisation du pilote client ODBC
Présentation de l’accès à un fichier de base de données FileMaker
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)
5
5
5
6
6
6
7
7
8
8
8
8
9
9
10
11
11
11
13
13
13
13
13
13
14
14
15
15
17
17
19
21
21
22
23
24
24
4
Modification d'un pilote client ODBC existant (Windows)
Vérification de l’accès via ODBC (Windows)
Accès à un fichier de base de données FileMaker depuis une application OS X
Spécification des propriétés de pilote client ODBC pour une source de données
FileMaker (OS X)
Modification d'un pilote client ODBC existant (OS X)
Vérification de l’accès via ODBC (OS X)
Chapitre 5
Installation de pilotes clients FileMaker JDBC
Configuration logicielle requise
Configuration requise pour une utilisation en réseau
Installation du pilote client JDBC
Utilisation du pilote client JDBC
Chapitre 6
Utilisation de JDBC pour partager des données FileMaker
A propos de JDBC
Utilisation du pilote client JDBC
A propos du pilote client JDBC
Utilisation d’une URL JDBC pour la connexion à une base de données
Spécification des propriétés du pilote dans le sous-nom de l’URL
Solutions possédant plusieurs fichiers de bases de données FileMaker
Vérification de l’accès via JDBC
Chapitre 7
Informations de référence
Fonctions de catalogue ODBC
Fonctions de métadonnées JDBC
Correspondances entre les rubriques FileMaker et les types de données ODBC
Correspondances entre les rubriques FileMaker et les types de données JDBC
Types de données des applications 64 bits
Messages d’erreur ODBC et JDBC
Messages d’erreur ODBC
Messages d’erreur JDBC
Index
24
26
27
27
27
29
31
31
31
31
32
33
33
33
34
34
36
37
37
38
38
38
38
39
39
40
40
40
41
Chapitre 1
Introduction
Ce guide décrit comment utiliser le logiciel FileMaker® en tant qu'application cliente ODBC et en
tant que source de données pour des applications ODBC (Open Database Connectivity) et JDBC
(Java Database Connectivity).
Le tableau suivant donne un aperçu de l’utilisation d’ODBC et de JDBC avec le logiciel FileMaker.
Consultez le
document
Que voulez-vous faire ?
Comment le faire ?
Produit
1 Utiliser le logiciel FileMaker
1. De façon interactive via le graphe
de liens
2. Unique, statique via importation
ODBC ou menu Fichier > Ouvrir.
Egalement, l’action de script Importer
enregistrements, l’action de script
Exécuter SQL et la fonction
ExecuteSQL.
1 FileMaker Pro
1 FileMaker Pro Advanced
1 FileMaker Server
1 Ce guide,
1. ODBC et JDBC
2. Requêtes SQL
1 FileMaker Pro
1 FileMaker Pro Advanced
1 FileMaker Server
1 Ce guide,
comme application cliente ODBC.
1 Accéder à des données ODBC
stockées dans une source de
données SQL externe.
1 Utiliser une base de données
FileMaker en tant que source de
données
1 Partager des données FileMaker
Pro avec une application cliente
ODBC tierce.
chapitre 2.
1 Aide FileMaker
Pro
chapitres 3 à 6.
1 Guide de
référence SQL
FileMaker.
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 http://www.filemaker.fr/support/product/documentation.html.
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 : http://www.filemaker.fr/support/product/documentation.html. Toutes les mises
à jour de ce document sont également disponibles sur le site Web.
A propos d'ODBC et de JDBC
ODBC et JDBC sont des interfaces de programmation d’applications (API). ODBC est une API
pour les applications rédigées en langage C et JDBC est l'API équivalente pour le langage Java.
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.
Chapitre 1 | Introduction
6
Toutes les applications prenant en charge ODBC et JDBC reconnaissent un sous-ensemble
commun d’instructions SQL (Structured Query Language). 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.
Avec les API ODBC et JDBC, une application cliente communique avec un gestionnaire de pilotes
qui identifie le pilote client permettant de communiquer avec une source de données.
Application
cliente
Gestionnaire
de pilotes
Client
Pilote
Source de
données
Le logiciel FileMaker peut faire office d'application cliente ou de source de données.
Utilisation du logiciel FileMaker comme application cliente ODBC
En tant qu'application cliente ODBC, le logiciel FileMaker peut accéder aux données de sources
de données SQL externes. Le logiciel FileMaker se connecte à la source de données SQL externe
à l'aide du pilote client correspondant à la source de données ODBC, puis importe les données
ODBC ou utilise les tables ODBC dans le graphe de liens.
Importation de données ODBC
Vous pouvez importer des données ODBC selon l'une des méthodes suivantes :
1 depuis le menu Fichier en précisant une source de données ODBC et en saisissant des
instructions SQL dans la boîte de dialogue Générateur de requête SQL de FileMaker Pro ;
1 en créant un script FileMaker utilisant l'action de script Importer enregistrements, l'action de
script Exécuter SQL ou la fonction ExecuteSQL.
Quelle que soit la méthode choisie, vous devez saisir les instructions SQL vous-même. Il convient
donc de connaître les instructions SQL prises en charge ainsi que leur syntaxe pour votre source de
données ODBC. Puisque vous rédigez les instructions SQL, vous pouvez importer des données
ODBC depuis n'importe quelle source de données ODBC. Pour plus d'informations sur les
instructions et la syntaxe SQL prises en charge par FileMaker, consultez le Guide de référence SQL
FileMaker.
Ajout de tables ODBC au graphe de liens
Lorsque vous ajoutez une table ODBC au graphe de liens, vous pouvez vous connecter à des
sources de données SQL externes et les utiliser à peu près de la même façon que vous travaillez
avec les données du fichier de base de données FileMaker actif. Par exemple, vous pouvez :
1 créer des tables dans le graphe de liens pour des sources de données ODBC ;
1 ajouter des rubriques supplémentaires aux tables ODBC pour exécuter des calculs non stockés
ou pour effectuer un récapitulatif des données des tables ODBC ;
1 ajouter, modifier et supprimer des données externes de manière interactive ;
1 créer des liens entre les rubriques des tables FileMaker et les rubriques (ou « colonnes ») des
tables ODBC ;
Chapitre 1 | Introduction
7
Puisque FileMaker Pro génère des instructions SQL utilisées pour communiquer avec une table
ODBC ajoutée au graphe de liens, vous êtes limité aux sources de données Oracle, SQL Server
et MySQL spécifiques prises en charge par FileMaker Pro dans le graphe de liens.
Remarque Vous ne pouvez pas modifier le schéma de sources de données ODBC externes à
l'aide de FileMaker Pro.
Le Chapitre 2, « Accès aux sources de données SQL externes » décrit comment utiliser le logiciel
FileMaker comme application cliente ODBC.
Utilisation d’une base de données FileMaker en tant que source de
données
En tant que source de données, les données FileMaker sont partagées avec des applications
compatibles ODBC et JDBC. L'application se connecte à la source de données FileMaker à l'aide
du pilote client FileMaker, crée et exécute les requêtes SQL à l'aide d'ODBC ou de JDBC et traite
les données récupérées dans la solution de base de données FileMaker.
Accès à une base de données FileMaker Pro hébergée
Avec FileMaker Server 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
Permet
FileMaker Server
Des connexions illimitées 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).
FileMaker Pro
Jusqu’à neuf connexions et ne prend en charge que l’accès local (même ordinateur).
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.
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 l'ordinateur où est installée
l’application tierce.
Ce guide explique comment les pilotes clients ODBC et JDBC utilisés avec FileMaker Pro et
FileMaker Server prennent en charge les standards de l’industrie pour ODBC et JDBC.
1 Le Chapitre 3, « Installation de pilotes clients FileMaker ODBC » explique comment installer les
fichiers de pilote nécessaires pour accéder à une source de données FileMaker à l'aide
d'ODBC.
1 Le chapitre Chapitre 4, « Utilisation d’ODBC pour partager des données FileMaker » décrit
comment utiliser le pilote client FileMaker ODBC pour se connecter à une source de données
FileMaker à partir d’une autre application.
1 Le Chapitre 5, « Installation de pilotes clients FileMaker JDBC » explique comment installer les
fichiers de pilote nécessaires pour accéder à une source de données FileMaker à l'aide de
JDBC.
Chapitre 1 | Introduction
8
1 Le Chapitre 6, « Utilisation de JDBC pour partager des données FileMaker » décrit comment
utiliser le pilote client FileMaker JDBC avec une application ou une applet Java qui se connecte
à une source de données FileMaker.
1 Le Chapitre 7, « Informations de référence » décrit les correspondances entre les rubriques
FileMaker et les types de données ODBC et JDBC.
Pour en savoir sur les instructions SQL prises en charge par les pilotes clients ODBC et JDBC,
lorsqu'ils sont utilisés avec FileMaker Pro et FileMaker Server, consultez le Guide de référence
SQL FileMaker.
Important Si vous désactivez le partage ODBC/JDBC après l’avoir activé, une source de
données hébergée par FileMaker Server 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
Microsoft Access : Lorsque vous utilisez Microsoft Access pour afficher les données d'une source
de données FileMaker, n'utilisez pas les données d'une rubrique statistique. Les données des
rubriques de type Statistique ne doivent pas être modifiées dans Microsoft Access et la valeur des
données affichée dans Microsoft Access peut être incorrecte.
Configuration requise pour une utilisation en réseau
Vous devez disposer d’un réseau TCP/IP pour utiliser FileMaker Server 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 depuis les versions précédentes de FileMaker Pro ou
FileMaker Server, vous devez installer le pilote pour la version 13.
Le pilote pour FileMaker version 13 n'est pas compatible avec les versions antérieures de
FileMaker Pro et FileMaker Server.
Pour plus d'informations sur l'installation des pilotes, consultez le chapitre 3, « Installation de
pilotes clients FileMaker ODBC » et le chapitre 5, « Installation de pilotes clients FileMaker
JDBC ».
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).
Chapitre 2
Accès aux sources de données SQL externes
En tant qu'application cliente ODBC, le logiciel FileMaker peut accéder aux données de sources
de données SQL externes. Le logiciel FileMaker se connecte à la source de données SQL externe
à l'aide du pilote client correspondant à la source de données ODBC, puis importe les données
ODBC ou utilise les tables ODBC dans le graphe de liens.
Que vous importiez des données ODBC ou que vous utilisiez des tables ODBC dans le graphe
de liens, vous devez configurer un pilote pour la source de données ODBC que vous utilisez. Par
exemple, pour accéder aux enregistrements d’une base de données Oracle, vous devez
configurer un pilote client Oracle.
Importation de données ODBC
Lorsque vous importez des données ODBC, vous devez configurer un pilote client ODBC pour la
source de donnés SQL externe sur l'ordinateur client.
FileMaker
Pro
Gestionnaire
de pilotes
Client
Pilote
Données SQL
Provenance
Après avoir configuré un pilote client ODBC, vous pouvez interagir avec les enregistrements,
importer des enregistrements dans un fichier de base de données FileMaker Pro existant ou créer
un nouveau fichier de base de données FileMaker Pro à partir d'une source de données ODBC
(telle qu’une base de données Oracle ou Microsoft Access).
Vous commencez par accéder à la source de données à partir de laquelle vous souhaitez
effectuer l'importation. Puis vous créez une requête pour les enregistrements à importer depuis la
source de données. Enfin, si vous importez des données dans un fichier existant, vous mettez en
correspondance les rubriques de votre source de données avec celles de votre fichier de base de
données FileMaker Pro.
Vous pouvez accéder à votre source de données ODBC depuis le menu Fichier, à l'aide de l'action
de script Importer enregistrements, de l'action de script Exécuter SQL ou de la fonction
ExecuteSQL.
Pour importer des données ODBC, appliquez le processus général suivant :
1. Installez et configurez des pilotes ODBC spécifiques aux sources de données externes
auxquelles vous souhaitez accéder.
2. Sur l'ordinateur hébergeant le fichier FileMaker Pro actif, définissez un nom de source de
données système pour chaque source de données ODBC à laquelle vous souhaitez accéder.
3. Déterminez éventuellement des considérations supplémentaires pour les sources de données
ODBC auxquelles vous souhaitez accéder (par exemple, décidez si les utilisateurs sont invités
à saisir un nom d'utilisateur et un mot de passe).
Chapitre 2 | Accès aux sources de données SQL externes
10
4. Dans FileMaker Pro, effectuez l’une des opérations suivantes :
1 Pour importer des données dans un fichier FileMaker Pro existant, choisissez le menu
Fichier > Importer des enregistrements > Source de données ODBC.
1 Pour créer un fichier FileMaker Pro à partir des enregistrements de la source de données,
choisissez le menu Fichier > Ouvrir. Dans la boîte de dialogue Ouvrir fichier, choisissez
Source de données ODBC dans la zone Type (Windows) ou Afficher (OS X).
5. Choisissez votre source de données, saisissez le nom d'utilisateur et le mot de passe (le cas
échéant), puis cliquez sur OK pour ouvrir la boîte de dialogue Générateur de requête SQL de
FileMaker Pro.
6. La boîte de dialogue Générateur de requête SQL de FileMaker Pro vous permet de créer une
requête. Sélectionnez la table à partir de laquelle vous souhaitez effectuer l'importation, puis
sélectionnez les colonnes précises à utiliser dans votre requête SQL. Utilisez l'onglet WHERE
pour créer des critères de recherche et l'onglet ORDER BY pour préciser un ordre de tri.
Vous pouvez également entrer une instruction SQL directement dans la boîte de dialogue
Générateur de requête SQL.
Vous pouvez exécuter la requête immédiatement ou utiliser l'action de script Importer
enregistrements, l'action de script Exécuter SQL ou la fonction ExecuteSQL pour exécuter une
requête dans le cadre d'un script FileMaker.
Remarque L'importation ODBC, l'action de script Exécuter SQL et les sources de données SQL
externes ne sont pas prises en charge dans les solutions d'exécution créées avec
FileMaker Pro Advanced.
Consultez l'aide de FileMaker Pro pour plus d'informations sur l'importation de données,
l'utilisation de la boîte de dialogue Générateur de requête SQL et la création de scripts FileMaker.
Exécution d'instructions SQL pour interagir avec des sources de
données via ODBC
Outre l'importation de données dans un fichier de base de données FileMaker Pro via ODBC,
vous pouvez également interagir avec les sources de données à l'aide d'instructions SQL grâce
à l'action de script Exécuter SQL et à la fonction ExecuteSQL. L'action de script Exécuter SQL
peut utiliser n'importe quelle instruction SQL prise en charge par la source de données, telle que
INSERT, UPDATE et DELETE. La fonction ExecuteSQL prend en charge uniquement l'instruction
SELECT.
Il vous est également possible d'utiliser des instructions SQL permettant d'effectuer d'autres
opérations que la simple importation de données dans un fichier de base de données
FileMaker Pro. Par exemple, vous pouvez exécuter des instructions SQL pour ajouter des
enregistrements à une table de base de données dans SQL Server en utilisant les informations
d’un fichier de base de données FileMaker Pro.
Consultez l'aide de FileMaker Pro pour plus d'informations sur la création de scripts FileMaker
utilisant l'action de script Exécuter SQL et la fonction ExecuteSQL.
Chapitre 2 | Accès aux sources de données SQL externes
11
Utilisation de tables ODBC dans le graphe de liens
Lorsque vous ajoutez une table ODBC au graphe de liens, vous pouvez vous connecter à des
sources de données SQL externes et les utiliser à peu près de la même façon que vous travaillez
avec les données du fichier de base de données FileMaker actif.
Lorsque vous utilisez FileMaker Pro ou FileMaker Server comme hôte d'une solution incluant des
tables ODBC dans le graphe de liens, vous devez configurer le pilote client ODBC pour la source
de données SQL externe sur l'ordinateur hôte.
FileMaker
Pro, utilisateur
FileMaker
Pro, utilisateur
FileMaker Pro
ou
FileMaker Serv
er, ordinateur
hôte
Gestionnaire
de pilotes
Client
Pilote
Données SQL
Provenance
FileMaker
Pro, utilisateur
Sources de données prises en charge dans FileMaker 13
En tant qu'application cliente ODBC, FileMaker prend en charge les sources de données SQL
externes suivantes comme tables ODBC dans le graphe de liens :
1
1
1
1
Oracle 11g
SQL Server 2008 R2
SQL Server 2012
MySQL 5.5
Ajout de tables ODBC au graphe de liens
Pour configurer une base de données FileMaker Pro afin qu'elle puisse accéder aux données des
sources de données ODBC prises en charge :
1. Installez et configurez des pilotes ODBC spécifiques aux sources de données externes
auxquelles vous souhaitez accéder.
2. Sur l'ordinateur hébergeant le fichier FileMaker Pro actif, définissez un nom de source de
données système pour chaque source de données ODBC à laquelle vous souhaitez accéder.
3. Déterminez éventuellement des considérations supplémentaires pour les sources de données
ODBC auxquelles vous souhaitez accéder (par exemple, décidez si les utilisateurs sont invités
à saisir un nom d'utilisateur et un mot de passe).
4. Ajoutez une ou plusieurs tables de la source de données ODBC dans le graphe de liens du
fichier FileMaker Pro actif.
Chapitre 2 | Accès aux sources de données SQL externes
12
5. Ajoutez des rubriques aux modèles du fichier FileMaker Pro pour afficher les données externes.
6. Vous pouvez également ajouter des rubriques supplémentaires aux tables externes et modèles
afin d'afficher les résultats des calculs et statistiques en fonction des données stockées dans
les sources de données ODBC externes.
Consultez l'aide de FileMaker Pro pour obtenir des étapes détaillées et des informations
supplémentaires sur la configuration d'un pilote client ODBC, la connexion aux sources de
données ODBC, la modification des sources de données ODBC et la configuration d'une table
ODBC dans le graphe de liens.
Chapitre 3
Installation de pilotes clients FileMaker ODBC
Ces instructions vous aident à installer le pilote client ODBC nécessaire pour accéder à FileMaker
en tant que source de données depuis des applications tierces et personnalisées via ODBC. Le
pilote client ODBC est disponible sur votre CD-ROM d'installation de FileMaker pour une
installation distincte ou peut être téléchargé par voie électronique dans le dossier xDBC.
Recherchez les mises à jour des pilotes clients à cette adresse :
http://www.filemaker.fr/support/downloads/
Si vous devez héberger un fichier de base de données FileMaker à l’aide de FileMaker Server,
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 pour interagir avec les données.
Configurations matérielles et logicielles requises
Pour installer et utiliser les pilotes clients ODBC, vous devez être équipé au minimum du matériel et
des logiciels suivants :
Configuration requise pour le pilote client ODBC (Windows)
1 1 Go de RAM minimum pour Windows 7 SP1, Windows 8, Windows Server 2008 R2 SP1 et
Windows Server 2012
1 Microsoft Data Access Components (MDAC) 2.8 SP1 (composant MDAC généralement installé
avec Windows sur les plates-formes Windows prises en charge)
Configuration requise pour le pilote client ODBC (OS X)
1 Ordinateur OS X équipé d'un processeur Intel
1 1 Go de RAM minimum, 2 Go de RAM recommandés
1 OS X version 10.7.x et OS X version 10.8.2 (le logiciel peut aussi fonctionner avec des
versions plus récentes certifiées par FileMaker)
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.
Présentation de l'architecture du pilote client ODBC
FileMaker fournit des pilotes clients 32 et 64 bits pour Windows et OS X afin de garantir la prise
en charge des applications ODBC 32 et 64 bits.
Vous devez installer le pilote client correspondant à votre application ODBC. Si votre application
ODBC est une application 32 bits, vous devez installer le pilote client 32 bits. Si votre application
ODBC est une application 64 bits, vous devez installer le pilote client 64 bits.
Chapitre 3 | Installation de pilotes clients FileMaker ODBC
14
Installation du pilote client ODBC (Windows)
Les pilotes clients Windows 32 et 64 bits sont installés en tant que bibliothèques séparées. Sur un
système d'exploitation Windows 32 bits, vous ne pouvez installer que le pilote client 32 bits. Sur
un système d'exploitation Windows 64 bits, les deux pilotes clients, 32 et 64 bits, peuvent être
installés.
Pour installer le pilote client ODBC
1. Effectuez l'une des opérations suivantes :
1 Si vous avez reçu le logiciel par voie électronique, double-cliquez sur l'icône d'installation
(fichier .exe).
1 Si vous disposez d'un disque d'installation, insérez-le dans le lecteur.
2. Dans la fenêtre FileMaker Pro ou FileMaker Server, double-cliquez sur le dossier xDBC.
3. Dans le dossier xDBC, double-cliquez sur le dossier du programme ODBC Client Driver
Installer.
4. Dans le dossier du programme ODBC Client Driver Installer, double-cliquez sur le fichier du
programme d'installation correspondant au pilote à installer.
1 Pour installer le pilote client 32 bits (fmodbc32.dll), utilisez le fichier du programme
d'installation 32 bits : FMODBC_Installer_Win32.msi
1 Pour installer le pilote client 64 bits (fmodbc64.dll), utilisez le fichier du programme
d'installation 64 bits : FMODBC_Installer_Win64.msi
L'Assistant Configuration du pilote ODBC FileMaker s'ouvre.
5. Installez le pilote client ODBC en suivant les instructions affichées à l’écran.
6. Lorsque vous avez terminé l’installation, cliquez sur Fermer.
Par défaut, le pilote client ODBC est installé dans le dossier suivant :
1 Sur un système d'exploitation Windows 32 bits, le pilote client 32 bits (fmodbc32.dll) est
installé dans le dossier c:\windows\system32
1 Sur un système d'exploitation Windows 64 bits, le pilote client 32 bits (fmodbc32.dll) est
installé dans le dossier c:\windows\SysWOW64
1 Sur un système d'exploitation Windows 64 bits, le pilote client 64 bits (fmodbc64.dll) est
installé dans le dossier c:\windows\system32
Le pilote client ODBC, FileMaker ODBC, est désormais disponible pour configurer l’accès à
une source de données FileMaker.
Configuration des pilotes clients (Windows)
Avant d’utiliser une application cliente ODBC 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 Lorsque vous utilisez un pilote client FileMaker, vous devez réserver le port 2399.
Chapitre 3 | Installation de pilotes clients FileMaker ODBC
15
Ouverture de l'administrateur ODBC (Windows)
Pour configurer le pilote client 32 bits, vous devez utiliser l'administrateur ODBC 32 bits. Pour
configurer le pilote client 64 bits, vous devez utiliser l'administrateur ODBC 64 bits.
Pour ouvrir l'administrateur ODBC 32 bits sur un système d'exploitation Windows 32 bits :
Dans le Panneau de configuration de Windows, ouvrez Outils d’administration > Sources de
données (ODBC).
Remarque L'option Outils d'administration apparaît dans la catégorie Système et sécurité.
L'Administrateur de sources de données ODBC 32 bits s'ouvre.
Pour ouvrir le pilote client ODBC 32 bits sur un système d'exploitation Windows 64 bits :
1. Ouvrez le dossier SysWOW64 sur votre système. (Par défaut, le dossier SysWOW64 se trouve
au chemin suivant : c:\windows\SysWOW64.)
2. Double-cliquez sur le fichier odbcad32.exe.
L'Administrateur de sources de données ODBC 32 bits s'ouvre.
Pour ouvrir le pilote client ODBC 64 bits sur un système d'exploitation Windows 64 bits :
Dans le Panneau de configuration de Windows, ouvrez Outils d’administration > Sources de
données (ODBC).
Remarque L'option Outils d'administration apparaît dans la catégorie Système et sécurité.
L'Administrateur de sources de données ODBC 64 bits s'ouvre.
Configuration de la source de données (Windows)
Pour créer une source de données pour une base de données hébergée par FileMaker Pro,
utilisez l'administrateur ODBC 32 bits. Pour créer une source de données pour une base de
données hébergée par FileMaker Server, utilisez l'administrateur ODBC 64 bits.
Pour une base de données hébergée par FikeMaker Pro qui utilise l'action de script
Exécuter SQL, créez une source de données utilisateur 32 bits ou une source de données
système 32 bits. Si vous hébergez la même base de données sur FileMaker Server, créez une
source de données système 64 bits dont le nom est identique.
Pour configurer le pilote client ODBC :
1. Dans l'Administrateur de source de données ODBC, sélectionnez l'onglet Sources de
données système ou Sources de données utilisateur.
2. Cliquez sur Ajouter.
La boîte de dialogue Créer une nouvelle source de données s'ouvre.
3. Sélectionnez FileMaker ODBC, puis cliquez sur Terminer.
La boîte de dialogue Configuration DSN FileMaker s'ouvre.
4. Cliquez sur Suivant.
Chapitre 3 | Installation de pilotes clients FileMaker ODBC
16
5. Dans la zone Nom, entrez un nom aisément identifiable par les autres utilisateurs accédant à
la source de données FileMaker Pro. Dans Description, entrez, si vous le souhaitez, une
description de la source de données FileMaker. Cliquez sur Suivant.
6. Dans Hôte :
1 Si vous vous connectez à un fichier de base de données hébergé par FileMaker Pro sur
votre ordinateur local, tapez localhost ou l'adresse IP 127.0.0.1.
1 Si vous vous connectez à un fichier de base de données hébergé par FileMaker Server par
l’intermédiaire d’un réseau, tapez l’adresse IP du serveur FileMaker.
Si vous avez activé le partage via ODBC/JDBC dans l'application hôte, vous pouvez
sélectionner Connectez-vous à l'hôte pour obtenir les noms des bases disponibles.
Cliquez sur Suivant.
Dans le cas contraire, cliquez sur Terminer pour enregistrer les informations de votre source
de données.
7. Pour Base de données, sélectionnez une base de données dans la liste des bases de données
disponibles ou tapez le nom de fichier de la base de données utilisée comme source de
données.
Remarque Pour les bases de données hébergées par FileMaker Server, vous pouvez filtrer la
liste des bases de données sur le paramètre Filtre d'affichage du fichier. Pour plus
d'informations, consultez l'Aide de FileMaker Server.
Si vous avez besoin d'un traitement spécial réservé aux caractères autres que français, cliquez
sur Langue avancée. La boîte de dialogue Options de langue avancées s'ouvre.
1 Pour détecter automatiquement les paramètres de langue, sélectionnez l'option Détectez
auto. paramètres de langue pour application. Pour préciser le paramètre de langue,
décochez l'option Détectez auto. paramètres de langue pour application et sélectionnez
le paramètre système à utiliser.
1 En regard de l'option Codage multioctet du texte, sélectionnez Système ou UTF-8. Par
exemple, certaines applications telles que Microsoft Excel peuvent s'attendre à ce que le
texte utilise le codage Système, contrairement à certaines applications Web qui prévoient
du texte codé en UTF-8. Si l'application s'attend à un codage spécifique mais que cette
option indique un codage différent, il se peut que l'application affiche mal certains
caractères.
Sélectionnez l'option Interpréter les rubriques Texte comme long varchar pour corriger les
problèmes relatifs aux valeurs de rubrique longues, par exemple les rubriques sans longueur
maximale spécifiée utilisées par la suite pour l'importation de fusion-publipostage de Microsoft
Word ou les valeurs de rubrique des applications PHP dépassant 255 caractères. Si vous
n'utilisez pas cette option pour les valeurs de rubrique dépassant 255 caractères, votre
application peut récupérer une chaîne vide (Windows) ou uniquement 255 caractères (OS X).
Si vous souhaitez créer un fichier journal pour les requêtes dont l'exécution est longue,
sélectionnez l'option Enregistrez requêtes longues dans fichier journal, puis entrez le nom
du fichier journal.
Cliquez sur Terminer pour enregistrer les informations de votre source de données.
Chapitre 3 | Installation de pilotes clients FileMaker ODBC
17
8. Vérifiez les informations relatives à votre DSN FileMaker.
1 Cliquez sur Test pour vérifier que vous avez correctement configuré le pilote client ODBC
pour l'accès à la source de données FileMaker. Si vous obtenez un message d'erreur, vous
pouvez corriger les informations de connexion. Vous devrez peut-être également vérifier que
le fichier de base de données FileMaker est hébergé et disponible, que le compte FileMaker
indiqué utilise un jeu de privilèges Accès via ODBC/JDBC et que l'application hôte
FileMaker Pro ou FileMaker Server a été configurée pour le partage via ODBC/JDBC.
1 Cliquez sur Terminer pour enregistrer vos informations de source de données.
Installation du pilote client ODBC (OS X)
Les pilotes clients OS X 32 et 64 bits sont installés en tant que groupe unique
(FileMaker ODBC.bundle) dans le dossier /Bibliothèque/ODBC. L'application cliente ODBC
charge automatiquement le pilote correct.
Pour installer le pilote client ODBC
1. Effectuez l'une des opérations suivantes :
1 Si vous avez reçu le logiciel par voie électronique, double-cliquez sur l'icône d'image disque
(fichier .dmg).
1 Si vous disposez d'un disque d'installation, insérez-le dans le lecteur.
2. Dans la fenêtre FileMaker Pro ou FileMaker Server, double-cliquez sur le dossier xDBC.
3. Dans le dossier xDBC, double-cliquez sur le dossier du programme ODBC Client Driver
Installer.
4. Dans le dossier du programme ODBC Client Driver Installer, double-cliquez sur le fichier
FileMaker ODBC.pkg.
Le programme d'installation du pilote FileMaker ODBC s'ouvre.
5. Installez le pilote client ODBC en suivant les instructions affichées à l’écran.
6. Lorsque vous avez terminé l’installation, cliquez sur Fermer.
Le pilote client ODBC est installé dans le dossier suivant : /Bibliothèque/ODBC
Remarque Vous ne pouvez pas modifier le dossier d'installation du pilote client ODBC.
Le pilote client ODBC, FileMaker ODBC, est désormais disponible pour configurer l’accès à
une source de données FileMaker.
Configuration des pilotes clients (OS X)
Avant d’utiliser une application cliente ODBC 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.
Ces instructions supposent que vous avez installé ODBC Manager d'Actual Technologies,
disponible à l'adresse http://www.odbcmanager.net, logiciel gratuit non pris en charge par
FileMaker.
Chapitre 3 | Installation de pilotes clients FileMaker ODBC
18
Etant donné qu'un seul groupe est installé pour les pilotes clients 32 et 64 bits, vous pouvez
utiliser le même administrateur ODBC pour les applications ODBC 32 et 64 bits. La source de
données FileMaker configurée peut être utilisée pour les applications ODBC 32 et 64 bits.
Important Lorsque vous utilisez un pilote client FileMaker, vous devez réserver le port 2399.
Pour configurer le pilote client ODBC :
1. Lancez l'utilitaire ODBC Manager. (ODBC Manager est installé dans le dossier Utilitaires du
dossier Applications.)
2. Sélectionnez l'onglet DSN système ou DSN utilisateur, puis cliquez sur Ajouter.
La boîte de dialogue de sélection d'un pilote s'ouvre.
3. Sélectionnez FileMaker ODBC, puis cliquez sur OK.
La boîte de dialogue Configuration DSN FileMaker s'ouvre.
4. Cliquez sur Continuer.
5. Dans la zone Nom, entrez un nom aisément identifiable par les autres utilisateurs accédant à
la source de données FileMaker Pro. Dans Description, entrez, si vous le souhaitez, une
description de la source de données FileMaker. Cliquez sur Continuer.
6. Dans Hôte :
1 Si vous vous connectez à un fichier de base de données hébergé par FileMaker Pro sur
votre ordinateur local, tapez localhost ou l'adresse IP 127.0.0.1.
1 Si vous vous connectez à un fichier de base de données hébergé par FileMaker Server par
l’intermédiaire d’un réseau, tapez l’adresse IP du serveur FileMaker.
Si vous avez activé le partage via ODBC/JDBC dans l'application hôte, vous pouvez
sélectionner Connectez-vous à l'hôte pour obtenir les noms des bases disponibles.
Cliquez sur Continuer.
Dans le cas contraire, cliquez sur Terminer pour enregistrer les informations de votre source
de données.
Chapitre 3 | Installation de pilotes clients FileMaker ODBC
19
7. Pour Base de données, sélectionnez une base de données dans la liste des bases de données
disponibles ou tapez le nom de fichier de la base de données utilisée comme source de
données.
Remarque Pour les bases de données hébergées par FileMaker Server, vous pouvez filtrer la
liste des bases de données sur le paramètre Filtre d'affichage du fichier. Pour plus
d'informations, consultez l'Aide de FileMaker Server.
Si vous avez besoin d'un traitement spécial réservé aux caractères autres que français, cliquez
sur Langue avancée. La boîte de dialogue Options de langue avancées s'ouvre.
1 Pour détecter automatiquement les paramètres de langue, sélectionnez l'option Détectez
auto. paramètres de langue pour application. Pour préciser le paramètre de langue,
décochez l'option Détectez auto. paramètres de langue pour application et sélectionnez
le paramètre système à utiliser.
1 Si votre application utilise des fonctions ODBC avec des mémoires tampons de caractères
à 4 octets, sélectionnez l'option L'application utilise l'API ODBC étendue.
1 Si vous souhaitez que le type de texte SQL_C_CHAR soit interprété par le pilote en tant que
type de texte SQL_C_WCHAR, sélectionnez l'option Considérer les types de texte comme
de l'Unicode.
1 En regard de l'option Codage multioctet du texte, sélectionnez Système ou UTF-8. Par
exemple, certaines applications telles que Microsoft Excel peuvent s'attendre à ce que le
texte utilise le codage Système, contrairement à certaines applications Web qui prévoient
du texte codé en UTF-8. Si l'application s'attend à un codage spécifique mais que cette
option indique un codage différent, il se peut que l'application affiche mal certains
caractères.
Sélectionnez l'option Interpréter les rubriques Texte comme long varchar pour corriger les
problèmes relatifs aux valeurs de rubrique longues, par exemple les rubriques sans longueur
maximale spécifiée utilisées par la suite pour l'importation de fusion-publipostage de Microsoft
Word ou les valeurs de rubrique des applications PHP dépassant 255 caractères.
Si vous souhaitez créer un fichier journal pour les requêtes dont l'exécution est longue,
sélectionnez l'option Enregistrez requêtes longues dans fichier journal, puis entrez le nom
du fichier journal.
Cliquez sur Terminer pour enregistrer les informations de votre source de données.
8. Vérifiez les informations relatives à votre DSN FileMaker.
1 Cliquez sur Test pour vérifier que vous avez correctement configuré le pilote client ODBC
pour l'accès à la source de données FileMaker. Si vous obtenez un message d'erreur, vous
pouvez corriger les informations de connexion. Vous devrez peut-être également vérifier que
le fichier de base de données FileMaker est hébergé et disponible, que le compte FileMaker
indiqué utilise un jeu de privilèges Accès via ODBC/JDBC et que l'application hôte
FileMaker Pro ou FileMaker Server a été configurée pour le partage via ODBC/JDBC.
1 Cliquez sur Terminer pour enregistrer vos informations de source de données.
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.
Chapitre 3 | Installation de pilotes clients FileMaker ODBC
20
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.
Pour plus d'informations sur l'utilisation de FileMaker en tant que source de données ODBC,
consultez le chapitre 4, « Utilisation d’ODBC pour partager des données FileMaker ».
Chapitre 4
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.
Le pilote client FileMaker ODBC est FileMaker ODBC.
Remarque Vous pouvez également utiliser FileMaker Pro en tant qu’application cliente ODBC et
la faire interagir avec les enregistrements d’une autre source de données via ODBC à l’aide de
SQL. Consultez le chapitre 2, « Accès aux sources de données SQL externes », pour plus de
détails sur l'accès à une source de données SQL externe via ODBC.
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 prenant en charge ODBC reconnaissent un sous-ensemble commun
d'instructions SQL (Structured Query Language). 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
afficher, 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 le Guide de référence SQL
FileMaker.
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 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.
Chapitre 4 | Utilisation d’ODBC pour partager des données FileMaker
22
Application
cliente
Gestionnaire
de pilotes
Oracle
Pilote ODBC
Pilote ODBC
SQL Server
Pilote client
FileMaker
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.
Chapitre 4 | Utilisation d’ODBC pour partager des données FileMaker
23
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 ou FileMaker Pro.
Pour plus d’informations, consultez l’aide de FileMaker Pro ou de FileMaker Server.
Important Les versions précédentes du pilote client ODBC ne sont pas compatibles avec
FileMaker 13. Pour vous connecter à un fichier de base de données FileMaker 13, vous devez
installer et configurer le nouveau pilote client ODBC.
Remarque Vous pouvez utiliser le Moniteur d’activité sous OS X ou le Gestionnaire des tâches
sous Windows pour vérifier l’état du processus du port d'écoute FileMaker XDBC afin de confirmer
que ce port d'écoute est en cours d’exécution. Une fois le processus lancé, il prend le nom
fmxdbc_listener, et les événements sont consignés sous ce nom. Le processus du port d'écoute
FileMaker XDBC est distinct du processus FileMaker Server. Vous pouvez utiliser l'Admin Console
FileMaker Server pour démarrer et arrêter le processus du port d'écoute XDBC. Dans le volet d'état
de FileMaker Server, définissez ODBC/JDBC sur Désactivé pour arrêter le port d'écoute XDBC, et
sur Activé pour le démarrer.
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 FileMaker Server (via
l'Admin Console FileMaker Server) ou FileMaker Pro.
Admin Console FileMaker Server : Sélectionnez Paramètres généraux > ODBC/JDBC puis
Activer ODBC/JDBC.
FileMaker Pro : Sélectionnez le menu Fichier > Partage > Activer ODBC/JDBC et définissez
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.
Chapitre 4 | Utilisation d’ODBC pour partager des données FileMaker
24
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.
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.
Pour configurer un nouveau pilote client ODBC, consultez la section « Configuration des pilotes
clients (Windows) », page 14.
Modification d'un pilote client ODBC existant (Windows)
Pour modifier un pilote client ODBC existant, ouvrez la version adéquate de l'administrateur
ODBC. Pour configurer le pilote client 32 bits, vous devez utiliser l'administrateur ODBC 32 bits.
Pour configurer le pilote client 64 bits, vous devez utiliser l'administrateur ODBC 64 bits.
Pour ouvrir l'administrateur ODBC 32 bits sur un système d'exploitation Windows 32 bits :
Dans le Panneau de configuration de Windows, ouvrez Outils d’administration > Sources de
données (ODBC).
Remarque L'option Outils d'administration apparaît dans la catégorie Système et sécurité.
L'Administrateur de sources de données ODBC 32 bits s'ouvre.
Pour ouvrir le pilote client ODBC 32 bits sur un système d'exploitation Windows 64 bits :
1. Ouvrez le dossier SysWOW64 sur votre système. (Par défaut, le dossier SysWOW64 se trouve
au chemin suivant : c:\windows\SysWOW64.)
2. Double-cliquez sur le fichier odbcad32.exe.
L'Administrateur de sources de données ODBC 32 bits s'ouvre.
Pour ouvrir le pilote client ODBC 64 bits sur un système d'exploitation Windows 64 bits :
Dans le Panneau de configuration de Windows, ouvrez Outils d’administration > Sources de
données (ODBC).
Remarque L'option Outils d'administration apparaît dans la catégorie Système et sécurité.
L'Administrateur de sources de données ODBC 64 bits s'ouvre.
Chapitre 4 | Utilisation d’ODBC pour partager des données FileMaker
25
Pour modifier le pilote client ODBC existant :
1. Dans l'Administrateur de source de données ODBC, sélectionnez l'onglet Sources de
données système ou Sources de données utilisateur (sélectionnez l'onglet utilisé lors de la
précédente configuration).
2. 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 Nom et FileMaker ODBC
apparaît sous Pilote.
3. Cliquez sur Configurer.
La boîte de dialogue Configuration DSN FileMaker s'ouvre.
4. Dans la zone Nom, entrez un nom aisément identifiable par les autres utilisateurs accédant à
la source de données FileMaker Pro. Dans Description, entrez, si vous le souhaitez, une
description de la source de données FileMaker. Cliquez sur Suivant.
5. Pour Hôte, 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 127.0.0.1 (ou localhost).
Si vous vous connectez à un fichier de base de données FileMaker hébergé par
FileMaker Server par l’intermédiaire d’un réseau, tapez l’adresse IP du serveur FileMaker.
Si vous avez activé le partage via ODBC/JDBC dans l'application hôte, sélectionnez
Connectez-vous à l'hôte pour obtenir les noms des bases disponibles.
Chapitre 4 | Utilisation d’ODBC pour partager des données FileMaker
26
6. Pour Base de données, sélectionnez une base de données dans la liste des bases de données
disponibles ou tapez le nom de fichier de la base de données utilisée comme source de
données.
Remarque Pour les bases de données hébergées par FileMaker Server, vous pouvez filtrer la
liste des bases de données sur le paramètre Filtre d'affichage du fichier. Pour plus
d'informations, consultez l'Aide de FileMaker Server.
Si vous avez besoin d'un traitement spécial réservé aux caractères autres que français, cliquez
sur Langue avancée. La boîte de dialogue Options de langue avancées s'ouvre.
1 Pour détecter automatiquement les paramètres de langue, sélectionnez l'option Détectez
auto. paramètres de langue pour application. Pour préciser le paramètre de langue,
décochez l'option Détectez auto. paramètres de langue pour application et sélectionnez
le paramètre système à utiliser.
1 En regard de l'option Codage multioctet du texte, sélectionnez Système ou UTF-8. Par
exemple, certaines applications telles que Microsoft Excel peuvent s'attendre à ce que le
texte utilise le codage Système, contrairement à certaines applications Web qui prévoient
du texte codé en UTF-8. Si l'application s'attend à un codage spécifique mais que cette
option indique un codage différent, il se peut que l'application affiche mal certains
caractères.
Sélectionnez l'option Interpréter les rubriques Texte comme long varchar pour corriger les
problèmes relatifs aux valeurs de rubrique longues, par exemple les rubriques sans longueur
maximale spécifiée utilisées par la suite pour l'importation de fusion-publipostage de Microsoft
Word ou les valeurs de rubrique des applications PHP dépassant 255 caractères.
Si vous souhaitez créer un fichier journal pour les requêtes dont l'exécution est longue,
sélectionnez l'option Enregistrez requêtes longues dans fichier journal, puis entrez le nom
du fichier journal.
7. Cliquez sur Terminer pour enregistrer les informations de votre source de données.
8. Cliquez sur Terminé pour fermer la boîte de dialogue Configuration DSN FileMaker.
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. Dans le Panneau de configuration de Windows, ouvrez Outils d’administration > Sources de
données (ODBC).
Remarque L'option Outils d'administration apparaît dans la catégorie Système et sécurité.
L'Administrateur de sources de données ODBC s'ouvre.
2. Sélectionnez l'onglet Sources de données système ou Sources de données utilisateur
(sélectionnez l'onglet utilisé lors de la précédente configuration).
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 Nom et FileMaker ODBC
apparaît sous Pilote.
Chapitre 4 | Utilisation d’ODBC pour partager des données FileMaker
27
4. Cliquez sur Configurer.
La boîte de dialogue Configuration DSN FileMaker s'ouvre.
5. Cliquez sur Suivant jusqu'à la page Conclusion.
6. Cliquez sur Test.
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 Réussite du test 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.
Accès à un fichier de base de données FileMaker depuis une application
OS X
Spécification des propriétés de pilote client ODBC pour une source de données
FileMaker (OS X)
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.
Pour configurer un nouveau pilote client ODBC, consultez la section « Configuration des pilotes
clients (OS X) », page 17.
Modification d'un pilote client ODBC existant (OS X)
Ces instructions supposent que vous avez installé ODBC Manager d'Actual Technologies,
disponible à l'adresse http://www.odbcmanager.net, logiciel gratuit non pris en charge par
FileMaker.
Etant donné qu'un seul groupe est installé pour les pilotes clients 32 et 64 bits, vous pouvez
utiliser le même administrateur ODBC pour les applications ODBC 32 et 64 bits. La source de
données FileMaker configurée peut être utilisée pour les applications ODBC 32 et 64 bits.
Pour modifier un pilote client ODBC existant :
1. Lancez l'utilitaire ODBC Manager. (ODBC Manager est installé dans le dossier Utilitaires du
dossier Applications.)
2. Cliquez sur l'onglet DNS système ou DNS utilisateur.
Chapitre 4 | Utilisation d’ODBC pour partager des données FileMaker
28
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 Nom et FileMaker ODBC
apparaît sous Pilote.
4. Cliquez sur Configurer.
La boîte de dialogue Configuration DSN FileMaker s'ouvre.
5. Cliquez sur Continuer.
6. Dans la zone Nom, 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).
7. Pour Hôte, 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 127.0.0.1 (ou localhost).
Si vous vous connectez à un fichier de base de données FileMaker hébergé par
FileMaker Server par l’intermédiaire d’un réseau, tapez l’adresse IP du serveur FileMaker.
Si vous avez activé le partage via ODBC/JDBC dans l'application hôte, sélectionnez
Connectez-vous à l'hôte pour obtenir les noms des bases disponibles.
8. Pour Base de données, sélectionnez une base de données dans la liste des bases de données
disponibles ou tapez le nom de fichier de la base de données utilisée comme source de
données.
Remarque Pour les bases de données hébergées par FileMaker Server, vous pouvez filtrer la
liste des bases de données sur le paramètre Filtre d'affichage du fichier. Pour plus
d'informations, consultez l'Aide de FileMaker Server.
Si vous avez besoin d'un traitement spécial réservé aux caractères autres que français, cliquez
sur Langue avancée. La boîte de dialogue Options de langue avancées s'ouvre.
1 Pour détecter automatiquement les paramètres de langue, sélectionnez l'option Détectez
auto. paramètres de langue pour application. Pour préciser le paramètre de langue,
décochez l'option Détectez auto. paramètres de langue pour application et sélectionnez
le paramètre système à utiliser.
1 Si votre application utilise des fonctions ODBC avec des mémoires tampons de caractères
à 4 octets, sélectionnez l'option L'application utilise l'API ODBC étendue.
1 Si vous souhaitez que le type de texte SQL_C_CHAR soit interprété par le pilote en tant que
type de texte SQL_C_WCHAR, sélectionnez l'option Considérer les types de texte comme
de l'Unicode.
Chapitre 4 | Utilisation d’ODBC pour partager des données FileMaker
29
1 En regard de l'option Codage multioctet du texte, sélectionnez Système ou UTF-8. Par
exemple, certaines applications telles que Microsoft Excel peuvent s'attendre à ce que le
texte utilise le codage Système, contrairement à certaines applications Web qui prévoient
du texte codé en UTF-8. Si l'application s'attend à un codage spécifique mais que cette
option indique un codage différent, il se peut que l'application affiche mal certains
caractères.
Sélectionnez l'option Interpréter les rubriques Texte comme long varchar pour corriger les
problèmes relatifs aux valeurs de rubrique longues, par exemple les rubriques sans longueur
maximale spécifiée utilisées par la suite pour l'importation de fusion-publipostage de Microsoft
Word ou les valeurs de rubrique des applications PHP dépassant 255 caractères.
Si vous souhaitez créer un fichier journal pour les requêtes dont l'exécution est longue,
sélectionnez l'option Enregistrez requêtes longues dans fichier journal, puis entrez le nom
du fichier journal.
9. Cliquez sur Terminer pour enregistrer les informations de votre source de données.
10. Cliquez sur Terminé pour fermer la boîte de dialogue Configuration DSN FileMaker.
Vérification de l’accès via ODBC (OS X)
Pour vérifier que vous avez configuré correctement le pilote client ODBC pour accéder à la source
de données FileMaker :
1. Lancez l'utilitaire ODBC Manager. (ODBC Manager se trouve dans le dossier Utilitaires du
dossier Applications.)
2. Sélectionnez l'onglet Sources de données système ou Sources de données utilisateur
(sélectionnez l'onglet utilisé lors de la précédente configuration).
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 Nom et FileMaker ODBC
apparaît sous Pilote.
4. Cliquez sur Configurer.
La boîte de dialogue Configuration DSN FileMaker s'ouvre.
5. Cliquez sur Continuer jusqu'à la page Conclusion.
6. Cliquez sur Test.
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 Réussite du test 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.
Chapitre 4 | Utilisation d’ODBC pour partager des données FileMaker
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.
30
Chapitre 5
Installation de pilotes clients FileMaker JDBC
Ces instructions vous aident à installer le pilote client nécessaire pour accéder à FileMaker en tant
que source de données depuis des applications tierces et personnalisées via JDBC. Le pilote
client est disponible dans le dossier xDBC du DVD-ROM de FileMaker ou du téléchargement
électronique.
Recherchez les mises à jour des pilotes clients à cette adresse :
http://www.filemaker.fr/support/downloads/
Si vous devez héberger un fichier de base de données FileMaker à l’aide de FileMaker Server,
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 pour interagir avec les données.
Le pilote client JDBC est la partie du logiciel FileMaker qui permet à des applications tierces ou
personnalisées d’accéder aux fichiers FileMaker en tant que sources de données JDBC.
Configuration logicielle requise
Pour installer et utiliser les pilotes clients JDBC, vous devez disposer de JDK 1.6 ou une version
ultérieure.
Pour savoir quelle version de Java vous exécutez, ouvrez une fenêtre de commande (Windows)
ou une fenêtre Terminal (OS X) 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 JDBC
Vous devez disposer d’un accès en écriture sur le dossier d’installation du pilote client JDBC.
Pour installer le pilote client JDBC
1. Effectuez l'une des opérations suivantes :
1 Windows : Si vous avez reçu le logiciel par voie électronique, double-cliquez sur l'icône
d'installation (fichier .exe).
1 OS X : Si vous avez reçu le logiciel par voie électronique, double-cliquez sur l'icône d'image
disque (fichier .dmg).
1 Si vous disposez d'un disque d'installation, insérez-le dans le lecteur.
2. Dans la fenêtre FileMaker Pro ou FileMaker Server, double-cliquez sur le dossier xDBC.
3. Dans le dossier xDBC, double-cliquez sur le dossier du programme JDBC Client Driver
Installer.
Chapitre 5 | Installation de pilotes clients FileMaker JDBC
32
4. Copiez le fichier fmjdbc.jar dans le dossier approprié pour votre système d'exploitation :
1 Windows : Copiez le fichier fmjdbc.jar dans le dossier contenant votre fichier exécutable
Java (java.exe) ou dans un autre dossier inclus dans l'élément ClassPath de votre
application Java.
1 OS X : Copiez le fichier fmjdbc.jar dans le dossier /Bibliothèque/Java/Extensions ou dans un
autre dossier inclus dans l'élément ClassPath de votre application Java.
Le pilote client JDBC est désormais disponible pour accéder à une source de données FileMaker.
Utilisation du pilote client JDBC
Votre application ou applet Java doit enregistrer le pilote client JDBC dans le gestionnaire de
pilotes JDBC et vous devez spécifier l’URL JDBC correcte à partir de l’application ou de l’applet.
Important Vous devez réserver le port 2399 pour le pilote de client FileMaker JDBC. Le numéro
de port est toujours 2399. Vous ne pouvez pas déplacer le partage JDBC sur un autre port.
Pour plus d'informations sur l'utilisation du pilote client JDBC, consultez le chapitre 6, « Utilisation
de JDBC pour partager des données FileMaker ».
Chapitre 6
Utilisation de JDBC pour partager des données
FileMaker
Si vous programmez en Java, vous pouvez employer le pilote client JDBC avec n’importe quel outil
RAD (Rapid Application Development) pour créer visuellement une application ou une applet Java
qui se connecte à une source de données FileMaker. L’application ou applet Java qui utilise le pilote
client JDBC peut accéder directement aux données d’un fichier de base de données FileMaker.
A propos de JDBC
JDBC est une API (Application Programming Interface) Java qui permet d’exécuter des
instructions SQL (Structured Query Language), langage standard d’accès aux bases de données
relationnelles. JDBC est une interface de bas niveau, ce qui signifie qu’il est utilisé pour appeler
directement les commandes SQL. Il sert également de base pour des interfaces et outils de
haut niveau.
Votre applet ou application Java peut communiquer directement avec un fichier de base de
données FileMaker en utilisant le pilote client JDBC. 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 pour l’hébergement, le fichier de base de données que vous
employez en tant que source de données peut être situé sur une autre machine (la machine
serveur) connectée au réseau, votre applet ou application cliente Java étant placée sur votre
machine (la machine cliente). Il s’agit d’une configuration client/serveur.
application Java
Pilote JDBC
FileMaker
Ordinateur client
Serveur de bases de données
Utilisation du pilote client JDBC
Vous pouvez utiliser le pilote client JDBC avec un compilateur Java ou un outil RAD pour vous
connecter à la base de données pendant la création du code de l’application ou de l’applet Java.
Une fois l’application ou l’applet Java créée, le pilote client JDBC doit accompagner les fichiers ou
être inclus dans le code pour que l’application ou l’applet puisse communiquer avec la base
de données.
Pour utiliser le pilote client JDBC, votre application ou applet Java doit enregistrer le pilote dans
le gestionnaire de pilotes JDBC et vous devez spécifier l’URL JDBC correcte à partir de
l’application ou de l’applet. L’URL JDBC est nécessaire pour se connecter à la base de données.
Chapitre 6 | Utilisation de JDBC pour partager des données FileMaker
34
A propos du pilote client JDBC
Le pilote client JDBC prend partiellement en charge la spécification JDBC 3.0. Les fonctions
suivantes ne sont pas prises en charge par FileMaker :
1
1
1
1
1
1
1
1
1
Savepoint
Extraction des clés générées automatiquement
Transmission des paramètres vers un objet d’instruction d’appel par nom
Curseur persistant
Extraction et mise à jour de l’objet référencé par un objet Ref
Mise à jour des colonnes contenant des types de données CLOB, ARRAY et REF
Type de données booléen
Type de données DATALINK
Transformation des groupes et correspondance de types
1 Relation entre le SPI JDBC et l’architecture Connector
Le pilote client JDBC a été testé par rapport au JDK (Java Development Kit) 1.6 et 1.7. Il s’agit
d’un pilote de type 4, c’est-à-dire d’un pilote de protocole natif purement Java qui convertit
directement les appels JDBC dans le protocole de réseau utilisé par FileMaker. Ce type de
pilote offre tous les avantages de Java, y compris l’installation automatique (par exemple, le
téléchargement du pilote JDBC avec l’applet qui l’utilise).
La classe (et point d’accès principal) du pilote est nommée :
com.filemaker.jdbc.Driver
Important Le pilote client JDBC remplace le pilote JDBC FileMaker 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 OS X ou le Gestionnaire des tâches
sous Windows pour vérifier l’état du processus du port d'écoute FileMaker XDBC afin de confirmer
que ce port d'écoute est en cours d’exécution. Une fois le processus lancé, il prend le nom
fmxdbc_listener et les événements sont consignés sous ce nom. Le processus du port d'écoute
FileMaker XDBC est distinct du processus FileMaker Server. Vous pouvez utiliser l'Admin Console
FileMaker Server pour démarrer et arrêter le processus du port d'écoute XDBC. Dans le volet d'état
de FileMaker Server, définissez ODBC/JDBC sur Désactivé pour arrêter le port d'écoute XDBC, et
sur Activé pour le démarrer.
Utilisation d’une URL JDBC pour la connexion à une base de données
En langage Java, l’accès à la plupart des ressources s’effectue par le biais d’URL (Uniform
Resource Locator). Une URL JDBC sert à identifier la base de données afin que le pilote client
JDBC puisse la reconnaître et s’y connecter.
L’URL JDBC est constituée de trois éléments principaux, séparés par le signe deux-points :
jdbc:<sous-protocole>:<sous-nom>
Chapitre 6 | Utilisation de JDBC pour partager des données FileMaker
35
La première partie de l’URL JDBC est toujours le protocole JDBC (jdbc). Le sous-protocole est
le nom du pilote ou le mécanisme prenant en charge plusieurs pilotes. Pour le pilote client JDBC, le
sous-protocole est filemaker. Le sous-nom est l’adresse IP de la machine qui héberge la source
de données FileMaker.
Enregistrement du pilote client JDBC et connexion à une source de données FileMaker (exemple)
Vous trouverez ci-dessous une partie de code d’une application cliente JDBC qui :
1. Enregistre le pilote client JDBC auprès du gestionnaire de pilotes JDBC.
2. Etablit une connexion avec la source de données FileMaker. L'URL JDBC est
jdbc:filemaker://192.168.1.1/database
3. Renvoie des codes d’erreur.
import java.sql.*
class FMPJDBCTest
{
public static void main(String[ ] args)
{
// enregistrement du pilote client JDBC
try {
Driver d =
(Driver)Class.forName("com.filemaker.jdbc.Driver").newInstance();
} catch(Exception e) {
System.out.println(e);
}
// établissement d’une connexion avec FileMaker
Connection con;
try {
con =
DriverManager.getConnection(“jdbc:filemaker://192.168.1.1/mydataba
se”,”username”, “password”);
} catch(Exception e) {
System.out.println(e);
}
// généreration des avertissements de connexion
SQLWarning warning = null;
try {
warning = con.getWarnings();
if (warning == null) {
System.out.println("Aucun avertissement");
return;
}
while (warning != null) {
System.out.println("Avertissement : +warning);
warning = warning.getNextWarning();
Chapitre 6 | Utilisation de JDBC pour partager des données FileMaker
36
}
} catch (Exception e) {
Sysem.out.println(e);
}
}
}þ
Remarque Cet exemple n’est pas destiné à être compilé.
Spécification des propriétés du pilote dans le sous-nom de l’URL
Indiquez les propriétés d’utilisateur et de mot de passe du pilote dans le sous-nom de l’URL JDBC.
Il s’agit des mêmes propriétés que celles qui pouvaient être transférées à la connexion en
invoquant la méthode DriverManager.getConnection à l’aide du paramètre Properties.
1 user : compte du fichier de base de données FileMaker qui emploie un jeu de privilèges avec
le privilège étendu Accès via ODBC/JDBC
1 password : mot de passe du compte du fichier de base de données FileMaker
Connexion à l’URL JDBC avec le nom de la base de données spécifiée dans l’URL
Format :
jdbc:filemaker://<adresse IP de l’hôte filemaker>/<nombasedonnées>
Par exemple :
jdbc:filemaker://192.168.1.1/publications
Connexion à l’URL JDBC avec le nom de la base de données, le nom d’utilisateur et le mot de passe
spécifiés dans l’URL
Format :
jdbc:filemaker://<adresse IP de l’hôte
filemaker>/<nombasedonnées>?user=<nomutilisateurbasedonnées>&password=<motpa
ssebasedonnées>
Par exemple :
jdbc:filemaker://192.168.1.1/customers?user=Collections&password=
admin
Remarque Etant donné l'utilisation du caractère « et » commercial (&) dans cette syntaxe, vous
ne pouvez pas utiliser de symbole et commercial dans le nom d'utilisateur ou le mot de passe.
Exemple de nom d'utilisateur incorrect :
jdbc:filemaker://localhost/sales_db?user=ad&min&password=admin
Exemple de mot de passe incorrect :
jdbc:filemaker://localhost/sales_db?user=admin1&password=ad&min
Chapitre 6 | Utilisation de JDBC pour partager des données FileMaker
37
Solutions possédant plusieurs fichiers de bases de données FileMaker
Si votre solution de base de données FileMaker utilise de nombreux fichiers de base de données
FileMaker, créez un fichier de base de données supplémentaire contenant toutes les références
nécessaires de sources de données externes, d’occurrences de tables et de liens. Définissez ensuite
ce fichier de base de données supplémentaire en tant que source de données dans l’URL JDBC.
Tous les fichiers de base de données FileMaker doivent être enregistrés sur le même ordinateur.
Vérification de l’accès via JDBC
Pour vérifier l’accès à un fichier de base de données FileMaker via JDBC, assurez-vous que :
1 Le fichier de base de données FileMaker est hébergé et disponible.
1 Votre compte FileMaker emploie un jeu de privilèges incluant le privilège étendu Accès via
ODBC/JDBC.
1 L’application hôte FileMaker Pro ou FileMaker Server a été configurée pour partager des
fichiers via ODBC/JDBC.
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 ou
FileMaker Pro. Pour plus d’informations, consultez l’aide de FileMaker Pro ou de
FileMaker Server.
1 L’enregistrement du pilote client JDBC et l’URL JDBC sont corrects (le pilote peut être inclus
dans l’application Java ou situé sur la machine cliente).
Chapitre 7
Informations de référence
Fonctions de catalogue ODBC
Le pilote client ODBC prend en charge les fonctions de catalogue suivantes :
1 SQLTables : les informations de catalogue sont stockées et reportées sous forme de noms
d'élément uniques (nom de table seulement).
1 SQLColumns
1 SQLColumnPrivileges
1 SQLDescribeCol
1 SQLGetTypeInfo
Fonctions de métadonnées JDBC
1
1
1
1
1
1
getColumns
getColumnPrivileges
getMetaData
getTypeInfo
getTables
getTableTypes
Correspondances entre les rubriques FileMaker et les types de données
ODBC
Le tableau suivant présente les correspondances entre les types de données FileMaker et ODBC
standard.
Type de rubrique
FileMaker
Type de données ODBC
correspondant après
conversion
Texte
SQL_VARCHAR
La longueur maximale d’une colonne de texte est de 1 million
de caractères, à moins que vous ne fixiez une limite
inférieure à l’aide de l’option Nombre maximal de
caractères pour la rubrique de type texte dans FileMaker.
FileMaker renvoie les chaînes vides sous la forme NULL.
Nombre
SQL_DOUBLE
Le type de rubrique nombre de FileMaker peut contenir des
valeurs positives ou négatives comprises entre 10-308 et
10+308, avec un maximum de 15 chiffres significatifs.
date
SQL_DATE
Heure
SQL_TIME
Horodatage
SQL_TIMESTAMP
Précisions sur ce type de données
Le type de rubrique heure de FileMaker peut contenir l’heure du
jour ou un intervalle de temps. Un intervalle de temps est renvoyé
sous forme d’heure du jour, à moins qu’il ne soit inférieur à 0 ou
supérieur à 24 (auquel cas la valeur renvoyée est 0).
Chapitre 7 | Informations de référence
39
Type de rubrique
FileMaker
Type de données ODBC
correspondant après
conversion
Conteneur (BLOB)
SQL_LONGVARBINARY
Calcul
Précisions sur ce type de données
Depuis une rubrique Conteneur, vous pouvez récupérer des
données binaires, des informations de référence de fichier ou
des données appartenant à un type de fichier particulier.
Au sein d'une instruction SELECT, utilisez la fonction CAST()
pour récupérer les informations de référence du fichier, de
même que la fonction GetAs() pour récupérer les données
d’un type de fichier en particulier.
Le résultat est converti dans le type de données ODBC
correspondant.
La longueur des chaînes est facultative dans les déclarations de table. Toutes les chaînes sont
stockées et extraites au format Unicode.
Remarque Les rubriques multivaluées de FileMaker sont prises en charge de la même façon que
les tableaux. Exemples :
INSERT INTO mytable(repField[3]) VALUES ('valeur multivaluée 3')
SELECT repField[1], repField[2] FROM mytable
Correspondances entre les rubriques FileMaker et les types de données
JDBC
Le pilote client JDBC emploie les correspondances suivantes pour convertir des types de
données FileMaker en types de données SQL JDBC. (For information about these types, see the
JDK documentation web pages at http://javasoft.com)
Type de rubrique
FileMaker
Type SQL JDBC correspondant après conversion
Texte
java.sql.Types.VARCHAR
Nombre
java.sql.Types.DOUBLE
date
java.sql.Types.DATE
Heure
java.sql.Types.TIME
Horodatage
java.sql.Types.TIMESTAMP
Conteneur
java.sql.Types.BLOB
Calcul
varie suivant le type de données du résultat du calcul
Le pilote client JDBC convertit le type de données calcul de FileMaker en type SQL JDBC
correspondant au résultat du calcul. Par exemple, le pilote client JDBC convertit un calcul
FileMaker qui génère un résultat de type horodatage en type java.sql.Types.TIMESTAMP.
Types de données des applications 64 bits
Dans la version 32 bits de l'API ODBC, certaines fonctions utilisaient des paramètres pouvant
transmettre des valeurs d'entier ou de pointeur, selon le contexte. Mais avec les systèmes
d'exploitation Windows 64 bits, les entiers et les pointeurs n'ont pas la même taille. La version 64 bits
de l'API ODBC utilise des types de données abstraites non définies en tant que taille spécifique.
Les applications utilisant des valeurs 32 bits peuvent être arrêtées lorsqu'elles sont transférées
sur un système d'exploitation 64 bits. Les applications utilisant des types de données abstraites
fonctionnent correctement sur les systèmes d'exploitation 32 et 64 bits.
Chapitre 7 | Informations de référence
40
Messages d’erreur ODBC et JDBC
Cette annexe présente le format de base des messages d’erreur que vous pouvez recevoir en
travaillant avec FileMaker et ODBC/JDBC.
Messages d’erreur ODBC
Si vous obtenez des messages d’erreur, ils peuvent provenir de différentes sources :
1 Pilote ODBC
1 FileMaker et port d'écoute FileMaker XDBC
Messages d’erreur FileMaker ODBC
Si une erreur se produit au niveau du port d'écoute FileMaker ou de la source de données, le
message précise le nom de cette source de données et se présente de la façon suivante :
[FileMaker] [FileMaker ODBC] message
Une source de données FileMaker, par exemple, peut renvoyer un message d’erreur comme
celui-ci :
[FileMaker] [FileMaker ODBC] Nom d'utilisateur/mot de passe non valide
Un message d’erreur de ce type signale que vous avez effectué une opération incorrecte dans le
système de base de données. Pour plus d’informations, consultez votre documentation FileMaker
ou demandez conseil à l’administrateur de la base de données.
Les messages suivants mentionnant des erreurs dans des colonnes différentes s’affichent parfois
dans un nom de colonne incorrect.
Messages d’erreur JDBC
Le pilote FileMaker JDBC signale les erreurs à l’application à l’origine de l’appel en renvoyant des
exceptions SQL. Si vous obtenez des messages d’erreur, ils peuvent provenir de différentes
sources :
1 Pilote JDBC ;
1 FileMaker et port d'écoute FileMaker XDBC
Messages d’erreur FileMaker JDBC
Si une erreur se produit au niveau du port d'écoute FileMaker ou de la source de données, le
message précise le nom de cette source de données et se présente de la façon suivante :
[FileMaker] [FileMaker JDBC] message
Une source de données FileMaker, par exemple, peut renvoyer un message d’erreur comme
celui-ci :
[FileMaker] [FileMaker JDBC] Nom d'utilisateur/mot de passe non valide
Un message d’erreur de ce type signale que vous avez effectué une opération incorrecte dans le
système de base de données. Pour plus d’informations, consultez votre documentation FileMaker
ou demandez conseil à l’administrateur de la base de données.
Index
A
accès à distance 7
Accès via ODBC/JDBC, privilège étendu 23
Action de script Exécuter SQL 10
Action de script Importer enregistrements 10
Administrateur de source de données ODBC (Windows) 27
administrateur ODBC (OSX) 29
application cliente, utilisation de FileMaker en tant que 5
B
base de données, DSN 26
C
clés générées automatiquement 34
comptes et privilèges 23
configuration d’une source de données FileMaker
via JDBC 36
via ODBC (OSX) 27
via ODBC (Windows) 24
configuration des privilèges et du partage 23
configuration requise pour l’installation 13, 31
Configuration réseau requise 8
configuration système requise 13, 31
correspondance de types de données
pilote clientJDBC 39
pilote clientODBC 38
curseur persistant 34
curseurs
dans JDBC 34
D
désactivation d’un fichier de base de données FileMaker
partagé 8
E
enregistrement du pilote client JDBC 35
étendus, privilèges 23
exceptions SQL 40
F
fichiers
configuration de l’accès à 23
organisation sur un seul ordinateur 7
fonction CAST 39
fonction ExecuteSQL 10
fonction GetAs 39
Fonctions de catalogue ODBC 38
Fonctions de métadonnées JDBC 38
formats des messages d’erreur 40
H
hôte, DSN 25, 28
I
installation, configuration requise 13, 31
J
Java, version 31
JDBC
messages d’erreur 40
pilote client, description 34
présentation 33
JDK (Java Development Kit) 34
M
mot de passe
avec JDBC 36
avec ODBC 27, 29
N
noms de colonne 24
noms de source de données. Voir sources de données
O
ODBC
messages d'erreur 40
présentation 21
rubriques multivaluées 39
OSX
configuration requise pour le pilote client JDBC 31
configuration requise pour le pilote client ODBC 13
création d'une source de données 27
vérification de l'accès à ODBC 29
outils RAD (Rapid Application Development) 33
P
partage, configuration de ODBC/JDBC 23
pilote client JDBC
classe et point d’accès principal du pilote 34
enregistrement avec le gestionnaire de pilotes JDBC 35
spécification de l’URL JDBC 34
vérification de l'accès 37
42
pilote client ODBC
vérification de l'accès (OSX) 29
vérification de l'accès (Windows) 26
pilote clientJDBC
types de données, correspondance 39
pilote clientODBC
types de données, correspondance 38
pilotes
désinstallation de l’ancien 8
port d'écoute XDBC 23, 34, 40
port, spécification pour JDBC 32
prise en charge de Savepoint 34
privilèges étendus 23
produits FileMaker 7
propriétés de pilote
pilote client JDBC 36
pilote client ODBC (OSX) 27
pilote client ODBC (Windows) 24
R
rubrique Conteneur
correspondance de types de données JDBC 39
correspondance de types de données ODBC 39
rubriques
correspondance avec JDBC 39
correspondance avec ODBC 38
rubriques multivaluées 39
S
source de données
configuration pour l’accès via JDBC 36
configuration pour l’accès via ODBC (OSX) 27
configuration pour l’accès via ODBC (Windows) 24
désactivation d’un fichier de base de données FileMaker
partagé 8
une source de données pour chaque fichier de base de données FileMaker 8
vérification de l'accès via JDBC 37
vérification de l’accès via ODBC (OSX) 29
vérification de l’accès via ODBC (Windows) 26
source de données serveur 28
sources de données
création (OS X) 27
création (Windows) 24
une par fichier 8
SPI JDBC 34
T
test d'accès
pilote client JDBC 37
pilote client ODBC (Windows) 26
test de l'accès
pilote client ODBC (OSX) 29
type de données ARRAY 34
type de données booléen 34
type de données CLOB 34
type de données DATALINK 34
type de données REF 34
types de données, correspondance
pilote clientJDBC 39
pilote clientODBC 38
U
URL (Uniform Resource Locator) pour le pilote client JDBC 34
utilisation d’ODBC et de JDBC avec FileMaker 5
V
valeur nulle 38
vérification de l'accès
pilote client JDBC 37
pilote client ODBC (OSX) 29
pilote client ODBC (Windows) 26
W
Windows
configuration requise pour le pilote client JDBC 31
configuration requise pour le pilote client ODBC 13
création d’une source de données 24
vérification de l’accès à ODBC 26
">