Konfigurera den automatiserade konverteringstjänsten för formulär

I den här hjälpen beskrivs hur en AEM kan konfigurera tjänsten Automated forms conversion 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

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 Adobes säljteam eller din Adobe-representant för att begära åtkomst till tjänsten. Tjänsten är också tillgänglig kostnadsfritt och föraktiverat för AEM Forms som Cloud Service.

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 åtkomst till AEM Forms-utvecklare (användare) i organisationen så att de kan ansluta till tjänsten.

Förutsättningar

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

  • Tjänsten Automated forms conversion är aktiverad för din organisation
  • Ett Adobe ID-konto med administratörsbehörighet för konverteringstjänsten
  • En igång AEM 6.4, AEM 6.5 eller AEM Forms som författarinstans av Cloud Servicen 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

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

  1. Ladda ned och installera AEM 6.4, AEM 6.5 eller ombord på AEM Forms som 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

Ladda ned och installera AEM 6.4 eller AEM 6.5 eller ombord på AEM Forms som Cloud Service

Tjänsten automated forms conversion körs AEM författarinstansen. Du behöver AEM 6.4, AEM 6.5 eller AEM Forms som Cloud Service för att konfigurera en AEM författarinstans.

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

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

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

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.

OBSERVERA

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

Skapa egna teman och mallar

Om du startar AEM 6.4 eller AEM 6.5 i produktionsläge (nosamplingsinnehållets körningsläge) installeras inte referenspaketen. Referenspaketen innehåller exempelteman och mallar. automated forms conversion-tjänsten 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 tjänstkonfiguration om du vill 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

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örerna 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 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 att postlådan innehåller e-post med tidigare nämnda titel och fortsätter till bevilja åtkomst till utvecklare i organisationen.

E-postadress för administratörsåtkomst

  • Utvecklare: En utvecklare ansluter en lokal AEM Forms-författarinstans till Automated forms conversion-tjänsten som körs i Adobe Cloud. När en administratör ger en utvecklare behörighet att ansluta till Automated forms conversion-tjänsten 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-postadress för utvecklaråtkomstbidrag

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

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 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 tjänstprofilen i Adobe Automated forms conversion har rätt att använda tjänsten Automated forms conversion. 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 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 fått e-postmeddelandet kan utvecklarna fortsätta att ansluta en lokal AEM Forms-instans med Automated forms conversion-tjänsten på Adobe Cloud.

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

När en administratör har gett dig utvecklaråtkomst kan du ansluta din lokala AEM Forms-instans till tjänsten Automated forms conversion 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

Tjänsten Automated forms conversion 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 få något meddelande 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 Day CQ Link Externalizer-konfigurationen. 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 som 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

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 formuläranvändaren-gruppen. 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 ska 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 välj 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

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 används 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

Om du vill använda Automated forms conversion-tjänsten skapar du ett projekt och lägger till API:t för automatisk Forms-konfigurationstjänst 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 av din organisation. Kontakta administratören om du inte vet vilken profil du ska välja.

  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 Automated forms conversion-tjänsten. 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 Console-sidan.

    OBSERVERA

    För nyttolast använder du koden som finns på fliken Generera JWT på JWT-sidan (Service Account) på Adobe Developer Console.

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

    FÖRSIKTIGHET

    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 meddelandet om token som hämtats.



Konfigurera Cloud Servicen

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.

    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-Repository 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 på 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 fragment Placering av befintliga fragment, om sådana finns.
    Anpassad metamodell Sökväg till .schema.json-filen för den anpassade metamodellen. Du kan skapa separata metamodeller för engelska, franska, tyska, spanska, italienska och portugisiska.
  4. På fliken Advanced på sidan Create Automated Forms Conversion Configuration anger du värdet för följande fält:

    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. Till 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 data som skickas ett element för varje sådant attribut. Till exempel,
       {
          "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.

På denna sida