Sobre projetos de automação

UiPath Studio allows you to create two types of standalone automation projects: process or library. Processes can incorporate all types of workflows, sequence, flowchart, state machine and global exception handler, while the global exception handler isn't available for libraries. Moreover, libraries can be added as dependencies to automation processes.

Quando você inicia um novo processo no Studio, uma pasta é criada com seu nome personalizado para o local selecionado.Os projetos são salvos no diretório %USERPROFILE%\Documents\UiPath por padrão, a menos que esse local seja alterado manualmente.

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

• Arquivos
  • Main.xaml - Created by default to hold your main workflow. In addition, all the other automation XAML files you add to the project are stored in the project folder. Optionally, you can set a different file as main. All the files must be linked through the Invoke Workflow File activity to the file set as main or to a file marked as an entry point to the project. In the case of test projects created in Studio Pro, a TestCase.xaml file is created by default instead of Main.xaml.
  • project.json — Contém informações sobre seu projeto de automação.
• Subpastas

  • .entities — Contém dados sobre entidades importadas do Data Service, caso alguma seja usada no projeto.

  • .local — Contém dados em cache local para o projeto.

  • .objects — Contém dados relacionados a itens adicionados ao Repositório de Objetos, caso algum seja usado no 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.

  • .tmh — Contém dados relacionados a casos de teste, caso algum seja usado no projeto.

    Observação:

    Projetos criados com versões mais recentes do Studio podem não funcionar com versões mais antigas. Leia mais sobre a Compatibilidade com versões anteriores e posteriores.

    Você não pode usar os seguintes caracteres em nomes de arquivo:", <, >, |, :, *, ?, \, /,; Esses caracteres vêm de restrições do Microsoft Windows e de outras restrições de caracteres especiais.

Definição do Idioma do Projeto

Projetos criados nos perfis do Studio e do StudioX usam a linguagem VB.NET para expressões.

Quando você cria um projeto no perfil do Studio Pro, pode escolher VB ou C#. VB é a linguagem selecionada por padrão, mas você pode definir C# como a linguagem padrão para novos projetos acessando Início (Modo de exibição Backstage do Studio) > Configurações > Design. Observe que projetos em C# só podem ser abertos a partir do perfil do Studio Pro.

O uso de expressões em VB e C# no mesmo projeto não é suportado. Também não é suportado o uso de expressões VB nos fluxos de trabalho C# e vice-versa. Quando você copiar e colar atividades de outros projetos, invocar ou importar fluxos de trabalho, certifique-se de que elas usam a mesma linguagem que o seu projeto.

Você pode instalar bibliotecas C# como dependências nos projetos VB e vice-versa. No entanto, os valores padrão definidos para argumentos no projeto da biblioteca usando expressões específicas de linguagem não podem ser acessados a partir do projeto em que a biblioteca está instalada.

Limitações da Linguagem C#

• A implementação C# atual é baseada no compilador C# que usa a versão 5 do C#, portanto, o acesso a recursos mais recentes, como atribuição de coalescência, operador condicional nulo, operador de coalescência nula, interpolação de string e outros, é limitado.
• Projetos que contenham expressões com incrementos são inválidos.
• Expressões que contenham o operador nameof() são marcadas como inválidas e não são permitidas com a implementação atual do C#.
• Expressões que contenham chamadas a métodos com argumentos opcionais devem incluir valores para os argumentos opcionais.
• O desempenho do tempo de design e do tempo de execução dos projetos em C# é menor quando comparado à VB.NET. Quando o desempenho do tempo de execução é essencial, recomendamos usar VB.NET em vez de C#.

Configurando a Versão do Projeto

Controle de versão semântico

O esquema de versionamento semântico tem o formato Major.Minor.Patch[-Suffix], onde:

• Major é a versão principal.
• Minor é a versão secundária.
• Patch é a versão da correção.
• -Suffix (opcional) é um hífen seguido de uma série de identificadores separados por ponto imediatamente após a versão da correção. Isso indica uma versão de pré-lançamento.

Os identificadores devem incluir somente caracteres alfanuméricos e hífens do ASCII e não devem estar vazios. Os identificadores numéricos não devem incluir os zeros à esquerda. Além disso, os metadados da compilação podem ser indicados anexando-se um sinal de mais e uma série identificadores separados por pontos, logo após o patch ou a versão de pré-lançamento como, por exemplo, 1.0.0-alfa+1.

Ao criar um processo ou biblioteca, o esquema da versão padrão será semântico. Ele pode ser alterado na janela Publicar, bastando adicionar um dígito extra ao número da versão. Também é possível modificar a versão semântica do projeto a partir do arquivo project.json. O patch de número 0 é automaticamente adicionado aos projetos com número de versão major.minor.

Controle de Versão Legada

O número da versão legada, gerado para o projeto tem o formato M.m.bbbb.rrrrr, onde:

• M é a versão principal.
• m é a versão secundária.
• bbbb é a versão da compilação.
• rrrrr é a versão de revisão.

As versões principais e secundárias também podem ser editadas no arquivo project.json, enquanto as versões de compilação e revisão são geradas de acordo com um algoritmo. O valor de compilação é o número de dias decorridos desde 01.01.2000. O valor da revisão é o número de segundos decorridos do dia atual até o momento do lançamento. O resultado é dividido por 2, para que o número máximo de revisão não exceda 653555.

O número da versão, sugerido na janela Publicar é gerado com base no esquema anterior de controle de versões, ao passo que a data atual e o carimbo de data/hora são considerados para projetos que utilizam o esquema de controle de versão de quatro dígitos.

Gerenciando projetos

O painel Projeto permite que você visualize o conteúdo do projeto atual, adicione pastas, abra o local do arquivo, gerencie dependências e ajuste as definições do projeto.

Copie e cole os arquivos do Explorador de Arquivos diretamente no painel Projeto. O mesmo pode ser feito com o recurso arrastar e soltar em um ou vários arquivos, incluindo os fluxos de trabalho .xaml. Osando os atalhos de teclado Ctrl + C e Ctrl + V você pode copiar um arquivo e duplicá-lo em outro lugar da árvore.

Opção	Description
Expandir Tudo	Expande todos os nós no projeto de automação.
Recolher Tudo	Fecha todos os nós no projeto de automação.
Atualizar	Atualiza o projeto.
Mostrar Todos os Arquivos	Mostra todos os arquivos que pertencem ao projeto de automação, incluindo o project.json.
Explorador de Arquivos	Abre o local do projeto na máquina.
Configurações do projeto	Abre a janela Configurações do Projeto para processos ou bibliotecas.
Remover Capturas de Tela não Utilizadas	Remove capturas de tela que não são usadas durante a execução do projeto de automação.

Menu de contexto para Projetos

Para abrir o menu de contexto com as opções descritas na tabela a seguir, clique com o botão direito do mouse em qualquer lugar do painel Projeto. Dependendo do lugar onde você clicar no painel, um outro subconjunto de opções é disponibilizado: o tipo de projeto e se ele foi adicionado ao controle de origem.

Opção	Description
Abrir Pasta do Projeto	Abre a pasta local que contém o projeto.
Configurações do projeto	Abre a janela Configurações do Projeto para ajustar preferências do projeto.
Adicionar	Opens a list of items that can be added to the project: folder, sequence, flowchart, state machine or global handler.
Importar fluxos de trabalho	Importa os arquivos .xaml para o projeto e adiciona o termo Importado ao nome do arquivo, caso ele coincida com o nome do arquivo principal.
Importar Arquivos	Abre a janela do Explorador de arquivos para importar vários arquivos para o seu projeto.
Adicionar ao Controle de Origem	Adds the current project to source control using Git Init, Copy to Git, Add to TFS, or Add to SVN options. Please note that this option is only visible when right-clicking the project node. When a project is added to source control, additional options are available in the context menu. See the options for GIT and the options for SVN and TFS.
Abrir	Abre os arquivos selecionados com o programa padrão.
Abrir Local do Arquivo	Abre a pasta local que contém o arquivo.
Renomear	Permite renomear o arquivo ou pasta selecionado, abrindo a janela Renomear Item. O item é renomeado em todas as ocorrências.
Excluir	Exclui o item selecionado somente da máquina local.
Selecionar para Comparar	Seleciona o arquivo atual para fins de comparação.
Comparar com Selecionado	Compares the current file with the previously selected file using Compare Files.
Encontrar Referências	Finds all references to the file in the project. The results are displayed in the Find References panel.
Depurar Arquivo	Depura o arquivo .xaml selecionado.
Definir como Principal	Define o arquivo .xaml selecionado como Principal na definição do projeto, o que significa que a execução do projeto é iniciada por esse arquivo. Somente pode haver um único arquivo de projeto Principal. O nome do arquivo definido como principal aparece em negrito no painel Projeto.
Propriedades	Abre a janela Propriedades da biblioteca para adicionar uma dica de ferramenta e o link de Ajuda.
Definir como Manipulador Global	Define o arquivo .xaml como o Gerenciador de Exceção Global do projeto. Isto se aplica a um fluxo de trabalho por projeto/processo.
Remover Manipulador	Remove a tag de Gerenciador de Exceção Global do arquivo .xaml.
Ativar Ponto de Entrada	Marks the selected workflow file as an entry point for the process, making it possible to select it as the workflow to run first when using the Invoke Process and Run Parallel Process activities in other processes. When a file is marked as an entry point, an arrow is displayed on the icon next to the file name . Habilitar um arquivo que foi ignorado da publicação como ponto de entrada define o arquivo como publicável. Esta opção não está disponível para arquivos de caso de teste. Esta opção não está disponível em projetos de biblioteca.
Desativar Ponto de Entrada	Deixa de marcar o arquivo do fluxo de trabalho selecionado como ponto de entrada para o processo. Esta opção não está disponível para o arquivo de fluxo de trabalho definido como Principal.
Ignorar da Publicação	Marca um ou mais arquivos selecionados como excluídos da publicação. When a file is ignored from publishing, the icon next to the file name turns gray . Ignorar um arquivo marcado como ponto de entrada da publicação desabilita o ponto de entrada. In a library project, a file that is ignored from publishing is included in the package, but no reusable component is created and made available in the Activities panel in projects where the library is installed as a dependency.
Definir como Publicável	Marca um ou mais arquivos selecionados que foram excluídos da publicação como publicáveis.

Opções do Menu de Contexto para o GIT

Em projetos adicionados aos repositórios do GIT, um ícone é exibido ao lado de cada arquivo no painel Projeto para indicar seu status:

O arquivo é sincronizado com o repositório.

O arquivo foi modificado.

O arquivo foi adicionado.

Right-click a file or project node in the Project panel to open the GIT-specific context menu for Managing Projects with GIT.

Opção	Description
Confirmar	Confirma as alterações atuais no repositório local do GIT.
Enviar por Push	Envia por push a versão atual para o repositório remoto.
Efetuar Pull (troca de base)	Efetua pull dos arquivos remotos e troca a base da ramificação atual.
Gerenciar Ramificações	Abre a janela do GIT com opções de gerenciamento das ramificações adicionadas no momento.
Mostrar Alterações	Abre a janela File Diff para comparar as alterações entre a versão local e a versão remota do arquivo.
Mostrar histórico	Abre a janela Mostrar Histórico para comparação de duas versões do mesmo arquivo.
Desfazer	Abre a janela Desfazer Alterações Pendentes se o arquivo não tiver sido confirmado ou enviado por push para o repositório remoto.

Opções do menu Contexto para o SVN e o TFS

Nos projetos adicionados aos repositórios do SVN ou do TFS, um ícone é exibido ao lado de cada arquivo no painel Projeto para indicar o status do arquivo:

Não é feito check-out do arquivo para edição.

Foi feito check-out do arquivo para edição.

O arquivo foi editado.

O arquivo foi adicionado.

Right-click a file or project node in the Project panel to open the context menu with options specific to managing projects with TFS or SVN.

Opção	Description
Abrir	Abre o arquivo .xaml selecionado no painel Designer em modo somente leitura se não tiver sido verificado para edição a partir do repositório do TFS/SVN.
Renomear	Permite renomear o arquivo ou pasta selecionado, abrindo a janela Renomear Item. Ao fazer registo de entrada no arquivo .xaml renomeado, será necessário fazer registo de entrada na versão modificada anteriormente.
Excluir	Exclui o item selecionado somente da máquina local. A última versão em que se realizou registo de entrada do arquivo ainda estará disponível no repositório de TFS/SVN.
Fazer check-out para editar	Marca o arquivo ou pasta selecionada como bloqueada para edição. Fazer check-out de um arquivo o bloqueia no servidor, de modo que ninguém mais possa editá-lo.
Finalizar Edição	Registra o arquivo project.json no repositório com as alterações e uma mensagem de confirmação.
Adicionar	Carrega o item selecionado no servidor TFS/SVN. Esta opção não estará disponível se o item tiver sido previamente carregado no servidor.
Obter versão mais recente	Faz download da versão mais recente do item selecionado do repositório do TFS/SVN.
Mostrar alterações...	Abre o File Diff para comparar as alterações entre o arquivo com versão e o que tiver sido mapeado localmente.
Fazer Check-In	Exibe a janela Check in de Alterações, permitindo carregar o item selecionado no servidor como a versão mais recente. O arquivo .xaml deve ser salvo antes de ser carregado. Depois que seu check in é feito, o arquivo se torna somente leitura no Studio.
Desfazer	Mostra a janela Desfazer Alterações Pendentes, permitindo reverter as alterações feitas ao projeto, seja a reversão de arquivos modificados para estados anteriores ou sem versão ou recuperar arquivos que foram excluídos da máquina local. As alterações não podem ser revertidas após o arquivo ser verificado.
Executar	Executa o fluxo de trabalho selecionado, mesmo se ele não tiver sido feito o check-out ou adicionado ao repositório.
Definir como Principal	Define o arquivo .xaml selecionado como Principal no projeto. O primeiro .xaml criado, por padrão, é definido como Principal.

Ajustando as Configurações do Projeto

Um conjunto de configurações individuais pode ser determinado em relação a cada projeto de automação em que você estiver trabalhando. As configurações ficam disponíveis na janela Configurações do Projeto, que pode ser aberta clicando em , no painel do Projeto.

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.
Desabilitar Pausa	Permitir ou evitar que os usuários pausem os processos na bandeja do Robô. Definir como Sim se pausar o processo durante a execução provocaria uma pane no mesmo. Por exemplo, se uma atividade no seu fluxo de trabalho usa a propriedade Timeout, pausar a execução faria o tempo limite expirar e interromperia a execução.
Inicia em Segundo Plano	Set to Yes to turn the project in a Background Process and allow it to run in the background concurrently with other processes, as long as it does not use UI interaction.
Oferece Suporte à Persistência	Set to Yes to turn the project in an Orchestration Process.
Pronto para PiP	Set to Yes to indicate that the project was tested using Picture in Picture. If set to No, the option to use this feature is not available for the process.
Inicia no PiP	Defina como Sim para indicar que o processo deve ser executado por padrão, usando o recurso Picture in Picture.
Experiência de Criação Moderna	Set to Yes to enable a modern experience of working with UI Automation, including new and improved activities, recorders, and wizards, as well as the Object Repository.

Clique em OK e as alterações ficarão visíveis no painel Projeto e no arquivo project.json.

Check out the Configuring Activity Project Settings page to read about how to adjust activity properties at project level.

Observação:

Considere que sempre que você desejar copiar uma quantidade grande de atividades de uma sequência para outra, é recomendável primeiro rolar até a parte inferior do painel Designer. Isso é devido a uma limitação do Windows Workflow Foundation.

Sobre o arquivo Projetor.Json

Project.json é um arquivo gerado automaticamente que é criado para cada arquivo .xaml marcado como Principal na pasta do projeto.

The file holds varied information, including project dependencies, or web services loaded in libraries. For more information about web services in libraries, check out the Loading Web Services in Libraries page.

Observação:

Manually editing the project.json file should be attempted for troubleshooting scenarios only, as it may lead to severe consequences and loss of support. As of 2018.2, you should specify a project.json file when running your project from the UiRobot.exe (command line) client.

Os parâmetros contidos no arquivo Project.json são descritos na seguinte tabela.

Parâmetro	Description
name	O título do projeto de automação. Ele é fornecido no Studio ao criar um processo ou uma biblioteca.
description	A descrição do projeto. Ela é fornecida no campo Descrição no Studio quando um novo projeto é criado.
main	O ponto de entrada do projeto de automação. Ele consiste em um arquivo .xaml. O nome padrão é "Main.xaml".Ele é exibido como o título do painel Designer e no painel Propriedades no Studio. Se quiser executar um projeto diferente, altere o valor desse parâmetro para o nome do arquivo .xaml a ser processado. If your automation project contains multiple files, each of them should be linked to the Main.xaml file through the Invoke Workflow File activity. This is especially useful when the project is published to Orchestrator and sent to a Robot, as the Robot executes only the file provided in this parameter.
dependencies	Os pacotes de atividades usados para criar o projeto de automação e suas versões. A lista será atualizada sempre que uma dependência for adicionada ou removida do projeto ou quando uma versão de pacote for alterada. Os números de versão são compostos pelas seguintes partes, em ordem: principal, secundário, compilação e revisão. O valor de compilação é o número de dias decorridos desde 01/01/2000. O valor de revisão é o número de segundos decorridos no dia da versão, a partir das 5h da manhã GMT.
webServices	namespace – O nome do serviço fornecido na janela Adicionar novo serviço para bibliotecas. serviceDocument – O caminho para o arquivo .xml ou .json com os metadados para o serviço Swagger ou SOAP. O arquivo será usado quando o serviço for reparado e precisar ser usado como parte do projeto. webDocumentUri – O caminho do arquivo ou link para o recurso SOAP ou Swagger (fornecido quando o serviço foi criado na janela Adicionar novo serviço). uniqueReference – Uma referência necessária para o controle de versões do serviço.
entitiesStores	serviceDocument – O caminho para o arquivo das entidades locais. tenantName – O tenant no qual o Data Service está localizado. namespace – O namespace no qual as entidades são importadas (o namespace do projeto). uniqueReference – Uma referência necessária para o controle de versões do serviço.
schemaVersion	A versão do arquivo project.json.
studioVersion	A versão do Studio usada para criar o projeto de automação.
projectVersion	A versão usada ao publicar esse projeto em um feed. Representa o projeto definido na janela Publicar.
runtimeOptions	isPausable – Se a pausa está habilitada para o processo requiresUserInteraction – Se o processo é um processo de longa execução. supportsPersistence – Se o processo é compatível com persistência. excludedLoggedData - Contains keywords that can be added to the name of an activity to prevent variable and argument values from being logged at the Verbose level. That can also be achieved by selecting the Private checkbox of any activity. Read more about the protection of sensitive information here. readyForPiP – Se o processo está marcado como Pronto para PiP. startsInPiP – Se o processo está configurado para iniciar no PiP.
designOptions	projectProfile – O perfil do Studio usado quando o projeto foi criado, Comercial (StudioX) ou Desenvolvimento. outputType Mostra o tipo de projeto: Processo, Biblioteca ou Testes. libraryOptions includeOriginalXaml - Se os arquivos de fluxo de trabalho originais devem ser incluídos no arquivo .nupkg resultante. privateWorkflows – O nome completo de arquivos .xaml privados contidos na biblioteca. processOptions ignoredFiles – Lista de arquivos de fluxo de trabalho RPA ignorados da publicação. fileInfoCollection – Contém as seguintes informações para cada arquivo de caso de teste no processo: editingStatus (Publishable ou InProgress), testCaseId e fileName. modernBehavior – Se o processo está configurado para usar a Experiência de design moderno.
arguments	Contém as seguintes informações para cada argumento input e output definidos no arquivo de fluxo de trabalho que está definido como Principal: name, type, tanto required, quanto se tiver um valor padrão (hasDefault). As informações de argumentos são adicionadas apenas ao arquivo .nupkg no pacote após publicação.
expressionLanguage	A linguagem definida para o processo (VisualBasic ou CSharp).
entryPoints	Contém as seguintes informações para cada arquivo marcado como um ponto de entrada para o processo filePath, uniqueId. e as seguintes informações para cada argumento input e output no arquivo: name, type, tanto required, quanto se tiver um valor padrão (hasDefault). As informações de argumentos são adicionadas apenas ao arquivo .nupkg no pacote após publicação.
isTemplate	Se o projeto é um modelo.
templateProjectData	Contém as seguintes informações para projetos de modelo: defaultProjectDescription – A descrição padrão do projeto para processos com base no modelo. defaultProjectName – O nome padrão do projeto para processos com base no modelo.

O seguinte é um exemplo do conteúdo de um arquivo project.json incluído em um pacote publicado do Studio.

{
  "name": "UI-40028",
  "description": "Blank Process",
  "main": "Flowchart.xaml",
  "dependencies": {
    "UiPath.Excel.Activities": "[2.9.3]",
    "UiPath.Mail.Activities": "[1.9.3]",
    "UiPath.System.Activities": "[20.10.1]",
    "UiPath.UIAutomation.Activities": "[20.10.6]"
  },
  "webServices": [],
  "entitiesStores": [],
  "schemaVersion": "4.0",
  "studioVersion": "20.10.2.0",
  "projectVersion": "1.0.1",
  "runtimeOptions": {
    "autoDispose": false,
    "isPausable": true,
    "requiresUserInteraction": true,
    "supportsPersistence": false,
    "excludedLoggedData": [
      "Private:*",
      "<em>password</em>"
    ],
    "executionType": "Workflow",
    "readyForPiP": false,
    "startsInPiP": false
  },
  "designOptions": {
    "projectProfile": "Developement",
    "outputType": "Process",
    "libraryOptions": {
      "includeOriginalXaml": false,
      "privateWorkflows": []
    },
    "processOptions": {
      "ignoredFiles": []
    },
    "fileInfoCollection": [],
    "modernBehavior": false
  },
  "arguments": {
    "input": [
      {
        "name": "argument1",
        "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
        "required": false,
        "hasDefault": false
      },
      {
        "name": "argument2",
        "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
        "required": false,
        "hasDefault": false
      }
    ],
    "output": []
  },
  "expressionLanguage": "VisualBasic",
  "entryPoints": [
    {
      "filePath": "Main.xaml",
      "uniqueId": "5289efb0-f8bc-42f3-8cf4-0caa3a7d1915",
      "input": [
        {
          "name": "argument1",
          "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
          "required": false,
          "hasDefault": false
        },
        {
          "name": "argument2",
          "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
          "required": false,
          "hasDefault": false
        }
      ],
      "output": []
    },
    {
      "filePath": "Flowchart.xaml",
      "uniqueId": "d0904ba0-506e-437d-979c-b9da4325faad",
      "input": [
        {
          "name": "argument1",
          "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
          "required": false,
          "hasDefault": false
        },
        {
          "name": "argument2",
          "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
          "required": false,
          "hasDefault": false
        }
      ],
      "output": []
    }
  ],
  "isTemplate": false,
  "templateProjectData": {},
  "publishData": {}
}