branching (Strings)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Disponibile per

Piani Business ed Enterprise

Contatta ilreparto vendite per dubbi relativi alle licenze.

Il branching viene utilizzato nel controllo versione del software. Copie dei file di progetto chiamate branch consentono ai team di svolgere lavoro su versioni parallele del progetto contemporaneamente, mantenendo una copia non modificata. Ciò elimina il rischio di sovrascrivere accidentalmente le modifiche di altri ai file di progetto.

Il progetto principale viene copiato quando viene creato un nuovo branch, con le modifiche apportate solo a quel branch. Quando le modifiche sono Completa, il branch viene unito nuovamente al progetto principale. È possibile svolgere lavoro su più branch contemporaneamente e, dopo l'unione, i branch vengono eliminati automaticamente. I branch uniti rimangono disponibili nella scheda Merged per un tracciamento semplificato della cronologia. I tag di un branch esistente vengono copiati nel nuovo branch.

Limitazioni

Tutti i roles eccetto traduttore e Guest hanno accesso alla vista Branches.
I merge non possono essere annullati e i branch non possono essere ripristinati.
I Jobs creati in un branch specifico non sono visibili nel progetto principale e viceversa. Quando un branch viene unito al progetto principale, tutti i lavori aperti in esso vengono persi.
I report nella vista Reports riflettono solo lo stato del branch attivo. L'unione di un branch nel progetto principale aggiorna i report del progetto principale.
La vista Activity contiene solo le attività nel branch attivo. Le attività nei branch non sono visibili nel progetto principale e viceversa. Le attività in un branch vengono perse quando lo si unisce al progetto principale.
GitHub Sync può essere usato solo sul progetto principale e non sui branch.
I commenti fatti in un branch non sono visibili nel progetto principale e viceversa.
Gli ordini creati in un branch non sono visibili nel progetto principale e viceversa. Quando un branch viene unito al progetto principale, tutti gli ordini aperti in esso vengono persi.
I traduttori non possono essere limitati a branch specifici, ma ricevono il permesso di lavorare su lingue specifiche. I traduttori dovrebbero essere istruiti su come lavorare con i branch.

Abilitare il branching

Il branching è abilitato nella scheda<1> Advanced} delle impostazioni<2> del progetto con l'opzione di proteggere il branch principale dalle modifiche.

Quando abilitato, un menu branch Branch Menu viene presentato nella schermata del progetto dove è possibile selezionare i branch di lavoro. Per specificare un branch in CLI, usare il parametro --branch:

--branch <branch_name>

I branch sono elencati nella scheda<1> Branches} di un progetto, dove vengono presentate le informazioni su creazione e merge. I branch possono anche essere eliminati o uniti e i job creati per quel branch dalla scheda<2> Branches}.

Per elencare tutti i branch per un progetto tramite API o CLI, eseguire:

$ phrase branches list --project_id <project_id>

# ad es.
$ phrase branches list --project_id 1d8ae641902624df63ce6fbd64ff9549$ phrase branches list <project_id>

Per eliminare un branch tramite API o CLI, eseguire:

$ phrase branches delete --project_id <project_id> --name <branch_name>

# ad es.
$ phrase branches delete --project_id 1d8ae641902624df63ce6fbd64ff9549 --name test-test$ phrase branch delete <project_id> <branch_name>

creare un branch

I ruoli amministratore, project manager, designer e developer possono creare nuovi branch nella scheda Branches, tramite API o nella CLI. I branch possono essere creati da qualsiasi altro branch, non solo dal branch principale. Sono supportati fino a 5 livelli di branch.

Per creare un branch dall'interfaccia utente, segui questi passaggi:

Da una pagina progetto, seleziona la scheda branch.
Clicca Crea branch.

Si apre la finestra Crea branch.
Fornisci un nome per il branch.
Seleziona un Base branch dall'elenco dei branch esistenti.
Clicca Crea.

Il nuovo branch viene aggiunto all'elenco.

Per creare un branch tramite API o CPI, esegui:

$ Phrase branches create --project_id <project_id> --data <data>

Per creare un branch durante il push delle traduzioni, esegui:

$ Phrase push --branch <branch_name>

Sincronizza branch

La sincronizzazione assicura che il branch di lavoro rimanga allineato con le ultime modifiche del branch da cui ha avuto origine. In questo modo, i traduttori possono lavorare con una versione aggiornata del contenuto anche in progetti a lungo termine.

Per sincronizzare un branch con il suo branch di base, segui questi passaggi:

Nella scheda branch, fare clic su Sync with base branch accanto al branch desiderato.

La pagina Sync viene visualizzata con informazioni su eventuali conflitti e modifiche da sincronizzare con il branch di base.
Fare clic su una qualsiasi delle modifiche rilevate per esaminarla prima della sincronizzazione.

Viene visualizzata una tabella con i dettagli sulla modifica selezionare.
Selezionare Sync e confermare per applicare le modifiche.

Le modifiche vengono aggiunte al branch di base e diventano visibili nell'editor di traduzione. Le informazioni sull'ultima sincronizzazione vengono visualizzate nella colonna Synced della scheda branch.

La sincronizzazione del branch può essere eseguita anche tramite API eseguendo questo comando CLI:

$ phrase branches sync \\
  --project_id <project_id> \
  --name <branch_name> \\
  --data '{\"strategy\":\"use_main\"}' \\
  --access_token <token>

use_branch risolve i conflitti applicando le modifiche dal branch e, se non specificato, è l'impostazione predefinita.
use_main risolve i conflitti rifiutando le modifiche dal branch e fa riferimento al branch di base. Quando si lavora con branch sovrapposti, il branch di base non è necessariamente l'effettivo branch principale del progetto.

Unire i branch

Dopo aver completato la traduzione o il lavoro specifico della versione in un branch, eventuali modifiche possono essere unite nel branch di base. Una volta che tutte le modifiche sono state unite lungo la catena, il branch di primo livello può essere unito nel branch principale.

Dopo un'operazione di unire riuscita, il branch unito viene eliminato automaticamente e appare nella scheda Merged per il monitoraggio della cronologia.

Durante le operazioni di unire, al branch di base vengono applicate solo le modifiche alle seguenti risorse:

Impostazioni locali
Chiavi
Traduzioni

Le modifiche ad altre risorse, come Attività, Lavori e Ordini, non vengono applicate.

I branch con branch (entità) subordinata attivo non possono essere uniti finché i branch (entità) subordinata non vengono prima eliminati o uniti.

Conflitti

Un conflitto si verifica quando una risorsa (traduzione, chiave o impostazioni locali) è cambiata sia nel branch corrente che nel suo branch di base dopo che il branch è stato creato o sincronizzato l'ultima volta. I conflitti possono verificarsi a qualsiasi livello dello stack di branch, non solo quando si esegue l'unione nel main.

Per unire un branch, seguire questi passaggi:

Dalla scheda branch di un progetto, fare clic su unire con branch di base Avanti al branch desiderato.

Si apre la pagina unire. Le informazioni sulle traduzioni da modificare durante l'unione possono essere consultate facendo clic nelle celle.
Se ci sono conflitti, selezionare una strategia di unione:
- Selezionare Usare branch di base per rifiutare le modifiche in conflitto e preservare le traduzioni esistenti.
- Selezionare Usare NomeBranch per Sostituisci le traduzioni esistenti con le modifiche dal branch.
Fare clic su unire e confermare per applicare le modifiche.

Il branch viene unito al branch di base ed eliminato automaticamente. Per rivedere la cronologia del branch unito, aprire la scheda Unito nella pagina branch.

Per unire un branch tramite API o CPI, eseguire:

$ phrase branches merge \\
  --project_id <project_id> \
  --name <name> \\
  --data '{\"strategy\":\"use_main\"}' \\
  --access_token <token>

use_branch risolve i conflitti applicando le modifiche dal branch e, se non specificato, è l'impostazione predefinita.
use_main risolve i conflitti rifiutando le modifiche dal branch. È supportato anche use_master.

L'azione unire elimina anche automaticamente il branch unito.

Push e pull

Quando si usa la CLI, specificare un branch da cui eseguire il push o il pull con il parametro --branch.

$ Phrase push --branch <branch_name>
$ Phrase pull --branch <branch_name>

Se il branch specificato non esiste in un progetto, il cliente lo Crea.

Usare --use-local-branch-name per eseguire push e pull usando il nome del branch di un branch git attivo:

$ Phrase push --use-local-branch-name
$ Phrase pull --use-local-branch-name

API

Tutti gli endpoint API che richiedono un argomento progetto supportano anche il parametro --branch per eseguire un'azione su un ramo specifico di un progetto:

$ Phrase upload Crea <project_id> \

  --branch <branch_name>

  --file /path/to/my/file.json \\

  --file-format json \\

  --locale-id abcd1234cdef1234abcd1234cdef1234 \\

  --tags awesome-feature,needs-proofreading \

  --locale-mapping "{"en": "2"}" \\

  --format-options "{"foo": "bar"}"