Passa al contenuto principale
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Servizio 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!


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.

Qtip: questa pagina contiene riferimenti all’API di Qualtrics, una funzione che richiede un’autorizzazione speciale per l’accesso. Se sei interessato ad ottenere l’accesso a questa funzione, contatta il tuo Amministratore della licenza per ulteriori informazioni.
Attenzione: l’impostazione di un servizio web richiede spesso conoscenze avanzate di programmazione. Anche se il nostro team di supporto è lieto di contribuire con le nozioni di base per inserire le informazioni nel servizio web, non possiamo fornire supporto sugli aspetti programmatici. Puoi invece provare a domandare alla nostra community di utenti esperti.

Aggiunta di un servizio Web

  1. Durante la modifica del sondaggio, fai clic sull’icona Flusso del sondaggio nella barra di navigazione a sinistra.
    Navigando fino al flusso del sondaggio facendo clic sullicona del flusso del sondaggio sulla barra di navigazione a sinistra
  2. Fai clic su Aggiungi sotto o Aggiungi qui un nuovo elemento.
    Pulsanti Aggiungi sotto e Aggiungi un nuovo elemento Qui; opzione Servizio Web in Cosa si desidera aggiungere? menu
  3. Selezionare Servizio Web.
  4. Nel campo URL, incollare l’URL del servizio Web esterno.
    Campo per URL in un servizio Web seguito dal metodo

    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 funzione di servizio web ti permette di scegliere tra una serie di Metodi per richiedere informazioni dal tuo URL specificato.

Tipo di metodo Azione Esempio
GET Il servizio Web passa all’URL e recupera le informazioni. Recupera informazioni su un membro della tua lista di contatti. Consultare la chiamata API Ottieni contatto per maggiori dettagli.
POST Passare all’URL e salvare le informazioni. Crea un messaggio della libreria.
PUT Aggiornare o sostituire le informazioni esistenti. Modificare un nome utente. Questa è una delle operazioni che è possibile eseguire con la chiamata Aggiorna utente.
PATCH Aggiornare o sostituire le informazioni esistenti. Molto simile a PUT. Mentre il nostro Web Service offre questo metodo, la nostra API non utilizza chiamate PATCH. Modificare i dati salvati sul server.
ELIMINA Rimuovere informazioni. Elimina un grafico dalla libreria.

 

Se si utilizzano le nostre chiamate API, la documentazione indicherà il metodo da utilizzare, come indicato nello screenshot seguente.

Metodo elencato accanto a ogni chiamata nella documentazione API

Parametri

Attualmente sono disponibili 3 tipi di parametri che è possibile aggiungere alla richiesta.

Un servizio Web con i seguenti elementi evidenziati: Aggiungere un parametro di query, Aggiungere un parametro del corpo e Aggiungere unintestazione personalizzata

  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: Piuttosto che immettere 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. In un parametro del corpo, ogni chiave e valore di un oggetto JSON, nonché ogni elemento di un array JSON, deve essere racchiuso tra virgolette doppie.
  3. Intestazione personalizzata: inserire qui le intestazioni URL.
    Consiglio Q: gli URL di autenticazione devono essere aggiunti all’intestazione personalizzata.

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

Nella documentazione API, una freccia che indica i parametri del corpo

Aggiunta di parametri al servizio Web

Parametri del corpo compilati in un 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.
    Testa pulsante URL accanto al campo URL
  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.
    Selezione dei campi da acquisire dallURL
  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.
    Opzione Incendio e dimenticata sopra i campi; applica in basso a destra

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

Finestra di dialogo che si apre sul flusso del sondaggio e dice Seleziona campi da includere come dati incorporati Il servizio Web non ha restituito campi. Fare clic qui per visualizzare i dati non elaborati. Nellangolo inferiore sinistro della finestra di dialogo è presente un pulsante che indica Visualizza dati grezzi

Attenzione: se si aggiorna l’elemento del servizio Web per correggere l’errore, è necessario pubblicare anche le modifiche all’indagine. Consigliamo di risolvere gli errori il prima possibile per evitare sessioni di indagine in corso utilizzando la vecchia versione del questionario dopo la scadenza. Se invece si risolve l’errore mediante un altro metodo (ad esempio, correggendo la configurazione TLS sul server di destinazione dell’elemento del servizio Web), la pubblicazione non è necessaria.

Tipi di progetti in cui è disponibile questa funzionalità

Finché hai accesso ai Servizi Web come parte della tua licenza, puoi aggiungere un servizio web a qualsiasi tipo di flusso del sondaggio del progetto. Ciò include:

Molte delle pagine di questo sito sono state tradotte dall'originale in inglese mediante traduzione automatica. Sebbene in Qualtrics abbiamo profuso il massimo impegno per avere le migliori traduzioni automatiche possibili, queste non sono mai perfette. Il testo originale inglese è considerato la versione ufficiale, e qualsiasi discrepanza tra questo e le traduzioni automatiche non è legalmente vincolante.