Conector de entrada de hierarquia de organização

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

Você pode usar o conector de entrada Hierarquia organizacional para carregar e atualizar hierarquias organizacionais por meio de arquivos armazenados em um servidor Secure File Transfer Protocol (SFTP) para o XM Discover. Este conector de entrada permite a você efetuar o seguinte:

• Carregar e programar atualizações para hierarquias de organização.
• Extrair arquivos de um arquivo ZIP ou Gzip antes de processar.
• Decodificar arquivos antes de processar.
• Configurar notificações avançadas.
• Aplicar transformações.
  Qdica: as hierarquias organizacionais funcionam da mesma forma, independentemente de onde (Studio ou Conectores) elas são criadas ou mantidas.

Formatos de arquivo de hierarquia organizacional

Antes de configurar um job usando o conector de entrada Hierarquia de organização, certifique-se de que você tem o arquivo de hierarquia de organização relevante preparado em 1 dos seguintes formatos de arquivo suportados:

• Arquivos Excel (XLS, XLSX)
• Arquivos de texto delimitados (CSV)

Requisitos de hierarquia organizacional em formato Excel

O conector de entrada Hierarquia organizacional permite que você defina todos os aspectos de uma organização por meio de uma única planilha do MS Excel.

• Você pode salvar sua hierarquia organizacional como uma planilha do MS Excel com uma extensão XLS ou XLSX.
• Recomendamos que você coloque todos os dados da hierarquia organizacional na primeira planilha do arquivo Excel.
• Certifique-se de que a primeira linha da sua planilha eletrônica contém nomes de coluna. Esses nomes serão usados para mapear colunas para parâmetros de organização.
• As colunas da planilha podem estar em qualquer ordem.
• Cada coluna é atribuída a um determinado parâmetro de hierarquia de organização durante a etapa de mapeamento.

Exemplo: aqui está um exemplo de uma hierarquia organizacional definida no formato Excel:

Exemplo: aqui está um exemplo de como mapear as colunas dos arquivos de hierarquia organizacional durante a etapa de mapeamento:

Hierarquia organizacional em requisitos de formato CSV

O conector de entrada Hierarquia de organização permite que você defina todos os aspectos de uma organização por meio de um único arquivo CSV.

• Salve sua hierarquia organizacional como um arquivo CSV.
• Separe as colunas usando uma vírgula.
• Todas as linhas devem ter o mesmo número de colunas, na mesma ordem.
• Certifique-se de que a primeira linha do seu arquivo CSV contém nomes de coluna. Esses nomes serão usados para mapear colunas para parâmetros de hierarquia de organização.
• A ordem das colunas não importa.
• Cada coluna é atribuída a um determinado parâmetro de hierarquia de organização durante a definição da hierarquia de etapas de mapeamento em um arquivo CSV.

Exemplo: este é um exemplo de como uma hierarquia de organização é definida em um arquivo CSV. Diferentes gerentes são atribuídos a diferentes níveis de hierarquia e o enriquecimento “Sentimento de destino” é definido para cada nível.

Exemplo: aqui está um exemplo de como as colunas dos arquivos de hierarquia organizacional devem ser mapeadas durante a etapa de mapeamento:

Para exemplos e dicas de solução de problemas para hierarquias de organização no XM Discover, consulte Best Practices for Organization Hierarchies (Studio).

Configurando a conexão

1. Iniciar sessão nos conectores.
2. Clique no botão Novo job no canto superior direito da página Jobs.
   
3. Na página Conectores, vá para a seção SELECIONAR UMA FONTE.
   
4. Clique no botão Hierarquia de organização.
   

Criar um job de conector de entrada de hierarquia de organização

Depois de configurar a conexão, siga estas etapas para criar um job de conector de entrada da hierarquia organizacional e configurar os dados enviados ao XM Discover:

• Etapa 1: fornecer nome do job
• Etapa 2: especificar projeto e descrição
• Etapa 3: Fornecer credenciais para uma pasta SFTP da Qualtrics
• Etapa 4: token de API de hierarquia
• Etapa 5: Configurações de hierarquia de organização
• Etapa 6: Fornecer configuração de arquivos
• Etapa 7: Mapear campos desejados no XM Discover
• Etapa 8: Configuração de notificação (opcional)
• Etapa 9: Configurar opções adicionais para job
• Etapa 10: Confirmar todas as configurações de job

Qdica: Clique nos botões Voltar e Avançar para navegar entre as páginas ou use as teclas de seta: ESQUERDA para voltar, DIREITA para avançar. Se você quiser cancelar a configuração, clique no botão Cancelar.

Etapa 1: fornecer nome do job

Insira um nome de job reconhecível na caixa Nome do job na parte superior esquerda da página.

Etapa 2: especificar projeto e descrição

1. Na página Especificar projeto e descrição, selecione o projeto para o qual os dados devem ser carregados a partir do menu suspenso de projetos.
   
   Qdica: você tem a opção de inserir uma observação sobre a tarefa na caixa Descrição do cargo. A descrição do cargo inserida na caixa Descrição do cargo só pode ser acessada na lista Conectores e não é carregada como parte dos dados de um trabalho.
2. Clique em Seguinte.

Etapa 3: Fornecer credenciais para uma pasta SFTP da Qualtrics

1. Na página Fornecer credenciais para uma pasta SFTP da Qualtrics, você pode selecionar um conjunto existente de credenciais de servidor SFTP no menu suspenso.
   
   Qdica: você pode adicionar um novo conjunto de credenciais SFTP seguindo as etapas abaixo Adicionando novas credenciais SFTP Dados integrados.
2. Clique em Seguinte.

Etapa 4: token de API de hierarquia

1. Na página Token de API de hierarquia, forneça seu token de autenticação de hierarquia na caixa Token de API de hierarquia.
   
   Qdica: Para obter mais informações sobre como gerar um token de autenticação de hierarquia e atualizar um token de autenticação de hierarquia após a criação de uma tarefa, consulte API de hierarquia.
2. Clique em Seguinte.

Etapa 5: Configurações de hierarquia de organização

1. Na página Configurações de hierarquia organizacional, forneça o nome para sua hierarquia de organização na caixa NOME.
   
2. Selecione 1 das seguintes opções do modo de upload para indicar como o sistema deve tratar hierarquias organizacionais.

• Carregar hierarquia de organização (padrão): crie e ative uma hierarquia de organização. Para mais informações, consulte o Carregar hierarquia de organização Dados integrados.
  Qdica: por padrão, a hierarquia da organização ativada não está publicada e só permitirá a personalização do painel.
• Carregar hierarquia de organização e publicar: criar, ativar e publicar uma hierarquia de organização. Para mais informações, consulte o Carregar hierarquia de organização e publicar Dados integrados.
  Qdica: a publicação de uma hierarquia de organização permite agrupar dados por seus níveis. Este é um pré-requisito para relatórios de pares e superiores, bem como relatórios de objetivo e de desvio. Para mais informações, consulte Relatórios de pares e superiores e Relatórios de destino e de desvio.
  Qdica: Para obter mais informações sobre a atualização das configurações de hierarquia organizacional após a criação de uma tarefa, consulte o Atualizando configurações de jobs de conector de entrada de hierarquia organizacional Dados integrados.

3. Clique em Seguinte.

Etapa 6: Fornecer configuração de arquivos

1. Na página Fornecer configuração de arquivos, marque 1 das seguintes caixas de seleção para escolher o tipo de arquivo que contém os dados a serem carregados:

• Arquivos de texto delimitados (CSV)
• Arquivos Excel (XLS, XLSX)
  
  

2. Aplique as opções de configuração para o tipo de arquivo selecionado:

• Arquivos de texto delimitados (CSV): para mais informações, consulte o Configurações de arquivos de texto delimitados (CSV) Dados integrados.
• Arquivos Excel (XLS, XLSX): para mais informações, consulte o Configurações de arquivos do Microsoft Excel Dados integrados.
  

3. Clique em Procurar na seção Local dos arquivos para apontar para a pasta onde os arquivos estão armazenados no servidor SFTP.
   
4. Na janela Selecionar localização de arquivos, selecione a pasta onde os arquivos estão armazenados.
   
   Qdica: Clique no nome da pasta para selecioná-la. Clique no ícone da pasta para abrir a pasta.
5. Assim que a pasta onde os arquivos estão armazenados for selecionada, clique em OK.
   
   Atenção: somente os arquivos na pasta selecionada são processados; as subpastas precisam ser processadas separadamente.
6. Insira uma expressão regular para processar somente arquivos com nomes correspondentes na caixa Nome do arquivo de expressão regular.
   
   Qdica: você pode atualizar as configurações de local dos arquivos após a criação de uma tarefa.
   Atenção: Os recursos de codificação personalizada são fornecidos no estado em que se encontram e exigem conhecimento de programação para serem implementados. O suporte da Qualtrics não oferece assistência nem consultoria em codificação customizada. Ao invés disso, você pode perguntar para nossa comunidade de usuários dedicados. Se você quiser saber mais sobre nossos serviços de codificação personalizada, entre em contato com o seu Executivo de Contas da Qualtrics.
7. Na página Fornecer configuração de arquivos, vá para a seção Decriptografia e compactação (opcional).
   
8. Se os arquivos estiverem armazenados em um arquivo zip ou Gzip, marque o campo de seleção Descompactar arquivos.
9. Insira uma expressão regular para descompactar somente arquivos com nomes correspondentes na caixa de expressão regular Nome do arquivo compactado.
   Atenção: Os recursos de codificação personalizada são fornecidos no estado em que se encontram e exigem conhecimento de programação para serem implementados. O suporte da Qualtrics não oferece assistência nem consultoria em codificação customizada. Em vez disso, você pode perguntar para nossa comunidade de usuários dedicados. Se você quiser saber mais sobre nossos serviços de codificação personalizada, entre em contato com o seu Executivo de Contas da Qualtrics.
10. Se os arquivos estiverem criptografados, marque o campo de seleção Decriptografar arquivo(s).
    
11. Insira uma expressão regular para descriptografar somente arquivos com nomes correspondentes na caixa Expressão regular de nome de arquivo criptografado.
    Atenção: Os recursos de codificação personalizada são fornecidos no estado em que se encontram e exigem conhecimento de programação para serem implementados. O suporte da Qualtrics não oferece assistência nem consultoria em codificação customizada. Em vez disso, você pode perguntar para nossa comunidadede usuários dedicados. Se você quiser saber mais sobre nossos serviços de codificação personalizada, entre em contato com o seu Executivo de Contas da Qualtrics.
12. Insira uma chave PGP/GPG para descriptografia na caixa de chaves PGP/GPG.
13. Insira uma frase-chave para descriptografia na caixa Frase-chave.
14. Se um arquivo não criptografado contiver arquivos criptografados, selecione o Descompactar e, em alternativa, se um arquivo criptografado contiver arquivos não criptografados, selecione a opção Decriptografar e, em seguida, Descompactar.
    Qdica: essas opções estarão disponíveis somente se as opções Descompactar arquivo(s) e Decriptografar arquivo(s) estiverem selecionadas.
    Atenção: Arquivos criptografados com arquivos criptografados não são suportados.
    Qdica: Você pode atualizar as configurações de descriptografia e compactação após a tarefa ser criada.
15. Para fornecer um arquivo de amostra para mapeamentos de campos, você pode escolher 1 das seguintes opções:

• Baixar uma amostra do armazenamento de arquivos: para mais informações, consulte o Baixando um arquivo de amostra do servidor SFTP Dados integrados.
• Carregue um arquivo do seu computador: Para mais informações, consulte o Carregando um arquivo de amostra do seu computador Dados integrados.
  

16. Clique em Seguinte.
    

Etapa 7: Mapear campos desejados no XM Discover

1. Na página Mapear campos desejados para o XM Discover, defina a hierarquia da organização mapeando os campos para os parâmetros de hierarquia apropriados na guia MAPEAMENTO DA FONTE:

• Nome do campo: o nome do campo do arquivo.
  
• Valores possíveis: exemplos de valores possíveis.
• Transformações: use esta opção para transformar seus dados. Para mais informações, consulte Aplicando transformações.
• Mapeamento: selecione o aspecto da hierarquia da organização para mapear os campos. Valores possíveis:
  • Nível 1 até nível 10. Defina a estrutura da sua hierarquia. Os níveis da estrutura organizacional são definidos por colunas no arquivo do Excel ou CSV.
    Qdica: 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: criar parâmetros de enriquecimento para sua hierarquia.|
    Qdica: o número máximo de enriquecimentos é 6.
    Qdica: Clique no ícone mais ( + ) à direita para adicionar novos campos de dados personalizados; clique no ícone menos ( – ) para remover campos.

2. Clique em Seguinte.
   

Etapa 8: Configuração de notificação (opcional)

1. Na página Configuração de notificação, você pode selecionar as notificações que os observadores de um trabalho devem receber se ocorrer qualquer um dos eventos listados a seguir.

• Notificar quando a execução do job falhar
• Notificar quando nenhum arquivo for encontrado para processamento
• Notificar quando o job terminar com um timeout
  

2. Clique em Seguinte.
   

Etapa 9: Configurar opções adicionais para job

1. Na página Configurar opções adicionais para job, na seção Programar job histórico/incremental, clique em 1 das seguintes opções:

• Programar execuções incrementais: para configurar uma programação para recebimentos de dados incrementais.
  Qdica: Para obter mais informações sobre a programação de execuções incrementais, consulte Programação de tarefas.
• Configurar pull único: para executar um pull de dados único.
  
  Qdica: Para obter mais informações, consulte Programar uma execução incremental para um job de pull único.

2. Na página Configurar opções adicionais para job, na seção Período de retenção, você pode indicar o período de retenção para arquivar files por job por um período de tempo definido.
   
   Qdica: Para obter mais informações sobre as configurações de retenção, consulte Atualizando configurações de retenção.
3. Clique em Seguinte.
   

Etapa 10: Confirmar todas as configurações de job

1. Na página Confirmar todas as configurações do trabalho, você pode visualizar um resumo de todas as configurações de um trabalho e editar as configurações, se necessário, antes de executar o carregamento de dados.
   
2. Para executar o upload de dados, clique no botão Concluir quando estiver pronto para executar o upload de dados.
   
   Será exibida uma mensagem de confirmação confirmando que a tarefa foi enviada com êxito. Quando você clica em Concluir, acontece o seguinte:

• Os pulls únicos são executados imediatamente.
• A menos que você tenha ativado a opção “Criar tarefa, mas não extrair dados”, os pull programados são executados imediatamente e, em seguida, definidos para serem executados de acordo com a programação que você definiu.
  Para mais informações sobre a monitorização de jobs, consulte Síntese de página de jobs.

Adicionando novas credenciais SFTP

Na página Fornecer credenciais para uma pasta SFTP da Qualtrics, você pode adicionar novas credenciais SFTP.

1. Para adicionar um novo conjunto de credenciais SFTP, selecione Adicionar novo no menu suspenso de credenciais.
   
2. Insira o nome do novo conjunto de credenciais na caixa NOME DA CONEXÃO.
   
3. Insira o nome de usuário do SFTP na caixa NOME DO USUÁRIO SFTP.
4. Forneça a senha do SFTP na caixa SENHA DO SFTP.
5. Digite o endereço do servidor SFTP na caixa HOST SFTP.
6. Forneça a porta do SFTP para a caixa do SFTP PORT.
   Qdica: a porta padrão é 22.
7. Você pode definir suas credenciais SFTP para expirar após um determinado período de tempo (opcional). Para definir uma data de vencimento para este conjunto de credenciais e definir um lembrete para todos os observadores de trabalho, marque a caixa de seleção Enviar notificações de vencimento. Isso ativa a caixa Dias antes da expiração.
   
8. Insira um valor na caixa Dias antes da expiração para definir quantos dias antes da expiração as notificações devem começar. Os valores possíveis variam de 1 a 100 dias.
   Qdica: este lembrete é acionado sempre que a tarefa for executada quando a data de expiração for menor que o número de dias definido na caixa Dias antes da expiração.
9. Selecione a Data de vencimento no selecionador de data de calendário. A data de vencimento será adicionada à caixa Data de vencimento.

Baixando um arquivo de amostra do servidor SFTP

1. Selecione Baixar amostra do Armazenamento de arquivos.
   
2. Clique no botão Selecionar arquivo de amostra na caixa Procurar armazenamento de arquivos.
3. Na janela Selecionar arquivo de amostra, abra a pasta onde o arquivo de amostra está armazenado.
   
4. Selecione o arquivo de amostra.
   
5. Clique em OK.
6. Aguarde até que o XM Discover carregue o arquivo de amostra e mostre uma visualização.
   
   Qdica: Para obter informações sobre possíveis erros de validação, consulte Erros de arquivo de amostra.

Carregando um arquivo de amostra do seu computador

1. Selecione Carregar amostra do meu computador.
   
2. Clique no botão Clique para selecionar arquivo para upload e aponte para o arquivo de dados ou solte seu arquivo na tela cinza.
3. Aguarde até que o XM Discover carregue o arquivo de amostra e mostre uma visualização.
   
   Qdica: Para obter informações sobre possíveis erros de validação, consulte Erros de arquivo de amostra.
   Qdica: você pode atualizar mapeamentos de campos atualizando a configuração dos cabeçalhos de arquivo por meio de um arquivo de amostra após a criação de uma tarefa.

Configurações de arquivos de texto delimitados (CSV)

Você pode aplicar as opções de configuração para arquivos de texto delimitados (CSV) na página Selecionar arquivo.

1. Selecione o sistema de codificação usado no arquivo a partir do menu.
   
2. Insira o caractere utilizado para delimitar entradas de dados no arquivo na caixa Caractere de delimitação.
   
   Qdica: Digite apenas 1 caractere.
   Qdica: o delimitador padrão é uma vírgula, que pode ser usada em arquivos CSV.
3. Insira o caractere utilizado para incluir cada campo de dados no arquivo na caixa de caracteres Embalagem.
   Qdica: Digite somente 2 caracteres.
   Qdica: marque a caixa de seleção Caractere de embalagem se os caracteres de embalagem forem opcionais.
4. Você pode clicar no link aqui para baixar e usar um modelo padrão com uma estrutura predefinida, filtros, usuários e enriquecimentos armazenados em um único arquivo como ponto de partida para criar sua própria hierarquia organizacional.
   
   O arquivo de modelo CSV para a estrutura organizacional será salvo no local padrão para downloads em seu computador. Depois de você baixar o modelo, modifique-o para corresponder à sua estrutura organizacional.
   
   

Configurações de arquivos do Microsoft Excel

Você pode aplicar as opções de configurações para arquivos do Microsoft Excel na página Selecionar arquivo. Você pode clicar no link aqui para baixar e usar um modelo padrão com uma estrutura predefinida, filtros, usuários e enriquecimentos armazenados em um único arquivo como ponto de partida para criar sua própria hierarquia organizacional.

O arquivo de modelo do Excel para a estrutura organizacional será salvo no local padrão para downloads em seu computador. Depois de você baixar o modelo, modifique-o para corresponder à sua estrutura organizacional.

Atualizando configurações de jobs de conector de entrada de hierarquia organizacional

Você pode atualizar configurações para jobs de conector de entrada de hierarquia organizacional para indicar como o sistema deve processar hierarquias de organização após a criação de um job. Estas são principalmente atualizações incompletas. Para cada execução incremental do conector Hierarquia de organização, ocorre o seguinte:

1. É criada uma versão da hierarquia de organização original.
2. A versão criada é editada com novos arquivos.
3. Se a estrutura ou os filtros forem atualizados, a versão é publicada. A versão não é publicada se só forem atualizados usuários e aprimoramentos.
4. A hierarquia de organização original é substituída por uma nova versão.
5. A versão temporária é excluída.
6. A hierarquia de organização é ativada se não estiver ativa.

Como atualizar configurações de jobs de conector de entrada de hierarquia organizacional

1. Iniciar sessão nos conectores.
2. Certifique-se de que a guia JOBS esteja selecionada.
   
3. Encontre o trabalho que você deseja atualizar usando filtros ou pesquisa.
4. Expanda o menu de ações ao lado do job.
5. Selecione Atualizar configurações de hierarquia de organização.
6. Na janela Atualizar configurações de hierarquia de organização, você pode selecionar 1 das seguintes opções de modo de upload para especificar como o sistema deve tratar hierarquias organizacionais:

• Carregar hierarquia de organização (padrão): crie e ative uma hierarquia de organização. Para mais informações, consulte a seção Carregar hierarquia de organização.
  Qdica: por padrão, a hierarquia da organização ativada não está publicada e só permitirá a personalização do painel.
• Carregar hierarquia de organização e publicar: criar, ativar e publicar uma hierarquia de organização. Para mais informações, consulte a seção Carregar hierarquia de organização e publicar.
  Qdica: a publicação de uma hierarquia de organização permite agrupar dados por seus níveis. Este é um pré-requisito para relatórios de pares e superiores, bem como relatórios de objetivo e de desvio. Para mais informações, consulte Relatórios de pares e superiores e Relatórios de destino e de desvio.
  

7. Clique em Salvar.
   Isso atualiza o job e aplica as novas configurações.

Carregar hierarquia de organização

Se você selecionar a opção de modo de upload Carregar hierarquia organizacional, poderá marcar a caixa de seleção Gerar grupos com base nesse arquivo de usuários para criar grupos com sua hierarquia de organização.

Carregar hierarquia de organização e publicar

Se você selecionar a opção de modo de upload Carregar hierarquia organizacional e Publicar, pode efetuar o seguinte:

• Selecione Gerar grupos com base neste arquivo de usuários para criar grupos com sua hierarquia de organização.
• Selecione Incluir registros sem texto para incluir registros com valores em branco na hierarquia da sua organização.
• Desmarque Incluir registros sem texto para excluir registros com valores em branco na íntegra da hierarquia da sua organização.
• Selecione Incluir em fluxos de dados incrementais para incluir o modelo de hierarquia organizacional em execuções incrementais.
• Desmarque Incluir em fluxos de dados incrementais para excluir o modelo de hierarquia organizacional das execuções incrementais. Se você espera que a publicação de uma hierarquia de organização entre em conflito com outros fluxos de dados de downstream em tempo real, recomendamos desmarcar essa opção. O modelo que é criado e classificado subsequentemente não bloqueará outros fluxos de dados se esta opção não estiver selecionada.
  
  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.