Forms-verzendservice voor Edge Delivery Services

De Forms-verzendservice is een door Adobe gehoste oplossing waarmee formulierverzendgegevens automatisch rechtstreeks in uw voorkeurspreadsheets worden opgeslagen: Google Sheets, Microsoft OneDrive of SharePoint. Dit elimineert de behoefte aan complexe backend infrastructuur terwijl het verstrekken van gegevens in real time en beheer.

Overzicht

de voorleggingsdienst van Forms
Figuur: Het werkschema van de Dienst van de Verzending van Forms - van vormvoorlegging aan spreadsheetopslag

Wie moet deze service gebruiken?

Perfect voor:

  • creators van de Inhoud bouwend eenvoudige vormen van de gegevensinzameling
  • Kleine ondernemingen die snelle vorm-aan-spreadsheetwerkschema's nodig hebben
  • de teams van de Marketing verzamelen loodinformatie
  • de organisatoren van de Gebeurtenis die registraties beheren

overweeg alternatieven voor:

  • Complexe workflows die aangepaste logica vereisen
  • Integratie van bedrijven met databases
  • Forms heeft geavanceerde validatie of verwerking nodig
Vaak voorkomende gevallen
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
Hoofdletters gebruiken Voorbeeld Voordelen voor werkblad
Contact Forms Website vragen → Google Sheets Eenvoudige follow-up en CRM-import
Registratie van de Gebeurtenis Conferentiehandtekeningen → Excel Online Real-time bijhouden van deelnemers
Loodgeneratie Nieuwsbrieven → SharePoint Analyse van de marketingcampagne
de Inzameling van de Terugkoppeling Antwoorden van de enquête → Google-bladen Snelle gegevensvisualisatie

Belangrijkste voordelen

De Forms-verzendservice biedt verschillende voordelen voor gestroomlijnde gegevensverzameling:

Vereenvoudigde installatie
  • Geen backend infrastructuur wordt vereist - de gastheren van Adobe het voorleggingseindpunt
  • Directe integratie met populaire spreadsheetplatforms
  • Automatische gegevenstoewijzing van vormgebieden aan spreadsheetkolommen
Real-Time gegevensbeheer
  • Onmiddellijke gegevens vangen - de bijdragen verschijnen onmiddellijk in uw spreadsheet
  • Gestructureerde opslag - georganiseerde kolommen voor gemakkelijke analyse
  • Levende samenwerking - de veelvoudige teamleden kunnen tot gegevens toegang hebben en analyseren
Ingebouwde beveiliging en toegangsbeheer
  • Hefboomwerkingen bestaande toestemmingen - gebruik de het delen van uw spreadsheetplatform controles
  • Adobe-Beheerde veiligheid - veilig voorlegging eindpunt met onderneming-rang bescherming
  • Eigendom van Gegevens - uw gegevensverblijven in uw gekozen spreadsheetplatform

Vereisten

Voordat u de Forms-verzendservice instelt, moet u controleren of:

Technische vereisten
  • GitHub bewaarplaats opstelling voor uw project van Edge Delivery Services met het recentste Aangepast geïnstalleerd Blok van Forms
  • goedkeuring van de Toegang - bewaarplaats die aan de lijst van gewenste personen wordt toegevoegd
Platforminstelling werkblad

Kies een van de ondersteunde platforms:

  • Google Sheets - de rekening van Google met de toestemmingen van de bladverwezenlijking
  • Microsoft OneDrive - Microsoft 365 rekening met de Online toegang van Excel
  • SharePoint - de toegang van SharePoint met lijst/bibliotheektoestemmingen
Machtigingen en toegang
  • geeft toestemmingen voor het doelspreadsheet uit
  • delend mogelijkheden om toegang tot forms@adobe.com te verlenen
  • toestemmingen van de generatie van de verbinding 0} {voor uw gekozen platform
TIP
Nieuw aan Edge Delivery Services? Begin met het Begonnen Leerprogrammaaan opstelling uw projectstichting.

Configuratiemethoden

De Forms-verzendservice biedt twee configuratiemethoden. Kies de methode die het beste bij uw workflow past:

Uw configuratiemethode kiezen
table 0-row-4 1-row-4 2-row-4
Methode Best voor Vereiste tijd Technisch niveau
Handmatige Opstelling Inhoudsmakers, eenmalige installatie 10-15 minuten Beginnen
API Configuratie Ontwikkelaars, geautomatiseerde workflows 5-10 minuten Intermediair
Projectinstelling

Voordat u een van beide methoden configureert, moet u ervoor zorgen dat uw AEM-projectstichting gereed is:

  1. creeer of werk uw project van AEM met het recentste Adaptieve Blok van Forms bij ( Begonnen het Leerprogramma)

  2. Updatefstab.yaml in uw projectwortel:

    code language-yaml
    # Replace with the path to your shared folder
    mountpoints:
      /: https://drive.google.com/drive/folders/your-shared-folder-id
    
  3. deel uw projectomslag met forms@adobe.com (geef vereiste toestemmingen uit)

Handmatige configuratie

Werkschema voor de dienst van de vormenvoorlegging
Cijfer: Volledig werkschema voor de handmatige opstelling van de Dienst van de Verzending van Forms

Voer de volgende stapsgewijze instructies uit om het formulier in te stellen met verzending van werkbladen:

Stap 1: Uw formulierdefinitie maken

Maak uw formulierstructuur met Google Sheets of Microsoft Excel.

Stappen van de Making van de Vorm:

  1. open uw spreadsheetplatform (Google Bladen of Microsoft Excel)
  2. creeer een nieuw spreadsheet voor uw vormproject
  3. Naam uw blad (moet of helix-default of shared-aem zijn)
  4. bepaalt uw vormstructuur gebruikend de gids van de vormverwezenlijking

de Definitie van de Vorm
Voorbeeld: De definitie van de vorm met gebiedstypes, etiketten, en bevestigingsregels

note important
IMPORTANT
het Noemen van het Blad Vereisten
Het definitieblad van het formulier moet een naam hebben:
  • helix-default (aanbevolen voor enkele formulieren)
  • shared-aem (voor meervoudige projecten)
Andere bladnamen worden niet door het systeem herkend.

Controlepunt van de Bevestiging:

  • De formulierstructuur is voltooid met alle vereiste velden
  • Werkblad krijgt de juiste naam (helix-default of shared-aem)
  • Veldtypen en validatieregels zijn op de juiste wijze geconfigureerd
Stap 2: Maak het werkblad voor gegevensverzameling

Stel een speciaal blad in voor het ontvangen van formulierverzendgegevens.

Opstelling van het Blad van Gegevens:

  1. voeg een nieuw blad aan uw bestaand spreadsheet toe
  2. noem het blad preciesincoming (case-sensitive)
  3. de kolomkopballen van de opstelling die uw vormgebieden aanpassen
  4. sparen spreadsheet om ervoor te zorgen de veranderingen worden bewaard

Binnenkomend blad
Voorbeeld: Binnenkomend blad met kolomkopballen die vormgebieden aanpassen

note warning
WARNING
Kritieke Vereiste
De naam van het blad moet exact incoming (kleine letters) zijn. Zonder dit blad:
  • Formulieraanvragen worden afgewezen
  • Er worden geen gegevens opgeslagen
  • Gebruikers zien verzendfouten

Controlepunt van de Bevestiging:

  • incoming -werkblad bestaat in het werkblad
  • Kolomkoppen komen overeen met uw formulierveldnamen
  • Werkblad is op de juiste wijze opgeslagen en toegankelijk
note tip
TIP
ProUiteinde: kopieer de nauwkeurige gebiedsnamen van uw vormdefinitie om perfecte aanpassing tussen vormgebieden en spreadsheetkolommen te verzekeren.
Stap 3: Deel spreadsheet met de Dienst van Adobe

Bied de Adobe Forms-verzendservice toegang tot uw spreadsheet.

het Delen Proces:

  1. klik de knoop van het Aandeel in de hoogste juiste hoek van uw spreadsheet

  2. voeg de de dienstrekening van Adobe toe:

    • E-mail: forms@adobe.com
    • Het niveau van de toestemming: Redacteur (die voor gegevens wordt vereist schrijven)
  3. verzend de het delen uitnodiging

  4. exemplaar de spreadsheetverbinding voor de volgende stap

    Aankomend blad van het Aandeel
    geleidelijke het delen proces voor het verlenen van de diensttoegang van Adobe

Platform-Specifieke Instructies:

Google Bladen:

  • forms@adobe.com toevoegen als editor
  • Zorg ervoor dat "Iedereen met de koppeling kan weergeven" is ingeschakeld
  • Kopieer de deelbare koppeling

Microsoft Excel (OneDrive/SharePoint):

  • forms@adobe.com toevoegen met bewerkingsmachtigingen

  • Koppeling delen instellen op "Iedereen met de koppeling kan bewerken"

  • De URL voor delen kopiëren

    verbinding van het Exemplaar van inkomend blad
    Voorbeeld: Het kopiëren van de shareable verbinding voor vormconfiguratie

Controlepunt van de Bevestiging:

  • forms@adobe.com heeft Editor toegang tot uw spreadsheet
  • De werkbladkoppeling is gekopieerd en klaar voor gebruik
  • Met machtigingen voor delen is externe toegang mogelijk
Stap 4: Formulier verbinden met werkblad

Koppel uw formulierdefinitie aan het verzendwerkblad.

vorm-spreadsheet Verbinding:

  1. open uw spreadsheet van de vormdefinitie (met helix-default of shared-aem blad)

  2. plaats van de Submit veldrij in uw vormdefinitie

  3. plak de gekopieerde spreadsheetverbinding in de kolom van de Actie voor het Submit gebied

  4. sparen de veranderingen aan uw vormdefinitie

    Verbinding een spreadsheet

Voorbeeld: Verbindend voorlegt actie aan uw spreadsheet van de gegevensinzameling

het Publiceren van Uw Vorm:

  1. Open AEM Sidekick in uw browser
  2. Voorproef uw vorm om de configuratie te testen
  3. publiceer de vorm om het levend te maken

Definitieve Bevestiging:

  • Werkbladkoppeling wordt correct toegevoegd aan de handeling Veld verzenden
  • Formulierdefinitie wordt opgeslagen en gepubliceerd
  • Alle velden worden correct weergegeven in het voorbeeld
  • Verzendknop is correct geconfigureerd
note success
SUCCESS
Opstelling voltooit! Uw formulier is nu verbonden met de Forms-verzendservice. Test het door voorbeeldgegevens te verzenden en het incoming -blad te controleren.

de Materialen van de Verwijzing:

API-configuratie

Met de API-methode kunnen ontwikkelaars via programmacode gegevens verzenden naar de Forms-verzendservice, ideaal voor geautomatiseerde workflows en aangepaste integraties.

Wanneer gebruikt u de API

Perfect voor:

  • Geautomatiseerde systemen voor gegevensverzameling
  • Aangepaste formulierimplementaties
  • Integratie met bestaande toepassingen
  • Werkstromen voor bulkgegevensverzending
API-vereisten

Controleer voordat u de API gebruikt of:

  • voltooide de opstelling van het Spreadsheet (met inbegrip van incoming blad)
  • de diensttoegang van Adobe verleend aan forms@adobe.com
  • identiteitskaart van de Vorm van uw gepubliceerde vorm
  • informatie van de Bewaarplaats (organisatie en plaatsnaam)
note important
IMPORTANT
Vereiste Stappen van de Opstelling
De API vereist de zelfde spreadsheetopstelling zoals handconfiguratie:
  • incoming sheet moet bestaan
  • forms@adobe.com moet Editor toegang hebben
  • Blad moet via AEM Sidekick worden gepubliceerd
API-eindpunt en verificatie

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

Vereiste Kopballen:

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

API Documentatie: Volledige API Verwijzing

Postman gebruiken

Postman biedt een gebruikersvriendelijke interface voor het testen van API-verzendingen.

Instructies van de Opstelling:

  1. creeer een nieuw POST verzoek in Postman

  2. vorm het eindpunt: https://forms.adobe.com/adobe/forms/af/submit/{id}

  3. vervangt placeholders:

    • {id} → Uw huidige formulier-id
    • [repository] → De naam van uw GitHub-opslagplaats
    • [organization] → Uw GitHub-organisatie/gebruikersnaam

Configuratie van het verzoek:

code language-json
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"
                }
}

Verwachte Reactie:

  • Code van de Status: 201 Created
  • Gegevens verschijnt in uw incoming spreadsheet onmiddellijk

postmanscherm
Voorbeeld: Succesvolle API voorlegging gebruikend de interface van Postman

Opdrachtregel gebruiken (curl)

Voor ontwikkelaars die terminal/bevelherinnering verkiezen, gebruik krulling om gegevens programmatically voor te leggen.

Opstelling van de Lijn van het Bevel:

Vervang de volgende plaatsaanduidingen in de onderstaande opdrachten:

  • {id} → Uw huidige formulier-id
  • [repository] → De naam van uw GitHub-opslagplaats
  • [organization] → Uw GitHub-organisatie/gebruikersnaam
tabs
macOS/Linux
code language-bash
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"
                }
            }'
de Herinnering van het Bevel van Vensters
code language-cmd
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\"}}"
Vensters PowerShell
code language-powershell
$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
API Reactie en verificatie

Succesvolle Reactie:

code language-http
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: *

Verificatie van Gegevens:

Controleer na een geslaagde verzending of de gegevens in uw spreadsheet worden weergegeven:

bijgewerkt blad
Voorbeeld: Gegevens met succes geschreven aan het inkomende blad via API

Bevestiging van de Reactie:

  • Status van HTTP: 201 Created wijst op succesvolle voorlegging
  • x-verzoek-identiteitskaart: Unieke herkenningsteken voor het volgen van de voorlegging
  • Gegevens verschijnt in uw incoming blad binnen seconden
  • Alle vormgebieden worden behoorlijk in kaart gebracht aan spreadsheetkolommen

Problemen oplossen

Algemene problemen en oplossingen

Probleem: 403 Verboden Fout

code language-none
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

Probleem: 404 niet Gevonden Fout

code language-none
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

Probleem: Gegevens verschijnen niet in Spreadsheet

code language-none
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

Probleem: De ongeldige Fout van het Formaat JSON

code language-none
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
Help opvragen

Kanalen van de Steun:

Volgende stappen

Nu u de gevormde Dienst van de Verzending van Forms hebt, onderzoek deze verwante onderwerpen:

Verbeter je Forms
Alternatieve verzendmethoden
Gegevensbeheer

Samenvatting

De Forms-verzendservice biedt een krachtige, niet-codeoplossing voor het rechtstreeks verzamelen van formuliergegevens in spreadsheets. Belangrijkste voordelen zijn:

  • Snelle opstelling - Geen vereiste backendinfrastructuur
  • gegevens in real time - Onmiddellijke voorlegging vangen
  • Flexibele platforms - de Bladen van Google, OneDrive, of SharePoint
  • API toegang - Programmatic voorleggingsmogelijkheden
  • veiligheid van de Onderneming - Adobe-Beheerde eindpunten met toegangscontroles

Klaar om te beginnen? volg de handconfiguratiegids voor een visuele opstelling, of sprong aan API configuratievoor programmatic integratie.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab