Read Range

UiPath.MicrosoftOffice365.Activities.Excel.ReadRange

Description

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). Depois de recuperar o intervalo de dados da célula, a atividade gera os valores em uma DataTable (TabelaDeDados).

Escopos

Essa atividade requer os seguintes escopos:

• Sites.Read.All

OU

• Sites.ReadWrite.All

Compatibilidade do projeto

Windows - Legado | Windows

Configuração

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 serem lidas. Se nenhum intervalo for especificado, a planilha inteira será lida. Digite seu intervalo de células na notação de estilo A1 (por exemplo, "A1:A5"). Esta propriedade oferece suporte a variáveis String e valores formatados em string.
• 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 - O DriveItem cujos dados são lidos. Este objeto pode ser recuperado usando a atividade Localizar arquivos e pastas . 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 Localizar arquivos e pastas , certifique-se de especificar qual item na matriz 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. Este campo aceita valores booleanos.

Opções

• Adicionar cabeçalhos - se selecionado, a primeira linha do intervalo é adicionada aos cabeçalhos de coluna sd no DataTable. Este campo oferece suporte a valores booleanos.

• Tipo de valor - O tipo de dados lidos do documento. Use a lista suspensa para selecionar uma das três opções:

  • Valores - Padrão. Recupera o valor codificado (ou seja, back-end) das células na linha. Isso pode diferir do valor do formato mostrado na planilha do Excel (por exemplo, se a célula exibir 23,00 na planilha, o valor codificado retornado é 23).
  • Fórmulas - Recupera apenas a fórmula da célula especificada (por exemplo, =SUM(A1,B1)). Se você selecionar Fórmulas e a célula especificada não contiver uma fórmula, o valor retornado será Values.
  • Text - Recupera o valor da planilha do Excel da célula (por exemplo, se a célula exibe 23,00 na planilha, o valor do texto retornado é 23,00).

Saída

• DataTable - The result of the read. This field supports only DataTable variables. Required if you plan to use the output data in subsequent activities. To get the DataTable contents, use an activity that has a DataTable input property (e.g., Output Data Table, For Each Row, Append to 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 do Microsoft Office 365 Scope ao seu projeto.
3. Adicione uma atividade ou execute um processo externo que gera um objeto DriveItem (por exemplo, Localizar arquivos e pastas, Criar pasta de trabalho, Copiar item).
4. Adicione a atividade Read Range dentro da atividade Microsoft Office 365 Scope.
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.