activities
latest
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo.
UiPath logo, featuring letters U and I in white
Atividades de produtividade
Last updated 21 de nov de 2024

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 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 docs image 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.

Exemplo



Consulte também:

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.