Stapelanforderungen

OData unterstützt Stapelanforderungen, die es Ihnen ermöglichen, mehrere Operationen in einer einzigen HTTP-Anforderung durchzuführen. Sie können Operationen auf Datensatzebene verwenden, z. B. einen Datensatz erstellen, einen Datensatz bearbeiten, einen Datensatz löschen und einen Datensatz suchen. Alternativ können Sie eine Reihe von atomaren Operationen erstellen, die unabhängig von anderen Prozessen ablaufen.

Komponente Beschreibung

HTTP-Methode

POST

URL

https://host/fmi/odata/version/datenbankname/$batch

host – FileMaker Cloud- oder FileMaker Server-Hostname

version – die OData-Version, immer v4

datenbankname – der Name der bereitgestellten Datenbank

$batch - der Name des Stapels

Beispiel: /fmi/odata/v4/KontaktMgmt/$batch
Parameter

Beispiel:

Kopieren 
POST https://host/fmi/odata/v4/KontaktMgmt/$batch
OData-Version: 4.0
Content-Type: multipart/mixed; boundary=batch_36522ad7-fc75-4b56-8c71-56071383e77b
Authorization: FMID Claris_ID_Token
Content-Type: application/http

GET https://host/fmi/odata/v4/KontaktMgmt/Kontakte(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://host/fmi/odata/v4/KontaktMgmt/Kontakte HTTP/1.1
Content-Type: application/json
Content-Length: 162

{
  "Primärschlüssel": "BJONES",
  "Name": "Bob Jones",
  "Zone": 1,
  "Titel": "Vertriebsleiter Südwest",
  "Firma": "Beispiel GmbH.",
  "Website": "www.beispiel.de"
}

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

PATCH https://host/fmi/odata/v4/KontaktMgmt/Kontakte(1) HTTP/1.1
Content-Type: application/json
Content-Length: 32

{
  "Titel": "Softwareingenieur"
}

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

DELETE https://host/fmi/odata/v4/KontaktMgmt/Kontakte(7) HTTP/1.1

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

GET https://host/fmi/odata/v4/KontaktMgmt/Kontakte(1) HTTP/1.1

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

FileMaker-Informationen

  • Geben Sie den Content-Type-Header als multipart/mixed an und fügen Sie eine Begrenzungsangabe ein.

  • Der Datenteil einer Stapelanforderung besteht aus einer Reihe von Einzelanforderungen und Änderungssätzen.

  • Stapelanforderungen unterstützen nicht den Verweis auf neu erstellte Datensätze mit $<Content-ID> in einem Änderungssatz.