WFRエージェント操作

次のトピックを参照して、WFRエージェントの起動および停止方法、WFRエージェントのインストール・ディレクトリ内で使用可能な主要なディレクトリ/ファイル、およびインバウンド・メタデータ・アクセス用の読取り専用ビューの作成方法について学習します。

WFRエージェントを起動する方法

WFRエージェントを起動するには:

管理者としてコマンド・プロンプトを実行します。
startWFRAgent.batファイルにナビゲートします。デフォルトのロケーションはC:\Program Files (x86)\Oracle\Oracle WebCenter Forms Recognition Agent\startWFRAgent.batです。

startWFRAgent.batファイルを実行します。

ノート:

startWFRAgent.batファイルを管理者として実行しない場合、コマンド・プロンプトで次のようなエラーが発生します:

C:\Program Files (x86)\Oracle\Oracle WebCenter Forms Recognition
        Agent>startWFRAgent.bat
    2022-01-23 22:38:36,518 main ERROR RollingFileManager (extproc-logs/extproc.log)
      java.io.FileNotFoundException: extproc-logs\extproc.log (Access is denied)
      java.io.FileNotFoundException:
extproc-logs\extproc.log (Access is denied)
at java.io.FileOutputStream.open0(Native Method)
at java.io.FileOutputStream.open(Unknown Source)
at java.io.FileOutputStream.<init>(Unknown Source)
at java.io.FileOutputStream.<init>(Unknown Source)

サーバーの起動を簡単にするには、デスクトップでこのファイルへのショートカットを作成します。エージェントは常に管理者として実行する必要があるため、ショートカットを実行するように構成します。
1. 「開始」メニューから、startWFRAgent.batファイルを検索します。
2. ファイルを右クリックし、「ファイルのロケーションを開く」を選択します。
3. アプリケーション・ショートカットを右クリックし、「プロパティ」を選択します。
4. 「ショートカット」タブで、「上級」をクリックします。
5. 「管理者として実行」オプションを選択します。
6. OKをクリックし、「適用」をクリックし、OKをクリックします。

WFRエージェントを停止する方法

WFRエージェントを停止するには:

WFRエージェントを管理者として起動したコマンド・プロンプトを開き、Ctrl + Cを押します。

次のようなメッセージが表示されます:

2022-01-23 22:38:06,849 [SpringApplicationShutdownHook] INFO  c.z.h.HikariDataSource - HikariPool-1 - Shutdown initiated...
2022-01-23 22:38:06,896 [SpringApplicationShutdownHook] INFO  c.z.h.HikariDataSource - HikariPool-1 - Shutdown completed.
Terminate batch job (Y/N)?

Y/yと入力し、Enterを押します。

WFRエージェントが停止/停止されます。

WFRエージェントのインストール・ディレクトリ内の主要なディレクトリおよびファイル

次の表に、WFRエージェントのインストール・ディレクトリ内に表示されるキー・ディレクトリとファイルを示します。

ディレクトリ/ファイル	ロケーション
問題の診断に役立つ可能性があるWFRエージェント・ログ・ファイル。	`C:\Program Files (x86)\Oracle\Oracle WebCenter Forms Recognition Agent\extproc-logs\extproc.log`
spring-bootアプリケーションのプロパティ・ファイルは、手動で更新または削除しないでください。これを行うと、WFRエージェントが一貫して動作しなくなります。	`C:\Program Files (x86)\Oracle\Oracle WebCenter Forms Recognition Agent\config\application.properties`
SSL証明書が構成されている場合、証明書ファイルは`config`ディレクトリに格納されます。	`C:\Program Files (x86)\Oracle\Oracle WebCenter Forms Recognition Agent\config`
`xpath`ディレクトリは、xPathマッピング用に構成されたすべてのWFRエージェントと、プロシージャ固有のWFR XMLテンプレート・ファイルで構成されます。	`C:\Program Files (x86)\Oracle\Oracle WebCenter Forms Recognition Agent\stage\xpath`
Content Captureのドキュメントは、WFRにインポートされる前に、一時的に`stage`ディレクトリに格納されます。	`C:\Program Files (x86)\Oracle\Oracle WebCenter Forms Recognition Agent\stage`

インバウンドMetadataアクセスの読取り専用ビューの作成方法

WebCenter Forms RecognitionとContent Captureの間のドキュメントのトラッキング、レポートおよび検証をサポートするために、Content Captureに作成されたドキュメント・メタデータは、WFRエージェント・データベースに格納されます。 WebCenter Forms Recognitionは、Content CaptureからWebCenter Forms Recognitionにデータを渡す必要がある場合に、このメタデータを問い合せます。 WFRエージェントを介してドキュメントの進捗をトラッキングできるようにするには、WebCenter Forms RecognitionスキーマからWFRエージェント・データベース・スキーマへのSELECTアクセス権を付与する必要があります。 SELECTアクセスでは、基礎となる表が変更された後でも問合せ可能なWFRエージェント・データベース表のビューを作成することもできます。

ユーザーの作成

SELECTアクセス権をEPDOCUMENTS表に付与するには、WFRエージェント・スキーマの読取り専用ユーザーを作成する必要があります:

"<password>";で識別されるユーザー<username>を作成

たとえば: "welcome1";で識別されるユーザーextproc_read_onlyを作成

付与権限

<privilege>を<user>に付与

たとえば: extproc_read_only;へのセッションの作成の付与

読取り専用ユーザーの作成: 例

SQL> connect <sys as sysdba>/<password>
SQL> create user extproc_read_only identified by welcome1;
SQL> grant create session to extproc_read_only;
SQL> grant select on <wfr_agent_schema_user>.EPDOCUMENTS to extproc_read_only;

EPDOCUMENTS表への読取り専用ユーザー・アクセス: 例

SQL> connect extproc_read_only/welcome1
SQL> select * from <wfr_agent_schema_user>.EPDOCUMENTS;