簡易マニュアル

Copyright© 2024 NTT Advanced Technology Corp. All Rights Reserved.

WinActorとは？
WinActorは、端末の操作手順をシナリオとして記録します。
WinActorは、仮想のオペレータとなり、シナリオに従って端末を自動操作します。
WinActorを利用することで、ヒューマンエラーを防ぎ、業務の効率化を図ることができます。

【導入前】

オペレータ

業務端末

【導入後】

ＤＢ

WinActor

業務端末

ＤＢ

オペレータ

人手による膨大な作業

WinActor活用による作業効率化

多くの手順をWinActorが自動実行

既存システムを改造することなく、多種多様な業務を改善できます
P.1

主要機能
WinActorには、記録、編集、実行という三つの主要機能があります。
記録機能には、イベント、エミュレーション、IE 、Chrome、Firefox、Edge、UI Automationという7種類のモードがあります。自動切り替えは、記録中に7種類のモードを自動的に切り替えます。

WinActor
記録 ・・・ ユーザ操作を記録し、シナリオを自動生成する機能
イベント・・・ Windowsアプリケーションを記録対象とするモード

エミュレーション ・・・ マウス/キーボードの動きを記録対象とするモード（イベントモードやIEモード等で記録できない場合に活用）
IE
・・・ IEを記録対象とするモード
Chrome・・・ Google Chromeを記録対象とするモード
Firefox・・・ Mozilla Firefoxを記録対象とするモード

Edge

・・・ Microsoft Edge(Chromium)を記録対象とするモード

UI Automation

・・・ WindowsアプリケーションのGUI要素を記録対象とするモード

自動切り替え・・・ 記録中に上記7種類のモードを自動的に切り替えるモード

編集 ・・・ 分岐条件、繰り返し条件の設定や操作手順の入れ替えなど、シナリオを編集する機能
実行 ・・・ 記録/編集で作成したシナリオを実行する機能
P.2

画面構成
「新規作成」ボタン「フローチャート画面」
操作の流れや手順を図式化したもの

ようこそ画面

••WinActorを起動後、ようこそ画面が表示されます。
「新規作成」ボタンをクリックすると、「フローチャート画面」が表示されます。

P.3

ツールバー「実行」ツールバー「編集／記録」ツールバー••「編集／記録」ツールバーを使ってシナリオを作成することができます。
（WinActorフル機能版でのみ利用可能です）「実行」ツールバーを使ってシナリオを実行することができます。

P.4

操作の記録（概要）作成「記録対象アプリケーション選択」ボタン
このボタンをクリックした後、マウスで記録対象アプリケーションの画面をクリックします。

「記録」ボタン「記録停止」ボタン••

ユーザの例示操作を自動的に検出し記録する機能を「記録機能」と呼びます。
記録を開始する前に、まずどのウィンドウに対する操作を記録するかをマウスクリックで指定します。
• 記録機能には、イベント、エミュレーション、IE 、Chrome、Firefox、Edge、UI Automationという7種類のモードがあります。自動切り替えは、記録中に7種類のモードを自動的に切り替えます。
指定したウィンドウのアプリケーションに応じたモードが自動的に選定されます。
「IE」モードは、EdgeのIEモードに対応しています。
P.5

操作の記録（ IE/イベント/Chrome/Firefox/Edge/UI Automation）-

作成①このボタンをクリックした後、対象アプリケーションをクリックして選択②記録を開始記録モードとして、Edgeが選択されています。

③Edgeを操作例）住所コードを入力して検索ボタンをクリック⑤記録を停止④操作が記録され、自動的にシナリオが生成されます。

•

記録したいウィンドウ（上記では住所管理システム）を選択すると、ウィンドウのアプリケーションに応じたモードが自動的に選定され、記録を開始できます。

P.6

操作の記録（エミュレーションモード）

作成①記録対象を選択すると記録モードで「エミュレーション」が選択されます。

③対象ウィンドウに対して操作を実施すると、操作記録リストにマウスやキーボードの操作内容が表示されます②「記録」ボタンをクリックすると、記録操作ダイアログが表示されます。

④「選択部アクション化」ボタンをクリックすることで、表示されているマウス・キーボード操作がアクション化され、フローチャート画面にエミュレーションアクションが追加されます。

••⑤記録終了時には、「アクション化後停止」ボタンをクリックします。

不要な操作はリストの該当の操作を選択し「選択部削除」をクリックすることで削除します。

「エミュレーション」モードはマウス・キーボードの操作をそのまま記録し再現するモードです。
「エミュレーション」モードでは、操作対象としてウィンドウだけでなく、「スクリーン（デスクトップ）」も指定できます。
P.7

画像マッチング(1/2)①ノードパレットからドラッグ＆ドロップで追加できます。

作成③マッチング画像を赤枠で設定します。
②ボタンをクリックし、対象ウィンドウをクリックすると対象ウィンドウの画面キャプチャが表示されます。
※対象ウィンドウは、ディスプレイに収まるように配置してください。

④マウスクリックする場合は場所を指定します。
マッチング画像との相対位置になります。

⑥画像が見つかったか否かを格納する変数名を指定します。結果を利用しない場合は未入力とします。
⑦更新ボタンをクリックします。

⑤画像が見つかった場所でクリック操作を行うことができます。

•••

リモートデスクトップなど、操作したい画面が画像でしか認識できない場合などに使います。
また、特定の情報がウィンドウ上に表示されているか否かを判定したり、ウィンドウは表示されていても内容の表示に時間がかかる場合にWinActorの自動操作を待たせる場合などにも活用できます。
指定ウィンドウと指定した画像のマッチングを行い、マッチングが成立した場合、クリック等のマウス操作が可能となります。
P.8

画像マッチング(2/2)

作成

マッチング画像を指定します。
検索範囲を絞り込むことが可能です。

マウス操作の位置を任意に設定することが可能です。
セキュリティ上問題がある部分を塗りつぶすことが可能です。選択した部分の内側を黒塗りします。

セキュリティ上問題がある部分を塗りつぶすことが可能です。選択した部分の外側を黒塗りします。
キャプチャ画像を画像ファイルから設定することが可能です。

••

マッチング画像の検索範囲を絞り込んだり、マスク機能で画像を塗りつぶすことが可能です。
クリック等のマウス操作の位置は、マッチング画像に限定されず、ユーザが任意の位置に指定可能です。
P.9

分岐と繰り返し

作成

分岐グループのプロパティ

・「条件式」を満たすか、満たさないかで分岐（条件式設定については次頁参照）•••「分岐」は条件に応じて処理を2つに分岐する制御ノードです。
「繰り返し」で条件に応じた繰り返し動作を設定できます。
ノードタブからドラッグ＆ドロップで追加できます。
P.10

条件式作成②追加する条件式の内容を設定します。

①条件式設定を選びます。

••••

文字列の比較は、「等しい」「等しくない」
数字の比較は、等号や不等号を使用します。

分岐、繰り返し等のノードでは条件式を設定します。
分岐、繰り返し等のノードのプロパティから設定します。
条件式を設定せずに実行しようとすると、プロパティ未設定である旨実行時に警告が出ます。
比較演算子は、正規表現や曖昧一致（半/全角、大/小文字を区別しない）にも対応します。
P.11

クリップボード作成

設定値で指定された値をクリップボードに設定します。

アクション実行時にクリップボードに設定されている値を取得します。
(テキスト形式のみ)• クリップボード（コピー/カット操作の対象データを一時的に保存するメモリ領域）へ変数の値を設定、またはクリップボードから取得した値を変数に格納することが可能です。
• クリップボードから取得できるのはテキスト形式のみ1,024文字までで、テキスト形式以外は空文字が格納されます。
P.12

変数

作成

変数名インポートボタンをクリックしてExcelやCSVファイルを選択します。

ExcelやCSVファイルの1行目が変数名として取り込まれますので、OKボタンをクリックします。

•••

シナリオでは、「変数」を使うことができます。シナリオ実行時に使うデータは通常は毎回異なりますが、これを「変数」として扱うことでシナリオとして作成できます。
「日時取得」、「文字列の取得」、 「表の値取得」など様々な用途で使うことができます。
ExcelやCSVファイルと連携させる場合には、変数一覧で変数名インポートボタンをクリックして、ExcelやCSVの一行目（データの項目名が書かれていることが前提）を変数名として取り込みます。上図はその場合の使用例です。
P.13

変数（Excel, CSV, データベースとの連携）
ExcelやCSVファイルから、データを取り込みます。

データベースから、データを取り込みます。

1行目の項目名が変数名になり、2行目以降がデータとして取り込まれます。

••
•

作成

チェックされた各行に対して処理が繰り返されます。実行済みの行はチェックが外れます。

データ一覧でExcelやCSVを読み込むと、 ExcelやCSVファイルの１行目の項目名が変数名と対応づけられます。
データベースと連携をした場合、カラム名が変数名と対応づけられます。
実行時には、データの行数分だけシナリオが繰り返して実行されます。
シナリオを実行した結果、変数のデータが変更された場合や変数に値が設定された場合には、その結果はそのまま元のExcelやCSVファイルや、データベースにも反映されます。
P.14

値の取得

作成

④「操作の記録」と同様に、このボタンをクリックした後にブラウザ画面を選択します。

②「値の取得」をフローチャート画面にドラッグ＆ドロップします。

①ライブラリのタブを選び、23_ブラウザ関連を開きます。

•••⑤「選択」ボタンをクリックした後に、ブラウザ画面の中の取得したいテキストボックスにマウスを乗せると色が変わるので、クリックします。

③ダブルクリックしてプロパティ画面を表示します。

⑥取得した文字列を入れる変数名を指定します。
一覧にない場合には新しい変数名を書きます。

WinActorのブラウザ拡張機能を利用すると、ブラウザの「値の取得」などができます。
例えば、Edgeで検索した結果の文字列を取り込みたいときなどに使用します。
WinActorのブラウザ拡張機能のインストール方法は『WinActor Chrome拡張機能インストールマニュアル』や『WinActor Firefox拡張機能インストールマニュアル』を参照してください。
P.15

シナリオ実行
実行ボタン

••

実行

実行ツールバーのコンボボックスで、スロー実行可能（値が大きくなるほど遅くなります）

メニューの「ファイル→開く」からWinActorファイル(シナリオを保存したファイル)を開くことができます。
実行ボタンを押すことでシナリオが実行されます。また、停止や一時停止→再実行も可能です。

P.16

シナリオ実行（部分実行）

実行「開始」、「終了」の外にあっても部分実行は可能
部分実行を選択

フローチャート上で実行したい部分を選択••

フローチャート上で実行したい部分を選択し、選択したノードを右クリックし、ポップアップメニ
ューから部分実行を選択作成したシナリオの部分毎に、部分実行しながらその動作を確認できます。

P.17

シナリオ実行（ここから実行）

実行「開始」、「終了」の外にあってもここから実行は可能
ここから実行を選択

フローチャート上で実行を開始したい場所を選択••

フローチャート上で実行を開始したい場所を選択し、選択したノードを右クリックし、ポップアップメニューから、ここから実行を選択
選択した場所からシナリオを実行開始できるので、その動作を確認できます。

P.18

起動パスワード

その他

設定変更・解除•

起動する際のパスワード入力の設定・変更・解除が可能です。
起動パスワードの入力画面•

設定した場合、起動した際に、パスワードの入力が求められます。
P.19

起動オプション
#
①
②

オプション
-f-s

設定方法
-f filename.ums7-s scenariopassword

説明
指定したシナリオファイルを起動時に開きます。
シナリオファイルに設定されたシナリオパスワードを指定することで、そのパスワードに対応するセキュリティモードを適応して、シナリオファイルを開きます。
起動後にシナリオ実行します。
指定したデータ一覧のファイルを起動時に開きます。
指定した時間（ミリ秒）待機します。※半角整数で指定します
シナリオの実行完了後に、データ一覧のファイルをexportfilepathに保存します。
exportfilepathを省略した場合はデータ一覧のファイルを上書き保存します。
※シナリオの実行中にアクション例外でキャッチされないエラーが発生した場合には、データ一覧の保存は行われません。
シナリオの実行完了後に、WinActorを終了します。
※シナリオの実行中にアクション例外でキャッチされないエラーが発生した場合には、WinActorの終了は行われません。
シナリオの実行完了後に、終了ステータスを返却してWinActorを終了します。
エラーが発生した場合には「1」、それ以外（正常終了時）は「0」のステータスが返却されます。
※コマンドプロンプトにて終了ステータスを受け取る場合は、「start /wait WinActor7.exe -ec ～」と入力し、WinActorの終了をお待ちください。
メイン画面を表示せず、WinActorをタスクトレイに収容した状態（最小化した状態）で起動します。
起動パスワードを指定します。
※フル機能版のみ使用可能です。※起動パスワード設定した場合のみ有効となります。
※起動パスワード設定せずに使用した場合、警告画面表示後、起動します。
データ一覧のDB連携のデータソース名を指定します。
データ一覧のDB連携のユーザ名を指定します。
データ一覧のDB連携のパスワードを指定します。
データ一覧のDB連携のテーブル名を指定します。
WinActor 起動時、またはシナリオ実行時に表示されるダイアログを非表示にします。
※シナリオに含まれるダイアログ（待機ボックスノード、インプットボックスノード、選択ボックスノードなどを実行して表示されるもの）は表示されます。
指定したファイル名でシナリオファイルを保存して、WinActorを終了します。

-r-d-w-x-r-d datafilepath-w delay-x exportfilepath-x-e-e-ec-ec-t-p-t-p password-od-ou-op-ot-sl-od datasorce-ou user-op password-ot table
-sl

⑯-sa

-sa filename.ums7••

WinActorは、コマンドラインからの起動が可能です。
コマンドラインからの起動時には上表に示すオプションを使うことができます。

③④⑤⑥⑦⑧⑨⑩⑪⑫⑬⑭⑮

実行

P.20

使用上の注意
WinActorを使用する場合、以下の点に注意の上ご使用ください。
•••

WinActorのプログラムの性質上、ユーザの操作を記録・保存する機能を有しています。このため、記録する操作によっては、個人情報などを記録・保存することも可能です。取扱いには十分ご注意ください。
WinActorは、端末操作を自動的に実行する機能を有しています。他者への迷惑行為を自動的に実行するなど、公序良俗に反する行為には使用しないでください。
WinActorの自動実行中、記録した操作と異なる操作となった場合は、直ちにWinActorを停止してください。
※タブを含むアプリケーション、コントロールの数や位置が動的に変化するアプリケーションは、WinActorが正しく操作できない可能性があります。

••

WinActorの自動実行中に、ユーザがキーボードやマウスの操作を行った場合、WinActorによる操作とユーザによる操作が同時にシステムに入力されます。結果として予期せぬ動作、処理結果を引き起こす恐れがありますので、十分ご注意ください。
WinActorは、自動操作対象のシステムに対して想定を超える速度でデータを入出力する可能性があります。このような場合、自動操作対象システムに多大な負荷をかける恐れがあります。自動操作シナリオの作成および実行時においては、ネットワーク、プログラム、ハードウェアの性能の範囲内でお使いください。
P.21

簡易マニュアル
Copyright© 2024 NTT Advanced Technology Corp. All Rights Reserved.
本書は著作権法上の保護を受けています。本書の一部あるいは全部を無断で複写、複製することは禁じられています。
本書の内容は予告なく変更される場合があります。
WA7-H- 20240514