Show Menu
主題×

設定和設定We.Gov參考網站

示範套件詳細資訊

安裝先決條件

此套件是為 AEM Forms 6.4 OSGI Author (已測試)建立,因此支援下列平台版本:
AEM版本
AEM FORMS.套件版本
狀態
6.4
5.0.86
支援
6.5
6.0.80
支援
此套件包含支援下列平台版本的雲端設定:
雲端供應商
服務版本
狀態
Adobe Sign
v5 API
支援
Microsoft Dynamics 365
1710 (9.1.0.3020)
支援
軟體包安裝注意事項:
  • 此套件預計會安裝在乾淨的伺服器上,不需要其他示範套件或舊版示範套件版本
  • 此套件預計會安裝在OSGI伺服器上,在「作者」模式中執行

此包包含什麼

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服務、自訂工作流程步驟實作等。
      • 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.config.public-<version>.zip *—— 包含所有預設組態節點,包括預留位置雲端組態,以協助避免表單資料模型和服務系結問題。*
此套件包含的資產包括:
  • 含可編輯範本的AEM網站頁面
  • AEM Forms Adaptive Forms
  • AEM Forms互動式通訊(列印和網路頻道)
  • AEM Forms XDP記錄檔案
  • AEM Forms MS Dynamics Forms資料模型
  • Adobe Sign整合
  • AEM Workflow Model
  • AEM Assets範例影像

設定選項

本節包含有關配置選項的詳細資訊。 目前,此區段是故意空的。

示範套件安裝

本節包含有關安裝演示軟體包的資訊。

從包共用

  1. 導覽至 https://<aemserver>:<port>/crx/packageshare/
    或在AEM中,按一下「部署」並導覽至「封裝共用圖示」。
  2. 使用您的Adobe ID登入。
  3. 搜尋並找 到we-gov-forms.pkg.all-<version>套件
  4. 選取「下載」選項並接受條款與條件。
  5. 下載後,選擇「已下載」選項,在「套件管理器」中找到套件。
  6. 選擇「安裝」選項以安裝軟體包。
  7. 允許完成安裝程式。
  8. 導覽至 https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled ,以確保安裝成功。

從本機ZIP檔案

  1. 下載並找 到we-gov-forms.pkg.all-<version>.zip檔
  2. 導覽至 https://<aemserver>:<port>/crx/packmgr/index.jsp
  3. 選擇「上傳套件」選項。
  4. 使用檔案瀏覽器導覽並選取下載的ZIP檔案。
  5. 按一下「開啟」以上傳。
  6. 上載後,選擇「安裝」選項以安裝軟體包。
  7. 允許完成安裝程式。
  8. 導覽至 https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled ,以確保安裝成功。

安裝新的軟體包版本

要安裝新軟體包版本,請遵循4.1和4.2中定義的步驟。在已安裝其他較舊軟體包的情況下安裝較新軟體包版本是可行的,但建議先卸載較舊軟體包版本。 若要這麼做,請遵循下列步驟。
  1. 導覽至 https://<aemserver>:<port>/crx/packmgr/index.jsp
  2. 找到 較舊的we-gov-forms.pkg.all-<version>.zip 檔案。
  3. 選擇「更多」選項。
  4. 從下拉式清單中,選取「解除安裝」選項。
  5. 確認後,請再次選擇「解除安裝」,並允許完成解除安裝程式。

示範套件設定

本節包含演示軟體包部署後配置的詳細資訊和說明,然後再演示。

虛構用戶配置

  1. 導覽至 https://<aemserver>:<port>/libs/granite/security/content/groupadmin.html
  2. 搜尋「工​ 作流程 」。
  3. 選取「 workflow-users 」群組,然後按一下「屬性」。
  4. 導覽至「成員」標籤。
  5. 在「選 取使用者 或群組」欄位中輸入wegov。
  6. 從下拉式清單「 We.Gov Form Users 」中選取。
  7. 按一下功能表列中的「儲存並關閉」。
  8. 重複步驟2-7:搜尋「 analytics 」、選取「 Analytics Administrators 」群組,並新增「 We.Gov Form Users 」群組為成員。
  9. 重複步驟2-7:搜尋「 forms users 」、選取「 forms-power-users 」群組,並新增「 We.Gov Form Users 」群組為成員。
  10. 重複步驟2-7:搜尋「 forms users 」、選取「 forms-users 」群組,並新增「 We.Gov Users 」群組為成員。

電子郵件伺服器組態

  1. 檢閱設定檔案 設定電子郵件通知
  2. 導覽至 https://<aemserver>:<port>/system/console/configMgr
  3. 找到並按一下「 Day CQ Mail Service (日CQ郵件服務)」服務進行配置。
  4. 配置服務以連接到您選擇的SMTP伺服器:
    1. SMTP伺服器主機名 :例如(smtp.gmail.com)
    2. 伺服器埠 :例如(465)使用SSL的gmail
    3. SMTP用戶: demo@ <companyname>.com
    4. 「寄件者」地址 : aemformsdemo@adobe.com
  5. 按一下「保存」保存配置。

AEM SSL設定

本節包含在AEM例項上設定SSL以便能夠設定Adobe Sign Cloud設定的詳細資訊。
引用:
附註:
  1. 導覽至https://<aemserver>:<port>/aem/inbox,您將可在此處完成上述參考檔案連結中說明的程式。
  2. we-gov-forms.pkg.all-<version>.zip 套件包含範例SSL金鑰和憑證,可透過解壓縮屬於套件一部分的 we-gov-forms.pkg.all-<version>.zip/ssl 資料夾來存取。
  3. SSL憑證和金鑰詳細資訊:
    1. 發佈至"CN=localhost"
    2. 10年有效期
    3. 密碼值為"password"

Adobe Sign cloud configuration

本節包含Adobe Sign Cloud設定的詳細資訊和指示。
引用:

Cloud configuration

  1. 檢閱必要條件。 請參 閱AEM SSL設定 ,以取得必要的SSL設定。
  2. 導航到:
    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 )
  3. 選取「We.gov Adobe Sign」組態。
  4. 按一下「屬性」。
  5. 導覽至「設定」標籤。
  6. 從已設定的Adobe Sign例項提供已設定的用戶端ID和用戶端密碼。
  7. 按一下「連線至Adobe Sign」。
  8. 成功連線後,按一下「儲存並關閉」以完成整合。

MS Dynamics雲端組態

本節包含有關MS Dynamics Cloud配置的詳細資訊和說明。
引用:

MS Dynamics OData雲端服務

  1. 導航到:
    https://<aemserver>:<port>/libs/fd/fdm/gui/components/admin/fdmcloudservice/fdm.html/conf/we-gov
    1. 請確定您使用與MS Dynamics應用程式註冊中設定的相同重新導向URL來存取伺服器。
  2. 選擇「Microsoft Dynamics OData Cloud服務」配置。
  3. 按一下「屬性」。
  4. 導覽至「驗證設定」標籤。
  5. 輸入以下詳細資訊:
    1. 服務根: 例如https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/
    2. 驗證類型: OAuth 2.0
    3. 驗證設定 (請參 閱MS Dynamics Cloud組態設定 ,以收集此資訊):
      1. 用戶端ID —— 也稱為應用程式ID
      2. 用戶端密碼
      3. 重新整理Token URL —— 例如 https://login.windows.net/common/oauth2/token
      4. 授權範圍- openid
      5. 驗證頭——授 權載體
    4. 按一下「連線至OAuth」。
  6. 成功驗證後,按一下「儲存並關閉」以完成整合。

MS Dynamics雲端組態設定

本節中詳細說明的步驟可協助您從MS Dynamics Cloud例項中找出用戶端ID、用戶端密碼和詳細資訊。
  1. 導覽至 https://portal.azure.com/ 並登入。
  2. 從左側功能表中選擇「所有服務」。
  3. 搜尋或導覽至「應用程式註冊」。
  4. 建立或選擇現有應用程式註冊。
  5. 複製 應用程式ID ,以便在AEM雲端設定中 當做OAuth用戶端 Id使用
  6. 按一下「設定」或「資訊清單」以設定回 覆URL。
    1. 此URL必須符合設定OData服務時用來存取AEM伺服器的URL。
  7. 在「設定」檢視中,按一下「金鑰」以檢視建立新金鑰(這會用作AEM中的「用戶端密碼」)。
    1. 請務必保留金鑰副本,因為您以後無法在Azure或AEM中檢視它。
  8. 要找到資源URL/服務根URL,請導航到MS Dynamics實例儀表板。
  9. 在頂端導覽列中,按一下「銷售」或您自己的例項類型,然後按一下「選取設定」。
  10. 按一下右下角的「自訂」和「開發人員資源」。
  11. 您會在那裡找到服務根URL:e.g
  12. 有關重新整理和存取Token URL的詳細資訊,請參閱:

測試表單資料模型

雲端設定完成後,您可能會想要測試表單資料模型。
  1. 導航到
    https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov
  2. 選擇「We.gov Microsoft Dynamics CRM FDM」,然後選擇「屬性」。
  3. 導覽至「更新來源」標籤。
  4. 確保「上下文感知配置」設定為「/conf/we-gov」,並確保配置的資料源為「ms-dynamics-odata-cloud-service」。
  5. 編輯表單資料模型。
    請確定您按一下「 取消 」,而 非「儲存並關閉 」,以避免需要重新安裝的問題。
  6. 測試服務,以確保它們成功連接到已配置的資料源。
    已報告資料來源必須重新啟動AEM伺服器才能成功系結至FDM。

Adobe Analytics configuration

本節包含Adobe Analytics Cloud設定的詳細資訊和指示。
引用:

Adobe Analytics雲端服務設定

此套件已預先設定為連線至Adobe Analytics。 提供下列步驟,以允許更新此配置。
  1. 導覽至 https://<aemserver>:<port>/libs/cq/core/content/tools/cloudservices.html
  2. 找到Adobe Analytics區段,並選取「顯示設定」連結。
  3. 選取「We.Gov Adobe Analytics(Analytics設定)」設定。
  4. 按一下「編輯」按鈕以更新Adobe Analytics設定(您必須提供共用密碼)。 按一下「連線至Analytics」以連線,然後按一下「確定」以完成。
  5. 如果您想要更新架構設定,請在同一頁按一下「We.Gov Adobe Analytics Framework(Analytics Framework)」(請參閱「 Enable AEM authoring to enable Authoring」)。

Adobe Analytics報表

檢視Adobe Analytics網站報告

  1. 導覽至 https://<aemserver>:<port>/sites.html/content
  2. 選取「AEM Forms We.Gov網站」以檢視網站頁面。
  3. 選取其中一個網站頁面(例如首頁),然後選擇「Analytics & Recommendations」。
  4. 在此頁面上,您會看到從Adobe Analytics擷取的與AEM Sites頁面相關的資訊(注意:設計時,會定期從Adobe Analytics重新整理此資訊,而不會即時顯示)。
  5. 返回頁面檢視頁面(在步驟3中存取)時,您也可以變更顯示設定,以檢視「清單檢視」中的項目,以檢視頁面檢視資訊。
  6. 找到「View」(檢視)下拉式功能表,並選取「List View」(清單檢視)。
  7. 從相同功能表中,選取「檢視設定」,並從「Analytics」區段中選取您要顯示的欄。
  8. 按一下「更新」,讓新欄可供使用。

檢視Adobe Analytics表格報表

  1. 導航到
    https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
  2. 選擇「健康福利的註冊申請」調適性表單,並選取「Analytics報表」選項。
  3. 等待頁面載入,並檢視Analytics報表資料。

檢視Adobe Analytics報表

或者,您也可以直接導覽至Adobe Analytics,以查看分析資料。
  1. 使用您的認證登入:
    1. 公司: AEM Forms示範
    2. 使用者: <available on request>
    3. 密碼: <available on request>
  2. 從報表套裝中選取「We.Gov參考網站」。
  3. 選取其中一個可用報表以顯示該報表的分析資料。

示範套件自訂

本節包含自訂示範的指示。

啟用AEM編寫

此示範套件包含OSGI服務設定檔,可控制目標Author伺服器上WCM Filter服務的行為。 此配置使伺服器在禁用的作者模式下運行(相當於?wcmmode=disabled),以允許演示。 要更新此配置並啟用編寫,請執行以下步驟:
  1. 導覽至 https://<aemserver>:<port>/system/console/configMgr
  2. 找到並按一下 Day CQ WCM Filter Service以進行設定。
  3. 將" WCM Mode "的值設為" Edit "。
  4. 按一下「 儲存 」以套用設定。

範本自訂

可編輯的範本位於下列位置:
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

Style system

此網站也提供client-libraries,其中一個會匯入Bootstrap 4( https://getbootstrap.com/ )。 此客戶端庫可在
https://<aemserver>:<port>/crx/de/index.jsp#/apps/we-gov/clientlibs/clientlib-base/css/bootstrap
此套件中包含的可編輯範本也預先設定了範本/頁面原則,這些原則使用Bootstrap 4 CSS類別進行分頁、樣式等。 並非所有類都已添加到模板策略中,但可以將引導4支援的任何類添加到策略中。 如需可用類別的清單,請參閱快速入門頁面:
此套件中包含的範本也支援樣式系統:

範本標誌

Project DAM Assets也包含We.Gov標誌和影像。 這些資產可在以下網址取得:
https://<aemserver>:<port>/assets.html/content/dam/we-gov
在編輯頁面和表單範本時,您可以選擇編輯導覽和頁尾元件以更新品牌標誌。 這些元件提供可設定的品牌和標誌對話方塊,可用來更新標誌:
如需詳細資訊,請參閱編輯頁面內容:

自訂網站頁面

所有網站頁面皆可從以下網站取得: https://<aemserver>:<port>/sites.html/content/we-gov
這些網站頁面也運用AEM Grid套件來控制一些元件的版面配置。

Style system

此套件中包含的頁面也支援樣式系統:
您也可以參閱範本自 訂樣式系統 ,以取得支援樣式的說明檔案。

最適化表單自訂

所有可調式表單皆可從以下網站取得:
https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
您可自訂這些表格,以符合特定使用案例。 請注意,不應修改某些欄位和提交邏輯,以確保表單繼續正常運作。 這包括:
健康福利註冊申請:
  • contact_id —— 用於在提交期間接收MS Dynamics聯繫人ID的隱藏欄位
  • 提交——需要自訂提交按鈕邏輯以支援回呼。 自訂是有記載的,但是在透過表單資料模型對MS Dynamics執行POST和GET作業時,需要使用大型指令碼來提交表單。
  • 根面板——初始化事件可用來以最不干擾的方式將MS Dynamics按鈕新增至AEM Inbox,因為所有AEM Inbox Granite UI元件都不可修改。

最適化表單樣式

您也可以使用樣式編輯器或主題編輯器來設定最適化表單的樣式:

工作流程自訂

「註冊最適化表單」會提交至OSGI工作流程以進行處理。 此工作流程可在 https://<aemserver>:<port>/conf/we-gov/settings/models/we-gov-process.html找到
由於某些限制,此工作流程包含數個指令碼和自訂OSGI工作流程程式步驟。 這些工作流程步驟已建立為一般步驟,而且尚未使用設定對話框建立。 目前,工作流步驟的配置依賴於進程參數。
所有工作流程步驟Java程式碼都 包含在we-gov-forms.core-<version>.jar套件中

示範注意事項和已知問題

本節包含有關演示功能和設計決策的資訊,在演示過程中可能需要特殊考慮。

示範注意事項

  • 根據AGRS-159,請確定「註冊最適化表單」中使用之連絡人的名稱(第一、中間和最後)是唯一的。
  • 註冊適應性表單會將Adobe Sign電子郵件傳送至表單電子郵件欄位中指定的電子郵件。 該電子郵件地址不能與用於設定Adobe Sign雲端設定的電子郵件地址相同。
  • 依預設,示範套件包含數個OSGI服務組態,以控制代管示範的目標伺服器的整體行為。 這些配置包括WCM過濾器服務配置,預設情況下,該配置使伺服器在禁用的作 者模式 (相當於?wcmmode=disabled)下運行。 請參 閱「啟用AEM編寫 ,以允許編寫頁面」。

已知問題

  • (AGRS-120)網站導覽元件目前不支援深度超過2層的巢狀子頁面。
  • (AGRS-159)目前的MS Dynamics FDM首先需要執行2個操作,將註冊適應性表單資料發佈到Dynamics,然後提取用戶記錄以檢索聯繫人ID。 在目前狀態下,如果Dynamics中有兩個以上同名的使用者,則擷取連絡人ID會失敗,這將不允許註冊最適化表單提交。

後續步驟

現在,大家都準備去探索We.Gov參考網站。 如需We.Gov參考網站工作流程和步驟的詳細資訊,請參 閱We.Gov參考網站逐步說明