本文詳細說明如何將建立通信解決方案與您的環境整合。
若要從自訂入口網站呼叫「建立通信」應用程式,一種方式是使用下列要求參數準備URL:
字母模板的標識符(使用cmLetterId參數),或字母模板的名稱(使用cmLetterName參數)
從所需資料源(使用cmDataUrl參數)中提取的XML資料的URL。
例如,自訂入口網站會將URL準備為
https://[server]:[port]/[contextPath]/aem/forms/createcorrespondence.html?random=[timestamp]&cmLetterId=[letter identifier]&cmDataUrl=[data URL]
,可以是入口網站連結的href。
如果入口網站的Letter範本名稱為,則URL可能為
https://[server]:[port]/content/cm/createcorrespondence.html?cmLetterName=[letter name]&cmDataUrl=[data URL]
。
以這種方式呼叫不安全,因為必要的參數會以GET要求的形式傳遞,方法是在URL中顯示相同的(清楚顯示)。
呼叫「建立通信」應用程式前,請儲存並上傳資料,以在指定dataURL呼叫「建立通信」UI。 這可以從自訂入口網站本身,或透過其他後端程式來完成。
呼叫「建立通信」應用程式的另一種(且更安全)方式,可能只是點擊URL: https://[server]:[port]/[contextPath]/aem/forms/createcorrespondence.html
時,以POST請求的形式傳送參數和資料以呼叫建立通信應用程式(隱藏給一般使用者)。 這也表示您現在可以內嵌傳遞建立通信應用程式的XML資料(作為相同請求的一部分,使用cmData參數),這在先前的方法中不可能/不理想。
名稱 | 類型 | 說明 |
cmLetterInstanceId | 字串 | 信函例項的識別碼。 |
cmLetterName | 字串 | 信函範本的識別碼。 如果伺服器上有多個同名的CM字母,則在URL中使用cmLetterName參數會擲回錯誤「有多個字母與名稱存在」。 在這種情況下,請在URL中使用cmLetterId參數,而非cmLetterName。 |
cmLetterId | 字串 | 字母模板的名稱。 |
表中的參數順序指定用於載入字母的參數的首選項。
名稱 | 類型 | 說明 |
cmDataUrl |
URL | 使用基本通訊協定(例如cq、ftp、http或檔案)從來源檔案取得XML資料。 |
cmLetterInstanceId | 字串 | 使用信函例項中可用的xml資料。 |
cmUseTestData | 布林值 | 重複使用資料字典中附加的測試資料。 |
表中的參數順序指定用於載入XML資料的參數的首選項。
名稱 | 類型 | 說明 |
cmPreview |
布林值 | 在預覽模式中開啟信函的值為true |
隨機 | 時間戳記 | 解決瀏覽器快取問題。 |
如果您對cmDataURL使用http或cq通訊協定,http/cq的URL應可匿名存取。