Modèle d’article

À propos des services Web

Il peut arriver que vous souhaitiez inclure des fonctions plus complexes dans votre enquête. Peut-être souhaitez-vous intégrer à votre enquête les 10 principaux titres d’un site web d’actualités ou automatiser la distribution d’une deuxième enquête qui sera envoyée par e-mail aux personnes ayant répondu à une première enquête exactement deux heures plus tard. Un service web vous permet de le faire en envoyant des requêtes à une URL désignée.

Ajout d’un service web

1. Lorsque vous éditez 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 le champ URL, collez l’URL de votre service Web externe.
   
   Astuce : vous pouvez utiliser le texte inséré pour transmettre des informations sur l’Enquête dans l’URL de votre point d’arrivée 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 fonction de service web vous permet de choisir parmi une série de méthodes pour demander des informations à l’URL spécifiée.

&nbsp ;

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 l’URL de votre service web, placez vos paramètres de requête ici.
2. Paramètre du corps: Ce paramètre n’est pas disponible pour les requêtes GET ou DELETE. Technologie de l’information :
   a) application/x-www-form-urlencoded: Plutôt que d’entrer vos paramètres de corps dans la zone spécifiée du Service Web, ajoutez-les en tant que chaîne de requête à la fin de votre URL spécifiée.
   b) application/json: Saisissez vos clés en notation pointée. Par exemple, notre appel API peut vous demander de spécifier un en-tête [fromEmail]. En notation pointée, 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érer ici les en-têtes d’URL.
   Astuce: Les URL d’authentificateurs doivent être ajoutées dans l’en-tête personnalisé.

Si vous utilisez les appels de notre API, la documentation vous indiquera le type de paramètres à inclure. L’exemple ci-dessous présente les paramètres du 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 la requête.
2. Saisissez le nom du paramètre dans la case Parameter to Web Service à gauche.
3. Tapez la valeur correspondante du paramètre dans la case 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 des paramètres

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

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 champ apparaît à gauche et l’Exemple de valeur correspondant apparaît à droite.
   
3. Cliquez sur Ajouter des données intégrées pour ajouter les champs sélectionnés à vos données.
   Astuce: 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. La côte à côte ne doit pas être modifiée. Les noms que vous avez définis à gauche seront les noms des champs tels qu’ils apparaissent dans vos données.
4. Si vous sélectionnez l’option Fire and Forget, vous ne sauvegarderez aucune des données renvoyées par l’appel au service web. Cette fonction est utile lorsque vous n’avez pas besoin d’enregistrer les données renvoyées.
   
   Astuce: La fonction “Fire and Forget” permet à votre enquête d’adresser une demande à un service web sans attendre de réponse. Cela signifie que vos répondants seront en mesure de répondre à l’intégralité de l’enquête sans aucun retard grâce au service web. Vous pouvez utiliser cette option si vous avez une demande de service web qui prend du temps à traiter, mais nous vous recommandons de n’utiliser cette fonction que pendant les tests, car elle empêchera les données intégrées d’être sauvegardées.
5. Lorsque vous avez terminé, cliquez sur Appliquer.

Correction des erreurs TLS

À partir du 1er septembre 2021, les demandes de services web comportant des erreurs de sécurité de la couche transport (TLS) échoueront. C’est TLS qui sécurise les requêtes web via HTTPS (par opposition à HTTP simple), en empêchant que les données de la requête soient visibles par des tiers et en garantissant que la requête est envoyée à la bonne destination. Le fait d’ignorer les erreurs TLS élimine effectivement 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 opérations suivantes :

• Corriger 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.
• Modifier la demande de service web de l’élément de flux pour qu’elle soit effectuée 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 : Veuillez noter que cette approche entraînera la transmission non cryptée des données de la demande de service web.

Vous pouvez vérifier que votre élément de service web est prêt pour cette modification en utilisant le bouton de test suivant le champ URL dans l’élément de flux. L’affichage des données brutes dans la fenêtre résultante, également illustrée ci-dessous, ne devrait pas faire apparaître d’erreur.

Types de projets dans lesquels cette fonction est disponible

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

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