本文詳細說明如何將建立通訊解決方案與您的環境整合。
從自訂入口網站呼叫「建立通訊」應用程式的一種方法是使用下列請求引數準備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範本的名稱。 |
表格中引數的順序會指定用來載入字母的引數偏好設定。
名稱 | 類型 | 說明 |
cmDataUrl |
URL | 來自使用基本通訊協定(例如cq、ftp、http或檔案)之來源檔案的XML資料。 |
cmLetterInstanceId | 字串 | 使用信件例項中可用的xml資料。 |
cmUseTestData | 布林值 | 重複使用資料字典中附加的測試資料。 |
表格中引數的順序會指定用來載入XML資料的引數偏好設定。
名稱 | 類型 | 說明 |
cmPreview |
布林值 | 若為True,則在預覽模式下開啟字母 |
隨機 | 時間戳記 | 若要解決瀏覽器快取問題。 |
如果您對cmDataURL使用http或cq通訊協定,應可匿名存取http/cq的URL。