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, fare riferimento a GitHub (Strings).

Il connettore GitHub consente il download di file sorgente e il caricamento di file di destinazione direttamente dal/al repository GitHub.

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. L'autenticazione dell'account GitHub può essere effettuata anche nell'App GitHub.

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 archivio online.
Configura il portale richiedente per consentire ai richiedenti di aggiungere file alle richieste direttamente dall'archivio online.
Usa creazione di progetti automatizzata (APC) per creare automaticamente nuovi progetti quando si rileva una modifica in dimensione del file nei file o nelle cartelle monitorati.
- Questo connettore supporta l'impostazione del percorso assoluto. I file di traduzione di destinazione possono essere memorizzati solo nello stesso branch del file sorgente.
Configura lavori continui per monitorare i file selezionati per le modifiche.

GitHub (Beta)

Nota

Il connettore è in beta da giugno 2026.

Autenticazione

Il connettore GitHub (Beta) utilizza il token di installazione dell'App GitHub piuttosto che 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 dell'app GitHub. L'opzione OAuth del connettore originale non è supportata.

Esporta

Il connettore GitHub (Beta) raggruppa tutti i file da un'unica esportazione in un solo commit e una sola pull request, quindi CI viene eseguito una volta per esportazione indipendentemente dal numero di file.

I file vengono raggruppati in un unico commit quando tutto il contenuto condivide lo stesso proprietario del repository, repository e branch.

Se l'APC è configurato per caricare i file man mano che vengono completati singolarmente, ogni file verrà impegnato separatamente anziché raggruppato.

I messaggi di commit vengono generati automaticamente e non possono essere personalizzati. Se si esporta come pull request, il nome della pull request e il nome del branch di destinazione possono essere personalizzati.

Limitazioni note

Il connettore può elencare, scaricare e caricare solo file. Eliminare o spostare file in GitHub non è supportato. Qualsiasi eliminazione o rinomina deve essere effettuata direttamente in GitHub.
L'elenco dei file potrebbe non funzionare correttamente per i 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 delle app GitHub, risolvile prima di migrare.

Migrazione al nuovo connettore GitHub (Beta)

La migrazione automatizzata non è possibile a causa del cambiamento nel modello di autenticazione.

Requisiti:

Accesso da amministratore alla tua organizzazione GitHub per installare un'app GitHub. Installalo a livello di organizzazione in modo che copra tutti gli archivi monitorati dai tuoi APC.
Impostazioni APC esistenti visibili (mantieni il vecchio connettore aperto in una seconda scheda).
Un ramo di test o un archivio non di produzione per convalidare prima di passare ai flussi di lavoro live.

Segui questi passaggi:

Installa l'app Phrase GitHub.
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. Clicca Nuovo connettore.
  
  Si apre la pagina Crea connettore.
4. Cambia il Tipo in GitHub (Beta).
5. Clicca Collegati.
  
  Phrase reindirizza a GitHub per autorizzare l'app Phrase GitHub.
6. Su GitHub, seleziona l'organizzazione o l'account e gli archivi a cui concedere accesso, quindi conferma l'installazione. Includi ogni archivio attualmente monitorato dai connettori esistenti.
  
  GitHub reindirizza automaticamente a Phrase.
7. Seleziona l'utente o l'account dell'organizzazione da collegare.
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. Clicca Nuovo connettore.
4. Seleziona l'installazione dell'app GitHub configurata nel primo passaggio.
5. Copia le impostazioni dal connettore esistente:
  - Archivio e ramo
  - Percorso della sottocartella (se utilizzi il monitoraggio della sottocartella)
  - Filtro file regex (se configurato)
  - 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 che puntano al nuovo connettore, rispecchiando la configurazione degli APC esistenti.
2. Abilita la modalità dry-run su ogni nuovo APC prima di attivarlo. La modalità dry-run scansiona l'archivio e abbina i file senza attivare i lavori di traduzione.
3. Esamina i file abbinati. Conferma che l'ambito corrisponde a ciò che gli APC esistenti monitorano.
Valida con un'esportazione di prova.
1. Fai una piccola modifica a un file nell'ambito monitorato.
2. Attiva un'esportazione tramite il nuovo connettore.
3. Conferma:
  - Viene creato un singolo commit (non uno per file).
  - Il commit appare sotto l'identità dell'app GitHub, non un account personale.
  - CI viene eseguito una sola volta, non una volta per file.
Cambia i flussi di lavoro attivi.

Una volta che la validazione è superata:
1. Disabilita gli APC sul connettore legacy.
2. Abilita gli APC sul nuovo connettore (rimuovi la modalità di prova).
3. Monitora per uno o due cicli di esportazione prima di dismettere il connettore 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 necessarie modifiche.

Impostazioni Phrase TMS

Importante

Se si accede da un dominio personalizzato (es. mydomain.phrase.jp), apri una finestra del browser in incognito e accedi tramite cloud.memsource.com o us.cloud.memsource.com per applicare l'autenticazione necessaria per la creazione o il salvataggio del connettore. Dopo il salvataggio, il connettore può essere accesso tramite il dominio personalizzato.

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

Si apre la pagina Connettori.
Clicca Nuovo connettore.

Si apre la pagina Crea connettore.
Modifica il Tipo in GitHub e fornisci un nome per il connettore.
Facoltativamente seleziona Esporta traduzioni come pull request e fornisci un Branch pull request.
Se necessario, seleziona Usa l'app GitHub per visualizzare l'URL dell'app Phrase GitHub e importare/esportare file utilizzando il flusso di autorizzazione dell'app GitHub:
1. Clicca sul link per aprire la pagina ufficiale del connettore Phrase App 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 sull'account GitHub di destinazione.
  
  Nota
  
  Se l'app GitHub non è installata sull'account GitHub di destinazione dell'utente, solo i repository pubblici saranno visibili al connettore GitHub.
3. Completa la procedura di installazione selezionando eventuali repository privati che saranno visibili e accessibili per il connettore GitHub.
4. Torna alla pagina Phrase Connettori/Crea per autorizzare l'app GitHub e connetterti a GitHub.
Clicca Collegati a GitHub. Se non connesso utilizzando l'app GitHub, apparirà una finestra popup o una nuova scheda che richiede l'autorizzazione.
Fornisci un Messaggio di commit se necessario.
Clicca il pulsante Autorizza Phrase.

Se utilizzi l'app GitHub, clicca il pulsante Autorizza Phrase App Connector.

Se ha successo, la finestra/scheda scomparirà e apparirà un piccolo segno di spunta accanto al pulsante Collegati a GitHub.
Clicca su Salva.

Il connettore viene aggiunto all'elenco nella pagina Connettori.

Importante

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