Konfigurera tjänsten Automated Forms Conversion (AFCS)
- Ämnen:
- Adaptiva formulär
Skapat för:
- Nybörjare
- Mellanliggande
- Administratör
- Utvecklare
- Användare
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
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
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
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
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.
-
Om du inte har AEM 6.5 installerat laddar du ned det från nedanstående platser. När du har hämtat AEM finns instruktioner om hur du konfigurerar en AEM-författarinstans i Distribuera och underhålla.:
-
Om du redan är AEM-kund hämtar du AEM 6.5 från Adobe licenswebbplats.
-
Om du är Adobe partner kan du använda Adobe Partner Training Program för att begära AEM 6.5.
-
-
Om du använder AEM Forms as a Cloud Service kan du läsa mer i AEM Forms as a Cloud Service och konfigurera en lokal utvecklingsmiljö.
2. (Endast för AEM 6.5) Hämta och installera AEM senaste Service Pack
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
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/
NOTE4. Skapa egna teman och mallar
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.
- 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.
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:
-
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.
-
Klicka på alternativet Automated Forms Conversion.
-
Klicka på New Profile på fliken Products.
-
Ange Name, Display Name och Description för profilen. Klicka på Done. Skapa till exempel en profil som AFC_Flamingo_Test_Dev.
-
Lägg till utvecklare i profilen. Så här lägger du till utvecklare:
- Gå till fliken Översikt i Admin Console.
- Klicka på Assign Developers på önskat produktkort.
- Ange utvecklarnas e-postadress och eventuellt för- och efternamn.
- 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
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:
-
Logga in som AEM-administratör på din AEM Forms-författarinstans. Använd dina lokala AEM-inloggningsuppgifter för att logga in.
-
Klicka på Adobe Experience Manager > Tools > Security > Users.
-
Välj en användare som är utsedd att köra konverteringstjänsten och klicka på Properties. Sidan Redigera användarinställningar öppnas.
-
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.
-
Klicka på fliken Grupper. Skriv och markera gruppen forms-users på fliken Välj grupp.
-
Klicka på Spara och stäng. Användaren är nu medlem i gruppen för användare av formulär.
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
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:
-
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.
-
Välj organisation i det övre högra hörnet. Kontakta administratören om du inte känner till din organisation.
-
Klicka på Create new project. En skärm för att komma igång med ditt nya projekt visas.
-
Klicka på Add API. En skärm med en lista över alla API:er som är aktiverade för ditt konto visas.
-
Markera Automated Forms Conversion service och klicka på Next. En skärm som konfigurerar API:t visas.
-
Välj autentiseringsmetoden OAuth Server-to-Server.
-
Ange Credential Name och klicka på Next.
-
Välj en produktprofil. Välj till exempel en profil som AFC_Flamingo_Test_Dev.
-
Klicka på Save configured API.
NOTEVä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. -
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).
Informationen på sidan används för att skapa IMS-konfiguration, vilket förklaras i avsnittet Skapa IMS-teknisk konfiguration på AEM Author Instance.
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.
-
Logga in på din AEM Forms-författarinstans. Navigera till Tools> Security > Adobe IMS Configurations.
-
Klicka på Create.
-
Sidan Adobe IMS Technical Account Configuration visas.
-
Välj Automated Forms Conversion Service i molnlösning.
-
Ange följande:
-
Titel: Ange en titel.
-
Auktoriseringsserver: https://ims-na1.adobelogin.com
-
Hämta följande från Konfigurera tjänst-API:erna i Adobe Developer Console-avsnittet:
- Klient-ID: Kopiera och klistra in API-nyckel (klient-ID).
- Klienthemlighet: Kopiera och klistra in Klienthemlighet.
- Omfång: Kopiera och klistra in Omfång.
- Organisations-ID: Kopiera och klistra in Tekniskt konto-ID.
-
-
Klicka på Save. Adobe IMS-konfigurationen skapas.
CAUTIONSkapa endast en IMS-konfiguration. Skapa inte fler än en IMS-konfiguration. -
Välj Adobe IMS-konfigurationen och klicka på Check Health. En dialogruta visas.
En Check-dialogruta visas.
-
Klicka på Check.
Meddelandet Token har hämtats visas när en anslutning har skapats.
-
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:
-
Klicka på Adobe Experience Manager > Tools> Cloud Services > Automate Forms Conversion Configuration på din AEM Forms-instans.
-
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.
-
På sidan Create Automated Forms Conversion Configuration anger du ett värde för följande fält och klickar på Next.
FältBeskrivningTitelUnik rubrik för konfigurationen. Titeln visas i användargränssnittet som används för att starta konverteringen.NamnUnikt namn för konfigurationen. Konfigurationen sparas i CRX-databasen med det angivna namnet. Namnet kan vara identiskt med titeln.MiniatyrplatsPlatsen för miniatyrbilden för konfigurationen.Tjänst-URLURL för tjänsten Automated Forms Conversion (AFCS) på Adobe Cloud. Använd URL:enhttps://aemformsconversion.adobe.io/.MallStandardmall 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.TemaStandardtema 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 segmentPlacering av befintliga fragment, om sådana finns.Anpassad metamodellSökväg till .schema.json-filen för anpassad metamodell. Du kan skapa separata metamodeller för engelska, franska, tyska, spanska, italienska och portugisiska. -
Ange värdet för följande fält på fliken Advanced på sidan Create Automated Forms Conversion Configuration:
FältBeskrivningGenerera postdokumentVä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:
{ "Type": "Principal", "Amount": "10.00", "currency": "USD" } -
Klicka på Create. Molnkonfigurationen har skapats. Din AEM Forms-instans är redo att börja konvertera äldre formulär till Adaptiv Forms.