HTTPトリガー

オペレーション名

機能概要

発火イメージ

プロパティ

HTTPトリガーの設定

実行内容の設定

実行オプションの設定

トリガー変数

HTTPトリガーでは、実行スクリプトから情報を取得することができます。
また、この変数をJSPなどにフォワードすることもできます。JSPで「HttpServletRequest.getAttribute("変数名")」で取得できます。

トリガー変数名	値	内容	備考
入力データ	trigger.inputData	リクエストのContent-Typeヘッダの値によって、リクエスト本体を扱う形式が異なります。 [text/xml]または[application/xml]: リクエスト本体をXML形式として扱い、スクリプト入力変数に格納します。 [application/json]: リクエスト本体をJSON形式として扱い、スクリプト入力変数に格納します。	指定例:${trigger.inputData} 値を設定できるスクリプト入力変数はXML型のみです。 JSON形式のデータの扱いについては、「JSON形式のデータ変換について」を参照してください。
終了コード	trigger.exitStatus	実行スクリプトの終了ステータスです。	指定例:${trigger.exitStatus}
異常終了時メッセージ	trigger.failureMessage	実行スクリプトが異常終了した場合のエラーメッセージ文字列です。	指定例:${trigger.failureMessage}
サービス名	trigger.serviceName	実行スクリプトのサービス名です。	指定例:${trigger.serviceName}
スクリプト名	trigger.scriptName	実行スクリプト名です。	指定例:${trigger.scriptName}
出力データ	trigger.outputData	[正常終了時の動作]に[スクリプトで生成されたページを返す]を選択した場合、この変数内のデータをHTTPクライアントに返します。	指定例:${trigger.outputData}
クライアントアドレス	trigger.client_address	SkyOnDemandサーバのIPアドレスが格納されます。	リクエスト元のIPアドレスを取得することはできません。
HTTPヘッダ	trigger.header:<HTTPリクエストヘッダ名>	<HTTPリクエストヘッダ名>で指定したリクエストヘッダの値を、スクリプト入力変数に格納します。	指定例:${trigger.header:Content-Type} <HTTPリクエストヘッダ名>に指定するヘッダ名の大文字小文字は区別しません。 <HTTPリクエストヘッダ名>に指定したヘッダが存在しない場合、スクリプト変数の初期値が使用されます。 <HTTPリクエストヘッダ名>に指定したヘッダが複数存在する場合、最初に検出したヘッダの値が格納されます。
	trigger.header:<HTTPレスポンスヘッダ名>	<HTTPレスポンスヘッダ名>で指定した名前と変数内の値を、レスポンスヘッダに追加します。	指定例:${trigger.header:X-PRODUCT-NAME} 以下のHTTPヘッダは指定しても無視されます。 Content-Type Content-Disposition Content-Length Transfer-Encoding Date Server
ステータスコード	trigger.status_code	この変数内の値をレスポンスのステータスコードに設定します。	指定例:${trigger.status_code} 設定可能なステータスコードについては、「レスポンスのステータスコードについて」を参照してください。
出力ファイル名	trigger.file_name	この変数内の値をレスポンスで出力するファイルの名前に設定します。	指定例:${trigger.file_name} マルチバイト文字を使用することはできません。

リクエストパラメータ設定方法

マルチパートフォームデータの設定方法

<form method="post" action="<HTTPトリガーのURL>" enctype="multipart/form-data">
<p>名<br>
<input type="text" name="firstname"></p>
<p>姓<br>
<input type="text" name="lastname"></p>
<p>プロフィール画像<br>
<input type="file" name="attachment"></p>
<p><input type="submit" value="送信"></p>
</form>

Content-Type: multipart/form-data; boundary=<バウンダリ>

--<バウンダリ>
Content-Disposition: form-data; name="firstname"

Ichiro

--<バウンダリ>
Content-Disposition: form-data; name="lastname"

Suzuki

--<バウンダリ>
Content-Disposition: form-data; name="attachment"; filename="profile.jpg"
Content-Type: image/jpeg

</data/profile.jpg のデータ>

--<バウンダリ>--

• パラメータ名は大文字小文字を区別します。
• マルチバイト文字のパラメータ名を扱うことはできません。
• 同名のパラメータが複数ある場合、最初に検出したパラメータの値をスクリプト変数に格納します。
• パラメータの値を文字列として扱う場合、[リクエスト設定/エンコーディング]の値でエンコーディングされます。
  ただし、パラメータのContent-Typeヘッダにcharsetパラメータがある場合、charsetパラメータの値でエンコーディングされます。

CSV出力について

• テーブルモデル型のXMLデータが渡された場合、CSVデータに変換して出力します。
  • CSVデータのデリミタ文字は「,」(半角カンマ)となります。
  • データにデリミタ文字、「"」(ダブルクォーテーション)、改行を含む場合はデータの最初と最後に「"」を記述します。
  • データに「"」を含む場合は「""」のように2つ続けて記述し、エスケープを行います。
• テーブルモデル型のXMLデータ以外のデータが渡された場合、データの文字列表現を出力します。

JSON出力について

• 「JSON形式のデータ変換について」の規則にしたがったXML形式のデータが渡された場合、JSON形式のデータに変換して出力します。
• 上記以外のデータが渡された場合、データの文字列表現を出力します。

ファイル出力について

JSON形式のデータ変換について

<--ルートがオブジェクト型のJSONオブジェクトの場合 -->
<?xml version="1.0"?>
<root type="object">
  <JSONメンバの名前 type="JSONの型を表す属性値">値</JSONメンバの名前>
    :
</root>

<-- ルートが配列型のJSONオブジェクトの場合 -->
<?xml version="1.0"?>
<root type="array">
  <element type="JSONの型を表す属性値">値</element>
    :
</root>

<-- JSONメンバの名前がXMLの要素名として不正な場合 -->
<?xml version="1.0"?>
<root type="object">
  <member type="JSONの型を表す属性値" name="JSONメンバの名前">値</member>
    :
</root>

{"name":"Suzuki"}

<root type="object">
  <name type="string">Suzuki</name>
</root>

["apple","grape","orange"]

<root type="array">
  <element type="string">apple</element>
  <element type="string">grape</element>
  <element type="string">orange</element>
</root>

{"name":"Suzuki"}

<name type="string">Suzuki</name>

{"age":37}

<age type="number">37</age>

{"success":true}

<success type="boolean">true</success>

{"name":{"first":"Ichiro","last":Suzuki"}}

<name type="object">
  <first type="string">Ichiro</first>
  <last type="string">Suzuki</last>
</name>

<JSONメンバの名前 type="array">
  <element type="JSONの型を表す属性値">値</element>
    :
</JSONメンバの名前>

{"fruits":["apple","grape","orange"]}

<fruits type="array">
  <element type="string">apple</element>
  <element type="string">grape</element>
  <element type="string">orange</element>
</fruits>

{"name":null}

<name type="null"/>

{"1name":"Suzuki"}

<member type="string" name="1name">Suzuki</member>

レスポンスのステータスコードについて

• トリガー変数「trigger.status_code」が設定されていない、または上記以外のデータが渡された場合、レスポンスのステータスコードは以下になります。
  • HTTPトリガーで実行したスクリプトが正常終了した場合「200」
  • HTTPトリガーで実行したスクリプトが異常終了した場合「500」
• スクリプトの実行前にリクエストの解析時でエラーが発生した場合、レスポンスのステータスは「400」になります。


• 指定したURLのトリガーが無効の場合、レスポンスのステータスコードは「403」になります。


• 指定したURLのトリガーが見つからないの場合、レスポンスのステータスコードは「404」になります。


• スクリプトの実行後にレスポンスを返す前でエラーが発生した場合、レスポンスのステータスコードは「500」になります。


• [正常終了時の動作]に[スクリプトで生成されたページを返す]を選択し、トリガー変数「trigger.status_code」に「204」または「304」を設定した場合、スクリプトで生成されたページを返してもレスポンスボディは空になります。


• [異常終了時の動作]に[ウェブサーバのエラーページを返す]を選択し、HTTPトリガーで実行したスクリプトが異常終了した場合、トリガー変数「trigger.status_code」にステータスコードを設定してもステータスコードは「500」になります。

仕様制限

• HTTPセッションを管理することはできません。


• レスポンスとして返すデータがXMLデータの場合、XMLデータの符号化宣言は[レスポンス設定/エンコーディング]で指定したエンコーディングになります。


• レスポンスとして返すデータがJSONデータの場合、UTF-8でエンコードされます。

主な例外

注意事項

• トリガーの登録後、トリガーに設定されているサービスやスクリプトの状態が変更された場合(サービス名・スクリプト名の変更や、スクリプト変数の追加・削除など)、登録済みのトリガーにその変更は反映されません。
  対象のトリガーのプロパティ設定ダイアログを開き、サービスやスクリプトの再選択を行ったあと[完了]ボタンを押下して再登録してください。


• ブラウザの設定によっては、キャッシュをクリアしないと処理の結果が正常に表示されない場合があります。
  そのような場合、ブラウザの再読み込みを行ってください。