DokumentationAEM as a Cloud ServiceAnvändarhandbok

Konfigurera dina Google-blad eller Microsoft Excel-filer så att du kan börja ta emot data

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Administratör
  • Utvecklare

När du har skapat och förhandsgranskat formuläret är det dags att aktivera motsvarande kalkylblad för att börja ta emot data. Du kan manuellt aktivera kalkylbladet för att ta emot data eller använda admin-API:er för att aktivera ett kalkylblad för att ta emot data.

Dokumentbaserat redigeringssystem

Aktivera kalkylbladet manuellt för att ta emot data

Aktivera att kalkylbladet accepterar data

  1. Öppna kalkylbladet som innehåller ditt formulär och lägg till ett nytt blad och ge det ett nytt namn till incoming.

    note warning
    WARNING
    Om bladet incoming inte finns skickar AEM inga data till kalkylbladet.

  2. I det här bladet infogar du en tabell med namnet "intag_form". Välj det antal kolumner som krävs för att matcha formulärfältsnamnen. Gå sedan till Infoga > Tabell i verktygsfältet och klicka på OK.

  3. Ändra namnet på tabellen till "intag_form". Om du vill ändra namnet på tabellen i Microsoft Excel markerar du tabellen och klickar på Tabelldesign.

  4. Lägg sedan till formulärfältsnamnen som tabellrubriker. Om du vill vara säker på att fälten är exakt desamma kan du kopiera och klistra in dem från bladet"shared-default". I ditt"shared-default"-blad markerar och kopierar du de formulär-ID som anges under kolumnen"Name", förutom i fältet submit.

  5. I det inkommande bladet väljer du Klistra in special > Transponera rader till kolumner för att kopiera fält-ID:n som kolumnrubriker i det nya bladet. Behåll endast de fält vars data behöver hämtas från andra fält som kan ignoreras.

    Varje värde i Name-kolumnen i shared-default -bladet, förutom skicka-knappen, kan fungera som en rubrik i incoming -bladet. Titta på följande bild som illustrerar rubriker för ett"kontaktformulär":

    Fält för ett kontaktformulär

  6. Använd tillägget AEM Sidekick för att förhandsgranska formuläruppdateringarna. Ditt blad är nu klart att ta emot inkommande formulärinskickat material.

    note note
    NOTE
    Även om du har förhandsgranskat bladet tidigare måste du förhandsgranska det igen när du har skapat bladet incoming för första gången.

När fältnamnen har lagts till i bladet incoming kan ditt formulär ta emot inskickade data. Du kan förhandsgranska formuläret och skicka data till bladet med hjälp av det.

När kalkylbladet har konfigurerats för att ta emot data kan du förhandsgranska formuläret med hjälp av adaptivt Forms-block eller använda förfrågningar från POSTER för att börja skicka data till bladet.

WARNING
De ska aldrig innehålla någon personligt identifierbar information eller känsliga data som du inte känner till om de är tillgängliga för allmänheten.

Använd admin-API:er för att aktivera ett kalkylblad som accepterar data

Du kan också skicka en begäran om POST till formuläret så att det kan ta emot data och konfigurera rubriker för bladet incoming. När tjänsten tar emot en begäran om POST analyserar tjänsten innehållet i begäran och skapar automatiskt de huvuden och ark som behövs för datainhämtning.

Så här använder du Admin API:er för att aktivera ett kalkylblad för att ta emot data:

  1. Öppna arbetsboken som du har skapat och ändra namnet på standardbladet till incoming.

    note warning
    WARNING
    Om bladet incoming inte finns skickar AEM inga data till arbetsboken.

  2. Förhandsgranska bladet i sidosparken.

    note note
    NOTE
    Även om du har förhandsgranskat bladet tidigare måste du förhandsgranska det igen när du har skapat bladet incoming för första gången.

  3. Skicka begäran om POST för att generera lämpliga rubriker i incoming-bladet och lägg till shared-default-bladen i ditt uppslagsblad, om det inte redan finns.

    Mer information om hur du formaterar begäran om POST för att konfigurera bladet finns i dokumentationen för Admin API. Du kan titta på exemplet nedan:

    Begäran

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

    Svar

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

    Du kan använda verktyg som curl eller Postman för att utföra denna begäran om POST, vilket visas nedan:

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

    Ovannämnda POST innehåller exempeldata, inklusive både formulärfält och deras respektive exempelvärden. Dessa data används av administrationstjänsten för att konfigurera formuläret.

    Formuläret är nu aktiverat för att ta emot data. Du kan även se följande ändringar i kalkylbladet:

Automatiska ändringar i bladet när det har aktiverats för att ta emot data.

När kalkylbladet är inställt på att ta emot data kan du se följande ändringar i kalkylbladet:

Ett blad med namnet "Slack" läggs till i Excel-arbetsboken eller Google-bladet. I det här bladet kan du konfigurera automatiska meddelanden för en angiven Slack-kanal när nya data hämtas till kalkylbladet. För närvarande stöder AEM endast meddelanden till AEM Engineering Slack och Adobe Enterprise Support.

  1. Om du vill konfigurera Slack-meddelanden anger du teamId för arbetsytan i Slack och kanalnamnet eller ID:t. Du kan också fråga en robot (med felsökningskommandot) för teamId och channel ID. Det är bättre att använda kanal-ID i stället för kanalnamn eftersom kanalens namn bevaras.

    note note
    NOTE
    Äldre formulär hade inte kolumnen teamId. "teamId" inkluderades i kanalkolumnen, avgränsad med "#" eller "/".

  2. Ange en titel som du vill ha och skriv under fält namnen på de fält som du vill se i Slack-meddelandet. Varje rubrik ska avgränsas med kommatecken (till exempel namn, e-post).

    note warning
    WARNING
    De ska aldrig innehålla någon personligt identifierbar information eller känsliga data som du inte känner till om de är tillgängliga för allmänheten.

Skicka data till bladet send-data-to-your-sheet

När kalkylbladet är inställt på att ta emot data kan du förhandsgranska formuläret med Adaptivt Forms-block eller använda Admin-API:er för att börja skicka data till bladet.

Använd admin-API:er för att skicka data till bladet

Du kan skicka POST-förfrågningar direkt till ditt formulär med hlx.page, hlx.live eller din produktionsdomän för att skicka data.

POST https://branch–repo–owner.hlx.(page|live)/email-form
POST https://my-domain.com/email-form
NOTE
URL:en ska inte ha filnamnstillägget .json. Du måste publicera bladet för att POST-åtgärder ska fungera på .live eller på produktionsdomänen.

Formatera formulärdata

Det finns olika sätt att formatera formulärdata i POSTENS brödtext. Du kan använda

  • matris med name:value par:

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

    Till exempel

    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 }
    ]
}'

  • ett objekt med key:value par:

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

    Exempel:

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

  • URL-kodad (x-www-form-urlencoded) brödtext (med rubriken content-type inställd på 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'

    Exempel:

    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

Sedan kan du anpassa tackmeddelandet.

Se även

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