Suplemento do Excel para o UiPath Assistant

O suplemento do UiPath Assistant para Excel permite usar os recursos do UiPath Assistant no aplicativo nativo do Excel. Isso fornece uma maneira fácil de executar, gerenciar e configurar automações específicas do Excel sem precisar alternar entre aplicativos.

Pré-requisitos

• UiPath Assistant 2023.4.2 ou superior conectado ao Orchestrator com uma licença Attended .
• Pelo menos uma automação com a tag excelAddin ou criada com o Modelo do Studio "UiPath Assistant para o processo do Excel".
• Microsoft Excel 2016 ou posterior, ou Microsoft 365 Excel online.

Observação: atualmente, o suplemento UiPath Assistant para o Excel não é compatível com o Excel para macOS ou navegadores não baseados em Chromium quando usado no Excel online.

Instalando o suplemento

O suplemento do UiPath Assistant para Excel pode ser instalado diretamente da Microsoft Store, ou usando um arquivo de manifesto para adicioná-lo manualmente em sua máquina ou implantá-lo em várias máquinas em seu ambiente.

Importante: o Microsoft Store sempre fornece a versão mais recente do suplemento UiPath Assistant for Excel, que pode interromper a compatibilidade com versões mais antigas do UiPath Assistant. Por isso, a instalação do suplemento no Microsoft Store é recomendada exclusivamente para usuários Community. Para usuários Enterprise, recomendamos implantar o complemento usando o arquivo de manifesto para garantir compatibilidade.

Da Microsoft Store

1. Acesse este link e selecione Obter agora.

Observação:

Você precisa estar conectado à Microsoft Store para concluir o download.

Ou então, você pode adicionar o suplemento do UiPath Assistant para o Excel diretamente da seção Obter suplementos no aplicativo do Excel.

Para fazer isso, siga as etapas abaixo:

1. No Microsoft Excel (tanto desktop quanto online), abra uma planilha e vá para a guia Inserir .
2. Clique em Obter suplementos, insira o ID HA200005457 na caixa de pesquisa e clique em Adicionar.

Como usar o arquivo de manifesto

No Excel Desktop

O suplemento é habilitado por meio do arquivo de manifesto usando um processo chamado "Carregamento lateral". Isso é feito com base nas etapas abaixo:

1. Baixe o arquivo de manifesto na seção Downloads de produtos no Customer Portal.
2. Siga as etapas descritas na documentação da Microsoft sobre esse tópico.
3. No Excel, acesse a guia Inserir e clique em Meus Suplementos, selecione Pasta Compartilhada, clique no bloco UiPath e selecione Adicionar. Uma nova guia chamada UiPath aparece na barra de ferramentas do Microsoft Excel.
4. Selecione a guia UiPath -> Encontrar Automações para ver o suplemento do UiPath Assistant para Excel.

No Excel Online

1. No Excel Online, abra uma planilha e, em seguida, acesse a guia Início.
2. Clique em Suplementos > Meus Suplementos.
3. Clique em Carregar meus Suplementose navegue até o arquivo de manifesto.

Implantação de administrador

1. Baixe o arquivo de manifesto na seção Downloads de produtos no Customer Portal.
2. Em um ambiente de implantação na Cloud , você pode implantar o suplemento na sua organização usando o centro de administração do Microsoft 365. Leia mais sobre como usar aplicativos integrados ou implantação centralizada.

Observação: quando o suplemento é carregado pela primeira vez, a versão mais recente disponível é usada. Depois que a conexão com o UiPath Assistant é criada, a versão do suplemento sincroniza-se com a do UiPath Assistant.

Fazendo login

Quando você abre o suplemento do UiPath Assistant para Excel pela primeira vez, se o Assistant não estiver em execução, você será solicitado a iniciá-lo.

Se você não estiver conectado ao UiPath Assistant ou se nenhuma automação estiver disponível, certifique-se de estar conectado ao Orchestrator com uma licença attended válida e de ter pelo menos uma automação que tenha a tag excelAddin implantada para sua conta.

Criando automações usando o modelo

Para criar uma automação para o UiPath Assistant para Excel, use o Modelo do Studio dedicado com o mesmo nome. Esse modelo apresenta a tag excelAddin e dois argumentos de entrada (in_FilePath e in_Selection) que são preenchidos no runtime, tornando mais fácil colar dados entre o Excel e a automação. Como essas automações têm a tag excelAddin, elas são adicionadas automaticamente ao suplemento UiPath Assistant para Excel depois de publicadas.

Você também pode criar suas próprias automações, certificando-se de que elas tenham a tag excelAddin . Para se beneficiar de qualquer um desses argumentos de entrada, eles precisam ser criados/usados dentro do fluxo de trabalho.

Quando os argumentos de entrada in_FilePath e in_Selection estão presentes em uma automação criada para o suplemento, eles são preenchidos automaticamente da seguinte maneira:

• in_FilePath (String) – representa o caminho do arquivo a partir do qual o complemento inicia o processo.
• in_Selection (String) – representa a(s) célula(s) selecionada(s) quando o processo está começando.

A variável in_Selection usa o esquema [Sheet]![Range], o que significa que, se precisar usar seleções diferentes para planilhas diferentes, você pode criar variáveis separadas a serem usadas como valores para cada planilha ou intervalo.

Observação: se você precisar de mais seleções, crie argumentos de entrada adicionais, novas variáveis de intervalo e novas variáveis de planilha se sua seleção for de uma planilha diferente. Depois disso, arraste e solte o fluxo de trabalho de seleção Analisar Excel na sequência principal e importe os argumentos e variáveis recém-criados.