実行時に処理されるプロセスインスタンスを記録し、それを再生してプロセスの動作を観察します。
記録と再生は、ステージング環境で正式なテストを実行する前に開発環境でプロセスバージョンをテストするのに便利です。
注意:
プロセスに操作が含まれていないか、イベントスタートポイントのみが含まれている場合は、Decision Point 操作をプロセスダイアグラムに追加して、プロセス入力変数の値が記録されるようにします。
プロセスの記録は、AEM forms サーバー上に保存され、他の Workbench を実行している他の開発者が利用できます。
プロセスを記録および再生してプロセスバージョンをテストする前に、それらのバージョンを検証する必要があります(
検証レポート
を参照)。
次の手順では、プロセスの実行を記録して再生するために実行するタスクについて説明します。
-
プロセスバージョンの記録を有効にします(
記録の有効化と無効化
を参照)。
-
プロセスを呼び出すときに、プロセスを記録および再生します(
プロセスの直接呼び出し
を参照)。
-
プロセスバージョンを呼び出します(
プロセスバージョンの呼び出し
を参照)。
-
記録されたプロセスインスタンスを再生します(
プロセス記録の再生
を参照)。
-
不要になった記録済みプロセスインスタンスを削除します(
記録の削除
を参照)。
-
プロセスバージョンの記録を無効にします(
記録の有効化と無効化
を参照)。
注意:
プロセスインスタンスで永久ループが実行されている場合は、プロセスインスタンスごとに最大 250 個の操作実行を記録できます。この制限により、永久ループが発生した場合に、サーバーリソースが保持されます。
記録の有効化と無効化
プロセスバージョンの実行履歴を記録するようにプロセスバージョンの記録を有効にします。記録を有効にすると、プロセスバージョンが呼び出されるたびに新しい記録が保存されます。プロセス実行を記録する必要がなくなった場合は、記録を無効にします。
注意:
記録では、AEM forms サーバー上のリソースが使用され、パフォーマンスが低下します。記録は、開発環境でのみ実行してください。
プロセスバージョンの記録を有効にすると、プロセスビューのプロセスバージョンのアイコンには、右上隅にある赤い記録ボタンのイメージ
が含まれます。
プロセスバージョンの記録を作成し、プロセスバージョンを変更しても、記録は再生できます。
記録を有効にするには、プロセスバージョンをアクティブにする必要があります。
プロセスを呼び出すときに記録プロセス実行を有効にすることもできます(
プロセスの直接呼び出し
を参照)。
プロセスバージョンの記録を有効または無効にするには:
アプリケーションビューで、プロセスバージョンを右クリックし、Record And Playback/Start Recording または Record And Playback/Stop Recording をクリックします。
プロセスバージョンで記録が有効になっている場合、プロセスが無効になると記録は自動的に停止します。
プロセスバージョンが開いている場合は、プロセスダイアグラムの未使用領域を右クリックしてコマンドにアクセスできます。
プロセスバージョンの呼び出し
プロセスバージョンの記録を有効にし、プロセスバージョンを呼び出すと、生成されるプロセスインスタンスの実行が記録されます。Workbench を使用して直接プロセスバージョンを呼び出すか、プロセスサービスに設定されているエンドポイントを使用して呼び出すことができます。
プロセスの直接呼び出し
テストのために、Workbench 内からプロセスバージョンを呼び出すことができます。直接呼び出しは、プロセスバージョン機能にのみ重点を置く場合に便利です。
プロセスバージョンに重点を置いたテストの後、実稼働環境で予想される使用シナリオを模したテストを実行する必要があります(
現実的なシナリオの使用テスト
を参照)。
プロセスバージョンを直接呼び出す場合は、入力変数の値を指定します。プロセス実行の結果がダイアログボックスに表示されます。ダイアログボックスに表示される情報は、プロセスバージョンが長期間有効であるか、短時間のみ有効であるかによって異なります。
-
長期間有効:
-
ダイアログボックスには、プロセスインスタンスの ID が示されます(
短時間のみ有効なプロセスと長期間有効なプロセス
を参照)。
-
短時間のみ有効:
-
ダイアログボックスには、プロセスインスタンスの出力変数の値が示されます。
プロセスバージョンを複数回呼び出す場合は、入力変数に同じ値または別々の値を指定できます。
プロセスを呼び出すときに必要に応じてプロセス実行を記録したり再生したりできます。
プロセスバージョンを直接呼び出すには:
-
アプリケーションビューで、プロセスバージョンを右クリックして「Invoke Process」を選択します。
-
プロセスバージョンの入力変数の値を指定します。必須の値には、アスタリスク(*)が付いています。
-
(オプション)プロセス実行を記録するには、次のいずれかを実行します。
-
「OK」をクリックします。
プロセスバージョンが開いている場合は、プロセスダイアグラムの未使用領域を右クリックして「Invoke Process」コマンドにアクセスできます。
エンドポイントを使用したプロセスの呼び出し
プロセスバージョンを呼び出して実行し、プロセスインスタンスを作成します。プロセスバージョンは、AEM forms に用意されている様々なツールを使用して呼び出すことができます。
プロセスバージョンをアクティブ化した後、プロセスバージョンのサービス用に EJB、SOAP およびリモートエンドポイントが自動的に作成されます。監視フォルダー、電子メールおよび TaskManager エンドポイントは、アプリケーションとサービスを使用して手動で作成する必要があります。
エンドポイントの作成に関する詳細は、『
アプリケーションおよびサービスの管理ヘルプ
』の「エンドポイントの管理」を参照してください。
プロセス記録の再生
記録済みのプロセスインスタンスを再生して、実行時の動作を観察します。記録を再生すると、関連付けられているプロセスバージョンが再生モードで開きます。
記録を再生すると、各操作の実行後にプロセス変数に含まれる値を表示できます。この情報は、予期しない動作のトラブルシューティングに役立ちます。
再生モードで記録を開く
実行時に使用されたルートを表示できるように記録を再生モードで開き、記録を再生します。
注意:
記録を再生モードで開いている間はプロセスマップを編集できません。
記録を再生モードで開くには、既存の記録のリストから記録を選択します。リストには、関心のある記録を識別できるように、次の情報が含まれています。
-
プロセスインスタンス ID:
-
記録されたプロセスインスタンスの固有の識別子
-
記録の開始日時:
-
記録されたプロセスインスタンスが呼び出された日時
-
プロセスバージョン:
-
プロセスバージョンの番号およびリビジョンが保存された日時
記録は、その記録の作成に使用されたプロセスバージョンのリビジョンに関連付けられています。プロセスバージョンの前のリビジョンで作成された記録を開くと、プロセスダイアグラムは、そのリビジョンの場合と同じように表示されます。
例えば、あるプロセスバージョンの記録を作成した後、操作をプロセスマップに追加し、変更を保存するとします。作成した記録は、プロセスバージョンの前のリビジョンに関連付けられています。プロセス記録を再生モードで開くと、表示されるプロセスダイアグラムには、最後のリビジョンで保存した操作は含まれません。
記録を再生および削除するには、プロセス管理者ロールがアサインされているか、Process Recording Read/Delete 権限が必要です。AEM forms 管理者に問い合わせるか、管理コンソールを使用してこれらの権限を設定してください。
記録を再生モードで開くには:
-
アプリケーションビューで、記録を再生するプロセスバージョンを右クリックし、Record And Playback/Play Process Recording を選択します。
-
再生する記録を選択し、「OK」をクリックします。
プロセスバージョンが開いている場合は、プロセスダイアグラムの未使用領域を右クリックして「Record And Playback」コマンドにアクセスできます。
記録の再生
記録済みのプロセスインスタンスを再生して、実行時のプロセス動作を観察します。再生時に、操作ごとの変数値と発生したエラーに関する情報を確認できます(
記録の解釈
を参照)。
記録を再生すると、実行中にプロセスインスタンスの現在の状態が進行状況バーに表示されます。
-
進行状況バーの目盛りは、実行時に行われた操作を表します。
-
進行状況の方向は左から右です。進行状況バーの最初の目盛りは、実行前のプロセスを表します。
-
進行状況バーのスライダーは、現在の進行状況を示します。スライダーが配置されている目盛りは、実行が完了した最後の操作を表します。この操作は、プロセスダイアログでもハイライト表示されます。
例えば、5 つの目盛りを含む進行状況バーは、4 つの操作が実行されたことを示します。再生中に、スライダーが 3 番目の目盛りに配置された場合は、4 つの操作中 2 番目の操作の実行が完了しています。
記録全体を再生するか、記録をステップごとに手動で再生できます。記録をステップごとに手動で再生した場合は、各操作の変数値を監察するのに時間がかかります。
記録全体を再生するには:
-
再生ボタン
をクリックします。
再生中は、再生ボタンの代わりに一時停止ボタンが表示されます。
-
目盛りで再生を一時停止するには、一時停止ボタン
をクリックします。
記録をステップごとに手動で再生するには:
-
次の目盛りに進むには、次へ進むボタン
をクリックするか、進行状況バーの次の目盛りをクリックします。
-
前の目盛りに移動するには、前へ戻るボタン
をクリックするか、進行状況バーの前の目盛りをクリックします。
記録の解釈
プロセスダイアグラムの視覚表示により、プロセス実行の結果に関する情報が示されます。
変数ビューを使用して、変数の実行時の値を表示します。
-
値は、再生中の実行の現在の状態に対応します。
-
値が変更された変数は、緑色でハイライト表示されます。変数は、変更が行われるステップでのみハイライト表示されます。
-
単純なデータ型の値がビューに表示されます。複雑なデータ型の値は、別のダイアログボックスに表示されます。
-
変数値がドキュメントの場合は、ドキュメントを関連付けられているアプリケーションで開くことができます。例えば、オペレーティングシステムで XML ファイルが Web ブラウザーに関連付けられている場合、XML ファイルは Web ブラウザーで開きます。
-
変数がフォームデータとフォームの場所の格納に使用されている場合は、フォームを開いてフォームのデータを表示できます。
変数ビューには、実行中に発生したエラーに関する情報も表示されます。ビュー内のエラーは赤色でハイライト表示されます。列には次の情報が含まれます。
-
名前:
-
Error
が含まれます。
-
Type:
-
エラーのタイプとエラーメッセージです。
-
値:
-
省略記号ボタンをクリックすると Error ダイアログボックスが開き、エラーメッセージとスタックトレースが表示されます。この情報は、エラーの原因の特定に使用します。
実行中にエラーが発生しなかった場合は、変数ビューにエラー行が表示されません。
再生中に変数値を確認するには:
記録の再生時に、変数ビューの Value 列の値を確認します。複雑なデータ型、ドキュメント、リストおよびマップの場合は、省略記号ボタン
をクリックしてデータを表示するか、ドキュメントを開きます。
変数を右クリックし、「Copy」を選択して変数の値をコピーします。他の開発者と通信するために、電子メールメッセージに値を貼り付けることができます。
エラーに関する詳細を表示するには:
-
変数ビューのエラー行で、Value 列の省略記号ボタン
をクリックします。
-
「Details」をクリックしてスタックトレースを表示します。
記録の削除
記録は、不要になったときにいつでも削除できます。
記録を削除するには、プロセス管理者ロールがアサインされているか、Process Recording Read/Delete 権限が必要です。AEM forms 管理者に問い合わせるか、管理コンソールを使用してこれらの権限を設定してください。
記録を削除するには:
-
アプリケーションビューで、記録を再生するプロセスバージョンを右クリックし、Record And Playback/Delete Process Recordings を選択します。
-
削除する記録を指定します。
-
「OK」をクリックします。
記録および再生動作のカスタマイズ
記録および再生機能の動作の一部を制御する、いくつかの環境設定を設定できます。次の表に、設定できる環境設定を示します。
環境設定
|
デフォルト値
|
説明
|
-Dcom.adobe.workbench.recordings.remove_on_save
|
false
|
プロセスバージョンを保存するときにプロセスバージョンの記録を削除するかどうかを制御します。
値が
true
の場合、プロセスバージョンの前のリビジョンに関連付けられている記録は保持されます。
|
-Dcom.adobe.workbench.recordings.remove_on_delete
|
true
|
プロセスバージョンを削除するときにプロセスバージョンの記録を削除するかどうかを制御します。
値が
true
の場合、プロセスバージョンの削除時にそのすべての記録が削除されます。
|
-Dcom.adobe.workbench.playback.max_recordings_to_display
|
100
|
削除または再生する記録を選択するときにリストに表示される記録の最大数です。
|
-Dcom.adobe.workbench.playback.animation.milliseconds_to_delay
|
2000
|
記録を再生するときに進行状況バーの目盛りでスライダーが一時停止する時間(ミリ秒単位)です。
|
-Dcom.adobe.workbench.unsupported.audit.maxNumberOfStepsToLoad
|
250
|
再生できる記録ごとの最大ステップ数です。
|
環境設定を設定するには、workbench.ini ファイルを変更します。ファイルの各行に、次の形式の環境設定が含まれています。
preference_name = value
例えば、次の環境設定では、プロセスバージョンの前のリビジョンの記録を保存するように指定します。
-Dcom.adobe.workbench.recordings.remove_on_save=false
workbench.ini ファイルは [
install directory
]/AEM forms Workbench/Workbench ディレクトリにあります。ここで、[
install directory
] は、Workbench をインストールした場所です。
注意:
-Dcom.adobe.workbench.recordings.remove_on_delete 環境設定が
true
に設定されていますが、管理コンソールでプロセスアーカイブを削除してプロセスバージョンを削除しても、そのプロセスの記録は削除されません。記録を削除するには、Audit Workflow DSC コンポーネントを停止してから起動します(
コンポーネントとサービスの停止
および
コンポーネントとサービスの開始
を参照)。このアクションにより、作成したすべての記録が削除されます。
記録および再生動作をカスタマイズするには:
-
workbench.ini ファイルをテキストエディターで開きます。
-
必要に応じて環境設定の値を変更します。
-
workbench.ini を保存し、Workbench を再起動します。
記録に使用する記憶領域の制限
AEM forms サーバーのファイルシステム上のスペースを確保するには、保存するデータを記録するプロセス用のサイズを制限できます。AuditWorkflowService サービスの次のプロパティを設定できます。
-
maxNumberOfRecordingInstances:
-
保存する記録の最大数です。保存の最大数に達すると、新しい記録が作成されるときに最も古い記録がファイルシステムから削除されます。このプロパティは、多数の記録を作成する可能性が高い場合に、古い記録が自動的に削除されるようにするのに便利です。
-
maxNumberOfRecordingEntries:
-
各記録に保存できるデータエントリの最大数です。データエントリはプロセスの操作に関する情報です。一部のエントリは操作の実行ごとに保存されます。例えば、操作が開始されたかどうか、操作が完了したかどうか、操作を発生させるルートが完了したかどうか、などです。このプロパティは、プロセスに操作の実行が多数含まれる場合(例えば、永久ループが発生した場合など)に便利です。
AuditWorkflowDSC コンポーネントには、AuditWorkflowService サービスが用意されています。サービスプロパティを設定するには、コンポーネントビューを使用します(「
サービス設定の編集
」を参照)。
記録に使用される記憶領域を最小限にするようにプロセスを設計することもできます。
大規模記録用のサーバーメモリの設定
数多くの変数または操作を含むプロセスの記録では、AEM forms サーバーのメモリが大量に使用される場合があります。プロセスの記録を実行すると AEM forms サーバーが不安定になる場合は、アプリケーションサーバーをホストしている Java 仮想マシン(JVM)に、より多くのメモリの割り当てが必要になる可能性があります。また、サーバーをホストしているコンピューターを再起動して、安定性を確保する必要がある場合もあります。
JVM に割り当てるメモリを増やすには、アプリケーションサーバーを実行する JVM の -Xmx オプションを設定します。例えば、現在のオプションが
-Xmx1024m
の場合、
-Xmx1280m
に変更すると、割り当てメモリの最大量を 256 MB 増やすことができます。
次の表に、アプリケーションサーバーで JVM オプションを設定する方法に関する、AEM forms マニュアルへのリンクを示します。
|
|
|