OSGi 上での Forms ベースのワークフローのインストールと設定
はじめに
企業は、複数のフォーム、バックエンドシステム、その他のデータソースからデータを収集して処理します。データの処理には、レビューと承認の手順、繰り返しのタスク、データのアーカイブが含まれます。例えば、フォームをレビューし、PDF ドキュメントに変換する場合などです。手動で行うと、繰り返しタスクに多くの時間と多数のリソースが必要になる場合があります。
OSGi 上の Forms ベースのワークフロー を使用して、アダプティブフォームベースのワークフローを迅速に構築することができます。これらのワークフローは、レビューと承認のワークフロー、ビジネスプロセスのワークフロー、その他の繰り返しタスクの自動化に役立ちます。これらのワークフローは、ドキュメントの処理 (PDF ドキュメントの作成、アセンブリ、配布、アーカイブ、ドキュメントへのアクセスを制限するための電子署名の追加、バーコードフォームのデコードなど ) や、フォームとドキュメントと併せた Adobe Sign 署名ワークフローの使用にも役立ちます。
これらのワークフローを一度設定すると、手動でトリガーして定義済みプロセスを完了することができ、また、ユーザーによるフォームの送信やインタラクティブ通信の際に、ワークフローをプログラムで実行することもできます。これは、AEM Forms のアドオンパッケージに含まれる機能で、
AEM Forms は強力なエンタープライズクラスのプラットフォームです。OSGi 上の Forms ベースのワークフローは、AEM Forms の機能の 1 つに過ぎません。機能の完全な一覧については、「AEM Forms の概要」を参照してください。
NOTEデプロイメントトポロジ
AEM Forms アドオンパッケージは AEM にデプロイされるアプリケーションです。OSGi 機能上で Forms ベースのワークフローを実行するには、最小限の AEM オーサーインスタンスまたは処理インスタンス（実稼動オーサー）が必要です。処理インスタンスは、強化された AEM オーサー インスタンスです。実稼動オーサーでは、ワークフローやアダプティブフォームの作成など、実際のオーサリングを実行しないでください。
次のトポロジは、AEM Forms のインタラクティブ通信、Correspondence Management、AEM Forms のデータ取得および OSGi 機能にある Forms 中心のワークフローを実行するための指標トポロジです。トポロジーについて詳しくは、「AEM Forms のアーキテクチャとデプロイメントトポロジー」を参照してください。
OSGi 上の AEM Forms の Forms ベースのワークフローは、AEM Form のオーサーインスタンス上で、AEM インボックスと AEM ワークフローモデルの作成 UI を実行します。
システム要件
NOTEForms ベースのワークフローを OSGi 上でのインストールと設定を開始する前に、以下を確認してください。
-
ハードウェアとソフトウェアのインフラが正しく設定されていること。サポート対象のハードウェアとソフトウェアの一覧について詳しくは、「技術要件」を参照してください。
-
AEM インスタンスのインストールパスに空白が含まれていないこと。
-
AEM インスタンスが稼働していること。AEM の用語では、「インスタンス」とは、サーバー上でオーサーモードまたはパブリッシュモードで実行されている AEM のコピーのことです。OSGi 上で Forms ベースのワークフローを実行するには、少なくとも 1 つの AEM インスタンス（オーサーまたは処理）が必要です。
-
オーサー：コンテンツの作成、アップロードおよび編集や web サイトの管理に使用される AEM インスタンス。公開の準備が整ったコンテンツは、パブリッシュインスタンスにレプリケートされます。
-
処理： 処理インスタンスは、強化された AEM オーサーインスタンスです。オーサーインスタンスを設定し、インストールを実行した後でこれを強化することができます。
-
パブリッシュ：公開されたコンテンツをインターネットまたは社内ネットワークを通じて提供する AEM インスタンス。
-
-
メモリ要件が満たされていること。AEM Forms アドオンパッケージでは、次が必要です。
- Microsoft Windows ベースのインストールの場合、15 GB の一時的な空きスペースが必要です。
- Unix ベースのインストールの場合、6 GB の一時的な空きスペースが必要です。
-
Unix ベースのシステムの追加必要システム構成：Unix ベースのオペレーティングシステムを使用する場合は、それぞれのオペレーティングシステムのインストールメディアから、次のパッケージをインストールしてください。
AEM Forms アドオンパッケージのインストール
AEM Forms アドオンパッケージは AEM にデプロイされるアプリケーションです。このパッケージには、OSGi 上の 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 ファイルに表示されなくなり、このログファイルが安定した状態になるまで待ってください。
NOTE「Ctrl + C」コマンドを使用して SDK を再起動することをお勧めします。 Java プロセスの停止など、別の方法を使用して AEM SDK を再起動すると、AEM 開発環境で不整合が生じる場合があります。 -
手順 1 から 7 を、すべてのオーサーインスタンスとパブリッシュインスタンスで繰り返します。
インストール後の設定
AEM Forms には、必須の設定とオプションの設定がいくつかあります。必須の設定には、BouncyCastle ライブラリおよびシリアル化エージェントの設定が含まれます。オプションの設定には、ディスパッチャーおよび Adobe Target の設定が含まれます。
インストール後の必須の設定
RSA ライブラリと BouncyCastle ライブラリの設定
これらのライブラリを起動するには、すべてのオーサーインスタンスとパブリッシュインスタンスで次の手順を実行します。
-
基になる AEM インスタンスを停止します。
-
編集用に [AEM インストールディレクトリ ]\crx-quickstart\conf\sling.properties ファイルを開きます。
[AEM インストールディレクトリ ]\crx-quickstart\bin\start.bat を使用して AEM を起動する場合は、[AEM ルート ]\crx-quickstart\ にある sling.properties を編集してください。
-
以下のプロパティを sling.properties ファイルに追加します。
sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.* -
ファイルを保存して閉じ、AEM インスタンスを起動します。
-
手順 1 から 4 を、すべてのオーサーインスタンスとパブリッシュインスタンスで繰り返します。
シリアル化エージェントの設定
このパッケージを許可リストに加えるには、オーサーインスタンスとパブリッシュインスタンスの両方で以下の手順を実行します。
- ブラウザーウィンドウで、AEM Configuration Manager を開きます。デフォルトの URL は https://'[server]:[port]'/system/console/configMgr です。
- デシリアライゼーションファイアウォール設定 を検索して開きます。
- sun.util.calendar パッケージを 許可リストに加える フィールドに追加します。「保存」をクリックします。
- 手順 1 から 3 を、すべてのオーサーインスタンスとパブリッシュインスタンスで繰り返します。
インストール後のオプションの設定
Dispatcher の設定
Dispatcher は、キャッシングとロードバランシングを行うための AEM ツールです。AEM Dispatcher を使用すると、AEM サーバーを攻撃から保護するのにも役立ちます。エンタープライズクラスの Web サーバーと共に Dispatcher を使用すると、AEM インスタンスのセキュリティを高められます。ディスパッチャーを使用する場合は、AEM Forms の次の設定を実行してください。
-
AEM Forms のアクセスの設定：
dispatcher.any ファイルを開いて編集します。フィルターセクションに移動し、次のフィルターをフィルターセクションに追加します。
/0025 { /type "allow" /glob "* /bin/xfaforms/submitaction*" } # to enable AEM Forms submissionファイルを保存して閉じます。フィルターについて詳しくは、Dispatcher のドキュメントを参照してください。
-
リファラーフィルターサービスの設定：
Apache Felix Configuration Manager に管理者としてログインします。Configuration Manager のデフォルト URL は https://'server':[port_number]/system/console/configMgr です。Configurations メニューで「Apache Sling Referrer Filter」を選択します。「Allow Hosts」フィールドで、ディスパッチャーのホスト名を入力してそれをリファラーとして許可し、「保存」をクリックします。URL の形式は、
https://'[server]:[port]'です。
キャッシュを設定
キャッシュは、データへのアクセスにかかる時間を短縮し、待ち時間を削減して I/O（入出力）速度を改善するメカニズムです。アダプティブフォームのキャッシュは、アダプティブフォームの HTML コンテンツと JSON の構造のみを保存し、事前入力されたデータは保存しません。これにより、アダプティブフォームのレンダリングの時間を短縮します。
- アダプティブフォームのキャッシュを使用するときは、AEM Dispatcher を使用してアダプティブフォームのクライアントライブラリ（CSS および JavaScript）をキャッシュします。
- カスタムコンポーネントの開発時には、開発に使用されるサーバー上でアダプティブフォームのキャッシュを無効にしておく必要があります。
次の手順を実行してアダプティブフォームのキャッシュを設定します。
-
https://'[server]:[port]'/system/console/configMgrの AEM Web コンソール設定マネージャーに移動します。 -
「アダプティブフォームおよびインタラクティブ通信 Web チャネルの設定」をクリックして、設定値を編集します。設定値を編集ダイアログで、AEM Forms サーバーのインスタンスでキャッシュできるフォームまたはドキュメントの最大数を「アダプティブフォームの数」フィールドに指定します。デフォルト値は 100 です。「保存」をクリックします。
NOTEキャッシュを無効にするには、「アダプティブフォームの数」フィールドの値を 0 に設定します。キャッシュ設定を無効にしたり変更したりすると、キャッシュがリセットされ、すべてのフォームとドキュメントがキャッシュから削除されます。
Adobe Sign を設定
Adobe Sign では、アダプティブフォームの電子サインワークフローを有効にすることができます。電子サインを使用すると、法務、販売、給与、人事管理など、様々な分野におけるドキュメント処理ワークフローが改善されます。
OSGi シナリオ上の Adobe Sign とフォームベースの一般的なワークフローでは、サービスを申し込む ためのアダプティブフォームに、ユーザーが入力します。例えば、クレジットカードの申込フォームや住民サービスフォームなどです。ユーザーが申し込みフォームに入力、送信、署名すると、承認または却下のワークフローが開始されます。サービスプロバイダーは、AEM インボックスでアプリケーションを確認し、Adobe Sign を使用してアプリケーションに電子署名します。これに類似した電子署名ワークフローを有効にするには、Adobe Sign を AEM Forms に統合します。
AEM Forms で Adobe Sign を使用するには、Adobe Sign を AEM Forms に統合を参照してください。
次の手順
OSGi 機能上で Forms ベースのワークフローを使用する環境を設定しました。この機能を使用するための手順は、次のとおりです。
