创建此包的目的是 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://docs.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云配置的情况下可用,如果 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云配置的情况下可用,如果 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 I/O访问权限。
创建与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
此包中包含的可编辑模板也预配置了模板/页面策略,这些策略使用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插件,该工具位于 此处.
安装后,在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引用站点演练.