Mode d emploi. La Révolution du formulaire. Comment créer des scripts simples pour exploiter des formulaires PDF sur le Web. Nombre d entre nous ont

Transcription

1 PAR MALCOLM GUTHRIE ILLUSTRATIONS DE BRIAN FYFFE La Révolution du formulaire. Comment créer des scripts simples pour exploiter des formulaires PDF sur le Web Nombre d entre nous ont essayé d élaborer de simples formulaires Web. Parfois avec succès, le plus souvent sans résultat. Nous concevons de beaux formulaires pour les voir confisqués par des autorités sans cœur, balayés de l espace cybernétique et on nous accuse de tentative de soumission illégale que nous ne pouvons pas comprendre, et encore moins commettre intentionnellement. Cela vous est-il déjà arrivé? Avez-vous évité de créer des formulaires, par crainte d un échec ou d un refus? Bonne nouvelle! Vous pouvez désormais concevoir des formulaires Web et écrire les scripts permettant leur traitement. Avec Adobe PDF, vous pouvez allier beauté et fonctionnalité. Préparez-vous à être un libéré du formulaire. Cet article examinera d abord ce que nous appelons la source d un formulaire Web. Nous vous indiquerons ce qui se passe réellement quand vous cliquez sur le bouton Envoyer (Submit). Ensuite, nous vous expliquerons comment créer un exemple de formulaire PDF et les scripts correspondants exécutés sur votre site Web. A la fin de cet article, vous saurez créer et gérer des formulaires de toute sorte. Cela vous paraît incroyable, mais c est en réalité à votre portée. Comment ça marche? La communication sur Internet est fondée sur le modèle client/serveur. Le client (en général un navigateur Internet) fait une requête sur Internet (à partir d un serveur). Le serveur localise la ressource appropriée, la récupère et la renvoie au client. Il existe actuellement des millions de serveurs connectés à Internet dont la fonction principale est d être à l écoute des requêtes des clients. Pour que la communication fonctionne, clients et serveurs doivent correspondre sur deux points. Premièrement, le format de transmission de l information : le format utilisé sur Internet est le protocole TCP/IP. Ensuite, le langage de description de ce qui est envoyé. Pour Internet, il s agit de HTTP. HTTP permet à un client de formuler sa requête et au serveur d envoyer sa réponse. La requête est formulée au format URL. Adobe Magazine Automne

2 Plus concrètement, chaque fois que vous saisissez du texte (une URL) dans votre navigateur et que vous tapez Entrée, vous initialisez un échange HTTP. La fonction des formulaires. Pour les formulaires, la seule différence avec ce modèle est qu au lieu de recevoir du serveur une page HTML statique, on reçoit un document interactif nous demandant un seul renseignement. Un formulaire sur Internet peut prendre la forme d un document HTML, PDF ou tout autre type de document visualisable dans un navigateur (y compris des formats comme Java, Shockwave ou ActiveX). Après réception du renseignement et des données nécessaires, le serveur traite les données avec un script et renvoie une réponse directe. Par exemple, un script peut rechercher le nom de l utilisateur proposé dans la base de données de la société, effectuer des calculs relatifs au compte de cet utilisateur et retourner l information. En général, la réponse est un fichier HTML affiché dans le navigateur utilisateur, mais vous pouvez renvoyer au client tout type de fichier. Le script peut aussi renvoyer une réponse par ou diriger le client vers une autre page (par ex. une page de type «merci pour votre commande»). Introduction au format PDF. Les formulaires HTML existent depuis Cependant, HTML ne permet pas un positionnement très précis et son contrôle typographique est limité. C est pourquoi de nombreux sites Internet optent pour Adobe PDF (portable document format) pour leurs formulaires. L objectif de PDF étant de préserver le format original, il est devenu un outil de choix dans l élaboration de documents tels que publicités, notices et toutes sortes de formulaires. La création de documents PDF est simple. Avec Adobe Acrobat Distiller ou Adobe PDFWriter, vous DOCUMENTATION Pour des renseignements d ordre général sur la création de formulaires, reportez-vous à la publication : PDFs Talk Back par Teri Patrick, Adobe Magazine, printemps 1997 ( archive/spr97na.html) Pour créer un champ de formulaire : acrforms/main.html Guide Acrobat (acrohelp.pdf) Pour des renseignements plus précis sur les formulaires Ressources sur les formulaires Acrobat : formsresources.html Notes pour l implémentation système des formulaires Acrobat : acr4formssysnotes.pdf Kit Adobe Solutions Network (ASN) Developer Program Acrobat Form Data Format ( acrosdk/forms.html) Acrobat PDF Bible, Ted Padova, IDG Books, ISBN Forms: Interactivity for the World Wide Web Malcolm Guthrie, Adobe Press, ISBN Pour les scripts et autres sources de documentation sur le PDF pouvez convertir tout type de document au format PDF. De nombreuses applications, telles qu Adobe PageMaker, Adobe FrameMaker, et d'autres, disposent d une fonction d exportation PDF. Une fois le formulaire de base conçu dans un fichier PDF, vous pouvez utiliser le module Forms d Acrobat version 3.0 ou ultérieure pour incorporer des champs de formulaires ou autres technologies identiques à celles offertes par HTML. Comment les scripts s intègrent-ils? Les scripts sont des fichiers texte écrits dans un langage codé, déchiffrables et exécutables par un interpréteur. Situés à mi-chemin entre le HTML et les langages de programmation, ils incluent notamment JavaScript, VBScript et Perl, des noms dont la seule évocation fait paniquer la plupart des gens. Mais il suffit d apprendre les codes et conventions d usage basiques pour créer un script applicable à de nombreux formulaires. Vous pouvez aussi écrire et compiler un programme dans un langage comme Java, C++ ou Visual Basic. Ceux-ci traitent les informations plus rapidement qu un script, mais nécessitent plus de maintenance (et une expérience de la programmation). Pour modifier un type de champ, par exemple, vous devrez recompiler le programme pour appliquer la modification. Nous ne détaillerons pas davantage cette méthode ici. A table Après la théorie, voyons la pratique. Nous verrons d abord les outils indispensables. Ensuite, avec un formulaire de commande de pizza (simplifié pour la démonstration) comme interface cliente, nous vous indiquerons les paramètres requis pour les champs de formulaires, détaillerons les scripts correspondants et le processus de téléchargement et commanderons une pizza. Mais n espérez pas recevoir une pizza livrée chez vous. Le matériel. Quatre types de logiciels sont nécessaires à la création et au traitement d un formulaire. Un éditeur de texte tel que Bloc-notes ou SimpleText Adobe Acrobat Exchange 3.1 avec Adobe Forms Author Plug-in 3.5 ou Adobe Acrobat 4.0 Un navigateur Web prenant en charge Adobe Acrobat (Netscape et Internet Explorer 4.0 et ultérieurs conviennent) Un serveur Web. Consultez votre fournisseur d accès à Internet au sujet des options et formats. Avec un accès Web, vous pouvez exécuter un serveur depuis votre ordinateur via un logiciel au niveau système : sous Windows, Internet Information Server (IIS) ou Microsoft Personal Web Server avec extensions ASP ; sur Macintosh, Personal Web Sharing, disponibles sur Mac OS 8.0. Le script de la page suivante, écrit dans un éditeur de 56 Adobe Magazine Automne 1999

3 texte avec VBScript, est défini comme un document Active Server Page (.asp) pour être compatible avec Microsoft Personal Web Server ou IIS. Sur Macintosh, vous pouvez utiliser un script Perl (si vous disposez de MacPerl) ou AppleScript (beaucoup plus compliqué). Les scripts Mac de cet exemple sont disponibles à l adresse : archive/99aumg01.html. Pour un serveur UNIX, vous devrez sans doute aussi écrire ce script en Perl. Comme nous l avons mentionné, vous pouvez créer des scripts de façon très variée. Nous avons voulu présenter ce procédé en utilisant les outils dont vous disposez déjà. Pour une application à grande échelle, vous aurez probablement besoin d outils plus puissants. Avec Microsoft Personal Web Server et Microsoft Internet Explorer, si le fichier PDF ne s affiche pas Champ Type Opérations à effectuer «nom» texte Sous Propriétés du champ, Description (Acrobat 4.0) ou Par défaut (Acrobat Exchange 3.x) peuvent rester vides. «téléphone» texte Dans l onglet Format, sélectionnez le N de téléphone dans la liste Options Spéciales pour que seuls les numéros de téléphone valides soient acceptés. «taille» case à cocher Dans l onglet Options, les 3 boutons «taille» ont le même nom mais des valeurs d exportation différentes. Cochez Une taille requise pour qu une valeur soit toujours sélectionnée. Les valeurs, a priori numériques, peuvent aussi être des descriptions (petite, moyenne ou grande). «envoyer» bouton Sélectionnez Texte seul. Laissez vide le champ Attributs du bouton (le texte requis ici a été défini dans la page originale). Définissez Souris relâchée sur Inverser. Dans la zone Actions, définissez Souris relâchée sur Envoyer un formulaire, puis entrez l URL utilisée pour traiter le formulaire pizza.pdf (l adresse complète avec le nom du fichier script). Ici, nous avons utilisé le format HTML et envoyé tous les champs. comme prévu, configurez Internet Explorer pour utiliser Acrobat comme assistant plutôt que comme plug-in. Pour plus de détails, consultez le document «Configurer Internet Explorer et AOL pour Windows 95, Windows 98, et Windows NT 4.0 pour l affichage de fichiers PDF» sur le site Web d Adobe ( SOLUTIONS/98fe.Html). Le format PDF. Le formulaire suivant est simple : nom du client, numéro de téléphone, taille de la pizza et bouton d envoi, mais vous verrez que ces champs peuvent être utilisés pour collecter d autres types de données et renvoyer d autres informations. Rappelezvous : un formulaire PDF n a aucune limite. En considérant que vous maîtrisez la création de formulaires, nous survolerons les options de la boîte de dialogue Propriétés du champ à sélectionner pour Le dialogue rudimentaire de cet exemple peut être réemployé pour des opérations interactives, notamment des enquêtes, commandes, formulaires, jeuxconcours, horoscopes et cartes-réponses. le formulaire client de cet exemple. Reportez-vous au tableau de gauche. Le script. Le script complet figure ci-dessous. Tapez-le (sans les numéros de ligne) dans votre éditeur de texte (ou téléchargez-le à l adresse : 99aumg01.html). Remarque : les retraits servent à distinguer les différentes parties (il n existe pas de mise en forme dans ce langage) et les numéros de ligne sont indiqués pour référence. Attention : il s agit du script Windows. Consultez le site Web pour l équivalent Macintosh. 1. <%@ Language=VBScript %> 2. <HTML> 3. <HEAD> 4. <TITLE>Confirmation de commande de pizza </TITLE> 5. </HEAD> 6. <BODY> Adobe Magazine Automne

4 Si vous utilisez Personal Web Server, le fichier de script doit se trouver dans le même répertoire que le fichier PDF. Nous avons nommé le nôtre Pizza.asp pour aller avec le fichier Pizza.pdf, mais les noms ne doivent pas nécessairement être identiques. Assurezvous juste que vous avez bien spécifié les nom et chemin adéquats vers le script quand vous configurez le bouton Envoyer (Submit) dans le formulaire. 7. <H1>Merci.</H1> 8. <P> 9. Vous êtes <% =Request("nom") %>. 10.<BR><BR> 11.Votre numéro de téléphone est <% =Request("téléphone") %>. 12.<BR><BR> 13.Vous avez commandé une pizza <% =Request("taille") %> 14.<BR><BR> 15.Vous serez livré dans 30 minutes. 16.</BODY> 17.</HTML> Ce script ultra-simple contient pourtant l essentiel pour créer un formulaire élaboré. Comme vous le savez, il reçoit le formulaire envoyé et renvoie la réponse sous forme de fichier HTML. Voici comment il fonctionne : le serveur Web est configuré par défaut pour lire tous les fichiers se terminant par «.asp» avant de renvoyer leur contenu au client. Le serveur recherche dans ces fichiers s il figure une instruction délimitée par les caractères <% et %>, indiquant un traitement spécial requis. Le texte en dehors de ces caractères est renvoyé inchangé au client. La ligne 1 du script indique au serveur dans quel langage il est écrit (VBScript, ici). Les lignes suivantes sont du langage HTML standard. Le texte de ces lignes n étant pas compris entre des caractères spéciaux, le serveur le lit et le renvoie inchangé au client. La ligne 9 indique où intervient le premier traitement. D abord les caractères «Vous êtes» sont envoyés au client sous forme de texte élémentaire, comme précédemment, puis le serveur rencontre le caractère «<%» introduisant un script. Le caractère «=» demande au serveur de renvoyer les résultats de la commande suivante vers le client. Ensuite, la séquence appelle la fonction Request() (Voir le script). Plusieurs fonctions de scripts permettent de récupérer des données. Request(), l une des plus simples, est bien appropriée dans ce cas. Elle permet d extraire le texte d un champ spécifique et de le rechercher dans les données indiquées dans un formulaire envoyé. En cas de correspondance, la fonction Request renvoie la valeur envoyée par le champ. A la ligne 9, nous avons demandé une recherche sur le champ «nom». En continuant à lire la ligne 9, le serveur rencontre la combinaison de caractères «%>» indiquant que les instructions du script sont terminées. Le serveur poursuit sa lecture du fichier et renvoie le texte vers le client jusqu à ce qu il rencontre de nouveau la balise «<%». Cela se produit deux autres fois dans ce script. Request() apparaît lignes 11 et 13, pour récupérer les valeurs de champ «téléphone» et «taille». Cela terminé, le serveur prépare le reste du texte dans le fichier pour le retourner au client, renvoie la réponse entière sous forme de fichier HTML et met fin à la requête du client. Trop simple? Et si vous proposiez plusieurs garnitures de pizza et une livraison express. Ces deux éléments indiqueraient comment renvoyer des informations variables à l émetteur de requête. Ne désirant pas compliquer les choses, nous n irons pas plus loin, mais vous pouvez trouver cet exemple dans un formulaire et un script «pizza avancée» disponibles sur le Web. Et si vous vouliez enregistrer et gérer les commandes de pizza pour analyse ou traitement ultérieur? Nous verrons ce sujet dans la deuxième partie de cet article (Numéro de Janvier/Février 2000 d Adobe Magazine). Revenons à notre exemple. Maintenant que nous possédons un document PDF final et son script, nous pouvons les installer sur le serveur Web. Tout d abord, créez un répertoire Pizza sur votre serveur Web. Placez-y ensuite les fichiers pizza.asp et pizza.pdf. Vous pouvez aussi les placer à la racine, pourvu qu ils restent ensemble, mais pour une meilleure organisation, nous les placerons à un niveau inférieur de l arborescence. Attribuez aussi les privilèges d exécution du script, une étape incontournable sur la plupart des serveurs, y compris UNIX. Maintenant entrez l URL du formulaire dans le navigateur, de type : pizza.pdf. Remplissez les champs du formulaire et cliquez sur Envoyer (Submit). Le serveur renvoie une page HTML et confirme les renseignements envoyés. Libérez votre créativité Vous avez franchi une étape importante et pouvez désormais exploiter vos acquis. Cet article donne un aperçu des possibilités des formulaires PDF : envoyer des s, interroger une base de données ou créer un fichier image. Ne vous limitez pas au renvoi d un document HTML, essayez aussi d envoyer une image JPEG, un PDF ou même une information au même fichier PDF. Dans le prochain numéro, nous parlerons du Form Data Format (FDF) d Adobe. Maintenant, libérez votre créativité! Rappelez-vous, vous êtes libéré du formulaire. Malcolm Guthrie est directeur associé à MiX media ( un atelier de développement Web à San Francisco et auteur de : Forms : Interactivity for the World Wide Web (Adobe Press, 1998). 58 Adobe Magazine Automne 1999

5 Adobe Magazine Automne

6 60 Adobe Magazine Automne 1999