Controle de origem

O controle de origem permite visualizar as atualizações feitas no 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 o recurso 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 lado do GitHub ou Azure. Um guia passo a passo também está disponível na interface do usuário.

Etapa 1: iniciar a conexão 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 conectar-se ao GitHub, você é redirecionado para o GitHub para selecionar a organização e os repositórios aos quais deseja que o Automation Ops™ tenha acesso.

Observação:

Se sua organização do GitHub usar o login SSO, você primeiro precisa entrar no GitHub. Depois disso, você pode instalar o aplicativo GitHub por meio do Controle de origem. Você pode fazer isso da seguinte maneira:

• Usuários gerenciados pelo Enterprise — precisam entrar no GitHub por meio de seu IdP.

• Os usuários podem configurar uma sessão de login do SSO em: https://github.com/orgs/<OrganizationName>/sso

Dependendo de sua escolha, os seguintes repositórios aparecem 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.

Ao conectar o Automation Ops™ - Controle de origem ao GitHub, você é solicitado a conceder as permissões necessárias para usar totalmente o Controle de origem e Pipelines. As permissões necessárias são:

• Acesso de leitura ao código e metadados

• Acesso de leitura e gravação a webhooks do repositório

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 do Automation Ops™ para o 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™.

Para sincronizar seus projetos, você deve habilitar o Acesso de aplicativo de terceiros via OAuth no seu nível de configurações da Organização do Azure. Para isso, você deve acessar a guia Política em Segurança. A habilitação da opção deve ser feita antes da autorização para sua conta do Azure Repos. Se você já tiver estabelecido a autorização, é necessário sincronizar novamente a conexão.

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™, você deve certificar-se de que as integrações de terceiros estejam desabilitadas no Azure lado para essa organização .

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

Para criar os Azure Service hooks, as permissões de Editar assinaturas e Exibir assinaturas são necessárias para a conta de serviço que autoriza o aplicativo. Por padrão, apenas os Administradores do Projeto têm essas permissões. Para conceder essas permissões a outros usuários, você pode usar o CLI do Azure ou a API REST de segurança do Azure.

Para remover a integração entre o UiPath Automation Ops™ e o Azure Repos, acesse a guia Autorização em Configurações do usuário no lado do Azure e exclua o aplicativo autorizado de lá e, em seguida, remova a integração na guia Gerenciar conexões no Automation Ops ™ - Controle de origem.

Etapa 3: visualizar os projetos no Automation Ops™

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

Para cada projeto, você pode visualizar os seguintes campos com base nos metadados do projeto em seu repositório externo:

• Nome do Projeto
• Breve descrição

• Compatibilidade

• Tipo

• Repositório

• Última Modificação

Para obter as atualizações mais recentes do seu repositório externo, 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.