Hierarquia Organização Conector de entrada

Sobre o conector de entrada de Hierarquia Organização

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

Preparação de um arquivo Hierarquia Organização

Antes de configurar um trabalho de entrada de hierarquia organização, você deve se certificar de que os dados da hierarquia organização estão no formato adequado e contêm a estrutura da organização.

As hierarquias Organização podem ser carregadas por meio de um arquivo CSV ou Excel (XLS ou XLSX).

Consulte as Práticas recomendadas para hierarquias Organização para obter exemplos e diretrizes de formatação para cada tipo de arquivo.

Exemplo: Abaixo está um arquivo do Excel que mostra um exemplo de estrutura organização para uma empresa hoteleira.

Configuração de um trabalho de entrada de Hierarquia Organização

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

1. Na guia Jobs, clique em New Job.
   
2. Selecione Hierarquia Organização.
   
3. Dê um nome ao seu trabalho para que você possa identificá-lo.
   
4. Escolha o projeto para carregar os dados.
5. Faça uma descrição do seu trabalho para que você saiba o propósito dele.
6. Clique em Seguinte.
7. Escolha o método de autenticação para seu servidor SFTP:
   • Autenticação básica: Conecte-se usando um nome de usuário e uma senha.
   • Chave SSH: Conecte-se usando uma chave Secure Shell (SSH) fornecida por você ou uma chave fornecida pela Qualtrics.
8. Use o menu suspenso para selecionar uma conexão existente ou selecione Add New para configurar uma nova conexão. Consulte Adição de uma Conta SFTP para obter mais informações sobre como criar uma nova conexão.
9. Clique em Seguinte.
10. Escolha o tipo de hierarquia:
    • Filtro personalizado
      • Classificação Delta
      • Classificação tradicional
    • Filtro Atributo
      Qdica: passe o mouse sobre o ícone de informações avançar do nome da hierarquia para saber mais sobre ela e seus casos de uso.
11. Clique em Seguinte.
12. Se estiver usando um tipo hierarquia “Classificação tradicional”, você também precisará inserir um Token API Hierarquia . Caso contrário, passe para a avançar etapa.
13. Dê um nome à sua hierarquia.
    Qdica: você pode atualizar uma hierarquia existente certificando-se de que o nome inserido aqui corresponda exatamente ao nome hierarquia existente.
14. Escolha suas configurações hierarquia. As opções aqui dependem do tipo de hierarquia selecionado na etapa 10:
    • Classificação Delta
      • Upload Hierarquia Organização: Crie e ative uma hierarquia organização. Por padrão, a hierarquia organização ativada não é publicada e só permite a personalização dashboard. Quando ativadas, as seguintes subopções também estão disponíveis:
        • Gerar grupos com base nesse arquivo de usuários: Criar grupos com base no arquivo hierarquia organização.
        • Ignorar usuários inexistentes: Ignorar usuários que não correspondem a usuários existentes Discover.
    • Carregar Hierarquia Organização e Publicar: criar, ativar e publicar uma hierarquia organização. A publicação de uma hierarquia organização permite agrupar dados por seus níveis. Esse é um pré-requisito para relatórios de pares e pais e relatórios de destino e variações. Isso também cria um modelo de categoria oculta para dar suporte a casos de uso adicionais. O modelo reflete a estrutura e os filtros da hierarquia organização. Quando ativadas, as seguintes subopções também estão disponíveis:
      • Incluir registros sem texto: Inclua registros com verbatims vazios na hierarquia da organização.
      • Incluir em fluxos de dados incrementais: Incluir a hierarquia organização no fluxo de dados
        incremental
        Qdica: se você espera que a publicação de uma hierarquia organização entre em conflito com outros fluxos de dados, recomendamos desmarcar essa opção. O modelo que for criado e posteriormente classificado não bloco outros fluxos de dados se essa opção estiver desativada.
      • Aplicar a dados históricos: Aplicar a hierarquia organização aos dados históricos.
      • Gerar grupos com base nesse arquivo de usuários: Criar grupos com base no arquivo hierarquia organização.
      • Ignorar usuários inexistentes: Ignorar usuários que não correspondem a usuários existentes Discover.
    • Classificação tradicional:
      • Upload Hierarquia Organização: Crie e ative uma hierarquia organização. Por padrão, a hierarquia organização ativada não é publicada e só permite a personalização dashboard. Quando ativada, a seguinte subopção também está disponível:
        • Gerar grupos com base nesse arquivo de usuários: Criar grupos com base no arquivo hierarquia organização.
      • Carregar Hierarquia Organização e Publicar: criar, ativar e publicar uma hierarquia organização. A publicação de uma hierarquia organização permite agrupar dados por seus níveis. Esse é um pré-requisito para relatórios de pares e pais e relatórios de destino e variações. Isso também cria um modelo de categoria oculta para dar suporte a casos de uso adicionais. O modelo reflete a estrutura e os filtros da hierarquia organização. Quando ativadas, as seguintes subopções também estão disponíveis:
        • Incluir registros sem texto: Inclua registros com verbatims vazios na hierarquia da organização.
        • Incluir em fluxos de dados incrementais: Incluir a hierarquia organização no fluxo de dados
          incremental
          Qdica: se você espera que a publicação de uma hierarquia organização entre em conflito com outros fluxos de dados, recomendamos desmarcar essa opção. O modelo que for criado e posteriormente classificado não bloco outros fluxos de dados se essa opção estiver desativada.
        • Gerar grupos com base nesse arquivo de usuários: Criar grupos com base no arquivo hierarquia organização.
    • Filtro Atributo
      • Ignorar usuários inexistentes: Ignorar usuários que não correspondem a usuários existentes Discover.
15. Clique em Avançar.
16. Escolha o tipo de arquivo que deseja carregar:
    
    • Arquivos “planos” separados por delimitadores
    • Arquivos do Excel (XLS, XLSX)
17. Para arquivos simples separados por delimitadores, há configurações adicionais que você pode escolher:
    
    • Codificação do arquivo: Escolha o sistema de codificação do arquivo (UTF-8, ASCII, etc.)
    • Caractere delimitador: Digite o caractere usado para delimitar as entradas de dados. Por padrão, é uma vírgula para arquivos CSV.
    • Caractere de fechamento: Digite o caractere que envolve a entrada de dados. Deixe esse campo em branco se a opção “No enclosure” for selecionada.
    • No enclosure: ative essa opção se o seu arquivo não contiver caracteres de delimitação.
18. Clique em Browse e escolha o caminho da pasta em seu servidor SFTP que contém o arquivo que você deseja carregar.
    Qdica: ao escolher um caminho de pasta, você pode clicar no ícone de uma pasta para expandi-la. Clique no nome da pasta para selecioná-la e, em seguida, clique em Ok quando terminar.
19. Digite a expressão regular de nome de arquivo que corresponde aos arquivos que você deseja carregar.
20. Se seus arquivos estiverem compactados, ative Descompactar arquivo(s) e insira a expressão regular Zipped Filename que corresponde aos arquivos que devem ser descompactados.
    
21. Se seus arquivos estiverem descriptografados, ative a opção Decrypt file(s) e digite o seguinte:
    • Expressão regular de nome de arquivo criptografado: Digite a expressão regular do nome do arquivo para os arquivos que devem ser descriptografados.
    • Chave PGP/GPG: Digite a chave PGP/GPG usada para criptografia.
    • Passphrase (Senha): Digite a frase secreta para descriptografia.
22. Se seus arquivos estiverem compactados e criptografados, você deverá escolher o que deve acontecer primeiro:
    • Descompacte e depois descriptografe: Os arquivos são descompactados e depois descriptografados.
    • Descriptografar e depois descompactar: Os arquivos são descriptografados e depois descompactados.
23. Você deve fornecer um arquivo amostra, que pode ser salvo em seu computador ou em seu servidor SFTP:
    
    • Selecione Download Amostra from File Storage (Baixar amostra do armazenamento de arquivos) se o arquivo amostra estiver 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 fazer download de um arquivo de modelo clicando no link aqui exibido na configuração do trabalho.
24. Por padrão, seu arquivo amostra não é usado para gerar a hierarquia organização. Se quiser que o arquivo amostra seja usado na primeira execução do trabalho, ative Usar arquivo amostra carregado para a execução inicial do trabalho.
25. Clique no botão Select File (Selecionar arquivo) e escolha o arquivo amostra em seu computador ou no servidor SFTP.
26. Será exibida uma visualização do arquivo. Se você vir uma mensagem de erro ou o conteúdo do 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 Amostra para obter ajuda na solução de problemas do arquivo.
27. Clique em Seguinte.
28. Comece a mapear os campos do seu arquivo amostra para os campos hierarquia organização no XM Discover. Clique na caixa da coluna Mapeamento para escolher um campo hierarquia organização XM Discover para mapear para o seu campo importado. Os campos possíveis hierarquia organização incluem:
    
    • Nível 1 a Nível 10: Defina a estrutura de sua hierarquia. O número máximo de níveis hierarquia é 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 de menos ( – ) ao lado do campo.
31. Clique em Avançar quando terminar de mapear os campos.
32. Escolha suas configurações de notificação.
    
33. Clique em Seguinte.
34. Selecione Schedule Incremental Runs (Agendar execuções incrementais ) se quiser que o trabalho seja executado periodicamente em uma programação ou Set Up One-Time Pull (Configurar execução única ) se quiser que o trabalho seja executado apenas uma vez. Consulte Agendamento de trabalhos para obter 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 alterar uma configuração específica, clique no botão Edit (Editar ) para ser levado a essa etapa na configuração do conector.
    
38. Clique em Finish (Concluir ) para salvar o trabalho.