Créer une table

Pour créer une nouvelle table, utilisez la méthode HTTP POST. Le corps de POST doit contenir la représentation d'une table valide unique, incluant un identifiant qui est le nom de la table.

Composant Description

Méthode HTTP

POST

URL

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

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/GestionDeContact/FileMaker_Tables

Paramètres

Exemple JSON :

Copier

  "tableName": "Société",  
  "fields": [
    {
      "name": "ID de la société",  
      "type": "int",  
      "primary": true 
    }, 
    {
      "name": "ID de l'utilisateur"
      "type": "varchar(20)",
      "unique": true,
      "default": "CURRENT_USER" 
    },
    {
      "name": "Nom de la société",
      "type": "varchar(100)"
      "nullable": false 
    },
    {
      "name": "Remarques"
      "type": "varchar(2000)",
      "global": true 
    },
    {
      "name": "Contrat signé",
      "type": "blob",
      "externalSecurePath": "ContactMgmt/" 
    }
  ]
}

Exemple Atom :

Copier
<TableDefinition tableName="Société">
   <FieldDefinition name="ID de la société" type="int" primary="true"/>
   <FieldDefinition name="ID de l'utilisateur" type="varchar(20)" unique="true" default="CURRENT_USER"/>
   <FieldDefinition name="Nom de la société" type="varchar(100)" nullable="false"/>
   <FieldDefinition name="Remarques" type="varchar(2000)" global="true"/>
</TableDefinition>

Informations FileMaker

  • FileMaker_Tables est une table système utilisée pour la création, la modification et la suppression de tables. Le paramètre type est l'un des suivants : NUMERIC, DECIMAL, INT, DATE, TIME, TIMESTAMP, VARCHAR, CHARACTER VARYING, BLOB, VARBINARY, LONGVARBINARY ou BINARY VARYING.

  • Les répétitions sont spécifiées entre crochets après le type (par exemple, "INT[4]"). Vous pouvez spécifier la longueur maximale d'une rubrique Texte entre des parenthèses (par exemple, "VARCHAR(200)").

  • Lorsque vous créez une nouvelle table et indiquez NULL comme type par défaut, la valeur de mot-clé affiche TIMESTAMP par défaut.

  • Les paramètres facultatifs suivants sont utilisés avec le nom de la rubrique et le type de rubrique :

    • "primary" : « true » ou « false » (si la rubrique est une clé primaire ; la valeur par défaut est « false »).

    • "unique" : « true » ou « false » (si la rubrique doit avoir une valeur unique ; la valeur par défaut est « false »).

    • "global" : « true » ou « false » (si la rubrique est de type Global ; la valeur par défaut est « false »).

    • "default" : chaîne de caractères contenant un mot-clé approprié pour le type de données ; mots-clés valides : USER, USERNAME, CURRENT_USER, CURRENT_DATE, CURDATE, CURRENT_TIME, CURTIME, CURRENT_TIMESTAMP et CURTIMESTAMP.

    • "externalSecurePath" (rubriques Conteneur uniquement) : chaîne de caractères contenant un chemin d'accès relatif pour les fichiers sécurisés dans "externalSecurePath". Excluez la partie "[emplacement base de données]/" du répertoire de la base. Assurez-vous de définir ce paramètre pour chaque base de données FileMaker Pro dans FileMaker Pro. Consultez la section Configuration de rubriques Conteneur afin de stocker des données en externe dans l'aide de FileMaker Pro.