HTTP_REQUEST機能ブロック

この機能ブロックは、HTTPインターフェース用のRAWクエリを作成します。

重要: HTTPインターフェースから送信する変数は、データ型がRAWである必要があります。

URIは、通信セクションで右側に定義された変数として定義されます。このURIが/で始まる場合、最初の/は削除されます。最下層ディレクトリへの要求を行う場合、変数/のみを定義できます。

一部のWebサーバーではUser-Agentヘッダーが必要です。そうしないとページが読み込まれません。これはAntcas Controlのエラーではなく、要求されたWebブラウザの保護メカニズムです。次の内容でHeader入力を使用してください:

User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.13) Gecko/20080311 Firefox/2.0.0.13

入力 Method

この入力は、文字列として転送方法を定義します。これは例えば"GET""POST""PUT"などです。方法が定義されていない場合、GETがデフォルトとして選択されます。

入力 Type

この入力は、文字列としてヘッダーのContent-Typeを定義します。入力が定義されていない場合、エントリはヘッダーに追加されません。

入力 Header

文字列として追加のヘッダーエントリを定義します。複数のヘッダーは改行で区切られます。ヘッダーContent-Lengthは自動的に定義され、ヘッダーContent-Typeは入力Typeの値で定義されます。

入力 Query

この入力は、文字列としてQueryを定義します。Queryは問い合わせ文字(?)の後の値であり、通常GETリクエストで使用されます。

http://server/uri?query

Queryの構造は次のようになります:

var1=wert1&var2=wert2&va...

値が正しく転送されるためには、個々の値を機能ブロックURL_ENCODEまたはQUERY_ENCODEでエンコードすることが望ましいです。データが不完全に転送される可能性があるためです。

注意: URLの最大長を考慮してください、特に大量のデータを転送する必要がある場合。必要に応じてPOSTメソッドを使用し、QueryをContentとして送信してください。

入力 Content

この入力は、入力Queryと同様です。ただし、ヘッダーの後にデータが転送され、より大量のデータがサポートされます。アプリケーションによっては、ContentのタイプにQueryメソッドがない場合があります。

注意: UTF-8準拠のデータのみがサポートされています。バイナリデータを転送する場合は、機能ブロックBASE64_ENCODEでエンコードすることを推奨します。

入力 Timeout

この入力は、リクエストのタイムアウトをT#30s形式で秒単位で定義します。高いタイムアウト値を使用することを推奨します。小さな値は、リクエストが完全に実行されない原因となる可能性があります。Keep-Alive手順により、通常の処理が再開されるまで時間がかかる場合があります。

入力 DIS

この入力が真の場合、出力Requestの値はNULLになります。

入力 SET

この入力が真の場合、出力Requestの生成を強制します。この入力は、入力DISより優先されます。

出力 Request

この出力はJSON形式の文字列を返します。無効にされた場合、値NULLが返されます。通常、インターフェースの出力変数と直接接続されます。

出力 Length

この出力は、入力Contentのバイト単位の長さを返します。

出力 ID

最後に生成されたクエリのIDを返します。これは機能ブロックHTTP_RESPONSEで応答を検証するために役立ちます。