本文詳細說明如何將「建立通信解決方案」與您的環境整合。
從自訂入口網站呼叫「建立對應」應用程式的一種方式,是使用下列請求參數來準備URL:
字母模板的標識符(使用cmLetterId參數),或字母模板的名稱(使用cmLetterName參數)
從所需資料來源擷取的XML資料的URL(使用cmDataUrl參數)。
例如,自訂入口網站會將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。 這可從自訂入口網站本身或透過另一個後端程式完成。
呼叫「建立對應」應用程式的另一種(也是更安全的)方式是,在傳送參數和資料以POST要求呼叫「建立對應」應用程式時,直接點擊https://[server]:[port]/[contextPath]/aem/forms/createcorrespondence.html
的URL(將其隱藏在使用者面前)。 這也表示您現在可以將XML資料傳遞至內嵌的「建立對應」應用程式(使用cmData參數做為相同要求的一部分),這在先前的方法中是不可能的/理想的。
名稱 | 類型 | 說明 |
cmLetterInstanceId | 字串 | 字母實例的標識符。 |
cmLetterName | 字串 | 字母模板的標識符。 如果伺服器上存在多個同名的CM字母,則使用URL中的cmLetterName參數會引發錯誤「Multiple letters exist with name(多個字母與名稱存在)」。 在這種情況下,請在URL中使用cmLetterId參數,而非cmLetterName。 |
cmLetterId | 字串 | 字母模板的名稱。 |
表中參數的順序指定用於載入字母的參數的首選項。
名稱 | 類型 | 說明 |
cmDataUrl |
URL | 使用基本通訊協定(例如cq、ftp、http或檔案)從來源檔案取得XML資料。 |
cmLetterInstanceId | 字串 | 使用字母實例中可用的xml資料。 |
cmUseTestData | 布林值 (Boolean) | 重複使用資料字典中附加的測試資料。 |
表中參數的順序指定用於載入XML資料的參數的首選項。
名稱 | 類型 | 說明 |
cmPreview |
布林值 (Boolean) | True以預覽模式開啟字母 |
隨機 | 時間戳記 | 若要解決瀏覽器快取問題。 |
如果您對cmDataURL使用http或cq通訊協定,http/cq的URL應匿名存取。