行を書き込み

UiPath.Gsuite.Activities.WriteRowConnections

説明

[配列行] または [データ行] を使用して、選択したシート ファイルに行を書き込みます。[データ行] 下の各フィールド オプションを使用して、各フィールドをターゲット列にマッピングできます。

スコープ

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

• https://www.googleapis.com/auth/drive

OR

• https://www.googleapis.com/auth/spreadsheets

プロジェクトの対応 OS

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

構成

• Google スプレッドシートのコネクション - アクティビティで使用する Google Workspace アカウントのコネクションです。
• スプレッドシート - 使用する Google スプレッドシートです。フォルダー アイコンをクリックすると、Google ドライブのフォルダーを参照してスプレッドシートを選択することができます。このオプションは IResource として入力を受け入れます。[その他を表示] ボタンのメニューを使用すると、入力モードを [変数を使用] または [URL または ID] (String) に切り替えることができます。
  • [変数を使用] を選択すると、[スプレッドシートを作成] などの他のアクティビティの出力変数を使用できます。
  • Spreadsheet URL - The URL or ID of the spreadsheet of interest. This field is available when Url or ID is selected as the input mode. This property supports String variables and string formatted values. For details, see How to retrieve spreadsheet IDs.
  • Spreadsheet sample - Select a file with the same ranges as the variable file. The field is visible after clicking Use spreadsheet template. Browse the Google Drive folders and select a spreadsheet. In Studio Desktop, the option is available from the Plus button menu next to Range. This field accepts IResource input. To learn more, see Working with templates.

  • フォルダーを変更し、最新のデータを取得する必要がある場合は、[ファイルのデータを再読み込み] オプションを選択します。

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

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

  • ブックを変更してから最新のデータを取得する必要がある場合は、[フィールドを更新] オプションを選択します。

• 書き込み方法 - 指定した範囲にデータを追加する方法を指定します。利用可能なオプションは次のとおりです。
  • 上書き - 既存のデータを上書きします。行を正確な場所に書き込みます。複数のセルを含む範囲が選択されている場合は、最初の行に書き込みます。
    • 行の位置 - アクティビティが行を上書きする行インデックスの位置です。このインデックスは、[範囲を読み込み] または [繰り返し (各行)] を使用した範囲の行の反復処理から取得できます。0 から開始します。
  • 追加 - 指定した範囲にデータを追加する方法を指定します。最初に見つかった空の行にデータを書き込み、セルを下にシフトして新しい行を挿入します。
    注: 現在は、データの追加は名前付き範囲をサポートしていません。
  • 挿入 - 行を挿入し、新しく挿入した行に書き込みます。
    注:[先頭行をヘッダーとする] をオンにすると、範囲の先頭行がヘッダーと見なされ、位置が 0 の行が次の行になります。
• 書き込む内容 - ブックに書き込まれるデータの種類です。利用可能なオプションは次のとおりです。
  • データ行 - 入力データとしてデータ行を使用します。
  • 配列行 - 入力データとして配列行を使用します。
  • 個々のフィールド - データを個々のターゲット フィールドにマッピングします。 各フィールドを使用して、指定した列に直接書き込みます。 指定されていない列はクリアされず、古いデータが保持されます。
• 書き込むデータ行 / 書き込む配列行 - ブックに書き込まれる、データ行または列配行内のデータです。
• 先頭行をヘッダーとする - 選択すると、範囲のヘッダーを読み取って列ヘッダーが生成されます。このプロパティでは Boolean 値がサポートされています。既定のオプションはオフです。このフィールドは、[書き込む内容] - [個別フィールド] オプションを選択した場合に表示されます。
• ターゲットの各列を管理 - 現在のオブジェクトの追加フィールドを選択します。このフィールドは、[書き込む内容] - [個別フィールド] オプションを選択した場合に表示されます。

注:

Batching API calls is supported for this activity when used inside: For Each Email, For Each File or Folder, For Each Event.

例

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

• シート アクティビティ
• 列を書き込み
• 範囲を読み込み
• 繰り返し (スプレッドシートの各行)