Modello di articolo

Informazioni sui servizi web

A volte è possibile includere nel sondaggio funzioni più complesse. Forse volete inserire nel vostro sondaggio i 10 titoli più importanti di un sito web di notizie, oppure volete automatizzare la distribuzione di un secondo sondaggio tramite e-mail ai partecipanti di un primo sondaggio esattamente 2 ore dopo. Un servizio Web consente di fare proprio questo, inviando richieste a un URL designato.

Aggiunta di un servizio web

1. Durante la modifica del sondaggio, fare clic sull’icona Flusso del sondaggio nella barra di navigazione 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.
   
   Consiglio Q: È possibile utilizzare il testo trasferito per passare le informazioni sul sondaggio nell’URL dell’endpoint tramite stringhe query.
5. Selezionare un metodo per il servizio web. Nella sezione che segue verranno spiegati meglio i diversi metodi.

Metodi

La funzione di servizio web consente di scegliere tra una serie di Funzioni per richiedere informazioni dall’URL specificato.

Se si utilizzano le chiamate API, la documentazione indica quale metodo utilizzare, come indicato nella schermata seguente.

Parametri

Attualmente esistono 3 tipi di parametri che possono essere aggiunti alla richiesta.

1. Parametro di query: Invece di aggiungere una stringa query alla fine dell’URL del servizio web, inserire qui i parametri della query.
2. Parametro corpo: Questo parametro non è disponibile per le richieste GET o DELETE. Sono disponibili 2 opzioni di formattazione:
   a) application/x-www-form-urlencoded: Invece di inserire i parametri del corpo nell’area specificata del servizio Web, aggiungerli come stringa query alla fine dell’URL specificato.
   b) application/json: Inserire le chiavi in notazione a punti. Ad esempio, la nostra chiamata API può chiedere all’utente di specificare un’intestazione[fromEmail]. In notazione a punti, questo diventa header.fromEmail.
   Attenzione: Ogni chiave e valore di un oggetto JSON, così come ogni elemento di un array JSON (compreso il testo trasferito), deve essere circondato da doppi apici.
3. Intestazione personalizzata: Inserire qui le intestazioni degli URL.
   Consiglio q: gli URL di autenticità devono essere aggiunti nell’intestazione personalizzata.

Se si utilizzano le nostre chiamate API, la documentazione indica il tipo di parametri da includere. L’esempio seguente fornisce i parametri del corpo da impostare.

Aggiunta di parametri al servizio web

1. Selezionare una delle 3 opzioni di Aggiungi un parametro da inviare al servizio web indicate nella sezione precedente. Nell’esempio precedente, si indicano i parametri della query.
2. Digitare il nome del parametro nella casella Parameter to Web Service 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.

Verifica dei parametri

Una volta incollato l’URL e impostati i parametri, si può testare l’URL per vedere quali campi si possono ottenere.

1. Fare clic su URL di prova per vedere quali informazioni è possibile estrarre dal servizio Web esterno.
   
2. Selezionare i campi che si desidera utilizzare o registrare nel sondaggio. Il NOME CAMPO appare a sinistra e il corrispondente valore di esempio a destra.
   
3. Fare clic su Aggiungi dati integrati per aggiungere ai dati i campi selezionati.
   Consiglio q: è possibile modificare i nomi dei dati integrati associati ai campi del servizio web nella colonna Imposta dati integrati. I nomi dei dati integrati si trovano a sinistra del segno di uguale(=), indicato dall’icona verde ED. Il lato destro non deve essere modificato. I nomi impostati a sinistra saranno i nomi dei campi così come appaiono nei dati.
4. Se si seleziona Fire and Forget, non si salverà nessuno dei dati restituiti dalla chiamata al servizio Web. Questa funzione è utile quando non è necessario salvare i dati restituiti.
   
   Consiglio Q: Fire and Forget consente al sondaggio di effettuare una richiesta a un servizio web senza attendere risposte. Ciò significa che i vostri intervistati potranno completare l’intero sondaggio senza ritardi dovuti al servizio web. Si può usare questa funzione se si ha una richiesta di servizio Web che richiede molto tempo per essere elaborata, ma si consiglia di usarla solo in fase di test, poiché impedisce il salvataggio dei dati integrati.
5. Al termine, fare clic su Applica.

Correzione degli errori TLS

A partire dal 1° settembre 2021, le richieste di servizi Web con errori di Transport-Layer Security (TLS) non saranno accettate. Il TLS rende sicure le richieste web tramite HTTPS (rispetto al semplice HTTP), impedendo che i dati della richiesta siano visibili a terzi e garantendo che la richiesta venga inviata alla destinazione corretta. Ignorare gli errori TLS elimina di fatto questi benefit aziendali; questa modifica è un passo importante nel nostro continuo impegno per migliorare la sicurezza della piattaforma QUALTRrics.

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 assistenza non può fornire indicazioni specifiche in merito, ma il vostro amministratore di rete saprà come risolvere l’errore.
• Modificare la richiesta di servizio Web dell’elemento di flusso in HTTP e non in HTTPS. Ad esempio, si può cambiare l’URL “https://example.com” in “http://example.com”. Se si sceglie questo approccio, è necessario assicurarsi che l’URL HTTP non venga reindirizzato all’URL HTTPS.
  Attenzione: Tenere presente che questo approccio comporta la trasmissione in chiaro dei dati della richiesta di servizio Web.

È possibile verificare che l’elemento del servizio Web sia pronto per questa modifica utilizzando il pulsante di prova avanti al campo URL nell’elemento di flusso. La visualizzazione dei dati grezzi nella finestra risultante, mostrata anche qui sotto, non dovrebbe mostrare alcun errore.

Tipi di progetti in cui è disponibile questa funzione

Se la licenza prevede l’accessibilità ai Servizi Web, è possibile aggiungere un servizio Web al flusso del sondaggio di qualsiasi tipo di progetto. Sono inclusi:

• Progetti di sondaggio
• Coinvolgimento
• 360
• Ciclo di vita
• Ricerca dipendente ad hoc
• Sondaggio d’opinione
• Soluzioni XM
• Analisi congiunte
• MaxDiff