diciembre 16, 2021

web.customRequest

Le permite crear una solicitud HTTP personalizada con cualquier método compatible con HTTP.

Sintaxis

web.Solicitud personalizada ({objeto} );

Objeto 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":}
Nombre de la propiedad
Descripción
stepName El nombre del paso.
url La dirección de la página web a cargar. La URL puede ser cualquiera de los siguientes protocolos: HTTP, HTTPS o FTP. Para fines de autenticación, incluya el nombre de usuario y la contraseña en el atributo URL con el siguiente formato: ftp://username:password@server/dir/path.
método Cualquier método HTTP.
targetFrame El nombre del marco que contiene el enlace o recurso actual. Consulte targetframe para obtener más información.
encType El método de codificación. Vea los detalles a continuación.
recContentType El valor del encabezado de respuesta» Content–Type » según se registra, por ejemplo, texto/html, aplicación/x–javascript. El valor recContentType se usa cuando el atributo resource no se especifica para determinar si la URL de destino es un recurso o no. Para obtener más información, consulte reccontentType y resource
referer La página web que hace referencia a la página actual. Si la ubicación se expresó explícitamente, se omite este atributo.
Código del cuerpo El cuerpo está en Latin1 UTF–16LE (little-endian) Unicode. Véase «Cuerpo» a continuación.
bodyBinary El cuerpo está en código binario. Véase «Cuerpo» a continuación.
cuerpo El cuerpo de solicitud. Véase «Cuerpo» a continuación.
bodyFilePath La ruta de acceso a un archivo que se pasa como el cuerpo de la solicitud. bodyFilepath no se puede usar junto con ningún otro atributo body.
recurso Uno de:

  • 0 – No un recurso. El error de descarga es un error.
  • 1-Recurso. Descargado solo si el ajuste de tiempo de ejecución «Descargar recursos no HTML» está configurado. El fallo de descarga es una advertencia. No se analiza como HTML.
resourceByteLimit Ver resourceByteLimit.
instantánea El nombre de archivo del archivo de instantánea.
modo El Nivel de grabación: HTML o HTTP. Consulte Nivel / modo de grabación (Web).
Extrasbasedir La URL base para resolver URL relativas dentro del grupo extraRes. Para obtener más información, consulte a continuación.
userAgent El encabezado HTTP identificar la aplicación que representa al usuario en la interacción con el servidor. Para obtener más información, consulte a continuación.
Codificación de contenido Codificación para el cuerpo de la solicitud. Por ejemplo, gzip o desinflar.
rawBody el cuerpo de La solicitud es aprobada como un puntero a los datos.
Recursos extra generados por mecanismos no HTML en la página web.

Valores devueltos

No aplicable

Parametrización

Todas las propiedades se pueden parametrizar utilizando la parametrización estándar, excepto el nombre de paso.

Información general

La web.La función customRequest es una función de acción que le permite crear una solicitud HTTP personalizada utilizando cualquier método o cuerpo. (Cada función de acción web en un script hace que el navegador muestre una nueva página web o marco. VuGen puede grabar todas las funciones de acción web. De forma predeterminada, VuGen genera esta función solo para solicitudes que no se pueden interpretar con otras funciones web.

Para insertar esta función manualmente, utilice el cuadro de diálogo Agregar paso. Para especificar un encabezado HTTP que se enviará antes de la solicitud personalizada, agregue una web.AddHeader o web.Añadir función de encabezado automático.

El encabezado HTTP se puede modificar para pasar información adicional sobre la solicitud al servidor. Al usar encabezados HTTP, puede, por ejemplo, permitir otros tipos de contenido en la respuesta, como archivos comprimidos, o puede solicitar una página web solo en ciertas condiciones. Para modificar el encabezado HTTP de la solicitud, consulte web.AddHeader. Para modificar todas las solicitudes posteriores, consulte web.Añadir encabezado automático.

Body

El cuerpo de una solicitud se pasa como el valor de uno de los argumentos body, bodyBinary o bodyUnicode, dependiendo del contenido. Solo se puede pasar un argumento body*.

Ejemplos de especificaciones del cuerpo:

 Código del cuerpo:"REPRICE" Bodybinario:"\x08\\x00\\xCC\\x02\\x00\\x00" cuerpo:".\r\n–dxjjtbw/(.tp?eg:ch/6\\r \ n" 

Todos los valores del cuerpo son ASCII, cadenas con terminación nula.

cuerpo: indica texto imprimible normal. No se pueden representar bytes nulos. Todos los caracteres se especifican con una barra invertida.

Bodybinario-indica código binario. Los caracteres no imprimibles se codifican en hexadecimal en la forma \ \ xHH, donde HH especifica el valor hexadecimal. Los bytes NULOS se especifican por «\\00»

Código corporal-US-Inglés, específicamente Latin1 UTF – 16LE (little–endian) solo Unicode. El parámetro real se elimina del byte cero adicional que se añade a cada carácter para facilitar la lectura del texto. Se vuelve a anexar por web.Solicitud personalizada antes de enviar al servidor web.
Para caracteres no imprimibles, utilice una sola barra invertida. No se pueden representar bytes nulos.

Para un cuerpo cuya longitud es superior a 100K, aparece un nombre de variable en lugar del atributo. La variable se define en lrw_custom_body.h.

encType

encType especifica un Tipo de contenido, como «text / html», que se especificará como el valor del encabezado de solicitud» Content–Type » para la repetición actual. web.customRequest no realiza codificación de cuerpo. El argumento body especifica el cuerpo que se utilizará tal cual (o después de aplicar el procesamiento «binario»), con cualquier codificación ya aplicada. Por lo tanto, especificar un tipo de código que no coincida con el cuerpo puede causar un error en el lado del servidor. En general, se recomienda que no modifique el encType como grabados.

Cualquier especificación encType anula silenciosamente cualquier web_add_header para el Tipo de contenido. Si se especifica» encType= «(valor vacío), no se genera ningún encabezado de solicitud» Content–Type». Si se omite «encType», se utiliza cualquier encabezado web_add_header aplicable. Si no hay encabezado y «method = POST»,» application/x–www–form–urlencoded » se usa como predeterminado. De lo contrario, no se genera ningún encabezado de solicitud de tipo de contenido.

extraRes

Los atributos de recursos adicionales solo se insertan cuando se realiza una grabación basada en HTML y la opción de grabación avanzada «Elementos no generados por HTML» está configurada para grabar dentro del paso de script actual. Esta es la configuración predeterminada. Para obtener más información, consulte el Centro de ayuda del Generador de usuarios Virtuales (seleccione la versión correspondiente).

El extraResBaseDir es la URL base para resolver URL relativas dentro del grupo extraRes. Las URL pueden ser absolutas (como » http://weather.abc.com/weather/forecast.jsp?loccode=LFPO») o relativas (como «pronóstico»).jsp?loccode = LFPO»). La descarga real de URL siempre se realiza utilizando URL absolutas, de modo que las URL relativas deben resolverse utilizando otra URL (absoluta) como «base». Por ejemplo, resolviendo el pronóstico relativo.jsp?loccode = LFPO «usar» http://weather.abc.com/weather/ «como base producirá» http://weather.abc.com/weather/forecast.jsp?loccode=LFPO». De forma predeterminada, cuando no se especifica» extraResBaseDir», se utiliza la URL principal de la función.

UserAgent

El UserAgent es el encabezado HTTP que identifica la aplicación, generalmente un navegador, que representa al usuario en la interacción con el servidor.

Por ejemplo, el encabezado «Agente de usuario: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0)» identifica Microsoft Internet Explorer 6.0 para Windows NT. Otras cadenas de agente de usuario se utilizan para diferentes navegadores y para otras aplicaciones que no son navegadores. Por lo general, todas las solicitudes de una aplicación utilizan el mismo valor de Agente de usuario, que el grabador especifica como una Configuración de Tiempo de ejecución. Sin embargo, incluso dentro de una sesión regular del navegador, puede haber componentes que no sean del navegador (por ejemplo, Active–X) que interactúan directamente con un servidor, y generalmente tienen una cadena de agente de usuario diferente a la del navegador.

Especificar un agente de usuario indica que se trata de una solicitud que no pertenece al navegador. La cadena especificada se usa en el encabezado HTTP » User-Agent:»y afecta al comportamiento de la repetición en algunos puntos, por ejemplo, al no usar la caché del navegador, asumiendo que las URL especificadas son recursos, etc. No se realiza ninguna comprobación para verificar que el valor especificado sea diferente al del navegador.

Usando código binario

Puede usar el siguiente formato para incluir código binario en el parámetro cuerpo de una web.Función customRequest:

\x

Esto representa el valor hexadecimal representado por .

Por ejemplo: \x24 es 16*2+4=36, que es un signo$; \x2B es un signo+.

Las secuencias que no representan secuencias hexadecimales de 2 caracteres válidas son tratadas por VuGen como texto ASCII. No utilice secuencias hexadecimales de 1 carácter. Por ejemplo, «\x2 » no es una secuencia hexadecimal válida de 2 caracteres. En su lugar, utilice «\x02».

Tenga en cuenta que los valores binarios aparecen en un script como \\x, es decir, la «x» va precedida de dos barras invertidas. Sin embargo, al generar una web.Función customRequest al usar VuGen, solo necesita escribir una barra invertida.

Si utiliza la parametrización dentro de una web.Función customRequest, incluye solo una barra invertida dentro de la definición del parámetro.

Ejemplo

 web.customRequest( { nombre : 'click_for_next.gif', url: 'http://kalimanjaro/Correlation_ASP_Project/click_for_next.gif', método: 'GET', recurso: 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'}); 

Deja una respuesta

Tu dirección de correo electrónico no será publicada.