ドキュメントサービスのインストールと設定 installing-and-configuring-document-services
AEM Forms は、PDF ドキュメントの作成、アセンブル、配布、アーカイブや、ドキュメントへのアクセスを制限するためのデジタル署名の追加、Barcoded Forms のデコードなど、様々なドキュメントレベルの操作を実現する一連の OSGi サービスを提供します。これらのサービスは、AEM Forms のアドオンパッケージに含まれており、ドキュメントサービスと総称されます。利用可能なドキュメントサービスのリストとその主な機能は次のとおりです。
-
Assembler サービス: PDF ドキュメントや XDP ドキュメントの結合、並べ替えおよび拡張と、PDF ドキュメントに関する情報の取得を実行できます。PDF ドキュメントを PDF/A 規格に変換して検証することもできます。また、PDF フォーム、XML フォームを PDF/A-1b、PDF/A-2b および PDFA/A-3b に変換することもできます。詳しくは、Assembler サービスを参照してください。
-
ConvertPDF サービス: PDF ドキュメントを PostScript ファイルまたは画像ファイル(JPEG、JPEG 2000、PNG および TIFF)に変換します。詳しくは、ConvertPDF サービスを参照してください。
-
Barcoded Forms サービス: バーコードの電子画像からデータを抽出します。このサービスは、入力として 1 つまたは複数のバーコードを含んだ TIFF ファイルや PDF ファイルを受け取り、バーコードデータを抽出します。詳しくは、Barcoded Forms サービスを参照してください。
-
DocAssurance サービス: ドキュメントの暗号化と復号、使用権限の追加による Adobe Reader の機能拡張、ドキュメントへのデジタル署名の追加を実行できます。DocAssurance サービスには、3 つのサービス(署名、暗号化、Reader 拡張機能)があります。詳しくは、DocAssurance サービスを参照してください。
-
Encryption サービス: ドキュメントの暗号化と復号を実行できます。ドキュメントを暗号化すると、その内容は判読できなくなります。許可されたユーザーはドキュメントを復号化して、内容にアクセスできます。詳しくは、Encryption サービスを参照してください。
-
Forms サービス: 通常 Forms Designer で作成されたフォームを検証、処理、変換および配信する、インタラクティブなデータキャプチャを行うクライアントアプリケーションを作成できます。Forms サービスは、作成したあらゆるフォームデザインを PDF ドキュメントとして処理します。詳しくは、 Forms サービスを参照してください。
-
Output サービス: PDF、レーザープリンター形式、ラベルプリンター形式など、様々な形式のドキュメントを作成します。レーザープリンター形式には、PostScript と Printer Control Language(PCL)があります。詳しくは、Output サービスを参照してください。
-
PDF Generator サービス: ネイティブファイル形式を PDF に変換する API を提供します。また、PDF を他のファイル形式に変換し、PDF ドキュメントのサイズを最適化します。詳しくは、PDF Generator サービスを参照してください。
-
Reader Extension サービス: 使用権限を追加して Adobe Reader の機能を拡張することで、組織内でインタラクティブな PDF ドキュメントを容易に共有できます。このサービスにより、PDF ドキュメントを Adobe Reader で開いた場合には使用できない機能(ドキュメントへのコメントの追加、フォームへの入力、ドキュメントの保存など)が有効になります。詳しくは、Reader Extension サービスを参照してください。
-
Signature サービス: AEM サーバーでデジタル署名とドキュメントを処理できます。例えば、通常、署名サービスは次のような状況で使用されます。
- ユーザーにフォームが送信されて Acrobat または Adobe Reader で開かれる前に、AEM サーバーでフォームを認証する場合。
- Acrobat または Adobe Reader を使用してフォームに追加された署名を、AEM サーバーが検証する場合。
- AEM サーバーが公証人に代わってフォームに署名する場合。
署名サービスは、トラストストアに格納されている証明書および認証情報にアクセスします。詳しくは、Signature サービスを参照してください。
AEM Forms は強力なエンタープライズクラスのプラットフォームであり、ドキュメントサービスは AEM Forms の機能の 1 つです。機能の完全な一覧については、「AEM Forms の概要」を参照してください。
デプロイメントトポロジ deployment-topology
AEM Forms アドオンパッケージは AEM にデプロイされるアプリケーションです。通常、AEM Forms ドキュメントサービスを実行するには、1 つの AEM インスタンス(オーサーインスタンスまたはパブリッシュインスタンス)があれば十分です。AEM Forms ドキュメントサービスを実行するには、次のトポロジをお勧めします。トポロジについて詳しくは、「AEM Forms のアーキテクチャとデプロイメントトポロジ」を参照してください。
システム要件 system-requirements
AEM Forms ドキュメントサービスのインストールおよび設定に進む前に、次のことを確認する必要があります。
-
ハードウェアとソフトウェアのインフラが正しく設定されていること。サポート対象のハードウェアとソフトウェアの一覧について詳しくは、「技術要件」を参照してください。
-
AEM インスタンスのインストールパスに空白が含まれていないこと。
-
AEM インスタンスが稼働していること。AEM の用語では、「インスタンス」とは、サーバー上でオーサーモードまたはパブリッシュモードで実行されている AEM のコピーのことです。通常、AEM Forms ドキュメントサービスを実行するには、1 つの AEM インスタンス(オーサーインスタンスまたはパブリッシュインスタンス)があれば十分です。
- オーサー:コンテンツの作成、アップロードおよび編集や web サイトの管理に使用される AEM インスタンス。公開の準備が整ったコンテンツは、パブリッシュインスタンスにレプリケートされます。
- パブリッシュ:公開されたコンテンツをインターネットまたは社内ネットワークを通じて提供する AEM インスタンス。
-
メモリ要件が満たされていること。AEM Forms アドオンパッケージでは、次が必要です。
- Microsoft® Windows ベースのインストールの場合、15 GB の一時的な空きスペースが必要です。
- Unix ベースのインストールの場合、6 GB の一時的な空きスペースが必要です。
-
PDF Generator を使用して Microsoft® Windows や Linux® で変換を実行するには、必要なクライアントソフトウェアをインストールする必要があります。
- Microsoft® Windows:Microsoft® Office または Apache OpenOffice をインストールします
- Linux®:Apache OpenOffice をインストールします
- Microsoft® Windows では、PDF Generator は、WebKit、Acrobat WebCapture および WebToPDF の変換ルートをサポートし、HTML ファイルを PDF ドキュメントに変換します。
- UNIX ベースのオペレーティングシステムでは、PDF Generator は、WebKit および WebToPDF の変換ルートをサポートし、HTML ファイルを PDF ドキュメントに変換します。
UNIX ベースのオペレーティングシステムの追加要件 extrarequirements
Unix ベースのオペレーティングシステムを使用する場合は、それぞれのオペレーティングシステムのインストールメディアから、次の 32 ビットパッケージをインストールしてください。
-
(PDF Generator のみ) 32 ビット版の libcurl ライブラリ、libcrypto ライブラリ、および libssl ライブラリをインストールし、以下のシンボリックリンクを作成します。シンボリックリンクは、それぞれのライブラリの最新バージョンを指すようにします。
- /usr/lib/libcurl.so
- /usr/lib/libcrypto.so
- /usr/lib/libssl.so
-
(PDF Generator のみ) PDF Generator サービスは、HTML ファイルを PDF ドキュメントに変換するため、WebKit および WebToPDF の各ルートをサポートしています。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 サーバーにインストールしてください。
- AEM Forms Server がオフラインまたはセキュア環境にあり、インターネットを使用して Adobe Acrobat をアクティブ化できない場合は、オフラインアクティベーションを参照して、そのような場合に Adobe Acrobat のインスタンスをアクティブ化する手順を確認してください。
- Adobe Acrobat、Microsoft® Word、Excel および PowerPoint は、Microsoft® Windows でのみ使用できます。UNIX ベースのオペレーティングシステムを使用している場合は、OpenOffice をインストールして、リッチテキストファイルやサポートされている Microsoft® Office ファイルを PDF ドキュメントに変換します。
- PDF Generator サービスを使用できるすべてのユーザーに対して、Adobe Acrobat およびサードパーティソフトウェアのインストール後に表示されるすべてのダイアログボックスを閉じます。
- インストールされているすべてのソフトウェアを少なくとも 1 回起動します。PDF Generator サービスを使用するように設定されているすべてのユーザーに対して、すべてのダイアログボックスを解除します。
- Adobe Acrobat シリアル番号の有効期限を確認してライセンスを更新する日付を設定するか、有効期限に基づいてシリアル番号を移行します。
Acrobat をインストールしてから、Microsoft® Word を開きます。「Acrobat」タブで「PDFを作成」をクリックし、マシン上にある .doc または .docx のファイルを PDF ドキュメントに変換します。変換が成功すれば、AEM Forms が PDF Generator サービスで Acrobat を使用する準備が整います。
環境変数を設定 setup-environment-variables
64 ビットの Java Development Kit、サードパーティアプリケーション、Adobe Acrobat の環境変数を設定します。環境変数には、対応するアプリケーションを起動する際に使用する実行ファイルの絶対パスを含める必要があります。以下の表に、いくつかのアプリケーション用の環境変数を例示します。
-
すべての環境変数とそれぞれのパスでは、大文字と小文字が区別されます。
-
JAVA_HOME および Acrobat_PATH(Windows のみ)は、必須の環境変数です。
-
環境変数 OpenOffice_PATH は、実行ファイルではなく、インストールフォルダーのパスに設定します。
-
Word、PowerPoint、Excel、Project などの Microsoft® Office アプリケーション、または AutoCAD については、環境変数を設定する必要はありません。これらのアプリケーションがサーバーにインストールされている場合は、Generate PDF サービスが自動的にこれらのアプリケーションを起動します。
-
UNIX ベースのプラットフォームでは、OpenOffice を /root としてインストールします。OpenOffice が root としてインストールされていないと、PDF Generator サービスは OpenOffice ドキュメントを PDF ドキュメントに変換できません。OpenOffice を非 root ユーザーとしてインストールして実行する必要がある場合は、非 root ユーザーに sudo 権限を与えます。
-
UNIX ベースのプラットフォームで OpenOffice を使用している場合は、以下のコマンドを実行して PATH 変数を設定します。
export OpenOffice_PATH=/opt/openoffice.org4
(IBM® WebSphere® のみ)IBM® SSL ソケットプロバイダーの設定 only-for-ibm-websphere-configure-ibm-ssl-socket-provider
以下の手順を実行して、IBM® SSL ソケットプロバイダーを設定します。
-
java.security ファイルのコピーを作成します。ファイルのデフォルトの場所は次のとおりです。
[WebSphere_installation_directory]\Appserver\java_[version]\jre\lib\security
-
コピーした java.security ファイルを開いて編集します。
-
デフォルトの SSL ソケットファクトリとして、デフォルトの IBM® WebSphere® ファクトリではなく JSSE2 ファクトリを使用するように変更します。
デフォルトの内容:
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
-
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 で作成されたファイルを変換できるようにします。
-
Microsoft® Office のアプリケーションを開きます。例えば、Microsoft® Word などです。「ファイル」/「オプション」に移動します。オプションのダイアログボックスが表示されます。
-
「Trust Center」をクリックし、「Trust Center 設定」をクリックします。
-
「Trust Center 設定」で、「ファイルブロック設定」をクリックします
-
PDF Generator サービスで PDF ドキュメントへの変換を許可するファイルタイプについて、「ファイルタイプ」リストで「開く」チェックボックスをオフにします。
(Windows のみ)プロセスレベルのトークンを置き換える権限の付与 grant-the-replace-a-process-level-token-privilege
アプリケーションサーバーの起動に使用されるユーザーアカウントには、プロセスレベルトークンの置き換え 権限が必要です。ローカルシステムアカウントには、デフォルトで プロセスレベルトークンの置き換え 権限があります。ローカル管理グループのユーザーが運用しているサーバーの場合は、権限を明示的に付与する必要があります。権限を付与するには、次の手順を実行します。
- Microsoft® Windows のグループポリシーエディターを開きます。グループポリシーエディターを開くには、「スタート」をクリックしてスタートの検索ボックスに gpedit.msc と入力し、「グループポリシーエディター」をクリックします。
- ローカルコンピューターポリシー/コンピューターの設定/Windows の設定/セキュリティの設定/ローカルポリシー/ユーザー権限の割り当て の順に移動し、プロセスレベルトークンの置き換え ポリシーを編集し、管理者グループを含めます。
- 「プロセスレベルトークンの置き換え」エントリにユーザーを追加します。
(Windows のみ)管理者以外のユーザーに対する PDF Generator サービスの有効化 enable-the-pdf-generator-service-for-non-administrators
管理者以外のユーザーが PDF Generator サービスを使用できるようにすることができます。通常は、管理者権限を持つユーザーのみがこのサービスを実行できます。
- PDFG_NON_ADMIN_ENABLED 環境変数を作成します。
- 環境変数の値を TRUE に設定します。
- AEM Forms のインスタンスを再起動します。
(Windows のみ)ユーザーアカウント制御(UAC)の無効化 disable-user-account-control-uac
-
システム構成ユーティリティにアクセスするには、スタート/ファイル名を指定して実行 を選択し、MSCONFIG と入力します。
-
「ツール」タブをクリックし、スクロールして「UAC 設定を変更」を選択します。「起動」をクリックして新しいウィンドウでコマンドを実行します。
-
スライダーを「通知しない」レベルに設定します。完了したら、コマンドウィンドウを閉じ、システム構成ウィンドウを閉じます。
-
レジストリ設定で UAC が 0(ゼロ)に設定されていることを検証します。検証するには、以下の手順を実行します。
- Microsoft® は、レジストリを変更する前にバックアップをとっておくことを推奨しています。詳しい手順については、「Windows でのレジストリのバックアップと復元方法」を参照してください。
- Microsoft® Windows のレジストリエディターを開きます。レジストリエディターを開くには、「スタート/ファイル名を指定して実行」に移動し、「regedit」と入力して「OK」をクリックします。
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\
に移動します。EnableLUA の値が 0(ゼロ)に設定されていることを確認します。- EnableLUA の値が 0(ゼロ)に設定されていることを確認します。値が 0 でない場合は、0 に変更します。レジストリエディターを終了します。
-
コンピューターを再起動します。
(Windows のみ)エラーレポートサービスの無効化 disable-error-reporting-service
Windows Server で PDF Generator サービスを使用してドキュメントを PDF に変換しているとき、実行ファイルに問題が見つかったためファイルを閉じる必要があると Windows Server で報告される場合があります。ただし、バックグラウンドで継続されるので、PDF の変換には影響しません。
エラーを受け取らないようにするには、Windows エラー報告を無効にします。エラーレポート機能を無効にする手順について詳しくは、https://technet.microsoft.com/ja-jp/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 ディレクトリにコピーします。
(UNIX ベースのプラットフォームのみ)HTML から PDF への変換用の追加設定 extra-configurations-for-html-to-pdf-conversion
UNIX ベースのプラットフォーム上で PDF Generator サービスは、HTML ファイルを PDF ドキュメントに変換するため、WebKit および WebToPDF の各ルートをサポートしています。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™)
- 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 への別のシンボリックリンクを作成します。また、courier フォントが使用可能であることを /usr/lib/X11/fonts で確認します。
- すべてのフォント(Unicode および非 Unicode)が /usr/share/fonts または /usr/share/X11/fonts ディレクトリで使用できることを確認してください。
- PDF Generator サービスを非 root ユーザーとして実行する場合は、すべてのフォントディレクトリへの読み取りおよび書き込みアクセス権を非 root ユーザーに与えます。
- 新しいフォントをフォントフォルダーにインストールしたときは、AEM Forms インスタンスを再起動してください。
AEM Forms アドオンパッケージのインストール install-aem-forms-add-on-package
AEM Forms アドオンパッケージは AEM にデプロイされるアプリケーションです。このパッケージには、AEM Forms ドキュメントサービスおよびその他の AEM Forms 機能が含まれています。次の手順を実行してパッケージをインストールします。
-
ソフトウェア配布を開きます。ソフトウェア配布にログインするには、Adobe ID が必要です。
-
ヘッダーメニューで「Adobe Experience Manager」を選択します。
-
「フィルター」セクションで、
- 「ソリューション」ドロップダウンリストから「Forms」を選択します。
- パッケージのバージョンとタイプを選択します。また、「ダウンロードを検索」オプションを使用して結果をフィルターすることもできます。
-
お使いのオペレーティングシステムに適した Forms アドオンパッケージの名前を選択し、「EULA 利用条件に同意する」を選択して、「ダウンロード」を選択します。
-
パッケージマネージャーを開き「パッケージをアップロード」をクリックしてパッケージをアップロードします。
-
パッケージを選択して「インストール」をクリックします。
AEM Forms リリースの記事に記載されている直接リンクからパッケージをダウンロードすることもできます。
-
パッケージのインストールが完了したら、AEM インスタンスを再起動します。その際、すぐにサーバーを停止しないでください。 AEM Forms サーバーを停止する前に、ServiceEvent REGISTERED メッセージと ServiceEvent UNREGISTERED メッセージが
[AEM-Installation-Directory]/crx-quickstart/logs/error
.log ファイルに表示されなくなり、ログファイルが安定した状態になるまで待ちます。
インストール後の設定 post-installation-configurations
RSA/BouncyCastle ライブラリ用のブート委任の設定 configure-boot-delegation-for-rsa-bouncycastle-libraries
-
AEM インスタンスを停止します。[AEM インストールディレクトリ]¥crx-quickstart¥conf フォルダーに移動します。sling.properties ファイルを開いて編集します。
[AEM installation directory]\crx-quickstart\bin\start.bat
を使用して AEM インスタンスを起動する場合は、[AEM_root]\crx-quickstart\
にある sling.properties 編集します。 -
次のプロパティを sling.properties ファイルに追加します。
code language-shell sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
-
(AIX® のみ)以下のプロパティを sling.properties ファイルに追加します。
code language-shell sling.bootdelegation.xerces=org.apache.xerces.*
-
ファイルを保存して閉じます。
フォントマネージャーサービスの設定 configuring-the-font-manager-service
-
管理者として「AEM Configuration Manager」にログインします。
-
CQ-DAM-Handler-Gibson Font Managers サービスを探して開きます。システムフォント、Adobe サーバーフォント、カスタマーフォントの各ディレクトリのパスを指定します。「保存」をクリックします。
note note NOTE アドビ システムズ社以外が提供しているフォントを使用するユーザーの権利は、それらのフォントを所有する会社が提供する使用許諾契約書に拘束されるもので、アドビソフトウェアを使用するための使用許諾契約書は適用されません。アドビ以外が提供しているフォントをアドビのソフトウェアで使用する前に、適用されるすべてのアドビ以外の使用許諾契約書に準拠していることを確認してください。特に、サーバー環境でフォントを使用する際は注意が必要です。
新しいフォントをフォントフォルダーにインストールしたときは、AEM Forms インスタンスを再起動してください。
PDF Generator サービスを実行するためのローカルユーザーアカウントの設定 configure-a-local-user-account-to-run-the-pdf-generator-service
PDF Generator サービスを実行するには、ローカルユーザーのアカウントが必要です。ローカルユーザーを作成する手順については、「Windows のユーザー アカウントを作成する」または「UNIX ベースのプラットフォームでユーザーアカウントを作成する」を参照してください。
-
AEM Forms PDF Generator の設定ページを開きます。
-
「ユーザーアカウント」タブでローカルユーザーのアカウントの資格情報を入力し、「送信」をクリックします。Microsoft® Windows のプロンプトが表示されたら、ユーザーにアクセスを許可します。正常に追加されると、設定されたユーザーが「ユーザーアカウント」タブの「ユーザーアカウント」セクションに表示されます。
タイムアウトの設定 configure-the-time-out-settings
-
AEM Configuration Manager で、Jacorb ORB Provider サービスを開きます。
次のプロパティを「Custom Properties.name」フィールドに追加し、「保存」をクリックします。これで、保留中の応答タイムアウト(「CORBA クライアントのタイムアウト」とも呼ばれます)が 600 秒に設定されます。
jacorb.connection.client.pending_reply_timeout=600000
-
AEM オーサーインスタンスにログインし、Adobe Experience Manager/ツール/Forms/PDF Generator を設定 に移動します。デフォルトの URL は http://localhost:4502/libs/fd/pdfg/config/ui.html です。
「一般的な設定」タブを開いて、自分の環境に合わせて以下のフィールドの値を変更します。
(Windows のみ)PDF Generator サービス用 Acrobat の設定 configure-acrobat-for-the-pdf-generator-service
Microsoft® Windows では、PDF Generator サービスは Adobe Acrobat を使用して、サポートしているファイル形式を PDF ドキュメントに変換します。以下の手順を実行して、Adobe Acrobat を PDF Generator サービスに設定します。
-
Acrobat を開き、「編集」/「環境設定」/「Updater」を選択します。「アップデートの有無をチェック」で「アップデートを自動的にインストール」のチェックを解除し、「OK」をクリックします。Acrobat を終了します。
-
システム上の PDF ドキュメントをダブルクリックします。Acrobat の初回起動時に、ログインのダイアログボックス、スタートアップスクリーンおよび EULA が表示されます。PDF Generator を使用するように設定されているすべてのユーザーに対して、このダイアログボックスを解除します。
-
PDF Generator ユーティリティのバッチファイルを実行して、Adobe Acrobat を PDF Generator サービス用に設定します。
-
AEM パッケージマネージャーを開き、
adobe-aemfd-pdfg-common-pkg-[version].zip
ファイルをパッケージマネージャーからダウンロードします。 -
ダウンロードした .zip ファイルを解凍します。管理者権限でコマンドプロンプトを開きます。
-
[extracted-zip-file]\jcr_root\etc\packages\day\cq60\fd\adobe-aemds-common-pkg-[version]\jcr_root\etc\packages\day\cq60\fd\
に移動します。 -
adobe-aemfd-pdfg-common-pkg-[version]
を解凍します。 -
[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 サービスを実行するように設定されます。
-
-
System Readiness Tool(SRT)を実行して、Acrobat のインストールを検証します。
(Windows のみ)HTML から PDF への変換のためのプライマリルートの設定 configure-primary-route-for-html-to-pdf-conversion-windows-only
PDF Generator サービスは、HTML ファイルを PDF ドキュメントに変換する複数のルート(Webkit、Acrobat WebCapture(Windows のみ)および WebToPDF)を提供します。アドビでは、WebToPDF ルートを使用することを推奨しています。動的コンテンツを処理する機能を持ち、32 ビットライブラリに依存せず、追加フォントを必要としないからです。また、WebToPDF ルートでは、変換を実行するための sudo または root アクセスは必要ありません。
HTML から PDF への変換のデフォルトのプライマリルートは WebKit です。変換ルートを変更するには:
-
AEM オーサーインスタンスで、「ツール」/「フォーム」/「PDF Generator を設定」に移動します。
-
「一般的な設定」タブで、「HTML を PDF へ変換するプライマリルート」ドロップダウンから希望の変換ルートを選択します。
グローバル Trust Store の初期化 intialize-global-trust-store
Trust Store 管理を使用すると、電子署名の検証および証明書認証のために、サーバー上で信頼する証明書の読み込み、編集、削除ができます。証明書はいくつでも読み込みと書き出しを行うことができます。証明書が読み込まれたら、信頼設定および Trust Store のタイプを編集できます。Trust Store を初期化するには、以下の手順を実行します。
- AEM Forms インスタンスに管理者としてログインします。
- ツール/セキュリティ/Trust Store に移動します。
- 「Trust Store を作成」をクリックします。パスワードを設定して「保存」を選択します。
Reader 拡張機能および暗号化サービス用の証明書を設定します。 set-up-certificates-for-reader-extension-and-encryption-service
DocAssurance サービスは PDF ドキュメントに使用権限を適用できます。PDF ドキュメントに使用権限を適用するには、証明書を設定します。
証明書を設定する前に、次が揃っていることを確認します。
-
証明書ファイル(.pfx)。
-
証明書ファイルとともに提供する秘密鍵パスワード。
-
秘密鍵のエイリアス。Java keytool コマンドを実行し、秘密鍵エイリアスを表示します。
keytool -list -v -keystore [keystore-file] -storetype pkcs12
-
キーストアファイルのパスワード。アドビの Reader Extensions 証明書を使用している場合、Keystore ファイルのパスワードは常に秘密鍵のパスワードと同一です。
証明書を設定するには、以下の手順を実行します。
-
AEM オーサーインスタンスに管理者としてログインします。「ツール」/「セキュリティ」/「ユーザー」に移動します。
-
ユーザーアカウントの 名前 フィールドをクリックします。ユーザー設定を編集 ページが開きます。AEM オーサーインスタンスでは、証明書は KeyStore にあります。KeyStore をまだ作成していない場合は、「KeyStore を作成」をクリックして、KeyStore の新しいパスワードを設定します。KeyStore がサーバーに既にある場合は、この手順をスキップします。アドビの Reader Extensions 証明書を使用している場合、Keystore ファイルのパスワードは常に秘密鍵のパスワードと同一です。
-
ユーザー設定を編集 ページで「キーストア」タブを選択します。「秘密鍵をキーストアファイルから追加」オプションを展開し、エイリアスを指定します。エイリアスは Reader Extensions の操作を実行する際に使用されます。
-
証明書ファイルをアップロードするには、「キーストアファイルを選択」をクリックし、<filename>.pfx ファイルをアップロードします。
キーストアのパスワード、秘密鍵のパスワード、証明書に関連付けられている 秘密鍵エイリアス を、各フィールドに追加します。「送信」をクリックします。
note note NOTE 実稼働環境では、評価用の資格情報を実稼働用の資格情報に置き換えます。期限切れの資格情報または評価用の資格情報を更新する前に、Reader Extensions の古い資格情報を削除してください。 -
ユーザー設定を編集 ページで「保存して閉じる」をクリックします。
AES-256 を有効にする enable-aes
PDF ファイルに AES 256 暗号化を使用するには、Java Cryptography Extension(JCE)Unlimited Strength Jurisdiction Policy ファイルを入手し、インストールします。jre/lib/security フォルダーの local_policy.jar ファイルと US_export_policy.jar ファイルを置き換えます。例えば、Sun JDK を使用している場合、ダウンロードしたファイルを [JAVA_HOME]/jre/lib/security
フォルダーにコピーします。
Assembler サービスは、Reader Extensions サービス、Signature サービス、Forms サービス、Output サービスに依存します。次の手順を実行し、必要なサービスが稼働していることを確認します。
- 管理者として URL
https://'[server]:[port]'/system/console/bundles
にログインします。 - 次のサービスを検索し、サービスが稼働していることを確認します。
(Windows のみ)Microsoft® Project のレジストリエントリを設定 configure-registry-entry-for-microsoft-project
AEM Forms アドオンと Microsoft® Project をマシンにインストールしたら、64 ビットの場所に Microsoft® Project のエントリを登録します。これにより、プロジェクトから PDFG への変換テストの実行が簡単になります。レジストリエントリのプロセスの概要を示す手順は次のとおりです。
- Microsoft® Windows レジストリエディター(regedit)を開きます。レジストリエディターを開くには、スタート/ファイル名を指定して実行に移動し、「regedit」と入力して、「OK」をクリックします。
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Adobe\Acrobat PDFMaker\<version>\Office\SupportedApp
に移動し、新しい バイナリ値 レジストリを作成して、名前を プロジェクト に変更します。- 作成したバイナリレジストリのデータ値を 01 に変更し、「OK」をクリックします。
- レジストリエントリを閉じます。
既知の問題とトラブルシューティング known-issues-and-troubleshooting
-
入力用 zip ファイルにファイル名が 2 バイト文字の HTML ファイルが含まれている場合、HTML から PDF への変換は失敗します。この問題を回避するには、HTML ファイルに名前を付けるときに 2 バイト文字を使用しないようにします。
-
UNIX ベースのオペレーティングシステムでは、以下を実行して不足しているライブラリを見つけます。
-
[crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/
に移動します。 -
次のコマンドを実行して、WebToPDF が HTML から PDF への変換に必要とするすべてのライブラリを一覧表示します。
ldd phantomjs
次のコマンドを実行して、不足しているライブラリを一覧表示します。
ldd phantomjs | grep not
-
不足しているライブラリを手動でインストールします。
System Readiness Tool(SRT) SRT
System Readiness ツールは、PDF Generator 変換を実行するようにマシンが正しく設定されているかどうかを確認します。ツールは、指定されたパスでレポートを生成します。ツールを実行するには:
-
コマンドプロンプトを開きます。
[extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools
フォルダーに移動します。 -
コマンドプロンプトから次のコマンドを実行します。
java -jar forms-srt-[version].jar [Path_of_reports_folder] en
このコマンドは、レポートを生成し、 srt_config.yaml ファイルも作成します。SRT ツールのオプションを設定する場合に使用できます。 SRT ツールのオプションを設定するオプションです。
note note NOTE - pdfgen.api ファイルが Acrobat プラグインフォルダーで使用できないことが System Readiness ツールから報告された場合は、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
ディレクトリにコピーします。
- pdfgen.api ファイルが Acrobat プラグインフォルダーで使用できないことが System Readiness ツールから報告された場合は、pdfgen.api ファイルを
-
[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:
- Locale: これは必須パラメーターです。英語(en)、ドイツ語(de)、フランス語(fr)、日本語(ja)をサポートしています。 デフォルト値は en です。OSGi 上の AEM Forms で実行される PDF Generator サービスには影響しません。
- aemTempDir: これはオプションのパラメーターです。Adobe Experience Manager の一時的な保存場所を指定します。
- users: これはオプションのパラメーターです。ユーザーを指定して、そのユーザーが PDF Generator の実行に必要なディレクトリに対する必要な権限と読み取り/書き込みアクセス権を持っているかどうかを確認できます。 ユーザーが指定されていない場合、ユーザー固有のチェックはスキップされ、失敗としてレポートに表示されます。
- outputDir: SRT レポートを保存する場所を指定します。 デフォルトの場所は、SRT ツールの現在の作業ディレクトリです。
トラブルシューティング
SRT ツールが報告する問題をすべて修正した後でも問題が発生した場合は、次のチェックを実行します。
次のチェックを実行する前に、System Readiness ツールがエラーを報告していないことを確認します。
- Microsoft® Office(32 ビット)と Adobe Acrobat のサポート対象バージョンのみがインストールされ、ダイアログを開く操作がキャンセルされていることを確認します。
- Adobe Acrobat アップデートサービスが無効になっていることを確認します。
- Acrobat_for_PDFG_Configuration.bat バッチファイルが管理者権限で実行されたことを確認します。
- PDF Generator ユーザーが PDF 設定 UI に追加されていることを確認します。
- プロセスレベルトークンの置き換え権限が PDF Generator ユーザーに追加されていることを確認します。
- Acrobat PDFMaker Office COM Addin が Microsoft Office アプリケーションで有効になっていることを確認します。
Microsoft® Windows
-
Microsoft Office 32 ビットサポート対象バージョンのインストールが完了していること、およびすべてのアプリケーションでダイアログを開くことがキャンセルされていることを確認します。
-
PDF Generator ユーザーが PDF 設定 UI に追加されていることを確認します。
-
PDF Generator ユーザーが管理グループのメンバーであり、プロセスレベルトークンの置き換え権限がそのユーザーに対して設定されていることを確認します。
-
ユーザーが PDF Generator UI で設定されており、次のアクションを実行していることを確認します。
- Microsoft® Windows に、PDF Generator ユーザーでログインします。
- Microsoft® Office または OpenOffice アプリケーションを開き、すべてのダイアログをキャンセルします。
- AdobePDF をデフォルトのプリンターとして設定します。
- Acrobat を PDF ファイルのデフォルトプログラムに設定します。
- Microsoft Office アプリケーションのファイル/印刷および Acrobat リボンを使用して手動変換を実行し、すべてのダイアログをキャンセルします。
- winword.exe、powerpoint.exe、excel.exe など、変換に関連するすべてのプロセスを終了します。
- AEM Forms サーバーを再起動します。
Linux®
-
OpenOffice のサポート対象バージョンをインストールします。AEM Formsは、32 ビットバージョンと 64 ビットバージョンの両方をサポートしています。 インストール後、すべての OpenOffice アプリケーションを開き、すべてのダイアログウィンドウをキャンセルして、アプリケーションを閉じます。 アプリケーションを再度開き、OpenOffice アプリケーションを開く際にダイアログボックスが表示されないことを確認します。
-
環境変数
OpenOffice_PATH
を作成し、コンソールまたは dt(デバイスツリー)プロファイルに設定されている OpenOffice のインストール先を指すように設定します。 -
OpenOffice のインストールに問題がある場合は、OpenOffice のインストールに必要な 32 ビットライブラリが利用可能であることを確認します。
- フォントディレクトリが 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
(AIX® では libcurl.a)、/usr/lib/libcrypto.so
(AIX® では libcrypto.a)および/usr/lib/libssl.so
(AIX® では libssl.a)も作成します。 -
以下の手順を実行して、IBM® SSL ソケットプロバイダーを設定します。
-
java.security ファイルを
<WAS_Installed_JAVA>\jre\lib\security
から AEM Forms Server 上の任意の場所にコピーします。デフォルトの場所は<WAS_Installed>\Appserver\java_[version]\jre\lib\security
.です。 -
コピー先の java.security ファイルを編集し、デフォルトの SSL Socket factories を JSSE2 factories に変更します(WebSphere® の代わりに JSSE2 factories を使用します)。
次のデフォルトの JSSE socket factories を変更します。
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
-
- Microsoft® Visual C++ 2012 x86 および Microsoft® Visual C++ 2013 x86(32 ビット)の再頒布可能パッケージが Windows にインストールされていることを確認します。
-
Microsoft® Office および OpenOffice の場合は、(各ユーザーと同様に)1 つ以上の変換を手動で実行し、変換時にダイアログがポップアップ表示されないようにします。ダイアログが表示された場合は、ダイアログを閉じます。自動変換時に、このようなダイアログが表示されないようにします。
-
OSGi 環境の AEM Forms で自動処理を実行する前に、テストパッケージがインストールされ、アクティブになっていることを確認します。
-
特定のユーザーが変換に失敗したかどうかを確認するには、サーバーログを確認します。(プロセスエクスプローラは、異なるユーザーの実行中のプロセスを確認するのに役立ちます)
-
PDF Generator 用に設定したユーザーに、ローカルの管理者権限が付与されていることを確認します。
-
PDF Generator ユーザーに、LC 一時ユーザーと PDFG 一時ユーザーに対する読み取り、書き込み、実行の権限があることを確認します。
-
Microsoft® Office および OpenOffice の場合は、(各ユーザーと同様に)1 つ以上の変換を手動で実行し、変換時にダイアログがポップアップ表示されないようにします。ダイアログが表示された場合は、ダイアログを閉じます。自動変換時に、このようなダイアログが表示されないようにします。
-
サンプル変換を実行します。
-
Adobe Acrobat の既存のライセンスを持っていて、そのライセンスが期限切れの場合、最新バージョンの Adobe Application Manager をダウンロードし、シリアル番号を移行します。シリアル番号の移行前に以下のことを行います。
-
次のコマンドを使用して prov.xml を生成し、シリアル番号の移行の記事で提供されているコマンドの代わりに、prov.xml ファイルを使用して既存のインストールを再シリアル化します。
code language-none ``` adobe_prtk --tool=VolumeSerialize --generate --serial=<serialnum> [--leid=<LEID>] [--regsuppress=ss] [--eulasuppress] [--locales=limited list of locales in xx_XX format or ALL>] [--provfile=<Absolute path to prov.xml>] ```
-
パッケージをボリュームシリアライズします(prov.xml ファイルと新しいシリアルを使用して既存のインストールを再シリアライズします)。PRTK インストールフォルダーから次のコマンドを管理者として実行し、クライアントマシンにデプロイされたパッケージをシリアライズしてアクティベートします。
code language-none ``` adobe_prtk --tool=VolumeSerialize --provfile=C:\prov.xml –stream ```
-
-
大規模インストールの場合は、Acrobat Customization Wizard をクリックして、以前のバージョンの Reader と Acrobat を削除します。インストーラーをカスタマイズし、組織のすべてのマシンにデプロイします。
- アドビ製品の初回起動から 7 日以内にオンラインにアクセスして、オンラインでのアクティベーションと登録を完了したり、インターネット対応デバイスと製品のシリアル番号を使用してこのプロセスを完了したりできます。手順について詳しくは、オフラインアクティベーションを参照してください。
ユーザーが Word ファイルまたは Excel ファイルを Microsoft Windows Server 上で PDF に変換しようとすると、次のエラーが発生します。
プライマリコンバーターからのエラーメッセージ:
ALC-PDG-015-003-システムは入力ファイルを開けません。 ファイルを再度送信するか、システム管理者に問い合わせてください。
この問題を解決するには、Windows Server 上で Word ファイルまたは Excel ファイルを PDF に変換できないを参照してください。
Microsoft® Excel 2019 を Microsoft® Windows Server 2019 上で PDFに変換する場合は、次の点を確認する必要があります。
-
PDF Generator サービスを使用する際は、Windows コンピューターで AEM サーバーとのリモート接続(Windows RDP セッション)をアクティブにしないようにします。
-
デフォルトのプリンターは Adobe PDF に設定する必要があります。
note note NOTE - Apple macOS および Ubuntu OS の場合、前述の設定を行う必要はありません。
次の手順 next-steps
これで、AEM Forms ドキュメントサービスの動作環境が用意できました。ドキュメントサービスは、以下で使用できます。