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 o Automation Ops™, selecione Controle de origem e, em seguida, selecione 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 GitHub usar o logon por SSO, primeiro você precisa fazer logon no GitHub. Em seguida, você deve instalar o aplicativo GitHub por meio de Controle de origem. Para tanto, realize as seguintes ações:

• 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

Depending on your choice, the repositories presented in the following table appear in Automation Ops™ - Source Control:

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 .

Depois de selecionar Aceitar, você será redirecionado de volta para o Automation Ops™, onde a lista de projetos disponíveis é 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.

For each project, you can notice the following fields based on the project metadata in your external repository:

• Nome do Projeto
• Breve descrição

• Compatibilidade

• Tipo

• Repositório

• Última Modificação

To get the latest updates from yor external repository, select the Sync button under the Manage connections button or from the Manage connections menu.

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

When you access a project, you can check the commit history of the project, which contains a short description of the change, the name of the person who made the commit, and the timestamp.

You can create a pipeline using the New Pipeline button. You are redirected to the Creating the first pipeline flow from the Pipelines section. In this case, the information required to define the pipeline is already filled in based on the project from which the pipeline creation process was triggered.

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.
• Selecting Variables, Arguments, or Imports provides details on each of them.
  
  

  

  
  

Comparando confirmações

Files that have been modified by the last commit are highlighted in yellow. To check the changes, select the Compare with previous commit button.

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.
• On the upper right side, you can navigate through each modification and select the type of change you want to check.
  
  

  

  
  

Navegação dentro de arquivos de fluxo de trabalho

For complex workflows, you can use the navigation controls to change the view and navigate through the workflow. Selecting the activity opens the Properties panel while selecting it twice expands that specific activity.

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.