HTTP-tietojenkäsittelytoimintojen luonti

Voit käyttää työkirjassa HTTP API -tiedonkäsittelytoimintoa niin, että kun valitset sarakkeen, se lähettää arvon REST-ohjelmointirajapinnalle, joka taas palauttaa vastauksen.

Toimialue, johon yrität luoda yhteyden, on määritettävä turvalliseksi toimialueeksi ennen HTTP API -tietotoimen luontia. Katso kohta Turvallisten toimialueiden rekisteröinti.

  1. Siirrä kotisivulla hiiren osoitin työkirjan kohdalle, valitse Toiminnot ja Avaa.
  2. Napsauta työkirjan Valikkoa ja valitse sitten Tiedonkäsittelytoiminnot.
  3. Valitse Lisää toimi ja syötä nimi uudelle HTTP API -tietotoimelle. Voit antaa nimeksi esimerkiksi HTTP API Esimerkki.
  4. Napsauta Tyyppi-kenttää ja valitse HTTP API.
  5. Napsauta Kiinnitä kohteeseen -kenttää ja valitse sarakkeet, joissa haluat käyttää HTTP API -tietotointa. Älä valitse mittarisarakkeita tai piilotettuja sarakkeita. Jos Kiinnitä kohteeseen -arvoa ei määritetä, tietojenkäsittelytoimintoa käytetään visualisointien kaikissa tietoelementeissä.
  6. Valitse menetelmä HTTP-menetelmä-luettelosta.
  7. Syötä REST-ohjelmointirajapinnan URL-osoite, jonka alussa on http tai https. Se voi sisältää myös korvaavia tunnuksia (replacement token).
  8. Jos valitsit POST-menetelmän:
    • Jos valitset Tietosisällön tyyppi -kohdan arvoksi Lomakkeen tiedot, syötä kukin parametri erilliselle riville.
    • Jos valitset Tietosisällön tyyppi -kohdan arvoksi Raakatiedot, syötä raakatiedot.
  9. Syötä mukautettu HTTP-otsikko, jos haluat lisätä tai korvata HTTP-otsikon, jotta se vastaisi käyttöliittymän API-rajapintaa.
  10. Aseta arvo valitsemalla Tukee useita valintoja.
    • Käytössä: Tietotoiminnon voi käynnistää, kun valittuna on yksi tai useampi arvopiste.
    • Ei käytössä: Tietotoiminnon voi käynnistää vain, kun valittuna on yksi arvopiste.

      Tämä asetus on erityisen kätevä, kun useiden arvopisteiden valinta aiheuttaa virheen (esimerkiksi joidenkin kolmansien osapuolten REST APIen kanssa).

  11. Tallenna valitsemalla OK.
  12. Napsauta jotakin visualisoinnin arvopistettä.

    Voit esimerkiksi valita "Books" tunnuksen Luokka-sarakkeesta saadaksesi näkyviin tietyn REST API -rajapinnan.

  13. Saat tuloksen näkyviin napsauttamalla hiiren kakkospainiketta ja valitsemalla HTTP API Esimerkki.

    Valitut arvopisteet määrittävät, mitkä arvot välitetään URL-tunnuksille.

    Jos REST-ohjelmointirajapinnan kutsuminen valittua arvoa käyttäen onnistuu, näet onnistumisesta kertovan vahvistussanoman.