建立 HTTP 資料動作

您可以在工作簿中使用 HTTP API 資料動作,如此便可在您選取資料欄時,將值傳送至會傳回回應的 REST API。

您必須先將嘗試連線的網域設定為安全網域,才能夠建立 HTTP API 資料動作。請參閱註冊安全網域

  1. 在首頁中,將游標停駐於工作簿上,按一下動作 「動作」圖示,然後選取開啟
  2. 按一下工作簿功能表,然後選取資料動作
  3. 按一下新增動作,然後輸入新 HTTP API 資料動作的名稱。例如,輸入 HTTP API 範例
  4. 按一下類型欄位,然後選取 HTTP API
  5. 按一下定錨至欄位,然後選取要套用 HTTP API 資料動作的資料欄。請勿選取計量資料欄或隱藏資料欄。如果未指定定錨至欄位值,資料動作就會套用到視覺化中的所有資料元素。
  6. HTTP 方法清單中選取一種方法。
  7. 輸入開頭為 http 或 https 並可視需要包含取代記號的 REST API URL。
  8. 若您選取 POST 方法:
    • 若您在有效負載類型值選取「表單資料」,請以一行一個的方式輸入每個參數。
    • 若您在有效負載類型值選取「原始資料」,請輸入原始資料。
  9. 如果您想要新增或覆寫 HTTP 標頭以適合您連結的 API,請輸入自訂 HTTP 標頭。
  10. 按一下支援多重選擇以設定值。
    • 開啟 - 可以在選取一或多個資料點後呼叫資料動作。
    • 關閉 - 只有在選取單一資料點時才能呼叫資料動作。

      選取多個資料點若可能導致錯誤時 (例如某些協力廠商 REST API 的錯誤),這項設定會特別有用。

  11. 按一下確定以儲存。
  12. 按一下視覺化項目中的資料點。

    例如,您可以從記號「類別」資料欄選取「圖書」以顯示特定 REST API。

  13. 按一下滑鼠右鍵並選取 HTTP API 範例以顯示結果。

    選取的資料點會決定要將哪些值傳送給 URL 記號。

    系統會顯示成功或失敗訊息,用以確認是否已使用選取的值順利呼叫 REST API。