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.
Signatur
DataObject search(DataObject root) throws
WIMException