Put

Télécharge les données fournies vers l’adresse URL indiquée.

Remarque : Acrobat et Adobe Reader ne sont pas capables d’identifier les formulaires certifiés tant que l’événement initialize n’a pas été lancé. pour tirer parti de la fonction Put sur les formulaires certifiés avant de procéder au rendu du formulaire, utilisez l’événement docReady.

Syntaxe

Put(s1, s2 [, s3 ])

Paramètres

Paramètre

Description

s1

Adresse URL de destination du téléchargement.

s2

Données à télécharger.

Si la fonction ne parvient pas à télécharger les données, elle renvoie une erreur.

s3 (facultatif)

Chaîne contenant le nom de la page de codes utilisée pour coder les données. Noms de pages de codes valides :

  • UTF-8 (valeur par défaut)

  • UTF-16

  • ISO8859-1

  • Tout codage de caractères reconnu par l’IANA (Internet Assigned Numbers Authority)

Si vous ne donnez pas de valeur à s3, la fonction attribue à la page de codes la valeur par défaut. L’application doit s’assurer que le codage des données à télécharger correspond à la page de codes indiquée.

Exemples

L’expression suivante illustre l’utilisation de la fonction Put :

Expression

Renvoie

Put("ftp://www.example.com/pub/fubu.xml", 
"<?xml version='1.0' 
encoding='UTF-8'?><msg>hello world!</msg>")

Rien si le serveur FTP a autorisé l’utilisateur à télécharger certaines données XML vers le fichier pub/fubu.xml sur le serveur. Dans les autres cas, la fonction renvoie une erreur.

Remarque : cet exemple fonctionne uniquement dans un environnement serveur et non dans Acrobat ou Adobe Reader. Pour les formulaires affichés dans Acrobat et Adobe Reader, utilisez les protocoles HTTP, HTTPS et FILE.