Write Range

UiPath.MicrosoftOffice365.Activities.Excel.WriteRangeConnections

Description

Grava uma variável DataTable em um intervalo de células de pasta de trabalho do Excel especificado.

Escopos

Essa atividade requer os seguintes escopos:

Arquivos.ReadWrite

Arquivos.ReadWrite.All

Sites.ReadWrite.All

Compatibilidade do projeto

Windows | Multiplataforma

Configuração

Conexão do Microsoft OneDrive e SharePoint — A conexão para a conta do Microsoft 365 que será usada na atividade.
Pasta de trabalho — A pasta de trabalho do Excel que será usada. O método para especificar a pasta a ser recuperada: Seletor de pasta, Inserir ID, Inserir URL.
- Exemplo de pasta de trabalho — O modelo de pasta de trabalho que será usado. O campo fica visível após clicar em Usar modelo de pasta de trabalho . Navegue pelas pastas do OneDrive e selecione uma pasta de trabalho. No Studio Desktop, a opção está disponível na página Veja mais menu de botões ao lado de Tipo de intervalo. Para saber mais, consulte Trabalho com modelos.
- Opção Seletor de arquivo/pasta : clique na pasta para navegar pelos arquivos/pastas do OneDrive ou do SharePoint e selecionar uma planilha. Essa opção aceita entrada como IResource.
  - Use o menu do botão Ver mais para usar uma variável ou selecione a opção Recarregar dados da pasta se você tiver modificado suas pastas e precisar recuperar os dados mais recentes.
- Insira a opção de ID :
  - ID da pasta de trabalho — O ID da pasta de trabalho de interesse. Essa propriedade é compatível com variáveis String e valores formatados de string.
  - Endereço do site do SharePoint — O URL do site do SharePoint que contém o arquivo ou pasta. Essa propriedade é compatível com variáveis String e valores formatados de string. Abra seu site do SharePoint em um navegador e copie sua URL, por exemplo, https://yourcompany.sharepoint.com/sites/ProductOfficial.
  - Biblioteca de documentos do SharePoint — A biblioteca de documentos dentro do site do SharePoint indicado que contém o arquivo ou pasta. Essa propriedade é compatível com variáveis String e valores formatados de string. Abra a guia Documentos em seu site do SharePoint e copie o URL, por exemplo, https://yourcompany.sharepoint.com/sites/ProductOfficial/Shared%20Documents/Forms/AllItems.aspx.
- Opção Insira Url:
  - URL da pasta de trabalho — O URL da pasta de trabalho de interesse. Essa propriedade é compatível com variáveis String e valores formatados de string. Recupere o URL abrindo o arquivo em um navegador.
Intervalo - O intervalo a ser escrito. Esse campo é pré-preenchido com informações recuperadas da planilha ou amostra de planilha selecionada. Essa propriedade é compatível com variáveis String e valores formatados de string.
- Selecione a opção Atualizar intervalos se você tiver modificado suas planilhas e precisar recuperar os dados mais recentes.
Incluir cabeçalhos - Esta propriedade oferece suporte a valores booleanos. Defina como True para incluir também os cabeçalhos DataTable na pasta de trabalho.
Como escrever - Especifica como adicionar os dados ao intervalo especificado. As opções disponíveis são:
- Substituir - Substitua quaisquer dados anteriores que existam.
- Acrescentar - Grave os dados na primeira linha vazia encontrada.
- Acrescentar à direita - Grave os dados na primeira coluna vazia encontrada. Consulte a seção Anexar abaixo para obter mais informações.
- Inserir - Insira uma linha.
Posição da linha — a posição do índice da linha na qual a atividade deve inserir a linha. O índice pode ser usado para iterar em cada linha ou nas linhas do intervalo usando o intervalo de leitura. Esse campo é exibido se você selecionar Como escrever – Inserir. Este campo é compatível com entrada do tipo Int32 .
O que escrever - Os dados na TabelaDeDados a serem gravados na pasta de trabalho. Este campo aceita variáveis DataTable . Por exemplo, você pode usar a variável de saída de uma atividade Read Range .

Observação: algumas combinações de caracteres especiais na propriedade Nome da planilha/intervalo podem fazer com que a atividade lance um erro. Por exemplo, Sheet%Test é uma entrada válida, mas Sheet%44 não é (%44 é transformado em D).

Anexando

No momento, a anexação de dados não é compatível com intervalos nomeados.

	Acrescentar (à parte inferior)	Anexar à Direita
Intervalo simples (notação A1)	Grave o intervalo na primeira linha vazia encontrada no intervalo de destino. Ele cria o número de linhas necessárias e preenche o intervalo com o intervalo de entrada. Se não houver uma linha vazia no intervalo, anexe o intervalo na parte inferior. Insira o número necessário de linhas e adicione o intervalo de entrada.	Grave o intervalo na primeira coluna vazia encontrada no intervalo de destino. Isso cria o número de colunas necessárias e preenche o intervalo com o intervalo de entrada. Se não houver uma coluna vazia no intervalo, anexe o intervalo à direita inserindo o número necessário de colunas e adicionando o intervalo de entrada.
Intervalo nomeado	Grave o intervalo na primeira linha vazia encontrada no intervalo de destino. Ele cria o número de linhas necessárias e preenche o intervalo com o intervalo de entrada. Se não houver uma linha vazia no intervalo, anexe o intervalo na parte inferior. Insira o número necessário de linhas e adicione o intervalo de entrada.	Grave o intervalo na primeira linha vazia encontrada no intervalo de destino. Ele cria o número de linhas necessárias e preenche o intervalo com o intervalo de entrada. Se não houver uma linha vazia no intervalo, anexe o intervalo na parte inferior. Insira o número necessário de linhas e adicione o intervalo de entrada.
Planilhas	Grave o intervalo na primeira linha vazia encontrada na planilha de destino. Ele cria o número de linhas necessárias e preenche o intervalo com o intervalo de entrada. Se não houver uma linha vazia no intervalo, anexe o intervalo na parte inferior. Insira o número necessário de linhas e adicione o intervalo de entrada.	Grave o intervalo na primeira coluna vazia encontrada na planilha de destino. Isso cria o número de colunas necessárias e preenche o intervalo com o intervalo de entrada. Se não houver uma coluna vazia no intervalo, anexe o intervalo à direita inserindo o número necessário de colunas e adicionando o intervalo de entrada.

Limitações conhecidas para solicitações

Esteja ciente dos limites de solicitação/resposta ao trabalhar com intervalos. O limite é de 4 MB, ou seja, em média 10.000 células com 20 caracteres cada para solicitações de leitura, 4.000 células com 20 caracteres cada para solicitações de gravação. Para obter mais informações, consulte Especificações e limites do Excel.

Limitação conhecida

Ocorrerá um erro se você usar Gravar linha/Gravar intervalo com a opção Acrescentar e o intervalo de destino for uma planilha que contém uma tabela vazia no início (sem outros dados). A atividade tenta inserir uma linha na planilha, no início da tabela, mas a API do Graph retorna um erro.