通信作成用 UI のカスタムポータルへの統合

概要

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

URL ベースの呼び出し

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

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

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

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

メモ

この呼び出し方法は安全ではありません。必要なパラメーターが URL に明示される GET 要求として渡されるからです。

メモ

通信を作成アプリケーションを呼び出す前に、データを保存、アップロードして、指定された dataURL で通信を作成の UI を呼び出します。この処理は、カスタムポータル自体で実行されるか、または異なるバックエンドプロセスで実行される可能性があります。

インラインデータベースの呼び出し

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

レターを指定するパラメーター

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

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

XML データソースを指定するパラメーター

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

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

その他のパラメーター

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

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

このページ