Benutzerhandbuch Abbrechen

Zusammenarbeit mit von Azure DevOps (Team Foundation Server)

Suchen

Zuletzt aktualisiert am 12. November 2023

Erfahren Sie, wie Sie von RoboHelp aus mithilfe von Azure DevOps (früher Team Foundation Server/Visual Studio Team Services) zusammenarbeiten.

Voraussetzungen für die Verbindung mit Azure DevOps

Bevor Sie ein Azure DevOps-Verbindungsprofil erstellen, gehen Sie wie folgt vor:

Richten Sie die Azure DevOps-Versionskontrolle auf Ihrem Computer ein. Weitere Informationen finden Sie in der Microsoft-Hilfe.
Klicken Sie in RoboHelp auf Bearbeiten > Voreinstellungen. Klicken Sie im Dialogfeld Anwendungseinstellungen auf Versionskontrolle, und geben Sie im Feld Team Foundation-Client den vollständigen Pfad der Binärdatei tf.exe an. Die Binärdatei tf.exe ist im Installationsverzeichnis von Visual Studio oder Team Explorer auf Ihrem Computer verfügbar. Ein Beispielpfad:
C:/Programme (x86)/Microsoft Visual Studio/2017/Enterprise/Common7/IDE/CommonExtensions/Microsoft/
TeamFoundation/Team Explorer/TF.exe

Hinweis:

RoboHelp unterstützt die tf.exe-Dateiversion 14.102 und höher.

Wenn Ihre Systemsprache nicht Englisch ist, ist eine Problemumgehung erforderlich, um die Verbindung mit Azure DevOps zu ermöglichen.Der Ordner, der tf.exe enthält, enthält auch Unterordner für verschiedene Sprachen. Entfernen Sie den Unterordner, der Ihrer Systemsprache entspricht, oder benennen Sie ihn um, damit tf.exe standardmäßig die englische Version verwendet. Wenn Ihre Systemsprache beispielsweise Französisch ist, entfernen Sie den Unterordner „fr“ oder benennen Sie ihn um.

Erstellen eines Azure DevOps-Verbindungsprofils

Erstellen Sie ein Projekt in Azure DevOps Services (oder einem Teamprojekt auf Azure DevOps Server), um ein Repository für Quellinhalte einzurichten, in dem Teams planen, den Fortschritt verfolgen und zusammenarbeiten können.

Hinweis:

Stellen Sie sicher, dass Ihr Benutzerkonto über ausreichende Berechtigungen für den Zugriff auf das erstellte Projekt verfügt. Falls Sie eine Verbindung mit einem Azure DevOps Server herstellen, ist dieses Konto mit Ihrem Systemkonto identisch (über das RoboHelp ausgeführt wird). Informationen zum Ändern von Benutzerberechtigungen finden Sie in der Microsoft-Hilfe.
Wählen Sie in RoboHelp Zusammenarbeiten > Neue Verbindung.
Geben Sie im Dialogfeld Verbindungsprofile einen Namen für Ihr Verbindungsprofil ein.
Wählen Sie in der Dropdownliste Versionskontrolle die Option Azure DevOps (Team Foundation Server).
Definieren und verwalten Sie im Feld Projektsammlungs-URL die Serviceverbindungen Ihres Projekts:
- Geben Sie für Azure DevOps Server als Projektsammlungs-URL http://myserver:8080/tfs/DefaultCollection
  ein.
- Geben Sie für Azure DevOps Services als Organisations-URL https://dev.azure.com/myorganization
  ein.
Wenn Sie eine Azure DevOps Server-URL angegeben haben, ist ein Kontrollkästchen sichtbar, um die Authentifizierung über persönliche Zugriffstoken zu aktivieren.

Die Standardauthentifizierung für Azure DevOps Server-Verbindungen ist NTLM-basiert. Wenn Sie das Kontrollkästchen Persönliches Zugriffstoken für die Authentifizierung verwenden aktivieren, werden Sie dazu aufgefordert, sich über das generierte PZT zu authentifizieren.

Weitere Informationen finden Sie unter AzureDevOps-PZT.
Geben Sie im Feld Projekt den Namen des Azure DevOps-Projekts an. Hier können Sie auch den Pfad eines beliebigen Ordners in Ihrem Projekt-Repository angeben. Der Pfad wird im folgenden Format angegeben:

$/<Projektname>/<verschachtelter Pfad>

'$/<Projektname>' ist der Standardrepositorypfad.

Hinweis:

Der Projektname und die Groß- und Kleinschreibung müssen dem Namen und der Schreibweise des Teamprojekts in Azure DevOps entsprechen.
Geben Sie im Feld Arbeitsbereich einen Arbeitsbereichsnamen an. Dieser Arbeitsbereich wird unter dem Pfad erstellt, der im Feld Lokaler Pfad angegeben ist.

Der Arbeitsbereich ist die lokale Kopie des Projekts. Sie können Inhalte lokal in RoboHelp erstellen und dann in Azure DevOps einchecken. Weitere Informationen zum Arbeitsbereich finden Sie in der Microsoft-Hilfe.

Hinweis:

Stellen Sie sicher, dass Ihr Benutzerkonto über die entsprechenden Berechtigungen zum Erstellen eines Arbeitsbereichs für das Projekt verfügt.

RoboHelp funktioniert nur mit lokalen Arbeitsbereichen. Informationen zur Verwendung eines lokalen Arbeitsbereichs und zum Festlegen des Standardarbeitsbereichstyps für Ihre Projektsammlung finden Sie in der Microsoft-Hilfe.
Geben Sie im Feld Lokaler Pfad einen Pfad auf Ihrem Computer an, der dem Projekt zugeordnet ist.

Wenn das Verbindungsprofil zum Hochladen des aktuell geöffneten RoboHelp-Projekts in Azure DevOps verwendet werden soll, geben Sie den Ordner mit dem Projekt oder einen übergeordneten Ordner an. Dieser Ordner wird den Projektinhalten auf dem Server zugeordnet.

Wenn Sie das Verbindungsprofil zum Herunterladen von Projektinhalten verwenden möchten, geben Sie den Pfad zu einem leeren lokalen Ordner an, in den das Projekt heruntergeladen werden soll.
Klicken Sie auf Speichern.

Herunterladen eines RoboHelp-Projekts von Azure DevOps

Wählen Sie in RoboHelp Zusammenarbeit > Verbindung öffnen, und wählen Sie ein Azure DevOps-Verbindungsprofil aus.

Hinweis:

Bei erstmaligen Verbindungen mit der Projektsammlungs-URL fordert RoboHelp Sie zur Eingabe Ihrer Anmeldeinformationen auf und speichert sie zur späteren Verwendung in der Anmeldeinformationsverwaltung des Systems.

Bei Verbindungen mit Azure DevOps Server bestehen die Anmeldeinformationen aus dem Kennwort für Ihr Benutzerkonto. Bei Verbindungen mit Azure DevOps Services bestehen die Anmeldeinformationen aus einem persönlichen Zugriffstoken mit entsprechenden Berechtigungen. Hilfe zu persönlichen Zugriffstoken finden Sie in der Microsoft-Hilfe.

Hinweis:

Wenn Sie die Anmeldeinformationen kürzlich geändert haben, löschen oder aktualisieren Sie den entsprechenden Datensatz in der Anmeldeinformationsverwaltung des Systems, um Authentifizierungsfehlermeldungen zu vermeiden. Der Datensatz wird in folgendem Format gespeichert:
Team:<Server>|<Benutzer>
. Wenn RoboHelp in der Anmeldeinformationsverwaltung des Systems keinen passenden Datensatz findet, werden Sie erneut zur Eingabe der Anmeldeinformationen aufgefordert. Weitere Informationen zur Anmeldeinformationsverwaltung des Systems (Windows) finden Sie in der Microsoft-Hilfe.

Das Projekt wird unter dem im Verbindungsprofil angegebenen lokalen Pfad geklont.
Wählen Sie im Dialogfeld Öffnen eine RoboHelp-Projektdatei (.rhpj) und klicken Sie auf Öffnen.

RoboHelp öffnet die Projektdatei.

Hinweis:

Wenn Sie ein RoboHelp-Projekt zum ersten Mal anhand dieser Schritte öffnen, werden die Verbindungsinformationen für die spätere Verwendung im Projekt gespeichert. Öffnen Sie das Projekt also direkt anhand einer der unter Öffnen eines Projekts beschriebenen Arten.

Arbeiten mit Dateien unter Versionskontrolle

Sie können Inhalt zu einem Thema hinzufügen oder ein Thema bearbeiten. Auch wenn keine Netzwerkverbindung vorhanden oder sie instabil ist, können Sie Dateien bearbeiten. Da RoboHelp nur lokale Arbeitsbereiche verwendet, müssen Sie die Dateien vor der Bearbeitung nicht explizit auschecken.
Um die Änderungen im Server einzuchecken, wählen Sie Zusammenarbeit > Einchecken.
Wählen Sie im Dialogfeld Einchecken aus der Liste der geänderten, neu hinzugefügten und gelöschten Dateien diejenigen aus, die Sie einchecken möchten.
Sie können optional eine Check-In-Beschreibung angeben.
Klicken Sie auf Einchecken.

Nach erfolgreichem Einchecken zeigt RoboHelp eine entsprechende Meldung an.

Hinweis:

Wenn die Datei, die Sie einchecken möchten, von einem anderen Benutzer auf dem Server geändert wurde, schlägt der Vorgang fehl. Sie werden aufgefordert, den Konflikt zwischen der lokalen Version und der Serverversion zu beheben. Checken Sie die Datei erneut ein, nachdem alle Konflikte behoben wurden.
Um Ihre lokalen Dateien mit der neuesten Version von Azure DevOps zu synchronisieren, wählen Sie Zusammenarbeit > Aktuelle Version abrufen.

Dateien in Ihrem Arbeitsbereich werden aktualisiert, mit Ausnahme der Dateien, die Änderungen enthalten. Sie können die lokal bearbeiteten Versionen beim Einchecken mit den aktualisierten Versionen vom Server zusammenführen.

Dateien sperren

Sie können Dateien im Inhaltsbereich sperren, um Änderungen durch andere Benutzer auf dem Server vorübergehend zu verhindern. Dies ist hilfreich, wenn Sie eine Datei in Ihrem Arbeitsbereich ändern und dann einchecken möchten, ohne Zusammenführungskonflikte zu beheben. Es kann immer nur ein Benutzer eine Datei sperren.

Um den Sperrstatus einer Datei zu aktualisieren, klicken Sie mit der rechten Maustaste darauf und wählen Sie Sperrstatus aktualisieren.

RoboHelp zeigt den Sperrstatus einer Datei als an, wenn sie von anderen Benutzern gesperrt wurde, und als , wenn sie von Ihnen gesperrt wurde.
Bewegen Sie den Mauszeiger über , um den Namen des Benutzers anzuzeigen, der die Datei gesperrt hat.
Um eine Datei zu sperren, klicken Sie im Inhaltsbereich mit der rechten Maustaste darauf und wählen Sie Sperren. Die Option Sperren wird nur angezeigt, wenn die Datei noch nicht von einem anderen Benutzer gesperrt wurde. Durch das Sperren einer Datei können andere Benutzer sie bearbeiten. Sie können ihre Änderungen jedoch erst auf dem Server einchecken, wenn die Sperre aufgehoben wird.
Um eine gesperrte Datei zu entsperren, klicken Sie mit der rechten Maustaste darauf und wählen Sie Entsperren. Auf diese Weise können andere Benutzer ihre Änderungen auf dem Server einchecken. Wenn Sie eine von Ihnen gesperrte Datei einchecken, wird diese automatisch entsperrt.

Hinzufügen eines RoboHelp-Projekts zu Azure DevOps

Um ein Projekt hinzuzufügen, wählen Sie Zusammenarbeit > Projekt hinzufügen und ein Azure DevOps-Verbindungsprofil aus.

Der lokale Pfad im Profil muss das aktuelle Projekt enthalten. Weitere Informationen finden Sie unter Schritt 8 in Erstellen eines Azure DevOps-Verbindungsprofils.

Das Dialogfeld Einchecken wird geöffnet.
Checken Sie die erforderlichen Dateien ein, wie unter Arbeiten mit Dateien unter Versionskontrolle beschrieben.

Entfernen der Azure DevOps-Verbindung

Um die Azure DevOps-Verbindung aus dem aktuellen RoboHelp-Projekt zu entfernen, wählen Sie Zusammenarbeit > Verbindung entfernen.
Wenn Sie den lokalen Arbeitsbereich ebenfalls löschen möchten, wählen Sie das Feld Alle Versionskontrollinformationen auch aus dem lokalen Ordner löschen im Dialogfeld Bestätigen aus.

Vorsicht:

Checken Sie alle Ihre Änderungen ein, bevor Sie den Arbeitsbereich löschen, und entsperren Sie gesperrte Dateien, die nicht eingecheckt werden.

Hinweis:

Das Löschen des Arbeitsbereichs schlägt fehl, wenn der aktuelle Benutzer keine Berechtigung dafür hat.
Klicken Sie auf OK.

Sobald die Verbindung entfernt wurde, öffnet RoboHelp das Projekt erneut und die Option Projekt hinzufügen im Menü Zusammenarbeit wird verfügbar. Um das Projekt erneut hinzuzufügen, gehen Sie wie unter Hinzufügen eines Projekts zu Azure DevOps beschrieben vor.

Schneller und einfacher Hilfe erhalten

Neuer Benutzer?