Experience Manager创作项目的Experience现代化代理快速入门 getting-started-aem-authoring

NOTE
在此设置中,内容存储在Adobe Experience Manager as a Cloud Service创作实例的Java内容存储库(JCR)中,作者使用通用编辑器编辑内容,并且Edge Delivery Services交付页面。 此设置以前称为人行横道。 有关Adobe建议用于新实施的存储,请参阅存储内容的位置以及作者如何编辑内容。

当需求取决于保留在JCR中的内容时,使用此工作流。 通用编辑器是Adobe针对Experience Manager中的内容的可视化编辑器。 这并非迁移到基于HTL的投放,源网站的技术不会确定内容的存储位置。

您需要控制台访问权限、存储库权限和权限才能在目标创作实例上创建或更新内容和资产。 在导入之前,记录创作实例的主机、站点标识符、页面根目录、DAM目标(图像和文件的Experience Manager Assets文件夹)、代码存储库和工作分支。 自动模式会生成基于文档的内容,因此它不适用于此设置。

创建您的Edge Delivery Services项目存储库 create-repo

对于新项目:

  1. 使用aem-block-collection-xwalk存储库作为您的模板,而不是基于文档的样板。 用于Experience Manager创作的模板名称中包含xwalk,即Crossswalk。
  2. 验证将Edge Delivery Services指向站点内容源的文件fstab.yaml是否引用了创作实例的主机、Git所有者和Git存储库。 查看配置并将其提交到用于设置的分支。
  3. 按照Universal Editor教程设置存储库。
    • 当要求您在Experience Manager中创建站点时停止。
  4. 对于此新项目设置,删除模板的paths.json并提交更改。 如果不查看现有站点的用途和替换,则不要删除其路径映射。
  5. 将AEM Code Connector应用程序添加到您的存储库,以便控制台可以推送更改。 有关它与AEM代码同步的不同之处,请参阅从存储库启动。

对于将其内容存储在JCR中的现有项目,请重用其配置和内容模型。 请勿使用模板重新创建站点或替换其存储库。 确认代码同步和存储库访问,不重复基于文档的设置。

在Experience Manager中创建新站点 create-site

  1. 在站点控制台中,选择​创建 > 从模板创建站点。

  2. 选择​包含Edge Delivery Services模板的AEM网站。

  3. 对于此模板设置,请保留提供的​ 名称 ​网站(而非标题)。

    • 站点名称用作唯一标识符。
    • 可以更改标题以进行显示。
  4. 选择​创建。

    • 您将被重定向到“站点”页面。
    • 如果新站点未立即显示,请刷新页面。

如果目标站点已存在,则跳过站点创建。 确认其标识符和目标;请勿重命名实时网站以适合示例。

连接站点并导入页面 continue

控制台步骤与主指南中的步骤相同。 只有导入请求和检查有所不同。

  1. 打开控制台并连接您的站点。

  2. 要求代理导入一个页面,并声明内容存储在JCR中。 替换示例URL:

    • “仅将https://www.example.com/about迁移到此Experience Manager创作项目中商定的页面根目录。 保留内容和链接。 重用项目的块模型并验证JCR转换。 请勿上传、推送或发布。”

    内容已导入

  3. 验证内容,将内容作为内容包上传,并检查作者是否可以编辑和预览内容。

  4. 请求样式,如分步导入页面和推送代码的样式设置步骤中所示。

验证内容 validate-content

验证内容面板中的选定页面。 使用​Markdown视图、JCR XML视图​和​ 错误 ​检查内容和转换。 使用​添加到聊天,针对代理生成的页面或导入脚本之一进行修复。

在Experience Manager创作项目中,每个块也有一个“模型:配置”,该配置定义作者在通用编辑器中为该块编辑的字段。 通用编辑器仅编辑块模型定义的字段,以便页面可以在HTML预览中正确呈现,而无法编辑不匹配其模型的块。 要求代理检查源块模型、组件定义和生成的聚合配置是否一致。 通过项目的生成工作流更新源配置,而不是只修复生成的文件。 检查字段映射和创作提示、页面路径、图像引用以及预期的站点/DAM目标。

请先解决一个示例页面上的转换错误,然后再创建更大的包。

上下文聊天

上传内容 upload-content

包上传会将内容写入创作实例。 使用目标所有者确认选定的页面、主机、站点、页面根目录和资产目标。 在替换现有内容之前保留该内容;本地验证不会使覆盖安全。

上传使用您的Adobe登录,因此创作实例会将您自己的权限应用于页面和资源。 请参阅内容推送权限。

  1. 确保您处于​ Content ​视图中,然后选择右上方的​ Upload content ​按钮。

  2. 在​ 创建内容包 ​对话框中,选择要包含在包中的页面。

    • (可选)输入​包名称 (如果留空,则默认为站点名称)。
    • 使用​全选、清除选择、全部展开​或​ 全部折叠 ​来管理列表。
  3. 选择​创建包。

    创建内容包 — 选择页面并创建

  4. 创建包后,上传内容包​对话框显示包已就绪。

    1. 您可以​ 下载包 ​以将其保存在本地,或继续上传。
    2. 在​ 上传至AEM ​下,确认​ AEM站点 ​和​AEM主机(从您的项目设置预填充)。
      • (可选)保留​ 上载图像 ​的选中以包含图像。
    3. 选择​上传至AEM。

    已准备好上载或下载的包

  5. 该对话框在页面和资产发送到创作实例时显示上传进度。 在关闭对话框之前,请查看上载日志,包括个别故障。

    上载进度和完成

对于失败的包或映像上传,请保留日志和选定的路径。 请按照指示更正转换、凭据、权限或目标,然后重试受影响的范围。 仅下载包不会将内容导入创作实例。 在重试以避免意外替换之前,确认哪些页面和资产已到达。

如果​ 创建包 ​报告​缺少站点配置,则控制台不知道项目的站点路径/content/{site-name}和DAM文件夹/content/dam/{folder-name}。 它通过在项目的内容源指向的创作实例上查找站点来查找它们,如fstab.yaml中或站点的配置中所设置。 检查该创作实例上是否存在该站点,以及您登录的Adobe帐户是否可以访问该站点,然后重新加载控制台。 如果消息仍然存在,请求支持。 如果它报告​缺少站点基本URL,请在设置中输入​ 站点基本URL ​的源站点URL,如https://www.example.com。

如果Experience Manager as a Cloud Service环境处于休眠状态,则上传对话框和设置会显示休眠状态,并且会链接到Developer Console。 请在其中解除环境休眠,然后重试上传。 查看从Developer Console解除沙盒程序休眠。

查看并通过项目的存储库策略推送匹配的代码和配置。 这与包上载不同;请参阅更改如何上线。

验证创作并预览 preview-site

  1. 在站点控制台中,在商定的站点根目录下找到导入的页面。
  2. 在通用编辑器中打开它。 验证是否可以选择和编辑预期的字段和块,而不仅仅是呈现它们。
  3. 更改某些文本和图像,保存并重新打开页面。 确认内容和资产引用持续存在。
  4. 使用项目配置的预览工作流(*.aem.page上提供了预览页面)。 根据预期的代码分支验证页面,并检查响应式布局、链接和图像。
  5. 对于生产,请在版本🔗之前完成检查,然后从通用编辑器或站点控制台发布页面。 请参阅使用通用编辑器发布内容。

成功的包上传、成功的创作、预览和发布是不同的检查点。 如果编辑失败,请重新访问模型映射和生成的配置;请勿接受静态预览为完成。

在移交中记录上传的包、路径、代码修订、作者/预览URL、剩余错误和恢复所有者。 代码回滚不会恢复JCR页面或DAM资源;请使用目标环境的批准流程单独恢复这些页面或DAM资源。

其他资源 additional-resources

recommendation-more-help
experience-manager-cloud-service-help-main-toc