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

總覽

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

基於URL的調用

若要從自訂入口網站呼叫「建立通信」應用程式，一種方式是使用下列要求參數準備URL:

  • 信函範本的識別碼（使用cmLetterId參數）。

  • 從所需資料源（使用cmDataUrl參數）中提取的XML資料的URL。

例如，自訂入口網站會將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應可匿名存取。

本頁內容