Controle de origem

O controle de origem permite visualizar 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.

Observação:

O acesso às políticas de controle de origem depende da oferta do Automation Cloud que você usa. Para obter detalhes, consulte a disponibilidade de funcionalidades do Automation Ops.

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™ e, em seguida, 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

Dependendo de sua escolha, os repositórios apresentados na tabela a seguir 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.
• A autenticação por meio de chaves de API ou tokens PAT não é compatível. Um Administrador da Organização GitHub deve fazer login por meio do GitHub OAuth para configurar a conexão. Se o usuário do Automation Ops não for um Administrador do GitHub Org, uma solução comum é atribuir temporariamente a função Administrador do Automation Ops a um Administrador do GitHub Org, permitir que ele conclua a configuração e, depois, revogar a função.
• 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.
• Automation Ops - o Controle de origem sincroniza apenas projetos do RPA na ramificação padrão de cada repositório.

Se você precisar se conectar a outra organização GitHub ou selecionar repositórios diferentes, selecione os repositórios necessários no GitHub e sincronize novamente a conexão no Controle de Origem.

Você pode remover a conexão existente no 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 aplicativos de terceiros via OAuth no seu nível de configurações da organização do Azure. Para isso, você precisa 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, você precisa 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ê é redirecionado de volta para o Automation Ops™, onde a lista de projetos disponíveis é preenchida.

Para criar ganchos de serviço do Azure, as permissões 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 Azure CLI ou a API REST de segurança do Azure.

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á e, em seguida, pode remover a integração da 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, é possível observar os seguintes campos com base nos metadados do projeto no 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, selecione o botão 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

Ao acessar um projeto, você pode verificar 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.

Você pode criar um pipeline usando o botão Novo pipeline . Você é redirecionado para a criação do primeiro fluxo de 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 disparado.

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 será exibida: Configure seus pipelines. Isso redireciona você para a Configuração de pipelines, de onde você pode configurar o ambiente em 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.

• Selecionar Variáveis, Argumentos ou Importações fornece detalhes sobre cada um deles.

  

Comparando confirmações

Os arquivos que foram modificados pela última confirmação ficam realçados em amarelo. Para verificar as alterações, selecione o 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 alteração que deseja verificar.

  

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. Selecionar a atividade abre o painel Propriedades, enquanto selecioná-la 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 todos: expande todos os subfluxos de trabalho na exibição atual.

• Zoom out: diminui o tamanho visual do fluxo de trabalho.

• Redefinir: retorna a exibição para 100% da largura.

• Zoom in: aumenta o tamanho do visual do fluxo de trabalho.