ここでは、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
オブジェクト。
備考
OpenRPAでは、DataTableは
値を保持するために使われる2次元の非シリアライズ可能なオブジェクトに相当します。これはi
行j
列の行列と考えることができます。i
行は.Rows(n)
属性でアクセスできます。nは
アクセスしたい行の番号です(0から始まる)。j
列には、.Item(n)
属性を使ってアクセスします。nは
、アクセスしたい列の番号-0から始まる-です。ここで、ユーザがRows
属性にアクセスしなければならないことを思い出してください。したがって、ユーザがデータ テーブルの 3 行目の 2 列目にアクセスしたい場合は、.Rows(2).Item(1)
属性を使用することになります。
スカラ<>を実行する
-
集約関数など、ちょうど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
– シーケンス内のアクティビティのタイトルです。結果
– 影響を受ける行の数。