此套件是為AEM Forms 6.4 OSGI Author建立,已經過測試,因此支援下列平台版本:
AEM版本 | AEM FORMS.套件版本 | 狀態 |
---|---|---|
6.4 | 五點〇點八六 | 支援 |
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 demo套件(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 Grid版面套件的「網站」頁面欄控制
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 -包含所有預設組態節點,包括預留位置雲端組態,以協助避免表單資料模型和服務系結問題。
此套件包含的資產包括:
本節包含有關安裝演示軟體包的資訊。
開啟軟體分發。 您必須有Adobe ID才能登入「軟體散發」。
點選頁首功能表中的「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」中選取。
按一下功能表列中的「儲存並關閉」。
重複步驟2-7,方法是搜尋「analytics」,選取「Analytics管理員」群組,並新增「We.Gov Forms使用者」群組作為成員。
通過搜索「forms users」、選擇「forms-power-users」組,並添加「We.Gov Forms Users」組作為成員,重複步驟2-7。
重複步驟2-7,方法是搜尋「forms-users」,選取「forms-users」群組,並新增「We.Gov Users」群組作為成員。
查看設定文檔配置電子郵件通知
以管理員身份登錄以執行此任務。
導覽至https://<aemserver>:<port>/system/console/configMgr
找到並按一下Day CQ Mail Service服務進行配置。
配置服務以連接到您選擇的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 Cloud設定的詳細資訊和指示。
引用:
檢閱必要條件。 如需必要的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 Cloud配置的詳細資訊和說明。
引用:
導航到:
https://<aemserver>:<port>/libs/fd/fdm/gui/components/admin/fdmcloudservice/fdm.html/conf/we-gov
選擇「Microsoft Dynamics OData Cloud服務」配置。
按一下「屬性」。
導覽至「驗證設定」標籤。
輸入以下詳細資訊:
服務根: 例如https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/
驗證類型: OAuth 2.0
驗證設定 (請參 閱MS Dynamics Cloud組態設 定以收集此資訊):
按一下「連線至OAuth」。
成功驗證後,按一下「儲存並關閉」以完成整合。
本節詳述的步驟可協助您從MS Dynamics Cloud例項中找出用戶端ID、用戶端密碼和詳細資訊。
導覽至https://portal.azure.com/並登入。
從左側功能表中選擇「所有服務」。
搜尋或導覽至「應用程式註冊」。
建立或選擇現有應用程式註冊。
複製應用程式ID,以用作AEM雲端設定中的OAuth 用戶端ID
按一下「設定」或「資訊清單」以設定回覆URL。
在「設定」檢視中,按一下「金鑰」以檢視建立新金鑰(這會用作AEM中的「用戶端密碼」)。
要找到資源URL/服務根URL,請導航到MS Dynamics實例儀表板。
在頂端導覽列中,按一下「銷售」或您自己的例項類型,然後按一下「選取設定」。
按一下右下角的「自訂」和「開發人員資源」。
您會在那裡找到服務根URL:e.g
https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/
有關重新整理和存取Token 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」。
編輯表單資料模型。
測試服務,以確保它們成功連接到已配置的資料源。
在測試服務後,按一下Cancel以確保非自願更改不會傳播到表單資料模型。
已報告資料來源必須重新啟動AEM伺服器才能成功系結至FDM。
雲端設定完成後,您可能會想要測試表單資料模型。
導覽至https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov
選擇We.gov Enrollment 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分析權限。
導覽至Adobe Admin Console。
按一下「管理控制台」所公開的Analytics例項。
選取「Analytics完整管理員存取權」。
新增使用者至描述檔。
將使用者ID對應至描述檔後,按一下「權限」標籤。
請確定所有權限都已映射至描述檔。
請注意,一旦對權限進行對應,使用者登入的功能可能需要數小時。
AEM Forms Analytics資料在離線時可用,如果已安裝we-gov-forms.ui.analytics-<version>.zip
套件,則無需Adobe Analytics雲端設定,但AEM Sites資料需要作用中的雲端設定。
導覽至https://<aemserver>:<port>/sites.html/content
選取「AEM Forms We.Gov網站」以檢視網站頁面。
選取其中一個網站頁面(例如首頁),然後選擇「Analytics & Recommendations」。
在此頁面上,您會看到從Adobe Analytics擷取的與AEM Sites頁面相關的資訊(注意:設計時,會定期從Adobe Analytics重新整理此資訊,而不會即時顯示)。
回到頁面檢視頁面(在步驟3.中存取),您也可以變更顯示設定以檢視「清單檢視」中的項目,來檢視頁面檢視資訊。
找到「View」(檢視)下拉式功能表,並選取「List View」(清單檢視)。
從相同功能表中,選取「檢視設定」,並從「Analytics」區段中選取您要顯示的欄。
按一下「更新」,讓新欄可供使用。
AEM Forms Analytics資料在離線時可用,如果已安裝we-gov-forms.ui.analytics-<version>.zip
套件,則無需Adobe Analytics雲端設定,但AEM Sites資料需要作用中的雲端設定。
導航到
https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
選擇「健康福利的註冊申請」調適性表單,並選取「Analytics報表」選項。
等待頁面載入,並檢視Analytics報表資料。
若要安裝並設定AEM Forms與Adobe Forms,轉換工具使用者必須具備下列功能。
存取Adobe I/O。
建立與Adobe Forms轉換服務整合的權限。
以「作者」身分執行的Adobe AEM 6.5最新Service Pack。
閱讀進一步指示前,請先閱讀以下內容:
為了設定服務以正確與表單轉換工具通訊,使用者必須設定身分管理系統(IMS)服務,才能向Adobe I/O註冊。
導覽至https://<aemserver>:<port> >按一下Adobe Experience
左上角的管理員>工具>安全性> Adobe IMS設定。
按一下建立。
執行下圖中的動作。
請確定下載憑證。
本節中建立的憑證將用於在Adobe I/O中建立整合服務。使用者在整合服務中建立後,使用者就可以使用Adobe I/O中的資訊來完成設定。
如果您未聯絡系統管理員以建立Adobe網域內的整合,請確定您有能力。
按一下建立整合項目。
選取「存取API」。
請確定您位在正確的群組中(右上方下拉式清單)。
在Experience Cloud區段中,選取「表單轉換工具」。
按一下「繼續」。
輸入整合的名稱和說明。
使用第2.1節的公開金鑰,將其放入金鑰的整合中。
為自動化表單轉換選取描述檔。
現在您已建立整合,讓我們完成IMS組態的安裝。
按一下您在Adobe I/O中的整合,以公開連線詳細資訊。
導覽至AEM中的IMS設定(「工具>安全性> IMS」)
按一下「IMS設定」畫面上的「下一步」。
輸入授權伺服器(螢幕擷取中顯示的值)。
輸入API金鑰。
輸入用戶端密碼(必須按一下Adobe I/O中的「公開」,才能公開)。
按一下Adobe I/O中的JWT標籤,以取得JWT裝載並貼入IMS設定的裝載中。
建立後,按一下「IMS設定」並選取「Health Check」(健康檢查),使用者應該會看到下列結果。
IMS設定完成後,我們就可以繼續在AEM中檢視雲端設定。 如果此設定不存在,請使用下列步驟在AEM中建立雲端設定:
開啟瀏覽器並導覽至系統URL https://<domain_name>:<system_port>
按一下畫面左上角的Adobe Experience Manager >工具>雲端服務>自動化表單對話設定。
選擇要將配置放入的配置資料夾。
按一下建立。
在下方的螢幕擷取中輸入資訊。
提供設定標題和名稱。
系統的服務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-themes
按一下下一步。
對於此配置,我們將兩個複選框值留空。
一旦IMS設定完成,我們就可以繼續在AEM中建立雲端設定。
開啟瀏覽器並導覽至系統URL https://<domain_name>:<system_port>
按一下畫面左上角的Adobe Experience Manager >工具>雲端服務>自動化表單對話設定。
選擇要將配置放入的配置資料夾。
按一下建立。
在下方的螢幕擷取中輸入資訊。
提供設定標題和名稱。
系統的服務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/theme
按一下下一步。
對於此配置,我們將兩個複選框值留空。
設定好設定後,使用者就可以上傳PDF檔案來測試它。
導覽至AEM系統https://<domain_name>:<system_port>
按一下「表單>表單與檔案> AEM Forms We.gov表單> AFC」。
選取We.Gov註冊應用程式PDF。
按一下右上角的啟動自動轉換按鈕。
使用者應能看到下列選項。
選取按鈕後,使用者將會看到下列選項
在您設定了所有要使用的選項後,選取開始轉換。
當轉換程式開始時,使用者應看到下列畫面:
轉換完成後,使用者會看到下列畫面:
按一下Output資料夾以查看生成的自適應表單。
自動表單轉換服務包含某些最佳實踐、已知複雜模式和已知問題。 在您開始使用AEM Forms Automated 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
此站點還具有client-libraries,其中一個庫將導入引導4(https://getbootstrap.com/)。 此客戶端庫可在
https://<aemserver>:<port>/crx/de/index.jsp#/apps/we-gov/clientlibs/clientlib-base/css/bootstrap
此套件中包含的可編輯範本也預先設定了範本/頁面原則,這些原則使用Bootstrap 4 CSS類別進行分頁、樣式等。 並非所有類都已添加到模板策略中,但可以將引導4支援的任何類添加到策略中。 如需可用類別的清單,請參閱快速入門頁面:
https://getbootstrap.com/docs/4.1/getting-started/introduction/
此套件中包含的範本也支援樣式系統:
Project DAM Assets也包含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瀏覽器中測試的頁面(注意:開啟多個標籤可能會影響您的分數,但最好是只開啟一個標籤)。 載入頁面後
按一下右鍵頁面上的並選擇Audits頁籤。 開發人員可以選擇由協助工具外掛程式執行的稽核類型。 在選取所有所需選項後,使用者就可以選取「產生報表」按鈕。 這將產生PDF檔案,其中顯示整體協助工具評等,以及可用來提高整體協助工具評等的內容。
報表一經執行,使用者就會看到下列內容:
使用者面前顯示的數字是他們取得的整體協助工具分級。 此外,還說明如何在分數之後計算此值。
如果使用者想要匯出此功能,可以按一下畫面右側的三個按鈕,並從外掛程式提供的其他選項中選取。
Adobe維護的公開Ultramarine主題內建於
we-gov-forms.pkg.all-<version>.zip
可安裝的ZIP檔案。 使用CRX安裝此軟體包後。
Package Manager,使用者可導覽至Forms > Themes > Reference Themes > Ultramarine-Accessible,以存取AEM Forms中的Ultramarine主題。
使用者可以設定各種工作流程服務選項,其中包括:
為了在「工作流」中將其配置為啟用,用戶需要執行以下任務。
導覽至https://'[server]:[port]'/system/console/configMgr。
找到WeGov配置。
開啟服務定義,並啟用選定服務以在工作流中調用。
僅僅因為用戶在「配置管理器」(Configuration Manager)頁中啟用了服務,用戶仍需設定服務配置以便與請求的外部服務通信。
完成後,按一下「保存」按鈕以保存設定。
現在,大家都準備去探索We.Gov參考網站。 如需We.Gov參考網站工作流程和步驟的詳細資訊,請參閱We.Gov參考網站逐步說明。