Capacidades de filtrado y selección de usuarios en Microsoft Graph Data Connect
Puede usar Microsoft Graph Data Connect para seleccionar los usuarios para los que quiere extraer datos y para incluir filtros para limitar los datos devueltos. Este artículo describe las opciones de selección de usuario que Data Connect proporciona y el filtrado que admite.
Selección del usuario
Puede ejecutar canalizaciones en un conjunto de usuarios. Estos son las opciones de selección de usuarios:
- Todos los usuarios dentro de la organización
- Hasta 10 grupos de usuarios dentro de la organización
- Un conjunto de usuarios basado en un predicado que consta de propiedades de usuario de Microsoft Entra
Especifique la selección de usuario en SourceDataSet de la actividad de copia de Azure Synapse o Azure Data Factory. Para ejecutar en una lista de grupos, agregue un nuevo campo allowedGroups en typeProperties y establezca esta propiedad en una lista de hasta 10 Id. de objeto de grupo separados por comas. Si no se especifica ningún grupo de forma predeterminada, los datos se extraen para toda la organización.
Para especificar un predicado para ejecutar en todo el espacio empresarial, agregue un nuevo campo userScopeFilterUri en typeProperties y establézcalo como predicado. El formato del predicado debe coincidir con el formato de la consulta de la API de Microsoft Graph. Por ejemplo, si quiere limitar la selección a los usuarios que trabajan en el departamento de finanzas, puede usar https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'. Si quiere limitar la selección a un usuario, puede usar https://graph.microsoft.com/v1.0/users?$filter=mail eq 'contosouser1@contoso.com'.
La consulta devuelve solo los usuarios dentro de la organización de Microsoft 365 que está consultando. No se devuelven los usuarios invitados ni los buzones que no son de usuarios.
Filtrado
Puede limitar los resultados que se extraen de la consulta mediante las propiedades de fecha y hora. Según el tipo de datos solicitado, es posible que necesite un filtro de fecha y hora. El filtro DateTime se proporciona mediante las propiedades de SourceDataSet de la actividad de copia de Azure Synapse o Azure Data Factory. Para especificar un filtro de fecha y hora, agregue un nuevo campo dateFilterColumn en typeProperties y establézcalo en una de las propiedades que admiten el filtrado de la tabla siguiente. A continuación, agregue un valor startTime y endTime que represente los valores DateTime sobre los que se filtra la propiedad.
Los siguientes conjuntos de datos requieren un filtro en una de las propiedades de fecha y hora correspondientes.
| Nombre del conjunto de datos | Propiedades que admiten el filtrado |
|---|---|
| BasicDataSet_v0.Event_v0 BasicDataSet_v0.Event_v1 |
CreatedDateTime LastModifiedDateTime |
| BasicDataSet_v0.Message_v0 BasicDataSet_v0.Message_v1 |
CreatedDateTime LastModifiedDateTime ReceivedDateTime SentDateTime |
| BasicDataSet_v0.SentItem_v0 BasicDataSet_v0.SentItem_v1 |
CreatedDateTime LastModifiedDateTime ReceivedDateTime SentDateTime |
Nota:
Las canalizaciones que requieren BasicDataSet_v0.CalendarView_v0 también requieren un filtro de fecha y hora, pero no se especifica dateFilterColumn en el SourceDataSet. Sin embargo, startTime y endTime son necesarios y solo se proporcionan los eventos que empiecen después de la startTime y finalicen antes de la endTime.