列を書き込み

UiPath.MicrosoftOffice365.Activities.Excel.WriteColumnConnections

説明

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

スコープ

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

• 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 を取得します。
• 範囲 - データの書き込みまたは追加先の範囲を指定します。完全な A1 表記を使用してカスタム範囲を使用できます。このプロパティでは、 String 型変数と文字列形式の値がサポートされています。

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

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

• 書き込み方法 - 指定した範囲にデータを追加する方法を指定します。利用可能なオプションは次のとおりです。
  • 上書き - 既存のデータを上書きします。列を正確な場所に書き込みます。複数のセルを含む範囲が選択されている場合は、最初の列に書き込みます。
    • 列の位置 - アクティビティが行を上書きする列インデックスの位置です。このインデックスは、[範囲を読み込み] を使用した範囲の列の反復処理から取得できます。列は 0 から開始します。
  • 右に追加 - データを右に追加します。 既定のオプションです。 書き込み対象の最初の空の列を、右から左に向かって探します。
    注: 現在は、データの追加は名前付き範囲をサポートしていません。
  • 挿入 - 列を挿入します。
    • 列の位置 - アクティビティが行を上書きする列インデックスの位置です。このインデックスは、[範囲を読み込み] を使用した範囲の列の反復処理から取得できます。列は 0 から開始します。
• 書き込む内容 - ブックに書き込まれるデータテーブル内のデータです。利用可能なオプションは次のとおりです。
  • データ列 - 入力データとしてデータ列を使用します。
  • 配列列 - 入力データとして配列列を使用します。
  • 個々のフィールド - データを個々のターゲット フィールドにマッピングします。
• 書き込むデータ列 / 書き込む配列列 - ブックに書き込まれる、データ列または列配列内のデータです。
• ターゲットの各列を管理 - 現在のオブジェクトの追加フィールドを選択します。このフィールドは、[書き込む内容] - [個別フィールド] オプションを選択した場合とスプレッドシートと範囲を選択した場合に表示されます。変数を使用する場合は、スプレッドシートのサンプルが必要です。

例

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

• Excel Online アクティビティ
• 行を書き込み
• 繰り返し (ブック内の各シート)
• 範囲を削除