Tabla de usuarios de Azure Active Directory

Microsoft Dataverse incluye una tabla virtual denominada usuario de AAD (aaduser). Esta tabla virtual proporciona una conexión a Azure Active Directory (AAD) y devuelve datos sobre los usuarios de la organización de AAD. No se requiere ninguna configuración de tabla virtual para usar la funcionalidad. Se trata de una característica solo en línea.

Búsquedas mediante AADUser

Puede agregar fácilmente una búsqueda a esta tabla virtual desde el portal de Power Apps.

Permissions

La tabla AADUser funciona con Microsoft Graph. A los usuarios de su organización se les deben asignar permisos de Graph para ver y usar la tabla virtual AADUser.

Operaciones permitidas

Solo las operaciones de lectura y lectura múltiple son posibles a través de la tabla virtual AADUser.

Ejemplos de API web de tabla AADUser

Esta sección contiene HTTPGET ejemplos de acceso a datos desde la tabla AADUser.

Recuperación de datos

En el ejemplo siguiente se muestra cómo recuperar datos de la tabla AADUser.

Recuperar todas las filas de la tabla AADUser

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers  

Recuperar registros de AADUser con el apellido "admin"

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=surname eq 'admin'

Recuperar registros de AADUser con el apellido "admin" o "admin02"

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=(surname eq 'Admin02') or (surname eq 'Admin')

Recupera los registros AADUser cuyo nombre de empresa no es NULL

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=companyname ne null

Recuperar registros AADUser cuyo tipo de usuario es "Member"

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=usertype eq 'Member'

Recuperar los registros de AADUser cuyos teléfonos comerciales contienen "123-555-1212"

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=contains(businessphones, '123-555-1212')

Recuperar registros AADUser cuyo nombre especificado comienza por "test"

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=startswith(givenname, 'test')

Recuperar registros AADUser cuyo nombre especificado no comienza por "test"

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=not startswith(givenname, 'test')

Recuperar registros de cuenta relacionados que hacen referencia a un registro AADUser

A continuación, new_aaduser_account es el nombre de la relación 1:N entre AADUser y la entidad Account.

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers(<user ID>)?$expand=new_aaduser_account($select=accountid,name)

Referencia a una fila de AADUser

En el ejemplo siguiente se muestra cómo hacer referencia a una fila de tabla AADUser.

Establecer el valor del campo de búsqueda que hace referencia a una fila AADUser

En este ejemplo new_testaaduserId , se trata de la propiedad de navegación de un solo valor creada con una relación personalizada de 1:N entre AADUser y la entidad Account. El nombre de esta propiedad de navegación se define en la propiedad OneToManyRelationshipMetadata.ReferencingEntityNavigationPropertyName de la relación. Más información: Propiedades de navegación con un solo valor

PATCH
https://[Organization URI].crm.dynamics.com/api/data/v9.0/accounts(<account ID>)
{
  new_testaaduserId@odata.bind : "/aadusers(user ID)"
}

Consulte también

Referencia de tabla/entidad aaduser
referencia de aaduser EntityType
Seguridad y datos de acceso