Fontes de importação de arquivo para automações
Fontes de importação de arquivo para automações
Com automações de importação de contatos e automações de importação de funcionários, você pode otimizar seu gerenciamento de diretório. Quando a automação estiver programada para ser executada, ela processará todos os arquivos designados que ainda não foram processados pela automação, incluindo arquivos recém-carregados. No entanto, antes de fazer isso, a automação precisa saber de onde extrair seus arquivos.
A fonte do arquivo para automações de importação de contatos e automações de importação de funcionários pode ser:
- Serviço de Arquivos Qualtrics
- Seu servidor SFTP
- Armazenamento de arquivos OAuth (Google Drive ou Dropbox)
Serviço de Arquivos Qualtrics
O Serviço de arquivos da Qualtrics é uma API segura de armazenamento de arquivos que permite carregar arquivos para essa automação importar. Você pode carregar um arquivo para um ponto de acesso HTTPS, que será fornecido em uma caixa cinza (exibida abaixo), como dados de formulário multipartes.
Quando a automação estiver programada para ser executada, ela processará os arquivos que ainda não foram processados pela automação, incluindo os recém-carregados.
Para utilizar o Serviço de arquivos Qualtrics, você precisará chamar o ponto de acesso HTTPS fornecido. Se o arquivo for gerado a partir do sistema, você irá querer fornecer a documentação API e o seguinte exemplo de implementação para sua equipe de TI ou de engenharia de software para integrar com nosso serviço.
Exemplo: este exemplo está no formato cURL. Consulte a página de suporte Visão geral da API sobre como gerar um token de API.
Para usuários Mac e Unix:
curl -X POST -H "X-API-TOKEN: [SUA API TOKEN]" \
-F 'file=@/path/to/import/file/sample-file.txt' \
https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files
Para usuários do Windows:
curl -X POST -H "X-API-TOKEN: [SUA API TOKEN]" ^
-F "file=@/path/to/import/file/sample-file.txt" ^
https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files
Exemplo: Este é um exemplo de solicitação. Consulte a página de suporte Visão geral da API sobre como gerar um token de API.
POST https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files HTTP/1.1
Content-Type: multipart/form-data
X-API-TOKEN: [YOUR API TOKEN]
-----------------------------
Content-Disposition: form-data; name="upfile"; filename="sample-file.txt"
Content-Type: text/simple
[FILE DATA]
-----------------------------
Administrar manualmente arquivos carregados com API
Você também pode gerenciar manualmente os arquivos carregados usando a API da Qualtrics. Os links a seguir explicam como interagir com a API de serviço de arquivos Qualtrics:
- Liste todos os arquivos carregados para essa automação.
- Carregue um arquivo para ser usado por essa automação.
- Obter os metadados associados a um arquivo.
- Obter o conteúdo de um arquivo.
- Remover um arquivo.
Por vezes, essas chamadas de API solicitarão um automationId. A Qualtrics fornecerá essas informações, formatadas como AU_XXXXX.
Próximas etapas – Automação de importação de contatos do XM Directory
Agora que você concluiu a definição do Serviço de arquivo Qualtrics como fonte de importação, chegou a hora de concluir a criação da automação de importação de contatos.
- Etapa 3: criptografia PGP
- Etapa 4: selecionar caminhos de pasta
- Etapa 5: Mapeamento de campo de dados e listas de destinatários
- Etapa 6: Vincular a automações de distribuição
- Etapa 7: Envio de relatórios de execução e ativação da automação
Próximas etapas – Automação de importação de pessoas do diretório de colaboradores
Servidor SFTP
Você pode querer integrar seus próprios registros de contato com a Qualtrics usando o Secure File Transfer Protocol (SFTP). Por exemplo, você pode querer importar conteúdo de uma eliminação de arquivo diária hospedada e, em seguida, importar e programar distribuições de pesquisa para esses contatos, tudo sob os métodos de transferência mais seguros.
Quando a automação estiver programada para ser executada, ela processará os arquivos que ainda não foram processados pela automação, incluindo os recém-carregados. Quando um arquivo é processado, ele é removido do servidor SFTP.
Na etapa Configurar fonte de importação, há duas opções de SFTP: nome de usuário & senha e nome de usuário & chave SSH.
- Na etapa Configurar fonte de importação, selecione um dos servidores SFTP.
- Clique em Continuar.
- Insira o URL do host.
Qdica: O URL geralmente se assemelha ao sftp.example.com. - Insira o Nome de usuário. Isto diferencia maiúsculas de minúsculas.
- Insira a Porta. Isto é opcional. 22 é inserido como padrão.
- Clique em Continuar.
Dependendo se você selecionou a senha ou a chave SSH, seus próximos passos irão variar.
Configuração via nome de usuário & senha
- Insira sua senha.
Qdica: Se o host, o nome de usuário e a porta exatos já tiverem sido fornecidos, não será solicitada uma senha. - Clique em Continuar.
Configuração via nome de usuário & chave SSH
- Se ainda não existir uma chave, selecione a opção para Gerar novo par de chaves SSH.
Qdica: O par Gerar nova chave SSH ainda está presente mesmo que uma chave já tenha sido gerada. Esta opção pode ser selecionada se o usuário quiser criar uma nova chave. No entanto, isso não é necessário se as mesmas credenciais SFTP forem utilizadas para a nova automação. O par de chaves é compartilhado em todas as automações que usam as mesmas credenciais SFTP dentro de uma única conta de usuário. - Clique em Fazer download da chave pública.
- Carregue a chave pública para seu servidor SFTP.
Cifras suportadas
A conexão a um servidor SFTP requer uma série de handshakes SSH para coordenar a criptografia usada entre o servidor e a automação. Para estabelecer uma conexão, o servidor SFTP precisará ter pelo menos uma cifra para cada tipo de cifra que corresponda a uma cifra suportada por automações. Abaixo está a lista de codificações suportadas por automações agrupadas pelo tipo de cifra.
Cópias de intercâmbio de chaves suportadas:
- curve25519-sha256@libssh.org
- diffie-hellman-group14-sha1
- diffie-hellman-group1-sha1
- diffie-hellman-group-exchange-sha256
- ecdh-sha2-nistp256
- ecdh-sha2-nistp384
- ecdh-sha2-nistp521
Cifras Mac suportadas:
- hmac-sha2-256
- hmac-sha2-512
Cifras de criptografia suportadas:
- aes128-ctr
- aes192-ctr
- aes256-ctr
- aes128-cbc
- Arcfour256
- Arcfour128
- Arcfour
- 3des-cbc
Suítes de cifras suportadas:
- chacha20-poly1305@openssh.com: Chacha20 é um algoritmo de criptografia simétrica, enquanto Poly1305 é uma cifra de autenticação.
- aes128-gcm@openssh.com: Advanced Encryption Standard (AES) com uma chave de 128 bits usando o Galois/Counter Mode (GCM).
Se o servidor SFTP não suportar as codificações apropriadas, recomendamos a utilização de uma das outras fontes de importação apresentadas nesta página.
Próximas etapas – Automação de importação de contatos do XM Directory
Agora que você concluiu a configuração de um servidor SFTP como fonte de importação, é hora de concluir a criação da automação de importação de contatos.
- Etapa 3: criptografia PGP
- Etapa 4: selecionar caminhos de pasta
- Etapa 5: Mapeamento de campo de dados e listas de destinatários
- Etapa 6: Vincular a automações de distribuição
- Etapa 7: Envio de relatórios de execução e ativação da automação
Próximas etapas – Automação de importação de pessoas do diretório de colaboradores
Google Drive & Dropbox
Você pode usar sua conta do Google Drive ou Dropbox como armazenamento de arquivos para automações de importação de contato. Suas informações de login para esses serviços permanecerão privadas; o Armazenamento de arquivos OAuth permite que as informações de conta de um usuário final sejam usadas pela Qualtrics, sem expor a senha do usuário. Essas informações de conta são usadas para se conectar ao armazenamento de arquivos de automações no XM Directory, comportando-se de forma semelhante à configuração do SFTP.
Quando a automação estiver programada para ser executada, ela processará os arquivos que ainda não foram processados pela automação, incluindo os recém-carregados. Quando um arquivo é processado, ele é removido do armazenamento de arquivos OAuth.
- Na etapa Configurar fonte de importação, selecione Google Drive ou Dropbox.
- Clique em Continuar.
- Você precisará acessar sua conta do Google ou Dropbox clicando em Acessar. Isso o redirecionará para uma nova janela na qual você pode iniciar sessão via OAuth.
- Assim que o acesso for bem-sucedido, você será redirecionado para concluir a configuração ou, se desejar, Alternar contas para outro usuário OAuth. Você também pode remover a conta OAuth clicando em Alterar na fonte de dados e selecionando uma fonte de dados alternativa.
- Vá para a seção Selecionar origem do arquivo de importação depois de configurar sua Fonte de importação. Você poderá declarar seu caminho da pasta aqui (por exemplo, “FolderName/Folder2”).
Próximas etapas – Automação de importação de contatos do XM Directory
Agora que você concluiu a configuração de um servidor SFTP como fonte de importação, é hora de concluir a criação da automação de importação de contatos.
- Etapa 3: criptografia PGP
- Etapa 4: selecionar caminhos de pasta
- Etapa 5: Mapeamento de campo de dados e listas de destinatários
- Etapa 6: Vincular a automações de distribuição
- Etapa 7: Envio de relatórios de execução e ativação da automação
Próximas etapas – Automação de importação de pessoas do diretório de colaboradores
- Etapa 3: criptografia PGP
- Etapa 4: selecionar caminhos de pasta
- Etapa 5: mapeamento de campos de dados
- Etapa 6: Envio de relatórios de execução e ativação da automação