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

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

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

1. [レコーダー] > [キャプチャ] の順にダブルクリックまたはドラッグします。
2. オブジェクトをキャプチャするウィンドウを指定します。
   [アプリケーション]、[ブラウザ]、または [変数] タブから選択します。

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

3. オプション: [ウィンドウ タイトル] フィールドでワイルドカード文字 (*) を挿入することで、さまざまなウィンドウ タイトルを検索できます。値の先頭、中間、末尾に 1 つ以上のワイルドカード文字 (*) を指定することができます。
   たとえば、タイトルに Microsoft を含むウィンドウで操作を実行するには、値の前または後にワイルドカード文字を追加して、次のように任意の文字列を示すことができます。*Microsoft*。Bot は、まず、完全に一致するウィンドウ タイトル (この場合であれば、Microsoft) を検索し、条件に一致する文字が見つからない場合は、タイトルに Microsoft を含むウィンドウを検索します。

   正規表現 (regex) を使用して、ウィンドウ タイトルを識別できます。各正規表現条件の [文字列] または [パターン] として正規表現を選択し、値を入力します。デフォルトでは、[ウィンドウ タイトル] フィールドで大文字と小文字が区別されます。[大文字と小文字を区別しない] 正規表現フラグを有効にして、大文字と小文字を区別しないウィンドウ タイトルを識別できます。

   たとえば、((\w*)-Notepad で始まるすべてのウィンドウ タイトル名には ((\w*)-Notepad として [文字列] 値を入力できます。または、((\w)\s)*document-Notepad といった [パターン] を使用すると、このパターンに一致するウィンドウ タイトルのみに絞り込むことができます。

   注: 実行中に、タスク Bot が正しいウィンドウを特定することを確認します。特定していない場合は、次の操作を実行します。

   1. アプリケーションまたはブラウザ ウィンドウを開きます。
   2. [ウィンドウ] > [アクティブなウィンドウ タイトルを取得] アクション を [レコーダー] > [キャプチャ] アクション の上にドラッグします。
   3. 文字列変数を [ウィンドウタイトルを変数に代入] フィールドに挿入します。
   4. [ウィンドウ] > [タイトルを設定] アクション を [ウィンドウ] > [アクティブなウィンドウ タイトルを取得] アクション の下にドラッグします。
   5. [ウィンドウ] フィールドに、[レコーダー] > [キャプチャ] アクション によって生成されたウィンドウ変数を挿入します。
   6. [新しいウィンドウ タイトル] フィールドで、[アクティブなウィンドウ タイトルを取得] アクション から文字列変数を挿入します。
   7. [保存] をクリックします。
4. オプション: [ウィンドウのサイズ変更] オプションを選択して、ウィンドウの寸法を指定します。
   このオプションによって、より信頼性の高い Bot を実現できます。タスク記録時に合わせてウィンドウのサイズを変更し、Bot がターゲット オブジェクトを特定できるようにします。
   • タスク記録時にウィンドウが最大化されている場合、このオプションは選択されていません。
   • タスクを記録するときにウィンドウが最大サイズでない場合は、このオプションがデフォルトで選択され、幅と高さのフィールドにはウィンドウの寸法が自動的に入力されます。

   注: このオプションは、サイズ変更が可能なウィンドウでのみ使用できます。これは [デスクトップ] または [タスクバー] オプションでは使用できません。
5. [オブジェクトをキャプチャ] をクリックします。
   選択したウィンドウが表示されます。
6. 自動化するオブジェクト、たとえばボタン、フォーム フィールド、テーブルの上にマウスを動かします。
   オブジェクトの周りに赤い長方形のボックスが表示されます。

   注: ボックスが表示されず、Google Chrome、Microsoft Edge または Mozilla Firefox ブラウザでキャプチャしている場合は、これらのブラウザの Automation Anywhere 拡張機能が有効になっていることを確認します。Google Chrome ブラウザについては、Google Chrome ブラウザ拡張要件 を参照してください。
7. オブジェクトをクリックします。
8. [オブジェクトのプロパティ] テーブルを確認します。
   以下は、テクノロジー タイプに応じてデフォルトで選択されるオブジェクトのプロパティの一覧です。

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

   テクノロジー タイプ	オブジェクトのプロパティ	説明
   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」と入力します。
   MS_ACTIVE_ACCESSIBILITY テクノロジー	コントロール タイプ	このプロパティは、正しいオブジェクトがキャプチャされていることを確認するための参照としてのみ使用します。
   	パス	アプリケーションにおける特定のコントロールの位置を数値で表したものです。
   	名前	要素の名前を指定し、識別子として機能します。
   	ID	要素の ID を指定し、識別子として機能します。
   JAVA テクノロジー	コントロール タイプ	このプロパティは、正しいオブジェクトがキャプチャされていることを確認するための参照としてのみ使用します。
   	パス	アプリケーションにおける特定のコントロールの位置を数値で表したものです。
   MS_UI_Automation テクノロジー	コントロール タイプ	このプロパティは、正しいオブジェクトがキャプチャされていることを確認するための参照としてのみ使用します。
   	パス	アプリケーションにおける特定のコントロールの位置を数値で表したものです。
   	名前	要素の名前を指定し、識別子として機能します。
   	ID	要素の ID を指定し、識別子として機能します。

   Bot は、選択したプロパティを使用して、実行時にオブジェクト コントロールを特定します。
   1. [コントロール タイプ] が意図したオブジェクトに一致することを確認します。
      たとえば、Web サイトからテーブルをキャプチャする際は、[コントロール タイプ] と [HTML タグ] の値が [TABLE]、[] であることを確認します。
      [コントロール タイプ] が意図したオブジェクトに一致しない場合は、オブジェクト コントロールを再度キャプチャします。
   2. オブジェクト検索に含めるオブジェクトのプロパティを選択して、値を割り当てます。
      Bot の信頼性を高めるために、静的値を持つプロパティ ([名前]、[クラス]、[タイプ]、[HTML ID]、[DOMXPATH] など) のみを選択し、動的な値を持つプロパティ ([HTML Href]、[パス]、[値]) の選択を解除することをお勧めします。動的な値は変更される可能性があり、Bot エラーの原因となります。
      プロパティが動的で頻繁に変更されるオブジェクトを検索するには、オブジェクトのプロパティ値にワイルドカード文字 (*) または変数を使用することをお勧めします。
9. ドロップダウン リストから [アクション] を選択します。
   オブジェクトで実行できる アクション の完全なリストについては、「ユニバーサル レコーダー でキャプチャされたオブジェクトに対して実行されるアクション」を参照してください。

   • If you record a click and keystrokes in a text box with a Control Type of PASSWORD_TEXT , the Recorder does not capture the keystrokes entered into the field. Instead, the アクション selects the Set text option and offers options to securely input the password. We recommend that you store the password in the 資格情報 Vault and insert it into the アクション as a credential. Bot エディター における資格情報と資格情報変数

     If you navigate to the text box using the TAB keystroke instead of a click in an MSAA or SAP application, the Recorder is able to identify fields with a Control Type of PASSWORD_TEXT .

   • 選択した [アクション] がバックグラウンド処理をサポートしている場合、[バックグラウンドで実行] オプションが表示されます。バックグラウンド処理
10. オプション: [コントロールを待機] フィールドに値を入力して、オブジェクト コントロールがアプリケーション ウィンドウに表示されるまで Bot が待機する時間 (秒) を指定します。
    [テキストを設定] アクションを使ってテキスト フィールドにキーボード操作を入力する際には、遅延時間を設定することをお勧めします。
11. オプション: 出力を変数に代入します。
    Control Room は、ステップ 8 で選択したアクションに基づいて、分かりやすいデフォルト変数名を提案します。たとえば、[プロパティを取得] を選択した場合、出力変数の候補は PropertyValue です。複数の出力変数を作成すると、重複を避けるために、後続の変数名に「-1」が追加されます。
12. [保存] をクリックします。
    キャプチャした画像は依存関係として追加されないので、Bot のチェックイン時に依存関係リストに表示されません。