# Append Range

> `UiPath.MicrosoftOffice365.Activities.Excel.AppendRange`

`UiPath.MicrosoftOffice365.Activities.Excel.AppendRange`

## Description

Uses the Microsoft Graph [Update range](https://docs.microsoft.com/en-us/graph/api/range-update?view=graph-rest-1.0&tabs=http) API to write a range of cell data (**DataTable**) to a specified workbook (**Workbook**) worksheet (**SheetName**).

If the specified worksheet does not exist in the specified workbook, a new worksheet is created with the name you enter in the **SheetName** property. If the worksheet does exist, the **DataTable** is added to the last row/column of cells that contain data.

### Scopes

This activity requires the following scopes:

* Files.ReadWrite

OR

* Files.ReadWrite.All

OR

* Sites.ReadWrite.All

## Project compatibility

Windows - Legacy | Windows

## Configuration
### Properties panel

#### Common

* **DisplayName** - The display name of the activity. This property supports `String` variables and string formatted values.

#### Input

* **DataTable** - The table to insert. To get the `DataTable` variable, create a table using the [Build Data Table](https://docs.uipath.com/activities/other/latest/user-guide/build-data-table) or [Generate Data Table](https://docs.uipath.com/activities/other/latest/user-guide/generate-data-table)) activity and use its output property variable. If the sheet specified in the **Sheet Name** exists, the **DataTable** is added to the last row/column of cells that contain data.
* **Sheet Name** - The name of the sheet to which the data is appended. If the name you enter in this property does not match a sheet name in the specified **Workbook**, a new sheet is created.
* **Workbook** - The `DriveItem` of the document to modify. This object can be retrieved using the [Find Files And Folders](https://docs.uipath.com/activities/other/latest/productivity/office365-find-files-and-folders) activity. Use the output property variable from either the **Find Files and Folders** (**First** or **Results**) or [Create Workbook](https://docs.uipath.com/activities/other/latest/productivity/office365-create-workbook) (**Workbook**) activities. When using the **Results** output property from the **Find Files and Folders** activity, be sure to specify which item in the array that you want to use (e.g., *myWorkbooks(0)*).

#### Misc

* **Private** - If selected, the values of variables and arguments are no longer logged at Verbose level. This field supports Boolean values.

## How it works

The following steps and message sequence diagram is an example of how the activity works from design time (i.e., the activity dependencies and input/output properties) to run time.

1. Complete the steps.
2. Add the [Microsoft Office 365 Scope](https://docs.uipath.com/activities/other/latest/productivity/microsoft-office-365-scope) activity to your project.
3. Add an activity or run an external process that outputs a `DriveItem` object (e.g., [Find Files and Folders](https://docs.uipath.com/activities/other/latest/productivity/office365-find-files-and-folders), [Create Workbook](https://docs.uipath.com/activities/other/latest/productivity/office365-create-workbook), [Copy Item](https://docs.uipath.com/activities/other/latest/productivity/office365-copy-item)).
4. Add an activity that outputs a `DataTable` object (e.g., [Build Data Table](https://docs.uipath.com/activities/other/latest/user-guide/build-data-table), [Generate Data Table](https://docs.uipath.com/activities/other/latest/user-guide/generate-data-table)).
5. Add the **Append Range** activity inside the **Microsoft Office 365 Scope** activity.
6. Enter values for the Input properties.
7. Run the activity.
   * Your input property values are sent to the [UpdateRange](https://docs.microsoft.com/en-us/graph/api/range-update?view=graph-rest-1.0&tabs=http) API.

![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/activities-docs-image-180576-c446a5bc.webp)