HTTP_POST

LANSA Composer

HTTP_POST


このアクティビティはHTTPサーバーからドキュメントを送信する際に使用できます。(通常はHTTP POSTメソッドを使用)

このアクティビティはHTTPアウトバウンド構成とともに使用されます。このHTTPアウトバウンド構成ではHTTPサーバーへの接続を確立するために必要なほどんどのパラメータが設定できます。選択されたHTTPアウトバウンド構成の属性はこのアクティビティのパラメータにより上書きされる場合があります。

このアクティビティでは、HTTPFAILEDという通知イベントが使用されます。このイベントがアクティブな場合、このアクティビティ内で失敗すると、通知イベントにより電子メールまたはその他のサポートされるフォームによる通知が送信されます。

INPUTパラメータ:

HTTPCONFIG: 必須

このパラメータは、HTTPサーバーへの接続を確立するための多くのパラメータを設定するHTTPアウトバウンド構成の名前を指定します。選択されたHTTPアウトバウンド構成の属性は、以下にも説明されている通り、このアクティビティの他のパラメータにより上書きされる場合があります。

URI : 任意

このパラメータには、HTTPアウトバウンド構成に指定されているURIを上書きする代替の値を指定します。使用する場合は、HTTPアウトバウンド構成に指定される、リモートホスト接続に使用するURIを指定します。このパラメータが指定されない場合は、HTTP構成から値が取られます。

CONTENTFILEDIR: 任意

このパラメータは任意選択です。このパラメータがブランク以外の値の場合、コンテント・ペイロード・ファイル(HTTPサーバーに送信するデータを含むファイル)が存在するローカル・サーバーのディレクトリとして使用されます。このパラメータが指定されない場合は、HTTP構成の値が用いられます。

CONTENTFILENAME: 任意

このパラメータは任意選択です。このパラメータがブランク以外の値の場合、コンテント・ペイロード・ファイル(HTTPサーバーに送信するデータを含むファイル)の名前として使用されます。このパラメータが指定されない場合は、HTTP構成の値が用いられます。

CONTENTFILETYPE: 任意

このパラメータは任意選択です。このパラメータがブランク以外の値の場合、コンテント・タイプとして使用されます。このパラメータが指定されない場合は、HTTP構成の値が用いられます。HTTP構成のコンテント・ファイル・タイプもブランクの場合は、ファイル拡張子からコンテント・タイプを取得します。

このパラメータの形式と有効値については、「HTTP構成」の[アウトバウンド]を参照してください。

RETURNFILEDIR: 任意

このパラメータは任意選択です。このパラメータがブランク以外の値の場合、返されるペイロード・ファイル(HTTPサーバーから受け取ったHTTP応答データを含むファイル)が保存されるローカル・サーバーのディレクトリとして使用されます。このパラメータが指定されない場合は、CONTENTFILEDIRの値が用いられます。

RETURNFILENAME: 任意

このパラメータは任意選択です。ブランク以外の値を指定した場合、返されるペイロード・ファイル(HTTPサーバーから受け取ったHTTP応答データを含むファイル)の名前として使用されます。

HTTPMETHOD : 任意(上級)

このパラメータでアウトバウンドHTTP要求に使用されるHTTP要求のメソッドを指定できます。HTTPプロトコル標準では、複数のメソッドやユーザー定義のメソッドがRESTスタイルのアプリケーションに使用することができます。省略値はPOSTで、HTTP_POSTアクティビティがHTTP経由でファイルをリモートサーバーに”送信”する際に最もよく使用される値です。また別のよく利用されるHTTPメソッドはGETです。GET要求を出すためにはHTTP_GETアクティビティが利用できます。GETは送信するコンテントがなく、リモートHTTPサーバーからコンテントを受信するためにアクティビティを利用する際に使用されます。

HTTPHEADERNAME: 任意(上級)
HTTPHEADERVALUE : 任意(上級)

この2つのパラメータでは、オプションとしてアウトバウンド要求のHTTPヘッダに追加するHTTPヘッダ値に対応する1つまたはそれ以上のHTTPヘッダ名を指定できます。このアクティビティでは、既に要求ヘッダに複数の一般的な”標準”プロパティを追加していることに注意してください。自身のアプリケーションが、'AUTHORIZATION'などのような追加のHTTPヘッダを指定するように要求している場合や、HTTPサーバーアプリケーション特有のカスタムプロパティがある場合にこのパラメータを使用できます。このアクティビティはHTTPHEADERNAMEリストに指定されたプロパティをいくつでも追加します。使用する場合は、それぞれのHTTPHEADERNAMEリスト項目に対して、対応するHTTPヘッダプロパティ値が含まれるHTTPHEADERNAMEリスト項目が存在することを、ユーザー自身で責任をもって確認してください。

OUTPUTパラメータ:

OUTPUTパラメータはありません。