Bitbucket (Strings)

Inhalte werden von Phrase Language AI maschinell aus dem Englischen übersetzt.

Tipp

Für Informationen zur Bitbucket-Integration in Phrase TMS siehe Bitbucket Cloud (TMS).

Bitbucket Sync wird nur für Bitbucket Cloud unterstützt. Es kann nicht mit Bitbucket Server verwendet werden.
Bitbucket Sync kann über API verwendet werden.

Voraussetzungen

Die .phrase.yml Konfigurationsdatei muss im Stammverzeichnis des zu überwachenden Branches vorhanden sein. Die Datei legt fest, welche Dateien aus dem Repository importiert (pull) oder exportiert (push) werden sollen.
Für das Repository ist Lese- und Schreibzugriff erforderlich.
Falsch festgelegte Konfigurationsdateien können Fehler verursachen. Stelle sicher, dass die Datei mindestens ein Push- und ein Pull-Ziel, die korrekten Dateiformate und die korrekte Einstellung des Parameters update_translations enthält.

Beispiel Konfigurationsdatei:

phrase:
    project_id: 1f61b9ecdb7a17a9dd174302419c50cc
    file_format: simple_json
    push:
        sources:
            - file: ./<locale_name>.json
    pull:
        targets:
            - file: ./<locale_name>.json

Die Projekt-ID eines Projekts befindet sich in den Projekteinstellungen.

Repositories verbinden

Sobald die Konfigurationsdatei vorhanden ist, folgen Sie diesen Schritten, um ein Repository zu verbinden:

Gehen Sie von der Integrationen-Seite nach unten zu Repo-Synchronisierung und klicken Sie auf Konfigurieren.

Die Seite Repo-Synchronisierungen öffnet sich.
Klicken Sie auf Synchronisierung hinzufügen/Bitbucket.

Die Aktivierungsseite für die Bitbucket-Synchronisierung öffnet sich.
Wählen Sie das zu verbindende Bitbucket-Konto aus der Dropdown-Liste Für Arbeitsbereich autorisieren aus und klicken Sie auf Zugriff gewähren.

Die Verbindung zwischen Phrase Strings und dem ausgewählten Bitbucket-Konto wird hergestellt. Das Einstellungsfenster der Bitbucket-Synchronisierung wird angezeigt.

Hinweis

Es ist nicht möglich, mehrere Konten über die Bitbucket-Integration zu verbinden.
Wählen Sie ein Projekt aus der Dropdown-Liste aus.
Wählen Sie ein Bitbucket-Repository aus der Dropdown-Liste aus.

Wenn der Repository-Besitz nicht korrekt ist, wird das Repository nicht in der Dropdown-Liste angezeigt.
Wählen Sie einen Repository-Branch aus der Dropdown-Liste aus, um von ihm zu importieren (push) und zu exportieren (pull). Dies ist normalerweise der Master-Branch.
Klicken Sie auf Konfiguration validieren, um sicherzustellen, dass die Authentifizierungseinstellungen und die Konfigurationsdatei korrekt sind.
Wählen Sie optional Automatischer Import aus, um Dateien mit jedem Commit in den ausgewählten Bitbucket-Branch zu importieren.
Klicken Sie auf Speichern.

Das Projekt ist jetzt mit dem ausgewählten Bitbucket-Repository verbunden und zur Liste hinzugefügt worden.

Integrationen können auf der Repo Syncs Seite deaktiviert oder entfernt werden.

Optional können Benutzer eine Bitbucket-Integration entfernen, indem sie die Autorisierung für Phrase Strings in ihren Bitbucket persönlichen Einstellungen widerrufen.

Import von Bitbucket

Nach der Aktivierung der Bitbucket-Synchronisierung und der Verbindung eines Repositories können Locale-Dateien importiert werden. Dies geschieht in Form von Pull-Requests, sodass Änderungen überprüft und das Branch-Management kontrolliert werden kann.

Um Locale-Dateien von Bitbucket zu importieren, befolgen Sie diese Schritte:

Wählen Sie auf der Repo Syncs Seite ein Projekt aus und klicken Sie auf Import .

Übersetzungen werden in das Projekt übernommen. Schlüssel und aktuelle Übersetzungen werden aktualisiert.
Genehmigen, zusammenführen oder schließen Sie den Pull-Request in Bitbucket.

Export nach Bitbucket

Um Locale-Dateien nach Bitbucket zu exportieren, befolgen Sie diese Schritte:

Wählen Sie auf der Repo Syncs Seite ein Projekt aus und klicken Sie auf Export .

Das Export Fenster wird angezeigt.
Geben Sie den Ziel-Branch im Feld PR-Branch an.

Die neuesten Dateien im Repository werden als neuer Pull-Request in den gewünschten Branch exportiert.
Sobald die Dateien exportiert sind, kann der Pull-Request im Repository zusammengeführt oder geschlossen und der Branch gelöscht werden.

Verlauf

Repo-Synchronisierungen führen einen Verlauf der letzten Importe und Exporte für jedes Phrase Strings-Projekt.

Um die Historie anzuzeigen:

Wählen Sie auf der Repo Syncs-Seite ein Projekt aus und klicken Sie auf Historie .

Die Import- und Exporthistorie für das Projekt wird angezeigt. Exporteinträge in der Historie enthalten einen Link zur entsprechenden Zusammenführungsanfrage.