创建 Easy Form
将 Easy Form 宏添加到页面并发布页面
表单名称
表单名称是表单数据的页面唯一键。在提交表单数据后更改它将断开与数据的连接。可以通过将名称恢复到其原始值来恢复数据连接。
单击表单上的“编辑”按钮（在页面视图模式下），拖放字段以快速创建表单
单击 Save
自定义输入验证
在管理配置工具中启用“使用正则表达式进行自定义验证”时，类型为“文本”的字段允许使用正则表达式配置自定义验证：
例如，您可以使用正则表达式 ^（\d{3}-？\d{2}-？\d{4}|XXX-XX-XXXX）$ 来验证用户是否输入了有效的美国社会安全号码，例如 123-45-6789：
您可以配置自定义验证失败消息，当用户的输入未通过验证时，将显示该消息：
创建报告
只需将 EasyForm 报表宏添加到任何页面，指明页面位置和表单名称，即可查看结果
报告权限
要在页面上查看 Easy Form 报表，用户必须对包含 Easy Form 的页面具有编辑权限（以及报表所在页面的查看权限）。
可以访问报表所在页面但无权访问报表的用户将看到一条信息性消息：
可以查看报表的用户可以从表单底部的链接导出表单数据：
要绕过表单报告的权限检查，可以在 Easy Form 宏编辑器中编辑表单以设置“不受限制的报告”：
匿名用户可查看不受限制的报表。不受限制的报表的最佳实践是将它们放在匿名用户无法访问的页面上，以便所有已登录的用户都可以看到报表，但不能看到其他任何人。如果您确实向匿名用户开放报表，请注意，即使报表不受限制，也会对匿名用户禁用报表导出功能。
从 Admin Tool 导出报告
管理员用户可以使用 Easy Form 管理工具将报表导出为 JSON、XML、XLS 或 CSV 数据。该工具位于 Confluence 通用配置管理工具的 “Easy Forms” 下：
其他空间中 Easy Forms 的报表
在 Easy Form Report 宏编辑器中，在“Page with form”的输入中键入页面名称，自动完成将在匹配页面名称的下拉列表中呈现该页面。如果页面位于另一个空间中，则选择它将通过在页面名称前加上该空格键来填充输入，以冒号分隔。例如，TestSp：测试 Easy Form 页面
报表中的分页
在版本 1.11.7 及更高版本中，Easy Form Report 宏具有用于控制分页的设置：“客户端分页的最大行数”。默认值为 10,000 行：
当报表中的行数小于或等于此设置中的行数时，将在报表表中使用客户端分页。否则，将使用服务器端分页。
客户端分页将报表的所有行加载到浏览器（和服务器）的内存中，这使得排序和搜索筛选变得快速。权衡是它比服务器端分页使用更多的内存，并且当页面数非常大时，它可能会使您的服务器或浏览器陷入困境。
服务器端分页仅将一页数据加载到浏览器（和服务器）的内存中。排序/搜索速度稍慢，但对于非常大的数据集（提交量很大的报表）性能良好。
您可以针对报表宏调整此参数，将数字调低以优先选择服务器端分页，或将数字调高以优先选择客户端分页。将其设置为 0 将始终使用服务器端分页。
由于 SQL 和报表的数据库架构施加的限制，服务器端分页在排序/筛选作中有一些限制。
对于服务器端分页，您不能在按提交值搜索的同时按提交值排序。对于这种情况，您必须按另一个字段（如更新日期）排序，然后按提交值搜索。
无法对多值提交字段（复选框）进行排序
无法按用户排序或搜索
排序和搜索区分大小写
电子邮件通知
通知配置
要控制表单提交的电子邮件通知，请导航到 管理 > Easy Forms > 配置
服务器配置
要使电子邮件通知正常工作，你的 Confluence 服务器还必须成功配置一个发送邮件 SMTP 服务器：
Confluence Workbox 通知集成
可以通过 Confluence Workbox 通知来通知 Confluence 用户提交表单：
通知将发送到用户的 workboxes，如下所示：
匿名表单
单个响应
要将表单上的投票限制为单个响应，用户需要登录并在宏编辑器中选择“Annonymous form”。
在宏编辑器中将表单指定为 “匿名表单” 时，送审是匿名的。
Report 宏将不包括每行的用户，因为匿名表单提交不会保留该用户。
无限响应
您还可以在允许匿名查看访问的页面上添加匿名响应，并且宏未选中“每个用户一个提交”
回复将显示为匿名，但任何人都可以根据需要多次回复。他们所要做的就是刷新表单。
Webhook 通知集成
Easy Form 管理工具具有用于启用 Webhook 集成的设置：
您可以将其设置为资源的 URL，该 URL 将接受 HTTP POST，其中包含一个 JSON 字符串，该字符串包含表单送审的提交数据。
JSON 对象包括 formId、formName 和 formTitle。提交的值包含在 2 个数组中：一个 columns 数组，用于定义表单中每个字段的标题和类型，以及一个包含字段值的 rows 数组。
例如：
{
"formId": "28",
"formName": "EasyFormWebHookTest",
"formTitle": "Test Form",
"formCreated": "2020-06-19T22:09Z",
"formUpdated": "2020-06-19T22:10Z",
"pageId": 1245427,
"rowsTotal": 1,
"rowsOffset": 0,
"rowsLimit": 1,
"columns": [
{
"uid": "c2YmFmL",
"title": "Favorite Color",
"type": "radio",
"created": "2020-06-19T22:10Z",
"updated": "2020-06-19T22:10Z",
"deleted": false
},
{
"uid": "c6RtagW",
"title": "Favorite Animal",
"type": "text",
"created": "2020-06-19T22:10Z",
"updated": "2020-06-19T22:10Z",
"deleted": false
}
],
"rows": [
{
"id": 32,
"userKey": "2c9_ThisIsFake_2016e234a15ad0000",
"userName": "John Doe",
"created": "2020-06-19T22:10Z",
"updated": "2020-06-19T22:10Z",
"fields": [
{
"uid": "c2YmFmL",
"values": [
"blue"
]
},
{
"uid": "c6RtagW",
"values": [
"Blue Whale"
]
}
]
}
]
}
HipChat 通知集成（已弃用）
请注意，Atlassian 的 Hipchat 已于 2019 年 2 月 15 日终止使用。Easy Form 的 Hipchat 集成已弃用，并将在未来版本中删除。
滚动到“插入 Easy Form 宏”弹出框的底部
输入您的 HipChat 房间令牌以集成 HipChat
表单复制
你可以使用 Confluence 的 Copy Page 功能，在 Confluence 页面的编辑模式中，将表单从一个页面复制粘贴到另一个页面
包含表单的页面模板可以简单地通过创建/编辑模板并粘贴到从编辑模式下的页面复制的 EasyForm 宏来创建
数据库
Easy Forms 使用 Active Objects 将数据持久化到 Confluence Server 的数据库中。本文档包含此应用程序使用的所有 DB 表的详细信息，除了在服务器之间迁移数据外，还可以用于 DB 备份作：在实例之间迁移 Easy Form 数据