Integrationen
    1. Phrase
    2. Phrase TMS
    3. Integrationen

    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-Connector ermöglicht das Herunterladen von Quelldateien und das Hochladen von Zieldateien direkt aus dem bzw. in das GitHub-Repository.

    Der Connector verwendet die GitHub-API zur Implementierung der Integration. Der Connector ermöglicht den Zugriff auf alle Repositories, die mit einem GitHub-Konto verknüpft sind. Die Authentifizierung des GitHub-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 Einreicher-Portal ein, um Einreichern zu ermöglichen, Dateien direkt aus dem Online-Repository zu Anfragen hinzuzufügen.

    • Verwende die Automatisierte Projekterstellung (APC), um automatisch neue Projekte erstellen zu lassen, wenn bei überwachten Dateien oder Ordnern eine Änderung der Dateigröße festgestellt wird.

      • Dieser Connector unterstützt die Einstellung absoluter Pfade. Zielsprachige Übersetzungsdateien können nur im selben Branch wie die Quelldatei gespeichert werden.

    • Richte kontinuierliche Jobs ein, um ausgewählte Dateien auf Änderungen zu überwachen.

    GitHub (Beta)

    Hinweis

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

    Authentifizierung

    Der GitHub (Beta)-Connector verwendet das GitHub App-Installationstoken anstelle eines individuellen Benutzerkontos. Tokens sind kurzlebig und werden automatisch erneuert. Wenn ein Benutzer die Organisation verlässt oder den Zugriff auf das Repository verliert, funktioniert der Connector weiterhin.

    Der GitHub (Beta)-Connector unterstützt ausschließlich die Authentifizierung über die GitHub App. Die OAuth-Option des ursprünglichen Connectors wird nicht unterstützt.

    Exportieren

    Der GitHub (Beta)-Connector fasst alle Dateien aus einem 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 alle Inhalte denselben Repository-Eigentümer, dasselbe Repository und denselben Branch teilen.

    Wenn der APC 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 Export als Pull Request können der Name des Pull Requests und der Name des Ziel-Branches angepasst werden.

    Bekannte Einschränkungen

    • Der Connector 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 bei Repositories mit mehr als 50.000 Dateien aufgrund von GitHub API-Einschränkungen möglicherweise nicht korrekt.

    • GitHub Enterprise Server wird derzeit nicht unterstützt.

    • Der neue Connector unterstützt nicht den OAuth-Flow des Legacy-Connectors. Wenn deine Organisation Beschränkungen für GitHub App-Installationen hat, behebe diese vor der Migration.

    Wechsel zum neuen GitHub (Beta)-Connector

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

    Hinweis

    Das Umstellen eines kontinuierlichen APC vom Legacy-Connector auf den neuen Connector ist keine Migration. Phrase behandelt dies als eine neue Connector-Konfiguration, sodass der APC die Quelldatei als neuen Job importiert, anstatt den bestehenden zu aktualisieren. Die Datei wird als neuer Inhalt behandelt, daher werden zuvor verarbeitete Wörter und Machine Translation Units (MTUs) nicht übernommen. Wenn du während eines Projekts den Connector wechselst, rechne damit, dass die Wortanzahl sowie der MTU-/Guthabenverbrauch für die betroffenen Dateien einen vollständigen Neuimport widerspiegeln.

    Voraussetzungen

    • Administratorzugriff auf deine GitHub-Organisation, um eine GitHub App zu installieren. Installiere sie auf Organisationsebene, damit sie alle Repositories abdeckt, die deine APCs überwachen.

    • Die GitHub App-Installation muss Zugriff auf Repositories mit Inhalten für die Übersetzung haben, andernfalls schlägt der Import über APC fehl.

    • Vorhandene APC-Einstellungen sichtbar (lass den alten Connector in einem zweiten Tab geöffnet).

    • Ein Test-Branch oder ein Nicht-Produktions-Repository zur Validierung, bevor Live-Workflows umgestellt werden.

    Folge diesen Schritten:

    1. Phrase-GitHub-App installieren

      1. Navigiere in Phrase TMS von der Seite 'Einstellungen' Setup_gear.png nach unten zum Bereich Integrations.

      2. Klicke auf Konnektoren.

        Die Seite Konnektoren wird geöffnet.

      3. Klick auf New connector.

        Die Seite Create connector wird geöffnet.

      4. Ändere den Type zu GitHub (Beta).

      5. Klick auf Connect.

        Phrase leitet zu GitHub weiter, um die Phrase GitHub App zu autorisieren.

      6. Wähle auf GitHub die Organisation oder das Konto sowie die Repositories aus, denen du Zugriff gewähren möchtest, und bestätige dann die Installation. Schließ jedes Repository ein, das derzeit vom bestehenden Connector bzw. den bestehenden Connectoren überwacht wird.

        GitHub leitet automatisch zu Phrase weiter.

      7. Wähle das Benutzer- oder Organisationskonto aus, das verbunden werden soll.

    2. Erstelle einen neuen Connector.

      1. Navigiere in Phrase TMS von der Seite 'Einstellungen' Setup_gear.png nach unten zum Bereich Integrationen.

      2. Klicke auf Konnektoren.

      3. Klick auf New connector.

      4. Wähle die im ersten Schritt eingerichtete GitHub App-Installation aus.

      5. Kopiere die Einstellungen vom bestehenden Connector:

        • Repository und Branch

        • Unterordnerpfad (bei Verwendung der Unterordnerüberwachung)

        • Dateifilter-Regex (falls konfiguriert)

        • Exportmodus: direkter Commit oder Pull Request sowie Ziel-Branch

        • Name des Pull Requests und Name des Ziel-Branches (bei Verwendung des PR-Modus)

        Es ist möglich, mehrere Connectors unter derselben GitHub App-Installation zu erstellen, jeder mit unabhängigen Einstellungen.

    3. Erstelle bestehende APCs im Dry-Run-Modus neu.

      Lösche oder deaktiviere die bestehenden APCs noch nicht.

      1. Erstelle neue APCs, die auf den neuen Connector verweisen, und spiegele die bestehende APC-Konfiguration.

      2. Aktiviere den Dry-Run-Modus für jeden neuen APC, bevor du ihn in Betrieb nimmst. Der Dry-Run-Modus scannt das Repository und gleicht Dateien ab, ohne Übersetzungsaufträge auszulösen.

      3. Überprüfe die abgeglichenen Dateien. Bestätige, dass der Umfang mit dem übereinstimmt, was der bestehende APC überwacht.

    4. Validiere mit einem Test-Export.

      1. Nimm eine kleine Änderung an einer Datei im überwachten Bereich vor.

      2. Löse einen Export über den neuen Connector 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 Konto.

        • CI wird einmal ausgeführt, nicht einmal pro Datei.

    5. Schalte die Live-Workflows um.

      Sobald die Validierung erfolgreich war:

      1. Deaktiviere die APCs auf dem Legacy-Connector.

      2. Aktiviere die APCs auf dem neuen Connector (entferne den Dry-Run-Modus).

      3. Überwache ein oder zwei Exportzyklen, bevor du den Legacy-Connector außer Betrieb nimmst.

    6. Nimm den Legacy-Connector außer Betrieb.

      Nachdem du bestätigt hast, dass der neue Connector stabil ist:

      1. Lösche die alten APCs.

      2. Lösche den Legacy-Connector unter Einstellungen → Connectors → GitHub (Legacy).

      3. Widerrufen Sie optional das OAuth-Token für das Benutzerkonto, das vom Legacy-Connector verwendet wurde.

    GitHub-Einstellungen (Legacy)

    Es sind keine Änderungen erforderlich.

    Phrase TMS-Einstellungen

    Wichtig

    Wenn du über eine benutzerdefinierte Domain zugreifst (z. B. mydomain.phrase.jp), öffne ein Inkognito-Browserfenster und melde dich über cloud.memsource.com oder us.cloud.memsource.com an, um die für das Erstellen oder Speichern des Connectors erforderliche Authentifizierung anzuwenden. Nach dem Speichern kannst du über die benutzerdefinierte Domain auf den Connector zugreifen.

    1. Scrolle auf der Seite Einstellungen Setup_gear.png nach unten zum Abschnitt Integrationen.

    2. Klicke auf Konnektoren.

      Die Seite Konnektoren wird geöffnet.

    3. Klick auf New connector.

      Die Seite Create connector wird geöffnet.

    4. Ändere den Typ auf GitHub und gib einen Namen für den Connector an.

    5. Aktiviere optional Benutzerdefinierte Domain verwenden und gib die API-URL an.

    6. Wähle optional Übersetzungen als Pull Requests exportieren aus und gib einen Pull-Request-Branch an.

    7. Wähle bei Bedarf GitHub-App verwenden aus, um die URL der Phrase GitHub-App anzuzeigen und Dateien über den Autorisierungsablauf der GitHub-App zu importieren/exportieren:

      1. Klicke auf den Link, um die offizielle Seite des Phrase App Connectors 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. Installiere die Phrase GitHub-App für das Ziel-GitHub-Konto.

        Hinweis

        Wenn die GitHub-App nicht für das Ziel-GitHub-Konto des Benutzers installiert ist, sind für den GitHub-Connector nur öffentliche Repositories sichtbar.

      3. Schließe den Installationsvorgang ab, indem du alle privaten Repositories auswählst, die für den GitHub-Connector sichtbar und zugänglich sein sollen.

      4. Gehe zurück zur Seite Connectors/Create von Phrase, um die GitHub-App zu autorisieren und eine Verbindung zu GitHub herzustellen.

    8. Klicke auf Mit GitHub verbinden. Wenn keine Verbindung über die GitHub-App besteht, erscheint ein Popup-Fenster oder ein neuer Tab, in dem um Autorisierung gebeten wird.

    9. Gib bei Bedarf eine Commit-Nachricht ein.

    10. Klicke auf die Schaltfläche Phrase autorisieren.

      Wenn du die GitHub-App verwendest, klicke auf die Schaltfläche Phrase App Connector autorisieren.

      Bei Erfolg schließt sich das Fenster bzw. der Tab und ein kleines Häkchen erscheint neben der Schaltfläche Mit GitHub verbinden.

    11. Klicke auf Speichern.

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

      Wichtig

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

    Einen Connector löschen

    So löschst du einen Connector:

    1. Wähle auf der Seite Integrationen den zu löschenden Connector aus.

    2. Klicke auf Löschen.

      Das Fenster Connector löschen öffnet sich.

    3. Gib „delete“ ein und klicke auf Löschen.

      Der Connector wird gelöscht und die Liste der Connectoren wird angezeigt.

    Hinweis

    Ein Connector 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 Connector zu löschen, führt zu der Fehlermeldung „Failed to delete connector“.

    Lösung: Öffne das mit dem Connector verknüpfte Projekt und schließe alle verbleibenden Jobs ab oder lösche sie. Gehe zu Einstellungen/Papierkorb und leere diesen, um alle Jobs zu entfernen, die noch mit dem Connector verknüpft sind. Versuche erneut, den Connector zu löschen.

    War dieser Beitrag hilfreich?
    ★ ★ ★ ★ ★

    Sorry about that! In what way was it not helpful?

    The article didn’t address my problem.
    I couldn’t understand the article.
    The feature doesn’t do what I need.
    Other reason.

    Note that feedback is provided anonymously so we aren't able to reply to questions.
    If you'd like to ask a question, submit a request to our Support team.
    Thank you for your feedback.