PDFから外部ツールで文字列情報を取得し、WinActorノートへ貼り付けを実行するサンプルシナリオ

はじめに

PDFから外部ツールで文字列情報を取得し、WinActorノートへ貼り付けを実行するサンプルシナリオ (以降、本サンプルシナリオ) について説明します。

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

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

使用するWinActorモジュール

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

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

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

動作確認環境

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

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

本サンプルシナリオの使い方は以下の通りです。

Step 1. 事前準備

本サンプルシナリオは、PDFファイルを操作するプログラムを使用しています。
対象のプログラムは、以下のリンク先からダウンロードすることが出来ます。
PDFBoxのプログラムダウンロページ
※「Command line tools」配下の「pdfbox-app-x.x.x.jar」

PDFファイルを操作するプログラムはJavaで動作するため、予めPCへJavaをインストールしてください。

Step 2. サンプルシナリオの読み込み

ダウンロードしたサンプルシナリオのZIPファイルを展開し、展開したフォルダに含まれている本サンプルシナリオをWinActorで読み込みます。

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

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

変数一覧画面
変数一覧画面

Step 4. サンプルシナリオの実行

WinActorで本サンプルシナリオを実行します。
ファイルの削除まで完了すると、本サンプルシナリオは終了します。

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

PDFから取得した文字列情報が、WinActorノートに出力されていることを確認してください。

トラブルシューティング

本サンプルシナリオでは、誤ったファイルパスやファイル名/フォルダ名を指定した場合、エラーメッセージが出力されます。
詳細については、エラーメッセージ一覧を参照してください。
エラーメッセージが出力されていないが、想定の通り動作しない場合は以下をご確認ください。

エラーが発生していないが、WinActorノートにPDFの内容が貼り付けられない場合

コマンド実行ノードにて実行しているコマンドにおいてはエラーが発生している可能性があります。
その上で既存で存在するテキストファイルをテキストファイルパスに指定しているとシナリオとしてエラーが発生しない可能性があります。
コマンド実行時にエラーとなる要因としては、以下が考えられます。

サンプルシナリオ解説

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

PDFファイルからの文字列情報の取得

本サンプルシナリオでは、変数一覧のPDFファイルパスに指定されたPDFファイルから、PDFファイルを操作する外部ツールを用いて文字列情報を取得し、テキストファイルに出力しています。
PDFからの文字列取得は従来のWinActorでは不可能でしたが、外部ツールを利用することでPDFからの文字列取得を可能としています。
外部ツールの利用に関しては、コマンド実行ノードを利用して実現しています。

コマンド実行ノードの設定
コマンド実行ノードの設定

PDFファイルからの文字列情報の取得以外にもコマンドにて実現可能な外部ツールであれば同様に利用可能です。

文字列情報のWinActorノートへの連携

本サンプルシナリオではPDFより取得した文字列情報をテキストファイルを経由し、WinActorノートへ連携を行っています。
テキストファイルからWinActorノートへの連携に関しては、「25_WinActorノート/テキストファイル読み込み.ums6」で行うことができます。

外部ツール連携とWinActorノート連携
外部ツール連携とWinActorノート連携

外部ツールを利用することで、PDFの文字列情報をテキストファイルとして出力することが可能であるため、外部ツールを利用してテキストファイルの出力、出力したテキストファイルを「25_WinActorノート/テキストファイル読み込み.ums6」を利用してWinActorノートへ連携を行っています。

WinActorノート以外への連携

変更履歴

版数 日付 修正内容
1.0版 2020/02/28 初版
1.1版 2020/11/09 事前準備で使用しているプログラムのリンク先を明記
1.2版 2023/06/12 ・注意事項を削除
・ファイル名を「SS2002_9419_GetStringFromPDF_1.0.1.zip」に変更