範囲に書き込み

UiPath.MicrosoftOffice365.Activities.Excel.WriteRangeConnections

説明

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

プロジェクトの対応 OS

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

構成

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

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

  • File/Folder picker option: Click the Folder icon to browse the OneDrive or SharePoint files/folders and select a spreadsheet. This option accepts input as 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] に設定します。

• 書き込み方法 - 指定した範囲にデータを追加する方法を指定します。利用可能なオプションは次のとおりです。
  • 上書き - 既存のデータを上書きします。
  • 追加 - 最初に見つかった空の行にデータを書き込みます。
  • 右に追加 - 最初に見つけた空の列にデータを書き込みます。詳細については、下記の「追加」セクションをご覧ください。
  • 挿入 - 行を挿入します。
• Row position - The row index position where the activity is to insert the row. The index can be used from iterating on the range rows using Read Range or For Each Row. This field is displayed if you select How to write – Insert. This field supports Int32 type input.
• 書き込む内容 - ブックに書き込む、データ テーブル内のデータです。このフィールドでは 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 アクティビティ

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