実装の概要

通信を作成アプリケーションの XML データにダイレクト URL を使用してアクセスできる場合、cmDataUrl は、そのホストされた URL を直接指定できます。通信を作成は、この URL からの XML データの取得および通信のレンダリングを試みます。

XML データは、CRX リポジトリにも格納できます。リポジトリへのパスは、crx:// プロトコルを使用して、通信を作成アプリケーションに提供されます。例えば、必要な XML データが /content/correspondence/data/test.xml に保存されている場合、通信を作成アプリケーションを起動するための URL は、http://<server>:<port>/content/cm/createcorrespondence.html?<usual request parameters>&cmDataUrl=crx://content/correspondence/data/test.xml です。

カスタムデータソースに統合するには、カスタムサーブレットを実装して、次の操作を行う必要があります。

• コンテンツプロバイダーから XML データを取得するカスタム HTTP サーブレットを記述します。取得した XML データをサーブレットの「応答」で返します。

• 通信を作成 URL の呼び出し時に、cmDataUrl の値をサーブレットの URL として設定します。

例えば、サーブレットが通信管理アプリケーション内で作成され、URL /CustomDataUrl にマップされている場合、通信を作成ユーザーインターフェイスの URL は、http://<server>:<port>/content/cm/createcorrespondence.html?<usual request parameters>&cmDataUrl=http://<server>:<port>/apps/solutions/cm/CustomDataUrl です。

package sample; 
 
import javax.servlet.ServletException; 
import javax.servlet.http.*; 
import java.io.*; 
 
 
public class CustomDataUrl extends HttpServlet { 
    public void doGet(HttpServletRequest request, 
             HttpServletResponse response) 
                throws ServletException, IOException 
          { 
            response.setContentType("text/xml"); 
            PrintWriter out = response.getWriter(); 
 
                // Replace the below line with an invocation to an external/legacy data source/API. 
                String xml = "<?xml version='1.0' encoding='UTF-8'?><F><P1><WCCFileNumber>9875</WCCFileNumber><SSN>3459837</SSN></P1></F>"; 
 
                // Write to the response stream 
            out.println(xml); 
            out.close(); 
          } 
 
}

通信を作成ユーザーインターフェイスを呼び出す前に、通信管理アプリケーションはオーケストレーションを呼び出して、プロセス（前述のデータファイルへのパス）の応答／出力を取得します。

cmDataUrl の値を、返されたファイルパスとして設定し、通信を作成ユーザーインターフェイスを呼び出します。