...
| Info |
|---|
Esup-signature propose de mettre rapidement en ligne des formulaires PDF en lignesimples. Cette fonction s'appuie sur les PDF Forms (formulaires présent présents dans les fichiers PDF). Esup D'une manière général, esup-signature est capable d'analyser les formulaires PDF, d'en effectuer le rendu (via PDF.js) et de stocker de "fusionner" les données saisie lors de la signature. Pour aller un peu plus loin vous avez la possibilité d'utiliser un PDF Form comme modèle au moment de démarrer un circuit. Dans ce cas on utilise le module d'administration pour déclarer un formulaire. Les formulaires sont accompagnés de plusieurs fonctions additionnelles :
|
|
La mise en place du formulaire basé sur un PDF se fait en 3 étapes :
- création du circuit des signatures
...
- (voir Gestion des circuits)
- création du PDF
...
- avec formulaire
- import dans Esup-signature
Création d'un PDF Form
Pour éditer créer un fichier PDF et créer un formulaire, il faut se doter d'un outils dédié. Lpossible d'utiliser Libre Office. Il gère correctement la création de champs de formulaires (texte, cases à cocher,...) ainsi que la conversion au format PDF. La seule restriction concerne les champs signature. Pour palier au problème, l'université de Rouen utilise Adobe Acrobat PRO. Sous linux il existe Master PDF Editor (payant), disponible pour Windows, Linux et Mac.
L'opération consiste donc à placer les champs de formulaire puis à les configurer de la bonne façon.
...
- Le nom. Esup-signature utilisera ce nom comme identifiant du champ.
- Cocher ou non "Obligatoire"
- Cocher ou non "Lecture seule"
- Esup-signature gère les champs texte, texte multi-lignes, cases à cocher, radio boutons et liste déroulantes
- Dans la partie "Format" des champs texte, sont gérés par esup-signature reconnait les type formats : Nombre , et Date et /Heure
- Toutes les autres options n'auront aucun effet sur le comportement d' Esupesup-signature
Une nomenclature de nommage des champs peut être utilisée pour signifier à Esup-signature d'opéré un traitement spécifique à un champ. On peut, via un nommage correcte, préciser si le champ doit être pré-rempli par Esup-signature et à quelles étapes le champ est modifiable.
| Remarque |
|---|
Depuis la version 1.2, la nomenclature des champs a changée. De plus, il n'est plus nécessaire de configurer ces comportements directement dans le fichier PDF. Il est maintenant possible de (re)définir la configuration après import du modèle PDF dans esup-signature Les comportements spécifiques sont à configurés dans l'onglet "Calcul" puis la partie "Script de calcul personnalisé" au niveau des propriétés des champs d'Acrobat Pro. |
La syntaxe à utiliser au niveau des scripts de calcul des champs est la suivante :
...
prefill.ldap(person, sn);
...
search.ldap(person, displayName);
...
Import du formulaire
Lorsque le formulaire PDF est terminé, il faut l'importer dans Esup-signature. Pour cela il faut aller sur "Admin" puis "Formulaire" puis cliquer sur le bouton bleu "+" et enfin sur l'icone PDF.
Vous devez saisir les informations suivantes :
- un nom (technique)
- un titre (affiché sur le bouton de création d'un nouveau document)
- sélectionner votre modèle PDF Form
- choisir la visibilité pour tous ou saisir les rôles pour définir qui peut accéder à ce formulaire
- choisir le type de pré-remplissage
- choisir un circuit qui aura été créer au préalable
Lorsque vous validez le formulaire, Esup-signature analyse le PDF Form et constitue la structure du formulaire. Vous avez ensuite accès à la configuration des champs
...
.
Voici un exemple de l'édition des champs d'un formulaire dans l'interface administrateur d'esup-signature ("Admin" → "Formulaire" → "Modifier les champs" :
On voit ici les propriétés des champ modifiables, elle sont les suivante :
| Propriété | Fonction |
|---|---|
| Nom du champ | (non modifiable) |
| Description | apparaît au survol et lors du contrôle des champs requis |
| Type | text, checkbox, radio, date, time, number, select |
| Favorisable | si cette case est cochée, les données saisies dans ce champ seront proposées à l'utilisateur lors dela prochaine saisis |
| Requis | aux étapes concernées, les champs seront obligatoires |
| Lecture seule | verrouille le champ |
| Pré-remplissage | active la fonction de pré-remplissage du champ en fonction de l'utilisateur courant |
| Auto-complétion | active la fonction de d'auto-complétion du champ en fonction de la saisie courante dans le champ concerné |
| Nom du service | choix du service utilisé lors du pré-remplissage ou de l'auto-complétion (esup-signature propose default et ldap nativement voir ci-après) |
| Type de donnée | sélection du "sous-service" utilisé lors du pré-remplissage ou de l'auto-complétion |
| Attribut retourné | nom le l'attribut retourné lors du pré-remplissage ou de l'auto-complétion |
| Étapes autorisées | numéro des étapes pour lesquels les champs sont à remplir (le champ sera verrouillé à toutes les autres étapes) |
Exemple de rendu d'un formulaire :
Pré-remplissage et auto-completion
Comme vu précédemment, esup-signature permet le pré-remplissage des champs. Les services disponibles sont définis à l'aide de classes de type "ExtValue" (valeur externes) champ modifiables via l'interface. Si la syntaxe mise en place dans le modèle PDF Form est correcte, les champs seront pré-configurés. Sinon il est possible de reprendre la configuration sur cet affichage accessible dans le menu "Admin" → "Formulaire" → "Liste des champs".Sur cette copie d'écran on voit que le champ "prenom" est configuré comme suit : Obligatoire, pré-rempli du "givenName" de l"utilisateur courant, avec une auto-completion qui retour le givenName (exemple pas vraiment utile en temps normal mais qui illustre la possibilité de cumuler pré-remplissage et auto-completion) et enfin, modifiable à l'étape 0.
Esup-signature est fourni avec les classes DefaulExtValue et LdapExtValue. La classe DefaultExtValue est utilisable en mettant "default" dans le nom du service . Elle et "system" au niveau du type. Elle propose les données attributs (calculéescalculés) suivante suivant :
| nom de l'attribut | description |
|---|---|
| day | numéro du jour |
...
| month | numéro du mois |
...
| year | numéro du l'année |
...
| date | date du |
...
| jour | |
| time | heure |
...
| dateTime | date et |
...
| heure | |
| currentUser | nom prénom de l'utilisateur courant |
...
| stepUsers | liste des mails des participants à l'étape courante |
| currentStepNumber | numéro de l'étape courante |
| id | id de la demande de signature |
Vous Comme c'est le cas pour les classes workflow, vous pouvez créer vos propre classes de données externes en implémentant le type "ExtValue" en reprenant DefaultExtValue.java par exemple.
Classe de pré-remplissage
Pour pré-remplir ou auto-compléter un formulaire, Esup-signature se base une une classe de "pré-remplissage" du type "PreFill". D'origine Esup-signature est fourni avec la classe DefaultPreFill qui prend en charge les données externes de type Default DefaultExtValue et LdapLdapExtValue. Ceci répond à une grande partie des besoins. Cependant, tout comme cela peut être le cas pour les workflows, il se peut qu'il soit nécessaire de calculer certaines données à pré-remplir spécifiquement pour un formulaire (donnée calculée en fonction de l'utilisateur courant par exemple).
Dans ce cas il y a là encore la possibilité d'implémenter votre propre classe de type PreFill (voir DefaultPreFill.java pour l'exemple)
Import du formulaire
Lorsque le formulaire PDF est terminé, il faut l'importer dans Esup-signature. Pour cela il faut aller sur "Admin" puis "Formulaire" puis cliquer sur le bouton bleu "+" et enfin sur l'icone PDF.
Vous devez saisir un nom (technique) et un titre (beau titre), sélectionner votre modèle PDF Form, saisir un rôle pour definir qui peut accéder à ce formulaire, choisir le type de pré-remplissage, un circuit qui aura été créer au préalable et éventuellement un dossier de destination.
Lorsque vous validez le formulaire, Esup-signature analyse le PDF Form et constitue la structure du formulaire. Sur cet exemple, on voit qu'il a bien pris en compte la nomenclature des champs. Il est possible de modifier les informations saisies lors de la création en cliquant sur le bouton jaune "crayon"
Votre formulaire sera disponible sur la page d'accueil des personnes autorisées à y accéder. Voici un exemple du rendu dans Esup-signature :
