ウェブ…customRequest
を使用すると、HTTPでサポートされている任意のメソッドを使用してカスタムHTTP要求を作成できます。
構文
ウェブ。customRequest({オブジェクト} );
JavaScriptオブジェクト
{ stepName:"<string>", url:"<string>", method:"<string>", targetFrame:"<string>", encType:"<string>", recContentType:"<string>", referer:"<string>", bodyUnicode:"<string>", bodyBinary:"<string>", body:"<string>", bodyFilePath:"<string>", resource:"<string>", resourceByteLimit:"<string>", snapshot:"<string>", mode:"<string>", extraResBaseDir:"<string>", userAgent:"<string>", contentEncoding:"<string>", rawBody:{ content:"<string>", length:"<string>" }, "extraRes":}
| プロパティ名 |
説明
|
|---|---|
| ステップ名 | ステップ名。 |
| url | ロードするwebページのアドレス。 URLには、HTTP、HTTPS、またはFTPのいずれかのプロトコルを使用できます。 認証のために、次の形式を使用して、URL属性にユーザー名とパスワードの両方を含めます。ftp://username:password@server/dir/path….. |
| メソッド | 任意のHTTPメソッド。 |
| targetFrame | 現在のリンクまたはリソースを含むフレームの名前。 詳細については、”targetframe”を参照してください。 |
| encType | エンコード方法。 以下の詳細を参照してください。 |
| recContentType | 記録された”Content–Type”応答ヘッダー値(text/html、application/x–javascriptなど)。 RecContentType値は、ターゲットURLがリソースであるかどうかを判断するためにresource属性が指定されていない場合に使用されます。 詳細については、”reccontentTypeおよびresource”を参照してください |
| referer | 現在のページを参照しているwebページ。 場所が明示的に表現されている場合、この属性は省略されます。 |
| Bodyunicode | 本文はLatin1UTF–16LE(リトルエンディアン)Unicodeです。 以下の”Body”を参照してください。 |
| bodyBinary | 本文はバイナリコードです。 以下の”Body”を参照してください。 |
| body | リクエスト本体。 以下の”Body”を参照してください。 |
| bodyFilePath | 要求の本文として渡されるファイルへのパス。 bodyFilepathは、他のbody属性と一緒に使用することはできません。 |
| リソース | のいずれか：
|
| resourceByteLimit | resourceByteLimitを参照してください。 |
| snapshot | スナップショットファイルのファイル名。 |
| モード | 記録レベル:HTMLまたはHTTP。 記録レベル/モード(Web)を参照してください。 |
| extraResBaseDir | extraResグループ内の相対Urlを解決するためのベースURL。 詳細については、以下を参照してください。 |
| userAgent | サーバーとの対話でユーザーを表すアプリケーションを識別するHTTPヘッダー。 詳細については、以下を参照してください。 |
| contentEncoding | リクエスト本文のエンコーディング。 たとえば、gzipまたはdeflateです。 |
| rawBody | リクエストの本体は、データへのポインタとして渡されます。 |
| extraRes | webページ内のHTML以外のメカニズムによって生成されたリソース。 |
戻り値
適用されません
パラメータ化
すべてのプロパティは、stepNameを除く標準パラメータ化を使用してパラメータ化できます。
一般情報
ウェブ。customRequest関数は、任意のメソッドまたはボディを使用してカスタムHTTP要求を作成できるアクション関数です。 (スクリプト内の各webアクション関数により、ブラウザーは新しいwebページまたはフレームを表示します。 すべてのwebアクション機能は、VuGenによって記録することができます。)デフォルトでは、VuGenは他のweb関数で解釈できなかったリクエストに対してのみこの関数を生成します。
この機能を手動で挿入するには、[ステップの追加]ダイアログボックスを使用します。 カスタム要求の前に送信するHTTPヘッダーを指定するには、webを追加します。addHeaderまたはweb。addAutoHeader関数。
HTTPヘッダーを変更して、要求に関する追加情報をサーバーに渡すことができます。 HTTPヘッダーを使用すると、たとえば、圧縮ファイルなどの応答で他のコンテンツタイプを許可したり、特定の条件でのみwebページを要求したりできます。 要求内のHTTPヘッダーを変更するには、webを参照してください。アドヘーダー 以降のすべての要求を変更するには、webを参照してください。アドオートヘーダー。
Body
要求の本文は、内容に応じて、引数body、bodyBinary、またはbodyUnicodeのいずれかの値として渡されます。 Body*引数は1つだけ渡すことができます。
ボディ仕様の例:
bodyUnicode:"REPRICE"bodyBinary:"\x08\\x00\\xCC\\x02\\x00\\x00"body:".\r\n–dxjjtbw/(.tp?eg:ch/6--\r\n"
すべてのボディ値はASCIIで、ヌル終端されています文字列。
body–通常の印刷可能なテキストを示します。 Nullバイトを表すことはできません。 すべての文字は円記号で指定されます。
bodyBinary–バイナリコードを示します。 非印刷可能な文字は、\\xHHの形式で16進数でエンコードされます。HHは16進数値を指定します。 ヌルバイトは、次のように指定されます”\\00″
bodyUnicode-US-English、特にLatin1UTF–16LE(リトルエンディアン)Unicodeのみ。 実際のパラメータは、テキストを読みやすくするために、各文字を追加する余分なゼロバイトが取り除かれます。 これは、webによって再追加されます。Webサーバーに送信する前のcustomRequest。
印刷できない文字の場合は、単一の円記号を使用します。 Nullバイトを表すことはできません。
長さが100Kを超えるボディの場合、属性の代わりに変数名が表示されます。 変数はlrw_custom_bodyで定義されています。h.
encType
encTypeは、現在の再生の”Content–Type”要求ヘッダーの値として指定される”text/html”などのContent–Typeを指定します。 ウェブ…customRequestは本文エンコードを実行しません。 Body引数は、エンコーディングが既に適用されている状態で、そのまま(または”バイナリ”処理を適用した後)使用されるボディを指定します。 したがって、本文と一致しないencTypeを指定すると、サーバー側のエラーが発生する可能性があります。 一般に、記録されたとおりにencTypeを編集しないことをお勧めします。
任意のencType指定は、content–Typeの任意のweb_add_headerを暗黙のうちにオーバーライドします。 “EncType=”(空の値)が指定された場合、”Content–Type”要求ヘッダーは生成されません。 “EncType”が省略された場合、該当するweb_add_headerが使用されます。 ヘッダーがなく、”method=POST”の場合は、”application/x–www–form–urlencoded”がデフォルトとして使用されます。 それ以外の場合、Content–Type要求ヘッダーは生成されません。
extraRes
Extra Resource属性は、HTMLベースの記録を実行する場合にのみ挿入され、”非HTML生成要素”高度な記録オプションが現在のスクリプトステップ内で記録するよう これはデフォルトの設定です。 詳細については、”Virtual User Generatorヘルプセンター”を参照してください(該当するバージョンを選択します)。ExtraResBaseDirは、extraResグループ内の相対Urlを解決するためのベースURLです。 URLは、絶対URL(“http://weather.abc.com/weather/forecast.jsp?loccode=LFPO”など)または相対URL(“forecast.”など)にすることができます。jsp？ロコード=LFPO”)。 Urlの実際のダウンロードは常に絶対Urlを使用して実行されるため、相対Urlは別の（絶対）URLを”ベース”として使用して解決する必要があります。 たとえば、相対的な”予測”を解決します。jsp？loccode=LFPO”ベースとして”http://weather.abc.com/weather/”を使用すると、”http://weather.abc.com/weather/forecast.jsp?loccode=LFPO”が生成されます。 デフォルトでは、”extraResBaseDir”が指定されていない場合、関数のプライマリURLが使用されます。
userAgent
userAgentは、アプリケーションを識別するHTTPヘッダーであり、通常はブラウザであり、サーバーとの対話におけるユーザーを表します。
たとえば、ヘッダー”User–Agent:Mozilla/4.0(compatible;MSIE6.0;Windows NT5.0)”は、Microsoft Internet Explorer6.0for Windows NTを識別します。 他のユーザーエージェント文字列は、異なるブラウザや他のブラウザ以外のアプリケーションで使用されます。 通常、アプリケーションからのすべての要求は、レコーダーがランタイム設定として指定する同じUser–Agent値を使用します。 ただし、通常のブラウザセッション内であっても、サーバーと直接対話し、通常はブラウザとは異なるユーザーエージェント文字列を持つブラウザ以外のコンポーネ
userAgentを指定すると、これはそのようなブラウザ以外の要求であることを示します。 指定された文字列は”User–Agent:”HTTPヘッダーで使用され、指定されたUrlがリソースであると仮定してブラウザのキャッシュを使用しないなど、いくつかのポイント 指定された値がブラウザの値と異なることを確認するためのチェックは行われません。
バイナリコードの使用
次の形式を使用して、webのbodyパラメータにバイナリコードを含めることができます。customRequest関数:
\x
これは、で表される十六進値を表します。
たとえば、\x24は16*2+4=36、これは$記号です。\x2bは+記号です。
有効な2文字の十六進シーケンスを表さないシーケンスは、VUGENによってASCIIテキストとして扱われます。 1文字の16進シーケンスは使用しないでください。 たとえば、”\x2″は有効な2文字の16進シーケンスではありません。 代わりに”\x02″を使用してください。
バイナリ値はスクリプト内で\\xとして表示されることに注意してください。 しかし、ウェブを生成するとき。customRequest関数VuGenを使用すると、円記号を1つだけ入力する必要があります。
web内でパラメータ化を使用する場合。customRequest関数は、パラメータの定義内の唯一の円記号を含めます。
customRequest({name:'click_for_next.gif',url:'http://kalimanjaro/Correlation_ASP_Project/click_for_next.gif',メソッド:'GET',リソース:1,recContentType : 'image/gif',referer:'http://kalimanjaro/Correlation_ASP_Project/Correlation_ASP_business_process.asp?first_field_is=param1&change_first_sessionid_each=three_times&links_forms_usage=links_only&step=1&form_method=GET&sessionid_in_cookie=&use_frameset=&frame_target_is=mainframe&first_sessionid_is_large=&type_of_frame=use_frameset&second_field_is=praram2&change_second_sessionid_each=three_times&second_sessionid_is_large=',snapshot:'t9.inf'});