Fonctionnalités de sélection d’utilisateurs et de filtrage de données dans la Connexion aux données Microsoft Graph

  • Article

Vous pouvez utiliser Microsoft Graph Data Connect pour sélectionner les utilisateurs pour lesquels vous souhaitez extraire des données et inclure des filtres pour limiter les données renvoyées. Cet article décrit les options de sélection d’utilisateurs fournies par la Connexion aux données ainsi que le filtrage pris en charge.

Sélection d’utilisateurs

Vous pouvez exécuter des pipelines sur un ensemble d’utilisateurs. Les options de sélection d’utilisateurs sont les suivantes :

  • Tous les utilisateurs de l’organisation
  • Jusqu’à 10 groupes d’utilisateurs de l’organisation
  • Un ensemble d’utilisateurs basé sur un prédicat constitué de Microsoft Entra propriétés utilisateur

Spécifiez votre sélection d’utilisateur dans le SourceDataSet de l’activité de copie Azure Synapse ou Azure Data Factory. Pour une exécution sur une liste de groupes, ajoutez un nouveau champ allowedGroups sous typeProperties et définissez-le sur une liste de 10 ID d’objet de groupes maximum, séparés par des virgules. Si aucun groupe n’est spécifié par défaut, les données sont extraites pour l’ensemble de l’organisation.

Pour spécifier un prédicat à exécuter sur l’ensemble du locataire, ajoutez un nouveau champ userScopeFilterUri sous typeProperties et définissez-le comme prédicat. Le format du prédicat doit correspondre au format de requête des API Microsoft Graph. Par exemple, si vous souhaitez limiter la sélection aux utilisateurs qui travaillent au service financier, vous pouvez utiliser https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'. Si vous voulez limiter la sélection à un seul utilisateur, vous pouvez utiliser https://graph.microsoft.com/v1.0/users?$filter=mail eq 'contosouser1@contoso.com'.

Votre requête renverra uniquement les utilisateurs de l’organisation Microsoft 365 que vous interrogez. Les utilisateurs invités et les boîtes aux lettres qui n’appartiennent pas à des utilisateurs ne seront pas renvoyés.

Filtrage

Vous pouvez limiter les résultats extraits pour votre requête en utilisant des propriétés DateTime. Selon le type de données demandées, un filtre DateTime peut être requis. Le filtre DateTime est fourni à l’aide des propriétés du SourceDataSet de l’activité de copie Azure Synapse ou Azure Data Factory. Pour spécifier un filtre DateTime, ajoutez un nouveau champ dateFilterColumn sous typeProperties et définissez-le sur une propriété qui prend en charge le filtrage dans le tableau suivant. Puis ajoutez une heure de début (startTime) et une heure de fin (endTime) représentant les valeurs DateTime sur lesquelles la propriété sera filtrée.

Les jeux de données suivants exigent qu’un filtre soit fourni sur l’une des propriétés DateTime correspondantes.

Nom du jeu de données Propriétés qui prennent en charge le filtrage
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

Remarque

Les pipelines exigeant BasicDataSet_v0.CalendarView_v0 nécessitent également un filtre DateTime, mais aucun élément dateFilterColumn n’est spécifié dans le champ SourceDataSet. Toutefois, des valeurs startTime et endTime sont requises, et seuls les événements commençant après l’heure startTime et se terminant avant l’heure endTime sont fournis.

Contenu connexe