Bitbucket (Strings)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Consiglio

Per informazioni sull'integrazione di Bitbucket in Phrase TMS, fare riferimento a Bitbucket Cloud (TMS).

Bitbucket Sync è supportato solo per Bitbucket Cloud. Non può essere utilizzato con Bitbucket server.
Bitbucket Sync può essere utilizzato tramite API.

Prerequisiti

Il file di impostazioni .phrase.yml deve essere presente nella radice del branch da monitorare. Il file definisce quali file importare (pull) o esportare (push) dall'archivio.
Per l’archivio è necessaria l’autorizzazione alla lettura e alla scrittura.
I file di configurazione definiti in maniera errata potrebbero provocare degli errori. Assicurati che il file contenga almeno una destinazione push e una pull, formati di file corretti e l’impostazione corretta del parametro update_translations.

File di configurazione di esempio:

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

L'ID progetto di un progetto si trova nelle impostazioni del progetto.

Collegare archivi

Una volta inserito il file di configurazione, per collegare un archivio, seguire questi passaggi:

Nella navigazione principale, fare clic su Automations, quindi su Repo Syncs.

In alternativa, dalla pagina Integrations, scorrere verso il basso fino a Repo Sync e fare clic su Configure.

Si apre la pagina Repo Syncs. L'elenco Repo Syncs visualizza solo i progetti a cui l'utente che sta visualizzando ha accesso.
Fare clic su Add Sync/Bitbucket.

Si apre la pagina di attivazione di Bitbucket Sync.
Selezionare l'account Bitbucket da collegare dall'elenco a discesa Authorize for workspace e fare clic su Grant access.

La connessione tra Phrase Strings e l'account Bitbucket selezionato è stabilita. Viene visualizzata la finestra delle impostazioni di sincronizzazione Bitbucket.

Nota

Non è possibile collegare più account tramite l'integrazione Bitbucket.
Selezionare un progetto dall'elenco a discesa.
Selezionare un archivio Bitbucket dall'elenco a discesa.

Se la proprietà dell'archivio non è corretta, l'archivio non sarà visibile nell'elenco a discesa.
Selezionare un branch dell'archivio dall'elenco a discesa da cui importare (push) ed esportare (pull). Di solito si tratta del branch master.
Fare clic su Convalida configurazione per assicurarsi che le impostazioni di autenticazione e il file di configurazione siano corretti.
Facoltativamente, selezionare Importazione automatica per importare i file a ogni commit nel branch Bitbucket selezionato.
Fai clic su Salva.

Il progetto è ora collegato all'archivio Bitbucket selezionato e aggiunto all'elenco.
(Facoltativo) Fare clic sull'icona a forma di matita per rinominare l'integrazione.

Le integrazioni possono essere disattivate o rimosse dalla pagina Sincronizzazioni archivio.

Facoltativamente, gli utenti possono rimuovere un'integrazione Bitbucket revocando l'autorizzazione per Phrase Strings nelle loro impostazioni personali Bitbucket.

Importare da Bitbucket

Dopo aver attivato la sincronizzazione Bitbucket e aver collegato un archivio, è possibile importare i file delle impostazioni locali. Ciò avviene sotto forma di pull request, in modo che le modifiche possano essere revisionate e la gestione del branch possa essere controllata.

Per importare i file delle impostazioni locali da Bitbucket, seguire questi passaggi:

Dalla pagina Sincronizzazioni archivio, selezionare un progetto e fare clic su importare .

Le traduzioni vengono estratte nel progetto. Le chiavi e le traduzioni correnti vengono aggiornate.
Approva, unire o chiudi la pull request in Bitbucket.

Esporta in Bitbucket

Per esportare i file delle impostazioni locali in Bitbucket, segui questi passaggi:

Dalla pagina Repo Syncs, Seleziona un progetto e fai clic su Esporta .

Viene visualizzata la finestra Esporta.
Fornisci il branch di destinazione nel campo PR branch.

I file più recenti nell'archivio verranno esportati come una nuova pull request nel branch desiderato.
Una volta esportati i file, la pull request può essere unire o chiusa nell'archivio e il branch può essere eliminato.

Ogni lingua esportata risulta in un commit separato all'interno della pull request. Il consolidamento di tutte le lingue esportate in un singolo commit non è attualmente supportato per Bitbucket, a differenza dell'integrazione GitHub.

Cronologia

Le sincronizzazioni dell'archivio mantengono una cronologia delle ultime importazioni ed esportazioni per ogni progetto Phrase Strings.

Per visualizzare la cronologia:

Dalla pagina Repo Syncs, Seleziona un progetto e fai clic su History .

Viene presentata la cronologia di importazione ed esportazione per il progetto. Le voci di esportazione nella cronologia includono un link alla corrispondente merge request.