Konfigurera tjänsten Automated Forms Conversion (AFCS) about-this-help

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

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

  • Med Linux® och Microsoft® Windows®,

Onboarding onboarding

Tjänsten är kostnadsfri för kunder som har 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 få tillgång till tjänsten. Tjänsten är också tillgänglig kostnadsfritt och föraktiverat för kunder som har AEM Forms as a 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 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 Service (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 AEM 6.5-version med den senaste versionen av AEM Service Pack eller AEM Forms as a Cloud Service som författare med de senaste uppdateringarna.
  • En AEM-användare (i din AEM-instans) som är medlem i en formuläranvändargrupp

Konfigurera miljön setuptheservice

Innan du använder tjänsten förbereder du din 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. Ladda ned och installera AEM 6.5 eller AEM Forms as a Cloud Service aemquickstart

Tjänsten Automated Forms Conversion (AFCS) körs på AEM Author Instance. Du måste ha AEM 6.5 eller AEM Forms as a Cloud Service för att kunna konfigurera en AEM-författarinstans.

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

Hämta och installera den senaste versionen av AEM Service Pack. Mer information finns i AEM 6.5 Service Pack versionsinformation.

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

En AEM-instans 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.
https://adminconsole.adobe.com/

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

4. Skapa egna teman och mallar referencepackage

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 adaptivt 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 åtkomst och behörigheter

Innan du fortsätter med att konfigurera tjänsten och ansluter instansen till tjänsten som körs i Adobe Cloud, ska du läsa 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 Adobe-program och -tjänster 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 AEM Forms-författarinstans till den automatiska formulärkonverteringstjänsten (AFCS) som körs i Adobe Cloud. När en administratör ger en utvecklare behörighet att ansluta till AFCS (Automated Forms Conversion Service) skickas ett e-postmeddelande med titeln Du har nu tillgång till 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-instans till tjänsten Automated Forms Conversion på Adobe Cloud.

E-post om beviljande av utvecklaråtkomst

Ge utvecklare i organisationen åtkomst

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 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 har lagts till i en AFCS-profil (Adobe Automated Forms Conversion 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.

  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. Skapa till exempel en profil som AFC_Flamingo_Test_Dev.

    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. Klicka 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 har lagt till utvecklare i Adobe I/O-profilen meddelas utvecklarna via e-post (om den är konfigurerad).

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

Ange en e-postadress i profilen för den AEM-användare som ska köra tjänsten. Kontrollera att användaren är medlem i gruppen forms-users. 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 som AEM-administratör på din AEM Forms-författarinstans. Använd dina lokala AEM-inloggningsuppgifter för att logga in.

  2. Klicka på Adobe Experience Manager > Tools > Security > Users.

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

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

    Ange e-postadress

  5. Klicka på fliken Grupper. Skriv och markera gruppen forms-users på fliken Välj grupp.

  6. Klicka på Spara och stäng. Användaren är nu medlem i gruppen för användare av formulär.

    Lägg till användargrupp

Anslut din AEM Forms-instans till tjänsten Automated Forms Conversion (AFCS) i Adobe Cloud

När en administratör har gett dig utvecklaråtkomst kan du ansluta din AEM Forms-instans till AFCS-tjänsten (Automated Forms Converting Service) som körs i Adobe Cloud.
Så här ansluter du AEM Forms-instansen till tjänsten Automated Forms Conversion:

1. Konfigurera tjänst-API:erna på Adobe Developer Console

2. Skapa Adobe IMS-konfigurationer

3. Skapa konfiguration för automatisk formulärkonvertering

1. Konfigurera tjänst-API:erna på Adobe Developer Console

Om du vill använda tjänsten Automated Forms Conversion (AFCS) skapar du ett projekt och lägger till Automated Forms Configuration Service API i projektet på Adobe Developer Console. Integreringen genererar API-nyckel, klienthemlighet, ID för tekniskt konto, scope och organisations-ID.
Så här konfigurerar du API:t för tjänsten Automated Forms Conversion på Adobe Developer Console:

  1. Logga in på https://developer.adobe.com/console. 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. Klicka på Create new project. En skärm för att komma igång med ditt nya projekt visas.

    Skapa nytt API-projekt

  4. Klicka på Add API. En skärm med en lista över alla API:er som är aktiverade för ditt konto visas.
    Lägg till API

  5. Markera Automated Forms Conversion service och klicka på Next. En skärm som konfigurerar API:t visas.
    Välj AFCS API

  6. Välj autentiseringsmetoden OAuth Server-to-Server.

  7. Ange Credential Name och klicka på Next.
    Ange autentiseringsuppgiftsnamn

  8. Välj en produktprofil. Välj till exempel en profil som AFC_Flamingo_Test_Dev.

  9. Klicka på Save configured API.
    Välj profil

    note note
    NOTE
    Välj den profil som skapades när du beviljade åtkomst till utvecklare i organisationen. Om du inte vet vilken profil du ska välja kontaktar du administratören.
  10. Klicka på OAuth Server-to-Server om du vill visa API-nyckeln, klienthemligheten och annan information som krävs för att ansluta din AEM-instans till tjänsten Automated Forms Conversion (AFCS).
    Välj autentiseringsuppgifter för sökväg

    Informationen på sidan används för att skapa IMS-konfiguration, vilket förklaras i avsnittet Skapa IMS-teknisk konfiguration på AEM Author Instance.

    Information om OAuth-autentiseringsuppgifter

2. Skapa Adobe IMS-konfigurationer

Logga in på din författarinstans för att skapa Adobe IMS-konfigurationer. Använd Information om OAuth-autentiseringsuppgifter för att hämta API-nyckeln, klienthemligheten, det tekniska konto-ID:t, omfånget och organisations-ID:t.

  1. Logga in på din AEM Forms-författarinstans. Navigera till Tools> Security > Adobe IMS Configurations.

  2. Klicka på Create.

    Skapa IMS Adobe-konfiguration

  3. Sidan Adobe IMS Technical Account Configuration visas.

    Sidan Konfiguration av Adobe IMS Technical Account

  4. Välj Automated Forms Conversion Service i molnlösning.

  5. Ange följande:

  6. Klicka på Save. Adobe IMS-konfigurationen skapas.

    note caution
    CAUTION
    Skapa endast en IMS-konfiguration. Skapa inte fler än en IMS-konfiguration.
  7. Välj Adobe IMS-konfigurationen och klicka på Check Health. En dialogruta visas.
    Kontrollera hälsa

    En Check-dialogruta visas.

  8. Klicka på Check.

    Kontrollera hälsa

    Meddelandet Token har hämtats visas när en anslutning har skapats.

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

  9. Klicka på Stäng.

3. Skapa konfiguration för automatisk formulärkonvertering

Skapa en konfiguration för automatisk formulärkonvertering för att ansluta din AEM-instans 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. Klicka på Adobe Experience Manager > Tools> Cloud Services > Automate Forms Conversion Configuration på din AEM Forms-instans.

  2. Markera mappen Global och klicka på Create.
    Sidan Skapa automatisk formulärkonverteringskonfiguration 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.
    Välj global mapp

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

    AFCS-konfiguration

    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) 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 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:
    AFCS-konfiguration

    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 (För 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. Klicka på Create. Molnkonfigurationen har skapats. Din AEM Forms-instans är redo att börja konvertera äldre formulär till Adaptiv Forms.

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