JSON 變數提取器節點

定義

JSON 變數提取器節點可以從 JSON 格式的輸入資料中提取指定的欄位（值）。這使得解析複雜的 JSON 字串並將其儲存為結構化的資訊成為可能，後續節點可以直接使用。

快速入門 / 使用方法

節點配置的詳細說明：在 GoInsight.AI 中右鍵點擊並選擇“添加節點”以將“JSON 變數提取器”節點添加到工作流程中。

1. 配置 JSON 變數提取器節點的值設定

“輸入值”有兩個選項：“變數”和“值”，具體說明如下：

如果“輸入值”設置為“變數”，您需要在“設置變數值”中選擇包含有效 JSON 格式資料的現有變數；如果選擇“值”，則需在文本框中輸入 JSON 格式的字串。範例：

{
  "name": "Scout",
  "age": 18
}

2. 配置 JSON 變數提取器節點的提取模式和輸出變數參數

提取模式包括“提取欄位”和“整體輸出”，對應於不同的輸出變數格式，說明如下：

• 提取欄位：允許您從 JSON 資料中提取特定欄位或巢狀欄位值。
  輸出變數：點擊「+」指定一個或多個輸出變數。每個輸出變數必須包括“變數名稱”、“目標欄位”和“欄位資料類型”。
• 整體輸出：不提取任何欄位，將整個 JSON 資料作為單一輸出。
  輸出變數：點擊「+」添加輸出變數，必須包括“變數名稱”和“欄位資料類型”。
• 欄位資料類型選項：
  輸出欄位資料類型涵蓋了 JSON 資料中常見的資料格式，允許使用者根據需要提取和處理不同類型的資料。詳細描述如下：

典型使用案例

假設「輸入值」設置為靜態「值」或現有「變數」，輸入以下 JSON：

{
  "name": "Scout",
  "age": 18
}

如果您想從 JSON 中提取欄位名稱和年齡並將它們儲存在不同的變數中：

1.提取模式：選擇“提取欄位”

第一個輸出變數設定

• 變數名稱：userName
• 目標欄位：name
• 欄位資料類型：字串

第二個輸出變數設定

• 變數名稱：userAge
• 目標欄位：age
• 欄位資料類型：數字

您可以獲得以下兩個輸出變數：

{
  "Outputs": [
    {
      "Name": "userName",
      "Type": "string",
      "Value": "Scout"
    },
    {
      "Name": "userAge",
      "Type": "number",
      "Value": 18
    }
  ]
}

如果您希望將整個 JSON 物件視為單一字串值，例如在向內部和外部系統發送 JSON 資料時。

2.提取模式：選擇“整體輸出”

輸出變數

• 變數名稱：userInfo
• 欄位資料類型：物件

您可以獲得以下輸出變數：

{
  "Outputs": [
    {
      "Name": "userInfo",
      "Type": "object",
      "Value": {
        "age": 18,
        "name": "Scout"
      }
    }
  ]
}

3. 輸入 JSON 為多層巢狀結構。

例如，以下 JSON 是多層巢狀結構：

{
  "user": {
    "name": "Scout",
    "info": {
      "age": 18,
      "hobbies": ["read", "run"]
    }
  }
}

如果您想提取「age」欄位，目標欄位為：$.user.info.age

• 在此 JSON 變數提取器節點的使用情境中，
  $.user.info.age
  是一個通用路徑表達式（JSONPath），用於指定在多層巢狀 JSON 結構中要提取的欄位位置。解釋如下：

JSON 變數提取器節點支援標準 JSON Path 語法。如果您需要使用更複雜的提取語法，可以參考此文件。需要注意的是，此節點僅支援使用雙引號包裹的字串值 "..." ，不支援單引號 '...'。 例如，在條件過濾情境 [?(@.field == "value")]中，值必須用雙引號括起，才能成功提取。

實用情境案例

篩選 YouTube 影片工作流程的步驟：

• 1. 在開始節點輸入關鍵字。
• 2. 在 HTTP 節點中輸入 API 資訊，使用關鍵字搜尋對應的 YouTube 影片。
• 3. 由於 HTTP 回應可能包含大量影片資訊，使用 JSON 變數提取器節點提取所需的標題、發布時間等資訊，篩選掉其他不必要的資訊。

這樣，我們可以直接獲得所需的 YouTube 影片的標題、發布時間和其他資訊。

常見問題

Q1: 為什麼提取結果是空的或出現錯誤？

檢查提取路徑和文件中指定的數據類型是否正確。

Q2: 為什麼 JSON 變數提取器節點的等待時間這麼長？

檢查是否存在以下情況：

• 一次加載大型 JSON 文件（例如，超過 100MB 的日誌文件）。
• 提取了太多冗餘字段。
• 重複解析相同的結構化數據。