> ## 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.
# PostgreSQL Lookup 配置
> 從 PostgreSQL 檢索值，並將其插入到工作流程中的知行之橋訊息中。
export const DbasaLookupTestLookup = ({datasource = "the data source"}) =>
使用 測試 Lookup 按鈕檢查配置並檢視結果，而無需手動處理檔案。使用 儲存範例資料 按鈕將輸出儲存為範例，以便稍後在流程中進行對映。
;
export const DbasaLookupAdvanced = ({datasource = "the data source"}) => <>
- 使用 未找到匹配記錄操作 來指定如果未找到與查詢匹配的記錄時應執行的操作。
-
{datasource} 端口可以針對本地快取執行 Lookup 查詢，而不是直接為每個 Lookup 查詢 {datasource}。這可以提高查詢效能，尤其是對於較大的資料庫。要啟用此功能，請選中 啟用快取 並配置其餘欄位。
- 快取容錯：控制端口向資料來源發出查詢以重新整理快取的頻率。
- 快取容錯單元：快取容錯 單元。選擇分鐘、小時或天。
- 快取提供器：選擇使用哪個驅動程式以方便連線到快取資料庫。
- 連接字串：設定後，端口將使用此處指定的資料庫進行快取。
- 如果查詢未從快取傳回結果，端口將直接查詢 {datasource}。
- 如果查詢語句包含
limit、offset 或 groupby 參數，則快取功能不起作用。這些查詢直接轉到 {datasource}。
;
export const DbasaLookupQueryMode = ({datasource = "the data source"}) => <>
按照以下步驟使用查詢模式為 {datasource} 端口配置查詢操作。
-
輸出目標：選擇 XPath 將查詢回應值插入到 XML 檔案中，或選擇 Header 將查詢回應值插入到訊息頭中。
- XPath：當選擇 XPath 時，目標分為兩部分。父級 XPath 應已存在於 XML 文件中。新節點名稱 是注入到 XML 文件中以儲存查詢結果的節點的名稱。查詢中的每一列在此處提供的 XML 元素中都有自己的 XML 元素（葉級別）。
- Header：當選擇 Header 時，端口會向查詢中每一列的輸出訊息新增一個訊息頭。從資料庫傳回的每條記錄的值均以逗號分隔。
- 在 查詢 中，輸入 SQL 查詢以從 {datasource} 表檢索資料。
- XPath：將路徑格式設定為
{'${XPATH:/path/to/element}'}。例如，{'SELECT CustomerID FROM Customers WHERE CustomerName = ${XPATH:/Items/Invoices/Customer}'}。
- Header：將路徑格式設定為
{'${HEADER:HeaderName}'}。
- 這兩個核取方塊可讓您配置當查詢傳回多個結果時應發生的情況。
- 選中 使用第一個結果 以始終使用第一個結果。
- 選中 如果多個結果時出錯 以在傳回多個結果時傳回錯誤。
;
export const DbasaLookupFilters = () => <>
可以透過定義單個過濾器和/或過濾器組來構建複雜的過濾器。為了便於閱讀，請單擊欄右側的擴充套件器圖示 
展開 Filters 部分。
要新增過濾器，請單擊 新增過濾器 或 新增組。
當構建過濾器時，請使用下拉功能表進行選擇並選擇運算子。然後指定要過濾的值。可以從以下選項中進行選擇：
當為過濾器選擇輸入 XML 時，如果已上傳範例檔案，編輯器將顯示文件的樹形表示形式，以便可以輕鬆找到所需的 XPath，如下圖所示。
可以重新排序過濾器和組。單擊手柄 
並將物件拖動到新位置。
;
export const DbasaLookupDesignerMode = ({datasource = "the data source"}) => <>
按照以下步驟使用設計器為 {datasource} 端口配置查詢操作。
- 使用 表格 下拉式清單選擇要包含的表格。
- 選擇要從表中包含的 列。
-
輸出目標：選擇 XPath 將查詢回應值插入到 XML 檔案中，或選擇 Header 將查詢回應值插入到訊息頭中。
- XPath：當選擇 XPath 時，目標分為兩部分。父級 XPath 應已存在於 XML 文件中。新節點名稱 是注入到 XML 文件中以儲存查詢結果的節點的名稱。查詢中的每一列在此處提供的 XML 元素中都有自己的 XML 元素（葉級別）。
- Header：當選擇 Header 時，端口會向查詢中每一列的輸出訊息新增一個訊息頭。從資料庫傳回的每條記錄的值均以逗號分隔。
- 使用 Record Limit 指定查詢傳回多個結果時應該發生的情況。
- 如果從下拉式清單中選擇 使用第一個結果，則可以使用 如果多個結果時出錯 在傳回多個結果時檢視錯誤。
- 如果選擇 自定義限制，則必須在顯示的欄位中指定限制。
- 使用 排序 選擇按哪一列對結果進行排序。
- 過濾器 部分允許建立過濾器來構建查詢 WHERE 子句，包括對輸入檔案中的訊息頭或 XML 的引用。
;
export const DbasaLookupConfiguration = () =>
使用此部分定義要包含在查詢中的表和列。設計器模式 可幫助選擇要作為查詢目標的表和列，而不是要求構建自由形式的查詢。但是，如果希望從頭開始編寫查詢，則可以使用 查詢模式。
;
export const DbasaLookupIntro = ({datasource = "the data source", siteName = "知行之桥", siteNameShort = "知行之桥"}) => <>
Lookup 操作從 {datasource} 檢索值並將這些值插入到流中的現有知行之橋訊息中。
- 在 {siteName} 的工作流程中，從將為 {datasource} 端口提供輸入的端口拖動一個箭頭。
- （可選）選擇 範例檔案。建議使用範例檔案，因為它允許端口提供有關檔案結構的更多上下文並幫助構建 過濾器 條件。
- 完成以下配置步驟後，在 {siteNameShort} 的工作流程中，將箭頭從 {datasource} 端口拖動到希望生成的 XML 或訊息頭資料所在的端口。
;
## Lookup 配置
### 設計器模式
### 過濾器
### 查詢模式
## 進階設定
## 測試 Lookup