Bitbucket (Strings)

Le contenu est traduit de l’anglais par Phrase Language AI.

Astuce

Pour des informations sur l'intégration de Bitbucket dans Phrase TMS, consultez Bitbucket Cloud (TMS).

La synchronisation Bitbucket n'est prise en charge que pour Bitbucket Cloud. Elle ne peut pas être utilisée avec Bitbucket Server.
La synchronisation Bitbucket peut être utilisée via API.

Conditions préalables

Le fichier .phrase.yml de configuration doit être présent à la racine de la branche à surveiller. Le fichier définit quels fichiers importer (pull) ou exporter (push) depuis le référentiel.
Les droits de lecture et d'écriture sur le référentiel sont requis.
Des fichiers de configuration mal définis peuvent entraîner des erreurs. Assurez-vous que le fichier contient au moins une cible push et une cible pull, des formats de fichiers corrects et le bon réglage du paramètre update_translations.

Exemple de fichier de configuration :

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

L'ID du projet d'un projet se trouve dans les paramètres du projet.

Connecter des référentiels

Une fois le fichier de configuration en place, pour connecter un référentiel, suivez ces étapes :

Depuis la page Intégrations, faites défiler vers le bas jusqu'à Synchronisation de Repo et cliquez sur Configurer.

La page Synchronisations de Repo s'ouvre.
Cliquez sur Ajouter Synchronisation/Bitbucket.

La page d'activation de la synchronisation Bitbucket s'ouvre.
Sélectionnez le compte Bitbucket à connecter dans la liste déroulante Autoriser pour l'espace de travail et cliquez sur Accorder l'accès.

La connexion entre les chaînes Phrase et le compte Bitbucket sélectionné est établie. La fenêtre des paramètres de synchro Bitbucket est affichée.

Remarque

Il n'est pas possible de connecter plusieurs comptes via l'intégration Bitbucket.
Sélectionnez un projet dans la liste déroulante.
Sélectionnez un référentiel Bitbucket dans la liste déroulante.

Si la propriété du référentiel n'est pas correcte, le référentiel ne sera pas visible dans la liste déroulante.
Sélectionnez une branche de référentiel dans la liste déroulante à importer (pousser) et exporter (tirer). C'est généralement la branche principale.
Cliquez sur Valider la configuration pour vous assurer que les paramètres d'authentification et le fichier de configuration sont corrects.
Optionnellement, sélectionnez Importation automatique pour importer des fichiers à chaque commit dans la branche Bitbucket sélectionnée.
Cliquez sur Enregistrer.

Le projet est maintenant connecté au référentiel Bitbucket sélectionné et ajouté à la liste.

Les intégrations peuvent être désactivées ou retirées de la page Repo Syncs.

Optionnellement, les utilisateurs peuvent retirer une intégration Bitbucket en révoquant l'autorisation pour Phrase Strings dans leurs paramètres personnels Bitbucket.

Importer depuis Bitbucket

Après avoir activé la synchronisation Bitbucket et connecté un référentiel, les fichiers de paramètre linguistique peuvent être importés. Cela se fait sous forme de demandes de tirage, afin que les modifications puissent être révisées et que la gestion des branches puisse être contrôlée.

Pour importer des fichiers de paramètre linguistique depuis Bitbucket, suivez ces étapes :

Depuis la page Repo Syncs, sélectionnez un projet et cliquez sur Importer .

Les traductions sont intégrées dans le projet. Les clés et les traductions actuelles sont mises à jour.
Approuvez, fusionnez ou fermez la demande de tirage dans Bitbucket.

Exporter vers Bitbucket

Pour exporter des fichiers de paramètre linguistique vers Bitbucket, suivez ces étapes :

Depuis la page Repo Syncs, sélectionnez un projet et cliquez sur Exporter .

La fenêtre Exporter s'affiche.
Fournissez la branche cible dans le champ branche PR.

Les fichiers les plus récents du référentiel seront exportés en tant que nouvelle demande de tirage vers la branche souhaitée.
Une fois les fichiers exportés, la demande de tirage peut être fusionnée ou fermée dans le référentiel et la branche peut être supprimée.

Historique

Les synchronisations de dépôt conservent un historique des dernières importations et exportations pour chaque projet de chaînes de phrases.

Pour consulter l'historique :

Depuis la page Synchronisations de dépôt, sélectionnez un projet et cliquez sur Historique .

L'historique des importations et exportations pour le projet est présenté. Les entrées d'exportation dans l'historique incluent un lien vers la demande de fusion correspondante.