Append Range

UiPath.MicrosoftOffice365.Activities.Excel.AppendRange

Description

Usa a API Update Range do Microsoft Graph para gravar um intervalo de dados de célula (DataTable) em uma planilha especificada da pasta de trabalho (Workbook) (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.

Escopos

Essa atividade requer os seguintes escopos:

• Arquivos.ReadWrite

OU

• Arquivos.ReadWrite.All

OU

• Sites.ReadWrite.All

Compatibilidade do projeto

Windows - Legado | Windows

Configuração

Propriedades

Comum

• NomeDeExibição — o nome de exibição da atividade. Essa propriedade é compatível com variáveis String e valores formatados de string.

Entrada

• TabelaDeDados — a tabela a ser inserida. Para obter a variável DataTable , crie uma tabela usando a atividade Build Data Table ou Generate Data Table) e use sua variável de propriedade de saída. Se a planilha especificada no Nome da Planilha existir, a TabelaDeDados será adicionada à última linha/coluna de células que contêm dados.
• 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.
• Pasta de trabalho — a DriveItem do documento a ser modificada. Este objeto pode ser recuperado usando a atividade Find Files And Folders . Use a variável de propriedade de saída das atividades Find Files and Folders (First ou Results) ou Create Workbook (Workbook). Ao usar a propriedade de saída Resultados da atividade Find Files and Folders , certifique-se de especificar qual item na matriz você deseja usar (por exemplo, myWorkbooks(0)).

Diversos

• Particular — se selecionada, os valores de variáveis e argumentos não são mais registrados no nível Verbose. Esse campo aceita valores Booleanos.

Como funciona

As etapas a seguir e o diagrama de sequência de mensagens são um exemplo de como a atividade funciona desde o tempo de design (ou seja, as dependências da atividade e as propriedades de entrada/saída) até o tempo de execução.

1. Conclua as etapas.
2. Adicione a atividade Microsoft Office 365 Scope ao seu projeto.
3. Adicione uma atividade ou execute um processo externo que gere um objeto DriveItem (por exemplo, Find Files and Folders, Create Workbook, Copy Item).
4. Adicione uma atividade que gere um objeto DataTable (por exemplo, Criar tabela de dados, Gerar tabela de dados).
5. Add the Append Range activity inside the Microsoft Office 365 Scope activity.
6. Insira valores para as propriedades de entrada.
7. Execute a atividade.
   • Seus valores de propriedade de entrada são enviados para a API UpdateRange .