此包是为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.analytics-<version>.zip - 包含要存储在存储库中的所有We.Gov Forms Analytics数据。
we-gov-forms.config.public-<version>.zip — 包含所有默认配置节点,包括占位符云配置,以帮助避免表单数据模型和服务绑定问题。
此资源包中包含的资产包括:
本节包含有关安装演示包的信息。
打开 Software Distribution。您需要 Adobe ID 才能登录 Software Distribution。
点按标题菜单中的 Adobe Experience Manager。
在Filters部分中:
点按we-gov-forms.pkg.all-<version>.zip包名称,选择接受EULA条款,然后点按下载。
打开包管理器,并单击上传包以上传包。
选择包并单击Install。
允许完成安装过程。
导航至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文件。
选择“更多”选项。
从下拉菜单中,选择“卸载”选项。
确认后,再次选择“卸载”,并允许完成卸载过程。
本节包含演示包部署后配置的详细信息和说明,然后再进行演示。
导航到https://<aemserver>:<port>/libs/granite/security/content/groupadmin.html
以管理员身份登录以执行以下任务。
向下滚动到页面末尾以加载所有用户组。
搜索“workflow”。
选择“workflow-users”组并单击“属性”。
导航到“成员”选项卡。
在“选择用户或组”字段中键入wegov。
从下拉列表“We.Gov Forms Users”中选择。
单击菜单栏中的“保存并关闭”。
通过搜索“analytics”,选择“Analytics管理员”组,并将“We.Gov Forms用户”组添加为成员,重复步骤2-7。
通过搜索“forms users”,选择“forms-power-users”组,并将“We.Gov Forms用户”组添加为成员,重复步骤2-7。
通过搜索“forms-users”,选择“forms-users”组,并这次将“We.Gov Users”组添加为成员,重复步骤2-7。
查看设置文档配置电子邮件通知
以管理员身份登录以执行此任务。
导航到https://<aemserver>:<port>/system/console/configMgr
找到并单击Day CQ Mail Service服务以进行配置。
配置服务以连接到您选择的SMTP服务器:
单击“保存”以保存配置。
本节包含有关在AEM实例上配置SSL以便能够配置Adobe Sign云配置的详细信息。
引用:
注释:
导航到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云配置的详细信息和说明。
引用:
查看先决条件。 有关所需的SSL配置,请参阅AEM 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/并登录。
从左侧菜单中选择“All Services”。
搜索或导航到“应用程序注册”。
创建或选择现有的应用程序注册。
复制应用程序ID以用作AEM云配置中的OAuth 客户端ID
单击“设置”或“清单”以配置回复URL。
在“设置”视图中,单击“密钥”以查看创建新密钥(这将用作AEM中的客户端密钥)。
要找到资源URL/服务根URL,请导航到MS Dynamics实例功能板。
在顶部导航栏中,单击“销售”或您自己的实例类型,然后单击“选择设置”。
单击右下方附近的“自定义”和“开发人员资源”。
您将在此处找到服务根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服务器才能成功绑定到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框架(Analytics框架)”(请参阅启用AEM创作以启用创作)。
要找到Adobe Analytics帐户的用户凭据,帐户管理员必须执行以下任务。
管理员可以通过执行以下操作,为用户提供AEM分析权限。
导航到Adobe Admin Console。
单击显示到Admin Console的Analytics实例。
选择Analytics完全管理员访问权限。
将用户添加到配置文件。
将用户ID映射到配置文件后,单击权限选项卡。
确保所有权限都已映射到配置文件。
请注意,一旦权限映射到用户登录的功能,则可能需要几个小时。
AEM Forms Analytics数据在离线时可用,或者如果安装了we-gov-forms.ui.analytics-<version>.zip
包,但AEM Sites数据需要活动的云配置,则不使用Adobe Analytics云配置。
导航到https://<aemserver>:<port>/sites.html/content
选择“AEM Forms We.Gov网站”以查看网站页面。
选择一个网站页面(例如主页),然后选择“Analytics & Recommendations”。
在此页面上,您将看到从Adobe Analytics获取的与AEM Sites页面相关的信息(注意:通过设计,此信息会从Adobe Analytics定期刷新,且不会实时显示)。
返回页面查看页面(在步骤3中访问)后,您还可以通过更改显示设置以在“列表视图”中查看项目来查看页面查看信息。
找到“视图”下拉菜单,然后选择“列表视图”。
从同一菜单中,选择“查看设置”,然后从“Analytics”部分选择要显示的列。
单击“更新”以使新列可用。
AEM Forms Analytics数据在离线时可用,或者如果安装了we-gov-forms.ui.analytics-<version>.zip
包,但AEM Sites数据需要活动的云配置,则不使用Adobe Analytics云配置。
导航至
https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
选择“为健康福利申请注册”自适应表单,然后选择“Analytics报表”选项。
等待页面加载,并查看Analytics报表数据。
要使用AdobeForms安装和配置AEM Forms,转换工具用户必须具有以下功能。
访问Adobe I/O。
有权创建与AdobeForms转换服务的集成。
AdobeAEM 6.5以作为作者运行的最新Service Pack。
在阅读进一步说明之前,请查看以下内容:
为了配置服务以与表单转换工具正确通信,用户必须配置Identity Management系统(IMS)服务以能够向Adobe I/O注册。
导航到https://<aemserver>:<port> >单击Adobe Experience
左上角的管理器>工具>安全> 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-themes
单击下一步。
对于此配置,我们将两个复选框值留空。
配置设置完毕后,用户可以通过上传PDF文档对其进行测试。
导航到AEM系统https://<domain_name>:<system_port>
单击Forms > Forms与文档> AEM Forms We.gov Forms > AFC。
选择We.Gov注册应用程序PDF。
单击右上角的开始自动转化按钮。
用户应该能够看到如下所示的选项。
选择按钮后,将向用户显示以下选项
在配置了要使用的所有选项后,选择开始转化。
在转换过程开始时,用户应会看到以下屏幕:
转化完成后,用户将看到以下屏幕:
单击Output文件夹以查看生成的自适应表单。
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站点、自适应表单和交互式通信模板,这些模板由可在以下位置找到的组件创建和组合:
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安装此包后。
包管理器中,用户可以通过导航到Forms > 主题 > 引用主题 > Ultramarine-Accessible来访问AEM Forms中的Ultramarine主题。
用户能够配置各种工作流服务选项,这些选项包括:
要将配置为在工作流中启用,用户需要执行以下任务。
导航到https://'[server]:[port]'/system/console/configMgr。
找到WeGov配置。
打开服务定义,并启用要在工作流中调用的选定服务。
正因为用户在配置管理器页面中启用了服务,用户仍需要设置服务配置才能与请求的外部服务通信。
完成后,单击保存按钮以保存设置。
现在,您已准备好浏览We.Gov引用站点。 有关We.Gov引用站点工作流和步骤的更多信息,请参阅We.Gov引用站点演练。