Partilhar via

Opção 4: Utilizar o modelo de Azure Data Factory para enviar dados para a nossa importação baseada em API

Siga os passos abaixo para utilizar um modelo Azure Data Factory para enviar dados para a importação baseada em API.

1. Criar novos Azure Data Factory

  1. Inicie sessão em https://adf.azure.com/en/datafactories.

  2. Crie uma nova fábrica de dados ou utilize uma fábrica de dados existente. Preencha os campos e, em seguida, selecione Criar.

    Captura de ecrã que mostra como criar uma nova fábrica de dados ou utilizar uma existente.

2. Criar um novo pipeline e atividade

  1. Crie um novo pipeline e introduza um nome para o pipeline.

    Captura de ecrã que mostra como criar um novo pipeline.

  2. Em Atividades, adicione Copiar dados.

    Captura de ecrã que mostra como adicionar dados de cópia.

3. Copiar definições de atividade de dados: Geral

Selecione a atividade Copiar dados e, em seguida, selecione Geral para concluir cada campo com a documentação de orientação abaixo.

Captura de ecrã que mostra como copiar as definições de atividade de dados.

  • Nome: introduza um nome para a sua atividade.
  • Descrição: introduza uma descrição para a sua atividade.
  • Estado da atividade: selecione Ativado. Em alternativa, selecione Desativado para excluir a atividade da execução e validação do pipeline.
  • Tempo limite: esta é a quantidade máxima de tempo que uma atividade pode ser executada. A predefinição é 12 horas, o mínimo é 10 minutos e o tempo máximo permitido é de sete dias. O formato está em D.HH:MM:SS.
  • Repetir: o número máximo de tentativas de repetição. Isto pode ser deixado como 0.
  • Intervalo de repetição (seg.): o número máximo de tentativas de repetição. Isto pode ser deixado como 30 se a tentativa de repetição estiver definida como 0.
  • Saída segura: quando selecionada, o resultado da atividade não é capturado no registo. Pode deixar esta opção desmarcada.
  • Entrada segura: quando selecionada, a entrada da atividade não é capturada no registo. Pode deixar esta opção desmarcada.

4. Copiar definições de atividade de dados: Origem

  1. Selecione Origem.

  2. Selecione um conjunto de dados de origem existente ou selecione +Novo para criar um novo conjunto de dados de origem. Por exemplo, em Novo conjunto de dados, selecione Armazenamento de Blobs do Azure e, em seguida, selecione o tipo de formato dos seus dados.

    Captura de ecrã que mostra como criar um novo conjunto de dados de origem.

  3. Defina as propriedades do ficheiro .csv. Introduza um Nome e, em Serviço ligado, selecione uma localização existente ou selecione +Novo.

    Captura de ecrã que mostra como definir as propriedades do ficheiro csv.

  4. Se tiver selecionado +Novo, introduza os detalhes do novo serviço ligado com a documentação de orientação abaixo.

    Captura de ecrã que mostra como adicionar detalhes para o novo serviço ligado.

  5. Junto a Conjunto de dados de origem, selecione Abrir.

    Captura de ecrã que mostra como abrir o conjunto de dados de origem.

  6. Selecione Primeira linha como cabeçalho.

    Captura de ecrã que mostra como selecionar a primeira linha como cabeçalho.

5. Copiar definições de atividade de dados: Sink

  1. Selecione Sink.

  2. Selecione +Novo para configurar um novo recurso rest para ligar à API. Procure "Descansar" e selecione Continuar.

    Captura de ecrã que mostra como configurar um novo recurso rest para ligar à API.

  3. Dê um nome ao serviço. Em Serviço ligado, selecione +Novo.

    Captura de ecrã que mostra como atribuir um nome ao serviço e adicionar um novo serviço ligado.

  4. Procure "Descansar" e selecione-o.

    Captura de ecrã que mostra como procurar o conjunto de dados Rest.

  5. Introduza os campos com a documentação de orientação abaixo.

    Captura de ecrã a mostrar como introduzir os campos do conjunto de dados.

  • Nome: introduza um nome para o novo serviço ligado.
  • Descrição: introduza uma descrição para o novo serviço ligado.
  • Ligar através do runtime de integração: introduza o método preferencial.
  • URL base: utilize o URL abaixo e substitua {tenantid} pelo seu ID de inquilino: https://api.orginsights.viva.office.com/v1.0/tenants/{tenantid}/modis/connectors/HR/ingestions/fileIngestion
  • Tipo de autenticação: selecione o tipo de autenticação como Principal de serviço e, em seguida, selecione Segredo ou Certificado. Exemplo do principal de serviço:

    • Inline: selecione-o.

    • ID do principal de serviço: introduza o ID da Aplicação autorizado para o conector da API.

    • Chave do principal de serviço: introduza a chave.

      Captura de ecrã que mostra como introduzir a chave do principal de serviço.

    • Inquilino: introduza o ID do inquilino.

    • Microsoft Entra ID recurso:https://api.orginsights.viva.office.com

    • Azure tipo de cloud: selecione o tipo de cloud Azure.

    • Validação do certificado de servidor: selecione Ativado.

  1. Introduza as definições de Sink com a documentação de orientação abaixo.

    Captura de ecrã que mostra como introduzir as definições de Sink.

  • Conjunto de dados sink: selecione o conjunto de dados existente ou criado recentemente.
  • Método do pedido: selecione POST.
  • Tempo limite do pedido: cinco minutos é a predefinição.
  • Intervalo do pedido (ms): 10 é a predefinição.
  • Tamanho do lote de escrita: o tamanho do lote deve ser superior ao número máximo de linhas no ficheiro.
  • Tipo de compressão Http: Nenhum é a predefinição. Em alternativa, pode utilizar gZip.
  • Cabeçalhos adicionais: selecione +Novo.
    • Caixa 1: x-nova-scaleunit
    • Valor: pode obter o valor ao navegar para a página Ligações de Dados na página Dados Organizacionais no Microsoft 365(>Migração da Configuração> iniciale importaDados Organizacionais > nasLigações de Dados doMicrosoft 365>). Em seguida, selecione Nova importação> Selecionar tipo > de ligação Iniciar configuração> baseada em APIConfigurar a página de ligação baseada em API.

6. Copiar definições de atividade de dados: Mapeamento

  1. Selecione Mapeamento.

  2. Para o carregamento do bootstrap, certifique-se de que inclui PersonId, ManagerId e Organização no mapeamento (nome de destino). Para o carregamento incremental, verifique se os nomes de destino são consistentes com os do carregamento anterior, juntamente com PersonId. Não pode efetuar carregamentos incrementais com novas colunas e o PersonId é necessário em todos os carregamentos.

    Captura de ecrã que mostra como introduzir definições de atividade para Mapeamento.

7. Copiar definições de atividade de dados: Definições e Propriedades do Utilizador

Não são necessárias outras personalizações para Definições ou Propriedades do Utilizador. Se for necessário, pode editar estas definições caso a caso.

8. Atividade de cópia de dados: Configuração do Acionador (Automatização)

Para adicionar um acionador à configuração da automatização, selecione Adicionar acionador. A automatização recomendada é semanal. Também pode personalizar a frequência.

Captura de ecrã que mostra como configurar o Acionador.

Efetuar alterações à ligação ou aos dados

  • Last updated on