Obtenir un seul enregistrement

Format 1 : /fmi/data/version/databases/nom-base/layouts/nom-modèle/records/id-enregistrement

Format 2 : /fmi/data/version/databases/nom-base/layouts/nom-modèle/records/id-enregistrement?portal=["nom-table-n", ...] &_offset.nom-table=enregistrement-départ &_limit.nom-table=nombre-enregistrements

version : la version FileMaker Data API demandée peut utiliser v1, v2 ou vLatest

• version 1 (v1) : la structure des données de table externe renvoyées dépend du paramètre d'affichage (Affichage sous forme de formulaire ou Affichage sous forme de tableau) du modèle spécifiquement utilisé.

  • Affichage sous forme de formulaire : renvoie tous les enregistrements liés

  • Affichage sous forme de tableau : renvoie le premier enregistrement lié

  Remarque  Le fait de modifier le paramètre d'affichage modifie également la structure des données de la table externe pour la valeur renvoyée.

• version 2 (v2) : la structure des données de la table externe renvoyées est basée sur un Affichage sous forme de formulaire.

• dernière version (vLatest) : le comportement est basé sur la dernière version de l'API.

nom-base : nom de la base de données hébergée

nom-modèle : nom du modèle servant de contexte à l'obtention de l'enregistrement

id-enregistrement : identifiant de l'enregistrement à obtenir

Pour les tables externes :

• La partie de l'URL correspondant à la table externe est facultative. Si l'option portal est omise et que le modèle inclut des tables externes, l'appel renverra les enregistrements liés de toutes les tables externes du modèle. Ainsi, pour de meilleures performances sur les modèles avec tables externes, utilisez l'option portal afin de spécifier uniquement les tables externes dont vous avez besoin pour obtenir des enregistrements liés.

• Seuls les enregistrements liés qui peuvent être consultés dans une table externe sont renvoyés. Dans la boîte de dialogue Table externe de FileMaker Pro, ces options sont susceptibles d'affecter les enregistrements qui peuvent être renvoyés :

  • Barre de défilement vertical - Si cette option est sélectionnée, tous les enregistrements qui peuvent être affichés grâce au défilement sont renvoyés. En cas de désélection, seul le nombre d'enregistrements entre Rangée initiale et Nombre de rangées (celles visibles sans défilement) est renvoyé.

  • Filtrer les enregistrements de la table externe - Si cette option est sélectionnée, seuls les enregistrements filtrés sont renvoyés.

• nom-table-n est une table externe contenant les enregistrements liés. Un nom de table externe peut être le nom de l'objet tel qu'indiqué dans l'Inspecteur de FileMaker Pro ou le nom de la table liée. Vous pouvez indiquer plusieurs noms de table externe.

• Pour _offset.nom-table-n, enregistrement-départ est le numéro d'enregistrement du premier enregistrement de table externe de la plage d'enregistrements liés. Si l'option n'est pas définie, la valeur par défaut est 1.

• Pour _limit.nom-table-n, nombre-enregistrements précise le nombre maximal d'enregistrements liés à renvoyer. Si l'option n'est pas définie, la valeur par défaut est 50.

Autres paramètres d'URL facultatifs :

• layout.response - Renvoie les données de réponse dans un modèle différent. Le modèle spécifié doit se rapporter à la même table de base que le modèle actuel. L'indication d'un modèle pour une autre table de base peut produire des résultats inattendus.

• dateformats - Spécifie le format des rubriques de date et d'horodatage. La valeur est 0 pour les formats américains, 1 pour les formats des paramètres régionaux du fichier ou 2 pour les formats ISO 8601. Si elle n'est pas définie, la valeur par défaut est 0.

• script.prerequest, script.presort, script - Exécute des scripts FileMaker dans le cadre de la requête. Consultez la section Exécuter un script avec une autre requête.

Authorization : Bearer jeton-session, où jeton-session est la valeur X-FM-Data-Access-Token unique de la session de base de données