Guia do usuário do StudioX

Última atualização 18 de nov de 2024

Sobre projetos de automação

Um projeto de automação é uma sequência de atividades que um Robô pode executar para automatizar uma série de tarefas que você executa no seu computador. Você cria e visualiza o projeto de automação na aba Designer do StudioX.

Quando você cria um projeto no StudioX, os arquivos do projeto são salvos em uma pasta com o nome do projeto em um local de sua escolha. Por padrão, os projetos são salvos no diretório %USERPROFILE%\Documents\UiPath.

Por padrão, a pasta do projeto inclui os seguintes arquivos e subpastas:

Arquivos
- um arquivo Main.xaml que contém seu fluxo de trabalho principal.
- um arquivo project.json com informações sobre seu projeto de automação.
- um arquivo do Excel, por padrão Project_Notebook.xlsx, se você não tiver configurado o seu projeto para usar um Notebook do projeto diferente.
um arquivo GlobalHandlerX.xaml que contém um fluxo de trabalho projetado para determinar o comportamento do projeto quando um erro de execução for encontrado.
um arquivo RuntimeExecutionError_Template.html que contém um modelo de mensagem de erro a ser exibida quando um erro de execução for encontrado.
Subpastas
- .local — Contém dados em cache local para o projeto.
- .screenshots — Contém capturas de tela informativas geradas nas atividades de automação de interface gráfica, caso alguma seja usada no projeto.
- .settings — Contém configurações de atividades do projeto usadas no tempo de execução.

Definindo a compatibilidade do projeto

Quando você criar um novo projeto, selecione a compatibilidade com base nos aplicativos a automatizar e o ambiente no qual o projeto será executado:

Windows - Selecione essa opção para automações que envolvem aplicativos do Windows, como o Microsoft Office for desktop. As automações podem ser executadas em computadores Windows. Essa é a opção padrão.
Multiplataforma - Selecione essa opção para automações que envolvem aplicativos online, como o Microsoft Office 365 para web e o Google Workspace. As automações podem ser executadas em sistemas operacionais Windows e do tipo Unix, como o Linux e o macOS. Para saber mais sobre como criar projetos multiplataforma, consulte Projetos multiplataforma no guia do Studio.
Windows - Legado - Similar ao Windows, mas baseado em tecnologia legada que está sendo desativada. Essa é a compatibilidade usada em projetos do StudioX criados em versões anteriores. Para obter informações sobre como converter projetos existentes na compatibilidade mais recente do Windows, consulte Conversão de projetos do Windows - Legado para a compatibilidade do Windows

Projetos do StudioX para uso Unattended

Os projetos StudioX são criados apenas para uso Attended, e não recomendamos o uso do StudioX ao desenvolver projetos que de destinem a uso Unattended. Você pode atualizar um projeto do StudioX para uso Unattended no perfil Studio removendo o GEH. Recomendamos que um RPA Developer revise o projeto antes de publicá-lo para uso Unattended, pois ele pode querer adicionar registros em log e manuseio de erros extras e verificar valores codificados que devem ser armazenados como ativos.

Ajustando as Configurações do Projeto

Para ajustar as configurações de cada projeto, selecione Projeto > Configurações do Projeto na barra do StudioX.

Descrição do campo para a Janela de Configurações

Campo	Description
Name	Altere o nome do projeto. Esses nomes podem conter caracteres de espaço em branco. Ao dar nome aos projetos, lembre-se que os caracteres de espaço em branco são removidos no momento da publicação. Este campo aceita até 128 caracteres.
Description	Altere a descrição do projeto. Este campo aceita até 500 caracteres.
Tags de projeto	Você pode adicionar uma ou mais tags ao projeto, quer criando novas tags ou reutilizando aquelas já definidas no Orchestrator. Existem dois tipos de tags: rótulos e propriedades (pares de chave-valor). As tags são incluídas no pacote publicado e ajudam a descrever e categorizar projetos. Por exemplo, elas podem se referir à aplicação automatizada (um rótulo `Excel`) ou ao departamento (uma propriedade de chave-valor de `department:accounting`). Quando você começa a digitar, são sugeridas combinações possíveis a partir de tags já definidas, e você pode reutilizar uma delas selecionando-a na lista de correspondências. Para uma correspondência da propriedade, a chave seguida pelo caractere `:` (dois pontos) é exibida primeiro, e os valores associados são exibidos depois de você selecionar a chave, Para adicionar uma nova tag, depois de digitar o nome, clique na entrada com o sinal de mais ao lado do nome. Separar strings com o caractere `:` (dois pontos) habilita você a adicionar propriedades, enquanto as entradas que não contêm um `:`adicionam rótulos. Os rótulos e propriedades de chave-valor são limitados a 256 caracteres. Nomes de tags não podem conter estes caracteres: `<`, `>`, `%`, `&`, `\`, `?`, `/`, `:`. As tags de projeto podem ser aplicadas automaticamente a processos no Orchestrator. Para obter mais informações sobre o uso de tags, consulte Organização de recursos com tags no Guia do Orchestrator.
URL do Automation Hub	URL de uma ideia do Automation Hub vinculada ao projeto. Para obter mais informações, consulte Vincular um projeto a uma ideia no Automation Hub.
Ícone do Pacote	Opcionalmente, defina um ícone personalizado para o projeto. Você pode procurar e selecionar um arquivo ou inserir um caminho ou URL público para um `jpeg`, `jpg` ou arquivo `png` de até 1 MB. Após a publicação do projeto, o ícone é exibido da seguinte maneira: Para automações de tarefas, no Assistant ao lado do nome do processo, facilitando a identificação na lista de processos. Para modelos, ao lado do modelo em Início (modo de exibição Backstage do Studio) > Modelos. Observação: o ícone não fica visível em Gerenciar pacotes se um arquivo local estiver sendo usado em uma biblioteca publicada no Orchestrator ou um feed que não suporta ícones incorporados. Nesse caso, especifique o ícone usando uma URL.
Opções de PiP	Indique se o projeto foi testado usando o Picture in Picture (PiP) e se ele deve ser iniciado no PiP por padrão. Testado para uso do PiP; Começando no PiP - A automação foi aprovada para ser executada no modo PiP. Ao ser executada, ela é iniciada no PiP por padrão. Testado para uso do PiP; Não começando no PiP por padrão - A automação foi aprovada para ser executada no modo PiP. Ao ser executada, ela é iniciada na sessão principal ou na área de trabalho por padrão. Não testada para uso do PiP - A automação não foi aprovada para ser executada no modo PiP. Quando executada, ela começa na sessão principal ou na área de trabalho por padrão. Se for executada em PiP, uma caixa de diálogo informa ao usuário que ela não foi testada usando esse recurso e solicita uma confirmação antes de prosseguir.
Tipo de PiP	Selecione como isolar a automação da sessão do usuário ao executar o projeto em PiP: Nova sessão (sessão filho na máquina) ou Nova área de trabalho (área de trabalho virtual na sessão do usuário).

Publicação de Projetos de Automação

Publicar um projeto de automação significa arquivar o fluxo de trabalho e todos os outros outros arquivos na pasta do projeto para que tudo seja enviado para Robôs e depois executado.

Se o Robô estiver conectado ao Orchestrator, você pode publicar os projetos do StudioX no Orchestrator e executá-los no Assistente UiPath. Se o Robô não estiver conectado ao Orchestrator, você pode publicar seus projetos nos Robôs padrão e executá-los no UiPath Assistant.

O processo de publicação para o StudioX é o mesmo do Studio. Para obter mais informações, consulte Sobre a publicação de projetos de automação no Studio Guide.