範囲に書き込み

UiPath.MicrosoftOffice365.Activities.Excel.WriteRange

説明

Microsoft Graph の UpdateRange API を使用して、ブック ([ブック]) のワークシート ([シート名]) 内の特定のセル ([開始セル]) から開始する範囲のセル データ ([データ テーブル]) を書き込みます。

スコープ

このアクティビティには、次のスコープが必要です。

• Files.ReadWrite

OR

• Files.ReadWrite.All

OR

• Sites.ReadWrite.All

プロジェクトの対応 OS

Windows - レガシ |Windows

構成

プロパティ

共通

• 表示名 - アクティビティの表示名です。 このプロパティは、String 型変数と文字列形式の値をサポートします。

入力

• データ テーブル - 挿入する表です。このフィールドでは DataTable 型の変数のみがサポートされています。DataTable 型の変数を取得するには、[データ テーブルを構築] または [データ テーブルを生成] アクティビティを使用して表を作成し、その出力プロパティ変数を使用します。
• シート名 - データを書き込むシートの名前です。この値は、既存のワークシートの名前に一致させる必要があります。一致していないと、"ItemNotFound" エラーがスローされます。このアクティビティでは、このプロパティで指定された名前が見つからないと新しいシートが作成されません。このプロパティは、String 型変数と文字列形式の値をサポートします。
• 開始セル ｰ 表の左上のセルを書き込むアドレスです。A1 形式の表記で 1 つのセルのアドレスを入力します。このプロパティはセルの範囲 (例: "A1:A5") をサポートしていません。このプロパティは、String 型変数と文字列形式の値をサポートします。
• ブック - 変更するドキュメントの DriveItem です。このオブジェクトは [ファイルやフォルダーを探す] アクティビティを使用して取得できます。[ファイルやフォルダーを探す] アクティビティの出力プロパティ変数 ([最初] または [結果]) または [ブックを作成] アクティビティの出力プロパティ変数 ([ブック]) を使用します。[ファイルやフォルダーを探す] アクティビティの [結果] 出力プロパティを使用する場合、必ず配列内の使用する項目を指定してください (例: myWorkbooks(0))。

その他

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

オプション

• ヘッダーを含む ｰ 選択した場合、データ テーブルのヘッダーもブックに挿入されます。このフィールドでは Boolean 値 (True、False) のみサポートされています。既定値は [True] です。

動作のしくみ

以下の手順とメッセージ シーケンス ダイアグラムは、設計時 (つまり、アクティビティの依存関係と入/出力プロパティ) から実行時に至るまでの、アクティビティの動作のしくみの例を示したものです。

1. 手順を完了します。
2. プロジェクトに [Microsoft Office 365 スコープ] アクティビティを追加します。
3. DriveItem オブジェクトを出力するアクティビティを追加するか外部プロセスを実行します (例 : [ファイルやフォルダーを探す]、[ブックを作成]、[アイテムをコピー])。
4. DataTable オブジェクトを出力するアクティビティを追加します (例 :[データ テーブルを構築]、[データ テーブルを生成])。
5. [Microsoft Office 365 スコープ] アクティビティ内に [範囲に書き込み] アクティビティを追加します。
6. [入力] セクションのプロパティに値を入力します。

7. アクティビティを実行します。

   • 入力したプロパティ値は、UpdateRange API に渡されます。