Поделиться через

Возможности выбора и фильтрации пользователей, поддерживаемые подключением к данным Microsoft Graph

  • Статья

Подключение к данным Microsoft Graph можно использовать, чтобы выбрать пользователей, для которых нужно извлечь данные, и включить фильтры для ограничения возвращаемых данных. В этой статье описаны параметры выбора пользователей, предоставляемые подключением к данным, а также поддерживаемые фильтры.

Выбор пользователей

Вы можете запустить конвейеры для набора пользователей. Параметры выбора пользователей:

  • все пользователи в организации;
  • до 10 групп пользователей в организации;
  • Набор пользователей на основе предиката, состоящего из Microsoft Entra свойств пользователя

Укажите выбор пользователя в SourceDataSet Azure Synapse или Фабрика данных Azure действия копирования. Чтобы выполнить для списка групп, добавьте новое поле allowedGroups в разделе typeProperties и укажите в нем список параметров Object Id не более 10 групп, разделенных запятыми. Если группы по умолчанию не указаны, данные извлекаются для всей организации.

Чтобы указать предикат для выполнения во всем клиенте, добавьте новое поле userScopeFilterUri в разделе typeProperties и присвойте ему значение предиката. Формат предиката должен совпадать с форматом запроса API Microsoft Graph. Например, если нужно ограничить выбор пользователями, работающими в финансовом отделе, можно использовать https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'. Если нужно ограничить выбор одним пользователем, можно использовать https://graph.microsoft.com/v1.0/users?$filter=mail eq 'contosouser1@contoso.com'.

Запрос возвращает только пользователей из организации Microsoft 365, в которой выполняется запрос. Гостевые пользователи и почтовые ящики, не относящиеся к пользователям, не возвращаются.

Фильтрация

Вы можете ограничить результаты, извлекаемые для запроса, с помощью свойств даты и времени. В зависимости от типа запрашиваемых данных может потребоваться фильтр даты и времени. Фильтр DateTime предоставляется с помощью свойств в SourceDataSet Azure Synapse или Фабрика данных Azure действия копирования. Чтобы указать фильтр даты и времени, добавьте новое поле dateFilterColumn в разделе typeProperties и присвойте ему значение одного из свойств, поддерживающих фильтрацию, из таблицы ниже. Затем добавьте startTime и endTime, представляющие значения даты и времени, по которым фильтруется свойство.

Следующие наборы данных требуют предоставления фильтра в одном из соответствующих свойств даты и времени.

Имя набора данных Свойства, поддерживающие фильтрацию
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

Примечание.

Конвейеры, запрашивающие свойство BasicDataSet_v0.CalendarView_v0, также требуют фильтр даты и времени, но в SourceDataSet не указывается поле dateFilterColumn. Однако свойства startTime и endTime являются обязательными, и предоставляются только события, начинающиеся после момента startTime и завершающиеся до момента endTime.

Связанные материалы