searchForRead

Versionshinweise	12.1, 13.1, 17.1

Code

GROOVY

List<IContainer> WorkSpaceScriptUtils.searchForRead(String searchPlainKey, Serializable... values)
List<IContainer> WorkSpaceScriptUtils.searchForRead(ISearch iSearch, Serializable... values)

Beschreibung

Führt die durch den Namen referenzierte Suche aus. Übergebene Suchparameter ersetzen in der Suche enthaltene Templates "Platzhalter (wird zur Laufzeit ersetzt)".

Das Suchergebnis enthält nur Suchergebnisfelder der Suche (also keine impliziten Suchergebnisfelder). Man kann auch SQL-Ausdrücke in der Suche verwenden (im Gegensatz zu search()).

Die Sortierung des Suchergebnisses kann mittels eines PropertyMapper-Eintrages mit der Id Order.-Plainkey- vorgegeben werden.

Parameter

searchPlainKey oder iSearch - Der Name einer Suche oder ein ISearch Suchobjekt (ab Version 17.1).
values - Parameter für die Suche. Mit Hilfe der Konstante WorkSpaceScriptUtils.NO_VALUE können Platzhalter in Suchen gezielt ignoriert werden. Ab Version 13.1 können Juhuuu-Felder über die Methode WorkSpaceScriptUtils.getLuceneParameter() gefüllt werden. Für Nachschlagefelder sollten validierte Nachschlagewerte (ILookup) übergeben werden.

Rückgabe

Gibt eine Liste von Datensätzen (IContainer) zurück.

Die Datensätze sind nicht für das Herstellen von Verknüpfungen mittels WorkSpaceScriptUtils.linkEntries() geeignet. Hier sollte stattdessen mit search gearbeitet werden. Anderserseits hat searchForRead den Vorteil, dass SQL-Ausdrücke verwendet werden können.

Beispiele

GROOVY

List<IContainer> searchResult = WorkSpaceScriptUtils.searchForRead("searchPlainKey ");
List<IContainer> searchResult = WorkSpaceScriptUtils.searchForRead("searchPlainKey ", "Test", 1.0);
 
// mit einer ISearch
ISearchCondition searchCond = SearchUtils.createSearchCondition("Subject.Activity", SearchUtils.LIKE, "Test");
ISearch iSearch = SearchUtils.createSearch("Activity", searchCond);
List<IContainer> searchResult = WorkSpaceScriptUtils.searchForRead(iSearch);