Tworzenie czynności HTTP związanych z danymi

W skoroszycie można użyć czynności HTTP API związanej z danymi, tak aby - gdy zostanie wybrana kolumna - była wysyłana do REST API odpowiednia wartość i była zwracana odpowiedź.

Przed przystąpieniem do tworzenia czynności HTTP API związanej z danymi trzeba skonfigurować domenę docelową jako bezpieczną. Zob. Rejestrowanie bezpiecznych domen.

  1. Na stronie startowej wskazać kursorem skoroszyt, kliknąć Czynności i wybrać Otwórz.
  2. Kliknąć Menu skoroszytu, po czym wybrać Czynności związane z danymi.
  3. Kliknąć Dodaj czynność, po czym wpisać nazwę nowej czynności HTTP API związanej z danymi. Na przykład wpisać Przykład HTTP API.
  4. Kliknąć w polu Typ, po czym wybrać HTTP API.
  5. Kliknąć w polu Zakotwicz do, po czym wybrać kolumny danych, do których (kolumn) ma być stosowana czynność HTTP API związana z danymi. Nie należy wybierać kolumn miar ani kolumn, które są ukryte. Jeśli w polu Zakotwicz do nie zostanie określona żadna wartość, to czynność związana z danymi będzie stosowana do wszystkich elementów danych w wizualizacji.
  6. Z listy Metoda HTTP wybrać odpowiednią metodę.
  7. Podać adres URL dla REST API, zaczynający się prefiksem http lub https i (opcjonalnie) zawierający tokeny zastępcze.
  8. Jeśli została wybrana metoda POST:
    • Jeśli jako Typ ładunku została wybrana wartość "Dane formularza", wpisać poszczególne parametry w osobnych liniach.
    • Jeśli jako Typ ładunku została wybrana wartość "Dane nieprzetworzone", wpisać dane nieprzetworzone.
  9. Wprowadzić niestandardowy nagłówek HTTP, jeśli trzeba dodać lub przesłonić nagłówek HTTP, tak aby pasował do używanego API.
  10. Wybrać opcję Obsługuje więcej niż jeden wybór, aby ustawić wartość.
    • Wł. - czynność związaną z danymi można wywołać, gdy zostanie wybrany jeden punkt danych lub większa ich liczba.
    • Wył. - czynność związaną z danymi można wywołać tylko wtedy, gdy zostanie wybrany jeden punkt danych.

      To ustawienie jest szczególnie przydatne, gdy wybór więcej niż jednego punktu danych może się przyczynić do błędu (na przykład w przypadku niektórych obcych REST API).

  11. Kliknąć przycisk OK, aby zapisać.
  12. Kliknąć na punkcie danych w wizualizacji.

    Na przykład, aby wyświetlić określony REST API, można wybrać token kolumny "Category".

  13. Kliknąć prawym przyciskiem myszy, po czym - aby wyświetlić wynik - wybrać Przykład HTTP API.

    O tym, które wartości mają zostać przekazane do tokenów w adresie URL, decydują wybrane punkty danych.

    Zostaje wyświetlony komunikat o powodzeniu lub niepowodzeniu potwierdzający, że interfejs REST API został pomyślnie wywołany z użyciem wybranej wartości.