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 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:

• Excel atividades on-line

• Create Workbook
• Delete Range
• Write Range