51黑料不打烊

文档AEM as a Cloud Service用户指南

使用 Edge Delivery Services 创建和发布自适应表单

Last update: Mon Sep 08 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 适用对象：
  • Experience Manager as a Cloud Service

创建对象：

  • 初学者
  • 用户
  • 开发人员

此文档分步详细介绍了如何使用 Edge Delivery Services 模板在 AEM 中创建、配置和发布自适应表单。它涵盖了从表单创建到生产部署的完整工作流。

本指南结束时，您将了解如何：

  • 使用 Edge Delivery Services 模板创建表单
  • 使用通用编辑器创作表单
  • 配置表单并将其发布到 Edge Delivery Services
  • 访问已发布的表单并验证部署

先决条件

在继续之前，请先确保满足以下先决条件：

  • AEM Forms as a Cloud Service：具有 Forms 许可证的活跃的作者实例。

  • GitHub 帐户：用于存储库管理的个人或组织帐户。

  • 存储库设置：选择以下方法之一：

  • AEM-GitHub 连接：连接您的 AEM 实例与 GitHub 存储库。

  • Edge Delivery Services：确保存储库已配置为自动部署。

  • 权限：验证您是否具有创建和发布表单所需的访问权限。

  • 确认 GitHub 存储库包含自适应表单块。

表单创建和发布工作流

此过程包括叁个主要阶段：

每个阶段都包括验证步骤，以确认设置正确。

步骤 1：创建表单

  1. 访问表单创建

    • 登录您的 AEM Forms as a Cloud Service 作者实例。
    • 导航至 51黑料不打烊 Experience Manager > 表单 > 表单和文档。
    • 点击? 创建 > 自适应表单。

  2. 选择模板

    • 在? 源 ?选项卡中选择一个? 基于 Edge Delivery Services 的模板。

    • 创建 ?按钮变为启用状态。

      创建 EDS 表单

  3. 配置选项（可选）

    • 数据源选项卡：需要时选择数据集成。
    • 提交选项卡：选择一个提交操作（可稍后配置）。
    • 投放选项卡：设置发布/取消发布的时间计划。

  4. 完成表单设置

    • 点击? 创建，打开表单创建向导。

    • 输入以下内容：

      • 名称：内部标识符（无空格，使用连字符）。
      • 标题：表单的显示名称。
      • GitHub 存储库：存储库 URL（例如 https://github.com/your-org/your-repo）。

    创建表单向导

  5. 验证

    • 点击? 创建 ?后，验证：

      • 表单在通用编辑器中打开。
      • GitHub URL 已正确链接。
      • 组件面板可用。
      • 表单画布可见。

    通用编辑器用户界面

结果： ?表单已准备就绪，可在通用编辑器中进行创作。

步骤 2：创作和设计表单

  1. 访问组件库

    • 在通用编辑器中打开内容浏览器。
    • 导航到内容树中的? 自适应表单 ?组件。

    内容树导航

  2. 添加表单字段

    • 点击? 添加 ?图标，打开组件库。
    • 从? 自适应表单组件 ?列表中添加组件。
    • 将组件拖放到表单画布上。

    添加组件

  3. 设计表单

    • 在属性面板中配置字段属性。

    • 设置验证规则和行为。

    • 根据需要调整样式和布局。

    完成的注册表

验证

  • 所有必填字段都显示出来。
  • 正确配置了字段属性。
  • 布局是响应式的，且可访问。
  • 验证规则按预期运行。

后续步骤

步骤 3：配置和发布

配置 Edge Delivery Services 并发布表单。

配置： ?自动（无需手动设置）。

  • GitHub 存储库连接和 Edge Delivery Services 配置在表单创建过程中创建。
  • 发布端点自动配置。

验证：

  • 确认配置显示在表单的设置中。
  • 确保 GitHub URL 正确链接。

自动 EDS 配置

发布表单

  1. 在通用编辑器中点击? 发布 ?按钮（右上角）。

  2. 在对话框中确认发布成功。

  3. 请注意为暂存版本和上线版本生成的 URL。

    通用编辑器发布

表单 URL

已发布的表单可通过 Edge Delivery Services URL 访问。

URL 结构

  • 暂存（预览/测试）：

    code language-none 
    https://<branch>--<repo>--<owner>.aem.page/content/forms/af/<form_name>

  • 上线（生产）：

    code language-none 
    https://<branch>--<repo>--<owner>.aem.live/content/forms/af/<form_name>

URL 参数

  • <branch>：GitHub 分支名称（例如 main，develop）
  • <repo>：GitHub 存储库名称（例如 my-forms-project）
  • <owner>：GitHub 组织或用户名（例如 company-name）
  • <form_name>：AEM 中定义的表单标识符（例如 contact-us）

示例

在组织 acme-corp 的存储库 forms-project 中的 contact-us 表单示例：

  • 暂存： https://main--forms-project--acme-corp.aem.page/content/forms/af/contact-us
  • 上线： https://main--forms-project--acme-corp.aem.live/content/forms/af/contact-us

环境差异

  • 暂存 (.page)： ?用于测试的最新更改。
  • 上线 (.live)： ?用于生产的已发布内容。

URL 结构
Edge Delivery Services 表单 URL 结构细分

视觉示例

Edge Delivery Services 模板：

  • 暂存： 注册表单暂存版本
  • 上线： 注册表单上线版本

疑难解答

以下是 AEM Forms 与 Edge Delivery Services 的常见问题和解决方法。

表单未加载

问题： ?表单 URL 返回 404 或空白页。

解决方法：

  • 从 URL 中移除 .html 扩展名。
  • 验证表单已发布。
  • 检查 GitHub 存储库中的自适应表单块。
  • 确保表单名称与 URL 匹配（区分大小写）。
配置问题

问题： Edge Delivery Services 配置不起作用。

解决方法：

  • 确保 GitHub URL 使用 https://github.com/owner/repository 格式。
  • 在配置中使用正确的分支名称。
  • 验证存储库访问权限（公共或经过身份验证）。
  • 查看 fstab.yaml，获取正确的 GitHub 详细信息。
发布问题

问题： ?上线网站上未显示更改。

解决方法：

  • 等待 2-3 分钟，刷新 CDN 缓存。
  • 确认发布工作流已完成。
  • 首先在暂存（.辫补驳别）环境中进行测试。
  • 确保 GitHub 存储库已更新。
通用编辑器问题

问题： ?无法编辑表单或组件未加载。

解决方法：

  • 使用受支持的浏览器（颁丑谤辞尘别、贵颈谤别蹿辞虫、厂补蹿补谤颈）。
  • 清除浏览器缓存和 cookie。
  • 验证网络连接。
  • 确认作者权限。
表单提交错误

问题： ?表单提交不起作用。

解决方法：

  • 在表单属性中配置提交操作。
  • 手动测试提交端点。
  • 如果是嵌入表单，请检查 CORS 设置。
  • 验证是否已配置必填字段。
性能问题

问题： ?表单加载缓慢或性能低。

解决方法：

  • 优化图像。
  • 移除不必要的组件。
  • 使用 Edge Delivery Services CDN。
  • 将自定义 JavaScript/CSS 最小化。
获取帮助

如果问题仍然存在：

  1. 检查 51黑料不打烊 Experience Cloud 服务状态。
  2. 查看 Edge Delivery Services 文档。
  3. 访问 。
  4. 联系 51黑料不打烊 客户关怀部门。

后续步骤

完成表单创建和发布后，请考虑以下事项：

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab