文件AEM 6.5使用手冊

安裝和設定檔案服務 installing-and-configuring-document-services

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • undefined
  • undefined
  • undefined

AEM Forms提供了一組OSGi服務，用於完成不同的檔案層級作業，例如，建立、彙編、散發和封存PDF檔案的服務、新增數位簽名以限制對檔案的存取，以及解碼條碼式Forms的服務。 這些服務包含在AEM Forms附加元件套件中。 這些服務統稱為檔案服務。 可用檔案服務及其主要功能的清單如下：

  • 組合器服務： ​可讓您組合、重新排列和增加PDF和XDP檔案，並取得有關PDF檔案的資訊。 它還有助於將PDF檔案轉換和驗證為PDF/A標準，將PDF forms、XML表單和PDF forms轉換為PDF/A-1b、PDF/A-2b和PDFA/A-3b。 如需詳細資訊，請參閱組合器服務。

  • ConvertPDF服務： ​可讓您將PDF檔案轉換為PostScript或影像檔案(JPEG、JPEG2000、PNG和TIFF)。 如需詳細資訊，請參閱ConvertPDF服務。

  • 條碼式Forms服務： ​可讓您從條碼的電子影像擷取資料。 此服務接受包含一或多個條碼作為輸入的TIFF和PDF檔案，並擷取條碼資料。 如需詳細資訊，請參閱條碼式Forms服務。

  • DocAssurance服務： ​可讓您加密和解密檔案、使用其他使用許可權擴充Adobe Reader的功能，以及將數位簽章新增至您的檔案。 Doc Assurance服務包含三種服務：簽名、加密和讀取器延伸。 如需詳細資訊，請參閱DocAssurance服務。

  • 加密服務： ​可讓您加密和解密檔案。 檔案加密後，其內容會變得無法讀取。 授權的使用者可以解密檔案以取得其內容的存取權。 如需詳細資訊，請參閱加密服務。

  • Forms服務： ​可讓您建立互動式資料擷取使用者端應用程式，以驗證、處理、轉換及傳遞通常在Forms Designer中建立的表單。 Forms服務會轉譯您為PDF檔案所開發的任何表單設計。 如需詳細資訊，請參閱Forms服務。

  • 輸出服務： ​可讓您建立不同格式的檔案，包括PDF、雷射印表機格式及標籤印表機格式。 雷射印表機格式為PostScript和印表機控制語言(PCL)。 如需詳細資訊，請參閱輸出服務。

  • PDF Generator服務： PDF Generator服務提供API以將原生檔案格式轉換為PDF。 它也會將PDF轉換為其他檔案格式，並最佳化PDF檔案的大小。 如需詳細資訊，請參閱PDF Generator服務。

  • Reader延伸服務： ​藉由延伸具有其他使用許可權的Adobe Reader功能，讓您的組織能夠輕鬆共用互動式PDF檔案。 此服務會啟動使用Adobe Reader開啟PDF檔案時無法使用的功能，例如新增註釋至檔案、填寫表單和儲存檔案。 如需詳細資訊，請參閱Reader延伸服務。

  • 簽章服務： ​可讓您在AEM伺服器上使用數位簽章和檔案。 例如，簽章服務通常用於以下情況：

    • AEM伺服器會先認證表單，再將表單傳送給使用者，以使用Acrobat或Adobe Reader開啟。
    • AEM伺服器會使用Acrobat或Adobe Reader驗證已新增至表單的簽名。
    • AEM伺服器代表公用公證員簽署表格。

    簽章服務會存取儲存在信任存放區中的憑證和認證。 如需詳細資訊，請參閱簽章服務。

AEM Forms是功能強大的企業級平台，檔案服務只是AEM Forms的其中一項功能。 如需完整的功能清單，請參閱AEM Forms簡介。

部署拓撲 deployment-topology

AEM Forms附加元件套件是部署至AEM的應用程式。 一般而言，您只需要一個AEM例項（製作或發佈）即可執行AEM Forms檔案服務。 建議使用下列拓撲來執行AEM Forms檔案服務。 如需拓撲的詳細資訊，請參閱AEM Forms的架構和部署拓撲。

AEM Forms的架構和部署拓撲

NOTE
雖然AEM Forms可讓您從單一伺服器設定並執行所有功能，但您應執行容量規劃、負載平衡，並為生產環境中的特定功能設定專用伺服器。 例如，在使用PDF Generator服務每天轉換數千頁頁面及多個調適型表單來擷取資料的環境中，請為PDF Generator服務和調適型表單功能設定個別的AEM Forms伺服器。 它有助於提供最佳效能，並獨立擴充伺服器。

系統需求 system-requirements

開始安裝及設定AEM Forms檔案服務前，請確定：

  • 硬體與軟體基礎架構已準備就緒。 如需支援的硬體和軟體詳細清單，請參閱技術需求。

  • AEM執行個體的安裝路徑未包含空格。

  • AEM執行個體已啟動且執行中。 在AEM術語中，「例項」是在伺服器上以製作或發佈模式執行的AEM的副本。 一般而言，您只需要一個AEM例項（製作或發佈）即可執行AEM Forms檔案服務：

    • 作者：用來建立、上傳和編輯內容以及管理網站的AEM執行個體。 一旦內容準備好上線，就會將其復寫到發佈執行個體。
    • Publish：透過網際網路或內部網路，向公眾提供已發佈內容的AEM執行個體。

  • 符合記憶體需求。 AEM Forms附加元件套件需要：

    • Microsoft® Windows安裝專用的15 GB暫存空間。
    • UNIX安裝需要6 GB的暫存空間。

  • 已安裝在Microsoft®Windows和Linux®上執行PDF產生器轉換所需的使用者端軟體：

NOTE
  • 在Microsoft® Windows上，PDF Generator支援WebKit、Acrobat WebCapture和WebToPDF轉換路由，以將HTML檔案轉換為PDF檔案。
  • 在基於UNIX的作業系統上，PDF Generator支援WebKit和WebToPDF轉換路由，以將HTML檔案轉換為PDF檔案。

UNIX作業系統的額外需求 extrarequirements

如果您使用UNIX作業系統，請從個別作業系統的安裝媒體安裝下列32位元套件：

  • 外派人員
  • libxcb
  • 自由文字
  • libXau
  • libSM
  • zlib
  • libICE
  • libuuid
  • glibc
  • libXext
  • nss-softokn-freebl
  • fontconfig
  • libX11
  • libXrender
  • libXrandr
  • libXinerama

  • (僅PDF Generator)安裝32位元版本的libcurl、libcrypto和libssl程式庫，並建立下列symlink。 符號連結指向個別程式庫的最新版本：

    • /usr/lib/libcurl.so
    • /usr/lib/libcrypto.so
    • /usr/lib/libssl.so

  • (僅限PDF Generator) PDF Generator服務支援WebKit和WebToPDF路由，以將HTML檔案轉換為PDF檔案。 若要啟用WebToPDF路由的轉換，請安裝下列的64位元程式庫。 一般而言，這些程式庫已經安裝。 如果缺少任何程式庫，請手動安裝：

    • 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

安裝前設定 preinstallationconfigurations

「安裝前組態」區段中列出的組態僅適用於PDF Generator服務。 如果您未設定PDF Generator服務，可以略過安裝前設定區段。

安裝Adobe Acrobat和協力廠商應用程式 install-adobe-acrobat-and-third-party-applications

如果您要使用PDF Generator服務來轉換原生檔案格式(例如Microsoft®Word、Microsoft®Excel、Microsoft®PowerPoint、OpenOffice、WordPerfect X7和Adobe Acrobat)以PDF檔案，請確定這些應用程式已安裝在AEM Forms伺服器上。

NOTE
  • 如果您的AEM Forms伺服器處於離線或安全的環境，且網際網路無法用來啟用Adobe Acrobat，請參閱離線啟用，取得啟用此類Adobe Acrobat執行個體的指示。
  • Adobe Acrobat、Microsoft®Word、Excel和Powerpoint僅適用於Microsoft®Windows。 如果您使用UNIX作業系統，請安裝OpenOffice以將RTF檔案和支援的Microsoft® Office檔案轉換成PDF檔案。
  • 關閉在安裝Adobe Acrobat和協力廠商軟體後，針對所有設定為使用PDF Generator服務的使用者顯示的所有對話方塊。
  • 至少啟動一次所有已安裝的軟體。 關閉所有設定要使用PDF Generator服務的使用者之所有對話方塊。
  • 檢查Adobe Acrobat序號的到期日並設定更新授權的日期，或根據到期日移轉您的序號。

安裝Acrobat後，請開啟Microsoft® Word。 在​ Acrobat ​索引標籤上，按一下​ 建立PDF，並將電腦上可用的.doc或.docx檔案轉換為PDF檔案。 如果轉換成功，AEM Forms就可以將Acrobat與PDF Generator服務搭配使用。

設定環境變數 setup-environment-variables

為64位元Java Development Kit、協力廠商應用程式和Adobe Acrobat設定環境變數。 環境變數應包含用來啟動對應應用程式之執行檔的絕對路徑，例如，下表列出一些應用程式的環境變數：

應用程式
環境變數
範例
JDK （64位元）
JAVA_HOME
C:\Program Files\Java\jdk1.8.0_74
Adobe Acrobat
Acrobat路徑
C:\Program檔案(x86)\Adobe\Acrobat 2015\Acrobat\Acrobat.exe
記事本
記事本_路徑
C:\WINDOWS\notepad.exe
OpenOffice
OpenOffice_PATH
C:\Program檔案(x86)\OpenOffice.org4
NOTE

  • 所有環境變數和各自的路徑都區分大小寫。

  • JAVA_HOME和Acrobat_PATH （僅限Windows）是強制的環境變數。

  • 環境變數OpenOffice_PATH設定為安裝資料夾，而非可執行檔的路徑。

  • 請勿為Microsoft® Office應用程式（例如Word、PowerPoint、Excel和Project）或AutoCAD設定環境變數。 如果這些應用程式已安裝在伺服器上，則產生PDF服務會自動啟動這些應用程式。

  • 在UNIX平台上，以/root格式安裝OpenOffice。 如果OpenOffice未安裝為root，則PDF Generator服務無法將OpenOffice檔案轉換為PDF檔案。 如果您需要以非根使用者身分安裝及執行OpenOffice，請向非根使用者提供sudo許可權。

  • 如果您在UNIX平台使用OpenOffice，請執行以下命令來設定路徑變數：

    export OpenOffice_PATH=/opt/openoffice.org4

(僅適用於IBM® WebSphere®)設定IBM® SSL通訊端提供者 only-for-ibm-websphere-configure-ibm-ssl-socket-provider

執行以下步驟來設定IBM® SSL通訊端提供者：

  1. 建立java.security檔案的復本。 檔案的預設位置為[WebSphere_installation_directory]\Appserver\java_[version]\jre\lib\security。

  2. 開啟複製的java.security檔案進行編輯。

  3. 變更預設的SSL通訊端工廠以使用JSSE2工廠，而非預設的IBM® WebSphere®工廠：

    預設內容：

    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

    修改的內容：

    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. 若要讓AEM Forms伺服器使用更新的java.security檔案，請在啟動AEM Forms伺服器時新增下列java引數：

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

（僅限Windows）設定Microsoft® Office的檔案封鎖設定 configure-the-file-block-settings-for-microsoft-office

變更Microsoft® Office信任中心設定，讓PDF Generator服務能夠轉換使用舊版Microsoft® Office建立的檔案。

  1. 開啟Microsoft® Office應用程式。 例如，Microsoft® Word。 瀏覽至​ 檔案> 選項。 「選項」對話方塊隨即顯示。

  2. 按一下[信任中心]​ ​，然後按一下[信任中心設定]​ ​。

  3. 在​ 信任中心設定 ​中，按一下​ 檔案封鎖設定。

  4. 在​ 檔案型別 ​清單中，取消選取​ 開啟，該檔案型別應該允許PDF Generator服務轉換成PDF檔案。

（僅限Windows）授予Replace a process level token許可權 grant-the-replace-a-process-level-token-privilege

用來啟動應用程式伺服器的使用者帳戶需要​ 取代處理序層級權杖 ​許可權。 本機系統帳戶預設具有​ 取代處理序層級權杖 ​許可權。 對於以Local Administrators群組的使用者執行的伺服器，必須明確授與許可權。 執行以下步驟來授與許可權：

  1. 開啟Microsoft® Windows的群組原則編輯器。 若要開啟群組原則編輯器，請按一下[開始] ​，在[開始搜尋]方塊中輸入​ gpedit.msc，然後按一下[群組原則編輯器] 。
  2. 瀏覽至​ 本機電腦原則 > 電腦組態 > Windows設定 > 安全性設定 > 本機原則 > 使用者許可權指派，並編輯​ 取代處理序層級權杖 ​原則並包含Administrators群組。
  3. 將使用者新增至「取代程式層級權杖」專案。
NOTE
如上所示，如果AEM伺服器是以LocalSystem帳戶(LSA)下的服務方式執行，則不需要明確指定此許可權給使用者。

（僅限Windows）為非系統管理員啟用PDF Generator服務 enable-the-pdf-generator-service-for-non-administrators

您可以讓非系統管理員使用者使用PDF Generator服務。 通常只有具有管理許可權的使用者才能使用服務：

  1. 建立環境變數PDFG_NON_ADMIN_ENABLED。
  2. 將環境變數的值設定為TRUE。
  3. 重新啟動AEM Forms執行個體。
NOTE
建議您使用'Ctrl + C'命令重新啟動SDK。 使用替代方法重新啟動AEM SDK （例如停止Java程式）可能會導致AEM開發環境不一致。

（僅限Windows）停用使用者帳戶控制(UAC) disable-user-account-control-uac

  1. 若要存取系統組態公用程式，請移至​ 開始>執行，然後輸入​ MSCONFIG。

  2. 按一下​ 工具 ​標籤，然後向下捲動並選取​ 變更UAC設定。 按一下​ 啟動，在新視窗中執行命令。

  3. 將滑桿調整為「永不通知」等級。 完成後，關閉命令視窗並關閉「系統組態」視窗。

  4. 確認UAC的登入設定設為0 （零）。 執行以下步驟以進行驗證：

    1. Microsoft®建議您在修改登入之前先備份登入。 如需詳細步驟，請參閱如何在Windows中備份及還原登入。
    2. 開啟Microsoft® Windows登入編輯器。 若要開啟登入編輯程式，請前往[開始] > [執行]，輸入regedit，然後按一下[確定]。
    3. 瀏覽至HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\。 請確定EnableLUA的值設為0 （零）。
    4. 請確定​ EnableLUA ​的值設為0 （零）。 如果值不是0，請將值變更為0。 關閉登錄編輯程式。

  5. 重新啟動電腦。

（僅限Windows）停用錯誤報告服務 disable-error-reporting-service

使用Windows Server上的PDF服務將檔案轉換為PDF Generator時，Windows Server偶爾會報告可執行檔發生問題，必須關閉。 但是，這不會影響PDF轉換，因為它會在背景中繼續。

若要避免收到錯誤，您可以停用Windows錯誤報告。 如需停用錯誤報告的詳細資訊，請參閱https://technet.microsoft.com/en-us/library/cc754364.aspx。

（僅限Windows）設定HTML至PDF的轉換 configure-html-to-pdf-conversion

PDF Generator服務提供將HTML檔案轉換為PDF檔案的WebKit、WebCapture和WebToPDF路徑或方法。 在Windows上，若要啟用WebKit和Acrobat WebCapture路由的轉換，請將Unicode字型複製到%windir%\fonts目錄。

NOTE
每當您將新字型安裝至字型資料夾時，請重新啟動AEM Forms例項。

（僅限UNIX平台）HTML至PDF轉換的額外設定 extra-configurations-for-html-to-pdf-conversion

在UNIX平台上，PDF Generator服務支援WebKit和WebToPDF路由，將HTML檔案轉換為PDF檔案。 若要啟用HTML至PDF轉換，請執行以下適用於您偏好轉換路由的設定：

（僅限UNIX平台）啟用Unicode字型支援（僅限WebKit） enable-support-for-unicode-fonts-webkit-only

視您的系統需要，將Unicode字型複製到下列任何目錄：

  • /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
  • 在Red Hat® Enterprise Linux® 6.x和更新版本上，Courier字型無法使用。 若要安裝Courier字型，請下載font-ibm-type1-1.0.3.zip封存。 在/usr/share/fonts解壓縮封存。 從/usr/share/X11/fonts建立符號連結至/usr/share/fonts。
  • 刪除Html2PdfSvc/bin和/usr/share/fonts目錄中的所有.lst字型快取檔案。
  • 確定目錄/usr/lib/X11/fonts和/usr/share/fonts存在。 如果目錄不存在，請使用ln指令建立從/usr/share/X11/fonts到/usr/lib/X11/fonts的符號連結，以及從/usr/share/fonts到/usr/share/X11/fonts的另一個符號連結。 同時請確定在/usr/lib/X11/fonts中可以使用快遞。
  • 請確定/usr/share/fonts或/usr/share/X11/fonts目錄中的所有字型（Unicode和非Unicode）都可用。
  • 當您以非root使用者的身分執行PDF Generator服務時，請為非root使用者提供所有字型目錄的讀寫存取權。
  • 每當您將新字型安裝至字型資料夾時，請重新啟動AEM Forms例項。

安裝AEM Forms附加元件套件 install-aem-forms-add-on-package

AEM Forms附加元件套件是部署至AEM的應用程式。 此套件包含AEM Forms Document Services和其他AEM Forms功能。 執行以下步驟來安裝套件：

  1. 開啟 Software Distribution。您需要 Adobe ID 才能登入 Software Distribution。

  2. 選取標題功能表中可用的​ Adobe Experience Manager。

  3. 在​ 篩選器 ​區段中：

    1. 從​ 解決方案 ​下拉式清單中選取​ Forms。
    2. 選取封裝的版本和型別。 您也可以使用​ 搜尋下載 ​選項來篩選結果。

  4. 選取適用於您作業系統的封裝名稱，選取​ 接受EULA條款，然後選取​ 下載。

  5. 開啟封裝管理員，然後按一下​ 上傳封裝 ​以上傳封裝。

  6. 選取封裝並按一下​ 安裝。

    您也可以透過AEM Forms發行版本文章中列出的直接連結來下載套件。

  7. 安裝套件後，系統會提示您重新啟動AEM執行個體。 不要立即停止伺服器。 ​在停止AEM Forms伺服器之前，請等候直到ServiceEvent REGISTERED和ServiceEvent UNREGISTERED訊息停止出現在[AEM-Installation-Directory]/crx-quickstart/logs/error.log檔案中，而且記錄檔穩定。

Post安裝設定 post-installation-configurations

設定RSA/BouncyCastle程式庫的開機委派 configure-boot-delegation-for-rsa-bouncycastle-libraries

  1. 停止AEM執行個體。 瀏覽至[AEM安裝目錄]\crx-quickstart\conf\資料夾。 開啟sling.properties檔案進行編輯。

    如果您使用[AEM installation directory]\crx-quickstart\bin\start.bat啟動AEM執行個體，請編輯位於[AEM_root]\crx-quickstart\的sling.properties。

  2. 將以下屬性新增到sling.properties檔案：

    code language-shell 
    sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*

  3. (僅限AIX®)將以下屬性新增到sling.properties檔案：

    code language-shell 
    sling.bootdelegation.xerces=org.apache.xerces.*

  4. 儲存並關閉檔案。

設定字型管理員服務 configuring-the-font-manager-service

  1. 以系統管理員身分登入AEM Configuration Manager。

  2. 找到並開啟​ CQ-DAM-Handler-Gibson字型管理員 ​服務。 指定System Fonts、Adobe Server Fonts和Customer Fonts目錄的路徑。 按一下「儲存」。

    note note
    NOTE
    您使用Adobe以外的各方所提供的字型的權利受這些各方提供給您的授權合約所規範，且您使用Adobe軟體的授權不涵蓋這些字型。 Adobe建議您先檢閱並確保遵守所有適用的非Adobe授權合約，然後再將非Adobe字型與Adobe軟體搭配使用，尤其是在伺服器環境中使用字型方面。
    將新字型安裝至字型資料夾時，請重新啟動AEM Forms例項。

設定本機使用者帳戶以執行PDF Generator服務 configure-a-local-user-account-to-run-the-pdf-generator-service

需要本機使用者帳戶才能執行PDF Generator服務。 如需建立本機使用者的步驟，請參閱在Windows中建立使用者帳戶，或在UNIX平台中建立使用者帳戶。

  1. 開啟AEM Forms PDF Generator設定頁面。

  2. 在​ 使用者帳戶 ​索引標籤中，提供本機使用者帳戶的認證，然後按一下​ 提交。 如果Microsoft®Windows提示，請允許使用者存取。 成功新增後，設定的使用者會顯示在​ 使用者帳戶 ​索引標籤的​ 您的使用者帳戶 ​區段下。

設定逾時設定 configure-the-time-out-settings

  1. 在AEM組態管理員中，找到並開啟​ Jacorb ORB提供者 ​服務。

    將下列專案新增至​ 自訂屬性。名稱 ​欄位，然後按一下​ 儲存。 它會將擱置中的回覆逾時（也稱為CORBA使用者端逾時）設定為600秒。

    jacorb.connection.client.pending_reply_timeout=600000

  2. 登入AEM作者執行個體並導覽至​ Adobe Experience Manager > 工具 > Forms > 設定PDF Generator。 預設URL為http://localhost:4502/libs/fd/pdfg/config/ui.html。

    開啟​ 一般組態 ​標籤，並修改您環境的下列欄位值：

欄位
說明
預設值
伺服器轉換逾時
PDFG轉換會在伺服器轉換逾時中定義的秒數內保持作用中
270秒
PDFG 清理掃描秒數
執行轉換後作業所需的秒數。
3600秒
工作逾期秒數
允許PDF Generator服務執行轉換的持續時間。 請確定作業過期秒數的值大於PDFG清理掃描秒數的值。
7200秒

（僅限Windows）為PDF Generator服務設定Acrobat configure-acrobat-for-the-pdf-generator-service

在Microsoft® Windows上，PDF Generator服務會使用Adobe Acrobat將支援的檔案格式轉換為PDF檔案。 執行以下步驟，為PDF Generator服務設定Adobe Acrobat：

  1. 開啟Acrobat並選取​ 編輯> 偏好設定> 更新程式。 在[檢查更新]中，取消選取[自動安裝更新]​ ​，然後按一下[確定]​ ​。 關閉Acrobat。

  2. 連按兩下您系統上的PDF檔案。 當Acrobat首次啟動時，會顯示登入、歡迎畫面和EULA的對話方塊。 為所有設定為使用PDF Generator的使用者關閉這些對話方塊。

  3. 執行PDF Generator公用程式批次檔案，為PDF Generator服務設定Acrobat：

    1. 開啟AEM封裝管理員，並從封裝管理員下載adobe-aemfd-pdfg-common-pkg-[version].zip檔案。

    2. 將下載的.zip檔案解壓縮。 以管理許可權開啟命令提示字元。

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

    4. 解壓縮adobe-aemfd-pdfg-common-pkg-[version]。

    5. 導覽至[downloaded-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]目錄。 執行以下批次檔案：

      Acrobat_for_PDFG_Configuration.bat

      Acrobat已設定為搭配PDF Generator服務執行。

  4. 執行系統整備工具(SRT)以驗證Acrobat安裝。

（僅限Windows）設定HTML到PDF轉換的主要路由 configure-primary-route-for-html-to-pdf-conversion-windows-only

PDF Generator服務提供將HTML檔案轉換為PDF檔案的多種途徑：Webkit、Acrobat WebCapture （僅限Windows）和WebToPDF。 Adobe建議使用WebToPDF路由，因為它具有處理動態內容的功能，並且不依賴32位元程式庫或不需要額外字型。 此外，WebToPDF路由不需要sudo或root存取權即可執行轉換。

HTML至PDF轉換的預設主要路由為Webkit。 若要變更轉換路線：

  1. 在AEM作者執行個體上，瀏覽至​ 工具> Forms> 設定PDF Generator。

  2. 在​ 一般組態 ​索引標籤中，從​ HTML至PDF轉換的主要路由 ​下拉式清單中選取偏好的轉換路由。

初始化全域信任存放區 intialize-global-trust-store

使用「信任存放區管理」，您可以匯入、編輯和刪除信任在伺服器上的憑證，以驗證數位簽章和憑證驗證。 您可以匯入和匯出任意數量的憑證。 匯入憑證後，您可以編輯信任設定和信任存放區型別。 執行以下步驟來初始化信任存放區：

  1. 以管理員身分登入AEM Forms執行個體。
  2. 移至​ 工具 > 安全性 > 信任存放區。
  3. 按一下​ 建立TrustStore。 設定密碼並選取​ 儲存。

設定Reader延伸與加密服務的憑證 set-up-certificates-for-reader-extension-and-encryption-service

DocAssurance服務可套用使用許可權至PDF檔案。 若要套用使用許可權至PDF檔案，請設定憑證。

在設定憑證之前，請確定您擁有：

  • 憑證檔案(.pfx)。

  • 憑證提供的私密金鑰密碼。

  • 私密金鑰別名。 您可以執行Java keytool指令來檢視「私密金鑰別名」：
    keytool -list -v -keystore [keystore-file] -storetype pkcs12

  • 金鑰庫檔案密碼。 如果您使用Adobe的Reader延伸憑證，Keystore檔案密碼一律與「私密金鑰」密碼相同。

執行以下步驟來設定憑證：

  1. 以管理員身分登入AEM Author執行個體。 移至​ 工具 > 安全性 > 使用者。

  2. 按一下使用者帳戶的​ 名稱 ​欄位。 編輯使用者設定 ​頁面隨即開啟。 在AEM編寫執行個體上，憑證位於KeyStore中。 如果您先前尚未建立KeyStore，請按一下[建立KeyStore] ​，並設定KeyStore的新密碼。 如果伺服器已包含KeyStore，請略過此步驟。 如果您使用Adobe的Reader延伸憑證，Keystore檔案密碼一律與「私密金鑰」密碼相同。

  3. 在​ 編輯使用者設定 ​頁面上，選取​ KeyStore ​索引標籤。 展開​ 從金鑰庫檔案新增私密金鑰 ​選項並提供別名。 別名可用來執行Reader擴充功能作業。

  4. 若要上傳憑證檔案，請按一下​ 選取金鑰存放區檔案，然後上傳<filename>.pfx檔案。

    將與憑證相關聯的​ 金鑰存放區密碼、私密金鑰密碼 ​和​ 私密金鑰別名 ​新增至個別欄位。 按一下「提交」。

    note note
    NOTE
    在生產環境中，將評估認證取代為生產認證。 在更新過期或評估認證之前，請確定您刪除了舊的Reader延伸認證。

  5. 在​ 編輯使用者設定 ​頁面上按一下​ 儲存並關閉。

啟用AES-256 enable-aes

若要對PDF檔案使用AES 256加密，請取得並安裝Java Cryptography Extension (JCE) Unlimited Strength管轄原則檔案。 取代jre/lib/security資料夾中的local_policy.jar和US_export_policy.jar檔案。 例如，如果您使用Sun JDK，請將下載的檔案複製到[JAVA_HOME]/jre/lib/security資料夾。

組合器服務取決於Reader延伸模組服務、簽名服務、Forms服務和輸出服務。 執行以下步驟，確認必要的服務已啟動且執行中：

  1. 以系統管理員身分登入URL https://'[server]:[port]'/system/console/bundles。
  2. 搜尋下列服務，並確定服務已啟動且執行中：
服務名稱
組合包名稱
簽名服務
adobe-aemfd-signatures
Reader 延伸模組服務
com.adobe.aemfd.adobe-aemfd-readerextensions
Forms 服務
com.adobe.livecycle.adobe-lc-forms-bedrock-connector
輸出服務
com.adobe.livecycle.adobe-lc-forms-bedrock-connector

（僅限Windows）設定Microsoft®專案的登入專案 configure-registry-entry-for-microsoft-project

在電腦上安裝AEM Forms附加元件和Microsoft® Project後，請在64位元位置註冊Microsoft® Project的專案。 它有助於執行Project到PDFG的轉換測試。 下列是列出登入輸入程式的步驟：

  1. 開啟Microsoft® Windows登入編輯器(regedit)，若要開啟登入編輯器，請前往[開始] > [執行]，輸入regedit，然後按一下[確定]。
  2. 導覽至Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Adobe\Acrobat PDFMaker\<version>\Office\SupportedApp，並建立新的​ 二進位值 ​登入並將它重新命名為​ 專案。
  3. 將已建立之二進位登入的資料值修改成01，然後按一下確定。
  4. 關閉登入專案。

已知問題和疑難排解 known-issues-and-troubleshooting

  • 如果壓縮的輸入檔案包含檔案名稱中含有雙位元組字元的HTML檔案，則PDF轉換的HTML會失敗。 為了避免此問題，命名HTML檔案時請勿使用雙位元組字元。

  • 在基於UNIX的作業系統上，執行下列操作以尋找任何遺漏的程式庫：

  1. 導覽至 [crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/。

  2. 執行以下命令，列出WebToPDF需要的所有程式庫，以便HTML到PDF轉換。

    ldd phantomjs

    執行以下命令以列出遺失的程式庫。

    ldd phantomjs | grep not

  3. 手動安裝遺失的程式庫。

系統整備工具(SRT) SRT

系統整備工具會檢查電腦是否已正確設定為執行PDF Generator轉換。 工具會在指定的路徑產生報表。 若要執行工具：

  1. 開啟命令提示。 導覽至 [extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools 檔案夾。

  2. 從命令提示字元執行下列命令：

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

    該指令會產生報告，也會建立srt_config.yaml檔案。 您可以使用它來設定SRT工具的選項。 可選擇性設定SRT工具的選項。

    note note
    NOTE
    • 如果系統整備工具報告pdfgen.api檔案在Acrobat外掛程式資料夾中無法使用，則將pdfgen.api檔案從[extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]\plugins\x86_win32目錄複製到[Acrobat_root]\Acrobat\plug_ins目錄。

  3. 瀏覽至[Path_of_reports_folder]。 開啟SystemReadinessTool.html檔案。 驗證報告並修正上述問題。

設定SRT工具的選項 srt-configuration

您可以使用srt_config.yaml檔案來設定SRT工具的各種設定。 檔案格式為：

   # =================================================================
   # 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:
  • 地區設定： ​它是必要引數。 它支援英文(en)、德文(de)、法文(fr)和日文(ja)。 預設值為en。 這對OSGi上在AEM Forms上執行的PDF Generator服務沒有影響。
  • aemTempDir： ​它是選用引數。 它會指定Adobe Experience Manager的暫存位置。
  • 使用者： ​它是選用引數。 您可以指定使用者來檢查使用者是否擁有執行PDF Generator所需的許可權和目錄的讀取/寫入存取權。 如果未指定使用者，則會略過使用者特定檢查，並在報表中顯示為失敗。
  • outputDir： ​指定儲存SRT報告的位置。 預設位置是SRT工具的目前工作目錄。

疑難排解

如果在修復SRT工具所報告的所有問題後仍遇到問題，請執行以下檢查：

在執行以下檢查之前，請確定系統整備工具未報告任何錯誤。

Adobe Acrobat
OpenOffice

Microsoft® Windows

  • 請確認已安裝32位元支援的Microsoft Office版本，並取消所有應用程式的開啟對話方塊。

  • 確認已在PDF Generator設定UI中新增PDF使用者。

  • 請確定PDF Generator使用者是系統管理員群組的成員，並且已為該使用者設定了取代處理序層級權杖許可權。

  • 請確認已在PDF Generator UI中設定使用者，並執行下列動作：

    1. 以PDF Generator使用者身分登入Microsoft® Windows。
    2. 開啟Microsoft® Office或OpenOffice應用程式並取消所有對話方塊。
    3. 將AdobePDF設為預設印表機。
    4. 將Acrobat設為PDF檔案的預設程式。
    5. 在Microsoft Office應用程式中使用選項「檔案>列印和Acrobat功能區」來執行手動轉換，並取消所有對話方塊。
    6. 結束所有與轉換相關的程式，例如winword.exe、powerpoint.exe和excel.exe。
    7. 重新啟動AEM Forms伺服器。

Linux®

  • 安裝支援的OpenOffice版本。 AEM Forms支援32位元和64位元版本。 安裝之後，請開啟所有OpenOffice應用程式、取消所有對話視窗，然後關閉應用程式。 重新開啟應用程式，並確保開啟OpenOffice應用程式時不會顯示任何對話方塊。

  • 建立環境變數OpenOffice_PATH，並將其設定為指向設定在主控台或dt （裝置樹狀結構）設定檔中的OpenOffice安裝。

  • 如果安裝OpenOffice時發生問題，請確定OpenOffice安裝所需的32位元程式庫可供使用。

HTML至PDF轉換問題
  • 請確定已在PDF Generator設定UI中新增字型目錄。

Linux與Solaris （WebToPDF轉換路由）

  • 確保可用於基於Webkit的HTMLToPDF轉換的32位元資料庫(libicudata.so.42)和64位元(libicudata.so.42資料庫可用於基於WebToPDF的HTMLToPDF轉換。

  • 執行以下命令以列出WebToPDF的遺失程式庫：

    code language-none 
    ldd phantomjs | grep not

Linux®和Solaris™ （WebKit轉換路由）

  • 確定目錄/usr/lib/X11/fonts和/usr/share/fonts存在。 如果目錄不存在，請建立從/usr/share/X11/fonts到/usr/lib/X11/fonts的符號連結，以及從/usr/share/fonts到/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

  • 請確定IBM字型複製於usr/share/fonts之下。

  • 確定電腦上有Ghost弱點修正Glibc。 使用您的預設封裝管理員來更新至最新版本的glibc。 其中包括Ghost弱點修正。

  • 確保系統上已安裝32位元lib curl、libcrypto和libssl程式庫的最新版本。 同時建立指向個別程式庫最新版本（32位元）的符號連結/usr/lib/libcurl.so (或libcurl.a (AIX®))、/usr/lib/libcrypto.so (或libcrypto.a (AIX®)和/usr/lib/libssl.so (或libssl.a (AIX®))。

  • 對IBM® SSL通訊端提供者執行以下步驟：

    1. 將java.security檔案從<WAS_Installed_JAVA>\jre\lib\security複製到AEM Forms伺服器上的任何位置。 預設位置為「預設位置」= <WAS_Installed>\Appserver\java_[version]\jre\lib\security。

    2. 編輯複製位置的java.security檔案，並變更預設的SSL通訊端工廠與JSSE2工廠(使用JSSE2工廠而非WebSphere®)。

      變更下列預設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

      替換為

      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
無法新增PDF Generator(PDFG)使用者
  • 請確定Windows上已安裝Microsoft® Visual C++ 2012 x86和Microsoft® Visual C++ 2013 x86 （32位元）可轉散發套件。
自動化測試失敗

  • 對於Microsoft® Office和OpenOffice，請手動執行至少一個轉換（以每位使用者的身分），以確保轉換期間不會彈出任何對話方塊。 如果出現任何對話方塊，則將其關閉。 自動轉換期間不應出現這類對話方塊。

  • 在OSGi環境的AEM Forms上執行自動化之前，請確定測試套件已安裝且作用中。

多個使用者轉換失敗

  • 驗證伺服器記錄以檢查特定使用者的轉換是否失敗。（程式總管可以協助您檢查不同使用者的執行程式）

  • 確保為PDF Generator設定的使用者具有本機管理員許可權。

  • 確保PDF Generator使用者對LC臨時和PDFG臨時使用者具有讀取、寫入和執行許可權。

  • 對於Microsoft® Office和OpenOffice，請手動執行至少一個轉換（以每位使用者的身分），以確保轉換期間不會彈出任何對話方塊。 如果出現任何對話方塊，則將其關閉。 自動轉換期間不應出現這類對話方塊。

  • 執行範例轉換。

AEM Forms伺服器上安裝的Adobe Acrobat授權過期

  • 如果您已有Adobe Acrobat的授權且已過期，請下載最新版的Adobe Application Manager，並移轉您的序號。 在移轉您的序號之前。

    • 使用以下命令來產生prov.xml，並使用prov.xml檔案重新整理現有的安裝，而不使用移轉序號編號文章中提供的命令。

      code language-none 
      &quot;&#39;

adobe_prtk —tool=VolumeSerialize —generate —serial=&lt;serialnum> [—leid=&lt;LEID>] [—regsuppress=ss] [—eulasuppress] [—locales=xx_XX格式或ALL>的有限地區設定清單] [—provfile=&lt;prov.xml>的絕對路徑]

&quot;&#39;

    • 磁碟區序列化套件（使用prov.xml檔案和新的序列重新序列化現有的安裝）：以管理員身分從PRTK安裝資料夾執行下列命令，以序列化並啟動使用者端機器上已部署的套件：

      code language-none 
      &grave;&grave;
adobe_prtk —tool=VolumeSerialize —provfile=C:\prov.xml -stream

&grave;&grave;

  • 若是大規模安裝，請使用AcrobatCustomization Wizard移除舊版的Reader和Acrobat。 自訂安裝程式，並將其部署至組織的所有電腦。

AEM Forms伺服器處於離線或安全的環境，且網際網路無法用來啟用Acrobat。
  • 您可在首次啟動Adobe產品後7天內上線，完成線上啟用與註冊，或使用具備網際網路功能的裝置和產品序號，完成此程式。 如需詳細指示，請參閱離線啟動。
無法在Windows Server上將Word或Excel檔案轉換為PDF

當使用者嘗試將Word或Excel檔案轉換成Microsoft Windows Server上的PDF時，會發生下列錯誤：

來自主要轉換器的錯誤訊息：
ALC-PDG-015-003 — 系統無法開啟輸入檔案。 再次提交您的檔案或連絡您的系統管理員。

若要解決此問題，請參閱無法將Word或Excel檔案轉換成Windows Server上的PDF。

無法在Windows Server 2019上將Excel檔案轉換為PDF

當您在Microsoft Windows Server 2019上將Microsoft Excel 2019轉換為PDF時，必須確定以下事項：

  • 使用PDF Generator服務時，您的Windows電腦不應與AEM伺服器（Windows RDP工作階段）有任何作用中的遠端連線。

  • 預設印表機必須設定為Adobe PDF。

    note note
    NOTE
    • 若為Apple macOS和Ubuntu作業系統，您不需要設定上述設定。
無法將XPS檔案轉換為PDF
若要解決此問題，在Windows上建立功能特定的登入機碼。

後續步驟 next-steps

您有一個運作中的AEM Forms檔案服務環境。 您可以透過以下方式使用檔案服務：

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