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
- WIMException :
- RemoteException :
Signature
La méthode générale DataObject get(racine DataObject) émet des exceptions
WIMException, RemoteException