Partilhar via

Importar dados de negócio com a importação de blobs do Azure (pré-visualização)

  • Artigo

Importante

Esta funcionalidade destina-se apenas a clientes de pré-visualização pública. As funcionalidades em pré-visualização podem não estar concluídas e podem sofrer alterações antes de ficarem disponíveis na versão mais abrangente.

Carregar dados de negócio para Viva Insights ajuda-o a compreender como a utilização da Copilot influencia os resultados de negócio mais importantes para a sua organização. Os resultados de negócio podem incluir métricas de produtividade ao nível da tarefa e do trabalho, como o número de e-mails enviados pela sua equipa de vendas ou o número de negócios fechados. Veja a nossa documentação separada sobre o relatório Copilot Business Outcome (Copilot Business Impact) para saber mais.

Pode carregar dados de negócio na aplicação de informações avançadas do Microsoft Viva Insights de uma de duas formas: através de ficheiros .csv individuais que o utilizador, enquanto Administrador de Informações, carrega diretamente para Viva Insights; ou através de uma importação de blobs do Azure que o utilizador, o administrador do sistema de origem e a configuração do Azure contribuidor.

Este artigo abrange a segunda opção, importação de blobs do Azure.

Com uma importação de blobs do Azure, o Proprietário ou Contribuidor da Conta de Armazenamento da subscrição do Azure (com Administrador de Controle de Acesso Baseado em Funções) cria uma nova conta de Armazenamento com um contentor de blobs no portal do Azure e o administrador do sistema de origem configura uma exportação periódica de um ficheiro de .csv para a localização do contentor de blobs. Em seguida, pode configurar Viva Insights para extrair automaticamente dados de negócio do ficheiro .csv nesta localização.

Fluxo de trabalho

  1. Configuração:

    1. O Proprietário da subscrição do Azure cria um contentor de blobs seguro no portal do Azure. A localização do arquivo de blobs deve ser segura para dados empresariais confidenciais e tem de ser configurada na subscrição do Azure do cliente.

    2. Se o contribuidor do Azure preferir a autorização do principal de serviço, o contribuidor do Azure autoriza o principal de serviço e fornece o URL do blob ao administrador do Insights e ao administrador do sistema de origem ao partilhá-lo de forma segura. Se o contribuidor do Azure não preferir a autorização do principal de serviço, geram um URL de SAS e fornecem-no ao administrador do Insights e ao administrador do sistema de origem.

    3. O administrador do sistema de origem prepara os dados num ficheiro .csv e configura uma exportação periódica do ficheiro do sistema de origem de RH para o contentor de blobs.

    4. O administrador do Insights introduz o URL na aplicação Viva Insights para ativar a importação a partir da localização do arquivo de blobs do Azure. O Insights Administração também carrega o ficheiro de mapeamento para os dados de negócio.

  2. Validação: Viva Insights valida os dados. (Se a validação não for bem-sucedida, pode escolher entre algumas opções descritas em Falha de validação.)

  3. Processamento: Viva Insights processa os dados. (Se o processamento não for bem-sucedido, pode escolher entre algumas opções descritas em Falha no processamento.)

    Depois de os dados validarem e processarem com êxito, a tarefa global de importação de dados é concluída.

Tutorial de vídeo

Configurar

1. Criar um contentor de blobs seguro

Aplica-se a: Proprietário da Subscrição do Azure com, pelo menos, permissões de Contribuidor de Dados do Blob de Armazenamento ao nível da conta

  1. Abra um browser e inicie sessão no portal do Azure da sua organização.

  2. Em Serviços do Azure, selecione Contas de armazenamento.

  3. Em Contas de armazenamento no canto superior esquerdo, selecione Criar para configurar uma nova conta de armazenamento.

  4. Em Detalhes do projeto, utilize as predefinições.

  5. Em Detalhes da instância, introduza o nome de uma conta de armazenamento e selecione a sua região. Para o Serviço primário, utilize a conta de Armazenamento gen 2 que suporta o espaço de nomes hierárquico. Saiba mais sobre como criar uma conta de armazenamento do Azure.

  6. Para Desempenho e Redundância, pode utilizar as predefinições, a menos que precise de fazer alterações.

  7. Na parte inferior, selecione Seguinte para aceder à secção Avançadas.

  8. Na página Avançadas, selecione Exigir transferência segura para operações da API REST e Ativar o acesso à chave da conta de armazenamento. Para "Versão mínima do TLS", selecione, pelo menos , a Versão 1.2. Selecione Ativar espaço de nomes hierárquico.

  9. Para todas as outras definições Avançadas, pode utilizar as predefinições, a menos que precise de fazer alterações.

  10. Na parte inferior, selecione Seguinte: Rede.

  11. Em Conectividade de rede, selecione Ativar acesso público a partir de todas as redes.

  12. Em Encaminhamento de rede, selecione a sua preferência de encaminhamento.

  13. Na parte inferior, selecione Seguinte: Proteção de dados.

  14. Na página Proteção de dados, pode utilizar as predefinições, a menos que precise de fazer alterações.

  15. Na parte inferior, selecione Seguinte: Encriptação.

  16. Na página Encriptação, pode utilizar as predefinições, a menos que precise de fazer alterações.

  17. Na parte inferior, selecione Seguinte: Etiquetas.

  18. Opcional: adicione etiquetas à conta.

  19. Na parte inferior, selecione Seguinte: Rever.

  20. Reveja as suas seleções. Em seguida, na parte inferior esquerda, selecione Criar.

  21. Na página seguinte, será apresentada uma mensagem a indicar "A implementação está em curso". Assim que a implementação estiver concluída, a sua conta de armazenamento e as respetivas definições serão apresentadas.

  22. À esquerda, em Armazenamento de dados, selecione Contentores.

  23. Para criar um novo contentor, na parte superior, selecione Contentor. Em seguida, à direita, introduza um nome para o contentor, como "myCustomData". Na parte inferior, selecione Criar.

2. Autorizar o contentor de blobs

Aplica-se a: Proprietário da Subscrição do Azure com, pelo menos, permissões de Contribuidor de Dados do Blob de Armazenamento ao nível da conta

Em seguida, terá de criar um URL de SAS de blob ou autorizar o principal de serviço do Workplace Analytics . A autorização do principal de serviço é a abordagem recomendada e mais segura. O token de SAS de blob não tem quaisquer capacidades de auditoria incorporadas. Siga os passos adequados abaixo para o método que escolher.

Para autorização do principal de serviço

  1. No painel esquerdo, selecione Controle de Acesso.

  2. Na parte superior, selecione Atribuições de funções. Selecione Adicionar e, em seguida, selecione Adicionar atribuição de função.

  3. Na lista de funções, localize e selecione Contribuidor de Dados do Blob de Armazenamento.

  4. Junto a Membros, selecione Selecionar membros. No campo de pesquisa à direita, introduza Workplace Analytics e selecione-o.

  5. No canto inferior esquerdo, selecione Rever + atribuir.

  6. No painel esquerdo, em Armazenamento de dados, selecione Contentores.

  7. Selecione o contentor de armazenamento que criou nos passos acima.

  8. No painel esquerdo, em Definições, selecione Propriedades.

  9. Copie e partilhe de forma segura o URL com o administrador do Insights.

  10. Informe o administrador do sistema de origem, quem irá preencher os dados neste contentor. Precisarão de acesso de Contribuidor de Dados do Blob de Armazenamento.

Para autorização de URL de SAS

  1. Quando for apresentado o novo contentor de armazenamento que criou, selecione-o. Em seguida, à esquerda, em Definições, selecione Política de acesso.

  2. Em Políticas de acesso armazenadas, selecione Adicionar política. Forneça um identificador exclusivo, como "BlobStoreVivaInsights". Selecione Permissões de Leitura e Lista . Selecione uma hora de início alguns minutos no passado e uma hora de fim daqui a um ano. Selecione OK.

  3. À esquerda, em Definições, selecione Tokens de acesso partilhado.

  4. Pode utilizar a opção predefinida em Chave de assinatura. Em Política de acesso armazenada, selecione a política criada acima. Isto irá preencher automaticamente a janela de expiração e a lista de permissões.

  5. Para Endereços IP permitidos e Protocolos permitidos, pode utilizar as predefinições.

  6. Selecione Gerar token e URL de SAS.

  7. Copie e partilhe de forma segura o URL de SAS do blob com o administrador do Insights.

  8. Informe o administrador do sistema de origem, quem irá preencher os dados neste contentor. Precisarão de acesso de Contribuidor de Dados do Blob de Armazenamento.

3. Configure Viva Insights para importar dados da localização do blob

Aplica-se a: Administrador de informações

Os dados de negócio provavelmente têm origens de dados diferentes e podem ser atualizados com base em agendas diferentes. As métricas de atividade de satisfação e vendas do cliente, por exemplo, podem ter sistemas de origem e administradores de origem diferentes. Deve configurar uma ligação de blob separada para cada uma destas ligações, que Viva Insights se refere como "conjuntos de dados".

  1. Inicie a importação a partir de um de dois locais na aplicação de informações avançadas: a página Hub de dados ; ou página Dados de negócio em Configuração da Plataforma.

    • A partir do Data Hub:

      1. No painel direito, em Origens de dados de negócio, selecione Importação de Blobs do Azure.
      2. Selecione Iniciar.

    • Na página Dados de negócio :

      1. Selecione Gerir origens de dados e, em seguida, selecione Importação de Blobs do Azure.
      2. Selecione Iniciar.

  2. Na página Ligação de Blobs do Azure, em Nome da ligação, introduza um nome exclusivo para a importação.

  3. Em Tipo de autorização, selecione Autorização do Principal de Serviço ou Autorização de URL de SAS. A sua seleção depende do método de autorização utilizado pela sua contribuidor do Azure no Passo 2 acima.

  4. Introduza o URL de SAS do Blob ou o URL do Blob para a importação que lhe foi fornecida pela contribuidor do Azure no Passo 2.

  5. Carregue um ficheiro metadata.json, com as entradas descritas abaixo:

    • Para carregamentos incrementais e acesso fácil a estes dados, introduza um "Nome do conjunto de dados" e "Tipo de conjunto de dados" para este conjunto de dados. Por exemplo, pode carregar dois conjuntos de dados diferentes da sua equipa de vendas na satisfação do cliente e na retenção da conta. Pode atribuir o tipo "Vendas" a estes conjuntos de dados e dar-lhes o nome "CSAT" e "Conta". Os analistas podem detetar estes dados ao procurar o respetivo nome e tipo durante a configuração de consultas. O nome e o tipo do conjunto de dados não devem conter espaços.

    • "Dataset type": o nome da categoria de dados, como "Dados de vendas". Pode atribuir qualquer tipo exclusivo, exceto estes tipos reservados do sistema: "Inquérito", "CRM", "Pessoa", "Sinal", "AnalystUploadedData", "UserSkills", "HeirarchicalSkills", "RelatedSkills", "SkillsLibrary", "ManagerHierarchy", "Learning", "None", "InteractiveExplorationPersonOutput", "None"

    • "Dataset name": nome exclusivo que representa uma tabela específica na categoria de dados. Caso o seu tipo de conjunto de dados tenha o nome "SalesData", um conjunto de dados de exemplo pode ser "Negócios", "Inventário" ou "Encomendas".

    • "IsBootstrap": esta opção está definida como Falso por predefinição. Defina como Verdadeiro apenas se quiser substituir uma tabela carregada anteriormente (veja Nome do conjunto de dados).

    • "ColumnMap": para além dos campos necessários de PersonId e StartDate, inclua os campos personalizados do ficheiro .csv. Para campos personalizados, tem de incluir um nome e um tipo de dados.

      • As etiquetas utilizadas para as colunas de origem denominadas "BusinessMetric1", "BusinessMetric2" e "BusinessMetric3" devem corresponder aos nomes das colunas no seu ficheiro de .csv.

      • A propriedade "name" deve representar os nomes que pretende ver refletidos na saída do relatório. Certifique-se de que as etiquetas que escolher seguem estas regras.

      • Tem duas opções para especificar o "tipo":

        • Introduza "int32" se os valores de dados consoante os números inteiros
        • Introduza "double" se os valores de dados incluírem pontos decimais

    Observação

    Terá de carregar dados numéricos de resultados de negócio para serem utilizados em qualquer um dos relatórios em informações avançadas.

    Eis um ficheiro de metadados de exemplo:

    { 
  "DatasetType": "SalesData", 
  "IsBootstrap": "false", 
  "properties": { 
    "DatasetName":  "Deals" 
  }, 
  "ColumnMap": { 
    "StartDate": { 
      "name": "StartDate", 
      "type": "DateTime_MMDDYYYY" 
    }, 
    "PersonId": { 
      "name": "PersonId", 
      "type": "EmailType" 
    }, 
    "BusinessMetric1": { 
      "name": " Metric1", 
      "type": "int32" 
    }, 
    "BusinessMetric2": { 
      "name": " Metric2", 
      "type": "int32" 
    }, 
    "BusinessMetric3": { 
      "name": " Metric3", 
      "type": "double" 
    } 
  } 
}

    Por exemplo, digamos que o administrador do sistema de origem utiliza "PipelineGenerated" para capturar o número de ofertas criadas. O código seria:

    "PipelineGenerated": { 

"name": "DealsCreated", 

"type": "int32" 

}

    Quando carrega os dados, os dados são registados como "PipelineGenerated" do tipo de número inteiro. Certifique-se de que carrega um resultado numérico. Saiba mais sobre como configurar o ficheiro de dados de negócio.

  6. Selecione Enviar.

  7. Se vir uma mensagem de erro, marcar para se certificar de que seguiu todos os passos descritos acima e marcar para garantir que o URL de SAS do blob ou o URL do blob introduzido está correto. Selecione Repetir.

4. Preparar o ficheiro de dados de negócio e enviar para o arquivo de blobs

Aplica-se a: Proprietário da Subscrição do Azure com, pelo menos, permissões de Contribuidor de Dados do Blob de Armazenamento ao nível da conta

Tarefa 1 - Preparar os seus dados

Primeiro, crie um ficheiro de .csv separado para cada conjunto de dados. Veja o modelo de .csv de exemplo para obter orientações e estrutura de dados para evitar problemas comuns, como demasiados ou poucos valores exclusivos, campos redundantes, formatos de dados inválidos e muito mais.  Saiba mais sobre regras de ficheiros e erros de validação.

Estrutura os dados desta forma:

  • Adicionar todos os campos que pretende importar para o ficheiro

  • Os campos obrigatórios são "PersonId" e "StartDate"

  • Todos os dados de negócio devem ser contabilizados ao nível mensal e por pessoa

  • "StartDate" deve representar os dados de um mês e a data deve representar o primeiro do mês. Por exemplo, janeiro de 2024 deve ser representado como 1/1/2024. Recomenda-se pelo menos três meses de dados empresariais.

  • Adicione uma coluna para cada métrica de resultado de negócio que pretende analisar.

  • Terá de carregar dados numéricos de resultados de negócio para serem utilizados em qualquer um dos relatórios em informações avançadas.

Observação

Os ficheiros que forem removidos antes da criação da ligação e do carregamento de mapeamento não serão recolhidos pelo Viva Insights. Por conseguinte, certifique-se de que estabelece a ligação primeiro antes de remover o ficheiro.

Tarefa 2 - Exportar dados do sistema de origem para o arquivo de Blobs

Recurso necessário: o ficheiro .csv criado na tarefa anterior

Com a frequência que decidir, exporte programaticamente os dados de negócio do seu sistema de origem como um ficheiro de .csv para o seu arquivo de blobs. Em alternativa, pode carregar o ficheiro .csv para o arquivo de Blobs manualmente no portal do Azure.

5. Validação

Aplica-se a: Administrador de informações

Depois de o administrador do sistema de origem exportar os dados e configurar a importação, a aplicação começa a validar. Na maioria dos casos, a validação de ficheiros deve ser concluída rapidamente.

Após a conclusão desta fase, a validação teve êxito ou falhou. Consoante o resultado, receberá uma status de êxito ou uma falha status na tabela Histórico de importações em Dados de negócio. 

Para obter informações sobre o que acontece a seguir, aceda à secção adequada:

A validação é bem-sucedida

Após a validação bem-sucedida, Viva Insights começa a processar os seus novos dados. O processamento pode demorar entre algumas horas e um dia ou mais. Durante o processamento, verá uma status "A Processar" na tabela Histórico de importações.

Após o processamento estar concluído, significa que foi bem-sucedido ou falhou. Consoante o resultado, encontrará uma status "Êxito" ou "Com Falhas" na tabela Histórico de importações.

O processamento é bem-sucedido

Quando encontrar a status "Êxito" na tabela Histórico de importações, o processo de carregamento é concluído. Depois de receber a status "Êxito", pode:

  • Selecione o ícone de vista (olho) para ver um resumo dos resultados da validação.

  • Selecione o ícone de mapeamento para ver as definições de mapeamento do fluxo de trabalho.

O processamento falha

Se o processamento falhar, encontrará uma status "A processar falhou" na tabela Histórico de importações. Para que o processamento seja bem-sucedido, o administrador do sistema de origem tem de corrigir erros e enviar os dados para Viva Insights novamente.

Observação

Geralmente, as falhas de processamento devem-se a erros de back-end. Se estiver a ver falhas de processamento persistentes e tiver corrigido os dados no ficheiro importado, registe um pedido de suporte connosco.

Falha na validação

Se a validação de dados falhar, verá uma status "Falha na validação" na tabela Histórico de importações. Para que a validação seja bem-sucedida, o administrador do sistema de origem tem de corrigir erros e reenviar os dados para o arquivo de blobs. Em Ações, selecione o ícone de transferência para transferir um registo de erros. Envie este registo para o administrador do sistema de origem para que saiba o que deve corrigir antes de enviar os dados novamente.

O administrador do sistema de origem pode considerar a secção seguinte útil para corrigir erros de dados no respetivo ficheiro de exportação.

Acerca dos erros nos dados

Aplica-se a: Administrador do sistema de origem

Quando qualquer linha ou coluna de dados tiver um valor inválido para qualquer atributo, toda a importação falhará até que o administrador da origem de dados corrija os dados de origem.

Seguem-se alguns erros específicos de importação que poderá encontrar se os seus ficheiros não estiverem formatados corretamente:

  • O ficheiro .csv está vazio. Adicione um ficheiro de .csv não vazio e carregue novamente.

  • Se um ficheiro zip for carregado para a localização do blob, carregue um .csv.

  • Se existirem campos obrigatórios em falta no ficheiro de .json, marcar e carregue novamente o ficheiro de mapeamento.

  • A coluna de origem não está mapeada para um tipo de dados suportado. Mapeie para um tipo de dados suportado e carregue o ficheiro novamente.

  • Os nomes de cabeçalho no ficheiro .csv não correspondem aos campos que mapeou no ficheiro .json. Certifique-se de que o ficheiro .json contém os mesmos campos que o ficheiro de .csv e carregue novamente o ficheiro de .zip.

  • O número de cabeçalhos no ficheiro .csv não corresponde aos campos que mapeou no ficheiro .json. Certifique-se de que o ficheiro .json contém os mesmos campos que o ficheiro de .csv e carregue novamente o ficheiro de .zip.

  • O ficheiro de .csv está mapeado para um campo nulo ou vazio no seu ficheiro de .json. Mapeie-o para um campo não vazio e carregue novamente o ficheiro .zip.

  • Saiba mais sobre outras regras de ficheiro e erros de validação.

Estado suspenso

Se vir uma status "Suspensa" na tabela Histórico de importações ou quando selecionar Gerir origens de dados, significa que as credenciais de autorização expiraram ou que o acesso foi revogado. Terá de atualizar as suas credenciais e voltar a ligar a origem de dados.

Adicionar novos dados e gerir conjuntos de dados

Aplica-se a: Administrador de informações

Depois de configurar a importação de dados, utilize os passos abaixo para adicionar novos dados a um conjunto de dados existente, criar um novo conjunto de dados, desativar as importações automatizadas e muito mais.

  1. Na página Dados de negócio , selecione Gerir origens de dados.

  2. Em Blob do Azure, selecione Gerir.

    • Para adicionar um novo conjunto de dados, selecione Adicionar um conjunto de dados e siga o processo descrito no Passo 3 acima.

    • Para eliminar um conjunto de dados, junto ao conjunto de dados que pretende eliminar, selecione o ícone do caixote do lixo.

    • Para fazer alterações a um conjunto de dados existente, selecione o ícone de definições.

    • Para adicionar novos dados a um conjunto de dados existente, selecione o ícone de adição junto ao conjunto de dados.

    Na página seguinte, pode editar o nome da ligação, o URL de SAS do blob ou o URL do blob. Se atualizar o URL ou o URI de SAS, a nova localização será utilizada para futuras atualizações de dados.

    Também pode ativar ou desativar as importações automatizadas. Quando terminar, clique em Salvar.

    Para substituir ou editar os dados de negócio com o URL sas de blob existente ou o URL do blob, contacte o administrador do sistema de origem. Ao importar dados para Viva Insights, irá efetuar uma atualização completa ou incremental. Se quiser eliminar campos, pode utilizar uma atualização completa para o fazer.

Tipos de atualização

Inteiro

Quando efetua uma atualização completa, está a substituir todos os seus dados de negócio no Viva Insights, ou seja, substitui o que já importou. Os campos necessários são PersonId e StartDate.

Pode utilizar uma atualização completa para eliminar campos, uma vez que os campos que deixar de fora não serão apresentados nos seus dados. Abordamos a eliminação de dados na secção seguinte.

Eliminar campos com atualizações completas

Para eliminar campos com uma atualização completa, exporte os seus dados como uma .csv que contém todos os campos, exceto os campos que pretende eliminar. Uma vez que uma atualização completa substitui os dados existentes, acabará por todos os campos, exceto os que deixou de fora durante a importação.

Incremental

Efetue uma atualização incremental quando quiser apenas adicionar novas informações aos dados de negócio que já carregou para Viva Insights. Com uma atualização incremental, pode adicionar novos dados de negócio para funcionários existentes ou editar dados empresariais existentes.

Como indicar uma atualização completa ou incremental

  1. Em metadata.json, vá para a linha 3.

  2. Atualize a "IsBootstrap"propriedade : para uma das seguintes opções:

    • Para uma atualização completa, utilize "IsBootstrap" : "true".

    • Para uma atualização incremental, utilize "IsBootstrap" : "false".

Quando a opção de importação for executada, Viva Insights começará a processar os seus dados como uma atualização completa ou incremental, dependendo do que especificou aqui no metadata.json.

Importante

Certifique-se de que elimina quaisquer campos de metadata.json que não esteja a incluir no seu ficheiro de data.csv. Se tiver mais campos no ficheiro de metadata.json do que no ficheiro de data.csv ou vice-versa, o processamento da importação falhará.

Campos a incluir no data.csv para atualizações completas e incrementais

As atualizações completas e incrementais devem incluir o mesmo conjunto de campos obrigatórios: PersonId e StartDate. O valor StartDate deve estar alinhado com os limites mensais. Remova os campos que não tem no seu .csv do ficheiro de .json de metadados.