Read Row

UiPath.MicrosoftOffice365.Activities.Excel.ReadRowConnections

Description

Usa a API Microsoft Graph Get range para recuperar os valores das células de uma linha especificada (StartingCell) em uma planilha de pasta de trabalho (Workbook) (SheetName).

Após recuperar os dados de todas as células na linha, a atividade retorna uma dinâmica DataRow.

Escopos

Essa atividade requer os seguintes escopos:

• Sites.Read.All

OU

• Sites.ReadWrite.All

Compatibilidade do projeto

Windows | Multiplataforma

Configuração

• Microsoft OneDrive e SharePoint - A conexão para a conta do Microsoft 365 a ser usada na atividade.
• Pasta de trabalho — a DriveItem cujos dados são lidos.
• Exemplo de pasta de trabalho - Selecione um arquivo com os mesmos intervalos do arquivo da variável. Esse campo fica visível quando você seleciona Usar modelo de pasta de trabalho.
• 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.
• Célula — o endereço da célula inicial da linha. Todas as células contíguas à direita disso são retornadas. Insira o endereço de uma única célula em notação estilo A1. Esta propriedade não é compatível com um intervalo de células (por exemplo, "A1:A5"). Essa propriedade é compatível com variáveis String e valores formatados de string.

Entrada

• Tipo de Valor — o tipo dos dados que são lidos do documento. Use a lista suspensa para selecionar uma das seguintes 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).
  • Valores e fórmulas - Recupera os valores e fórmulas da célula especificada apenas (por exemplo, =SUM(A1,B1)).
  • 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

• Row - Os valores da linha como uma matriz de objetos. Este campo suporta apenas Object[] variáveis. Obrigatório se você planeja usar os dados de saída em atividades subseqüentes.

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 Row dentro da atividade Microsoft Office 365 Scope.
5. Insira valores para as propriedades de entrada.
6. Crie e insira uma variável Object[] 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 Object[] para sua variável de propriedade de saída.