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 (SheetName) da pasta de trabalho (Workbook).

After retrieving the cell value, the activity returns the column value in an Object[] (Column).

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

Entrada

• Tipo de valor — o tipo de dados que é lido do documento. Use a lista suspensa para selecionar uma das seguintes opções:
  • Values - Default. Retrieves the coded value (i.e., backend) of the cells in the row. This might differ from the format value shown in the Excel worksheet (e.g., if the cell displays 23.00 in the worksheet, the coded value returned is 23).
  • Valores e fórmulas - Recupera os valores e as fórmulas apenas da célula especificada (por exemplo, =SUM(A1,B1)).
  • Text - Retrieves the Excel worksheet value of the cell (e.g., if the cell displays 23.00 in the worksheet, the text value returned is 23.00).

Saída

• Column - The values of the column as an array of objects. This field supports only Object[] variables. Required if you plan to use the output data in subsequent activities.

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 Workbook, Copy Item).
4. Add the Read Column activity inside the Microsoft Office 365 Scope activity.
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.