Skip to content

Functions: RecordsResource: Create

Florian Fehring edited this page Apr 20, 2026 · 2 revisions

RecordsResource: Create Datasets API

Funktion 1: Anlegen eines Datensatzes

  1. Es wird ein Datensatz übermittelt mit Key-Value Paaren
    • testCreateSetSimple()
    • Der Datensatz wird der angegebenen Tabelle hinzugefügt
    • Es wird mit Status 201 CREATED geantwortet und die ID des angelegten Datensatzes zurückgegeben
  2. Es wird ein Datensatz übermittelt mit Key-Value Paaren deren Keys sich in Groß-Klein-schreibung von den Attributnamen unterscheiden
    • Der Datensatz wird der angegebenen Collection hinzugefügt
    • Es wird mit Status 201 CREATED geantwortet und die ID des angelegten Datensatzes zurückgegeben

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Es wurden Werte mit Unicode-Zeichen im Datensatz übermittelt
    • testCreateSetUnicode()
    • Der Datensatz wird angelegt
  3. Es wurden Messwerte für Attribute übermittelt, die es keine Attribute gibt
    • Für jeden dieser Messwerte wird eine Warnung zurückgegeben
    • Die annehmbaren Daten werden in die Datenbank geschrieben
  4. Es wurden ausschließlich Messwerte für Attribute übermittelt, die nicht existieren
    • Die Schnittstelle antwortet mit Status 412 (Precondition failed)
    • Es wird eine entsprechende Fehlermeldung zurückgegeben
  5. Es wurde ein Datensatz übermittelt, der bereits existiert (identische identitycolumn)
    • testReCreateSetSimple()
    • Es wird mit Status 409 (Conflict) und einer entsprechenden Fehlermeldung geantwortet.

Beispiel:

Methode: POST

URL: http://localhost:8080/SmartData/smartdata/records/my_table?storage=smartmonitoring

Payload: {"name":"Neuer Datensatz", "desc": "Dies ist der Inhalt des neuen Datensatzes"}

Funktion 2: Anlegen mehrerer Datensätze

  1. Es werden mehrere Datensätze auf einmal übermittelt mit Key-Value Paaren
    • testCreateSetsSimple()
    • Die Datensätze werden der angegebenen Collection hinzugefügt
    • Es wird mit Status 201 CREATED geantwortet.
    • Wird in der Konfiguration spec.version=2020fhbi gesetzt, werden bei der Antwort die IDs der angelegten Datensätze zurückgegeben
  2. Es werden Datensätze übermittelt mit Key-Value Paaren deren Keys sich in Groß-Klein-schreibung von den Attributnamen unterscheiden
    • Die Datensätze werden der angegebenen Tabelle hinzugefügt
    • Es wird mit Status 201 CREATED geantwortet und die ID des angelegten Datensatzes zurückgegeben

Beispiel:

Methode: POST

URL: http://localhost:8080/SmartData/smartdata/records/my_table?storage=smartmonitoring

Payload: [{"name":"Neuer Datensatz", "desc": "Dies ist der Inhalt des neuen Datensatzes"},{"name":"Neuer Datensatz 2", "desc": "Dies ist der Inhalt des neuen Datensatzes 2"}]

Clone this wiki locally