Bitbucket (Strings)

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

Astuce

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

Bitbucket Sync est uniquement pris en charge pour Bitbucket Cloud. Il ne peut pas être utilisé avec Bitbucket serveur.
Bitbucket Sync peut être utilisé via API.

Prérequis

Le fichier de configuration .phrase.yml doit être présent à la racine de la branche à surveiller. Le fichier définit les 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:
        targets:
            - file: ./<locale_name>.json

L'Identifiant de 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'à Repo Sync et cliquez sur Configurer.

La page Repo Syncs s'ouvre.
Cliquez sur Ajouter Sync/Bitbucket.

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

La connexion entre Phrase Strings et le compte Bitbucket sélectionné est établie. La fenêtre des paramètres Bitbucket sync s'affiche.

Remarque

Il n'est pas possible de connecter plusieurs comptes via l'intégration Bitbucket.
Sélectionner un projet dans la liste déroulante.
Sélectionner 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électionner un référentiel branche dans la liste déroulante pour importer (push) et exporter (pull) depuis celui-ci. Il s'agit généralement de la branche principale.
Cliquez sur Validate Configuration pour vous assurer que les paramètres d'authentification et le fichier de configuration sont corrects.
Sélectionner éventuellement Auto import pour importer des fichiers à chaque commit vers 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.
(Facultatif) Cliquez sur l'icône crayon pour renommer l'intégration.

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

Facultativement, 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é Bitbucket Sync 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 (pull requests), afin que les modifications puissent être révisées et que la gestion de la branche puisse être contrôlée.

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

Depuis la page Repo Syncs, Sélectionner un projet et cliquez sur importer <3>.

Les traductions sont extraites 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électionner un projet et cliquez sur Exporter .

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

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 référentiel conservent un historique des derniers importations et exportations pour chaque projet Phrase Strings.

Pour afficher l'historique :

Depuis la page Repo Syncs, Sélectionner un projet et cliquez sur History .

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