Passer au contenu principal
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Service Web


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


À 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.

Astuce Qualtrics : cette page contient des références à l’API de Qualtrics, qui est une fonctionnalité à laquelle un accès spécial est requis. Si vous souhaitez accéder à cette fonctionnalité, contactez votre Administrateur de marque pour plus d’informations.
Attention : la configuration d’un service Web nécessite souvent des connaissances avancées en programmation. Bien que notre équipe de support soit heureuse de vous aider avec les notions de base de la mise à disposition d’informations dans le service Web, nous ne pouvons pas fournir d’assistance sur les aspects de programmation. Vous pouvez plutôt tenter de vous adresser à notre communauté d’utilisateurs dédiés.

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.
    accès au flux d’enquête en cliquant sur l’icône de flux d’enquête dans la barre de navigation de gauche
  2. Cliquez sur Ajouter ci-dessous ou Ajouter un nouvel élément ici.
    Ajouter ci-dessous et ajouter un nouvel élément Boutons Ici ; option Service Web dans loption Que voulez-vous ajouter ? Menu
  3. Sélectionnez Service Web.
  4. Dans la zone URL, collez l’URL de votre service Web externe.
    Zone pour URL dans un service Web suivie de la méthode

    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.

Type de méthode Action Exemple
GET Le service Web accède à l’URL et récupère des informations. Récupérez des informations sur un membre de votre liste de contacts. Voir l’appel de l’API Get Contact pour plus de détails.
POST Accédez à l’URL et sauvegardez les informations. Créez un message de la bibliothèque.
PUT Mettez à jour ou remplacez les informations existantes. Modifiez un nom d’utilisateur. C’est l’une des choses que vous pouvez faire avec l’appel Mettre à jour l’utilisateur.
PATCH Mettez à jour ou remplacez les informations existantes. Très similaire à PUT. Bien que notre service Web propose cette méthode, notre API n’utilise pas d’appels PATCH. Modifier les données enregistrées sur votre serveur.
DELETE Supprimez les informations. Supprimer une image de votre bibliothèque.

 

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

Méthode indiquée en regard de chaque appel dans la documentation API

Paramètres

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

Un service Web avec les éléments suivants en surbrillance : Ajouter un paramètre de requête, Ajouter un paramètre de corps et Ajouter un en-tête personnalisé

  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. Dans un paramètre de corps, chaque clé et valeur dun objet JSON, ainsi que chaque élément dun tableau JSON, doit comporter des 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.

Dans la documentation de lAPI, une flèche indiquant les paramètres du corps

Ajout de paramètres à votre service Web

Paramètres de corps renseignés dans un 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.
    Bouton Tester lURL en regard de la zone URL
  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.
    Sélection des zones à capturer à partir de lURL
  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.
    Option "Incendir" et "Oublier" au-dessus des zones ; appliquer en bas à droite

    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.

boîte de dialogue qui s’ouvre sur le flux d’enquête et indique Sélectionner les champs à inclure en tant que données intégrées Le service Web n’a renvoyé aucun champ. Cliquez ici pour afficher les données brutes. Dans le coin inférieur gauche de la boîte de dialogue se trouve un bouton qui indique Afficher les données brutes.

Attention : si vous mettez à jour l’élément de service Web pour corriger l’erreur, vous devez également publier vos modifications dans l’enquête. Nous vous recommandons de résoudre les erreurs dès que possible afin d’éviter les sessions d’enquête en cours en utilisant l’ancienne version de l’enquête après l’échéance. Si vous résolvez plutôt l’erreur via une autre méthode (par exemple, en corrigeant la configuration TLS sur le serveur ciblé par votre élément de service Web), la publication n’est pas nécessaire.

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 :

De nombreuses pages de ce site ont été traduites de l'anglais en traduction automatique. Chez Qualtrics, nous avons accompli notre devoir de diligence pour trouver les meilleures traductions automatiques possibles. Toutefois, le résultat ne peut pas être constamment parfait. Le texte original en anglais est considéré comme la version officielle, et toute discordance entre l'original et les traductions automatiques ne pourra être considérée comme juridiquement contraignante.