Abonnieren

UiPath Studio

UiPath Studio-Anleitung

Verwalten von Projekten mit GIT

GIT integration in Studio requires the Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017, 2019, and 2022. Check the Software Requirements page.

GIT-Authentifizierung

Authentication methods in Studio differ in accordance with the methods used for cloning a GIT repository, either HTTPS or SSH. Check this page to see which you should use if you're working with GitHub.

📘

Hinweise:

  • Die GIT-Anmeldeinformationen, die Sie in Studio angeben, werden in der Windows-Anmeldeinformationsverwaltung gespeichert.
  • Die GIT-Integration mit Studio unterstützt derzeit nur die Zwei-Faktor-Authentifizierung für GitHub, wenn Sie sich durch Anmeldung beim Dienst authentifizieren. Verwenden Sie für andere Tools die SSO-Authentifizierungsmethode mit einem persönlichen Token oder die Methode der einfachen Zugriffsauthentifizierung.

Im aktuellen Handbuch werden die Schritte für die Authentifizierung in einem GitHub-Repository beschrieben, aber die Git-Integration in Studio ist nicht nur auf diesen Dienst beschränkt.

Über HTTPS

Wenn Sie ein Remote-GIT-Repository klonen oder das aktuelle Projekt zum ersten Mal mithilfe von HTTPS in ein vorhandenes GIT-Repository kopieren, müssen Sie Ihre GIT-Anmeldeinformationen angeben. Diese Anmeldeinformationen müssen in die Felder Anmeldeinformationen verwenden eingegeben werden:

Sie können sich mit den folgenden Optionen authentifizieren:

  • Mit GitHub anmelden – Melden Sie sich mit Ihrem GitHub-Konto an.
  • Benutzer/Kennwort – Geben Sie Ihren Benutzer und Ihr Kennwort ein.
  • Token – Geben Sie Ihren Benutzer und Ihr persönliches Zugriffstoken ein.
    Follow the steps detailed in this page to generate a GIT token for your GitHub repository.

🚧

Wichtig:

Die Option Mit GitHub anmelden ist nur für Repositorys verfügbar, die auf github.com gehostet werden, und erfordert, dass die UiPath GitHub-App in Ihrer Organisation oder Ihrem Konto installiert ist.

Über SSH

Wenn Sie ein Repository klonen oder das aktuelle Projekt zum ersten Mal mit SSH in ein vorhandenes GIT-Repository kopieren, haben Sie die Möglichkeit, einen privaten Schlüssel zu verwenden:

Add the Private Key Path and the Password, and then click Open to clone your remote GIT repository. Check out the steps detailed here to generate a SSH key for your GitHub repository.

Authentifizierung fehlgeschlagen

Über HTTPS

Beim Klonen eines GIT-Repositorys wird das Fenster Anmeldeinformationen eingeben mit der Meldung Authentifizierung fehlgeschlagen angezeigt, wenn die angegebenen Anmeldeinformationen falsch waren:

Geben Sie die richtigen Anmeldeinformationen ein und versuchen Sie es erneut. Sie können z. B. auch Git Bash verwenden, um einen Remote-Klonvorgang für Ihr Repository auszuführen und so zu überprüfen, ob der Benutzername und das Kennwort korrekt sind.

In der folgenden Abbildung haben wir versucht, ein Repository über HTTPS zu klonen, aber ein falsches Kennwort eingegeben. Das Git Bash-Fenster zeigt, dass die Anmeldeinformationen falsch waren.

Über SSH

Das folgende Fenster Anmeldeinformationen eingeben wird angezeigt, wenn die Authentifizierung über SSH fehlschlägt:

Geben Sie den korrekten Pfad des privaten Schlüssels und das Kennwort ein, und versuchen Sie es erneut. Sie können z. B. auch Git Bash verwenden, um einen Remote-Klonvorgang für Ihr Repository auszuführen und so zu überprüfen, ob das Token und/oder Kennwort korrekt sind.

In der folgenden Abbildung haben wir versucht, ein Repository über SSH zu klonen, aber wir hatten keine öffentlichen SSH-Schlüssel in unserem Konto eingerichtet.

Klonen eines Remote-GIT-Repositorys

  1. Wählen Sie auf der Registerkarte Team die Option Repository klonen aus. Das Fenster Ein Remote-GIT-Repository klonen. wird angezeigt.
  2. Wählen Sie entweder HTTPS verwenden oder SSH verwenden aus.
  3. Geben Sie die Repository-URL ein, und wählen Sie ein leeres Auscheckverzeichnis.
  4. Wählen Sie Anmeldeinformationen verwenden/Schlüssel verwenden aus und konfigurieren Sie die Authentifizierung (entweder mit GitHub anmelden, Benutzer und Kennwort eingeben, Benutzer und Token für HTTPS eingeben oder privaten Schlüsselpfad und Kennwort für SSH eingeben).
  5. Klicken Sie auf Öffnen. Studio öffnet das Projekt im Panel Designer.
  6. Wählen Sie im Fenster Öffnen (Open) eine project.json-Datei zum Öffnen in Studio aus.

Nachdem Sie ein GIT-Repository in einem lokalen Arbeitsverzeichnis geklont haben, wird das Unterverzeichnis .git erstellt. Es enthält die erforderlichen GIT-Metadaten. Die Metadaten enthalten Unterverzeichnisse für Objekte, Referenzen und Vorlagendateien. Außerdem wird eine Datei HEAD erstellt, die auf das aktuell ausgecheckte Commit verweist.

Hinzufügen eines Projekts zu GIT

Die Funktion GIT-Initialisierung fügt das aktuelle Projekt einem lokalen GIT-Repository hinzu. Greifen Sie über die Registerkarte Team oder die Statusleiste auf den Befehl zu.

  1. Erstellen oder öffnen Sie ein Projekt in Studio. Klicken Sie auf die Registerkarte Start > Team. Die Registerkarte Team wird angezeigt.
  2. Klicken Sie auf die Schaltfläche GIT-Initialisierung, und wählen Sie einen Pfad aus, an dem das Repository initialisiert werden soll. Der Speicherort kann derselbe wie für den Projekt- oder den übergeordneten Ordner sein. Das Fenster Änderungen committen wird geöffnet.
  1. Im Abschnitt Geänderte Dateien werden die Projektdateien angezeigt, die dem GIT-Repository hinzugefügt werden sollen. Deaktivieren Sie das Kontrollkästchen neben denjenigen, die Sie nicht hinzufügen möchten, oder verwenden Sie Alle auswählen, Keine auswählen.
  2. Wählen Sie das Feld Dateien ohne Versionsangabe anzeigen aus, um der Liste Dateien ohne Versionsangabe hinzuzufügen.
    Schreiben Sie eine Commit-Nachricht. Klicken Sie auf die Schaltfläche Commit, um die Änderungen an das lokale Git-Repository zu übertragen.

When a project is added to GIT, the context menu in the Project panel includes GIT-specific options. For more information, see Context Menu Options for GIT.

Übergeben und Verschieben nach GIT

  1. Klicken Sie in demselben Fenster Änderungen committen auf die Schaltfläche Committen und pushen, um die Änderungen zu übergeben und in das Remote-Repository zu verschieben. Dieses Fenster Remotes verwalten wird angezeigt. Das Fenster ist auch über die Statusleiste verfügbar.
  1. Fügen Sie im Abschnitt Name den Namen des Remote-Repositorys hinzu.
  2. Fügen Sie im Abschnitt URL die Remote-URL hinzu.

Wenn Sie Änderungen an den hinzugefügten Repositorys vornehmen möchten, klicken Sie einfach auf einen Eintrag, ändern Sie den Namen und die URL, und klicken Sie auf die Schaltfläche Aktualisieren. Wenn Sie fertig sind, klicken Sie auf Hinzufügen und dann auf Speichern. Das folgende Meldungsfeld wird geöffnet.

  • Klicken Sie auf die Schaltfläche Remote-Inhalt überschreiben (Overwrite remote content), um die lokalen Versionen der Dateien in das Remote-Repository zu verschieben und die Dateien dort zu überschreiben.
  • Klicken Sie auf die Schaltfläche Ziehen (Basis ändern) (Pull (rebase)), um die Remote-Dateien zu ziehen und die Basis der aktuellen Verzweigung zu ändern.
  • Klicken Sie auf die Schaltfläche Abbrechen (Cancel), um die gesamte Operation abzubrechen.

The number of unpushed changes, and newly added files are visible in the status bar. Click the changes_iconchanges_icon icon to open the Commit Changes window, or the push_commitpush_commit icon to push changes.

📘

Hinweis:

Wenn Sie eine Datei von einem Projekt, das zu Source Control hinzugefügt wurde, in einem externen Editor bearbeiten, wird die Änderung im Projektfenster und in der Statusleiste erst angezeigt, nachdem Sie im Projektfenster auf Aktualisieren refreshrefresh geklickt haben.

Andern der letzten Übergabe

Das mit GIT integrierte Studio bietet außerdem eine Option zum Ändern der Übergabe (Amend Commit), mit der die zuletzt durchgeführte Übergabe vor dem Verschieben geändert werden kann.

  1. Klicken Sie im Panel Projekt mit der rechten Maustaste auf eine geänderte Datei, und wählen Sie Commit aus. Das Fenster Änderungen committen wird angezeigt.
  1. Wählen Sie das Feld Commit abändern aus. Die letzte Commit-Nachricht wird zusammen mit den Dateien angezeigt, für die ein Commit ausgeführt wurde. Um Änderungen zwischen der aktuellen Datei und dem letzten Commit anzuzeigen, verwenden Sie die Option Änderungen anzeigen.
  2. Ändern Sie die Commit-Nachricht, und wählen Sie die Dateien aus, die Sie einschließen möchten. Klicken Sie auf die Schaltfläche Committen und pushen oder auf die Schaltfläche Commit.

Anstehende Änderungen rückgängig machen

Studio bietet die Option, Änderungen rückgängig zu machen, die an Dateien mit Versionsangabe durchgeführt wurden, bevor Sie die Dateien committen und in das Remote-Repository pushen.

Nachdem Änderungen an einer Datei im lokalen Repository durchgeführt wurden, klicken Sie auf Rückgängig machen (Undo) im GIT-Kontextmenü, um das Fenster Anstehende Änderungen rückgängig machen (Undo Pending Changes) zu öffnen.

Markieren Sie das Kontrollfeld neben den Dateien und klicken Sie auf Rückgängig machen (Undo). Die Dateien werden wieder in den Zustand versetzt, in dem sie vor Durchführung der Änderungen waren.

📘

Hinweis:

Der Vorgang Rückgängig deckt keine Dateien ohne Version ab. Wenn Sie neue Dateien erstellen und dann Rückgängig auswählen, werden die Dateien nicht aus dem Projekt entfernt. Nach dem Hinzufügen zur Projektstruktur bleiben neue Dateien dort, es sei denn, sie werden manuell gelöscht.

Kopieren eines Projekts nach GIT

Mit der Schaltfläche In GIT kopieren in der Studio Backstage-Ansicht und Statusleiste können Sie das aktuelle Projekt in ein vorhandenes GIT-Repository kopieren.

Dazu öffnen oder erstellen Sie ein Projekt in Studio. Aktivieren Sie auf der Registerkarte Team (Team) die Option Nach GIT kopieren (Copy to GIT) und wählen Sie einen vorhandenen GIT-Repository-Ordner auf Ihrem Computer aus. Das Projekt wird zum lokalen GIT-Repository hinzugefügt und das Meldungsfenster Nach GIT kopieren (Copy to GIT) wird geöffnet.

  • Wählen Sie Ja (Yes), um das Projekt an dem neuen Speicherort zu öffnen. Das Fenster Änderungen übergeben (Commit changes) wird geöffnet. Schreiben Sie eine Übergabenachricht (Commit message) und klicken Sie auf Übergeben und Verschieben (Commit and Push) oder nur auf Übergeben (Commit).
  • Mit Nein (No) wird wieder die Studio-Bedienoberfläche angezeigt.

Erstellen und Verwalten von Verzweigungen

Add and manage branches from the Manage Branches window. To access it, either right-click the project node or a file in the Project panel and select Manage Branches, or use the merge_buttonmerge_button branch menu in the status bar.

  • So fügen Sie eine Verzweigung hinzu:
    1. Select a branch in the table, and then click Plus add_buttonadd_button at the top of the window.
    2. Geben Sie einen Namen für die Verzweigung ein, klicken Sie auf Verzweigung aus branch_name erstellen und klicken Sie dann auf Speichern.
      Die Verzweigung wird der Liste hinzugefügt.
  • To refresh the list of branches, click Refresh refresh_buttonrefresh_button at the top of the window.
  • To delete a local branch, select it, and then click Delete delete_buttondelete_button at the top of the window.
  • Um Verzweigungen zu verwalten, klicken Sie mit der rechten Maustaste auf eine beliebige Verzweigung und wählen Sie eine der Optionen aus dem Menü aus:
    • Die Option Verzweigung auschecken (Checkout branch) schaltet auf die ausgewählte Verzweigung um.
    • Die Option Basis ändern (Rebase) ändert die Basis der aktuellen Verzweigung auf die ausgewählte Verzweigung.
    • Die Option Zusammenführen (Merge) führt die ausgewählte Verzweigung mit der aktuellen Verzweigung zusammen.
      Um eine Verzweigung in den Master-Abschnitt eines GIT-Remote-Repositorys zu überführen, müssen Sie die Master-Verzweigung in Studio auschecken und die geänderte Verzweigung dann in den Master-Abschnitt überführen.
  • To switch between branches, open the merge_buttonmerge_button branch menu in the status bar, and then select the branch to switch to from the list of recently checked out branches.

Anzeigen des Commit-Verlaufs

Um den Commit-Verlauf für ein Projekt, für eine bestimmte Datei oder einen bestimmten Ordner in einem Projekt anzuzeigen, klicken Sie im Projekt-Panel mit der rechten Maustaste auf den Projektknoten, eine Datei oder einen Ordner und wählen Sie dann Verlauf anzeigen aus. Dadurch wird das Fenster Verlauf geöffnet, in dem eine Liste vorhandener Revisionen für die ausgewählte Datei, den Ordner oder das Projekt angezeigt wird. Für jedes Commit werden Commit-Hash, Nachricht, Autor und Datum in einer Tabelle im oberen Teil des Fensters angezeigt. Weitere Informationen zu einem ausgewählten Commit finden Sie auf den Registerkarten Details und Änderungen im unteren Teil des Fensters.

Vergleichen zweier Versionen einer Datei

So vergleichen Sie zwei Versionen derselben Datei:

  • Wenn Sie den Verlauf für eine Datei geöffnet haben, klicken Sie im Fenster „Verlauf“ mit der rechten Maustaste auf einen Commit und wählen Sie dann Mit vorheriger vergleichen, Mit lokaler vergleichen oder Mit neuester vergleichen aus.
  • Wenn Sie den Verlauf für einen Ordner oder ein Projekt geöffnet haben, wählen Sie im Fenster „Verlauf“ einen Commit aus und doppelklicken Sie dann unter der Registerkarte „Änderungen“ auf eine Datei, um sie mit der vorherigen Version zu vergleichen.

Erstellen einer Verzweigung aus einem vorherigen Commit

So erstellen Sie eine Verzweigung aus einem bestimmten Commit:

  1. Klicken Sie im Fenster „Verlauf“ mit der rechten Maustaste auf einen Commit und wählen Sie dann Verzweigung erstellen aus.
  2. Im Fenster Verzweigung erstellen:
    • Geben Sie einen Namen für die neue Verzweigung ein.
    • Stellen Sie auch zum Auschecken der neuen Verzweigung sicher, dass die Option Nach der Erstellung auschecken ausgewählt ist.
  3. Klicken Sie auf OK.

Konflikte lösen

Die GIT-Integration mit Studio bietet eine Funktion zum Lösen von Konflikten, die beim Ausführen des Befehls Umbasieren oder Push ausführen im Fenster Änderungen committen auftreten können.

Immer wenn Studio einen Konflikt zwischen der lokalen Datei und der im Remote-Repository angetroffenen erkennt, wird das Fenster zur Konfliktlösung geöffnet.

The window is similar to File Diff, showing the differences between the Remote version of the file and the Local version.

In der folgenden Tabelle werden die im Fenster Konflikte lösen verfügbaren Optionen beschrieben.

Option

Description

Choose Left

Select the left file representing the file in the remote repository to push.

Choose Right

Select the right file representing the file in the local repository to push.

Save

Click Save after choosing the left or right file.

Cancel

Cancel the operation and exit the Solve conflicts window.

Previous

Navigates to the previous change in the compared files.

Next

Navigates to the next change in the compared files.

Collapse All

Collapses all nodes in the .xaml files.

Expand All

Expands all nodes in the .xaml files.

Trennen von GIT

In den beiden folgenden Fällen steht die Option Trennen in der Studio Backstage-Ansicht auf der Registerkarte > Team für Dateien mit Versionsangabe zur Verfügung:

  1. Ein Prozess wird als lokales GIT-Repository initialisiert. Erstellen Sie einen neuen Prozess, fügen Sie ihn mit GIT init (GIT Init) zu einem lokalen GIT-Repository hinzu und entfernen Sie mit Trennen (Disconnect) das Unterversions-Tag.
  2. Das Unterversions-Tag kann durch Klicken auf Trennen (Disconnect) bei einem GIT-Repository entfernt werden, das über- und untergeordnete Projekte enthält.
  3. Beim Trennen eines untergeordneten Projekts wird das gesamte GIT-Repository, das die geöffneten Projekte enthält, von der Quellenkontrolle getrennt. In Studio wird ein Meldungsfenster geöffnet, in dem Sie aufgefordert werden, zu bestätigen, bevor die Trennung ausgeführt wird.

Ändern der Signatur

Das Ändern der GIT-Commitsignatur kann über die Registerkarte Team > Signatur ändern durchgeführt werden. Geben Sie Ihren Namen und Ihre E-Mail-Adresse ein, und klicken Sie auf OK.

Ändern der Anmeldeinformationen

So aktualisieren Sie die Anmeldeinformationen, die zum Herstellen einer Verbindung mit einem Remote-Repository verwendet werden:

  1. Wählen Sie im Verzweigungsmenü merge_buttonmerge_button in der Statusleiste Remotes verwalten aus.
  2. Klicken Sie im Dialogfeld „Remotes verwalten“ mit der rechten Maustaste auf ein Remote-Repository, und wählen Sie Anmeldeinformationen ändern aus.
  3. Je nachdem, wie das Repository geklont wurde (über HTTPS oder SSH), melden Sie sich entweder bei einem GitHub-Konto an (nur für Repositorys, die auf github.com gehostet werden), geben Sie den Benutzernamen/das Kennwort oder den Benutzernamen/das Token ein oder zeigen Sie auf einen neuen privaten Schlüssel und klicken Sie auf OK.
    Die Anmeldeinformationen werden in der Windows-Anmeldeinformationsverwaltung (Windows Credential Manager) aktualisiert.

Verwenden von GIT mit einem Proxyserver

Die GIT-Integration in Studio unterstützt den Zugriff auf Remote-Repositorys, wenn der Internetzugang über einen Proxyserver erfolgt. Dies kann auf zwei Arten erfolgen: entweder konfiguriert auf Computerebene im Fenster Proxyeinstellungen oder durch Änderungen an git-Befehlen.

Proxydetails, die im Fenster Proxyeinstellungen konfiguriert sind, werden berücksichtigt, ohne dass sie in die .gitconfig-Datei eingegeben werden müssen.

Um Proxydetails mit git-Befehlen zu konfigurieren, fügen Sie diese im folgenden Formular zu GIT-Konfigurationsdateien hinzu:
[http "https://domain.com"] proxy = http://proxyUsername:[email protected]:port

GIT-Konfigurationsdateien finden Sie an folgenden Speicherorten:

  • config-Datei: %ProgramData%\Git
  • .gitconfig-Datei: %UserProfile%
  • lokale config-Datei aus Projektebene, z. B. %UserProfile%\Desktop\testproject\.git.

Aktualisiert vor 2 Monaten

Verwalten von Projekten mit GIT


Auf API-Referenzseiten sind Änderungsvorschläge beschränkt

Sie können nur Änderungen an dem Textkörperinhalt von Markdown, aber nicht an der API-Spezifikation vorschlagen.