Integración de GitLab con PTC

+

Conecte GitLab con PTC para una localización continua. Reciba las traducciones a través de solicitudes de fusión automáticas cada vez que cambie su código.

Cómo integrar GitLab con PTC

PTC se conecta a su repositorio de GitLab y mantiene sus archivos de recursos traducidos mientras trabaja. Envíe cambios a su código y PTC los detectará automáticamente, traducirá las cadenas actualizadas y abrirá una solicitud de fusión.

1

Conecte su repositorio de GitLab

PTC es compatible tanto con GitLab.com como con repositorios de GitLab autoalojados. Dependiendo de en qué punto de su flujo de trabajo se encuentre, hay dos formas de empezar:

  • Al crear un nuevo proyecto en PTC, seleccione Integración con Git 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 Configuración → Solicitudes de fusión y haga clic en Añadir integración con Git.

En ambos casos, verá una pantalla donde podrá introducir la URL de su proyecto dentro del repositorio. PTC detectará automáticamente que está utilizando GitLab.

2

Autenticarse con GitLab

Para conectar su repositorio, puede utilizar 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 utilizar un token de acceso, el rol y los alcances que necesite dependerán de cómo desee configurar el webhook:

Configuración automática del webhook

Cómo funciona

PTC crea y configura el webhook en GitLab en su nombre durante el flujo de integración.

Creación del token

En su proyecto, vaya a Ajustes → Tokens de acceso. Asigne un nombre al token, una descripción opcional y establezca una fecha de caducidad (recomendado por seguridad).

Rol requerido

Mantenedor

Alcances

api → permite a PTC leer y enviar al repositorio

Configuración manual del webhook

Cómo funciona

PTC le proporciona una URL de devolución de llamada y un token secreto. Usted crea un webhook en su configuración de GitLab utilizando estos datos, con los eventos de inserción (push) y de solicitud de fusión como activadores.

Creación del token

En su grupo, vaya a Ajustes → Tokens de acceso. Asigne un nombre al token, una descripción opcional y establezca una fecha de caducidad (recomendado por seguridad).

Rol requerido

Desarrollador (o equivalente)

Alcances

read_repository + write_repository

Cómo funciona

Creación del token

Rol requerido

Alcances

Configuración automática del webhook

PTC crea y configura el webhook en GitLab en su nombre durante el flujo de integración.

En su proyecto, vaya a Ajustes → Tokens de acceso. Asigne un nombre al token, una descripción opcional y establezca una fecha de caducidad (recomendado por seguridad).

Mantenedor

api

Configuración manual del webhook

PTC le proporciona una URL de devolución de llamada y un token secreto. Usted crea un webhook en su configuración de GitLab utilizando estos datos, con los eventos de inserción (push) y de solicitud de fusión como activadores.

En su proyecto, vaya a Ajustes → Tokens de acceso. Asigne un nombre al token, una descripción opcional y establezca una fecha de caducidad (recomendado por seguridad).

Desarrollador (o equivalente)

read_repository + write_repository

Guarde el token de forma segura y añádalo a PTC. Este verificará sus permisos y le permitirá elegir qué ramas y archivos de recursos desea supervisar.

3

Traduzca su proyecto con PTC

Una vez que su repositorio de GitLab esté conectado, continúe con los pasos de configuración para proporcionar contexto sobre su aplicación o software y elija sus idiomas de destino.

PTC traducirá entonces los archivos de recursos en su rama de GitLab conectada. Si su repositorio ya contiene archivos de traducción, PTC puede detectarlos y reutilizarlos.

4

Revise la solicitud de fusión con las traducciones

PTC traduce en cuestión de minutos y envía una solicitud de fusión con las traducciones directamente a su repositorio de GitLab. Cuando esté listo, simplemente fúndala; no se requiere ninguna otra acción.

A partir de ese momento, a medida que envíe cambios a su código, PTC los detectará y enviará nuevas solicitudes de fusión con las traducciones actualizadas, manteniendo su software totalmente localizado a lo largo del tiempo.

Generar nuevas solicitudes de fusión manualmente

Además de las actualizaciones automáticas, puede generar una nueva solicitud de fusión en cualquier momento para sincronizar las traducciones que haya editado o vuelto a traducir.

Para ello, vaya a la pestaña Traducciones. 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 MR para enviar las traducciones actualizadas a su repositorio.

5

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 pedirle a PTC que los busque.

  1. Vaya a Configuración → Archivos supervisados y haga clic en Volver a escanear su repositorio. PTC escaneará su repositorio y mostrará cualquier archivo recién descubierto como borrador.
  2. Haga clic en el icono + junto a un archivo para incluirlo en la traducción y, a continuación, haga clic en Guardar con traducción para confirmar.

Para omitir por completo la revisión manual, seleccione la casilla de verificación Incluir automáticamente nuevos archivos de traducción. A partir de ese momento, PTC detectará y supervisará automáticamente cualquier archivo de recursos nuevo que encuentre, sin necesidad de confirmación.

Para ajustar otras configuraciones, como las ramas supervisadas y los idiomas, navegue por las pestañas Gestión de ramas, Archivos supervisados y Idiomas.

Por qué localizar proyectos de GitLab con PTC

Traducción automática de archivos

PTC detecta y traduce automáticamente sus archivos de recursos, entregando las traducciones mediante solicitudes de fusión. 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 supervisar su repositorio y actualizar los archivos de traducción a medida que envía los cambios.

Precisión de traducción mejorada

PTC elimina el riesgo de errores humanos, como claves mal ubicadas o traducciones obsoletas. Obtendrá traducciones muy precisas y que reflejan la identidad de su marca.

Preguntas frecuentes sobre la integración de GitLab

Ir arriba