Skip to content

Functions: RecordsResource: Get

Jump to bottom
Florian Fehring edited this page Apr 20, 2026 · 1 revision

RecordsResource: Get Datasets API

Funktion 3: Datensätze abrufen

  1. Abfrage aller verfügbaren Datensätze

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Es werden die Datensätze aus dem storage "public" geliefert so fern er existiert
  2. Es werden Daten von einer Collection angefragt, die nicht existiert
    • testGetSetsNotExists()
    • Es wird eine Fehlermeldung mit den entsprechenden Hinweis geliefert
  3. Es sind keine Datensätze vorhanden
    • Es wird eine leere Liste geliefert

Funktion 4: Abfrage nur eines Attributes aus den Datensätzen

  1. Es wird in einer Anfrage mit abgegeben, welches Attribut zurückgeliefert werden sollen

Ausnahmen:

  1. Es wird ein Attribut angegeben, das nicht existiert
    • testGetSetsWithNotExistingInclude()
    • Es wird mit dem Datensatzids geantwortet
    • Die Antwort enthält eine entsprechende Warnung

Funktion 5: Angabe der gewünschten Attribute

  1. Es wird in einer Anfrage mit abgegeben, welche Attribute zurückgeliefert werden sollen

Ausnahmen:

  1. Es wird ein Attribut angegeben, das nicht existiert
    • Es werden die Daten der existierenden Attribute zurückgegeben
    • Die Antwort enthält eine Warnung für die nicht existenden Attribute

Funktion 6: Anzahl der abgefragten Datensätze einschränken

  1. Die Anzahl der abgefragten Datensätze kann eingeschränkt werden

Ausnahmen:

  1. Es wird ein Limit von 0 angegeben
    • Es werden alle Datensätze zurückgeliefert (max. bis Hardlimit)
  2. Es wird ein negatives Limit angegeben
    • testGetSetsNegativeLimit()
    • Es wird mit Status 406 und einer entsprechenden Fehlermeldung geantwortet

Funktion 7: Harte Abfragebeschränkung

Vorbedingung:

  • In der Konfigurationsdatei wurde der Eintrag "hardLimit" gesetzt
  1. Es werden mehr Datensätze abgefragt, als maximal zulässig ist laut Systemeinstellungen
    • Es wird der Parameter "size" mit angegeben und auf einen Wert gesetzt, der höher ist, als der Wert im Eintrag "hardlimit"
    • Es werden nur so viele Datensätze zurückgeliefert wie das Hardlimit erlaubt
    • In der Antwort wird eine entsprechende Warnung mitgeliefert

Funktion 8: Sortierung der abgefragten Datensätze

  1. Es wird angegeben, wonach und wie sortiert werden soll

Ausnahmen:

  1. Das Attribut nach dem sortiert werden soll, existiert nicht
    • testGetSetsWithNotExistingOrder()
    • Die Daten werden unsortiert zurück geliefert
    • Es wird eine entsprechende Warnmeldung zurückgegeben
  2. Es wird die Kombination von Attributliste und OrderBy abgefragt, wobei in der Messwertliste der Messwert nach dem sortiert werden soll, nicht vorkommt
    • Das Attribut nach dem sortiert werden soll wird automatisch zur Abfrageliste hinzugefügt
    • Es werden die Daten zurück geliefert inkl. des Messwerts nach dem sortiert wurde
  3. Es wurde eine ungültige Angabe bei der Sortierart gemacht werden
    • Die Daten werden nach ASC sortiert zurück geliefert

Clone this wiki locally