通用互動式USA資料對應元件
概觀
通用互動式USA資料地圖是可重複使用的Adobe Experience Manager (AEM) Sites元件,主要設計為 依據美國州別 以視覺效果呈現AEM最適化表單提交。
元件提供表單提交活動的互動式地理呈現,讓使用者瞭解美國各地提交的分佈情形、識別提交量較高的州,以及檢視州層級的提交計數。
雖然其主要使用案例是顯示表單提交,但此元件與資料來源無關,而且可以視覺化其他以狀態為基礎的業務量度,例如銷售、客戶發佈和服務要求。
內容作者可透過AEM元件對話方塊設定相容的REST API端點,而不需修改元件的JavaScript或後端實作。
元件使用 D3.js和TopoJSON 來呈現互動式USA對應,根據設定的REST API傳回的值動態著色狀態。
主要功能
- 表單提交視覺效果:顯示依美國狀態彙總的AEM最適化表單提交計數。
- 互動式地理地圖:根據提交量為個別狀態著色。
- 狀態選擇:允許使用者按一下狀態來檢視其名稱、狀態代碼和提交計數。
- 摘要統計資料:顯示提交總數、呈現的狀態數目,以及提交量最高的狀態。
- 可設定的REST資料來源:支援在Azure、轉譯器、AWS或其他平台上裝載的相容REST API。
- 資料來源獨立性:不需要特定的資料庫或後端技術。
- 可設定的JSON欄位對應:允許作者指定代表狀態碼和數值的JSON屬性。
- 可自訂的簡報:支援可設定的地圖示題、量度標籤、摘要統計資料和工具提示。
- 回應式設計:可適應不同的熒幕大小。
- 鍵盤協助工具:支援鍵盤式狀態選擇。
主要使用案例 — 各州提交的AEM Forms
元件通常用作 AEM Forms儀表板 的一部分,以視覺化方式呈現最適化表單提交的地理分佈。
當使用者提交最適化表單時,提交資料會儲存在後端系統中,例如Azure SQL資料庫。
REST API會依狀態擷取及彙總提交專案,並傳回元件預期JSON格式的結果。
「美國地圖」會取用此API回應,並顯示地理位置的提交計數。
範例
如果組織收到來自加利福尼亞、德克薩斯和紐約的提交內容,則地圖會根據收到的提交內容數反白標示這些州。
使用者可與對應互動,以檢視與每個狀態相關聯的提交計數。
這可提供視覺化的方式來監控表單提交活動及識別地理趨勢。
REST API資料合約
元件預期HTTP GET端點會傳回JSON格式的彙總狀態層級資料。
範例回應:
{
"states": [
{ "state": "CA", "count": 150 },
{ "state": "TX", "count": 95 },
{ "state": "NY", "count": 70 }
]
}
每個記錄代表美國狀態及其對應的提交計數。
狀態列位和值欄位的名稱可透過AEM編寫對話方塊設定。
例如,透過對應元件設定中的欄位,可支援傳回stateCode和totalSubmissions的REST API。
後端REST API負責擷取、彙總表單提交資料,並將資料格式化為預期的狀態層級JSON結構。 元件不會查詢資料庫或彙總個別提交。
AEM製作設定
元件提供AEM Touch UI對話方塊,其中包含下列設定選項:
安全性設定欄位不會單獨強制執行存取控制。 受保護的端點必須實作他們自己的驗證和授權。
資料來源整合
元件支援兩種REST整合模式。
直接REST API整合
元件會從瀏覽器直接呼叫相容的REST API。
端點必須支援HTTPS、適當的CORS設定以及任何適用的內容安全性原則需求。
受保護的REST API整合
對於需要API金鑰或驗證的後端服務,元件可以呼叫AEM Sling Servlet或其他安全後端Proxy。
這可確保敏感憑證保持在伺服器端。
已驗證的實作
AEM Forms提交控制面板
元件已實作,以顯示儲存在Azure SQL資料庫中的調適型表單提交計數。
此整合使用AEM最適化Forms、Azure函式、Azure SQL和AEM Sling Servlet來擷取狀態層級的提交計數。
外部REST API整合
元件也透過在轉譯器上託管的Node.js REST API進行測試,傳回美國州的銷售資料範例。
這表示元件可以視覺化不同後端系統的資料,而不需要變更其轉譯邏輯。
技術棧疊
- Adobe Experience Manager as a Cloud Service
- AEM HTL和Granite UI
- JavaScript和SCSS
- D3.js和TopoJSON
- Webpack和AEM使用者端資料庫
- JSON REST API
可重複使用
雖然此元件主要是要視覺化依狀態提交的 AEM Forms,但也可以顯示其他狀態層級的量度,包括銷售、客戶分佈、行銷轉換、服務要求及分支活動。
若要重複使用元件,作者會設定相容的REST端點以及適當的JSON欄位對應。
摘要
通用互動式USA資料地圖為AEM Sites提供可重複使用的地理視覺化功能,以AEM最適化表單提交監控為主要使用案例。
它可讓組織呈現美國各州的表單提交量、識別地理趨勢,並以互動方式探索州層級的提交計數。
其獨立於資料來源的架構也使其適用於其他商業報告情境,前提是設定的REST API會傳回相容的狀態層級JSON資料。