範囲に書き込み

UiPath.MicrosoftOffice365.Activities.Excel.WriteRangeConnections

説明

指定した Excel ブックのセル範囲に DataTable 型変数を書き込みます。

スコープ

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

• Files.ReadWrite

OR

• Files.ReadWrite.All

OR

• Sites.ReadWrite.All

プロジェクトの対応 OS

Windows | クロスプラットフォーム

構成

• Microsoft OneDrive & SharePoint - アクティビティで使用する Microsoft 365 アカウント用のコネクションです。
• ブック - 使用する Excel ブックです。取得するフォルダーの指定方法 ([フォルダー ピッカー]、[ID を入力]、[URL を入力]) です。

  • ブックのサンプル - 使用するブック テンプレートです。[ブック テンプレートを使用] をクリックすると表示されます。OneDrive フォルダーを参照してブックを選択します。デスクトップ版の Studio では、このオプションは [範囲の種類] の横にある [その他を表示] ボタンのメニューから利用できます。詳しくは、「テンプレートを使用する」をご覧ください。

  • ファイル/フォルダー ピッカー オプション: フォルダー アイコンをクリックすると、OneDrive または SharePoint のファイル/フォルダーを参照してブックを選択できます。このオプションはIResource として入力を受け入れます。

    • フォルダーを変更し、最新のデータを取得する必要がある場合は、[その他を表示] ボタンのメニューを使用して変数を使用するか、[フォルダーのデータを再読み込み] オプションを選択します。

  • [ID を入力] オプション:

    • ブック ID - 取得するブックの ID です。 このプロパティは、String 型変数と文字列形式の値をサポートします。
    • SharePoint サイト アドレス - ファイルまたはフォルダーを含む SharePoint サイトの URL です。このプロパティでは、String 型の変数と文字列形式の値がサポートされています。ブラウザーで SharePoint サイトを開き、URL をコピーします (例: https://yourcompany.sharepoint.com/sites/ProductOfficial)。
    • SharePoint ドキュメント ライブラリ - ファイルまたはフォルダーを含む、指定した SharePoint サイト内のドキュメント ライブラリです。このプロパティでは、String 型の変数と文字列形式の値がサポートされています。SharePoint サイトの [ドキュメント] タブを開き、URL をコピーします (例: https://yourcompany.sharepoint.com/sites/ProductOfficial/Shared%20Documents/Forms/AllItems.aspx)。

  • [URL を入力] オプション:

    • ブック URL - 対象のブックの URL です。このプロパティでは、String 型の変数と文字列形式の値がサポートされています。ブラウザーでファイルを開いて URL を取得します。
• 範囲 - 書き込む範囲です。このフィールドには、選択したスプレッドシートまたはスプレッドシートのサンプルから取得した情報が事前に入力されます。このプロパティでは、String 型の変数と文字列形式の値がサポートされています。

  • シートを変更してから最新のデータを取得する必要がある場合は、[範囲を更新] オプションを選択します。

• ヘッダーを含める - このプロパティでは Boolean 値がサポートされています。ブックにデータ テーブルのヘッダーも含める場合は、[True] に設定します。

• 書き込み方法 - 指定した範囲にデータを追加する方法を指定します。利用可能なオプションは次のとおりです。
  • 上書き - 既存のデータを上書きします。
  • 追加 - 最初に見つかった空の行にデータを書き込みます。
  • 右に追加 - 最初に見つけた空の列にデータを書き込みます。詳細については、下記の「追加」セクションをご覧ください。
  • 挿入 - 行を挿入します。
• 行の位置 - アクティビティが行を挿入する行インデックスの位置です。このインデックスは、[範囲を読み込み] または [繰り返し (各行)] を使用した範囲の行の反復処理から取得できます。このフィールドは、[書き込み方法] - [挿入] を選択した場合に表示されます。このフィールドでは Int32 型の入力がサポートされています。
• 書き込む内容 - ブックに書き込む、データ テーブル内のデータです。このフィールドでは DataTable 型変数がサポートされています。たとえば、[範囲を読み込み] アクティビティの出力変数を使用できます。

注: [シート]/[範囲の名前] プロパティで特殊文字を特定の組み合わせで使用すると、アクティビティでエラーがスローされる可能性があります。たとえば、Sheet%Test は入力として有効ですが、Sheet%44 は有効ではありません (%44 は D に変換されます)。

追加

現在は、データの追加は名前付き範囲をサポートしていません。

	追加 (下に)	右に追加
書式なし範囲 (A1 表記)	対象の範囲で見つかった最初の空の行に範囲を書き込みます。 必要な数の行を作成し、入力範囲を範囲に入力します。 範囲内に空の行がない場合は、必要な数の行を挿入し入力範囲を追加することで、範囲を下に追加します。	対象の範囲で見つかった最初の空の列に範囲を書き込みます。 必要な数の列を作成し、入力範囲を範囲に入力します。 範囲内に空の列がない場合は、必要な数の列を挿入し入力範囲を追加することで、範囲を右に追加します。
名前付き範囲	対象の範囲で見つかった最初の空の行に範囲を書き込みます。 必要な数の行を作成し、入力範囲を範囲に入力します。 範囲内に空の行がない場合は、必要な数の行を挿入し入力範囲を追加することで、範囲を下に追加します。	対象の範囲で見つかった最初の空の行に範囲を書き込みます。 必要な数の行を作成し、入力範囲を範囲に入力します。 範囲内に空の行がない場合は、必要な数の行を挿入し入力範囲を追加することで、範囲を下に追加します。
シート	対象のシートで見つかった最初の空の行に範囲を書き込みます。 必要な数の行を作成し、入力範囲を範囲に入力します。 範囲内に空の行がない場合は、必要な数の行を挿入し入力範囲を追加することで、範囲を下に追加します。	対象のシートで見つかった最初の空の列に範囲を書き込みます。 必要な数の列を作成し、入力範囲を範囲に入力します。 範囲内に空の列がない場合は、必要な数の列を挿入し入力範囲を追加することで、範囲を右に追加します。

要求に関する既知の制限事項

範囲を扱う場合は、要求/応答の制限に注意してください。制限は 4 MB です。たとえば、読み取り要求の場合は平均 10,000 セル (セル 1 つあたり 20 文字) で、書き込み要求の場合は平均 4,000 セル (セル 1 つあたり 20 文字) です。詳細については、「Excel specifications and limits」をご覧ください。

既知の制限事項

[追加] オプションを選択し、対象範囲として先頭に他のデータを含まない空の表を含むシートを設定した [行を書き込み]/[範囲に書き込み] を使用すると、エラーが発生します。アクティビティは、シート内の表の先頭に行を挿入しようとしますが、Graph API からエラーが返されます。

例

以下の記事もご覧ください。

• Excel Online アクティビティ

• ブックを作成
• シートを削除
• セルを読み込み