Obtenir des métadonnées

Pour récupérer les informations de métadonnées d'une table, utilisez la méthode HTTP GET.

Utilisez le mot-clé $metadata avec la racine du service de base de données pour demander une liste complète des métadonnées de la base de données.

Composant Description

Méthode HTTP

GET

URL

https://hôte/fmi/odata/version/nom-base/$metadata

hôte : nom d'hôte FileMaker Cloud ou FileMaker Server.

version : version OData, toujours v4.

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

Exemple : /fmi/odata/v4/GestionDeContenu/$metadata

Informations FileMaker

Pour fournir des informations concernant les tables FileMaker de la base de données, des annotations (informations non définies dans la norme OData) sont ajoutées aux résultats des métadonnées, telles que le numéro de version du produit FileMaker.

Les annotations ci-dessous ont une valeur booléenne « true » si elles sont présentes. Sinon, la valeur est « false ».

  • AutoGenerated : indique si la valeur de rubrique est automatiquement générée par FileMaker Pro.

  • Index : indique si les valeurs de rubrique sont indexées.

  • VersionID : indique si la rubrique est une rubrique Horodatage et une nouvelle valeur d'horodatage est générée lorsque l'enregistrement est modifié.

  • Global : indique si la rubrique contient une valeur globale.

  • Calculation : indique si la rubrique est de type Calcul.

  • Summary : indique si la rubrique est de type Statistique.

Autres annotations :

  • MaxRepetitions : une valeur entière indiquant le nombre maximum de répétitions définies pour une rubrique multivaluée. Si cette annotation n'est pas présente, la rubrique n'est pas une rubrique multivaluée.

  • ExternalSecurePath : une chaîne de caractères indiquant le chemin d'accès relatif spécifié pour le stockage sécurisé d'une rubrique Conteneur.

  • BestRowID : contient toujours ROWID, une rubrique système qui est explicitement incluse dans un jeu de résultats en spécifiant $select=ROWID. Cette valeur est identique à celle renvoyée par la fonction Obtenir ( IDEnreg ) pour un enregistrement.

  • RowVersion : contient toujours ROWMODID, une rubrique système qui est explicitement incluse dans un jeu de résultats en spécifiant $select=ROWMODID. Cette valeur est identique à celle renvoyée par la fonction Obtenir ( NombreModificationsEnreg ) pour un enregistrement.

Important  OData exige que chaque table définisse une clé primaire. OData utilise des rubriques qui ne sont pas vides et exigent une valeur unique comme clé primaire. Par conséquent, si de telles rubriques ne sont pas définies pour vos tables, la rubrique système ROWID est utilisée comme clé primaire. La rubrique système ROWID contient la même valeur que celle renvoyée par la fonction Obtenir ( IDEnreg ) pour l'enregistrement.