Méthode get

Utilisez la méthode d'extraction (get) pour récupérer les informations d'une ou de plusieurs entités.

Objectif

La méthode get retourne les informations demandées des entités spécifiées. Par exemple, les propriétés, les groupes auxquels l'entité appartient, les ancêtres ou les descendants de l'entité.

Pour extraire une entité, l'objet de données de l'entité avec ses identificateurs est ajouté sous l'objet de données racine. Vous pouvez extraire plusieurs entités avec un seul appel de méthode d'extraction en ajoutant plusieurs objets de données d'entité sous la racine.

Vous pouvez retourner différentes informations en indiquant différentes commandes. Par exemple, PropertyControl renvoie les propriétés des entités. GroupMembershipControl renvoie les groupes auxquels appartiennent les entités.
Remarque : SortControl est ignoré dans ProfileManager, si les entités demandées ont été retournées par un adaptateur asynchrone. Dans ce cas, les résultats sont triés selon les fonctions de tri prises en charge par l'adaptateur asynchrone.

Paramètres

racine
Indique l'objet de données racine qui contient les informations demandées.

Retours

Objet de données racine qui contient les informations demandées.
Remarque : La propriété de mot de passe est retournée uniquement si le référentiel sous-jacent le renvoie. Le mot de passe est retourné dans le même format que celui dans lequel le référentiel sous-jacent l'a renvoyé à virtual member manager.

Exceptions

Signature

La méthode générale DataObject get(racine DataObject) émet des exceptions WIMException, RemoteException


Conditions d'utilisation | Commentaires