[AEM Forms]{class="badge positive" title="適用於AEM Forms)。"}
建立表單資料模型(FDM) create-form-data-model
Experience Manager Forms中的 表單資料模型(FDM) 定義了資料的結構化以及在表單與後端系統之間交換的方式。 Experience Manager Forms資料整合提供直覺式使用者介面,用於建立和使用表單資料模型。 表單資料模型(FDM)依賴資料來源來交換資料;不過,您可以建立表單資料模型(FDM) ,無論是否具有資料來源。 此彈性可讓您在後端連線可用之前就開始設計和測試表單,然後稍後在不重建模型的情況下繫結資料來源。
建立表單資料模型(FDM)的方法有兩種,視您是否已設定資料來源而定:
-
使用預先設定的資料來源:如果您已依照設定資料來源中的說明設定資料來源,則可以在建立表單資料模型(FDM)時選取它們。 選取已設定的資料來源,即可從選取的資料來源取得可用於表單資料模型(FDM)的所有資料模型物件、屬性和服務。 若您的整合端點已建立,且您希望FDM反映來自這些系統的即時架構、作業和服務,此方法即是理想選擇。
-
沒有資料來源:如果您尚未設定表單資料模型(FDM)的資料來源,您仍可建立沒有資料來源的表單資料模型(FDM)。 您可以使用表單資料模型(FDM)來撰寫最適化Forms,並使用範例資料加以測試。 當資料來源可供使用時,您可以將表單資料模型(FDM)與資料來源繫結,而且此繫結會自動傳播到關聯的調適型Forms — 因此,在新增真正的後端連線後,根據範例資料建立的表單會繼續運作。
建立表單資料模型(FDM) data-sources
在建立表單資料模型(FDM)之前,請確定您已依照設定資料來源的說明,設定您要用於表單資料模型(FDM)的資料來源。 表單資料模型(FDM)提供將Adobe Experience Manager個Forms連線到一個或多個已設定資料來源的統一層,可讓您將表單欄位繫結到後端資料並叫用資料來源服務。 執行下列作業,根據已設定的資料來源建立表單資料模型(FDM):
-
在Experience Manager作者執行個體中,導覽至Forms >資料整合。
-
選取建立>表單資料模型。
-
在建立表單資料模型對話方塊中:
- 指定表單資料模型(FDM)的名稱。
- (選擇性)指定表單資料模型(FDM)的標題、說明和標籤。
- (選擇性,並只在資料來源已設定時才適用)選取 資料Source設定 欄位旁的勾選圖示,並選取您要使用之資料來源的雲端服務所在的設定節點。 因此,下一頁可供選取的資料來源清單會限製為所選設定節點中的可用資料來源。 不過,預設會列出任何Experience Manager使用者設定檔資料來源。 如果您未選取組態節點,則會列出所有組態節點的資料來源。
-
選取「下一步」。
-
(僅適用於已設定資料來源的情況) 選取資料來源畫面會列出可用的資料來源。 選取您要在表單資料模型中使用的資料來源。
-
選取建立,然後在確認對話方塊中選取 開啟 以開啟表單資料模型編輯器。
表單資料模型編輯器UI包含下列元件:
A. 資料來源列出表單資料模型中的資料來源。 展開資料來源以檢視其資料模型物件及服務。
B. 重新整理資料Source定義會從已設定的資料來源擷取資料來源定義的任何變更,並在表單資料模型編輯器的「資料來源」索引標籤中進行更新。 這可確保模型可反映連線資料來源的目前狀態。
C. 模型顯示新增資料模型物件的內容區域。
D. 服務新增的資料來源作業或服務出現的內容區域。
E. 工具列使用表單資料模型(FDM)的工具。 工具列會根據表單資料模型(FDM)中選取的物件顯示更多選項。
F. 新增選取的專案將選取的資料模型物件和服務新增至表單資料模型。
如需有關表單資料模型編輯器以及如何使用它來編輯和設定表單資料模型(FDM)的詳細資訊,請參閱使用表單資料模型。
更新資料來源 update
請依照下列步驟,在Adobe Experience Manager Forms的現有 表單資料模型(FDM) 中新增、取代或刪除資料來源。 讓資料來源保持最新狀態,可確保以模型為基礎的最適化Forms能持續讀取和寫入正確的系統。
-
移至Forms >資料整合,選取您要新增或更新資料來源的表單資料模型(FDM),然後選取屬性。
-
在表單資料模型屬性中,移至 更新Source 標籤。
在 更新Source 索引標籤中,您可以選取組態內容,然後新增、取代或刪除資料來源:
-
選取設定內容:在 內容感知設定 欄位中選取瀏覽圖示,並選取您要新增之資料來源的雲端設定所在的設定節點。 這會決定可以看到哪些雲端設定。 如果您未選取節點,當您選取 新增來源 時,只會列出位於
global節點的雲端設定。 -
新增資料來源:選取 新增來源 並選取要新增至 表單資料模型(FDM) 的資料來源。 會顯示在
global中及所選設定節點中設定的所有資料來源(如果有的話)。 這會新增選取的資料來源,以便其資料模型物件可在模型中繫結。 -
取代現有的資料來源:若要以相同型別的其他資料來源取代現有的資料來源,請選取資料來源的 編輯 圖示,並從可用的資料來源清單中選取。 以相同型別的來源取代,會保留現有的資料模型結構,讓相依繫結保持有效。
-
刪除現有的資料來源:若要刪除現有的資料來源,請選取資料來源的 刪除 圖示。 「刪除」圖示已停用,因為該資料來源的資料模型物件已新增並用於表單資料模型(FDM),以防止移除仍被參考的相依性。
-
-
選取 儲存並關閉 以儲存更新。
特定執行模式的內容感知設定 runmode-specific-context-aware-config
表單資料模型(FDM)使用Sling內容感知設定提供不同的資料來源引數,啟用與Experience Manager執行模式中不同資料來源的連線。 此功能可讓單一部署目標不同的端點,這取決於它是否在開發、階段或 生產 中執行。
當表單資料模型(FDM)使用雲端設定來儲存引數時,這些引數在透過原始檔控制(Cloud-Manager GIT存放庫)簽入和部署時,會建立單一雲端設定,並在所有執行模式(開發、階段和生產)中使用相同的引數。 當您的使用案例需要不同的資料集用於測試和生產環境時,請使用每個Experience Manager執行模式特定的資料來源引數(例如,資料來源URL)。
若要達成此目的,請建立包含資料來源引數值組的OSGi組態。 這可確保OSGi值優先,在執行階段覆寫來自表單資料模型(FDM)雲端設定的相同組。 由於OSGi設定預設支援這些執行模式,因此您可以根據執行模式將資料來源引數覆寫為不同的值,讓每個環境解析為自己的端點。
若要在表單資料模型(FDM)中啟用部署特定的雲端設定:
-
在本機開發執行個體上建立雲端設定。 如需詳細步驟,請參閱如何設定資料來源。
-
將您的雲端設定儲存至檔案系統。
- 使用篩選器
/conf/{foldername}/settings/cloudconfigs/fdm建立封裝。 使用與步驟1相同的{foldername}。 並以Azure儲存體設定的azurestorage取代fdm。 - 建置並下載套件。 如需詳細資訊,請參閱封裝動作。
- 使用篩選器
-
整合Experience Manager原型專案中的雲端設定。
- 將下載的套件解壓縮。
- 複製「
jcr_root」資料夾並放置您的「ui.content>src>main>content」。 - 更新
ui.content>src>main>content>META-INF>vault>filter.xml以包含篩選器/conf/{foldername}/settings/cloudconfigs/fdm。 如需詳細資訊,請參閱AEM專案原型的ui.content模組。 透過Cloud Manager (CM)管道部署此原型專案時,相同的雲端設定會安裝在所有環境(或執行模式)上。 若要根據環境變更雲端設定的欄位值(例如URL),請使用以下步驟中討論的OSGi設定。
-
建立Apache Sling內容感知設定。 若要建立OSGi設定:
-
在Experience Manager Archetype專案中設定OSGi設定檔。
建立PID為org.apache.sling.caconfig.impl.override.OsgiConfigurationOverrideProvider的OSGi Factory組態檔。 在每個執行模式資料夾下建立一個名稱相同的檔案,其中值需要為每個執行模式變更。 這可確保每個執行模式都套用自己的覆寫值。 如需詳細資訊,請參閱為 Adobe Experience Manager設定OSGi。 -
設定OSGi設定JSON。 設定Apache Sling內容感知設定覆寫提供者,以便在部署時自動套用環境特定值。 若要使用Apache Sling內容感知設定覆寫提供者:
- 在您的本機開發執行個體
/system/console/configMgr上,選取名稱為 Apache Sling內容感知設定覆寫提供者: OSGi設定 的工廠OSGi設定。 - 提供說明。
- 選取已啟用。
- 在覆寫下,根據Sling覆寫語法中的環境,提供需要變更的欄位。 如需詳細資訊,請參閱Apache Sling內容感知設定 — 覆寫。 例如
cloudconfigs/fdm/{configName}/url="newURL"。
選取 + 以新增多個覆寫。 - 選取「儲存」。
- 若要取得OSGi設定JSON,請依照使用AEM SDK快速入門產生OSGi設定中的步驟操作。
- 將JSON放入上一步建立的OSGi Factory設定檔案中。
- 將覆寫設定中的
newURL值變更為每個環境(或執行模式)的正確目標值,讓每個環境解析為自己的URL。 - 若要根據執行模式變更密碼值,請使用Cloud Manager (CM) API建立密碼變數,之後再於OSGi設定中參考它。
透過Cloud Manager (CM)管道部署此原型專案時,覆寫作業會針對不同環境(或執行模式)提供不同值。 因此,單一程式碼基底在執行階段會解析為環境特定的設定。 這可確保開發、測試和生產執行個體都可接收正確的URL和密碼值,而不會手動變更程式碼。
note NOTE Adobe Managed Service使用者可以使用加密支援來加密密碼值。 如需詳細資訊,請參閱組態屬性🔗的加密支援,並在Service Pack 6.5.13.0提供內容感知組態之後,將加密文字置於值中。 - 在您的本機開發執行個體
-
-
透過FDM使用者介面(UI)重新整理表單資料模型(FDM)快取,並取得最新組態,使用重新整理表單資料模型編輯器中資料來源定義的選項來重新整理資料來源定義。 這可確保FDM快取反映新套用的覆寫值。
後續步驟 next-steps
您現在擁有已新增資料來源的表單資料模型(FDM)。 在連線資料來源後,下一步是調整並擴充表單資料模型(FDM),以便它精確地呈現您的表單需要擷取和處理的資料。
編輯 表單資料模型(FDM) 以執行下列工作:
- 新增及設定資料模型物件及服務。
- 在資料模型物件之間新增關聯,以定義相關資料的連線方式。
- 編輯現有資料模型物件的屬性。
- 將自訂資料模型物件和屬性新增到模型資料,這些資料在連線的資料來源中無法使用。
- 產生範例資料以測試並預覽表單資料模型的行為方式。
這些設定步驟可讓您在將 表單資料模型(FDM) 繫結至表單之前,根據您的特定業務需求加以量身打造。
如需詳細資訊,請參閱使用表單資料模型。