REST API-Datenverbindung - Automate_Evolve - Automate_Studio_Manager - Latest

Benutzerhandbuch zu Automate Evolve

Product type
Software
Portfolio
Integrate
Product family
Product
Automate > Automate Evolve
Automate > Automate Studio Manager
Version
Latest
Language
Deutsch
Product name
Automate Evolve
Title
Benutzerhandbuch zu Automate Evolve
Copyright
2024
First publish date
2018
ft:lastEdition
2024-05-23
ft:lastPublication
2024-05-23T16:24:42.750458

Schritt 1: REST-API-Verbindung im Bereich „Global“ oder „App“ erstellen

  1. Navigieren Sie auf globaler Ebene oder auf Anwendungsebene zu Verbindungen → Datenquellen.

  2. Definieren Sie eine neue REST-API-Verbindung.

  3. Geben Sie die Basis-API-URL und Authentifizierungsdaten an. Weitere Informationen finden Sie unter Datenbankverbindungen erstellen.

Schritt 2: Datenverbindung für die Lösung erstellen

Befolgen Sie die nachstehenden Schritte, um die Datenverbindung gemäß den erforderlichen Vorgängen (Erstellen, Lesen, Aktualisieren oder Löschen) und gemäß den vom API-System benötigten Daten zu konfigurieren.

  1. Erstellen Sie eine neue oder öffnen Sie eine vorhandene Formularlösung, und klicken Sie im Menüband der Lösung auf Datenverbindung hinzufügen.

  2. Geben Sie der Lösung einen Namen, und wählen Sie den Typ REST-API aus. Dadurch werden alle Datenquellen des Typs „REST-API“ angezeigt, die entweder im aktuellen Bereich „App“ oder im Bereich „Global“ vorhanden sind.

  3. So legen Sie die API-URL oder den REST-API-Endpunkt fest:

    1. Standardmäßig wird die Basis-API-URL angezeigt, wie sie beim Erstellen der Datenverbindung definiert wurde. Konfigurieren Sie diese URL je nach Bedarf, um Daten von einem bestimmten Endpunkt abzurufen.

    2. Klicken Sie auf die drei Punkte, um den URL-Generator zu öffnen und URL-Teile hinzuzufügen.

    3. Fügen Sie im Dialogfeld „URL-Generator“ nach Bedarf die URL für die Datenverbindung für diese Lösung hinzu. Dabei kann es sich um einen Festwert, einen Formularfeldwert oder beides handeln. Nachfolgend finden Sie ein Beispiel zum Abrufen bestimmter Produktdetails über die SAP HANA-API.

      1. Basis-URL wie in folgender Verbindung definiert: https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap

      2. Erster URL-Teil zur Angabe des Zugriffs auf die Produkt-API: /API_PRODUCT_SRV/A_Product/

      3. Zweiter URL-Teil zur Angabe der Produktnummer aus einem Formularfeld: ('[/my:myFields/my:Search_Product_Id]') HINWEIS: Dieser Wert entspricht der Spezifikation der SAP HANA-API, d. h. ('<<Produktnummer>>').

      4. Die endgültige URL sieht folgendermaßen aus:

        https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PRODUCT_SRV/A_Product/('[/my:myFields/my:Search_Product_Id]')

    Der Fallback auf die in der Datenverbindungsbibliothek definierte API-URL funktioniert, wenn keine API-URL mit Steuerung definiert ist (Suche/Abfrage/Dropdown-Menü).

    Wenn die API-URL in der Datenverbindungsbibliothek geändert wird, wird sie auch in der Laufzeitlösung widergespiegelt.

    Die aus der Datenverbindungsbibliothek hinzugefügte Datenverbindung kann auf der Ebene der Datenverbindung der Lösung nicht bearbeitet werden. Der Benutzer kann die API-URL nur über die Filtereigenschaft (unformatierte Where-Klausel) der Kontrolle Suche/Abfrage/Dropdown-Menü bearbeiten.

    Folgende Priorität wird eingehalten:

    • Bei der Verbindung der Datenverbindungsbibliothek

      • Die in der Kontrolle Abfrage/Suche definierte API-URL wird zuerst berücksichtigt.

      • Ist unter Abfrage/Suche keine API-URL definiert, wird auf die API-URL zurückgegriffen, die auf der Ebene der Datenverbindungsbibliothek definiert ist.

    • Bei der Lösungsverbindung

      • Die in der Kontrolle Abfrage/Suche definierte API-URL wird zuerst berücksichtigt.

      • Ist unter Abfrage/Suche keine API-URL definiert, wird auf die API-URL zurückgegriffen, die auf der Ebene der Lösungsverbindung definiert ist.

  4. HTTP-Vorgänge: Die REST-API verwendet das HTTP-Verb, um anzugeben, dass die Anforderung für den Vorgang Lesen/Aktualisieren/Löschen oder Erstellen bestimmt ist. Wählen Sie dieses Feld gemäß der aktuellen Verwendung der API-Verbindung aus. Folgende Vorgänge werden unterstützt:

    1. GET: Ruft Daten von der API ab.

    2. Put/Patch: Aktualisiert Daten.

    3. Post: Erstellt Daten.

    4. Delete: Löscht Daten.

      Anmerkung:
      • Wählen Sie den oben stehenden Vorgang gemäß der API-Spezifikation des Systems aus, da einige Systeme möglicherweise nicht dem HTTP-Standardverb folgen. D. h., bei dem POST-Vorgang werden möglicherweise Daten gelöscht.

      • Plug-in „Adapter für Datenverbindung“ – Ausführer-Knoten wird mit der REST-API-Datenverbindung nicht unterstützt.

  5. Legen Sie das API-Schema fest:

    1. Eingabeschema: Das Eingabeschema ist für die Daten vorgesehen, die an die API gesendet werden (d. h. Anforderungsnutzlast in JSON). Stellen Sie das JSON-Schema entweder aus der Datei bereit, oder kopieren Sie es direkt in das Textfeld.

    2. Ausgabeschema: Das Ausgabeschema ist für die Daten vorgesehen, die über die API empfangen werden (d. h. Antwortnutzlast in JSON). Stellen Sie das JSON-Schema entweder aus der Datei bereit, oder kopieren Sie es direkt in das Textfeld.

      Weitere Informationen finden Sie unter Schritte zum Aktualisieren des Eingabe-/Ausgabeschemas für die REST-API-Verbindnug.

    3. Fehlerschema: Im Falle eines Fehlers oder einer Ausnahme geben einige APIs Daten in einem anderen JSON-Schema zurück, d. h., HTTP-Statuscodes (4xxx oder 5xxx) gelten als Fehler/Ausnahme beim API-Aufruf. Stellen Sie das JSON-Schema entweder aus der Datei bereit, oder kopieren Sie es direkt in das Textfeld.

    4. Anforderungsheader: Dies sind die Header-Daten im Schlüssel-Wert-Paar-Format. Anforderungsheader sind die Daten, die im Abschnitt „Anforderungsheader“ an die API gesendet werden. Geben Sie die erwarteten Anforderungsheader gemäß der API-Spezifikation an. Zudem können sowohl der Schlüssel als auch der Wert so konfiguriert werden, dass sie aus Formularfeldern oder Festwerten oder beidem gelesen werden.

      Beispiel: Wenn die Berechtigung für den Anforderungsheader auf den Wert „Bearer [FormFieldName]“ gesetzt ist, lautet der Wert der Berechtigung für den Anforderungsheader zur Laufzeit „Bearer 1234“, wenn der „FormFieldName“ den Wert 1234 aufweist.

      Hier ist „Bearer“ ein Festwert und „FormFieldValue“ ein Formularfeld.

    5. Antwortheader: Dies ist der Header im Schlüssel-Wert-Paar-Format. Antwortheader sind die Daten, die von der API als Antwort im Abschnitt „Header“ empfangen werden. Geben Sie die erwarteten Anforderungsheader gemäß der API-Spezifikation an. Der Schlüsselname sollte ein Festwert/statischer Wert sein, der zur Entwurfszeit der Lösung bereitgestellt wird. Der Wert ist ein Formularfeld, und dieses Formularfeld wird mit dem Wert gemäß den von der API empfangenen Daten aktualisiert. Antwortheader funktionieren nur mit Webdienstausführung (Webdienststeuerung oder Data Connection Adapter).

      Hinweis zu Anforderungsheadern

      Nachfolgend finden Sie die Details zur Unterstützung des Headers über das Formularfeld:

      1. Asynchrone Datenverbindung: Das automatische Abrufen von Daten beim Öffnen des Formulars ist nicht aktiviert. Dies wird nicht unterstützt.

      2. Datenverbindung synchronisieren: Das automatische Abrufen von Daten beim Öffnen des Formulars ist aktiviert. Dies wird nur für sich nicht wiederholende Felder unterstützt.

      Anmerkung:
      • Wenn die REST-API-Datenverbindung (Sync/Async) im Dropdown-Menü mit definiertem Filter verwendet wird und der Benutzer die Datenverbindung ändert, wird eine Warnmeldung angezeigt. Basierend auf der Auswahl ändert sich der Datenverbindungsmodus, und die Filter werden gelöscht. Der entsprechende Filterdialog (Synchronisierungsfilter oder Filter der REST-API-URL) wird geöffnet, wenn die REST-API-Datenverbindung genutzt wird.

      • Wenn die REST-API-Datenverbindung im Dropdown-Menü ohne definierten filter verwendet wird, wird keine Warnmeldung angezeigt.

      Datentyp des Feldes „JSON-Nutzlast“:

      Die Anwendung kann den Datentyp der JSON-Felder bestimmen, wenn in dem im Eingabe-/Ausgabe-/Fehlerschema angegebenen JSON-Schema der Name des Datentyps im Wert angegeben ist, d. h. zur Angabe des Feldes „CityName“ als Zeichenfolgentyp {“CityName”:”string”} oder zur Angabe des Feldes „CreatedOn“ als Datumstyp {“CreatedOn”:”date”}. Nachfolgend finden Sie die Zuordnungstabelle für Feldtypen als Referenz:

      Datentyp Feldtyp
      int, bigint Für Zahlenfeld
      Zeichenfolge Für Zeichenfolgen- oder Textfeld
      decimal Für Dezimalfeld
      bit, bool, true Für Boolesches Feld
      date, datetime Für Datumsfeld

      Wenn kein Datentyp angegeben ist, versucht die Anwendung, den Datentyp basierend auf dem angegebenen Wert vorherzusagen. Zahlenwert für „int“ (d. h. 0 oder 12 usw.), Dezimalwert für „double“ (d. h. 12,4 oder 9,1 auch 0,0 gilt als „int“), Datumswert für „date“. Es wird empfohlen, den Datentyp anzugeben, um genauere Ergebnisse zu erhalten.

      Array-Unterstützung

      Eigenschaften vom Typ „Array“ werden ebenfalls unterstützt. Nachfolgend finden Sie ein Beispiel für eine Eigenschaft vom Typ „Array“ und ihre Datentypnotation. Bei Eigenschaften vom Typ „Array“ wird das Formularschema als einspaltige Tabelle generiert (d. h. wiederholter Abschnitt mit einem Formularfeld)

      [{ "id": "int", "name": "string", "productType": "string", "sizes": ["string"], "otherDetails": { "colors": ["string"], "versions": ["int"] }}]

      Nichtübereinstimmung des Datumstyps bei Feldgenerierung

      Wenn das in der Nutzlast angegebene API-Feld nicht mit dem Formularfeldtyp übereinstimmt (hauptsächlich Anwendungsfall bei Datum und Zahlen), der API-Feldtyp also „string“ lautet, jedoch einem Formularfeld vom Typ „date“ oder umgekehrt zugeordnet ist. In solchen Fällen ist die Datenkonvertierung möglicherweise nicht korrekt, da die Anwendung die vom API-Server empfangenen Daten als Zeichenfolge betrachtet, das Formular sie jedoch wie ein Datum behandelt. Dadurch kann es zu Datenkonflikten oder unbekannten Fehlern kommen.

      Die bereitgestellte JSON-Nutzlast wird unter Berücksichtigung der Groß-/Kleinschreibung verarbeitet, und alle bereitgestellten Schlüsselnamen werden mit der gleichen Groß-/Kleinschreibung wie angegeben verarbeitet. D. h., bei der Anwendung von “id”:”int” wird nach einem Schlüssel mit einem Namen gesucht, der die gleiche Groß-/Kleinschreibung „id“ aufweist, gesucht. Empfangene Daten wie „Id“ oder „ID“ usw. können nicht verarbeitet werden.

    6. Speichern Sie die Verbindung. Sie wird dann in den Datenverbindungen der Lösung angezeigt.

Bearbeiten der Datenverbindung (REST-API):

Bei Verwendung der Datenverbindung können nur folgende Eigenschaften bearbeitet werden:

  • URL

  • Anforderungs-/Antwortheader

Schritt 3: Datenverbindung der API-Lösung Formularfeldern zuordnen

In diesem Schritt werden Datenfelder in der Datenverbindung der API-Lösung Formularfeldern zugeordnet. Die Vorgehensweise entspricht der Zuordnung der Felder Webdienst- oder Referenzdatenverbindung zu Formularfeldern.

Im Folgenden finden Sie die Schritte zum Zuordnen der Datenverbindung der API-Lösung zu Formularfeldern:

  1. Klicken Sie mit der rechten Maustaste auf Datenverbindung der Lösung, und wählen Sie die Option Formularfelder erstellen aus.

  2. Geben Sie im Dialogfeld Feldzuordnung folgende Informationen an:

    1. Beschreibung: Eine Textnotiz für diese Zuordnung.

    2. Gruppenname: Der Gruppenname für Formularschemafelder. Alle Formularfelder werden nur innerhalb dieser Gruppe erstellt.

    3. Webdienstname: Ein Zuordnungsname, der in der Formularsteuerung oder in Plug-Ins verwendet wird.

    4. Klicken Sie in diesem Dialogfeld auf Weiter.

  3. Das Dialogfeld Feldzuordnungsparameter zeigt alle Datenverbindungsfelder und Formularfelder der API-Lösung an, ähnlich dem, was bei dem Dialogfeld „Webdienst-Feldzuordnung“ angezeigt wird.

  4. Überprüfen oder ändern Sie je nach Bedarf den Formularfeldtyp oder die maximale Länge.

  5. Klicken Sie auf OK, um die Zuordnung abzuschließen.

Das Zuordnen beliebiger Schemafelder mit unterschiedlichen Typen von Formularfeldern sollte im Dialogfeld Feldzuordnung erfolgen. Durch eine Änderung des Formularfeldtyps über Eigenschaften würde der Datentyp nicht in WSDL geändert.

Beispiel:

Bei einigen GET-API-Methoden enthält das Ausgabeschema ein Datumsfeld, dessen zugehöriger Datentyp eine Zeichenfolge ist. Der Benutzer sollte den Datentyp im Dialogfeld Feldzuordnung auswählen.

Anmerkung: Durch die Zuordnung von „Datumsauswahl“ zu „Textfeld“ und die anschließende Änderung des Datumstyps über Feldeigenschaften werden nicht die erwarteten Ergebnisse angezeigt.

Schritt 4: Formular entwerfen

Entwerfen Sie das Formular mit den Feldern, die Sie erstellt und der Datenverbindung der API-Lösung zugeordnet haben. Legen Sie auch Formularsteuerungen fest (d. h. Webdienst, Suche, Abfrage oder Dropdown), die die API-Datenverbindung ausführen.

  1. Entwerfen Sie in der Fomularansicht die Formularfelder.

  2. Platzieren Sie den Webdienst und die Schaltflächen-Steuerung in der Formularansicht. Konfigurieren Sie die Webdienst-Steuerung und die Schaltflächen-Steuerung so, dass die Datenverbindung der API-Lösung ausgeführt wird, wenn Sie auf diese Schaltfläche klicken.

  3. Implementieren Sie die Lösung.

Anmerkung: Die Datenverbindung der API-Lösung entspricht dem Entwurf anderer Datenverbindungen und kann mit unterstützten Formularsteuerungen und Plug-ins verwendet werden.

Schritt 5: Datenverbindung der API-Lösung testen

Starten Sie das Formular, und führen Sie die Datenverbindung der API-Lösung aus.

  1. Starten Sie das Formular.

  2. Klicken Sie auf die konfigurierte Schaltfläche, um die Datenverbindung der API-Lösung auszuführen.

  3. Das Formular führt die API aus und zeigt in zugeordneten Formularfeldern die Antwortdaten an.

    Wenn Sie die Funktion Datenverbindung in der Formularlösung verwenden, um die Daten im Evolve Formular herunterzuladen, haben Sie folgende Möglichkeiten:

    • Laden Sie die Daten zu den Benutzeraktionen auf dem Formular herunter.
    • Laden Sie die Daten im Hintergrund mit dem Plug-in Data Connection Adapter (Adapter für Datenverbindung) herunter.

    Es wird empfohlen, eine Lösung zu entwerfen, die keine großen Datenmengen (mehr als 1.000 Datensätze) in das Formular herunterlädt. Das Speichern einer so großen Datenmenge im Formular kann zu einem hohen Ressourcenverbrauch von RAM oder CPU führen. Dies kann sich auf andere Funktionen der Anwendung auswirken und zu einer langsamen Reaktion oder Verzögerung bei der Verarbeitung der Aufträge führen.

    Beispielsweise sollten Formularfelder der Eingabeparameter für die Abfrage so festgelegt werden, dass die Abfrage nie mehr als 1.000 Datensätze zurückgibt. Dazu können Sie den Eingabeparameter als obligatorisch festlegen. Wenn Sie eine REST-API verwenden und diese API die maximale Anzahl von Datensätzen unterstützt, die bei einer Abfrage oder einem Filter zurückgegeben werden (z. B. enthält die OData-API normalerweise den Parameter „count“ oder „$count“), sollten solche Parameter beim Entwerfen der Lösung mit einem bestimmten Grenzwert (weniger als 1.000) eingestellt werden. Wenn also der Endbenutzer des Formulars versehentlich einen falschen Filter oder eine falsche Eingabe bereitstellt, sollten nicht Tausende von Datensätzen zurückgegeben werden.

Beispiel-API, die Produkte zurückgibt

API-Spezifikation

Die API mit dem Endpunkt „http://globalsystem/api/Product“ gibt Produkte mit dem HTTP-Verb/-Vorgang GET im JSON-Format zurück. Auf die API kann mit dem bereitgestellten Schlüsselcode zugegriffen werden, der über den Anforderungsheader im Schlüsselnamen accesskey gesendet werden sollte. Der API-URL-Endpunkt verfügt für die Rückgabe von Produkten über eine Basisadresse für alle APIs und einen spezifischen URL-Teil. Der Basis-URL-Teil lautet „http://globalsystem/api“ und der Produkt-URL-Teil „/Product“. Diese API gibt mindestens ein Produkt zurück. Nachfolgend finden Sie ein Beispiel:

API-Antwort mit Details zu zwei Produkten. Es ist ein Array von JSON-Objekten.

[  { "id": 1, "name": "100-100", "productType": "A1", "weightUnit": "W1", "netWeight": 90, "grossWeight": 100, "validityStartDate": "2020-10-03T10:28:45.892275+05:30" }, { "id": 2, "name": "100-200", "productType": "A1", "weightUnit": "W1", "netWeight": 100, "grossWeight": 150, "validityStartDate": "2019-08-30T10:28:46.3904638+05:30" } ]

Schritt 1:

  1. Fügen Sie entweder auf Anwendungsebene oder auf globaler Ebene eine neue Verbindung mit der Basis-URL „http://globalsystem/api“ und mit Authentifizierungstyp HTTP-Header hinzu, d. h., fügen Sie einen Header von Schlüsselname accesskey hinzu. Der Wert müsste der gültige Zugriffsschlüssel sein, wie er vom System empfangen wurde. Geben Sie als Verbindungsnamen „GlobalSystemAPI“ an.

Schritt 2:

  1. Erstellen Sie eine neue Lösung, und fügen Sie dem in Schritt 1 erstellten Verbindungsnamen „GlobalSystemAPI“ die Datenverbindung der REST-API hinzu.

  2. Legen Sie den Namen dieser Datenverbindung auf „conProductGlobalSystem“ fest.

  3. Legen Sie die API-URL auf die Produkt-API fest, indem Sie mithilfe des URL-Generators den URL-Teil „/Product“ hinzufügen.

  4. Legen Sie den GET-Vorgang fest.

  5. Sie müssen kein Eingabeschema festlegen, da die API keine Nutzlast erwartet.

  6. Legen Sie das Ausgabeschema nur für ein Produkt fest, da die Verbindung nur das Schema und keine genaue Ausgabe mit mehreren Produktdaten benötigt. Legen Sie den Feldtyp (Datentyp) fest, der im Composer Formularfeld erwartet wird. Es gibt zwei Möglichkeiten, Ihrer API die Schemadetails hinzuzufügen. Speichern Sie dieses Schema entweder in einer Datei, und navigieren Sie dann zur Datei, ODER legen Sie das Schema direkt als Text ab. Nachfolgend finden Sie das Schemabeispiel (Array von Produkten)

    Schemabeispiel

    [ { "id": “int”, "name": "string", "productType": "string", "weightUnit": "string", "netWeight": “decimal”, "grossWeight": “decimal”, "validityStartDate": "date" } ]
    Anmerkung: Das obige Schema besteht aus einem Array von Daten, die als Antwort von der API zurückgegeben werden. Zudem ist dies ist eine Standardspezifikation für das JSON-Format. Es gibt auch jeden Feldtyp an, den Composer beim Erstellen von Formularfeldern verwendet.
    Anmerkung: Wenn der Wert eines bestimmten Schlüssels im obigen Schema erwartet, dass mehrere Werte zurückgegeben werden (ein Array von Werten, die durch Kommas getrennt sind), wird damit ebenfalls umgegangen. Die vorhandenen Datentypen reichen für diesen Zweck aus. Ein Beispiel für einen Array-Wert, der als Antwort auf einen „Schlüssel“ im Schema empfangen wird, kann wie folgt aussehen: [“value_1”, “value_2”, “value_3”]. Diese Daten können als Daten vom Datentyp „String“ betrachtet werden.
  7. Speichern Sie die Verbindung.

Schritt 3: API-Datenverbindung Formularfeldern zuordnen

  1. Klicken Sie in der Lösungsstruktur mit der rechten Maustaste auf die oben erstellte Verbindung „conProductGlobalSystem“, und wählen Sie „Formularfelder erstellen“ aus. Geben Sie dieser Zuordnung bzw. diesem Webservice den Namen „ProductGlobalSystemWS“, und befolgen Sie die Schritte, um die Formularfelder zu erstellen.

Schritt 4: Formular entwerfen

  1. Platzieren Sie die in Schritt 3 erstellten Formularfelder in einer Formularansicht.

  2. Fügen Sie eine Schaltflächen-Steuerung hinzu, und geben Sie dieser den Namen „Produkte abrufen“.

  3. Fügen Sie eine Webdienst-Steuerung hinzu, und wählen Sie die Zuordnung bzw. den Webservice namens „ProductGlobalSystemWS“ aus. Konfigurieren Sie ihn so, dass er durch Aufrufen der Schaltfläche ausgeführt wird, und wählen Sie die oben hinzugefügte Schaltfläche aus.

  4. Implementieren Sie die Lösung.

Anmerkung:

  • Die Anforderungs-URL aus dem Lösungsfeld wird in Formularvorlagen nicht direkt unterstützt. Der Benutzer muss für die Verwendung einen Entwurf oder eine Aufgabe erstellen.

  • Bei Formularkontrollen wie „Abfrage“, „Suche“, „Dropdown“ oder „PR“ ist nur der äußerste Abschnitt des Schemas verfügbar. Daher wird bei Datenverbindungen nur der äußerste Satz von Feldern als Spalten angezeigt.

Schritt 5: REST-API-Verbindung testen

  1. Starten Sie die Formularvorlage, und klicken Sie auf die Schaltfläche Produkte abrufen. Es werden alle Produkte abgerufen, und das Ergebnis müsste in einer Tabelle sichtbar sein.

Umgang mit Datum/Uhrzeit in der REST-API-Integration:

POST-/PATCH-/PUT-Vorgang

Anwendungsfall-1 A > Buchungsdatum mit dem Datumsauswahl-Steuerelement

Bei Verwendung des Datumsauswahl-Steuerelements muss der Benutzer das Datum in dem Format eingeben, das im Datumsauswahl-Steuerelement festgelegt ist, unabhängig von dem in der REST-API-Domänenkomponente festgelegten Datumsformat (ISO/Ticks).

Anwendungsfall-1 B > Zeitanteil im Datumsauswahl-Steuerelement

Der Zeitanteil geht bei der Buchung mit dem Datumsauswahl-Steuerelement verloren.

Anwendungsfall-2 A > Buchungsdatum mit TextField

Bei Verwendung von TextField, d. h. das Schema enthält ein Datumsfeld, aber im Fenster Feldzuordnung erstellen wird das Datumsfeld dem Textfeldttyp zugeordnet. Hier muss das korrekte, von der API akzeptierte Format festgelegt werden.

• Für Ticks: Der Benutzer muss einen Wert im Ticks-Format eingeben. Beispiel: /Date(1595808000000)/.

• Für ISO: Der Benutzer muss das Datum im ISO-Format eingeben. Beispiel: jjjj-mm-tt

Anwendungsfall-2 B > Zeitanteil und Zeitzone mit TextField

Bei Verwendung von Textfield geht der Zeitanteil nicht verloren. Auch die Zeitzone wird berücksichtigt, wenn der Datumswert zusammen mit dem Offset angegeben wird. Beispiel: Durch die Bereitstellung von Werten wie 2021-03-31T01:01:13.8366463+05:30 wird das Datum zusammen mit der Zeitzone im System gebucht.

GET-VORGANG

Anwendungsfall-1 A > Daten im Datumsauswahl-Steuerelement abrufen

Hier wird das Datum unabhängig vom Datumsformat (Ticks/ISO) gemäß der Datumsauswahl in der REST-API-Datenverbindung festgelegt.

Anwendungsfall-1 B > Zeitteil und Zeitzone

Der Zeitteil geht verloren. Das Datum wird immer in UTC zurückgegeben.

Anwendungsfall-2 A > Datum im Textfeld abrufen

Hier wird das Datum gemäß dem Datumsformat in der REST-API-Datenverbindung festgelegt. Beispiel: Für Ticks wird das Datum wie folgt festgelegt: /Date(1595808000000)/, für ISO wird es wie folgt festgelegt: jjjj-mm-tt hh:mm:ss.

Anwendungsfall-2 B > Zeitanteil und Zeitzone mit TextField

Das Datum wird immer in der UTC-Zeitzone zurückgegeben.

Beispiel: Wenn als Datum 2021-03-31T00:00:00.0000000+05:30 (indische Zeitzone) gebucht wird, dann wird das Datum beim GET -Vorgang als 2021-03-30 zurückgegeben (d. h. in der UTC-Zeitzone).