Read Column

UiPath.MicrosoftOffice365.Activities.Excel.ReadColumn

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

• 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.
• Célula Inicial - O endereço da célula inicial da coluna. Todas as células contíguas abaixo dessa 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.
• 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

• 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

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