Les fonctionnalités décrites dans cette page font partie du Plugin Formulaires (installé par défaut dans l'application de démonstration Ametys).

L'éditeur en ligne des champs riches offre la possibilité de créer et gérer des formulaires dans vos contenus.

Cette page documente le processus de création d'un formulaire à l'aide de l'éditeur en ligne. Ce fonctionnement s'applique à la fois aux formulaires gérés avec l'application mais aussi aux formulaires vers un site externe.
Tous les autres renseignements quant aux fonctionnalités liées aux formulaires dans Ametys sont disponibles à la page suivante : Formulaires.

  1. Créer un formulaire
    1. Formulaire CMS
    2. Formulaire externe
    3. Cycle de vie
    4. Limitation des entrées
    5. Champs des formulaires
      1. Détails des types de champs
        1. Texte simple
        2. Zone de texte
        3. Liste déroulante
        4. Case à cocher
        5. Cases de choix
        6. Mot de passe
        7. Fichier
        8. Champ caché
        9. Coût
        10. Captcha
        11. Groupe de champs
        12. Bouton Valider
        13. Bouton annuler
  2. Exemple illustré
    1. Création et édition de l'article qui contiendra le formulaire.
    2. Mise en place du formulaire

Créer un formulaire

En édition, la création d'un formulaire est réalisée par le bouton suivant:

Vous pouvez choisir le type de formulaire à créer :

  • un formulaire CMS est entièrement géré par l'application.
  • un formulaire vers un site externe envoie les données vers ce site
    Un tel formulaire n'est pas géré par l'application CMS

Formulaire CMS

Un formulaire CMS :
- Stocke les données saisies par les utilisateurs en base de donnée.
- Ces données sont par la suite exploitables grâce à la fonction d'export des données au format Excel (fichier CSV).
- De plus il est possible de définir des destinataires du formulaire qui recevront les données saisies par les internautes.
- Enfin vous pouvez mettre en place un système d'accusé de réception permettant à l'utilisateur de recevoir un email confirmant la bonne réception des données dans l'application.

Dans l'onglet Edition, un formulaire est représenté par:

Dans l'onglet contextuel Formulaire CMS, vous pouvez ajouter des champs et formater votre formulaire

Gérer le Formulaire CMS :

 Champ

 Description

Aperçu 

Nom

Choisissez le nom du formulaire pour faciliter les traitements internes du CMS

 

Cycle de vie

Permet de choisir le cycle de vie à utiliser pour les entrées de formulaire. (voir page Formulaires)

Soumettre dans une autre fenêtre

Cocher cette case si vous souhaitez que la validation du formulaire s'ouvre dans une nouvelle fenêtre.

Apparence

Permet de choisir l'apparence du formulaire :

  • Libellé à gauche : une ligne par champ; le label à gauche, le champ à droite
  • Libellé au-dessus : libellé au-dessus du champ
  • personnalisé : vous pouvez déplacer les éléments comme souhaité

Pour que votre site reste accessible, les libellés doivent être à côté des champs.

Page de succès

Permet de choisir une page dans le plan du site vers laquelle le visiteur est redirigé après la soumission du formulaire.
Par défaut une page hors navigation est automatiquement générée.

Accusé de réception

Permet de choisir le champ contenant une adresse email vers laquelle l'internaute recevra un accusé de réception.
(voir page Formulaires)

Emails des destinataires du formulaire

Entrer les emails des personnes qui vont recevoir les données envoyées par les internautes.

 

Vous pouvez saisir une adresse email par ligne, ou les séparer par des espaces, des virgules à votre convenance.

Convertir en formulaire externe

Transforme le formulaire courant en formulaire vers un site externe.

Supprimer

Supprime le formulaire dans son ensemble.

Formulaire externe

Dans l'onglet Edition, le formulaire externe est représenté par:

Dans la barre d'outils, vous pouvez gérer le formulaire :

Gérer un formulaire externe :

 Champ

 Description

Aperçu 

 URL

Adresse web de l'application qui va réceptionner et traiter le formualire. Cette adresse doit vous être donnée par l'administrateur externe en question. Par exemple : http://www.monserveur.fr/monapp

Ce champ est nécessaire pour que votre formulaire fonctionne.

 

Soumettre dans une nouvelle fenêtre

Cocher cette case si vous souhaitez ouvrir une nouvelle fenêtre après la validation du formulaire par l'internaute.

Apparence

De même que pour le formulaire CMS, vous pouvez choisir l'apparence du formulaire externe.

Convertir en formulaire CMS

Transforme le formulaire courant en formulaire CMS à traitement automatique.

Supprimer

Supprime le formulaire dans son ensemble.

Cycle de vie

Pour chacun de vos formulaires CMS, vous pouvez choisir un cycle de vie (workflow) qui sera applicable sur les entrées du formulaires (autrement dit les réponses soumises par les visiteurs)

La liste des cycles de vie dépend de votre application. Les cycles de vie sont définis par l'intégration : Plugin Formulaires - Manuel d'intégration v1.9.0

Si au cours de la vie d'un formulaire, vous modifiez son cycle de vie, le statut (état du workflow) de l'ensemble des entrées sera ré-initialisé.

Limitation des entrées

Cette fonctionnalité est disponible à partir de la v2.10 des formulaires. 

Lors de l'édition d'un formulaire, il est possible de limiter les entrées, c'est-à-dire limiter le nombre de soumissions que les visiteurs pourront effectuer avant que le formulaire ne soit fermé. 

Cette limitation est accessible via le menu , qui ouvre la fenêtre suivante : 

 Paramètre

 Description

Obligatoire 

 Nombre de soumissions autorisées

Entier avec valeur minimum 1

Correspond à la limite du nombre de soumissions qu'il sera possible d'effectuer dans ce formulaire. 

Au delà de cette limite, le formulaire sera fermé.  

 

 Oui

 Affichage du nombre restant

Texte indiqué au début du formulaire pour indiquer le nombre de places disponibles restantes. 

Il est possible de laisser ce champ vide, dans ce cas, aucun texte ne sera affiché. 

Des mots clefs (à écrire entre {}) peuvent être utilisés et seront remplacés dans le texte par les valeurs correspondantes : 

  • {remaining} : nombre de places restantes
  • {submissions} : nombre de soumissions déjà effectuées
  • {limit} : nombre de soumissions maximales autorisées

Par défaut, la phrase proposée est : Il reste {remaining} place(s)

 Non

 Affichage du formulaire fermé

 Texte indiqué à la place du formulaire lorsque la limite de soumissions sera atteinte. 

Il est possible de laisser ce champ vide, dans ce cas, aucun texte ne sera affiché à la place du formulaire.

Les mêmes mots clefs que ci-dessus peuvent être utilisés. 

Par défaut, la phrase proposée est : Désolé, ce formulaire d'inscription n'est plus disponible car il n'y a plus de places disponibles. 

 Non

Le bouton "Ok" permet de mettre en place la limitation des entrées, 

le bouton "Supprimer" permet quant à lui de supprimer les limitations. Dans ce cas, le nombre de soumissions n'est pas contrôlé. 

Champs des formulaires

Ceci est la liste des types de champs que vous pouvez insérer dans un formulaire; leurs propriétés sont décrites ci-dessous.

ChampRendu en éditionInformations complémentaires

Texte simple

 

Zone de texte

 

Liste déroulante

 

Case à cocher

 

Cases de choix

Pour créer un ensemble de cases de choix :

  • Créer un groupe de champs possédant le nom de votre choix (éditer la mention Groupement dans le champ riche)
  • Créer les cases de choix une à une en y spécifiant :
    • un nom de groupe identique (exemple : groupeA)
    • le libellé associé à la case
    • la valeur qui sera envoyée lorsque cette case sera sélectionnée (dans l'illustration de gauche, les cases sont respectivement associées aux valeurs A, B et C).

Mot de passe

Attention, le mot de passe qui sera spécifié par les utilisateurs sera stocké en clair et visible à l'aide d'un simple export.

Fichier

 

Champ caché

Un champ caché est un champ non visible par l'utilisateur. Il sert à stocker des informations qui seront utilisées dans le post-traitement ou tout simplement stockées pour un usage futur. La valeur de ce champ est statique.

Par exemple, un script de formulaire externe peut avoir besoin d'une référence pour être capable de savoir où les données du formulaires ont été saisie. Dans notre cas, le champ caché pourrait se nommer fromApplication et avoir comme valeur Ametys.

Coût

Ce champ est disponible à partir de la version 2.11 des formulaires

Captcha

 

Groupe de champs

 

Bouton valider

 

Bouton annuler

Ce bouton sert à réinitialiser le formulaire.

Le rendu des champs en mode édition est à titre indicatif.

L'onglet contextuel propre à chaque champ propose plusieurs zones de paramétrage :

  • La zone "propriétés" sert à renseigner les paramètres généraux.
  • La zone "règles" sert à définir certains aspects du comportement du champ (contraintes principalement).
  • La zone "contrôle" sert à déplacer ou supprimer le champ du formulaire.

Pour que votre site reste accessible, les cases de choix (bouton radio) d'un même groupe doivent être situées à l'intérieur d'un groupe de champs.

Dans le cas d'un formulaire externe, il est important de s'assurer que les identifiants des champs correspondent avec ceux attendus par l'application externe.

Détails des types de champs

Texte simple

Cocher la case "Obligatoire" pour rendre ce champ obligatoire.

Cocher la case "Avec confirmation" pour ajouter un deuxième texte simple juste en-dessous, de manière à demander à l'internaute de confirmer son entrée. Cette option est surtout utilisée pour confirmer un mot de passe ou une adresse e-mail.

Pré-remplissage: Vous pouvez choisir de pré-remplir automatiquement le champ avec une information de l'utilisateur connecté: Nom, Prénom, Nom complet, Email ou identifiant de connexion.
Attention, le champ sera pré-rempli uniquement si le formulaire est sur une page à accès limité et si un utilisateur est connecté sur le site.

Règle: Vous pouvez choisir une règle prédéfinie en choisissant une entrée dans la liste :

  • Entier
  • Décimal
  • Email
  • Téléphone
  • Date
  • Heure
  • Date et Heure
  • Personnalisé

Puis en renseignant les valeurs min et max au besoin (dépend de la règle choisie).

Si vous choisissez "Personnalisé", vous pouvez spécifier une expression régulière. (Voir le guide dédié de Mozilla pour plus d'informations sur les expressions régulières)

Zone de texte

Cocher la case "Obligatoire" pour rendre ce champ obligatoire.

Liste déroulante

Cocher la case "Obligatoire" pour rendre ce champ obligatoire.

Cocher la case "Choix multiples" pour autoriser la sélection multiple (à l'aide des touches CTRL et MAJ).

La case "Participe au coût" est disponible à partir de la version 2.11

Cocher la case "Participe au coût" si le champ participe au calcul du coût total. 

Le bouton "Choix de la liste" permet de peupler la liste des valeurs.

  • Si la case "Participe au coût" n'est pas cochée : 

  • Si la case "Participe au coût" est cochée, il est possible d'entrer un coût pour chaque option :

 

Case à cocher

Cocher la case "Obligatoire" pour rendre ce champ obligatoire.

Cocher la case "Coché par défaut" pour que la case apparaisse comme cochée au chargement du formulaire.

Cases de choix

Identique à "case à cocher", sauf pour la propriété "Groupe" qui permet de définir les groupes de cases à cocher. Une seule "case de choix" peut être sélectionnée par groupe.

Mot de passe

Les caractères sont remplacés par un * à l'écran.

Cocher la case "Obligatoire" pour rendre ce champ obligatoire.

Cocher "Avec confirmation": un deuxième champ mot de passe est ajouté juste en-dessous, de manière à confirmer l'entrée.

De même que pour le champ "Texte simple", vous pouvez spécifier les règles "min", "max" et "expression régulière".

Fichier

Cocher la case "Obligatoire" pour rendre ce champ obligatoire.

Taille maximale (en MO) : Taille maximale du fichier que le visiteur peut envoyer via le formulaire.

La taille totale du formulaire est limitée par le serveur : par exemple si le serveur limite l'envoie de fichier à 10 MO par formulaire, c'est l'ensemble des fichiers du formulaire qui ne doivent pas dépasser cette valeur.

Champ caché

Permet de définir un champ caché (champ de type hidden).

Coût

Ce champ Coût est disponible à partir de la version 2.11

Ce champ, en lecture seule, affiche le total des options sélectionnées (et sur lesquelles le coût a été activé) par l'utilisateur. 

Il est possible de choisir l'unité s'affichant après le coût : 

Exemple d'utilisation du coût : 

Captcha

Permet d'insérer un Captcha dans le formulaire pour se protéger des robots.

Groupe de champs

Un groupe de champs permet de grouper plusieurs champs ensemble.

Bouton Valider

Bouton annuler

Exemple illustré

Le webmaster ou un contributeur souhaite mettre en place un formulaire dans une page, par exemple un formulaire de contact.

Création et édition de l'article qui contiendra le formulaire.

Nous savons qu'un formulaire est un des éléments pouvant composer un contenu.
Il faut donc tout d'abord créer ou modifier une page puis y ajouter un contenu, voici les étapes à suivre :

  • Ouvrir ou créer la page qui contiendra le formulaire
  • sélectionner la zone qui contiendra le formulaire
  • insérer un article: dans l'onglet Page, cliquer sur Ajouter un contenu et choisir Article
  • dans l'onglet Contenu (puisque le nouvel article est automatiquement sélectionné), cliquer sur le bouton Modifier le contenu

Un onglet s'affiche avec l'Article en mode édition. L'onglet Edition est affiché.

Comme dans toute édition de contenu de type Article, le contributeur peut saisir un texte introductif, une image, etc...

Mise en place du formulaire

Une fois en édition sur le contenu, le contributeur peut insérer un formulaire dans n'importe quelle zone riche du contenu. Pour notre article, nous ajouterons le formulaire dans le champ Texte Riche intitulé Contenu.

  • Positionner le curseur à l'endroit où positionner le formulaire
  • dans l'onglet Edition, cliquer sur la flèche à droite de Formulaire
  • cliquer sur Formulaire CMS
  • une nouvelle zone vient s'ajouter dans le contenu, cette zone représente les limites du formulaire

  • un nouvel onglet Formulaire CMS est ouvert:
  • ce ruban permet de définir les paramètres du formulaire et de construire le formulaire.

Voici un exemple de formulaire de contact en mode édition:

 

Voici ci-dessous le rendu sur le front-office.

Retour en haut

Manuel utilisateur