[キャプチャ] アクションの使用

[キャプチャ] アクションを使用すると、オブジェクトコントロール (テキストボックス、ボタン、テーブル、メニュー、ラジオボタン、コンボボックス、チェックボックス、リストビュー、リンク、ツリー、またはページタブ) との 1 つのインタラクション (クリック、キーストローク、マウスの動作) をキャプチャできます。

前提条件

レコーダーを使用するには、次の操作を実行しておく必要があります。
- デバイスの登録と Bot エージェントのインストール
- ユーザーのデバイス資格情報の設定
デバイスの表示とフォントの倍率を 100% に設定します。
レコーダーパッケージバージョン 2.0.6-20200626-193519 以降を使用している場合は、Google Chrome、Internet Explorer、Java、Microsoft Active Accessibility、および Microsoft UI の自動化アプリケーションで、デバイスの表示倍率が 100%、125%、150% のいずれかに設定されたコンピューターでタスクを記録できます。
ブラウザを使用してタスクを自動化する場合は、ズームレベルを 100% に設定します。
レコーダーパッケージバージョン 2.0.6-20200626-193519 以降を使用している場合は、ズームレベル設定が 100% でない Google Chrome ブラウザでタスクを記録できます。
Google Chrome ブラウザを使用してタスクを自動化する場合は、Automation 360 のビルドバージョンに対応する Automation Anywhere プラグインが有効になっていることを確認します。
RPA Workspace のブラウザ要件
Microsoft Edge Chromium ブラウザの Internet Explorer モードで、ユニバーサルレコーダーを使用して実行されている Web アプリケーションを自動化するには、Internet Explorer の互換モードが有効になっていることを確認します。Web アプリケーション上のオブジェクトは、HTML テクノロジーを使用してキャプチャされます。このモードを有効にするには、次の手順を実行します。
1. Microsoft Edge Chromium ブラウザのページで [設定] をクリックします。
2. 左側のパネルで、[既定のブラウザ] をクリックします。
3. [Internet Explorer モードでサイトの再読み込みを許可] オプションに移動し、[許可] を選択します。
4. [追加] をクリックして、Internet Explorer モードでロードするページの URL を追加します。
  注: 追加したページは、ページを追加した日付から 30 日間、Internet Explorer モードで開きます。

タスクを記録する際の考慮事項:

可能な場合は、ショートカットキーではなくクリックを使用します。
レコーダーを使用してオブジェクトをクリックすると、オブジェクトのプロパティが取得され、ランタイム時に Bot がオブジェクトを識別できるようになります。キーボードショートカットは信頼性が低いので、オブジェクトをクリックしてもタスクを自動化できない場合に使用してください。
ブラウザを使用してタスクを自動化する場合は、自動入力を使用してフィールドに値を入力しないでください。
タスクは低速で記録してください。
記録プロセス中はウィンドウをドラッグしないでください。
記録および自動化しているプロセスの一部ではないアプリケーションをクリックしないでください。
Internet Explorer が使用されている場合、アクションはブラウザが完全にレンダリングされるまで待機し、アクションを実行する前に準備完了状態になります。

手順

オブジェクトコントロールとの単一インタラクションを記録するには、次の手順を実行します。

[レコーダー] > [キャプチャ] の順にダブルクリックまたはドラッグします。

オブジェクトをキャプチャするウィンドウを指定します。

[アプリケーション]、[ブラウザ]、または [変数] タブから選択します。

オプション	説明
アプリケーション	現在アクティブなウィンドウのリストから選択します。このオプションでは、Bot Creator デバイスで開いているすべてのアプリケーションウィンドウとブラウザウィンドウのリストが表示されます。
ブラウザ	対応ブラウザタブのリストから選択します。注: このオプションは、Google Chrome、Chromium ベースの Microsoft Edge、および Internet Explorer ブラウザをサポートします。それ以外のブラウザの場合は、[アプリケーション] オプションを使用してください。
変数	既存のウィンドウ変数を選択して、アプリケーションウィンドウのタイトルを指定します。

[オブジェクトのプロパティ] テーブルを確認します。

以下は、テクノロジータイプに応じてデフォルトで選択されるオブジェクトのプロパティの一覧です。

Important: 以下のリストは、すべてのプロパティを含むものではありませんが、テクノロジータイプに応じて、最もよく使用される重要なプロパティに限定されています。


テクノロジータイプ	オブジェクトのプロパティ	説明
HTML テクノロジー	コントロールタイプ	これは、テキストボックスやボタンなど、キャプチャされたオブジェクトのタイプを示します。
	DOMXPath	キャプチャされたコントロールやオブジェクトを特定するために使用するパスです。DOMXPath には、相対 XPath と絶対 XPath の 2 種類があります。絶対 Xpath: ルート要素から目的の要素までの完全なパスを含みます。たとえば、このトピックの絶対 Xpath は `/html/body/div/div[1]/main/div[2]/div/div/div[2]/div/div/div[1]/div/article/main/article/div/p[1]` となります。相対 Xpath: 特定する要素を参照する短いパスです。相対パスは、記号 `//` で始まります。たとえば、このトピックの相対 XPath は `//*[@id="cloud-using-recorder-action"]/div/p[1]` になります。たとえば、Google Chrome ブラウザで特定の要素の DOMXPath を見つけたい場合は、以下の手順を実行します。 XPath を取得する要素を選択します。要素を右クリックして [検査] を選択します。 [要素] タブでハイライト表示された要素を右クリックします。 [コピー] > [Xpath のコピー] に移動して相対パスをコピーし、[コピー] > [完全な Xpath をコピー] を選択して絶対パスをコピーします。
	パス	これは、アプリケーション内の特定のコントロールの位置を数値で表したものです。Web アプリケーションでは、[パス] と比較したときに検索条件から [DOMXPath] を使用するのがベストプラクティスです。
	HTML 名と ID	これらのプロパティは、HTML オブジェクトを識別するために使用されます。
	HTML インナーテキスト	DOM innerText プロパティは、指定ノードとその派生物のテキストコンテンツを設定するか返すために使用します。
	HTML タグ	HTML タグは、Web ブラウザでコンテンツをフォーマットして表示する方法を定義するキーワードのようなものです。たとえば、キャプチャしたテキストに HTML コード、`<h3 class="search_results-title">Search results for ״string package״</h3>` がある場合は、HTML タグ欄に「`h3`」と入力します。
Microsoft Active Accessibility	コントロールタイプ	このプロパティは、正しいオブジェクトがキャプチャされていることを確認するための参照としてのみ使用します。
	パス	アプリケーションにおける特定のコントロールの位置を数値で表したものです。
	名前	要素の名前を指定し、識別子として機能します。
	ID	要素の ID を指定し、識別子として機能します。
Java テクノロジー	コントロールタイプ	このプロパティは、正しいオブジェクトがキャプチャされていることを確認するための参照としてのみ使用します。
Java テクノロジー	パス	アプリケーションにおける特定のコントロールの位置を数値で表したものです。
Microsoft UI オートメーション	コントロールタイプ	このプロパティは、正しいオブジェクトがキャプチャされていることを確認するための参照としてのみ使用します。
	パス	アプリケーションにおける特定のコントロールの位置を数値で表したものです。
	名前	要素の名前を指定し、識別子として機能します。
	ID	要素の ID を指定し、識別子として機能します。
Microsoft UI オートメーション (COM)	コントロールタイプ	このプロパティは、正しいオブジェクトがキャプチャされていることを確認するための参照としてのみ使用します。
	パス	これは、アプリケーション内の特定のコントロールの位置を数値で表したものです。
	名前	要素の名前を指定し、識別子として機能します。
	ID	要素の ID を指定し、識別子として機能します。

Bot は、選択したプロパティを使用して、実行時にオブジェクトコントロールを特定します。

[コントロールタイプ] が意図したオブジェクトに一致することを確認します。
たとえば、Web サイトからテーブルをキャプチャする際は、[コントロールタイプ] と [HTML タグ] の値が [テーブル] であることを確認します。

[コントロールタイプ] が意図したオブジェクトに一致しない場合は、オブジェクトコントロールを再度キャプチャします。
オブジェクト検索に含めるオブジェクトのプロパティを選択して、値を割り当てます。
Bot の信頼性を高めるために、静的値を持つプロパティ ([名前]、[クラス]、[タイプ]、[HTML ID]、[DOMXPATH] など) のみを選択し、動的な値を持つプロパティ ([HTML Href]、[パス]、[値]) の選択を解除することをお勧めします。動的な値は変更される可能性があり、Bot エラーの原因となります。
プロパティが動的で頻繁に変更されるオブジェクトを検索するには、オブジェクトのプロパティ値にワイルドカード文字 (*) または変数を使用することをお勧めします。

Link an object to a supporting anchor

注: You can use object anchoring in Microsoft Active Accessibility, Microsoft UI Automation, or Java applications.

At runtime, if the Bot cannot reliably identify an object, link it to a nearby object (such as a link or button) that is easier for the Bot to find:

Open the Capture アクション.
Click the Anchor tab.
Click Capture anchor.
The browser or application window activates with the main object highlighted (the object that you previously captured). A dialog box appears, verifying whether the action has correctly identified the main object.
If the correct object is highlighted, click Yes, Select anchor.
Otherwise, click No, I need to correct it to select the correct object.
Select a nearby object to the target object that is easier for the Bot to find.
The object is highlighted with an anchor icon on the right of the object.
Click Save.

Automation 360