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

OU

• Arquivos.ReadWrite.All

OU

• Sites.ReadWrite.All

Compatibilidade do projeto

Windows | Multiplataforma

Configuração

• Conexão do Microsoft OneDrive & 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 que 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 Ver mais menu de botão ao lado de tipo de Intervalo. Para saber mais, consulte Trabalhar com modelos.

  • Opção de seletor de arquivo/pasta : selecione a pasta ícone para navegar pelos arquivos/pastas do OneDrive ou do SharePoint e selecionar uma planilha. Essa opção aceita entrada como IResource.

    • Use 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 ID :

    • ID da pasta de trabalho — O ID da pasta de trabalho de interesse. Esse campo é compatível com entrada do tipo String .
    • Endereço do site do SharePoint - A URL do site do SharePoint que contém o arquivo ou pasta. Este campo suporta a entrada de tipo String seu site do SharePoint em um navegador e copie seu 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. Esse campo é compatível com entrada do tipo 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.

  • Insira a opção URL :

    • URL da pasta de trabalho — O URL da pasta de trabalho de interesse. Esse campo é compatível com entrada do tipo 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.
• Include headers - This property supports Boolean values. Set to True to also include the DataTable headers into the workbook.
• 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.
  • Anexar à direita - Grave os dados na primeira coluna vazia encontrada. Consulte a seção Anexar abaixo para obter mais informações.
  • Inserir — inserir uma linha.
• Posição da linha — a posição de índice da linha em que 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. Esse campo é compatível com entrada do tipo Int32 .
• O que escrever — os dados na TabelaDeDados a serem escritos na pasta de trabalho. Este campo é compatível com DataTable variáveis. 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 gere 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.

Tipo de intervalo	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, por exemplo, uma média de 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 Write Row/Write Range 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.

Exemplo

Para obter mais detalhes, consulte também os seguintes recursos:

• Excel atividades on-line
• Create Workbook
• Excluir Planilha
• Ler Célula