Sources d’importation de fichiers pour les automatisations

À propos des sources d’importation de fichiers pour les automatisations

Avec les automatisations d’importation de contacts et les automatisations d’importation d’employés, vous pouvez rationaliser la gestion de vos répertoires. Lorsque l’exécution de l’automatisation est planifiée, elle traite tous les fichiers désignés qui n’ont pas encore été traités par l’automatisation, y compris les fichiers nouvellement téléchargés. Cependant, avant de pouvoir le faire, l’automatisation doit savoir d’où extraire vos fichiers.

La source du fichier pour les automatisations d’importation de contacts et les automatisations d’importation d’employés peut être :

1. Service de fichier Qualtrics
2. Votre serveur SFTP
3. Stockage de fichiers OAuth (Google Drive ou Dropbox)

Service de fichier Qualtrics

Le service de fichier Qualtrics est une API de stockage de fichiers sécurisée qui vous permet d’importer des fichiers pour cette automatisation. Vous pouvez télécharger un fichier vers un point de terminaison HTTPS, qui sera fourni dans une zone grise (illustrée ci-dessous), sous forme de données de formulaire multiparties.

Lorsque l’exécution de l’automatisation est planifiée, elle traite tous les fichiers qui n’ont pas encore été traités par l’automatisation, y compris ceux qui viennent d’être chargés.

Pour utiliser le service de fichiers Qualtrics, vous devrez appeler le point de terminaison HTTPS fourni. Si le fichier est généré à partir du système, vous devrez fournir la documentation API et l’exemple d’implémentation suivant à votre équipe informatique ou de génie logiciel pour l’intégrer à notre service.

curl -X POST -H "X-API-TOKEN: [YOUR API TOKEN]" \
 -F 'file=@/path/to/import/file/sample-file.txt' \
 https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files

curl -X POST -H "X-API-TOKEN: [YOUR API TOKEN]" ^
 -F "file=@/path/to/import/file/sample-file.txt" ^
 https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files

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/plain
 
 [FILE DATA]
 -----------------------------

Gestion manuelle des fichiers chargés avec API

Vous pouvez également gérer manuellement les fichiers téléchargés à l’aide de l’API Qualtrics. Les liens suivants expliquent comment interagir avec l’API du service de fichiers Qualtrics :

• Répertorier tous les fichiers chargés pour cette automatisation.
• Chargez un fichier à utiliser par cette automatisation.
• Obtenez les métadonnées associées à un fichier.
• Obtenez le contenu d’un fichier.
• Supprimer un fichier.

Parfois, ces appels d’API demanderont un ID d’automatisation. Qualtrics vous fournira ces informations au format AU_XXXXX.

Étapes suivantes – Automatisation de l’importation des contacts du répertoire XM

Maintenant que vous avez terminé de définir le Service de fichier Qualtrics comme votre source d’importation, il est temps de terminer la création de votre automatisation d’importation de contacts.

• Étape 3 : chiffrement PGP
• Étape 4 : sélection des chemins d’accès au dossier
• Étape 5 : Mappage des champs de données et listes de distribution
• Étape 6 : Liaison aux automatisations de distribution
• Étape 7 : Envoi de rapports d’exécution et activation de l’automatisation

Étapes suivantes – Automatisation de l’importation de personnes du répertoire des employés

• Étape 3 : chiffrement PGP
• Étape 4 : sélection des chemins d’accès au dossier
• Étape 5 : Mappage des champs de données
• Étape 6 : Envoi de rapports d’exécution et activation de l’automatisation

Serveur SFTP

Vous souhaiterez peut-être intégrer vos propres enregistrements de contacts à Qualtrics à l’aide du protocole SFTP (Secure File Transfer Protocol). Par exemple, vous pouvez souhaiter importer du contenu à partir d’un dépôt de fichier quotidien hébergé, puis importer et planifier des distributions d’enquêtes pour ces contacts, le tout dans le cadre des méthodes de transfert les plus sécurisées et les plus sécurisées.

Lorsque l’exécution de l’automatisation est planifiée, elle traite tous les fichiers qui n’ont pas encore été traités par l’automatisation, y compris ceux qui viennent d’être chargés. Lorsqu’un fichier est traité, il est supprimé du serveur SFTP.

Dans l’étape Configurer la source d’importation, il existe 2 options SFTP : Nom d’utilisateur &amp ; Mot de passe et nom d’utilisateur &amp ; Clé SSH.

1. À l’étape Configurer la source d’importation, sélectionnez l’un des serveurs SFTP.
   
2. Cliquez sur Continuer.
3. Saisissez l’ URL de l’hôte.
   
   Astuce : l’URL ressemble généralement à sftp.example.com.
4. Saisissez le nom d’utilisateur. Ceci est sensible à la casse.
5. Saisissez le port. Ceci est facultatif. 22 est saisi comme valeur par défaut.
6. Cliquez sur Continuer.

Selon que vous avez sélectionné le mot de passe ou la clé SSH, vos prochaines étapes varieront.

Configuration via nom d’utilisateur &amp ; mot de passe

1. Saisissez votre mot de passe.
   
   Astuce Qualtrics : si l’hôte, le nom d’utilisateur et le port exacts ont déjà été fournis, aucun mot de passe ne vous sera demandé.
2. Cliquez sur Continuer.

Configuration via nom d’utilisateur &amp ; clé SSH

1. Si aucune clé n’est déjà présente, sélectionnez l’option Générer une nouvelle paire de clés SSH.
   
   Astuce Qualtrics : la nouvelle paire de clés SSH est toujours présente même si une clé est déjà générée. Cette option peut être sélectionnée si l’utilisateur souhaite créer une clé, mais cela n’est pas nécessaire si les mêmes identifiants SFTP sont utilisés pour la nouvelle automatisation. La paire de clés est partagée dans toutes les automatisations utilisant les mêmes identifiants SFTP dans un seul compte utilisateur.
2. Cliquez sur Télécharger la clé publique.
   
3. Téléchargez la clé publique sur votre serveur SFTP.

Chiffrements pris en charge

La connexion à un serveur SFTP nécessite une série de poignées de main SSH pour coordonner le cryptage utilisé entre le serveur et l’automatisation. Pour établir une connexion, le serveur SFTP doit avoir au moins un chiffrement pour chaque type de chiffrement qui correspond à un chiffrement pris en charge par les automatisations. Vous trouverez ci-dessous la liste des chiffrements pris en charge par les automatisations regroupées par type de chiffrement.

Chiffres d’échange de clés pris en charge :

• 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

Chiffrements Mac pris en charge :

• hmac-sha2-256
• hmac-sha2-512

Chiffrements de chiffrement pris en charge :

• aes128-ctr
• aes192-ctr
• aes256-ctr
• aes128-cbc
• Arcfour256
• Arcfour128
• Arcfour
• 3des-cbc

Suites chiffrées prises en charge :

• chacha20-poly1305@openssh.com : Chacha20 est un algorithme de chiffrement symétrique, tandis que Poly1305 est un chiffrement authentifiant.
• aes128-gcm@openssh.com: Advanced Encryption Standard (AES) avec une clé de 128 bits utilisant le mode Galois/Counter (GCM).

Si le serveur SFTP ne prend pas en charge les chiffrements appropriés, nous vous recommandons d’utiliser l’une des autres sources d’importation présentées sur cette page.

Étapes suivantes – Automatisation de l’importation des contacts du répertoire XM

Maintenant que vous avez terminé la configuration d’un serveur SFTP comme source d’importation, il est temps de terminer la création de votre automatisation d’importation de contacts.

• Étape 3 : chiffrement PGP
• Étape 4 : sélection des chemins d’accès au dossier
• Étape 5 : Mappage des champs de données et listes de distribution
• Étape 6 : Liaison aux automatisations de distribution
• Étape 7 : Envoi de rapports d’exécution et activation de l’automatisation

Étapes suivantes – Automatisation de l’importation de personnes du répertoire des employés

• Étape 3 : chiffrement PGP
• Étape 4 : sélection des chemins d’accès au dossier
• Étape 5 : Mappage des champs de données
• Étape 6 : Envoi de rapports d’exécution et activation de l’automatisation

Google Drive & Dropbox

Vous pouvez utiliser votre compte Google Drive ou Dropbox comme stockage de fichiers pour vos automatisations d’importation de contacts. Vos informations de connexion pour ces services resteront privées ; le stockage de fichiers OAuth permet à Qualtrics d’utiliser les informations de compte d’un utilisateur final, sans exposer le mot de passe de l’utilisateur. Ces informations de compte sont utilisées pour se connecter au stockage de fichiers à partir d’automatisations dans le répertoire XM, se comportant de manière similaire à une configuration SFTP.

Lorsque l’exécution de l’automatisation est planifiée, elle traite tous les fichiers qui n’ont pas encore été traités par l’automatisation, y compris ceux qui viennent d’être chargés. Lorsqu’un fichier est traité, il est supprimé du stockage de fichiers OAuth.

1. À l’étape Configurer la source d’importation, sélectionnez Google Drive ou Dropbox.
   
2. Cliquez sur Continuer.
3. Vous devrez vous connecter à votre compte Google ou Dropbox en cliquant sur Connexion.  Vous serez redirigé vers une nouvelle fenêtre dans laquelle vous pourrez vous connecter via OAuth.
   
4. Une fois la connexion réussie, vous serez redirigé pour terminer la configuration ou, si vous le souhaitez, basculer les comptes vers un autre utilisateur OAuth. Vous pouvez également supprimer le compte OAuth en cliquant sur Modifier dans la source de données et en sélectionnant une autre source de données.
   
5. Rendez-vous dans la section Sélectionner la source du fichier d’importation après avoir configuré votre source d’importation. Vous pourrez déclarer votre chemin d’accès au dossier ici (par exemple, “NomDossier/Dossier2”).
   

Étapes suivantes – Automatisation de l’importation des contacts du répertoire XM

Maintenant que vous avez terminé la configuration d’un serveur SFTP comme source d’importation, il est temps de terminer la création de votre automatisation d’importation de contacts.

• Étape 3 : chiffrement PGP
• Étape 4 : sélection des chemins d’accès au dossier
• Étape 5 : Mappage des champs de données et listes de distribution
• Étape 6 : Liaison aux automatisations de distribution
• Étape 7 : Envoi de rapports d’exécution et activation de l’automatisation

Étapes suivantes – Automatisation de l’importation de personnes du répertoire des employés

• Étape 3 : chiffrement PGP
• Étape 4 : sélection des chemins d’accès au dossier
• Étape 5 : Mappage des champs de données
• Étape 6 : Envoi de rapports d’exécution et activation de l’automatisation

&nbsp ;