レコーダー パッケージ

レコーダー パッケージ は、プロセス内の一連のタスクをキャプチャし、それらを自動化します。 レコーダー を使用して、テキスト ボックス、ボタン、テーブル、ラジオ ボタン、コンボ ボックス、リスト ビューなどのアプリケーション オブジェクトで実行される アクション をキャプチャして、ビジネス アプリケーション (デスクトップ、Web、SAP、Java アプリケーションなど) を自動化できます。

Automation 360 の拡張機能設定

Bot または レコーダー ブラウザで動作する静的ページをGoogle Chromeを使用して自動化したときに Microsoft Edge の実行に時間がかかる場合は、次の手順に従って Automation 360 の拡張機能の設定を有効にします。
  • ブラウザ ウィンドウの右上隅にある拡張機能アイコンをクリックします。
  • Automation 360 プラグインの横にある縦の 3 点リーダーをクリックして、[拡張機能の管理] を選択します。
  • [ファイル URL へのアクセスを許可する] オプションを有効にします。
  • ブラウザを再起動して、Bot を実行します。

レコーダー パッケージの代わりにSAP パッケージを使用するメリット

レコーダー アプリケーションを自動化するには、SAPを使用することをお勧めします。 レコーダーを使用して SAP アプリケーションを自動化すると、次のメリットを得ることができます。
  • セッションを作成せずにオブジェクトを自動化することができます。 SAP パッケージを使用する場合は、セッションを作成する必要があります。
  • フィールド パスを生成したり、フィールド パスに関する予備知識を習得したりすることなく直接、オブジェクトを自動化できます。 SAP パッケージを使用する場合、検索条件のプロパティと、実行中に パッケージ が検索するオブジェクトが一致すると、アクションにより、コントロール フィールド パスで直接、Botが実行されます。
  • レコーダー ランタイム ウィンドウと自動化したいオブジェクトが重なる場合、レコーダーはオブジェクトが自動化される前にランタイム ウィンドウを非表示にします。
  • レコーダーは、条件、ループおよび待機 パッケージのアクションをサポートしており、これらを使用すると特定のブラウザまたはウィンドウ中にオブジェクトが存在するかどうかをチェックすることができます。
注: レコーダー パッケージと比較した場合、SAP パッケージを使用すると、アプリケーション ウィンドウをアクティブ化することなくアプリケーションを自動化できます。

レコーダーを使用したキャプチャ

[キャプチャ] アクション を使用して、ユーザー インターフェース (UI) オブジェクトとのインタラクションをキャプチャします。 この アクション により、Bot のビルド時に単一のインタラクションを追加できます。
注:
  • アクション 以降、オブジェクト クローニング コマンドは [キャプチャ] バージョン 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 ページを自動化している場合、ターゲット オブジェクトが画面上に表示されていると、[レコーダー] > キャプチャ アクションにより、Web ページが下にスクロールされなくなりました。 これにより、Web ページに固定された上部ペインがあり、マウス クリックなどの物理的なアクションが想定どおりに動作しない場合のユーザー エクスペリエンスと、オートメーションの信頼性が向上します。

レコーダー > キャプチャ アクションを使用すると、デバイスの資格情報が UPN 形式で入力されたときに、オブジェクトが正常に自動化されます。

Silverlight テクノロジーの手動構成

レコーダー パッケージ (バージョン 2.17.2 以降) と、Automation 360 v.31 でリリースされた新しい Bot エージェント (バージョン 22.1.22) では、Silverlight テクノロジーは構成されなくなります。 Silverlight テクノロジーを構成する場合は、次の手順に従って check.exe ファイルを手動で実行してください。
注: check.exe ファイルを実行する前に、許可リストに追加してください。
  1. C:\ProgramData\AutomationAnywhere\GlobalCache\embedded-resources に移動します
  2. ec0db824-25eb-4c57-ab44-f77ef67d2579 を検索します。

    検索結果に レコーダー パッケージのリストが表示されます。

  3. 使用する レコーダー パッケージを選択します。
  4. 該当するフォルダーから check.exe ファイルを管理者として実行します。
あるいは、次の手順に従って、Windows PowerShell から check.exe ファイルを手動で実行することもできます。
  1. [ファイル] メニューをクリックします。
  2. Windows PowerShell を開く > Windows PowerShell を管理者として開く に移動します。

    Windows PowerShell を開く

  3. スクリプトに .\Check.exe を入力し、[Enter] をクリックします。
次の手順に従って、コマンド プロンプトから手動で check.exe ファイルを実行します。
  1. コマンド プロンプトを開き、管理者として実行します。
  2. C:\ProgramData\AutomationAnywhere\GlobalCache\embedded-resources\ の後に続けて、使用する レコーダー パッケージのバージョンを入力します。
  3. スクリプトに Check.exe を入力し、[Enter] をクリックします。

サポートされているアプリケーション

Microsoft Edge Chromium 上で IE モードで実行されている次のアプリケーションを自動化することができます:
  • Java Web アプリケーション
  • Citrix Workspace アプリからアクセスするアプリケーション。
  • Citrix Virtual Apps
    注: Citrix 仮想アプリおよびデスクトップ バージョン 2303 は レコーダー パッケージで認証されています (バージョン 2.16.0-20231101-165457 以降)。
注:
  • SAP アプリケーション上のオブジェクトを正確にキャプチャまたは自動化するには、スクリプト記述を有効にすることをお勧めします。 スクリプト記述が有効でない場合、Bot ランタイム ウィンドウの下に以下のプロンプト メッセージが表示されます。

    SAP スクリプトは無効です。 スクリプトを有効にすることで、より確実なキャプチャが可能になります

    スクリプト記述を有効にしない場合、SAP テクノロジーを使用する代わりに、レコーダー は、オブジェクトのキャプチャに MSAA テクノロジーを使用します。

  • Electron アプリケーションを自動化する場合、レコーダー はデフォルトで Microsoft UI オートメーション (COM) テクノロジーを使用して、アプリケーション上の特定のコントロールをキャプチャします。 これにより、特定のテクノロジーでオブジェクトを再キャプチャすることなく、Electron アプリケーションをシームレスに自動化することができます。

Citrix XenApp のサポート

Citrix XenApp アプリケーションから Google Chrome または Microsoft Edge ブラウザ ウィンドウを起動したり、特定のブラウザから Control Room にアクセスしたり、XenApp として実行される他の仮想アプリケーションを自動化したりできるようになりました。 これにより、Control Room とビジネス アプリケーションの両方を同じシステムから仮想アプリケーションとしてデプロイして起動する際に、信頼性の高いオブジェクトベースのオートメーションが可能になります。
注:
  • ビジネスアプリケーションを起動するのと同じ Citrix XenApp サーバーに Bot エージェントをインストールしてください。
  • Control Room を XenApp として起動する場合、Automation Anywhere リモート エージェント (Citrix 用) は必要ありません。
Citrix XenApp 環境では、バージョンの異なる Bots レコーダーを使用する親および子の パッケージ を正常に実行できます。
注: 複数のバージョンの レコーダー パッケージを Bot で効果的に使用して実行するには、Bots が親も子も レコーダー パッケージ (バージョン 2.16.0-20231101-165457 以降) を使用していることを確認してください。 以前のバージョンを使用すると、この機能がサポートされず、Citrix 環境での Bot の実行中に不整合やエラーが発生する可能性があります。

サポートされるコントロール タイプ

Web ページを Google Chrome、Microsoft Edge Chromium、または Mozilla Firefox ブラウザで自動化する場合、以下のコントロール タイプを自動化できます。
  • ポップアップ ウィンドウ
  • アラート ダイアログ ボックス
  • 確認ダイアログ ボックス
  • プロンプト ダイアログ ボックス
注: Web ページのアラート ダイアログ ボックスを自動化する場合は、[レコーダー] > [キャプチャ] アクション の前に遅延を追加することをお勧めします。これは、アラート ダイアログ ボックスが遅延の後にアプリケーション ウィンドウに表示されることがあるためです。

クロスドメイン サポート

同じフレーム ソースの複数の IFrame や、Google Chrome および Microsoft Edge Chromium ブラウザで実行時に動的に読み込まれる IFrame を持つクロスドメイン IFrame 内のオブジェクトをキャプチャおよび自動化できます。 クロス ドメイン IFrame 内のオブジェクトをキャプチャした後、フレームのパスが [FrameDOMXPath] プロパティにデフォルトで格納されます。

FrameDOMXPath プロパティを使用したキャプチャ

新しい [FrameDOMXPath] プロパティは、オブジェクトが配置されているフレームを識別します。 Bot を正常に実行して、クロスドメイン IFrame のオブジェクトを自動化するには、このプロパティを選択する必要があります。
注:
  • [FrameDOMXPath] プロパティを検索条件から選択した場合、このプロパティの値を変更しないでください。
  • 検索条件から [FrameDOMXPath] プロパティを消去すると、レコーダーはフレームの識別に失敗します。
重要: Google Chrome ブラウザでは、クロスドメイン内のオブジェクトをキャプチャして自動化し、同じフレーム ソースで複数のフレームを使用できます。

管理者ユーザーとして実行するアプリケーションの自動化

Bot エディターから [管理者権限でキャプチャして実行する] オプションを選択すると、管理者として実行されているアプリケーションのオブジェクトをキャプチャできます。

管理者ユーザーとして実行されているアプリケーションを自動化する前に、以下を確認してください。
  • Bot エージェントがシステム プロファイルにインストールされている。
  • Bot 作成者 と Bot Runners が、アプリケーションを自動化するデバイスに対する管理者権限を持っている。
Bot エディターの [記録を開始] オプションを選択して複数のアプリケーションを記録し、昇格モードおよび非昇格モードで実行中のアプリケーションを切り替えると、Bot がモード間の変更を識別できない場合があります。 このような場合は、昇格モードのアプリケーションのすべてのキャプチャについて、[管理者権限でキャプチャして実行する] オプションを選択した後、オブジェクトを再キャプチャしてください。
注: 昇格モードは、管理者としてアプリケーションを実行する許可を与えるものです。
重要: レコーダーを昇格モードで使用して、非昇格の Java アプリケーションまたは SAP アプリケーションを自動化しようとすると、Bot でエラーが発生します。

このエラーを回避するには、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フレームワークを使用するデスクトップアプリケーションを自動化するには、昇格モードで自動化を開発および実行する必要があります。 「」を参照してください。
重要: この機能は レコーダー パッケージ バージョン 3.5.0-20241129-105732 以降で利用可能です。
サポート可能性
  • すべての既存の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 です。
[フレーム名] プロパティを使用すると、オブジェクトが存在する特定のフレームを見つけてコントロールを自動化することができます。 これにより、オートメーションのパフォーマンスと信頼性が向上します。
注:
  • 内部フレーム内の特定のコントロールのフレーム名が空白の場合、キャプチャされたオブジェクトの フレーム名 プロパティは空白になり、デフォルトの検索条件として追加されません。
  • オブジェクトが内部フレーム内にない場合、プロパティはリストに表示されません。
  • [フレーム名] プロパティは、ワイルドカード文字と変数の両方をサポートしています。
  • ウィンドウによっては [フレーム名] が変わる場合があるため、内部フレーム オブジェクトを識別するためには、ワイルドカード (*) 文字を使うことをお勧めします。
注:
  • 既存のオートメーションに新しいプロパティを使用する場合は、コントロールを再キャプチャしてください。
  • この機能は既存の Bots には影響しないため、変わらず実行が継続されます。

オブジェクトのプロパティ

キャプチャするオブジェクトを選択すると、実行時にオブジェクトを特定するために、ユニバーサル レコーダー によってオブジェクトのプロパティのデータが収集されます。 オブジェクト プロパティで以下の操作を実行できます。
  • キャプチャしたオブジェクト プロパティが意図したオブジェクトと一致することを確認します。

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

    コントロール タイプのプロパティ テーブル

  • プロパティ値を取得します。 プロパティを取得 アクション を使用して、プロパティ名フィールドにプロパティの名前を入力するか、使用可能なプロパティのリストからオブジェクト プロパティを選択します。 このリストには、オブジェクトプロパティ テーブルの検索基準から提案されるプロパティ値が含まれています。 プロパティのリストからオブジェクトプロパティを選択するには、マウス ポインターを プロパティ名フィールドの右側に移動し、矢印をクリックします。

    たとえば、リンクのテキストを取得するには、[プロパティを取得] アクションを使用して、[プロパティ名] フィールドに「HTML InnerText」と入力するか、プロパティのリストから [HTML InnerText] を選択します。

  • Bot のプロパティの組み合わせを選択して、ビジネス アプリケーション ウィンドウでオブジェクトを一意に検索できます。

TOP オブジェクトのプロパティ

クリック、右クリック、ダブルクリック、テキストの設定、プロパティの取得 アクションを使用する場合は、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 は、条件に一致する最初のテキスト ボックスをキャプチャします。

注: この機能は、Automation 360 v.23 以降の 2.4.0-20211016-070100 バージョンの レコーダー パッケージ を使用して作成する Bot で利用可能です。 以前のバージョンの Bots レコーダー を使用して パッケージ を作成した場合、この機能を使用するには、オブジェクトを再キャプチャする必要があります。

キャプチャしたオブジェクトで実行するアクション

オブジェクトをキャプチャした後、実行時にオブジェクトで Bot が実行するアクションを指定します。 たとえば、ハイパーリンクをキャプチャするときに、ボタンをクリックすることやリンクのテキストを取得することができます。 すべてのオブジェクトの表および可能な操作については、「ユニバーサル レコーダー でキャプチャされたオブジェクトに対して実行されるアクション」を参照してください。
注: Bot からオブジェクトをキャプチャする Internet Explorer を実行しているときにエラーが発生し、エラー メッセージが Google Chrome に関するものである場合は、「Your Chrome Plug-in is either not installed or disabled (A-People login required)」を参照してください。

バックグラウンド処理

バックグラウンド処理は、フォアグラウンドでのアプリケーションとの対話 (マウス クリックなど) を伴うオートメーションを、バックグラウンドで実行できるようにするものです。ターゲット オブジェクトの可視性を高め、Bot の精度を向上させるために、バックグラウンドで実行するオプションを使用することをお勧めします。次の アクション はバックグラウンド処理に対応しています。
  • クリック
  • テキストを設定
  • テキストを取得

安全性が確保されたレコーディング

安全な記録モードが有効になっている場合、Bots はキャプチャ後にターゲット オブジェクトの画像を表示しません。 これにより、機密データが表示されることはありません。
注: Bots はキャプチャ後にターゲット画像を表示しませんが、画像は Control Room を実行するのに必要であるため、Bots に保存されます。

安全な記録モードでタスクを記録すると、[プレビュー] ウィンドウにキャプチャされた領域の画像が一時的に表示されます。 この画像は、Bot エディター ウィンドウ外に移動したり、ウィンドウを更新すると非表示になります。

新しいオートメーションについては、安全な記録モードでオブジェクトをキャプチャするときに、[Automatically delete unused object properties on save] (保存時に未使用のオブジェクト プロパティを自動的に削除) オプションを有効にすることで、未使用のオブジェクト プロパティの値を自動的に削除するように選択できます。 このオプションを有効にすると、オートメーションを保存し、更新したときに検索条件の一部ではないオブジェクト プロパティの値が破棄されます。 これにより、個人を特定できる情報 (PII) がオートメーションに誤って保存されることがなくなります。 安全な記録の設定を有効にする方法の詳細については、「安全な記録」を参照してください。
注: タスクを自動化するために 生成レコーダー を使用していて、[Automatically delete unused object properties on save] (保存時に未使用のオブジェクト プロパティを自動的に削除) オプションを有効にしている場合、生成 AI フォールバックがサポートされません。
注:
  • この機能は、レコーダー パッケージ (バージョン 3.2.1-20240606-105427 以降) および Bot エージェント (バージョン 22.60.23 以降) でサポートされています。
  • 既存のオートメーションでこのオプションを使用する場合は、コントロールを再キャプチャする必要があります。
  • [左]、[右]、[高さ]、[幅] プロパティの値は破棄されません。

管理者権限を持つユーザーは、この設定を有効にする必要があります。 「設定を構成する」を参照してください。

プロキシ サポート

デバイスがプロキシで構成されている場合、この パッケージ からのすべてのアウトバウンド リクエストはプロキシ サーバー経由でルーティングされます。 「Bot エージェント とプロキシの設定されているデバイスの接続」を参照してください。

レコーダーの事例

以下のサンプル タスクは、Bots のビルドでレコーダーを使用する方法について紹介しています。