Read Range

UiPath.MicrosoftOffice365.Activities.Excel.ReadRangeConnections

Description

Lê e salva as informações de um intervalo de células de pasta de trabalho especificado 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 & 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.

  • 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 - Selecione o Intervalo para leitura após configurar a pasta de trabalho. Esse campo é pré-preenchido com informações recuperadas da planilha ou amostra de planilha selecionada. Você também pode adicionar um intervalo personalizado, como Sheet!1C5:F10, um NamedRange, 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 gere um erro. Por exemplo, Sheet%Test é uma entrada válida, mas Sheet%44 não é (%44 é transformado em D).

Observação:

Esse campo não é compatível com notações A1 apenas com colunas ou apenas com linhas (por exemplo, Sheet1!A:C, Sheet1!2:4). Em vez disso, certifique-se de especificar um intervalo de células delimitada, como Sheet1!A1:C100 .

• Has headers - This property supports Boolean values. Set to True if the first row in the range represents a header row.

Opção adicional

Entrada

• What to read - The type of information that is read from the cell range: Values, Values and Formulas, Text.

Saída

• Intervalo de leitura — referência às informações recuperadas pela atividade (armazenadas 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, 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.

Exemplo

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

• Excel atividades on-line
• Create Workbook
• Delete Range
• Write Range