Service Web

À propos des services Web

Il peut arriver que vous souhaitiez inclure des fonctionnalités plus complexes dans votre enquête. Vous souhaitez peut-être insérer les 10 titres d’un site Web d’actualités dans votre enquête, ou vous souhaitez automatiser une deuxième distribution d’enquête à envoyer par e-mail aux répondants d’une première enquête exactement 2 heures plus tard. Un service Web vous permet de le faire en adressant des requêtes à une URL désignée.

Ajout d’un service Web

1. Lors de la modification de votre enquête, cliquez sur l’icône Flux d’enquête dans la barre de navigation de gauche.
   
2. Cliquez sur Ajouter ci-dessous ou Ajouter un nouvel élément ici.
   
3. Sélectionnez Service Web.
4. Dans la zone URL, collez l’URL de votre service Web externe.
   
   Astuce Qualtrics : vous pouvez utiliser du texte inséré pour transmettre les informations de l’enquête à votre URL de point de terminaison via des chaînes de requête.
5. Sélectionnez une méthode pour votre service Web. Nous expliquerons plus en détail les différentes méthodes dans la section ci-dessous.

Méthodes

Notre fonctionnalité de service Web vous permet de choisir parmi une série de méthodes pour demander des informations à partir de votre URL spécifiée.

Si vous utilisez nos appels API, la documentation vous indiquera la méthode à utiliser, comme indiqué dans la capture d’écran ci-dessous.

Paramètres

Il existe actuellement 3 types de paramètres que vous pouvez ajouter à votre demande.

1. Paramètre de requête : au lieu d’ajouter une chaîne de requête à la fin de votre URL de service Web, placez vos paramètres de requête ici.
2. Paramètre de corps : ce paramètre n’est pas disponible pour les demandes GET ou DELETE. Il est fourni avec 2 options de mise en forme :
   a) application/x-www-form-urlencoded : Plutôt que de saisir les paramètres de votre corps dans la zone spécifiée du service Web, ajoutez-les comme chaîne de requête à la fin de votre URL .
   b) application/json : Saisissez vos clés dans Dot Notation. Par exemple, notre appel d’API peut vous demander d’indiquer un en-tête[fromEmail]. Dans Dot Notation, cela devient header.fromEmail.
   Attention : chaque clé et valeur d’un objet JSON, ainsi que chaque élément d’un tableau JSON (y compris le texte inséré), doit être entouré de guillemets doubles.
3. En-tête personnalisé : insérez les en-têtes d’URL ici.
   Astuce Qualtrics : les URL d’authentification doivent être ajoutées dans l’en-tête personnalisé.

Si vous utilisez nos appels API, la documentation vous indiquera les types de paramètres à inclure. L’exemple ci-dessous fournit les paramètres de corps à définir.

Ajout de paramètres à votre service Web

1. Sélectionnez l’une des 3 options Ajouter un paramètre à envoyer au service Web indiquées dans la section précédente. Dans l’exemple ci-dessus, nous indiquons les paramètres de requête.
2. Saisissez le nom du paramètre dans la zone Paramètre pour service Web à gauche.
3. Saisissez la valeur correspondante du paramètre dans la zone Valeur à droite.
4. Cliquez sur le signe plus (+) à droite du paramètre pour en ajouter un autre.
5. Cliquez sur Appliquer lorsque vous avez terminé.

Test de vos paramètres

Une fois que vous avez collé votre URL et configuré vos paramètres, vous pouvez tester votre URL pour voir quels champs vous pouvez extraire.

1. Cliquez sur Tester l’URL pour voir quelles informations vous pouvez extraire du service Web externe.
   
2. Sélectionnez les champs que vous souhaitez utiliser ou enregistrer dans votre enquête. Le nom de zone apparaît à gauche et une valeur d’exemple correspondante apparaît à droite.
   
3. Cliquez sur Ajouter des données intégrées pour ajouter des champs sélectionnés à vos données.
   Astuce Qualtrics : vous pouvez modifier les noms des données intégrées associées aux champs de votre service Web dans la colonne Définir les données intégrées. Les noms des données intégrées se trouvent à gauche du signe égal (=), indiqué par une icône ED verte. Le côté droit ne doit pas être modifié. Les noms que vous définissez à gauche seront les noms des champs tels qu’ils apparaissent dans vos données.
4. Si vous sélectionnez Feu et oubli, vous ne sauvegarderez aucune des données renvoyées par l’appel de service Web. Cette fonctionnalité est utile lorsque vous n’avez pas besoin d’enregistrer les données renvoyées.
   
   Astuce Qualtrics : feu et oubli permet à votre enquête de faire une demande à un service Web sans attendre de réponse. Cela signifie que vos répondants pourront répondre à l’enquête dans son intégralité sans retard dû au service Web. Vous pouvez utiliser cette option si vous avez une demande de service Web qui prend un certain temps à être traitée, mais nous vous recommandons d’utiliser cette fonctionnalité uniquement pendant le test, car elle empêchera l’enregistrement des données intégrées.
5. Lorsque vous avez terminé, cliquez sur Appliquer.

Correction des erreurs TLS

À partir du 1er septembre 2021, les demandes de services Web avec des erreurs TLS (Transport-Layer Security) échoueront. TLS est ce qui rend les requêtes Web via HTTPS (par opposition à HTTP simple) sécurisées, empêchant ainsi les données de la demande d’être visibles par des tiers et garantissant que la requête est envoyée à la bonne destination. Ignorer les erreurs TLS élimine efficacement ces avantages en matière de sécurité. Ce changement est une étape importante dans nos efforts continus pour améliorer la sécurité de la plateforme Qualtrics.

Pour résoudre chaque erreur TLS, vous devez effectuer l’une des actions suivantes :

• Corrigez l’erreur TLS. En raison de la nature des erreurs TLS, notre équipe d’assistance ne peut pas fournir de conseils spécifiques sur la manière de procéder, mais votre administrateur réseau saura comment corriger l’erreur.
• Modifiez la demande de service Web de l’élément de flux à effectuer via HTTP, et non HTTPS. Par exemple, vous pouvez remplacer l’URL “https://example.com” par “http://example.com”. Si vous optez pour cette approche, vous devez également vous assurer que l’URL HTTP ne redirige pas vers l’URL HTTPS.
  Attention : cette approche entraînera la transmission non chiffrée des données de demande de service Web.

Vous pouvez vérifier que votre élément de service Web est prêt pour cette modification à l’aide du bouton de test en regard du champ URL dans l’élément de flux. L’affichage des données brutes dans la fenêtre qui s’affiche, également illustré ci-dessous, ne doit pas afficher d’erreur.

Types de projets dans lesquels cette fonctionnalité est disponible

Tant que vous avez accès aux services Web dans le cadre de votre licence, vous pouvez ajouter un service Web à n’importe quel type de flux d’enquête du projet. Cela comprend :

• Projets d’enquête
• Engagement
• 360
• Cycle de vie
• Recherche ponctuelle sur les employés
• Enquête Pulse
• Solutions XM
• Conjoints
• Différence maximum