Integre la localización en su pipeline de CI/CD con la API de PTC
Aprenda a integrar la API de PTC en su pipeline de CI/CD para ofrecer traducciones con IA de calidad humana como parte de su proceso de compilación.
Seguro por diseño: no requiere acceso de lectura ni escritura al repositorio.- Compatible con cualquier sistema de CI/CD e incluye configuraciones listas para usar.
- Acceso controlado mediante tokens de API específicos del proyecto.
- Traducciones de calidad humana entregadas en minutos, directamente en su compilación.
Cómo funciona la integración de CI/CD
Antes de configurar PTC con su sistema de CI, estos son los tres principios detrás de la API y la CLI de PTC:
1. Los archivos de recursos están vinculados a una rama
Cada archivo que envía a PTC está vinculado a un nombre de rama (por ejemplo, main, feature/new-checkout). Esto mantiene las traducciones separadas, por lo que las traducciones de diferentes funciones no se sobrescriben entre sí.
Cuando utiliza las configuraciones de CI/CD listas para usar, este mapeo ya se procesa automáticamente.
2. Las traducciones se procesan de forma asíncrona
PTC no devuelve las traducciones inmediatamente. En su lugar:
- Sube los archivos actualizados
- Identifica solo las cadenas nuevas o modificadas
- Traduce las cadenas
- Prepara los archivos traducidos para su descarga
3. Un script de CLI funciona en todas partes
En lugar de llamar a la API usted mismo, utilice la CLI de PTC:
Un script se encarga de todo el flujo (carga → sondeo → descarga). La CLI se ejecuta en Linux y macOS, y funciona con GitHub Actions, GitLab, Bitbucket o cualquier otra plataforma de CI/CD.
Flujo de alto nivel: configure la API de PTC en su pipeline de CI/CD
1Regístrese para obtener una prueba.
Obtenga acceso completo a todas las funciones y traduzca hasta 20.000 palabras a dos idiomas de su elección.
2Cree un nuevo proyecto.
Al elegir cómo usar PTC, seleccione API integration. Durante la configuración, proporcionará un poco de contexto sobre su proyecto (qué hace, para quién es) y seleccionará los idiomas a los que desea traducir.
3Obtenga su token de API.
Al final de la configuración, recibirá un token de API específico del proyecto. Cópielo y guárdelo de forma segura: lo necesitará para autenticar todas las solicitudes. Siempre puede volver a encontrar el mismo token en el panel de control de su proyecto en Configuración → Tokens de API de PTC.
4Añada el token de API de PTC a su repositorio en la ubicación correcta.
| Proveedor | Dónde añadir el token |
|---|---|
| GitHub Actions | Vaya a Settings → Secrets and variables → Actions y añada PTC_API_TOKEN. Luego, vaya a Settings → Actions → General → Workflow permissions y active Allow GitHub Actions to create and approve pull requests. El archivo de flujo de trabajo ya solicita el acceso de escritura que necesita; esta casilla es lo único que no puede concederse a sí mismo. |
| GitLab CI/CD | Vaya a Settings → CI/CD → Variables y añada PTC_API_TOKEN. |
| Bitbucket Pipelines | Vaya a Repository settings → Pipelines → Repository variables y añada PTC_API_TOKEN. |
5Copie la configuración de CI/CD lista para usar.
En GitHub Actions, añada la acción PTC Translate a su flujo de trabajo. Su token de API es el único dato de entrada que debe proporcionar. La acción lleva una versión fija de la CLI en su interior, por lo que su compilación nunca descarga un script en tiempo de ejecución, y cuando una ejecución produce nuevas traducciones, abre el pull request por usted.
En GitLab CI, Bitbucket Pipelines o cualquier otra plataforma, copie el trabajo para su plataforma desde las plantillas de CI/CD de la CLI de PTC. Cada plantilla fija la versión de la CLI a un lanzamiento específico y publica la suma de comprobación para verificarla, de modo que un lanzamiento posterior de la CLI no pueda cambiar lo que ejecuta su compilación.
6Ejecute el flujo de trabajo.
Puede activar el flujo de trabajo manualmente, en los commits que actualizan archivos de recursos o de forma programada. Consulte los activadores para GitHub, GitLab y Bitbucket. Un pull request necesita una rama contra la cual abrirse, por lo que en GitHub Actions la acción PTC Translate abre uno en un push, de forma programada y en una ejecución manual desde una rama. En un evento pull_request, pull_request_target o merge_group, o en una etiqueta o un lanzamiento, se detiene con una explicación en su lugar: traduzca en un push a su rama de origen, o configure create-pr: false para esa ejecución.
Cuando se ejecuta, la CLI sube sus archivos, espera a que terminen las traducciones y vuelve a escribir las traducciones actualizadas en su repositorio. Si utiliza las configuraciones listas para usar y la ejecución produjo nuevas traducciones, el flujo de trabajo también create a merge request con los cambios, para que pueda revisarlos y fusionarlos como cualquier otra actualización de código. Una ejecución que no encuentra nada para traducir no escribe nada y no abre ningún merge request. A partir de aquí, sus traducciones se mantienen sincronizadas automáticamente.
Ejemplos de CI/CD
WordPress
Ruby on Rails
Archivos JSON (aplicaciones React)Lecturas adicionales
- Datos de entrada de la acción PTC Translate
- Plantillas de CI/CD para GitHub y GitLab
- Archivo de configuración
- Flujo de trabajo de procesamiento
- Solución de problemas
¿Por qué usar PTC para las traducciones de software?
PTC es un sistema de traducción completo para desarrolladores y equipos de productos, creado para mantener su código, su marca y su audiencia sincronizados.
Traducciones contextualizadas que protegen su marca
Antes de traducir, PTC aprende sobre su producto, su audiencia y su terminología. Por eso, el 99,5 % de las oraciones llegan a producción sin ediciones, y el 85 % de los proyectos no se editan en absoluto.
Cómo las traducciones con IA de PTC protegen su marca →
Amplia compatibilidad con plataformas y formatos de archivo
PTC funciona con las plataformas y los formatos de archivos de recursos más populares, incluyendo: Android, iOS, React, Vue.js, Angular, Ruby on Rails, JavaScript, Adobe Commerce (Magento), Shopify y WordPress.
Más información sobre los formatos de archivo compatibles →
Traduzca más que solo archivos de recursos
¿Necesita traducir notas de lanzamiento, correos electrónicos o documentación? PTC también incluye una función rápida «Paste to translate» que le ofrece las mismas traducciones contextualizadas para el texto fuera del código.
Cómo traducir texto fuera de los archivos de recursos →
Automatice las traducciones en su CI/CD
Configure PTC una vez y sus archivos de recursos y traducciones se mantendrán actualizados automáticamente en su pipeline de CI/CD.