Integración de GitLab con PTC
Conecte GitLab con PTC para una localización continua. Reciba las traducciones mediante merge requests automáticos cada vez que cambie su código.
Cómo integrar GitLab con PTC
PTC se conecta a su repositorio de GitLab y mantiene traducidos sus archivos de recursos mientras usted trabaja. Suba los cambios a su código y PTC los detectará automáticamente, traducirá las cadenas actualizadas y abrirá un merge request.
La integración con GitLab es una función Pro. Está disponible al activar el Pay-As-You-Go.
Conecte su repositorio de GitLab
PTC es compatible tanto con GitLab.com como con repositorios de GitLab autohospedados. Dependiendo de en qué punto de su flujo de trabajo se encuentre, hay dos formas de comenzar:
- Al crear un nuevo proyecto en PTC, seleccione Git Integration en el asistente de configuración.
- Para cambiar un proyecto existente de subidas de archivos manuales a un flujo de trabajo continuo basado en Git, vaya a Settings → Merge Requests y haga clic en Git Integration.
En ambos casos, verá una pantalla donde podrá introducir la URL de su proyecto. PTC detectará automáticamente que está utilizando GitLab.
Autentíquese con GitLab
Para conectar su repositorio, puede usar un token de acceso (recomendado) o iniciar sesión con OAuth. PTC admite tanto tokens de acceso de proyecto como tokens de acceso de grupo.
PTC requiere acceso a webhooks para detectar cambios en su repositorio. Al usar un token de acceso, el rol y los alcances (scopes) que necesita dependen de cómo desee configurar el webhook:
| Configuración automática del webhook | Configuración manual del webhook | |
|---|---|---|
| Cómo funciona | PTC crea y configura el webhook en GitLab en su nombre durante el flujo de integración. | PTC le proporciona una Callback URL y un Secret Token. Usted crea un webhook en sus ajustes de GitLab usando estos detalles, con los eventos Push events y Merge request events como activadores. |
| Creación del token | En su proyecto, vaya a Settings → Access Tokens. Dé un nombre al token, una descripción opcional y establezca una fecha de caducidad (recomendado por seguridad). | En su grupo, vaya a Settings → Access Tokens. Dé un nombre al token, una descripción opcional y establezca una fecha de caducidad (recomendado por seguridad). |
| Rol requerido | Maintainer | Developer (o equivalente) |
| Alcances (scopes) | api → Permite a PTC leer y subir cambios al repositorio |
read_repository + write_repository |
Guarde el token de forma segura y añádalo a PTC. El sistema verificará sus permisos y le permitirá elegir qué ramas y archivos de recursos desea monitorizar.
El acceso se limita a los archivos que PTC traduce
PTC utiliza el acceso de lectura para detectar cambios en sus archivos de recursos y el acceso de escritura para entregar las traducciones mediante merge requests. PTC solo interactúa con los archivos que gestiona para la traducción y no realiza cambios en ninguna otra parte de su repositorio.
Los webhooks mantienen las traducciones sincronizadas automáticamente
Los webhooks son la forma en que PTC recibe notificaciones cuando usted sube cambios a su repositorio, permitiéndole retraducir las cadenas afectadas automáticamente. Sin acceso a los webhooks, PTC no puede monitorizar sus ramas en busca de actualizaciones.
Traduzca su proyecto con PTC
Una vez conectado su repositorio de GitLab, continúe con los pasos de configuración para proporcionar contexto sobre su aplicación o software y elija sus idiomas de destino.
A continuación, PTC traducirá los archivos de recursos en su rama de GitLab conectada. Si su repositorio ya contiene archivos de traducción, PTC puede detectarlos y reutilizarlos.
Revise el merge request con las traducciones
PTC traduce en cuestión de minutos y envía un merge request con las traducciones directamente a su repositorio de GitLab. Cuando esté listo, simplemente acéptelo; no se requiere ninguna otra acción.
A partir de ese momento, a medida que suba cambios a su código, PTC los detectará y enviará nuevos merge requests con las traducciones actualizadas, manteniendo su software totalmente localizado a lo largo del tiempo.
Generar nuevos merge requests manualmente
Además de las actualizaciones automáticas, puede generar un nuevo merge request en cualquier momento para sincronizar las traducciones que haya editado o retraducido.
Para hacerlo, vaya a la pestaña Translations. Desde aquí, puede revisar el texto traducido que supere el límite de longitud y editarlo manualmente o dejar que PTC genere una versión más corta. Una vez que haya terminado, haga clic en Generar merge request para enviar las traducciones actualizadas a su repositorio.
Dé acceso a PTC a los nuevos archivos de recursos a medida que los añada
Si añade nuevos archivos de recursos a su repositorio después de la integración inicial, puede solicitar a PTC que los busque.
- Vaya a Settings → Monitored Files y haga clic en Volver a escanear el repositorio. PTC escaneará su repositorio y mostrará cualquier archivo recién descubierto como borrador.
- Haga clic en el icono + junto a un archivo para incluirlo en la traducción y, a continuación, haga clic en Save with translation para confirmar.
Para omitir la revisión manual por completo, seleccione la casilla Automatically include new translation files. A partir de ese momento, PTC detectará y monitorizará automáticamente cualquier nuevo archivo de recursos que encuentre, sin necesidad de que usted los confirme.
Para ajustar otros parámetros, como las ramas monitorizadas y los idiomas, navegue por las pestañas Branch Management, Monitored Files y Languages.
Por qué localizar proyectos de GitLab con PTC
Traducción de archivos automatizada
PTC detecta y traduce automáticamente sus archivos de recursos, entregando las traducciones mediante merge requests. Usted mantiene el control utilizando el flujo de trabajo de GitLab que ya conoce y en el que confía, y sin necesidad de crear ningún script.
Menos trabajo manual
PTC ahorra tiempo de desarrollo y acelera los lanzamientos al monitorizar su repositorio y actualizar los archivos de traducción a medida que usted sube los cambios.
Precisión de traducción mejorada
PTC elimina el riesgo de errores humanos, como claves mal colocadas o traducciones desactualizadas. Obtendrá traducciones de alta precisión y acordes con su voz de marca.
La localización sigue el ritmo del desarrollo de software y aplicaciones móviles
PTC está diseñado para equipos que crean productos de software y aplicaciones móviles y que desean que la localización siga el ritmo del desarrollo. Una vez que conecte su repositorio de GitLab, PTC detecta automáticamente las cadenas nuevas y actualizadas y devuelve las traducciones a través de un merge request, sin necesidad de transferencias manuales.
Los formatos habituales en proyectos de software y móviles —como los archivos PO y los archivos JSON— son totalmente compatibles. Para obtener más información sobre cómo se adapta PTC a estos flujos de trabajo, consulte nuestras páginas de localización de software y localización de aplicaciones móviles.
Conecte GitLab sin coste adicional
No hay ningún cargo adicional por conectar GitLab. En lugar de un modelo de suscripción, PTC utiliza un sencillo sistema de precios Pay-As-You-Go: solo se le cobra por las palabras que traduzca, y las primeras 500 palabras de cada mes son gratuitas. Todos los detalles están en la página de precios de PTC.
También funciona con GitHub y Bitbucket
Además de GitLab, PTC se integra con GitHub y Bitbucket, ofreciendo los mismos flujos de trabajo de localización automatizada y funciones para cada plataforma.