レンディション変換プラグイン設定ファイル(EDMRDRPlugins.ini)は,レンディション変換で使用するレンディション変換プラグインの設定を行うファイルです。
レンディション変換プラグイン設定ファイルの設定例を次に示します。
[plugin1]
plugin=<インストールディレクトリ>¥bin¥EDMRDRPFGPDF.DLL
to=application/pdf
from1=application/msword
from2=application/vnd.ms-excel
from3=application/vnd.ms-powerpoint
from4=application/vnd.visio
from5=application/rtf
from6=application/jxw
from7=text/plain
from8=image/tiff
from9=image/jpeg
from10=image/gif
from11=image/png
from12=application/postscript
from13=message/rfc822
from14=application/vnd.ms-word.document.macroEnabled.12
from15=application/vnd.openxmlformats-officedocument.wordprocessingml.document
from16=application/vnd.ms-excel.sheet.binary.macroEnabled.12
from17=application/vnd.ms-excel.sheet.macroEnabled.12
from18=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
from19=application/vnd.ms-powerpoint.presentation.macroEnabled.12
from20=application/vnd.openxmlformats-officedocument.presentationml.presentation
opt_endpoint= http://servername:port/pdfg-ws/services/PdfGenInterface
opt_useproxy=false
opt_proxyservername=
opt_proxyserverport=
opt_proxyusrname=
opt_proxyusrpassword=
opt_maxpsfilesizews=
opt_timeout=
opt_converttopstimeout=
opt_pollinginterval=
opt_printer=Acrobat Distiller J
opt_joboptionsettingname=
opt_securitysettingname=
opt_filetypesettingname=
opt_bookmarkautocreate=false
opt_pptfittopage=true
opt_messagelocale=ja_JP
opt_pdfgenerator=7
opt_webserviceuser=
opt_webservicepass=
[plugin1]
plugin=<インストールディレクトリ>¥bin¥EDMRDRPLWD12.DLL
to=application/pd
from1=application/msword
from2=application/rtf
from3=application/vnd.ms-word.document.macroEnabled.12
from4=application/vnd.openxmlformats-officedocument.wordprocessingml.document
from5=text/plainplugin_timeout=
[plugin2]
plugin=<インストールディレクトリ>¥bin¥EDMRDRPLXL12.DLL
to=application/pdf
from1=application/vnd.ms-excel
from2=application/vnd.ms-excel.sheet.binary.macroEnabled.12
from3=application/vnd.ms-excel.sheet.macroEnabled.12
from4=application/vnd.openxmlformats-officedocument.spreadsheetml.sheetplugin_timeout=
[plugin3]
plugin=<インストールディレクトリ>¥bin¥EDMRDRPLPP12.DLL
to=application/pdf
from1=application/vnd.ms-powerpoint
from2=application/vnd.ms-powerpoint.presentation.macroEnabled.12
from3=application/vnd.openxmlformats-officedocument.presentationml.presentationplugin_timeout=
レンディション変換プラグイン設定ファイルに設定できるセクションは,plugin<n>セクションです。<n>は1からの通番で,plugin1からplugin32まで最大32個のセクションを指定できます。1個のセクションが1個のレンディション変換プラグインの定義となります。33個以上のセクションを指定した場合,33個目以降のセクションは無視されます。最低1個のセクションを定義することが必要です。デフォルトでは<PDFstaffを使用する場合>のplugin1セクションが設定されています。
plugin<n>セクションに設定できるエントリについて,基本設定,PDF変換プラグインのオプション設定,およびユーザ定義プラグインの設定に分けて説明します。
レンディション変換プラグイン設定ファイルの基本設定用エントリを次の表に示します。
表6-3 レンディション変換プラグイン設定ファイルの基本設定用エントリ
エントリ名 | 説明 | 省略時の仮定値 | インストール時の値 |
---|---|---|---|
plugin | 使用するレンディション変換プラグインのファイルパスをフルパスで指定します。省略はできません。 次に示すプラグインのファイルパスが指定できます。
| 必須 | <インストールディレクトリ>¥bin¥EDMRDRPFGPDF.DLL |
plugin_timeout | Microsoft Officeを使用する場合,またはユーザ定義プラグインを使用する場合,プラグインの変換処理のタイムアウト値をミリ秒単位で指定します。 指定できる値の範囲は300000~4294967295です。 0を指定すると,タイムアウト値は無限となります。 PDFstaffを使用する場合,このエントリは指定しないでください。PDFstaffの変換処理のタイムアウト値は,opt_timeoutエントリとopt_converttopstimeoutエントリで指定してください。 | 1800000 | なし |
to | 変換先レンディションタイプを指定します。省略はできません。 先頭の"MIME::"を取り除いて249バイト以内で指定します。 レンディションタイプの詳細は,「6.5 レンディションタイプの指定方法」を参照してください。 | 必須 | application/pdf |
from<n> | pluginエントリで指定したレンディション変換プラグインが受け付ける変換元レンディションタイプを指定します。省略はできません。 エントリ名の<n>は,1からの通番です。 from1からfrom100まで最大100個のエントリを指定できます。101個以上のエントリを指定した場合,101個目以降のエントリは無視されます。 各エントリのレンディションタイプは,先頭の"MIME::"を取り除いて249バイト以内で指定します。 レンディションタイプの詳細は,「6.5 レンディションタイプの指定方法」を参照してください。 | 必須(最低1個) |
|
uoc | UOCを実行する場合,UOCを格納したファイルのファイルパスをフルパスで指定します。指定を省略すると,UOCは無効となります。 このエントリは,PDFstaffを使用する場合だけ有効になります。Microsoft Officeを使用する場合,およびユーザ定義プラグインを使用する場合は,このエントリの指定は無視されます。 | なし | なし |
uoc_sql | UOCでプロパティ値を利用する場合は,SQL情報ファイルのファイルパスをフルパスで指定します。指定を省略すると,UOCのパラメタファイルにプロパティ値が格納されません。 このエントリは,PDFstaffを使用する場合だけ有効になります。Microsoft Officeを使用する場合,およびユーザ定義プラグインを使用する場合は,このエントリの指定は無視されます。 SQL情報ファイルの詳細は,「(4) SQL情報ファイル」を参照してください。 | なし | なし |
PDFStaffを使用する場合,PDF変換のオプション設定ができます。レンディション変換プラグイン設定ファイルのPDF変換プラグインのオプション設定用エントリを次の表に示します。
表6-4 レンディション変換プラグイン設定ファイルのPDF変換プラグインのオプション設定用エントリ
エントリ名 | 説明 | 省略時の仮定値 | インストール時の値 |
---|---|---|---|
opt_endpoint | Adobe LiveCycle PDF Generatorのサービスエンドポイントを指定します。省略はできません。 Adobe LiveCycle PDF Generatorのサービスエンドポイントは,通常の場合はhttp://servername:port/pdfg-ws/services/PdfGenInterfaceの形式になります。 Adobe LiveCycle PDF Generator ES2の場合はhttp://servername:8080/soap/services/?blob=dimeの形式となります。 | 必須 | http://servername:port/pdfg-ws/services/PdfGenInterface |
opt_useproxy | Adobe LiveCycle PDF Generatorに接続する場合にプロキシを使用するかどうかを指定します。 指定できる値は次のとおりです。 true:プロキシを使用します。 false:プロキシを使用しません。 | false | false |
opt_proxyservername | Adobe LiveCycle PDF Generatorに接続する場合に使用するプロキシサーバのサーバ名を指定します。 | "" | なし |
opt_proxyserverport | Adobe LiveCycle PDF Generatorに接続する場合に使用するプロキシサーバのポート番号を指定します。 | 0 | なし |
opt_proxyusrname | Adobe LiveCycle PDF Generatorに接続する場合に使用するプロキシの認証ユーザ名を指定します。プロキシサーバの認証が必要なときだけ指定します。 | "" | なし |
opt_proxyusrpassword | Adobe LiveCycle PDF Generatorに接続する場合に使用するプロキシの認証ユーザのパスワードを指定します。プロキシサーバの認証が必要なときだけ指定します。 | "" | なし |
opt_maxpsfilesizews | Adobe LiveCycle PDF GeneratorのWebサービスに対して,PostScriptをPDFへ変換処理依頼する際のファイルサイズの上限を指定します。 | 262,144,000(約250メガバイト) | なし |
opt_timeout | Adobe LiveCycle PDF GeneratorのWebサービスに対して,PostScriptをPDFへ変換処理依頼する際のタイムアウト時間をミリ秒単位で指定します。 指定できる値の範囲は0~2147483647です。 0を指定すると,タイムアウト値は無限となります。 | 270,000(270秒) | なし |
opt_converttopstimeout | PDFstaffがファイルをPostScriptへ変換する際のタイムアウト時間をミリ秒単位で指定します。 指定できる値の範囲は0~2147483647です。 0を指定すると,2147483647を指定したときと同じ動作をします。 なお,実際にタイムアウトする時間は,処理のオーバーヘッドなどによって,指定した値よりも大きくなることがあります。 | PDFstaff 仮想フォルダのセッションタイムアウト値 (IISの設定)※1,または1,200,000(20分)※2 | なし |
opt_pollinginterval | PDFstaffがAdobe LiveCycle PDF Generatorの処理状況をポーリングする間隔をミリ秒単位で指定します。指定できる値の範囲は0~2147483647です。 Adobe LiveCycle PDF Generator ES2の場合,このエントリに値を指定しても無視されます。 | 5000(5秒) | なし |
opt_printer | PDFstaffがOffice文書,HTMLページ(html),および一太郎文書をPDFに変換する過程で使用するPostScriptプリンタドライバのプリンタ名を指定します。 プリンタ名に指定できる文字は,半角英数字,アンダースコア「_」,ピリオド「.」,およびハイフン「-」です。220バイトまで指定できます。 | 必須 | Acrobat Distiller J |
opt_joboptionsettingname | Adobe LiveCycle PDF GeneratorがPostScriptをPDFに変換する際に使用するAdobe PDF設定名を指定します。Adobe LiveCycle PDF Generatorに登録されているAdobe PDF設定名を文字列で指定します。""(空文字)を指定すると,Adobe LiveCycle PDF Generatorでデフォルトとして設定されているAdobe PDF設定が使用されます。 | "" | なし |
opt_securitysettingname | Adobe LiveCycle PDF GeneratorがPostScriptをPDFに変換する際に使用するセキュリティ設定名を指定します。Adobe LiveCycle PDF Generatorに登録されているセキュリティ設定名を文字列で指定します。""(空文字)を指定すると,Adobe LiveCycle PDF Generatorでデフォルトとして設定されているセキュリティ設定名が使用されます。 | "" | なし |
opt_filetypesettingname | Adobe LiveCycle PDF GeneratorがPostScriptをPDFに変換する際に使用するファイルタイプ設定名を指定します。このエントリは,指定を省略するか,または空文字を設定して使用してください。""(空文字)を指定すると,Adobe LiveCycle PDF Generatorでデフォルトとして設定されているファイルタイプ設定が使用されます。 | "" | なし |
opt_bookmarkautocreate | Word文書をPDFに変換するときに,Wordの見出しからPDFのしおりを作成するかどうかを指定します。 指定できる値は次のとおりです。 true:PDFのしおりを作成します。 false:PDFのしおりを作成しません。 このエントリでtrueを指定した場合でも,目次のリンク,図表番号への相互参照,URLリンクなど,文書中のリンク情報は作成されません。
| false | false |
opt_pptfittopage | PowerPoint文書をPostScriptまたはPDFに変換するときに,ページを用紙サイズに合わせて作成するかどうかを指定します。 指定できる値は次のとおりです。 true:用紙サイズに合わせて作成します。 false:用紙サイズに合わせて作成しません。 このエントリでtrueを指定した場合,PowerPointのページ設定で指定した用紙サイズではなく,PostScriptプリンタドライバのデフォルト用紙設定のサイズに合わせて(内容が拡大または縮小されて)PDFが作成されます。 また,このエントリでfalseを指定した場合,PDF作成時に内容が用紙からはみ出して出力されたり,中央に小さく縮小されて出力されたりすることがあります。 | true | true |
opt_messagelocale | Adobe LiveCycle PDF Generatorが返すメッセージのロケールを文字列で指定します。 Adobe LiveCycle PDF Generator ES2の場合,このエントリに値を指定しても無視されます。 | ja_JP | ja_JP |
opt_pdfgenerator | 使用するAdobe LiveCycle PDF Generatorを指定します。指定できる値は次のとおりです。
| 7 | 7 |
opt_webserviceuser | Adobe LiveCycle PDF Generator ES2サーバのWeb サービスを利用する際の認証ユーザ名を指定します。opt_pdfgeneratorにESを指定したときにだけ指定します。 | "" | なし |
opt_webservicepass | Adobe LiveCycle PDF Generator ES2サーバのWeb サービスを利用する際の認証パスワードを指定します。opt_pdfgeneratorにESを指定したときにだけ指定します。 | "" | なし |
レンディション変換プラグイン設定ファイルのユーザ定義プラグインの設定用エントリを次の表に示します。
表6-5 レンディション変換プラグイン設定ファイルのユーザ定義プラグインの設定用エントリ
エントリ名 | 説明 | 省略時の仮定値 | インストール時の値 |
---|---|---|---|
user_plugin_name | ユーザ定義プラグインの名称を63バイト以内で指定します。 このエントリで指定した名称は,エラーログ出力時に使用されます。 pluginエントリにユーザ定義プラグインを指定した場合は,必ず指定してください。 pluginエントリにユーザ定義プラグインを指定していない場合,このエントリを指定しても無視されます。 | なし | なし |
user_subprocess_name | ユーザ定義プラグインでの変換タイムアウト発生時に,ユーザ定義プラグインの強制停止と同時に停止するサブプロセスの名称を指定します。 セミコロン(;)で区切って最大8個のサブプロセスが指定できます。 各サブプロセスの名称は,パスを含めないで,31バイト以内で指定します。
| なし | なし |
user_stop_waittime | ユーザ定義プラグインを中断するときにユーザ定義プラグインの終了を待つ期間をミリ秒単位で指定します。 指定できる値の範囲は10000~60000です。 0を指定すると,ユーザ定義プラグインの終了を待たずにユーザ定義プラグインのプロセスを強制終了します。 10000~60000の値を指定した場合,イベント "EDMRDR_UserPlugin_StopEvent"をシグナル状態とした後,指定した期間,ユーザ定義プラグインの終了を待ちます。 pluginエントリにユーザ定義プラグインを指定していない場合,このエントリを指定しても無視されます。 | 0 | なし |
user_input_extensions | ユーザ定義プラグインが処理できる変換元ファイルの拡張子を指定します。 セミコロン(;)で区切って複数個指定できます。セミコロンを含めて全体で255バイト以内で指定します。大文字・小文字は区別されません。指定を省略すると,どの拡張子のファイルでも処理できると見なされます。
| なし | なし |
user_output_extension | ユーザ定義プラグインが作成する変換先ファイルの拡張子を32バイト以内で指定します。大文字・小文字は区別されません。
| 必須 | なし |
UOCでプロパティ値を利用するときは,プロパティ値を取得するためのSQL文をSQL情報ファイルに設定します。
SQL情報ファイルに設定できるセクションは,<文書クラス名>セクションです。
<文書クラス名>には,DMAクラスdmaClass_DocVersionまたはそのサブクラス名を指定できます。複数のクラスが対象の場合は,複数のセクションを指定できます。最大32個のセクションを指定できます。33個以上のセクションを指定した場合,33個目以降のセクションは無視されます。指定した<文書クラス名>が存在しない場合,または指定した<文書クラス名>がDMAクラスdmaClass_DocVersion またはそのサブクラス名でない場合は,エラーメッセージKMBX11311-Eが出力されます。
SQL情報ファイルに設定できるエントリを次の表に示します。
表6-6 SQL情報ファイルに設定できるエントリ
エントリ名 | 説明 | 省略時の仮定値 | インストール時の値 |
---|---|---|---|
sql | プロパティ値を取得するためのSQL文を指定します。SQL文の文法は,マニュアル「DocumentBroker Version 3 クラスライブラリ C++ 解説」またはマニュアル「DocumentBroker Version 3 クラスライブラリ Java 解説」を参照してください。 また,SQL文には,?パラメタを利用してDocVerのdmaProp_OIIDと完全一致させる条件を付与する必要があります。 sqlエントリには,8,192バイトまでのSQL文が指定できます。8,192バイトを超えるSQL文を指定した場合,8,193バイト以降が切り捨てられます。 エントリの指定,またはエントリの値の指定がないときは,セクションの指定が無視されます。 | なし | なし |
sqlエントリの記述例を次に示します。なお,sqlエントリは1行で記述します。△は半角の空白です。
sql=select△dmaProp_OIID,任意のプロパティ,…△from△usrClass_DocVer△where△dmaProp_OIID=?△and△<その他の条件>