创建此包的目的是 AEM Forms 6.4 OSGI创作已经过测试,因此在以下平台版本中受支持:
AEM版本 | AEM Forms包版本 | 状态 |
---|---|---|
6.4 | 5.0.86 | 支持 |
6.5 | 6.0.80 | 支持 |
6.5.3 | 6.0.122 | 支持 |
此包包含支持以下平台版本的云配置:
云提供商 | 服务版本 | 状态 |
---|---|---|
Adobe Sign | v5 API | 支持 |
Microsoft® Dynamics 365 | 1710 (9.1.0.3020) | 支持 |
Adobe Analytics | v1.4 Rest API | 支持 |
软件包安装注意事项: |
此 AEM Forms We.Gov演示包 (we-gov-forms.pkg.all-<version>.zip)作为包提供,其中包括多个其他子包和服务。 该软件包包含以下模块:
we-gov-forms.pkg.all-<version>.zip - 完整演示包
we-gov-forms.ui.apps-<version>.zip — 包含所有组件、客户端库、示例用户、工作流模型等。
we-gov-forms.core-<version>.jar - 包含所有OSGI服务、自定义工作流步骤实施等。
we-gov-forms.derby<version>.jar - 包含所有OSGI服务、数据库架构等。
core.wcm.components.all-2.0.4.zip - 示例WCM组件的集合
grid-aem.ui.apps-1.0-SNAPSHOT.zip - 站点页列控件的AEM Sites网格布局包
we-gov-forms.ui.content-<version>.zip - 包含所有内容、页面、图像、表单、交互式通信资源等。
we-gov-forms.ui.ananalytics-<version>.zip - 包含要存储在存储库中的所有We.Gov Forms Analytics数据。
we-gov-forms.config.public-<version>.zip - 包含所有默认配置节点,包括占位符云配置以帮助避免表单数据模型和服务绑定问题。
此包中包含的资源包括:
本节包含有关安装演示软件包的信息。
打开 Software Distribution。您需要 Adobe ID 才能登录 Software Distribution。
点按标题菜单中的 Adobe Experience Manager。
在 筛选器 部分:
点按 we-gov-forms.pkg.all-<version>.zip 包名称,选择 接受EULA条款,然后点按 下载.
打开包管理器,并单击上传包以上传包。
选择资源包并单击 安装.
允许安装过程完成。
导航到 https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled 以确保安装成功。
下载并找到 we-gov-forms.pkg.all-<version>.zip 文件。
导航到 https://<aemserver>:<port>/crx/packmgr/index.jsp.
选择“上传包”选项。
使用文件浏览器导航到下载的ZIP文件并将其选中。
单击“打开”以上传。
上传后,选择“安装”选项以安装包。
允许安装过程完成。
导航到 https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled 以确保安装成功。
要安装新的软件包版本,请按照4.1和4.2中定义的步骤操作。虽然可以在已安装其他旧软件包的同时安装较新的软件包版本,但建议先卸载旧软件包版本。 为此,请执行以下步骤。
导航到 https://<aemserver>:<port>/crx/packmgr/index.jsp
查找旧的 we-gov-forms.pkg.all-<version>.zip 文件。
选择“更多”选项。
从下拉列表中选择“Uninstall”选项。
确认后,再次选择“卸载”,并允许卸载过程完成。
此部分包含有关演示包在演示之前部署后配置的详细信息和说明。
导航到 https://<aemserver>:<port>/libs/granite/security/content/groupadmin.html
以管理员身份登录以执行以下任务。
向下滚动到页面末尾以加载所有用户组。
搜索“”工作流“。
选择"workflow-users组并单击“属性”。
导航到“成员”选项卡。
键入 wegov 在“选择用户或组”字段中。
从下拉列表中选择"We.Gov Forms用户“。
单击菜单栏中的“保存并关闭”。
通过搜索“”重复步骤2至7 分析",选择"Analytics管理员”组,并添加“We.Gov Forms用户”组作为成员。
通过搜索“”重复步骤2至7 表单用户",选择"forms-power-users”组,并添加“We.Gov Forms用户”组作为成员。
通过搜索“”重复步骤2至7 forms-users",选择"forms-users”组,这次添加“We.Gov用户”组作为成员。
查看设置文档 配置电子邮件通知
以管理员身份登录以执行此任务。
导航到 https://<aemserver>:<port>/system/console/configMgr
找到并单击 Day CQ邮件服务 要配置的服务。
配置该服务以连接到您选择的SMTP服务器:
单击“保存”以保存配置。
此部分包含有关在AEM实例上配置SSL以便能够配置Adobe Sign Cloud配置的详细信息。
引用:
注释:
导航到https://<aemserver>:<port>/aem/inbox ,您可以在此处完成上述参考文档链接中说明的过程。
此 we-gov-forms.pkg.all-[version].zip
该软件包包含示例SSL密钥和证书,可通过解压 we-gov-forms.pkg.all-[version].zip/ssl
属于包的文件夹。
SSL证书和密钥详细信息:
私钥是 localhostprivate.der.
证书是 localhost.crt.
单击下一步。
HTTPS主机名应设置为 localhost.
端口应设置为系统已公开的端口。
此部分包含有关Adobe Sign云配置的详细信息和说明。
引用:
查看先决条件。 参见 AEM SSL配置 用于所需的SSL配置。
导航至:
https://<aemserver>:<port>/libs/adobesign/cloudservices/adobesign.html/conf/we-gov
用于访问AEM服务器的URL应与Adobe Sign OAuth重定向URI中配置的URL匹配,以避免配置问题(例如, https://<aemserver>:<port>/mnt/overlay/adobesign/cloudservices/adobesign/properties.html)
选择“We.gov Adobe Sign”配置。
单击“属性”。
导航到“设置”选项卡。
输入oAuth URL,例如: https://secure.na1.echosign.com/public/oauth
提供配置的Adobe Sign实例中的配置客户端ID和客户端密钥。
单击“连接到Adobe Sign”。
成功连接后,单击“保存并关闭”以完成集成。
此部分包含有关MS® Dynamics云配置的详细信息和说明。
引用:
导航至:
https://<aemserver>:<port>/libs/fd/fdm/gui/components/admin/fdmcloudservice/fdm.html/conf/we-gov
选择“Microsoft® Dynamics ODataCloud Service”配置。
单击“属性”。
导航到“身份验证设置”选项卡。
输入以下详细信息:
服务根目录: 例如, https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/
身份验证类型: OAuth 2.0
身份验证设置 (请参阅 MS® Dynamics云配置设置 以收集此信息):
https://msdynamicsserver.api.crm3.dynamics.com
单击“连接到OAuth”。
在成功进行身份验证后,单击“保存并关闭”以完成集成。
包括本节中详述的步骤,以帮助您从MS® Dynamics Cloud实例中查找客户端ID、客户端密钥和详细信息。
导航到 https://portal.azure.com/ 和登录。
从左侧菜单中选择“所有服务”。
搜索或导航到“应用程序注册”。
创建或选择现有的应用程序注册。
复制 应用程序ID 将用作OAuth 客户端ID AEM云配置中的
单击“设置”或“清单”以配置 回复URL。
在“设置”视图中,单击“密钥”以查看新密钥(在AEM中用作客户端密钥)。
要找到资源URL/服务根URL,请导航到MS® Dynamics实例仪表板。
在顶部导航栏中,单击“Sales”或您自己的实例类型和“Select Settings”。
单击右下角附近的“自定义”和“开发人员资源”。
在此,您可以找到服务根URL:例如,
*https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/
有关刷新和访问令牌URL的详细信息,请参阅此处:
https://learn.microsoft.com/en-us/rest/api/datacatalog/authenticate-a-client-app
云配置完成后,您可能需要测试表单数据模型。
导航至
https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov
选择“We.gov Microsoft® Dynamics CRM FDM”并选择“属性”。
导航到“更新源”选项卡。
确保将“上下文感知配置”设置为“/conf/we-gov”,并且配置的数据源为“ms-dynamics-odata-cloud-service”。
编辑表单数据模型。
测试服务以确保它们成功连接到配置的数据源。
测试服务后,单击 取消 以确保非自愿更改不会传播到表单数据模型。
据报告,需要重新启动AEM Server才能成功将数据源绑定到FDM。
云配置完成后,您可能需要测试表单数据模型。
导航到 https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov
选择 We.gov注册FDM 并选择 属性.
导航到 更新源 选项卡。
确保 上下文感知配置 设置为 /conf/we-gov
并且配置的数据源是 We.Gov Derby DS.
选择保存并关闭。
测试服务 以确保它们成功连接到配置的数据源
此部分包含有关Adobe Analytics Cloud配置的详细信息和说明。
引用:
此包预配置为连接到Adobe Analytics。 提供了以下步骤以允许更新此配置。
导航到 https://<aemserver>:<port>/libs/cq/core/content/tools/cloudservices.html
找到Adobe Analytics部分,然后选择“显示配置”链接。
选择“We.Gov Adobe Analytics(Analytics配置)”配置。
单击“编辑”按钮以更新Adobe Analytics配置(您需要提供共享密钥)。 单击“连接到Analytics”进行连接,单击“确定”完成。
如果您要更新框架配置,请在同一页面中单击“We.Gov Adobe Analytics Framework (Analytics Framework)”(请参阅 启用AEM创作 以启用创作)。
要查找帐户管理员必须执行以下任务的Adobe Analytics帐户的用户凭据,请执行以下操作:
管理员可以通过执行以下操作,向用户提供AEM Analytics权限。
导航到Adobe Admin Console。
单击对Admin Console公开的Analytics实例。
选择Analytics完全管理员访问权限。
将用户添加到配置文件。
将用户ID映射到配置文件后,单击权限选项卡。
确保所有权限都映射到配置文件。
一旦映射了权限之后用户登录的功能可能需要几个小时。
AEM Forms Analytics数据在离线时或没有Adobe Analytics Cloud配置的情况下可用,如果 we-gov-forms.ui.analytics-<version>.zip
虽然已安装包,但AEM Sites数据需要活动的cloud配置。
导航到 https://<aemserver>:<port>/sites.html/content
选择“AEM Forms We.Gov网站”以查看网站页面。
选择一个网站页面(例如“主页”),然后选择“Analytics和Recommendations”。
在此页面上,您将看到从Adobe Analytics获取的与AEM Sites页面相关的信息(注意:通过设计,这些信息会定期从Adobe Analytics刷新,并且不会实时显示)。
返回页面查看页面(在步骤3中访问),您还可以通过更改显示设置来查看“列表视图”中的项目来查看页面查看信息。
找到“视图”下拉菜单,然后选择“列表视图”。
从同一菜单中,选择“查看设置”,然后从“Analytics”部分中选择要显示的列。
单击“更新”使新列可用。
AEM Forms Analytics数据在离线时或没有Adobe Analytics Cloud配置的情况下可用,如果 we-gov-forms.ui.analytics-<version>.zip
虽然已安装包,但AEM Sites数据需要活动的cloud配置。
导航至
https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
选择“健康福利注册应用程序”自适应表单,然后选择“Analytics报表”选项。
等待页面加载并查看Analytics报表数据。
要使用AdobeForms安装和配置AEM Forms,转化工具用户必须具备以下条件。
访问Adobe Developer。
创建与AdobeForms转换服务集成的权限。
Adobe以创作方式运行的最新AEM 6.5 Service Pack。
在阅读更多说明之前,请查看以下内容:
为了配置服务以正确与表单转换工具进行通信,用户必须配置Identity Management System (IMS)服务以便能够注册Adobe I/O。
导航到https://<aemserver>:<port> >单击左上方的Adobe Experience Manager >工具>安全> Adobe IMS配置。
单击创建。
执行以下图像中的操作。
确保下载证书。
不要继续进行配置的其余部分 — 查看部分 在Adobe I/O中创建集成
在此部分中创建的证书将用于在Adobe I/O中创建集成服务。一旦用户在集成服务中创建了,用户就可以使用Adobe I/O中的该信息完成配置。
如果不联系系统管理员以创建集成,请确保您能够在Adobe域中创建集成。
导航到 Adobe I/O控制台.
单击创建集成。
选择访问API。
确保您位于正确的组中(右上角的下拉列表)。
在Experience Cloud部分中,选择Forms转换工具。
单击“继续”。
输入集成的名称和描述。
使用第2.1节中的公共密钥可将其置于密钥的集成中。
为您的automated forms conversion选择配置文件。
现在,您已创建集成,接下来让我们完成IMS配置的安装。
单击Adobe I/O中的集成以显示连接详细信息。
导航到AEM中的IMS配置(“工具”>“安全”>“IMS”)
单击IMS配置屏幕上的下一步。
输入授权服务器(屏幕快照中显示的值)。
输入API密钥。
输入客户端密钥(必须单击“在Adobe I/O中集成”上的“公开”才能公开此密钥)。
单击Adobe I/O中的JWT选项卡以获取JWT有效负载并将其粘贴到IMS配置的有效负载中。
创建后,单击IMS配置并选择运行状况检查,用户应会看到以下结果。
IMS配置完成后,您可以继续查看AEM中的云配置。 如果配置不存在,请使用以下步骤在AEM中创建云配置:
打开浏览器并导航到系统URL https://<domain_name>:<system_port>
单击屏幕左上角的Adobe Experience Manager >工具>Cloud Services>自动Forms对话配置。
选择要将配置放置到的配置文件夹。
单击创建。
在下面的屏幕快照中输入信息。
为配置提供标题和名称。
系统的服务URL设置为https://aemformsconversion.adobe.io/。
模板URL /conf/we-gov/settings/wcm/templates/we-gov-flamingo-template.
主题URL: /content/dam/formsanddocuments-themes/adobe-gov-forms-themes/we-gov-theme
单击下一步。
对于此配置,我们将两个复选框值留空。
IMS配置完成后,我们可以继续在AEM中创建云配置。
打开浏览器并导航到系统URL https://<domain_name>:<system_port>
单击屏幕左上角的Adobe Experience Manager >工具>Cloud Services>自动Forms对话配置。
选择要将配置放置到的配置文件夹。
单击创建。
在下面的屏幕快照中输入信息。
为配置提供标题和名称。
系统的服务URL设置为https://aemformsconversion.adobe.io/
模板URL: /conf/we-finance/settings/wcm/templates/we-finance-adaptive-form
主题URL: /content/dam/formsanddocuments-themes/adobe-finance-forms-themes/we-finance-theme
单击下一步。
对于此配置,我们将两个复选框值留空。
设置配置后,用户可以通过上传PDF文档对其进行测试。
导航到AEM系统https://<domain_name>:<system_port>
单击Forms > Forms & Documents > AEM Forms We.gov Forms > AFC。
选择We.Gov注册申请PDF。
单击 启动自动转换 在右上角。
用户应该能够看到如下所示的选项。
选择按钮后,将为用户显示以下选项
配置要使用的全部选项后,选择开始转换。
转换过程开始时,用户应会看到以下屏幕:
转换完成后,用户将看到以下屏幕:
单击 输出 文件夹以查看生成的自适应表单。
automated forms conversion服务包括 最佳实践,已知的复杂模式、和 已知问题. 在开始使用AEM FormsAutomated forms conversion服务之前,请查看这些内容。
如果要在转换后将表单绑定到FDM,请生成表单并生成自适应表单,但不启用数据绑定。
确保模板文件夹已启用jcr:read for everyone权限,否则服务用户将无法从存储库中读取模板,并且转换将失败。
此部分包含有关自定义演示的说明。
可在以下位置找到可编辑的模板:
https://<aemserver>:<port>/libs/wcm/core/content/sites/templates.html/conf/we-gov
这些模板包括AEM Site、自适应表单和交互式通信模板,这些模板是使用可以在以下位置找到的组件创建和组装的:
https://<aemserver>:<port>/crx/de/index.jsp#/apps/we-gov/components
此站点还具有客户端库,其中一个客户端库导入Bootstrap4 ( https://getbootstrap.com/ )。 此客户端库位于
https://<aemserver>:<port>/crx/de/index.jsp#/apps/we-gov/clientlibs/clientlib-base/css/bootstrap
此包中包含的可编辑模板也预配置了template/page策略,这些策略使用Bootstrap4 CSS类进行分页、样式设置等。 并非所有类都已添加到模板策略中,但可以将Bootstrap4支持的任何类添加到策略中。 有关可用类的列表,请参阅入门页面:
https://getbootstrap.com/docs/4.1/getting-started/introduction/
此软件包中包含的模板还支持样式系统:
项目DAM资产还包含We.Gov徽标和图像。 这些资产位于:
https://<aemserver>:<port>/assets.html/content/dam/we-gov
在编辑页面和表单模板时,您可以选择通过编辑导航和页脚组件来更新品牌徽标。 这些组件提供了一个可用于更新徽标的可配置品牌和徽标对话框:
有关更多信息,请参阅编辑页面内容:
所有网站页面均可从以下位置访问: https://<aemserver>:<port>/sites.html/content/we-gov
这些站点页面还使用AEM Grid包来控制几个组件的布局。
此包中包含的页面还支持样式系统:
您还可以参阅 模板自定义样式系统 有关支持的样式的文档。
所有自适应表单均可从以下位置获取:
https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
这些表单可定制以适合特定用例。 不应修改某些字段和提交逻辑以确保表单继续正常运行。 这包括:
健康福利登记申请:
自适应表单也可以使用样式编辑器或主题编辑器设置样式:
注册自适应表单提交到OSGI工作流以供处理。 此工作流可在以下位置找到: https://<aemserver>:<port>/conf/we-gov/settings/models/we-gov-process.html.
由于某些限制,此工作流包含多个脚本和自定义OSGI工作流流程步骤。 这些工作流步骤是作为通用步骤创建的,尚未通过配置对话框创建。 目前,工作流步骤的配置依赖于进程参数。
所有工作流步骤Java™代码都包含在 we-gov-forms.core-<version>.jar 捆绑。
本节包含有关演示功能和设计决策的信息,在演示过程中可能需要特别考虑这些功能和决策。
要执行辅助功能测试,请安装此处提供的Chrome插件 https://chrome.google.com/webstore/detail/accessibility-developer-t/fpkknkljclfencbdbgkenhalefipecmb?hl=en
.
安装后,在Chrome浏览器中加载要测试的页面(注意:打开多个选项卡可能会影响您的得分,最好只打开一个选项卡)。 加载页面后, 右键单击 ,然后选择 审核 选项卡。 开发人员可以选择要由辅助功能插件执行的审核类型。 选择所有需要的选项后,用户可以单击“生成报告”按钮。 这将生成一个PDF文档,其中显示整体无障碍等级以及可用于提高整体无障碍等级的内容。
运行报告后,用户可能会看到以下内容:
显示在用户面前的数字是他们已获得的总体无障碍评级。 此外,还提供了有关如何在分数后计算此值的描述。
如果用户要导出此内容,可以单击屏幕右侧的三个按钮,然后从插件提供的其他选项中进行选择。
由Adobe维护的公开的超海洋主题内置于
we-gov-forms.pkg.all-<version>.zip
可安装的ZIP文件。 使用CRX安装此软件包后。
AEM Forms包管理器,用户可以通过导航到 Forms > 主题 > 引用主题 > 超便携无障碍.
用户能够配置各种工作流服务选项,其中包括:
要将它们配置为在工作流中启用,用户必须执行以下任务。
导航到https://'[服务器]:[端口]'/system/console/configMgr.
找到 WeGov配置.
打开服务定义,并在工作流中调用选定的服务。
仅仅因为用户在Configuration Manager页面中启用该服务,用户仍需要设置服务配置才能与请求的外部服务进行通信。
完成后,单击保存以保存设置。
现在,您已准备好探索We.Gov引用站点。 有关We.Gov引用站点工作流和步骤的更多信息,请参阅 We.Gov引用站点演练.