Recorder パッケージ

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

Automation 360 の拡張機能設定

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

SAP packageの代わりにRecorder packageを使用するメリット

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

Recorderを使用したキャプチャ

[キャプチャ] action を使用して、ユーザー インターフェース (UI) オブジェクトとのインタラクションをキャプチャします。この action により、bot のビルド時に単一のインタラクションを追加できます。
注:
  • Version 11.3 以降、Object Cloning コマンドは [キャプチャ] action に置き換えられました。
  • コンピューターへのログインに使用したユーザー アカウントとは異なるユーザー アカウントで対応ブラウザ、またはアプリケーションを起動すると、Recorder がコントロール actionsを正確にキャプチャし再生できない場合があります。
  • デュアル モニターを使用しているときにオブジェクトを確実にキャプチャするには、両方のモニターの画面解像度が同じであることを確認してください。
  • Automation 360 v.29 とともにリリースされた Bot Agent (バージョン 21.250 以降) でRecorder package (バージョン 2.3.0-20210806-215200 以前) を使用すると、オブジェクトのキャプチャ中に問題が発生する場合があります。オブジェクトを正常にキャプチャするには、Bot Agent (バージョン 21.250 以降) でRecorder package (バージョン 2.4.0-20211118-080716 以降) を使用することをお勧めします。
  • Bot Agentがユーザーレベル、つまりユーザー固有のインストール タイプでインストールされている場合は、Bot Agentを実行しているセッションに必要な権限がない可能性があるため、Citrix、Java、および SAP は構成されません。現在のユーザーには VMWare プラグインのみが構成されます。

[キャプチャ] action の使用

Google Chrome および Microsoft Edge ブラウザで実行中の Web ページを自動化している場合、ターゲット オブジェクトが画面上に表示されていると、[レコーダー] > [キャプチャ] actionにより、Web ページが下にスクロールされなくなりました。これにより、Web ページに固定された上部ペインがあり、マウス クリックなどの物理的なアクションが想定どおりに動作しない場合のユーザー エクスペリエンスと、オートメーションの信頼性が向上します。

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

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

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

    検索結果に Recorder packagesのリストが表示されます。

  3. 使用する Recorder packageを選択します。
  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\ の後に続けて、使用する Recorder packageのバージョンを入力します。
  3. スクリプトに Check.exe を入力し、[Enter] をクリックします。

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

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

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

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

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

Citrix XenApp のサポート

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

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

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

クロスドメイン サポート

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

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

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

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

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

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

このエラーを回避するには、Bot editorで [管理者権限でキャプチャして実行する] オプションの選択を解除し、Recorderを非昇格モードで実行して Java アプリケーションまたは SAP アプリケーションをキャプチャします。

マルチユーザー アクセスを必要とするアプリケーションの自動化

同じオートメーション ワークフロー内で、同じユーザー セッションで実行されていても、さまざまなアプリケーション レベルのアクセス権を必要とするブラウザ アプリケーションを正常に自動化できます。たとえば、管理者以外のユーザーはレコードの作成と検証を行うことができ、管理者ユーザーは同じプロセス オートメーション内で承認を行うことができるようになりました。
注:
  • この機能は、Google Chrome、Microsoft Edge、IE モード ブラウザの Microsoft Edge 上で動作する Web アプリケーションのオートメーションに対応しています。
  • この機能は、Recorder package (バージョン 3.2.1-20240606-105427 以降) および Bot Agent (バージョン 22.60.23 以降) でサポートされています。
  • 他のユーザー権限で開かれたブラウザ アプリケーションを自動化する場合は、昇格モードでオートメーションをキャプチャおよび実行するようにしてください。
  • Bot Agentが更新されたら、ブラウザ アプリケーションを再起動する必要があります。
  • 高度なタイムアウト オプションは現在、サポートされていません。

Java アプリケーションの自動化

Oracle EBS アプリケーションなど、Java アプリケーションで同様のプロパティを持つコントロールを自動化する場合、パスのプロパティが大きく変化するため、信頼性は高くなりません。このようなシナリオで信頼性の高いコントロールの自動化をするには、[出現] オブジェクト プロパティを使用します。

[出現] プロパティを使用すると、類似のプロパティを持つコントロールが検出され、上から下、左から右の形式で並べられ、出現値に基づいた特定のコントロールが検出されます。
注:
  • [出現] プロパティは、デフォルトの検索条件の一部ではありません。
  • [出現] プロパティは、キャプチャ時ではなく、実行時にのみ取得されます。
  • [出現] プロパティの最大値は、画面上に表示される類似のコントロールの数に依存します。たとえば、[説明] タイプのコントロールが画面上に 15 個表示されている場合、出現の最大値は 15 になります。画面上のコントロールをスクロールしても、出現の最大値は 15 のままです。
  • 出現値の範囲は 1 ～ 999 です。
[フレーム名] プロパティを使用すると、オブジェクトが存在する特定のフレームを見つけてコントロールを自動化することができます。これにより、オートメーションのパフォーマンスと信頼性が向上します。
注:
  • 内部フレーム内の特定のコントロールのフレーム名が空白の場合、キャプチャされたオブジェクトの フレーム名 プロパティは空白になり、デフォルトの検索条件として追加されません。
  • オブジェクトが内部フレーム内にない場合、プロパティはリストに表示されません。
  • [フレーム名] プロパティは、ワイルドカード文字と変数の両方をサポートしています。
  • ウィンドウによっては [フレーム名] が変わる場合があるため、内部フレーム オブジェクトを識別するためには、ワイルドカード (*) 文字を使うことをお勧めします。
注:
  • 既存のオートメーションに新しいプロパティを使用する場合は、コントロールを再キャプチャしてください。
  • この機能は既存の bots には影響しないため、変わらず実行が継続されます。

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

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

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

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

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

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

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

Recorder package の検索アルゴリズムにより、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 バージョンの Recorder package を使用して作成する Bot で利用可能です。以前のバージョンの Recorder package を使用して bots を作成した場合、この機能を使用するには、オブジェクトを再キャプチャする必要があります。

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

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

バックグラウンド処理

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

安全な記録

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

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

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

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

プロキシ サポート

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

レコーダーの事例

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