[レコーダー] パッケージ
- 最終更新日2025/09/11
レコーダー パッケージ は、プロセス内の一連のタスクをキャプチャし、それらを自動化します。 レコーダー を使用して、テキスト ボックス、ボタン、テーブル、ラジオ ボタン、コンボ ボックス、リスト ビューなどのアプリケーション オブジェクトで実行される アクション をキャプチャして、ビジネス アプリケーション (デスクトップ、Web、SAP、Java アプリケーションなど) を自動化できます。
Automation 360 の拡張機能設定
- ブラウザ ウィンドウの右上隅にある拡張機能アイコンをクリックします。
- Automation 360 プラグインの横にある縦の 3 点リーダーをクリックして、拡張機能の管理 を選択します。
- ファイル URL へのアクセスを許可する オプションを有効にします。
- ブラウザを再起動して、Bot を実行します。
レコーダー パッケージの代わりにSAP パッケージを使用するメリット
- セッションを作成せずにオブジェクトを自動化することができます。 SAP パッケージを使用する場合は、セッションを作成する必要があります。
- フィールド パスを生成したり、フィールド パスに関する予備知識を習得したりすることなく直接、オブジェクトを自動化できます。 SAP パッケージを使用する場合、検索条件のプロパティと、実行中に パッケージ が検索するオブジェクトが一致すると、アクションにより、コントロール フィールド パスで直接、Botが実行されます。
- レコーダー ランタイム ウィンドウと自動化したいオブジェクトが重なる場合、レコーダーはオブジェクトが自動化される前にランタイム ウィンドウを非表示にします。
- レコーダーは、条件、ループおよびWait パッケージのアクションをサポートしており、これらを使用すると特定のブラウザまたはウィンドウ中にオブジェクトが存在するかどうかをチェックすることができます。
レコーダーを使用したキャプチャ
- アクション 以降、オブジェクト クローニング コマンドは [キャプチャ] バージョン 11.3 に置き換えられました。
- コンピューターへのログインに使用したユーザー アカウントとは異なるユーザー アカウントで対応ブラウザやアプリケーションを起動すると、レコーダー がコントロール アクション を正確にキャプチャし再生できない場合があります。
- デュアル モニターを使用しているときにオブジェクトを確実にキャプチャするには、両方のモニターの画面解像度が同じであることを確認してください。
- レコーダー v.29 とともにリリースされた パッケージ (バージョン 21.250 以降) でBot エージェント Automation 360 (バージョン 2.3.0-20210806-215200 以前) を使用すると、オブジェクトのキャプチャ中に問題が発生する場合があります。 オブジェクトを正常にキャプチャするには、レコーダー (バージョン 21.250 以降) でパッケージ Bot エージェント (バージョン 2.4.0-20211118-080716 以降) を使用することをお勧めします。
- Bot エージェントがユーザーレベル、つまりユーザー固有のインストール タイプでインストールされている場合は、Bot エージェントを実行しているセッションに必要な権限がない可能性があるため、Citrix、Java、および SAP は構成されません。 現在のユーザーには VMWare プラグインのみが構成されます。
Google Chrome および Microsoft Edge ブラウザで実行中のウェブページを自動化している場合、ターゲット オブジェクトが画面上に表示されていると、 アクションにより、ウェブページが下にスクロールされなくなりました。 これにより、Web ページに固定された上部ペインがあり、マウス クリックなどの物理的なアクションが想定どおりに動作しない場合のユーザー エクスペリエンスと、オートメーションの信頼性が向上します。
アクションを使用すると、デバイスの資格情報が UPN 形式で入力されたときに、オブジェクトが正常に自動化されます。
ウェブアプリケーションが頻繁に変更され、動的な性質を持つ場合は、生成レコーダー を使用して自動化します。 「生成レコーダー」をご覧ください。
macOS プラットフォーム上でのSafari ブラウザのウェブ自動化
レコーダー は Safari ブラウザ上での自動化をサポートし、macOS プラットフォーム上のウェブアプリケーションのオブジェクトベースの自動化を提供します。 Safari は macOS ユーザーのデフォルトブラウザであるため、この機能は自動化の採用とカバレッジを向上させ、macOS ユーザーがウェブアプリケーションを自動化できるようにします。 レコーダー は、サードパーティのプラグインを必要とせずに、ボタン、フォーム、リンクなどの Safari のウェブ要素と直接やり取りすることを可能にします。
- オブジェクト プロパティ の ブラウザタイプ プロパティには Apple Safari が表示されます。
- ブラウザ アプリケーション フィールドには Apple Safari が表示されます。
- 録画中、Safari ブラウザウィンドウがウィンドウリストに表示され、Google Chrome や Microsoft Edge などの他のブラウザとグループ化されます。
macOSでサポートされているテクノロジー
- HTML 技術(Google Chromeのみ)
- macOS アクセシビリティ技術
新しい macOS アクセシビリティ技術は、macOS の組み込みアクセシビリティ機能を活用することで、自動化機能を強化します。 この技術により、レコーダーはmacOS上のアプリケーションのユーザーインターフェース要素と直接対話することができます。 自動化スクリプトを作成するために不可欠な、ボタンをクリックしたり、テキストを入力したり、画面から値を読み取ったりするなどのactionsを実行できます。
さらに、macOSのアクセシビリティ技術は、ファンクションキーや特別なキーの組み合わせを含む、幅広いmacOS特有のキーボード入力をサポートしており、これにより自動化を効率的に作成、テスト、展開することができます。
レコーダー によってキャプチャされたプロパティのリストについては を参照してください。
Silverlight テクノロジーの手動構成
- C:\ProgramData\AutomationAnywhere\GlobalCache\embedded-resources に移動します
-
ec0db824-25eb-4c57-ab44-f77ef67d2579 を検索します。
検索結果に レコーダー パッケージのリストが表示されます。
- 使用する レコーダー パッケージを選択します。
- 該当するフォルダーから check.exe ファイルを管理者として実行します。
- ファイル メニューをクリックします。
-
- スクリプトに .\Check.exe を入力し、Enterをクリックします。
- コマンド プロンプトを開き、管理者として実行します。
- C:\ProgramData\AutomationAnywhere\GlobalCache\embedded-resources\ の後に続けて、使用する レコーダー パッケージのバージョンを入力します。
- スクリプトに Check.exe を入力し、Enter をクリックします。
サポートされているアプリケーション
- Java Web アプリケーション
- Citrix Workspace アプリからアクセスするアプリケーション。
-
Citrix Virtual Apps
注: Citrix 仮想アプリおよびデスクトップ バージョン 2303 は レコーダー パッケージ (バージョン 2.16.0-20231101-165457 以降) で認証されています。
- SAP アプリケーション上のオブジェクトを正確にキャプチャまたは自動化するには、スクリプト記述を有効にすることをお勧めします。 スクリプト記述が有効でない場合、Bot ランタイム ウィンドウの下に以下のプロンプト メッセージが表示されます。
SAP スクリプトは無効です。 スクリプトを有効にすることで、より確実なキャプチャが可能になります
スクリプト記述を有効にしない場合、SAP テクノロジーを使用する代わりに、レコーダー は、オブジェクトのキャプチャに MSAA テクノロジーを使用します。
- Electron アプリケーションを自動化する場合、レコーダー はデフォルトで Microsoft UI オートメーション (COM) テクノロジーを使用して、アプリケーション上の特定のコントロールをキャプチャします。 これにより、特定のテクノロジーでオブジェクトを再キャプチャすることなく、Electron アプリケーションをシームレスに自動化することができます。
- Microsoft Active Accessibility (MSAA)
- Microsoft UI オートメーション
- Microsoft COM UI オートメーション
Citrix XenApp のサポート
- ビジネスアプリケーションを起動するのと同じ Citrix XenApp サーバーに Bot エージェントをインストールしてください。
- Control Room を XenApp として起動する場合、Automation Anywhere リモート エージェント (Citrix 用) は必要ありません。
- 旧バージョンのパッケージで作成された自動化は、新しいリモート エージェント バージョン3.5.2と完全に互換性があります。 既存のオートメーションは、特に変更を加えることなくそのまま実行できます。
-
パッケージ(バージョン 5.0.5-20250903-100026 以降)を旧リモート エージェントと併用する場合でも、あなたの自動化は以前のリモート エージェント バージョンと同様に動作します。
これにより、さまざまなパッケージとリモート エージェントのバージョン間で互換性が保証されるため、安心してアップデートでき、一貫した自動化パフォーマンスを維持できます。
サポートされるコントロール タイプ
- ポップアップ ウィンドウ
- アラート ダイアログ ボックス
- 確認ダイアログ ボックス
- プロンプト ダイアログ ボックス
クロスドメイン サポート
同じフレーム ソースの複数の IFrame や、Google Chrome および Microsoft Edge Chromium ブラウザで実行時に動的に読み込まれる IFrame を持つクロスドメイン IFrame 内のオブジェクトをキャプチャおよび自動化できます。 クロス ドメイン IFrame 内のオブジェクトをキャプチャした後、フレームのパスが FrameDOMXPath プロパティにデフォルトで格納されます。
- FrameDOMXPath プロパティを検索条件から選択した場合、このプロパティの値を変更しないでください。
- 検索条件から FrameDOMXPath プロパティを消去すると、レコーダーはフレームの識別に失敗します。
管理者ユーザーとして実行するアプリケーションの自動化
管理者として実行されているアプリケーションのオブジェクトをキャプチャするには、Bot エディターから管理者権限でキャプチャして実行するオプションを選択してください。
- Bot エージェントがシステム プロファイルにインストールされている。
- Bot Creator と Bot Runner が、アプリケーションを自動化するデバイスに対する管理者権限を持っている。
このエラーを回避するには、Bot エディターで管理者権限でキャプチャして実行するオプションの選択を解除し、レコーダーを非昇格モードで実行して Java アプリケーションまたは SAP アプリケーションをキャプチャします。
マルチユーザー アクセスを必要とするアプリケーションの自動化
- この機能は、Google Chrome、Microsoft Edge、IE モード ブラウザの Microsoft Edge 上で動作する Web アプリケーションのオートメーションに対応しています。
- この機能は、レコーダー パッケージ (バージョン 3.2.1-20240606-105427 以降) および Bot エージェント (バージョン 22.60.23 以降) でサポートされています。
- 他のユーザー権限で開かれたブラウザ アプリケーションを自動化する場合は、昇格モードでオートメーションをキャプチャおよび実行するようにしてください。
- Bot エージェントが更新されたら、ブラウザ アプリケーションを再起動する必要があります。
- 高度なタイムアウト オプションは現在、サポートされていません。
Chromium埋め込みフレームワーク (CEF) デスクトップアプリを自動化する
開発者は、デスクトップアプリケーションにウェブブラウザ機能を追加するために、組み込みのクロミウムブラウザを使用します。レコーダー は、そのようなデスクトップアプリケーションのオブジェクトベースの自動化をサポートし、より広範な自動化カバレッジを確保します。
レコーダー はこれらの CEF デスクトップアプリを HTML テクノロジーとして検出します。
デスクトップ CEF アプリケーションで JavaScript スニペットを実行するか、JavaScript 関数を呼び出すには、[JavaScript を実行] アクション | JavaScript 関数を呼び出すアクションを参照してください。
- すべての既存の HTML コントロールとそれに対応する アクション がサポートされています。
- CEFアプリは、cef sharpライブラリとwinformsを使用して開発されており、サポートされています。
- クロスドメインIFrameがサポートされています。
- CSSセレクタを使用して要素を特定することがサポートされています。 [Shadow DOM標準を使用したウェブアプリを自動化する]を参照してください。
- 32-bit CEF アプリケーションは現在サポートされていません。
- WPFおよび.NET Coreベースのアプリケーションで開発されたCEFアプリケーションは現在サポートされていません。
- 単一の CEF アプリケーションで複数のブラウザ コントロールを自動化することはサポートされていません。
- 生成レコーダー を使用したCEFベースのアプリケーションの自動化はサポートされていません。
- CEF アプリケーションでは、高度なタイムアウト オプションは現在、サポートされていません。
- Shadow DOM 標準を使用したウェブアプリの自動化はサポートされていません。
Java アプリケーションの自動化
Oracle EBS アプリケーションなど、Java アプリケーションで同様のプロパティを持つコントロールを自動化する場合、パスのプロパティが大きく変化するため、信頼性は高くなりません。 このようなシナリオで信頼性の高いコントロールの自動化をするには、出現 オブジェクト プロパティを使用します。
- 出現 プロパティは、デフォルトの検索条件の一部ではありません。
- 出現 プロパティは、キャプチャ時ではなく、実行時にのみ取得されます。
- 出現 プロパティの最大値は、画面上に表示される類似のコントロールの数に依存します。 たとえば、説明 タイプのコントロールが画面上に 15 個表示されている場合、出現の最大値は 15 になります。 画面上のコントロールをスクロールしても、出現の最大値は 15 のままです。
- 出現値の範囲は 1 ~ 999 です。
- 内部フレーム内の特定のコントロールのフレーム名が空白の場合、キャプチャされたオブジェクトの フレーム名 プロパティは空白になり、デフォルトの検索条件として追加されません。
- オブジェクトが内部フレーム内にない場合、プロパティはリストに表示されません。
- フレーム名 プロパティは、ワイルドカード文字と変数の両方をサポートしています。
- ウィンドウによっては フレーム名 が変わる場合があるため、内部フレーム オブジェクトを識別するためには、ワイルドカード (*) 文字を使うことをお勧めします。
- 既存のオートメーションに新しいプロパティを使用する場合は、コントロールを再キャプチャしてください。
- この機能は既存の Bot には影響しないため、変わらず実行が継続されます。
オブジェクトのプロパティ
- キャプチャしたオブジェクト プロパティが意図したオブジェクトと一致することを確認します。
たとえば、Web サイトからテーブルをキャプチャする際は、コントロール タイプ と HTML タグ の値が TABLE であることを確認します。
- プロパティ値を取得します。
プロパティを取得
アクション を使用して、プロパティ名フィールドにプロパティの名前を入力するか、使用可能なプロパティのリストからオブジェクト プロパティを選択します。 このリストには、オブジェクト プロパティ テーブルの検索条件から提案されたプロパティ値が含まれています。 プロパティのリストからオブジェクトプロパティを選択するには、マウスポインターをプロパティ名フィールドの右側に移動し、矢印をクリックします。
たとえば、リンクのテキストを取得するには、プロパティを取得 アクション を使用して、プロパティ名 フィールドにHTML InnerTextと入力するか、プロパティのリストから HTML InnerText を選択します。
- Bot のプロパティの組み合わせを選択して、ビジネス アプリケーション ウィンドウでオブジェクトを一意に検索できます。
クリック、右クリック、ダブルクリック、テキストの設定、プロパティの取得 アクションを使用する場合は、TOP オブジェクトのプロパティを使用します。
設計時に、要素の位置は、DOM 領域 (1) の上部 (3) と左側からドキュメント ポイントを計算することによって決まります。 たとえば、姓の要素を取得したとき、TOP プロパティの値は、DOM の上部 (3) から計算されて 131
と記録されます。 ただし、実行時には、この姓要素のTOPプロパティの値が216
として表示されます。 この不一致が発生するのは、実行時に拡張機能が要素の位置を DOM の上部 (3) ではなく、ナビゲーション バー (2) から計算するためです。
レコーダー パッケージ の検索アルゴリズムにより、Bot を実行したとき、オブジェクトは、そのプロパティが オブジェクト プロパティ テーブルで選択されている検索条件と完全に一致する場合にのみキャプチャされるようになります。 オブジェクトのプロパティが検索条件と完全に一致しない場合は、Bot はエラー メッセージを表示して失敗します。 ただし、検索条件にワイルド カード文字が含まれている場合には、Bot は検索条件に一致する最初のオブジェクトをキャプチャします。
たとえば、firstname1、firstname2、firstname3 と名前の 3 つのテキスト ボックスがあるアプリケーションから 1 つのテキスト ボックスをキャプチャするために、検索条件として HTML 名 を選択して、HTML 名フィールドにfirstnameと入力し、Bot を実行すると、Bot はエラー メッセージを表示して失敗します。これは、firstnameという HTML 名のテキスト ボックスが存在しないためです。 しかし、HTML 名 フィールドに firstname* を入力して Bot を実行すると、Bot は、条件に一致する最初のテキスト ボックスをキャプチャします。
キャプチャしたオブジェクトで実行するアクション
バックグラウンド処理
- クリック
- テキストを設定
- テキストを取得
安全な記録
安全な記録モードでタスクを記録すると、プレビュー ウィンドウにキャプチャされた領域の画像が一時的に表示されます。 この画像は、Bot エディター ウィンドウ外に移動したり、ウィンドウを更新すると非表示になります。
- この機能は、レコーダー パッケージ (バージョン 3.2.1-20240606-105427 以降) および Bot エージェント (バージョン 22.60.23 以降) でサポートされています。
- 既存のオートメーションでこのオプションを使用する場合は、コントロールを再キャプチャする必要があります。
- 左、右、高さ、幅 プロパティの値は破棄されません。
管理者権限を持つユーザーは、この設定を有効にする必要があります。 [設定を構成する]を参照してください。
プロキシ サポート
デバイスがプロキシで構成されている場合、この パッケージ からのすべてのアウトバウンド リクエストはプロキシ サーバー経由でルーティングされます。 [Bot エージェント とプロキシの設定されているデバイスの接続]を参照してください。
レコーダーの事例
以下のサンプル タスクは、Bot のビルドでレコーダーを使用する方法について紹介しています。