Importar dados organizacionais usando a importação baseada em API (versão prévia)

Importante

Esse recurso é somente para clientes de visualização pública. Os recursos da versão prévia podem não estar completos e podem sofrer alterações antes de serem disponibilizados na versão mais ampla.

Você pode importar dados organizacionais para aplicativos e serviços do Microsoft 365 por meio de uma importação de dados baseada em API configurada por você e seu Administrador Global do Microsoft 365. Veja como.

Com uma importação baseada em API, você traz dados do seu sistema de origem para a API do Microsoft 365 por meio de um arquivo .csv. Você pode:

• Crie um aplicativo personalizado para exportar dados do sistema de origem para um arquivo .csv. Em seguida, usando o mesmo aplicativo, importe esses dados usando as informações da API nestes artigos.

• Crie um aplicativo personalizado para exportar dados do sistema de origem para um arquivo .csv. Em seguida, execute um aplicativo de console C# que criamos para importar dados para o Serviço de Dados Organizacionais do Microsoft 365.

• Crie um aplicativo personalizado para exportar dados do sistema de origem para um arquivo .csv. Em seguida, execute um script do PowerShell que criamos para importar dados para o Serviço de Dados Organizacionais do Microsoft 365.

• Use um modelo de Azure Data Factory (ADF) para enviar dados para a importação baseada em API.

• Execute um script de nó para recuperar tokens OAuth. Em seguida, use esses tokens para enviar dados diretamente de uma fonte externa, como o Workday, para a importação baseada em API.

Antes de configurar a conexão, você precisa coordenar algumas tarefas entre você e seu administrador global. Consulte o Fluxo de trabalho abaixo para obter uma visão geral das etapas e instruções necessárias e links para os artigos relevantes.

Fluxo de trabalho

1. Configurar a conexão entre a fonte de dados e o Serviço de Dados Organizacionais do Microsoft 365

Função	Etapas (em ordem)
Administrador Global do Microsoft 365	Registre um novo aplicativo no centro de administração do Microsoft Entra e compartilhe a ID do aplicativo com o administrador da fonte de dados.
Administrador da Fonte de Dados Organizacional ou administrador do sistema de origem HRIS	Gere um certificado de segurança, segredo ou credencial federada e compartilhe-o com o administrador global.
Administrador Global do Microsoft 365 ou Administrador da Fonte de Dados Organizacional	1. Configure uma importação segura no Centro de administração do Microsoft 365 usando a ID de registro do aplicativo compartilhada acima. 2. Configure o acesso e o mapeamento de atributos. 3. Valide os dados.

Veja as instruções detalhadas.

2. Chamar a API do Microsoft 365 para transferir dados organizacionais

Função	Etapas (em ordem)
Administrador Global do Microsoft 365 ou Administrador da Fonte de Dados Organizacional ou Administrador do Sistema de Origem HRIS	Prepare e exporte seus dados do sistema de origem em uma frequência definida.
Administrador Global do Microsoft 365 ou Administrador da Fonte de Dados Organizacional ou Administrador do Sistema de Origem HRIS	Chame a API do Microsoft 365 para transferir dados organizacionais da fonte de dados para o Serviço de Dados Organizacionais do Microsoft 365 usando: Script C# ou Powershell ou aplicativo personalizado Uma integração em sua fonte externa como o Workday usando tokens OAuth recuperados de um script do Node Repositório GitHub para script C# e Powershell de exemplo e script do Nó para recuperar tokens O modelo do ADF

Veja as instruções detalhadas.

3. Fazer alterações na conexão ou nos dados

Função	Etapas
Administrador Global do Microsoft 365 ou Administrador da Fonte de Dados Organizacional	Editar .csv arquivo e mapear Editar acesso a atributos e mapeamento de atributos Editar nome da conexão ou ID do aplicativo

Veja as instruções detalhadas.