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

Il connettore GitHub consente il download di file di origine e il caricamento di file di destinazione direttamente da/verso l'archivio GitHub.

Il connettore usa l'API GitHub per implementare l'integrazione. Il connettore consente di accedere a tutti gli archivi 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 richieste per consentire ai richiedenti di aggiungere file alle richieste direttamente dall'archivio online.
Usa la creazione di progetti automatizzata (APC) per creare automaticamente nuovi progetti quando si rileva una modifica nella dimensione del file per i file o le cartelle monitorati.
- 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 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) usa 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 all'archivio, il connettore continua a funzionare.

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

Esporta

Il connettore GitHub (Beta) raggruppa tutti i file da un singolo esportare in un unico commit e una singola pull request, quindi la CI viene eseguita una volta per esportare indipendentemente dal numero di file.

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

Se l'APC è configurato per caricare i file man mano che vengono completati individualmente, ogni file verrà sottoposto a commit separatamente anziché essere raggruppato.

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

Limitazioni note

Il connettore può solo elencare, eseguire il download 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 archivi 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.

Migrazione al nuovo connettore GitHub (Beta)

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

Prerequisiti:

Accesso come amministratore alla tua organizzazione GitHub per installare una GitHub App. Installalo a livello di organizzazione in modo che copra tutti gli archivi monitorati dai tuoi APC.
Impostazioni APC esistenti visibili (tieni aperto il vecchio connettore in una seconda scheda).
Un branch di test o un archivio non di produzione da 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. Fai clic su Nuovo connettore.
  
  Si apre la pagina Creare connettore.
4. Modificare il Tipo in GitHub (Beta).
5. Fai clic su Connetti.
  
  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 l'accesso, quindi conferma l'installazione. Includi ogni archivio attualmente monitorato dal/i connettore/i esistente/i.
  
  GitHub reindirizza automaticamente a Phrase.
7. Seleziona l'utente o l'account dell'organizzazione da connettere.
Creare 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:
  - Archivio e branch
  - Percorso sottocartella (se si utilizza il monitoraggio della sottocartella)
  - Regex di filtrare dei file (se configurata)
  - Modalità Esporta: 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 di GitHub App, ciascuno con impostazioni indipendenti.
Ricreare gli APC esistenti utilizzando la modalità dry-run.

Non eliminare o disabilitare ancora gli APC esistenti.
1. Creare nuovi APC che puntano al nuovo connettore, rispecchiando la configurazione APC esistente.
2. Abilitare la modalità dry-run su ogni nuovo APC prima di attivarlo. La modalità dry-run scansiona l'archivio e trova i file corrispondenti senza attivare processi di traduzione.
3. Revisionare i file corrispondenti. Conferma che l'ambito corrisponda a quello monitorato dall'APC esistente.
Convalidare con un'esportazione di prova.
1. Apportare una piccola modifica a un file nell'ambito monitorato.
2. Attivare 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.
  - La CI viene eseguita una volta, non una volta per file.
Passare ai flussi di lavoro live.

Una volta superata la convalida:
1. Disabilita gli APC sul connettore legacy.
2. Abilitare gli APC sul nuovo connettore (rimuovere la modalità dry-run).
3. Monitorare per uno o due cicli di esportare prima di dismettere il connettore legacy.
Dismettere il connettore legacy.

Dopo aver confermato che il nuovo connettore è stabile:
1. Eliminare i vecchi APC.
2. Eliminare il connettore legacy da impostazioni → Connectors → GitHub (legacy).
3. Facoltativamente, revocare il token OAuth per l'account utente che è stato usato dal connettore legacy.

impostazioni GitHub (legacy)

Non è necessario modificare nulla.

Impostazioni Phrase TMS

Importante

Se si accede da un dominio Personalizzato (es. mydomain.phrase.jp), aprire una finestra del browser in incognito e accedere tramite cloud.memsource.com o us.cloud.memsource.com per applicare l'autenticazione richiesta per la creazione o il salvataggio del connettore. Dopo il salvataggio, il connettore può essere accessibile 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 Creare connettore.
Modificare il Type in GitHub e fornire un nome per il connettore.
Facoltativamente Seleziona Export translations as pull requests e fornire un Pull request branch.
Se richiesto, Seleziona Use Github app per visualizzare l'URL dell'app Phrase GitHub e importare/esportare file usando il flusso di autorizzazione dell'app GitHub:
1. Fare clic 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 US).
2. Installare 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. Completare la procedura di installazione selezionando tutti i repository privati che saranno visibili e accessibili per il connettore GitHub.
4. Tornare alla pagina Connectors/Create di Phrase per autorizzare l'app GitHub e connettersi a GitHub.
Fai clic su Connect to GitHub. Se non è stata effettuata la connessione utilizzando l'app GitHub, apparirà una finestra popup o una nuova scheda che richiederà l'autorizzazione.
Fornisci un Commit message se richiesto.
Fai clic sul pulsante Authorize Phrase.

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

Se l'operazione ha esito positivo, la finestra/scheda scomparirà e apparirà un piccolo segno di spunta accanto al pulsante Connect to 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.