Read Column

UiPath.MicrosoftOffice365.Activities.Excel.ReadColumnConnections

Description

Usa a API Get Range do Microsoft Graph para recuperar valores de células de uma coluna especificada (CélulaInicial) em uma planilha (NomeDaPlanilha) da pasta de trabalho (Pasta de trabalho).

Depois de recuperar o valor da célula, a atividade retorna o valor da coluna em um Object[] (Coluna).

Escopos

Essa atividade requer os seguintes escopos:

• Arquivos.ReadWrite

OU

• Arquivos.ReadWrite.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 coluna. Todas as células contíguas abaixo disso são retornadas. Insira o endereço de uma única célula em notação estilo A1. Essa 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

• Coluna - O conteúdo da coluna como uma array de objetos. Este campo é compatível apenas com variáveis Object[]. Obrigatório se você planeja usar os dados de saída em atividades subsequentes.

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 Column 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.