O Microsoft Graph Data Connect é compatível com a seleção de usuário e filtragemUser selection and filtering Microsoft Graph data connect supports

Você pode usar o Microsoft Graph Data Connect para selecionar os usuários cujos dados serão extraídos, e para aplicar filtros para limitar os dados retornados.You can use Microsoft Graph data connect to select the users that you want to extract data for, and to include filters to limit the data returned. Este artigo descreve as opções que o Data Connect suporta para filtragem e seleção do usuário.This article describes the user selection options that data connect provides and the filtering that it supports.

Seleção de usuárioUser selection

Você pode executar pipelines em um conjunto de usuários.You can run pipelines on a set of users. As opções para seleção de usuário são as seguintes:The following are the options for user selection:

  • Todos os usuários da organizaçãoAll users within the organization
  • Execução em grupos de até dez usuários da organizaçãoUp to 10 groups of users within the organization to run on
  • Um conjunto de usuários com base em um predicado com as propriedades de usuário do Azure Active DirectoryA set of users based on a predicate consisting of Azure Active Directory user properties

Especifique a seleção de usuários em OrigemDoConjuntoDeDados da atividade de cópia do Azure Data Factory.Specify your user selection in the SourceDataSet of the Azure Data Factory copy activity. Para executar em uma lista de grupos, adicione um novo campo GruposPermitidos em PropriedadesDoTipo e aplique essa definição para uma lista de até dez IDs de objeto de um grupo, separados por vírgulas.To run on a list of groups, add a new field allowedGroups under typeProperties and set this to a list of up to 10 groups' Object Ids separated by commas. Se nenhum grupo for especificado por padrão, os dados serão extraídos da organização inteira.If no groups are specified by default, data will be extracted for the entire organization.

Para especificar um predicado para executar no locatário inteiro, adicione um novo campo EscopoDeFiltroUriDoUsuário em PropriedadesDoTipo e o defina no predicado.To specify a predicate to run on the entire tenant, add a new field userScopeFilterUri under typeProperties and set this to the predicate. O formato do predicado deve coincidir com o formato de consulta de APIs do Microsoft Graph.The predicate format should match the query format of Microsoft Graph APIs. Se você quiser limitar a seleção para os usuários que funcionam no departamento de finanças, você pode usar https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance', por exemplo.For example, if you want to limit the selection to users who work in the Finance department, you can use https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'. Se desejar limitar a seleção a um usuário, você pode usar o https://graph.microsoft.com/v1.0/users?$filter=mail eq 'contosouser1@contoso.com'.If you want to limit the selection to one user, you can use https://graph.microsoft.com/v1.0/users?$filter=mail eq 'contosouser1@contoso.com'.

A consulta retornará somente usuários dentro da organização do Microsoft 365 que você está pesquisando.Your query will only return users within the Microsoft 365 organization that you're querying. Os usuários convidados e caixas de correio que não são de usuários não serão retornadas.Guest users and non-user mailboxes will not be returned.

FiltragemFiltering

Você pode limitar os resultados extraídos de sua consulta usando as propriedades de data e hora.You can limit the results extracted for your query using DateTime properties. Dependendo do tipo de dado solicitado, talvez seja necessário um filtro de data e hora.Depending on the type of data requested, a DateTime filter might be required. O filtro de data e hora é fornecido usando as propriedades OrigemDoConjuntoDeDados da atividade de cópia do Azure Data Factory.The DateTime filter is provided using properties in the SourceDataSet of the Azure Data Factory copy activity. Para especificar um filtro de data e hora, adicione um novo campo FiltroDeColunaDeData em PropriedadesDoTipo e aplique essa definição para uma das propriedades de suporte à filtragem na tabela a seguir.To specify a DateTime filter, add a new field dateFilterColumn under typeProperties and set this to one of the properties that support filtering in the following table. Em seguida, adicione uma hora de início e hora de término que representam os valores de data e hora que a propriedade será filtrada.Next, add a startTime and endTime that represent the DateTime values that the property will be filtered upon.

Os conjuntos de dados a seguir exigem que um filtro seja fornecido em uma das propriedades de data e hora correspondentes.The following datasets require a filter to be provided on one of the corresponding DateTime properties.

Nome do conjunto de dadosDataset name Propriedades de suporte à filtragemProperties that support filtering
BasicDataSet_v0.Event_v0BasicDataSet_v0.Event_v0
BasicDataSet_v0.Event_v1BasicDataSet_v0.Event_v1
DataeHoraDaCriaçãoCreatedDateTime
DataeHoraDaÚltimaModificaçãoLastModifiedDateTime
BasicDataSet_v0.Message_v0BasicDataSet_v0.Message_v0
BasicDataSet_v0.Message_v1BasicDataSet_v0.Message_v1
DataeHoraDaCriaçãoCreatedDateTime
DataeHoraDaÚltimaModificaçãoLastModifiedDateTime
DataeHoraRecebidaReceivedDateTime
DataeHoraEnviadaSentDateTime
BasicDataSet_v0.SentItem_v0BasicDataSet_v0.SentItem_v0
BasicDataSet_v0.SentItem_v1BasicDataSet_v0.SentItem_v1
DataeHoraDaCriaçãoCreatedDateTime
DataeHoraDaÚltimaModificaçãoLastModifiedDateTime
DataeHoraRecebidaReceivedDateTime
DataeHoraEnviadaSentDateTime

Observação Os pipelines que solicitam BasicDataSet_v0.CalendarView_v0 também exigem um filtro de data e hora, mas nenhum FiltroDeColunaDeData é especificado na OrigemDoConjuntoDeDados.Note Pipelines requesting BasicDataSet_v0.CalendarView_v0 also require a DateTime filter, but no dateFilterColumn is specified in the SourceDataSet. No entanto, uma hora de início e hora de término são obrigatórios e somente eventos que começam após a hora de início e que terminam antes da hora de término são fornecidos.However, a startTime and endTime are required and only events that begin after the startTime and finish before the endTime are provided.

Próximos passosNext Steps

Para saber mais sobre como modificar o usuário selecionado para extração e filtragem nos pipelines do Data Connect, confira a documentação do conector do Office 365 do Azure Data Factory.For more information about how to modify the user selected for extractoin and filtering in data connect pipelines, see the Azure Data Factory Office 365 connector documentation.