Bitbucket (Strings)

El contenido se traduce automáticamente del inglés por Phrase Language AI.

Consejo

Para obtener información sobre la integración de Bitbucket en Phrase TMS, consulte Bitbucket Cloud (TMS).

Bitbucket Sync solo es compatible con Bitbucket Cloud. No se puede utilizar con Bitbucket Server.
Bitbucket Sync se puede utilizar a través de la API.

Requisitos previos

El archivo de configuración .phrase.yml debe estar presente en la raíz de la rama que se va a supervisar. El archivo define qué importar (pull) o exportar (push) del repositorio.
Requiere un acceso de lectura y escritura para el repositorio.
Los archivos de configuración definidos incorrectamente pueden causar errores. Comprueba que el archivo contiene al menos un meta para importar y otro para exportar, que los formatos de archivo sean correctos y que la configuración del parámetro update_translations esté bien.

Archivo de configuración de muestra:

phrase:
    project_id: 1f61b9ecdb7a17a9dd174302419c50cc
    file_format: simple_json
    push:
        sources:
            - file: ./<locale_name>.json
    pull:
        targets:
            - file: ./<locale_name>.json

El ID del proyecto se encuentra en la configuración del proyecto.

Conectar repositorios

Una vez que el archivo de configuración esté en su lugar, para conectar un repositorio, siga estos pasos:

Desde la página Integraciones, desplácese hacia abajo hasta Sincronización de repositorios y haga clic en Configurar.

Se abre la página Sincronizaciones de repositorios.
Haga clic en Agregar sincronización/Bitbucket.

Se abre la página de activación de Bitbucket Sync.
Seleccione la cuenta de Bitbucket que se va a conectar en la lista desplegable Autorizar para el espacio de trabajo y haga clic en Acceder.

Se establece la conexión entre Phrase Strings y la cuenta de Bitbucket seleccionada. Se muestra la ventana de configuración de Bitbucket sync.

Nota

No es posible conectar varias cuentas a través de la integración de Bitbucket.
Seleccionar un proyecto de la lista desplegable.
Seleccionar un repositorio de Bitbucket de la lista desplegable.

Si la propiedad del repositorio no es correcta, el repositorio no será visible en la lista desplegable.
Seleccionar una rama de repositorio de la lista desplegable desde la cual importar (push) y exportar (pull). Esta suele ser la rama principal.
Haga clic en Validar configuración para asegurarse de que la configuración de autenticación y el archivo de configuración sean correctos.
Opcionalmente, seleccionar Importación automática para importar archivos con cada confirmación (commit) a la rama de Bitbucket seleccionada.
Haz clic en Guardar.

El proyecto ahora está conectado al repositorio de Bitbucket seleccionado y agregado a la lista.
(Opcional) Haga clic en el icono de lápiz para cambiar el nombre de la integración.

Las integraciones se pueden desactivar o eliminar desde la página de Repo Syncs.

Opcionalmente, los usuarios pueden eliminar una integración de Bitbucket revocando la autorización para Phrase Strings en su configuración personal de Bitbucket.

Importar desde Bitbucket

Después de activar la sincronización de Bitbucket y conectar un repositorio, se pueden importar archivos de localización. Esto se realiza en forma de solicitudes de extracción, por lo que los cambios pueden ser revisados y la gestión de la rama puede ser controlada.

Para importar archivos de localización desde Bitbucket, siga estos pasos:

Desde la página de Repo Syncs, seleccione un proyecto y haga clic en importar .

Las traducciones se extraen al proyecto. Las claves y las traducciones actuales se actualizan.
Aprobar, unir o cerrar la solicitud de extracción en Bitbucket.

Exportar a Bitbucket

Para exportar archivos de localización a Bitbucket, siga estos pasos:

Desde la página Repo Syncs, Seleccionar un proyecto y hacer clic en Exportar .

Se muestra la ventana Exportar.
Proporcione la rama meta en el campo PR branch.

Los archivos más recientes en el repositorio se exportarán como una nueva solicitud de extracción a la rama deseada.
Una vez exportados los archivos, la solicitud de extracción puede unir o cerrarse en el repositorio y la rama puede eliminarse.

Cada idioma exportado resulta en una confirmación separada dentro de la solicitud de extracción. Consolidar todos los idiomas exportados en una sola confirmación no es compatible actualmente para Bitbucket, a diferencia de la integración de GitHub.

Historial

Las sincronizaciones de repositorio mantienen un historial de las últimas importaciones y exportaciones para cada proyecto de Phrase Strings.

Para ver el historial:

Desde la página Repo Syncs, Seleccionar un proyecto y hacer clic en Historial .

Se presenta el historial de importación y exportación del proyecto. Las entradas de Exportar en el historial incluyen un enlace a la solicitud de unir correspondiente.