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 finden Sie unter GitHub (Strings).

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

    • Richten Sie das Einreicher-Portal ein, um Einreichern zu ermöglichen, Dateien direkt aus dem Online-Repository zu Anfragen hinzuzufügen.

    • Verwenden Sie 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.

    • Richten Sie kontinuierliche Aufträge 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. Token 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 Exportieren 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 aufgrund von GitHub API-Einschränkungen möglicherweise nicht korrekt für Repositories mit mehr als 50.000 Dateien.

    • GitHub Enterprise Server wird derzeit nicht unterstützt.

    • Der neue Connector unterstützt den OAuth-Flow des Legacy-Connectors nicht. Falls die Organisation Einschränkungen bei GitHub App-Installationen aufweist, müssen diese vor der Migration behoben werden.

    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 reimportiert, 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. Beim Wechsel des Connectors während eines Projekts ist zu erwarten, dass die Wortanzahl sowie der MTU-/Credit-Verbrauch der betroffenen Dateien einem vollständigen Reimport entsprechen.

    Voraussetzungen

    • Administratorzugriff auf die GitHub-Organisation, um eine GitHub App zu installieren. Auf Organisationsebene installieren, damit alle von den APCs überwachten Repositories abgedeckt werden.

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

    • Bestehende APC-Einstellungen sichtbar (lassen Sie 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. Scrollen Sie in Phrase TMS auf der Seite Einstellungen Setup_gear.png nach unten zum Bereich Integrationen.

      2. Klicke auf Konnektoren.

        Die Seite Konnektoren wird geöffnet.

      3. Klicken Sie auf Neuer Connector.

        Die Seite Connector erstellen wird geöffnet.

      4. Ändern Sie den Typ auf GitHub (Beta).

      5. Klicken Sie auf Verbinden.

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

      6. Auf GitHub die Organisation bzw. das Konto sowie die entsprechenden Repositories auswählen und die Installation bestätigen. Alle aktuell von den bestehenden Connectoren überwachten Repositories sollten einbezogen werden.

        GitHub leitet automatisch zu Phrase weiter.

      7. Das Benutzer- oder Organisationskonto, das verbunden werden soll, auswählen.

    2. Ein neuer Connector wird erstellt.

      1. Scrollen Sie in Phrase TMS auf der Seite Einstellungen Setup_gear.png nach unten zum Bereich Integrationen.

      2. Klicke auf Konnektoren.

      3. Klicken Sie auf New connector.

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

      5. Kopieren Sie 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. Erstellen Sie vorhandene APCs im Dry-Run-Modus neu.

      Bestehende APCs sollten noch nicht gelöscht oder deaktiviert werden.

      1. Neue APCs sollten erstellt werden, die auf den neuen Connector verweisen und die bestehende APC-Konfiguration widerspiegeln.

      2. Der Dry-Run-Modus sollte für jeden neuen APC aktiviert werden, bevor dieser in Betrieb genommen wird. Der Dry-Run-Modus scannt das Repository und gleicht Dateien ab, ohne Übersetzungsaufträge auszulösen.

      3. Die abgeglichenen Dateien sollten überprüft werden. Es sollte bestätigt werden, dass der überwachte Umfang mit dem des bestehenden APC übereinstimmt.

    4. Es sollte ein Testexport zur Validierung durchgeführt werden.

      1. An einer Datei im überwachten Bereich sollte eine kleine Änderung vorgenommen werden.

      2. Ein Export über den neuen Connector sollte ausgelöst werden.

      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. Die Live-Workflows sollten umgestellt werden.

      Sobald die Validierung erfolgreich war:

      1. Die APCs auf dem Legacy-Connector sollten deaktiviert werden.

      2. Die APCs auf dem neuen Connector sollten aktiviert und der Dry-Run-Modus entfernt werden.

      3. Es sollte ein bis zwei Exportzyklen überwacht werden, bevor der Legacy-Connector außer Betrieb genommen wird.

    6. Der Legacy-Connector sollte außer Betrieb genommen werden.

      Nachdem die Stabilität des neuen Connectors bestätigt wurde:

      1. Die alten APCs sollten gelöscht werden.

      2. Der Legacy-Connector sollte unter Einstellungen → Connectors → GitHub (Legacy) gelöscht werden.

      3. Optional sollte das OAuth-Token des Benutzerkontos, das vom Legacy-Connector genutzt wurde, widerrufen werden.

    GitHub-Einstellungen (Legacy)

    Es sind keine Änderungen erforderlich.

    Phrase TMS-Einstellungen

    Wichtig

    Wenn über eine benutzerdefinierte Domain (z. B. mydomain.phrase.jp) zugegriffen wird, sollte ein Inkognito-Browserfenster geöffnet und über cloud.memsource.com oder us.cloud.memsource.com angemeldet werden, um die für die Erstellung oder Speicherung des Connectors erforderliche Authentifizierung anzuwenden. Nach dem Speichern kann über die benutzerdefinierte Domain auf den Connector zugegriffen werden.

    1. Auf der Seite 'Einstellungen' Setup_gear.png sollte zum Abschnitt Integrationen nach unten gescrollt werden.

    2. Klicke auf Konnektoren.

      Die Seite Konnektoren wird geöffnet.

    3. Klicken Sie auf Neuer Connector.

      Die Seite Connector erstellen wird geöffnet.

    4. Ändern Sie den Typ auf GitHub und geben Sie einen Namen für den Connector an.

    5. Aktivieren Sie optional Benutzerdefinierte Domain verwenden und geben Sie die API-URL an.

    6. Wähle optional Export translations as pull requests und gib einen Pull request branch an.

    7. Wähle bei Bedarf Use Github app 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 im Ziel-GitHub-Konto installiert ist, werden für den GitHub-Connector nur öffentliche Repositories angezeigt.

      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 Authorize Phrase.

      Wenn die GitHub-App genutzt wird, klicke auf die Schaltfläche Authorize Phrase App Connector.

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

    11. Klicke auf Speichern.

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

      Wichtig

      Wenn der GitHub-Connector über den Autorisierungsablauf der GitHub-App erstellt wurde, kann die Autorisierungsmethode nach dem Speichern der Connectoreinstellungen nicht mehr geändert werden.

    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.