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.
De spreadsheet handmatig inschakelen voor het accepteren van gegevens
De spreadsheet inschakelen om gegevens te accepteren
-
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. -
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.
-
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.
-
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.
-
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 hetshared-default
-blad, met uitzondering van de verzendknop, kan fungeren als koptekst in hetincoming
-blad. Neem bijvoorbeeld de volgende afbeelding die kopteksten illustreert voor een formulier "contact-us": -
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.
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:
-
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. -
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. -
Verzend het verzoek om de POST om de juiste kopteksten op het
incoming
-blad te genereren en voeg deshared-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.
-
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 "/". -
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
.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
) (metcontent-type
header ingesteld opapplication/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
- Aan de slag met AEM Forms-Edge Delivery Services
- Een formulier maken met Google Sheets of Microsoft Excel
- Stel uw Google-werkbladen of Microsoft Excel-bestanden in om te beginnen met het accepteren van
- Publish uw formulier en begin gegevens te verzamelen
- De weergave van uw formulieren aanpassen
- Herhaalbare secties toevoegen aan een
- Een aangepast bedankbericht weergeven na verzenden van formulier
- Aangepaste componenten van het Blok van de Vorm en hun eigenschappen