通用互動式USA資料對應元件

概觀

通用互動式USA資料地圖​是可重複使用的Adobe Experience Manager (AEM) Sites元件,主要設計為​ 依據美國州別 ​以視覺效果呈現AEM最適化表單提交。

map-component

元件提供表單提交活動的互動式地理呈現,讓使用者瞭解美國各地提交的分佈情形、識別提交量較高的州,以及檢視州層級的提交計數。

雖然其主要使用案例是顯示表單提交,但此元件與​資料來源無關,而且可以視覺化其他以狀態為基礎的業務量度,例如銷售、客戶發佈和服務要求。

內容作者可透過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對話方塊,其中包含下列設定選項:

設定
說明
地圖示題
標題顯示在美國地圖上方
量度標籤
說明所顯示量度(例如提交內容)的標籤
資料Source型別
已設定的JSON資料來源型別
REST API端點
傳回彙總狀態層級資料的URL
狀態列位
包含雙字母狀態碼的JSON屬性
值欄位
包含提交計數的JSON屬性
顯示摘要統計資料
啟用或停用摘要統計資料
顯示工具提示
啟用或停用狀態工具提示
安全性設定
說明預期的公開或驗證資料存取模式

安全性設定欄位不會單獨強制執行存取控制。 受保護的端點必須實作他們自己的驗證和授權。

資料來源整合

元件支援兩種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資料。

recommendation-more-help
experience-manager-learn-help-cloud-service