Service de soumission Forms pour Edge Delivery Services

Parfait pour :

• Créateurs de contenu création de formulaires de collecte de données simples
• Petites entreprises ayant besoin de workflows de la forme à la feuille de calcul rapides
• Équipes marketing collecte des informations sur les prospects
• Organisateurs d'événements gestion des inscriptions

Envisagez des alternatives pour :

• Workflows complexes nécessitant une logique personnalisée
• Intégrations d’entreprise avec des bases de données
• Forms nécessitant une validation ou un traitement avancés

• Aucune infrastructure principale requise - Adobe héberge le point d’entrée d’envoi
• Intégration directe avec les tableurs populaires
• Mappage automatique des données des champs de formulaire aux colonnes des feuilles de calcul

• Capture instantanée des données - les envois apparaissent immédiatement dans votre feuille de calcul
• Stockage structuré - colonnes organisées pour une analyse facile
• Collaboration en direct - plusieurs membres de l’équipe peuvent accéder aux données et les analyser

• Tire parti des autorisations existantes - Utilisez les commandes de partage de votre plateforme de feuilles de calcul.
• sécurité gérée par Adobe - point d’entrée d’envoi sécurisé avec protection de niveau entreprise
• Propriété des données - vos données restent dans la plateforme de feuille de calcul choisie

• Référentiel GitHub configurez pour votre projet Edge Delivery Services avec le dernier bloc de Forms adaptatif installé
• Validation des accès - Référentiel ajouté à la place sur la liste autorisée

Choisissez l’une des plateformes prises en charge :

• Google Sheets - Compte Google avec autorisations de création de feuilles
• Microsoft OneDrive - Compte Microsoft 365 avec accès à Excel Online
• SharePoint - Accès à SharePoint avec autorisations de liste/bibliothèque

• Modifier les autorisations pour la feuille de calcul cible
• Fonctionnalités de partage pour accorder l’accès à forms@adobe.com
• génération de liens autorisations pour la plateforme de votre choix

Avant de configurer l’une des méthodes, vérifiez que votre base de projet AEM est prête :

1. Créez ou mettez à jour votre projet AEM avec le dernier bloc de Forms adaptatif (tutoriel de prise en main)

2. Mettez à jour lefstab.yaml dans la racine de votre projet :

   code language-yaml
   # Replace with the path to your shared folder mountpoints: /: https://drive.google.com/drive/folders/your-shared-folder-id

3. Partagez le dossier du projet avec forms@adobe.com (les autorisations de modification sont requises)

Créez votre structure de formulaire à l’aide de Google Sheets ou de Microsoft Excel.

Étapes de création du formulaire :

1. Ouvrez votre plateforme de feuilles de calcul (Google Sheets ou Microsoft Excel)
2. Créer une nouvelle feuille de calcul pour votre projet de formulaire
3. Nommez votre feuille (doit être helix-default ou shared-aem).
4. Définissez votre structure de formulaire à l’aide du guide de création de formulaire

Exemple : définition de formulaire avec des types de champs, des libellés et des règles de validation

Point de contrôle de validation :

• La structure du formulaire est complète avec tous les champs obligatoires.
• La feuille est correctement nommée (helix-default ou shared-aem)
• Les types de champs et les règles de validation sont correctement configurés

Configurez une feuille dédiée pour recevoir les données d’envoi de formulaire.

Configuration de la feuille de données :

1. Ajouter une nouvelle feuille à votre feuille de calcul existante
2. Nommez la feuille exactementincoming (sensible à la casse).
3. Configurer des en-têtes de colonne qui correspondent à vos champs de formulaire.
4. Enregistrez la feuille de calcul pour vous assurer que les modifications sont conservées

Exemple : feuille entrante avec en-têtes de colonne correspondant aux champs du formulaire

Point de contrôle de validation :

• incoming feuille de calcul existe dans votre feuille de calcul
• Les en-têtes des colonnes correspondent aux noms des champs du formulaire
• La feuille est correctement enregistrée et accessible

Accordez au service d’envoi Adobe Forms l’accès à votre feuille de calcul.

Processus de partage :

1. Cliquez sur le bouton Partager dans le coin supérieur droit de votre feuille de calcul

2. Ajoutez le compte de service Adobe :

   • E-mail : forms@adobe.com
   • Niveau d'autorisation : Éditeur (nécessaire pour l'écriture de données)

3. Envoyer l'invitation de partage

4. Copiez le lien de la feuille de calcul pour l’étape suivante

   
   Processus de partage détaillé pour accorder l’accès au service Adobe

Instructions spécifiques à Platform :

Feuilles Google:

• Ajout de forms@adobe.com en tant qu’éditeur
• Assurez-vous que « Toute personne disposant du lien peut afficher » est activé
• Copier le lien partageable

Microsoft Excel (OneDrive/SharePoint) :

• Ajouter des forms@adobe.com avec des autorisations de modification

• Définir le partage de liens sur « Toute personne disposant du lien peut le modifier »

• Copier l’URL de partage

  
  Exemple : copie du lien partageable pour la configuration du formulaire

Point de contrôle de validation :

• forms@adobe.com a accès à votre feuille de calcul en tant qu'éditeur
• Le lien de la feuille de calcul est copié et prêt à être utilisé.
• Les autorisations de partage autorisent l’accès externe.

Liez votre définition de formulaire à la feuille de calcul d’envoi.

Connexion Formulaire-Feuille De Calcul:

1. Ouvrez votre feuille de calcul de définition de formulaire (celle qui contient helix-default ou shared-aem feuille)

2. Recherchez la ligne Envoyer le champ dans votre définition de formulaire

3. Collez le lien de la feuille de calcul copiée dans la colonne Action du champ Envoyer

4. Enregistrez les modifications dans votre définition de formulaire

   

Exemple : connexion de l’action Envoyer à votre feuille de calcul de collecte de données

Publication De Votre Formulaire :

1. Ouvrez AEM Sidekick dans votre navigateur.
2. Prévisualisez votre formulaire pour tester la configuration.
3. Publier le formulaire pour le rendre actif

Validation finale :

• Le lien de la feuille de calcul est correctement ajouté à l’action de champ Envoyer
• La définition du formulaire est enregistrée et publiée
• L’aperçu du formulaire affiche correctement tous les champs
• Le bouton Envoyer est correctement configuré

Documents de référence :

• Exemple complet de feuille de calcul avec une configuration appropriée
• Documentation AEM Sidekick pour obtenir des conseils sur la publication

Parfait pour :

• Systèmes automatisés de collecte de données
• Implémentations de formulaires personnalisés
• Intégration avec les applications existantes
• Workflows d’envoi de données en bloc

Avant d’utiliser l’API , vérifiez que vous disposez des éléments suivants :

• paramétrage de la feuille de calcul terminé (y compris la feuille de incoming)
• Accès au service Adobe accordé à forms@adobe.com
• ID du formulaire à partir du formulaire publié
• Informations sur le référentiel (nom de l’organisation et du site)

URL de base : https://forms.adobe.com/adobe/forms/af/submit/{id}

En-têtes requis :

• Content-Type: application/json
• x-adobe-routing: tier=live,bucket=main--[repository]--[organization]

Documentation de l’API : Référence complète de l’API

Postman fournit une interface conviviale pour tester les envois d’API.

Instructions de configuration :

1. Créer une requête POST dans Postman

2. Configurer le point d’entrée : https://forms.adobe.com/adobe/forms/af/submit/{id}

3. Remplacer les espaces réservés :

   • {id} → votre ID de formulaire réel
   • [repository] → Nom de votre référentiel GitHub
   • [organization] → votre organisation/nom d’utilisateur GitHub

Configuration de la demande:

POST https://forms.adobe.com/adobe/forms/af/submit/your-form-id

Headers:
Content-Type: application/json
x-adobe-routing: tier=live,bucket=main--your-repo--your-org

Body (JSON):
{
        "data": {
            "startDate": "2025-01-10",
            "endDate": "2025-01-25",
            "destination": "Australia",
            "class": "First Class",
            "budget": "2000",
            "amount": "1000000",
            "name": "Mary",
            "age": "35",
            "subscribe": null,
            "email": "mary@gmail.com"
                }
}

Réponse attendue :

• Code d’état : 201 Created
• Les données apparaissent immédiatement dans votre feuille de calcul incoming

Exemple : envoi réussi de l’API à l’aide de l’interface Postman

Pour les développeurs qui préfèrent une invite de terminal/commande, utilisez curl pour envoyer des données par programmation.

Configuration de la ligne de commande :

Remplacez les espaces réservés suivants dans les commandes ci-dessous :

• {id} → votre ID de formulaire réel
• [repository] → Nom de votre référentiel GitHub
• [organization] → votre organisation/nom d’utilisateur GitHub

curl -X POST "https://forms.adobe.com/adobe/forms/af/submit/your-form-id" \
    --header "Content-Type: application/json" \
  --header "x-adobe-routing: tier=live,bucket=main--your-repo--your-org" \
    --data '{
        "data": {
            "startDate": "2025-01-10",
            "endDate": "2025-01-25",
            "destination": "Australia",
            "class": "First Class",
            "budget": "2000",
            "amount": "1000000",
            "name": "Joe",
            "age": "35",
            "subscribe": null,
      "email": "joe@example.com"
                }
            }'

curl -X POST "https://forms.adobe.com/adobe/forms/af/submit/your-form-id" ^
    --header "Content-Type: application/json" ^
  --header "x-adobe-routing: tier=live,bucket=main--your-repo--your-org" ^
  --data "{\"data\": {\"startDate\": \"2025-01-10\", \"endDate\": \"2025-01-25\", \"destination\": \"Australia\", \"class\": \"First Class\", \"budget\": \"2000\", \"amount\": \"1000000\", \"name\": \"Joe\", \"age\": \"35\", \"subscribe\": null, \"email\": \"joe@example.com\"}}"

$body = @{
  data = @{
    startDate = "2025-01-10"
    endDate = "2025-01-25"
    destination = "Australia"
    class = "First Class"
    budget = "2000"
    amount = "1000000"
    name = "Joe"
    age = "35"
    subscribe = $null
    email = "joe@example.com"
  }
} | ConvertTo-Json -Depth 3

Invoke-RestMethod -Uri "https://forms.adobe.com/adobe/forms/af/submit/your-form-id" `
  -Method POST `
  -Headers @{"Content-Type"="application/json"; "x-adobe-routing"="tier=live,bucket=main--your-repo--your-org"} `
  -Body $body

Réponse réussie :

HTTP/1.1 201 Created
Connection: keep-alive
Content-Length: 0
X-Request-Id: 02a53839-2340-56a5-b238-67c23ec28f9f
X-Message-Id: 42ecb4dd-b63a-4674-8f1a-05a4a5b0372c
Date: Fri, 10 Jan 2025 13:06:10 GMT
Access-Control-Allow-Origin: *

Vérification des données:

Une fois l’envoi réussi, vérifiez que les données apparaissent dans votre feuille de calcul :

Exemple : données écrites dans la feuille entrante via l’API

Validation de la réponse :

• Statut HTTP : 201 Created indique un envoi réussi
• X-Request-Id : identifiant unique pour le suivi de l’envoi
• Les données apparaissent dans votre feuille de incoming en quelques secondes
• Tous les champs de formulaire sont correctement mappés aux colonnes de la feuille de calcul

Problème : Erreur Interdite 403

Causes: Missing or incorrect access permissions
Solutions:
- Verify forms@adobe.com has Editor access to your spreadsheet
- Check that your repository is added to the allowlist
- Confirm the x-adobe-routing header format

Problème : Erreur 404 Introuvable

Causes: Incorrect Form ID or endpoint URL
Solutions:
- Verify your Form ID is correct
- Check the API endpoint URL format
- Ensure your form is published and live

Problème : les données n’apparaissent pas dans la feuille de calcul

Causes: Missing 'incoming' sheet or permission issues
Solutions:
- Confirm 'incoming' sheet exists (case-sensitive)
- Verify column headers match form field names exactly
- Check forms@adobe.com has edit permissions
- Ensure spreadsheet is shared properly

Problème : Erreur de format JSON non valide

Causes: Malformed request body
Solutions:
- Validate JSON syntax using online JSON validators
- Ensure proper escaping of special characters
- Check quote marks and brackets are balanced

Canaux d’assistance :

• Problèmes d’accès anticipé : e-mail aem-forms-ea@adobe.com
• Documentation de l’API : Référence du développeur
• Assistance communautaire : Communauté Adobe Experience League

• Créer un Forms avancé - Ajouter la validation, la logique conditionnelle et le style personnalisé
• Guide des composants de formulaire - Explorer les types de champ de formulaire disponibles

• Envois de publications AEM - Pour les workflows complexes et les intégrations d’entreprise
• Actions Envoyer personnalisées - Gestion avancée des envois

• Form Analytics - Suivre les performances et l’utilisation des formulaires
• Intégration de données - Connectez les formulaires aux bases de données et aux systèmes CRM