Servizio web

Informazioni sui servizi Web

A volte potresti voler includere caratteristiche più complesse nel tuo sondaggio. Forse vuoi inserire nel tuo sondaggio i primi 10 titoli di un sito web di notizie o vuoi automatizzare una seconda distribuzione del sondaggio da inviare tramite e-mail agli intervistati di un primo sondaggio esattamente 2 ore dopo. Un servizio Web consente di eseguire solo questa operazione effettuando richieste a un URL designato.

Aggiunta di un servizio Web

1. Durante la modifica del sondaggio, fai clic sull’icona Flusso del sondaggio nella barra di navigazione a sinistra.
   
2. Fai clic su Aggiungi sotto o Aggiungi qui un nuovo elemento.
   
3. Selezionare Servizio Web.
4. Nel campo URL, incollare l’URL del servizio Web esterno.
   
   Qtip: puoi utilizzare il testo trasferito per trasmettere le informazioni dell’indagine all’URL del punto finale tramite stringhe di query.
5. Selezionare un Metodo per il servizio Web. Spiegheremo di più i diversi metodi nella sezione sottostante.

Metodi

La nostra funzionalità del servizio Web consente di scegliere tra una serie di Metodi per richiedere informazioni dall’URL specificato.

Se stai utilizzando le nostre chiamate API, la documentazione ti indicherà quale metodo utilizzare, come indicato nella cattura dello schermo sottostante.

Parametri

Ci sono attualmente 3 tipi di parametri che puoi aggiungere alla tua richiesta.

1. Parametro di query: invece di aggiungere una stringa di query alla fine dell’URL del servizio Web, posizionare qui i parametri di query.
2. Parametro corpo: questo parametro non è disponibile per le richieste GET o DELETE. Viene fornito con 2 opzioni di formattazione:
   a) application/x-www-form-urlencoded: anziché inserire i parametri del corpo nell’area specificata del servizio Web, aggiungerli come stringa di query alla fine dell’URL specificato.
   b) application/json: immettere le chiavi in Dot Notation. Ad esempio, la chiamata API potrebbe richiedere di specificare un’intestazione [fromEmail]. In Notazione punto, diventa header.fromEmail.
   Attenzione: ogni chiave e valore in un oggetto JSON, così come ogni elemento in una matrice JSON (incluso il testo trasferito), deve avere le virgolette doppie intorno ad esso.
3. Intestazione personalizzata: inserire qui le intestazioni URL.

Se si utilizzano le chiamate API, la documentazione indicherà il tipo di parametri da includere. L’esempio seguente fornisce i parametri Corpo da impostare.

Aggiunta di parametri al servizio Web

1. Selezionare una delle 3 opzioni Aggiungi un parametro da inviare al servizio Web indicate nella sezione precedente. Nell’esempio precedente, si stanno indicando i Parametri query.
2. Digitare il nome del parametro nella casella Parametro al servizio Web a sinistra.
3. Digitare il valore corrispondente del parametro nella casella Valore a destra.
4. Fare clic sul segno più (+) a destra del parametro per aggiungerne un altro.
5. Al termine, fare clic su Applica.

Testare i parametri

Dopo aver incollato l’URL e configurato i parametri, è possibile verificare l’URL per vedere quali campi è possibile inserire.

1. Fare clic su Testare URL per visualizzare le informazioni che è possibile rilevare dal servizio Web esterno.
   
2. Seleziona i campi che vuoi utilizzare o registrare nel tuo sondaggio. Il Nome campo viene visualizzato a sinistra e un Valore di esempio corrispondente a destra.
   
3. Fai clic su Aggiungi dati incorporati per aggiungere i campi selezionati ai tuoi dati.
   Qtip: puoi modificare i nomi dei dati incorporati associati ai campi del tuo servizio web nella colonna Imposta dati incorporati. I nomi dei dati incorporati sono a sinistra del segno di uguale (=), indicato da un’icona ED verde. Il lato destro non deve essere modificato. I nomi impostati a sinistra saranno quelli dei campi visualizzati nei dati.
4. Se si seleziona Incendio e dimenticate, non verranno salvati i dati restituiti dalla chiamata del servizio Web. Questa funzionalità è utile quando non è necessario salvare i dati restituiti.
   
   Qtip: Fuoco e dimentica permette al tuo sondaggio di fare una richiesta a un servizio web senza attendere una risposta. Ciò significa che i partecipanti saranno in grado di completare il sondaggio completo senza ritardi a causa del servizio web. È possibile utilizzare questa opzione se si dispone di una richiesta di servizio Web che richiede un po’ di tempo per l’elaborazione, ma si consiglia di utilizzare questa funzionalità solo durante il test, poiché impedirà il salvataggio dei dati incorporati.
5. Al termine dell’operazione, fare clic su Applica.

Correzione degli errori TLS

A partire dal 1° settembre 2021, le richieste di servizio Web con errori Transport-Layer Security (TLS) avranno esito negativo. TLS è ciò che rende sicure le richieste Web tramite HTTPS (al contrario di semplici HTTP), impedendo la visibilità dei dati della richiesta a terzi e garantendo che la richiesta venga inviata alla destinazione corretta. Ignorare gli errori TLS elimina efficacemente questi vantaggi in termini di sicurezza; questa modifica è un passo importante nei nostri continui sforzi per migliorare la sicurezza della piattaforma Qualtrics.

Per risolvere ogni errore TLS, è necessario eseguire una delle seguenti operazioni:

• Correggere l’errore TLS. A causa della natura degli errori TLS, il nostro team di supporto non può fornire indicazioni specifiche su come farlo, ma l’amministratore di rete saprà come risolvere l’errore.
• Modificare la richiesta di servizio Web dell’elemento di flusso da eseguire tramite HTTP, non HTTPS. Ad esempio, è possibile modificare l’URL “https://example.com” in “http://example.com”. Se si sceglie questo approccio, è anche necessario assicurarsi che l’URL HTTP non venga reindirizzato all’URL HTTPS.
  Attenzione: questo approccio determinerà la trasmissione non crittografata dei dati della richiesta del servizio Web.

È possibile verificare che l’elemento del servizio Web sia pronto per questa modifica utilizzando il pulsante di test accanto al campo URL nell’elemento del flusso. La visualizzazione dei dati grezzi nella finestra risultante, anch’essa mostrata di seguito, non deve mostrare un errore.