Skip to content

Functions: RecordsResource: Filter

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

#RecordsResource: Datasets filter APIs

Function 66: Use multiple filters

Multiple filters will be applied to requested data.

  • Add multiplte filter parameters into URL
  • Datasets will fullfill every filter (all AND-combined)

Example: http://localhost:8080/SmartData/smartdata/records/mycollection?storage=mystorage&filter=my_first_attr,eq,20&filter=my_first_attr,in,1,2,3,4

Funktion 13: Filter: Werte auf Gleichheit prüfen (EQ-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut einen bestimmten Wert besitzt

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testEQFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testEQFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 14: Filter: Werte auf Ungleichheit prüfen (NEQ-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut einen bestimmten Wert nicht besitzt
    • testNEQFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testNEQFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 15: Filter: Werte, die einen bestimmten String enthalten (CS-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut einen bestimmten String enthält
    • testCSFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testCSFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testCSFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 16: Filter: Werte, die einen bestimmten String nicht enthalten (NCS-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut einen bestimmten String nicht enthält
    • testNCSFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testNCSFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testNCSFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 17: Filter: Werte, die mit einem bestimmten String beginnen (SW-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut mit einem bestimmten String beginnt
    • testSWFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testSWFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testSWFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 18: Filter: Werte, die nicht mit einem bestimmten String beginnen (NSW-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut nicht mit einem bestimmten String beginnt
    • testNSWFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testNSWFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testNSWFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 19: Filter: Werte, die mit einem bestimmten String enden (EW-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut mit einem bestimmten String endet
    • testEWFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testEWFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testEWFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 20: Filter: Werte, die nicht mit einem bestimmten String enden (NEW-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut nicht mit einem bestimmten String endet
    • testNEWFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testNEWFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testNEWFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 21: Filter: Werte auf kleiner als prüfen (LT-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut kleiner als ein bestimmter Wert ist
    • testLTFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testLTFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testLTFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 22: Filter: Werte auf nicht kleiner als prüfen (NLT-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut nicht kleiner als ein bestimmter Wert ist
    • testNLTFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testNLTFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testNLTFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 23: Filter: Werte auf kleiner als/gleich prüfen (LE-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut kleiner oder gleich einem bestimmten Wert ist
    • testLEFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testLEFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testLEFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 24: Filter: Werte auf nicht kleiner als/gleich prüfen (NLE-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut nicht kleiner oder gleich einem bestimmten Wert ist
    • testNLEFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testNLEFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testNLEFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 25: Filter: Werte auf größer als/gleich prüfen (GE-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut größer oder gleich einem bestimmten Wert ist
    • testGEFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testGEFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testGEFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 26: Filter: Werte auf nicht größer als/gleich prüfen (NGE-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut nicht größer oder gleich einem bestimmten Wert ist
    • testNGEFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testNGEFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testNGEFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 27: Filter: Werte auf größer als prüfen (GT-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut größer als ein bestimmter Wert ist
    • testGTFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testGTFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testGTFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 28: Filter: Werte auf nicht größer als prüfen (NGT-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut nicht größer als ein bestimmter Wert ist
    • testNGTFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testNGTFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testNGTFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 29: Filter: Werte, die zwischen zwei bestimmten Werten liegen (BT-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut zwischen zwei bestimmten Werten liegt
    • testBTFilterFound()
    • testBTFilterTimestamp()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testBTFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testBTFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 30: Filter: Werte, die nicht zwischen zwei bestimmten Werten liegen (NBT-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut nicht zwischen zwei bestimmten Werten liegt
    • testNBTFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testNBTFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testNBTFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 31: Filter: Werte, die in einer Liste mit bestimmten Werten vorhanden sind (IN-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut in einer Liste von bestimmten Werten vorhanden ist
    • testINFilterFound()
    • testINFilterTimestamp()
    • testINFilterString()
    • testINFilterDouble()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testINFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testINFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Example: http://localhost:8080/SmartData/smartdata/records/my_table?storage=smartmonitoring&filter=my_column_id,in,1,2,3,4,5 Gets all datasets where "my_column_id" contains the values 1,2,3,4 or 5.

Funktion 32: Filter: Werte, die nicht in einer Liste mit bestimmten Werten vorhanden sind (NIN-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut nicht in einer Liste von bestimmten Werten vorhanden ist
    • testNINFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testNINFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testNINFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 33: Filter: Werte, die null sind (IS-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut null ist
    • testISFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testISFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • testISFilterNotFound()
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Funktion 34: Filter: Werte, die nicht null sind (NIS-Filter)

  1. Es werden Datensätze abgefragt, bei denen ein Attribut nicht null ist
    • testNISFilterFound()
    • Es werden passende Datensätze zurückgeliefert
    • Es wird mit Status 200 OK geantwortet

Ausnahmen:

  1. Es wurde kein storage angegeben
    • Der Datensatz wird im storage "public" angelegt, sofern dieser existiert
  2. Das angegebene Attribut existiert nicht
    • testNISFilterMissingAttribute()
    • Es wird mit Status BAD REQUEST geantwortet
  3. Es gibt keine passenden Datensätze
    • Es wird mit Status 200 OK und einer leeren Liste geantwortet

Clone this wiki locally