通过 Edge Delivery Services 发布自适应表单
发布自适应表单可使其在 Edge Delivery Services 上供最终用户访问和提交。此过程包括三个主要阶段:发布表单、配置安全设置、访问上线表单。
您将了解:
- 将表单发布到 Edge Delivery Services
- 为表单提交配置安全设置
- 访问并验证您发布的表单
- 设置适当的 URL 路由和 CORS 策略
先决条件
- 已使用 Edge Delivery Services 模板创建了自适应表单
- 表单已经过测试,并准备好用于生产
- AEM Forms 作者权限
- Cloud Manager 访问权限(用于生产配置)
- 开发人员对表单块代码的访问权限(用于提交设置)
发布流程概述
将表单发布到 Edge Delivery Services 采用一个三阶段方法:
- 第一阶段:表单发布 - 将您的表单发布到内容传递网络并验证发布状态
- 第二阶段:安全配置 - 设置 CORS 策略和引荐来源过滤器以确保安全提交
- 第叁阶段:访问和验证 - 测试表单功能并验证完整的工作流
每个阶段都以前一个阶段为基础,以确保安全、正确地部署。
阶段 1:发布表单
-
访问您的表单:在通用编辑器中打开自适应表单
-
开始发布:点击工具栏中的? 发布 ?图标
-
审阅发布资产:系统显示所有正在发布的资产,包括您的表单
-
确认发布:点击? 发布 ?以继续
-
验证成功:查看确认消息
检查状态:再次点击? 发布 ?图标,查看当前状态
验证检查点:
- 在编辑器中,表单显示“已发布”状态
- 发布过程中没有出现任何错误消息
- 表单出现在已发布资产列表中
要取消发布表单:
- 在编辑器中打开表单
- 点击右上角的叁圆点菜单(?)
- 选择? 取消发布
阶段 2:配置安全设置
要启用安全表单提交,您必须配置以下安全设置:
- 允许 Edge Delivery Services 将数据提交给 AEM
- 防止您的 AEM 实例在未经授权的情况下被访问
- 为表单提交启用 CORS(跨来源资源共享)
- 过滤请求,仅允许合法的 Edge Delivery 域
note important |
---|
IMPORTANT |
生产环境中需要:这些配置对于在生产环境中的表单提交是必需的。 |
目的:将表单直接提交到您的 AEM 实例
文件位置:blocks/form/constant.js
在您的 Edge Delivery Services 项目中
配置示例:
code language-javascript |
---|
|
验证检查点:
- 通过正确的 AEM 发布 URL 更新了
constant.js
文件 - URL 与您的(生产、暂存或本地)环境匹配
- URL 中没有结尾斜杠
目的:允许来自 Edge Delivery Services 域的表单提交请求
实施:将 CORS 配置添加到您的 AEM dispatcher 或 Apache 配置
code language-apache |
---|
|
验证检查点:
- dispatcher 配置已应用 CORS 规则
- 包含所有必需的域(濒辞肠补濒丑辞蝉迟、丑濒虫.辫补驳别、丑濒虫.濒颈惫别)
- 配置已部署到目标环境
参考文档:
目的:将写入操作限制在已授权的 Edge Delivery Services 域中
实施方法:通过 AEM as a Cloud Service 中的 Cloud Manager 配置
配置文件:添加到项目的 OSGi 配置
code language-json |
---|
|
配置细分:
allow.empty
:拒绝没有引荐来源标头的请求allow.hosts.regexp
:允许来自 Edge Delivery Services 域的请求filter.methods
:在这些 HTTP 方法中进行筛选exclude.agents.regexp
:筛选时排除在外的用户代理
验证检查点:
- 通过 Cloud Manager 部署了引荐来源过滤器配置
- AEM 发布实例上的配置已激活
- 测试从 Edge Delivery Services 域提交表单是否正常运作
- 未经授权的域被禁止提交表单
参考文档:
阶段 3:访问您已发布的表单
标准 URL 格式:
code language-none |
---|
|
URL 组成:
<branch>
:Git 分支名称(通常是main
)<repo>
:存储库名称<owner>
:GitHub 组织或用户名<form_name>
:您的表单名称(小写,使用连字符)
环境特有的 URL:
code language-none |
---|
|
验证表单的无障碍可访问性:
- 测试表单加载:访问您的表单 URL,确认其正确加载
- 测试表单提交:填写并提交表单,验证数据处理
- 检查响应式设计:在不同的设备和屏幕尺寸上测试表单
- 验证安全性:确保 CORS 和引荐来源过滤器正常工作
预期结果:
- 表单加载无误
- 所有表单字段均正确显现
- 成功处理了表单提交
- 数据出现在所配置的目标中(电子表格、电子邮件等)
- 没有与 CORS 或安全策略相关的控制台错误