...
| Info |
|---|
Esup-signature permet de créer des circuits de signatures puissants dont les fonctionnalités paramètres sont :
|
...
- Préciser un nom et une description (dans name et description)
- Implémenter la fonction generateWorkflowSteps()
...
Les formulaires
| Info |
|---|
L'autre fonction principale d'Esup-signature est la possibilité de mettre rapidement en ligne des formulaires. Cette fonction s'appuie sur les PDF Forms (formulaires présent dans les fichiers PDF). Esup-signature est capable d'analyser les formulaires PDF, d'en effectuer le rendu (via PDF.js) et de stocker les données saisies dans sa base de données. |
La mise en place du formulaire basé sur un PDF se fait en 2 étapes : création du PDF puis import dans Esup-signature
Création d'un PDF Form
Pour éditer un fichier PDF et créer un formulaire, il faut se doter d'un outils dédié. L'université de Rouen utilise Adobe Acrobat PRO. Sous linux il existe Master PDF Editor (payant)
L'opération consiste à placer les champs de formulaire puis à les configurer de la bonne façon.
Voici un exemple d'un document PDF en mode édition de formulaire sous Adobe Acrobat PRO.
Les champs doivent être configuré comme suit:
- Le nom peut correspondre ou non à une nomenclature (détaillée après) permettant le pré-remplissage lors de sa saisie par l'utilisateur final. Dans tous les cas Esup-signature utilisera ce nom comme identifiant du champ.
- Cocher ou non "Obligatoire"
- Dans la partie "Format" du champ, sont gérés par Esup-signature les type : Nombre, Date et Heure
- Toutes les autres options n'auront aucun effet sur le comportement d'Esup-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.
Pour ce faire le nom du champ doit être construit comme suit :
| <nom_du_champ> | $<nom_du_service_de_données_externes> | (<nom_du_champ_issue_des_données_externes>) | #<numéro_étape_1>#<numéro_étape_2> |
|---|---|---|---|
| prenom | $ldap | (givenName) | #1 |
Dans l'exemple suivant le nom du champ est "prenom$ldap(givenname)#1", traduction : le champ est nommé "prenom" il sera pré-rempli en utilisant la classe de données externes "ldap" (voir LdapExtValue.java) avec le champ "givenName" et uniquement modifiable à l'étape 1 du circuit
Attention : avec cette nomenclature l'étape de saisie correspond à l'étape 0 (zéro #0)
Esup-signature est fourni avec la classe DefaulExtValue et LdapExtValue. La classe DefaultExtValue est utilisable en mettant "$default" dans le nom du champ. Elle propose les données (calculées) suivante :
- numéro du jour (day)
- numéro du mois (month)
- numéro du l'année (year)
- date du jour (date)
- heure (time)
- date et heure (dateTime)
- nom prénom de l'utilisateur courant (currentUser)
Si vous souhaitez un champ date automatique dans votre formulaire PDF, il suffit donc le nommer "datejour$default(date)#0" par exemple.
Comme c'est le cas pour les classes workflow, vous pouvez créer vos propre classes de données extenes en implémentant le type "ExtValue" en reprenant DefaultExtValue par exemple.
Import du formulaire
Les messages d'information
...