-
Piani Team, Business ed Enterprise
Mettiti in contatto con il reparto vendite per dubbi relativi alle licenze.
-
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 il download dei file di origine e il caricamento dei file di destinazione direttamente da/verso il 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 nella GitHub App.
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 la creazione di progetti automatizzata (APC) per creare automaticamente nuovi progetti quando si rileva una modifica nella dimensione del file nei file o nelle cartelle monitorate.
-
Questo connettore supporta l'impostazione del percorso assoluto. I file di traduzione di destinazione possono essere archiviati solo nello stesso ramo 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 esclusivamente l'autenticazione tramite la GitHub App. L'opzione OAuth del connettore originale non è supportata.
Esporta
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 quando tutto il contenuto condivide lo stesso proprietario del repository, il repository e il branch.
Se l'APC è configurato per caricare i file man mano che vengono completati individualmente, ogni file verrà sottoposto a commit 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ò solo elencare, scaricare e caricare file. L'eliminazione o lo spostamento di file in GitHub non è supportato. Qualsiasi eliminazione o ridenominazione deve essere eseguita 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 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, pertanto le parole elaborate in precedenza e le unità di traduzione automatica (MTUs) non vengono trasferite. Quando si cambiano i connettori a metà progetto, aspettati che il conteggio delle parole e il consumo di MTU/crediti per i file interessati riflettano una reimportazione completa.
Prerequisiti:
-
Accesso amministrativo 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 dell'app GitHub deve avere accesso ai repository con contenuti da tradurre, altrimenti l'importazione tramite APC non riuscirà.
-
Impostazioni APC esistenti visibili (tieni aperto il vecchio connettore in una seconda scheda).
-
Un branch di test o un repository non di produzione per convalidare prima di passare ai flussi di lavoro live.
Segui questi passaggi:
-
Installa l'app Phrase GitHub
-
In Phrase TMS, dalla pagina Impostazioni
, scorri verso il basso fino alla sezione .
-
Fai clic su Connettori.
Si apre la pagina .
-
Fai clic su Nuovo connettore.
Si apre la pagina .
-
Cambia il Tipo in GitHub (Beta).
-
Fai clic su Connetti.
Phrase reindirizza a GitHub per autorizzare l'app GitHub di Phrase.
-
Su GitHub, seleziona l'organizzazione o l'account e i repository a cui concedere l'accesso, quindi conferma l'installazione. Includi ogni repository attualmente monitorato dai connettori esistenti.
GitHub reindirizza automaticamente a Phrase.
-
Seleziona l'utente o l'account dell'organizzazione da connettere.
-
-
Crea un nuovo connettore.
-
In Phrase TMS, dalla pagina Impostazioni
-
Fai clic su Connettori.
-
Fai clic su Nuovo connettore.
-
Seleziona l'installazione dell'app GitHub configurata nel primo passaggio.
-
Copia le impostazioni dal connettore esistente:
-
Repository e branch
-
Percorso sottocartella (se si utilizza il monitoraggio delle sottocartelle)
-
Regex filtro file (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 di GitHub App, ognuno con impostazioni indipendenti.
-
-
-
Ricrea gli APC esistenti utilizzando la modalità dry-run.
Non eliminare o disabilitare ancora gli APC esistenti.
-
Crea nuovi APC che puntano al nuovo connettore, rispecchiando la configurazione APC esistente.
-
Abilita la modalità dry-run su ogni nuovo APC prima di attivarlo. La modalità dry-run analizza il repository e trova i file corrispondenti senza avviare processi di traduzione.
-
Esamina i file corrispondenti. Conferma che l'ambito corrisponda a quello monitorato dall'APC esistente.
-
-
Convalida con un'esportazione di prova.
-
Apporta una piccola modifica a un file nell'ambito monitorato.
-
Avvia un'esportazione tramite il nuovo connettore.
-
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.
-
-
-
Passa ai flussi di lavoro attivi.
Una volta superata la convalida:
-
Disabilita gli APC sul connettore legacy.
-
Abilita gli APC sul nuovo connettore (rimuovi la modalità dry-run).
-
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:
-
Elimina i vecchi APC.
-
Elimina il connettore legacy da Impostazioni → Connettori → GitHub (Legacy).
-
Facoltativamente, revoca il token OAuth per l'account utente utilizzato dal connettore legacy.
-
Impostazioni GitHub (legacy)
Non sono necessarie modifiche.
Importante
Se accedi 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 richiesta per la creazione o il salvataggio del connettore. Dopo il salvataggio, è possibile accedere al connettore tramite il dominio personalizzato.
-
Dalla pagina Impostazioni
-
Fai clic su Connettori.
Si apre la pagina .
-
Fai clic su Nuovo connettore.
Si apre la pagina .
-
Cambia il Tipo in GitHub e fornisci un nome per il connettore.
-
Facoltativamente, abilita e fornisci l'.
-
Facoltativamente, seleziona e fornisci un .
-
Se necessario, seleziona per visualizzare l'URL dell'app Phrase GitHub e importare/esportare file utilizzando il flusso di autorizzazione dell'app GitHub:
-
Fai 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 USA).
-
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.
-
Completa la procedura di installazione selezionando i repository privati che desideri rendere visibili e accessibili per il connettore GitHub.
-
Torna alla pagina Phrase per autorizzare l'app GitHub e connetterti a GitHub.
-
-
Fai clic su Connetti a GitHub. Se non sei connesso utilizzando l'app GitHub, apparirà una finestra popup o una nuova scheda che richiede l'autorizzazione.
-
Fornisci un se richiesto.
-
Fai clic sul pulsante Autorizza Phrase.
Se utilizzi l'app GitHub, fai clic sul pulsante Autorizza connettore app Phrase.
Se l'operazione ha esito positivo, la finestra/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 .
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.
Elimina un connettore
Per eliminare un connettore:
-
Dalla pagina , seleziona il connettore da eliminare.
-
Fai clic su Elimina.
Si apre la finestra .
-
Digita \"delete\" e fai clic su Elimina.
Il connettore viene eliminato e viene visualizzato l'elenco dei connettori.
Nota
Un connettore non può essere eliminato finché è ancora collegato a lavori incompleti in un progetto, inclusi i lavori presenti nel Cestino. Il tentativo di eliminare tale connettore restituisce un errore \"Impossibile eliminare il connettore\".
Risoluzione: Apri il progetto associato al connettore e completa o elimina eventuali lavori rimanenti. Vai in e svuotalo per rimuovere eventuali lavori ancora collegati al connettore. Riprova a eliminare il connettore.