Configurer vos feuilles de calcul Google Sheets ou fichiers Microsoft Excel pour commencer à accepter des données

Ouvrez la feuille de calcul qui comporte votre formulaire et ajoutez-y une nouvelle feuille en la renommant incoming.

Dans cette feuille, insérez un tableau nommé « intake_form ». Sélectionnez le nombre de colonnes requis pour correspondre aux noms des champs de votre formulaire. Ensuite, dans la barre d’outils, accédez à Insérer > Tableau et cliquez sur OK.

Remplacez le nom du tableau par « intake_form ». Dans Microsoft Excel, pour modifier le nom du tableau, sélectionnez-le, puis cliquez sur Conception du tableau.

Ajoutez ensuite les noms des champs de formulaire en tant qu’en-têtes de tableau. Pour vous assurer que les champs sont exactement les mêmes, vous pouvez les copier et les coller à partir de la feuille « shared-default ». Dans votre feuille « shared-default », sélectionnez et copiez les identifiants de formulaires répertoriés sous la colonne « Name », à l’exception du champ d’envoi.

Dans la feuille « incoming », sélectionnez Collage spécial > Transposer les lignes en colonnes pour copier les identifiants de champ sous forme d’en-têtes de colonne dans cette nouvelle feuille. Ne conservez que les champs dont les données doivent être capturées, les autres peuvent être ignorés.

Chaque valeur dans la colonne Name de la feuille shared-default, à l’exception du bouton d’envoi, peut servir d’en-tête dans la feuille incoming. Prenons l’exemple de l’image suivante illustrant les en-têtes d’un formulaire « contact-us » :

Utilisez l’extension AEM Sidekick pour prévisualiser les mises à jour du formulaire. Votre feuille est maintenant prête à accepter les envois de formulaire entrants.

Ouvrez le classeur que vous avez créé et remplacez le nom de la feuille par défaut par incoming.

Prévisualisez la feuille dans le sidekick.

Envoyez la requête POST pour générer les en-têtes appropriés dans la feuille incoming, puis ajoutez la feuille shared-default à votre feuille de calcul, si elle n’existe pas déjà.

Pour comprendre comment mettre en forme la requête POST afin de configurer votre feuille, reportez-vous à la Documentation de l’API d’administration. Vous pouvez consulter l’exemple ci-dessous :

Requête

POST 'https://admin.hlx.page/form/{owner}/{repo}/{branch}/contact-us.json' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "Email": "john@wknd.com",
        "Name": "John",
        "Subject": "Regarding Product Inquiry",
        "Message": "I have some questions about your products.",
        "Phone": "123-456-7890",
        "Company": "Adobe Inc.",
        "Country": "United States",
        "PreferredContactMethod": "Email",
        "SubscribeToNewsletter": true
    }
}'

Réponse

HTTP/2 200
content-type: application/json
x-invocation-id: 1b3bd30a-8cfb-4f85-a662-4b1f7cf367c5
cache-control: no-store, private, must-revalidate
accept-ranges: bytes
date: Sat, 10 Feb 2024 09:26:48 GMT
via: 1.1 varnish
x-served-by: cache-del21736-DEL
x-cache: MISS
x-cache-hits: 0
x-timer: S1707557205.094883,VS0,VE3799
strict-transport-security: max-age=31557600
content-length: 138

{"rowCount":2,"columns":["Email","Name","Subject","Message","Phone","Company","Country",      "PreferredContactMethod","SubscribeToNewsletter"]}%

Vous pouvez utiliser des outils tels que curl ou Postman pour exécuter cette requête POST, comme illustré ci-dessous :

curl -s -i -X POST 'https://admin.hlx.page/form/wkndforms/portal/main/contact-us.json' \
    --header 'Content-Type: application/json' \
    --data '{
        "data": {
            "Email": "john@wknd.com",
            "Name": "John",
            "Subject": "Regarding Product Inquiry",
            "Message": "I have some questions about your products.",
            "Phone": "123-456-7890",
            "Company": "Wknd Inc.",
            "Country": "United States",
            "PreferredContactMethod": "Email",
            "SubscribeToNewsletter": true
    }
}'

La requête POST mentionnée ci-dessus fournit des données d’exemple, y compris les champs de formulaire et leurs valeurs d’exemple respectives. Ces données sont utilisées par le service d’administration pour configurer le formulaire.

Votre formulaire peut maintenant accepter des données. Vous constatez également les modifications suivantes dans votre feuille de calcul :

Pour configurer les notifications Slack, saisissez l’« identifiant de l’équipe » de l’espace de travail Slack et le « nom du canal » ou l’« identifiant ». Vous pouvez également demander au Slackbot (avec la commande debug) l’« identifiant d’équipe » et l’« identifiant du canal ». Il est préférable d’utiliser l’« identifiant du canal » plutôt que le « nom du canal », car il n’est pas modifié lorsque le canal est renommé.

Saisissez le titre de votre choix et sous les champs, saisissez le nom des champs que vous souhaitez voir dans la notification Slack. Chaque en-tête doit être séparé par une virgule (par exemple, nom, adresse e-mail).