HTTP受付の動作情報を設定します。HTTP受付開始時にHTTP受付定義ファイルに設定した内容が有効になります。

HTTP受付定義ファイルは「cscurecphttp.properties」というファイル名で作成します。

 
<サービスプラットフォームのインストールディレクトリ>\CSC\custom-reception\http\config\templates\cscurecphttp.properties
 

注意

ここに格納されているファイルはテンプレートファイルです。HTTP受付定義ファイルを編集する場合は，HTTP受付の追加時にユーザ定義受付定義画面（詳細）で［独自定義ファイル］の［編集］ボタンをクリックし，定義ファイルの内容を修正してください。

(1)HTTP受付関連

urecp-http.context-root=HTTP受付のコンテキストルート　〜<<HTTP受付の受付ID>>

HTTP受付のコンテキストルートを半角英数字および次に示す半角記号で指定します。

• ハイフン（-）
• ピリオド（.）
• アンダーバー（_）
• 波ダッシュ（~）
• スラッシュ（/）
• アットマーク（@）
• プラス（+）
• ドル（$）
• 感嘆符（!）
• 引用符（'）
• 丸括弧（()）
• パーセント（%）

上記以外の文字を指定した場合，および次の場合はエラーとなります。

• 先頭または末尾に区切り文字（/）が指定されている
• 区切り文字（/）が多重指定されている
• 相対パスで指定されている
• パーセントエンコーディング以外の目的でパーセント（%）が指定されている

このプロパティを省略した場合，HTTP受付の受付IDが設定されます。

urecp-http.max-threads=HTTP受付の最大同時実行スレッド数　〜＜数字＞((1−1024))<<10>>

HTTP受付の最大同時実行スレッド数を指定します。HTTP受付の占有スレッド数（urecp-http.exclusive-threadsプロパティで指定）以上の値を指定する必要があります。

urecp-http.exclusive-threads=HTTP受付の占有実行スレッド数　〜＜数字＞((0−1024))<<0>>

HTTP受付の占有実行スレッド数を指定します。HTTP受付の最大同時実行スレッド数（urecp-http.max-threadsプロパティで指定）を超えない範囲で値を指定する必要があります。

urecp-http.queue-size=HTTP受付の実行待ちキューのサイズ　〜＜数字＞((0−2147483647))<<8192>>

HTTP受付の実行待ちキューのサイズを指定します。

urecp-http.pooled-instance.minimum=HTTP受付のプール内のインスタンスの最小数　〜＜数字＞((0または1−2147483647))<<0>>

HTTP受付のプール内のインスタンスの最小数を整数で指定します。0を指定した場合，制限はありません。

なお，このプロパティでは，urecp-http.pooled-instance.maximumプロパティの値（HTTP受付のプール内のインスタンスの最大数）以下の値を指定してください。指定した値が，urecp-http.pooled-instance.maximumプロパティで指定した値よりも大きい場合，運用コマンド実行時にエラーになります。

urecp-http.pooled-instance.maximum=HTTP受付のプール内のインスタンスの最大数　〜＜数字＞((0または1−2147483647))<<0>>

HTTP受付のプール内のインスタンスの最大数を整数で指定します。0を指定した場合，制限はありません。

なお，このプロパティでは，urecp-http.pooled-instance.minimumプロパティの値（HTTP受付のプール内のインスタンスの最小数）以上の値を指定してください。指定した値が，urecp-http.pooled-instance.minimumプロパティで指定した値よりも小さい場合，運用コマンド実行時にエラーになります。

urecp-http.ejb-transaction-timeout=HTTP受付のEJBトランザクションタイムアウト時間　〜＜数字＞((0または1−2147483647))<<0>>

HTTP受付のEJBトランザクションタイムアウト時間を秒単位で指定します。0を指定した場合，J2EEサーバに設定されたデフォルトのタイムアウト値で動作します。

(2)受付設定関連

httprecp.switchover.pass-through.mode={true｜false}　〜<<false>>

メッセージボディをビジネスプロセスに渡すときのボディ変数を生成するモードを指定します。大文字と小文字は区別されません。

• true
  パススルーモードを使用します。
  
• false
  標準モードを使用します。
  

httprecp.switchover.file-transfer.mode={true｜false}　〜<<false>>

リクエスト受付時にHTTP受付が作業フォルダを作成するかどうかを設定します。大文字と小文字は区別されません。

このプロパティはマルチパート型以外のリクエストに対して有効です。マルチパート型のデータの場合は，必ず作業フォルダが作成されます。

• true
  リクエストがマルチパート型かどうかに関係なく作業フォルダが必ず作成されます。
  
• false
  リクエストがマルチパート型の場合は作業フォルダが生成されます。それ以外の場合，作業フォルダは作成されません。
  

httprecp.http.charset={Shift_JIS｜UTF-8}　〜<<UTF-8>>

メッセージボディとクエリのエンコードに使用する文字コードを指定します。大文字と小文字は区別されません。

httprecp.response.ignore-bodymsg={true｜false}　〜<<false>>

ビジネスプロセスから受信した応答電文（ボディ）をHTTP受付が無視するか（HTTPレスポンスに設定しない）どうかを設定します。大文字と小文字は区別されません。

• true
  応答電文（ボディ）はHTTPレスポンスに設定されません。
  
• false
  応答電文（ボディ）はHTTPレスポンスのボディ部分に設定されます。
  

httprecp.response.header.filename=HTTPレスポンスヘッダ定義ファイルの名称

HTTPレスポンスヘッダ定義ファイルの名称を指定します。大文字と小文字は区別されます。

httprecp.system-exception.status-code=システム例外時のステータスコード　〜＜数字＞((000−999))<<500>>

システム例外時のステータスコードを3桁の数字で指定します。

httprecp.response.generate.content-length={true｜false}　〜<<true>>

HTTP受付でコンテンツ長を生成するかどうかを指定します。大文字と小文字は区別されません。

• true
  コンテンツ長を生成します。
  
• false
  コンテンツ長を生成しません。
  

httprecp.file-trans.temp-file.partsize-threshold=一時ファイルを出力する閾値サイズ　〜＜数字＞((0または1−2147483647))<<0>>

マルチパート型のHTTPリクエストの場合に，HTTPリクエストを一時ファイルに出力するときの閾値となるサイズをバイト単位で指定します。

HTTP受付が受信したHTTPリクエストのサイズがこの値を超えた場合，受信したHTTPリクエストは一時ファイルに出力されます。0を指定した場合，一時ファイルは必ず出力されます。

httprecp.file-trans.maxsize.part=受信できるファイルデータの1ファイル当たりの上限サイズ　〜＜数字＞((0または1−2147483647))<<2147483647>>

HTTP受付で受信できるファイルデータの1ファイル当たりの上限サイズの値をバイト単位で指定します。

HTTP受付が受信したマルチパート型HTTPリクエストの各パートのうち，ファイル形式で扱うパートのサイズがこの値を超えた場合，システム例外が発生します。

httprecp.file-trans.maxsize.request=受信できるHTTPリクエストボディの上限サイズ　〜＜数字＞((0または1−2147483647))<<2147483647>>

HTTP受付で受信できるHTTPリクエストボディの上限サイズをバイト単位で指定します。

HTTP受付が受信したHTTPリクエストボディのサイズがこの値を超えた場合，システム例外が発生します。

httprecp.work-dir.auto-delete={true｜false}　〜<<true>>

処理完了後に作業フォルダを自動的に削除するかどうかを指定します。大文字と小文字は区別されません。

• true
  ビジネスプロセスの処理が正常に完了したあと，作業フォルダが自動で削除されます。
  
• false
  作業フォルダは自動で削除されません。
  

false以外の値を指定した場合，またはキーや値を省略した場合は，trueと見なされます。ビジネスプロセスが非同期型の場合，このプロパティにはfalseを指定してください。

httprecp.response.download.disposition-type=HTTPレスポンスヘッダのContent-Dispositionヘッダに設定する値　〜<<attachment>>

HTTP受付からHTTPクライアントにデータを送信するときにHTTPレスポンスヘッダのContent-Dispositionヘッダに設定する値を指定します。大文字と小文字は区別されます。なお，指定した値が有効かどうかは検証されません。

このプロパティで設定したヘッダの値は，HTTPクライアントがダウンロードするファイルが1つの場合だけ利用されます。

httprecp.pass-through.parameter-use={true｜false}　〜<<true>>

パススルーモードで，HTTPリクエストボディにmsgキーを使用するかどうかを指定します。大文字と小文字は区別されません。

このプロパティは，httprecp.switchover.pass-through.modeプロパティでtrueを指定した場合だけ有効となります。

• true
  msgキーを使用します。
  
• false
  msgキーを使用しません。HTTPリクエストボディの内容が要求電文として直接ビジネスプロセスに渡されます。
  

(3)JSON-XML変換関連

httprecp.request.switchover.json-transfer.mode={true｜false}　〜<<false>>

HTTP受付のリクエスト処理時にJSON-XML変換をするかどうかを指定します。

• true
  HTTP受付のリクエスト処理時にJSON-XML変換をします。
  
• false
  HTTP受付のリクエスト処理時にJSON-XML変換をしません。
  

httprecp.response.switchover.json-transfer.mode={true｜false}　〜<<false>>

HTTP受付のレスポンス処理時にJSON-XML変換をするかどうかを指定します。

• true
  HTTP受付のレスポンス処理時にJSON-XML変換をします。
  
• false
  HTTP受付のレスポンス処理時にJSON-XML変換をしません。
  

記述例を次に示します。

 
urecp-http.max-threads=10
urecp-http.exclusive-threads=0
urecp-http.queue-size=8192
urecp-http.pooled-instance.minimum=0
urecp-http.pooled-instance.maximum=0
urecp-http.ejb-transaction-timeout=0
httprecp.switchover.pass-through.mode=false
httprecp.switchover.file-transfer.mode=false
httprecp.http.charset=UTF-8
httprecp.response.ignore-bodymsg=false
httprecp.response.header.filename=cscurecphttp_header.properties
httprecp.system-exception.status-code=500
httprecp.response.generate.content-length=true
httprecp.request.switchover.json-transfer.mode=true
httprecp.response.switchover.json-transfer.mode=true