Web サイトへのアクセス

ブラウザインターフェイス

RPA の組み込み Chromium ブラウザは、次のプロトコルをサポートしています。

http:
about:
https:
file:

組み込みブラウザには、次のようなコントロールが用意されています。

ボタン	説明
	戻る: 1 ページ前に戻ります。
	進む: 1 ページ先に進みます。
	リロード: 現在のページをリロードします。ページの読み込み中、ボタンにはブラウザがビジー状態であることを示すクロスが表示されます。
	[URL] フィールド: 現在読み込まれているページの URL、またはそのページに移動する前に貼り付けた URL が表示されます。
	ナビゲート: URL フィールドに入力した URL に移動します。ボタンが見えない場合は、[レコーダービュー] ウィンドウを右にスクロールしてください。
	ページの保存ボタン: 現在開いているページを HTML 形式で保存します。ボタンが見えない場合は、[レコーダービュー] ウィンドウを右にスクロールしてください。詳細については、以下を参照してください。
	プロキシ設定: プロキシ設定ダイアログボックスを開きます。ボタンが見えない場合は、[レコーダービュー] ウィンドウを右にスクロールしてください。詳細については、以下を参照してください。
	PDF に印刷: 現在開いているページを PDF ファイルに保存します。ボタンが見えない場合は、[レコーダービュー] ウィンドウを右にスクロールしてください。詳細については、以下を参照してください。

組み込みブラウザ内の URL

ブラウザウィンドウでは、ツールバーに URL テキストフィールドが表示されます。これは、読み込まれた Web ページの URL を示します。URL を選択し、アクションステップを使用して変数に値を抽出することができます。ツリービューには URL も表示されます。

URL フィールドのテキストを選択するには、クリックステップを使用して URL フィールドをクリックします。
アドレスを変更するには、クリックステップを使用して URL フィールドをクリックし、テキストを入力ステップまたは変数を使用してアドレスを入力します。
入力した URL に移動するには、URL フィールドの右側にある [ナビゲート] ボタンをクリックします。

コマンドタイムアウト: Web サイトのブラウズのコマンドタイムアウトは、Design Studio でワークフローを実行するための Design Studio 設定ウィンドウにある [Desktop Automation] タブ、または RoboServer 実行のための [RoboServer 設定] アプリケーションの [セキュリティ] タブにある [オートメーションデバイス] セクションで設定します。詳細については、『Tungsten RPA 管理者ガイド』を参照してください。

システムのクリップボードからコピーして貼り付け: 現在のところ、組み込みブラウザを使用している場合は、1 つまたは複数のロボット内でシステムクリップボードを使用してコンテンツをコピーしたり、貼り付けたりすることはできません。コンテンツをコピーして貼り付ける代わりに、「値を抽出」ステップを使用することをお勧めします。

プロキシを構成する

デフォルトでは、Desktop Automation サービスのすべてのロボットは Tungsten RPA グローバルプロキシ設定を使用します。Desktop Automation サービスは、Design Studio および Management Console と同じプロキシ設定を使用します。プロキシサーバーのプロパティの詳細については、「Design Studio でのプロキシサーバーの設定」および「Management Console でのプロキシサーバーの設定」を参照してください。

Desktop Automation サービスの組み込みブラウザのローカルプロキシ設定は、Tungsten RPA グローバルプロキシ設定よりも優先順位が高いことに注意してください。タスクでローカルプロキシ設定を使用する必要がない場合、ロボットは Tungsten RPA グローバルプロキシ設定を使用することを確認してください。

ロボットで組み込みブラウザのプロキシ設定を変更するには、ブラウザのツールバーの [プロキシ設定] ボタンをクリックします。以下のプロキシオプションがあります。

[ダイレクト]: プロキシは使用されません。
[固定]: ホスト、ポート、迂回リストなどの固定プロキシ設定を指定します。
[PAC]: プロキシ自動設定スクリプトファイルの URL を指定します。
[自動]：Web プロキシ自動検出プロトコルなど、ネットワークで自動プロキシ設定が提供されている場合は、このオプションをクリックします。
システム: ロボットを実行しているコンピュータからプロキシ設定をコピーするには、このオプションを選択します。

プロキシ設定を完了した後に [OK] をクリックして設定を保存し、ダイアログボックスを閉じます。

プロキシの認証のネゴシエート: 認証のネゴシエートは、プロキシサーバーで使用することができます。プロキシサーバーがロボット用に設定されている場合、サーバーでネゴシエートプロトコルがサポートされていると、このプロトコルが自動的に使用されます。

PDF に印刷

ブラウザのツールバーの [PDF に印刷] ボタンを使用して、Web ページを PDF 形式で保存します。

[クリック] ステップを使用して [PDF に印刷] ボタンをクリックします。

ステップを実行すると、ブラウザで [ページを PDF ドキュメントとして保存] ダイアログまたは完成した PDF ドキュメントのダウンロードタブが開きます。この結果は、ブラウザステップの [ダウンロード先] モード設定と、使用している RPA のバージョンに応じて異なります。参照ステップの「ダウンロード先」オプションを参照してください。
テキストの置き換えステップを使用して、ファイル名を含むフルパスを指定し、[OK] をクリックします。

デフォルトでは、ファイルは現在のユーザーに構成された一時ファイルフォルダに保存されます。

必要に応じて、ダイアログボックスで [ロボットファイルシステム] を選択して、ファイルを RFS に保存します。[RFS ファイル名] フィールドに、設定したファイルシステムへのパスとファイル名を入力します (「myshare/downloaded.pdf」など)。ファイルシステム名は、Management Console 内の [ロボットファイルシステム] セクションでの指定に対応している必要があります。

Design Studio で、ロボットファイルシステムを使用するロボットを実行するには、ロボットを共有プロジェクトに配置します。
[保存] をクリックします。

ページの向き、用紙サイズ、縮尺などの PDF ファイルの設定を調整するには、ブラウザステップの [PDF 設定] プロパティでオプションを指定します。

プリンタ選択用のポップアップの処理に関する制限により、開いている HTML ページまたはドキュメントをハードウェアプリンタに直接送信することはできません。代わりに、システムでは自動的に [ページを PDF ドキュメントとして保存] ダイアログボックスが開きます。これにより、ドキュメントをファイルシステムまたは RFS に PDF 形式で保存して、後で使用することができます。

HTML でのページの保存

ブラウザツールバーの [ページの保存] ボタンを使用すると、現在開いているページを HTML 形式で保存できます。

クリックステップを使用して [ページの保存] ボタンをクリックします。
このステップを実行すると、ブラウザで [名前を付けて保存] ダイアログボックスが開きます。
「テキストの置き換え」ステップを使用して、ファイル名を含むフルパスを指定します。デフォルトでは、ファイルは現在のユーザーに構成された一時ファイルフォルダに保存されます。
[OK] をクリックします。
[保存] をクリックします。

アプリケーションアクション

アプリケーションレベルのアクションとはアプリケーション全体に適用されるアクションのことで、[レコーダービュー] のアプリケーションタブを右クリックして使用できます。Chromium 組み込みブラウザのアプリケーションレベルのアクションのリストには、次のアクションが含まれます。

アクション	説明
[アプリケーション名を設定]	ブラウザアプリケーションの name タグに値を追加します。アプリケーションを識別でき、堅牢で信頼性の高いファインダーの作成に役立つ名前を指定します。開かれたページにあるリンクを使用して新しいブラウザウィンドウに Web ページがロードされると、新しく開いたブラウザアプリケーションの name タグには、たとえば name="mainpage(2)" のように、親アプリケーションの名前と括弧で囲まれた数字が含まれます。エラーを回避するために、ロボット内のアプリケーションにはそれぞれ異なるアプリケーション名を割り当てます。
ウィンドウを閉じる	開いているアプリケーションウィンドウを閉じるステップを追加します。
ウィンドウを複製	アプリケーションタブを複製し、新しいタブで開くステップを追加します。アプリケーションの状態は保持されます。
JavaScript の実行	メインウィンドウコンテキストの現在のページで JavaScript を実行するステップを追加します。関連項目: JavaScript アプリケーションの実行アクション。 JavaScript: 実行するコードを入力します。 JS 実行結果: 結果を保存するバイナリ形式の変数を指定します。返された実行結果がテキストタイプでない場合は、自動的にテキストに変換されます。「未定義」はテキスト「undefined」に変換されます。「オブジェクト」はテキスト「object」に変換されます。「Null」はテキスト「null」に変換されます。「ブール値」は、「true」または「false」に変換されます。「数値」は、数値の文字列表現に変換されます。ロボットがより複雑なデータを返すようにする必要がある場合は、JavaScript コードでデータを JSON にシリアル化します。次に、parse() 関数を使用して、ロボットでデータを JSON 変数に逆シリアル化します。 [結果を待機] を選択すると、コードが実行され、結果が [「JS 実行結果」] 変数に書き込まれるまでロボットは待機します。デフォルトのタイムアウトは 30 秒です。この期間内にアクションが完了しない場合は、例外がスローされます。JavaScript コードにエラーが含まれる場合も、例外がスローされます。このオプションをオフにすると、ロボットはコードの実行が開始された直後に (実行の完了を待たずに) 次のステップに進みます。
ナビゲート:	指定した URL を開くステップを追加します。[URL] フィールドに URL を入力します。
再ロード	現在の Web ページを再ロードします。
戻る	1 ページ前に戻ります。ブラウザツールバーの [戻る] ボタンをクリックする操作と同様です。
進む	1 ページ先に進みます。ブラウザツールバーの [進む] ボタンをクリックする操作と同様です。
Cookie を設定	ブラウザに Cookie を追加するか、置き換えます。名前: Cookie の名前。値: Cookie の値。ホスト/ドメインCookie の範囲。これは、ドット (.) で始まるホスト名またはドメイン名のいずれかである必要があります。 [パス]: Cookie のパス。有効期限Cookie の有効期限。セッション Cookie を指定するには [セッション] を選択し、Cookie の有効期間 (秒単位) を指定するには [期間] を選択します。または、有効期限を ISO 8601 UTC 形式で指定するには [日付] を選択します (例: 2030-06-01T13:27:00.000Z)。 HTTP のみの Cookie を設定するには、[HttpOnly] を選択します。ブラウザ内のスクリプトはこのような Cookie にはアクセスできません。セキュアな Cookie を設定するには、[セキュア] を選択します。セキュアな Cookie は、HTTPS 接続経由でのみホストに送信できます。 Cookie 値内の無効な文字に対して URI エスケープを実行するには、[エスケープ文字] を選択します。 Cookie を設定すると、ブラウザは Cookie の有効期限を適用します。有効期限によって過去の Cookie が上書きされると、この Cookie は削除されます。 Chromium 組み込みブラウザは、Cookie を設定する前に検証を行います。ブラウザは、無効な文字を含む Cookie やセキュリティ制約に違反する Cookie を拒否します。その結果、ロボットステップでエラーが発生します。現在の Chromium バージョンでは、Cookie の有効期間が 400 日に制限されており、この制限を適用するために有効期限が自動的に調整されます。 [期間] オプションで受け入れられる値の範囲はそれに応じて制限されます。 Cookie の管理の詳細については、「Chromium 組み込みブラウザでの Cookie の管理」を参照してください。
Cookie を取得	ブラウザから Cookie 値を取得し、テキスト変数に保存します。 [URL]: Cookie の範囲。このドメインに一致するホストとドメインの Cookie のみが返されます。名前: 必要な Cookie の名前。 [エスケープ文字解除] を選択すると、返される Cookie 値内の URI エスケープ文字 (%XX) がデコードされます。ブラウザでCookieが見つからない場合に返される値を設定するには、[デフォルト値] を指定します。デフォルト値が設定されていない場合、ロボットは空の値を返します。結果: 値を保存するテキスト形式の変数を指定します。
Cookie を削除	選択した Cookie を削除します。 [URL]: Cookie の範囲。名前: Cookie の名前。必要なスコープ内で表示されるすべてのホスト Cookie を削除するには、[URL] のみを指定します。 [URL] および [名前] を指定すると、スコープ内の指定された名前を持つすべてのドメイン Cookie が削除されます。
すべての Cookie を消去	ブラウザからすべての Cookie を削除します。
Cookie をエクスポート	ブラウザから Cookie をエクスポートし、テキスト変数で返します。 [URL] を選択して入力すると、この URL の範囲内でアクセス可能な Cookie のみをエクスポートします。エクスポートにセッション Cookie (有効期限のない Cookie) を含めるには、[セッション Cookie] を選択します。 Cookie: Cookie を保存するテキスト形式の変数を指定します。結果を外部に保存し、別のロボットと [Cookie をインポート] アプリケーションアクションを使用してインポートできます。
Cookie をインポート	[Cookie をエクスポート] アプリケーションアクションによって以前に保存された Cookie をインポートします。このステップは、Tungsten RPA の以前のバージョンで保存された Cookie を受け入れます。 Cookie: インポートする Cookie。ブラウザはインポートされた Cookie の有効期限を適用します。
Web ストレージ	ブラウザに読み込まれるドメインの Web ストレージキーまたは値のペアを操作します。 Web ストレージは永続的ではありません。ロボットが終了するとキーはすべて破棄されます。ブラウザセッションにロードされる Web ストレージ領域と、これらの領域の内容を表示するには、開発者ツールを使用します。このアクションは、アプリケーションアクションおよびコンポーネントアクションとして使用できます。アプリケーションアクションとして使用するには、次の手順を実行します。 [ストレージ] オプションの [ローカルストレージ] または [セッションストレージ] を選択します。どのドメインの Web ストレージを操作するかを設定するには、[Web ストレージドメイン] を選択します。メインサイトのドメインとして [元] を選択します。ドメインの完全なホスト URL を入力するには、[特定] を選択します。ブラウザ内のフレーム内でドメインが読み込まれていない場合は例外が発生します。 [操作] オプションからいずれかのオプションを選択します。クリア: Web ストレージ領域からすべてのキーを削除します。削除: Web ストレージ領域から、指定したキーを削除します。キーの設定: Web ストレージ領域で、指定した値を持つキーを作成するか変更します。[キー] を入力するか、ボックスを空欄のままにしてください。空欄のままにした場合は、キーに空の値が割り当てられます。値を取得: Web ストレージ領域からキーの値を取得し、結果の変数に保存します。キーが Web ストレージ領域に存在しない場合は、デフォルト値が返されます。キーの一覧表示: Web ストレージ領域のすべてのキーのリストを取得し、そのリストを JSON 配列として結果の変数に保存します。ドメインの一覧表示: ブラウザ内のすべての Web ストレージコンテナのリストを取得し、そのリストを JSON 配列として結果の変数に保存します。結果: 結果の変数が発生する [操作] オプションの場合、結果はテキスト変数として保存されます。結果のない操作では自動的に結果の変数がクリアされます。結果の変数がテキスト変数であるため、parse(text) 関数を使用して [キーの一覧表示] および [ドメインの一覧表示] の結果をループ可能な適切な JSON 配列に変換することができます。

コンポーネントアクション

コンポーネントアクションとは選ばれたコンポーネントまたは要素に適用され、[レコーダービュー] またはツリービューで要素を右クリックすることで使用できます。Chromium 組み込みブラウザのコンポーネントレベルのアクションのリストには、次のアクションが含まれます。

RPA は CEF ブラウザを自動的に検出し、適切なツリーモードに切り替えますが、右クリックして [ツリーモード] > [ISA] を選択すると、アプリケーション全体および特定の要素のツリーモードを ISA に変更できます。詳細については、ツリーモードを参照してください。

アクション	説明
リンクを新しいウィンドウで開く	Web ページのリンクに適用されます。選択したリンクを [レコーダービュー] の新しいタブで開くステップを追加します。
ターゲット抽出	データ URL 値を持つ href 属性を使用したアンカー HTML 要素に適用できます。これにより、ユーザーはデータ URL 値をバイナリ変数に抽出できます。値は、必要に応じて base64 形式からバイナリにデコードされます。バイナリ変数の利用可能なタイプには、バイナリ、画像と PDF が含まれます。[状態] ペインで画像をプレビューできること、およびターゲット抽出ステップで保存した変数から [レコーダービュー] で PDF を使用して PDF を開くことができることを除き、これらはすべて同等です。
JavaScript の実行	メインウィンドウコンテキストの現在のページで JavaScript を実行するステップを追加します。関連項目: JavaScript アプリケーションの実行アクション。 JavaScript: 実行するコードを入力します。 JS 実行結果: 結果を保存するバイナリ形式の変数を指定します。返された実行結果がテキストタイプでない場合は、自動的にテキストに変換されます。「未定義」はテキスト「undefined」に変換されます。「オブジェクト」はテキスト「object」に変換されます。「Null」はテキスト「null」に変換されます。「ブール値」は、「true」または「false」に変換されます。「数値」は、数値の文字列表現に変換されます。ロボットがより複雑なデータを返すようにする必要がある場合は、JavaScript コードでデータを JSON にシリアル化します。次に、parse() 関数を使用して、ロボットでデータを JSON 変数に逆シリアル化します。 [結果を待機] を選択すると、コードが実行され、結果が [「JS 実行結果」] 変数に書き込まれるまでロボットは待機します。デフォルトのタイムアウトは 30 秒です。この期間内にアクションが完了しない場合は、例外がスローされます。JavaScript コードにエラーが含まれる場合も、例外がスローされます。このオプションをオフにすると、ロボットはコードの実行が開始された直後に (実行の完了を待たずに) 次のステップに進みます。
Web ストレージ	ブラウザに読み込まれるドメインの Web ストレージキーまたは値のペアを操作します。 Web ストレージは永続的ではありません。ロボットが終了するとキーはすべて破棄されます。ブラウザセッションにロードされる Web ストレージ領域と、これらの領域の内容を表示するには、開発者ツールを使用します。このアクションは、アプリケーションアクションおよびコンポーネントアクションとして使用できます。アプリケーションアクションとして、コンポーネントアクションには適用されない追加のオプションを使用できます。コンポーネントアクションとして使用するには、次の手順を実行します。 [ストレージ] オプションの [ローカルストレージ] または [セッションストレージ] を選択します。コンポーネントアクションを使用すると、そのコンポーネントを含むフレームのドメインが自動的に設定されます。 [操作] オプションからいずれかのオプションを選択します。クリア: Web ストレージ領域からすべてのキーを削除します。削除: Web ストレージ領域から、指定したキーを削除します。キーの設定: Web ストレージ領域で、指定した値を持つキーを作成するか変更します。[キー] を入力するか、ボックスを空欄のままにしてください。空欄のままにした場合は、キーに空の値が割り当てられます。値を取得: Web ストレージ領域からキーの値を取得し、結果の変数に保存します。キーが Web ストレージ領域に存在しない場合は、デフォルト値が返されます。キーの一覧表示: Web ストレージ領域のすべてのキーのリストを取得し、そのリストを JSON 配列として結果の変数に保存します。結果: 結果の変数が発生する [操作] オプションの場合、結果はテキスト変数として保存されます。結果のない操作では自動的に結果の変数がクリアされます。結果の変数がテキスト変数であるため、parse(text) 関数を使用して [キーの一覧表示] および [ドメインの一覧表示] の結果をループ可能な適切な JSON 配列に変換することができます。
指定タグまでスクロール	選択した要素にページをスクロールするステップを追加して、ウィンドウの中央に要素が表示されるようにします。
オプション選択	Desktop Automation ロボットに、メニューから単一のオプションまたは複数のオプションを選択できるステップを追加します。アイテムのリスト、アイテムのグループ、またはドロップダウンリストから単一のオプションを選択します。折りたたまれた状態のドロップダウンリストからオプションを選択するには、レコーダービューのメニューをクリックし、ツリービューで必要なオプションを選択します。アイテムのリストまたはアイテムのグループから複数のオプションを選択します。これは、Ctrl キーを押しながらクリックする場合と同様の操作です。リストまたはグループからすでに 1 つのオプションを選択している場合は、このリストまたはグループの別のアイテムに [オプション選択] ステップを追加し、このステップのプロパティで [複数選択] をオンにします。ステップを実行すると、選択された状態で両方のオプションが表示されます。さらにオプションを選択するには、選択する追加オプションごとに同じ手順を実行します。複数選択を解除するには、ステップのプロパティの [複数選択] をオフにします。このステップでは、選択されたオプションが処理され、選択された他のすべてのオプションはオフになります。
ドロップダウンで選択	Desktop Automation ロボットに、メニューまたは実行時の変数からオプションを選択するステップを追加します。 [ドロップダウンで選択] ステップと [オプション選択] ステップを組み合わせてメニューを操作することができます。これらのステップの違いは、メニューからのオプションの選択方法のみです。アイテムのリスト、アイテムのグループ、またはドロップダウンリストから単一のオプションを選択します。アイテムのリストまたはアイテムのグループから複数のオプションを選択します。これは、Ctrl キーを押しながらクリックする場合と同様の操作です。すでに 1 つ以上のオプションを選択している場合は、別のアイテムに [ドロップダウンで選択] ステップを追加し、このステップのプロパティで [複数選択] をオンにします。ステップを実行すると、選択された状態で両方のオプションが表示されます。さらにオプションを選択するには、選択する追加オプションごとに同じ手順を実行します。複数選択を解除するには、ステップのプロパティの [複数選択] をオフにします。このステップでは、選択されたオプションが処理され、選択された他のすべてのオプションはオフになります。大文字と小文字を区別しない照合を実行するには、ステップのプロパティで [大文字と小文字を区別] をオフにします。ロボットは以下の順序で利用可能なオプションを照合します。一致する値属性を持つ最初のオプション。空白をトリミングした後に一致する値属性を持つ最初のオプション。空白をトリミングした後に、メニューに表示されているものと一致するテキスト値を持つ最初のオプション。メニューに一致する値がない場合はエラーが表示されます。
ファイルとしてアップロード	ファイル選択ダイアログを使用せずに Web フォームにファイルをアップロードしたり、バイナリ変数の内容を直接アップロードしたりできるステップを追加します。このステップは、ローカルファイルシステムまたはロボットファイルシステム (RFS) からファイルをアップロードします。 Design Studio で、ロボットファイルシステムを使用するロボットを実行するには、ロボットを共有プロジェクトに配置します。このステップを、「file」タイプ属性設定を持つ Input HTML 要素に適用します。このステップは、入力要素のクリックをシミュレートし、アップロード用に選択したファイルを提供します。これにより、フォームはアップロードを正常に処理できるようになります。バイナリ変数がアップロードされる場合、ステップはフォームで使用されるファイル名を指定します。
フォームフィールドの入力	Desktop Automation ロボットに、HTML フォームの入力要素を操作するステップを追加します。このステップを使用して、カラーピッカーやボリュームスライダーといったインタラクティブな操作が必要なグラフィック要素を制御することができます。設計時にデータリストが要素に関連付けられている場合は、そのデータリストの値がリストに表示されます。これらの要素は、[ドロップダウンで選択] アクションのように入力を制限することなく自動的に補完されます。ファイルアップロードなどの一部の要素はこのアクションではサポートされないことに注意してください。

デベロッパーツールによるデバッグ

Tungsten RPA は、デベロッパーツールを使用した Chromium ブラウザエンジンでのデバッグをサポートします。これにより、Web サイトとブラウザ間のデータのやり取りや、Web コンテンツの処理中に発生するエラーを分析するために必要な情報を抽出して保存することができます。情報は HTTP アーカイブ (HAR) 形式で保存されます。関連項目: デベロッパーツールを起動。

ログをファイルに保存するには、次の手順を実行します。

参照ステップを使用してブラウザを開きます。
ブラウザタブを右クリックし、コンテキストメニューで [デベロッパーツールを起動] を選択します。
[Chrome DevTools] ウィンドウで、[ネットワーク] タブを選択し、[ログを保存] を選択して、Ctrl+R を押します。

ネットワークトレースがウィンドウに読み込まれます。
トレースを右クリックし、[コンテンツ付きの HAR としてすべて保存] を選択して、ネットワークトレースをファイルに保存します。

HTTP アーカイブインスペクターでこのファイルを開くことができるようになります。

Web サイトへのアクセス

ブラウザ インターフェイス