Read Range

A atividade Read Range, que usa a API Get range do Microsoft Graph para recuperar valores de um intervalo especificado de células (Intervalo) em uma planilha (NomeDaPlanilha) de pasta de trabalho (Pasta de trabalho) no Microsoft 365.

UiPath.MicrosoftOffice365.Activities.Excel.ReadRange

Description

Usa a API Get range do Microsoft Graph para recuperar valores de um intervalo especificado de células (Range) em uma planilha de pasta de trabalho (Workbook) (SheetName). Depois de recuperar o intervalo de dados da célula, a atividade gera os valores em uma DataTable (DataTable).

Escopos

Essa atividade requer os seguintes escopos:

• Sites.Read.All

OU

• Sites.ReadWrite.All

Compatibilidade do projeto

Windows - Legado | Windows

Configuração

Painel de Propriedades

Comum

• NomeDeExibição — o nome de exibição da atividade. Essa propriedade é compatível com variáveis String e valores formatados de string.

Entrada

• Intervalo - O intervalo de células a ser lido. Se nenhum intervalo for especificado, toda a planilha será lida. Insira seu intervalo de células em notação estilo A1 (por exemplo, "A1:A5"). Essa propriedade é compatível com variáveis String e valores formatados de string.

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 .

• Nome da planilha — o nome da planilha a partir da qual os dados são lidos. Essa propriedade é compatível com variáveis String e valores formatados de string.
• Pasta de trabalho — a DriveItem cujos dados são lidos. Este objeto pode ser recuperado usando a atividade Find Files And Folders . Use a variável de propriedade de saída das atividades Find Files and Folders (First ou Results) ou Create Workbook (Workbook). Ao usar a propriedade de saída Resultados da atividade Find Files and Folders , certifique-se de especificar qual item na matriz você deseja usar (por exemplo, myWorkbooks(0)).

Diversos

• Particular — se selecionada, os valores de variáveis e argumentos não são mais registrados no nível Verbose. Esse campo aceita valores Booleanos.

Opções

• Adicionar cabeçalhos - Se estiver selecionado, a primeira linha do intervalo é adicionada como cabeçalhos de coluna sd na TabelaDeDados. Esse campo aceita valores Booleanos.
• Value Type - The type of data that is read from the document. Use the drop-down list to select one of the three options:
  • Values - Default. Retrieves the coded value (i.e., backend) of the cells in the row. This might differ from the format value shown in the Excel worksheet (e.g., if the cell displays 23.00 in the worksheet, the coded value returned is 23).
  • Formulas - Retrieves the formula of the specified cell only (e.g., =SUM(A1,B1)). If you select Formulas and the specified cell doesn't contain a formula, the returned value defaults to Values.
  • Text - Retrieves the Excel worksheet value of the cell (e.g., if the cell displays 23.00 in the worksheet, the text value returned is 23.00).

Saída

• TabelaDeDados - O resultado da leitura. Este campo é compatível apenas com variáveis DataTable . Obrigatório se você planeja usar os dados de saída em atividades subsequentes. Para obter o conteúdo da TabelaDeDados , use uma atividade que tenha uma propriedade de entrada DataTable (por exemplo, Tabela de dados de saída, Para cada linha, Acrescentar a CSV, etc.).

Como funciona

As etapas a seguir e o diagrama de sequência de mensagens são um exemplo de como a atividade funciona desde o tempo de design (ou seja, as dependências da atividade e as propriedades de entrada/saída) até o tempo de execução.

1. Conclua as etapas.
2. Adicione a atividade Microsoft Office 365 Scope ao seu projeto.
3. Adicione uma atividade ou execute um processo externo que gere um objeto DriveItem (por exemplo, Find Files and Folders, Create Workbook, Copy Item).
4. Add the Read Range activity inside the Microsoft Office 365 Scope activity.
5. Insira valores para as propriedades de entrada.
6. Crie e insira uma variável DataTable para a propriedade Saída.
7. Execute a atividade.
   • Seus valores de propriedade de entrada são enviados para a API GetRange .
   • A API retorna o valor DataTable para sua variável de propriedade de saída.