GitHub (TMS)

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

Verfügbar für

Team-, Business- und Enterprise-Pläne

Kontaktiere Vertrieb für Fragen zur Lizenzierung.

Verfügbar für

Ultimate- und Enterprise-Pläne (Legacy)

Kontaktiere Vertrieb für Fragen zur Lizenzierung.

Tipp

Informationen zur GitHub-Integration in Phrase Strings findest du unter GitHub (Strings).

Der GitHub-Konnektor ermöglicht das Herunterladen von Ausgangssprache-Dateien und das Hochladen von Zielsprache-Dateien direkt in das/aus dem GitHub-Repository.

Der Konnektor verwendet die GitHub-API, um die Integration zu implementieren. Der Konnektor ermöglicht den Zugriff auf alle Repositories, die mit einem GitHub-User-Konto verknüpft sind. Die Authentifizierung des GitHub-User-Kontos kann auch in der GitHub App erfolgen.

Anwendungsfälle

Der Konnektor kann in verschiedenen Anwendungsfällen verwendet werden:

Projektmanager können direkt aus einem Online-Repository Dateien zu Projekten hinzufügen.
Richte das Submitter Portal ein, um Einreichern zu ermöglichen, Dateien direkt aus dem Online-Repository zu Anfragen hinzuzufügen.
Verwende die Automatisierte Projekterstellung (APE), um automatisch neue Projekte erstellen zu lassen, wenn bei überwachten Dateien oder Ordnern eine Änderung der Dateigröße festgestellt wird.
- Dieser Konnektor unterstützt die Einstellung absoluter Pfade. Zielsprache-Übersetzungsdateien können nur im selben Branch wie die Ausgangssprache-Datei gespeichert werden.
Richte kontinuierliche Jobs ein, um ausgewählte Dateien auf Änderungen zu überwachen.

GitHub (Beta)

Hinweis

Der Konnektor befindet sich seit Juni 2026 in der Beta-Phase.

Authentifizierung

Der GitHub (Beta)-Konnektor verwendet das GitHub App-Installationstoken anstelle eines individuellen User-Kontos. Token sind kurzlebig und erneuern sich automatisch. Wenn ein User die Organisation verlässt oder den Zugriff auf das Repository verliert, funktioniert der Konnektor weiterhin.

Der GitHub (Beta)-Konnektor unterstützt nur die GitHub App-Authentifizierung. Die OAuth-Option des ursprünglichen Konnektors wird nicht unterstützt.

Exportieren

Der GitHub (Beta)-Konnektor fasst alle Dateien aus einem einzelnen Export in einem Commit und einem Pull Request zusammen, sodass CI pro Export unabhängig von der Dateianzahl nur einmal ausgeführt wird.

Dateien werden in einem einzigen Commit zusammengefasst, wenn der gesamte Content denselben Repository-Eigentümer, dasselbe Repository und denselben Branch teilt.

Wenn der APE so konfiguriert ist, dass Dateien hochgeladen werden, sobald sie einzeln fertiggestellt sind, wird jede Datei separat committet, anstatt sie zusammenzufassen.

Commit-Nachrichten werden automatisch generiert und können nicht angepasst werden. Beim Exportieren als Pull Request können der Name des Pull Requests und der Name des Zielsprache-Branch angepasst werden.

Bekannte Einschränkungen

Der Konnektor kann Dateien nur auflisten, herunterladen und hochladen. Das Löschen oder Verschieben von Dateien in GitHub wird nicht unterstützt. Jegliche Löschungen oder Umbenennungen müssen direkt in GitHub vorgenommen werden.
Die Dateiauflistung funktioniert aufgrund von GitHub API-Beschränkungen möglicherweise nicht korrekt für Repositorys mit mehr als 50.000 Dateien.
GitHub Enterprise Server wird derzeit nicht unterstützt.
Der neue Konnektor unterstützt nicht den OAuth-Flow des Vermächtnis-Konnektors. Wenn Ihre Organisation Beschränkungen für GitHub App-Installationen hat, lösen Sie diese vor der Migration.

Wechsel zum neuen GitHub (Beta)-Konnektor

Eine automatisierte Migration ist aufgrund der Änderung des Authentifizierungsmodells nicht möglich.

Hinweis

Das Wechseln eines kontinuierlichen APE vom Vermächtnis-Konnektor zum neuen Konnektor ist keine Migration. Phrase behandelt dies als eine neue Konnektor-Konfiguration, daher importiert der APE die Ausgangssprache-Datei als neuen Job erneut, anstatt den bestehenden zu aktualisieren. Die Datei wird als neuer Content behandelt, daher werden zuvor verarbeitete Wörter und maschinelle Übersetzungseinheiten (MTUs) nicht übernommen. Wenn Sie Konnektoren mitten im Projekt wechseln, erwarten Sie, dass die Wortanzahl und der MTU-Verbrauch für die betroffenen Dateien einen vollständigen Reimport widerspiegeln.

Voraussetzungen:

Admin-Zugriff auf deine GitHub Organisation, um eine GitHub App zu installieren. Installiere sie auf Organisationsebene, damit sie alle Repositories abdeckt, die deine APEs überwachen.
Die GitHub App-Installation muss auf Repositories mit Content für die Übersetzung zugreifen können, andernfalls schlägt der Import über APE fehl.
Bestehende APE-Einstellungen sichtbar (lasse den alten Konnektor in einem zweiten Tab geöffnet).
Ein Test-Branch oder ein Nicht-Produktions-Repository zur Validierung, bevor Live-Workflows umgestellt werden.

Folge diesen Schritten:

Installiere die Phrase GitHub App.
1. Scrolle in Phrase TMS auf der Seite Einstellungen nach unten zum Abschnitt Integrationen.
2. Klicke auf Konnektoren.
  
  Die Seite Konnektoren wird geöffnet.
3. Klicke auf Neuer Konnektor.
  
  Die Seite Konnektor erstellen wird geöffnet.
4. Ändere den Typ auf GitHub (Beta).
5. Klicke auf Verbinden.
  
  Phrase leitet zu GitHub weiter, um die Phrase GitHub App zu autorisieren.
6. Wähle auf GitHub die Organisation oder das User-Konto sowie die Repositories aus, auf die zugegriffen werden soll, und bestätige dann die Installation. Schließe jedes Repository ein, das derzeit von dem/den bestehenden Konnektor(en) überwacht wird.
  
  GitHub leitet automatisch zu Phrase weiter.
7. Wähle das User-Konto oder die Organisation aus, das/die verbunden werden soll.
Einen neuen Konnektor erstellen.
1. Scrolle in Phrase TMS auf der Seite Einstellungen nach unten zum Abschnitt Integrationen.
2. Klicke auf Konnektoren.
3. Klicke auf Neuer Konnektor.
4. Wähle die im ersten Schritt festgelegte GitHub App-Installation aus.
5. Einstellungen vom bestehenden Konnektor kopieren:
  - Repository und Branch
  - Unterordner-Pfad (bei Verwendung der Unterordner-Überwachung)
  - Dateifilter-Regex (falls konfiguriert)
  - Export-Modus: direkter Commit oder Pull Request sowie Zielsprache-Branch
  - Name des Pull Requests und Name des Zielsprache-Branchs (bei Verwendung des PR-Modus)
  Es ist möglich, mehrere Konnektoren unter derselben GitHub App-Installation zu erstellen, jeder mit unabhängigen Einstellungen.
Bestehende APEs im Dry-Run-Modus neu erstellen.

Die bestehenden APEs noch nicht löschen oder deaktivieren.
1. Neue APEs erstellen, die auf den neuen Konnektor verweisen und die bestehende APE-Konfiguration spiegeln.
2. Dry-Run-Modus für jeden neuen APE aktivieren, bevor dieser aktiviert wird. Der Dry-Run-Modus scannt das Repository und gleicht Dateien ab, ohne Übersetzungsaufträge auszulösen.
3. Überprüfen Sie die abgeglichenen Dateien. Bestätigen Sie, dass der Umfang mit dem übereinstimmt, den der bestehende APE überwacht.
Validieren Sie mit einem Test-Export.
1. Nehmen Sie eine kleine Änderung an einer Datei im überwachten Bereich vor.
2. Lösen Sie einen Export über den neuen Konnektor aus.
3. Bestätigen:
  - Es wird ein einzelner Commit erstellt (nicht einer pro Datei).
  - Der Commit erscheint unter der Identität der GitHub App, nicht unter einem persönlichen User-Konto.
  - CI wird einmal ausgeführt, nicht einmal pro Datei.
Live-Workflows umschalten.

Sobald die Validierung erfolgreich war:
1. Deaktivieren Sie die APCs auf dem Vermächtnis-Konnektor.
2. Aktivieren Sie die APCs auf dem neuen Konnektor (entfernen Sie den Dry-Run-Modus).
3. Überwachen Sie ein oder zwei Exportzyklen, bevor Sie den Vermächtnis-Konnektor außer Betrieb nehmen.
Nehmen Sie den Vermächtnis-Konnektor außer Betrieb.

Nachdem Sie bestätigt haben, dass der neue Konnektor stabil ist:
1. Löschen Sie die alten APCs.
2. Löschen Sie den Vermächtnis-Konnektor unter Einstellungen → Konnektoren → GitHub (Vermächtnis).
3. Optional das OAuth-Token für das User-Konto widerrufen, das vom Vermächtnis-Konnektor verwendet wurde.

GitHub Einstellungen (Vermächtnis)

Es sind keine Änderungen erforderlich.

Phrase TMS-Einstellungen

Wichtig

Beim Zugriff über einen Individuellen Fachbereich (z. B. mydomain.phrase.jp) öffnen Sie ein Inkognito-Browserfenster und melden Sie sich über cloud.memsource.com oder us.cloud.memsource.com an, um die für das Erstellen oder Speichern des Konnektors erforderliche Authentifizierung anzuwenden. Nach dem Speichern kann über den Individuellen Fachbereich auf den Konnektor zugegriffen werden.

Scrolle auf der Seite Einstellungen nach unten zum Abschnitt Integrationen.
Klicke auf Konnektoren.

Die Seite Konnektoren wird geöffnet.
Klicke auf Neuer Konnektor.

Die Seite Konnektor erstellen wird geöffnet.
Ändern Sie den Typ auf GitHub und geben Sie einen Namen für den Konnektor an.
Optional Individuellen Fachbereich verwenden aktivieren und API URL angeben.
Optional Übersetzungen als Pull Requests exportieren auswählen und einen Pull Request Branch angeben.
Falls erforderlich, Github App verwenden auswählen, um die Phrase GitHub App-URL anzuzeigen und Dateien über den GitHub App-Autorisierungsablauf zu importieren/exportieren:
1. Klicken Sie auf den Link, um die offizielle Seite des Phrase App-Konnektors in einem neuen Tab zu öffnen: https://github.com/apps/phrase-app-connector-eu (EU-Rechenzentrum) oder https://github.com/apps/phrase-app-connector-us (US-Rechenzentrum).
2. Installieren Sie die Phrase GitHub App für das Zielsprache GitHub User-Konto.
  
  Hinweis
  
  Wenn die GitHub-App nicht im Zielsprache-User-Konto von GitHub installiert ist, sind für den GitHub-Konnektor nur öffentliche Repositories sichtbar.
3. Schließen Sie den Installationsvorgang ab, indem Sie alle privaten Repositories auswählen, die für den GitHub-Konnektor sichtbar und zugänglich sein sollen.
4. Gehen Sie zurück zur Phrase-Connectors/Create-Seite, um die GitHub-App zu autorisieren und eine Verbindung zu GitHub herzustellen.
Klicken Sie auf Connect to GitHub. Wenn die Verbindung nicht über die GitHub-App hergestellt wird, erscheint ein Popup-Fenster oder ein neuer Tab, in dem Sie zur Autorisierung aufgefordert werden.
Geben Sie bei Bedarf eine Commit message ein.
Klicken Sie auf die Schaltfläche Authorize Phrase.

Wenn Sie die GitHub-App verwenden, klicken Sie auf die Schaltfläche Authorize Phrase App Connector.

Bei Erfolg schließt sich das Fenster/der Tab und ein kleines Häkchen erscheint neben der Schaltfläche Connect to GitHub.
Klicke auf Speichern.

Der Konnektor wird der Liste auf der Seite Konnektoren hinzugefügt.

Wichtig

Wenn der GitHub-Konnektor über den Autorisierungsablauf der GitHub-App erstellt wurde, ist es nicht möglich, die Autorisierungsmethode nach dem Speichern der Konnektor-Einstellungen zu ändern.

Konnektor löschen

So löschen Sie einen Konnektor:

Wählen Sie auf der Integrations-Seite den Konnektor aus, den Sie löschen möchten.
Klicken Sie auf löschen.

Das Fenster Konnektor löschen wird geöffnet.
Geben Sie „Löschen“ ein und klicken Sie auf löschen.

Der Konnektor wird gelöscht und die Liste der Konnektoren wird angezeigt.

Hinweis

Ein Konnektor kann nicht gelöscht werden, solange er noch mit unvollständigen Jobs in einem Projekt verknüpft ist, einschließlich Jobs, die sich im Papierkorb befinden. Der Versuch, einen solchen Konnektor zu löschen, führt zu der Fehlermeldung „Konnektor konnte nicht gelöscht werden“.

Lösung: Öffnen Sie das mit dem Konnektor verknüpfte Projekt und schließen Sie alle verbleibenden Jobs ab oder löschen Sie diese. Gehen Sie zu Einstellungen/Papierkorb und leeren Sie ihn, um alle Aufträge zu entfernen, die noch mit dem Konnektor verknüpft sind. Versuchen Sie erneut, den Konnektor zu löschen.