Integrazione di GitLab con PTC

+

Connetti GitLab con PTC per una localizzazione continua. Ricevi le traduzioni tramite merge request automatiche ogni volta che il tuo codice cambia.

Come integrare GitLab con PTC

PTC si connette al tuo repository GitLab e mantiene tradotti i tuoi file di risorse mentre lavori. Invia le modifiche al tuo codice e PTC le rileverà automaticamente, tradurrà le stringhe aggiornate e aprirà una merge request.

1

Connetti il tuo Repository GitLab

PTC supporta sia GitLab.com che i repository GitLab self-hosted. A seconda della fase del tuo flusso di lavoro, ci sono due modi per iniziare:

  • Quando crei un nuovo progetto in PTC, seleziona Integrazione Git nel wizard di configurazione.
  • Per passare un progetto esistente dai caricamenti manuali dei file a un flusso di lavoro continuo basato su Git, vai su Impostazioni → Merge Request e clicca su Aggiungi integrazione Git.

In entrambi i casi, vedrai una schermata in cui potrai inserire l’URL del tuo progetto all’interno del repository. PTC rileverà automaticamente che stai usando GitLab.

2

Autenticati con GitLab

Per connettere il tuo repository, puoi usare un token di accesso (scelta consigliata) o accedere con OAuth. PTC supporta sia i token di accesso al progetto che i token di accesso al gruppo.

PTC richiede l’accesso ai webhook per rilevare le modifiche nel tuo repository. Quando usi un token di accesso, il ruolo e gli ambiti necessari dipendono da come vuoi configurare il webhook:

Configurazione automatica del webhook

Come funziona

PTC crea e configura il webhook in GitLab per tuo conto durante il flusso di integrazione.

Creazione del token

Nel tuo progetto, vai su Impostazioni → Token di accesso. Assegna un nome al token, una descrizione facoltativa e imposta una data di scadenza (consigliata per la sicurezza).

Ruolo richiesto

Maintainer

Ambiti

api → consente a PTC di leggere e inviare al repository

Configurazione manuale del webhook

Come funziona

PTC ti fornisce un URL di callback e un Secret Token. Crea un webhook nelle tue impostazioni di GitLab usando questi dettagli, impostando gli eventi Push e gli eventi Merge request come trigger.

Creazione del token

Nel tuo gruppo, vai su Impostazioni → Token di accesso. Assegna un nome al token, una descrizione facoltativa e imposta una data di scadenza (consigliata per la sicurezza).

Ruolo richiesto

Developer (o equivalente)

Ambiti

read_repository + write_repository

Come funziona

Creazione del token

Ruolo richiesto

Ambiti

Configurazione automatica del webhook

PTC crea e configura il webhook in GitLab per tuo conto durante il flusso di integrazione.

Nel tuo progetto, vai su Impostazioni → Token di accesso. Assegna un nome al token, una descrizione facoltativa e imposta una data di scadenza (consigliata per la sicurezza).

Maintainer

api

Configurazione manuale del webhook

PTC ti fornisce un URL di callback e un Secret Token. Crea un webhook nelle tue impostazioni di GitLab usando questi dettagli, impostando gli eventi Push e gli eventi Merge request come trigger.

Nel tuo progetto, vai su Impostazioni → Token di accesso. Assegna un nome al token, una descrizione facoltativa e imposta una data di scadenza (consigliata per la sicurezza).

Developer (o equivalente)

read_repository + write_repository

Conserva il token in modo sicuro e aggiungilo a PTC. Verificherà i tuoi permessi e ti permetterà di scegliere quali branch e file di risorse monitorare.

3

Traduci il tuo progetto con PTC

Una volta connesso il tuo repository GitLab, prosegui con i passaggi di configurazione per fornire un po’ di contesto sulla tua app o sul tuo software e scegli le lingue di destinazione.

PTC tradurrà quindi i file di risorse nel branch GitLab connesso. Se il tuo repository contiene già file di traduzione, PTC può rilevarli e riutilizzarli.

4

Rivedi la Merge Request con le traduzioni

PTC traduce in pochi minuti e invia una merge request con le traduzioni direttamente al tuo repo GitLab. Quando sei pronto, ti basta unirla: non è necessaria nessun’altra azione.

Da quel momento in poi, man mano che invii modifiche al tuo codice, PTC le rileverà e invierà nuove merge request con le traduzioni aggiornate, mantenendo il tuo software completamente localizzato nel tempo.

Genera nuove Merge Request manualmente

Oltre agli aggiornamenti automatici, puoi generare una nuova merge request in qualsiasi momento per sincronizzare le traduzioni che hai modificato o ritradotto.

Per farlo, vai alla scheda Traduzioni. Da qui, puoi rivedere il testo tradotto che supera il limite di lunghezza e modificarlo manualmente o lasciare che PTC ne generi una versione più breve. Una volta terminato, clicca su Genera MR per inviare le traduzioni aggiornate al tuo repository.

5

Dai a PTC l’accesso ai nuovi file di risorse man mano che li aggiungi

Se aggiungi nuovi file di risorse al tuo repository dopo l’integrazione iniziale, puoi chiedere a PTC di cercarli.

  1. Vai su Impostazioni → File monitorati e clicca su Riesegui la scansione del repository. PTC eseguirà la scansione del tuo repository e mostrerà tutti i file appena scoperti come bozze.
  2. Clicca sull’icona + accanto a un file per includerlo nella traduzione, quindi clicca su Salva con traduzione per confermare.

Per saltare completamente la revisione manuale, seleziona la casella Includi automaticamente i nuovi file di traduzione. Da quel momento in poi, PTC rileverà e monitorerà automaticamente tutti i nuovi file di risorse che trova, senza richiedere conferma.

Per regolare altre impostazioni come i branch monitorati e le lingue, naviga tra le schede Gestione branch, File monitorati e Lingue.

Perché localizzare i progetti GitLab con PTC

Traduzione automatizzata dei file

PTC rileva e traduce automaticamente i tuoi file di risorse, consegnando le traduzioni tramite merge request. Mantieni il controllo utilizzando il flusso di lavoro di GitLab che già conosci e di cui ti fidi — e senza la necessità di creare alcuno script.

Meno lavoro manuale

PTC fa risparmiare tempo di sviluppo e accelera i rilasci monitorando il tuo repository e aggiornando i file di traduzione man mano che invii le modifiche.

Maggiore accuratezza della traduzione

PTC elimina il rischio di errori umani come chiavi fuori posto o traduzioni obsolete. Ottieni traduzioni estremamente accurate e in linea con il tuo marchio.

Domande frequenti sull’integrazione di GitLab

Scorri verso l'alto