Utilice el método get para recuperar la información de una entidad o de varias
entidades.
Finalidad
El método get devuelve la información solicitada de las
entidades especificadas. Por ejemplo, las propiedades, los grupos a los que pertenece la
entidad, los ascendientes y los descendientes de la entidad.
Para recuperar una entidad, el objeto de datos de entidad con el identificador
(Identifier) se añaden debajo el objeto de datos raíz. Se pueden recuperar varias
entidades en una llamada de método get añadiendo objetos de datos de varias entidades
debajo de la raíz.
Al especificar controles diferentes, se puede devolver información diferente. Por
ejemplo, PropertyControl se utiliza para devolver las propiedades de las entidades. GroupMembershipControl
se utiliza para devolver los grupos a los que pertenecen las entidades.
Nota: SortControl se ignora en el gestor de perfiles, si las entidades
solicitadas las ha devuelto un adaptador asíncrono. En este caso, los resultados se
clasifican según las funciones de clasificación que admita el adaptador asíncrono.
Parámetros
- root
- Especifica el objeto de datos raíz que contiene la información de la solicitud.
Retorno
El objeto de datos raíz que contiene la información
solicitada.
Nota: La propiedad de contraseña sólo se devuelve si el depósito
subyacente la devuelve. La contraseña se devuelve en el mismo formato que el depósito
subyacente devuelve la contraseña a virtual member manager.
Excepciones
- WIMException:
- RemoteException:
Firma
public DataObject get(DataObject root) emite WIMException, RemoteException