Oracle XML Publisher管理および開発者ガイド リリース12 E05659-01

目次

前へ

次へ

配信マネージャAPIの使用

はじめに

配信マネージャは、XMLパブリッシャ文書の配信を制御できる一連のJava APIです。配信マネージャは次の各操作に使用します。

• 確立された配信チャネル（Eメール、FAX、プリンタ、WebDAV、FTP、Secure FTP、AS2またはHTTP）またはカスタム配信チャネルを介した文書の配信

• 各配信のステータスの追跡

• 文書の再配信

配信マネージャの使用

配信マネージャを使用する手順は、次のとおりです。

1. DeliveryManagerインスタンスを作成します。

2. createRequest()メソッドを使用して、DeliveryRequestインスタンスを作成します。

3. 要求のプロパティ（DeliveryRequestの宛先など）を追加します。ほとんどのプロパティでは文字列値が必要です。詳細は、各配信チャネルでサポートされるプロパティを参照してください。

4. DeliveryRequestに文書を設定します。

5. submit()をコールしてこの配信要求を発行します。

1つの配信要求によって、1つの文書と1つの宛先を処理できます。必要な場合は、この処理によってモニタリングと再発行が容易になります。

DeliveryRequestでは、文書を次の3つの方法で設定できます。

• 文書の入力ストリームをDeliveryRequestに設定します。入力ストリームは、ユーザーが初めてsubmit()をコールしたときに、DeliveryRequestによって読み込まれます。入力ストリームは、DeliveryRequestによって閉じられないため、ユーザーが閉じる必要があります。

• 文書のファイル名をDeliveryRequestに設定します。

ダイレクト・モードを設定をすると、配信マネージャによって効率的な配信がサポートされます。「ダイレクト・モードとバッファリング・モード」を参照してください。

このマニュアルで説明する配信チャネルは、次のとおりです。

• Eメール

• プリンタ

• FAX

• WebDAV

• FTP

• Secure FTP

• HTTP

• AS2

Eメールを介した文書の配信

次に、Eメールを介した配信のコード例を示します。

// create delivery manager instance
     DeliveryManager dm = new DeliveryManager();
     // create a delivery request
     DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_SMTP_EMAIL);

     // set email subject
     req.addProperty(DeliveryPropertyDefinitions.SMTP_SUBJECT, "test mail");
     // set SMTP server host
     req.addProperty(
       DeliveryPropertyDefinitions.SMTP_HOST, "mysmtphost");
     // set the sender email address
     req.addProperty(DeliveryPropertyDefinitions.SMTP_FROM, "myname@mydomain.com");
     // set the destination email address
     req.addProperty(
       DeliveryPropertyDefinitions.SMTP_TO_RECIPIENTS, "user1@mydomain.com, user2@mydomain.com" );
     // set the content type of the email body
     req.addProperty(DeliveryPropertyDefinitions.SMTP_CONTENT_TYPE, "application/pdf");
     // set the document file name appeared in the email
     req.addProperty(DeliveryPropertyDefinitions.SMTP_CONTENT_FILENAME, "test.pdf");
     // set the document to deliver
     req.setDocument("/document/test.pdf");

     // submit the request
     req.submit();
     // close the request
     req.close();

次の表に、サポートされるプロパティを示します。

複数の受信者の定義

Eメール配信サーバー・チャネルでは、要求ごとに複数の文書と複数の宛先がサポートされます。次に、複数のTOアドレスとCCアドレスのコード例を示します。

    // set the TO email addresses
     req.addProperty(
       DeliveryPropertyDefinitions.SMTP_TO_RECIPIENTS,
        "user1@mydomain.com", user2@mydomain.com, user3@mydomain.com");

     // set the CC email addresses
     req.addProperty(
       DeliveryPropertyDefinitions.SMTP_CC_RECIPIENTS,
        "user4@mydomain.com, user5@mydomain.com, user6@mydomain.com");
 

1つの要求に対する複数文書の添付

添付ユーティリティ・クラス（oracle.apps.xdo.delivery.smtp.Attachment）を使用して、1つの要求に複数の文書を添付します。次に、使用方法の例を示します。

     :
     :
   // create Attachment instance
   Attachment m = new Attachment();

   // add PDF attachment
   m.addAttachment(
       "/pdf_doc/invoice.pdf",      // file to deliver
       "invoice.pdf",               // file name as appears in email
       "application/pdf");          // content type

   // add RTF attachment
   m.addAttachment(
       "/rtf_doc/product.rtf",      // file to deliver
       "product.rtf",               // file name appears in the email
       "application/rtf");          // content type

   // add XML attachment
   m.addAttachment(
       "/xml_doc/data.xml",          // file to deliver
       "data.xml",                   // file name appears in the email
       "text/xml");                  // content type

   // If you want to attach HTML doucments, use addHtmlAttachment().
   // This method automatically resolves the image references
   // in your HTML document and attaches those images.
   m.addHtmlAttachment("/html_doc/invoice.html");

   // add the attachment to the request
   req.addProperty(DeliveryPropertyDefinitions.SMTP_ATTACHMENT, m);

     :
     :  

複数のHTML文書の添付

1つの要求に複数のHTML文書を添付できます。HTML文書に、ローカル・ファイル・システムに配置されたイメージ・ファイルへの参照がある場合は、添付ユーティリティによって、そのイメージ・ファイルも自動的に添付されます。次に、使用方法の例を示します。

   Attachment m = new Attachment();
   m.addHtmlAttachment("/path/to/my.html");
     :
     :

   req.addProperty(DeliveryPropertyDefinitions.SMTP_ATTACHMENT, m);

添付ファイルのEメール最上部での表示

Eメールの最上部に添付ファイルを表示する場合は、SMTP_ATTACHMENT_FIRSTプロパティをtrueに設定します。次に、使用方法の例を示します。

   Attachment m = new Attachment();
   m.addHtmlAttachment("/path/to/my.html");
     :
     :
   req.addProperty(DeliveryPropertyDefinitions.SMTP_ATTACHMENT_FIRST, "true");
     :

Eメールの本文としてのStringオブジェクトの使用

Eメールの本文にStringオブジェクトを使用できます。この方法は、添付ファイルにメッセージを含める場合に便利です。次のサンプル・コードでは、Eメールの本文として「Please find the attached invoice.」というメッセージと、添付ファイルとして1つのPDF文書invoice.pdfが配信されます。

   // create delivery manager instance
   DeliveryManager dm = new DeliveryManager();
   // create a delivery request
   DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_SMTP_EMAIL);

   // set email subject
   req.addProperty(DeliveryPropertyDefinitions.SMTP_SUBJECT, "Invoice");
   // set SMTP server host
   req.addProperty(
     DeliveryPropertyDefinitions.SMTP_HOST, "mysmtphost");
   // set the sender email address
   req.addProperty(DeliveryPropertyDefinitions.SMTP_FROM, "myname@mydomain.com");
   // set the destination email address
   req.addProperty(
     DeliveryPropertyDefinitions.SMTP_TO_RECIPIENTS, "user1@mydomain.com, user2@mydomain.com" );
   // set the document to deliver
   req.setDocument("Please find the attached invoice. ", "UTF-8");

   // create Attachment
   Attachment m = new Attachment();
   // add attachments
   m.addAttachment(
     "/pdf_doc/invoice.pdf",            // file to deliver
     "invoice.pdf",                     // file name appears in the email
     "application/pdf");                // content type
   // add the attachment to the request
   req.addProperty(DeliveryPropertyDefinitions.SMTP_ATTACHMENT, m);

   // submit the request
   req.submit();
   // close the request
   req.close();

     :
     :

Eメールの本文としてのHTML文書の使用

Eメールの本文には、HTML文書も使用できます。HTML文書内にあるローカル・イメージへの参照は、ユーティリティによって自動的に解決され、それらのイメージも添付されます。

次に、使用方法の例を示します。

   // create delivery manager instance
   DeliveryManager dm = new DeliveryManager();
   // create a delivery request
   DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_SMTP_EMAIL);

   // set email subject
   req.addProperty(DeliveryPropertyDefinitions.SMTP_SUBJECT, "Invoice");
   // set SMTP server host
   req.addProperty(
     DeliveryPropertyDefinitions.SMTP_HOST, "mysmtphost");
   // set the sender email address
   req.addProperty(DeliveryPropertyDefinitions.SMTP_FROM, "myname@mydomain.com");
   // set the destination email address
   req.addProperty(
     DeliveryPropertyDefinitions.SMTP_TO_RECIPIENTS, "user1@mydomain.com, user2@mydomain.com" );

   // set the content type of the email body
   req.addProperty(DeliveryPropertyDefinitions.SMTP_CONTENT_TYPE, "text/html");
   // set the document file name appeared in the email
   req.addProperty(DeliveryPropertyDefinitions.SMTP_CONTENT_FILENAME, "body.html");
   // set the document to deliver
   req.setDocument("/document/invoice.html");

   // submit the request
   req.submit();
   // close the request
   req.close();

     :
     :

認証用のユーザー名とパスワードの指定

SMTPサーバーで認証が必要な場合は、配信要求にユーザー名とパスワードを指定できます。

 :
   req.addProperty(DeliveryPropertyDefinitions.SMTP_USERNAME, "scott");
   req.addProperty(DeliveryPropertyDefinitions.SMTP_PASSWORD, "tiger");
     :

プリンタへの文書の配信

配信サーバーでは、IPPサポート対象のプリンタやサーバー（CUPSなど）への文書配信について、RFC 2910とRFC 2911で定義されているInternet Printing Protocol（IPP）をサポートしています。

Common Unix Printing System（CUPS）は、無償のサーバー・スタイルのIPPベース・ソフトウェアです。このソフトウェアは、IPP要求を受け入れ、その要求をプリンタやFAXなどのIPPおよび非IPPベースのデバイスにディスパッチします。CUPSの詳細は、http://www.cups.org/を参照してください。使用しているシステムへのCUPS設定の詳細は、「CUPSの設定」を参照してください。

IPPを使用して文書を印刷するには、配信前にその文書を対象IPPプリンタまたはサーバーで認識可能な書式に変換する必要があります。たとえば、対象プリンタがPostscriptプリンタであれば、文書をPostscript書式に変換する必要があります。通常、PDF、RTF、ExcelまたはWord文書の書式はプリンタでネイティブには認識されません。配信API自体には文書の書式変換機能はありませんが、この変換目的で文書フィルタがサポートされています。詳細は、「文書フィルタのサポート」を参照してください。

次に、プリンタへの配信のコード例を示します。

// create delivery manager instance
     DeliveryManager dm = new DeliveryManager();
     // create a delivery request
     DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_IPP_PRINTER);

     // set IPP printer host
     req.addProperty(DeliveryPropertyDefinitions.IPP_HOST, "myhost");
     // set IPP printer port
     req.addProperty(DeliveryPropertyDefinitions.IPP_PORT, "631");
     // set IPP printer name
     req.addProperty(DeliveryPropertyDefinitions.IPP_PRINTER_NAME, "/printers/myprinter");
     // set the document format
     req.addProperty(DeliveryPropertyDefinitions.IPP_DOCUMENT_FORMAT,
       DeliveryPropertyDefinitions.IPP_DOCUMENT_FORMAT_POSTSCRIPT);
     // set the document
     req.setDocument("/document/invoice.ps");

     // submit the request
     req.submit();
     // close the request
     req.close();

次のプロパティがサポートされています。特に記載がないかぎり、各プロパティには、1つの文字列値が必要です。IPP_SIDES、IPP_COPIES、IPP_ORIENTATIONなどのプリンタ固有のプロパティは、プリンタ機能に依存しています。たとえば、対象プリンタが両面印刷をサポートしていない場合、IPP_SIDES設定は機能しません。

HTTPプロキシ・サーバーを介した印刷

HTTPプロキシ・サーバーを介してIPPプリンタやFAXに文書を配信する場合は、CUPSとプロキシ・サーバー間でのHTTP実装の相違によって、配信に問題が発生する場合があります。次の2つのプロパティを設定することで、これらの問題のほとんどは解決できます。

• DeliveryPropertyDefinitions.IPP_USE_FULL_URL - trueに設定します。

• DeliveryPropertyDefinitions.IPP_USE_CHUNKED_BODY - falseに設定します。

CUPSをデフォルトの設定で使用する場合は、一般的に次のようなプロパティ設定となります。

• IPP_HOST: <host-name>

• IPP_PORT: 631

• IPP_PRINTER_NAME: /printers/<printer-name>

Microsoft Internet Information Service（IIS）をデフォルトの設定で使用する場合は、一般的に次のようなプロパティ設定となります。

• IPP_HOST: <host-name>

• IPP_PORT: 80

• IPP_PRINTER_NAME: /printers/<printer-name>/.printer

FAXを介した文書の配信

この配信システムは、CUPS上に構成されたFAXモデムに対する文書の配信をサポートしています。FAXモデムは、efax（http://www.cce.com/efax/）およびFAX4CUPS（http://www.gnu.org/directory/productivity/special/fax4CUPS.html）を使用してCUPS上に構成できます。

次に、FAX配信のコード例を示します。

// create delivery manager instance
     DeliveryManager dm = new DeliveryManager();
     // create a delivery request
     DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_IPP_FAX);

     // set IPP fax host
     req.addProperty(DeliveryPropertyDefinitions.IPP_HOST, "myhost");
     // set IPP fax port
     req.addProperty(DeliveryPropertyDefinitions.IPP_PORT, "631");
     // set IPP fax name
     req.addProperty(DeliveryPropertyDefinitions.IPP_PRINTER_NAME, "/printers/myfax");
     // set the document format
     req.addProperty(DeliveryPropertyDefinitions.IPP_DOCUMENT_FORMAT, "application/postscript");
     // set the phone number to send
     req.addProperty(DeliveryPropertyDefinitions.IPP_PHONE_NUMBER, "9999999");
     // set the document
     req.setDocument("/document/invoice.pdf");

     // submit the request
     req.submit();
     // close the request
     req.close();

サポートされるプロパティは、プリンタ文書でサポートされるプロパティと同じです。また、次のプロパティもサポートされます。

WebDAVサーバーへの文書の配信

次に、WebDAVサーバーへの配信のコード例を示します。

// create delivery manager instance
     DeliveryManager dm = new DeliveryManager();
     // create a delivery request
     DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_WEBDAV);

     // set document content type
     req.addProperty(DeliveryPropertyDefinitions.WEBDAV_CONTENT_TYPE, "application/pdf");
     // set the WebDAV server hostname
     req.addProperty(DeliveryPropertyDefinitions.WEBDAV_HOST, "mywebdavhost");
     // set the WebDAV server port number
     req.addProperty(DeliveryPropertyDefinitions.WEBDAV_PORT, "80");
     // set the target remote directory
     req.addProperty(DeliveryPropertyDefinitions.WEBDAV_REMOTE_DIRECTORY, "/content/");
     // set the remote filename
     req.addProperty(DeliveryPropertyDefinitions.WEBDAV_REMOTE_FILENAME, "xdotest.pdf");

     // set username and password to access WebDAV server
     req.addProperty(DeliveryPropertyDefinitions.WEBDAV_USERNAME, "xdo");
     req.addProperty(DeliveryPropertyDefinitions.WEBDAV_PASSWORD, "xdo");
     // set the document
     req.setDocument("/document/test.pdf");

     // submit the request
     req.submit();
     // close the request
     req.close();

次のプロパティがサポートされています。特に記載がないかぎり、各プロパティには、1つの文字列値が必要です。

FTPを使用した文書の配信

次に、FTPサーバーへの配信のコード例を示します。

// create delivery manager instance
     DeliveryManager dm = new DeliveryManager();
     // create a delivery request
     DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_FTP);

     // set hostname of the FTP server
     req.addProperty(DeliveryPropertyDefinitions.FTP_HOST, "myftphost");
     // set port# of the FTP server
     req.addProperty(DeliveryPropertyDefinitions.FTP_PORT, "21");
     // set username and password to access WebDAV server
     req.addProperty(DeliveryPropertyDefinitions.FTP_USERNAME, "xdo");
     req.addProperty(DeliveryPropertyDefinitions.FTP_PASSWORD, "xdo");
     // set the remote directory that you want to send your document to
     req.addProperty(DeliveryPropertyDefinitions.FTP_REMOTE_DIRECTORY, "pub");
     // set the remote file name
     req.addProperty(DeliveryPropertyDefinitions.FTP_REMOTE_FILENAME, "test.pdf");
     // set the document
     req.setDocument("/document/test.pdf");

     // submit the request
     req.submit();
     // close the request
     req.close();

次のプロパティがサポートされています。特に記載がないかぎり、1つの文字列値が必要です。

Secure FTPを介した文書の配信

Secure FTPは、Secure Shellテクノロジ（ssh）に基づくプロトコルであり、セキュアな方法でファイルを転送するために一般に使用されています。Secure ShellおよびSecure FTPのいずれもInternet Engineering Task Force（IETF）により定義され、仕様はIETFのWebサイト（http://www.ietf.org）で参照できます。配信システムでは、Secure FTPサーバーへの文書の配信をサポートしています。

次の表に、サポートされるプロパティを示します。特に記載がないかぎり、各プロパティには、1つの文字列値が必要です。

// create delivery manager instance
     DeliveryManager dm = new DeliveryManager();
     // create a delivery request
     DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_SFTP);
     // set hostname of the SFTP server
     req.addProperty(DeliveryPropertyDefinitions.SFTP_HOST, "mysftphost");
     // set username and password to access server
     req.addProperty(DeliveryPropertyDefinitions.SFTP_USERNAME, "myname");
     req.addProperty(DeliveryPropertyDefinitions.SFTP_PASSWORD, "mypassword");
     // set the remote directory that you want to send your document to
     req.addProperty(DeliveryPropertyDefinitions.SFTP_REMOTE_DIRECTORY, "pub");
     // set the remote file name
     req.addProperty(DeliveryPropertyDefinitions.SFTP_REMOTE_FILENAME, "test.pdf");
     // set the document
     req.setDocument("/document/test.pdf");

     // submit the request
     req.submit();
     // close the request
     req.close();

認証モード

Secure FTPを介した配信では、パスワード認証および公開鍵認証という2つの認証モードがサポートされています。モードを選択するには、プロパティSFTP_AUTH_TYPEを設定します。デフォルト・モードはパスワード認証です。

         :
         :
      // set public key auth type
      req.addProperty(DeliveryPropertyDefinitions.SFTP_AUTH_TYPE,
                      DeliveryPropertyDefinitions.SFTP_AUTH_TYPE_PUBLIC_KEY);
      // set username
      req.addProperty(DeliveryPropertyDefinitions.SFTP_USERNAME, "myname");
      // set the client's private key file
      req.addProperty(DeliveryPropertyDefinitions.SFTP_PRIVATE_KEY_FILE,
             "/path/to/the/key");
      // set the client's private key password
      req.addProperty(DeliveryPropertyDefinitions.SFTP_PRIVATE_KEY_PASSWORD, "myPrivateKeyPass");
         :
         :

パスワード認証モードでは、Secure FTPサーバーにログインする際にユーザー名とパスワードが必要です。次の例で、サンプル・コードを示しています。

:
         :
     // set password auth type
      req.addProperty(DeliveryPropertyDefinitions.SFTP_AUTH_TYPE,
                      DeliveryPropertyDefinitions.SFTP_AUTH_TYPE_PASSWORD);
      // set username and password to access server
      req.addProperty(DeliveryPropertyDefinitions.SFTP_USERNAME, "myname");
      req.addProperty(DeliveryPropertyDefinitions.SFTP_PASSWORD, "mypassword");
         :
         :

公開鍵承認モードでは、ユーザー名、秘密鍵および秘密鍵のパスワードが必要です。このモードはパスワード認証よりもセキュアな方法です。公開鍵認証モードを使用するには、事前にssh/Secure FTPサーバーで公開鍵を設定する必要があるので注意してください。次の例で、サンプル・コードを示しています。

         :
         :
      // set public key auth type
      req.addProperty(DeliveryPropertyDefinitions.SFTP_AUTH_TYPE,
                      DeliveryPropertyDefinitions.SFTP_AUTH_TYPE_PUBLIC_KEY);
      // set username
      req.addProperty(DeliveryPropertyDefinitions.SFTP_USERNAME, "myname");
      // set the client's private key file
      req.addProperty(DeliveryPropertyDefinitions.SFTP_PRIVATE_KEY_FILE,
                      "/path/to/the/key");
      // set the client's private key password
      req.addProperty(DeliveryPropertyDefinitions.SFTP_PRIVATE_KEY_PASSWORD, "myPrivateKeyPass");
         :
         :

HTTPを介した文書の配信

この配信マネージャは、HTTPサーバーへの文書の配信をサポートします。次のコード例では、HTTP POSTメソッドを介して文書を送信しています。受信するHTTPサーバーは、カスタムHTTP要求を（カスタム・サーブレットまたはCGIプログラムを介して）事前に受け入れることができる必要があります。

// create delivery manager instance
     DeliveryManager dm = new DeliveryManager();
     // create a delivery request
     DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_HTTP);

     // set request method
     req.addProperty(DeliveryPropertyDefinitions.HTTP_METHOD, DeliveryPropertyDefinitions.HTTP_METHOD_POST);
     // set document content type
     req.addProperty(DeliveryPropertyDefinitions.HTTP_CONTENT_TYPE, "application/pdf");
     // set the HTTP server hostname
     req.addProperty(DeliveryPropertyDefinitions.HTTP_HOST, "myhost");
     // set the HTTP server port number
     req.addProperty(DeliveryPropertyDefinitions.HTTP_PORT, "80");
     // set the target remote directory
     req.addProperty(DeliveryPropertyDefinitions.HTTP_REMOTE_DIRECTORY, "/servlet/");
     // set the remote filename (servlet class)
     req.addProperty(DeliveryPropertyDefinitions.HTTP_REMOTE_FILENAME, "uploadDocument");

     // set the document
     req.setDocument("/document/test.pdf");

     // submit the request
     req.submit();
     // close the request
     req.close();

次の表に、サポートされるプロパティを示します。特に記載がないかぎり、各プロパティには、1つの文字列値が必要です。

AS2を介した文書の配信

AS2は、Electronic Data Interchange-Internet Integration（EDI-INT）で定義された標準プロトコルの1つです。AS2はHTTPおよびその他のインターネット標準テクノロジに基づいており、セキュアな方法でインターネットを介してデータを交換するように設計されています。AS2の仕様は、RFC4130（http://www.ietf.org/で参照可能）で定義されています。配信システムでは、AS2サーバーへの文書の配信がサポートされています。サンプル・コードは次のとおりです。

// create delivery manager instance
    DeliveryManager dm = new DeliveryManager();
    // create a delivery request
    DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_AS2);

    // set AS2 message properties
    req.addProperty(DeliveryPropertyDefinitions.AS2_FROM, "Me");
    req.addProperty(DeliveryPropertyDefinitions.AS2_TO, "You");
    req.addProperty(DeliveryPropertyDefinitions.AS2_SUBJECT, "My EDI Message");
    req.addProperty(DeliveryPropertyDefinitions.AS2_CONTENT_TYPE, "applications/EDIFACT");

    // set HTTP properties
    req.addProperty(DeliveryPropertyDefinitions.AS2_HTTP_HOST, "as2hsot");
    req.addProperty(DeliveryPropertyDefinitions.AS2_HTTP_REMOTE_DIRECTORY, "/");
    req.addProperty(DeliveryPropertyDefinitions.AS2_HTTP_REMOTE_FILENAME, "as2");

    // set the document
    req.setDocument("/document/myEDIdoc");
    // submit the request
    DeliveryResponse res = req.submit();
    // close the request
    req.close();

次の表に、サポートされるプロパティを示します。特に記載がないかぎり、各プロパティには、1つの文字列値が必要です。

配信受領書

AS2サーバーは、あらゆるAS2要求に対してAS2配信受領書を常に発行します。AS2_DELIVERY_RECEIPT_DIRECTORYプロパティを設定して、配信受領書を格納する場所を指定します。このディレクトリを指定しない場合、配信受領書は無視されます。配信受領書ディレクトリを設定するコード例を次に示します。

         :
         :
 // Set the delivery receipt directory
 req.addProperty(DeliveryPropertyDefinitions.AS2_DELIVERY_RECEIPT_DIRECTORY, "/my/receipt/dir");
         :
         :

同期性

AS2サーバーには、同期または非同期の配信要求を送信できます。デフォルトでは要求は同期であるため、DeliveryResponseでただちにMessage Disposition Notification（MDN）を参照できます。

AS2_ASYNC_ADDRESSを要求に対して設定すると、要求は非同期になります。処理後、配信受領書の送信先をHTTP URLまたはEメール・アドレスのいずれかに指定できます。配信受領書を受け取るには、HTTPサーバーまたはEメール・アドレスの設定が必要です。

AS2_ASYNC_ADDRESSにEメール・アドレスを指定すると、配信APIは非同期要求を追跡できます。配信APIにEメール・アカウント情報を提供すると、配信APIでは定期的にEメール・アカウントを確認し、配信受領書を取得します。これに関するサンプル・コードは次のとおりです。

         :
         :
 // Set the email address - async request
 req.addProperty(DeliveryPropertyDefinitions.AS2_ASYNC_ADDRESS, "async_target@acme.com");

 // Set the delivery receipt directory
 req.addProperty(DeliveryPropertyDefinitions.AS2_DELIVERY_RECEIPT_DIRECTORY, "/my/receipt/dir");

 // Set the email server information where the delivery receipt will be delivered to.
 req.addProperty(
     DeliveryPropertyDefinitions.AS2_ASYNC_EMAIL_SERVER_HOST, "mail.acme.com");
 req.addProperty(
     DeliveryPropertyDefinitions.AS2_ASYNC_EMAIL_SERVER_USERNAME, "async_target");
 req.addProperty(
     DeliveryPropertyDefinitions.AS2_ASYNC_EMAIL_SERVER_PASSWORD, "mypassword");
 req.addProperty(
     DeliveryPropertyDefinitions.AS2_ASYNC_EMAIL_SERVER_FOLDER_NAME, "inbox");

 // set the document
 req.setDocument("/document/myEDIdoc");

 // submit the request with the DeliveryResponseListener
 req.submit(myDeliveryListener);
        :
        :

前述のコードに示すように、非同期要求を追跡するには、配信APIの非同期配信要求のメカニズムを使用する必要があります。詳細は「非同期配信要求」を参照してください。

文書の署名

配信APIでは安全な取引のために文書に署名ができます。これは公開鍵アーキテクチャに基づいているため、次の設定が必要です。

• 送信者側: 送信者の公開鍵/秘密鍵

  送信者は、PKCS12標準ファイルで送信者の公開鍵/秘密鍵が必要です。ファイルの拡張子は.p12です。そのファイルを、配信APIを実行するローカルのシステムに置きます。

• 受信者側（AS2サーバー側）: 送信者の公開鍵証明書

  受信者は送信者の公開鍵証明書が必要です。AS2サーバーへの証明書のインストールはサーバーによって異なります。通常は、特定の場所に.derまたは.cerの証明書をコピーする必要があります。作業の詳細はAS2サーバーのマニュアルを参照してください。

設定を完了すると、配信要求でプロパティを設定することで文書に署名ができます。これに関するサンプル・コードは次のとおりです。

        :
        :
 // Signing the document
 req.addProperty(DeliveryPropertyDefinitions.AS2_MESSAGE_SIGNATURE, "true");
 req.addProperty(DeliveryPropertyDefinitions.AS2_SENDER_PKCS12_FILE, "/path/to/mykey.p12");
 req.addProperty(DeliveryPropertyDefinitions.AS2_SENDER_PKCS12_PASSWORD, "welcome");
        :
        :

文書の暗号化

配信APIでは、安全な取引のために文書を暗号化できます。これは公開鍵アーキテクチャに基づいているため、次の設定が必要です。

• 送信者側: 受信者の公開鍵証明書

  送信者側では受信者の公開鍵証明書ファイルが必要です。ファイルの拡張子は.derまたは.cerです。そのファイルを、配信APIを実行するローカルのシステムに置きます。AS2サーバーの公開鍵証明書を取得する方法は、AS2サーバーのマニュアルを参照してください。

• 受信者側（AS2サーバー側）: 受信者の公開鍵/秘密鍵

  受信者側（AS2サーバー）には、受信者の公開鍵/秘密鍵が必要です。鍵を設定する方法は、AS2サーバーのマニュアルを参照してください。

設定が完了すると、配信要求でプロパティを設定することで文書を暗号化できます。サンプル・コードは次のとおりです。

        :
        :
 // Encrypting the document
 req.addProperty(DeliveryPropertyDefinitions.AS2_MESSAGE_ENCRYPTION, "true");
 req.addProperty(DeliveryPropertyDefinitions.AS2_RECEIVER_CERTIFICATES_FILE,  "/path/to/server-certificate.der");
        :
        :

外部コマンドを使用した文書の配信

配信APIでは、外部のオペレーティング・システム（OS）ネイティブのコマンドを使用した文書の配信をサポートしています。

OSネイティブのコマンドを、{file}プレースホルダを付けて指定します。実行時には、このプレースホルダが文書のファイル名に置き換わります。

配信ステータスは、OSコマンドの終了値によって決まります。値がゼロの場合、要求は成功したものとマークされます。

サンプル・コードは次のとおりです。

     // create delivery manager instance
     DeliveryManager dm = new DeliveryManager();
     // create a delivery request
     DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_EXTERNAL);
     // set the OS native command for delivery
     req.addProperty(ExternalDeliveryPropertyDefinitions.EXTERNAL_DELIVERY_COMMAND,
     "/usr/bin/lp -d myprinter {file}");
     // set the document
     req.setDocument("/document/test.pdf");

     // submit the request
     req.submit();
     // close the request
     req.close();

次のプロパティが、DeliveryPropertyDefinitionsでサポートされ、定義されています。

ローカル・ファイル・システムへの文書の配信

配信APIでは、配信APIを実行するローカル・ファイル・システムへの文書の配信をサポートしています。このコマンドにより、指定した場所にファイルがコピーされます。

次のサンプル・コードでは、ファイル/document/test.pdfが/destination/document.pdfにコピーされます。

     // create delivery manager instance
     DeliveryManager dm = new DeliveryManager();
     // create a delivery request
     DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_LOCAL);
     // set the document destination in the local filesystem.
     req.addProperty(ExternalDeliveryPropertyDefinitions.LOCAL_DESTINATION, "/destination/document.pdf");
     // set the document to deliver.
     req.setDocument("/document/test.pdf");

     // submit the request
     req.submit();
     // close the request
     req.close();

次のプロパティが、DeliveryPropertyDefinitonsでサポートされ、定義されています。

ダイレクト・モードとバッファリング・モード

配信システムでは、ダイレクト・モードとバッファリング・モードの2つのモードがサポートされています。バッファリング・モードがデフォルトです。

ダイレクト・モード

ダイレクト・モードでは、完全で効率的な配信処理ができます。文書は、宛先に直接接続している接続ストリームに配信されます。このモードは高速で、小規模なメモリーとディスク領域で使用でき、オンラインでの対話型処理にお薦めします。

ダイレクト・モードを設定するには、BUFFERING_MODEプロパティをfalseに設定します。次に、コード例を示します。

// create delivery manager instance
     DeliveryManager dm = new DeliveryManager();

     // create a delivery request
     DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_IPP_PRINTER);

     // set the direct mode
     req.addProperty(DeliveryPropertyDefinitions.BUFFERING_MODE, "false");
           :
           :
           :

このモードでは、文書の再配信ができません。再配信が必要な場合は、バッファリング・モードを使用します。

バッファリング・モード

バッファリング・モードでは、何度でも文書を再配信できます。配信サーバー構成ファイルに一時ディレクトリ（ds-temp-dir）を指定すると、配信システムでは、一時ファイルを使用して文書がバッファされます。一時ディレクトリを指定しない場合、配信システムではテンポラリのメモリー・バッファが使用されます。一時ディレクトリを定義することをお薦めします。この構成ファイルの詳細は、「構成ファイルのサポート」を参照してください。

一時ファイルまたはバッファは、配信要求の終了後、DeliveryRequest.close()をコールすることで明示的に消去できます。

// create delivery manager instance
     DeliveryManager dm = new DeliveryManager();

     // create a delivery request
     DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_IPP_PRINTER);

     // set buffering mode
     req.addProperty(DeliveryPropertyDefinitions.BUFFERING_MODE, "true");
     req.addProperty(DeliveryPropertyDefinitions.TEMP_DIR, "/tmp");
           :
           :
           :
     // submit request
     req.submit();
           :
           :
     // submit request again
     req.submit();
           :
           :
     // close the request
     req.close();

非同期配信要求

配信APIでは、コールバック関数を登録することにより、配信要求を非同期で実行できます。

DeliveryResponseListenerインタフェースを実装することにより、独自のコールバック・ロジックを作成できます。resposeReceived()メソッドの実装は必須です。このメソッドに作成したロジックを実装することで、配信要求が完了したときにロジックをコールできます。サンプル・コードは次のとおりです。

  import oracle.apps.xdo.delivery.DeliveryResponseListener;

  class MyListener implements DeliveryResponseListener
  {

    public void responseReceived(DeliveryResponse pResponse)
    {
      // Show the status to the System.out
      System.out.println("Request done!");
      System.out.println("Request status id  : " + pResponse.getStatus());
      System.out.println("Request status msg : " + pResponse.getStatusMessage());
    }

  }

コールバックを実装すると、DeliveryRequestのsubmit()メソッドをコールするときに、作成したコールバックを渡すことができます。submit()をコールバックとともにコールすると、バックグラウンドで配信処理が開始され、submit()メソッドがただちに制御を戻します。サンプル・コードは次のとおりです。

    // create delivery manager instance
    DeliveryManager dm = new DeliveryManager();

    // create a delivery request
    DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_IPP_PRINTER);
          :
          :
    // submit request with the callback logic
    req.submit(new MyListener());
          :
          :

文書フィルタのサポート

配信APIでは、サポートしているすべてのプロトコルで文書フィルタ機能をサポートしています。この機能により、それぞれの配信要求の前に文書を変換するネイティブOSのコマンドをコールできます。フィルタを指定するには、ネイティブOSのコマンド文字列を、入力と出力のファイル名である2つのプレースホルダ（{infile}および{outfile})とともに渡します。配信要求ではフィルタを配信プロパティとして設定できます。次に2つのサンプルを示します。

// The easiest filter, just copy the file :)
req.addProperty(DeliveryPropertyDefinitions.FILTER, "cp {infile} {outfile}");


// Call "pdftops" utility to transform the PDF document into Postscript format
 req.addProperty(DeliveryPropertyDefinitions.FILTER, "pdftops {infile} {outfile}");

あるいは、構成ファイルで各サーバーのフィルタを指定することもできます(「構成ファイルのサポート」を参照)。この場合、このサーバーに対する要求には常にこのフィルタが使用されます。

         :
         :

<server name="printer1" type="ipp_printer" default="true">
<uri>ipp://myserver:80/printers/MyPrinter1/.printer</uri>
<filter>pdftops {infile} {outfile}</filter>
</server>
         :
         :

これは特に、直接またはMicrosoft Internet Information Service（IIS）でIPPプリンタをコールする場合に役立ちます。これらのプリンタでは通常PDF文書には対応せず、一部の文書形式にのみ対応しているためです。この機能により、ターゲットのプリンタが対応できる形式に文書を変換させるネイティブOSのコマンドをコールできます。たとえば、Microsoft IISで設定されたHP LaserJetプリンタをLinuxからコールする場合、PDF文書をHP LaserJetが対応できる形式に変換するフィルタとしてGhostscriptを設定できます。

     // specify filter
     req.addProperty(DeliveryPropertyDefinitions.FILTER,
     "gs -q -dNOPAUSE -dBATCH -sDEVICE=laserjet -sOutputFile={outfile}
      {infile}");

この機能を使用するには、バッファリング・モードを使用可能にし、一時ディレクトリを指定する必要があります。これらのプロパティの設定の詳細は、「構成ファイルのサポート」を参照してください。

日付式のサポート

3つのプロパティで日付式がサポートされます。日付式は、ファイル名を日付で設定したり、実行時に日付を自動的に設定する場合に使用します。

日付式をサポートしているプロパティは、次のとおりです。

• SMTP_CONTENT_FILENAME

• FTP_REMOTE_FILENAME

• WEBDAV_REMOTE_FILENAME

サポートされている日付式は、次のとおりです。

• %y : 4桁の年（例: 1972、2005）

• %m : 2桁の月（00から12）

• %d : 2桁の日（00から31）

• %H : 24時間書式の2桁の時間（00から24）

• %M : 2桁の分（00から59）

• %S : 2桁の秒（00から59）

• %l : 3桁のミリ秒（000から999）

たとえば、ファイル名にmy_file_%y%m%d.txtと指定した場合、2005年11月8日であれば実際のファイル名はmy_file_20051108.txtとなります。すべての未定義の式はゼロ長の文字列に変換されます。たとえば、my_file_%a%b%c.txtと指定した場合、生成されるファイル名はmy_file_.txtとなります。「%」文字は「%%」を渡すことでエスケープできます。

国際化

配信サーバーAPIでは、リストした配信チャネルに対して次の国際化機能がサポートされます。

SMTP

• メイン文書の文字エンコードをSMTP_CONTENT_TYPEに指定します。

• addAttachment() methodメソッドのコール時に、コンテンツ・タイプを渡すことにより添付の文字エンコードを指定します。

• EメールのTo/From/CC/Subjectの文字エンコードをSMTP_CHARACTER_ENCODINGプロパティに指定します。デフォルト値は「UTF-8」です。

IPP

• IPP属性の文字エンコードをIPP_ATTRIBUTE_CHARSETプロパティを使用して指定します。デフォルト値は「UTF-8」です。

• URLの非ASCII文字のエンコードをIPP_URL_CHARACTER_ENCODINGプロパティで指定します。

WebDAV

• URLの非ASCII文字のエンコードをWEBDAV_URL_CHARACTER_ENCODINGプロパティで指定します。

FTP

• FTP配信チャネルでは、ターゲットのFTPサーバーがサポートしている国際化が自動的に検出されます。非ASCII文字のディレクトリ名やファイル名はFTPサーバーが国際化をサポートしている場合にのみ指定できます（詳細はRFC 2640を参照）。この場合、UTF-8エンコードが自動的に使用されます。国際化をサポートしていないサーバーで非ASCII値を指定した場合、配信処理中に例外が戻されます。

HTTP

• URLの非ASCII文字のエンコードをWEBDAV_URL_CHARACTER_ENCODINGプロパティで指定できます。

配信ステータスのモニタリング

配信システムでは、getStatus()メソッドをコールすることで、要求の最新配信ステータスを確認できます。この要求ステータスはいつでも確認できますが、配信要求オブジェクトは現在保持している必要があります。ステータスの定義は、DeliveryRequestインタフェースで定義されます。

SMTP配信チャネルとHTTP配信チャネルについては、配信ステータスをモニタリングできません。

// create delivery manager instance
     DeliveryManager dm = new DeliveryManager();

     // create a delivery request
     DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_IPP_PRINTER);
           :
           :
     // submit request
     req.submit();
           :
           :

     // get request status
     int status = req.getStatus();
     if (status == DeliveryRequest.STATUS_SUCCESSFUL)
     {
        System.out.println("Request has been delivered successfully.");
     }
           :
           :
     // get request status again...
     status = req.getStatus();
           :
           :

グローバル・プロパティ

すべての配信要求がグローバル・プロパティを自動的に継承するように、DeliveryManagerにグローバル・プロパティを定義できます。

次のグローバル・プロパティがサポートされています。

// create delivery manager instance
     DeliveryManager dm = new DeliveryManager();

     // set global properties
     dm.addProperty(DeliveryPropertyDefinitions.TEMP_DIR, "/tmp");
     dm.addProperty(DeliveryPropertyDefinitions.BUFFERING_MODE, "true");

     // create delivery requests
     DeliveryRequest req1 = dm.createRequest(DeliveryManager.TYPE_IPP_PRINTER);
     DeliveryRequest req2 = dm.createRequest(DeliveryManager.TYPE_IPP_FAX);
     DeliveryRequest req3 = dm.createRequest(DeliveryManager.TYPE_SMTP_EMAIL);
           :
           :

カスタム配信チャネルの追加

次の手順によって、システムにカスタム配信チャネルを追加できます。

1. 配信プロパティを定義します。

2. DeliveryRequestインタフェースを実装します。

3. DeliveryRequestHandlerインタフェースを実装します。

4. DeliveryRequestFactoryインタフェースを実装します。

5. DeliveryManagerにカスタムのDeliveryRequestFactoryを登録します。

次の各項では、ローカル・ファイル・システムに文書を配信するFile delivery channelというサンプルを使用して、カスタム配信チャネルの作成方法を説明します。

配信プロパティの定義

カスタム配信チャネルを追加する最初の手順は、プロパティの定義です。プロパティは、チャネルで実行する内容によって異なります。プロパティには定数を定義できます。次のコード例にあるファイル配信チャネルに必要なプロパティは1つのみで、そのプロパティは宛先です。

次に、コード例を示します。

package oracle.apps.xdo.delivery.file;

public interface FilePropertyDefinitions
  {
     /** Destination property definition.  */
     public static final String FILE_DESTINATION = "FILE_DESTINATION:String";

   }

各定数値は、文字列であるかぎり任意の値にできます。値は、プロパティ値が実行時に配信システムで自動的に検証されるように、[プロパティ名]:[プロパティ値タイプ]の形式で定義することをお薦めします。この例にあるFILE_DESTINATIONプロパティには1つの文字列値が定義されています。

DeliveryRequestインタフェースの実装

DeliveryRequestは、文書情報と配信メタデータ（宛先や他のプロパティなど）が含まれた配信要求を表します。oracle.apps.xdo.delvery.DeliveryRequestを実装するために、クラスoracle.apps.xdo.delivery.AbstractDeliveryRequestを拡張できます。

たとえば、ローカル・ファイル・システムに文書を配信するためのカスタム配信チャネルを作成するには、次のようにDeliveryRequestを実装します。

package oracle.apps.xdo.delivery.file;
import oracle.apps.xdo.delivery.AbstractDeliveryRequest;

public class FileDeliveryRequest extends AbstractDeliveryRequest
implements FilePropertyDefinitions
{
  private static final String[] MANDATORY_PROPS = {FILE_DESTINATION};

  /**
   * Returns mandatory property names
   */
  public String[] getMandatoryProperties()
  {
    return MANDATORY_PROPS;
  }
  /**
   * Returns optional property names
   */
  public String[] getOptionalProperties()
  {
    return null;
  }
}

DeliveryRequestHandlerインタフェースの実装

DeliveryRequestHandlerには、配信要求を処理するためのロジックが含まれています。次に、ファイル配信チャネル用のoracle.apps.xdo.delivery.DeliveryRequestHandlerの実装例を示します。

package oracle.apps.xdo.delivery.file;
import java.io.BufferedOutputStream;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStream;

import oracle.apps.xdo.delivery.DeliveryException;
import oracle.apps.xdo.delivery.DeliveryRequest;
import oracle.apps.xdo.delivery.DeliveryRequestHandler;
import oracle.apps.xdo.delivery.DeliveryStatusDefinitions;

public class FileDeliveryRequestHandler implements DeliveryRequestHandler
{

  private FileDeliveryRequest mRequest;
  private boolean mIsOpen = false;
  private OutputStream mOut;

  /**
   * default constructor.
   */
  public FileDeliveryRequestHandler()
  {
  }

  /**
   * sets the request.
   */
  public void setRequest(DeliveryRequest pRequest)
  {
    mRequest = (FileDeliveryRequest) pRequest;
  }

  /**
   * returns the request.
   */
  public DeliveryRequest getRequest()
  {
    return mRequest;
  }

  /**
   * opens the output stream to the destination.
   */
  public OutputStream openRequest() throws DeliveryException
  {
    try
    {
      String filename =
        (String) mRequest.getProperty(FileDeliveryRequest.FILE_DESTINATION);
      mOut = new BufferedOutputStream(new FileOutputStream(filename));

      mIsOpen = true;
      // set request status to open
      mRequest.setStatus(DeliveryStatusDefinitions.STATUS_OPEN);
      return mOut;

    }
    catch (IOException e)
    {
      closeRequest();
      throw new DeliveryException(e);
    }

  }

  /**
   * flushes and closes the output stream to submit the request.
   */
  public void submitRequest() throws DeliveryException
  {
    try
    {
      // flush and close
      mOut.flush();
      mOut.close();
      // set request status
      mRequest.setStatus(DeliveryStatusDefinitions.STATUS_SUCCESSFUL);
      mIsOpen = false;
    }
    catch (IOException e)
    {
      closeRequest();
      throw new DeliveryException(e);
    }
  }

  /**
   * checks the delivery status.
   */
  public void updateRequestStatus() throws DeliveryException
  {

    // check if the file is successfully delivered
    String filename =
      (String) mRequest.getProperty(FileDeliveryRequest.FILE_DESTINATION);
    File f = new File(filename);

    // set request status
    if (f.exists())
      mRequest.setStatus(DeliveryStatusDefinitions.STATUS_SUCCESSFUL);
    else
      mRequest.setStatus(DeliveryStatusDefinitions.STATUS_FAILED_IO_ERROR);

  }
  /**
   * returns the request status.
   */
  public boolean isRequestOpen()
  {
    return mIsOpen;
  }

  /**
   * closes the request, frees all resources.
   */
  public void closeRequest()
  {
    mIsOpen = false;
    try
    {
      if (mOut != null)
      {
        mOut.flush();
        mOut.close();
      }
    }
    catch (IOException e)
    {
    }
    finally
    {
      mOut = null;
    }
  }

}

DeliveryRequestFactoryインタフェースの実装

配信システムにカスタム配信チャネルを登録するには、DeliveryRequestFactoryインタフェースを実装します。

次に、oracle.apps.xdo.delivery.DeliveryRequestFactoryの実装例を示します。

package oracle.apps.xdo.delivery.file;

import oracle.apps.xdo.delivery.DeliveryRequest;
import oracle.apps.xdo.delivery.DeliveryRequestFactory;
import oracle.apps.xdo.delivery.DeliveryRequestHandler;

public class FileDeliveryRequestFactory
implements DeliveryRequestFactory
{
  /**
   * default constructor.
   */
  public FileDeliveryRequestFactory()
  {
  }
  /**
   * returns delivery request.
   */
  public DeliveryRequest createRequest()
  {
    return new FileDeliveryRequest();
  }
  /**
   * returns delivery request handler.
   */
  public DeliveryRequestHandler createRequestHandler()
  {
    return new FileDeliveryRequestHandler();
  }
  /**
   * returns this
   */
  public DeliveryRequestFactory getFactory()
  {
    return this;
  }
}

DeliveryManagerへのカスタムDeliveryRequestFactoryの登録

最後の手順では、配信システムにカスタム配信チャネルを登録します。配信チャネルは次の2つの方法で登録できます。

• 静的メソッド

  このメソッドを使用して配信チャネルを構成ファイルに指定し、その配信チャネルを配信システム全体に登録します。詳細は、「構成ファイルのサポート」を参照してください。

• 動的メソッド

  登録するAPIをプログラムでコールすることで、Java VMインスタンスに配信チャネルを登録します。

  次に、動的メソッドを使用してファイル配信チャネルを登録し、そのファイル配信チャネルをコールするためのコード例を示します。

  package oracle.apps.xdo.delivery.file;
  
  import oracle.apps.xdo.delivery.DeliveryManager;
  import oracle.apps.xdo.delivery.DeliveryRequest;
  
  public class FileDeliverySample
  {
    public static void main(String[] args) throws Exception
    {
      // register the file delivery channel
      DeliveryManager.addRequestFactory("file", "oracle.apps.xdo.delivery.file.FileDeliveryRequestFactory");
  
      // create delivery manager instance
      DeliveryManager dm = new DeliveryManager();
      // create a delivery request
      DeliveryRequest req = dm.createRequest("file");
  
      // set the destination
      req.addProperty(
        FileDeliveryRequest.FILE_DESTINATION,
        "d:/Temp/testDocument_delivered.pdf");
      // set the document to deliver
      req.setDocument("D:/Temp/testDocument.pdf");
  
      // submit the request
      req.submit();
      // close the request
      req.close();
    }
  }

構成ファイルのサポート

配信システムでは、デフォルト・サーバー、デフォルト・プロパティおよびカスタム配信チャネルを設定するための構成ファイルがサポートされています。構成ファイルの位置は次のとおりです。

{XDO_TOP}/resource/xdodelivery.cfg

{XDO_TOP}は、物理ディレクトリを指し示すJavaシステム・プロパティです。

このシステム・プロパティは、次の2つの方法で設定できます。

• -DXDO_TOP=/path/to/xdotopをJava起動パラメータに渡します。

• コードには、java.lang.System.getProperties().put("XDO_TOP", "/path/to/xdotop")などのJava APIを使用します。

DeliveryManagerオブジェクトを構成する前に、システム・プロパティを定義する必要があります。

次に、構成ファイルの例を示します。

<?xml version='1.0' encoding='UTF-8'?>
 <config xmlns="http://xmlns.oracle.com/oxp/delivery/config">
   <! -  ========================================================  - >
   <! -     servers section                                        - >
   <! -     List your pre-defined servers here.                    - >

   <! -  ========================================================  - >
   <servers>
     <server name="myprinter1" type="ipp_printer" default="true">
       <uri>ipp://myprinter1.oracle.com:631/printers/myprinter1</uri>

     </server>
     <server name="myprinter2" type="ipp_printer" >
       <host>myprinter2.oracle.com</host>
       <port>631</port>

       <uri>ipp://myprinter2.oracle.com:631/printers/myprinter2</uri>
       <authType>basic</authType>
       <username>xdo</username>
       <password>xdo</password>

     </server>
     <server name="myfax1" type="ipp_fax" default="true" >
       <host>myfax1.oracle.com</host>

       <port>631</port>
       <uri>ipp://myfax1.oracle.com:631/printers/myfax1</uri>
     </server>
     <server name="mysmtp1" type="smtp_email" default="true">

       <host>myprinter1.oracle.com</host>
       <port>25</port>
     </server>
     <server name="mysmtp2" type="smtp_email" >

       <host>mysmtp12.oracle.com</host>
       <port>25</port>
       <username>xdo</username>
       <password>xdo</password>

     </server>
   </servers>
   <! -  ========================================================  - >
   <! -     properties section                                     - >
   <! -     List the system properties here.                       - >
   <! -  ========================================================  - >
   <properties>

     <property name="ds-temp-dir">/tmp</property>
     <property name="ds-buffering">true</property>
   </properties>
   <! -  ========================================================  - >
   <! -      channels section                                      - >

   <! -      List the custom delivery channels here.               - >
   <! -  ========================================================  - >
   <channels>
     <channel name="file">oracle.apps.xdo.delivery.file.FileDeliveryRequestFactory</channel>
   </channels>

 </config>

配信チャネルに対する複数サーバーの定義

各配信チャネルには、複数のサーバー・エントリを定義できます。たとえば、前述の構成ファイルの例では、ipp_printer配信チャネルに対して2つのサーバー・エントリ（myprinter1およびmyprinter2）があります。

DeliveryRequest.setServer()メソッドをコールして、配信要求にサーバー・エントリをロードします。次に例を示します。

// create delivery manager instance
     DeliveryManager dm = new DeliveryManager();
     // create a delivery request
     DeliveryRequest req = dm.createRequest(DeliveryManager.TYPE_IPP_PRINTER);

     // load myprinter1 setting
     req.setServer("myprinter1");

配信チャネルに対するデフォルト・サーバーの指定

配信チャネルにデフォルト・サーバーを定義するには、default="true"を指定します。前述の構成ファイルの例では、myprinter1がipp_printer配信チャネルのデフォルト・サーバーとして定義されています。ユーザーがipp_printer配信のサーバー・プロパティを指定していない場合は、デフォルト・サーバーの下のサーバー・プロパティが使用されます。

サポートされている構成ファイルのプロパティおよび要素

<properties>セクションでサポートされているプロパティは、次のとおりです。

• ds-temp-dir: 一時ディレクトリの場所。

• ds-buffering: バッファリング・モードに対してtrueまたはfalseを指定。

• ds-ca-cert-file: SSL証明書ファイルの場所を指定。

<server type="ipp_printer">および<server type="ipp_fax">では、次の要素がサポートされています。

• <host>

• <port>

• <printerName>

• <uri>

• <username>

• <password>

• <authType>

• <encType>

• <proxyHost>

• <proxyPort>

• <proxyUsername>

• <proxyPassword>

• <proxyAuthType>

• <filter>

<server type="smtp_email">では、次の要素がサポートされています。

• <host>

• <port>

• <uri>

• <username>

• <password>

• <authType>

• <filter>

<server type="webdav">では、次の要素がサポートされています。

• <host>

• <port>

• <uri>

• <username>

• <password>

• <authType>

• <encType>

• <proxyHost>

• <proxyPort>

• <proxyUsername>

• <proxyPassword>

• <proxyAuthType>

• <filter>

<server type="ftp">および<server type="sftp">では、次の要素がサポートされています。

• <host>

• <port>

• <uri>

• <username>

• <password>

• <filter>

<server type="external">では、次の要素がサポートされています。

• <command>

• <filter>

CUPSの設定

配信マネージャには、文書を印刷およびFAX送信するためのCommon Unix Printing System（CUPS）が必要です。この項では、RedHat Linuxで印刷およびFAX送信するCUPSの設定方法を説明します。

次の図に、XMLパブリッシャとCUPSの統合を示します。

次の各手順では、CUPSにプリンタおよびFAXを追加する方法、およびその設定のテスト方法を説明します。『CUPS Software Administrators Manual』（http://www.cups.org/doc-1.1/sam.html）およびRedhat Advanced Serverのオンライン・ヘルプを参照してください。

前提条件

• RedHat Advanced Server 3.0

• Linuxボックスに接続したFAXモデム

• インストールしたRedHat Advanced Server用の開発ツール

• CUPS（RedHat AS 3.0のインストール時にデフォルトでインストールされます）

CUPSでのプリンタ設定

RedHat Advanced Serverには、プリンタの設定に役立つ構成ウィザードが用意されています。RedHatプロセスの要約を次に示します。

RedHatプリンタ構成ウィザードの使用

1. 「redhat-config-printer」を実行します。

   ルート・ユーザーでログインした際に、端末を開いて「redhat-config-printer」を実行します。これによって、「Printer configuration」ウィンドウが起動します。

2. 「New」タブを選択して、Add a new print queueウィザードを起動します。

3. ウィザードのプロンプトに従って、次の操作を実行します。

   • キュー名を入力します。

   • キュー・タイプを選択します。

     「Networked_JetDirect」を選択して、ネットワーク・プリンタを設定します。この選択では、次の内容も入力する必要があります。

     • Printer - ホスト名またはIPアドレスを入力します。

     • Port - ポートを入力します。

     Microsoft Windowsにプリンタ・ドライバがインストールされている場合、プリンタとポートの情報は、そのプリンタの「Properties」ダイアログ（「設定」->「Printers and Faxes」->「（select printer）」->「File」->「Properties」）から入手できます。

   • プリンタ・モデルを選択します。

     使用しているプリンタがPostScriptをサポートしている場合は、次を選択します。

     • Manufacturer: Generic

     • Model: PostScript Printer

   • 選択内容を確認し、「Apply」を選択して新規の印刷キューを作成します。

4. 新規キューが「Printer configuration」ウィンドウに表示されます。

CUPSでのプリンタのテスト

1. RedHatでブラウザを起動し、次のURLを入力します。

   http://localhost:631

2. 「Printers」タブを選択します。作成したプリンタがリストされます。

   Windowsのブラウザを使用してこのページにアクセスするには、「他のマシンからCUPSへのアクセス」を参照してください。

3. 「Print Test Page」を選択して、プリンタの設定をテストします。テスト・ページが印刷されない場合は、構成手順を繰り返します。プリンタ・タイプとモデルが正しく選択されていることを確認してください。

CUPS用FAXのインストールと設定

この項では、efax-0.9ソフトウェアをインストールしてCUPS用に構成する方法を説明します。

FAXソフトウェアのインストール

1. 次のいずれかの場所からefax-0.9をダウンロードします。

   • http://www.cce.com/efax/download/

   • ftp://ftp.metalab.unc.edu/pub/Linux/apps/serialcomm/fax/efax-0.9.tar.gz

2. 次のコマンドを使用して、このファイルを作業ディレクトリに抽出します。

   • gunzip efax-0.9.tar.gz

   • tar xvf efax-0.9.tar

3. 次のコマンドを使用して、コンパイルおよびインストールします（詳細は、Readmeを参照）。

   • make

   • make install

   注意: 使用するRedHat ASには、makeおよびgccをインストールしておく必要があります。

4. FAXをテストします。

   次のコマンドを入力します。

   fax send <fax_number><tiff file>

   次に例を示します。

   fax send 1234567 test.tiff

   次のリターン・コードを取得した場合、FAXは正常に送信されています。

   done, returning 0 (success)

5. fax4CUPをダウンロードします。次のサイトから入手できます。

   • http://www.gnu.org/directory/productivity/special/fax4CUPS.html

6. 次のように、fax4CUPSをインストールします。

   • tarファイルを一時ディレクトリに抽出します。

   • このディレクトリをcd fax4CUPS-1.23で変更します。

   • INSTALLファイルを開き、すべての手順を実行します。

7. 次のコマンドを使用して、CUPSを再起動します。

   /etc/rc.d/init.d/cups restart

CUPSでのFAX設定

1. ブラウザを起動し、URL http://localhost:631/adminに移動します。

2. 起動されたダイアログに、管理者のユーザー名とパスワードを入力します。

3. 「Admin」ページで「Add Printer」を選択します。

4. 次のように、FAXキューを追加します。

   「Add New Printer」リージョンで、次のフィールドに入力します。

   • Name - efaxserverなどのわかりやすい名称を入力します。これによって、ipp://serverName:631/printers/efaxserverと表示されます。

   • Location - オプション

   • Description - オプション

5. FAXキューのデバイスを選択します。

   「Faxmodem (efax on /dev/modem)」を選択します。場合によっては、かわりに「/dev/ttySxx」が表示されます。

6. FAXキューのモデルを選択します。

   「efax」を選択します。「HylaFAX」または「mgetty-fax」も、インストールしている場合は選択できます。

7. FAXキューのドライバを選択します。

   「efax (en)」を選択します。

8. 「CUPS Admin」Webページに表示されている新規のFAXキューを検証します。

9. CUPSでFAXをテストします。

   FAXをテストするには、次のコマンドを入力します。

   /usr/bin/lp -d <printer name> -t <phone#> test.pdf

   例:

   /usr/bin/lp -d efax1 -t 5556231 myfax.pdf

他のマシンからCUPSへのアクセス

デフォルトでは、他のネットワーク・マシンからCUPSにアクセスすることはできません。ただし、次のように、アクセスが可能になるように構成できます。

1. 次のコマンドを使用して、CUPS構成ファイルを開きます。

   Open /etc/cups/cupsd.conf

2. Listen命令を追加します。

   • 構成ファイルの下部にスクロールします。ここには他のListen命令が宣言されています。

   • 「Listen 127.0.0.1:631」をコピーして、オリジナルの上か下に貼り付けます。

   • 「127.0.0.1」をLinuxサーバーのIPアドレスに置換します。

3. 各プリンタを構成します。

   • 構成ファイルで次の位置を検索します。

     <Location /printers/your_printer_queue>

   • 「Deny From All」命令をコメントにします。

     例:

     # Deny From All

   • 「Allow from 127.0.0.1」を「Allow from All」に変更します。

   • アクセスを可能にするすべてのプリンタまたはFAXキューについて、この手順を繰り返します。

4. 構成ファイルを保存し、CUPSを再起動します。

   • CUPSを停止するには、次のコマンドを使用します。

     /etc/rc.d/init.d/cups stop

   • CUPSを開始するには、次のコマンドを使用します。

     /etc/rc.d/init.d/cups start

5. 他のマシンからのアクセシビリティをテストします。

   別のマシンからブラウザを起動して、次のいずれかのURLを入力し、CUPSのWebページにアクセスできることを確認します。

   • http://linux_server_name:631

   • http://linux_ip_address:631

Copyright © 2006, Oracle. All rights reserved.