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

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

前提条件

  • レコーダー を使用するには、次の操作を実行しておく必要があります。
  • デュアル モニターを使用しているときは、両方のモニターの画面解像度が同じであることを確認してください。
  • 画面解像度が 1,366 x 768 に設定されていることを確認してください。
  • デバイスの表示とフォントの倍率を 100% に設定します。

    レコーダー パッケージ バージョン 2.0.6-20200626-193519 以降を使用している場合は、Google Chrome、Internet Explorer、Java、Microsoft Active Accessibility、および Microsoft UI の自動化アプリケーションで、デバイスの表示倍率が 100% または 125% に設定されたコンピューターでタスクを記録できます。

  • ブラウザを使用してタスクを自動化する場合は、ズーム レベルを 100% に設定します。

    レコーダー パッケージ バージョン 2.0.6-20200626-193519 以降を使用している場合は、ズーム レベル設定が 100% でない Google Chrome ブラウザでタスクを記録できます。

  • Google Chrome ブラウザを使用してタスクを自動化する場合は、Automation Anywhere のビルド バージョンに対応する Automation 360 プラグインが有効になっていることを確認します。

    Automation 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 が使用されている場合、アクションはブラウザが完全にレンダリングされるまで待機し、アクションを実行する前に準備完了状態になります。

手順

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

  1. [レコーダー] > [キャプチャ] の順にダブルクリックまたはドラッグします。
  2. オブジェクトをキャプチャするウィンドウを指定します。
    [アプリケーション]、[ブラウザ]、または [変数] タブから選択します。
    オプション説明
    アプリケーション 現在アクティブなウィンドウのリストから選択します。このオプションでは、Bot Creator デバイスで開いているすべてのアプリケーション ウィンドウとブラウザ ウィンドウのリストが表示されます。
    ブラウザ 対応ブラウザ タブのリストから選択します。
    注: このオプションは、Google Chrome、Chromium ベースの Microsoft Edge、および Internet Explorer ブラウザをサポートします。それ以外のブラウザの場合は、[アプリケーション] オプションを使用してください。
    変数 既存のウィンドウ変数を選択して、アプリケーション ウィンドウのタイトルを指定します。
  3. オプション: [ウィンドウ タイトル] フィールドでワイルドカード文字 (*) を挿入することで、さまざまなウィンドウ タイトルを検索できます。値の先頭、中間、末尾に 1 つ以上のワイルドカード文字 (*) を指定することができます。
    たとえば、タイトルに Microsoft が含まれているウィンドウで操作を実行するには、値の前または後にワイルドカードを追加して任意の文字列を示します。*Microsoft*。Bot は、まず、完全に一致するウィンドウ タイトル (この場合であれば、Microsoft) を検索し、条件に一致する文字が見つからない場合は、タイトルに Microsoft を含むウィンドウを検索します。

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

    ブラウザのタイトルを識別する場合、[大文字と小文字が区別される] オプションを有効にすると、大文字と小文字を一致させることができます。このオプションを無効にすると、大文字と小文字が一致しないウィンドウ タイトルを識別できます。
    注: システムにインストールされている最小 Bot エージェント バージョンが、Automation 360 v.26 でリリースされたバージョンであることを確認してください。Automation 360 v.25 以前でリリースされた Bot エージェント バージョンを使用している場合、ウィンドウ タイトルはデフォルトで大文字小文字を区別して識別されます。
    たとえば、単語の後に「- Notepad」が続くすべてのウィンドウ タイトル名に一致させるには、[文字列] 値として「* -Notepad」と入力するか、[パターン] 値として ((\w)\s)*document-Notepad を使用してこのパターンにマッチするウィンドウ タイトルのみに一致させます。
    注:
    • 任意のアクションでウィンドウ タイトルの入力値として「-title」を含む [文字列] 型の正規表現を使用する場合、Bot にランタイム エラーが発生する可能性があります。ランタイム エラーを防ぐために、「*-title」と文字列を追加入力したときに特定のタイトルのアプリケーションが開くことを確認します。アスタリスク (*) は単なる文字であり、ワイルド カード文字ではありません。
    • 任意のアクションでウィンドウ タイトルの入力値として「-title」を含む [パターン] 型の正規表現を使用する場合、入力値「*-title」が正しくないため、Bot にランタイム エラーが発生する可能性があります。

      有効な正規表現パターンを使用していることを確認してください。

    注: 実行中に、タスク 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. [オブジェクトのプロパティ] テーブルを確認します。
    以下は、テクノロジー タイプに応じてデフォルトで選択されるオブジェクトのプロパティの一覧です。
    注: Java または HTML テクノロジーを明示的に選択するオプションはありません。 自動検出モードでアプリケーションをキャプチャすると、レコーダー はキャプチャされるアプリケーションに基づいて自動的にテクノロジーを検出します。 レコーダー が特定のテクノロジーを検出すると、テクノロジー タイプが [オブジェクトのプロパティ] に表示されます。
    重要: 以下のリストは、すべてのプロパティを含むものではありませんが、テクノロジー タイプに応じて、最もよく使用される重要なプロパティに限定されています。
    テクノロジー タイプ オブジェクトのプロパティ 内容
    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] になります。
    たとえば、ブラウザで特定の要素のDOMXPathGoogle Chromeを見つけたい場合は、以下の手順を実行します。
    1. XPath を取得する要素を選択します。
    2. 要素を右クリックして [検査] を選択します。
    3. [要素] タブでハイライト表示された要素を右クリックします。
    4. [コピー] > [Xpath のコピー] をクリックして相対パスをコピーし、[コピー] > [完全な Xpath をコピー] を選択して絶対パスをコピーします。
    パス これは、アプリケーション内の特定のコントロールの位置を数値で表したものです。 Web アプリケーションでは、[パス] と比較したときに検索条件から [DOMXPath] を使用するのがベスト プラクティスです。
    HTML 名と ID これらのプロパティは、HTML オブジェクトを識別するために使用されます。
    HTML インナー テキスト DOM innerText プロパティは、指定ノードとその派生物のテキスト コンテンツを設定するか返すために使用します。
    HTML タグ HTML タグは、Web ブラウザでコンテンツをフォーマットして表示する方法を定義するキーワードのようなものです。 たとえば、キャプチャしたテキストに HTML コード、 <h3 class="search_results-title">「string package」の検索結果</h3> がある場合は、HTML タグ フィールドに h3 を入力します。
    Microsoft Active Accessibility コントロール タイプ このプロパティは、正しいオブジェクトがキャプチャされていることを確認するための参照としてのみ使用します。
    パス アプリケーションにおける特定のコントロールの位置を数値で表したものです。
    名前 要素の名前を指定し、識別子として機能します。
    ID 要素の ID を指定し、識別子として機能します。
    Java テクノロジー コントロール タイプ このプロパティは、正しいオブジェクトがキャプチャされていることを確認するための参照としてのみ使用します。
    パス アプリケーションにおける特定のコントロールの位置を数値で表したものです。
    Microsoft UI オートメーション コントロール タイプ このプロパティは、正しいオブジェクトがキャプチャされていることを確認するための参照としてのみ使用します。
    パス アプリケーションにおける特定のコントロールの位置を数値で表したものです。
    名前 要素の名前を指定し、識別子として機能します。
    ID 要素の ID を指定し、識別子として機能します。
    IsFirst このプロパティにより、Bot がツリー全体をトラバースするのではなく、検索条件に基づいて最初のオブジェクトを検出することができます。 このプロパティは、オブジェクトに一意の Automation ID がなく、アプリケーションでオブジェクトの階層が変更された場合に使用できます。
    Microsoft UI オートメーション (COM) コントロール タイプ このプロパティは、正しいオブジェクトがキャプチャされていることを確認するための参照としてのみ使用します。
    パス これは、アプリケーション内の特定のコントロールの位置を数値で表したものです。
    名前 要素の名前を指定し、識別子として機能します。
    ID 要素の ID を指定し、識別子として機能します。
    Bot は、選択したプロパティを使用して、実行時にオブジェクト コントロールを特定します。
    1. [コントロール タイプ] が意図したオブジェクトに一致することを確認します。
      たとえば、Web サイトからテーブルをキャプチャする際は、[コントロール タイプ] と [HTML タグ] の値が [テーブル] であることを確認します。
      [コントロール タイプ] が意図したオブジェクトに一致しない場合は、オブジェクト コントロールを再度キャプチャします。
    2. オブジェクト検索に含めるオブジェクトのプロパティを選択して、値を割り当てます。
      Bot の信頼性を高めるために、静的値を持つプロパティ ([名前]、[クラス]、[タイプ]、[HTML ID]、[DOMXPATH] など) のみを選択し、動的な値を持つプロパティ ([HTML Href]、[パス]、[値]) の選択を解除することをお勧めします。動的な値は変更される可能性があり、Bot エラーの原因となります。
      プロパティが動的で頻繁に変更されるオブジェクトを検索するには、オブジェクトのプロパティ値にワイルドカード文字 (*) または変数を使用することをお勧めします。
      注: ワイルドカード文字の照合は、現在 SAP テクノロジーではサポートされていません。 Bot をワイルドカード文字で実行すると、検索条件で指定されたとおりのプロパティ値に一致します。
  9. ドロップダウン リストから [アクション] を選択します。
    オブジェクトで実行できる アクション の完全なリストについては、「ユニバーサル レコーダー でキャプチャされたオブジェクトに対して実行されるアクション」を参照してください。
    • コントロール タイプ が Password text のテキスト ボックスにクリックとキー ストロークを記録すると、レコーダー は、フィールドに入力されたキー ストロークをキャプチャしません。 代わりに、アクション は [テキストを設定] オプションを選択し、パスワードを安全に入力するためのオプションを提供します。 パスワードを Credential Vault に保存し、資格情報としてアクションに挿入することをお勧めします。

      「Bot エディター における資格情報と資格情報変数」を参照してください。

      MSAA または SAP アプリケーションで、クリックではなく TAB キーストロークを使用してテキスト ボックスに移動した場合、[レコーダー] は [コントロール タイプ] が Password text のフィールドを特定することができます。

    • 選択した [アクション] がバックグラウンド処理をサポートしている場合、[バックグラウンドで実行] オプションが表示されます。

      「」を参照してください。

  10. [システム タイムアウトの設定] フィールドから、[基本] または [詳細] を選択します。
    • 基本: [システム レスポンスを待機 (秒数)] フィールドで、オブジェクト コントロールをアプリケーション ウィンドウに表示するまで Bot が待機する必要がある秒数を指定します。 この待機時間には、ページのロードとオブジェクト検索の両方の待機時間が含まれます。

      [テキストを設定] アクションを使ってテキスト フィールドにキーボード操作を入力する際には、遅延時間を設定することをお勧めします。

      注: アプリケーション ウィンドウにコントロールが表示されるまで Bot を待機させるタイムアウト値を指定します。このタイムアウト値は、コントロールが表示されるウィンドウが存在する場合にのみ適用されます。 レコーダーは、最初にアプリケーション ウィンドウを検索し、次にウィンドウの中にあるオブジェクトを検索します。 ウィンドウの検索時間は、デフォルトで 30 秒です。 このため、待ち時間を 5 秒に指定しても、ウィンドウが存在しない場合は、デフォルトで 30 秒間待機します。

      まず、[If] > [ウィンドウが存在する] 条件を使用し、待機時間を 0 秒に指定し、アプリケーション ウィンドウが存在することを確認することをお勧めします。 ウィンドウが存在する場合は、レコーダーを使用し、待機時間を 5 秒に指定し、Bot を実行してオブジェクトを検出します。

    • 詳細: このオプションは、株式の Web サイトなど、常に最新のデータをロードして更新している Web サイトを自動化するために使用します。 これらの Web サイトは、技術的に画面に完全にはロードされません。 このような場合、Bot は Web ページが完全にロードされるのを待つ必要がなく、一定時間後に Web ページの自動化を直接進めることができます。

      [ブラウザ レスポンスを待機 (秒数)] フィールドで、Bot がブラウザのロードを待機する必要がある秒数を指定します。 次のいずれかのオプションを選択します。

      • Bot を停止し、エラー メッセージを表示する: 指定したタイムアウト時間内に Web ページが完全にロードされなかった場合は、このオプションを選択して Bot を停止し、エラー メッセージを表示します。
      • スキップしてオブジェクトに進む: このオプションを選択すると、Web ページが完全にロードされていない場合でも、オブジェクトに直接進み、キャプチャします。

      [オブジェクト レスポンスを待機 (秒数)] フィールドで、オブジェクト コントロールをアプリケーション ウィンドウに表示するまで Bot が待機する必要がある秒数を指定します。

  11. オプション: 出力を変数に代入します。
    Control Room は、ステップ 8 で選択したアクションに基づいて、分かりやすいデフォルト変数名を提案します。 たとえば、[プロパティを取得] を選択した場合、出力変数の候補は PropertyValue です。 複数の出力変数を作成すると、重複を避けるために、後続の変数名に -1 が追加されます。
  12. [保存] をクリックします。
    キャプチャした画像は依存関係として追加されないので、Bot のチェックイン時に依存関係リストに表示されません。
サポートしているアンカーにオブジェクトをリンクする
注: オブジェクト固定は、Microsoft Active Accessibility、Microsoft UI Automation、または Java アプリケーションで使用できます。
実行時に Bot がオブジェクトを確実に識別できない場合は、そのオブジェクトを近くのオブジェクト (リンクやボタンなど) にリンクし、Bot が簡単に見つけられるようにします。
  1. [キャプチャ] アクションを開きます。
  2. [アンカー] タブをクリックします。
  3. [アンカーをキャプチャ] をクリックします。

    ブラウザまたはアプリケーションのウィンドウが起動し、メイン オブジェクト (前にキャプチャしたオブジェクト) がハイライトされます。 アクションがメイン オブジェクトを正しく識別したかどうかを確認するダイアログ ボックスが表示されます。

  4. 正しいオブジェクトがハイライトされている場合は、[はい、アンカーを選択します] をクリックします。

    それ以外の場合は、[いいえ、修正する必要があります] をクリックして、正しいオブジェクトを選択します。

  5. 対象オブジェクトの近くにある、Bot が見つけやすいオブジェクトを選択します。

    オブジェクトはハイライトされ、右側にはアンカー アイコンが表示されます。

  6. [保存] をクリックします。