OpenIAPカテゴリー: 3.5. Interface

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

FinalState 活動

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

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

プロパティパラメータ

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

ForEachWithBodyFactory<> アクティビティ

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

プロパティパラメータ

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

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

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

ParallelForEachWithBodyFactory<> アクティビティ

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

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

プロパティ パラメータ

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

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

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

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

PickWithTwoBranchesFactory 活動

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

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

プロパティパラメータ

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

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クラスのオブジェクトにすることができます。

非クエリーの実行

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

プロパティ パラメータ

Query– 実行されるクエリ。

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

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

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

クエリーの実行

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

プロパティパラメータ

Query– 実行されるクエリ。

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

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

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

スカラ<>を実行する

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

プロパティパラメータ

Query– 実行されるクエリ。

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

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

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

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

DataTableからの更新

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

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

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

物件紹介

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

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

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

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

ここでは、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.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“).

URLを開く

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

プロパティパラメータ

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

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

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

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

カラーを取得する

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

プロパティパラメータ

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

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

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

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

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

エレメントを取得

画面内または特定のアプリケーションウィンドウ内の画像を検索し、その画像から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’ をテストしてください。

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

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

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

画像を取得する

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

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

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

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

プロパティパラメータ

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

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

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

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

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

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

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

テキストを取得

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

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

プロパティパラメータ

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

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

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

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

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

ファイルから読み込む

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

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

プロパティパラメータ

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

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

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

備考

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

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

画面全体または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プロパティにアクセスすることでアクセスすることができます。

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“).

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.Officeのツールボックスの中にあるアクティビティは以下の通りです。

パラグラフィーの追加

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

プロパティパラメータ

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

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

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

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

クリアレンジ

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

プロパティパラメータ

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

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

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

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

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

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

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

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

ドキュメントを閉じる

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

プロパティパラメータ

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

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

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

ワークブックを閉じる

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

プロパティパラメータ

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

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

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

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

メール取得

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>型の変数に保存されます。

パラグラフを取得

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

プロパティパラメータ

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

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

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

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

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

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

選択した範囲を取得する

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– ファイルの書き込みに使用されるパスワード。

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

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

MailItemを移動する

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

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

プロパティパラメータ

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

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

新規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の結果が保存されるメールオブジェクトのファイルパス。別のフォルダに送るなど、送信後のメッセージの操作に使用できます。

リードセル

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

プロパティパラメータ

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

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

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

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

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

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

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

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

Range– 読み込まれる範囲。

読み取り範囲

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

プロパティパラメータ

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

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

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

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

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

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

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

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

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

WritePassword– ファイルが読み込まれた後に書き込まれるパスワード．

DataTable– データが保存されるDataTableファイルのパス．

lastUsedColumn– 最後に使用されたカラムのインデックスを変数に保存する．

lastUsedRow– 最後に使用された行のインデックスを変数に保存する。

ワークブック–ワークブックを特定の変数に保存します。

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– 現在未使用のパラメータです。

セット・パラグラフ

このアクティビティは、Microsoft Word文書内の段落の内容を設定します。

Indexパラメータに値を指定しないことで、ドキュメント全体を指定したテキストで上書きすることができます。変更内容を設定した後、［ドキュメントを閉じる］アクティビティを使用してWordドキュメントを適切に閉じ、保存することをお勧めします。

プロパティ パラメータ

ファイル名– 段落が設定されるMicrosoft Word文書ファイルのパスのフルパスとファイル名です。

Index– 設定される段落のインデックス．

Text– 与えられた段落またはドキュメント全体を上書きするテキストを含むテキスト変数または文字列。

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

セル<>を書き込む

Microsoft Excel文書内の1つのセルに値や数式を設定する方法です。

ユーザーは、まず、セルに保存されるデータ型に対応するResultのタイプを設定する必要があります。このデータ型は、Excelドキュメント内ですでに設定されている必要があります。また、Workbookパラメータで使用するワークブックと、セルの書き込みや上書きに使用するワークシートを指定することができます。

プロパティパラメータ

セル– 内容が変更されるセル。

Formula– 値が取得され、セル内に配置される数式。

値– 取得され、セル内に配置される、事前に指定されたデータ型を持つ変数またはコンテンツ。

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

ファイル名– セルに設定されるMicrosoft Excel文書ファイルのパスのフルパスとファイル名です。

Result– 現在未使用のパラメータです。

ワークブック– セルの内容を挿入または変更するために使用されるワークブックです。

ワークシート– セルの内容を挿入または変更するために使用されるワークシートです。

書き込み範囲

このアクティビティは、DataTableに含まれるすべてのデータをMicrosoft Excelのワークシートに書き込みます。

ユーザーは、最初に...ボタンをクリックし、保存または追加されるファイルのファイルパスを見つける必要があります。また、ユーザーは、ワークブック

プロパティパラメータ

Cell– 書き込みを開始する行ファイルのパスに対応する最初のCell．

DataTable– データを収集するためのテーブル。

ファイル名– セルに設定されるMicrosoft Excel文書ファイルのパスのフルパスとファイル名です。

Worksheet– 書き込むシートファイルのパス名です。

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

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

ヘッダー 行を使用–Trueに設定すると、DataTableからヘッダーを使用して、選択されたセルの範囲を書き込みます。

Visible–Trueに設定すると、Microsoft Excelドキュメントを目に見える形で開き、書き込むことができます。

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

ワークブック– セルの内容を挿入または変更するために使用されるワークブックです。

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

OpenFlowを割り当てる

OpenFlowワークフローをユーザーまたはロールに割り当てます。このアクティビティは、Node-RED内のassignノードと非常によく似た動作をします。

プロパティパラメータ

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

InitialRun– このパラメータは、割り当てられたワークフローに初期実行を属性付けします。

targetid– ワークフローが割り当てられるユーザーファイルパスのID。

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

workflowid– 割り当てられるワークフローのIDです。

ファイルの削除

OpenFlow の MongoDB データベースからファイルを削除します。ユーザーは、削除したいファイルのファイル名か、OpenFlow のページ > 管理 > ファイル > ファイルの編集ボタンをクリック > json を表示、または URL を確認することで得られるid のどちらかを使用することができます。

プロパティパラメータ

_id– 削除されるファイルのID。

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

Filename– 削除されるファイルのファイル名です。

IgnoreErrors– 発生した可能性のあるエラーを無視し、ファイルを強制的に削除します。

デリートワン

OpenFlow MongoDB データベースから項目を一つ削除します。ユーザーは、アイテムが属するコレクションファイルのパスを指定する必要があります。データベースから一括で削除するオブジェクトを指定することもできます。

プロパティ パラメータ

_id– 削除されるアイテムのID。

コレクション– アイテムが属するコレクションファイルのパス。

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

IgnoreErrors– 発生した可能性のあるエラーを無視し、アイテムを強制的に削除します。

Item– ユーザーが_id の代わりに指定できるオブジェクト。

認証情報の取得

OpenFlow から暗号化されたクレデンシャルのセットを取得します。これは、Set Credentialsアクティビティで OpenFlow MongoDB データベースに以前保存したクレデンシャルを取得する方法として最も推奨されるものです。KeePass のようなローカル金庫の代わりとして最適です。

プロパティパラメータ

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

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

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

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

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

ファイルを取得する

OpenFlow MongoDB データベース内に保存されているファイルをダウンロードし、指定されたLocalPath に保存します。ユーザーは、ダウンロードしたいファイルのファイル名か、OpenFlow のページ > 管理 > ファイル > ファイルの編集ボタンをクリック > json を表示、または URL を確認することで、id を利用することができます。ファイルを保存するフォルダ・ファイルパスは、すでに存在している必要があります。

プロパティパラメータ

_id– ダウンロードされるファイルのID．

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

Filename– ダウンロードされるファイルのファイル名です。

IgnorePath–Trueに設定すると、LocalPathの最後の名前を無視します。OpenFlow内部で作成されたフルフォルダをダウンロードする際に便利です。

LocalPath- ファイルが保存されるフォルダファイルパスのパス。

許可する

指定されたオブジェクトのユーザまたはロールのパーミッションを追加または更新するものです。InsertまたはUpdate Oneでパーミッションを変更した後は、OpenFlowでドキュメントを更新する必要があります。また、オブジェクトはOpenFlowDB.Queryアクティビティから提供される必要があります。

プロパティパラメータ

Delete–True に設定すると、指定されたユーザーまたはロールが OpenFlow 内でオブジェクトを削除することを許可します。

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

EntityId– OpenFlow MongoDBデータベース内のオブジェクトのID。

Item–OpenFlowDB.Queryアクティビティから収集したオブジェクト。

名前– ファイルパスのパーミッションが追加されるロールまたはユーザーの名前です。

Read–Trueに設定すると、指定されたユーザーまたはロールがOpenFlow内のオブジェクトを読み取ることを許可します。

Result– 結果オブジェクトが保存されるJObjectファイルのパス．

Update–True に設定すると、指定されたユーザーまたはロールがOpenFlow 内のオブジェクトを更新できるようになります。

インサートワン

OpenFlow MongoDB データベースにオブジェクトを一つ挿入します。

プロパティパラメータ

Collection– オブジェクトが保存されるコレクションファイルのパス。デフォルトは"entities "です。

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

EncryptFields– 指定されたフィールドを暗号化する。

IgnoreErrors– OpenFlow MongoDB データベースにオブジェクトを強制的に追加し、発生しうるエラーを無視します。

Item– 追加されるオブジェクト。

Result– 追加されたばかりのオブジェクトを含むJObjectを返します。

タイプ– 追加されるオブジェクトのタイプです。

一意性– 項目が一意であるかどうかのフィールドを指定します。

1つの挿入または更新

OpenFlow データベースにアイテムを更新し、存在しない場合は代わりに挿入します。ユーザが Uniqueness を指定しない限り、_idをチェックし、Uniqueness で指定されたフィールドを元に既存のアイテムを探します。

プロパティパラメータ

Collection– オブジェクトが保存されるコレクションファイルのパス。デフォルトは"entities "です。

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

EncryptFields– 指定されたフィールドを暗号化する。

IgnoreErrors– OpenFlow MongoDB データベースにオブジェクトを強制的に追加し、発生しうるエラーを無視します。

Item– 追加されるオブジェクト。

Result– 追加されたばかりのオブジェクトを含むJObjectを返します。

タイプ– 追加されるオブジェクトのタイプです。

一意性– 項目が一意であるかどうかのフィールドを指定します。

クエリ活動

OpenFlow MongoDB データベースに 1 つ以上の項目を問い合わせます。

プロパティパラメータ

Collection– オブジェクトが保存されるコレクションファイルのパス。デフォルトは"entities "です。

DataTable– クエリの出力をDataTable に保存します。

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

Orderby– データに問い合わせる順番を選択します。詳しくはこちら(https://docs.mongodb.com/manual/reference/operator/meta/orderby/#:~:text=In%20the%20mongo%20shell%2C%20use,in%20ascending%20or%20descending%20order.&text=These%20examples%20return%all%20documents,age%20field%20in%20descending%20 order.) をご覧ください。

Projection–ここ(https://docs.mongodb.com/manual/tutorial/project-fields-from-query-results/)のように、データを投影するために使用するフィールドを提供します。

QueryString– コレクション内で返されるオブジェクトの名前です。

Result– クエリによって返されたすべてのオブジェクトを含むJObjectを返します。

Skip– スキップするアイテムファイルパスの数。引数の型はInt32です。

Top– トップアイテムを選択します。引数の型はInt32です。

OpenRPA.OpenFlowDBクエリ

許可証の削除

指定されたオブジェクトのユーザーまたはロールのパーミッションを削除します。その後、OpenFlowでInsertまたはUpdate Oneアクティビティを使用してパーミッションを変更した後、ドキュメントを更新する必要があります。アクティビティ内の入力フィールドは、パーミッションが削除されるユーザーを選択するためのオートコンプリートのフィールドです。ObjectItemは、OpenFlowDB.QueryアクティビティのResultである必要があります。

プロパティパラメータ

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

EntityId– OpenFlow MongoDBデータベース内のオブジェクトのID。

Item–OpenFlowDB.Queryアクティビティから収集したオブジェクト。

名前– 権限を追加するロールまたはユーザーの名前です。

Result– 結果オブジェクトが保存されるJObjectファイルのパス．

ファイルの保存

OpenFlow MongoDB データベースにファイルをアップロードして保存します。

プロパティパラメータ

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

Filename– アップロードされるファイルの完全なパスとファイル名です。

パス– データベース内にパスを付加してファイルを保存します。特定のフォルダー内にアイテムを配置し、後でそれらを戻すために使用します。

Result– OpenFlow MongoDBデータベース内のファイルのIDを含む文字列。

OpenRPA.OpenFlowDBセーブファイル

認証情報の設定

OpenFlow 内で暗号化されたクレデンシャルのセットを作成または更新します。これは、OpenFlow の MongoDB データベースにクレデンシャルを保存する最も推奨される方法です。KeePass のようなローカル金庫の代わりとして最適です。

プロパティパラメータ

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

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

Password– 保存されるクレデンシャルのパスワード。

Username– 保存されるクレデンシャルのユーザー名です。

データテーブルからの更新

OpenFlowのコレクション内に、DataTableの各行をEntityとして追加します。

ユーザーは、データを挿入するコレクションを最初に挿入する必要があります。デフォルトのコレクションは「entity」ですが、新しいコレクションにデータを追加したい場合、ユーザーは任意のコレクション名を挿入することができます。コレクションが存在しない場合、アクティビティは自動的にそれを作成します。

次に、データの取得元となるDataTableを挿入する必要があります。

EncryptFieldsを使用すると、ユーザーはClient-Side Field Level Encryption(https://docs.mongodb.com/manual/core/security-client-side-encryption/) を使用してデータを暗号化することができます。

Resultパラメータは、行の挿入によって返されたクエリを含むデータをJArray変数に保存します。

Typeパラメータは、行に型フィールドがないか、NULL、""、または空の場合、与えられた行に追加されるデフォルトの型を指定します。

Uniquenessパラメータは、 インデックス化されたフィールドに重複した値を保存しないようにするものです。デフォルトの一意性インデックスはid(MongoDB では_id として保存されます) です。しかし、ユーザーはname のような別の一意性インデックスを指定することができます。一意なインデックスを指定するには、カンマで区切って入力します。つまり、一意なインデックスとしてnameとtypeを指定したい場合は、このパラメータにname,type と入力すればいいのです。これについては、ユニーク・インデックス(https://docs.mongodb.com/manual/core/index-unique/)を参照してください。

プロパティパラメータ

コレクション– データが挿入されるコレクション。デフォルトのコレクションは「entity」ですが、新しいコレクションにデータを追加したい場合、ユーザーは任意のコレクション名を挿入することができます。コレクションが存在しない場合、アクティビティは自動的にそれを作成します。

DataTable– データの取得元となるデータテーブル．

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

EncryptFields–Client-Side Field Level Encryption(https://docs.mongodb.com/manual/core/security-client-side-encryption/) を使用して、ユーザーがデータを暗号化できるようにします。

Result– 行の挿入によって返されるクエリを含むデータが保存される変数。JArray型でなければならない。

Type– 行に型フィールドがないか、NULL、""、または空の場合、指定した行に追加する既定の型を指定します。

一意性– インデックス化されたフィールドが重複した値を保存しないようにします。デフォルトの一意性インデックスはid(MongoDB では_id として保存されます) です。しかし、ユーザーはname のような他の一意性インデックスを指定することができます。一意なインデックスを指定するには、カンマで区切って入力します。つまり、一意なインデックスとしてnameとtypeを指定したい場合は、このパラメータにname,type と入力すればいいのです。これについては、ユニーク・インデックス(https://docs.mongodb.com/manual/core/index-unique/)を参照してください。