Use Excel File

UiPath.Excel.Activities.Business.ExcelApplicationCard

Description

Permite selecionar um arquivo do Excel para usar na automação e permite que o StudioX se integre com o Excel. Os dados do arquivo estão disponíveis para todas as atividades adicionadas em Usar Arquivo Excel. Isso significa que, ao configurar atividades filhas, você pode selecionar dados do arquivo diretamente do StudioX. Se o arquivo do Excel não existir no momento em que você criar a automação, você poderá definir um arquivo do Excel existente com a mesma estrutura de um modelo para uso no momento do design.

Você pode adicionar atividades UI Automation diretamente na atividade Use Excel File para automatizar rapidamente a interface do Excel. Para que isso funcione, você precisa ter o arquivo do Excel aberto em sua máquina.

Observação:

Se você usar um arquivo com a extensão .xls todas as atividades compatíveis com o Excel para arquivos .xls funcionarão no runtime. No entanto, o conteúdo do arquivo não está disponível para seleção diretamente no menu Mais ao criar a automação no designer. Para selecionar dados do arquivo, use as opções Indicar no Excel e Entrada personalizada ou salve uma cópia .xlsx do arquivo e adicione-o como um Arquivo de modelo.

Para saber como usar esta atividade, consulte:

• Tutorial: criação de uma Tabela dinâmica.
• Tutorial: Iterando através das Linhas de uma Tabela.
• Tutorial: Comparar arquivos do Excel e enviar e-mails com erros de reconciliação.

Configurando a atividade

Painel do Designer

• Excel file - Select Browse next to the field, and then browse to and select an Excel, CSV, or text file to use in the automation. To create a new file when the automation is executed, browse to the folder where to create it and enter the file name. If you need to work with a file with a dynamic name, such as a file downloaded daily under a different name, you can provide the file path using one of the options in the Plus menu on the right side of the field. For example, select a cell in the Project Notebook where the file path can be extracted daily using the provided formulas, or select Ask when run to enter the path of the file when executing the project. In this situation, if you want to be able to configure the activities that use data from the file, select another Excel file with the same format as a Template file. Alternatively, you can work with a remote Excel file by inputting the SharePoint URL of the file.
• Reference as - Enter a name by which to refer to the file in the automation project.
• Salvar alterações - Selecione essa opção se você quiser salvar o arquivo após cada atividade do Excel que faz uma alteração no seu conteúdo. Use a atividade Save Excel File se essa opção estiver desabilitada. Esta opção é selecionada por padrão. Quando a opção de salvar alterações estiver desabilitada, a mensagem salvamento desabilitado será exibida ao lado do recurso do Excel no painel Data Manager.
• Criar se não existir - Se estiver selecionado, uma nova pasta de trabalho do Excel é criada se a pasta de trabalho não for encontrada no caminho especificado. Se não estiver selecionado, ocorre um erro se a pasta de trabalho não for encontrada no caminho especificado. Esta opção é selecionada por padrão.
• Formatação de leitura - Escolha qual formatação deve ser aplicada aos valores lidos do Excel:
  • Igual ao projeto — a configuração herda o valor das Configurações do projeto.
  • Default - Applies the default formatting returned by Excel.
  • Raw Value - Retrieves the raw values from Excel and ignores all formatting.
  • Display Value - Retrieves the values as they are displayed in Excel.
• Template file - If the Excel file you want to automate is dynamic or does not exist at the time you design the automation (for example, the file is downloaded or created by the automation), select this option to use another Excel file that has the same structure at design time. The data in this file is available for selection from the Plus menu, letting you configure the activities added inside Use Excel File. The template file is used only at design time. When the automation is executed, it processes the file defined in the Excel file field.

Painel de Propriedades

Comum

• DisplayName - The name displayed for the activity in the Designer panel.

de transações

• Editar senha - A senha necessária para editar a pasta de trabalho do Excel se o arquivo tiver proteção por senha.
• Password - The password required for opening the Excel workbook, if the file is password-protected.
• Caminho da pasta de trabalho - O caminho para o arquivo do Excel. Se o arquivo não existir e você selecionar a opção CriarNovoArquivo, ele será criado pelo StudioX.

Diversos

• Particular — se selecionada, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Opções

• Criar se não existir — consulte a descrição no corpo da atividade.
• Keep excel file open - If the file is not open at the time the project runs, keeps the workbook open after the project finished running instead of closing it. This can be used to review the file afterwards.
• Formatação de leitura - Consulte a descrição no corpo da atividade.
• SomenteLeitura - Se estiver selecionado, a pasta de trabalho especificada é aberta no modo SomenteLeitura. Marcar essa caixa de seleção habilita você a executar operações de extração de dados em um arquivo do Excel que está bloqueado para edição ou que tem senha para edição. Essa opção não está selecionada por padrão.
• Salvar mudanças - Consulte a descrição no corpo da atividade.
• Rótulo de confidencialidade - O ID de string do rótulo de confidencialidade ou uma instância do IExcelLabelObject. É usada apenas quando a operação de confidencialidade é Adicionar/Atualizar. Caso contrário, é ignorada.
• Operação de confidencialidade - Selecione o comportamento para o rótulo de confidencialidade anexado ao arquivo. Use o menu suspenso para escolher entre as seguintes opções: Não fazer nada, Adicionar/Atualizar ou Limpar.

Observação:

• Há uma limitação conhecida onde um erro de objeto COM ocorre para a atividade Use Excel File . Isso acontece quando você mantém aberto um arquivo do Excel em uma Excel Process Scope e, em seguida, reutiliza o mesmo arquivo em uma Excel Process Scope diferente.
• As atividades do Excel representam o usuário conectado ao aplicativo Excel. Quando o UiPath Robot executa os trabalhos, ele recupera automaticamente as permissões do usuário do Excel. Portanto, nenhuma configuração adicional é necessária para que o UiPath Robot interaja com rótulos de confidencialidade. Para obter mais informações, consulte Trabalhando com rótulos de confidencialidade.