挿入

UiPath.Database.Activities.InsertDataTable

説明

既存のテーブルに対応する DataTable を挿入します。また、影響を受けた行の数を返します。

重要: [Insert] アクティビティは、DataAdapter を使用して、データベース スキーマに基づいて適切な挿入/更新クエリを自動的に生成します。クエリを生成するために、ODBC は標準のスキーマ呼び出しを実装します。使用しているデータベースに標準のスキーマ呼び出しが実装されていることを確認してください。そうしないと、アクティビティが正しく機能しない可能性があります。

プロジェクトの対応 OS

Windows - レガシ | Windows | クロスプラットフォーム

Windows - レガシ、Windows での設定

デザイナー パネル

• 接続を構成... - 既存のデータベース接続を選択するか、接続ウィザードを使用して新しいデータベース接続を追加します。
• ターゲットのテーブル名 - データを挿入する SQL テーブルです。このフィールドでは String 型の変数のみがサポートされています。
• 入力データ テーブル - テーブルに挿入される DataTable 型変数です。DataTable の列の名前と説明は、データベース テーブルのものと一致する必要があります。

プロパティ パネル

共通

• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。
  注: このアクティビティが [トライ キャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True の場合、プロジェクトが実行されたときにエラーは発生しません。
• 表示名 - アクティビティの表示名です。 このフィールドでは String 型の変数のみがサポートされています。

接続設定

• 接続文字列 - データベース接続の確立に使用する接続文字列です。 このフィールドでは String 型の変数のみがサポートされています。
• 既存の接続 - [接続] または [トランザクションを開始] アクティビティから取得する、すでに開かれているデータベース接続です。この接続を指定すると、ConnectionString プロパティと SecureConnectionString プロパティは無視されます。このフィールドでは、DatabaseConnection 型の変数のみがサポートされています。
• プロバイダー名 - データベースへのアクセスに使用するデータベース プロバイダーの名前です。 このフィールドでは String 型の変数のみがサポートされています。
• セキュリティで保護された接続文字列 - データベース接続の確立に使用する、SecureString 型の接続文字列です。このフィールドでは SecureString 型の変数のみがサポートされています。

入力

• 入力データ テーブル - テーブルに挿入される DataTable 型変数です。DataTable の列の名前と説明は、データベース テーブルのものと一致する必要があります。
• ターゲットのテーブル名 - データを挿入する SQL テーブルです。このフィールドでは String 型の変数のみがサポートされています。

その他

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

出力

• 影響を受ける行数 - 影響を受ける行の数を Int32 型変数に格納します。

クロスプラットフォームでの設定

• 既存の接続 - [データベースに接続] アクティビティから取得する、既に開かれているデータベース接続です。
• 入力データ テーブル - テーブルに挿入される DataTable 型変数です。DataTable の列の名前と説明は、データベース テーブルのものと一致する必要があります。
• ターゲットのテーブル名 - データの挿入先となるデータベース テーブルです。

詳細オプション

その他

• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。

出力

• 影響を受ける行数 - 影響を受ける行の数です。