Google-bladen of Microsoft Excel-bestanden instellen om gegevens te accepteren

Zodra u hebt gecreeerd en de vormpreviewde, is het tijd om het overeenkomstige spreadsheet toe te laten beginnen gegevens te ontvangen. U kunt de spreadsheet handmatig inschakelen voor het accepteren van gegevens of Admin API's gebruiken om een spreadsheet in te schakelen voor het accepteren van gegevens.

op document-gebaseerde het Authoring ecosysteem

De spreadsheet handmatig inschakelen voor het accepteren van gegevens

De spreadsheet inschakelen om gegevens te accepteren

  1. Open het werkblad met het formulier en voeg een nieuw blad toe, onder een andere naam incoming .

    note warning
    WARNING
    Als het incoming sheet niet aanwezig is, verzendt AEM geen gegevens naar het spreadsheet.
  2. Voeg op dit blad een tabel in met de naam "take_form". Selecteer het aantal kolommen dat nodig is om overeen te komen met de namen van de formuliervelden. Ga vervolgens op de werkbalk naar Invoegen > Tabel en klik op OK.

  3. Wijzig de naam van de tabel in "take_form". Als u in Microsoft Excel de naam van de tabel wilt wijzigen, selecteert u de tabel en klikt u op Tabelontwerp.

  4. Voeg vervolgens de namen van de formuliervelden toe als de tabelkoppen. Om ervoor te zorgen dat de velden exact hetzelfde zijn, kunt u deze kopiëren en plakken vanaf het standaardblad. Selecteer en kopieer de formulier-id's onder de kolom Naam op het blad 'shared-default', behalve het verzendveld.

  5. Selecteer Plakken speciaal > Rijen omzetten in kolommen op het blad 'inkomend' om de veld-id's als kolomkoppen op dit nieuwe blad te kopiëren. Alleen velden behouden waarvan de gegevens andere gegevens moeten vastleggen, kunnen worden genegeerd.

    Elke waarde in de kolom Name van het shared-default -blad, met uitzondering van de verzendknop, kan fungeren als koptekst in het incoming -blad. Neem bijvoorbeeld de volgende afbeelding die kopteksten illustreert voor een formulier "contact-us":

    Gebieden voor een contact-usvorm

  6. Gebruik de extensie AEM Sidekick om een voorbeeld van de formulierupdates weer te geven. Uw blad is nu klaar om inkomende formulierverzendingen te accepteren.

    note note
    NOTE
    Zelfs als u al eerder een voorvertoning van het blad hebt weergegeven, moet u dit opnieuw bekijken nadat u het incoming -blad voor het eerst hebt gemaakt.

Nadat de veldnamen aan het incoming -werkblad zijn toegevoegd, kan het formulier opmerkingen accepteren. U kunt een voorbeeld van het formulier bekijken en gegevens naar het blad verzenden.

Zodra het blad opstelling is om gegevens te ontvangen, kunt u voorproef de vorm gebruikend het AanpassingsBlok van Formsof verzoeken van de gebruiksPOSTbeginnen gegevens naar het blad te verzenden.

WARNING
De "gedeelde-standaard"bladen moeten nooit om het even welke persoonlijk identificeerbare informatie of gevoelige gegevens bevatten die u niet aan openbaar toegankelijk bent.

Admin API's gebruiken om een spreadsheet in te schakelen voor het accepteren van gegevens

U kunt ook een verzoek van de POST naar het formulier verzenden, zodat het formulier gegevens kan accepteren en kopteksten voor het incoming -blad kan configureren. Na ontvangst van het verzoek van de POST analyseert de dienst het lichaam van verzoek en produceert autonoom de essentiële kopballen en bladen nodig voor gegevensopname.

Admin APIs gebruiken om een spreadsheet toe te laten om gegevens goed te keuren:

  1. Open het werkboek dat u hebt gecreeerd en verander de naam van het standaardblad in incoming.

    note warning
    WARNING
    Als het incoming blad niet bestaat, zal AEM geen gegevens naar dit werkboek verzenden.
  2. Geef een voorvertoning van het blad weer in het zijpaneel.

    note note
    NOTE
    Zelfs als u al eerder een voorvertoning van het blad hebt weergegeven, moet u dit opnieuw bekijken nadat u het incoming -blad voor het eerst hebt gemaakt.
  3. Verzend het verzoek om de POST om de juiste kopteksten op het incoming -blad te genereren en voeg de shared-default -bladen toe aan uw spreadsheet, als dit nog niet het geval is.

    Om te begrijpen hoe te om het verzoek van de POST voor vestiging uw blad te formatteren, verwijs naar de Admin API documentatie. U kunt het onderstaande voorbeeld bekijken:

    Verzoek

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

    Reactie

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

    U kunt gereedschappen zoals curl of Postman gebruiken om dit verzoek voor POSTEN uit te voeren, zoals hieronder wordt getoond:

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

    Het bovenstaande verzoek om POST bevat voorbeeldgegevens, waaronder zowel formuliervelden als de bijbehorende samplewaarden. Deze gegevens worden door de beheerservice gebruikt om het formulier in te stellen.

    Uw formulier is nu ingeschakeld voor het accepteren van gegevens. U ziet ook de volgende wijzigingen in uw spreadsheet:

Automatische wijzigingen in blad als dit is ingeschakeld voor het accepteren van gegevens.

Wanneer het werkblad is ingesteld op het ontvangen van gegevens, ziet u de volgende wijzigingen in het werkblad:

Er wordt een blad met de naam "Slack" toegevoegd aan uw Excel-werkboek of Google-werkblad. In dit blad, kunt u automatische berichten voor een aangewezen kanaal van de Slack vormen wanneer de nieuwe gegevens in uw spreadsheet worden opgenomen. Momenteel steunt AEM berichten uitsluitend aan de organisatie van de Slack van de Techniek van de AEM en de organisatie van de Steun van de Onderneming van de Adobe.

  1. Als u meldingen voor Slacks wilt instellen, voert u 'teamId' van de werkruimte van de Slack en 'kanaalnaam' of 'ID' in. U kunt ook de slack-bot (met de foutopsporingsopdracht) vragen naar "teamId" en "channel ID". Het verdient de voorkeur de kanaalid te gebruiken in plaats van de kanaalnaam, omdat deze de kanaalnamen behoudt.

    note note
    NOTE
    Oudere formulieren hadden niet de kolom "teamId". "teamId" is opgenomen in de kanaalkolom, gescheiden door "#" of "/".
  2. Voer een gewenste titel in en typ onder velden de namen van de velden die u wilt weergeven in het bericht Slack. Elke kop moet worden gescheiden door een komma (bijvoorbeeld naam, e-mail).

    note warning
    WARNING
    De "gedeelde-standaard"bladen moeten nooit om het even welke persoonlijk identificeerbare informatie of gevoelige gegevens bevatten die u niet aan openbaar toegankelijk bent.

Gegevens naar uw werkblad verzenden send-data-to-your-sheet

Nadat het blad wordt geplaatst om gegevens te ontvangen, kunt u voorproef de vorm gebruikend het AanpassingsBlok van Formsof gebruik Admin APIsbeginnen gegevens naar het blad te verzenden.

Admin API's gebruiken om gegevens naar uw werkblad te verzenden

U kunt verzoeken om POST rechtstreeks naar het formulier verzenden met hlx.page, hlx.live of uw productiedomein, om gegevens te verzenden.

POST https://branch–repo–owner.hlx.(page|live)/email-form
POST https://my-domain.com/email-form
NOTE
De URL mag niet de extensie .json hebben. U moet het blad publiceren zodat bewerkingen in de POST kunnen worden uitgevoerd op .live of in het productiedomein.

De formuliergegevens opmaken

Er zijn een paar verschillende manieren waarop u de formuliergegevens in de hoofdtekst van de POST kunt opmaken. U kunt het volgende gebruiken:

  • array van name:value paren:

    code language-json
    {
      "data": [
        { "name": "name", "value": "Clark Kent" },
        { "name": "email", "value": "superman@example.com" },
        { "name": "subject", "value": "Regarding Product Inquiry" },
        { "name": "message", "value": "I have some questions about your products." },
        { "name": "phone", "value": "123-456-7890" },
        { "name": "company", "value": "Example Inc." },
        { "name": "country", "value": "United States" },
        { "name": "preferred_contact_method", "value": "Email" },
        { "name": "newsletter_subscribe", "value": true }
      ]
    }
    

    Bijvoorbeeld

    code language-json
    curl -s -i -X POST 'https://main--portal--wkndforms.hlx.page/contact-us' \
        --header 'Content-Type: application/json' \
        --data '{
        "data": [
            { "name": "name", "value": "Clark Kent" },
            { "name": "email", "value": "superman@example.com" },
            { "name": "subject", "value": "Regarding Product Inquiry" },
            { "name": "message", "value": "I have some questions about your        products." },
            { "name": "phone", "value": "123-456-7890" },
            { "name": "company", "value": "Example Inc." },
            { "name": "country", "value": "United States" },
            { "name": "preferred_contact_method", "value": "Email" },
            { "name": "newsletter_subscribe", "value": true }
        ]
    }'
    
  • een object met key:value paren:

    code language-json
        {
          "data": {
            "name": "Jessica Jones",
            "email": "jj@example.com",
            "subject": "Regarding Product Inquiry",
            "message": "I have some questions about your products.",
            "phone": "123-456-7890",
            "company": "Example Inc.",
            "country": "United States",
            "preferred_contact_method": "Email",
            "newsletter_subscribe": true
          }
        }
    

    Bijvoorbeeld:

    code language-json
    curl -s -i -X POST 'https://admin.hlx.page/form/wkndforms/portal/main/contact-us.json' \
    --header 'Content-Type: application/json' \
    --data '{
        "data": {
            "Email": "khushwant@wknd.com",
            "Name": "khushwant",
            "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
        }
    }'
    
  • De hoofdtekst van een URL-codering (x-www-form-urlencoded ) (met content-type header ingesteld op application/x-www-form-urlencoded )

    code language-shell
    'Email=kent%40wknd.com&Name=clark&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'
    

    Bijvoorbeeld:

    code language-shell
    curl -s -i -X POST \
      -d 'Email=kent%40wknd.com&Name=clark&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' \
      https://main--portal--wkndforms.hlx.live/contact-us
    

Daarna, kunt u aanpassen dankt u bericht.

Zie ook

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