Integrace
    1. Phrase
    2. Phrase TMS
    3. Integrace

    GitHub (TMS)

    Obsah je strojově přeložen z angličtiny s použitím Phrase Language AI.

    K dispozici pro

    • Plány Team, Business a Enterprise

    S dotazy ohledně licencí se obraťte na prodejce.

    K dispozici pro

    • Plány Ultimate a Enterprise (Legacy)

    S dotazy ohledně licencí se obraťte na prodejce.

    Tip

    Informace o integraci GitHub v Phrase Strings naleznete v části GitHub (Strings).

    Konektor GitHub umožňuje stahování zdrojových souborů a nahrávání cílových souborů přímo do/z úložiště GitHub.

    Konektor využívá k implementaci integrace rozhraní GitHub API. Konektor umožňuje přístup ke všem úložištím přidruženým k účtu GitHub. Ověření účtu GitHub lze provést také v GitHub App.

    Příklady použití

    Konektor lze použít v několika případech:

    • Projektoví manažeři mohou přidat soubory přímo do projektů z online úložiště.

    • Nastavte portál zadavatele tak, aby zadavatelé mohli přidat soubory k požadavkům přímo z online úložiště.

    • Použijte automatizované vytváření projektů (APC) k automatickému vytváření nových projektů, jakmile se u sledovaných souborů nebo složky zjistí změna velikosti souboru.

      • Tento konektor podporuje nastavení absolutní cesty. Cílové překladové soubory lze ukládat pouze ve stejné větvi jako zdrojový soubor.

    • Nastavte průběžné úlohy pro sledování změn u vybraných souborů.

    GitHub (Beta)

    Poznámka

    Konektor je od června 2026 ve verzi beta.

    ověřování

    Konektor GitHub (Beta) používá instalační token aplikace GitHub namísto individuálního uživatelského účtu. Tokeny mají krátkou platnost a obnovují se automaticky. Pokud uživatel opustí organizaci nebo ztratí přístup k úložišti, konektor bude nadále fungovat.

    Konektor GitHub (Beta) podporuje pouze ověřování pomocí aplikace GitHub. Možnost OAuth z původního konektoru není podporována.

    Export

    Konektor GitHub (Beta) seskupuje všechny soubory z jednoho exportu do jednoho commitu a jednoho pull requestu, takže CI se spustí jednou pro každý export bez ohledu na počet souborů.

    Soubory jsou sloučeny do jednoho commitu, pokud všechny patří stejnému vlastníkovi repozitáře, stejnému repozitáři a stejné větvi.

    Pokud je APC nakonfigurováno tak, aby nahrávalo soubory po jejich individuálním dokončení, bude každý soubor commitován samostatně namísto seskupení.

    Commit messages se generují automaticky a nelze je přizpůsobit. Při exportu jako pull request lze název pull requestu a název cílové větve přizpůsobit.

    Známá omezení

    • Konektor umí pouze vypisovat, stahovat a nahrávat soubory. Mazání nebo přesouvání souborů v GitHubu není podporováno. Jakékoli mazání nebo přejmenování musí být provedeno přímo v GitHubu.

    • Výpis souborů nemusí fungovat správně u úložišť s více než 50 000 soubory kvůli omezením rozhraní GitHub API.

    • GitHub Enterprise Server není v současné době podporován.

    • Nový konektor nepodporuje tok OAuth ze staršího konektoru. Pokud má vaše organizace omezení pro instalace aplikací GitHub, vyřešte je před migrací.

    Přechod na nový konektor GitHub (Beta)

    Automatizovaná migrace není možná kvůli změně modelu ověřování.

    Poznámka

    Přepnutí průběžného APC ze staršího konektoru na nový konektor není migrace. Phrase s ním zachází jako s novou konfigurací konektoru, takže APC znovu importuje zdrojový soubor jako novou úlohu namísto aktualizace té stávající. Se souborem se zachází jako s novým obsahem, takže dříve zpracovaná slova a jednotky strojového překladu (MTU) se nepřenášejí. Při přepínání konektorů v průběhu projektu očekávejte, že počet slov a spotřeba MTU/kreditů u dotčených souborů bude odrážet úplný opětovný import.

    Předpoklady:

    • Správcovský přístup k vaší organizaci GitHub pro instalaci aplikace GitHub App. Nainstalujte ji na úrovni organizace, aby pokrývala všechna úložiště, která vaše APC monitorují.

    • Instalace aplikace GitHub App musí mít přístup k úložištím s obsahem k překladu, jinak import prostřednictvím APC selže.

    • Stávající nastavení APC jsou viditelná (ponechte starý konektor otevřený na druhé kartě).

    • Testovací větev nebo neprodukční úložiště pro ověření před přepnutím živých pracovních postupů.

    Postupujte podle těchto kroků:

    1. Nainstalujte aplikaci Phrase GitHub

      1. Ve Phrase TMS na stránce Nastavení Setup_gear.png přejděte dolů do oddílu Integrace.

      2. Klikněte na Konektory.

        Otevře se stránka Konektory.

      3. Klikněte na Nový konektor.

        Otevře se stránka Vytvořit konektor.

      4. Změňte Typ na GitHub (Beta).

      5. Klikněte na Připojit.

        Phrase vás přesměruje na GitHub za účelem autorizace aplikace Phrase GitHub App.

      6. Na GitHubu vyberte organizaci nebo účet a úložiště, ke kterým chcete udělit přístup, a poté instalaci potvrďte. Zahrňte všechna úložiště, která jsou aktuálně monitorována stávajícím konektorem (konektory).

        GitHub vás automaticky přesměruje zpět do Phrase.

      7. Vyberte uživatelský nebo organizační účet, který chcete připojit.

    2. Vytvořte nový konektor.

      1. Ve Phrase TMS na stránce Nastavení Setup_gear.png přejděte dolů do oddílu Integrace.

      2. Klikněte na Konektory.

      3. Klikněte na Nový konektor.

      4. Vyberte instalaci aplikace GitHub App nastavenou v prvním kroku.

      5. Zkopírujte nastavení ze stávajícího konektoru:

        • Úložiště a větev

        • Cesta k podsložce (pokud používáte sledování podsložek)

        • Regex filtru souborů (pokud je nakonfigurován)

        • Režim exportu: přímý commit nebo pull request a cílová větev

        • Název pull requestu a název cílové větve (pokud používáte režim PR)

        V rámci stejné instalace aplikace GitHub je možné vytvořit více konektorů, každý s nezávislým nastavením.

    3. Znovu vytvořte stávající APC pomocí režimu dry-run.

      Zatím nemažte ani nedeaktivujte stávající APC.

      1. Vytvořte nová APC směřující na nový konektor, která budou zrcadlit stávající konfiguraci APC.

      2. Před aktivací povolte režim dry-run u každého nového APC. Režim dry-run prohledá úložiště a spáruje soubory, aniž by spustil překladové úlohy.

      3. Zkontrolujte spárované soubory. Potvrďte, že rozsah odpovídá tomu, co sleduje stávající APC.

    4. Ověřte pomocí testovacího exportu.

      1. Proveďte malou změnu v souboru ve sledovaném rozsahu.

      2. Spusťte export prostřednictvím nového konektoru.

      3. Potvrdit

        • Vytvoří se jeden commit (nikoli jeden na soubor).

        • Commit se zobrazí pod identitou aplikace GitHub, nikoli pod osobním účtem.

        • CI se spustí jednou, nikoli jednou na soubor.

    5. Přepněte živé pracovní postupy.

      Jakmile ověření proběhne úspěšně:

      1. Deaktivujte APC na starším konektoru.

      2. Aktivujte APC na novém konektoru (odstraňte režim dry-run).

      3. Před vyřazením staršího konektoru z provozu monitorujte jeden nebo dva cykly exportu.

    6. Vyřaďte starší konektor z provozu.

      Po potvrzení, že je nový konektor stabilní:

      1. Odstraňte staré APC.

      2. Odstraňte starší konektor v Nastavení → Konektory → GitHub (starší).

      3. Volitelně zrušte platnost tokenu OAuth pro uživatelský účet, který používal starší konektor.

    Nastavení GitHub (starší)

    Nejsou vyžadovány žádné změny.

    Nastavení Phrase TMS

    Důležité

    Pokud přistupujete z vlastní domény (např. mydomain.phrase.jp), otevřete okno prohlížeče v režimu inkognito a přihlaste se přes cloud.memsource.com nebo us.cloud.memsource.com, abyste použili ověření vyžadované pro vytvoření nebo uložení konektoru. Po uložení lze ke konektoru přistupovat přes vlastní doménu.

    1. Na stránce Nastavení Setup_gear.png přejděte dolů do oddílu Integrace.

    2. Klikněte na Konektory.

      Otevře se stránka Konektory.

    3. Klikněte na Nový konektor.

      Otevře se stránka Vytvořit konektor.

    4. Změňte Typ na GitHub a zadejte název konektoru.

    5. Volitelně povolte Použít vlastní doménu a zadejte API URL.

    6. Volitelně vyberte Exportovat překlady jako pull requests a zadejte Větev pull requestu.

    7. V případě potřeby vyberte Použít aplikaci Github pro zobrazení URL aplikace Phrase GitHub a import/export souborů pomocí autorizačního toku aplikace GitHub:

      1. Kliknutím na odkaz otevřete oficiální stránku konektoru Phrase App na nové kartě: https://github.com/apps/phrase-app-connector-eu (datové centrum EU) nebo https://github.com/apps/phrase-app-connector-us (datové centrum USA).

      2. Nainstalujte aplikaci Phrase GitHub do cílového účtu GitHub.

        Poznámka

        Pokud aplikace GitHub není nainstalována v cílovém účtu GitHub uživatele, konektor GitHub uvidí pouze veřejná úložiště.

      3. Dokončete postup instalace výběrem všech soukromých úložišť, která budou pro konektor GitHub viditelná a přístupná.

      4. Vraťte se na stránku Phrase Connectors/Create pro autorizaci aplikace GitHub a připojení ke službě GitHub.

    8. Klikněte na Připojit ke GitHubu. Pokud nejste připojeni pomocí aplikace GitHub, zobrazí se vyskakovací okno nebo nová karta s žádostí o autorizaci.

    9. V případě potřeby zadejte Commit message.

    10. Klikněte na tlačítko Authorize Phrase.

      Pokud používáte aplikaci GitHub, klikněte na tlačítko Authorize Phrase App Connector.

      Pokud je operace úspěšná, okno/karta zmizí a vedle tlačítka Connect to GitHub se objeví malé zaškrtnutí.

    11. Klikněte na Uložit.

      Konektor je přidán do seznamu na stránce Konektory.

      Důležité

      Pokud je konektor GitHub vytvořen pomocí autorizačního toku aplikace GitHub, po uložení nastavení konektoru již není možné změnit metodu autorizace.

    Odstranit konektor

    Chcete-li odstranit konektor:

    1. Na stránce Integrations vyberte konektor, který chcete odstranit.

    2. Klikněte na Delete.

      Otevře se okno Delete connector.

    3. Napište „delete“ a klikněte na Delete.

      Konektor je odstraněn a zobrazí se seznam konektorů.

    Poznámka

    Konektor nelze odstranit, pokud je stále propojen s nedokončenými úlohami v projektu, včetně úloh v koši. Pokus o odstranění takového konektoru vrátí chybu „Failed to delete connector“.

    Řešení: Otevřete projekt přidružený ke konektoru a dokončete nebo odstraňte všechny zbývající úlohy. Přejděte do Settings/Recycle bin a vyprázdněte jej, abyste odstranili všechny úlohy, které jsou stále propojeny s konektorem. Zkuste znovu odstranit konektor.

    Byl pro vás tento článek užitečný?
    ★ ★ ★ ★ ★

    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.