La méthode search permet de trouver des entrées dans les référentiels de
profil qui répondent aux critères de recherche.
Objectif
L'interface SPI search recherche dans le référentiel de profil les entités
qui répondent à l'expression de recherche.
Une
liste des propriétés qui sont retournées par la recherche est incluse dans
SearchControl, dans le graphique de données d'entrées. Vous pouvez également
inclure dans ce graphique un contrôle PageControl et/ou SortControl.
Le
contrôle SearchControl du graphique comprend la chaîne de l'expression de
recherche. La classe d'implémentation de l'interface API du
référentiel doit analyser la chaîne d'expression de recherche XPath.
Remarque : Si
un adaptateur ne prend pas en charge le tri. Le contrôle SortControl de l'objet
de données d'entrée est ignoré.
La
méthode renvoie un graphique de données qui comprend toutes les entités qui
correspondent à l'expression de recherche, si la fonction de pagination n'est
pas utilisée. Pour la fonction de pagination, vous devez inclure également un
contrôle PageResponseControl dans le graphique de données de sortie. Si le nombre d'entités est supérieur au volume de pages, un cookie doit
être renvoyé par le contrôle PageResponseControl afin de pouvoir être utilisé
dans les appels ultérieurs. Si le volume de pages est défini sur 0
dans un appel ultérieur pour la recherche paginée, cela signifie que
l'appelant ne souhaite pas recevoir le reste des résultats de la recherche. L'adaptateur
procède à un nettoyage des données, tel que l'élimination de la mémoire
cache, le cas échéant.
Remarque : Virtual
member manager n'utilise pas la fonction de pagination d'un magasin de données
sous-jacent.
Le nom
unique d'une entité retournée est le nom unique de virtual member manager,
qui n'est pas toujours le même que celui du magasin de données.
L'adaptateur
transfert le nom unique du magasin de données vers le nom unique de virtual
member manager en fonction des informations de configuration de l'adaptateur.
Paramètres
- racine
- Indique l'objet de données racine contenant les contrôles liés à la recherche.
Retours
L'objet de données racine contenant les entités qui correspondent à
l'expression de recherche.
Signature
la méthode DataObject search(racine DataObject) émet une exception WIMException