GitHub (TMS)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Disponibile per

Piani Team, Business ed Enterprise

Mettiti in contatto con il reparto vendite per dubbi relativi alle licenze.

Disponibile per

Piani Ultimate ed Enterprise (legacy)

Mettiti in contatto con il reparto vendite per dubbi relativi alle licenze.

Consiglio

Per informazioni sull'integrazione di GitHub in Phrase Strings, consulta GitHub (Strings).

Il connettore GitHub consente di scaricare i file di origine dal repository GitHub e di caricarvi i file di destinazione.

Il connettore utilizza l'API di GitHub per implementare l'integrazione. Il connettore consente l'accesso a tutti i repository associati a un account GitHub. Puoi autenticare l'account GitHub anche tramite la GitHub App.

Casi d'uso

Ci sono una serie di casi d'uso per il connettore:

I project manager possono aggiungere file direttamente ai progetti da un repository online.
Configura il portale dei richiedenti per consentire ai richiedenti di aggiungere file alle richieste direttamente dal repository online.
Usa la creazione automatizzata dei progetti (APC) per creare automaticamente nuovi progetti quando viene rilevata una variazione della dimensione dei file monitorati o dei file in una cartella monitorata.
- Questo connettore supporta l'impostazione del percorso assoluto. I file di traduzione di destinazione possono essere archiviati solo nello stesso branch del file di origine.
Configura i lavori continui per monitorare le modifiche ai file selezionati.

GitHub (Beta)

Nota

Il connettore è in versione beta a partire da giugno 2026.

Autenticazione

Il connettore GitHub (Beta) utilizza il token di installazione dell'app GitHub anziché un account utente individuale. I token hanno una durata breve e si rinnovano automaticamente. Se un utente lascia l'organizzazione o perde l'accesso al repository, il connettore continua a funzionare.

Il connettore GitHub (Beta) supporta solo l'autenticazione tramite app GitHub. L'opzione OAuth del connettore originale non è supportata.

Esportazione

Il connettore GitHub (Beta) raggruppa tutti i file di una singola esportazione in un unico commit e una singola pull request, in modo che la CI venga eseguita una volta per esportazione, indipendentemente dal numero di file.

I file vengono raggruppati in un unico commit se appartengono allo stesso proprietario e allo stesso repository e si trovano nello stesso branch.

Se l'APC è configurato per caricare i file man mano che ciascuno viene completato, per ogni file verrà creato un commit separato anziché raggrupparli in un unico commit.

I messaggi di commit vengono generati automaticamente e non possono essere personalizzati. Se esporti i file tramite una pull request, puoi personalizzare il nome della pull request e quello del branch di destinazione.

Percorso di esportazione e sottocartelle

Quando il percorso di esportazione dei file del repository online inizia con / (un percorso assoluto), il connettore GitHub (Beta) mantiene la struttura delle sottocartelle dei file di origine. Ogni file tradotto viene esportato in una sottocartella del percorso di esportazione che corrisponde a quella del file di origine all'interno della cartella monitorata dalla creazione automatizzata dei progetti (APC).

Un file situato direttamente nella cartella monitorata viene esportato direttamente nel percorso di esportazione. Non viene aggiunta alcuna sottocartella per un percorso di esportazione relativo o quando le sottocartelle non sono incluse.

Un percorso di esportazione assoluto parte dalla radice del repository nel branch di origine.

Limitazioni note

Il connettore può solo elencare, scaricare e caricare file. L'eliminazione o lo spostamento di file in GitHub non sono supportati. Qualsiasi eliminazione o ridenominazione deve essere eseguita direttamente in GitHub.
L'elenco dei file potrebbe non funzionare correttamente per repository con più di 50.000 file a causa delle limitazioni dell'API di GitHub.
GitHub Enterprise Server non è attualmente supportato.
Il nuovo connettore non supporta il flusso OAuth del connettore legacy. Se la tua organizzazione ha restrizioni sulle installazioni di GitHub App, risolvile prima di eseguire la migrazione.

Passaggio al nuovo connettore GitHub (Beta)

La migrazione automatizzata non è possibile a causa della modifica nel modello di autenticazione.

Nota

Il passaggio di un APC continuo dal connettore legacy al nuovo connettore non è una migrazione. Phrase lo tratta come una nuova configurazione del connettore, quindi l'APC reimporta il file sorgente come un nuovo lavoro invece di aggiornare quello esistente. Il file viene trattato come nuovo contenuto, quindi le parole precedentemente elaborate e le Unità di Traduzione Automatica (MTU) non vengono trasferite. Se cambi connettore a progetto avviato, tieni presente che il conteggio delle parole e il consumo di MTU/crediti per i file interessati rifletteranno una reimportazione completa.

Prerequisiti:

Accesso amministratore alla tua organizzazione GitHub per installare una GitHub App. Installala a livello di organizzazione in modo che copra tutti i repository monitorati dai tuoi APC.
L'installazione della GitHub App deve avere accesso ai repository con contenuti da tradurre, altrimenti l'importazione tramite APC non riuscirà.
Tieni a portata di mano le impostazioni degli APC esistenti (lascia aperto il vecchio connettore in un'altra scheda).
Un branch di test o un repository non di produzione per verificare il funzionamento prima di passare ai flussi di lavoro attivi.

Segui questi passaggi:

Installa l'App GitHub di Phrase.
1. In Phrase TMS, dalla pagina Impostazioni , scorri verso il basso fino alla sezione Integrazioni.
2. Fai clic su Connettori.
  
  Si apre la pagina Connettori.
3. Fai clic su Nuovo connettore.
  
  Si apre la pagina Crea connettore.
4. Cambia il Tipo in GitHub (Beta).
5. Fai clic su Connetti.
  
  Phrase reindirizza a GitHub per autorizzare l'App GitHub di Phrase.
6. Su GitHub, seleziona l'organizzazione o l'account e i repository a cui concedere l'accesso, quindi conferma l'installazione. Includi tutti i repository attualmente monitorati dai connettori esistenti.
  
  GitHub reindirizza automaticamente a Phrase.
7. Seleziona l'account utente o dell'organizzazione da connettere.
Crea un nuovo connettore.
1. In Phrase TMS, dalla pagina Impostazioni , scorri verso il basso fino alla sezione Integrazioni.
2. Fai clic su Connettori.
3. Fai clic su Nuovo connettore.
4. Seleziona l'installazione dell'App GitHub configurata nel primo passaggio.
5. Copia le impostazioni dal connettore esistente:
  - Repository e branch
  - Percorso della sottocartella (se si utilizza il monitoraggio delle sottocartelle)
  - Espressione regolare per il filtro dei file (se configurata)
  - Modalità di esportazione: commit diretto o pull request e branch di destinazione
  - Nome della pull request e nome del branch di destinazione (se si utilizza la modalità PR)
  È possibile creare più connettori sotto la stessa installazione dell'App GitHub, ognuno con impostazioni indipendenti.
Ricrea gli APC esistenti utilizzando la modalità dry-run.

Non eliminare o disabilitare ancora gli APC esistenti.
1. Crea nuovi APC collegati al nuovo connettore, replicando la configurazione degli APC esistenti.
2. Abilita la modalità dry-run su ogni nuovo APC prima di attivarlo. La modalità dry-run esamina il repository e individua i file corrispondenti senza avviare processi di traduzione.
3. Esamina i file individuati. Conferma che l'ambito corrisponda a ciò che l'APC esistente monitora.
Convalida con un'esportazione di prova.
1. Apporta una piccola modifica a un file nell'ambito monitorato.
2. Avvia un'esportazione tramite il nuovo connettore.
3. Conferma:
  - Viene creato un singolo commit (non uno per file).
  - Il commit appare sotto l'identità della GitHub App, non di un account personale.
  - Il sistema di CI viene eseguito una volta, non una volta per file.
Passa ai flussi di lavoro attivi.

Una volta superata la convalida:
1. Disabilita gli APC sul connettore legacy.
2. Abilita gli APC sul nuovo connettore (rimuovi la modalità dry-run).
3. Monitora il funzionamento del nuovo connettore per uno o due cicli di esportazione prima di dismettere quello legacy.
Dismetti il connettore legacy.

Dopo aver confermato che il nuovo connettore è stabile:
1. Elimina i vecchi APC.
2. Elimina il connettore legacy da Impostazioni → Connettori → GitHub (Legacy).
3. Facoltativamente, revoca il token OAuth per l'account utente utilizzato dal connettore legacy.

Impostazioni GitHub (legacy)

Non sono richieste modifiche.

Impostazioni Phrase TMS

Importante

Se accedi da un dominio personalizzato (es. mydomain.phrase.jp), apri una finestra di navigazione in incognito e accedi tramite cloud.memsource.com o us.cloud.memsource.com per effettuare l'autenticazione necessaria a creare o salvare il connettore. Dopo il salvataggio, è possibile accedere al connettore tramite il dominio personalizzato.

Dalla pagina Impostazioni , scorri verso il basso fino alla sezione Integrazioni.
Fai clic su Connettori.

Si apre la pagina Connettori.
Fai clic su Nuovo connettore.

Si apre la pagina Crea connettore.
Imposta Tipo su GitHub e assegna un nome al connettore.
Facoltativamente, abilita Usa dominio personalizzato e fornisci l'URL API.
Facoltativamente, seleziona Esporta traduzioni come pull request e indica il Ramo della pull request.
Se richiesto, seleziona Usa app GitHub per visualizzare l'URL dell'app Phrase GitHub e importare/esportare file utilizzando il flusso di autorizzazione dell'app GitHub:
1. Fai clic sul link per aprire la pagina ufficiale di Phrase App Connector in una nuova scheda: https://github.com/apps/phrase-app-connector-eu (data center UE) o https://github.com/apps/phrase-app-connector-us (data center USA).
2. Installa l'app Phrase GitHub nell'account GitHub di destinazione.
  
  Nota
  
  Se l'app GitHub non è installata nell'account GitHub di destinazione dell'utente, solo i repository pubblici saranno visibili al connettore GitHub.
3. Completa la procedura di installazione selezionando i repository privati che saranno visibili e accessibili al connettore GitHub.
4. Torna alla pagina Connettori/Crea di Phrase per autorizzare l'app GitHub e connetterti a GitHub.
Fai clic su Connetti a GitHub. Se non ti connetti tramite l'app GitHub, si aprirà una finestra popup o una nuova scheda in cui ti verrà chiesta l'autorizzazione.
Fornisci un Messaggio di commit se richiesto.
Fai clic sul pulsante Autorizza Phrase.

Se utilizzi l'app GitHub, fai clic sul pulsante Autorizza Phrase App Connector.

Se l'operazione ha esito positivo, la finestra o la scheda scomparirà e apparirà un piccolo segno di spunta accanto al pulsante Connetti a GitHub.
Clicca su Salva.

Il connettore viene aggiunto all'elenco nella pagina Connettori.

Importante

Se il connettore GitHub viene creato utilizzando il flusso di autorizzazione dell'app GitHub, non è possibile modificare il metodo di autorizzazione dopo aver salvato le impostazioni del connettore.