整合建立通訊UI與您的自訂入口網站

概觀

本文詳細說明如何將建立通訊解決方案與您的環境整合。

以URL為基礎的叫用

從自訂入口網站呼叫「建立通訊」應用程式的一種方法是使用下列請求引數準備URL：

  • 信件範本的識別碼（使用cmLetterId引數）。

  • 從所需資料來源擷取之XML資料的URL （使用cmDataUrl引數）。

例如，自訂入口網站會將URL準備為
https://'[server]:[port]'/[contextPath]/aem/forms/createcorrespondence.html?random=[timestamp]&cmLetterId=[letter identifier]&cmDataUrl=[data URL]，這可能是來自入口網站連結的href。

注意

以這種方式呼叫並不安全，因為必要的引數會作為GET請求傳遞，方法是在URL中公開相同的（清楚可見）。

注意

在呼叫「建立通訊」應用程式之前，請儲存並上傳資料以在指定的dataURL呼叫「建立通訊」UI。 您可以從自訂入口網站本身或透過其他後端程式完成此操作。

內嵌資料型叫用

呼叫建立通訊應用程式的另一個（且更安全）方法可能是直接點選https://'的URL[伺服器]：[連線埠]'/[contextPath]/aem/forms/createcorrespondence.html ，同時傳送引數和資料以作為POST要求呼叫建立通訊應用程式（對一般使用者隱藏它們）。 這也表示您現在可以內嵌傳遞「建立對應」應用程式的XML資料（作為相同請求的一部分，使用cmData引數），這在先前的方法中是不可能/理想的。

指定字母的引數

名稱 類型 說明
cmLetterInstanceId 字串 信件例項的識別碼。
cmLetterId 字串 Letter範本的名稱。

表格中引數的順序會指定用來載入字母的引數偏好設定。

用於指定XML資料來源的引數

名稱 類型 說明
cmDataUrl
 URL 來自使用基本通訊協定（例如cq、ftp、http或檔案）之來源檔案的XML資料。
cmLetterInstanceId 字串 使用信件例項中可用的xml資料。
cmUseTestData 布林值 重複使用資料字典中附加的測試資料。

表格中引數的順序會指定用來載入XML資料的引數偏好設定。

其他引數

名稱 類型 說明
cmPreview
 布林值 若為True，則在預覽模式下開啟字母
隨機 時間戳記 若要解決瀏覽器快取問題。

如果您對cmDataURL使用http或cq通訊協定，應可匿名存取http/cq的URL。

本頁內容