設計手冊
設計手冊
在 Ragic 中，你可以用合併列印將資料輸出成自訂的 Excel 或 Word 格式。像是將「員工資料」輸出成公司內慣用的格式：
合併列印可以輸出表單頁或是列表頁的格式，針對 Excel 或 Word 分別可以輸出的格式如下：
| 格式 | Excel | Word |
|---|---|---|
| 表單頁格式(一般格式) | 支援 | 支援 |
| 表單頁格式(一頁中包含多筆資料格式) | 不支援 | 支援 |
| 列表頁格式 | 支援 | 不支援 |
注意：Excel 格式雖然不支援此種輸出方式，不過可以在輸出表單頁格式時選擇儲存成一份檔案(一頁籤多筆)，也可以達成類似效果。
以下將分別說明這幾種格式的設定與範例。
想了解更多合併列印的應用請參考教學影片與應用章節。
在開始合併列印前，首先需要製作「範例格式」(以下稱為「範本」)，在列表頁或表單頁的工具點選合併列印
你可以先下載「範例格式」來製作「範本」，點選「範例格式」旁邊的下載即可直接下載表單頁的 Excel 範例格式，Word 沒有提供範例格式，需要自己製作。
下載檔案後可以根據需求修改，例如調整欄位位置、刪除欄位、加上公司名稱及圖片，要注意的是根據不同列印格式，範本的設計也會不同。
備註：
1. 在以下範例中我們用 Excel 來編輯範例格式，但基本上可以用任何試算表軟體，只要可以存成 .xlsx 檔即可。
2. Word 合併列印不支援圖片上傳欄位的多圖片設定，Word 不像 Excel 有清楚分格，因此多張圖片在同一欄位的排版沒有適合的輸出邏輯。
以下說明在範本中可以使用的參數/變數：
目前合併列印可用的格式（參數）與對應的結果主要如下。
| 格式（參數） | 對應結果 |
|---|---|
| <<欄位編號>> | 該欄位值，如果表單中有重複的欄位名稱請使用欄位編號 |
| <<欄位名稱>> | 該一般欄位值 |
| #欄位名稱# | 該子表格欄位值 |
| <<$USERNAME>> | 執行的使用者名稱 |
| <<$USERID>> | 執行的使用者信箱 |
| <<$DATE>> | 執行的日期 |
| <<$DATETIME>> | 執行的日期及時間 |
| <<RECORD_LINK>> | 該筆資料的網址 |
例如：要加入欄位時可以輸入<<欄位名稱>>，若為子表格欄位的話，則要寫#欄位名稱#。
表單中若有簽核流程，右下方的簽核紀錄並不會自動附在範例檔案格式中。
要將簽核紀錄加入在合併列印中，可以在範例格式中加入簽核相關變數，大部分變數只支援輸出至 Excel 格式。
以下為簽核流程相關的格式變數與其對應的結果：
| 格式（變數） | 顯示結果 | 備註說明 |
|---|---|---|
| #{{APPROVAL_STATUS}}# | 簽核的狀態 | 如果是代理人同意或拒絕的話會有(代理)字樣 |
| #{{APPROVAL_APPROVER_TITLE}}# | 簽核階層的名稱 | 無 |
| #{{APPROVAL_DATE}}# | 簽核的日期 | 只有簽核的狀態是同意時會被載入 |
| #{{APPROVAL_APPROVER_NAME}}# | 簽核者的名稱 | 無 |
| #{{APPROVAL_APPROVER_SIG}}# | 簽核者在個人設定中的簽名圖檔 | 無 |
| #{{APPROVAL_APPROVER_EMAIL}}# | 簽核者的E-mail | 無 |
| #{{APPROVAL_COMMENT}}# | 同意/拒絕簽核的理由 | 無 |
| <<APPROVAL_RESULT>> | 簽核結果 | 支援輸出至 Word |
假設要將一筆「出庫單」中的簽核紀錄加入合併列印格式中，原本表單設計如下。
加入簽核流程的變數，在範例中是加入簽核狀態、簽核人。
輸出後就可以在格式中設定的欄位看到簽核相關的資料。
如果希望輸出表單頁格式的資料，可以使用 Excel 或 Word 格式。
Excel：可以直接下載 Excel 範例格式來修改。
Word：由於 Word 沒有辦法下載範本，可以把 Excel 範本的參數先複製 Word中，再參考參數調整你的範本。
子表格
如果要輸出表單頁上的子表格時，請注意 Word 不支援輸出子表格資料，請用 Excel 格式。如果希望以自訂 Word 格式輸出子表格內容，請使用客製列印報表。
子表格的參數和獨立欄位不同，請參考以下範例以及參數列表：
在列表頁和表單頁都可以上傳表單頁格式的範本，開啟設定合併列印的視窗後，點擊新增格式，在範本上傳的地方選擇檔案，命名這個合併列印範本的名稱，選擇以表單頁格式輸出，再按上傳就可以了。
你可以根據需求上傳不同版本及格式的範本。
在列表頁和表單頁都可以輸出表單頁格式的資料。
1. 輸出單筆資料
進入想要輸出的資料表單頁，開啟合併列印的設定視窗或是直接點擊右下角的動作按鈕來輸出該筆資料的表單頁格式檔案。
點擊後就會直接下載檔案。
2. 輸出多筆資料
在列表頁開啟合併列印的設定視窗後(或是在頁面右下角)，點擊合併列印按鈕，選擇輸出資料的範圍及下載方式。
下載方式有以下兩種：
(1) 將檔案儲存至表單的欄位
若你的表單內有檔案上傳欄位，可以選擇這個方式將檔案依輸出資料上傳至該資料的檔案上傳欄位。
(2) 儲存檔案
根據輸出不同檔案類型，可以下載的方式不同：
Excel：一份檔案(多個頁籤)、多個檔案(壓縮成 Zip 檔)、一份檔案(一頁籤多筆)
Word：多個檔案(壓縮成 Zip 檔)、一份檔案
注意：目前合併列印成一份檔案下載上限是 Excel 一次 300 筆/ Word 一次 100筆資料，如果要合併列印超過上限資料的話，下載方式請選擇儲存到檔案欄位或儲存為多個檔案。
合併列印預設輸出時是一頁一筆資料，但如果希望將多筆資料印在同個頁面上，例如：製作通訊錄、標籤或名片等等。這時候可以運用 Word 格式製作範本。
注意：Excel 格式雖然不支援此種輸出方式，不過可以在輸出表單頁格式時選擇儲存成一份檔案(一頁籤多筆)，也可以達成類似效果。
在 Word 範本中，將參數改為<<欄位名稱或 ID ~~1>>、<<欄位名稱或 ID ~~2>>以此類推，並在格式中設定好一頁要包含幾筆資料。要注意上傳的範本「僅限一頁」，超過一頁的範本會無法正常執行。
參考範例如下：
一頁中包含多筆資料格式的範本只能上傳於列表頁，在列表頁開啟設定合併列印的視窗後，點擊新增格式，在範本上傳的地方選擇檔案，命名這個合併列印範本的名稱，記得要選擇以列單頁格式輸出，再按上傳就可以了。
注意：在表單頁上傳或是選擇以表單頁格式輸出，都會導致輸出失敗。
在列表頁開啟合併列印的設定視窗後(或是在頁面右下角)，點擊合併列印按鈕，選擇輸出資料的範圍。
就能將多筆資料輸出在同一個頁面上。
如果希望輸出列表頁格式的資料，只能使用 Excel 範本，Word 無法輸出列表頁格式。
在 Excle 的範本將要輸出的表單頁欄位依照列表頁的方式排列：
使用公式
在列表頁格式中，你可以設定公式來計算資料。
公式的設定格式如下：
<<FORMULA:(在這邊輸入你的公式)>>
你也可以在公式內使用動態式參數來自動選取你所要計算的儲存格。目前支援的兩種動態式參數如下：
{{r}}：自動更換成目前儲存的行。
{{l}}：自動更換成此列的儲存的最後一行。
承接上面的例子，如果你想要知道這些球場的觀眾容納人數是否多於 8000 人，可以在格式中套用這個公式：
<<FORMULA:IF(C{{r}}>=8000, "是","否")>>
就可以合併列印出以下資料。
另外，如果你要計算所有球場的加總容納人數，你可以設定這個公式：
<<FORMULA:SUM(C2:C{{l}})>>
在合併列印格式上設定加總公式時，需要將要計算的第一筆資料所在的儲存格加入在公式內。以這個例子來說，就是 C2。
就可以合併列印出以下資料。
在列表頁和表單頁都可以上傳列單頁格式的範本，開啟設定合併列印的視窗後，點擊新增格式，在範本上傳的地方選擇檔案，命名這個合併列印範本的名稱，選擇以列表頁格式輸出，再按上傳就可以了。
注意：如果在表單頁上傳列表頁格式，合併列印按鈕並不會顯示於表單頁，只會顯示在列表頁上。
你只能在列表頁輸出列表頁格式。
你可以在列表頁先篩選資料，或是直接開啟合併列印視窗(或是頁面右下角)點擊按鈕，選擇資料範圍就可以列表頁的形式輸出了。
上傳範本後可以針對該範本進行以下設定：
點擊合併列印按鈕旁的編輯格式，可以重新上傳或下載範本，也可以刪除該範本。
點擊編輯格式右側的齒輪就可以設定能夠使用此合併列印範本的群組。
表單頁合併列印
在編輯格式右方的齒輪中，選取要將欄位值套用至檔名的參考欄位。
列表頁合併列印
在編輯格式右方的齒輪中，可以自行命名檔案名稱。
在編輯格式右方的齒輪中，還可以進行以下設定：
1. 更改按鈕名稱。
2. 如果資料中有圖片，可以決定是否將圖片依比例縮放。
3. 可以設定是否要將合併列印顯示為動作按鈕。
注意：由於合併列印實際上並非動作按鈕，只是作為一個「捷徑」按鈕方便使用者直接點擊列印，因此不支援動作按鈕附加設定或是與其他動作按鈕合併，關於動作按鈕的種類有哪些，請參考此章節。
跟著下方的影片一步一步學習！
除了參考影片中關於「訂購單」因應不同情境需求的應用，你也可以參考以下兩篇部落格文章來了解更多關於合併列印的應用喔！
1. 合併列印設定的版面大小是固定的，不會因為子表格資料而自動改變列高，但你可以參考 Excel 教學，在合併列印後，手動一次調整列高。
2. 還原版本紀錄時，合併列印的設定也會還原至該版本紀錄儲存當下的合併列印設定狀態。
