3.5.4.9. OpenRPA.NM

OpenRPA.NMのツールボックスにあるアクティビティを紹介します。

タブを閉じる

OpenRPAが現在サポートしている3つのブラウザのうち、現在開いているタブまたはすべてのタブを閉じることができるActivityです。Chrome、Firefox、Edgeの3つのブラウザに対応しています。

ユーザーは、Browserパラメータで希望のブラウザを設定する必要があります。これは、"chrome"、 "ff"、"edge "のいずれかです。それぞれ、上記の各ブラウザに対応します。

もし、ユーザーがすべてのタブを閉じたい場合は、CloseAllパラメータをTrueに設定する必要があります。

プロパティパラメータ

Browser– OpenRPAがタブを閉じるためのブラウザ。このパラメータには、"chrome"、 "ff"、"edge“を設定できます。

CloseAll–Trueに設定すると、OpenRPAは、ブラウザ内で現在開いているすべてのタブを閉じます。

Displayname– シーケンス内のアクティビティのタイトルです。

images/openrpa_close_tab.png
スクリプトの実行

このActivityは、現在OpenRPAがサポートしている3つのブラウザの中で、ユーザーがJavaScriptスクリプトを実行することを可能にします。Chrome、Firefox、Edgeの3つのブラウザの中でJavaScriptスクリプトを実行し、最後に評価された式の値を返します。ブラウザがすでに開いている必要があり、そうでない場合はSystem.NullReferenceExceptionが返されることをユーザーに思い出させるのに役立ちます。

実行するスクリプトは、「Open Editor」をクリックしてコード エディター内に貼り付けるか、タイプすることで挿入することができます。

また、Browserパラメータに、スクリプトを実行するブラウザを設定する必要があります。これは、"chrome"、 "ff"、"edge "のいずれかです。それぞれ、上記の各ブラウザに対応する。

最後に評価された式の値をオブジェクトとして返すには、Resultパラメータに変数名を入力し、Ctrl+Kキーを押して作成する必要があります。

また、ユーザーはスクリプトが注入される ``Frame`` に 対応するFrameId`´を設定することができます。これについての詳細は、Window.frames(https://developer.mozilla.org/en-US/docs/Web/API/Window/frames) をご覧ください。

プロパティパラメータ

Browser– OpenRPAがスクリプトを実行するブラウザー。このパラメータには、"chrome"、 "ff"、"edge“のいずれかを設定します。

DisplayName– シーケンス内のアクティビティのタイトル。

FrameId– スクリプトが注入されるフレームのIDです。Int32 型である必要があります。

Result– 最後に評価された式の結果が保存される変数．

Script– 実行されるスクリプトです。

images/openrpa_execute_script.png
エレメントを取得

このアクティビティは、OpenRPA.Get Elementと似ています。NMセレクタでフィルタリングされた要素（または要素）を選択します。

ハイライト」をクリックすると、セレクタの条件に一致する最初の「要素」が赤くハイライトされます。セレクタが正しく設定されているかどうかを確認するのに便利です。

プロパティパラメータ

Displayname– シーケンス内のアクティビティのタイトルです。

要素– 選択されたNM要素。

From– NMElementのインスタンスの中で見つかった要素内のみを検索することができます。

MaxResults– 検出される要素の最大値。

MinResults– 最小結果の数。この値が0より大きく、このアクティビティが要素を見つけられなかった場合、例外(ElementNotFound)がスローされます。要素が存在するかどうかを確認したい場合は、この値を0に設定し、シーケンス内で ‘item.Length() == 0’ をテストしてください。

セレクタ– NMアプリケーションを識別するためのすべてのデータが含まれています。

Timeout– 要素の検索に成功しなかった場合、アクティビティが停止するまでの時間。

Wait for ready– “True “に設定すると、ページが完全に読み込まれるまで待ちます。

備考

ユーザーは、XPath セレクタを使って、ページ内の要素を選択することもできます。XPath セレクタは以下のような構文で使用します。

    • 任意の要素ノードにマッチする

  • * – 任意の属性ノードにマッチします．

  • node() – あらゆる種類のノードにマッチします。

例えば、bookstoreノードのすべての子要素ノードを選択したい場合は、/bookstore/*を使用します。文書内のすべての要素を選択するには、//* を使用します。ここで、何らかの属性を少なくとも 1 つ持つtitle要素をすべて選択したい場合は、//title[@*] を使用します。XPath 式を連結する場合は、｜ 演算子を使用します。つまり、すべての book 要素のtitle および price要素をすべて選択する場合は、//book/title | //book/price.¹ という式を使用します。

¹ – `XPath Syntax <https://www.w3schools.com/xml/xpath_syntax.asp>`_ (“https://www.w3schools.com/xml/xpath_syntax.asp“).

備考

XPathセレクタの他に、CSSセレクタも使用することができます。CSSセレクタは、以下の構文を使用します。

  • .{CLASS}– そのクラスを持つすべての要素にマッチします。

  • #{CLASS}– そのidを持つすべての要素にマッチします。

  • ** ** – すべての要素にマッチします。

  • {ELEMENT}– すべての<p>要素にマッチします。

構文はXPath セレクタとほぼ同じです。CSS セレクタについては、CSS セレクタ(https://www.w3schools.com/cssref/css_Selectors.asp)を参照してください。

images/openrpa_ie_get_element.png

OpenRPA.NM ゲットエレメント。

URLを開く

現在OpenRPAがサポートしている3つのブラウザのうち、いずれかのブラウザ内でURLを開きます。Chrome、Firefox、Edgeのいずれかです。URLが設定されていない場合は、自動的に新しいブラウザのインスタンスが起動します。

ユーザーは、URLを開くために必要なブラウザをBrowserパラメータに設定する必要があります。これは、"chrome"、 "ff "または"edge "です。それぞれ、上記の各ブラウザに対応します。

また、NewTabパラメータをTrueまたはFalseに設定することで、新しいタブの中に開くか、現在開いているタブの中に開くかをユーザーが設定する必要があります。

プロパティ パラメータ

Browser– OpenRPAがスクリプトを実行するブラウザー。このパラメータには、"chrome"、 "ff"、"edge“のいずれかを設定します。

DisplayName– シーケンス内のアクティビティーのタイトル。

NewTab–Trueに設定すると、ブラウザの新しいタブ内にURLを開きます。一方、Falseに設定すると、現在開いているタブの中にURLが開かれます。

Url– ブラウザ内で開かれるURLです。

images/openrpa_open_url.png

OpenRPA.NM オープンURL.。