ユニバーサルレコーダーを使用して記録したタスクの編集

タスクを記録した後で、[キャプチャ] アクションを編集して、ウィンドウの変更、別のオブジェクトのキャプチャ、新しいアクションの選択、バックグラウンド処理の有効化、異なる待機時間の入力、変数への出力の保存などを行います。

前提条件

[リスト] ビューを選択して、各アクションの詳細を表示します。

以下の操作を行うには、記録されたタスクを編集します。

操作を行うアプリケーションウィンドウを変更するか、ウィンドウタイトルにワイルドカードを追加する。
キャプチャしたオブジェクトのプロパティを変更する。
キャプチャしたオブジェクトで実行するアクションを指定する。
遅延を適用してから、次のアクションを実行する。
出力を格納するために使用する変数を指定する。

タスクに [キャプチャ] アクションを追加するには、「[キャプチャ] アクションの使用」を参照してください。

手順

記録されたタスクを編集するには、次の手順を実行します。

編集対象の記録されたアクションを含む Bot を開きます。
編集する [キャプチャ] アクションをクリックします。

必要に応じて、次の変更を行います。

ウィンドウの選択を [現在有効] ウィンドウオプションに変更します。
オプション: [ウィンドウタイトル] フィールドでワイルドカード文字 (*) を挿入することで、さまざまなウィンドウタイトルを検索できます。値の先頭、中間、末尾に 1 つ以上のワイルドカード文字 (*) を指定することができます。
たとえば、タイトルに Microsoft を含むウィンドウで操作を実行するには、値の前または後にワイルドカード文字を追加して、次のように任意の文字列を示すことができます。*Microsoft*。Bot は、まず、完全に一致するウィンドウタイトル (この場合であれば、Microsoft) を検索し、条件に一致する文字が見つからない場合は、タイトルに Microsoft を含むウィンドウを検索します。
正規表現 (regex) を使用して、ウィンドウタイトルを識別できます。各正規表現条件の [文字列] または [パターン] として正規表現を選択し、値を入力します。デフォルトでは、[ウィンドウタイトル] フィールドで大文字と小文字が区別されます。[大文字と小文字を区別しない] 正規表現フラグを有効にして、大文字と小文字を区別しないウィンドウタイトルを識別できます。

静的なウィンドウやブラウザのタイトルと、ワイルドカード文字を含むタイトルを識別するには、[大文字と小文字が区別される] オプションを有効にします (大文字小文字を一致させる場合)。大文字と小文字が一致しないウィンドウタイトルを識別するオプションを無効にします。
注: システムにインストールされている Bot エージェントは、Automation 360 v.26でリリースされたバージョンが最小であることを確認してください。Automation 360 V.25 以前でリリースされた Bot エージェントバージョンを使用している場合、ウィンドウタイトルはデフォルトで大文字小文字を区別して識別されます。
たとえば、((\w*)-Notepad で始まるすべてのウィンドウタイトル名には ((\w*)-Notepad として [文字列] 値を入力できます。または、((\w)\s)*document-Notepad といった [パターン] を使用すると、このパターンに一致するウィンドウタイトルのみに絞り込むことができます。
注:
- 任意のアクションでウィンドウタイトルの入力値として「-title」を含む文字列型の正規表現を使用する場合、Bot にランタイムエラーが発生する可能性があります。「*-title」として文字列入力を追加する場合、特定のタイトルのアプリケーションが開くことを確認します。「*」は単なる文字を示しており、ワイルドカード文字ではありません。
- 任意のアクションでウィンドウタイトルの入力値として「-title」を含むパターン型の正規表現を使用する場合、入力値「*-title」が正しくないため、Bot にランタイムエラーが発生する可能性があります。
  有効な正規表現パターンを使用していることを確認してください。
注: 実行中に、タスク Bot が正しいウィンドウを特定することを確認します。特定していない場合は、次の操作を実行します。
1. アプリケーションまたはブラウザウィンドウを開きます。
2. [ウィンドウ] > [アクティブなウィンドウタイトルを取得] アクションを [レコーダー] > [キャプチャ] アクションの上にドラッグします。
3. 文字列変数を [ウィンドウタイトルを変数に代入] フィールドに挿入します。
4. [ウィンドウ] > [タイトルを設定] アクションを [ウィンドウ] > [アクティブなウィンドウタイトルを取得] アクションの下にドラッグします。
5. [ウィンドウ] フィールドに、[レコーダー] > [キャプチャ] アクションによって生成されたウィンドウ変数を挿入します。
6. [新しいウィンドウタイトル] フィールドで、[アクティブなウィンドウタイトルを取得] アクションから文字列変数を挿入します。
7. [保存] をクリックします。
オプション: [ウィンドウのサイズ変更] オプションを選択して、ウィンドウの寸法を指定します。
このオプションによって、より信頼性の高い Bot を実現できます。タスク記録時に合わせてウィンドウのサイズを変更し、Bot がターゲットオブジェクトを特定できるようにします。
- タスク記録時にウィンドウが最大化されている場合、このオプションは選択されていません。
- タスクを記録するときにウィンドウが最大サイズでない場合は、このオプションがデフォルトで選択され、幅と高さのフィールドにはウィンドウの寸法が自動的に入力されます。
注: このオプションは、サイズ変更が可能なウィンドウでのみ使用できます。これは [デスクトップ] または [タスクバー] オプションでは使用できません。

[オブジェクトのプロパティ] テーブルを確認します。

以下は、テクノロジータイプに応じてデフォルトで選択されるオブジェクトのプロパティの一覧です。

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


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

Bot は、選択したプロパティを使用して、実行時にオブジェクトコントロールを特定します。

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

[コントロールタイプ] が意図したオブジェクトに一致しない場合は、オブジェクトコントロールを再度キャプチャします。
オブジェクト検索に含めるオブジェクトのプロパティを選択して、値を割り当てます。
Bot の信頼性を高めるために、静的値を持つプロパティ ([名前]、[クラス]、[タイプ]、[HTML ID]、[DOMXPATH] など) のみを選択し、動的な値を持つプロパティ ([HTML Href]、[パス]、[値]) の選択を解除することをお勧めします。動的な値は変更される可能性があり、Bot エラーの原因となります。
プロパティが動的で頻繁に変更されるオブジェクトを検索するには、オブジェクトのプロパティ値にワイルドカード文字 (*) または変数を使用することをお勧めします。

ドロップダウンリストから [アクション] を選択します。
オブジェクトで実行できるアクションの完全なリストについては、「ユニバーサルレコーダーでキャプチャされたオブジェクトに対して実行されるアクション」を参照してください。
- 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 Credential 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.
  We recommend setting a delay time when using the Set text action to enter keystrokes into a text field.
- 選択した [アクション] がバックグラウンド処理をサポートしている場合、[バックグラウンドで実行] オプションが表示されます。バックグラウンド処理
オプション: [コントロールを待機] フィールドに値を入力して、オブジェクトコントロールがアプリケーションウィンドウに表示されるまで Bot が待機する時間 (秒) を指定します。
オプション: 出力を変数に代入します。
Control Room は、ステップ 8 で選択したアクションに基づいて、分かりやすいデフォルト変数名を提案します。たとえば、[プロパティを取得] を選択した場合、出力変数の候補は PropertyValue です。複数の出力変数を作成すると、重複を避けるために、後続の変数名に -1 が追加されます。
Bot で編集するその他のアクションに対してステップ 3 ～ 9 を実行します。
[保存] をクリックします。

Link an object to a supporting anchor

注: You can use object anchoring in Microsoft Active Accessibility, Microsoft UI Automation, or Java applications.

At runtime, if the Bot cannot reliably identify an object, link it to a nearby object (such as a link or button) that is easier for the Bot to find:

Open the Capture アクション.
Click the Anchor tab.
Click Capture anchor.
The browser or application window activates with the main object highlighted (the object that you previously captured). A dialog box appears, verifying whether the action has correctly identified the main object.
If the correct object is highlighted, click Yes, Select anchor.
Otherwise, click No, I need to correct it to select the correct object.
Select a nearby object to the target object that is easier for the Bot to find.
The object is highlighted with an anchor icon on the right of the object.
Click Save.

Automation 360