DokumentationAEMGuide för automatiserad konverteringstjänst för Forms

Konfigurera tjänsten Automated forms conversion (AFCS) about-this-help

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Nybörjare
  • Mellanliggande
  • Administratör
  • Utvecklare
  • Användare

I den här hjälpen beskrivs hur en AEM kan konfigurera tjänsten Automated forms conversion (AFCS) för att automatisera konverteringen av PDF forms till adaptiva formulär. Den här hjälpen är till för IT-administratörer och AEM på din organisation. Informationen baseras på antagandet att alla som läser den här hjälpen känner till följande tekniker:

  • Installera, konfigurera och administrera Adobe Experience Manager- och AEM-paket,

  • Med Linux® och Microsoft® Windows®,

  • Konfigurera SMTP-e-postservrar

Onboarding onboarding

Tjänsten är kostnadsfri för kunder med AEM 6.4 Forms och AEM 6.5 Forms On-Premise och företagskunder med Adobe-Managed Service. Du kan kontakta Adobe säljteam eller din Adobe-representant för att begära åtkomst till tjänsten. Tjänsten är också tillgänglig kostnadsfritt och föraktiverad för AEM Forms as a Cloud Service kunder.

Adobe aktiverar åtkomst för organisationen och tillhandahåller behörigheter åt den person som utses till administratör i organisationen. Administratören kan ge AEM Forms-utvecklare (användare) i din organisation åtkomst till tjänsten.

Förutsättningar prerequisites

Du behöver följande för att kunna använda tjänsten Automated forms conversion (AFCS):

  • Tjänsten Automated forms conversion (AFCS) är aktiverad för din organisation
  • Ett Adobe ID-konto med administratörsbehörighet för konverteringstjänsten
  • En instans som är igång AEM 6.4, AEM 6.5 eller AEM Forms as a Cloud Service författare med senaste AEM Service Pack eller senaste uppdateringar.
  • En AEM användare (i din AEM instans) som är medlem i användargruppen formulär

Konfigurera miljön setuptheservice

Innan du använder tjänsten förbereder du AEM författarinstans för att ansluta till tjänsten som körs i Adobe Cloud. Utför följande steg i den listade sekvensen för att förbereda instansen för tjänsten:

  1. Hämta och installera AEM 6.4, AEM 6.5 eller ombord på AEM Forms as a Cloud Service
  2. Hämta och installera det senaste AEM Service Pack
  3. Hämta och installera det senaste AEM Forms-tilläggspaketet
  4. (valfritt) Hämta och installera det senaste kopplingspaketet
  5. Skapa egna teman och mallar

Hämta och installera AEM 6.4 eller AEM 6.5 eller ombord på AEM Forms as a Cloud Service aemquickstart

Tjänsten Automated forms conversion (AFCS) körs AEM författarinstansen. Du måste AEM 6.4, AEM 6.5 eller AEM Forms as a Cloud Service för att kunna konfigurera en AEM författarinstans.

(Endast för AEM 6.4 och AEM 6.5) Hämta och installera AEM senaste Service Pack servicepack

Hämta och installera det senaste AEM Service Pack. Mer information finns i AEM 6.4 Service Pack versionsinformation eller AEM 6.5 Service Pack versionsinformation.

(Endast för AEM 6.4 och AEM 6.5) Hämta och installera AEM Forms tilläggspaket downloadaemformsaddon

En AEM innehåller grundläggande formulärfunktioner. Konverteringstjänsten kräver AEM Forms alla funktioner. Ladda ned och installera AEM Forms-tilläggspaket för att utnyttja alla funktioner i AEM Forms. Paketet krävs för att konfigurera och köra konverteringstjänsten. Detaljerade instruktioner finns i Installera och konfigurera datainhämtningsfunktioner.

NOTE
Kontrollera att du utför de obligatoriska konfigurationerna efter installationen när du har installerat tilläggspaketet.

Skapa egna teman och mallar referencepackage

Om du startar AEM 6.4 eller AEM 6.5 i produktionsläge (noSampleContent Run Mode) installeras inte referenspaketen. Referenspaketen innehåller exempelteman och mallar. Tjänsten Automated forms conversion (AFCS) kräver minst ett tema och en mall för att konvertera ett PDF-formulär till ett anpassningsbart formulär. Skapa ett eget tema och en egen mall och en tjänstkonfiguration för att använda anpassade mallar och teman innan du använder tjänsten.

Du kan också hämta och installera AEM Forms Reference Assets -paketet på din Author-instans. Det skapar vissa referensteman och mallar.

Konfigurera tjänsten configure-the-service

Innan du fortsätter att konfigurera tjänsten och ansluter din lokala instans till tjänsten som körs i Adobe Cloud, ska du lära dig mer om vilka profiler och behörigheter som krävs för att ansluta till tjänsten. Tjänsten använder två olika typer av profiler, administratörer och utvecklare:

  • Administratörer: Administratörer ansvarar för att hantera program och tjänster från Adobe för sin organisation. Administratörer ger utvecklare i sin organisation åtkomst till tjänsten Automated forms conversion (AFCS) som körs i Adobe Cloud. När en administratör har etablerats för en organisation får administratören ett e-postmeddelande med titeln ‘You now have administrator rights to manage Adobe software and services for your organization’. Om du är administratör kontrollerar du om postlådan innehåller e-post med den tidigare nämnda titeln och fortsätter till Ge utvecklare i din organisation åtkomst.

E-post för beviljande av administratörsåtkomst

  • Utvecklare: En utvecklare ansluter en lokal AEM Forms-författarinstans till tjänsten Automated forms conversion (AFCS) som körs i Adobe Cloud. När en administratör ger en utvecklare behörighet att ansluta till tjänsten Automated forms conversion (AFCS), skickas ett e-postmeddelande med titeln Du har nu utvecklaråtkomst för att hantera Adobe API-integreringar för din organisation till utvecklaren. Om du är utvecklare kan du kontrollera om din postlåda innehåller e-post med den tidigare nämnda titeln och fortsätta till Anslut din lokala AEM till Automated forms conversion-tjänsten på Adobe Cloud.

E-post om beviljande av utvecklaråtkomst

(Endast för administratörer av AEM 6.4 och AEM 6.5) Bevilja åtkomst till utvecklare i din organisation adduseranddevs

När Adobe har aktiverat åtkomst för din organisation och gett administratören de behörigheter som krävs kan administratören logga in på Admin Console (detaljerade instruktioner nedan), skapa en profil och lägga till utvecklare i profilen. Utvecklare kan ansluta en lokal instans av AEM Forms till tjänsten Automated forms conversion (AFCS) i Adobe Cloud.

Utvecklare är medlemmar i din organisation som har utsetts att köra konverteringstjänsten. Endast de utvecklare som läggs till i AFCS-profilen (Adobe service) har rätt att använda tjänsten Automated forms conversion (AFCS). Följ stegen nedan för att skapa en profil och lägga till utvecklare i den. Minst en profil krävs för att ge utvecklare i organisationen nödvändig åtkomst:

  1. Logga in på Admin Console. Använd Adobe ID av administratören som har etablerats för att använda tjänsten Automated forms conversion (AFCS) för inloggning. Använd inte något annat ID eller Federated ID för att logga in.

  2. Klicka på alternativet Automated Forms Conversion.

  3. Klicka på New Profile på fliken Products.

  4. Ange Name, Display Name och Description för profilen. Klicka på Done. En profil skapas.

    Ange information för den nya profilen.

  5. Lägg till utvecklare i profilen. Så här lägger du till utvecklare:

    1. Gå till fliken Översikt i Admin Console.
    2. Klicka på Assign Developers på önskat produktkort.
    3. Ange utvecklarnas e-postadress och eventuellt för- och efternamn.
    4. Välj produktprofiler. Tryck på Save.

Upprepa stegen ovan för alla användare. Mer information om hur du lägger till utvecklare finns i Hantera utvecklare.

När en administratör lägger till utvecklare i profilen Adobe I/O meddelas utvecklarna via e-post. När du har tagit emot e-postmeddelandet kan utvecklarna fortsätta att ansluta en lokal AEM Forms-instans med tjänsten Automated forms conversion i Adobe Cloud.

(Endast för utvecklare) Anslut din lokala AEM Forms-instans till tjänsten Automated forms conversion (AFCS) i Adobe Cloud connectafcadobeio

När en administratör har gett dig utvecklaråtkomst kan du ansluta den lokala AEM Forms-instansen till tjänsten Automated forms conversion (AFCS) som körs i Adobe Cloud. Utför följande steg i den listade sekvensen för att ansluta din AEM Forms-instans till tjänsten:

Konfigurera e-postmeddelande configureemailnotification

Tjänsten Automated forms conversion (AFCS) använder Day CQ-e-posttjänsten för att skicka e-postmeddelanden. Dessa e-postmeddelanden innehåller information om lyckade eller misslyckade konverteringar. Om du väljer att inte ta emot meddelanden hoppar du över dessa steg. Utför följande steg för att konfigurera Day CQ Mail Service:

  • För AEM 6.4 Forms eller AEM 6.5 Forms:

    1. Gå till AEM konfigurationshanteraren på http://localhost:4502/system/console/configMgr

    2. Öppna Dag CQ Mail Service-konfigurationen. Ange ett värde för fälten SMTP server host name, SMTP server port och From address. Klicka på Save.

      Du kan kontakta din e-postleverantör eller IT-administratör för att få information om värdnamn och port för SMTP-servern. Du kan använda valfri giltig e-postadress i formulärfältet. Exempel: notification@example.com eller donotreply@example.com.

    3. Öppna konfigurationen för Day CQ Link Externalizer. I fältet Domains anger du det faktiska värdnamnet eller IP-adressen och portnumret för lokala instanser, författare och publiceringsinstanser. Klicka på Save.

  • För AEM Forms as a Cloud Service loggar du en supportanmälan för att aktivera e-posttjänsten.

Lägg till användare i gruppen för formuläranvändare adduserstousergroup

Ange en e-postadress i profilen för den AEM användaren som ska köra tjänsten. Kontrollera att användaren är medlem i gruppen forms user. E-post skickas till e-postadressen till den användare som kör konverteringen. Så här anger du en e-postadress för användaren och lägger till användare i formuläranvändargruppen:

  1. Logga in på din AEM Forms-författarinstans som AEM. Använd dina lokala AEM för att logga in. Använd inte Adobe ID för att logga in. Tryck på Adobe Experience Manager > Tools > Security > Users.

  2. Välj en användare som är utsedd att köra konverteringstjänsten och tryck på Properties. Sidan Redigera användarinställningar öppnas.

  3. Ange en e-postadress i fältet Email och tryck på Save. E-postmeddelandena skickas till den angivna e-postadressen när konverteringen har slutförts eller misslyckats.

  4. Tryck på fliken Grupper. Skriv och markera gruppen forms-users på fliken Välj grupp. Tryck på Spara och stäng. Användaren är nu medlem i gruppen för användare av formulär.

(Endast för AEM 6.4 och AEM 6.5) Skaffa offentliga certifikat obtainpubliccertificates

Med ett offentligt certifikat kan du autentisera din profil på Adobe I/O.

  1. Logga in på din AEM Forms-författarinstans. Navigera till Tools> Security > Adobe IMS Configurations. Tryck på Create. Sidan Adobe IMS Technical Account Configuration visas.

    Sidan Konfiguration av Adobe IMS Technical Account

  2. Välj Automated Forms Conversion Service i molnlösningen.

  3. Markera kryssrutan Create new certificate och ange ett alias. Aliaset fungerar som namn på dialogrutan. Tryck på Create certificate. En dialogruta visas. Klicka på OK. Certifikatet skapas.

  4. Tryck på Download Public Key och spara certifikatfilen AEM-Adobe-IMS.crt på datorn. Certifikatfilen används för att konfigurera tjänstens API:er på Adobe Developer Console. Tryck på Next.

  5. Ange följande:

    Lämna de andra fälten tomma (kommer senare). Håll sidan öppen.

(Endast för AEM 6.4 och AEM 6.5) Konfigurera tjänst-API:erna på Adobe Developer Console createintegration

Om du vill använda tjänsten Automated forms conversion (AFCS) skapar du ett projekt och lägger till API:t för Automated Forms Configuration Service i projektet på Adobe Developer Console. Integreringen genererar API-nyckel, klienthemlighet, nyttolast (JWT).

  1. Logga in på https://console.adobe.io/. Använd ditt Adobe ID-utvecklarkonto som administratören har konfigurerat för inloggning på Adobe I/O-konsolen.

  2. Välj organisation i det övre högra hörnet. Kontakta administratören om du inte känner till din organisation.

  3. Tryck på Create new project. En skärm för att komma igång med ditt nya projekt visas. Tryck på Add API. En skärm med en lista över alla API:er som är aktiverade för ditt konto visas.

  4. Välj Automated Forms Conversion service och tryck på Next. En skärm som konfigurerar API:t visas.

  5. Välj alternativet Upload your public key, överför filen AEM-Adobe-IMS.crt som hämtas i avsnittet Hämta offentliga certifikat och tryck på Next. Alternativet Skapa ett nytt tjänstkonto (JWT) visas. Tryck på Next.

  6. Välj en produktprofil och tryck på Save configured API. Välj den profil som skapades när du beviljade åtkomst till utvecklare i din organisation. Om du inte vet vilken profil du ska välja kontaktar du administratören.

  7. Tryck på Service Account (JWT) om du vill visa API-nyckeln, klienthemligheten och annan information som krävs för att ansluta den lokala AEM till tjänsten Automated forms conversion (AFCS). Informationen på sidan används för att skapa IMS-konfigurationer på den lokala datorn.

  8. Öppna sidan IMS-konfiguration på den lokala instansen. Du lämnade den här sidan öppen i slutet av avsnittet Hämta ett offentligt certifikat.

    Ange titel, API-nyckel, klienthemlighet och nyttolast

  9. På Adobe IMS Technical page anger du API Key och Client Secret. Använd de värden som anges på JWT (Service Account) på Adobe Developer konsolsida.

    note note
    NOTE
    För nyttolast använder du koden som finns på fliken Generera JWT på sidan Tjänstkonto (JWT) i Adobe Developer Console.

  10. Tryck på Save. IMS-konfigurationen skapas.

    note caution
    CAUTION
    Skapa endast en IMS-konfiguration. Skapa inte fler än en IMS-konfiguration.

  11. Välj IMS-konfigurationen och tryck på Check Health. En dialogruta visas. Tryck på Check. Meddelandet Token har hämtats visas när en anslutning har skapats.

    När anslutningen lyckades visas det token som hämtats.

Konfigurera Cloud Servicen configure-the-cloud-service

Skapa en Cloud Service-konfiguration för att ansluta AEM till konverteringstjänsten. Du kan också ange en mall, ett tema och formulärfragment för en konvertering. Du kan skapa flera olika molntjänstkonfigurationer separat för varje formuläruppsättning. Du kan till exempel ha en separat konfiguration för säljavdelningsformulär och en separat konfiguration för kundsupportformulär. Så här skapar du en molntjänstkonfiguration:

  1. Tryck på Adobe Experience Manager > Tools> Cloud Services > Automate Forms Conversion Configuration på din AEM Forms-instans.

  2. Tryck på mappen Global och tryck på Create. Sidan där du skapar konfigurationen för Automated forms conversion visas. Konfigurationen skapas i mappen Global. Du kan också skapa konfigurationen i en annan mapp som finns eller skapa en mapp för dina konfigurationer.

  3. På sidan Create Automated Forms Conversion Configuration anger du värdet för följande fält och trycker på Next.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2
    Fält Beskrivning
    Titel Unik rubrik för konfigurationen. Titeln visas i användargränssnittet som används för att starta konverteringen.
    Namn Unikt namn för konfigurationen. Konfigurationen sparas i CRX-databasen med det angivna namnet. Namnet kan vara identiskt med titeln.
    Miniatyrplats Platsen för miniatyrbilden för konfigurationen.
    Tjänst-URL URL för tjänsten Automated forms conversion (AFCS) i Adobe Cloud. Använd URL:en https://aemformsconversion.adobe.io/.
    Mall Standardmall som ska användas för konverterade formulär. Du kan alltid ange en annan mall innan du påbörjar konverteringen. En mall innehåller grundläggande struktur och ursprungligt innehåll för ett adaptivt formulär. Du kan välja en mall bland de färdiga mallarna. Du kan också skapa en anpassad mall.
    Tema Standardtema som ska användas på konverterade formulär. Du kan alltid ange ett annat tema innan du påbörjar konverteringen. Du kan klicka på ikonen för att välja ett tema som ingår i rutan. Du kan också skapa ett anpassat tema.
    Befintliga segment Placering av befintliga fragment, om sådana finns.
    Anpassad metamodell Sökväg till .schema.json-filen för anpassad metamodell. Du kan skapa separata metamodeller för engelska, franska, tyska, spanska, italienska och portugisiska.

  4. Ange värdet för följande fält på fliken Advanced på sidan Create Automated Forms Conversion Configuration:

    table 0-row-2 1-row-2 2-row-2
    Fält Beskrivning
    Generera postdokument Välj alternativet att automatiskt generera arkivdokument för konverterade formulär. Alternativet är endast för XFA-baserade formulär (XDP och PDF forms). När du aktiverar alternativet kan du, när du har skickat in ett formulär, tillåta dina kunder att bevara en post, i utskrift eller i dokumentformat, med information som de har fyllt i formuläret för framtida referens. Detta kallas för ett urkunder.
    Aktivera analys (Endast för AEM 6.4 och AEM 6.5) Markera alternativet att aktivera Adobe Analytics för alla konverterade formulär. Kontrollera att Adobe Analytics är aktiverat för din AEM Forms-instans innan du använder alternativet.
    • När källan är ett XFA-baserat formulär med tillägget .XDP, behåller DOR-utdatafilen XFA-layouten, annars använder konverteringstjänsten en mall som inte finns i rutan för att generera DOR för andra XFA-baserade formulär.
    • När ett XFA-formulär skickas sparas data från formuläret som ett XML-element eller ett attribut. Exempel: <Amount currency="USD"> 10.00 </Amount>. Valutan sparas som ett attribut och valutabelopp, 10.00 sparas som ett element. Skicka data från ett anpassat formulär har inga attribut, utan bara element. När ett XFA-baserat formulär konverteras till ett adaptivt formulär innehåller de adaptiva uppgifterna för att skicka formulär ett element för varje sådant attribut. Exempel:
    code language-css 
       {
      "Type": "Principal",

      "Amount": "10.00",

      "currency": "USD"
   }

  5. Tryck på Create. Molnkonfigurationen har skapats. Din AEM Forms-instans är redo att börja konvertera äldre formulär till anpassningsbara formulär.

recommendation-more-help
c40c2ccf-3d1b-4b47-b158-c4646051b46c