Servizio di invio Forms per Edge Delivery Services

Ideale per:

• Creatori di contenuti creazione di semplici moduli di raccolta dati
• Piccole aziende che richiedono flussi di lavoro rapidi da modulo a foglio di calcolo
• Team di marketing che raccolgono informazioni sui lead
• Organizzatori di eventi che gestiscono le registrazioni

Valuta alternative per:

• Flussi di lavoro complessi che richiedono una logica personalizzata
• Integrazioni aziendali con i database
• Forms che necessita di convalida o elaborazione avanzata

• Non è richiesta alcuna infrastruttura di back-end - Adobe ospita l'endpoint di invio
• Integrazione diretta con piattaforme di fogli di calcolo più diffuse
• Mappatura automatica dei dati dai campi modulo alle colonne del foglio di calcolo

• Acquisizione immediata dei dati - gli invii vengono visualizzati immediatamente nel foglio di calcolo
• Archiviazione strutturata: colonne organizzate per analisi semplificate
• Collaborazione in tempo reale - più membri del team possono accedere e analizzare i dati

• Sfrutta le autorizzazioni esistenti - utilizza i controlli di condivisione della piattaforma del foglio di calcolo
• Sicurezza gestita da Adobe - endpoint di invio sicuro con protezione di livello enterprise
• Proprietà dei dati: i dati rimangono nella piattaforma del foglio di calcolo scelta

• Archivio GitHub configurato per il progetto Edge Delivery Services con il blocco Forms adattivo più recente installato
• Approvazione dell'accesso - repository aggiunto al inserisco nell'elenco Consentiti di

Scegli una delle piattaforme supportate:

• Fogli Google - Account Google con autorizzazioni per la creazione di fogli
• Microsoft OneDrive - Account Microsoft 365 con accesso a Excel Online
• SharePoint - Accesso a SharePoint con autorizzazioni elenco/raccolta

• Modifica autorizzazioni per il foglio di calcolo di destinazione
• Funzionalità di condivisione per concedere l'accesso a forms@adobe.com
• Autorizzazioni generazione collegamenti per la piattaforma scelta

Prima di configurare uno di questi metodi, assicurati che le basi del progetto AEM siano pronte:

1. Crea o aggiorna il progetto AEM con il blocco Forms adattivo più recente (Esercitazione introduttiva)

2. Aggiornafstab.yaml nella directory principale del progetto:

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

3. Condividi la cartella del progetto con forms@adobe.com (sono necessarie le autorizzazioni di modifica)

Creare la struttura del modulo utilizzando Google Sheets o Microsoft Excel.

Passaggi per la creazione del modulo:

1. Apri la piattaforma del foglio di calcolo (fogli di Google o Microsoft Excel)
2. Crea un nuovo foglio di calcolo per il progetto modulo
3. Denomina il foglio (deve essere helix-default o shared-aem)
4. Definisci la struttura del modulo utilizzando la guida alla creazione del modulo

Esempio: definizione modulo con tipi di campo, etichette e regole di convalida

Checkpoint di convalida:

• Struttura del modulo completata con tutti i campi obbligatori
• Il foglio è denominato correttamente (helix-default o shared-aem)
• I tipi di campo e le regole di convalida sono configurati correttamente

Imposta un foglio dedicato per ricevere i dati di invio del modulo.

Impostazione foglio dati:

1. Aggiungi un nuovo foglio al foglio di calcolo esistente
2. Denomina il foglio esattamenteincoming (distinzione maiuscole/minuscole)
3. Configura intestazioni di colonna corrispondenti ai campi modulo
4. Salvare il foglio di calcolo per assicurarsi che le modifiche vengano mantenute

Esempio: foglio in ingresso con intestazioni di colonna corrispondenti ai campi modulo

Checkpoint di convalida:

• Il foglio incoming esiste nel tuo foglio di calcolo
• Le intestazioni di colonna corrispondono ai nomi dei campi modulo
• Il foglio è salvato correttamente e accessibile

Concedi al servizio Adobe Forms Submission l’accesso al tuo foglio di calcolo.

Processo di condivisione:

1. Fai clic sul pulsante Condividi nell'angolo superiore destro del foglio di calcolo

2. Aggiungere l'account del servizio Adobe:

   • E-mail: forms@adobe.com
   • Livello di autorizzazione: Editor (obbligatorio per la scrittura dei dati)

3. Invia l'invito alla condivisione

4. Copia il collegamento del foglio di calcolo per il passaggio successivo

   
   Processo di condivisione passo per passo per concedere l'accesso al servizio Adobe

Istruzioni Specifiche Per La Piattaforma:

Fogli Google:

• Aggiungi forms@adobe.com come editor
• Verificare che sia abilitato "Chiunque disponga del collegamento può visualizzare"
• Copia il collegamento condivisibile

Microsoft Excel (OneDrive/SharePoint):

• Aggiungi forms@adobe.com con autorizzazioni di modifica

• Imposta la condivisione del collegamento su "Chiunque abbia il collegamento può modificare"

• Copia l’URL di condivisione

  
  Esempio: copia del collegamento condivisibile per la configurazione del modulo

Checkpoint di convalida:

• forms@adobe.com ha accesso editor al tuo foglio di calcolo
• Il collegamento al foglio di calcolo viene copiato e pronto per l'uso
• Le autorizzazioni di condivisione consentono l'accesso esterno

Collegare la definizione del modulo al foglio di calcolo di invio.

Connessione Foglio Di Calcolo Modulo:

1. Apri il foglio di calcolo di definizione modulo (quello con helix-default o shared-aem foglio)

2. Individua la riga del campo Invia nella definizione del modulo

3. Incolla il collegamento del foglio di calcolo copiato nella colonna Azione per il campo Invia

4. Salva le modifiche nella definizione del modulo

   

Esempio: connessione dell'azione di invio al foglio di calcolo della raccolta dati

Pubblicazione del modulo:

1. Apri AEM Sidekick nel browser
2. Visualizza l'anteprima del modulo per verificare la configurazione
3. Pubblica il modulo per renderlo attivo

Convalida finale:

• Il collegamento al foglio di calcolo viene aggiunto correttamente all’azione Invia campo
• La definizione del modulo viene salvata e pubblicata
• L’anteprima del modulo mostra correttamente tutti i campi
• Il pulsante Invia è configurato correttamente

Materiale di riferimento:

• Completare il foglio di calcolo di esempio con la configurazione corretta
• Documentazione di AEM Sidekick per istruzioni sulla pubblicazione

Ideale per:

• Sistemi automatizzati di raccolta dati
• Implementazioni di moduli personalizzati
• Integrazione con le applicazioni esistenti
• Flussi di lavoro per l’invio di dati in blocco

Prima di utilizzare l’API, assicurati di disporre di:

• Configurazione foglio di calcolo completata (inclusi incoming fogli)
• Accesso al servizio Adobe concesso a forms@adobe.com
• ID modulo dal modulo pubblicato
• Informazioni archivio (nome organizzazione e sito)

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

Intestazioni richieste:

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

Documentazione API: Riferimento API completo

Postman fornisce un’interfaccia intuitiva per testare gli invii API.

Istruzioni di installazione:

1. Crea una nuova richiesta POST in Postman

2. Configura l'endpoint: https://forms.adobe.com/adobe/forms/af/submit/{id}

3. Sostituisci segnaposto:

   • {id} → l'ID modulo effettivo
   • [repository] → nome archivio GitHub
   • [organization] → nome utente/organizzazione GitHub

Configurazione richiesta:

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"
                }
}

Risposta prevista:

• Codice stato: 201 Created
• I dati vengono visualizzati nel foglio di calcolo incoming immediatamente

Esempio: invio API riuscito tramite interfaccia Postman

Per gli sviluppatori che preferiscono terminale/prompt dei comandi, utilizza curl per inviare i dati a livello di programmazione.

Installazione riga di comando:

Sostituisci i segnaposto seguenti nei comandi seguenti:

• {id} → l'ID modulo effettivo
• [repository] → nome archivio GitHub
• [organization] → nome utente/organizzazione 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

Risposta corretta:

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: *

Verifica dati:

Dopo un invio corretto, verifica che i dati vengano visualizzati nel foglio di calcolo:

Esempio: dati scritti correttamente nel foglio in ingresso tramite API

Convalida risposta:

• Stato HTTP: 201 Created indica invio completato
• X-Request-Id: Identificatore univoco per il tracciamento dell'invio
• Dati visualizzati nel foglio incoming in pochi secondi
• Tutti i campi modulo sono mappati correttamente alle colonne del foglio di calcolo

Problema: Errore 403 Non Consentito

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

Problema: Errore 404 Non Trovato

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

Problema: dati non visualizzati nel foglio di calcolo

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

Problema: errore formato JSON non valido

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

Canali di supporto:

• Problemi di accesso anticipato: E-mail aem-forms-ea@adobe.com
• Documentazione API: Riferimento sviluppatore
• Supporto community: Community Adobe Experience League

• Crea Forms avanzato - Aggiungi convalida, logica condizionale e stile personalizzato
• Guida ai componenti del modulo - Esplora i tipi di campo modulo disponibili

• Invii di pubblicazione AEM - Per flussi di lavoro complessi e integrazioni aziendali
• Azioni di invio personalizzate - Gestione avanzata dell'invio

• Analisi modulo - Monitora prestazioni e utilizzo modulo
• Integrazione dei dati - Connessione dei moduli a database e sistemi di gestione delle relazioni con i clienti