UiPath Documentation
studio
2021.10
false
Guia do usuário do Studio
Importante :
A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.

Sobre projetos de automação

O UiPath Studio permite que você crie os seguintes tipos de projetos:

  • Processo - Crie um processo de automação e publique-o para que possa ser executado por robôs.
  • Library - Design workflows as reusable components and publish the project as a library that can be added as a dependency to multiple processes. For more information, see About Libraries.
  • Test Automation - Design a test automation project. For more information about test automation, check the Studio testing section.
  • Template - Design a process and publish it as a template that other processes which share common characteristics can then be based on. For more information, see Project Templates.

Para criar um novo projeto em branco, acesse Início (Exibição de Backstage do Studio) > Iniciar e selecione o tipo de projeto a ser criado em Novo Projeto. Alternativamente, você pode iniciar a partir de um dos modelos padrão disponíveis em Novo do Modelo, ou acessar a guia Modelos para procurar mais modelos de diversas fontes.

Na janela do novo projeto, configure o seguinte para cada projeto:

  • Insira um nome para o novo projeto (até 128 caracteres) e uma descrição que resuma o que você está planejando fazer com esse projeto de automação (até 500 caracteres).

  • Selecione o local em que deseja criar o projeto. O local padrão em que os projetos são criados é %USERPROFILE%\Documents\UiPath.

  • Select the compatibility and language.

    Observação:

    The compatibility and language cannot be changed after you create a project.

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

  • Arquivos
    • Main.xaml — criado por padrão para reter seu fluxo de trabalho principal. Além disso, todos os outros arquivos XAML de automação que você adicionar ao projeto serão armazenados na pasta do projeto. Opcionalmente, você pode definir um arquivo diferente como o principal. Todos os arquivos devem ser vinculados por meio da atividade Invoke Workflow File ao arquivo definido como principal ou a um arquivo marcado como um ponto de entrada para o projeto.Para projetos de automação de teste, um arquivo TestCase.xaml é criado por padrão, em vez de 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.

      Observação:
      • A pasta .local está oculta. Você pode habilitar a visualização de itens ocultos a partir das configurações do Explorador de Arquivos do Windows.
      • A pasta .local não deve ser compartilhada entre projetos.
    • .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.

    • .templates - Contém modelos de arquivos adicionados ao projeto.

    • .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.

Definindo a compatibilidade do projeto

Ao criar um novo projeto no perfil do Studio, selecione a compatibilidade com base no ambiente no qual o projeto será executado:

  • Windows -Legado -usa o .NET Framework 4.6.1. a compatibilidade usada em versões anteriores à 2021.10. Esse é o valor padrão.

  • Windows - Uses .NET 6 (in Studio 2021.10.6 and later versions) or .NET 5 (in Studio 2021.10 versions prior to 2021.10.6) with Windows support.

  • Cross-platform - Uses .NET 6 (in Studio 2021.10.6 and later versions) or .NET 5 (in Studio 2021.10 versions prior to 2021.10.6) with cross-platform support.

    Importante:

    Os processos do Windows e multiplataforma exigem o Orchestrator 2021.10 e mais novos para serem executados.

Para entender mais sobre as diferenças entre compatibilidades, consulte a tabela a seguir.

Windows - LegacyWindowsMultiplataforma
Execução de processos32 bits64 bits64 bits
Plataformas suportadas para execuçãoWindows (32 e 64 bits)Windows (64 bits)Windows e Linux (64 bits)
Os processos são compilados quando publicadosNo. Pacotes publicados contêm os arquivos de origem do projeto.Sim. Os pacotes publicados contêm arquivos de DLL compilados.Sim. Os pacotes publicados contêm arquivos de DLL compilados.

The design experience is the same for all compatibilities, but only the activities packages that support the selected compatibility can be installed from the package manager.

A compatibilidade de cada projeto é exibida no lado direito da barra de status do Studio e no painel Projeto > nó Dependências. A compatibilidade também é exibida na entrada de cada projeto na lista Abrir Recente em Início (Exibição Backstage do Studio) > aba Iniciar.

Observação:

Não há suporte para copiar e colar atividades entre projetos com diferentes compatibilidades.

Criando projetos multiplataforma

Os projetos multiplataforma permitem que você crie automações baseadas em API que podem ser executadas no Windows e também em sistemas operacionais baseados em Unix.

Observação:

Na versão 2021.10, projetos multiplataforma podem ser executados somente no Windows e Linux.

Para criar projetos não assistidos com suporte multiplataforma:

  1. No Studio, crie um novo projeto e selecione a opção de compatibilidade Multiplataforma. Essa opção está disponível para todos os tipos de projeto.
  2. Crie a automação. Observe que nem todos os pacotes de atividades são compatíveis com projetos multiplataforma, portanto, apenas uma seleção limitada de pacotes está disponível no gerenciador de pacotes. As dependências padrão para um projeto multiplataforma são UiPath.System.Activities e UiPath.WebApi.Activities.
  3. Test the automation. We recommend testing automations on the machines where they will run using remote debugging which works with both Windows and Linux robots.
  4. After testing the automation, publish the project to Orchestrator. The procedure for running unattended jobs is the same for Windows and Linux.

Definição do Idioma do Projeto

Ao criar um novo projeto no perfil do Studio, você pode selecionar qual linguagem será usada para expressões, 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 (Exibição Backstage do Studio) > Configurações > Design. Os projetos criados no perfil do StudioX usam a linguagem VB.NET para expressões.

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. Você também pode usar os atalhos Ctrl + C e Ctrl + V ou as opções Copiar e Colar no menu de contexto para copiar e duplicar arquivos ou pastas dentro do painel.

Opção Description

Expandir Tudodocs image

Expande todos os nós no projeto de automação.

Recolher Tudodocs image

Fecha todos os nós no projeto de automação.

Atualizardocs image

Atualiza o projeto.

Mostrar Todos os Arquivosdocs image

Mostra todos os arquivos que pertencem ao projeto de automação, incluindo o project.json.

Explorador de Arquivosdocs image

Abre o local do projeto na máquina.

Configurações do projetodocs image

Abre a janela Configurações do Projeto para processos ou bibliotecas.

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, global handler, workflow, or, in test automation projects, test case.

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.

Copiar

Copia os arquivos ou pastas selecionados para a área de transferência. Você pode colá-los no painel do projeto ou no explorador de arquivos do Windows.

Colar

Cola arquivos ou pastas que foram copiados para a área de transferência.

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, or when starting a job from Orchestrator.

  • When a file is marked as an entry point, an arrow is displayed on the icon next to the file name docs image.
  • 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.

Extrair como modelo

Salva o fluxo de trabalho selecionado ou o caso de teste como um modelo no qual é possível basear outros arquivos no projeto. Usar um modelo de arquivo permite economizar tempo quando você precisa criar vários arquivos com a mesma estrutura. Ao adicionar um fluxo de trabalho ou caso de teste, você tem a opção de baseá-lo em qualquer modelo do mesmo tipo que existe na pasta de projeto Modelos.

Ignorar da Publicação / Definir como Publicável

Marca um ou mais arquivos selecionados como excluídos da publicação ou publicáveis.

  • When a file is ignored from publishing, the icon next to the file name turns gray docs image.
  • Ignorar um arquivo marcado como ponto de entrada da publicação desabilita o ponto de entrada.
  • Essas opções não estão disponíveis para arquivos de fluxo de trabalho em arquivos de biblioteca.
  • Em projetos em que os arquivos XAML são compilados quando publicados, os arquivos de fluxo de trabalho e caso de teste que são excluídos da publicação não são compilados.

Tornar Privado / Tornar Público

Marca um ou mais arquivos selecionados em um projeto de biblioteca como privados ou publicados. Um arquivo de fluxo de trabalho privado é incluído no pacote publicado, mas nenhum componente reutilizável é criado e disponibilizado no painel Atividades em projetos em que a biblioteca esteja instalada como uma dependência.

  • When a file is marked as private, the icon next to the file name turns gray docs image.
  • Essas opções não estão disponíveis para arquivos de caso de teste.

Criar Caso de teste

Creates a test case that invokes the selected workflow file.

Converter para Caso de Teste / Converter para Fluxo de Trabalho

Converts the selected workflows to test cases or the selected test cases to workflows.

Importar Casos de Teste

Importa casos de teste para dentro do projeto como casos de teste de rascunho.

Adicionar Dados de Teste

Opens the Import Data Variation Source window that enables you to add test data to the project. This option is only available for test cases.

Vincular ao Test Manager

Opens the Link to Test Manager window that enables you to link the selected test cases to Test Manager.

Executar Casos de Teste / Depurar Casos de Teste

Executa ou depura múltiplos casos de teste selecionados.

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:

Imagem dos documentos O arquivo é sincronizado com o repositório.

Imagem dos documentos O arquivo foi modificado.

Imagem dos documentos O arquivo foi adicionado.

Imagem dos documentos O arquivo foi removido.

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

OpçãoDescription
ConfirmarConfirma as alterações atuais no repositório local do GIT.
Enviar por PushEnvia 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çõesAbre a janela do GIT com opções de gerenciamento das ramificações adicionadas no momento.
Mostrar AlteraçõesAbre a janela File Diff para comparar as alterações entre a versão local e a versão remota do arquivo.
Mostrar históricoAbre a janela Mostrar Histórico para comparação de duas versões do mesmo arquivo.
DesfazerAbre a janela Desfazer Alterações Pendentes se o arquivo não tiver sido confirmado ou enviado por push para o repositório remoto.
Copiar URL do RepositórioCopia a URL do repositório do projeto para a área de transferência.
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:

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

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

Imagem dos documentos O arquivo foi editado.

Imagem dos documentos 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çãoDescription
AbrirAbre 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.
RenomearPermite 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.
ExcluirExclui 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 editarMarca 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çãoRegistra o arquivo project.json no repositório com as alterações e uma mensagem de confirmação.
AdicionarCarrega 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 recenteFaz 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-InExibe 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.
DesfazerMostra 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.
ExecutarExecuta o fluxo de trabalho selecionado, mesmo se ele não tiver sido feito o check-out ou adicionado ao repositório.
Definir como PrincipalDefine o arquivo .xaml selecionado como Principal no projeto. O primeiro .xaml criado, por padrão, é definido como Principal.
Copiar URL do RepositórioCopia a URL do repositório do projeto para a área de transferência.

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 Imagem dos documentos, no painel do Projeto.

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

The following table describes the project settings for process, test automation, and template projects. For information about the settings available for libraries, see About Libraries.

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.

URL do Automation Hub

URL of an Automation Hub idea linked to the project. For more information, see Linking a Project to an Idea in 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 arquivo ico, jpeg, jpg ou png de até 1MB.

Após a publicação do projeto, o ícone é exibido da seguinte maneira:

  • Para processos, no Assistant ao lado do nome do processo, facilitando identificá-lo na lista de processos.
  • Para modelos, ao lado do modelo em Início (modo de exibição Backstage do Studio) > Modelos.
  • Para bibliotecas, ao lado do pacote na janela Gerenciar pacotes no Studio.
O ícone não fica visível em Gerenciar pacotes se um arquivo tiver sido usado para uma biblioteca publicada no Orchestrator ou se um feed que não for compatível com ícones incorporados. Neste caso, especifique o ícone usando uma URL.

Desabilitar Pausa

Permita ou evite que usuários pausem a execução a partir do UiPath Assistant. Defina 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.

Automação Assistida

Defina como Sim para indicar que o projeto só deve ser executado em um contexto assistido. Use essa configuração para projetos que incluam atividades de Automação de Interface Gráfica ou outras atividades que exijam interação do usuário.

Inicia em Segundo Plano

Set to Yes to turn the project into 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 into an Orchestration Process.

Pronto para PiP

Set to Yes to indicate that the project was tested using Picture in Picture. If set to No, when the process is run in PiP from the Assistant, a dialog informs the user it was not tested using this feature and prompts for confirmation before proceeding.

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.

This setting also enables / disables a modern design experience for Excel if the Excel Design Experience option is set to UseGlobalSetting in the Excel activities project settings.

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.

Como remover recursos de projeto não usados

Os recursos desnecessários podem complicar os projetos, de modo que isso afete o desempenho. Para evitar esse problema, remova recursos não usados de seus projetos clicando em Remover não usados na faixa de opções do Studio e remova-os:

  • Fluxos de trabalho - Remover arquivos do fluxo de trabalho que não são referenciados no projeto.
  • Variáveis - Remover variáveis que não são usadas no arquivo atualmente aberto.
  • Argumentos - Remover argumentos que não são usados no arquivo atualmente aberto.
  • Dependências - Remover pacotes de atividades instaladas onde nenhuma atividade está em uso no projeto.
  • Importações - Remover namespaces importados que não são usados no arquivo atualmente aberto.
  • Capturas de tela - Remover capturas de tela informativas que não são usadas em nenhuma atividade no projeto.

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.

A partir da versão 2018.2, você deve especificar um arquivo project.json ao executar seu projeto a partir do cliente UiRobot.exe (linha de comando).

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 em segundo plano.
  • supportsPersistence – Se o processo é um processo de longa execução.
  • 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.

targetFramework

A estrutura de destino definida para o projeto (Legacy, Windows ou Portable).

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": {}
}
{
  "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": {}
}

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades