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 6 de nov de 2024

Read Range

UiPath.MicrosoftOffice365.Activities.Excel.ReadRangeConnections

Description

Lê e salva as informações de um intervalo de células especificado da pasta de trabalho do Excel para uso em outras atividades, como Write Range.

Escopos

Essa atividade requer os seguintes escopos:

  • Sites.Read.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.
    • 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 - Selecione o Intervalo a ser lido após configurar a pasta de trabalho. Esse campo é pré-preenchido com informações recuperadas da planilha ou amostra de planilha selecionada. Também é possível adicionar um intervalo personalizado, como Sheet1C5:F10, um IntervaloNomeado, por exemplo, Clientes, ou um Nome de tabela. 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.

    • Selecione a opção Atualizar tabela se você tiver modificado sua pasta de trabalho e precisar recuperar os dados mais recentes.

    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).
  • Tem cabeçalhos - Esta propriedade oferece suporte a valores booleanos. Defina como True se a primeira linha no intervalo representar uma linha de cabeçalho.

Opções adicionais

Entrada

  • O que ler - O tipo de informação que é lida no intervalo de células: Valores, Valores e Fórmulas, Texto.

Saída

  • Intervalo deleitura — referência às informações recuperadas pela atividade (armazenada como uma variável TabelaDeDados) para uso em outras atividades, como Write Range.
  • Informações de leitura - Detalhes do intervalo selecionado, armazenados em uma variável RangeInformation .
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.

Exemplo



Consulte também:
  • Description
  • Compatibilidade do projeto
  • Configuração
  • Exemplo

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.