Controle de origem

O controle de origem permite que você visualize atualizações do código-fonte de projetos de automação. Isso pode ser feito usando provedores externos se você for um usuário regular, no UiPath Cloud por meio do Studio Web se você for um administrador da organização. Juntamente com a funcionalidade Controle de origem , disponível no Studio e no StudioX, permite que você obtenha mais controle sobre o gerenciamento de código.

Pré-requisitos para repositórios externos

• Uma conta do GitHub ou do Azure DevOps com pelo menos uma organização e um repositório.
• Direitos de fornecer acesso para o aplicativo UiPath-AutomationOps no repositório. Você deve ser o administrador da organização do GitHub ou administrador de pelo menos um repositório. Para o Azure, os repositórios aos quais o usuário tem acesso serão conectados.

Observação:

A integração do Azure Repos está atualmente em visualização, o que significa que certas funcionalidades podem não estar disponíveis.

Configuração

O Automation Ops precisa se conectar à organização do GitHub ou Azure para gerenciar informações. Isso é feito instalando o aplicativo UiPath-AutomationOps no GitHub ou no lado do Azure. Um guia passo a passo também está disponível na interface do usuário.

Etapa 1: iniciar a conexão a partir do Automation Ops

Acesse Automation Ops > Controle de Origem e clique em Conectar ao GitHub ou Conectar ao Azure.

Etapa 2.a: instalar e autorizar o aplicativo Automation Ops para GitHub

Ao escolher se conectar ao GitHub, você será redirecionado para o GitHub para selecionar a organização e repositórios que deseja que o Automation Ops tenha acesso.

Dependendo de sua escolha, os seguintes repositórios aparecerão no Automation Ops - Controle de origem:

Função do GitHub	Seleção	Resultado
Administrador da organização GitHub	Todos os repositórios	Todos os repositórios públicos e privados.
Administrador da organização GitHub	Apenas selecionar repositórios	Apenas os repositórios selecionados são exibidos (não todos os públicos, por padrão).
Somente administrador de repositório	Apenas selecionar repositórios	Só é possível selecionar nos repositórios que você gerencia.

Observação: a lista de repositórios do GitHub sempre pode ser atualizada posteriormente.

Importante:

• A conexão com o GitHub requer a autenticação de administrador do GitHub, o que significa que o usuário que inicia a conexão a partir do Automation Ops — Controle de Origem, também deve ser um administrador de organização do GitHub.
• Se você escolher selecionar manualmente os repositórios, também precisará selecionar explicitamente os públicos, pois não há seleção implícita para eles.

Se você precisar se conectar a outra organização GitHub ou selecionar repositórios diferentes, deve remover a conexão existente e reiniciar a configuração. Isso é feito a partir do menu Configurações de conexão > Remover.

Ao remover a conexão no UiPath, o aplicativo instalado no lado do GitHub também é removido.

Etapa 2.b: instalar e autorizar o aplicativo Automation Ops para Azure Repos

Ao escolher se conectar ao Azure, você será redirecionado ao Azure para fornecer as credenciais e confirmar que você permite que o UiPath leia os repositórios aos quais você tem acesso.

É recomendável criar e usar uma conta de serviço separada para fornecer acesso ao aplicativo da UiPath no Azure. Isso ocorre porque o acesso é concedido em nome da conta do usuário, o que significa que se um usuário fizer parte de várias organizações do Azure habilitadas para OAuth, todas elas serão refletidas no Automation Ops.

To sync your projects, you must enable the Third-party application access via OAuth at your Azure Organization settings level. For this, you have to access the Policy tab under Security. Enabling the option must be done before the authorization to your Azure Repos account. If you have already established the authorization, you need to resync the connection.

Se o usuário que permitiu a conexão com o Azure fizer parte de várias organizações e você quiser evitar que o conteúdo de um repositório específico seja exibido no Automation Ops, deve certificar-se de que as integrações de terceiros estejam desabilitadas no lado do Azure para essa organização.

Após clicar em "Aceitar", você será redirecionado de volta para o Automation Ops, onde a lista de projetos disponíveis é preenchida.

In order to create Azure Service Hooks, Edit subscriptions and View subscriptions permissions are needed for the service-account that authorizes the application. By default, only Project Administrators have these permissions. To grant other users these permissions, you can use the Azure CLI or the Azure Security REST API.

Para remover a integração entre o UiPath Automation Ops e o Azure Repos, você precisa acessar a guia Autorização em Configurações do usuário no lado do Azure e excluir o aplicativo autorizado de lá. Posteriormente, você pode remover a integração na guia Gerenciar conexões no Automation Ops - Controle de origem.

Etapa 3: exibir os projetos no Automation Ops

Após o aplicativo ser autorizado, você será redirecionado de volta para o Automation Ops e a lista de projetos será preenchida.

Para cada projeto, é possível ver os seguintes campos com base nos metadados do projeto no GitHub:

• Nome do Projeto
• Breve descrição
• Última atualização
• Versão
• Repositório

Para obter as atualizações mais recentes do GitHub, clique no Sincronizar no botão Gerenciar conexões ou no menu Gerenciar conexões.

Você pode sincronizar a lista de projetos sempre que necessário para obter os projetos adicionados mais recentes. Após a sincronização ser concluída, a lista de projetos atualizada estará disponível para todos os usuários do Controle de Origem.

Após a sincronização inicial, as sincronizações subsequentes serão mais rápidas, pois são baseadas nas diferenças da última sincronização.

Observação: dependendo do tamanho do seu repositório, pode levar algum tempo para que todos os projetos sejam exibidos no Automation Ops - Controle de origem.

Viewing the commit history for a project

Quando você acessa um projeto, pode ver o histórico de commits do projeto, que contém uma breve descrição da alteração, o nome da pessoa que fez a confirmação e o carimbo de data/hora.

A partir daqui, você pode criar um pipeline usando o botão Novo pipeline . Você é redirecionado para a seção Criando o primeiro fluxo do pipeline da seção Pipelines. Nesse caso, as informações necessárias para definir o pipeline já estão preenchidas com base no projeto a partir do qual o processo de criação do pipeline foi acionado.

Observação:

Na seção Pipelines, se você alterar o repositório/organização e, em seguida, selecionar novamente o inicial, as configurações pré-configuradas do pipeline serão limpas.

Se nenhum ambiente de runtime do pipeline estiver disponível, em vez do botão Novo pipeline , uma nova opção é exibida: Configure seus pipelines. Isso redireciona você para Configuração de pipelines, de onde você pode configurar o ambiente de execução.

Viewing the details of a commit

Abrir uma confirmação permite visualizar os arquivos que fazem parte do projeto com mais detalhes.

• Para arquivos de fluxo de trabalho, uma visualização semelhante à do Studio está disponível.
• Para outros tipos de arquivos, uma visualização de conteúdo é exibida com base no tipo de arquivo.
• Clicar em Variáveis, Argumentos ou Importações fornece detalhes sobre cada um deles.
  
  

  

  
  

Comparando confirmações

Os arquivos que foram modificados pela última confirmação são realçados em amarelo. Para ver as alterações, clique no botão Comparar com confirmação anterior .

Na janela de comparação:

• A versão mais antiga do arquivo está à esquerda e a versão mais recente do arquivo está à direita.
• O nome do arquivo e os identificadores de confirmação que são comparados são exibidos no lado superior esquerdo.
• No lado superior direito, você pode navegar por cada modificação e selecionar o tipo de mudança que deseja ver.
  
  

  

  
  

Navegação dentro de arquivos de fluxo de trabalho

Para fluxos de trabalho complexos, você pode usar os controles de navegação para alterar a exibição e navegar pelo fluxo de trabalho. Clicar na atividade abre o painel Propriedades, enquanto clicar duas vezes expande essa atividade específica.

Para voltar um nível na atividade, use o menu de navegação estrutural na parte superior.

Os seguintes controles de navegação estão disponíveis:

• Expandir tudo: expande todos os subfluxos de trabalho na exibição atual.
• Reduzir: diminui o tamanho visual do fluxo de trabalho.
• Redefinir: retorna a exibição para 100% de largura.
• Aumentaro zoom: aumenta o tamanho visual do fluxo de trabalho.