Vytváření akcí s daty HTTP

V sešitu můžete použít akci s daty HTTP API, která při výběru sloupce odešle hodnotu do rozhraní REST API, které vrátí odpověď.

Doménu, ke které se snažíte připojit, musíte konfigurovat jako bezpečnou doménu, než vytvoříte akci s daty HTTP API. Viz část Registrace bezpečných domén.

  1. Na domovské stránce umístěte ukazatel myši na sešit, klikněte na ikonu Akce a poté vyberte položku Otevřít.
  2. Klikněte na Nabídku sešitu a poté vyberte Akce s daty.
  3. Klikněte na volbu Přidat akci a zadejte název pro novou akci s daty rozhraní API protokolu HTTP. Zadejte například název Příklad HTTP API.
  4. Klikněte na pole Typ a vyberte volbu HTTP API.
  5. Klikněte na pole Ukotvit k a vyberte sloupce, na které se má vztahovat akce s daty rozhraní API protokolu HTTP. Nevybírejte sloupce ukazatelů ani skryté sloupce. Pokud nezadáte hodnotu pro pole Ukotvit k, datová akce platí pro všechny datové prvky ve vizualizacích.
  6. V seznamu Metoda HTTP vyberte metodu.
  7. Zadejte adresu URL pro rozhraní REST API, která začíná znaky http nebo https a volitelně zahrnuje tokeny pro nahrazení.
  8. Pokud jste vybrali metodu POST:
    • Když pro položku Typ datové části vyberete hodnotu Data formuláře, zadejte každý parametr na samostatný řádek.
    • Když pro položku Typ datové části vyberete hodnotu Nezpracovaná data, zadejte nezpracovaná data.
  9. Pokud chcete přidat nebo přepsat záhlaví HTTP, aby vyhovovalo používanému rozhraní API, zadejte vlastní záhlaví HTTP.
  10. Klikněte na položku Podporuje vícenásobný výběr a nastavte hodnotu.
    • Zapnuto – Akci s daty lze vyvolat, když je vybrán jeden nebo více datových bodů.
    • Vypnuto – Akci s daty lze vyvolat pouze v případě, že je vybrán jeden datový bod.

      Toto nastavení je obzvláště užitečné, pokud výběr více datových bodů může vést k chybě (například u některých rozhraní REST API od třetích stran).

  11. Uložte kliknutím na tlačítko OK.
  12. Klikněte na datový bod ve vizualizaci.

    K zobrazení konkrétního rozhraní REST API můžete například vybrat položku „Books“ ze sloupce Kategorie tokenu.

  13. Výsledek zobrazíte kliknutím pravým tlačítkem myši a výběrem položky Příklad HTTP API.

    Vybrané datové body určují, které hodnoty mají být přeneseny do tokenů adres URL.

    Zobrazí se zpráva o úspěšném provedení (nebo selhání), která potvrzuje, že rozhraní REST API bylo (nebo nebylo) úspěšně vyvoláno pomocí vybrané hodnoty.