OPRO X Server のリクエストを受け付けるゲートウェイ (CGI / サーブレット) に対し、Web ブラウザからリクエストし、OPRO X Server で生成したドキュメント(OPR、PDFなど)をメールで送信する方法について記述します。
事前に OPRO X Server のセットアップ・動作確認(Windows / UNIX)の作業が完了している必要があります。
OPRO X Server がドキュメントを生成するには、OPRO X Designer で設計したテンプレートファイル (.oxt) が必要となります。
ここでは、簡単なテンプレート(Labelを一つ配置しただけのもので構いません)を用意してください。
作成したテンプレート(.oxt)を、「IN_FILE ディレクトリの作成」(Windows / UNIX)で作成したディレクトリに配置してください。
[OXS_HOME]/conf/ODCAW.xml で、メール送信のための設定を行います。通常は、以下の赤で記された項目のみで問題ありません。
<OMPS active="YES"> <!-- YESであることを確認してください。--> <OMPS_COMMON> <MAIL> <SMTPSERVER> <HOST>mail.host</HOST><!-- 確認メールを送信する際に使用する SMTPサーバのIPアドレスを指定してください。--> <PORT>25</PORT> <RETRY_INTERVAL unit="mins">0</RETRY_INTERVAL> <RETRY_ATTEMPTS>3</RETRY_ATTEMPTS> <CHARSET>ISO-2022-JP</CHARSET> </SMTPSERVER> <CONFIRMATION_SENDER allow="YES">admin@mail.host</CONFIRMATION_SENDER> </MAIL> </OMPS_COMMON> <ODMS active="YES" alias="ODMS_SERVER1"> <!-- YESであることを確認してください。--> <SMTP> <SERVER> <HOST>127.0.0.1</HOST> <!-- メールを送信する際に使用する SMTPサーバのIPアドレスを指定してください。--> <PORT>25</PORT> <RETRY_INTERVAL unit="mins">0</RETRY_INTERVAL> <RETRY_ATTEMPTS>3</RETRY_ATTEMPTS> <CHARSET>ISO-2022-JP</CHARSET> </SERVER>
例えば、OPRO X Serverを呼び出すインターフェイスとしてCGIを使用しており、URLが「http://127.0.0.1/scripts/odcaw2_cgi.exe」である場合、Template1.oxtから生成したPDFファイルをメール送信するためのリクエスト内容は、以下のようになります。
それぞれのパラメータに対する値は、以下のように指定してください。
パラメータ | 値 |
---|---|
DO | 「実行」を意味する「ex」を指定してください。 |
OP | 「メール送信」を意味する「ml」を指定してください。 |
FM | フォーマット(o=OPR, p=PDF, h=HTML等)を指定してください。 |
UN | ODCAW.xmlの、ODMS_INFOで設定したユーザ名を指定してください。ここでは「ADMIN」を指定しています。 |
PW | ODCAW.xmlの、ODMS_INFOで設定したパスワードを指定してください。ここでは「admin」を指定しています。 |
TS0 | ODCAW.xmlの、ODMS_INFOで設定したURLのnameを指定してください。ここでは「DEFAULT」を指定しています。 |
DN0_0 | ODCAW.xmlの、ODMS/SMTP/SERVER/HOSTで設定したSMTPを指定してください。ここでは「127.0.0.1」を指定しています。 |
MT0_0 | 宛先メールアドレスを指定してください。ここでは「user@mail.host」を指定しています。 |
MF | 差出人メールアドレスを指定してください。ここでは「admin@mail.host」を指定しています。 |
MSJ | メールの件名 |
MB | メールの本文 |
MA | 添付ファイル名 |
TP | テンプレート名を指定してください。ここでは「Template1」を指定しています。 |
ES | 「実行サービス名」として「odds」を指定してください。 |
※ メール送信のためのパラメータはこの他にもあります。詳しくは CGI / サーブレット パラメータリスト もしくは、OPRO X Designer のサンプル HTMLを参照してください。
上記のリクエストを実行すると、Web ブラウザに以下のような画面が表示されます。