> ## Documentation Index > Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt > Use this file to discover all available pages before exploring further. # REST V1 端口 (已棄用) > 用於構建動態 REST 請求的原始 REST 端口。此版本已棄用；新工作流程請使用當前 REST 端口。 REST 端口支援構建動態 REST 請求以使用 RESTful API Web 服務。 ## 核心功能 * 完整的 RESTful API 用戶端，支援所有 HTTP 方法（GET、POST、PUT、PATCH 和 DELETE） * 支援 Swagger 匯入，可自動配置 API 並生成請求 * 支援進階身分驗證，包括 OAuth 2.0、Bearer Token、AWS Signature 以及 Basic/Digest 認證 * 支援在 URL、標頭和表單資料中使用 ArcScript 構建動態請求 * 靈活的正文型別，包括 raw、form-data、URL-encoded 和檔案上傳 ## 概觀 REST 端口提供簡單介面，用於構建 REST 請求的標頭、授權、正文和 HTTP 方法。請求正文可以在端口配置中靜態設定，也可以根據端口處理的檔案動態生成。 ### 操作 此端口可以執行三種端口操作型別中的任何一種： • *觸發* 按計劃執行一個 request ，並且可能會生成要沿著工作流程傳送的檔案。此操作充當工作流程的起點。 • *轉換* 接受來自工作流程的訊息作為 request 的輸入並生成輸出。此操作充當工作流程的中間部分。 • *終結* 接受來自工作流程的訊息作為 request 的輸入並充當工作流程的終點。 ## 端口設定 ### REST 頁面 *與端口請求詳細資訊相關的設定。* ![](https://mintcdn.com/qiao/HyyOl9gYIsxaiGgh/26.4/images/rest_details_tab.png?fit=max\&auto=format\&n=HyyOl9gYIsxaiGgh\&q=85\&s=beb92cf15668eab5b6bba0d918d92ef4) #### 認證 *與 REST 服務認證相關的設定。* | 設定 | 說明 | | - | - | | **認證型別** | REST 服務使用的認證型別。選項會根據你的選擇而變化。詳情請參見[認證方式](#認證方式)。 | | **TLS 伺服器憑證** | 用於驗證 TLS 伺服器身份的公開金鑰憑證。你可以上傳憑證，留空以允許底層 OS/JVM 執行憑證驗證，或設定為 `Any Certificate` 以信任目標伺服器的身份。請謹慎使用 Any Certificate：憑證用於驗證你連線的是預期伺服器。 | #### 請求詳情 | 設定 | 說明 | | - | - | | **從 Swagger 匯入** | 單擊 ![從 swagger 匯入](https://mintcdn.com/qiao/HyyOl9gYIsxaiGgh/26.4/images/rest_import_from_swagger.png?fit=max\&auto=format\&n=HyyOl9gYIsxaiGgh\&q=85\&s=df1870dcdee5497d25634d9abf8b0227) 圖示可直接從 Swagger URL 匯入 API 詳細資訊。 | | **測試** | 測試當前配置，而不建立傳送到工作流程下游的訊息或交易。單擊**測試**會開啟包含四個索引標籤的視窗（更多資訊請參見[測試請求配置](#測試請求配置)）： **回應正文**：檢視來自伺服器的回應正文。 **回應標頭**：檢視伺服器回應中包含的標頭。 **訊息標頭**：檢視測試輸出中包含的訊息標頭。 **日誌**：檢視端口日誌。 | | **操作** | 端口應執行的操作。（有關三個選項的詳細資訊，請參見[操作](#操作)。） | | **請求 URL** | REST 請求的 HTTP 方法和目標 HTTP URL。可用方法選項包括：GET、POST、PUT、PATCH 和 DELETE。 | | **正文型別** | 隨 REST 請求提供的正文內容類型。當 HTTP 方法為 GET 時不可見。有關每個選項的說明，請參見[正文型別](#正文型別)。 | | **標頭** | **標頭**索引標籤支援新增要包含在傳出 REST 請求中的 HTTP 標頭清單。標頭以名稱-值對指定。更多資訊請參見[靜態請求](#靜態請求)。 | | **正文** | 如果**正文型別**設定為 `form-data` 或 `x-www-urlencoded`，請使用**正文**索引標籤提供一組構成請求正文的名稱-值對（欄位）。詳情請參見[正文型別](#正文型別)。 | ### 設定頁面 *與端口核心配置相關的設定。* #### 配置
設定 描述
**端口 Id** 端口的靜態、唯一識別碼。
**端口型別** 顯示端口型別及其用途的描述。
**端口描述** 一個可選欄位，用於提供端口及其在流中的角色的自由格式描述。
#### 進階設定 | 設定 | 說明 | | - | - | | **本地檔案方案** | 為端口輸出的訊息分配檔名的方案。可以在檔名中使用宏，動態包含識別碼和時間戳等資訊。有關更多資訊，請參見[宏](#宏)。 | ### 進階頁面 #### TLS 用戶端認證 *與需要雙向 TLS 身分驗證時的用戶端身分驗證相關的設定。*
設定描述
**私有憑證** TLS 用戶端身分驗證期間提供的私有憑證。
**憑證密碼** 存取 TLS 用戶端憑證所需的密碼。
#### 進階設定 *不屬於前述類別的設定。* | 設定 | 說明 | | - | - | | **標頭中的 ArcScript** | 允許在發出查詢前對標頭中的 ArcScript 運算式求值。範例請參見 [URL](#url) 部分。 | | **URL 中的 ArcScript** | 允許在發出查詢前對 URL 中的 ArcScript 運算式求值。範例請參見[標頭](#標頭)部分。 | | **輸出錯誤回應** | 預設情況下，當回應以不表示成功的狀態碼傳送時，端口不會向工作流程輸出訊息。啟用此設定後，端口會為這些錯誤回應向工作流程輸出訊息。稍後可以在工作流程中使用 HTTP-Status-Code 標頭過濾訊息。 | | **分塊編碼** | 傳送請求時是否使用 HTTP 分塊傳輸編碼。這允許應用程式按順序傳送訊息的各部分（塊），以避免連線過載。 | | **塊大小** | 啟用**分塊編碼**時每個塊的大小（位元組）。 | | **壓縮** | 是否在傳送請求之前將 PUT 或 POST 請求的正文壓縮為 `gzip` 格式。傳出請求中還會新增 **Content-Encoding** 標頭。 | | **GET 請求正文** | 允許 GET 請求使用輸入訊息資料作為請求正文。 | | **HTTP 版本** | 連線到 REST 服務時使用 HTTP 1.0、1.1 還是 2.0。 | | **輸出行為** | 預設情況下，端口輸出包含 `Response` 資料的訊息。其他選項允許你輸出 `Input Message` 以便進一步處理，或完全不輸出訊息。更多資訊請參見[回應事件](#回應事件)。 | | **逾時（秒）** | 擲回逾時錯誤之前等待 REST 伺服器回應的時長（秒）。 | | **回應標頭** | 設定後，端口會將 REST 訊息中的指定標頭提升為已下載訊息的中繼資料。可以用逗號分隔清單指定多個標頭。 | | **保留 Cookie** | 若要在輸出訊息上保留 Cookie，請提供要持久化的 Cookie 名稱逗號分隔清單。使用 `*` 可保留所有 Cookie。**注意**：僅保留名稱-值對，不執行屬性檢查。使用者負責確保 Cookie 不會洩露到非預期目標。 | | **啟用的 TLS 協議** | 建立出站連線時支援的 TLS/SSL 協議清單。最佳實踐是僅使用 TLS 協議。某些過時的作業系統不支援 TLS 1.2。 | #### 代理設定 這是一組用於識別連線所經代理並對其進行身分驗證的設定。預設情況下，本節使用 [安全設定](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/security.md) 頁面的 [代理設定](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/proxy-settings.md) 部分中的全域設定。清除此核取方塊可為您的端口提供特定的設定。
設定描述
**代理型別** 基於代理的防火牆使用的協議。
**代理主機** 基於代理的防火牆的名稱或 IP 地址。
**代理端口** 基於代理的防火牆的 TCP 端口。
**代理使用者** 用於透過基於代理的防火牆進行身分驗證的使用者名稱。
**代理密碼** 用於對基於代理的防火牆進行身分驗證的密碼。
**身分驗證方案** 保留預設值 **None** 或選擇以下身分驗證方案之一：**Basic**、**Digest**、**Proprietary** 或 **NTLM**。
#### 日誌 *用於管理日誌建立和儲存的設定。*
設定 描述
**日誌級別** 指定要記錄在端口日誌目錄中的資訊型別：
  • **None** - 不建立任何日誌。
  • **Error** - 僅當端口遇到錯誤時才建立日誌。
  • **Warning** - 僅當端口發出警告時才建立日誌。
  • **Info** - 記錄工作流程的一般資訊，包括任何錯誤和警告（如果適用）。
  • **Debug** - 記錄成功和失敗工作流程的詳細偵錯資訊。
  • **Trace** - 記錄成功和失敗工作流程的詳細跟蹤資訊。
\*\*請注意：\*\***Debug** 和 **Trace** 級別的日誌可能會記錄敏感資訊，包括訊息內容和 SSL 憑證。儘管連線屬性（例如密碼）被遮蔽了，但在與您的組織外部共享它們之前，請檢視此級別的日誌以避免洩漏敏感資訊。
**日誌資料夾結構** 指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如，**Weekly** 選項指示端口每週建立一個新的子資料夾，並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口，使用子資料夾有助於保持日誌的有序性並提高效能。
**保留訊息副本** 指示端口在日誌目錄中儲存最新訊息副本的切換。請注意，端口每個子資料夾只保留一個訊息，並且端口在再次執行時會覆蓋以前儲存的訊息。
#### 其他設定 *特殊設定適用於特定用例。*
設定 描述
**其他設定** 允許在以分號分隔的清單中配置隱藏的端口設定，例如 `setting1=value1;setting2=value2`。正常的端口用例和功能不需要使用這些設定。
### 自動化 #### 自動化設定 *與端口自動處理檔案相關的設定。* | 設定 | 說明 | | - | - | | **傳送** | 指示端口在檔案準備就緒時自動傳送檔案的開關。 | | **重試間隔** | 端口在重試失敗傳送之前等待的間隔。 | | **最大次數** | 端口嘗試傳送訊息的次數。將此值設定為 *1* 會指示端口僅進行初始傳送嘗試而不重試。端口會在每次嘗試之間等待**重試間隔**指定的時長。 | | **接收** | 指示端口按配置間隔自動發起 REST 請求的開關。 | | **接收執行間隔** | 端口發起配置的 REST 請求的間隔。下一個欄位取決於此處的選擇： **每小時**：*小時後分鐘數*下拉功能表允許指定小時後多少分鐘處理接收檔案。 **每天**：顯示*時間*欄位，用於指定一天中的時間（UTC）來處理接收檔案。 **每週**：顯示兩個欄位。*日期*允許選擇處理的星期幾，*時間*允許指定處理接收檔案的時間（UTC）。 **每月**：顯示兩個欄位。*日期*允許選擇每月的日期，*時間*允許指定處理接收檔案的時間（UTC）。 **分鐘**：顯示*分鐘*欄位，用於指定處理間隔之間的分鐘數。 **進階**：五位 *Cron 運算式*欄位允許指定精確的處理間隔。 | | **小時後分鐘數** | 小時計劃的分鐘偏移量。僅當**接收間隔**設定為\_每小時\_時適用。例如，如果此值設定為 5，自動化服務會在 1:05、2:05、3:05 等時間傳送請求。 | #### 效能 *與端口資源分配相關的設定。*
設定 描述
**最大工作執行緒數** 此端口上處理檔案時從執行緒池中消耗的最大工作執行緒數。如果設定，則會覆蓋 [進階設定](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/advanced-settings.md) 頁面的 [效能設定](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/performance-settings.md) 部分的預設設定。
**最大檔案數** 分配給端口的每個執行緒傳送的最大檔案數。如果設定，則會覆蓋 [進階設定](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/advanced-settings.md) 頁面的 [效能設定](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/performance-settings.md) 部分的預設設定。
### 告警索引標籤 *與配置通知相關的設定。* 在執行服務級別協議 (SLA) 之前，需要設定電子郵件通知以接收通知。預設情況下，知行之桥 使用 [通知](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/alerts.md) 索引標籤上的全域設定。要為此端口使用其他設定，請啟用 **覆蓋全域設定**。 預設情況下，錯誤通知處於啟用狀態，這意味著每當出現錯誤時都會傳送電子郵件。要關閉錯誤通知，請取消選中 **啟用** 核取方塊。 輸入 **主題**（必填）。勾選**允許在主題中使用 ArcScript**，即可在**主題**欄位中使用 ArcScript。選中後會顯示 **ArcScript 編輯器**按鈕（![ArcScript 編輯器按鈕](https://docs.kasoftware.com/26.4/images/rest_arcscript_editor.png)）。 （可選）輸入以逗號分隔的**收件人**電子郵件地址清單。 ### SLA 索引標籤 *與配置服務級別協議 (SLA) 相關的設定。* SLA 允許配置預期流程中端口傳送或接收的資料量，並設定預期達到該資料量的時間範圍。當 SLA 未達到時，知行之桥 會傳送電子郵件警告使用者，並將 SLA 標記為 *存在風險*，這意味著如果 SLA 未能儘快達到，則會被標記為 *已違反*。這讓使用者有機會介入並確定 SLA 未達到的原因，並採取適當的措施。如果在風險時間段結束時仍未達到 SLA，則會將 SLA 標記為已違反，並再次通知使用者。 SLA 轉換為 *存在風險* 或 *已違反* 狀態時，也會寫入[應用程式日誌](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/activity.md#应用程序日志)，這意味著應用程式效能監控 (APM) 和日誌擷取工具也可以針對這些狀態發出警示。 要定義 SLA，請啟用 **預期資料量**，然後點選 **設定** 索引標籤。 ![SLA Empty](https://docs.kasoftware.com/26.4/images/sla_empty.png) 以下範例顯示了為端口配置的 SLA，該端口預計在週一至週五每天接收 1000 個檔案。如果尚未收到 1000 個檔案，則會在時間段結束前 1 小時傳送風險通知。 ![SLA Configuration Example](https://docs.kasoftware.com/26.4/images/sla_defined.png) > [!NOTE] > > 如果有必要，可以關閉 SLA 通知。這在維護視窗期間非常有用。點選導覽列上的 **設定**，然後跳轉到 **通知 > 通用通知**。點選平板和鉛筆圖示進行編輯，並取消勾選 **SLA 通知** 設定。 ### 交易索引標籤 此索引標籤列出與端口關聯的所有訊息。使用搜尋欄查詢特定訊息，或單擊漏斗圖示應用篩選器。可以按時間、訊息方向和/或狀態進行篩選。 此索引標籤上的選項因端口的[操作型別](#操作)而異： * 如果端口是 **Trigger**，請使用**接收檔案**按鈕啟動工作流程。 * 如果端口是 **Transform** 或 **Terminal**，請使用**上傳檔案**按鈕將檔案上傳到工作流程。 ## 建立連線 與任何 REST 服務建立連線都需要有效的目標 URL。服務 URL 可以支援各種 HTTP 方法，你應根據特定 Web 服務操作或要檢索的資料集配置**方法**。某些服務可能還需要身分驗證或一組自定義標頭才能使用該服務。 如果目標 URL 是 HTTPS URL，請將 **TLS 伺服器憑證**設定為標識伺服器的公開金鑰憑證。若要隱式信任目標端點，請將該欄位設定為 `Any Certificate`。 ### 認證方式 REST 端口支援多種身分驗證型別，每種型別都有自己的要求： * Basic（純文字）、Digest（加密）和 NTLM 需要使用者名稱-密碼身分驗證。這些憑據會作為請求中的標頭提供給 REST 服務。 * OAuth 身分驗證需要在 REST 服務的 Web 門戶或開發控制檯中註冊應用。應用註冊中要包含的 **Callback URL** 會顯示在 知行之橋 UI 中。選擇適用於 REST 服務的 **Grant Type**，並根據 REST 服務 Web 門戶或開發控制檯中顯示的詳細資訊指定其餘設定。然後單擊**取得新的存取權杖**以取得與服務互動所需的權杖。檢索到初始權杖後，應用程式會在權杖即將過期時重新整理它們。 * Bearer Token 身分驗證需要來自服務 Web 門戶或開發控制檯的權杖。 * AWS Signature 身分驗證用於對 Amazon 進行身分驗證，需要配置 Amazon 提供的憑據：**Access Key**、**Secret Key** 等。 ## 測試請求配置 你可以隨時測試當前配置，而不建立傳送到工作流程下游的訊息或交易。單擊 **REST 詳情**索引標籤上的**測試**。下圖顯示了成功測試後的**回應正文**結果。 ![](https://mintcdn.com/qiao/HyyOl9gYIsxaiGgh/26.4/images/rest_test_tab.png?fit=max\&auto=format\&n=HyyOl9gYIsxaiGgh\&q=85\&s=44d9ae166da38b3ebaf8b61446bf2f45) * **回應正文**：以伺服器傳回的格式顯示 REST 請求的輸出。 * **回應標頭**：顯示伺服器傳回回應中包含的回應標頭。 * **訊息標頭**：顯示測試輸出中包含的訊息標頭。 * **日誌**：顯示測試日誌。 ## 正文型別 使用端口的[請求詳情](#請求詳情)索引標籤指定正文的配置方式以及提供的資訊型別。以下清單更詳細地說明了每個選項。 * **none**：REST 請求不提供正文。 * **form-data**：正文以一組名稱-值對（欄位）提供。使用 **Name** 旁邊的下拉式清單選擇欄位型別。 * **Static**：同時提供 **Name** 和 **Value**。 * **XML**：在 UI 中提供 **Name**。**Value** 會從端口處理的輸入檔案中動態讀取。更多資訊請參見[動態表單資料](#動態表單資料)。 * **File**：每個端口可以有一個正文欄位設定為 File。這會使輸入檔案作為請求正文傳送。由於端口使用輸入檔案本身作為表單資料，因此 **Value** 欄位會變灰。\ **注意**：**File** 選項與動態請求和其他檔案請求不相容。如果使用此選項，只能將其與靜態欄位結合使用。 * **Header**：使用 **Value** 欄位指定從輸入訊息的哪個標頭讀取正文。 * **ArcScript**：提供的 **Value** 會渲染為 ArcScript，結果值會用於請求正文。 * **x-www-urlencoded**：正文的配置方式與 form-data 相同；但名稱-值對會編碼為 URL 查詢字串，而不是多部分表單資料。 * **raw**：正文設定為端口處理的輸入檔案內容。使用下拉式清單選擇正文的**內容類型**，或在**標頭**部分將其指定為自定義標頭。 ## 靜態請求 內容完全靜態的 REST 請求（例如使用 HTTP GET 方法的請求）不需要輸入檔案，因為請求內容完全在端口 UI 中配置。只需在**標頭**部分新增任何必要的名稱-值對作為自定義標頭，或在**正文**部分新增表單資料。 如果啟用**接收自動化**，可以按計劃自動傳送靜態請求。每個請求的回應會儲存在輸出資料夾中，或傳遞給工作流程中的下一個端口。 如果啟用**傳送自動化**，到達端口輸入資料夾的檔案也會觸發靜態請求。輸入檔案的內容會被忽略，請求會根據 UI 中的配置傳送。 ## 動態請求 REST 請求可以使用到達端口輸入資料夾的檔案中的資料動態填充。 ### 原始輸入資料 如果將請求的**正文型別**設定為 `raw`，輸入檔案的內容會作為 REST 請求正文傳送。 使用**內容類型**下拉式清單設定資料的特定內容類型。如果所需內容類型未列出，可以在**標頭**部分新增 *Content-Type* 標頭。 ### 動態表單資料 如果將請求的**正文型別**設定為 `form-data` 或 `x-www-urlencoded`，端口會從輸入檔案中查詢特定值來填充請求。對於設定為 `XML` 的每個名稱-值對，端口會掃描輸入檔案，查詢與欄位名稱相同且使用特定 XML 結構的 XML 元素，如下所示： ```xml theme={null} ``` 為適配此結構，知行軟體強烈建議在工作流程中的 REST 端口前使用 XML Map 端口，如[下文](#帶有-xml-對映的動態範本)所述。 當端口找到與欄位名稱和所需 XML 結構匹配的元素時，該元素中的值會用作名稱-值對中的值。例如，如果正文中有名為 `CustomerID` 的動態欄位，並且輸入檔案包含如下所示的 XML，則 REST 端口會將 `CustomerID` 欄位的值設定為 12354。 ```xml theme={null} 12354 ``` #### 帶有 XML 對映的動態範本 將 [XML Map](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/connectors/xml-map/xml-map.md) 端口與 REST 端口結合使用，可以輕鬆從其他 XML 資料結構構建動態請求。XML Map 端口會將自定義 XML 結構轉換為 REST 端口期望的 XML 結構。 首先，為 REST 端口配置請求中應存在的一組動態（和靜態）**正文**欄位。接下來，在 知行之橋 工作流程中將 XML Map 端口連線到 REST 端口，並儲存工作流程更改。這使 XML Map 端口能夠檢測 REST 端口期望在傳入輸入檔案中出現哪些欄位。 然後，在 XML Map 端口中，**目的檔案**下拉式清單會包含 REST 請求架構。選擇它作為目標，並將**來源檔案**設定為自定義 XML 結構。這會填充 XML Map 對映編輯器，你可以將需要包含在 REST 請求中的資料從源結構拖放到目標結構。對映完成後，XML Map 端口會自動將與來源檔案匹配的檔案轉換為有效的 REST 請求結構。 有關使用 XML Map 端口的更多資訊，請參見 [XML Map 端口文件](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/connectors/xml-map/xml-map.md)。 ### URL 如果在端口配置窗格的[進階頁面](#進階頁面)上選擇**允許在 URL 中使用 ArcScript**，即可對 ArcScript 中的運算式求值，以生成動態字串作為 URL。例如，以下 URL 包含日期和時間： `http://myendpoint.com/api?day=[_ | now('yyyyMMdd')]` 此 URL 包含用於透過傳送自動化觸發的查詢的傳入訊息標頭： `http://myendpoint.com/api?customer=[_message.header:customerid]` 最後，此 URL 使用從上次查詢時間到當前時間戳的動態日期範圍，併為第一次查詢使用預設時間戳： `http://myendpoint.com/api?DateFrom=[_connector.lastruntimestamp | def('2025-01-01T00:00:00-04:00')]&DateTo=[_connector.currenttimestamp]` ### 標頭 如果在端口配置窗格的[進階頁面](#進階頁面)上選擇**允許在標頭中使用 ArcScript**，即可對 ArcScript 中的運算式求值，以生成動態字串作為標頭值。例如，以下標頭包含日期和時間： `Timestamp [_ | now('yyyyMMdd')]` 以下標頭包含用於透過傳送自動化觸發的查詢的客戶 ID： `Customer [_message.header:customerid]` ## 回應事件 可以在 REST 端口中使用回應事件與從伺服器接收的回應（包括正文、標頭、Cookie 等）互動，並豐富端口生成的輸出訊息。可以在 `Response` 事件中使用以下特殊專案。 * [\_cookies](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/scripting/introduction-to-arcscript.md#http-cookie（_cookies）) * [\_message](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/scripting/introduction-to-arcscript.md#知行之橋訊息（_message）) * [\_request](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/scripting/introduction-to-arcscript.md#http-請求（_request）) * [\_response](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/scripting/introduction-to-arcscript.md#http-回應（_response）) ### 回應事件 Example 此指令碼讀取從 REST 呼叫接收的 JSON 回應，解析出 JSON 中包含的存取權杖，並將其作為標頭新增到 REST 端口建立的輸出訊息上： ```xml theme={null} ``` 以下步驟詳細說明了發生的情況： 1 透過 `_response.body` 存取伺服器傳送回知行之橋中 REST 端口的回應正文，並將其設定為 jsonDOMGet 操作的 text 屬性。jsonDOMGet 的其他屬性也會被填充，例如 `map` 屬性，其中包含回應正文中所需權杖的 jsonpath。 2 呼叫 jsonDOMGet 操作。如果在回應 JSON 正文中找到權杖，則會透過 `_message.header:access_token` 語法將其作為訊息標頭新增到 REST 端口的輸出訊息。如果未找到權杖，則 `access_token` 標頭的值會設定為靜態字串：*Token not found!*。 在 知行之橋 中檢視來自 REST 端口的訊息的輸出訊息詳細資訊時，結果如下所示： ![](https://mintcdn.com/qiao/HyyOl9gYIsxaiGgh/26.4/images/rest_response_event.png?fit=max\&auto=format\&n=HyyOl9gYIsxaiGgh\&q=85\&s=1845a3cd0d81d58982016f40d5add92f) 當你需要從傳送請求後伺服器傳回的原始 JSON 回應正文中解析資料時，這類指令碼很有用。隨後可以在工作流程的後續端口中讀取和使用該標頭。 > [!TIP] > > 如果伺服器使用 XML 回應，可以使用 xmlDOMget 實現相同結果。 ## 宏 在檔案命名策略中使用宏可以提高組織效率和對資料的上下文理解。透過將宏合併到檔名中，可以動態地包含相關資訊，例如識別碼、時間戳和訊息頭資訊，從而為每個檔案提供有價值的上下文。這有助於確保檔名反映對組織重要的詳細資訊。 知行之桥 支援這些宏，它們都使用以下語法：`%Macro%`。
宏描述
ConnectorID替換為端口的 ConnectorID。
ConnectorName替換為端口名稱。可用於在檔名或路徑中包含連線名稱，例如按生成備份檔案的資料庫連線標記檔案。
Ext替換為端口當前正在處理的檔案的副檔名。
Filename替換為端口當前正在處理的檔案的檔名（包括副檔名）。
FilenameNoExt替換為端口當前正在處理的檔案的檔名（不帶副檔名）。
MessageId計算端口輸出的訊息的 MessageId。
RegexFilename:*pattern*將規則運算式模式應用於端口當前正在處理的檔案的檔名。
Header:*headername*替換為端口正在處理的當前訊息的目標訊息頭（`headername`）的值。
LongDate以常規格式計算系統的當前日期時間（例如，2024 年 1 月 24 日星期三）。
ShortDate以 yyyy-MM-dd 格式計算系統的當前日期時間（例如 2024-01-24）。
DateFormat:*format*以指定格式（`format`）計算系統的當前日期時間。有關可用的日期時間格式，請參閱 [範例日期格式](https://docs.kasoftware.com/26.4/self-hosted/zh/scripting/value-formatters/date-formatters.md#date-formats-with-literal-characters)。
Vault:*vaultitem*計算指定保管庫專案的值。
### 範例 某些宏（例如 %Ext% 和 %ShortDate%）不需要參數，但其他宏則需要。所有帶有參數的宏都使用以下語法：`%Macro:argument%` 以下是帶有參數的宏的一些範例： 還可以建立更復雜的宏，如以下範例所示： This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.