Creare azioni dati HTTP

È possibile utilizzare un'azione dati di interfaccia API HTTP in una cartella di lavoro in modo che, quando si seleziona una colonna, venga inviato un valore all'API REST che restituisce una risposta.

1. Nella Home page passare il puntatore del mouse su una cartella di lavoro, fare clic su Azioni, quindi selezionare Apri.
2. Fare clic sul menu della cartella di lavoro e selezionare Azioni dati.
3. Fare clic su Aggiungi azione e immettere un nome per la nuova azione dati di API HTTP. Ad esempio, immettere Esempio di API HTTP.
4. Fare clic sul campo Tipo e selezionare API HTTP.
5. Fare clic sul campo Ancoraggio a e selezionare le colonne alle quali si desidera venga applicata l'azione dati di API HTTP. Non selezionare colonne di misura o colonne nascoste. Se non si specifica un valore per il campo Ancoraggio a, l'azione dati verrà applicata a tutti gli elementi dati nelle visualizzazioni.
6. Nella lista Metodo HTTP selezionare un metodo.
7. Immettere l'URL per l'API REST, che inizia con http o https e può includere token di sostituzione.
8. Se è stato selezionato il metodo POST:
   • quando si seleziona il valore Tipo di payload Dati form, immettere ogni parametro su una riga distinta;
   • quando si seleziona il valore Tipo di payload Dati di tipo RAW, immettere dati di tipo RAW.
9. Immettere un'intestazione HTTP personalizzata se si desidera aggiungere o sostituire l'intestazione HTTP per adattarla all'API di interfacciamento.
10. Fare clic su Supporta più selezioni per impostare il valore.
    • Attivo: l'azione dati può essere richiamata quando si selezionano uno o più datapoint.
    • Non attivo: l'azione dati può essere richiamata solo quando si seleziona un datapoint singolo.

      Questa impostazione si rivela particolarmente utile quando la selezione di più datapoint può causare un errore, ad esempio con alcune API REST di terze parti.

11. Fare clic su OK per salvare le modifiche.
12. Fare clic su un datapoint nella visualizzazione.

    Ad esempio, è possibile selezionare "Books" da una determinata colonna Category per visualizzare una particolare API REST.

13. Fare clic con il pulsante destro del mouse e selezionare Esempio di API HTTP per visualizzare il risultato.

    I datapoint selezionati determinano i valori passati ai token dell'URL.

    Viene visualizzato un messaggio di operazione riuscita o non riuscita per indicare l'esito del richiamo dell'API REST mediante il valore selezionato.