search

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.

Exceptions

Signature

la méthode DataObject search(racine DataObject) émet une exception WIMException


Conditions d'utilisation | Commentaires