Oprette HTTP-datahandlinger

Du kan bruge en HTTP API-datahandling i en projektmappe, så når du vælger en kolonne, sendes værdien til et REST-API, som returnerer en respons.

Du skal konfigurere det domæne, som du forsøger at oprette forbindelse til, som et sikkert domæne, før du opretter en HTTP-API-datahandling. Se Registrere sikre domæner.

  1. Hold musemarkøren over en projektmappe på startsiden, klik på Handlinger, og vælg Åbn.
  2. Klik på projektmappens Menu, og vælg derefter Datahandlinger.
  3. Klik på Tilføj handling, og indtast et navn til den nye HTTP API-datahandling. Skriv for eksempel HTTP API-eksempel.
  4. Klik på feltet Type, og vælg HTTP API.
  5. Klik på feltet Opret forankring til, og vælg de kolonner, som HTTP API-datahandlingen skal anvendes på. Vælg ikke målingskolonner eller skjulte kolonner. Hvis du ikke angiver en værdi for feltet Opret forankring til, anvendes datahandlingen på alle dataelementer i visualiseringerne.
  6. Vælg en metode på listen HTTP-metode.
  7. Indtast URL'en for REST-API'en, der starter med http eller https og eventuelt indeholder erstatningstokens.
  8. Hvis du valgte POST-metoden:
    • Når du vælger Payload-type-værdien Formulardata, skal du kan indtaste hver parameter på en separat linje.
    • Når du vælger Payload-type-værdien Rå data, skal du indtaste de rå data.
  9. Indtast en tilpasset HTTP-header, hvis du vil tilføje eller tilsidesætte HTTP-headeren, så den passer til API-interfacet.
  10. Klik på Understøtter flere valg for at angive værdien.
    • Til - Datahandlingen kan kaldes, når et eller flere datapunkter er valgt.
    • Fra - Datahandlingen kan kun kaldes, når et enkelt datapunkt er valgt.

      Denne indstilling er især nyttig, når valget af flere datapunkter kan resultere i en fejl (for eksempel med REST-API'er fra tredjepart).

  11. Klik på OK for at gemme.
  12. Klik på et datapunkt i visualiseringen.

    Du kan for eksempel vælge "Books" fra en token-kategorikolonne for at vise en bestemt REST-API.

  13. Højreklik, og vælg HTTP API-eksempel for at få vist resultatet.

    De valgte datapunkter bestemmer, hvilke værdier der skal overføres til URL-tokens.

    Der vises en udført- eller ikke udført-meddelelse, der bekræfter, at REST-API'en blev kaldt med den valgte værdi.