设计手册
设计手册
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. 若图片字段有勾选上载多张图片，当仅上载一张图片且未设置“最高高度”与“最宽宽度”时，系统默认引出尺寸为 300px × 300px；若有设置，则依设置尺寸引出。当上载多张图片时，系统会依图片数量分配设置的“最高高度”与“最宽宽度”，以避免图片过多导致版面挤压。因此，上载越多张图片，单张图片的引出尺寸会越小，不会完全依照设置尺寸引出。
当在自由输入字段有使用 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 及多图字段。
感谢您的宝贵意见！
