Write Range

UiPath.MicrosoftOffice365.Activities.Excel.WriteRange

Description

Usa a API de intervalo de atualização do Microsoft Graph para gravar um intervalo de dados de célula (DataTable) a partir de uma célula específica (Célula inicial) em uma planilha de pasta de trabalho ( Pastade trabalho) especificada (SheetName).

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. Esse campo é compatível apenas com variáveis DataTable . 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.
• Nome da Planilha - O nome da planilha na qual os dados são gravados. Esse valor deve corresponder ao nome de uma planilha existente, caso contrário, um erro ItemNotFound será lançado. Esta atividade não cria uma nova planilha se não conseguir localizar o nome especificado nesta propriedade. Esta propriedade oferece suporte a variáveis String e valores formatados em string.
• StartingCell - O endereço no qual a célula superior esquerda da tabela é gravada. Digite o endereço de uma única célula na notação de estilo A1. Esta propriedade não suporta um intervalo de células (por exemplo, "A1:A5"). Esta propriedade oferece suporte a variáveis String e valores formatados em string.
• Pasta de trabalho — a DriveItem do documento a ser modificada. Esse 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 (Primeiro ou Resultados) ou Create Workbook (Pasta detrabalho). Quando estiver usando 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. Este campo aceita apenas valores booleanos.

Opções

• IncluirCabeçalhos — se selecionado, os cabeçalhos da tabela de dados também são inseridos na pasta de trabalho. Este campo só aceita valores boolianos (Rue, False). O valor padrão é True.

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 Workbooke Copy Item).
4. Adicione uma atividade que gere um objeto DataTable (por exemplo, Build Data Table, Generate Data Table).
5. Adicione a atividade Write Range dentro da atividade Microsoft Office 365 Scope.
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.