Definieren der Parameter für einen Suchvorgang und eine Ergebnisliste
Wenn Sie beispielsweise Ihren Anwendern einen definierten Suchvorgang oder eine Ergebnisliste bereitstellen möchten, können Sie verschiedene Parameter angeben. In der Regel ist die Volltextsuche in einem d.3-Repository zu unspezifisch. Deshalb können Sie die Suchanfrage mithilfe von Abfrageparametern einschränken.
Sie müssen die Parameter der URL encodieren (z.B. Leerzeichen in %20
). Die Länge des encodierten Abfrageparameters darf 2000 Zeichen nicht überschreiten.
Parameter | Beschreibung |
---|---|
| Legt fest, auf welche Kategorien sich die Suche beziehen soll. Sie können mindestens eine Kategorie definieren. Geben Sie die ID einer Kategorie an. Wird keine Angabe gemacht, erfolgt die Suche in allen Kategorien eines d.3-Repositorys. Beispiele (nicht encodiert):
|
| Gibt einen Volltextsuchbegriff an. |
| Gibt eine Sucheinschränkung nach Eigenschaften der Dokumente und Akten an. Mit folgenden Kriterien können Sie einen Suchvorgang einschränken:
Sie können je Eigenschaft mindestens einen Wert definieren. Beispiele (nicht encodiert):
Einschränkung in Bezug auf die Definition eines Suchvorgangs: Sie können zu einem Parameter mehrere Werte definieren, sofern für die zugehörige Eigenschaft Facetten konfiguriert wurden. Falls keine Facetten für die Eigenschaft zum Anzeigen konfiguriert wurden, wird immer der letzte Wert für den Suchvorgang übernommen. Sie können die Ergebnisliste und den Suchvorgang auch anhand einer erweiterten Eigenschaft einschränken. Die ID der Eigenschaft entspricht der Kennung (RID) einer Eigenschaft, die Sie in d.3 admin für jede erweiterte Eigenschaft ermitteln können. Weitere Informationen zur Kennung einer Eigenschaft (RID) finden Sie in der Dokumentation zu d.3 admin ( Beispiele (nicht encodiert):
Sie können auch mehrere Eigenschaften gleichzeitig als Sucheinschränkung verwenden: Beispiele (nicht encodiert):
|
Anmerkung
Spezielle Angaben für den properties
-Parameter in Bezug auf verschiedene Einschränkungsmöglichkeiten, um gezielt zum Ergebnis zu gelangen:
Suche nach einem numerischen Wert oder einem Geldwert:
Geben Sie den Wert ohne Tausendertrennzeichen an. Als Dezimaltrennzeichen gilt der Punkt (.). Beispiel: Für den Wert 1.000,20 EUR geben Sie 1000.20 an.
Suche nach einem Datum und Uhrzeit:
Geben Sie das Datum im Format YYYY-MM-DD an. Beispiel: Für den 05.12.2014 (DD.MM.YYYY) geben Sie 2014-12-05 an.
Zeitangaben werden nach dem Format YYYY-MM-DDTHH:mm:ss+01:00 durchführt. Das Pluszeichen (+) müssen Sie mit
%2b
encodieren. Beispiel: 2015-02-18T23:59:59%2b01:00 für den 18.02.2015 um 23:59 Uhr und 59 Sekunden in der Zeitzone UTC+1 für Winterzeit in Deutschland.Suche nach Elementen, die sich in einem bestimmten Bereich befinden:
Für die Bereichssuche verwenden Sie als Trennzeichen eine Kombination aus einem Pipe- und Minuszeichen (|-). Beispiele für ein numerisches Feld mit der ID
"231"
:
Werte größer oder gleich 100:
{"231":["100|-"]}
Werte kleiner oder gleich 100:
{"231":["|-100"]}
Werte zwischen 100 und 200:
{"231":["100|-200"]}