Write Range

UiPath.MicrosoftOffice365.Activities.Excel.WriteRange

Description

Usa a API Update Range do Microsoft Graph para gravar um intervalo de dados de célula (TabelaDeDados) a partir de uma célula específica (Célula Inicial) em uma planilha de pasta de trabalho especificada (Pasta de trabalho) (NomeDaPlanilha).

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. Este 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á gerado. Esta atividade não cria uma nova planilha se não puder localizar o nome especificado nesta propriedade. Essa propriedade é compatível com variáveis String e valores formatados de string.
• CélulaInicial - O endereço no qual a célula superior esquerda da tabela é gravada. Digite o endereço de uma única célula em notação estilo A1. Esta propriedade não é compatível com um intervalo de células (por exemplo, "A1:A5"). Essa propriedade é compatível com variáveis String e valores formatados de string.
• 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. Este campo só aceita 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 booleanos (True, 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 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 Write 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 .