Quellenkontrolle

Mit Source Control können Sie Aktualisierungen des Quellcodes von Automatisierungsprojekten anzeigen. Wenn Sie ein regulärer Benutzer sind, kann dies über externe Anbieter erfolgen, in UiPath Cloud über Studio Web, wenn Sie ein Organisationsadministrator sind. Ermöglicht Ihnen zusammen mit der in Studio und StudioX verfügbaren Source Control -Funktion mehr Kontrolle über die Codeverwaltung.

Voraussetzungen für externe Repositorys

• Ein GitHub- oder Azure DevOps-Konto mit mindestens einer Organisation und einem Repository.
• Rechte zum Bereitstellen des Zugriffs für die UiPath-AutomationOps-App auf das Repository. Sie müssen entweder der GitHub-Organisationsadministrator oder der Administrator von mindestens einem Repository sein. Bei Azure werden die Repositorys verbunden, auf die der Benutzer Zugriff hat.

Hinweis:

Die Azure Repos-Integration befindet sich derzeit in der Vorschau, was bedeutet, dass bestimmte Funktionalitäten möglicherweise nicht verfügbar sind.

Konfiguration

Automation Ops™ muss sich mit der GitHub- oder Azure-Organisation verbinden, um Informationen zu verwalten. Dazu wird die UiPath-AutomationOps-App auf der GitHub- oder Azure-Seite installiert. In der Benutzeroberfläche ist zudem eine Schritt-für-Schritt-Anleitung verfügbar.

Schritt 1: Starten der Verbindung von Automation Ops™

Greifen Sie auf Automation Ops™ > Source Control zu und klicken Sie dann auf Verbindung mit GitHub herstellen oder Verbindung mit Azure herstellen.

Schritt 2.a: Installieren und autorisieren Sie die Automation Ops™-App für GitHub

Wenn Sie eine Verbindung mit GitHub herstellen möchten, werden Sie zu GitHub weitergeleitet, um die Organisation und Repositorys auszuwählen, auf die Automation Ops™ Zugriff haben soll.

Hinweis:

Wenn Ihre GitHub-Organisation die SSO-Anmeldung verwendet, müssen Sie sich zuerst bei GitHub anmelden. Danach können Sie die GitHub-App über Source Control installieren. Sie können dies wie folgt tun:

• In Enterprise verwaltete Benutzer – müssen sich über ihren IdP bei GitHub anmelden.

• Benutzer können eine SSO-Anmeldesitzung einrichten unter: https://github.com/orgs/<OrganizationName>/sso

Je nach Auswahl werden die folgenden Repositorys in Automation Ops™ – Quellenkontrolle angezeigt:

GitHub-Rolle	Auswahl	Ergebnisse
GitHub-Organisationsadministrator	Alle Repositorys	Alle öffentlichen und privaten Repositorys.
GitHub-Organisationsadministrator	Nur Repositorys auswählen	Nur die ausgewählten Repositorys werden angezeigt (standardmäßig nicht alle öffentlichen).
Nur Repository-Administrator	Nur Repositorys auswählen	Sie können nur aus den Repositorys auswählen, die Sie verwalten.

Hinweis: Die GitHub-Repository-Liste kann jederzeit zu einem späteren Zeitpunkt aktualisiert werden.

Wenn Sie Automation Ops™ - Source Control mit GitHub verbinden, werden Sie aufgefordert, die erforderlichen Berechtigungen zu erteilen, um Source Control und Pipelines vollständig zu nutzen. Die erforderlichen Berechtigungen sind:

• Lesezugriff auf Code und Metadaten

• Lese- und Schreibzugriff auf Repository-Webhooks

Wichtig:

• Die Verbindung mit GitHub erfordert eine GitHub-Administratorauthentifizierung, d. h., der Benutzer, der die Verbindung über Automation Ops™ – Quellenkontrolle initiiert, muss auch ein GitHub-Organisationsadministrator sein.
• Wenn Sie die Repositorys manuell auswählen, müssen Sie auch die öffentlichen Repositorys explizit auswählen, da es für sie keine implizite Auswahl gibt.

Wenn Sie eine Verbindung mit einer anderen GitHub-Organisation herstellen oder andere Repositorys auswählen müssen, müssen Sie die vorhandene Verbindung entfernen und die Konfiguration neu starten. Dies geschieht über das Menü Verbindungseinstellungen > Entfernen.

Wenn Sie die Verbindung in UiPath entfernen, wird auch die auf GitHub-Seite installierte App entfernt.

Schritt 2.b: Installieren und autorisieren der Automation Ops™-App für Azure Repos

Wenn Sie sich für die Verbindung mit Azure entscheiden, werden Sie zu Azure umgeleitet, um die Anmeldeinformationen bereitzustellen und zu bestätigen, dass Sie UiPath erlauben, die Repositorys zu lesen, auf die Sie Zugriff haben.

Es wird empfohlen, ein separates Dienstkonto für den Zugriff auf die UiPath-App auf der Azure-Seite zu erstellen und zu verwenden. Dies liegt daran, dass der Zugriff im Namen des Benutzerkontos gewährt wird, was bedeutet, dass, wenn ein Benutzer Teil mehrerer OAuth-fähiger Azure-Organisationen ist, alle in Automation Ops™ widergespiegelt werden.

Um Ihre Projekte zu synchronisieren, müssen Sie den Zugriff auf Drittanbieteranwendungen über OAuth auf der Ebene Ihrer Azure- Organisationseinstellungen aktivieren. Dazu müssen Sie unter Sicherheit auf die Registerkarte Richtlinie zugreifen. Das Aktivieren der Option muss vor der Autorisierung für Ihr Azure Repos-Konto erfolgen. Wenn Sie die Autorisierung bereits hergestellt haben, müssen Sie die Verbindung erneut synchronisieren.

Wenn der Benutzer, der die Verbindung mit Azure zugelassen hat, Teil mehrerer Organisationen ist und Sie vermeiden möchten, dass der Inhalt aus einem bestimmten Repository in Automation Ops™ angezeigt wird, müssen Sie sicherstellen, dass Integrationen von Drittanbietern auf der Azure-Seite für diese Organisation deaktiviert sind .

Sobald Sie auf „ Akzeptieren “ klicken, werden Sie zurück zu Automation Ops™ weitergeleitet, wo die Liste der verfügbaren Projekte ausgefüllt wird.

Zum Erstellen von Azure Service-Hooks sind die Berechtigungen Abonnements bearbeiten und Abonnements anzeigen für das Dienstkonto erforderlich, das die Anwendung autorisiert. Standardmäßig verfügen nur Projektadministratoren über diese Berechtigungen. Um anderen Benutzern diese Berechtigungen zu erteilen, können Sie die Azure CLI oder die Azure Security REST API verwenden.

Um die Integration zwischen UiPath Automation Ops™ und Azure Repos zu entfernen, müssen Sie auf die Registerkarte Autorisierung unter Benutzereinstellungen auf der Azure-Seite zugreifen und die autorisierte App von dort löschen. Anschließend können Sie die Integration auf der Registerkarte Verbindungen verwalten in Automation Ops entfernen ™ – Quellenkontrolle.

Schritt 3: Anzeigen der Projekte in Automation Ops™

Nachdem die Anwendung autorisiert wurde, werden Sie zurück zu Automation Ops™ umgeleitet und die Projektliste wird aufgefüllt.

Für jedes Projekt können Sie die folgenden Felder basierend auf den Projektmetadaten in Ihrem externen Repository sehen:

• Projektname
• Kurzbeschreibung

• Kompatibilität

• Typ

• Repository

• Zuletzt geändert

Um die neuesten Aktualisierungen von Ihrem externen Repository abzurufen, klicken Sie auf Schaltfläche zum Synchronisieren unter der Schaltfläche Verbindungen verwalten oder im Menü Verbindungen verwalten.

Sie können die Projektliste jederzeit synchronisieren, um die zuletzt hinzugefügten Projekte zu erhalten. Nachdem die Synchronisierung abgeschlossen ist, steht die aktualisierte Projektliste allen Source Control-Benutzern zur Verfügung.

Nach der ersten Synchronisierung sind nachfolgende Synchronisierungen schneller, da sie auf den Unterschieden zur letzten Synchronisierung basieren.

Hinweis: Je nach Größe Ihres Repositorys kann es einige Zeit dauern, bis alle Projekte in Automation Ops™ – Source Control angezeigt werden.

Viewing the commit history for a project

Wenn Sie auf ein Projekt zugreifen, können Sie den Commit-Verlauf des Projekts anzeigen, der eine kurze Beschreibung der Änderung, den Namen der Person, die den Commit durchgeführt hat, und den Zeitstempel enthält.

Von hier aus können Sie eine Pipeline mit der Schaltfläche Neue Pipeline erstellen. Sie werden vom Abschnitt Pipelines zum Erstellen der ersten Pipeline weitergeleitet. In diesem Fall sind die Informationen, die zum Definieren der Pipeline erforderlich sind, bereits basierend auf dem Projekt ausgefüllt, von dem aus der Pipelineerstellungsprozess ausgelöst wurde.

Hinweis:

Wenn Sie im Abschnitt Pipelines das Repository/die Organisation ändern und dann die ursprüngliche Repository erneut auswählen, werden die vorkonfigurierten Pipelineeinstellungen gelöscht.

Wenn keine Pipeline-Laufzeitumgebung verfügbar ist, wird anstelle der Schaltfläche Neue Pipeline eine neue Option angezeigt: Richten Sie Ihre Pipelines ein. Dadurch werden Sie zur Pipelines- Konfiguration umgeleitet, von der aus Sie die Ausführungsumgebung einrichten können.

Viewing the details of a commit

Durch Öffnen eines Commits können Sie die Dateien des Projekts detaillierter anzeigen.

• Für Workflow-Dateien ist eine Studio-ähnliche Ansicht verfügbar.
• Für andere Dateitypen wird eine Inhaltsansicht basierend auf dem Dateityp angezeigt.
• Wenn Sie auf Variablen, Argumente oder Importe klicken, werden Details zu jeder einzelnen angezeigt.
  
  

  

  
  

Vergleichen von Commits

Dateien, die durch den letzten Commit geändert wurden, werden gelb hervorgehoben. Um die Änderungen anzuzeigen, klicken Sie auf die Schaltfläche Mit vorherigem Commit vergleichen .

Im Vergleichsfenster:

• Die ältere Version der Datei befindet sich auf der linken Seite und die neuere Version der Datei befindet sich auf der rechten Seite.
• Der Dateiname und die Commit-IDs, die verglichen werden, werden oben links angezeigt.
• Oben rechts können Sie durch jede Änderung navigieren und den Typ der Änderung auswählen, die Sie anzeigen möchten.
  
  

  

  
  

Navigieren in Workflow-Dateien

Bei komplexen Workflows können Sie die Navigationssteuerelemente verwenden, um die Ansicht zu ändern und durch den Workflow zu navigieren. Wenn Sie auf die Aktivität klicken, wird der Eigenschaftenbereich geöffnet, während durch Doppelklicken diese bestimmte Aktivität erweitert wird.

Über das Breadcrumb-Menü oben können Sie bei der Aktivität eine Ebene zurück gehen.

Die folgenden Navigationssteuerelemente sind verfügbar:

• Alleerweitern: Erweitert alle untergeordneten Workflows in der aktuellen Ansicht.
• Herauszoomen: Verringert die Größe des visuellen Workflows.
• Zurücksetzen: Setzt die Ansicht auf 100 % Breite zurück.
• Vergrößern: Vergrößert das Workflow-Visual.