Installera och konfigurera dokumenttjänster installing-and-configuring-document-services

AEM Forms tillhandahåller en uppsättning OSGi-tjänster för att utföra olika åtgärder på dokumentnivå, till exempel tjänster för att skapa, sammanställa, distribuera och arkivera PDF-dokument, lägga till digitala signaturer för att begränsa åtkomst till dokument samt avkoda Barcoded Forms. Dessa tjänster ingår i AEM Forms tilläggspaket. Tillsammans kallas dessa tjänster dokumenttjänster. Listan över tillgängliga dokumenttjänster och deras viktigaste funktioner är följande:

  • Assembler-tjänst: Gör att du kan kombinera, ordna om och förstärka PDF- och XDP-dokument och få information om PDF-dokument. Det hjälper även till att konvertera och validera PDF-dokument till standarden PDF/A, omformar PDF forms, XML-formulär och PDF forms till PDF/A-1b, PDF/A-2b och PDFA/A-3b. Mer information finns i Assembler Service.

  • ConvertPDF-tjänsten: Gör att du kan konvertera PDF-dokument till PostScript- eller bildfiler (JPEG, JPEG 2000, PNG och TIFF). Mer information finns i Konvertera PDF-tjänst.

  • Barcoded Forms-tjänst: Gör att du kan extrahera data från elektroniska bilder av streckkoder. Tjänsten accepterar TIFF och PDF som innehåller en eller flera streckkoder som indata och extraherar streckkodsdata. Mer information finns i Barcoded Forms Service.

  • DocAssurance-tjänsten: Gör att du kan kryptera och dekryptera dokument, utöka Adobe Reader funktioner med ytterligare användningsbehörighet och lägga till digitala signaturer i dina dokument. Tjänsten Doc Assurance innehåller tre tjänster: signatur, kryptering och läsartillägg. Mer information finns i DocAssurance-tjänsten.

  • Krypteringstjänst: Gör att du kan kryptera och dekryptera dokument. När ett dokument är krypterat blir innehållet oläsligt. En behörig användare kan dekryptera dokumentet för att få åtkomst till dess innehåll. Mer information finns i Krypteringstjänst.

  • Forms-tjänst: Gör att du kan skapa interaktiva klientprogram för datainhämtning som validerar, bearbetar, omvandlar och levererar formulär som vanligtvis skapas i Forms Designer. Forms-tjänsten återger alla formulärdesigner som du utvecklar för PDF-dokument. Mer information finns i Forms-tjänsten.

  • Utdatatjänst: Gör att du kan skapa dokument i olika format, t.ex. PDF, laserskrivarformat och etikettskrivarformat. Laserskrivarformat är PostScript och Printer Control Language (PCL). Mer information finns i Utdatatjänst.

  • PDF Generator-tjänst: Tjänsten PDF Generator tillhandahåller API:er för konvertering av ursprungliga filformat till PDF. Dessutom konverteras PDF till andra filformat och storleken på PDF-dokument optimeras. Mer information finns i PDF Generator-tjänsten.

  • Reader-tilläggstjänsten: Gör det möjligt för din organisation att enkelt dela interaktiva PDF-dokument genom att utöka funktionaliteten i Adobe Reader med ytterligare användningsbehörighet. Med tjänsten aktiveras funktioner som inte är tillgängliga när ett PDF-dokument öppnas med Adobe Reader, t.ex. för att lägga till kommentarer i ett dokument, fylla i formulär och spara dokumentet. Mer information finns i Reader-tilläggstjänsten.

  • Signaturtjänst: Gör att du kan arbeta med digitala signaturer och dokument på AEM server. Signaturtjänsten används till exempel vanligtvis i följande situationer:

    • AEM certifierar ett formulär innan det skickas till en användare för att öppnas med Acrobat eller Adobe Reader.
    • Den AEM servern validerar en signatur som har lagts till i ett formulär med Acrobat eller Adobe Reader.
    • Den AEM servern signerar ett formulär för en offentlig notarius publicus.

    Signaturtjänsten får åtkomst till certifikat och autentiseringsuppgifter som lagras i förtroendearkivet. Mer information finns i Signaturtjänst.

AEM Forms är en kraftfull plattform för större företag och dokumenttjänsterna är bara en av AEM Forms funktioner. En fullständig lista över funktioner finns i Introduktion till AEM Forms.

Distributionstopologi deployment-topology

AEM Forms tilläggspaket är ett program som distribueras till AEM. I allmänhet behöver du bara en AEM (författare eller publicerad) för att köra AEM Forms Document Services. Följande topologi rekommenderas för att köra AEM Forms Document Services. Mer information om topologier finns i Arkitektur och distributionstopologier för AEM Forms.

Arkitektur och distributionstopologier för AEM Forms

NOTE
Även om du kan använda AEM Forms för att konfigurera och köra alla funktioner från en enda server, bör du göra kapacitetsplanering, lastbalansering och konfigurera dedikerade servrar för specifika funktioner i en produktionsmiljö. I en miljö som använder tjänsten PDF Generator för att konvertera tusentals sidor om dagen och flera adaptiva formulär för att hämta in data, kan du skapa separata AEM Forms-servrar för tjänsten PDF Generator och funktioner för adaptiva formulär. Det ger optimala prestanda och skalar servrarna oberoende av varandra.

Systemkrav system-requirements

Innan du börjar installera och konfigurera AEM Forms Document Services bör du kontrollera att:

  • Maskinvaru- och programvaruinfrastruktur finns på plats. En detaljerad lista över maskinvara och programvara som stöds finns i Tekniska krav.

  • Installationssökvägen för AEM-instansen innehåller inte blanksteg.

  • En AEM-instans körs. I AEM är "instance" en kopia av AEM som körs på en server i författar- eller publiceringsläge. I allmänhet behöver du bara en AEM (författare eller publicerad) för att köra AEM Forms Document Services:

    • Författare: En AEM som används för att skapa, överföra och redigera innehåll och för att administrera webbplatsen. När innehållet är klart att publiceras replikeras det till publiceringsinstansen.
    • Publish: En AEM som skickar det publicerade innehållet till allmänheten via Internet eller ett internt nätverk.
  • Minneskraven är uppfyllda. AEM Forms tilläggspaket kräver:

    • 15 GB temporärt utrymme för Microsoft® Windows-baserade installationer.
    • 6 GB temporärt utrymme för UNIX-baserade installationer.
  • Klientprogramvara som krävs för att skapa PDF för konvertering i Microsoft® Windows och Linux® installeras:

NOTE
  • I Microsoft® Windows stöder PDF Generator konverteringsvägar för WebKit, Acrobat WebCapture och WebToPDF för att konvertera HTML-filer till PDF-dokument.
  • På UNIX-baserade operativsystem stöder PDF Generator konverteringsvägar för WebKit och WebToPDF för konvertering av HTML-filer till PDF.

Extra krav för UNIX-baserat operativsystem extrarequirements

Om du använder ett UNIX-baserat operativsystem installerar du följande 32-bitarspaket från installationsmediet för respektive operativsystem:

  • exponat
  • libxcb
  • freetype
  • libXau
  • libSM
  • zlib
  • libICE
  • libuuid
  • glibc
  • libXext
  • nss-softokn-free-bl
  • fontconfig
  • libX11
  • libXrender
  • libXrandr
  • libXinerama
  • (endast PDF Generator) Installera 32-bitarsversionen av bibliotek för libcurl, libcrypto och libssl och skapa nedanstående symboler. Symbolerna pekar på den senaste versionen av respektive bibliotek:

    • /usr/lib/libcurl.so
    • /usr/lib/libcrypto.so
    • /usr/lib/libssl.so
  • (endast PDF Generator) PDF Generator-tjänsten stöder WebKit- och WebToPDF-vägar för konvertering av HTML-filer till PDF-dokument. Installera nedanstående 64-bitarsbibliotek om du vill aktivera konvertering för WebToPDF-vägar. I allmänhet är dessa bibliotek redan installerade. Om något bibliotek saknas installerar du det manuellt:

    • linux-gate.so.1
    • libz.so.1
    • libfontconfig.so.1
    • libfreetype.so.6
    • libdl.so.2
    • librt.so.1
    • libpthread.so.0
    • libstdc++.so.6
    • libm.so.6
    • libgcc_s.so.1
    • libc.so.6
    • ld-linux.so.2
    • libexpat.so.1

Konfigurationer före installation preinstallationconfigurations

Konfigurationer som listas i avsnittet med förinstallationskonfigurationer gäller endast för tjänsten PDF Generator. Om du inte konfigurerar tjänsten PDF Generator kan du hoppa över konfigurationsavsnittet före installation.

Installera Adobe Acrobat och tredjepartsprogram install-adobe-acrobat-and-third-party-applications

Om du ska använda tjänsten PDF Generator för att konvertera inbyggda filformat som Microsoft® Word, Microsoft® Excel, Microsoft® PowerPoint, OpenOffice, WordPerfect X7 och Adobe Acrobat till PDF-dokument måste du kontrollera att dessa program är installerade på AEM Forms Server.

NOTE
  • Om din AEM Forms-server är offline eller i en säker miljö och Internet inte är tillgängligt för att aktivera Adobe Acrobat finns mer information i Offlineaktivering om hur du aktiverar sådana instanser av Adobe Acrobat.
  • Adobe Acrobat, Microsoft® Word, Excel och PowerPoint finns endast för Microsoft® Windows. Om du använder det UNIX-baserade operativsystemet måste du installera OpenOffice för att konvertera RTF-filer och Microsoft® Office-filer som stöds till PDF-dokument.
  • Stäng alla dialogrutor som visas när du har installerat Adobe Acrobat och tredjepartsprogram för alla användare som har konfigurerats att använda tjänsten PDF Generator.
  • Starta alla installerade program minst en gång. Stäng alla dialogrutor för alla användare som har konfigurerats att använda tjänsten PDF Generator.
  • Kontrollera förfallodatumet för dina Adobe Acrobat-serienummer och ange ett datum för att uppdatera licensen eller migrera ditt serienummer baserat på förfallodatumet.

När du har installerat Acrobat öppnar du Microsoft® Word. På fliken Acrobat klickar du på Skapa PDF och konverterar en .doc- eller .docx-fil som finns på datorn till ett PDF-dokument. Om konverteringen lyckas är AEM Forms redo att använda Acrobat tillsammans med PDF Generator.

Konfigurera miljövariabler setup-environment-variables

Ange miljövariabler för 64-bitars Java Development Kit, tredjepartsprogram och Adobe Acrobat. Miljövariablerna ska innehålla den absoluta sökvägen för den körbara fil som används för att starta motsvarande program, till exempel visas miljövariabler för ett fåtal program i tabellen nedan:

Program
Miljövariabel
Exempel
JDK (64-bitars)
JAVA_HOME
C:\Program Files\Java\jdk1.8.0_74
Adobe Acrobat
Acrobat_PATH
C:\Program filer (x86)\Adobe\Acrobat 2015\Acrobat\Acrobat.exe
Anteckningar
Notepad_PATH
C:\WINDOWS\notepad.exe
OpenOffice
OpenOffice_PATH
C:\Program filer (x86)\OpenOffice.org4
NOTE
  • Alla miljövariabler och respektive sökvägar är skiftlägeskänsliga.

  • JAVA_HOME och Acrobat_PATH (endast Windows) är obligatoriska miljövariabler.

  • Miljövariabeln OpenOffice_PATH ställs in på installationsmappen i stället för på sökvägen till den körbara filen.

  • Ställ inte in miljövariabler för Microsoft® Office-program som Word, PowerPoint, Excel och Project, eller för AutoCAD. Om dessa program är installerade på servern startar tjänsten Generate PDF automatiskt dessa program.

  • Installera OpenOffice som /root på UNIX-baserade plattformar. Om OpenOffice inte är installerat som rot kan tjänsten PDF Generator inte konvertera OpenOffice-dokument till PDF-dokument. Om du måste installera och köra OpenOffice som en icke-rotanvändare anger du sudo-rättigheter till användaren som inte är rotanvändare.

  • Om du använder OpenOffice på en UNIX-baserad plattform kör du följande kommando för att ange variabeln path:

    export OpenOffice_PATH=/opt/openoffice.org4

(Endast för IBM® WebSphere®) Konfigurera IBM® SSL-socketleverantör only-for-ibm-websphere-configure-ibm-ssl-socket-provider

Utför följande steg för att konfigurera IBM® SSL-socketprovidern:

  1. Skapa en kopia av filen java.security. Standardplatsen för filen är [WebSphere_installation_directory]\Appserver\java_[version]\jre\lib\security.

  2. Öppna den kopierade java.security-filen för redigering.

  3. Ändra standardfabrikerna för SSL-socket så att de använder JSSE2-fabrikerna i stället för standardfabrikerna i IBM® WebSphere®:

    Standardinnehåll:

    code language-shell
    #ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImpl
    #ssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl
    #WebSphere socket factories (in cryptosf.jar)
    ssl.SocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLSocketFactory
    ssl.ServerSocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLServerSocketFactory
    

    Ändrat innehåll:

    code language-shell
    ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImpl
    ssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl
    
    #WebSphere socket factories (in cryptosf.jar)
    #ssl.SocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLSocketFactory
    #ssl.ServerSocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLServerSocketFactory
    
  4. Om du vill att AEM Forms Server ska kunna använda den uppdaterade java.security-filen när AEM Forms-servern startas lägger du till följande java-argument:

    -Djava.security.properties= [path of newly created Java.security file].

(Endast Windows) Konfigurera filblocksinställningarna för Microsoft® Office configure-the-file-block-settings-for-microsoft-office

Ändra inställningarna för Microsoft® Office Trust Center så att tjänsten PDF Generator kan konvertera filer som skapats med äldre versioner av Microsoft® Office.

  1. Öppna ett Microsoft® Office-program. Exempel: Microsoft® Word. Navigera till File> Options. Dialogrutan Alternativ visas.

  2. Klicka på Trust Center och sedan på Trust Center Settings.

  3. Klicka på File Block Settings i Trust Center settings.

  4. I listan File Type avmarkerar du Open för den filtyp som tjänsten PDF Generator ska kunna konvertera till PDF-dokument.

(Endast Windows) Bevilja privilegiet Ersätt en token på processnivå grant-the-replace-a-process-level-token-privilege

Användarkontot som används för att starta programservern kräver privilegiet Ersätt en token på processnivå. Det lokala systemkontot har behörigheten Ersätt en token på processnivå som standard. För servrar som körs med en användare i gruppen Lokala administratörer måste privilegiet ges uttryckligen. Utför följande steg för att bevilja privilegiet:

  1. Öppna Group Policy Editor för Microsoft® Windows. Om du vill öppna grupprincipredigeraren klickar du på Start, skriver gpedit.msc i rutan Starta sökning och klickar på Group Policy Editor.
  2. Navigera till Local Computer Policy > Computer Configuration > Windows Settings > Security Settings > Local Policies > User Rights Assignment och redigera Replace a process level token-principen och inkludera gruppen Administratörer.
  3. Lägg till användaren i posten Ersätt en processnivåtoken.
NOTE
Om AEM körs som en tjänst under LocalSystem-kontot (LSA) är det inte nödvändigt att uttryckligen tilldela detta privilegium till en användare, vilket anges ovan.

(Endast Windows) Aktivera tjänsten PDF Generator för icke-administratörer enable-the-pdf-generator-service-for-non-administrators

Du kan göra det möjligt för en icke-administratörsanvändare att använda tjänsten PDF Generator. Normalt kan endast användare med administratörsbehörighet använda tjänsten:

  1. Skapa en miljövariabel, PDFG_NON_ADMIN_ENABLED.
  2. Ange värdet för miljövariabeln till TRUE.
  3. Starta om AEM Forms.
NOTE
Du bör använda kommandot Ctrl + C för att starta om SDK:n. Om du startar om AEM SDK med alternativa metoder, till exempel genom att stoppa Java-processer, kan det leda till inkonsekvenser i den AEM utvecklingsmiljön.

(Endast Windows) Inaktivera Kontroll av användarkonto (UAC) disable-user-account-control-uac

  1. Gå till Start > Run och ange MSCONFIG om du vill komma åt systemkonfigurationsverktyget.

  2. Klicka på fliken Tools, rulla nedåt och välj Change UAC Settings. Klicka på Launch om du vill köra kommandot i ett nytt fönster.

  3. Justera skjutreglaget till nivån för Aldrig meddelande. När du är klar stänger du kommandofönstret och stänger fönstret Systemkonfiguration.

  4. Kontrollera att registerinställningen för UAC är inställd på 0 (noll). Verifiera genom att utföra följande steg:

    1. Microsoft® rekommenderar att du säkerhetskopierar registret innan du ändrar det. Detaljerade steg finns i Säkerhetskopiera och återställa registret i Windows.
    2. Öppna Registereditorn i Microsoft® Windows. Öppna Registereditorn genom att gå till Start > Kör, skriva regedit och klicka på OK.
    3. Navigera till HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\. Kontrollera att värdet för EnableLUA är 0 (noll).
    4. Kontrollera att värdet för EnableLUA är 0 (noll). Om värdet inte är 0 ändrar du värdet till 0. Stäng Registereditorn.
  5. Starta om datorn.

(Endast Windows) Inaktivera felrapporteringstjänsten disable-error-reporting-service

När ett dokument konverteras till PDF med tjänsten PDF Generator på Windows Server rapporteras ibland om att den körbara filen har stött på ett problem och måste stängas. Den påverkar dock inte konverteringen av PDF eftersom den fortsätter i bakgrunden.

Du kan undvika att få felmeddelanden genom att inaktivera Windows-felrapportering. Mer information om hur du inaktiverar felrapportering finns i https://technet.microsoft.com/en-us/library/cc754364.aspx.

(Endast Windows) Konfigurera konvertering från HTML till PDF configure-html-to-pdf-conversion

Tjänsten PDF Generator tillhandahåller vägar eller metoder för WebKit, WebCapture och WebToPDF för att konvertera HTML-filer till PDF-dokument. Om du vill aktivera konvertering för WebKit- och Acrobat WebCapture-vägar i Windows kopierar du Unicode-teckensnittet till katalogen %windir%\fonts.

NOTE
När du installerar nya teckensnitt i teckensnittsmappen startar du om AEM Forms-instansen.

(Endast UNIX-baserade plattformar) Extra konfigurationer för konvertering från HTML till PDF extra-configurations-for-html-to-pdf-conversion

På UNIX-baserade plattformar har PDF Generator-tjänsten stöd för WebKit- och WebToPDF-vägar för konvertering av HTML-filer till PDF. Om du vill aktivera konvertering från HTML till PDF ska du göra följande konfigurationer som passar din önskade konverteringsväg:

(Endast UNIX-baserade plattformar) Aktivera stöd för Unicode-teckensnitt (endast WebKit) enable-support-for-unicode-fonts-webkit-only

Kopiera Unicode-teckensnittet till någon av följande kataloger som passar ditt system:

  • /usr/lib/X11/fonts/TrueType
  • /usr/share/fonts/default/TrueType
  • /usr/X11R6/lib/X11/fonts/ttf
  • /usr/X11R6/lib/X11/fonts/TrueType
  • /usr/X11R6/lib/X11/fonts/TrueType
  • /usr/X11R6/lib/X11/fonts/TTF
  • /usr/openwin/lib/X11/fonts/TrueType (Solaris™)
NOTE
  • I Red Hat® Enterprise Linux® 6.x och senare finns inte Courier-teckensnitt tillgängliga. Hämta arkivet font-ibm-type1-1.0.3.zip för att installera teckensnittet Courier. Extrahera arkivet på /usr/share/fonts. Skapa en symbolisk länk från /usr/share/X11/fonts till /usr/share/fonts.
  • Ta bort alla .lst-teckensnittscachefiler från katalogerna Html2PdfSvc/bin och /usr/share/fonts.
  • Kontrollera att katalogerna /usr/lib/X11/fonts och /usr/share/fonts finns. Om katalogerna inte finns använder du ln-kommandot för att skapa en symbolisk länk från /usr/share/X11/fonts till /usr/lib/X11/fonts och en annan symbolisk länk från /usr/share/fonts till /usr/share/X11/fonts. Se även till att teckensnitten finns på /usr/lib/X11/fonts.
  • Kontrollera att alla teckensnitt (Unicode och icke-unicode) är tillgängliga i katalogen /usr/share/fonts eller /usr/share/X11/fonts.
  • När du kör PDF Generator som en icke-rotanvändare ska du ge icke-rotanvändaren läs- och skrivåtkomst till alla teckensnittskataloger.
  • När du installerar nya teckensnitt i teckensnittsmappen startar du om AEM Forms-instansen.

Installera AEM Forms-tilläggspaket install-aem-forms-add-on-package

AEM Forms tilläggspaket är ett program som distribueras till AEM. Paketet innehåller AEM Forms Document Services och andra AEM Forms-funktioner. Så här installerar du paketet:

  1. Öppna Programvarudistribution. Du behöver en Adobe ID för att logga in på Software Distribution.

  2. Välj Adobe Experience Manager som finns på rubrikmenyn.

  3. I avsnittet Filters:

    1. Välj Forms i listrutan Solution.
    2. Välj version och typ för paketet. Du kan också använda alternativet Search Downloads för att filtrera resultaten.
  4. Välj det paketnamn som gäller för ditt operativsystem, välj Accept EULA Terms och välj Download.

  5. Öppna Pakethanteraren och klicka på Upload Package för att överföra paketet.

  6. Markera paketet och klicka på Install.

    Du kan även hämta paketet via den direktlänk som visas i artikeln AEM Forms-utgåvor.

  7. När paketet har installerats uppmanas du att starta om AEM. Stoppa inte servern omedelbart. Innan du stoppar AEM Forms Server väntar du tills ServiceEvent REGISTERED- och ServiceEvent UNREGISTERED-meddelandena inte längre visas i filen [AEM-Installation-Directory]/crx-quickstart/logs/error.log och loggen är stabil.

Post-installationskonfigurationer post-installation-configurations

Konfigurera Boot Delegation för RSA/BouncyCastle-bibliotek configure-boot-delegation-for-rsa-bouncycastle-libraries

  1. Stoppa AEM. Navigera till mappen [AEM installationskatalogen]\crx-quickstart\conf. Öppna filen sling.properties för redigering.

    Om du använder [AEM installation directory]\crx-quickstart\bin\start.bat för att starta en AEM ska du redigera sling.properties som finns på [AEM_root]\crx-quickstart\.

  2. Lägg till följande egenskaper i filen sling.properties:

    code language-shell
    sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
    
  3. (Endast AIX®) Lägg till följande egenskaper i filen sling.properties:

    code language-shell
    sling.bootdelegation.xerces=org.apache.xerces.*
    
  4. Spara och stäng filen.

Konfigurera teckensnittshanterartjänsten configuring-the-font-manager-service

  1. Logga in på AEM Configuration Manager som administratör.

  2. Leta reda på och öppna tjänsten CQ-DAM-Handler-Gibson Font Managers. Ange sökvägen till katalogerna System Fonts, Adobe Server Fonts och Customer Fonts. Klicka på Save.

    note note
    NOTE
    Din rätt att använda teckensnitt som tillhandahålls av andra parter än Adobe regleras av de licensavtal som dessa parter ger dig med dessa teckensnitt och omfattas inte av din licens att använda Adobe. Adobe rekommenderar att du granskar och ser till att du följer alla tillämpliga licensavtal som inte är Adobe innan du använder teckensnitt som inte är Adobe med Adobe, särskilt när det gäller användning av teckensnitt i servermiljöer.
    När du installerar nya teckensnitt i teckensnittsmappen startar du om AEM Forms-instansen.

Konfigurera ett lokalt användarkonto för att köra tjänsten PDF Generator configure-a-local-user-account-to-run-the-pdf-generator-service

Det krävs ett lokalt användarkonto för att köra tjänsten PDF Generator. Anvisningar om hur du skapar en lokal användare finns i Skapa ett användarkonto i Windows eller skapa ett användarkonto på UNIX-baserade plattformar.

  1. Öppna sidan Konfiguration i AEM Forms PDF Generator.

  2. Ange autentiseringsuppgifter för ett lokalt användarkonto på fliken User Accounts och klicka på Submit. Tillåt åtkomst till användaren om du uppmanas att göra det i Microsoft® Windows. När den konfigurerade användaren läggs till visas den under avsnittet Your user accounts på fliken User Accounts.

Konfigurera timeout-inställningar configure-the-time-out-settings

  1. I AEM konfigurationshanteraren letar du reda på och öppnar tjänsten Jacorb ORB Provider.

    Lägg till följande i fältet Custom Properties.name och klicka på Save. Tidsgränsen för väntande svar (kallas även CORBA-klienttimeout) anges till 600 sekunder.

    jacorb.connection.client.pending_reply_timeout=600000

  2. Logga in på AEM författarinstans och navigera till Adobe Experience Manager > Tools > Forms > Configure PDF Generator. Standardwebbadressen är http://localhost:4502/libs/fd/pdfg/config/ui.html.

    Öppna fliken General Configuration och ändra värdet för följande fält för din miljö:

Fält
Beskrivning
Standardvärde
Timeout för serverkonvertering
En PDFG-konvertering förblir aktiv i det antal sekunder som anges i tidsgränsen för serverkonvertering
270 sekunder
Sekunder för PDFG-rensningsgenomsökning
Antalet sekunder som krävs för att utföra efterkonverteringsåtgärder.
3 600 sekunder
Utgångsdatum i sekunder för jobb
Varaktighet som tjänsten PDF Generator får utföra en konvertering för. Kontrollera att värdet för Sekunder för jobbförfallodatum är större än värdet för PDFG-rensningsgenomsökning.
7 200 sekunder

(Endast Windows) Konfigurera Acrobat för tjänsten PDF Generator configure-acrobat-for-the-pdf-generator-service

I Microsoft® Windows används Adobe Acrobat för att konvertera de filformat som stöds till ett PDF-dokument. Så här konfigurerar du Adobe Acrobat för tjänsten PDF Generator:

  1. Öppna Acrobat och välj Edit> Preferences> Updater. I Leta efter uppdateringar avmarkerar du Automatically install updates och klickar på OK. Stäng Acrobat.

  2. Dubbelklicka på ett PDF-dokument på datorn. När Acrobat startas för första gången visas dialogrutorna för inloggning, välkomstskärm och licensavtal. Stäng de här dialogrutorna för alla användare som har konfigurerats att använda PDF Generator.

  3. Kör batchfilen för verktyget PDF Generator för att konfigurera Acrobat för tjänsten PDF Generator:

    1. Öppna AEM Package Manager och hämta filen adobe-aemfd-pdfg-common-pkg-[version].zip från Package Manager.

    2. Zippa upp den hämtade ZIP-filen. Öppna kommandotolken med administratörsbehörighet.

    3. Navigera till [extracted-zip-file]\jcr_root\etc\packages\day\cq60\fd\adobe-aemds-common-pkg-[version]\jcr_root\etc\packages\day\cq60\fd\

    4. Zippa upp adobe-aemfd-pdfg-common-pkg-[version].

    5. Navigera till katalogen [downloaded-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]. Kör följande kommandofil:

      Acrobat_for_PDFG_Configuration.bat

      Acrobat är konfigurerat att köras med tjänsten PDF Generator.

  4. Kör Systemberedskapsverktygetför att validera Acrobat-installationen.

(Endast Windows) Konfigurera primär väg för konvertering från HTML till PDF configure-primary-route-for-html-to-pdf-conversion-windows-only

Tjänsten PDF Generator erbjuder flera vägar för att konvertera HTML-filer till PDF-dokument: Webkit, Acrobat WebCapture (endast Windows) och WebToPDF. Adobe rekommenderar att WebToPDF-vägen används eftersom den kan hantera dynamiskt innehåll och inte är beroende av 32-bitars bibliotek eller inte kräver några extra teckensnitt. WebToPDF-flödet kräver inte heller sudo- eller root-åtkomst för att köra konverteringen.

Den primära standardvägen för konvertering från HTML till PDF är Webkit. Så här ändrar du konverteringsflödet:

  1. Navigera AEM författarinstansen till Tools> Forms> Configure PDF Generator.

  2. Välj önskad konverteringsväg i listrutan Primary Route for HTML to PDF conversions på fliken General Configuration.

Initiera Global Trust Store intialize-global-trust-store

Med pålitlighetslagerhanteringen kan du importera, redigera och ta bort certifikat som du litar på på servern för validering av digitala signaturer och certifikatautentisering. Du kan importera och exportera valfritt antal certifikat. När ett certifikat har importerats kan du redigera pålitlighetsinställningarna och förtroendearkivets typ. Så här initierar du ett förtroendearkiv:

  1. Logga in på AEM Forms-instansen som administratör.
  2. Gå till Tools > Security > Trust Store.
  3. Klicka på Create TrustStore. Ange lösenord och välj Save.

Konfigurera certifikat för Reader-tilläggs- och krypteringstjänsten set-up-certificates-for-reader-extension-and-encryption-service

DocAssurance-tjänsten kan tillämpa användarrättigheter på PDF-dokument. Konfigurera certifikaten om du vill tillämpa användarrättigheter på PDF-dokument.

Innan du konfigurerar certifikaten bör du kontrollera att du har en:

  • Certifikatfil (.pfx).

  • Lösenordet för den privata nyckeln som tillhandahålls med certifikatet.

  • Alias för privat nyckel. Du kan köra kommandot för Java-nyckelverktyget för att visa alias för den privata nyckeln:
    keytool -list -v -keystore [keystore-file] -storetype pkcs12

  • Lösenord för nyckelbehållarfil. Om du använder certifikatet för Adobe Reader Extensions är lösenordet för nyckelfilen alltid detsamma som lösenordet för den privata nyckeln.

Utför följande steg för att konfigurera certifikaten:

  1. Logga in AEM författarinstansen som administratör. Gå till Tools > Security > Users.

  2. Klicka på fältet name för användarkontot. Sidan Edit User Settings öppnas. I AEM Author-instansen finns certifikat i en KeyStore. Om du inte har skapat en KeyStore tidigare klickar du på Create KeyStore och anger ett nytt lösenord för KeyStore. Om servern redan innehåller en KeyStore hoppar du över det här steget. Om du använder certifikatet för Adobe Reader Extensions är lösenordet för nyckelfilen alltid detsamma som lösenordet för den privata nyckeln.

  3. Välj fliken KeyStore på sidan Edit User Settings. Expandera alternativet Add Private Key from Key Store file och ange ett alias. Aliaset används för att utföra Reader-tilläggsåtgärden.

  4. Om du vill överföra certifikatfilen klickar du på Select Key Store File och överför en <filnamn>.pfx-fil.

    Lägg till Key Store Password, Private Key Password och Private Key Alias som är associerad med certifikatet till respektive fält. Klicka på Submit.

    note note
    NOTE
    I produktionsmiljön ersätter du dina utvärderingsreferenser med produktionsuppgifter. Se till att du tar bort dina gamla inloggningsuppgifter för Reader Extensions innan du uppdaterar en inloggningsuppgift som har gått ut eller utvärderar den.
  5. Klicka på Save & Close på sidan Edit User Settings.

Aktivera AES-256 enable-aes

Om du vill använda AES 256-kryptering för PDF-filer hämtar och installerar du Java Cryptography Extension (JCE) Unlimited Strength Jurisdential Policy-filer. Ersätt filerna local_policy.jar och US_export_policy.jar i mappen jre/lib/security. Om du till exempel använder Sun JDK kopierar du de hämtade filerna till mappen [JAVA_HOME]/jre/lib/security.

Assembler-tjänsten är beroende av tjänsten Reader Extensions, tjänsten Signature, Forms och Output. Utför följande steg för att verifiera att de tjänster som krävs är igång:

  1. Logga in på URL https://'[server]:[port]'/system/console/bundles som administratör.
  2. Sök i följande tjänst och kontrollera att tjänsterna körs:
Tjänstnamn
Paketnamn
Signaturtjänst
adobe-aemfd-signatures
Tjänsten Reader Extensions
com.adobe.aemfd.adobe-aemfd-readerextensions
Forms Service
com.adobe.livecycle.adobe-lc-forms-bedrock-connector
Output Service
com.adobe.livecycle.adobe-lc-forms-bedrock-connector

(Endast Windows) Konfigurera registerpost för Microsoft® Project configure-registry-entry-for-microsoft-project

När du har installerat AEM Forms-tillägget och Microsoft® Project på datorn registrerar du ett bidrag för Microsoft® Project på 64-bitarsplatsen. Det underlättar körning av konverteringstester för Project till PDFG. Följande steg beskriver processen för registerposten:

  1. Öppna Registereditorn för Microsoft® Windows (regedit), öppna Registereditorn, gå till Start > Kör, skriv regedit och klicka på OK.
  2. Navigera till Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Adobe\Acrobat PDFMaker\<version>\Office\SupportedApp och skapa ett nytt binärt värderegister och byt namn på det till Projekt.
  3. Ändra datavärdet för det skapade binära registret till 01 och klicka på OK.
  4. Stäng registerposten.

Kända fel och felsökning known-issues-and-troubleshooting

  • Konverteringen från HTML till PDF misslyckas om en ZIP-indatafil innehåller HTML-filer med dubbelbytetecken i filnamn. Undvik det här problemet genom att inte använda dubbelbytetecken när du namnger HTML-filer.

  • På UNIX-baserade operativsystem gör du följande för att hitta bibliotek som saknas:

  1. Navigera till [crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/.

  2. Kör följande kommando för att lista alla bibliotek som WebToPDF kräver för konvertering från HTML till PDF.

    ldd phantomjs

    Kör följande kommando för att lista saknade bibliotek.

    ldd phantomjs | grep not

  3. Installera de saknade biblioteken manuellt.

Systemberedskap (SRT) SRT

Verktyget Systemberedskap kontrollerar om datorn är korrekt konfigurerad för att köra PDF Generator-konverteringar. Verktyget genererar en rapport vid den angivna sökvägen. Så här kör du verktyget:

  1. Öppna kommandotolken. Navigera till mappen [extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools.

  2. Kör följande kommando från kommandotolken:

    java -jar forms-srt-[version].jar [Path_of_reports_folder] en

    Kommandot genererar en rapport och skapar även filen srt_config.yaml. Du kan använda den för att konfigurera alternativ för SRT-verktyget. Det är valfritt att konfigurera alternativ för SRT-verktyget.

    note note
    NOTE
    • Om systemberedskapsverktyget rapporterar att filen pdfgen.api inte är tillgänglig i Acrobat plug-ins-mappen kopierar du filen pdfgen.api från katalogen [extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]\plugins\x86_win32 till katalogen [Acrobat_root]\Acrobat\plug_ins.
  3. Navigera till [Path_of_reports_folder]. Öppna filen SystemReadinessTool.html. Verifiera rapporten och åtgärda problemen.

Konfigurera alternativ för SRT-verktyget srt-configuration

Du kan använda filen srt_config.yaml för att konfigurera olika inställningar för SRT-verktyget. Filformatet är:

   # =================================================================
   # SRT Configuration
   # =================================================================
   #Note - follow correct format to avoid parsing failures
   #for example, <param name>:<space><param value>
   #locale: (mandatory field)Locale to be used for SRT. Supported locales [en/fr/de/ja].
   locale: en

   #aemTempDir: AEM Temp direcotry
   aemTempDir:

   #users: provide PDFG converting users list
   #users:
   # - user1
   # - user2
   users:

   #profile: select profile to run specific checks. Choose from [LCM], more will be added soon
   profile:

   #outputDir: directory where output files will be saved
   outputDir:
  • Språk: Det är en obligatorisk parameter. Det har stöd för engelska (en), tyska (de), franska (fr) och japanska (ja). Standardvärdet är en. Det påverkar inte PDF Generator tjänster som körs på AEM Forms i OSGi.
  • aemTempDir: Det är en valfri parameter. Den anger tillfällig lagringsplats för Adobe Experience Manager.
  • användare: Det är en valfri parameter. Du kan ange en användare som ska kontrollera om användaren har nödvändig behörighet och läs-/skrivåtkomst för kataloger som krävs för att köra PDF Generator. Om ingen användare anges hoppas användarspecifika kontroller över och visas som misslyckade i rapporten.
  • outputDir: Ange platsen där SRT-rapporten ska sparas. Standardplatsen är den aktuella arbetskatalogen för SRT-verktyget.

Felsökning

Om du får problem även efter att du har åtgärdat alla problem som rapporterats av SRT-verktyget utför du följande kontroller:

Kontrollera att Systemberedskapsverktyget inte rapporterar något fel innan du utför följande kontroller.

Adobe Acrobat
  • Kontrollera att endast version av Microsoft® Office (32-bitars) och Adobe Acrobat som stöds är installerade och att dialogrutorna för att öppna är avbrutna.
  • Kontrollera att Adobe Acrobat Update Service är inaktiverad.
  • Kontrollera att gruppfilen Acrobat_for_PDFG_Configuration.bat kördes med administratörsbehörighet.
  • Se till att en PDF Generator-användare läggs till i användargränssnittet för PDF-konfigurationen.
  • Kontrollera att behörigheten Ersätt en token på processnivå har lagts till för PDF Generator-användaren.
  • Kontrollera att Office COM-tillägget för Acrobat PDFMaker är aktiverat för Microsoft Office-program.
OpenOffice

Microsoft® Windows

  • Kontrollera att 32-bitars version av Microsoft Office som stöds är installerad och att dialogrutorna för att öppna är avbrutna för alla program.

  • Se till att en PDF Generator-användare läggs till i användargränssnittet för PDF-konfigurationen.

  • Kontrollera att PDF Generator-användaren är medlem i en administratörsgrupp och att privilegiet Ersätt en token för processnivå har angetts för användaren.

  • Se till att användaren är konfigurerad i användargränssnittet i PDF Generator och utför följande åtgärder:

    1. Logga in på Microsoft® Windows med PDF Generator.
    2. Öppna Microsoft® Office- eller OpenOffice-program och avbryt alla dialogrutor.
    3. Ange Adobe PDF som standardskrivare.
    4. Ange Acrobat som standardprogram för PDF-filer.
    5. Utför manuell konvertering med menyalternativet Arkiv > Skriv ut och Acrobat i Microsoft Office-program och avbryt alla dialogrutor.
    6. Avsluta alla konverteringsprocesser som winword.exe, powerpoint.exe och excel.exe.
    7. Starta om AEM Forms Server.

Linux®

  • Installera den version av OpenOffice som stöds. AEM Forms stöder både 32- och 64-bitarsversioner. När du har installerat öppnar du alla OpenOffice-program, avbryter alla dialogrutor och stänger programmen. Öppna programmen igen och se till att ingen dialogruta visas när du öppnar ett OpenOffice-program.

  • Skapa en miljövariabel OpenOffice_PATH och ställ in den så att den pekar på OpenOffice-installationen anges i console - eller dt-profilen (enhetsträd).

  • Om det uppstår problem när du installerar OpenOffice kontrollerar du att 32-bitars bibliotek som krävs för OpenOffice-installation är tillgängliga.

HTML till konverteringsproblem i PDF
  • Se till att teckensnittskataloger läggs till i användargränssnittet för PDF Generator config.

Linux och Solaris (WebToPDF-konverteringsflöde)

  • Kontrollera att det finns ett 32-bitars bibliotek (libicudata.so.42) för Webkit-baserad HTMLToPDF-konvertering och att det finns 64-bitars (libicudata.so.42 libs för WebToPDF-baserad HTMLToPDF-konvertering.

  • Kör följande kommando för att lista saknade bibliotek för WebToPDF:

    code language-none
    ldd phantomjs | grep not
    

Linux® och Solaris™ (WebKit-konverteringsväg)

  • Kontrollera att katalogerna /usr/lib/X11/fonts och /usr/share/fonts finns. Om katalogerna inte finns skapar du en symbolisk länk från /usr/share/X11/fonts till /usr/lib/X11/fonts och en annan symbolisk länk från /usr/share/fonts till /usr/share/X11/fonts.

    code language-none
    ln -s /usr/share/fonts /usr/share/X11/fonts
    
    ln -s /usr/share/X11/fonts /usr/lib/X11/fonts
    
  • Se till att IBM-teckensnitt kopieras under användare/resurs/teckensnitt.

  • Kontrollera att glibc för att åtgärda spöksårbarheter finns på datorn. Använd din standardpakethanterare för att uppdatera till den senaste versionen av glibc. Det innehåller åtgärder för att åtgärda spöksårbarheter.

  • Kontrollera att de senaste versionerna av 32-bitars lib curl-, libcrypto- och libssl-bibliotek är installerade på datorn. Skapa också symbolerna /usr/lib/libcurl.so (eller libcurl.a för AIX®), /usr/lib/libcrypto.so (eller libcrypto.a för AIX®) och /usr/lib/libssl.so (eller libssl.a för AIX®) som pekar på de senaste versionerna (32 bitar) av respektive bibliotek.

  • Utför följande steg för IBM® SSL Socket Provider:

    1. Kopiera java.security-filen från <WAS_Installed_JAVA>\jre\lib\security till valfri plats på din AEM Forms-server. Standardplatsen är Standardplats = <WAS_Installed>\Appserver\java_[version]\jre\lib\security.

    2. Redigera java.security-filen på den kopierade platsen och ändra standardfabrikerna för SSL Socket med JSSE2-fabriker (använd JSSE2-fabriker i stället för WebSphere®).

      Ändra följande standardsocketfabriker för JSSE:

      code language-none
      #ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImpl
      #ssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl
      WebSphere socket factories (in cryptosf.jar)
      ssl.SocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLSocketFactory
      ssl.ServerSocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLServerSocketFactory
      

      med

      code language-none
      ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImpl
      ssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl
      WebSphere socket factories (in cryptosf.jar)
      #ssl.SocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLSocketFactory
      #ssl.ServerSocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLServerSocketFactory
      
Det går inte att lägga till en PDF Generator-användare (PDFG)
  • Kontrollera att omdistribuerbara Microsoft® Visual C++ 2012 x86 och Microsoft® Visual C++ 2013 x86 (32-bitars) är installerade på Windows.
Fel vid automatiseringstest
  • För Microsoft® Office och OpenOffice utför du minst en konvertering manuellt (som varje användare) för att säkerställa att ingen dialogruta öppnas under konverteringen. Om någon dialogruta visas, stänger du den. Ingen sådan dialogruta ska visas vid automatisk konvertering.

  • Kontrollera att testpaketet är installerat och aktivt innan du kör automatisering på en AEM Forms i OSGi-miljö.

Flera användarkonverteringsfel
  • Kontrollera serverloggarna för att kontrollera om konverteringen misslyckas för en viss användare.(Process Explorer kan hjälpa dig att kontrollera processen för olika användare)

  • Kontrollera att den användare som konfigurerats för PDF Generator har lokala administratörsrättigheter.

  • Kontrollera att PDF Generator har läs-, skriv- och körbehörighet för tillfälliga LC- och PDFG-användare.

  • För Microsoft® Office och OpenOffice utför du minst en konvertering manuellt (som varje användare) för att säkerställa att ingen dialogruta öppnas under konverteringen. Om någon dialogruta visas, stänger du den. Ingen sådan dialogruta ska visas vid automatisk konvertering.

  • Utför en exempelkonvertering.

Licensen för Adobe Acrobat som är installerad på AEM Forms Server upphör att gälla
  • Om du har en befintlig licens för Adobe Acrobat och den har upphört att gälla Ladda ned den senaste versionen av Adobe Application Manager och migrera ditt serienummer. Innan du migrerar ditt serienummer.

    • Använd följande kommandon för att generera prov.xml och serialisera om den befintliga installationen med prov.xml-filen i stället för kommandona i migrera serienummerartikeln.

      code language-none
      &quot;
      
      adobe_prtk —tool=VolumeSerialize —generate —serial=&lt;serialnum> [—leid=&lt;LEID>] [—regsuppress=ss] [—eulasuppress] [—locales=limited list of locales in xx_XX format or ALL>] [—provfile=&lt;Absolute path to prov.xml>]&lbrace;2&quot;
      
    • Volymserialisera paketet (serialisera om den befintliga installationen med prov.xml-filen och den nya serienumret): Kör följande kommando från PRTK-installationsmappen som administratör för att serialisera och aktivera distribuerade paket på klientdatorer:

      code language-none
      &quot;
      adobe_prtk —tool=VolumeSerialize —provfile=C:\prov.xml -stream
      
      &quot;
      
  • Vid storskaliga installationer använder du Acrobat Customization Wizard för att ta bort tidigare versioner av Reader och Acrobat. Anpassa installationsprogrammet och distribuera det till alla datorer i organisationen.

AEM Forms Server är offline eller säker och Internet är inte tillgängligt för att aktivera Acrobat.
  • Du kan gå online inom 7 dagar efter det att du startat Adobe för att slutföra aktiveringen och registreringen online eller använda en internetaktiverad enhet och produktens serienummer för att slutföra processen. Mer information finns i Aktivering offline.
Det går inte att konvertera Word- eller Excel-filen till PDF på Windows Server

När en användare försöker konvertera Word- eller Excel-filer till PDF på Microsoft Windows Server, uppstår följande fel:

Felmeddelande från den primära konverteraren:
ALC-PDG-015-003-Systemet kan inte öppna indatafilen. Skicka filen igen eller kontakta systemadministratören.

Information om hur du löser problemet finns i Det går inte att konvertera Word- eller Excel-filen till PDF på Windows Server.

Det går inte att konvertera Excel-filer till PDF på Windows Server 2019

När du konverterar Microsoft Excel 2019 till PDF på Microsoft Windows Server 2019 måste du se till följande:

  • När du använder tjänsten PDF Generator bör din Windows-dator inte ha någon aktiv fjärranslutning till AEM (Windows RDP-session).

  • Standardskrivaren måste ställas in på Adobe PDF.

    note note
    NOTE
    • För Apple macOS och Ubuntu OS behöver du inte konfigurera de ovannämnda inställningarna.
Det går inte att konvertera XPS-filer till PDF
Du löser problemet genom att skapa en funktionsspecifik registernyckel i Windows.

Nästa steg next-steps

Du har en fungerande AEM Forms Document Services-miljö. Du kan använda dokumenttjänster genom att:

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2