Chromium コネクタのメソッド
Chromium コネクタのメソッドは、アプリケーション、画面、および Google Chrome と Microsoft Edge ブラウザーの画面上の要素に対して異なるタスクを実行します。
Chromium コネクタのメソッドレベル
アプリケーションレベルのメソッド
ナビゲート
指定された URL に基づいて Web ページを起動します。
入力するには、「ポートのプロパティを設定する」を参照してください。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| URL | Web ページの URL。 | データ入力 | 文字列 | デフォルト値なし | いいえ |
| タイムアウト | 処理がタイムアウトするまでの時間を秒単位で指定するオプションです。 | データ入力 | 整数 | デフォルト値なし | いいえ |
| 戻る | True の場合、Web ページは起動しています。False の場合、Web ページは起動していません。 | データ出力 | ブール | 適用外 | 適用外 |
WaitForAnyScreen
指定された画面がロードされるまでの遅延時間を設定します。
画面を指定するには、次の手順を実行します。
- メソッド設定アイコン (
) をクリックします。
- [画面を選択 (CHOOSE SCREENS)] ウィンドウで、必要な画面を選択します。
- [OK] をクリックします。
フィールドに入力するには、「ポートのプロパティを設定する」を参照してください。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? | メモ |
|---|---|---|---|---|---|---|
| MatchAllChildren | True の場合、画面がロードされる前に、メソッドは Web ページからキャプチャされた要素を照合します。False の場合、メソッドはどの要素とも照合しません。 | データ入力 | ブール | デフォルト値なし | いいえ | 要素は、[Chromium コネクタ (Chromium Connector)] ウィンドウの [子要素を照合 (MATCH CHILDREN)] セクションにあります。 |
| タイムアウト | 処理がタイムアウトするまでの時間を秒単位で指定します。 | データ入力 | 整数 | デフォルト値なし | いいえ |
画面レベルのメソッド
クローズ
キャプチャされた画面ウィンドウを閉じます。
重点
キャプチャされたウィンドウにフォーカスを設定します。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| 戻る | True の場合、フォーカスはキャプチャされたウィンドウに設定されています。False の場合、フォーカスはキャプチャされたウィンドウに設定されていません。 | データ出力 | ブール | デフォルト値なし | 適用外 |
GetFields
指定されたフィールドまたは要素の値を返します。たとえば、ボタンのテキストを返すことができます。
フィールドを指定するには、次の手順を実行します。
- メソッド設定アイコン (
) をクリックします。
- [フォーム要素を選択 (CHOOSE FORM ELEMENTS)] ウィンドウで、必要なフィールドを選択します。
- [OK] をクリックします。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| フィールドまたは要素の名前 | メソッドが値を返すフィールドまたは要素です。 | データ出力 | 文字列 | デフォルト値なし | 適用外 |
GetInnerHtml
キャプチャされた画面の内部 HTML を返します。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| 戻る | キャプチャされた画面の内部 HTML を返します。 | データ出力 | オブジェクト | 適用外 | 適用外 |
GetPageSource
キャプチャされた画面のページソースを返します。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| 戻る | キャプチャされた画面のページソースを返します。 | データ出力 | 文字列 | 適用外 | 適用外 |
GetScreenShot
設定された画面のスクリーンショットを返します。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| 戻る | 設定された画面のスクリーンショットを返します。 | データ出力 | ビットマップ | デフォルト値なし | 適用外 |
GetTitle
キャプチャされた Web ページのタイトルを返します。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| 戻る | キャプチャされた Web ページのタイトルを返します。 | データ出力 | 文字列 | デフォルト値なし | 適用外 |
GetURL
キャプチャされた Web ページの URL を返します。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| 戻る | キャプチャされた Web ページの URL を返します。 | データ出力 | 文字列 | デフォルト値なし | 適用外 |
GetValueByXPath
指定された XML パスから、XML ノード内の値を返します。
フィールドに入力するには、「ポートのプロパティを設定する」を参照してください。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| XPath | キャプチャされた Web ページの XPath。 | データ入力 | 文字列 | デフォルト値なし | いいえ |
| 戻る | XML ノードから値を返します。 | データ出力 | 文字列 | 適用外 | 適用外 |
IsCreated
Web アプリケーション上で画面が正常にレンダリングされたかどうかを示すブール値を返します。
フィールドに入力するには、「ポートのプロパティを設定する」を参照してください。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルトタイプ | 必須? | メモ |
|---|---|---|---|---|---|---|
| MatchAllChildren | True の場合、画面がレンダリングされる前に、メソッドはキャプチャされたすべての要素との照合を試行します。False の場合、照合は行われません。 | データ入力 | ブール | デフォルト値なし | いいえ | キャプチャされた要素は、[Chromium コネクタ (Chromium Connector)] ウィンドウの [子要素を照合 (MATCH CHILDREN)] セクションにあります。 |
| 戻る | True の場合、画面は正常にレンダリングされました。False の場合、画面のレンダリングは失敗しました。 | データ出力 | ブーリアン | 適用外 | 適用外 |
要素レベルのメソッド
クリック
要素に対してクリック操作を実行します。
重点
要素にフォーカスを設定します。
フィールドに入力するには、「ポートのプロパティを設定する」を参照してください。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| scrollIntoView | True の場合、メソッドはスクロールバーを使用して、Web ページ上のキャプチャされた要素に移動します。False の場合、キャプチャされた要素にスクロールしません。 | データ入力 | ブール | デフォルト値なし | いいえ |
| 戻る | True の場合、メソッドは要素にフォーカスを設定します。False の場合、メソッドは要素へのフォーカスの設定に失敗しました。 | データ出力 | ブール | 適用外 | 適用外 |
GetInnerHTML
キャプチャされた要素の内部 HTML を返します。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| 戻る | キャプチャされた要素の内部 HTML を返します。 | データ出力 | 文字列 | デフォルトタイプなし | 適用外 |
GetInnerText
キャプチャされた要素の内部テキストを返します。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| 戻る | キャプチャされた要素の内部テキストを返します。 | データ出力 | 文字列 | 適用外 | 適用外 |
GetOuterHTML
キャプチャされた要素の HTML 要素とその属性、開始タグ、終了タグを返します。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| 戻る | キャプチャされた要素の外部 HTML を返します。 | データ出力 | 文字列 | デフォルト値なし | 適用外 |
GetOuterText
キャプチャされた要素のテキストコンテンツを返します。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| 戻る | キャプチャされた要素のテキストコンテンツを返します。 | データ出力 | 文字列 | デフォルト値なし | 適用外 |
IsCreated
キャプチャされた要素がロードされたかどうかを示すブールステータスを返します。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| 戻る | True の場合、キャプチャされた要素はロードされています。False の場合、キャプチャされた要素のロードに失敗しました。 | データ出力 | ブール | デフォルト値なし | 適用外 |
SetPassword
たとえば、ログインフォームのパスワードフィールドにパスワードを安全に入力するなど、Web ベースのアプリケーションのパスワードフィールドへのパスワードの安全な入力を自動化します。
フィールドに入力するには、「ポートのプロパティを設定する」を参照してください。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? | メモ |
|---|---|---|---|---|---|---|
| パスワード | パスワードをセキュリティで保護された文字列として受け入れます。 | データ入力 | セキュリティで保護された文字列 | なし | はい | パスワードはセキュリティで保護された文字列として受け入れられるため、パラメーターを右クリックして [データをプレビュー] をクリックしたときに文字列の長さのみが表示されます。 |
| UseSendKeys | SendKeys は、文字、数字、記号などのキーボード入力をアプリケーション内のテキストボックスに送信するために使用されるメソッドです。 | データ入力 | ブール | False | はい | ヒント: SetPassword メソッドで [パスワード] フィールドにパスワードを入力できなかった場合は、値を [True] に設定し、メソッドを再度実行します。 |
SendKeys
キャプチャされた要素にショートカットキーを渡します。
フィールドに入力するには、「ポートのプロパティを設定する」を参照してください。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| キー | ショートカットキーを取得します。 | データ入力 | 文字列 | デフォルト値なし | いいえ |
| ClearExistingValue | True の場合、メソッドはフィールド内の既存の値をすべてクリアします。False の場合、既存の値はクリアされません。 | データ入力 | ブール | デフォルト値なし | いいえ |
| TypeDelay | 各キー間の入力遅延を設定します。 | データ入力 | 倍精度 | デフォルト値なし | いいえ |
GetInstanceCount
要素が利用可能なインスタンスの数を返します。
GetOuterHTML
キャプチャされた要素の外部 HTML を取得します。
SendKeys
Web ページとウィンドウ上のキーストロークをシミュレートします。
SimulateMouseEvent
Web ベースのアプリケーションの要素に指定したマウスイベントをシミュレートします。たとえば、要素の右クリックをシミュレートします。
重要:
要素でマウスイベントをシミュレートするには、その特定のイベントが Web ページの HTML ですでに定義されている必要があります。たとえば、要素の
contextmenu イベントをシミュレートするには、要素に HTML で定義された contextmenu イベントが既に存在している必要があります。フィールドに入力するには、「ポートのプロパティを設定する」を参照してください。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? | メモ |
|---|---|---|---|---|---|---|
| MouseEvent | キャプチャされた Web ページの要素で発生するマウスイベント。Web ページの要素でマウスイベントが発生する時点で、その要素には既に HTML で定義されたマウスイベントが必要です。 | データ入力 | MouseEventType | click | はい | このメソッドは、これらのマウスイベントをサポートします。
|
| MouseButton | キャプチャされた Web ページの要素で、マウスボタンのクリックをシミュレートします。 | データ入力 | MouseButton タイプ | 左 | はい | このメソッドは、これらのマウスボタンアクションをサポートします。
|
SimulateEvent
Google Chrome ページまたはページ上の要素で、指定した HTML イベントをシミュレートします。
フィールドに入力するには、「ポートのプロパティを設定する」を参照してください。
| パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須? |
|---|---|---|---|---|---|
| EventName | HTML イベントの名前です。このメソッドは指定されたイベントをサポートしているため、指定されたとおりにイベントの名前を正確に入力する必要があります。 HTML イベント
|
データ入力 | 文字列 | なし | はい |