OpenIAPカテゴリー: 3. OpenRPA

シーケンス内に含まれるオブジェクトの到達点を指します。プログラミングとスコープについてある程度知識がある方は、この部分は飛ばしていただいて構いません。 まず、集合について考えてみましょう。この例では、引数はグローバルにスコープされているかのように機能するので、変数を使うことにする。

下のコードブロックでは、シーケンスB は変数 x, – にしかアクセスできませんが、BはA のスコープ内にあるため、シーケンスBはすべての変数 {n, p, x, y} にアクセスできるようになります。簡単に言えば、シーケンスを使って変数のスコープを整理し、アクティビティをグループ化することができます。これは、開発者がプログラミング言語で関数を使用して一枚岩のコードを回避するのと同じです。

Sequence A {	variables = n, p	Sequence B {		variables = x, y	}}	

引数は、他のシーケンスや外部サービス、ワークフローに渡すことができる単なる変数であり、グローバルなスコープを持つ。この特徴を除けば、変数と全く同じ働きをします。他のシーケンス内に作成されたシーケンスに引数を渡した場合、その引数は外側のシーケンス内でも有効です。変数を渡した場合、そのようなことは起こりません。

変数も引数もデフォルト値を持つことができ、シーケンスの実行中に必ずしも値が代入されない場合は、両方に代入されることに注目することが重要です。また、isRequiredプロパティがチェックされている引数は、’In’値、つまり既に渡されたか、デフォルト値を持つことが必須となります。

OpenRPAの引数は、変数と同様に静的型付けされており、その型は引数ボックス内の変数型フィールドから選択することができます。

出力（In – In/Out – Out）出力とは、実行時に変数や引数を処理する方法のことである。以下に分類される。

• で

  この場合、引数は外部サービスから受け取り、ワークフロー実行後には返せない入力値のみが与えられる

• イン/アウト

  この場合、引数には入力値を与えることも、ワークフロー実行後に変更し出力することも可能である

• アウト

  この場合、引数は外部サービスに対する値を返すので、ワークフロー実行後に変更することはできない

• 物件紹介

  これは、引数をPropertyに変えるもので、In/Out引数と同じ機能を持ち、さらにデフォルト値を持つことができる。

Importsタブには、選択したシーケンスで使用・参照されるすべてのモジュールが表示されます。

OpenRPAのベースとなっているMicrosoft Workflow Fundation（MWF）では、変数や引数を2つの異なるカテゴリに分類しています。大半のワークフローでは、この違いを理解する必要はなく、何も影響を与えませんが、非シリアル化オブジェクトの技術的な制限を知ることで、ワークフローやプロセスが期待通りに動作しない理由を説明できる場合があります。

要するに、非シリアライズ可能なオブジェクトは、その名が示すように、シリアライズすることができないのです。この用語は、この文脈では、「これらのオブジェクトは保存できない/ネットワーク上で送信できない」と簡略化することができる。つまり、ワークフローにシリアライズ不可能な変数/引数が含まれる場合、ワークフローの状態を保存することができません。また、シリアライズ不可能な引数を持つワークフローの起動もサポートされていません。最も一般的なシリアライズ不可能な変数/引数のタイプは次のとおりです。DataTablesとDataSetsですが、その他の型（すべての名前空間から無限に存在する型）もこのカテゴリに属します。

この簡単な説明のもと、シリアライズ不可能な変数や引数を含むワークフローを扱う際にユーザーが直面する可能性のある制限と、その回避策をいくつか紹介します。

• ワークフローの状態の保存

  OpenRPAが OpenFlowに接続されている場合、特定のアクティビティ¹に到達するたびに、ワークフローの状態がOpenFlowに自動的に保存されます。これらの状態は、実行中のデザイナーレイアウト（アクティビティ、シーケンス）、変数や引数、およびそれらの現在値など、ワークフローインスタンスに関連する現在の状況を示すために存在します。したがって、ワークフローがDataTableのようなシリアライズ不可能なオブジェクトを含む場合、ステートを保存することはできない。

  アイドル状態になるすべてのアクティビティ（Detectors、Delay、Invoke Remote with wait）、およびPersistアクティビティです。

  回避策複雑なワークフローをより小さなワークフローに分割し、シリアライズできないオブジェクトの管理を小さなワークフローに任せます。そうすることで、予期せぬ中断が発生しても、すべてのデータを失うことはありません。

• リモート OpenRPA / シリアル化できない引数での起動

• Openflowの起動 / Node-REDの起動とデータリターン

  Invoke Remote OpenRPAActivityを使用する場合、呼び出されるワークフローがシリアライズ不可能な引数を使用する可能性があることに注意してください。呼び出し先のコンピューター/OpenRPAが呼び出し元のOpenRPAと異なるため、シリアライズ不可能な引数を渡すことができず、呼び出しに失敗します。

  同様の制限は、ユーザーがNode-REDで Invoke Openflowアクティビティを使用してフローを呼び出す場合にも発生し、シリアライズできないオブジェクトは引数として使用することがサポートされません。このルールの例外はDataTableタイプで、OpenRPAは Node-REDに問い合わせる前にこれらをきちんとJArray オブジェクトに変換し、データが返されたとき/ ノードワークフローが使われたときにDataTableに戻そうと試みます。

  回避策OpenRPA.OpenFlowDBツールボックスのアクティビティを使用して、OpenFlowMongoDBにファイルをアップロード/データを更新/エンティティやコレクションを作成し、デスティネーションコンピュータでOpenFlowMongoDBにクエリを実行してデータにアクセスします。この方法では、データ/データセット/データテーブル(シリアライズできないオブジェクト) 全体が MongoDB に格納され、呼び出し時に渡されるパラメーターは_idやその他の識別子になります。

  回避策2：シリアライズできないオブジェクトをシリアライズ可能なオブジェクトに変換します（例：base64文字列）。

以下に、OpenRPAツールボックス内のアクティビティを紹介します。

クリックエレメント

GetElementで見つかったElementをクリックします。

プロパティパラメータ

Animate Mouse–Trueに設定すると、カーソルは実行中にその位置を変えて表示されます。物理的なクリックの時のみ動作します

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

ダブル クリック–Trueに設定すると、カーソルがウィンドウ内で2回クリックされます。

Element–Get Elementアクティビティで選択されたアプリケーション。

キーモディファイア– 設定すると、実行中に対応するキーが押されたように動作します。

Mouse Button– 左マウスボタンをクリックする場合は1、中央マウスボタンの場合は “2“、右マウスボタンの場合は3に設定されます。

Post Wait–OpenRPAがこのアクティビティの実行を完了した後、終了を待つべき時間。

Virtual Click– デフォルトでTrueに設定されています。OpenRPAは、実際にマウスでクリックする代わりに、仮想クリックを試みます。詳細については、付録B–仮想クリックを参照してください。

X Offset– クリックされるウィンドウの内側の水平方向のオフセットです．単位はピクセルです。また、負の値も可能です。物理的なクリックでのみ動作します。

Y Offset– クリックされるウィンドウの内側の垂直方向のオフセットです．単位はピクセルです。また、負の値も可能です。物理的なクリックでのみ動作します。

OpenRPAクリック要素.。

アプリケーションを閉じる

Get Elementアクティビティで選択したアプリケーションを終了します。

プロパティパラメータ

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

Force- Trueに設定すると、アプリケーションを終了させます。

セレクタ– 選択されたアプリケーションに属するすべてのデータが含まれます。

Timeout– アプリケーションを正常に終了できなかった場合、アクティビティが停止するまでの時間間隔。単純な00:00:00.00 {hh:min:ss.mili}またはTimeSpanクラスのオブジェクトにすることができます。

OpenRPAクローズアプリケーション。

コメントアウト

Comment Out内のアクティビティは、ワークフローの実行では無視される。このアクティビティは、シーケンスから何かを指摘するのに便利である。

プロパティ パラメータ

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

クリップボードのコピー

Windowsのクリップボードの内容を変数に保存します。

しかし、このアクティビティを繰り返し連続的に使用することは、バッファの問題で信頼性が低いので、お勧めできません。回避策として、 コード起動アクティビティを使用して、次のAHKコードを実行することができますvariable1 := Clipboard.variable1が変数名であることに注意してください。

コピーされるWindowsクリップボードの内容が文字列の場合、ユーザーはプロパティボックスの String Resultフィールドに変数を指定する必要があります。イメージの場合は、イメージの保存先であるBitmapSource変数のファイルパスをImage Resultに指定する必要があります。

プロパティパラメータ

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

Image Result– クリップボードにコピーされたイメージからビットマップを作成し、BitmapSource変数として返します。

Send Ctrl+C– クリップボードの内容をコピーしようとする前に、Ctrl+Cを送信します。

String Result– クリップボードからの結果を文字列として返します。

OpenRPA Copy Cliboard.。

ディテクター活動

Detectorはワークフローをアイドルモードにし、選択したDetectorがトリガーされるのを待ちます。

Detectorは、OpenRPAの内部でStateMachineのトリガーとして使用することもできることを、ユーザーに伝えておく価値があります。

Detectorの設定方法の例は、Windows Automationセクションにあります。

プロパティパラメータ

Detector– 条件をトリガするために使用される検出器のIDです。

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

データ行を検索する

Foreach DataRowは DataTable内の各行を列挙する。

このアクティビティは、DataTableまたはDataViewを繰り返し処理します♪²Foreach DataRow内のすべてのアクティビティは、各行でループされます。Foreach DataRowアクティビティの使用例は、Web Automationと Excel Readのワークフロー例で紹介されています。

プロパティ パラメータ

DataTable– データを収集するために使用されるデータテーブルです。

DataView– データを収集するために使用されるデータビューです。DataViewの使用方法については、付録BのDataViewを参照してください。

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

OpenRPAのForeach DataRow.。

² –DataViewとDataTableの違いは何ですか？(https://stackoverflow.com/questions/7382932/what-is-the-difference-between-dataview-and-datatable)

ハイライト要素

GetElement活動で見つけた要素をハイライト表示する。

また、GetElementアクティビティ以外でこのアクティビティを使用する場合、ユーザーは特定のElementをハイライト表示するよう定義することができます。さらに、DurationパラメータにHH:mm:ss形式のTimeSpanオブジェクトを挿入することで、ハイライトの継続時間を指定することができます（例えば00:00:30で 30 秒間ハイライトします）。また、BlockingパラメータをTrueに設定することで、ハイライトが終了するまでワークフローの実行をブロックすることができます。

プロパティパラメータ

Blocking–Trueに設定すると、ハイライトが終了するまでワークフローの実行をブロックします。

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

Duration`-ハイライトの継続時間。単純な 00:00:00.00 {hh:min:ss.mili} またはTimeSpanクラスのオブジェクトを指定することができます。

Element–GetElementによってハイライトされる要素．

Result– [DEPRECATED] 現在使われていないパラメータです。

OpenRPAハイライト要素。

クリップボードの挿入

パラメータTextの内容をWindowsのクリップボードバッファにセットします。 しかし、このアクティビティを繰り返し連続して使用することは、バッファの問題で信頼性が低いので、お勧めしません。提案/回避策として、Invoke CodeActivityを使用して、以下のAHKコードを実行することができます。

Clipboard := variable1Timeout := 3WaitForAnyData := 1ClipWait, % Timeout, % WaitForAnyData; "variable1" is the name of the variable, can be changed.; More info about ClipWait at https://www.autohotkey.com/docs/commands/ClipWait.htm (yes .htm, not .html)

プロパティパラメータ

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

Ignore Errors– エラーが発生した場合、それを無視して続行します。デフォルトはFalseです。

Text– クリップボードに挿入されるテキストです。

OpenRPA Insert Clipboard.（クリップボード挿入）。

OpenFlowの起動

Invoke OpenFlowは、OpenFlow/ Node-REDで設定されたワークフローを呼び出すことができます。つまり、ワークフローのページ（例：http://localhost.openiap.io/#/Workflows）で利用可能です。

プロパティ パラメータ

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

Wait until Completed–Trueに設定すると、OpenRPAは Workflow呼び出しが終了するまで待機します（成功またはエラー）。成功した場合、データを含むメッセージ（Node-REDのフローで設計されたもの）がOpenRPAロボットに返されます。

しかし、Falseに設定すると、OpenRPAは返されたメッセージにアクセスできなくなり、通信は一方通行となります。したがって、これに依存するすべてのロジックを再設計する必要があります。例外メッセージを返さないtry/catch例外ブロックのようなものだと考えてください。³

ワークフロー– 呼び出されるワークフロー。

OpenRPA Invoke OpenFlow.。

OpenRPAの起動

Invoke OpenRPAは、OpenFlowのリポジトリに保存されているOpenRPA Workflows（RPA Workflowsページで公開されているもの）を呼び出すことができます（例：http://localhost.openiap.io/#/RPAWorkflows）。

Map Variables］ボタンをクリックすると、現在設定されている変数や引数をワークフ ローの呼び出しに渡すことができます。これを行うには、ドロップダウンからワークフローを選択した後、「変数、引数、イン ポート」ボックスで引数を作成し、アクティビティで「変数マッピング」ボタンをクリッ クします。

プロパティパラメータ

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

Wait until Completed–Trueに設定すると、OpenRPAは Workflow呼び出しが終了するまで待機します（成功またはエラー）。成功した場合、データを含むメッセージ（Node-REDのフローで設計されたもの）がOpenRPAロボットに返されます。

しかし、Falseに設定すると、OpenRPAは返されたメッセージにアクセスできなくなり、通信が一方通行になるため、これに依存するすべてのロジックを再設計する必要があります。これは、例外メッセージを返さないtry/catch例外ブロックだと考えてください。

ワークフロー– 呼び出されるワークフロー。

OpenRPAを起動する OpenRPA.。

リモートOpenRPAの起動

OpenFlowのリポジトリに保存されたRPAワークフローをリモートで呼び出し、他のOpenRPAクライアントで実行できるようにします。

Map Variables] ボタンをクリックすると、現在設定されている変数や引数を ワークスフローの呼び出しに渡すことができます。これを行うには、ドロップダウンからワークフローを選択した後、「変数、引数、イン ポート」ボックスで引数を作成し、アクティビティで「変数マッピング」ボタンをクリッ クします。

プロパティ パラメータ

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

Target– ワークフローを実行するためにアクティブにされるターゲットを識別するOpenFlowのハッシュ文字列。

完了 するまで待つ

Trueに設定すると、OpenRPAはWorkflow呼び出しが終了するまで待機します（成功またはエラー）。成功した場合、データを含むメッセージ（Node-REDでのフローで設計されたもの）がOpenRPAロボットに返されます。

しかし、Falseに設定すると、OpenRPAは返されたメッセージにアクセスできなくなり、通信が一方通行になるため、これに依存するすべてのロジックを再設計する必要があります。これは、例外メッセージを返さないtry/catch例外ブロックだと考えてください。

Workflow– 実行されるワークフローを識別するOpenFlowのハッシュ文字列。

OpenRPA Invoke Remote OpenRPA.を起動します。

マウスを移動させる

マウスカーソルをGetElementで見つかった要素（要素がない場合はデスクトップ）に相対する位置に移動します。

このActivityには、2つの使用モードがあります。

最初の使用モードはセレクタレスです。このモードでは、アクティビティはスクリーンの絶対値を使用してXと Yのオフセット値を見つけます。例として、ユーザーが 1366x768のディスプレイを持っている場合、アクティビティはスクリーン内のその解像度に従ってマウスを移動させる。このモードを使用するには、ユーザーがアクティビティのElementプロパティ内の任意の値（デフォルト値はitem）を削除するだけで、Xと Yのオフセット値を定義することができます。

2つ目の使用モードはセレクタバウンドです。このモードでは、Windowsの要素を選択した後、アクティビティは要素が占める画面の部分の相対値を使用して、Xと Yのオフセット値を見つけます。このモードを使用するには、ユーザーはMove Mouseアクティビティを選択された要素にドラッグし、Xと Yのオフセット値を定義するだけでよいのです。

アプリケーションは、「要素の取得」アクティビティを使用して選択する必要があります。

プロパティパラメータ

Animate Mouse–Trueに設定すると、カーソルは実行中にその位置を変えて表示されます。プレゼンテーションで何が起こっているかを示すのに適しています。

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

要素–要素の取得アクティビティで選択されたアプリケーション。

ポストウェイト–OpenRPAがこのアクティビティの実行を完了した後、終了するまで待つ時間です。

X Offset– カーソルの移動先となるウィンドウ内の水平オフセット．単位はピクセルです。また、負の値を指定することもできます。

Y Offset– カーソルが移動するウィンドウ内の垂直方向のオフセットです．単位はピクセルです。また、負の値を指定することもできます。

OpenRPAムーブマウス.。

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

Open Applicationは、セレクタを元にWindowsの要素を検索し、その要素にフォーカスを当てます。アプリケーションを見つけられなかった場合は、アプリケーションを起動します。

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

このアクティビティは、自身の内部でセレクタを操作することも可能です。必要なことは、GetElement、またはそれに応じたアクティビティを、そのシーケンス内にドラッグすることだけです。

このアクティビティは、ブラウザや、Java、SAPなどの他のアプリケーションで動作させることもできます。プロパティパラメータ

Animate Move– 開くアプリケーションのウィンドウを瞬時に移動させるのではなく、目に見える形で移動させます。プレゼンテーションに便利です。

Check Running– アプリケーションがセレクタを使用してすでに実行されているかどうかをチェックします。Falseに設定すると、何があっても新しいアプリケーションを起動します。

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

Height– 設定された場合、アプリケーションはこの高さで開かれます。単位はピクセルです。

Result– 実行結果を変数に保存します。デフォルトでは、アプリケーションのElementそのものを保存します。

セレクタ– アプリケーションの識別に使用されるすべてのデータが含まれています。

Timeout– アプリケーションが見つかったかどうかを確認する時間。基本的には、Check Runningパラメータのタイムアウトです。 単純な00:00:00.00 {hh:min:ss.mili}またはTimeSpanクラスのオブジェクトにすることができます。

Width– 設定された場合、アプリケーションはこの高さで開かれます。単位はピクセルです。

X– 設定された場合、アプリケーションはこの水平オフセットに移動します。単位はピクセルです。また、負の値も可能です。

Y– 設定された場合、アプリケーションはこの垂直オフセットに移動します。単位はピクセルです。また、負の値も可能です。

OpenRPAオープンアプリケーション。

バルーンチップを表示する

バルーンチップの表示] は、システムトレイ付近の [通知の表示] アクティビティと同様のメッセージを表示します。タイトルが表示され、エラーや警告など他の種類の通知も可能な点で、[通知を表示]とのみ異なります。

プロパティパラメータ

期間– メッセージが表示される期間です。

Message– 表示されるメッセージ。引用符で囲む必要があります。

タイトル– バルーンチップのタイトルです。

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

NotificationType– 異なる通知タイプ。情報、エラーまたは警告。

OpenRPAショーバルーンTip.。

タイプ テキスト

ユーザーはこのアクティビティを使用することを強くお勧めします。GetElementアクティビティで要素を選択し、Assignプロパティを使って文字列値を割り当てるのが望ましいでしょう。

Type Textは、Hintに含まれるテキストから、現在フォーカスされているウィンドウにキーストロー クを送信します。すべてのキーストロークを記憶するのではなく、すべてのキーストロークを自動的にマッピングするRecorderの使用を推奨します¹。

キーストロークの構文は、「{{Modifier1, Key1}」とします。{修飾子2, キー2}」。{…}{修飾子N、KeyN}}」とします。補助キーとなる修飾子（Ctrl、Alt、Shiftなど）は必須ではありませんのでご注意ください。

また、ユーザーは変数や ハードコードされたテキストを送信することもできます。例えば、”{{Modifier1, Key1}}” を送信します。SOME TEXT ” + desired_variable + “{Enter}”のように送信します。

プロパティパラメータ

クリックディレイ– 各キーストローク間のディレイ。

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

Text–ワークフローデザイナー内の表示名。

OpenRPAタイプテキスト。

¹ – `TypeText Activityの概要 <https://openrpa.openiap.io/pages/typetext-syntax>`_ (“https://openrpa.openiap.io/pages/typetext-syntax“)

Coming soon – Work in progress

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

呼び出しコード

エディタ内にコードを記述し、ワークフロー・シーケンスの特定のステップで指定されたコードを実行することができます。現在サポートされている言語は、C#、 PowerShell、Python、VB、AutoHotkeyです。コードを書くには、「Open Editor」ボタンをクリックし、ドロップダウンから希望の言語を選択し、「Validate」ボタンをクリックするだけです。ワークフローが実行されると、コードが実行されます。

このアクティビティがデータ バインディングをサポートしていること、つまり、ユーザーがOpenRPA内部で変数を定義してコード内部でそれを使用したり、逆に変数が事前に定義されている必要があることをユーザーに思い出させることは有用です。また、このアクティビティで書かれたコードを実行するために使用されるPython環境には、組み込みのPythonバージョン（3.7.3）がインストールされていることに注意する必要があります。もし、ユーザーがフォルダ内にインストールされた外部環境（ウィンドウの環境変数で設定されたユーザー 変数 >パス変数で定義されている）を使用したい場合は、設定>プラグイン実行>スクリプトを参照し、Use embedded pythonチェックボックスをオフにする必要があります。

プロパティパラメータ

Code– 実行されるコード。

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

言語– コードの実行に使用される言語。現在サポートされている言語は、C#、 PowerShell、Python、VB、AutoHotkeyです。

PipelineOutput– 現在、使用されていないパラメータです。

ピップインストール

現在選択されているPython環境に、1つまたは複数のPythonモジュールをインストールします。ここでいうPython環境とは、OpenRPAがモジュールのインストールに使用するPythonのバージョンのことです。設定 > プラグイン実行 > スクリプトの中にあるチェックボックスをユーザーがオフにしていない場合、OpenRPAは OpenRPAに組み込まれているデフォルトのPython環境を使用します。そうでなければ、OpenRPAは、ウィンドウの環境変数内のユーザー 変数で設定されたパスにインストールされた環境を使用します。

プロパティパラメータ

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

Force–Trueに設定すると、指定されたモジュールの再インストールを強制します。

Modules– インストールされるモジュールを定義するための文字列配列、例えば{"matplotlib", "sns"} など。

ここでは、OpenRPA.Utilitiesのツールボックス内にあるアクティビティを紹介します。

AddDataColumn 活動

既存のDataTableに DataColumnを追加します。

ユーザーはまず、DataTableフィールドに列が追加されるDataTableファイルのパスを挿入しなければなりません。次に、空白のドロップダウンからタイプを選択し、最後に新しいDataColumnの名前を挿入してください。

プロパティパラメータ

AllowDBNull– マークの付いた場合、テーブルに属する行のこのカラムにNULL値が許可されます。

AutoIncrement– マークの場合、テーブルに追加された新しい行の列の値が自動的にインクリメントされます。

ColumnName– 追加される列のヘッダーの名前です。

DataTable–列が追加されるデータテーブルのファイルパス．

DefaultValue–カラムのデフォルト値．AutoIncrementがチェックされている場合、設定されてはいけません。

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

MaxLength– テキストカラムの最大長を設定します。

TargetType–列のデータの型．

一意– マークの付いた場合、列の各行の値が一意である必要があることを示す。

AddDataRow 活動

既存のDataTableに DataRowを追加します。

ユーザーは、まず フィールドに 挿入 するD ataTableの 中にDataTableを挿入する必要があります。次に、 DataTableの カラムの配列の中に行のデータを挿入します。行のデータは、DataTable内の指定された列の数と一致しなければならないことをユーザーに思い出させることは興味深いことです。

プロパティパラメータ

DataTable–データ行が追加されるデータテーブルのファイルパス．

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

RowData– 行データを含むオブジェクト配列，例えば{"zechriel", 31909790}．

CreateDataTableアクティビティ

このアクティビティでは、カラム名（ヘッダー）を持つ新しいDataTableオブジェクトを作成し、変数にマッピングしています。

ユーザーはまず、New DataTable 変数フィールドに変数を挿入し、Ctrl+Kキーを押して変数を作成しなければならない。次に、与えられたDataTableのカラム名をArray of DataTable columnsの中に挿入しなければなりません、例えば{"name", "telephone_number"}.

プロパティパラメータ

ColumnNames–DataTableオブジェクトのヘッダ。例えば{"name", "telephone_number"} のようなString の配列を含まなければなりません。

DataTable– 新規に作成されたDataTableがマッピングされるDataTableファイルパス型の変数名です。

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

DeleteAllRows 活動

このアクティビティは、既存のDataTableオブジェクトからすべての行を削除します。

DataTableオブジェクトは、Update from DataTableアクティビティで更新する必要があります。

プロパティパラメータ

DataTable– 行を削除するためのDataTableオブジェクト．

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

DeleteRow 活動

dt.Rows(n)はdataTableオブジェクトを表し、nは指定されたDataRowのインデックスを表しており、指定されたインデックスの行を削除することが可能です。

プロパティパラメータ

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

Row–DataTableから削除されるDataRowオブジェクト．

ダウンロードファイル活動

指定されたファイルパスにファイルをダウンロードします。まず、...ボタンをクリックしてファイルを保存するフォルダを選択し、ファイル名と ファイル 形式をドットで区切って入力します（例：`insideairbnb.csv“）。次に、ファイルを取得するためのURLをプロパティボックスに入力する必要があります。

プロパティパラメータ

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

LocalPath– ダウンロードされるファイルのフルパスとファイル名です。

Overwrite– このパラメータは、ファイルがすでに存在する場合、上書きします。

URL– ファイルを収集するためのURLです。

認証情報の取得

このアクティビティは、Windowsのクレデンシャルマネージャからクレデンシャルセットを取得します。

資格情報を取得・保存する最も推奨される方法は、Set Credentialsアクティビティを使用してOpenFlow MongoDBデータベースを経由する方法です。詳しくは、OpenRPA.OpenFlowDBの項をご参照ください。

プロパティパラメータ

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

名前– 取得されるクレデンシャルの名前。

Password– パスワードをSecureString型変数(https://docs.microsoft.com/en-us/dotnet/api/system.security.securestring?view=netcore-3.1)に保存します。

UnsecurePassword– 取得したパスワードをString 型の変数に保存します。

Username– 取得したユーザー名をString型の変数に保存します。

JArrayToDataTable 活動内容

このアクティビティはJSON Arrayの内容をDataTableオブジェクトにパースし、変数にマップします。JArrayは 必ず1次元でなければならず、さもなければ主配列に属さないコンテンツは無視されます。

このアクティビティは、OpenFlowDB.Queryアクティビティを使用して、コレクションのすべての内容をDataTableオブジェクトにマッピングするのに適しています。データを収集したいCollectionを選択し、QueryStringパラメータの中に{}を挿入し、Resultを変数にマッピングします – つまりresultsです。この方法では、すべてのデータを返し、ユーザーはそれを変数jarrayobjに割り当て、コンテンツnew JArray（results）を使用し、最後にこの活動を使用してjarrayobjの内容をデータテーブルにマップします。

プロパティパラメータ

DataTable–JArrayの結果を保持するDataTable変数。

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

JArray– パースされるコンテンツを保持するJArray変数。

マッチング活動

このアクティビティは、与えられたStringオブジェクトを正規表現パターンにマッチさせ、Stringが与えられたパターンを含んでいれば、ブール値、すなわち、TrueまたはFalseの結果を変数に保存します。正規表現の詳しい説明は、RyansTutorials Regular Expressions(https://ryanstutorials.net/regular-expressions-tutorial/)を参照してください。

プロパティパラメータ

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

Input–RegExパターンにマッチする入力文字列．

Pattern– 文字列に対するマッチングに使われるRegExパターン．

Result–RegExパターンに入力文字列が一致した場合、または一致しなかった場合に保存されるブール値、つまりTrueまたはFalseの変数ファイルパス。

Compiled– 正規表現がアセンブリにコンパイルされることを指定します。これにより、実行速度が速くなりますが、起動時間が長くなります。

CultureInvariant– マークの場合、言語における文化的差異が無視されることを指定します。

ECMAScript– マークの場合、式に対してECMAScriptに準拠した動作を有効にします。 この値は、IgnoreCase、Multiline、およびCompiledの各値と組み合わせてのみ使用することができます。

ExplicitCapture– マークの場合、有効なキャプチャは、明示的に名前または番号が付けられたグループのみであることを指定します(?<名前>...)という形式です。これにより、名前のない括弧は、(?:...)のような構文上の不便さを伴わずに、非キャプチャグループとして機能することができます。

IgnoreCase– マークの付いた場合、大文字と小文字を区別しないマッチングが指定されます。

IgnorePatternWhiteSpace– マークの付いた場合、パターンからエスケープされていない空白を取り除き、#でマークされたコメントを有効にします。ただし、この値は、文字クラス、数値定量詞、または個々の正規表現言語要素の開始を示すトークンの空白に影響したり、空白を除去したりすることはありません。

Multiline– マルチライン・モード。マークされた場合、^と $の意味を変更し、文字列全体の先頭と末尾だけでなく、任意の行の先頭と末尾でそれぞれマッチするようにします。

RightToLeft– マークの場合、左から右ではなく、右から左へ検索することを指定します。

Singleline– マークを付けると、単一行モードが指定されます。ドット(.)の意味が変わり、すべての文字にマッチします（自分以外のすべての文字にマッチするのではありません）。

アクティビティにマッチする

このアクティビティは、与えられたStringオブジェクトをRegular Expressionパターンにマッチさせ、結果のグループをMatchオブジェクトの配列<https://docs.microsoft.com/en-us/dotnet/api/system.text.regularexpressions.match?view=netcore-3.1>_(https://docs.microsoft.com/en-us/dotnet/api/system.text.regularexpressions.match?view=netcore-3.1) に保存します。

オブジェクトは、下の画像のように、配列にインデックスを付けることでアクセスできます。正規表現についての詳しい説明は、RyansTutorials Regular Expressions(https://ryanstutorials.net/regular-expressions-tutorial/)を参照してください。

プロパティ パラメータ

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

Input–RegExパターンにマッチする入力文字列ファイルパス．

Pattern– 文字列に対するマッチングに使われるRegExパターン．

Result– 変数ファイルのパスRegExパターンに入力文字列がマッチするかどうか、ブール値、つまり “True“ またはFalse が保存されます。

Compiled– このパラメータは、正規表現がアセンブリにコンパイルされることを指定します。これにより、実行速度が速くなりますが、起動時間が長くなります。

CultureInvariant– マークの場合、言語における文化的差異を無視することを指定します。

ECMAScript– マークの場合、式に対してECMAScriptに準拠した動作を有効にします。 この値は、IgnoreCase、Multiline、およびCompiledの各値と組み合わせてのみ使用することができます。

ExplicitCapture– マークの場合、有効なキャプチャは、明示的に名前付けされたグループ、または(?<名前>...) という形式の番号付けされたグループのみであることが指定されます。これにより、名前のない括弧は、(?:...)のような構文上の不便さを伴わずに、非キャプチャグループとして機能することができます。

IgnoreCase– マークの付いた場合、大文字と小文字を区別しないマッチングが指定されます。

IgnorePatternWhiteSpace– マークの付いた場合、パターンからエスケープされていない空白を取り除き、#でマークされたコメントを有効にします。ただし、この値は、文字クラス、数値定量詞、または個々の正規表現言語要素の開始を示すトークンの空白に影響したり、空白を除去したりすることはありません。

Multiline– マルチライン・モード。マークされた場合、^と $の意味を変更し、文字列全体の先頭と末尾だけでなく、任意の行の先頭と末尾でそれぞれマッチするようにします。

RightToLeft– マークの場合、左から右ではなく、右から左へ検索することを指定します。

Singleline– マークを付けると、単一行モードが指定されます。ドット(.)の意味が変わり、すべての文字にマッチします（自分以外のすべての文字にマッチするのではありません）。

ReadCSV 活動

このアクティビティは、.csvファイルの内容をDataTable変数にパースします。

ユーザーはまず、…ボタンをクリックして解析されるファイルを選択し、次にプロパティボックス内に内容が保存されるDataTable変数ファイルのパスを挿入する必要があります。

また、Delimeterパラメータで特定の区切り文字を定義することもできます（デフォルトは", "または"; "です）。また、UseHeaderRowsパラメータをFalseに設定することで、ヘッダーをDataTable内に挿入することも可能です。

プロパティパラメータ

DataTable–.csvファイルを解析して生成されたコンテンツが保存されるDataTable変数ファイルのパスです。

デリミタ–.csvファイルの列を区切るためのデリミタを指定します – デフォルトは","または";" です。

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

Filename– 解析される.csvファイルのフルパスとファイル名です。

UseHeaderRows–Falseに設定すると、OpenRPAは .csvファイルのヘッダーの内容もパースしてDataTableに取り込みます。そうでない場合は、単にヘッダーを無視します。

ReadExcel 活動

このアクティビティは、Microsoft Excelドキュメントの内容をDataSet変数にパースします。

ユーザーは、最初に...ボタンをクリックして解析される Microsoft Excel ドキュメントを選択し、次に、コンテンツが保存されるDataSet変数ファイル パスをプロパティ ボックスに挿入する必要があります。また、UseHeaderRowsを Falseに設定することにより、ヘッダーをデータセット内に挿入することもできます。

プロパティパラメータ

DataSet– Microsoft Excel ドキュメントを解析して生成されたコンテンツが保存されるDataSet変数ファイルのパスです。

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

ファイル名– 解析されるMicrosoft Excelドキュメントのフルパスとファイル名です。

UseHeaderRows–Falseに設定すると、OpenRPAはMicrosoft Excelドキュメントのヘッダーの内容も解析してDataSetに取り込みます。そうでなければ、単にヘッダーを無視します。

ReadJSONアクティビティ

.jsonファイル内のJSON 配列の内容をDataTable変数にパースします。

現在、1次元のJSON 配列のみをサポートしています。ユーザーは、まず... ボタンをクリックして解析される.jsonファイルを選択し、プロパティ ボックスに内容が保存されるDataTable変数ファイル パスを挿入する必要があります。

ファイルの最初の文字位置には[]、最後の文字位置には[]が必要であることをユーザーに伝えると効果的です。

プロパティパラメータ

DataTable–.jsonファイルを解析して生成されたコンテンツが保存されるDataTable変数ファイルのパスです。

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

Filename– 解析される.jsonファイルのフルパスとファイル名です。

ReadPDF 活動

PDFファイルのテキスト内容をString変数にパースし、オプションで、より多くのパースオプションのためにPdfReader(https://github.com/itext/itextsharp/blob/5d8d6301e334aa37a01b5374cdfd4e9bc20f40ca/src/core/iTextSharp/text/pdf/PdfReaderInstance.cs) をResultとして返します。

ユーザーはまず、…ボタンをクリックして解析されるPDFファイルを選択し、次にAllTextパラメータ内にPDFファイル内のすべてのテキストを持つStringオブジェクトを含む変数を挿入する必要があります。

プロパティパラメータ

AllText–PDFファイルのテキスト内容が保存される文字列変数ファイルパスです。

Filename– 解析されるPDFファイルのフルパスとファイル名です。

結果–PdfReader変数ファイルのパス、パースから取得したメモリのストリームが保存されます。

リプレース活動

与えられたStringオブジェクトを正規表現パターンにマッチさせ、マッチした各グループの内容をReplacement Stringオブジェクトで置き換えます。

正規表現の詳しい説明は、RyansTutorials Regular Expressions(https://ryanstutorials.net/regular-expressions-tutorial/)を参照してください。

プロパティパラメータ

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

Input– 入力RegExパターンにマッチし、その内容が置換される文字列ファイルパスです。

Pattern– 文字列に対するマッチングに使われるRegExパターン．

Replacement–入力 文字列内の各グループをその内容で置き換えるために利用される，置換 文字列オブジェクト．

結果– このアクティビティによって置き換えられた内容を持つStringオブジェクトの変数ファイルパスが保存されます。

Compiled– このパラメータは、正規表現がアセンブリにコンパイルされることを指定します。これにより、実行速度が速くなりますが、起動時間が長くなります。

CultureInvariant– マークの場合、言語における文化的差異を無視することを指定します。

ECMAScript– マークの場合、式に対してECMAScriptに準拠した動作を有効にします。 この値は、IgnoreCase、Multiline、およびCompiledの各値と組み合わせてのみ使用することができます。

ExplicitCapture– これが指定されている場合、有効なキャプチャは、明示的に名前または番号が付けられた(?<名前>...) 形式のグループのみであることが指定されます。これにより、名前のない括弧を非キャプチャグループとして動作させることができ、(?:...)のような構文上の不便さはありません。

IgnoreCase– マークの付いた場合、大文字と小文字を区別しないマッチングが指定されます。

IgnorePatternWhiteSpace– マークの付いた場合、パターンからエスケープされていない空白を取り除き、#でマークされたコメントを有効にします。ただし、この値は、文字クラス、数値定量詞、または個々の正規表現言語要素の開始を示すトークンの空白には影響しませんし、空白を除去しません。

Multiline– マルチライン・モード。マークされた場合、^と $の意味を変更し、文字列全体の先頭と末尾だけでなく、任意の行の先頭と末尾でそれぞれマッチするようにします。

RightToLeft– マークの場合、左から右ではなく、右から左へ検索することを指定します。

Singleline– マークを付けると、単一行モードが指定されます。ドット(.)の意味が変わり、すべての文字にマッチします（自分以外のすべての文字にマッチするのではありません）。

SelectFile 活動

ワークフローのエンドユーザーに対して、FileDialog（https://docs.microsoft.com/pt-br/dotnet/api/system.windows.forms.filedialog?view=netcore-3.1）を使用してフ ァイルを選択し、そのファイルパス（またはパス）を変数に保存するように促し ます。また、ワークフローを構築したユーザーは、ファイルが存在するかどうか、パス が存在するかどうかなど、特定のチェックを実施することができます。

また、IsSaveAsパラメータを変更することで、ユーザは2種類のダイアログを指定することができる。一つ目はOpenFileDialog(https://docs.microsoft.com/pt-br/dotnet/api/system.windows.forms.openfiledialog?view=netcore-3.1)で、エンドユーザがファイルを開いてResultパラメータに保存することができるものである。2つ目はSaveFileDialog(https://docs.microsoft.com/en-us/dotnet/api/system.windows.forms.savefiledialog?view=netcore-3.1)で、エンドユーザが空のファイルを希望のfilepathに保存することができます。

MultiselectパラメータをTrueにすると、1 つ以上のファイル パスを返すこともできますが、その場合はFileNamesパラメータを使用して結果を保存しなければなりません。ユーザーが複数のファイルを選択する場合は、括弧を使用して、result(0) のように反復処理することができます。ファイル パスを保持する result 変数をResultまたはResultsパラメータに挿入したら、Ctrl+K キーを押して変数を作成する必要があります。

プロパティ パラメータ

CheckFileExists–Trueの場合、ユーザーが存在しないファイル名を指定した場合に警告を表示します。既定値はFalseです。

CheckPathExists–Trueの場合、ユーザーが存在しないパスを指定した場合に警告を表示します。既定値はFalseです。

DefaultExt– ファイルダイアログ内のデータ表示に使用されるデフォルトの拡張子を設定します（例：txt）。

フィルター–ファイルの 種類のドロップダウンに表示されるオプションにフィルターをかけます。例：「txt ファイル （*.txt）|*.txt|すべての ファイル （*.*）|*.*」。

FilterIndex–Filterパラメータの開始インデックスです。

InitialDirectory– ファイルダイアログの開始ディレクトリ．

IsSaveAs–Trueの場合、ダイアログをSaveFileDialog(https://docs.microsoft.com/en-us/dotnet/api/system.windows.forms.savefiledialog?view=netcore-3.1)に設定します。そうでない場合は、OpenFileDialog(https://docs.microsoft.com/pt-br/dotnet/api/system.windows.forms.openfiledialog?view=netcore-3.1)に設定されます。

Multiselect–True の場合、ユーザーが複数のファイルを選択できるようになります。ユーザーは、FileNamesパラメータを使用して、選択したファイルの結果をファイル パスに設定することが義務付けられています。デフォルトはFalseです。

タイトル– ファイルダイアログウィンドウのタイトルです。

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

FileName– 選択されたファイルのファイルパスを含む文字列を保持する結果変数。MultiselectがTrueに設定され、エンドユーザーが複数のファイルを選択した場合、最後に選択されたファイルの値のみが保持されます。

FileName–MultiselectパラメータがTrueに設定されている場合に，選択されたすべてのファイルのパスを含むString[]を保持する結果変数．Falseに設定されている場合、この変数は、インデックス0において選択された1つのファイルのみを保持します。

SelectFolder アクティビティ

FolderBrowserDialog（https://docs.microsoft.com/en-us/dotnet/api/system.windows.forms.folderbrowserdialog?view=netcore-3.1）を使用して、ワークフローのエンドユーザーにフォルダーを選択し、そのフォルダーパスを変数に保存するようプロンプトを表示します。

Folderパラメータにフォルダパスを保持するresult変数を挿入した後、ユーザーはCtrl+Kキーを押してそれを作成する必要があります。

プロパティパラメータ

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

Folder– 選択されたフォルダのフォルダパスを含む文字列を保持する変数です。

RootFolder– エンドユーザーに表示されるルートフォルダです。空のままだと、Desktopフォルダが表示されます。

ShowNewFolderButton– 新規 フォルダーの作成ボタンを表示し、FolderBrowserDialogで新規フォルダーを作成できるようにします。

SetAllRowsState アクティビティ

このアクティビティは、DataTable内のすべてのDataRowsの状態を設定します。OpenRPA内部でDataTableが作成、更新、削除されるたびに、それに加えられたすべての変更のトランザクションログも同様に作成、更新、削除されます。このアクティビティは、このトランザクションログを更新します。

ここでは、3つの可能性があります。Added、Modified、Not Modifiedです。Addedは DataTableの内容を更新し、Modifiedはデータを含む既存の行を変更し、Not Modifiedはこれらの行に全く作用しない。

これは、例えば DataTable アクティビティから更新を行う際に、新しく追加された行があるかどうかをチェックしてデータベースを更新するので、便利です。All rowsをAddedにすると、ロボットはデータベースを更新する前に、すべての行の情報をチェックします。もし、ユーザーがデータベースに情報を追加したくない場合は、すべての行をNot Modifiedに設定することで対応できます。これは、1つのデータモデルを更新するために、異なるソースから2つのDataTableを使用する場合に便利です。また、このアクティビティは、Update from DataTableがデータベースを処理する際に、update itemコマンドとinsert itemコマンドのどちらを使用すべきかを指示します。

プロパティパラメータ

DataTable– 行が属するDataTableの名前。

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

RowState– 3つのオプションのうち1つを選択します。

SetAutoLoginアクティビティ

このアクティビティは、使用中のマシンでの自動ログオンを設定します。

Microsoft アカウントを使用しない場合、ユーザーは「${HOSTNAME}}${USERNAME}」を使用して、プロパティボックス内のUsernameを設定する必要があります。そうでない場合は、現在使用しているMicrosoft アカウントとして設定された電子メールを使用して、マシンに認証することができます。また、パスワードとして SecureStringを使用することも可能である。パスワードをプレーンテキスト 文字列として保存したい場合は、UnsecurePassword.Password にパスワードを入力するだけです。

プロパティパラメータ

AutoLogonCount–AutoLogonCountは、AutoLogon を使用してコンピュータにログオンできる回数を指定します。この値は、コンピュータにログオンするたびに減少します。AutoLogonCount の値をリセットするには、コンピュータを再起動する必要があります。

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

パスワード– ここで定義されたSecureStringをログイン時のデフォルトパスワードとして使用します。

UnsecurePassword– ここで定義されたプレーンテキスト 文字列を、ログイン用のデフォルトパスワードとして使用します。

Username– ログイン時のユーザー名を定義する文字列オブジェクト。

認証情報の設定

このアクティビティは、Windowsのクレデンシャルマネージャからクレデンシャルセットを作成または更新します。

資格情報を取得・保存する方法として最も推奨されるのは、Set CredentialsActivityでOpenFlow MongoDBデータベースを利用する方法です。詳しくは、OpenRPA.OpenFlowDBの項をご参照ください。

プロパティパラメータ

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

名前– 保存されるクレデンシャルの名前。

Password– 保存される資格情報のパスワード。

Username– 保存される資格情報のユーザー名です。

StartProcess 活動

Filenameパスパラメータで指定された実行ファイルを参照するプロセスを開始する。

また、ユーザーはArgumentsパラメータ内で実行されるプロセスに引数を渡すことができる。コマンドラインインターフェースからプロセスを開始するときと同様である。このActivityでは、プロセスが開始するディレクトリとして使用するWorkingDirectoryも渡すことができる。

また、WaitForExitを設定することで、OpenRPAがプロセスの実行停止を待つかどうかを定義することができます。また、WaitForExitパラメータにタイムアウトを定義することも可能です。

プロパティパラメータ

Arguments– プロセスの実行に渡すことができるオプションの引数。

Filename– そのプロセスを持つ実行ファイルのパス。

WaitForExit–Trueの場合、プロセスの実行が終了するのを待ちます。

WaitForExitTimeout– プロセスの実行が停止するのをOpenRPAが待機する時間間隔。単純な 00:00:00.00 {hh:min:ss.mili} またはTimeSpanクラスのオブジェクトを使用できます。

WorkingDirectory– プロセスを実行するための開始ディレクトリ。

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

WriteCSV 活動

このアクティビティは、DataTableの内容を.csvファイルに書き出します。

ユーザーはまず、...ボタンをクリックして、DataTableの書き込み先となるファイルを選択する必要があります。そして、その内容を取得するDataTable変数をプロパティボックスに挿入してください。

また、Delimeterパラメータで特定の区切り文字を定義することもできます（デフォルトは", "または"; "です）。また、IncludeHeadersパラメータをTrueに設定することで、DataTableの中にヘッダを挿入することができます。

プロパティパラメータ

DataTable– コンテンツの取得元となるDataTable変数．

デリミタ– このパラメータは、.csvファイルの列を区切るために使用されるデリミタを指定します – デフォルトは","または";" です。

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

Filename– 書き込まれる.csvファイルのフルパスとファイル名です。

IncludeHeaders–True に設定すると、OpenRPA は DataTableヘッダーの内容も.csvファイルに書き込みます。

WriteExcel 活動

このアクティビティは、DataSetまたはDataTableオブジェクトの内容を Microsoft Excel ドキュメントに書き込みます。

まず、...ボタンをクリックして、データテーブルを書き込む Microsoft Excel ドキュメントを選択する必要があります。そして、その内容を取得するデータセットまたはデータテーブル変数をプロパティボックスの中に挿入してください。

また、includeHeaderパラメータをTrueに設定することで、DataTable内にヘッダを挿入することができます。また、Microsoft Excel ドキュメント内のセルの色に使用されるテーブルスタイル(https://www.excel-easy.com/examples/table-styles.html) を含むテーマを指定することもできます。

プロパティパラメータ

DataSet– コンテンツの取得元となるDataSet変数．

DataTable– コンテンツの取得元となるDataTable変数．

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

ファイル名– 書き込まれるMicrosoft Excelドキュメントのフルパスとファイル名です。

IncludeHeaders–True に設定すると、OpenRPA は DataTableヘッダーの内容も.csvファイルに書き込みます。

テーマ– Microsoft Excel文書内のセルの色付けに使用するテーマを指定することができます。

ここでは、OpenRPA.Windowsのツールボックス内にあるアクティビティを紹介します。

エレメントを取得

このアクティビティは、[セレクタを開く]ボタンを使って、または録音によって自動的にエレメントを選択します。

また、「ハイライト」ボタンを使って、画面内の選択部分を強調表示することもできます。ハイライト」ボタンをクリックすると、セレクタの条件に一致する最初の要素が赤くハイライトされます。このアクティビティは、セレクタが正しく設定されているかどうかを確認するのに便利です。

プロパティパラメータ

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

要素– 画像の収集元となる要素。

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

MaxResults– 最大結果の数。

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

セレクタ– 選択されたアプリケーションに属するすべてのデータが含まれます。

Timeout– 要素の検索に成功しなかった場合、アクティビティが停止するまでの時間間隔。 単純な00:00:00.00 {hh:min:ss.mili}またはTimeSpanクラスのオブジェクトにすることができます。

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

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

AddToCollection<> アクティビティ

このアクティビティは、コレクションにアイテムを追加します。

コレクションはリストと似ていますが、リストが新しい項目を受け入れないのに対して、コレクションは新しい項目を受け入れないという点を覚えておいてください。このテーマに関する包括的な説明は、Microsoftの.NET公式Webページ(https://docs.microsoft.com/pt-br/dotnet/visual-basic/programming-guide/concepts/collections)を参照してください。

Collectionはまず、System.Collections.Generic.List<T>に変数を代入して初期化する必要がある。ここでTは、Collection内に含まれるオブジェクトのデータ型に対応するものである。例えば、文字列の コレクションで、ユーザが一つの値"name" で初期化したい場合、彼は値new List(of string)({"name"})を目的の変数に代入します。

プロパティパラメータ

Collection– 一致する要素が存在するかどうかをチェックするコレクションの名前。これは、変数または引数として最初に宣言されている必要があり、引数の型はSystem.Collections.Generic.List<T> です。ここで、Tは、コレクション内に含まれるオブジェクトのデータ型に対応します。

.

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

Item– 追加される項目。TypeArgumentで宣言されたものと同じ型でなければならない。

TypeArgument– リストの項目のデータのタイプ。

システム.アクティビティAddToCollection<>。

アクティビティを割り当てる

このActivityは、変数に値を代入するために使用されます。

プロパティパラメータ

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

To– 値が割り当てられる変数ファイルのパス。

Value– 変数に代入される値です。

システム.アクティビティ割り当てを

ClearCollection<> アクティビティ

このアクティビティは、コレクションをクリアする、つまり、コレクションからすべてのアイテムを削除します。

プロパティ パラメータ

Collection– 一致する要素が存在するかどうかをチェックするコレクションの名前。これは、変数または引数として最初に宣言されている必要があり、引数タイプはSystem.Collections.Generic.List<T> です。ここで、Tは、AddToCollection<>アクティビティセクションの画像に見られるように、コレクション内に含まれるオブジェクトのデータ型に対応しています。

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

TypeArgument– リストの項目のデータの型。

System.Activities ClearCollection<>。

ディレイ活動

TimeSpanクラスへのオブジェクトのインスタンスから遅延を作成します。また、ユーザーは単純にHH:MM:SSのフォーマットで時間の長さを入力することができます。

プロパティ パラメータ

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

Duration– 遅延の長さを指定する引数です。単純な 00:00:00.00 {hh:min:ss.mili} またはTimeSpanクラスのオブジェクトにすることができます。

備考

TimeSpan値は時間間隔を表し、特定の日数、時間、分、秒、ミリ秒として表現することができる。特定の始点や終点を持たない一般的な間隔を表すため、日数が可変である年や月で表すことはできない¹。

¹ – `TimeSpan Struct <https://docs.microsoft.com/en-us/dotnet/api/system.timespan?view=netcore-3.1>`_ (“https://docs.microsoft.com/en-us/dotnet/api/system.timespan?view=netcore-3.1“)

システム.アクティビティ ディレイ.。

Do Whileアクティビティ

ループ内にドロップされた他のアクティビティを少なくとも1回実行し、ループの条件が Trueに評価されなくなるまで繰り返し実行するループを作成します。

プロパティ パラメータ

Condition– これは、ループ条件を表すVB Expressionです。

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

システム.アクティビティ.Do.While.の

ExistsInCollection<> アクティビティ

このActivityは、コレクションにItemが存在するかどうかを調べ、ブール値を返す。

Collectionはまず、System.Collections.Generic.List<T>に変数を代入して初期化する必要がある。ここでTは、Collection内に含まれるオブジェクトのデータ型に対応するものである。例えば、文字列の コレクションで、ユーザが一つの値"name" で初期化したい場合、彼は値new List(of string)({"name"})を目的の変数に代入します。

プロパティ パラメータ

Collection– 一致する要素が存在するかどうかをチェックするコレクションの名前。これは、変数または引数として最初に宣言されている必要があり、引数タイプはSystem.Collections.Generic.List<T> です。ここで、Tは、AddToCollection<>アクティビティセクションの画像に見られるように、コレクション内に含まれるオブジェクトのデータ型に対応しています。

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

Item–コレクション内部で検索される項目。TypeArgumentで宣言されたものと同じタイプでなければならない。

Result–ブーリアン変数、または結果が保存されるファイルパス。

TypeArgument– リストの項目のdatatype。

システム.アクティビティExistsInCollection<>。

フローチャート活動

フローチャートは、非連続的なワークフローを追加するために使用される。定義によると、フローチャートアクティビティは、実行されるアクティビティのコレクションを含むアクティビティである。

フローチャートはシーケンスに似ているが、より簡単に扱えるのがデシジョンツリーである。シーケンスの中に複数の「if」文がある場合（特にネストされている場合）、アクティビティやデータの扱いが非常に難しくなることがある。フローチャートは、このような状況を簡単に処理し、ワークフローをよりユーザーフレンドリーでグラフィカルな方法で可視化することができます。

フローチャートにアクティビティを追加するには、フローチャートに「シーケンス」を追加し、その「シーケンス」の中にアクティビティを追加する方法がある。

プロパティ パラメータ

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

ValidateUnconnectedNodes–True の場合、フローチャートの実行フローに接続されていないノード内のワークフロー ロジックの検証を実行します。

System.Activityのフローチャート。

FlowDecision活動

このアクティビティは、変数の値に基づいて、含まれるアクティビティ間の実行を指示する。Ifアクティビティと同様に、ブーリアン条件に基づいて実行を分岐させる。

このアクティビティは、ブール値「True」または「False」で表される2つの可能なパスにフローをルーティングする役割を担っています。これは、2つの可能な分岐結果のみを持つIf文と非常によく似ている。

プロパティパラメータ

条件– バリデートされるVB式。

表示名– フローチャート内のアクティビティのタイトル。

FalseLabel–FlowDecisionノードの “False “出口に表示されるテキスト。

TrueLabel–FlowDecisionノードの “True “出口に表示されるテキスト。

システム.アクティビティフローの決定。

FlowStep活動

Coming soon – work in progress!

FlowSwitch<>アクティビティ

このアクティビティは、2つ以上の代替ブランチを持つマッチ基準に基づく条件ノード（FlowDecisionと同様）である。分岐が2つだけの場合は、FlowDecisionの方が良い選択である。また、Switchと似ているが、シーケンスではなくフローチャート上で動作するように設計されている。

ワークフローに複数のルートを作成する必要がある場合に有効です。

プロパティパラメータ

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

Expression– アクティビティで検証されるVB式です。

システム.アクティビティフロースイッチの

HandleScope<> アクティビティ

このActivityは、Microsoft Workflow Foundationからのベースラインであるため、System.Activityに存在し、リストされていますが、OpenFlow/ OpenRPAのコンテキストで使用されています。

このActivityの包括的な説明は、このテーマに関するマイクロソフトのウェブサイト（https://docs.microsoft.com/pt-br/dotnet/api/system.activities.statements.handlescope-1?view=netframework-4.8）をご覧ください。

アクティビティーの場合

progの条件文に似ている。節条件が Trueの場合、Thenブロックのアクティビティを実行します。もしFalseなら、Elseブロックを実行する。

プロパティパラメータ

Condition– これは、句の条件を表すVB Expressionである。

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

システム.アクティビティ場合。

InvokeMethod アクティビティ

このActivityは、オブジェクトに定義されたパブリックメソッドを変数内部で呼び出すことができるものです。

実用的には、値を返さない式を呼び出したり、OpenRPA内部にActivityとして存在しないメソッドを実行するための方法です。また、値を返すメソッドにしか使えないAssignアクティビティの代替と見なされています。

ユーザーはまず、MethodNameパラメータで呼び出されるメソッドを指定する必要があります。

もしユーザが非静的メソッドを呼び出したい場合は、TargetObjectフィールド内にメソッドが実行されるオブジェクトを代入する必要があります。TargetObjectと TargetTypeは相互に排他的であることをユーザーに思い出させるのに便利です。

静的メソッドを呼び出したい場合は、TargetTypeフィールドにメソッドが実行されるクラスタイプを指定する必要があります。

もしユーザがジェネリックメソッドを呼び出したい場合は、GenericTypeArgumentsフィールドにジェネリックタイプを指定する必要があります。これについては、`Generic Methods (C# Programming Guide)`_(https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/generics/generic-methods)を参照してください。

また、Resultパラメータには、メソッド呼び出しの結果を保存する変数をユーザーが指定することができる。

また、ユーザーはRunAsynchronouslyチェックボックスをチェックすることで、メソッドを非同期で実行するかどうかを指定することができます。

InvokeCodeを使用すると、インテリセンスによる自動補完やその他の機能があるため、より良い選択肢であることに注意してください。

プロパティパラメータ

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

GenericTypeArguments–ジェネリックメソッドを呼び出す際に、ユーザーがジェネリック 引数を渡すことを可能にする。

MethodName– 呼び出されるメソッドの名前です。

パラメータ– メソッドに必要なパラメータ。

Result– 結果を格納する変数または引数ファイルのパス。データ型は、メソッドから期待される結果と一致している必要があります。

RunAsynchronously–Trueに設定すると、ロボットはワークフローと並行してこのメソッドを実行します（つまり、他のアクティビティに移る前にメソッドが完了するのを待つことはありません）。

TargetObject– メソッドが実行されるオブジェクト。TargetTypeと相互排他的です。

TargetType– メソッドが実行されるクラスタイプ。TargetObjectと排他的です。

NoPersistScope 活動

このActivityは、Microsoft Workflow Foundationからのベースラインであるため、System.Activityに存在し、リストされていますが、OpenFlow/ OpenRPAのコンテキストで使用されています。

このActivityの包括的な説明は、このテーマに関するマイクロソフトのウェブサイト（https://docs.microsoft.com/en-us/dotnet/api/system.activities.statements.nopersistscope?view=netframework-4.8）をご覧ください。

パラレル・アクティビティ

OpenRPAが複数のSequenceを同時に実行できるようにするActivityです。

Parallelの中にSequence Activityを追加し、このSequenceの中にActivityを追加する必要があることに注意してください。

このアクティビティは、その中の複数のシーケンスがUIで動作している場合、異なるアクティビティ間の競合を引き起こす可能性があるため、推奨されません。これは、異なるSequenceが同時に同じアプリケーションにアクセスする場合や、マウスやキーボードを使用する場合にも当てはまります。

プロパティ パラメータ

CompletionCondition– ブール値。Falseに設定された場合、ロボットは次のアクティビティに進む前に、並行しているすべてのSequenceが終了するのを待ちます。そうでない場合、ロボットは、1つのSequenceが終了すると、次のアクティビティに進みます。

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

システム.アクティビティパラレル。

パーシスト活動

このアクティビティは、すべての変数と状態をXMLファイルに保存し、OpenRPAが「アイドル」状態になった最後のアクティビティからワークフローを継続できるようにします。

重要なことは、ワークフローがシリアライズ可能な変数を持っている場合のみ、この処理を行うことができるということです。例えば、DataTablesはシリアライズ可能ではありません。したがって、変数のシリアライズ時に何らかのエラーが発生した場合（つまり、ワークフローがDataTablesを持つ場合）、状態は全く持続されない。

プロパティ パラメータ

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

System.Activityの永続性。

ピック活動

このアクティビティでは、ユーザーがワークフローの実行を分岐させ、最初にトリガーされた分岐を進めることができます。

各ブランチには、TriggerフィールドとActionフィールドがあります。トリガーは、Detectorのようなイベントドリブンなアクティビティと連動するように設計されています。Detectorがトリガーされると、ActionフィールドにあるActivityが実行されます。

トリガーフィールドに何も入力されていない場合、両方のブランチが実行され、最初のブランチが完了すると、ロボットはピックアクティビティを終了します。実用的には、このアクティビティの使い方は「並列アクティビティ」と非常に似ていますが、次に進む前にすべてのブランチが完了するのを待たないという点が異なります。

プロパティパラメータ

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

システム.アクティビティピックの

RemoveFromCollection<> アクティビティ

このアクティビティは、コレクションから1つのアイテムを削除します。

コレクションはリストと似ていますが、リストが新しい項目を受け入れないのに対して、コレクションは新しい項目を受け入れないという点を覚えておいてください。このテーマに関する包括的な説明は、Microsoftの.NET公式Webページ(https://docs.microsoft.com/pt-br/dotnet/visual-basic/programming-guide/concepts/collections)を参照してください。

プロパティパラメータ

Collection– 一致する要素が存在するかどうかをチェックするコレクションの名前。これは、変数または引数として最初に宣言されている必要があり、引数タイプはSystem.Collections.Generic.List<T> です。ここで、Tは、AddToCollection<>アクティビティセクションの画像に見られるように、コレクション内に含まれるオブジェクトのデータ型に対応しています。

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

Item– 削除される項目。TypeArgumentで宣言されたものと同じ型でなければならない。

Result– 結果を格納する変数または引数ファイルのパス。これは、”Boolean “タイプでなければなりません。

TypeArgument– リストの項目のデータの型。

System.ActivitiesRemoveFromCollection<>の略。

Rethrow活動

このActivityは、Throwブロックと同じコンテキストで、Catchブロックの内部で使用する必要があります。違いは、このアクティビティはTryブロックで投げた例外と同じ例外をCatchブロックで再度投げることです。

プロパティパラメータ

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

システム.アクティビティ再投入を

シーケンス活動

このアクティビティは、メインシーケンスにシーケンスをネストさせるために使用される。メインシーケンスと同じように、この中にアクティビティをドロップすることができます。展開したり折りたたんだりできるので、コードやワークフローを整理するのに便利です。

プロパティパラメータ

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

システム.アクティビティ シーケンス.の

国家活動

ステートマシンを構成する基本単位で、特定の時間に1つの状態にしかならない。

各状態には、Entry Action（状態に入るときに実行されるアクティビティ）とExit Action（状態を抜けるときに実行されるアクティビティ）が存在することになります。OpenRPAでは、ユーザーは各状態をダブルクリックして、その状態の入口と出口で実行されるアクティビティを編集することができます。

それ以外に、ステート間の遷移を編集することも必要です。新しいStateを追加して最初のStateに接続すると、両者の接続線に「T」と数字が付いた円が表示されます（例：最初の遷移はT1、2番目はT2、などなど）。この円をダブルクリックすると、StateMachineがこれらの異なる状態間をどのように遷移するかを、評価およびチェックされるConditionとして VB 式を 挿入して編集できます。

Transitionの設定では、あるConditionを満たした場合に実行するActivityと、そのConditionをチェックした場合に実行するActivityを追加することができます（Triggerフィールドで）。つまり、ロボットは実行可能な全てのトランジションをチェックし、トリガー内のアクティビティを実行し、コンディションを満たしたものだけに順次進んでいく。なお、「条件」は「状態」ではなく「遷移」の中にあるので、「条件」を満たさない場合でも「トリガー」は実行される。

StateとStateMachineに関する包括的な説明は、マイクロソフトの公式サイト（https://docs.microsoft.com/pt-br/dotnet/framework/windows-workflow-foundation/state-machine-workflows）を参照してください。

プロパティパラメータ

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

System.Activityの状態。

StateMachine 活動

ステートマシンはイベント駆動型のワークフローであり、「シーケンス」や「フローチャート」とは異なるタイプのワークフローを構成する。ワークフローが完了したときに到達する初期状態と最終状態は、少なくとも1つだけ存在することができる。ステートマシンは、特定の時間に1つの状態であることができるだけです。

プロパティパラメータ

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

StateとStateMachineに関する包括的な説明は、マイクロソフトの公式サイト（https://docs.microsoft.com/pt-br/dotnet/framework/windows-workflow-foundation/state-machine-workflows）を参照してください。

システム.アクティビティStateMachineの

スイッチ<>アクティビティ

このアクティビティは、ケース内のキーに対して式を評価し、一致したケースに関連するアクティビティを実行します。

このアクティビティをデザイナーにドラッグすると、ダイアログウィンドウが表示され、ユーザーは式のデータ型を選択することができます。その後、式が評価されるたびに実行される「デフォルト」ブロックと、新しいケースを追加するオプションが表示されます。それぞれのケースには、キー（式に対してテストされる値）と新しいアクティビティをドロップするためのブロックが含まれます。ロボットはすべての値を「式」に対してテストし、そのうちの1つが一致すれば、関連するアクティビティが実行されます。

プロパティパラメータ

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

Expression– ケース内のキーのテスト対象となる式。

システム.アクティビティ スイッチ<>。

TerminateWorkflow 活動

ワークフローの実行を終了させるアクティビティ。一度終了したワークフローは、再開することができない。

プロパティパラメータ

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

Exception– ワークフローが終了するときにスローされる例外。対応するデータ型（System.Exception）で既に宣言された変数または引数でなければなりません。

Reason– ワークフローが終了した理由を説明する文字列。

System.Activities TerminateWorflow （システムアクティビティターミネイトワーフロー

投擲活動

このアクティビティは、特定のケースでワークフローの実行を終了させ、エラーメッセージを表示するメソッドを提供します。プログラミングでは、「例外を投げる」と呼ばれます。Exception欄に例外を入力し、newと入力すると、利用可能な例外が表示されます。

プロパティパラメータ

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

Exception– エラーメッセージに表示される例外です。

システム.アクティビティスローの

TransactionScope アクティビティ

このActivityは、Microsoft Workflow Foundationからのベースラインであるため、System.Activityに存在し、リストされていますが、OpenFlow/ OpenRPAのコンテキストで使用されています。

このActivityの包括的な説明は、このテーマに関するマイクロソフトのウェブサイト（https://docs.microsoft.com/pt-br/dotnet/api/system.transactions.transactionscope?view=netcore-3.1）をご覧ください。

TryCatch 活動

Tryブロック内の一連のアクティビティを実行しようとします。その中でエラーが発生した場合、エラーがキャッチされ、Catchesブロック内のアクティビティが実行されます。実行の最後には、Finallyブロックが実行されます。

プロパティパラメータ

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

システム.アクティビティ TryCatch.。

活動中

このActivityは、条件が満たされていない間（つまりFalseの間）、その中にドロップされた他のActivityを実行するループを作成する。条件が満たされる、つまりTrueになると、ループは終了し、次のActivityに移行する。ループを開始する前に、まず条件がTrueに評価されるかどうかをチェックするDo WhileActivityとは異なる。

プロパティパラメータ

Condition– これは条件を表すVB Expressionです。

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

システム.アクティビティ.While.の

WriteLine 活動

このActivityは、Text文字列に従って、コンソールに出力を書き込む。

プロパティパラメータ

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

Text– コンソールに表示される文字列．

TextWriter–オプション– 文字ストリームの書き込みに使用されるライターです。

TextWriterクラスは抽象クラスです。したがって、ユーザーはコード内でこれをインスタンス化するべきではありません。StreamWriterクラスはTextWriterから派生したクラスで、ストリームに書き込むためのメンバの実装を提供します。以下の例では、WriteLineAsync(String)メソッドを使用して、文字列値からなる2行をテキストファイルに書き込む方法を示します¹。

¹ – `TextWriter クラス <https://docs.microsoft.com/en-us/dotnet/api/system.io.textwriter?view=netcore-3.1>`_ (“https://docs.microsoft.com/en-us/dotnet/api/system.io.textwriter?view=netcore-3.1“)

システム.アクティビティ.ライン.を書く

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

FinalState 活動

FinalStateはStateMachineの出力で、一度だけ存在することができます。これは別のタイプのステートと考えることができるが、エンドノードであり遷移を必要としないため、Exit Actionを持たないステートである。ロボットがこのステートに入ったときに実行されるアクティビティやシーケンスなど、Entry Actionのみを受け入れることができる。

1つのStateMachineに複数のFinalStateノードが存在することが可能です。

プロパティパラメータ

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

FinalState（ファイナルステート

ForEachWithBodyFactory<> アクティビティ

このアクティビティは、オブジェクトを反復処理し、「Body」フィールドにあるアクティビティまたはシーケンスを実行する。列挙子やリストになるものはすべて、このActivityで反復処理することができる。ただし、DataTableで使用することは推奨しない。

プロパティパラメータ

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

TypeArgument– オブジェクト内のアイテムのデータ型。

Values– 反復処理されるオブジェクト．これは，あらかじめ宣言された変数や引数，あるいは強く型付けされたデータです．

ForEachWithBodyFactory<>の場合。

ParallelForEachWithBodyFactory<> アクティビティ

このActivityはForEachWithBodyFactoryと非常に似ているが、その中のアクティビティをイテレーションごとに非同期で実行することができる点が異なる。つまり、アクティビティは別々のスレッドで実行されないので、連続する各アクティビティは、前にスケジュールされたアクティビティが完了するか、アイドル状態になったときにのみ実行される。このアクティビティの実行フロー内のどのアクティビティも非同期でないか、アイドル状態にならない場合、このアクティビティは、ForEachWithBodyFactoryアクティビティと同じ方法で実行される。

Parallelに存在するCompletionConditionパラメータは、ロボットが次のActivityに移る前にすべての反復が完了するのを待つべきか、あるいは最初に成功した反復の後に進むべきかを定義します。

プロパティ パラメータ

CompletionCondition– ブール値。falseに設定された場合、ロボットは次のアクティビティに進む前に、すべてのイテレーションが終了するのを待ちます。そうでなければ、ロボットは最初の反復が終了した時点で、次のアクティビティに進みます。

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

TypeArgument– オブジェクトのアイテムのデータ型。

`Values– 反復処理されるオブジェクト．これは，あらかじめ宣言された変数や引数，あるいは強く型付けされたデータである場合があります．

PickWithTwoBranchesFactory 活動

これは、すでに2つのブランチを持つPickActivityのテンプレートです。ユーザーはこれらのブランチをコピー＆ペーストして、ブランチの数を増やすことができます。

ピック活動の詳細については、「ピック」をご参照ください。

プロパティパラメータ

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

System.ActivitiesPickWithTwoBranchesFactory（ピックウィズツーブランチファクトリー

ReceiveAndSendReplyFactory Activity

このActivityは、Microsoft Workflow Foundationからのベースラインであるため、System.Activityに存在し、リストされていますが、OpenFlow/ OpenRPAのコンテキストで使用されています。

このActivityの包括的な説明は、このテーマに関するマイクロソフトのウェブサイト（https://docs.microsoft.com/en-us/visualstudio/workflow-designer/receiveandsendreply-template-designer?view=vs-2019）をご覧ください。

SendAndReceiveReplyFactory Activity

このActivityは、Microsoft Workflow Foundationからのベースラインであるため、System.Activityに存在し、リストされていますが、OpenFlow/ OpenRPAのコンテキストで使用されています。

このActivityの包括的な説明は、このテーマに関するマイクロソフトのウェブサイト（https://docs.microsoft.com/en-us/visualstudio/workflow-designer/sendandreceivereply-template-designer?view=vs-2019）をご覧ください。

ここでは、OpenRPA.Databaseのツールボックス内にあるアクティビティを紹介します。

データベースの範囲

接続を開き、その範囲内のすべてのアクティビティが終了したら接続を終了することによって、データの照会、挿入、更新、削除に使用されるデータベースを選択します。詳細な例は、OpenRPA.Database Activities, DataTable, DataViewのセクションに記載されています。

プロパティパラメータ

ConnectionString– データベースへの接続に使用されるConnectionString(https://docs.microsoft.com/en-us/dotnet/api/system.data.sqlclient.sqlconnection.connectionstring?view=dotnet-plat-ext-3.1) です。例としては、「Server=localhost;Port=3306;Database=using_datatables;Uid=root;Pwd='life is fine 9#';」となります。

DataProvider– 指定されたデータベースで使用されるプロバイダ。MySQLのデフォルトは"MySql.Data.MySqlClient" です。

DataSource– データを収集するために使用されるデータベース スキーマの名前です。

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

Timeout– 接続が完了するまでの待ち時間。この時間まで接続が完了しない場合、アクティビティは外部シーケンス内の他を通過していきます。 単純な00:00:00.00 {hh:min:ss.mili}またはTimeSpanクラスのオブジェクトにすることができます。

OpenRPA.Databaseデータベースの範囲.。

非クエリーの実行

INSERT、UPDATE、DELETEステートメントに有用な、結果を返さないクエリを実行します。Resultの値は、このコマンドによって影響を受けた行の数である。影響を受ける行がない場合は、0を返します。

プロパティ パラメータ

Query– 実行されるクエリ。

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

CommandType– デフォルトはTextに設定されており、Queryフィールドの中のコマンドが実行されることを意味します。StoredProcedureに設定すると、Query内のテキストはストアドプロシージャの名前である必要があります。TableDirectに設定すると、Execute メソッドを呼び出したときに、指定したテーブルのすべての行と列が返されます。

Result– 実行されたクエリの出力（Int32）。

OpenRPA.Databaseの非クエリ実行.。

クエリーの実行

クエリを実行し、その結果をDataTableとして返します。SELECTステートメントと一緒に使うと便利です。

プロパティパラメータ

Query– 実行されるクエリ。

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

CommandType– デフォルトはTextに設定されており、これはQueryフィールド内のコマンドが実行されることを意味します。StoredProcedureに設定すると、Query内のテキストはストアドプロシージャの名前である必要があります。TableDirectに設定すると、Execute メソッドを呼び出したときに、指定したテーブルのすべての行と列が返されます。

DataTable– クエリの結果を保存するDataTableオブジェクト。

OpenRPA.Databaseの実行クエリ.。

スカラ<>を実行する

集約関数など、ちょうど1つの結果を返すクエリを実行します。SUM、AVG、MAX、MIN、COUNT などの集約関数のように、ちょうど1つの結果を返すクエリを実行します。

プロパティパラメータ

Query– 実行されるクエリ。

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

ArgumentType– 返される結果のタイプ。

CommandType– デフォルトはTextに設定されており、これはQueryフィールド内のコマンドが実行されることを意味します。StoredProcedureに設定すると、Query内のテキストはストアドプロシージャの名前である必要があります。TableDirectに設定すると、Execute メソッドを呼び出したときに、指定したテーブルのすべての行と列が返されます。

Result– 実行されたクエリの結果出力。- は、ArgumentType のように型が定義されている。

OpenRPA.Databaseの実行スカラー<>.。

DataTableからの更新

指定されたDataTableに含まれるデータをSQL テーブルに 追加します。

SELECT * from ${TABLE} ;"ステートメントを使用して、クエリー実行アクティビティでデータテーブルを選択する必要があります。次に、AddDataRowアクティビティで行を追加してデータを変更し、最後に上記の方法で更新することができます。

ヘッダーとコンテンツはSQL テーブルのものと一致させなければならないことをユーザーに伝えることが重要である。

物件紹介

更新 したい データの あるDataTable– 自明です 。

TableName– 行を挿入するテーブル．

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

結果– 影響を受ける行の数。

OpenRPA.DataTable.Baseからのデータベース更新。

ここでは、OpenRPA.ElisRossumツールボックス内のアクティビティについて説明します。

認証活動

Rossum の認証情報を使ってRossum Platform(https://rossum.ai/) にユーザーを認証し、返されたJWT トークンを変数に保存します。ユーザーは、最初にアカウントを設定する必要があります。

プロパティボックス内のResultパラメータに希望する変数名を入力した後、Ctrl+Kで変数を作成する必要があります。この変数には、返されたJWT トークンの内容が格納され、後述するアクティビティで請求処理を行う際に利用することができます。

Rossum Platformの詳細については、Rossum – FAQ｜ヘルプセンター（https://rossum.ai/help/article/quick-start-guide/）のクイックスタートガイドを参照してください。

プロパティパラメータ

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

パスワード–Rossumの資格情報のパスワード。

Result–JWT トークンが保存される変数。

Username–Rossumのクレデンシャル用のユーザー名。

OpenRPA.ElisRossum Auth.

このプラットフォームは、この種のデータに対して一般的なOCRよりも推奨される方法であるコグニティブ・データ・キャプチャを通じて請求書抽出サービスを提供します。詳しくは、Rossum – FAQ｜ヘルプセンター（https://rossum.ai/help/faq/）をご覧ください。

ファイルデータの書き出し

このアクティビティは、Rossum Platformアノテーション（https://api.elis.rossum.ai/docs/#annotation）から取得したデータを、OpenRPA.ElisRossum.ExportResult型の変数にエクスポートします。さらに、このオブジェクトは、ユーザーがそれを繰り返し、次のデータ型を消費することができます：invoice_id、date_issue、date_due、sender_ic、recipient_ic、amount_total_base、amount_total_tax.

ユーザーは、Auth Activityから返されたJWT トークンをあらかじめ変数に保存しておく必要があり、Keyパラメータに挿入されます。

また、ユーザーは事前にGet Queueアクティビティを使用して、Rossum Platformキューを変数に初期化しておく必要があります。

Rossum Platformアノテーションのデータ取得に使用するFileurl変数は、Resultfrom anUpload Fileアクティビティとして初期化されている必要があります。

プロパティボックスの ResultパラメータにExportResult変数の名前を入力した後、Ctrl+Kで変数を作成する必要があります。この変数には、指定されたFileurlを使用して取得したRossum Platformアノテーションの現在のデータが格納されます。

プロパティボックス

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

Fileurl–Upload Fileアクティビティで取得したRossum Platformアノテーションの URLです。

Key–Auth Activityから返されたJWT トークン。

Queue–Get Queueアクティビティで取得した変数から返される、インデックス付きキューのURL 属性です – 例.qs(0).url.

Result– 取得したデータの保存先となる変数。

OpenRPA.ElisRossum エクスポートファイルのデータです。

ファイルステータスの取得

Rossum Platform アノテーション（https://api.elis.rossum.ai/docs/#annotation）のステータスを収集し、変数に保存します。

ユーザーは、Auth Activityから返されたJWT トークンをあらかじめ変数に保存しておく必要があり、Keyパラメータに挿入されます。

また、ユーザーは事前にGet Queueアクティビティを使用して、Rossum Platformキューを変数に初期化しておく必要があります。

Rossum Platformアノテーションのステータスデータを収集するために使用されるFileurl変数は、Resultfrom anUpload Fileアクティビティとして初期化されている必要があります。

可能なファイルステータスの詳細については、Rossum Platform Annotation Lifecycle(https://api.elis.rossum.ai/docs/#annotation-lifecycle)を参照してください。

プロパティパラメータ

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

Fileurl–Upload Fileアクティビティで取得したRossum Platformアノテーションの URLです。

Key–Auth Activityから返されたJWT トークン。

Result– アクティビティによって返されるステータス。詳細については、Rossum Platform Annotation Lifecycle(https://api.elis.rossum.ai/docs/#annotation-lifecycle)を参照してください。

OpenRPA.ElisRossum ファイルの状態を取得します。

キューを取得する

Auth Acivityで提供されるRossum 認証情報に対して、与えられたアカウント内に含まれるすべてのキューを取得し、変数に保存します。

ユーザーは、Auth Activityから返されたJWT トークンをあらかじめ変数に保存しておく必要があり、Keyパラメータに挿入されます。

Rossum Platformでは、キューは、ユーザーが処理したい文書をインポートするためのスペースです。各キューは、通常、処理する必要がある特定の文書の種類を表す組織単位です。Rossum プラットフォームのキューを作成する方法はRossum で新しいキューを作成する – FAQ | ヘルプセンター(https://rossum.ai/help/article/creating-a-new-queue/)でご覧いただけます。

プロパティボックスの Resultsパラメータに希望の変数名を入力した後、Ctrl+Kを押して変数を作成する必要があります。この変数は、Rossumプラットフォームから返される“Queue[]“ を含むJSON オブジェクトの内容を保持します。

プロパティパラメータ

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

Key–Auth Activityから返されたJWT トークン。

Results–Queues[] の内容を保持する変数．

ファイルのアップロード

Get Queueアクティビティによって返されたキューの1つにファイルをアップロードし、Rossum Platformアノテーションのために結果のURLを保存します(https://api.elis.rossum.ai/docs/#annotation)。

ユーザーは、Auth Activityから返されたJWT トークンをあらかじめ変数に保存しておく必要があり、Keyパラメータに挿入されます。

また、ユーザーは事前にGet Queueアクティビティを使用して、Rossum Platformキューを変数に初期化しておく必要があります。

ユーザーは、プロパティ・ボックス内のファイル名パラメータに ファイルの 絶対パスを指定する必要があります。このファイルは必ずPDFファイル形式でなければならず、そうでない場合、アクティビティはエラーを返します。また、引用符で囲む必要があります。

プロパティボックスの Resultパラメータに希望の変数名を入力した後、Ctrl+Kで変数を作成する必要があります。この変数には、`Rossum Platform annotation’のURL`の内容が格納されます。

プロパティパラメータ

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

Filename– アップロードされるファイルの絶対的な ファイルパス。

Key–Auth Activityから返されたJWT トークン。

Queue–Get Queueアクティビティで取得した変数から返される、インデックス付きキューのURL 属性です – 例.qs(0).url.

Result– アップロードされたドキュメントのURLが保存される変数です。

ファイルの状態を待つ

Rossum Platform のアノテーション（https://api.elis.rossum.ai/docs/#annotation）の状態がユーザーから提供されたものと同じになるまで、ワークフローの状態をアイドルに設定します。

ユーザーは、Auth Activityから返されたJWT トークンをあらかじめ変数に保存しておく必要があり、Keyパラメータに挿入されます。

Rossum Platformアノテーションのステータスデータと一致させるために使用されるFileurl変数は、Resultfrom anUpload Fileアクティビティとして初期化されている必要があります。

プロパティボックスの Resultパラメータに希望の変数名を入力した後、Ctrl+Kを押して変数を作成する必要があります。この変数は、指定されたFileurlを使用して取得したRossum Platformアノテーションの現在のステータスを保持します。

可能なファイルステータスの詳細については、Rossum Platform Annotation Lifecycle(https://api.elis.rossum.ai/docs/#annotation-lifecycle)を参照してください。

プロパティボックス

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

Fileurl–Upload Fileアクティビティで取得したRossum Platformアノテーションの URLです。

Key–Auth Activityから返されたJWT トークン。

Result–Rossum Platform Annotation Statusが保存される変数。

ステータス– ファイルの現在のステータスが照合されるステータス。可能なファイルのステータスの詳細については、Rossum Platform Annotation Lifecycle(https://api.elis.rossum.ai/docs/#annotation-lifecycle)を参照してください。

Timeout–Rossum PlatformのファイルのステータスがStatusパラメータで提供されたステータスと 一致するかどうかをチェックするのをやめるまで、ワークフローが待機する時間間隔です。単純な00:00:00.00 {hh:min:ss.mili}またはTimeSpanクラスからのオブジェクトを指定することができます。

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

起動フォーム

ForgeForms 言語(https://wpf-forge.github.io/Forge.Forms/guides/getting-started.html) を使用した静的フォームを作成することができます。SimpleFormとImageFormのサンプルは、Activity ツールボックスの隣のSnippets ツールボックスに表示されます。これは、ワークフローがビジネスロジックを実行する前にユーザーから入力を収集する必要がある場合に非常に便利です。ユーザーは、「Open Designer」ボタンをクリックすることで、フォームをセットアップし、プレビューすることができます。作成後、ユーザーは「Create variables」ボタンをクリックするだけで、そのフォームで使用される変数を作成できます。OpenRPA Formsのセクションに例があります。

プロパティパラメータ

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

Form– 作成されるフォームを含む文字列。

Result–FormResult変数を作成し、フォームによって作成されたDOMオブジェクトを保持します。作成された DOM オブジェクト内の値にアクセスするには、ユーザーは単にModel.Values(i).ToStringを使ってi 番目の入力変数にアクセスすることができます。

お知らせを表示する

画面右下に一定時間、通知を表示します。

プロパティパラメータ

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

メッセージ– 表示されるメッセージです。

NotificationType– 異なる通知タイプ。情報、エラーまたは警告。

OpenRPA.Forms 通知を表示する。

OpenRPA.IEのツールボックスの中にあるアクティビティは以下の通りです。

エレメントを取得

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

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

このアクティビティは、GetElementsのネストもサポートしています。それについてもっと知るために、複数の要素を返すセクションを参照してください。

プロパティ パラメータ

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

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

From– IEElementのインスタンスの中で見つかった要素内のみを検索できるようにします。

LoopAction– 選択されたアクティビティを何かが見つかるまでループします。

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

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

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

タイムアウト– 要素の検索に成功しなかった場合、アクティビティが停止する時間。

Wait for ready– trueの場合、ページが完全に読み込まれるまで待ちます。

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

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

URLを開く

現在選択されているInternetExplorer.ApplicationのインスタンスでURLを開きます。URLが設定されていない場合は、自動的に新しいInternetExplorerのインスタンスが起動されます。

プロパティパラメータ

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

FocusBrowser–Trueに設定すると、ブラウザで開かれたウィンドウにフォーカスを当てます。

Url– ブラウザが移動するURLです。

OpenRPA.IE オープンURL.。

OpenRPA.Imageのツールボックス内にあるアクティビティです。

カラーを取得する

Image.GetElementで指定された要素内の指定された座標のRGBAカラーを取得します。

プロパティパラメータ

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

要素– 色の取得元となる要素．

Result– 色を保存するための可変のファイルパスです。

X Offset– 色をキャプチャするための，要素内の水平オフセットです．単位はピクセルです．また，負の値も指定できます．

Y オフセット– 色をキャプチャするための要素内の垂直オフセット．単位はピクセルです。また、負の値も可能です。

OpenRPA.ImageGetColor.。

エレメントを取得

画面内または特定のアプリケーションウィンドウ内の画像を検索し、その画像からImageElementを作成します。画像選択ボタンでキャプチャしたい画像を選択するか、レコーダを使用します。

Recorderは、まず、Windowsアプリケーション、Javaアプリケーション、またはWeb要素のコントロールからElementを作成しようとします。そして、最後のリソースとして、Image.GetElementを利用して、録画中にドラッグした画像の中の最小のユニークイメージをキャプチャしてElementを作成します。

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

プロパティパラメータ

CompareGray–Trueに設定すると、グレースケールで画像を比較し、目的の要素を見つけます。このパラメータもパフォーマンスの節約になります。

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

要素– 画像の収集元となる要素。

From–ImageElementのインスタンスの中にあるElementの中だけを検索できるようにします。

Limit– Elementsの数を制限します。

LoopAction– 選択されたアクティビティを何かが見つかるまでループします。

MaxResults– 最大結果の数。

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

プロセス名– 要素のプロセスを特定のプロセス名に制限します。

しきい値– 一致する画像を見つけるために使用されるしきい値。

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

OpenRPA.画像取得要素.。

画像を取得する

Image.GetElementで見つけた他の画像またはElementからの相対的な画像をスクリーンから取得します。

まず、Image.Get Element ActivityでこのActivityが作用する画像を選択し、Select Imageボタンでキャプチャしたい画面内の相対的な領域を指定する必要があります。つまり、Image.Get Element Activityで選択した画像と、Get Imageの選択が一致する必要があります。

ハイライト]をクリックすると、選択されている画像のうち、相対する画像が緑色にハイライトされ、青色にハイライトされた状態で表示されます。セレクターが正しく設定されているかどうかを確認するのに便利です。

OpenRPA内部での画像処理については、「付録B –画像処理」をご覧ください。

プロパティパラメータ

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

Element– 画像の収集元となる要素。

高さ– キャプチャする画像の高さです。

OffsetX– 画像をキャプチャするための，要素内の水平方向のオフセットです．単位はピクセルです。また、負の値も可能です。

OffsetY– 画像をキャプチャする際の，画像内の垂直方向のオフセットです．単位はピクセルです。また、負の値も可能です。

Result– 画像Elementが保存されるファイルのパスを指定します。

幅– 取り込む画像の幅です。

OpenRPA.Image取得イメージ.。

テキストを取得

OCRを使用して画像からテキストを取得します。特定の単語や文に限定することができます。また、他の画像関連活動から収集したテキストを分割または制限するために使用することができます。

Limit toまたはWordLimitパラメータは、OCR 処理の出力を制限するために使用されます。これは、 テキストを取得の出力を、与えられた単語のセットに制限したい場合に便利です。OCR で作成されたテキストにアクセスするには、単にitem.Value変数 – または定義された要素の Valueプロパティにアクセスします。

プロパティパラメータ

CaseSensitive– 小文字と大文字を区別する。

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

Element– 画像の収集元となる要素。

Result– 収集されたImageElementが保存される可変長ファイルパス。

WordLimit– 収集する単語の最大数です。

OpenRPA.ImageGetText.を表示します。

ファイルから読み込む

ファイルから画像を読み込み、ImageElement として返す。

また、OCR画像認識を自動的に使用して、スクリーンショット内のテキストをキャプチャし、結果のImageElement.value属性の中に保存されます。使用できる拡張子は、gif, jpg, jpeg,png で、つまり画像の拡張子のみです。

プロパティパラメータ

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

Filename– 画像の取得に使われるファイルのファイル名．

Result–ImageElement を保存するための可変長ファイルパス。

備考

注：OCR 画像認識は、画像に対して自動的に行われます。ユーザーは、ImageElement.valueプロパティにアクセスすることで、結果のテキストにアクセスすることができます。

OpenRPA.Imageをファイルから読み込む。

スクリーンショットを撮る

画面全体またはImage.GetElementで指定された Element のスクリーンショットを取得し、ImageElement として返します。

このActivityには、2つの使用モードがあります。

最初の使用モードはセレクタレスです。このモードでは、Width、Height、オフセットが設定されていない場合、アクティビティは画面全体のスクリーンショットを撮影します。このモードを使用するには、アクティビティのElementプロパティ内の値を削除し（デフォルト値はitem）、必要に応じてXおよびYオフセット値を定義するだけです。

2つ目の使用モードはセレクタバインドです。このモードでは、Image Elementを選択すると、アクティビティはImage Elementの相対値を使用して、Xと Yのオフセット値を見つけます。このモードを使うには、ユーザーはTake Screenshotアクティビティを選択したElementにドラッグし、Width、Height、X,“Y“ のオフセット値を定義するだけです。

プロパティ パラメータ

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

要素– スクリーンショットのキャプチャ元となる要素の名前です。

Height– スクリーンショットの高さです。

結果– スクリーンショットを保存するための可変のファイルパスです。

Width– スクリーンショットの幅です。

X– スクリーンショットをキャプチャするための、画像内の水平オフセット。単位はピクセルです。また、負の値も可能です。

Y– スクリーンショットをキャプチャするための、画像内の垂直オフセットです。単位はピクセルです。また、負の値も可能です。

備考

注：OCR画像認識は、画像に対して自動的に行われ、結果のテキストには、結果のImage 要素の valueプロパティにアクセスすることでアクセスすることができます。

OpenRPA.イメージテイクスクリーンショット.。

Coming soon – Work in progress

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

タブを閉じる

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

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

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

プロパティパラメータ

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

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

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

スクリプトの実行

この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– 実行されるスクリプトです。

エレメントを取得

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

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

プロパティパラメータ

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

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

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

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

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

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

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

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

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

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です。

OpenRPA.NM オープンURL.。

OpenRPA.Officeのツールボックスの中にあるアクティビティは以下の通りです。

パラグラフィーの追加

Microsoft Word文書に新しい段落を追加し、位置Indexに挿入します。

プロパティパラメータ

ファイル名– 段落が追加されるMicrosoft Word文書ファイルのパスのフルパスまたはファイル名です。

Index– 段落が追加されるインデックスファイルのパスです。したがって、もしユーザーが、その後に段落を含む位置で追加した場合、新しい段落はその間に追加されます。

テキスト– 追加されるテキスト、すなわち段落。

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

OpenRPA.Officeパラグラフを追加する。

クリアレンジ

セルの範囲からすべてのデータと書式をクリアします。

プロパティパラメータ

セル– すべてのセルを消去する場合は、消去するセルの範囲を選択するか、または空白のままにします。

ファイル名– Microsoft Excelワークブックのフルパスまたはファイル名。

ワークシート– セルのクリアを行うワークシートの名前です。

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

ReadPassword– パスワードが必要な場合に Microsoft Excel ファイルを開く方法を提供する。パスワードは引用符で囲んでください。

Visible– Microsoft Excel のインターフェイスが実際に開きます。

WritePassword– パスワードが必要な場合に、Microsoft Excelファイルを保存する方法を提供します。パスワードは引用符で囲んでください。

ワークブック– 読み込まれるワークブックを選択する方法を提供します。

OpenRPA.Officeのクリアレンジ。

ドキュメントを閉じる

Microsoft Wordの文書を閉じます。また、他のドキュメントが開いていない場合は、Microsoft Wordアプリケーション自体も閉じます。このアクティビティはOpenRPA.Close Applicationと非常によく似た動作をしますが、ここでの唯一の違いは、Wordドキュメントを閉じるときにデフォルトで保存することです。

プロパティパラメータ

ファイル名– 閉じられるMicrosoft Wordドキュメントのフルパスまたはファイル名です。

変更を保存する – Word文書を閉じるときに、変更を保存するかどうかを指定します。デフォルトはTrueです。

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

OpenRPA.Officeのクローズドキュメント。

ワークブックを閉じる

開いているMicrosoft Excelのワークブックを閉じます。他に開いているワークブックがない場合は、Microsoft Wordも閉じます。このアクティビティはOpenRPA.Close Applicationと非常によく似た動作をしますが、唯一の違いは、Excelドキュメントを閉じるときにデフォルトで保存することです。

プロパティパラメータ

ファイル名– 閉じられるMicrosoft Excelワークブックのフルパスまたはファイル名です。

Save Changes– Excelワークブックを閉じるときに、変更を保存するかどうかを指定します。デフォルトはTrueです。

Workbook– すでに開いているWorkbookの 変数名を渡すこともできます。

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

OpenRPA.Officeを閉じるワークブック。

メール取得

Microsoft Outlook フォルダからすべての電子メールを取得し、item変数に自動的に保存します。その後、ユーザーは、選択したフォルダー内のすべての電子メールをループするか、Emailsフィールドに挿入してIEnumerable<email>型の変数に保存するかを選択することができます。

また、DASL クエリを使用して、収集した電子メールをフィルタリングすることもできます。例えば、"@SQL=urn:schemas:httpmail:subject LIKE '%${SUBJECT}%'"というクエリは、件名に${SUBJECT} で渡したパラメータを含むすべてのメールにフィルタをかけることができるのです。

ここで、${FOLDERPATH}は添付ファイルを保存するフォルダファイルのパスを含むString変数、${OVERWRITE}はファイルを上書きするかどうかを指定するBoolean値で、Trueに設定すると上書きは行われません。

プロパティパラメータ

Filter– 指定した文字列を含むメールのみを取得するためのフィルタを渡すことができます。

フォルダ– 電子メールが収集されるフォルダです。

MaxResults– 取得するメールの最大件数を指定します。

UnreadOnly–Trueに設定すると、未読のEメールのみを取得します。それ以外の場合は、すべての既読および未読の電子メールを取得します。

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

Emails– 取得したすべてのメールを含むIEnumerable<email>型の変数に保存されます。

OpenRPA.OfficeのGet Mails。

パラグラフを取得

Microsoft Word文書から、インデックス1から始まる1つまたは複数の段落を取得します。ユーザーは最初に取得したテキストが保存される可変ファイル パスをTextパラメータに設定する必要があります。ユーザーがインデックスを設定しない場合、活動はWord文書内のすべてのテキストをキャプチャします。必要であれば、キャプチャされる段落の量を制限するために、最大 結果パラメータで結果の最大数を設定し、カウントパラメータでWord文書に含まれる段落の数を保持するために変数を設定することも可能です。また、Word文書に加えた変更を有効にするには、［段落の設定］アクティビティを使用して保存する必要があります。

プロパティパラメータ

ファイル名– 段落を取得するMicrosoft Wordドキュメントのフルパスとファイル名です。

インデックス– 収集される段落の開始インデックスです。Word文書内のテキスト全体を収集する場合は、このフィールドを空白にします。

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

最大 結果– 取得する段落の数を制限します。空白にすると、インデックス以降のすべてを取得します。

Count– ドキュメント内の段落の総数を返します。

Text– この変数に結果テキストを保存します。

OpenRPA.OfficeのGetParagraph。

選択した範囲を取得する

Microsoft Excel アプリケーションの Windows UI 内で、Excel ワークシート内で選択されている範囲のセルインデックスを取得します。...をクリックして、Excelワークシートを開くファイルを選択します。セルが選択されていない場合、デフォルトでC11セルを返します。

プロパティパラメータ

ColumnAbsolute–Trueに設定すると、列の絶対インデックスを返します。文字の前に$を付ける必要があります。例えば、$Aは最初の列を返します。

External–Falseに設定すると、ワークブックとワークシートの参照を含めずに、ローカルな参照を返します。

ファイル名– Microsoft Excel Workbookのフルパスまたはファイル名です。

RowAbsolute–Trueに設定すると、その行の絶対インデックスを返します。数値の前に$ を付ける必要があります。例えば、$9とすると行番号 9 を返します。

Worksheet– セルが選択されるワークシートの文字列。

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

ReadPassword– ファイルの読み取りに使用されるパスワード。

Visible–Trueに設定すると、Excelワークシートが目に見える形で開かれ、アクティビティが実行されます。

WritePassword– ファイルの書き込みに使用されるパスワード。

範囲– 選択された範囲が保存される可変ファイルパス。

ワークブック– ユーザーは、ファイル名の代わりに、既に開いているワークブックを使用することもできます。

OpenRPA.Office 選択されたレンジを取得する。

MailItemを移動する

Get MailsActivityで取り込んだメールを、ドロップダウンで選択したフォルダに移動します。

まず、ドロップダウンでフォルダを選択し、次にメール入力フィールドに移動するメールオブジェクトを入力します。このメールオブジェクトは、Get MailsActivityのIEnumerable<email>変数からインデックスが作成されます。

プロパティパラメータ

フォルダ–電子メールが移動されるフォルダファイルのパスです。

Mail– 移動されるOutlook内の電子メールに対応する電子メールオブジェクト。

OpenRPA.Office MoveMailItem。

新規MailItem

新しい電子メールアイテムを作成し、目的の電子メール 連絡先に送信するか、新しいOutlookメッセージボックスを開き、その中で他のアクティビティを実行するようユーザーに促します。後者のオプションを選択した場合、ユーザーが変更を保存するよう求められたときに[はい]をクリックすると、Outlookは新しい下書きを作成するか、単に電子メールメッセージ全体を破棄します。

また、添付ファイルのパスを含む文字列 リスト変数を指定することで、添付ファイルを送信することができます。ユーザーは、HTMLBodyパラメータで添付ファイルを使用することにより、添付ファイル、すなわちメディアを消費することもできます。

プロパティパラメータ

Attachments– 添付ファイルのパスを含む文字列 リスト。例：{"C:/BPA/attachment1.pdf", "C:/BPA/attachment2.png"}.注：変数の型はString[]、すなわち文字列のリストとして設定する必要があります。

BCC–Blind Carbon Copy（ブラインド・ カーボン・ コピー）。あらかじめ定義された受信者にメールを送信し、他の受信者を見ることができないようにするものです。

本文–電子メールメッセージのテキスト本文。

CC–カーボン コピー。あらかじめ定義された受信者にメールを送信し、他の受信者を確認できるようにします。

HTMLBody–電子メールメッセージのHTML本文。

Subject–Eメールメッセージの件名。

To–電子メールメッセージの主な受信者。

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

UIAction– [送信]を選択した場合、すぐにメールが送信されます。そうでない場合は、Outlookメッセージボックスのプロンプトが表示されます。

Email– Activityの結果が保存されるメールオブジェクトのファイルパス。別のフォルダに送るなど、送信後のメッセージの操作に使用できます。

OpenRPA.Office 新しいMailItem。

リードセル

Microsoft Excelシートの1つのセルの内容を変数に読み込む。

プロパティパラメータ

セル– 読み込まれるセル、例えば"A8"。

ArgumentType– セルの内容が保存される変数ファイルパスのタイプ。

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

Filename– 読み込まれるファイルのファイル名．

Result– セルの結果の内容が保存される可変長のファイルパスです。

Workbook–Workbookオブジェクト全体が保存される可変のファイルパス。このActivityは特定のセルを読み取るにもかかわらず、Workbookも利用可能です。

ワークシート– データを収集するためのワークシートです。

数式– セル内の数式の内容を保存する変数ファイルのパスです。

Range– 読み込まれる範囲。

OpenRPA.Office Read Cell.の。

読み取り範囲

Microsoft Excelシートのセル範囲を読み取る。

プロパティパラメータ

セル– 読み込まれるセルは、コロンで区切ることができる。

Filename– 読み込まれるファイルのファイル名．

ワークシート– 読み込まれるExcelファイル内のシートです。

Clear Formats– セルの書式をクリアします。

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

IgnoreEmptyRows– 読み込まれるファイル内の空の行を無視します。行の番号付けが変更されることに注意してください。

ReadPassword– ファイルのパスワードを含む文字列（存在する場合）．

ヘッダー 行を使用– 選択されたセルの範囲からヘッダーを読み込みます。

Visible–OpenRPAは、WindowsのUIで実際にExcelファイルを開きます。

WritePassword– ファイルが読み込まれた後に書き込まれるパスワード．

DataTable– データが保存されるDataTableファイルのパス．

lastUsedColumn– 最後に使用されたカラムのインデックスを変数に保存する．

lastUsedRow– 最後に使用された行のインデックスを変数に保存する。

ワークブック–ワークブックを特定の変数に保存します。

OpenRPA.Officeの読み取り範囲。

Excelのマクロを実行する<>。

このアクティビティは、Microsoft Excelのマクロの実行を担当します。

このActivityが作成されると、「型の選択」というダイアログウィンドウが表示されます。このマクロを定義するVBA マクロ プロシージャが実際に何らかのデータを返す場合、ユーザーは戻り出力のデータ型を選択する必要があります。そうでなければ、ユーザーはこのパラメータをStringとして設定することができます。マクロとは何か、どのように使うかについては、「OfficeでVBAを始める」（https://docs.microsoft.com/en-us/office/vba/library-reference/concepts/getting-started-with-vba-in-office）のページを参照してください。VBA マクロ プロシージャがパラメータを受け取る必要がある場合、パラメータはParameters内でString 配列として宣言する必要があります (すなわち、{} で囲みます)。

Microsoft Excelが終了している場合、ワークフローがこのアクティビティに到達すると、Excelが開かれます。

プロパティパラメータ

名前– 実行されるマクロの名前。これはファイル名ではなく、選択されたファイル内のマクロの名前であることに注意してください。この名前は、引用符で囲まれている必要があります。

Parameters– マクロが必要とするパラメータ。これは、すべてのパラメータを含む配列である必要があります。

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

Filename– 実行されるマクロを含むxlsmファイルのフルパスまたはファイル名です。

Result– マクロの結果（出力）が保存される変数または引数ファイルのパス（ある場合）。ワークフローを実行する前に作成する必要があります。

Workbook–Workbookオブジェクト全体を保存することができる変数ファイルパス。この変数の型は “Microsoft.Office.Interop.Excel.Workbook” でなければなりません。

Worksheet– マクロが読み込まれるワークシートの名前です。文字列である必要があります。

OpenRPA.OfficeのExcelマクロを実行する<>。

スライドショーの実行

このアクティビティは、事前に作成したMicrosoft PowerPointのスライドショーを発表する役割を担っています。

プロパティパラメータ

ファイル名-提示されるMicrosoft PowerPointのスライドショーのフルパスまたはファイル名。

StartingSlide– ロボットがスライドショーの提示を開始すべき、スライドのインデックスです。

AdvanceTime– プレゼンテーションの次のスライドを表示する前にOpenRPAが待機すべき時間間隔です。 単純な 00:00:00.00 {hh:min:ss.mili} またはTimeSpanクラスのオブジェクトにすることができます。

CloseAtEnd–ブール値。Trueに設定すると、プレゼンテーションが終了したとき、Microsoft PowerPointアプリケーションの実行を停止する。そうでなければ、それは開いたままになります。

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

EndingSlide– 最後に表示されるスライドのインデックスです。

KioskMode– ブール値。Trueに設定すると、Microsoft PowerPointのキオスクモードが有効になります。つまり、ユーザーがスライドショーの実行を妨害できないように、スライドショーが自動的に表示されるようになります。

OpenRPA.Office Run スライドショー

メールアイテムの保存

Microsoft Outlookの電子メールアイテムをファイルとして保存します。

まず、プロパティボックスの EMailパラメータに、IEnumerable<email>変数からインデックスを作成した電子メールオブジェクトを入力します。このメールオブジェクトは、Get Mailsアクティビティで取得したIEnumerable<email>変数からインデックスを作成したものです。電子メールは、電子メールの件名を ファイル名として、指定されたフォルダに自動的に保存されます。

プロパティ パラメータ

EMail– ファイルに保存される電子メールアイテム。IEnumerable<email>変数からインデックス化されています。

フォルダ–電子メールアイテムが保存されるフォルダパスファイルのパスです。

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

タイプ–電子メールアイテムを保存するために使用されるファイルのタイプです。現在サポートされている形式は、.doc,.html,.ics,.mht,.msg,.rtf,.oft,.txt,.vcs,.vcfです。

Filename– 現在未使用のパラメータです。

OpenRPA.Office 保存MailItem。

セット・パラグラフ

このアクティビティは、Microsoft Word文書内の段落の内容を設定します。

Indexパラメータに値を指定しないことで、ドキュメント全体を指定したテキストで上書きすることができます。変更内容を設定した後、［ドキュメントを閉じる］アクティビティを使用してWordドキュメントを適切に閉じ、保存することをお勧めします。

プロパティ パラメータ

ファイル名– 段落が設定されるMicrosoft Word文書ファイルのパスのフルパスとファイル名です。

Index– 設定される段落のインデックス．

Text– 与えられた段落またはドキュメント全体を上書きするテキストを含むテキスト変数または文字列。

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

OpenRPA.Officeセットパラグラフ」。

セル<>を書き込む

Microsoft Excel文書内の1つのセルに値や数式を設定する方法です。

ユーザーは、まず、セルに保存されるデータ型に対応するResultのタイプを設定する必要があります。このデータ型は、Excelドキュメント内ですでに設定されている必要があります。また、Workbookパラメータで使用するワークブックと、セルの書き込みや上書きに使用するワークシートを指定することができます。

プロパティパラメータ

セル– 内容が変更されるセル。

Formula– 値が取得され、セル内に配置される数式。

値– 取得され、セル内に配置される、事前に指定されたデータ型を持つ変数またはコンテンツ。

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

ファイル名– セルに設定されるMicrosoft Excel文書ファイルのパスのフルパスとファイル名です。

Result– 現在未使用のパラメータです。

ワークブック– セルの内容を挿入または変更するために使用されるワークブックです。

ワークシート– セルの内容を挿入または変更するために使用されるワークシートです。

OpenRPA.Office Write Cell<>。

書き込み範囲

このアクティビティは、DataTableに含まれるすべてのデータをMicrosoft Excelのワークシートに書き込みます。

ユーザーは、最初に...ボタンをクリックし、保存または追加されるファイルのファイルパスを見つける必要があります。また、ユーザーは、ワークブック

プロパティパラメータ

Cell– 書き込みを開始する行ファイルのパスに対応する最初のCell．

DataTable– データを収集するためのテーブル。

ファイル名– セルに設定されるMicrosoft Excel文書ファイルのパスのフルパスとファイル名です。

Worksheet– 書き込むシートファイルのパス名です。

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

ReadPassword– ファイルの読み取りに使用されるパスワード。

ヘッダー 行を使用–Trueに設定すると、DataTableからヘッダーを使用して、選択されたセルの範囲を書き込みます。

Visible–Trueに設定すると、Microsoft Excelドキュメントを目に見える形で開き、書き込むことができます。

WritePassword– ファイルの書き込みに使用されるパスワード。

ワークブック– セルの内容を挿入または変更するために使用されるワークブックです。

OpenRPA.Officeの書き込み範囲。