Integra la localizzazione nella tua pipeline CI/CD con l’API di PTC
Scopri come integrare l’API di PTC nella tua pipeline CI/CD per fornire traduzioni con IA di qualità umana come parte del tuo processo di build.
Sicuro per progettazione — non è richiesto l’accesso in lettura o scrittura alla repository.- Compatibile con qualsiasi sistema CI/CD, con configurazioni pronte all’uso incluse.
- Accesso controllato tramite token API specifici per il progetto.
- Traduzioni di qualità umana fornite in pochi minuti, direttamente nella tua build.
Come funziona l’integrazione CI/CD
Prima di configurare PTC con il tuo sistema di CI, ecco i tre principi alla base dell’API e della CLI di PTC:
1. I file di risorse sono legati a un branch
Ogni file che invii a PTC è collegato a un nome di branch (ad es. main, feature/new-checkout). Questo mantiene le traduzioni separate, in modo che le traduzioni di diverse funzionalità non si sovrascrivano a vicenda.
Quando utilizzi le configurazioni CI/CD pronte all’uso, questa mappatura viene già gestita automaticamente.
2. Le traduzioni sono elaborate in modo asincrono
PTC non restituisce le traduzioni immediatamente. Invece:
- Carica i file aggiornati
- Identifica solo le stringhe nuove o modificate
- Traduce le stringhe
- Prepara i file tradotti per il download
3. Un unico script CLI funziona ovunque
Invece di chiamare l’API direttamente, usa la CLI di PTC:
Un unico script gestisce l’intero flusso (caricamento → polling → download). La CLI gira su Linux e macOS e funziona con GitHub Actions, GitLab, Bitbucket o qualsiasi altra piattaforma CI/CD.
Flusso generale: configura l’API di PTC nella tua pipeline CI/CD
1Iscriviti per una prova gratuita.
Ottieni l’accesso completo a tutte le funzionalità e traduci fino a 20.000 parole in due lingue a tua scelta.
2Crea un nuovo progetto.
Quando scegli come utilizzare PTC, seleziona API integration. Durante la configurazione, fornirai un po’ di contesto sul tuo progetto (cosa fa, a chi è rivolto) e selezionerai le lingue in cui desideri tradurre.
3Ottieni il tuo token API.
Al termine della configurazione, riceverai un token API specifico per il progetto. Copialo e conservalo in modo sicuro: ti servirà per autenticare tutte le richieste. Puoi sempre ritrovare lo stesso token nel tuo pannello di controllo del progetto sotto Settings → PTC API tokens.
4Aggiungi il token API di PTC al tuo repository nella posizione corretta.
| Provider | Dove aggiungere il token |
|---|---|
| GitHub Actions | Vai su Settings → Secrets and variables → Actions e aggiungi PTC_API_TOKEN. Poi vai su Settings → Actions → General e abilita Workflow permissions in modo che il workflow possa creare pull request. |
| GitLab CI/CD | Vai su Settings → CI/CD → Variables e aggiungi PTC_API_TOKEN. |
| Bitbucket Pipelines | Vai su Repository settings → Pipelines → Repository variables e aggiungi PTC_API_TOKEN. |
5Copia la configurazione CI/CD pronta all’uso.
Puoi ottenere la configurazione CI/CD pronta all’uso per la tua piattaforma dal wiki della CLI di PTC. Questi template includono già i passaggi per scaricare ed eseguire la CLI.
6Esegui il workflow.
Puoi attivare il workflow manualmente, sui commit che aggiornano i file di risorse o in modo pianificato. Consulta i trigger per GitHub, GitLab e Bitbucket.
Quando viene eseguita, la CLI carica i tuoi file, attende il completamento delle traduzioni e scrive le traduzioni aggiornate nel tuo repository. Se stai usando le configurazioni pronte all’uso, il workflow creerà anche una pull/merge request con le modifiche, così potrai revisionarle ed eseguirne il merge come qualsiasi altro aggiornamento del codice. Da qui in avanti, le tue traduzioni rimarranno sincronizzate automaticamente.
Esempi di CI/CD
Ulteriori letture
Perché usare PTC per le traduzioni software?
PTC è un sistema di traduzione completo per sviluppatori e team di prodotto — costruito per mantenere sincronizzati il tuo codice, il tuo brand e il tuo pubblico.
Traduzioni contestuali che proteggono il tuo brand
Prima di tradurre, PTC impara a conoscere il tuo prodotto, il tuo pubblico e la tua terminologia. Ecco perché il 99,5% delle frasi va online senza modifiche e l’85% dei progetti non viene affatto modificato.
Come le traduzioni con IA di PTC proteggono il tuo brand →
Ampio supporto per piattaforme e formati di file
PTC funziona con i formati di file di risorse e le piattaforme più popolari, tra cui: Android, iOS, React, Vue.js, Angular, Ruby on Rails, JavaScript, Adobe Commerce (Magento), Shopify e WordPress.
Scopri di più sui formati di file supportati →
Traduci più dei semplici file di risorse
Hai bisogno di tradurre note di rilascio, e-mail o documentazione? PTC include anche una veloce funzione “Incolla per tradurre” che ti offre le stesse traduzioni contestuali per i testi al di fuori del codice.
Come tradurre testi al di fuori dei file di risorse →
Automatizza le traduzioni nella tua CI/CD
Configura PTC una volta e i tuoi file di risorse e le traduzioni rimarranno aggiornati automaticamente nella tua pipeline CI/CD.