設計手冊
設計手冊
Ragic 提供客製列印報表功能，可將表單資料匯出為自訂格式檔案，包括 PDF、DOCX、PNG、XLSX、PPTX 等。
例如，可以將「銷售訂單」匯出為公司內慣用的 PDF 格式。
在列表頁或表單頁的工具選擇客製列印報表。
或是從建立報表中選擇客製列印報表。
會進到這個頁面。
接下來依照以下步驟建立範本。
注意：只有開放系統管理者 SYSAdmin 有建立與設定客製列印報表範本的權限。
1. 確認是否有範本
首先，系統會先確認你是否已經有一個已經設計好了的檔案（Word、Excel 或 PowerPoint）可以上傳當作範本。
如果已經有範本請選擇有，我要上傳自己的檔案當作範本，沒有範本則選擇沒有，請給我一個預設範本修改
2. 下載範本
若選擇的是沒有，請給我一個預設範本修改，便會進入此頁面，點擊下載來下載預設範本。
備註：目前僅提供預設的 Word 範本，可作為基礎進行修改，製作所需的報表格式或類型（例如 Excel 或 PowerPoint）。下載的 Word 範本在本機編輯並儲存後，變更將自動反映於線上的報表預覽中，無需手動重新上傳；若需輸出為 Excel 或 PowerPoint 格式的報表，則需另行上傳對應格式的範本。
3. 修改範本
接下來就可以依需求修改範本，包括調整排版、增減欄位，或將範本轉換為 Excel 或 PowerPoint 格式。修改注意事項請參考此章節。
Word 格式範本
Excel 格式範本
PowerPoint 格式範本
一般欄位參數可參考上傳範本頁面中的欄位語法產生器；若需使用特定欄位參數、特殊格式或相關範例，請參考此章節。
點擊該欄位的語法會直接複製參數，便可以快速貼到你的範本中。
注意：獨立欄位和子表格欄位的語法不同。
獨立欄位：
子表格： 只需要參考下圖語法，寫 [i] 和 [i+1] 兩列即可，並且列 [i+1] 中只需加入其中任一欄位的語法，即可代表整列資料。
當表單中有多個參照自相同來源表單的子表格時，系統會在子表格欄位的參數中加上欄位座標以作區分。若需要自行在範本上加上欄位座標，除了可以從欄位語法產生器取得，也可以查看欄位資訊。
4. 上傳範本
如果選擇有，我要上傳自己的檔案當作範本或是下載完範本後點擊下一步，便會進入到此頁面，將修改完成的範本上傳。
可以從下方的視窗預覽修改後的範本。
命名報表：在上方可以修改報表名稱，由於可以有多種不同版本的客製列印報表，請以簡單易懂的方式命名以便使用者辨識。
檔案格式：在預覽視窗的右上角選擇想要下載的檔案類型。
以下列出不同格式範本所支援的輸出檔案格式：
| 範本格式 | 支援產出格式 |
|---|---|
| Word 範本 | DOCX、PDF、PNG |
| Excel 範本 | XLSX、PDF |
| PowerPoint 範本 | PPTX、PDF |
圖片比例與尺寸：當輸出格式選擇為 PNG 時，可以自訂圖片的比例與尺寸，以調整輸出的解析度與顯示效果。尺寸倍率越大，輸出的解析度與像素越高，圖片畫質也會越清晰。
輸出的文件內容會依據所選比例自動調整圖片比例，建議確認範本版面比例與所選比例一致，以避免內容顯示異常或版面裁切。
完成設定後點擊儲存報表。
備註：報表進階設定請參考此章節。
便會出現以下頁面。
按下方的結束便會看到報表的按紐新增於右下角的位置，即可開始使用客製列印報表。
圖片上傳無法順利輸出時，可以重新下載預設範本，但如果有自己設計的範本，不方便重新下載預設範本時，請在該欄位的參數後方加上 IMG:html。
備註：
1. Excel 和 PowerPoint 格式範本不支援此參數。若需在這兩種格式範本中輸出圖片，請參考此章節，將圖片欄位加入範本中。此方式僅適用於單圖圖片欄位，多圖圖片欄位不適用。
2. 輸出圖片大小可透過設定「最高高度」與「最寬寬度」調整。若輸出結果不符合預期，也可參考此章節，透過調整圖片欄位範本控制輸出大小。此範本調整方式僅適用於單圖圖片欄位，多圖圖片欄位不適用。
3. 若欄位有勾選上傳多張圖片上傳越多張圖片，單張圖片的輸出尺寸會越小，不會完全依照設定尺寸輸出。
當在自由輸入欄位有使用 alt+enter 來換行時，需要手動調整範本的欄位參數，在該欄位的參數後面加上 :convCRLF，才可以在輸出時正確將欄位內容換行。
如果在自由輸入欄位中使用了 BBCodes，或在文字編輯器中套用了文字樣式，並希望在匯出檔案時保留相同的文字效果，則需要調整欄位參數。（Excel 和 PowerPoint 格式範本不支援。）
請參考下表兩種參數說明：
| 參數格式 | html 格式 | html(inline) 格式 |
|---|---|---|
| 範例 | {d.1002578:html} | {d.1002581:html(inline)} |
| 支援 BBCodes | br、b、i、u、s、li、ol、ul、img、url、color | b、i、u、s、color（不支援網址、圖片及任何會造成換行的 BBCode） |
| 適用情境 | 需完整樣式顯示，欄位值需要換行（段落、清單） | 只需呈現部分樣式，且因特殊版面需求，欄位值不需換行 |
範例：
將下圖的資料使用兩種不同格式輸出效果如下：
html 格式
html(inline) 格式
當表單中使用 Markdown 欄位，且希望匯出檔案時保留相同的排版效果，需在該欄位參數後加上 :html。（Excel 與 PowerPoint 格式範本不支援。）
備註：
1. 若有使用 Headers（#）語法，需在範本任一位置加入 {o.preReleaseFeatureIn=5002000}。
2. 目前不支援 Blockquotes 語法。
若希望在列印的檔案中顯示輸出當下的日期與時間，可在範本中加入以下參數： {c.now:formatD('YYYY-MM-DD HH:mm:ss')} 。
注意事項：
1. formatD() 可使用的日期/時間參數格式請參考此頁面。
2. 參數中請使用「單引號」，且只能使用 「'」，不可使用 「’」。
3. 時間將依照公司所設定的時區顯示。
在範本中加入參數後，可以將表單中指定檔案上傳欄位的 PDF 檔案合併至最終輸出的 PDF 文件。你可以選擇將其合併至文件的開頭或最後。以下示例假設該檔案上傳欄位的參數為 「d.1234567」。
合併到最後面
在範本中的任意位置加入以下參數：
{d.1234567FILE_URL[i]:appendFile}
{d.1234567FILE_URL[i+1]}
合併到最前面
在範本中的任意位置加入以下參數：
{d.1234567FILE_URL[i]:appendFile(start)}
{d.1234567FILE_URL[i+1]}
上傳加入參數的範本後，該欄位中所有已上傳的 PDF 檔案會依順序自動合併至輸出文件的開頭或最後。
若表單中有多個檔案上傳欄位，只需為每一個欄位分別加入相同格式的參數即可。可以依需求決定哪些欄位合併至文件開頭，哪些合併至文件最後。
備註：合併後的檔案大小上限為 100 MB。
點擊報表名稱旁邊的齒輪並選擇進階設定進行以下設定：
使用權限：設定可使用此列印報表的群組。
檔案名稱參考欄位：設定下載時的檔案名稱要依據表單的哪個欄位來命名。
隱藏動作按鈕：勾選是否要在列表頁或表單頁隱藏列印動作按鈕。
以下項目只有在檔案格式為 PDF 時才能設定：
以密碼保護生成的 PDF：勾選後可以輸入密碼，之後就必須輸入該組密碼才能開啟下載的 PDF 檔案。
使用欄位值作為 PDF 密碼：勾選後可以選擇表單中的某個欄位值作為密碼，例如：「員工薪資單」可以選擇「員工編號」欄位值作為密碼，員工必須輸入自己的「員工編號」才能開啟個人的薪資單 PDF 檔案。
注意事項：
1. 此設定和以密碼保護生成的 PDF 只能擇一啟用。
2. 當該筆資料的指定欄位值為空時，則產生的 PDF 不會套用密碼保護。
3. 當同時下載多筆資料並合併為一份 PDF 時，產生的 PDF 也不會套用密碼保護。
使用列印預覽而非直接下載：勾選後，點擊報表按鈕時會另開視窗顯示預覽頁面，可以在此直接列印，而無需下載檔案。下載多筆資料時，只有在選擇儲存為一份檔案時才支援列印預覽；多個檔案(壓縮成 Zip 檔與儲存到檔案欄位皆不支援。
再次進入客製列印報表的頁面後，可以選擇要新增報表或是修改已儲存過的報表。
也可以直接點擊報表名稱旁的齒輪來修改報表的名稱、進階設定、下載範本或報表。
點擊想要修改的報表，便可以再次上傳修改好的範本。
可以點擊報表名稱旁邊的齒輪並選擇下載此版範本來下載目前這個報表所儲存的範本再進行修改。
新增、修改及刪除範本的紀錄都會記錄在版本紀錄中，點擊範本連結可以下載該版本檔案。
可以在此頁面點擊報表旁的 X 來刪除儲存的報表。
注意：只要有新增儲存報表，就會產生一組對應的動作按鈕，此按鈕無法透過刪除動作按鈕來移除，只能透過客製列印報表的設定頁面刪除對應的報表來移除該動作按鈕。
儲存報表後到想要列印的表單資料的表單頁，在右下角動作按鈕的地方會新增剛剛儲存好的列印報表按紐，點擊按鈕後便會開始下載檔案。
系統管理者也可以進入客製列印報表頁面選擇報表後，點擊報表名稱旁邊的齒輪並選擇下載報表。
注意：若有發現有欄位無法順利下載的情況，請參考限制與注意事項以及此篇文章。
先在列表頁點擊右下角的圖示以開啟按鈕列。
在列表頁點擊列印報表按紐後，可以選擇下載多筆資料的範圍及方式。
下載方式有以下兩種：
(1) 將檔案儲存至表單的欄位
若你的表單內有檔案上傳欄位，可以選擇這個方式將輸出檔案上傳至該資料的檔案上傳欄位。
(2) 儲存檔案
可以選擇儲存成多個檔案(壓縮成 Zip 檔)或是合併成一份檔案。
注意：多筆資料合併成一份檔案目前只支援 PDF、XLSX 及 PPTX 格式輸出。
1. 目前只有提供下載表單的表單頁格式，若想要下載列表頁格式，請參考合併列印功能。
2. 當表單的欄位過多導致表單寬度過大時，下載的範本會無法顯示超出範圍的欄位，請參考欄位語法產生器將欄位加到範本中。
3. 下載的範本會自動將子表格置於表單的最下方，若想要移動子表格位置需要自行調整，但請留意請勿將不同子表格並排排列，會導致列印報表時出現問題。
4. 目前僅支援將檔案上傳欄位中的 PDF 檔合併至輸出的 PDF 檔案。如需調整範本設定，請參考此章節。
5. 目前在 Word 格式範本使用部分 BBCodes 的欄位將無法顯示於輸出檔案中，支援輸出的 BBcodes 及調整範本方法請參考此章節。
6. 當簽名欄位或條碼欄位無法順利輸出時，可以重新下載預設範本，但如果有自己設計的範本，不方便重新下載預設範本時，請參考此文章的方法。
8. 目前不支援輸出使用以下回傳電子簽名的簽核公式欄位：
(1) APPROVAL.STEP([stepIndex]).SIG([email])
(2) APPROVAL.STEP([stepIndex]).SIGIMG([email], [width], [height])。
9. 使用 Excel 格式範本限制：
(1) 不支援將圖片插入至儲存格內（僅支援插入於儲存格上方），且不支援子表格中的單圖欄位輸出。
(2) 不支援 :html 參數，因此無法輸出 BBCode 、Markdown 及多圖欄位。
10. 使用 PowerPoint 格式範本限制：
(1) 不支援子表格中的單圖欄位輸出。
(2) 不支援 :html 參數，因此無法輸出 BBCode 、Markdown 及多圖欄位。
感謝您的寶貴意見！
