Post

Envía los datos especificados a la URL indicada.

Nota: Acrobat y Adobe Reader no pueden comprobar si el formulario está certificado hasta el inicio del suceso initialize. Para utilizar la función Post en formularios certificados antes de la representación del formulario, utilice el suceso docReady.

Sintaxis

Post(s1, s2 [, s3 [, s4 [, s5 ]]])

Parámetros

Parámetro

Descripción

s1

La URL a la que se va a enviar.

s2

Los datos que se van a enviar.

Si la función no puede enviar los datos, devuelve un error.

s3 (opcional)

Cadena que contiene el tipo de contenido de los datos que se van a enviar. A continuación se detallan los tipos de contenido válido:

  • application/octet-stream (valor predeterminado)

  • text/html

  • text/xml

  • text/plain

  • multipart/form-data

  • application/x-www-form-urlencoded

  • Cualquier otro tipo MIME válido

Si no se incluye un valor para s3, la función establece el tipo de contenido en el valor predeterminado. La aplicación garantiza que los datos que se van a enviar utilicen el formato correcto para el tipo de contenido especificado.

s4 (opcional)

Cadena que contiene el nombre de la página de códigos empleada para codificar los datos. A continuación se detallan nombres de página de código válidos:

  • UTF-8 (valor predeterminado)

  • UTF-16

  • ISO-8859-1

  • Cualquier codificación de caracteres admitida por la Autoridad de números asignados de Internet (IANA, del inglés Internet Assigned Numbers Authority)

Si no incluye un valor para s4, la función establece la página de códigos en el valor predeterminado. La aplicación garantiza que la codificación de los datos que se van a enviar coincida con la página de código especificada.

s5 (opcional)

Una cadena que contiene cualquier encabezado HTTP adicional que se vaya a incluir en el envío de los datos.

Si no se incluye un valor para s5, la función no incluye un encabezado HTTP adicional en el envío.

Los servidores SOAP suelen requerir un encabezado SOAPAction cuando se les envían datos.

Ejemplos

Las expresiones siguientes son ejemplos de uso de la función Post:

Expresión

Devuelve

 
Post("http://tools_build/scripts/jfecho.cgi", 
"user=joe&passwd=xxxxx&date=27/08/2002", 
"application/x-www-form-urlencoded")

Envía datos de registro codificados de URL a un servidor y devuelve la página de acuse de recibo del mismo.

 
Post("http://www.nanonull.com/TimeService/ 
TimeService.asmx/getLocalTime", "<?xml version='1.0' 
encoding='UTF-8'?><soap:Envelope><soap:Body> 
<getLocalTime/></soap:Body> 
</soap:Envelope>", "text/xml", "utf-8", 
"http://www.Nanonull.com/TimeService/getLocalTime")

Envía una solicitud de SOAP de la hora local a algún servidor, a la espera de una respuesta XML.