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 — a DriveItem cujos dados são lidos. Esse 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 (Primeiro ou Resultados) ou Create Workbook (Pasta detrabalho). Quando estiver usando 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. 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 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 Workbooke Copy 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.