通信作成用 UI のカスタムポータルへの統合 integrating-create-correspondence-ui-with-your-custom-portal

概要 overview

ここでは、通信を作成のソリューションをお使いの環境に統合する方法の詳細を説明します。

URL ベースの呼び出し url-based-invocation

通信を作成アプリケーションをカスタムポータルから呼び出す 1 つの方法として、次のリクエストパラメーターを持つ URL を準備する方法が挙げられます。

  • 文字テンプレートの識別子(cmLetterId パラメーターを使用)。

  • 目的のデータソースから取得した XML データの URL(cmDataUrl パラメーターを使用)。

例えば、カスタムポータルは、次のような URL を準備します
https://'[server]:[port]'/[contextPath]/aem/forms/createcorrespondence.html?random=[timestamp]&cmLetterId=[letter identifier]&cmDataUrl=[data URL](ポータル上のリンクからの href にすることができます)。

NOTE
この呼び出し方法は安全ではありません。必要なパラメーターが URL に明示される GET リクエストとして渡されるからです。
NOTE
通信を作成アプリケーションを呼び出す前に、データを保存、アップロードして、指定された dataURL で通信を作成の UI を呼び出します。この処理は、カスタムポータル自体で実行されるか、または異なるバックエンドプロセスで実行される可能性があります。

インラインデータベースの呼び出し inline-data-based-invocation

通信作成用アプリケーションを呼び出す別の(そしてより安全な)方法は、https://'[server]:[port]'/[contextPath]/aem/forms/createcorrespondence.html の URL をシンプルにヒットしながら、通信作成用アプリケーションを呼び出すパラメーターとデータを POST リクエストとして送信(エンドユーザーからはそれらを隠して)すること、が考えられます。つまり、通信を作成アプリケーションの XML データを(cmData パラメーターを使用して、同じリクエストの一部として)インラインで渡すことができることも意味します。これは、前述のアプローチでは、不可能で、理想的ではありませんでした。

レターを指定するパラメーター parameters-for-specifying-letter

名前
タイプ
説明
cmLetterInstanceId
文字列
レターインスタンスの ID です。
cmLetterId
文字列
レターテンプレートの名前です。

テーブル中のパラメーターの順序が、レターの読み込みに使用されるパラメーターの優先順位を指定します。

XML データソースを指定するパラメーター parameters-for-specifying-the-xml-data-source

名前
種類
説明
cmDataUrl
URL
cq、ftp、http、file などの基本的なプロトコルを使用してソースファイルから取得する XML データです。
cmLetterInstanceId
文字列
レターインスタンスで使用可能な xml データを使用します。
cmUseTestData
ブール値
データディクショナリに添付されたテストデータを再利用します。

テーブル中のパラメーターの順序が、XML データの読み込みに使用されるパラメーターの優先順位を指定します。

その他のパラメーター other-parameters

名前
種類
説明
cmPreview
ブール値
「True」に設定されている場合、レターをプレビューモードで開きます
ランダム
Timestamp
ブラウザーのキャッシュに関する問題を解決します。

cmDataURL に http または cq プロトコルを使用している場合、http または cq の URL には匿名でアクセスできます。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2