Guide FileMaker 18 Data API

FileMaker^® Data API est une interface de programmation d'applications (API) qui permet aux services Web d'accéder aux données se trouvant dans des bases de données hébergées. FileMaker Data API utilisant une architecture REST (Representational State Transfer), elle peut donc être qualifiée d'API REST.

Votre service Web ou votre application appelle FileMaker Data API pour obtenir un jeton d'authentification afin d'accéder à une base de données hébergée. Il ou elle utilise alors ce jeton dans les appels suivants pour créer, mettre à jour et supprimer des enregistrements, mais aussi pour exécuter des requêtes.

FileMaker Data API renvoie ensuite des données au format JSON (JavaScript Object Notation), un format texte couramment utilisé avec les API REST, car il ne dépend d'aucun format de langage de programmation en particulier.

Ce guide part du principe que vous savez :

• utiliser FileMaker Pro Advanced pour créer des bases de données. Vous devez comprendre les bases de la conception de bases de données avec FileMaker Pro Advanced, ainsi que les concepts de rubriques, de liens, de modèles, de tables externes et de conteneurs. Consultez l'Aide FileMaker Pro Advanced.
• utiliser FileMaker Server ou un produit FileMaker Cloud pour héberger des bases de données. Vous devez savoir configurer l'hôte, autoriser l'accès aux bases de données hébergées et les surveiller au moyen de l'Admin Console.
• FileMaker Cloud est un service permettant aux apps personnalisées qui utilisent FileMaker Pro Advanced, FileMaker Go et FileMaker WebDirect d'accéder au cloud. FileMaker Cloud utilise le système de connexion intégré FileMaker ID pour authentifier les utilisateurs. FileMaker Cloud est disponible directement via FileMaker, Inc.
• FileMaker Cloud for AWS est un service permettant aux apps personnalisées qui utilisent FileMaker Pro Advanced, FileMaker Go et FileMaker WebDirect d'accéder au cloud. FileMaker Cloud for AWS s'exécute sur le cloud Amazon Web Services (AWS) et est disponible via AWS Marketplace.
• Les produits FileMaker Cloud font référence à FileMaker Cloud et FileMaker Cloud for AWS.
• utiliser des API REST dans des applications côté serveur ou des services Web qui appellent les méthodes POST, GET, PATCH et DELETE avec des données au format JSON. Vous pouvez utiliser les langages de programmation ou les outils de votre choix.

L'Admin Console désigne l'Admin Console de FileMaker Server, FileMaker Cloud for AWS et FileMaker Cloud, sauf si un produit en particulier est mentionné. La FileMaker Cloud Admin Console désigne l'Admin Console des deux produits FileMaker Cloud, sauf si un produit en particulier est mentionné.

Pour utiliser FileMaker Data API, procédez comme suit :

1. Préparez votre base de données pour un accès via FileMaker Data API avec FileMaker Pro Advanced. Vous pouvez créer une base de données ou préparer une base de données existante. Consultez la section Préparer les bases de données pour un accès via FileMaker Data API.
2. Ecrivez un code qui appelle les méthodes FileMaker Data API afin de rechercher, créer, modifier, dupliquer et supprimer des enregistrements dans une base de données hébergée. Consultez la section Ecrire des appels FileMaker Data API.
3. Hébergez votre solution en activant l'accès via FileMaker Data API. Consultez la section Héberger une solution FileMaker Data API.
4. Testez le fonctionnement de l'accès via FileMaker Data API. Consultez la section Tester une solution FileMaker Data API.
5. Surveillez votre solution hébergée avec l'Admin Console. Consultez la section Surveiller les solutions FileMaker Data API.

Client API REST

1

6

Serveur Web

2

5

Moteur FileMaker Data API

3

4

Serveur de base de données

1. Un client API REST envoie un appel FileMaker Data API (requête HTTPS) au serveur Web sur le port HTTPS (port 443). Il est inutile d'installer ou d'exécuter FileMaker Pro Advanced.

2. Le serveur Web achemine la requête via le module serveur Web FileMaker jusqu'au moteur FileMaker Data API.
3. Le moteur FileMaker Data API convertit la requête HTTPS (URL et données JSON) en un format que le composant serveur de base de données peut comprendre, puis envoie des demandes de données à partir de la base de données hébergée par le serveur de base de données.

La disponibilité des ports 3000 et 8989 est indispensable pour un bon fonctionnement du moteur FileMaker Data API.

4. Le serveur de base de données renvoie les données FileMaker demandées au moteur FileMaker Data API.

La disponibilité du port 5003 est indispensable pour un bon fonctionnement du serveur de base de données.

5. Le moteur FileMaker Data API convertit les données FileMaker en une réponse HTTPS (URL avec données JSON) pour répondre à l'appel, retransférant ainsi les données au serveur Web.
6. Le serveur Web envoie la réponse HTTPS au client API REST qui en fait la demande.

Si vous ne maîtrisez pas bien les API REST, envisagez les solutions suivantes pour publier vos données FileMaker sur Internet.

FileMaker WebDirect^™ : les utilisateurs Web se connectent à votre base de données hébergée pour visualiser, modifier, trier ou rechercher des enregistrements en fonction des droits d'accès que vous leur donnez. Ils n'ont pas besoin d'installer d'autres logiciels. Un navigateur Web compatible et un accès à Internet ou à un intranet suffisent. L'interface utilisateur ressemble à la version bureau de l'application FileMaker Pro Advanced. Les pages Web et les formulaires sur lesquels l'utilisateur Web interagit dépendent des modèles et des affichages définis dans la base de données FileMaker Pro Advanced.

Consultez le Guide FileMaker WebDirect.

Publication statique : si vos données ne font pas souvent l'objet d'une modification ou si vous ne souhaitez pas que les utilisateurs puissent se connecter directement à votre base de données, envisagez la publication statique. Avec cette dernière, vous exportez des données FileMaker Pro Advanced pour créer une page Web que vous pouvez ensuite personnaliser à l'aide du langage HTML. Ainsi, la page Web n'est pas modifiée lorsque la base de données l'est, et les utilisateurs ne se connectent pas à votre base de données.

Consultez la section Publication de données sur des pages Web statiques dans l'Aide FileMaker Pro Advanced.

Publication Web personnalisée : pour intégrer votre base de données FileMaker à un site Web personnalisé, utilisez les technologies de Publication Web personnalisée fournies par FileMaker Server.

Consultez le Guide de la Publication Web personnalisée FileMaker Server.

Vous pouvez créer une base de données FileMaker Pro Advanced et l'utiliser avec FileMaker Data API ou utiliser une base de données existante. Si vous créez une base de données, envisagez de concevoir les modèles et rubriques nécessaires à votre solution FileMaker Data API. Si vous utilisez une base de données existante, envisagez de créer un modèle spécifique à votre solution FileMaker Data API.

Lorsque vous accédez à des données d'enregistrement, les appels FileMaker Data API nécessitent l'indication d'un modèle. FileMaker Data API utilise la vue par défaut définie pour le modèle que vous avez spécifié.

Indiquez un modèle qui définit la Vue Formulaire comme vue par défaut. Si au contraire vous utilisez un modèle qui définit la vue Tableau comme vue par défaut, FileMaker Data API ne sera en mesure d'obtenir que les données du premier enregistrement lié.

FileMaker Data API nécessite la connexion de votre code d'API REST à une session de base de données au moyen d'un compte protégé par mot de passe. Affectez des mots de passe aux comptes de base de données utilisés pour l'accès de l'API REST ou utilisez un fournisseur de service OAuth pour ces comptes.

Remarques

• Au moment de définir les noms des comptes et les mots de passe des solutions FileMaker Data API, utilisez des caractères ASCII imprimables, par exemple a-z, A-Z et 0-9. Pour sécuriser davantage encore les noms des comptes et les mots de passe, intégrez des caractères de ponctuation du type « ! » et « % » mais n'utilisez pas les deux points. Consultez l'Aide FileMaker Pro Advanced.
• Pour les bases de données hébergées par FileMaker Cloud, vous devez utiliser des comptes FileMaker ID. Consultez la documentation FileMaker Cloud dans le Centre de documentation produit.

Vous devez activer le privilège étendu fmrest, Accès via FileMaker Data API, dans chaque base de données à laquelle vous souhaitez accéder avec FileMaker Data API. Si vous n'activez pas le privilège étendu fmrest, les applications d'API REST ne pourront pas utiliser FileMaker Data API pour accéder à la base de données, même si celle-ci est hébergée.

Remarque :Pour des raisons de sécurité, activez uniquement le privilège étendu fmrest dans les jeux de privilèges des comptes auxquels vous souhaitez autoriser l'accès via FileMaker Data API.

Consultez la section « Modification des privilèges étendus » de l'Aide FileMaker Pro Advanced.

FileMaker Data API fournit une API REST pour accéder aux données des bases de données hébergées. Avec FileMaker Data API, votre code peut :

• obtenir des informations sur l'hôte ; par exemple, des informations sur le produit et les noms des bases de données hébergées. Consultez la section Obtenir des métadonnées.
• obtenir des informations sur une base de donnés hébergée ; par exemple, les noms de script, les noms de modèle ou les métadonnées de modèle, y compris les noms de rubrique, les noms de liste de valeurs et le contenu des listes de valeurs. Consultez la section Obtenir des métadonnées.
• se connecter à une base de données hébergée ou s'en déconnecter. Consultez la section Se connecter à une base de données ou s'en déconnecter.
• créer, modifier, dupliquer, supprimer ou obtenir un enregistrement ou une plage d'enregistrements. Consultez la section Utiliser les enregistrements.
• exécuter des requêtes. Consultez la section Exécuter une requête.
• définir des valeurs de rubrique de type Global. Consultez la section Définir des valeurs de rubrique de type Global.
• exécuter des scripts FileMaker. Consultez la section Scripts FileMaker et FileMaker Data API.
• uploader des données dans des rubriques Conteneur. Consultez la section Uploader des données de conteneur.
• accéder aux données dans des tables FileMaker externes. Consultez la section Se connecter à une source de données externe.
• utiliser un modèle différent pour les données de réponse au moment d'obtenir un enregistrement ou une plage d'enregistrements. Consultez les sections Obtenir un enregistrement, Obtenir une plage d'enregistrements et Exécuter une requête.

FileMaker Data API ne prend pas en charge :

• l'accès aux données dans des sources de données ODBC externes.
• les plug-ins FileMaker.
• l'activation des déclencheurs de script par l'utilisateur. Une solution FileMaker Data API peut activer des déclencheurs de script uniquement en exécutant un script FileMaker.
• l'accès au système de fichiers de la machine serveur. Par exemple, FileMaker Data API ne prend pas en charge la fonction Obtenir(CheminTemporaire) de FileMaker Pro Advanced. Cette fonction renvoie une chaîne vide lorsqu'elle est utilisée avec FileMaker Data API. Il est possible de stocker les fichiers dans une rubrique Conteneur, mais sans accès au système de fichiers du serveur.

FileMaker Data API renvoie les données de rubrique telles qu'elles sont stockées dans la base de données, et non telles qu'elles sont affichées dans FileMaker Pro Advanced.

La référence à FileMaker Data API fournit des informations détaillées sur tous les appels pris en charge par FileMaker Data API.

Remarque :Pour afficher cette référence, vérifiez que l'accès à FileMaker Data API a été activé dans l'Admin Console. Consultez le Centre de documentation produit.

• Pour afficher la référence sur un hôte FileMaker Cloud, ouvrez un navigateur et saisissez l'URL
  https://hôte/fmi/data/apidoc/
  où hôte correspond à l'adresse IP ou au nom de l'hôte FileMaker Cloud
• Pour afficher la référence sur un ordinateur maître exécutant FileMaker Server, ouvrez un navigateur et saisissez l'URL
  https://localhost/fmi/data/apidoc/
• Pour afficher la référence sur un ordinateur distant exécutant FileMaker Server, ouvrez un navigateur et saisissez l'URL
  https://hôte/fmi/data/apidoc/
  où [hôte] est l'adresse IP ou le nom d'hôte de l'ordinateur maître exécutant FileMaker Server.

• Pour FileMaker Server installé sur un serveur Windows, les fichiers de référence se trouvent dans le dossier
  [disque]:\Program Files\FileMaker\FileMaker Server\Documentation\Data API Documentation
  où [disque] est le disque sur lequel se trouve le déploiement FileMaker Server.

  Si vous effectuez votre installation sur un emplacement sous Windows autre que celui par défaut, votre emplacement d'installation remplace la première partie du chemin d'installation par défaut
  [disque]:[emplacement_installation]\FileMaker\FileMaker Server\Documentation\Data API Documentation

• Pour FileMaker Server installé sur un serveur macOS, les fichiers de référence se trouvent dans le dossier
  /Bibliothèque/FileMaker Server/Documentation/Data API Documentation

Remarques

• Pour afficher les variables des URL dans les fichiers de référence, utilisez un mot-clé précédé du signe deux points (:). Par exemple : :base
• Dans ce guide, les variables des URL sont indiquées en italique. Par exemple : nom-base

• La longueur maximale de l'identificateur URI de FileMaker Data API dépend parfois du système d'exploitation, du serveur Web et du navigateur Web. Pour une utilisation optimale sur toutes les plateformes, limitez cette longueur à 2 000 caractères.
• Certaines URL ou parties d'URL ne sont pas sensibles à la casse. Néanmoins, en règle générale, traitez-les comme si elles l'étaient. Par exemple, si vous utilisez un nom de base de données en minuscules pour vous connecter à une session de base de données, continuez à utiliser un nom de base de données en minuscules pour les URL suivantes qui transmettent le même jeton de session. Dans le cas contraire, vous pourriez recevoir un message d'erreur indiquant un jeton non valide.
• Les chaînes des URL doivent utiliser le codage URL également appelé %-encodage, ce qui est normal pour les requêtes HTTP. Par exemple, pour indiquer un nom de modèle qui inclut un caractère barre oblique, vous devez spécifier ce dernier sous forme de valeur encodée : « %2F ».
• Les valeurs de données de chaîne définies dans les paramètres, dans le corps de la requête, doivent utiliser le codage UTF-8.
• En règle générale, FileMaker Data API traite les valeurs de données numériques comme si elles étaient au format virgule flottante double précision (binaire 64). Utilisez le format de données correspondant au langage de programmation choisi. (Les valeurs de données numériques ne doivent pas être mises entre guillemets et ne doivent pas utiliser l'encodage URL.)
• Les valeurs de données des rubriques de type nombre, date, heure et horodatage suivent les mêmes limites que celles définies par FileMaker Pro Advanced. Consultez l'Aide FileMaker Pro Advanced.
• Les rubriques et tables externes que vous spécifiez doivent figurer dans le modèle indiqué.
• Pour spécifier des rubriques liées, utilisez la syntaxe portalData.

  Remarque :La syntaxe nomtable::rubrique-liée(nombre-répétition).id-enregistrement issue de la publication précédente est encore prise en charge, mais nous vous conseillons d'utiliser la syntaxe portalData.

• Dans le corps de réponse, FileMaker Data API renvoie uniquement le nom des rubriques de la table active et le nom complet des rubriques des tables liées. Pour les rubriques de table externe, le nom entièrement qualifié utilise le nom de la table externe si cette dernière a été nommée dans l'Inspecteur ; sinon, le nom entièrement qualifié utilise le nom de l'occurrence de table.
• Pour les données de rubrique Conteneur, FileMaker Data API renvoie à l'objet de données de conteneur une URL contenant la référence au chemin.

Un script FileMaker est une ou plusieurs instructions (actions de script) définies pour automatiser les tâches répétitives ou difficiles. Lorsque les scripts FileMaker sont utilisés avec FileMaker Data API, ils permettent aux services Web d'exécuter plusieurs tâches ou une série de tâches. Consultez la section Exécution de scripts FileMaker.

Pour visualiser les actions de script acceptées par FileMaker Data API, ouvrez l'Espace de travail de script de FileMaker Pro Advanced, cliquez sur le bouton Compatibilité, puis sélectionnez FileMaker Data API. Les actions de script non grisées sont prises en charge par FileMaker Data API. Certaines actions de script fonctionnent différemment ou peuvent ne pas être prises en charge par FileMaker Data API. Consultez l'Aide FileMaker Pro Advanced.

Les scripts exécutés par FileMaker Data API ne peuvent pas exécuter les scripts dans d'autres fichiers FileMaker sauf si les fichiers sont hébergés sur le même hôte. Le privilège étendu fmrest doit être activé pour les autres fichiers FileMaker.

Dans FileMaker Pro Advanced, les scripts et actions des utilisateurs (par exemple, l'utilisateur cliquant dans une rubrique) peuvent activer des déclencheurs de script. Toutefois, dans les solutions FileMaker Data API, seuls les scripts peuvent activer des déclencheurs de script. Pour plus d'informations sur les déclencheurs de script, consultez l'Aide FileMaker Pro Advanced.

Remarques

• Tenez compte de la quantité de données et du nombre d'enregistrements qu'un script peut renvoyer, puis définissez les scripts en conséquence. Dans FileMaker Pro Advanced, un script peut renvoyer tous les enregistrements d'une table ou d'un jeu d'enregistrements trouvés. Toutefois, si un script renvoie tous les enregistrements d'une table, un service Web qui tente de tous les traiter peut se heurter à un problème de mémoire.
• Utilisez les comptes et privilèges pour restreindre l'ensemble des scripts qu'un service Web exécute. Vérifiez que les scripts contiennent exclusivement des actions de script compatibles avec le Web et donnez uniquement accès aux scripts pouvant être utilisés depuis un service Web.
• Pensez aux effets secondaires des scripts qui exécutent une combinaison d'actions contrôlées par des privilèges d'accès. Par exemple, si un script comporte une action visant à supprimer des enregistrements et qu'un service Web ne se connecte pas avec un compte autorisant la suppression d'enregistrements, le script n'exécutera pas l'action Supprimer des enregistrements. L'exécution du script peut néanmoins se poursuivre et mener à des résultats inattendus.
• Dans l'Espace de travail de script, accordez les privilèges d'accès intégral à un script afin d'effectuer des actions auxquelles des utilisateurs n'ont normalement pas accès. Par exemple, vous pouvez empêcher les utilisateurs de supprimer des enregistrements avec leurs comptes et privilèges, mais les autoriser à exécuter un script visant à supprimer certains enregistrements dans les conditions définies dans le script.
• Les points de terminaison FileMaker Data API sont destinés à valider immédiatement les modifications apportées aux données, mais les scripts peuvent laisser des enregistrements non validés. Par exemple, une session pourrait exécuter un script qui modifie un enregistrement mais ne le valide pas ; la session suivante obtiendrait alors un message d'erreur lors de la tentative de modification du même enregistrement. Ou bien, dans une seule session, un script pourrait modifier un enregistrement, puis créer une nouvelle fenêtre, puis appeler un second script qui tente de modifier le même enregistrement. Assurez-vous de vérifier les résultats de script et l'absence d'erreurs de script.
• Tout script modifiant des données doit inclure l'action de script Valider enreg./requêtes, car toutes les modifications apportées aux données ne sont pas accessibles tant que les données ne sont pas enregistrées sur le serveur. Ceci inclut des actions de script telles que Couper, Copier ou Coller. De nombreuses actions de script uniques doivent être converties en script pour inclure l'action Valider enreg./requêtes. Lors de la conception de scripts destinés à être exécutés depuis un service Web, incorporez l'action Valider enreg./requêtes en fin de script pour garantir l'enregistrement de toutes les modifications.
• Ouvrez les scripts susceptibles d'être exécutés par les utilisateurs Web et vérifiez qu'ils s'exécutent correctement lorsque la base de données est hébergée en tant que solution FileMaker Data API. Vérifiez que le script utilise uniquement les actions de script prises en charge par FileMaker Data API, comme décrit plus haut.

Les appels FileMaker Data API utilisent les composants ci-après.

FileMaker Data API utilise un jeton d'accès pour définir une connexion à une base de données. Ce jeton d'accès doit figurer dans l'en-tête de tous les appels ultérieurs à la base de données hébergée. Il est valide jusqu'à ce que vous vous déconnectiez d'une session de base de données ou pendant une durée de 15 minutes après le dernier appel ayant permis de le spécifier. (Tant que ce jeton est valide, chaque appel qui le spécifie réinitialise le compteur de délai d'expiration de session et le remet à zéro.)

FileMaker Data API prend en charge la récupération des métadonnées suivantes :

• les informations sur l'hôte. Consultez la section Obtenir des informations sur le produit.
• les noms des bases de données hébergées. Consultez la section Obtenir des noms de base de données.
• les noms des scripts FileMaker disponibles dans une base de données hébergée. Consultez la section Obtenir des noms de script.
• les noms des modèles disponibles dans une base de données hébergée. Consultez la section Obtenir des noms de modèle.
• les métadonnées supplémentaires relatives à un modèle spécifique dans une base de données hébergée. Consultez la section Obtenir des métadonnées de modèle.

Pour uploader des données de conteneur, utilisez une méthode HTTP POST avec le point de terminaison API containers en indiquant le nom de la base de données, le nom du modèle, l'identifiant de l'enregistrement, le nom de la rubrique et une répétition de rubrique.

Pour exécuter une requête, utilisez une méthode HTTP POST avec le point de terminaison API _find en indiquant le nom de la base de données, le modèle et des informations supplémentaires (rubriques de requête et critères, ordre de tri, enregistrement de départ et nombre d'enregistrements). Vous pouvez également indiquer des informations de table externe pour limiter le nombre d'enregistrements liés renvoyés.

Pour définir les valeurs des rubriques de type Global, utilisez une méthode HTTP PATCH avec le point de terminaison API globals en indiquant le nom de la base de données.

FileMaker Data API peut exécuter des scripts FileMaker :

• en utilisant une méthode HTTP GET avec le point de terminaison API script. Consultez la section Exécuter un script.
• dans le cadre d'une autre requête en insérant les paramètres script.prerequest, script.presort et script dans le corps de la requête. Consultez la section Exécuter un script avec une autre requête.

Quand une erreur se produit, FileMaker Data API renvoie :

• un code d'état de niveau HTTP 400 pour les erreurs HTTP standard
• un code d'état HTTP 500 pour les erreurs FileMaker 

1. Passez en revue toutes les étapes décrites dans la section Préparer les bases de données pour un accès via FileMaker Data API.
2. Assurez-vous que l'accès via FileMaker Data API a été activé et correctement configuré dans l'Admin Console. Consultez le Centre de documentation produit.
3. Vérifiez le bon fonctionnement du serveur Web et du moteur FileMaker Data API.

4. Cryptez les communications.

   FileMaker Data API impose à vos applications d'API REST d'utiliser une connexion HTTPS. Les connexions HTTPS utilisent le cryptage SSL (Secure Sockets Layer) pour les communications.

   FileMaker Server fournit un certificat SSL standard signé par FileMaker, Inc. qui ne vérifie pas le nom du serveur. Le certificat par défaut de FileMaker est uniquement destiné à des fins de tests. Un certificat SSL personnalisé est requis à des fins de production. Consultez le Guide d'installation et de configuration de FileMaker Server.

   Le langage ou la technologie que vous utilisez pour appeler FileMaker Data API doit prendre en charge le protocole TLS (Transport Layer Security) v1.2 pour communiquer avec le serveur Web.

Avant de mettre votre solution FileMaker Data API en production, vérifiez qu'elle fonctionne comme prévu.

• Testez les fonctions telles que la recherche, l'ajout et la suppression des enregistrements avec différents comptes et de jeux privilèges.
• Vérifiez que les jeux de privilèges fonctionnent comme prévu en les testant avec différents comptes. Faites en sorte que des utilisateurs non autorisés ne puissent pas accéder à vos données ni les modifier.
• Testez le comportement de votre solution et vérifiez qu'il est identique d'un système d'exploitation à l'autre.

L'administrateur serveur peut utiliser l'Admin Console pour démarrer ou arrêter le moteur FileMaker Data API, surveiller les clients FileMaker Data API, suivre l'utilisation des appels FileMaker Data API et télécharger le fichier journal de FileMaker Data API.

Utilisez un connecteur de données Web pour définir une connexion entre une base de données FileMaker hébergée et Tableau. Un connecteur de données Web est un exemple de mise en œuvre qui accepte les appels d'API REST au format JSON. Cette connexion utilise FileMaker Data API pour importer des données depuis une base de données FileMaker hébergée dans Tableau.

Utilisez FileMaker Server ou un produit FileMaker Cloud pour héberger la base de données FileMaker. Ces hôtes peuvent être intégrés aux produits Tableau suivants :

• Tableau Desktop, version 10 ou ultérieure pour Windows ou macOS. Utilisez le Connecteur de données Web FileMaker pour Tableau Desktop pour définir une connexion à Tableau Desktop.

• Tableau Server, installé sur site ou hébergé par le client. Hébergez le Connecteur de données Web FileMaker pour Tableau Server sur Tableau Server.

• Tableau Cloud. Exécutez une instance de Tableau Server pour procurer des données à Tableau Cloud. Hébergez le Connecteur de données Web FileMaker pour Tableau Server sur Tableau Server.

• Tableau Online. Nécessite l'utilisation de Tableau Bridge.

Le Connecteur de données Web FileMaker pour Tableau nécessite :

• Une base de données FileMaker Pro Advanced protégée par mot de passe et contenant les données à importer. La base de données doit être hébergée sur FileMaker Server ou un hôte FileMaker Cloud. FileMaker Server et FileMaker Cloud for AWS prennent en charge l'authentification de fichier FileMaker et l'authentification OAuth. FileMaker Cloud requiert l'authentification FileMaker ID.

• Un point de terminaison API REST valide.

  Avec FileMaker Server, ce point de terminaison est un point de connexion HTML qui fournit les informations nécessaires aux services Web. Ce point de terminaison a pour format
  https://<nomhôte>/fmi/data/version/tableau/fm_connector.html
  où nomhôte correspond au nom d'hôte entièrement qualifié de votre déploiement FileMaker Server.

  Par exemple :

  https://monserveur.monentreprise.com/fmi/data/v1/tableau/fm_connector.html

• Un certificat SSL personnalisé valide sur l'hôte. Le Connecteur de données Web FileMaker pour Tableau n'autorisera pas l'importation des données sans un certificat SSL personnalisé valide.

  Remarque :Si votre hôte utilise un certificat SAN (autre nom de l'objet), le nom d'hôte doit correspondre au nom commun utilisé dans ce certificat.

Pour définir le modèle servant à l'importation et pour activer la base de données permettant d'accéder à FileMaker Data API, suivez les étapes indiquées dans la section Préparer les bases de données pour un accès via FileMaker Data API.

Remarque :Pour importer des données dans Tableau, la table doit contenir au moins un enregistrement et des données d'enregistrement.

Les types de rubrique FileMaker suivants sont importés sous forme de types de données Tableau.

Les types de rubrique FileMaker suivants ne sont pas pris en charge au moment de l'importation dans Tableau :

• rubriques Conteneur
• rubriques de type Statistique. Vous pouvez créer une rubrique de type Statistique dans Tableau d'après les données que vous importez depuis FileMaker.
• rubriques Calcul. Vous pouvez créer une rubrique de type Calcul dans Tableau d'après les données que vous importez depuis FileMaker.
• données de graphique
• données provenant de tables externes FileMaker Pro Advanced. Pour importer des données depuis des enregistrements liés, créez un modèle FileMaker Pro Advanced d'après la table liée, ou importez des données dans Tableau depuis des tables FileMaker Pro Advanced distinctes, puis créez un lien entre elles dans Tableau.
• répétitions de rubrique dans lesquelles l'affichage des rubriques multivaluées pour Afficher les répétitions intègre des valeurs multiples. Une seule répétition est acceptée.
• valeurs non numériques dans les rubriques de type Nombre. Si Tableau détecte des valeurs non numériques dans des rubriques de type Nombre, les données ne sont pas importées.

N'utilisez aucun mot réservé comme noms de rubrique dans FileMaker Pro Advanced.

Suivez les instructions de l'Aide en ligne du produit Tableau qui décrivent l'utilisation des connecteurs de données Web.

Par exemple, pour configurer la connexion des données avec le Connecteur de données Web FileMaker Server pour Tableau Desktop :

1. Dans Tableau Desktop, sous Connexion (à gauche de l'écran), choisissez Plus > Connecteur de données Web.
2. Saisissez l'URL de votre point de terminaison FileMaker Server.
   https://<nomhôte>/fmi/data/v1/tableau/fm_connector.html
   où <nomhôte> correspond au nom d'hôte entièrement qualifié de FileMaker Server.

3. Dans la boîte de dialogue Importer des données depuis un fichier FileMaker :

   • Connectez-vous à la base de données FileMaker Pro Advanced en saisissant les informations suivantes ou en utilisant un fournisseur d'identité OAuth.

     • Nom de la base de données source : nom de la base de données FileMaker Pro Advanced
     • Nom du modèle source : nom du modèle FileMaker Pro Advanced
     • Nom du compte : nom du compte FileMaker Pro Advanced détenant le privilège fmrest
     • Mot de passe : mot de passe du compte FileMaker Pro Advanced
   • Sélectionnez Activer l'actualisation incrémentielle pour activer l'actualisation incrémentielle.
4. Cliquez sur Importer des données FileMaker.

Tableau importe les données. La durée du traitement dépend du nombre d'enregistrements importés, de la charge du serveur et du débit du réseau. Tableau établit une correspondance entre les noms de rubrique et données FileMaker Pro Advanced et les dimensions et mesures. Les données de type Chaîne de caractères sont habituellement mises en correspondance avec les dimensions, et les données numériques avec les mesures. Cette mise en correspondance intervient automatiquement au moment de l'importation. Toutefois, vous pouvez la personnaliser.