Créer un formulaire à l’aide du bloc de formulaires adaptatifs
AEM Forms Edge Delivery fournit un bloc, appelé bloc de formulaires adaptatifs, qui vous permet de créer facilement des formulaires pour capturer et stocker les données capturées. Vous pouvez créer un projet AEM préconfiguré avec le bloc de formulaires adaptatifs ou ajouter le bloc de formulaires adaptatifs à un projet AEM existant.
Ces formulaires envoient directement les données vers un fichier Microsoft Excel ou Google Sheets, ce qui vous permet d’utiliser l’écosystème dynamique et les API robustes de Google Sheets, Microsoft Excel et Microsoft SharePoint pour traiter facilement les données envoyées ou pour démarrer un workflow d’entreprise existant.
Prérequis
Avant de commencer, vérifiez que vous avez déjà effectué les étapes suivantes :
- Vous avez configuré un projet AEM à l’aide du modèle standard AEM Forms ou ajouté un bloc de formulaires adaptatifs à votre projet AEM existant et cloné le référentiel GitHub correspondant sur votre ordinateur local.
Dans ce document, le dossier local de votre projet Edge Delivery Services (EDS) est désigné par[EDS Project repository]
. - Assurez-vous d’avoir accès à Google Sheets ou à Microsoft SharePoint. Pour configurer Microsoft SharePoint en tant que source de contenu, voir Utilisation de SharePoint.
Créer un formulaire
Plutôt que de recourir à des processus complexes, il est possible de créer facilement un formulaire à l’aide d’une feuille de calcul. Vous pouvez définir les lignes et les colonnes qui constitueront la structure du formulaire. Chaque ligne représente un champ de formulaire individuel et les en-têtes de colonne définissent les propriétés du champ correspondantes.
Prenons l’exemple de la feuille de calcul suivante, dans laquelle les lignes correspondent aux champs d’un formulaire enquiry
et les en-têtes de colonne définissent leurs propriétés :
Pour poursuivre la création du formulaire :
-
Accédez au dossier de votre projet AEM Edge Delivery sur Microsoft SharePoint ou Google Drive.
-
Créez un classeur Microsoft Excel ou une feuille Google Sheets n’importe où dans le répertoire de votre projet AEM Edge Delivery. Par exemple, créez une feuille de calcul nommée
enquiry
dans le répertoire du projet AEM Edge Delivery sur Google Drive. -
Assurez-vous que la feuille est partagée avec la personne appropriée utilisant AEM (par exemple,
helix@adobe.com
) conformément aux configurations spécifiées pour votre projet. Octroyez à l’utilisateur ou l’utilisatrice l’autorisation de modification de la feuille. -
Ouvrez la feuille de calcul créée et renommez la feuille par défaut en « shared-default ».
-
Pour ajouter les champs du formulaire, insérez les lignes et les en-têtes de colonne dans la feuille « shared-default ». Chaque ligne doit représenter un champ de formulaire, avec des en-têtes de colonne définissant les propriétés du champ correspondantes.
Pour un démarrage rapide, pensez à copier le contenu de la feuille de calcul de demande dans votre feuille de calcul. Après avoir copié le contenu, enregistrez votre feuille de calcul.
embed -
Utilisez AEM Sidekick pour prévisualiser la feuille.
Lors de la prévisualisation, de nouveaux onglets de navigateur affichent le contenu de la feuille au format JSON. Veillez à noter l’URL d’aperçu, car elle sera nécessaire pour le rendu du formulaire dans la section suivante. Le format de l’URL se présente comme suit :
code language-json https://<branch>--<repository>--<owner>.hlx.live/<form-path>/<form-file-name>.json
<branch>
fait référence à la branche de votre référentiel GitHub.<repository>
indique votre référentiel GitHub.<owner>
fait référence au nom d’utilisateur ou d’utilisatrice de votre compte GitHub qui héberge votre référentiel GitHub.
Par exemple, si le référentiel de votre projet est nommé « portal », qu’il se trouve dans le compte « wkndforms » et que vous utilisez la branche « main », l’URL ressemble à ceci :
https://main--portal--wkndforms.hlx.page/enquiry.json
À ce stade, vous avez préparé la structure du formulaire. Maintenant, pour prévisualiser le formulaire :
-
Ouvrez votre compte Microsoft SharePoint ou votre compte Google Drive et accédez au répertoire de votre projet AEM Edge Delivery.
-
Ouvrez un fichier document (fichier d’index, par exemple) pour incorporer le formulaire. Vous pouvez également créer un document.
-
Accédez à l’emplacement souhaité dans le document où vous avez l’intention d’ajouter le formulaire.
-
Pour créer un bloc de formulaire afin d’afficher le formulaire. Sélectionnez Insérer > Tableau, puis créez un tableau à une colonne et deux lignes. Nommez le tableau « Form » (formulaire) et collez l’URL d’aperçu dans la deuxième ligne. Assurez-vous que l’URL se présente sous la forme d’un lien hypertexte et non de texte brut, comme illustré ci-dessous :
table 0-row-1 1-row-1 Formulaire https://main–wefinance–wkndforms.hlx.live/enquiry.json Ce bloc sert d’espace réservé à l’emplacement où le formulaire est incorporé. Dans la deuxième ligne du bloc, ajoutez l’URL d’aperçu de votre fichier
<form>.json
sous la forme d’un lien hypertexte.note important IMPORTANT Assurez-vous que l’URL est formatée en tant que lien hypertexte et non sous forme de texte brut. -
Utilisez AEM Sidekick pour prévisualiser le document. La page affiche désormais le formulaire. Par exemple, voici le formulaire basé sur la feuille de calcul de demande :
Remplissez maintenant le formulaire et cliquez sur le bouton d’envoi. Une erreur semblable à celle ci-dessous s’affiche, car la feuille de calcul n’est pas encore configurée pour accepter les données.
Étape suivante
Préparez votre feuille de calcul pour commencer à accepter les données lors de l’envoi du formulaire.
Voir également
- Commencer avec Edge Delivery Services pour AEM Forms
- Créer un formulaire à l’aide de Google Sheets ou de Microsoft Excel
- Configurer vos fichiers Google Sheets ou Microsoft Excel pour accepter des données
- Publier votre formulaire et commencer à collecter des données
- Personnaliser l’apparence de vos formulaires
- Ajouter des sections répétables à un formulaire
- Afficher un message de remerciement personnalisé après l’envoi du formulaire
- Composants de bloc de formulaire adaptatif et leurs propriétés