Extraire des données de la tâche Amazon S3

À propos de l’extraction de données depuis Amazon S3

Amazon Simple Storage Service (également connu sous le nom Amazon S3) est un service où vous pouvez stocker des données. Avec les flux de travail, vous pouvez facilement automatiser l’extraction des données d’Amazon S3 pour les utiliser dans Qualtrics.

Avant de commencer

Avant de commencer à extraire des données d’Amazon S3, tenez compte des considérations suivantes :

• Que voulez-vous faire de vos données ? Consultez les tâches du chargeur disponibles pour obtenir une liste d’options.
• Vos fichiers correspondent-ils à un format cohérent ? Par exemple, les fichiers que vous souhaitez importer dans le même workflow doivent avoir les mêmes en-têtes/colonnes/zones, même si les valeurs diffèrent.

Connexion de Qualtrics à AWS

Autorisation S3 requise pour un utilisateur IAM

Les utilisateurs IAM doivent disposer des autorisations S3 suivantes pour connecter leur compte AWS. Pour en savoir plus sur la gestion des accès S3, voir la documentation d’AWS.

• s3:DeleteObject
• s3:GetObject
• s3:ListBucket
• s3:PutObject
• s3:AbortMultipartUpload
• s3:ListMultipartUploadParts

RESSOURCES S3 REQUISES POUR UN UTILISATEUR IAM

Les utilisateurs IAM doivent disposer des ressources S3 suivantes pour connecter leur compte AWS. Pour en savoir plus sur la gestion des accès S3, voir la documentation d’AWS.

• arn:aws:s3:::bucket-name/*
• arn:aws:s3:::nom-boucle

Ajout d’un compte AWS

Ces étapes expliquent comment connecter votre compte Qualtrics personnel à un compte Amazon Web Services (AWS).

1. Créez un workflow avec une tâche Extraire les données d’Amazon S3.
2. Cliquez sur Ajouter un compte utilisateur.
   
3. Ajoutez un nom d’affichage pour le compte. Ce nom sera uniquement utilisé en interne pour faire référence à ce compte.
   
4. Copiez l’ ID compte et l‘ ID externe affichés.
5. Dans AWS, configurez un rôle IAM à l’aide de l’ID de compte et de l’ID externe. Consultez cette page d’assistance AWS pour en savoir plus sur les rôles IAM dans AWS.
6. Saisissez le nom de ressource Amazon associé au rôle IAM que vous avez créé.
7. Saisissez votre région. Consultez cette page d’assistance AWS si vous avez besoin d’aide pour trouver votre région.
8. Cliquez sur Connecter un compte.

Astuce Qualtrics : si vous le souhaitez, vous pouvez vous connecter à AWS à l’aide d’une clé d’accès et d’une clé secrète à la place. Pour ce faire, cliquez sur Passer à l’ancienne version en haut de la page.

Saisissez ensuite votre clé d’accès AWS et votre clé secrète. Vous devrez également nommer le compte et saisir votre région AWS.
Veuillez noter qu’Amazon vous recommande de ne pas utiliser cet ancien type de connexion et d’utiliser à la place la méthode étape par étape fournie ci-dessus. Cette méthode d’authentification deviendra obsolète à une date ultérieure.

Connexion d’un compte en tant qu’administrateur de l’organisation

En tant qu’Administrateur de la Marque, vous pouvez ajouter un compte AWS à partager avec plusieurs utilisateurs de votre licence. Pour ajouter un compte AWS partagé, accédez à la section Extensions de l’onglet Admin et recherchez l’extension AWS pour laquelle vous souhaitez ajouter un compte.

Une fois que vous avez sélectionné votre extension, suivez les étapes ci-dessus pour ajouter un compte AWS. Vous pouvez également sélectionner les utilisateurs qui ont accès au compte.

Configuration d’une tâche d’extraction de données à partir d’Amazon S3

1. Cliquez sur le menu de navigation en haut à gauche.
   
2. Sélectionnez Workflows.
3. Cliquez sur Créer un workflow.
4. Déterminez si le workflow doit être planifié ou basé sur les événements. Pour une comparaison de ces options, voir les workflows planifiés par rapport aux workflows basés sur les événements.
   Astuce Qualtrics : en règle générale, nous vous recommandons d’utiliser un workflow planifié avec des tâches d’extracteur pour les automatiser.
5. Si vous le souhaitez, renommez votre workflow en cliquant sur le nom du workflow en haut.
   
6. Déterminez quand le workflow doit être exécuté (si un workflow planifié) ou l’événement qui déclenche le workflow (s’il s’agit d’un workflow basé sur un événement).
7. Cliquez sur le signe plus ( + ) et sélectionnez Tâche.
8. Sélectionnez Extraire les données d’Amazon S3.
   
9. Sélectionnez le compte Amazon Web Services (AWS) à partir duquel extraire les fichiers. Tous les comptes ajoutés par les Administrateurs de la Marque, ainsi que les comptes que vous avez ajoutés vous-même, seront répertoriés ici.
   
10. Si vous souhaitez ajouter de nouveaux identifiants de compte AWS, cliquez sur Ajouter un nouveau compte et suivez les étapes de la section Connexion à un compte AWS.
11. Cliquez sur Suivant.
12. Saisissez le nom du compartiment S3 à partir duquel vous souhaitez extraire les données.
    
13. Saisissez un préfixe de nom de fichier. Tous les fichiers avec le préfixe que vous avez indiqué seront traités.
14. Sélectionnez un type de fichier à traiter. Vous avez le choix entre les options suivantes :
    • CSV (valeurs séparées par des virgules)
    • TSV (valeurs séparées par des tabulations)
15. Sous Traitement du fichier après l’importation, sélectionnez l’une des options suivantes :
    • Supprimer les fichiers traités (par défaut) : supprimez les fichiers d’AWS après leur extraction.
    • Déplacer les fichiers traités : Déplacer les fichiers traités dans un autre compartiment. Si vous choisissez cette option, il vous sera demandé de saisir le nom du compartiment S3 dans lequel vous souhaitez que les fichiers traités soient stockés.
      
    • Renommer les fichiers traités : renommez les fichiers après leur traitement. Si vous sélectionnez cette option, vous serez invité à fournir un préfixe que vous souhaitez ajouter aux noms de fichiers après leur traitement.
      
16. Sélectionnez cette option si vous souhaitez Utiliser PGP pour chiffrer vos fichiers.
17. Sous Charger un fichier échantillon, ajoutez un fichier échantillon ayant les mêmes en-têtes que les fichiers qui seront traités à chaque exécution du workflow. Cliquez sur Choisir un fichier pour télécharger le fichier depuis votre ordinateur.
    Astuce Qualtrics : si vous le souhaitez, vous pouvez télécharger les exemples de fichiers dans la tâche ou télécharger les fichiers dans la section Exemples de fichiers. Le seul format d’encodage de fichier pris en charge est UTF-8. Certains logiciels de feuille de calcul enregistrent des fichiers au format Unicode UTF-8, ce qui est différent de UTF-8 si vous recevez des erreurs inattendues. Assurez-vous que vous exportez au format UTF-8 et non au format Unicode UTF-8. Voir CSV & TSV Upload Issues (Problèmes de téléchargement TSV) pour plus d’étapes de dépannage.
    
18. Vérifiez les champs du fichier. La table affiche les en-têtes de colonne (qui représentent les champs individuels) et leurs valeurs pour les 2 premières lignes de données.
    
    Astuce Qualtrics : si vous souhaitez télécharger un autre fichier sur le serveur ou apporter d’autres modifications, cliquez sur Modifier la configuration.
19. Lorsque vous avez terminé, cliquez sur Sauvegarder.
20. Cliquez sur le signe plus (+) et sélectionnez Tâche pour configurer la tâche qui doit suivre votre extraction de données. Il doit s’agir d’une tâche du chargeur de données. Consultez les tâches du chargeur disponibles pour obtenir une liste des options.