activities
latest
false
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。
UiPath logo, featuring letters U and I in white
生産性を高めるアクティビティ
Last updated 2024年11月21日

範囲に書き込み

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 では、このオプションは [範囲の種類] の横にある [その他を表示] ボタンのメニューから利用できます。詳しくは、「テンプレートを使用する」をご覧ください。

    • ファイル/フォルダー ピッカー オプション: フォルダーdocs image アイコンをクリックすると、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 は有効ではありません (%44D に変換されます)。
追加

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

 追加 (下に)右に追加
書式なし範囲 (A1 表記)

対象の範囲で見つかった最初の空の行に範囲を書き込みます。

必要な数の行を作成し、入力範囲を範囲に入力します。

範囲内に空の行がない場合は、必要な数の行を挿入し入力範囲を追加することで、範囲を下に追加します。

対象の範囲で見つかった最初の空の列に範囲を書き込みます。

必要な数の列を作成し、入力範囲を範囲に入力します。

範囲内に空の列がない場合は、必要な数の列を挿入し入力範囲を追加することで、範囲を右に追加します。

名前付き範囲

対象の範囲で見つかった最初の空の行に範囲を書き込みます。

必要な数の行を作成し、入力範囲を範囲に入力します。

範囲内に空の行がない場合は、必要な数の行を挿入し入力範囲を追加することで、範囲を下に追加します。

対象の範囲で見つかった最初の空の行に範囲を書き込みます。

必要な数の行を作成し、入力範囲を範囲に入力します。

範囲内に空の行がない場合は、必要な数の行を挿入し入力範囲を追加することで、範囲を下に追加します。

シート

対象のシートで見つかった最初の空の行に範囲を書き込みます。

必要な数の行を作成し、入力範囲を範囲に入力します。

範囲内に空の行がない場合は、必要な数の行を挿入し入力範囲を追加することで、範囲を下に追加します。

対象のシートで見つかった最初の空の列に範囲を書き込みます。

必要な数の列を作成し、入力範囲を範囲に入力します。

範囲内に空の列がない場合は、必要な数の列を挿入し入力範囲を追加することで、範囲を右に追加します。

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

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

既知の制限事項

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



以下の記事もご覧ください。
  • 説明
  • プロジェクトの対応 OS
  • 構成
  • 既知の制限事項

このページは役に立ちましたか?

サポートを受ける
RPA について学ぶ - オートメーション コース
UiPath コミュニティ フォーラム
Uipath Logo White
信頼とセキュリティ
© 2005-2024 UiPath. All rights reserved.