webb.customRequest
låter dig skapa en anpassad HTTP-begäran med vilken metod som helst som stöds av HTTP.
Syntax
webb.customRequest ({objekt} );
JavaScript-objekt
{ 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":}
Fastighetsnamn |
beskrivning
|
---|---|
stegnamn | stegnamnet. |
url | adressen till webbsidan som ska laddas. Webbadressen kan vara något av följande protokoll: HTTP, HTTPS eller FTP. För autentiseringsändamål, inkludera både användarnamnet och lösenordet i URL-attributet med följande format: ftp://username:password@server/dir/path. |
metod | vilken HTTP-metod som helst. |
targetFrame | namnet på ramen som innehåller den aktuella länken eller resursen. Se targetframe för mer information. |
encType | kodningsmetoden. Se detaljer nedan. |
recontenttype | den” Content–Type ” svar header värde som registrerats, till exempel, text/html, application/x–javascript. Recontenttype-värdet används när resursattributet inte anges för att avgöra om måladressen är en resurs eller inte. För mer information, se recontenttype och resurs |
referer | webbsidan som hänvisade till den aktuella sidan. Om platsen uttrycktes uttryckligen utelämnas detta attribut. |
bodyUnicode | kroppen är i Latin1 UTF–16LE (little–endian) Unicode. Se ”kropp” nedan. |
bodyBinary | kroppen är i binär kod. Se ”kropp” nedan. |
kroppen | begäran kroppen. Se ”kropp” nedan. |
bodyFilePath | sökvägen till en fil som ska skickas som kroppen av begäran. bodyFilepath kan inte användas tillsammans med något annat kroppsattribut. |
resurs | en av:
|
resourceByteLimit | se resourceByteLimit. |
snapshot | filnamnet på snapshot-filen. |
läge | inspelningsnivå: HTML eller HTTP. Se inspelningsnivå / läge (Web). |
extraResBaseDir | basadressen för att lösa relativa webbadresser inom extraRes-gruppen. För mer information, se nedan. |
userAgent | HTTP-huvudet som identifierar det program som representerar användaren i interaktionen med servern. För mer information, se nedan. |
contentEncoding | kodning för begäran kropp. Till exempel gzip eller deflate. |
rawBody | kroppen av begäran skickas som en pekare till data. |
extraRes | resurser som genereras av icke–HTML-mekanismer på webbsidan. |
returvärden
Ej tillämpligt
parametrering
alla egenskaper kan parametreras med standardparametrering utom stegnamnet.
allmän Information
webben.customRequest-funktionen är en åtgärdsfunktion som låter dig skapa en anpassad HTTP-begäran med vilken metod eller kropp som helst. (Varje webbåtgärdsfunktion i ett skript gör att webbläsaren visar en ny webbsida eller ram. Alla web action-funktioner kan spelas in av VuGen.) Som standard genererar VuGen denna funktion endast för förfrågningar som inte kunde tolkas med andra webbfunktioner.
för att infoga den här funktionen manuellt, använd dialogrutan Lägg till steg. Om du vill ange en HTTP-rubrik som ska skickas före den anpassade begäran lägger du till en webb.addHeader eller webb.addAutoHeader funktion.
HTTP-huvudet kan ändras för att skicka ytterligare information om begäran till servern. Med HTTP-rubriker kan du till exempel tillåta andra innehållstyper i svaret, till exempel komprimerade filer, eller så kan du bara begära en webbsida på vissa villkor. För att ändra HTTP-rubriken i begäran, se web.addHeader. För att ändra alla efterföljande förfrågningar, se web.addAutoHeader.
Body
kroppen för en begäran skickas som värdet av ett av argumenten body, bodyBinary eller bodyUnicode, beroende på innehållet. Du kan bara skicka en kropp * argument.
exempel på kroppsspecifikationer:
bodyUnicode:"REPRICE" bodyBinary:"\x08\\x00\\xCC\\x02\\x00\\x00" body:".\r\n–dxjjtbw/(.tp?t.ex.: ch/6--\r\n"
alla kroppsvärden är ASCII, null–terminerade strängar.
body – indikerar vanlig, utskrivbar text. Null byte kan inte representeras. Alla tecken anges med ett backslash.
bodyBinary – indikerar binär kod. Icke-utskrivbara tecken kodas i hexadecimalt i formen \ \ xHH, där HH anger det hexadecimala värdet. NULL byte anges av ”\\00”
bodyUnicode-US-English, specifikt Latin1 UTF–16LE (little-endian) endast Unicode. Den faktiska parametern avlägsnas från den extra nollbyten som lägger till varje tecken för att möjliggöra enklare läsning av texten. Det är åter bifogas av web.custombegäran innan du skickar till webbservern.
för icke–utskrivbara tecken Använd ett enda backslash. Null byte kan inte representeras.
för en kropp vars längd är över 100k visas ett variabelnamn istället för attributet. Variabeln definieras i lrw_custom_body.h.
encType
encType anger en innehållstyp, till exempel ”text/html”, som ska anges som värdet för ”Content–Type”–förfrågningshuvudet för den aktuella omspelningen. webb.customRequest utför ingen kroppskodning. Kroppsargumentet anger det organ som ska användas som det är (eller efter att ha tillämpat ”binär” bearbetning), med någon kodning som redan har tillämpats. Att ange en encType som inte matchar kroppen kan därför orsaka ett fel på serversidan. I allmänhet rekommenderas att du inte redigerar encType som inspelad.
varje encType–specifikation åsidosätter tyst alla web_add_header för innehållstyp. Om ”encType= ”(tomt värde) anges genereras ingen” Content–Type ” – förfrågningshuvud. Om ”encType” utelämnas används alla tillämpliga web_add_header. Om det inte finns någon rubrik och” metod=POST ”används” application/x–www–form–urlencoded ” som standard. Annars genereras ingen rubrik för begäran om innehållstyp.
extraRes
de extra Resursattributen infogas endast när du utför HTML-baserad inspelning och alternativet ”icke HTML-genererade element” Avancerad inspelning är inställt på Spela in i det aktuella scriptsteget. Detta är standardinställningen. Mer information finns i hjälpcentret för virtuell Användargenerator (välj relevant version).
extraResBaseDir är basadressen för att lösa relativa webbadresser inom extraRes-gruppen. Webbadresser kan vara absoluta (som ”http://weather.abc.com/weather/forecast.jsp?loccode=LFPO”) eller relativa (som ”prognos.jsp?loccode=LFPO”). Den faktiska nedladdningen av webbadresser utförs alltid med absoluta webbadresser, så att relativa webbadresser måste lösas med en annan (absolut) URL som en ”bas”. Till exempel lösa den relativa ”prognosen.jsp?loccode=LFPO ” med ” http://weather.abc.com/weather/”som bas kommer att ge”http://weather.abc.com/weather/forecast.jsp?loccode=LFPO”. Som standard, när ”extraResBaseDir” inte anges, används den primära webbadressen till funktionen.
userAgent
userAgent är HTTP-huvudet som identifierar applikationen, vanligtvis en webbläsare, som representerar användaren i interaktionen med servern.
till exempel identifierar rubriken ”användaragent: Mozilla/4.0 (kompatibel; MSIE 6.0; Windows NT 5.0)” Microsoft Internet Explorer 6.0 för Windows NT. Andra användaragentsträngar används för olika webbläsare och för andra applikationer som inte är webbläsare. Vanligtvis använder alla förfrågningar från ett program samma Användaragentvärde, vilket inspelaren anger som en Körtidsinställning. Men även inom en vanlig webbläsarsession kan det finnas komponenter som inte är webbläsare (till exempel Active–X) som interagerar direkt med en server och vanligtvis har en annan användaragentsträng än webbläsaren.
ange en userAgent indikerar att detta är en sådan begäran som inte är webbläsare. Den angivna strängen används i HTTP-rubriken ”User-Agent:” och påverkar uppspelningens beteende på vissa punkter, till exempel genom att inte använda webbläsarens cache, förutsatt att de angivna webbadresserna är resurser etc. Ingen kontroll görs för att verifiera att det angivna värdet är annorlunda än webbläsarens.
använda binär kod
du kan använda följande format för att inkludera binär kod i kroppsparametern på en webb.customRequest funktion:
\x
detta representerar det hexadecimala värdet som representeras av .
till exempel: \x24 är 16*2+4 = 36, vilket är ett $ tecken; \x2B är + tecken.
sekvenser som inte representerar giltiga hexadecimala sekvenser med 2 tecken behandlas av VuGen som ASCII–text. Använd inte hexadecimala sekvenser med 1 tecken. Till exempel är ”\x2” inte en giltig 2–tecken hexadecimal sekvens. Använd istället ”\ x02”.
Observera att binära värden visas i ett skript som \\x, dvs ”x” föregås av två backslashes. Men när man skapar en webb.customRequest-funktionen genom att använda VuGen måste du bara skriva ett backslash.
om du använder parametrisering inom en webb.customRequest-funktionen, inkludera endast ett backslash inom definitionen av parametern.
exempel
webb.customRequest ({ namn: 'click_for_next.gif', url: 'http://kalimanjaro/Correlation_ASP_Project/click_for_next.gif', metod: 'hämta', resurs : 1, recontenttype : 'bild / gif', referens: '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=', ögonblicksbild: 't9.inf'});