search

Verwenden Sie die Methode "search", um nach Einträgen in den Profil-Repositorys zu suchen, die mit den Suchkriterien übereinstimmen.

Verwendungszweck

Die SPI "search" durchsucht das Profil-Repository, um die Entitäten zu finden, die mit dem Suchausdruck übereinstimmen.
Eine Liste der Merkmale, die von der Suche zurückgegeben werden, ist in "SearchControl" im Eingabedatengraph enthalten. Im Eingabedatengraph können auch "PageControl" und/oder "SortControl" enthalten sein. "SearchControl" enthält im Eingabedatengraph die Suchausdruckzeichenfolge. Die Implementierungsklasse der Repository-API muss XPath basierend auf der Suchausdruckzeichenfolge analysieren.
Anmerkung: Wenn ein Adapter die Sortierung nicht unterstützt, wird "SortControl" im Eingabedatenobjekt ignoriert.
Die Methode gibt einen Datengraph zurück, welcher alle Entitäten enthält, die mit dem Suchausdruck übereinstimmen, wenn die Blätterfunktion nicht verwendet wird. Für die Blätterfunktion muss "PageResponseControl" ebenfalls im Ausgabedatengraph enthalten sein. Wenn die Anzahl der Entitäten größer ist als die Seitengröße, wurde ein Cookie von "PageResponseControl" zurückgegeben, so dass er in nachfolgenden Aufrufen verwendet werden kann. Wenn für einen nachfolgenden seitenweisen Abruf von Suchergebnissen die Seitengröße auf 0 gesetzt wurde, bedeutet dies, das der Aufrufende den Rest der Suchergebnisse nicht erhalten möchte. Der Adapter kann eine Datenbereinigung wie z. B. das Löschen des Caches ausführen, falls notwendig.
Anmerkung: Virtual Member Manager verwendet nicht die Blätterfunktion eines zugrunde liegenden Datenspeichers.

Der eindeutige Name "uniqueName" einer zurückgegebenen Entität ist der eindeutige Virtual Member Manager-Name, welcher nicht immer derselbe ist wie der eindeutige Name im Datenspeicher. Der Adapter überträgt den eindeutigen Namen des Datenspeichers gemäß den Konfigurationsdaten des Adapters an den eindeutigen Virtual Member Manager-Namen.

Parameter

root
Gibt das Stammdatenobjekt ("Root") an, welches die Steuerelemente enthält, die zur Methode "search" gehören.

Ausgabe

Das Stammdatenobjekt mit den Entitäten, die mit dem Suchausdruck übereinstimmen.

Ausnahmebedingungen

Signatur

DataObject search(DataObject root) throws WIMException


Rechtliche Hinweise | Feedback