Conector de entrada de hierarquia de organização

Sobre o conector de entrada da hierarquia de organização

As hierarquias organizacionais permitem que você carregue sua estrutura organizacional para o XM Discover para melhorar a análise de dados, a personalização do usuário e o controle de acesso a dados. Você pode usar o conector de entrada da hierarquia organizacional para carregar e atualizar hierarquias de organização.

Preparando um arquivo de hierarquia de organização

Antes de poder configurar um job de entrada da hierarquia organizacional, você deve garantir que seus dados de hierarquia organizacional estão no formato adequado e contêm sua estrutura organizacional.

As hierarquias de organização podem ser carregadas usando um arquivo CSV ou Excel (XLS ou XLSX).

Consulte as melhores práticas para hierarquias organizacionais para obter exemplos e diretrizes de formatação para cada tipo de arquivo.

Exemplo: abaixo está um arquivo Excel que mostra um exemplo de estrutura organizacional para uma empresa hoteleira.

Configuração de um job de entrada de hierarquia de organização

Siga as etapas abaixo para configurar um job de entrada de hierarquia organizacional. Essa configuração exige que você gere um token de API de hierarquia no Studio, que é recomendado antes de concluir as etapas abaixo.

1. Na guia Trabalhos, clique em Novo trabalho.
   
2. Selecione Hierarquia de organização.
   
3. Dê um nome ao seu job para poder identificá-lo.
   
4. Selecione o projeto para o qual os dados devem ser carregados.
5. Dê uma descrição ao seu cargo para que você saiba o seu objetivo.
6. Clique em Seguinte.
7. Escolha uma conta SFTP para usar ou selecione Adicionar novo para adicionar uma nova.
   
8. Se estiver adicionando uma nova conta, insira as seguintes informações para sua conta SFTP:
   • Nome da conexão: dê um nome à conexão para reconhecê-la mais tarde.
   • Nome de usuário do SFTP: insira o nome de usuário para conexão com o servidor SFTP.
   • Senha do SFTP: insira a senha para se conectar ao servidor SFTP.
   • Host SFTP: insira o URL do host do servidor SFTP.
   • Porta SFTP: insira sua porta SFTP. Normalmente é 22.
   • Enviar notificações de expiração: se desejar que suas credenciais SFTP expirem após um determinado período de tempo, selecione esta opção.
   • Dias antes da expiração: se as notificações de expiração forem ativadas, insira quantos dias você gostaria de ser notificado antes da expiração. Você pode inserir um valor entre 1 e 100 dias.
   • Data de vencimento: defina a data em que as credenciais expirarão. Clique na caixa para abrir um calendário e selecionar a data.
9. Clique em Seguinte.
10. Insira seu Token de API de hierarquia.
    
11. Clique em Seguinte.
12. Dê um nome à sua hierarquia organizacional.
    
13. Escolha se você deseja publicar sua hierarquia de organização ou não:
    • Carregar hierarquia de organização: crie e ative uma hierarquia de organização. Por padrão, a hierarquia de organização ativada não está publicada e só ativará a personalização do dashboard.
    • Carregar hierarquia de organização e publicar: criar, ativar e publicar uma hierarquia de organização. A publicação de uma hierarquia organizacional permite a você agrupar dados pelos respectivos níveis. Este é um pré-requisito para relatórios de pares e superiores e relatórios de objetivo e de desvio.
      Qdica: a publicação de uma hierarquia de organização cria um modelo de categoria correspondente oculto para dar suporte a casos de uso adicionais. O modelo de categoria criado irá espelhar a estrutura e os filtros da hierarquia de organização e se comportará como um modelo, quando aplicável.
14. Selecione opções de hierarquia adicionais dependendo de suas preferências:
    • Gerar grupos com base neste arquivo de usuários: criar grupos com base no arquivo de hierarquia de organização.
    • Incluir registros sem texto: inclua registros com textos textuais vazios na hierarquia da sua organização. Esta opção só está disponível se você estiver publicando sua hierarquia de organização.
    • Incluir em fluxos de dados incrementais: incluir a hierarquia da organização em execuções de fluxo de dados incremental. Esta opção só está disponível se você estiver publicando sua hierarquia de organização.
      Qdica: Se você espera que a publicação de uma hierarquia de organização entre em conflito com outros fluxos de dados, desmarque esta opção. O modelo que é criado e classificado subsequentemente não bloqueará outros fluxos de dados se esta opção estiver desativada.
15. Clique em Seguinte.
16. Selecione o tipo de arquivo que você deseja carregar:
    
    • Arquivos “planos” separados por delimitadores
    • Arquivos do Excel (XLS, XLSX)
17. Para arquivos planos separados por delimitador, existem configurações adicionais para você selecionar:
    
    • Codificação do arquivo: Escolha o sistema de codificação do arquivo (UTF-8, ASCII, etc)
    • Caractere delimitador: insira o caractere utilizado para delimitar entradas de dados. Por padrão, esta é uma vírgula para arquivos CSV.
    • Caractere de embalagem: insira o caractere que inclui a entrada de dados. Deixe este campo em branco se “Sem embalagem” estiver selecionado.
    • Sem inclusão: ative esta opção se o seu arquivo não contiver caracteres de embalagem.
18. Clique em Procurar e escolha o caminho da pasta no servidor SFTP que contém o arquivo que você deseja carregar.
    Qdica: Ao escolher um caminho de pasta, você pode clicar em um ícone de pasta para expandir essa pasta. Clique no nome da pasta para selecioná-la e clique em OK quando terminar.
19. Insira o nome do arquivo expressão regular que corresponda aos arquivos que você deseja carregar.
20. Se seus arquivos estiverem compactados, ative Descompactar arquivo(s) e insira a expressão regular Nome do arquivo compactado que corresponde aos arquivos que devem ser descompactados.
    
21. Se seus arquivos forem descriptografados, habilite Descriptografar arquivo(s) e insira o seguinte:
    • Expressão regular de nome de arquivo criptografado: insira o nome de arquivo expressão regular para arquivos que devem ser descriptografados.
    • Chave PGP/GPG: insira a chave PGP/GPG usada para criptografia.
    • Frase-chave: insira a frase-chave para descriptografia.
22. Se seus arquivos forem compactados e criptografados, você deve escolher o que deve acontecer primeiro:
    • Descompactar e depois descriptografar: os arquivos são descompactados e, em seguida, descriptografados.
    • Descriptografar e descompactar: os arquivos são descriptografados e, em seguida, descompactados.
23. Você deve fornecer um arquivo de amostra, que pode ser salvo em seu computador ou no servidor SFTP:
    
    • Selecione Baixar amostra do armazenamento de arquivos se o arquivo de amostra for salvo em seu servidor SFTP.
    • Selecione Carregar amostra do meu computador se a amostra estiver salva em seu computador.
      Qdica: Se necessário, você pode baixar um arquivo de modelo clicando no link aqui exibido na configuração da tarefa.
24. Por padrão, seu arquivo de amostra não é usado para gerar a hierarquia de organização. Se você quiser que seu arquivo de amostra seja usado para a primeira execução do job, ative Usar arquivo de amostra carregado para a execução do job inicial.
25. Clique no botão Selecionar arquivo e escolha o arquivo de amostra em seu computador ou em seu servidor SFTP.
26. Uma visualização do arquivo será exibida. Se você vir uma mensagem de erro ou conteúdo de arquivo bruto em vez da visualização, pode haver um problema com as opções de formato de dados que você selecionou. Consulte Erros de arquivo de amostra para obter ajuda na solução de problemas do seu arquivo.
27. Clique em Seguinte.
28. Comece mapeando campos do seu arquivo de amostra para campos de hierarquia da organização no XM Discover. Clique na caixa na coluna Mapeamento para escolher um campo de hierarquia de organização do XM Discover para mapear para seu campo importado. Os possíveis campos de hierarquia de organização incluem:
    
    • Nível 1 a nível 10: defina a estrutura da sua hierarquia. O número máximo de níveis hierárquicos é 10.
    • Usuários: mapeie os usuários para sua hierarquia.
    • Filtros: defina os filtros para sua hierarquia.
    • Enriquecimentos: crie parâmetros de enriquecimento para sua hierarquia. O número máximo de enriquecimentos é 6.
29. Se necessário, você pode transformar os dados de entrada clicando no ícone de engrenagem na coluna Transformações.
30. Você pode adicionar campos adicionais clicando no sinal de mais ( + ) ou remover campos clicando no sinal negativo ( – ) nex no campo.
31. Clique em Avançar quando terminar de mapear os campos.
32. Selecione suas configurações de notificação.
    
33. Clique em Seguinte.
34. Selecione Programar execuções incrementais se você quiser que seu job seja executado periodicamente em uma programação ou Configurar pull único se quiser que o job seja executado somente uma vez. Consulte Escalonamento do job para mais informações.
    
35. Escolha um período de retenção para arquivos processados. Os arquivos são excluídos após o período definido.
36. Clique em Seguinte.
37. Revise sua configuração. Se você precisar modificar uma configuração específica, clique no botão Editar para ir para essa etapa na configuração do conector.
    
38. Clique em Concluir para salvar o trabalho.