Introduction

Orbeon Form Builder

Orbeon Form Builder est un outil visuel qui vous permet de créer et publier des formulaires rapidement depuis votre navigateur web.

Voici quelques-unes des fonctionnalités de Form Builder :

• 100% implémenté en technologies web. Form Builder ne requiert pas d'installation de logiciel sur l'ordinateur de l'utilisateur : vous n'avez besoin que d'un navigateur récent tel que Firefox, Safari, Google Chrome ou Internet Explorer, sans installation de plugins ou d'extensions.
• Disposition simple en grille. Form Builder utilise une disposition basée sur des sections et des grilles, dans lesquelles vous placez les éléments de formulaire. Vous vous concentrez sur les données à capturer, et non sur les détails ennuyants.
  
• Richesse des contrôles et de la validation de données. Form Builder supporte la validation de types de données courants, ainsi que des fichiers et images joints. Il vous permet également d'importer votre propre Schéma XML pour la définition de types simples.
  
• Sortie HTML et PDF automatique.  Les formulaires que vous créez avec Form Builder produisent automatiquement une sortie HTML et PDF élégantes.
  
• Internationalisation. Avec Form Builder, tout formulaire peut facilement inclure plusieurs langues, y compris pour les libellés, l'aide, et les messages d'erreur.
• Mode "expert" avec XForms. Pour les experts, Form Builder permet de communiquer avec le monde extérieur grâce à son éditeur de Services Web, et les auteurs avancés peuvent fournir leur propre code XForms.
• Formulaires accessibles. Les formulaires produisent soit de l'Ajax ou un format HTML plus accessible qui n'utilise pas de scripts.
  
• Environnement d'exécution intégré. D'un simple clic, vous publiez votre formulaire dans l'environnement Form Runner, et vos utilisateurs peuvent commencer à entrer des données.
• Actions et services. Créez des services et actions simples directement depuis l'éditeur, sans programmation.
  

Connaissances préliminaires

Form Builder peut être utilisé sans beaucoup de connaissances techniques pour créer de nombreux types de formulaires. Certaines des fonctionnalités avancées nécessitent des connaissances techniques, mais vous n'avez pas nécessairement besoin de les utiliser, et si oui vous pouvez déléguer ces tâches puisque Form Builder se prête bien au travail en équipe.

Glossaire

Voici quelques termes utilisés dans ce document :

• Contrôle de formulaire. Un contrôle de formulaire est un élément d'interface utilisateur tel qu'une ligne de texte, un groupe de boutons radio, un champ email ou valeur monétaire, etc.
  
• Définition de formulaire. Une définition de formulaire (aussi parfois simplement appelée "un formulaire") inclut un ensemble de contrôles, une disposition de ces contrôles à l'écran, une représentation des données à capturer (par ex. un format de document en XML), et optionnellement des événements et actions définissant un comportement lorsque l'utilisateur interagit avec les contrôles, ainsi que des règles qui peuvent s'appliquer aux données.
  
• Données de formulaire. Les données de formulaire sont les données capturées ou éditées par une définition de formulaire.
• Auteur de formulaire. L'auteur du formulaire est la personne créant une définition de formulaire (en utilisant un outil visuel, ou en écrivant du code).
• Entrée de données. Action d'entrer des données dans un formulaire.
• Utilisateur de formulaire. L'utilisateur du formulaire, à l'opposé de l'auteur du formulaire, est la personne qui entre des données dans un formulaire.
  
• Form Builder. Le logiciel, décrit dans ce document, utilisé par l'auteur du formulaire pour créer une définition de formulaire.
• Form Runner. L'environnement d'exécution d'Orbeon Forms, qui s'occupe de présenter une définition de formulaire à l'utilisateur du formulaire.
• Edition. Période durant laquelle le formulaire est édité dans Form Builder.
• Exécution. Période durant laquelle le formulaire est exécuté par Form Runner, et durant laquelle l'utilisateur peut entrer des données.
  

Logiciel nécessaire

Sur le client, Form Builder nécessite un navigateur web moderne, par exemple :

• Firefox 3 ou plus récent
  
• Safari 3 ou plus récent
• Google Chrome
• Opera 10 ou plus récent
• Internet Explorer 7 (pas recommandé) ou plus récent

Plus le navigateur est rapide, meilleure sera l'expérience de l'auteur du formulaire. Pour cette raison, le navigateur que nous recommandons le moins est Internet Explorer 7.

Les formulaires produits par Form Builder fonctionnent également sur IE 6 et des navigateurs plus anciens.

---

Cycle de vie d'un formulaire

Introduction

Les cas d'usage pour le déploiement de Form Builder et Form Runner peuvent varier en fonction de la configuration, mais voici un scénario typique :

• Edition. L'auteur du formulaire
  
• Initie la création d'une nouvelle définition de formulaire dans la page de sommaire de Form Builder
• Edite la définition de formulaire dans l'éditeur de Form Builder
• Sauvegarde la définition de formulaire
• Teste la définition de formulaire
• Plusieurs cycles édition/sauvegarde/test peuvent avoir lieu
  
• Publie la définition de formulaire
• Exécution. L'utilisateur du formulaire
  
• Initie la création de nouvelles données de formulaire dans la page de sommaire du formulaire
• Entre des données dans le formulaire
• Revoit, sauvegarde, soumet, ou télécharge les données entrées
  

Les définitions de formulaire, ainsi que les données de formulaire, peuvent également être recherchées et supprimées.

Publication

La notion de publication est centrale à Form Builder/Form Runner.

• En tant qu'auteur de formulaire, vous travaillez sur une définition de formulaire dans un espace spécial où le formulaire peut être modifié, sauvegardé, et testé.
• Lorsque la définition de formulaire est prête, vous la publiez vers Form Runner.
  
• Après ce moment-là :
• le formulaire devient disponible pour les utilisateurs du formulaire pour l'entrée de données
• Form Builder n'est plus impliqué
  

NOTE : En date de juin 2009, Form Builder a du support très limité pour le versionage des définition de formulaire. Vous pouvez publier un formulaire plusieurs fois, mais les nouvelles versions remplacent les anciennes. Il faut donc être prudent lors de multiples publications.

---

Page de sommaire de Form Builder

Utilité

La page de sommaire de Form Builder est votre point de départ lorsque vous travaillez avec Form Builder. Elle permet de :

• Lister, chercher, et naviguer les définition de formulaire
• Créer de nouvelles définition de formulaire
• Editer les définition de formulaire
• Supprimer les définition de formulaire
• Tester les définition de formulaire

NOTE : Les définition de formulaire sont généralement stockées dans une base de données sur le serveur. En général vous ne les gardez pas sur votre propre ordinateur.

Accéder à la page de sommaire

Vous accédez à la page de sommaire depuis votre navigateur par un URL (ou adresse web) de la forme :

NOTE : Il se peut que l'URL exact soit fourni par votre organisation.

Une fois la page de sommaire visible,  vous devez voir soit une liste vide, soit une liste des définition de formulaire existantes, comme visible sur cette copie d'écran :


Pour chaque définition de formulaire, la liste montre :

• La date de création
• La date de dernière modification
• Le nom d'application
  
• Le nom du formulaire
• Le titre du formulaire
  
• La description du formulaire si présente

Si la liste ne tient pas entièrement sur une page, vous pouvez naviguer vers les pages supplémentaires en utilisant les flèches au bas de la liste de résultats.

Si la liste est trop large, un ascenseur horizontal apparait au fond de la liste et vous permet de naviguer horizontalement.

Par défaut, la page de sommaire liste toutes les définitions de formulaire auxquelles vous avez accès.

NOTE : En fonction de vos permissions, les champs Nom d'application/Nom de formulaire peuvent être des champs de texte, ou des menus qui restreignent votre choix.

Rechercher et naviguer les définitions de formulaires

Le sommet de la page de sommaire montre des champs de recherche. Il y a deux types de recherche :

• Recherche libre. Ceci recherche un texte quelconque dans la définition de formulaire.
• Recherche structurée. Ceci recherche par Nom d'application, Nom de formulaire, Titre de formulaire, ou Description de formulaire.

Pour rechercher : entrer un terme de recherche, et pressez le bouton "Rechercher" ou la touche "Enter".

Conseil : pour remettre la recherche à zéro et lister à nouveau toutes les définitions, vider tous les champs de recherche et pressez le bouton "Rechercher" ou la touche "Enter".

Créer une nouvelle définition de formulaire

Pour créer une nouvelle définition de formulaire, presser le bouton "New" au fond de la page. Ceci ouvre l'éditeur de Form Builder dans une nouvelle fenêtre ou un nouvel onglet du navigateur.

Supprimer une définition de formulaire

A l'aide des case à cocher qui apparaissent sur chaque ligne, sélectionner les définitions à supprimer, puis presser le bouton "Supprimer".

Tester une définition de formulaire

A l'aide des case à cocher qui apparaissent sur chaque ligne, sélectionner une seule définitions à tester, puis presser le bouton "Tester".

Une nouvelle fenêtre ou un nouvel onglet du navigateur s'ouvre et montre le formulaire en mode de test. Notez que vous pouvez également tester le formulaire directement depuis l'éditeur.

---

L'éditeur de formulaire

Créer votre première définition de formulaire

Après avoir pressé le bouton "New" de la page de sommaire, vous atteignez l'éditeur. Form Builder a besoin de deux informations initiales :

• Nom d'application. Chaque définition de formulaire a un nom d'application, qui identifie un groupe de formulaires groupés logiquement. En pratique, un nom de formulaire peut correspondre à un projet, un département, une entreprise. Par exemple, tous les formulaires faits par Orbeon ont le nom d'application "orbeon".
  NOTE : En fonction de vos permissions, le nom d'application peut déjà être sélectionné. Il se peut aussi que vous ayez un choix limité de noms prédéfinis.
  
• Nom de formulaire. Chaque définition a aussi un nom de formulaire, qui identifie un formulaire unique dans une application donnée.

Aussi bien le nom d'application que de formulaire doivent suivre un format donné :

• Utiliser des lettres et optionnellement des chiffres et séparateurs tels que "-" et "_"
• Commencer par une lettre
  
• Ne pas utiliser d'espaces

NOTE : Une raison d'être de ces restrictions est que ces noms sont utilisés dans les URLs créés par Form Runner lorsque le formulaire est publié, et que de cette façon les URLs sont plus "propres".

Pour votre premier formulaire, ne vous souciez pas trop de ces noms : entrez n'importe quelle valeur valide. Vous pouvez toujours les changer plus tard !

Disposition générale de Form Builder

L'éditeur de Form Builder est organisé en 4 régions :

• Sommet : zone de titre  avec information d'état et sélection de la langue de l'interface de Form Builder.
• Gauche : boîte à outils, qui peut être déplacée verticalement en fonction de la taille du navigateur ou du moniteur.
• Fond : icônes d'état et boutons.
  
• Centre : zone WYSIWYG où vous éditez effectivement la définition de formulaire. Cette région peut avoir un ascenseur vertical et/ou horizontal en fonction de la taille du navigateur ou du moniteur, ou de celle du formulaire en cours d'édition.
  

Barre du sommet

En haut à droite de la barre du sommet, vous pouvez changer la langue de l'interface de Form Builder en cliquant sur une des langues disponibles. En date de juin 2009, l'anglais et le français sont disponibles. Des langues supplémentaires pourront être rajoutées dans le futur.

Changer la langue met à jour l'interface de Form Builder immédiatement : vous n'avez pas même besoin de sauvegarder votre formulaire avant un changement de langue.

NOTE : Cette fonction contrôle seulement l'interface utilisateur de Form Builder. Pour la fonction de localisation du formulaire en cours d'édition, voir plus loin.

De plus, la barre du sommet affiche certaines informations d'état, comme ce message indiquant que la définition de formulaire a été sauvegardée avec succès.

Barre du fond

La barre du fond de Form Builder contient deux types d'objets :

• Icônes d'état
• Icône "Erreurs dans le formulaire". Cette icône rouge indique si le formulaire contient des erreurs, tel un titre de formulaire ou de section manquant. Si cette icône apparait, vous ne pouvez pas sauvegarder la définition de formulaire.
• Icône "Changements non sauvegardés". Cette icône indique que le formulaire a des changements non sauvegardés.
  
• Boutons
• Bouton "Fermer". Ferme la fenêtre ou l'onglet du navigateur dans lequel l'éditeur est ouvert.
• Si le formulaire a des changements non sauvegardés, un message d'avertissement apparait.
• Sinon, la fenêtre ou l'onglet se ferme et ramène à la page de sommaire de Form Builder.
  
• Bouton "Tester". Teste le formulaire courant. Si le formulaire contient des erreurs, ce bouton est grisé.
  
• Bouton "Publier". Publie le formulaire courant. Si le formulaire contient des erreurs ou n'est pas sauvegardé, ce bouton est grisé. Vous devez corriger toute erreur et sauvegarder le formulaire avant de pouvoir le publier.
  
• Bouton "Sauvegarder". Sauvegarde le formulaire en base de données.

---

La boîte à outils de Form Builder

---

La zone WYSIWYG de Form Builder

Introduction

L'apparence de la zone WYSIWYG est conçue pour ressembler le plus possible au formulaire publié.

Form Builder utilise des concepts simples pour la disposition des contrôles : sections et grilles. Ceci est considéré une bonne alternative :

• au positionnement absolu, qui est rarement approprié pour les formulaires sur le web
• aux dispositions complexes, qui souvent déroutent les auteurs de formulaires

Dans le futur, il se peut que d'autres dispositions soient ajoutées à Form Builder.

Edition en place

Form Builder vous permet d'éditer certaines informations en place. Ceci signifie simplement que le texte apparait tel qu'il le ferait dans le formulaire publié, mais devient éditable lorsque vous cliquez sur ce texte.

Pour éditer ce texte :

• Cliquer sur le texte (ou conseil à l'entrée)
  
• Un champ de texte apparait
• Entrer ou modifier le texte
• Presser le bouton "Appliquer"

Pour indiquer que le champ est éditable, un surlignage apparait lorsque la souris le survole.


Ce mécanisme permet d'éditer :

• Le titre du formulaire
• La description du formulaire
• Le titre d'une section
  
• Les libellés de contrôles
  
• Les conseils à l'entrée de contrôles
  

Logo, titre, et description du formulaire

Form Builder vous permet d'importer un logo optionnel qui apparait au sommet de votre formulaire. Simplement utiliser le sélecteur de fichier pour spécifier ou remplacer le logo, et il apparait ensuite sur la page. Pour des raisons esthétiques, il est recommandé d'utiliser un petit logo horizontal, similaire au logo d'Orbeon.

Le titre du formulaire est obligatoire. Le tire peut être édité en place : simplement le cliquer pour faire apparaitre le champ de texte.

La description du formulaire est optionnelle. Vous l'éditez de la même façon que le titre.

Cette copie d'écran montre :

• Le logo Orbeon
• Le titre "Collection vidéo"
• La description "Ce formulaire vous permet d'entrer des informations sur votre collection vidéo."

Sections et grilles

Form Builder représente chaque formulaire comme une série de sections :

• Une section représente simplement un groupement logique de contrôles. Par exemple, un formulaire peut avoir une section "Adresse", et une section "Détails personnels".
• Les sections sont ordonnées, l'une au-dessous de l'autre.
  
• Chaque formulaire possède au moins une section.
• Il n'y a pas de limite au nombre de sections dans un formulaire.

Vous pouvez effectuer les opérations suivantes sur une section :

• Définir le titre de la section en cliquant sur celui-ci. Le titre est localisable.
• Supprimer la section en cliquant sur l'icône poubelle. Si la section contient des contrôles, un message de confirmation apparait.
• Définir un message d'aide optionnel pour la section, en cliquant sur l'icône d'aide. L'aide est localisable.
• Définir les propriétés de la section.
• Ouvrir ou fermer la section en cliquant sur la flèche à gauche du titre.
• Déplacer la section vers le haut ou vers le bas en cliquant sur les flèches "Déplacer vers le haut"ou "Déplacer vers le bas". Ces flèches apparaissent lorsque nécessaire si plus d'une section est présente.
  

Chaque section contient une ou plusieurs grilles :

• Une grille est un groupement logique des contrôles organisés en lignes et colonnes.
• Une grille possède entre 1 et 4 colonnes.
• Une grille peut posséder un nombre quelconque de lignes.
  
• Une cellule peut contenir un seul contrôle, ou rester vide.
• Une cellule peut couvrir plusieurs lignes.
  
• Contrairement aux sections, une grille n'a pas de titre ou de propriétés.

Lorsque le pointeur de la souris survole une grille, les frontières de celle-ci, ainsi que des icônes, apparaissent.

La copie d'écran suivante montre deux sections, "Section 1" et "Section 2". La première section contient une grille de 3 colonnes par 2 lignes.

Vous pouvez effectuer les opérations suivantes sur une grille :

• Ajouter des colonnes en cliquant sur les flèches gauche/droite au sommet de chaque colonne.
• Ajouter des lignes en cliquant sur les flèches haut/bas à gauche de chaque ligne.
• Supprimer une colonne en cliquant sur l'icône poubelle au sommet de la colonne.
• Supprimer une ligne en cliquant sur l'icône poubelle à gauche de la ligne.
• Supprimer toute la grille en cliquant sur l'icône poubelle en haut à gauche de la grille.
  

Pour les actions de suppression, un dialogue de confirmation apparait si des contrôles vont être détruits.

Cellules et contrôles

Chaque cellule peut contenir un seul contrôle, ou être vide. Si un contrôle est présent, les actions suivantes sont possibles :

• Définir le libellé : cliquer sur le libellé (édition en place)
• Un libellé apparait en général au dessus du contrôle. Le but du libellé est de fournir une description simple de la fonction du contrôle.
• Exemples : "Prénom", "Rue", "Numéro de téléphone".
  
• Définir le message d'aide : cliquer sur l'icône "point d'interrogation" pour ouvrir le dialogue "Edition de l'aide"
  
• Définir le conseil à l'entrée : cliquer sur le conseil à l'entrée (édition en place)
• Le conseil à l'entrée d'un contrôle apparait en général sous le contrôle. Le but est de fournir une indication simple sur la manière de remplir le champ.
• Exemples : "Votre prénom", "Date au format jj/mm/aaaa".
  
• Définir une valeur par défaut : simplement entrer le texte, ou sélectionner une valeur
  
• Editer la liste de choix du contrôles : cliquer sur le texte ou l'icône "Editer la liste" pour ouvrir le dialogue "Editeur de listes de choix" (contrôles de sélection seulement)

Lorsque votre pointeur de souris survole une cellule contenant un contrôle, certaines icônes apparaissent :

• Icône "Supprimer le contrôle" : supprimer le contrôle.
• Ceci aussi supprime les informations associées au contrôle, y compris les propriétés de validation et la représentation XML.
  
• Icône "Détails du contrôle" : ouvre le dialogue "Détails du contrôle".
  
• Icône "Réglage de la validation" : ouvre le dialogue "Réglage de la validation".
• Icône "Etendre : étend la cellule vers le bas si possible.
• Ceci permet au contrôle de prendre deux lignes ou plus dans la grille, par exemple pour une longue liste de boutons radio.
  
• Si le contrôle prend plus d'une ligne, une icône "Rétrécir" apparait pour effectuer l'opération inverse.
  
• Icône "Changer l'apparence" : change l'apparence entre types de contrôles de sélection (contrôles de sélection seulement)

Espace réservé pour les boutons du formulaire

Ceci est simplement une région vide montrant où les boutons de votre formulaire, tels que "Sauvegarder", "Fermer", etc. seront affichés par Form Runner.


Lors de la première ouverture du dialogue, une seule entrée vide est présente. Vous ajoutez des choix avec le bouton "+", et les supprimez avec les icônes poubelles.

Notes d'utilisabilité :

• Dans un champ libellé, presser la touche "tab" vers une valeur vide crée automatiquement une valeur par défaut. Par ex. :
  
• "Pomme" devient "pomme"
• "Jamalac blanc" devient "jamalac-blanc"
• Dans un champ de valeur, presser la touche "enter" ajoute automatiquement un nouveau choix après le choix courant.
  

Il y a des contraintes sur les valeurs acceptables :

• Pour les contrôles de sélection simples (par ex. boutons radio), la valeur peut être une chaîne de caractères quelconque.
• Pour les contrôles de sélection multiple (par ex. cases à cocher), la valeur ne doit pas contenir d'espaces.
  

Pour vous faciliter la vie, l'éditeur vous permet de passer d'une langue à l'autre sans fermer le dialogue.

Les valeurs associées aux choix ne sont pas localisables : elles restent les mêmes pour chaque langue. Par contre, les libellés sont localisables. Par ex. :

• Français
• Nom : "Pomme"
• Valeur : "pomme"
• Anglais
• Nom : "Apple"
• Valeur : "pomme"
  

Ceci assure que les données capturées sont lisibles par du logiciel même si l'interface utilisateur change.

---

Localisation du formulaire

Travailler avec la localisation

Form Builder supporte des formulaires localisés. Ceci signifie que vos titres de formulaire, libellés, message d'aide, etc. peuvent être spécifiés en plus d'une langue. A l'exécution, l'utilisateur du formulaire peut choisir la langue ou utiliser la langue par défaut.

Par défaut, seule une langue est présente, typiquement le français. La langue par défaut est configurable dans Form Builder par un administrateur système.


Presser l'icône "+" fait apparaitre le menu suivant :


La liste vous permet de choisir une nouvelle langue à ajouter à la liste des langues du formulaire :

Lorsqu'une nouvelle langue est ajoutée :

• Elle apparait dans la liste des langues en haut à droite de la zone WYSIWYG
• Toutes les ressources localisées de la langue courante précédente sont copiées vers la nouvelle langue

Vous passez d'une langue à l'autre en cliquant sur la langue à sélectionner :

• La langue courante est reconnaissable car elle n'est pas soulignée comme un lien.
• Toute édition de ressource localisable se fait dans la langue couramment sélectionnée.

Vous pouvez supprimer la langue courante en pressant l'icône "-". Ceci supprime toutes les ressources associées à cette langue. Vous devez donc être prudent en supprimant une langue. Un message d'avertissement apparait avant que la suppression ne se fasse.

Voici les étapes typiques pour créer un formulaire en deux langues :

• Créer le formulaire dans la langue principale et entrer toutes les ressources localisables tels que libellés, messages d'aide, conseils à l'entrée, etc.
• Ajouter la seconde langue.
• Traduire les ressources localisables qui sont maintenant visible sur le formulaire.
• En testant le formulaire, vous pouvez passer d'une langue à l'autre pour vous assurer qu'aucune ressource n'a été omise.

Changer les métadonnées du formulaire

La catégorie "Métadonnées" vous permet de changer le nom de l'application et du formulaire. Simplement cliquer le lien "Editer métadonnées" pour mettre à jour les champs.

Génération PDF

Introduction

Form Builder et Form Runner peuvent produire une sortie PDF de deux façons :

• Automatique
• Le PDF est produit en fonction de l'apparence du formulaire dans votre navigateur. La sortie est similaire à une version en lecture seule de votre formulaire à l'écran.
• En tant qu'auteur de formulaire, aucune configuration spéciale n'est nécessaire pour ce mode.
  
• Basée sur un PDF modèle
  
• Vous importez un fichier PDF en utilisant le dialogue "Importer PDF" dans la boîte à outils. A l'exécution, Form Runner remplit les champs Acrobat contenus dans le modèle.
• Ce mode est activé automatiquement si un modèle PDF est annexé au formulaire.

Fonctionnement des modèles PDF

Le but des modèles PDF est de permettre l'utilisation de fichiers PDF existants et d'utiliser Form Runner pour les remplir. Ceci a les atouts suivants :

• Il se peut que votre organisation ait déjà de nombreux formulaires au format PDF.
• Ces formulaires on probablement fait l'objet d'une conception précise pour l'impression ou l'archivage.
  

Un modèle PDF doit inclure des champs de formulaire Acrobat. Ceux-ci peuvent être créés avec Acrobat Professional.

A l'exécution, lors de la production de la sortie PDF finale, Form Runner effectue les opérations suivantes :

• Le modèle PDF est lu
  
• Les données du formulaire remplies au format XML sont lues
  
• Pour chaque contrôle, un nom est construit, sous la forme "nom-de-section$nom-de-champ". Par ex. :
• Le nom du contrôle est "prénom" (défini dans le dialogue "Détails du contrôle")
• Le contrôle est dans une section appelée "adresse" (défini dans le dialogue "Détails de la section")
• Le nom de champ PDF produit est : "adresse$prénom"
• Ceci est le nom de champ qui doit être utilisé dans le modèle PDF de sorte que Form Runner soit capable d'en effectuer le remplissage !
  

Créer un modèle PDF utilisable avec Form Builder

1. Ouvrir un fichier PDF existant
   
2. Effectuer la détection automatique de champs
3. Supprimer les régions incorrectement détectées, et rajouter les champs manquants
4. Entrer tous les noms de champs, en suivant la consigne "nom-de-section$nom-de-champ" expliquée ci-dessus
5. Zones de texte multi-ligne
• Activer le mode "multi-line" dans Acrobat pour le champ
• Mettre si nécessaire un fond blanc pour cacher par ex. des lignes pointillées venant du formulaire original
6. Cases à cocher exclusives
   
• Utiliser des boutons radio PDF avec apparence "Cross" ou "Check"
• Utiliser le même nom pour tous les boutons liés
  
• Utiliser par contre une "export value" différente pour chaque bouton
• La valeur du choix du contrôle (et NON le libellé) est utilisée par Form Runner pour l'associer à l'"export value"
7. Cases à cocher non-exclusive
• Utiliser des cases à cocher PDF
• Utiliser le même nom pour tous les boutons liés
  
• Utiliser par contre une "export value" différente pour chaque bouton
• La valeur du choix du contrôle (et NON le libellé) est utilisée par Form Runner pour l'associer à l'"export value"
8. Menu
• Utiliser un champ de texte PDF simple
9. Pour une langue comme le français, s'assurer que les champs aient une fonte Arial et non Helvetica. Ne pas utiliser Arial peut causer des problèmes avec les accents.

Avancé : import de Schéma XML

Travailler avec un Schéma XML

Le bouton "Importer schéma" dans la catégorie "Fonctions avancées" vous permet d'importer un Schéma XML au formulaire. Ceci a deux buts :

• Le schéma est utilisé pour valider les données du formulaire.
• Le types simple présents dans le schéma sont mis à disposition dans le dialogue "Réglage de la validation".

NOTE : En date de juin 2009, Form Builder n'est pas capable de gérer des sous-schémas importés/inclus. Si vous essayez d'importer de tels schémas, un message d'avertissement s'affiche.

Avancé : expressions XPath dans les dialogues "Détails du contrôle" et "Détails de la section"

Expressions XPath

XPath est un langage d'expressions pour XML. Il ne permet pas de modifier du XML, mais permet d'effectuer des recherches sur du XML et de calculer des valeurs.

En général, vous n'avez pas besoin de connaitre XPath dans Form Builder, à l'exception de certaines propriétés des dialogues "Détails du contrôle" et "Détails de la section". Les expressions XPath sont considérées une fonction avancée de Form Builder, qui peut nécessiter des connaissances de programmation.

Dialogue "Détails de la section"

Dans le dialogue "Détails de la section", les expressions XPath expressions sont utilisées pour spécifier les aspects suivants d'une section :

• Visibilité : expression booléenne spécifiant si la section est visible ou non.
• Si ce champ est vide, la section est toujours visible.
• Sinon, elle est visible seulement si le résultat de l'expression booléenne est true().
• Lecture seule : expression booléenne spécifiant si la section est en lecture seule ou non.
• Si ce champ est vide, le contenu de la section est toujours éditable.
• Sinon, le contenu de la section est éditable seulement si le résultat de l'expression booléenne est false().

Référencer des valeurs de contrôles

normalize-space($first-name) = ''

Explication :

if ($quantity1 castable as xs:integer and $quantity2 castable as xs:integer)
  then $quantity1 + $quantity2
  else ''

$fr-roles = 'admin'

A cause de la logique de XPath utilisée pour la comparaison des séquences, cette expression retourne true() si au moins l'un des rôles est "admin", même si d'autres rôles sont disponibles.

xxforms:get-request-header('full-name')