進階關聯記錄外掛

kintone 的關聯記錄清單，是能將應用程式之間的資訊串連顯示的便利標準功能。

但在實際業務中，經常會出現「想從顯示的關聯記錄中進一步搜尋」「想在同一畫面看到關聯應用程式的子表格明細」「想當場彙總金額或數量」這類需求。

若只靠標準的關聯記錄清單來因應，就必須在設定畫面調整顯示項目與條件，或另外準備其他清單與彙總用欄位，確認作業因此變得零碎。

使用本外掛，即可將關聯應用程式的記錄，以進階表格的形式顯示於記錄詳細畫面所配置的空白欄位中。

由於支援表格內搜尋、依欄位篩選、數值與計算欄位的彙總，以及關聯應用程式子表格資料列的展開，讓您能在同一個畫面追蹤所有相關資訊。

原始碼全部公開於 GitHub，可免費使用。

外掛提供的功能

• 將關聯記錄以表格顯示於任意的空白欄位
• 以關鍵字搜尋顯示中的表格
• 依各欄位的值或關鍵字進行篩選
• 將關聯應用程式的子表格資料列展開至同一個表格
• 以記錄為單位合併顯示關聯記錄的欄位
• 顯示數值與計算欄位的彙總值
• 設定彙總值的進位處理與小數點以下顯示位數
• 以關聯記錄為單位進行分頁
• 設定關聯記錄的排序方式

將關聯記錄置換為清楚易讀的表格

在本外掛中，您需要設定關聯應用程式、取得條件、要顯示的欄位，以及顯示位置的空白欄位。

外掛會取得符合所設定條件的關聯記錄，並在記錄詳細畫面或編輯畫面中以表格顯示。

它不只像一般關聯記錄欄位那樣「顯示關聯應用程式的資訊」，還能在表格上進行搜尋、篩選與換頁，因此即使關聯記錄筆數眾多，也能輕鬆找到目標資訊。

在同一畫面確認子表格資料列

若關聯應用程式中含有子表格，只要選擇要顯示的子表格與欄位，即可將關聯記錄的資訊與子表格資料列展開至同一個表格。

展開子表格時，關聯記錄端的欄位可以記錄為單位合併顯示。即使一筆關聯記錄底下有多列明細，也能清楚看出父關聯記錄的資訊與明細列之間的對應關係。

例如從案件應用程式參照報價應用程式，並顯示報價應用程式中明細子表格的架構下，就能以一份連續的表格確認父記錄底下的報價與明細。

若不使用子表格，也可以只將關聯應用程式的一般欄位以「一筆記錄一列」的方式顯示。

搜尋與篩選顯示中的資料

表格上方會顯示搜尋欄位。

您輸入的字串會同時以顯示中的關聯記錄欄位與子表格欄位為搜尋對象。若輸入多個詞彙，即可篩選出同時包含這些詞彙的資料列。

此外，您也可以從各欄位的篩選器選擇值，或以欄位內的關鍵字進行篩選。

搜尋與欄位篩選可以搭配使用，因此更容易進行「只看特定客戶的明細」「只看特定狀態且已填入金額的列」這類確認作業。

當場彙總數值與計算欄位

數值欄位與計算欄位可以顯示彙總值。

由於彙總對象會與目前顯示的資料列連動，您可以針對經過搜尋或欄位篩選後的結果，確認總和、平均、最大值與最小值。

進位處理可從四捨五入、無條件進位、無條件捨去中選擇，小數點以下的最大顯示位數也可以設定。

以多重條件取得關聯記錄

從關聯應用程式取得資料的條件可以設定多組。

外掛會比對本應用程式端的欄位值與關聯應用程式端的欄位值，只顯示符合條件的記錄。

文字類欄位可指定「等於」「不等於」「包含」「不包含」，日期類欄位可指定「早於」「晚於」等，數值類欄位可指定「大於等於」「小於等於」等，依欄位型別提供對應的條件。

sequenceDiagram
    participant U as 使用者
    participant R as 記錄詳細畫面
    participant P as 外掛
    participant K as kintone API

    Note over R,P: 顯示記錄詳細畫面
    R->>P: 於空白欄位建立顯示區域
    P->>K: 取得關聯應用程式的欄位資訊
    P->>P: 依目前記錄的值組出取得條件查詢
    P->>K: 取得符合條件的關聯記錄
    K-->>P: 關聯記錄資料
    P->>P: 展開子表格資料列並建立搜尋索引
    P-->>R: 顯示表格

    Note over U,P: 顯示後的操作
    U->>P: 搜尋、欄位篩選、換頁
    P->>P: 於用戶端進行篩選並更新顯示
    Note over P: 不消耗 API，即時反映結果

適合使用本外掛的情境

關聯應用程式中含有明細子表格時

即使只靠關聯記錄難以追蹤父記錄以外的資訊，只要將子表格資料列展開至同一個表格，就能輕鬆進行明細層級的確認。

想在記錄詳細畫面比較關聯資料時

適合案件、合約、請款、作業歷程等，一筆記錄底下連結多項關聯資訊的業務。

透過搜尋與欄位篩選，您不必離開詳細畫面就能篩選出所需的關聯記錄。

想快速確認關聯記錄的數量或金額時

不必為了確認總和或平均而另外製作彙總表，可直接針對顯示中的關聯記錄與明細，當場確認彙總值。

設定步驟

配置顯示位置的空白欄位

首先，請在您想顯示外掛的應用程式表單中配置一個空白欄位。

空白欄位的元素 ID 稍後將在外掛設定畫面中選取。

設定關聯應用程式與取得條件

在外掛設定畫面中選擇關聯應用程式。

接著選擇本應用程式端的欄位與關聯應用程式端的比對欄位，設定要以什麼條件取得關聯記錄。

取得條件可新增多組，所有條件都會以 AND 結合。

選擇要顯示於表格的欄位

選擇要從關聯應用程式顯示的欄位。

必要時，也可以選擇要顯示的子表格，以及要從子表格顯示的欄位。

若未選擇子表格，則會以關聯記錄為單位顯示表格。

調整顯示筆數、彙總與排序

單次顯示的關聯記錄筆數可設定在 1 至 500 筆的範圍內。

若要顯示彙總值，請設定進位處理與小數點以下的最大顯示位數。

最後指定關聯記錄的排序欄位與遞增／遞減順序，設定即告完成。

聯絡我們

若您發現外掛的問題，或有新增功能的需求，歡迎透過畫面上方的導覽列與我們聯繫。

外掛的原始碼

本外掛為開源專案。 原始碼公開於 GitHub，任何人都能自由查閱。

若您對詳細的實作內容或架構有興趣，請透過本頁上方的「查看原始碼」按鈕前往儲存庫。