此封裝是為以下專案建立的: 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。
在 篩選器 區段:
點選 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 檔案。
選取「更多」選項。
從下拉式清單中選取「解除安裝」選項。
確認後,再次選取「解除安裝」,並允許解除安裝程式完成。
本節包含簡報前示範套件的部署後設定的詳細資訊和指示。
導覽至 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雲端設定的詳細資訊。
引用:
附註:
導覽至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執行個體控制面板。
在頂端導覽列中,按一下「銷售」或您自己的執行個體型別和「選取設定」。
按一下右下角附近的「自訂」和「開發人員資源」。
您會在此找到服務根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 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資料需要主動式雲端設定。
導覽至 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資料需要主動式雲端設定。
瀏覽到
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 ,否則服務使用者將無法從存放庫讀取範本,且轉換將失敗。
本節包含示範自訂的相關指示。
可在以下位置找到可編輯的範本:
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外掛程式: https://chrome.google.com/webstore/detail/accessibility-developer-t/fpkknkljclfencbdbgkenhalefipecmb?hl=en
.
安裝後,在Chrome瀏覽器中載入您要測試的頁面(注意:開啟多個分頁可能會影響您的分數,最好只開啟一個分頁)。 載入頁面後
按一下右鍵 ,並選取 稽核 索引標籤。 開發人員可以選取協助工具外掛程式要執行的稽核型別。 選取所有需要的選項後,使用者可以按一下產生報告按鈕。 這會產生PDF檔案,顯示整體協助工具評等,以及可用來提升整體協助工具評等的專案。
執行報表後,使用者可能會看到下列內容:
顯示在使用者前面的數字是他們已獲得的整體協助工具評等。 此外也提供在評分之後如何計算此值的說明。
如果使用者想要匯出此內容,可以按一下畫面右側的三個按鈕,然後從外掛程式提供的其他選項中選取。
由Adobe維護的公開可用的Ultraminary主題內建在
we-gov-forms.pkg.all-<version>.zip
可安裝的ZIP檔案。 使用CRX安裝此套件後。
Package Manager,使用者可透過導覽至「 」存取AEM Forms中的Ultramine主題 Forms > 主題 > 參考主題 > 超便攜無障礙.
使用者可以設定各種工作流程服務選項,包括下列各項:
若要將其設定為在工作流程中啟用,使用者需要執行下列任務。
導覽至https://'[伺服器]:[連線埠]'/system/console/configMgr.
找到 WeGov設定.
開啟服務定義,並啟用在工作流程中叫用的選定服務。
僅僅因為使用者在Configuration Manager頁面中啟用服務,使用者仍需設定服務組態,才能與要求的外部服務通訊。
完成後,按一下「儲存」按鈕以儲存設定。
現在您已準備就緒,可探索We.Gov參考網站。 如需We.Gov參考網站工作流程和步驟的詳細資訊,請參閱 We.Gov參考網站逐步說明.