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

上次更新: 2023-12-07

概觀

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

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 字串 信函範本的名稱。

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

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

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

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

其他引數

名稱 類型 說明
cmPreview
布林值 True表示在預覽模式中開啟字母
隨機 時間戳記 解決瀏覽器快取問題。

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

本頁內容