Skapa HTTP-dataåtgärder

Du kan använda en HTTP-API-dataåtgärd i en arbetsbok som, när du väljer en kolumn, skickar värdet till ett REST-API som returnerar ett svar.

Du måste konfigurera domänen du försöker ansluta till som en säker domän innan du skapar en HTTP-API-dataåtgärd. Se Registrera säkra domäner.

  1. Gå till hemsidan, håll muspekaren över en arbetsbok, klicka på Åtgärder och välj Öppna.
  2. Klicka på arbetsbokens Meny och välj Dataåtgärder.
  3. Klicka på Lägg till åtgärd och ange ett namn för den nya HTTP-API-dataåtgärden. Du kan till exempel ange HTTP API-exempel.
  4. Klicka på fältet Typ och välj HTTP-API.
  5. Klicka i fältet Förankra till och välj de kolumner du vill att HTTP-API-dataåtgärden ska gälla för. Välj inte måttkolumner eller dolda kolumner. Om du inte anger ett värde för fältet Förankra till gäller dataåtgärden för alla dataelement i visualiseringarna.
  6. I listan HTTP-metod väljer du en metod.
  7. Ange URL:en för den REST-API som börjar med http eller https och eventuellt innehåller ersättnings-token.
  8. Om du valt POST-metoden:
    • När du väljer värdet Formulärsdata för Typ av nyttolast anger du varje parameter på en egen rad.
    • När du väljer värdet Rådata för Typ av nyttolast anger du rådata.
  9. Ange ett anpassat HTTP-huvud om du vill lägga till eller åsidosätta HTTP-huvudet enligt vad som passar för det API du överför till.
  10. Klicka på Stöder flerval för att ange värdet.
    • – Dataåtgärden kan anropas när en eller flera datapunkter har valts.
    • Av – Dataåtgärden kan endast anropas när en enda datapunkt har valts.

      Den här inställningen är särskilt användbar när valet av flera datapunkter kan resultera i ett fel (till exempel med REST API:er från tredje part).

  11. Klicka på OK för att spara.
  12. Klicka på en datapunkt i visualiseringen.

    Du kan till exempel välja "Books" från en tokenkategorikolumn för att visa ett bestämt REST-API.

  13. Högerklicka och välj Exempel på HTTP-API för att visa resultaten.

    De valda datapunkterna fastställer vilka värden som ska överföras till URL-token.

    Ett meddelande visas som bekräftar om anropet till REST-API med det valda värdet slutfördes eller inte.