はじめに

WinActorのライブラリ等のWinActorモジュールを使用して、株式会社アジラのAI-OCRサービス「ジジラ」にChromeブラウザで定型機能を使用したOCRへPDFファイルをアップロードしてOCR実行結果のCSVファイルをダウンロードするサンプルシナリオについて説明します。

本サンプルシナリオの概要

本サンプルシナリオは、以下の処理を行います。

• Chromeブラウザを起動してジジラにログインします。
• 定型種別を選択します。
• ジジラに読み取りを行うPDFファイルをアップロードします。
• ジジラのOCRを実行します。
• OCR実行結果のCSVファイルをダウンロードします。

使用するWinActorモジュール

本サンプルシナリオでは、以下のWinActorモジュールを使用します。

• ノード/アクション/ウィンドウ状態待機
• ノード/アクション/指定時間待機
• 04_自動記録アクション/クリック(WIN32).ums6
• 04_自動記録アクション/文字列設定(WIN32).ums6
• 07_文字列操作/03_連結/文字列の連結(３つ).ums6
• 11_ウィンドウ関連/画面サイズ、位置設定.ums6
• 23_ブラウザ関連/クリック.ums6
• 23_ブラウザ関連/ブラウザクローズ.ums6
• 23_ブラウザ関連/ブラウザ起動(プロキシ設定).ums6
• 23_ブラウザ関連/ページ表示.ums6
• 23_ブラウザ関連/リスト選択.ums6
• 23_ブラウザ関連/値の取得.ums6
• 23_ブラウザ関連/値の設定(入力再現).ums6

本サンプルシナリオの入力ファイル

PDFファイルを入力ファイルとします。
シナリオ内でジジラにアップロードし、OCR読み取りを行います。
入力ファイルの詳細は入力ファイルの形式を参照してください。

本サンプルシナリオの想定レベル

本ドキュメントは、以下の技術レベルのユーザを対象としています。

• ジジラの使い方について理解している。

動作確認環境

本サンプルシナリオは以下の環境で動作確認しています。

• Windows 10
• WinActor 6.3.0、7.1.0
• Google Chrome 83.0.4103.97

制約事項

• 本サンプルシナリオを実行するためには、ジジラにアクセスするためのインターネット環境が必要です。
• 本サンプルシナリオおよびドキュメントは、ジジラにログインできる状態を前提に記載されています。
• 本サンプルシナリオおよびドキュメントは、Google Chromeが使用できる状態を前提に記載されています。
• 本サンプルシナリオは WinActor 6.0 より古いバージョンでは動作しません。

本サンプルシナリオの使い方

本サンプルシナリオの実施方法は以下の通りです。

Step 1. ジジラへのログイン

本サンプルシナリオではシナリオ実行前の手順としてジジラを操作する必要があります。
ジジラを開いてログインを行ってください。

ジジラホーム画面

Step 2. テンプレートの読み取り範囲の設定

本サンプルシナリオではドキュメントの読み取り範囲を事前に設定する必要があります。
以下の手順で設定をしてください。(手順内に記載されている"申込書サンプル.pdf"は本サンプルシナリオに添付されています)

1. ホーム画面の[テンプレート設定]ボタンを押下します。
2. ホーム画面の[テンプレートアップロード]ボタンを押下します。

テンプレートアップロードボタン - ホーム画面

3. ファイル選択画面から"申込書サンプル.pdf"を選択します。
4. テンプレート名登録画面のテンプレート名入力欄に「申込書」を入力します。 ※任意の文字列で問題ありません。

テンプレート名登録画面

5. テンプレート名登録画面の[テンプレート名を登録する]ボタンを押下します。
6. テンプレート設定画面で読み取り範囲の設定 および ボックス設定をします。 ※1個所ずつ設定して[確定]ボタンを押してください。
　　以下の表の読み取り項目および値を設定してください。その他の項目については設定不要です。

テンプレート設定画面

7. テンプレート設定画面の[保存]ボタンを押下します。

Step 3. 入力ファイルをディレクトリに配置

任意のディレクトリに入力ファイルを配置します。
本サンプルシナリオには、サンプルのPDFファイル(申込書サンプル.pdf)が添付されています。
このファイルを使用して、入力を行います。

Step 4. WinActorで本サンプルシナリオを読み込み

Step 5. 動作に必要な変数を設定

本サンプルシナリオを実行するために必要な値を、変数一覧で設定します。
本サンプルシナリオの実行にあたり、事前に設定が必要な変数は下記の通りです。

• プロキシID
  • プロキシのIDを指定します。
    ※プロキシサーバを利用しない場合、空白を指定してください。
    
    
• プロキシパスワード
  • プロキシのパスワードを指定します。
    ※プロキシサーバを利用しない場合、空白を指定してください。
    
    
• ジジラログインID
  • ジジラのIDを指定します。
    
    
• ジジラログインパスワード
  • ジジラのパスワードを指定します。
    
    
• ジジラ識別文字列
  • ジジラの識別文字列を指定します。
    ジジラ識別文字列はジジラホーム画面等のアドレスバーに表示されます。("https://jijilla.jp/*****/ の*の部分)
    
    
• 読み取りファイルパス
  • 本サンプルシナリオの入力ファイルのファイルパスを指定します。
    例) C:\sample\申込書サンプル.pdf
    
    
• 定型種別名
  • 使用するテンプレート名を指定します。
    本サンプルシナリオでは「申込書」と指定してください。
    
    
• プロジェクト名
  • 使用するプロジェクト名を指定します。
    プロジェクトの一覧はメイン画面上部右から2番目のプルダウンを開くことで確認できます。

変数設定の対象箇所- ジジラ画面

本サンプルシナリオ変数一覧の設定

Step 6. WinActorで本サンプルシナリオを実行

本サンプルシナリオを実行します。
Chromeブラウザが閉じると、本サンプルは終了します。

Step 7. サンプルシナリオ実行終了後の確認

Chromeブラウザに設定されているダウンロードディレクトリに、OCR実行結果のCSVファイル(ファイル名はOCR読み取りを行ったPDFファイル名と同名)が格納されていることを確認してください。

トラブルシューティング

本サンプルシナリオでは、指定秒数待機している箇所があります。
以下に、固定秒数待機不足により失敗する動作に対しての修正箇所を記載します。
シナリオ内の対象となる指定時間待機モジュールの待機時間プロパティの秒数を増やす対応をしてください。

サンプルシナリオ解説

本サンプルシナリオで使用している実装テクニックについて説明します。

入力ファイルの形式

入力ファイル(PDF)は以下の形式をとります。

入力ファイルサンプル

入力ファイルを自作する場合の注意事項

読み取り範囲を設定したドキュメント(入力ファイルサンプル)に形式を合わせて作成してください。
また、自作した場合は読み取り箇所がずれてしまうことがあるため、OCR実行をして読み取り結果を確認してください。