Use Excel File

UiPath.Excel.Activities.Business.ExcelApplicationCard

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 da Tabela dinâmica
• Tutorial: Iterando através das Linhas de uma Tabela.
• Tutorial: Comparação de arquivos do Excel e envio de e-mails com erros de reconciliação.

Configurando a atividade

No corpo da atividade

• Arquivo do Excel - Clique em Pesquisar ao lado do campo e, em seguida, navegue e selecione um arquivo do Excel, CSV ou texto para usar na automação. Para criar um novo arquivo durante a execução da automação, pesquise a pasta em que deseja criá-lo e insira o nome do arquivo.

  Se você precisar trabalhar com um arquivo com um nome dinâmico, como um arquivo baixado diariamente com um nome diferente, você pode fornecer o caminho do arquivo usando uma das opções no menu Mais no lado direito do campo. Por exemplo, selecione uma célula no Notebook do projeto onde o caminho do arquivo pode ser extraído diariamente usando as fórmulas fornecidas ou selecione Perguntar quando executar para inserir o caminho do arquivo ao executar o projeto. Nessa situação, se você quiser configurar facilmente as atividades que usam dados do arquivo, selecione outro arquivo do Excel com o mesmo formato que um Arquivo de modelo. Ou então, você pode trabalhar com um arquivo Excel remoto inserindo o URL do SharePoint do arquivo.

• Referenciar como — Insira um nome pelo qual se referirá ao arquivo no projeto de automação.

• Salvar mudanças - 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.
  • Padrão — aplica a formatação padrão retornada pelo Excel.
  • Valor Bruto - Recupera os valores brutos do Excel e ignora toda a formatação.
  • Valor da exibição — recupera os valores conforme eles são exibidos no Excel.

• Arquivo de modelo - Se o arquivo do Excel que você deseja automatizar for dinâmico ou não existir no momento em que você projeta a automação (por exemplo, o arquivo é baixado ou criado pela automação), selecione esta opção para usar outro arquivo do Excel que tenha o mesma estrutura em tempo de design.

  Os dados nesse arquivo estão disponíveis para seleção no menu Mais, permitindo que você configure facilmente as atividades adicionadas dentro de Use Excel File. O arquivo de modelo é usado apenas no momento do design. Quando a automação é executada, ela processa o arquivo definido no campo Arquivo do Excel.

Painel de Propriedades

Comum

• NomeDeExibição — o nome exibido para a atividade no painel do Designer.

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.
• Senha — a senha necessária para abrir a pasta de trabalho do Excel, se o arquivo estiver protegido por senha.
• 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.
• Manter arquivo Excel aberto — se o arquivo não estiver aberto no período em que o projeto for executado, manterá a pasta de trabalho aberta após o término da execução do projeto em vez de fechá-la. Isso pode ser usado para revisar o arquivo posteriormente.
• Ler formatação — 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. Esta 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: 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.