Von Microsoft Graph Data Connect unterstützte Funktionen zur Benutzerauswahl und Filter

Sie können Microsoft Graph Data Connect verwenden, um die Benutzer auszuwählen, für die Sie Daten extrahieren, und Filter festlegen, um die zurückgegebenen Daten einzuschränken. In diesem Artikel werden die von Data Connect bereitgestellten Benutzerauswahloptionen und die unterstützten Filter beschrieben.

Benutzerauswahl

Sie können Pipelines auf einer Gruppe von Benutzern ausführen. Folgende Optionen für die Benutzerauswahl gibt es:

• Alle Benutzer in der Organisation
• Bis zu 10 Gruppen von Benutzern innerhalb der Organisation
• Eine Gruppe von Benutzern basierend auf einem Prädikat, das aus Microsoft Entra-Benutzereigenschaften besteht

Geben Sie Ihre Benutzerauswahl im SourceDataSet der Azure Synapse- oder Azure Data Factory-Kopieraktivität an. Um die Kopieraktivität für eine Liste von Gruppen auszuführen, fügen Sie ein neues Feld (allowedGroups) unter typeProperties hinzu, und legen Sie dieses auf eine kommagetrennte Liste von Objekt-IDs von bis zu 10 Gruppen fest. Wenn standardmäßig keine Gruppen angegeben sind, werden Daten für die gesamte Organisation extrahiert.

Um ein Prädikat anzugeben, das für den gesamten Mandanten ausgeführt werden soll, fügen Sie ein neues Feld (userScopeFilterUri) unter typeProperties hinzu, und legen Sie dieses auf das Prädikat fest. Das Prädikatsformat sollte dem Abfrageformat von Microsoft Graph-APIs entsprechen. Wenn Sie die Auswahl beispielsweise auf Benutzer beschränken möchten, die in der Finanzabteilung arbeiten, können Sie https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance' verwenden. Wenn Sie die Auswahl auf einen Benutzer einschränken möchten, können Sie https://graph.microsoft.com/v1.0/users?$filter=mail eq 'contosouser1@contoso.com'verwenden.

Ihre Abfrage liefert nur Benutzer innerhalb der Microsoft 365-Organisation, die Sie abfragen. Postfächer von Gastbenutzern und Nichtbenutzern werden nicht zurückgegeben.

Filtern

Sie können die für Ihre Abfrage extrahierten Ergebnisse mit DateTime-Eigenschaften einschränken. Abhängig von der Art der angeforderten Daten kann ein DateTime-Filter erforderlich sein. Der DateTime-Filter wird mithilfe von Eigenschaften im SourceDataSet der Azure Synapse- oder Azure Data Factory-Kopieraktivität bereitgestellt. Um einen DateTime-Filter festzulegen, fügen Sie ein neues Feld (dateFilterColumn) unter typeProperties hinzu, und legen Sie dieses in der folgenden Tabelle auf eine der Eigenschaften fest, die Filtern unterstützen. Als Nächstes fügen Sie eine Startzeit (startTime) und eine Endzeit (endTime) für die DateTime-Werte hinzu, nach denen die Eigenschaft gefiltert wird.

Für die folgenden Datasets muss ein Filter auf eine der entsprechenden DateTime-Eigenschaften angewendet werden.

Datasetname	Eigenschaften, die das Filtern unterstützen
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

Hinweis

Pipelines, die „BasicDataSet_v0.CalendarView_v0“ anfordern, benötigen zusätzlich einen DateTime-Filter, aber im Quelldataset (SourceDataSet) wird keine Datenfilterspalte (dateFilterColumn) angegeben. Eine Startzeit und eine Endzeit werden jedoch benötigt, und nur Ereignisse, die nach derStartzeit beginnen und vor der Endzeit enden, werden bereitgestellt.

Verwandte Inhalte

Häufig gestellte Fragen zu Data Connect