Requêtes par lots

OData prend en charge les requêtes par lots qui vous permettent de réaliser plusieurs opérations dans une seule et même requête HTTP. Vous pouvez effectuer des opérations au niveau des enregistrements, telles que la création, la modification, la suppression et la recherche d'un enregistrement. Vous pouvez également créer un ensemble d'opérations atomiques dont l'exécution sera indépendante des autres processus.

Composant Description

Méthode HTTP

POST

URL

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

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.

$batch : nom du lot.

Exemple : /fmi/odata/v4/GestionDeContact/$batch
Paramètres

Exemple :

Copier 
POST https://hôte/fmi/odata/v4/GestionDeContact/$batch
OData-Version: 4.0
Content-Type: multipart/mixed; boundary=batch_36522ad7-fc75-4b56-8c71-56071383e77b
Authorization: FMID Jeton_Claris_ID
Content-Type: application/http

GET https://hôte/fmi/odata/v4/GestionDeContact/Contacts(1) HTTP/1.1

--batch_36522ad7-fc75-4b56-8c71-56071383e77b
Content-Type: multipart/mixed; boundary=changeset_77162fcd-b8da-41ac-a9f8-9357efbbd

--changeset_77162fcd-b8da-41ac-a9f8-9357efbbd
Content-Type: application/http
Content-ID: 1

POST https://hôte/fmi/odata/v4/GestionDeContact/Contacts HTTP/1.1
Content-Type: application/json
Content-Length: 162

{
  "CléPrimaire": "PMARTIN",
  "Nom": "Pierre Martin",
  "Zone": 1,
  "Fonction": "Directeur des ventes pour la région Sud-Ouest",
  "Société": "Exemple, Inc.",
  "SiteWeb": "www.exemple.com"
}

--changeset_77162fcd-b8da-41ac-a9f8-9357efbbd
Content-Type: application/http
Content-ID: 2

PATCH https://hôte/fmi/odata/v4/GestionDeContact/Contacts(1) HTTP/1.1
Content-Type: application/json
Content-Length: 32

{
  "Fonction": "Ingénieur logiciel"
}

--changeset_77162fcd-b8da-41ac-a9f8-9357efbbd
Content-Type: application/http
Content-ID: 3

DELETE https://hôte/fmi/odata/v4/GestionDeContact/Contacts(7) HTTP/1.1

--changeset_77162fcd-b8da-41ac-a9f8-9357efbbd--
--batch_36522ad7-fc75-4b56-8c71-56071383e77b
Content-Type: application/http

GET https://hôte/fmi/odata/v4/GestionDeContact/Contacts(1) HTTP/1.1

--batch_36522ad7-fc75-4b56-8c71-56071383e77b--

Informations FileMaker

  • Indiquez multipart/mixed dans l'en-tête Content-Type et incluez une spécification de limite.

  • Le corps d'une requête par lots se compose d'une série de requêtes individuelles et d'ensembles de modifications.

  • Les requêtes par lots ne prennent pas en charge le référencement d'enregistrements récemment créés en utilisant $<Content-ID> dans un ensemble de modifications.