L'integrazione Phrase Strings (denominata nell'interfaccia di Strings) collega Phrase TMS e Phrase Strings. L'integrazione supporta la sincronizzazione sia a livello di lavoro che a livello di progetto.
-
Job Sync
I lavori creati e avviati in Strings con lo stato In corso possono essere importati in TMS per la traduzione e poi inviati nuovamente a Strings.
Consigliato per flussi di lavoro a lotti che richiedono un controllo granulare.
-
Sincronizzazione a livello di progetto
Tutte le chiavi di un progetto Strings selezionato vengono trasferite a TMS senza dover creare un lavoro. Le chiavi appena aggiunte o aggiornate diventano automaticamente disponibili per la sincronizzazione.
Consigliato per flussi di lavoro di localizzazione continua.
Prerequisiti
-
Accesso alle applicazioni TMS e Strings
-
I codici lingua utilizzati nel progetto TMS devono corrispondere ai codici delle lingue nel lavoro Strings.
-
La lingua predefinita del progetto Strings deve coincidere con la lingua di origine definita nel progetto TMS.
Importante
I file Figma possono essere visualizzati per intero e in tempo reale in Strings, ma non sono supportati in TMS. L'editor CAT di TMS può visualizzare solo il contenuto tradotto in uno specifico frame Figma in formato SVG.
Per impostazione predefinita, il contenuto inviato da Strings a TMS viene importato come file XLIFF 2.0. Quando usi APC, imposta su o nelle impostazioni di importazione dei file del modello di progetto TMS.
Gli stati di traduzione delle chiavi di Strings non sono supportati. La sincronizzazione dei lavori invia a TMS il testo di destinazione attualmente presente in Strings, indipendentemente dal fatto che la chiave sia verificata o meno. Le chiavi contrassegnate come in Strings prima dell'importazione in TMS possono tornare in Strings come anche se le traduzioni di destinazione non sono state modificate.
L'impostazione del progetto Strings non viene applicata dalla sincronizzazione dei lavori. La sostituzione di fallback non avviene in nessuna delle due direzioni tra Strings e TMS, pertanto il testo dell'impostazione locale di fallback non viene usato al posto delle traduzioni non verificate.
Il numero di segmenti creati in TMS dopo l’importazione di un lavoro di Strings può essere diverso dal numero originale di chiavi nei seguenti casi:
-
Le chiavi sono contrassegnate come escluse in Strings. Le chiavi escluse non vengono importate.
-
L'opzione Segmenta XLIFF è stata abilitata nelle impostazioni di importazione dei file XLIFF 2.0 durante la creazione del lavoro in TMS. In questo caso, il numero di segmenti può essere superiore al numero di chiavi in Strings.
Le chiavi di Strings possono contenere entità HTML. Quando configuri il connettore in TMS, abilita l'opzione per conservare le entità HTML anziché visualizzare i caratteri corrispondenti in TMS.
Gli spazi iniziali e finali presenti nel testo di origine di una chiave Strings non vengono visualizzati nell'editor CAT di TMS. Questi spazi vengono conservati nella struttura del file e reinseriti sia nel testo di origine sia nella traduzione quando il lavoro viene sincronizzato di nuovo con Strings. Ciò può influire sulle convalide del limite di caratteri configurate in Strings, poiché il conteggio degli spazi non viene mostrato nell'editor TMS durante la traduzione.
Utilizzando il connettore, è possibile monitorare più progetti e file in APC. Ogni progetto richiede un monitoraggio individuale all'interno di un singolo APC.
Quando APC elabora un evento che attiva la sincronizzazione dei lavori, crea un lavoro TMS per ogni lingua del lavoro Strings. L'ordine di importazione di questi lavori non è garantito e non può essere configurato tramite il modello di progetto assegnato alla regola APC. Non viene applicato alcun criterio di ordinamento in nessuna fase del processo. Per gestire in modo diverso ciascun gruppo di lingue, configura regole APC separate, ciascuna associata a un modello di progetto diverso.
Il connettore usa le annotazioni delle lingue dei lavori per associare ai lavori Strings e alle relative lingue i metadati del progetto Phrase TMS corrispondente. L'endpoint dell'API di Phrase Strings che elenca le annotazioni delle lingue dei lavori recupera questi metadati. Anche l'endpoint che elenca le lingue di destinazione dei lavori include questi metadati quando il parametro include_annotations è impostato su true. I lavori annotati contengono campi come tms_project_id e tms_in_progress, che consentono di monitorare lo stato di un lavoro Strings nel suo progetto Phrase TMS collegato.
TMS non supporta l'uso della stessa lingua come lingua di origine e di destinazione in un progetto. Ad esempio, se un lavoro Strings usa en-US sia come lingua di origine sia come lingua di destinazione, la lingua di destinazione en-US non può essere importata in TMS e il lavoro non può essere contrassegnato come completato. Non selezionare la lingua di origine come lingua di destinazione durante la creazione di lavori in Strings che verranno sincronizzati con TMS.
Messaggi ICU e forme plurali CLDR
Quando invii a TMS per la traduzione lavori Strings contenenti messaggi ICU o forme plurali, abilita l'opzione nelle impostazioni di importazione dei file XLIFF 2.0 o nei modelli di progetto TMS.
Ci sono una serie di casi d'uso per il connettore:
-
I project manager di TMS possono aggiungere file direttamente ai progetti TMS da un archivio online.
-
Configura il portale richiedente Phrase TMS per consentire ai richiedenti di aggiungere file alle richieste direttamente da Phrase Strings.
-
Usa la creazione di progetti automatizzata (APC) di TMS per creare automaticamente nuovi progetti quando si rileva una modifica nell’ultima data di modifica per i file o le cartelle monitorati.
-
Per la sincronizzazione a livello di lavoro, configura il percorso monitorato da APC in modo che punti alla sottocartella dei lavori del progetto (ad esempio,
All projects / [project name] / [branch] / jobs). -
Per la sincronizzazione a livello di progetto, configura il percorso monitorato da APC in modo che punti solo al progetto e al ramo, senza la sottocartella jobs (ad esempio,
All projects / [project name] / [branch]). Usa il monitoraggio pianificato anziché quello basato su webhook: la sincronizzazione a livello di progetto non avvia un lavoro Strings, quindi l'evento webhookjobs:startnon si attiva. -
Per le sincronizzazioni a livello di lavoro, APC viene attivato dai seguenti aggiornamenti dei lavori:
-
Chiavi aggiunte di recente o modifiche a chiavi esistenti
-
Data di scadenza del lavoro modificata in Strings
Nota
La riapertura dei lavori non conta come un aggiornamento per APC.
-
-
Per le sincronizzazioni a livello di progetto, APC viene attivato da:
-
Chiavi appena aggiunte
-
Modifiche alle chiavi esistenti
-
-
Se l’opzione è selezionata durante l’impostazione di APC, l’archivio online remoto può essere monitorato non solo per gli aggiornamenti dell’origine, ma anche della destinazione.
Se si sceglie di monitorare gli aggiornamenti della destinazione, qualsiasi modifica apportata alla copia di destinazione nell'archivio online aggiornerà automaticamente la memoria di traduzione in Phrase TMS.
-
Se gli , le modifiche principali al testo nella lingua di destinazione di Strings vengono automaticamente implementate nelle memorie di traduzione di TMS utilizzate nel pertinente progetto APC.
-
-
L'API del connettore di TMS può essere utilizzata per automatizzare i passaggi che verrebbero altrimenti eseguiti manualmente tramite l'interfaccia utente. I webhook possono essere utilizzati per inviare notifiche a sistemi di terze parti in merito a determinati eventi (ad esempio, una modifica dello stato lavoro). I webhook possono essere attivati per l'evento
jobs:startper le sincronizzazioni a livello di lavoro.
La pagina offre una panoramica di tutte le configurazioni di sincronizzazione dei lavori (APC) che usano il connettore Phrase Strings. Include sia le sincronizzazioni create direttamente in Strings che quelle configurate in TMS, con le relative informazioni.
Nella pagina , gli utenti con ruolo di amministratore o project manager in Strings possono configurare nuove sincronizzazioni dei lavori, modificare quelle esistenti (anche attivandole o disattivandole) oppure eliminarle.
Puoi modificare o eliminare le sincronizzazioni dei lavori esistenti usando le opzioni del menu . Tutte le modifiche vengono sincronizzate tra Strings e TMS. L'eliminazione di una sincronizzazione dei lavori rimuove la regola APC corrispondente in TMS.
Puoi accedere alla pagina dai menu e nella barra di navigazione a sinistra.
Nota
Se in TMS sono definiti campi personalizzati obbligatori, non puoi configurare una sincronizzazione dei lavori da Strings.
Per configurare una nuova sincronizzazione dei lavori tra Strings e TMS con le impostazioni di base, segui questi passaggi nell'interfaccia di Strings:
-
Nella pagina , seleziona Configure accanto all'integrazione .
Viene visualizzata la pagina .
-
Fai clic su + New Job Sync.
Viene visualizzata la finestra .
-
Inserisci un nome nel campo e seleziona i progetti Strings da collegare a TMS dal menu a discesa .
È possibile includere solo progetti con le stesse combinazioni linguistiche.
-
Se vuoi, seleziona il da utilizzare. Il modello di progetto TMS selezionato deve corrispondere al set di lingue definito nei progetti Strings assegnati.
I job sincronizzati verranno aggiunti al progetto TMS creato dal modello selezionato.
-
Se è selezionato , viene creato automaticamente un modello di progetto TMS basato sui progetti Strings selezionati.
-
-
Seleziona il tipo di progetto da creare in TMS nel campo .
-
Opzione predefinita.
-
Un nuovo progetto TMS viene creato ogni volta che vengono rilevate modifiche nei job di Strings.
-
-
Nella sezione , specifica le impostazioni di esportazione di Strings per controllare come vengono esportate in Strings le traduzioni provenienti da TMS.
-
Aggiorna le traduzioni di destinazione esistenti in Strings.
-
Contrassegna automaticamente il job come completato in Strings.
-
Le chiavi contrassegnate come non verificate verranno automaticamente verificate in Strings in caso di traduzioni di destinazione invariate.
-
-
Se necessario, fai clic su Advanced options per visualizzare ulteriori opzioni di esportazione.
-
Contrassegna un locale specifico come completato dopo averne sincronizzato le traduzioni.
-
Assicura che le nuove chiavi da TMS vengano create in Strings e che quelle esistenti vengano aggiornate.
-
Impedisce la sovrascrittura delle traduzioni se il testo sorgente è cambiato in Strings dopo l'esportazione.
-
-
Fai clic su Salva.
La nuova configurazione di sincronizzazione dei job viene aggiunta all'elenco con stato inattivo. Usa l'interruttore nella colonna per abilitare la sincronizzazione dei job.
Consiglio
Per configurazioni più avanzate, imposta il connettore utilizzando le impostazioni di Phrase TMS.
Se utilizzi una mappatura personalizzata, apporta eventuali modifiche al connettore in TMS.
La creazione del connettore Strings in Phrase TMS non crea automaticamente APC per l'importazione e l'esportazione automatizzate dei job. L'APC deve essere configurato separatamente in TMS.
Alcune organizzazioni hanno già un connettore Phrase Strings creato automaticamente, utilizzando l'identità della piattaforma Phrase dell'organizzazione. Controlla l'elenco dei connettori nella pagina prima di crearne uno manualmente. Il connettore creato automaticamente si autentica lato server utilizzando l'identità dell'utente connesso, non un token di accesso inserito manualmente.
Il connettore mostra lo stato mentre completa la sincronizzazione iniziale dopo la creazione, quindi passa allo stato . Lo stato viene attivato anche ogni volta che viene apportata una modifica alla configurazione del connettore o quando viene salvata la pagina delle impostazioni del connettore, anche senza modifiche significative. Quando un connettore è nello stato , non può essere utilizzato come origine per creare job in Phrase TMS. Attendi che lo stato passi a prima di creare job con quel connettore.
-
Dalla pagina Impostazioni
, scorri verso il basso fino alla sezione .
-
Fai clic su Connettori.
Si apre la pagina .
-
Fai clic su New connector.
Si apre la pagina .
-
Imposta Type su e fornisci un nome per il connettore.
-
Inserisci l'ID account e il token di accesso ottenuti da Strings.
-
Fai clic su Test connessione.
-
Se l'operazione ha esito positivo, viene visualizzato un piccolo segno di spunta accanto al pulsante .
-
-
Seleziona gli elementi da importare in TMS.
Se le chiavi di destinazione non vengono importate, il file XLIFF 2.0 può essere ulteriormente segmentato se selezioni Segment XLIFF nelle per i file XLIFF 2.0.
-
Abilita o disabilita le opzioni di importazione avanzate secondo le tue esigenze:
-
La lingua sorgente del progetto TMS viene applicata indipendentemente dalla lingua predefinita nel progetto Strings.
-
Abilita questa opzione per evitare di creare job TMS duplicati per i locale per i quali sono già in corso altri job. Quando questa opzione è abilitata, le modifiche alle chiavi già incluse in un job TMS attivo non vengono reimportate finché il job originale non è completato. Consigliato per un maggiore controllo sui lavori in diverse lingue.
-
-
L'opzione assicura che le entità HTML siano avvolte in CDATA per essere conservate durante il trasferimento tra Strings e TMS.
-
L'opzione consente di importare contenuti combinando sintassi ICU ed elementi HTML in linea.
-
-
-
-
Seleziona una modalità di esportazione.
-
Abilita o disabilita le seguenti opzioni di esportazione secondo le tue esigenze:
-
Disabilita questa opzione per evitare che le traduzioni esistenti vengano aggiornate con il contenuto del file.
-
Disabilita questa opzione per impedire la creazione di nuove chiavi e l'aggiornamento di quelle esistenti.
-
Le traduzioni non allineate al contenuto sorgente più recente vengono escluse durante la sincronizzazione. Ciò contribuisce a mantenere la coerenza tra il testo sorgente e le traduzioni, evitando traduzioni non aggiornate o errate.
-
Le chiavi contrassegnate come verranno automaticamente verificate in Strings se le traduzioni di destinazione sono rimaste invariate. Quando abilitata, ogni traduzione restituita da TMS viene contrassegnata come in Strings, indipendentemente dal fatto che il testo sia stato modificato o semplicemente restituito invariato. Solo le chiavi il cui testo sorgente è stato modificato in Strings mentre il job era in corso vengono escluse e rimangono .
-
Contrassegna un locale specifico come completato dopo averne sincronizzato le traduzioni.
-
Se questa opzione è selezionata, il job viene contrassegnato come completato solo dopo il caricamento dell'ultimo locale.
-
-
-
Se necessario, seleziona una cartella predefinita: puoi farlo solo dopo aver salvato.
-
La viene presentata e può essere personalizzata, se necessario. Assicurati che, nella configurazione del connettore, ogni locale di Strings abbia una sola voce di mappatura verso un unico locale TMS. Le modifiche nella mappatura della lingua non influiranno sui lavori esistenti.
L'elenco mostra cinque progetti per pagina, ordinati alfabeticamente: prima da A a Z (maiuscole) e poi da a a z (minuscole).
-
Fai clic su Salva.
Il connettore viene aggiunto all'elenco nella pagina .
L’integrazione supporta:
-
Modelli di progetto di TMS
-
Flussi di lavoro di TMS
-
briefing del job (non applicabile quando si utilizza la sincronizzazione a livello di progetto)
-
due date del job (non applicabile quando si utilizza la sincronizzazione a livello di progetto)
La data di scadenza impostata in Strings aggiornerà la scadenza del progetto in TMS. Se ci sono più scadenze, al progetto TMS verrà applicata quella più lontana nel tempo.
Trasferimento da Strings a TMS come riferimento del progetto:
-
Nomi delle chiavi
Trasferimento da Strings e visualizzazione come chiave di contesto nel pannello Nota di contesto di TMS CAT Editor.
-
Descrizioni delle chiavi
Trasferimento da Strings e visualizzazione come nota di contesto nel pannello Nota di contesto di TMS CAT Editor.
-
Lunghezza massima in caratteri delle chiavi
Trasferimento da Strings e visualizzazione nel pannello Nota di contesto di TMS CAT Editor.
-
Screenshot
Per visualizzare gli screenshot di Strings nel riquadro degli editor CAT di TMS:
-
Abilita l'opzione nella sezione Access and Security delle impostazioni del progetto TMS.
-
Seleziona il formato di testo nel riquadro .
-
-
Metadati personalizzati nei formati di file supportati:
-
.XLSX
-
.CSV
-
.XLIFF 2.0
-
Per monitorare gli aggiornamenti del testo di destinazione effettuati in Strings tramite APC, segui i passaggi riportati di seguito:
-
Al momento della configurazione di un APC, seleziona .
Ciò consente il monitoraggio dell'archivio online per gli aggiornamenti del testo di destinazione effettuati in Strings.
-
Nella sezione della configurazione dell’APC, seleziona .
Le modifiche apportate al contenuto della lingua di destinazione in Strings vengono automaticamente salvate nella memoria di traduzione di Phrase TMS quando viene attivato il monitoraggio dell’APC.
È possibile sovrascrivere gli aggiornamenti della memoria di traduzione modificando i segmenti di destinazione in Phrase TMS editor. Questi aggiornamenti verranno riesportati in Strings quando viene completato il lavoro in Phrase TMS.
Comportamento di eliminazione delle chiavi con APC
L'eliminazione di una chiave in Strings dopo che è stata inclusa in un job non influisce su un job di Phrase TMS creato tramite un'importazione manuale una tantum. Il job rimane invariato finché non viene reimportato manualmente.
Quando il monitoraggio APC è attivo, Phrase confronta un hash del contenuto a ogni controllo periodico o attivazione tramite webhook e considera qualsiasi modifica, inclusa l'eliminazione di una chiave, un aggiornamento che avvia una nuova sincronizzazione.
-
Nella modalità , la risincronizzazione aggiorna il progetto o il job esistente in Phrase TMS in base ai contenuti attuali di Strings, rimuovendo dal job quelli della chiave eliminata.
-
Nella modalità , la risincronizzazione crea una nuova versione del job in Phrase TMS con i contenuti aggiornati dopo l'eliminazione, mentre le versioni create in precedenza rimangono invariate.
La seguente tabella delinea i problemi comuni che gli utenti possono riscontrare durante l'utilizzo dell'integrazione Strings. Fornisce possibili cause e soluzioni per la risoluzione dei problemi.
|
Problema |
Causa |
Soluzione |
|---|---|---|
|
Messaggio di avviso relativo a |
I nomi delle chiavi contengono caratteri indesiderati (ad es. spazi) |
Nonostante il messaggio di avviso, gli utenti possono comunque gestire il contenuto di traduzione ed esportarlo in Strings. |
|
Le chiavi in TMS sono vuote |
Il lavoro contiene chiavi senza testo di origine nella lingua di origine |
Alternative:
|
|
L’APC non crea progetti o non elabora nuovi lavori |
Disallineamento dei codici della lingua |
Assicurati che i codici linguistici in Strings corrispondano a quelli del progetto in TMS. Quando l’APC è impostato come progetto continuo, eventuali modifiche apportate al modello di progetto dopo la creazione del progetto non verranno applicate ai progetti esistenti. Pertanto, le modifiche devono essere apportate direttamente ai progetti continui. |
|
L’APC considera elaborati il lavoro/le impostazioni locali |
Se modello di progetto/le impostazioni dell’APC vengono modificati dopo aver iniziato il lavoro, possono essere considerati come elaborati nella cronologia dell’APC. Potrebbe pertanto essere necessario aggiornare il lavoro per poter procedere con l’iterazione successiva. Alternative:
|
|
|
Errore |
Riduci il numero di APC e abbassa la frequenza del monitoraggio. |
|
|
Una chiave presente nel progetto Strings manca nel job TMS |
La chiave specifica non è stata aggiunta al job di Strings |
Aggiungi la chiave al job di Strings e reimporta il job dal repository online in TMS |
|
L'errore "Impossibile autenticarsi" compare quando si tenta di importare o esportare lavori. |
Token di accesso scaduto o revocato per il connettore «created by Phrase Strings» creato automaticamente |
Crea un nuovo connettore Phrase Strings in TMS, ricollega gli APC esistenti al nuovo connettore e attiva il monitor. |
|
Non è possibile trovare il job di Strings da importare o reimportare, né tramite APC né manualmente, anche se non risulta completato. |
Il lavoro era già stato importato in un progetto TMS che è stato successivamente spostato nel cestino senza essere completato o eliminato definitivamente. Poiché il progetto è tecnicamente ancora in corso, il lavoro non viene rilasciato per la reimportazione. |
Prima di procedere con altre verifiche, controlla le accanto alla lingua del job in Strings per verificare se è già stato importato in TMS. Se il progetto collegato è nel cestino, ripristinalo e continua a lavorarci. Se non ti serve, annulla i job e il progetto oppure elimina definitivamente il progetto tramite l'API usando il parametro |
|
Il salvataggio di Job Sync non riesce e viene visualizzato l'errore " |
Job Sync convalida le impostazioni locali di destinazione nel progetto Strings direttamente rispetto all'elenco delle impostazioni locali supportate nativamente da TMS al momento del salvataggio. Questa convalida non tiene conto delle mappature personalizzate delle impostazioni locali del connettore. |
Se un progetto Strings ha una lingua di destinazione non supportata nativamente da TMS, usa il connettore Strings direttamente in TMS anziché avviare l'operazione da Strings e configura una mappatura personalizzata delle lingue. |
|
Le traduzioni non vengono esportate nuovamente in Strings anche se i job mostrano uno stato consegnato in TMS. |
Nel progetto o nel modello è attiva un'impostazione di automazione dello stato che contrassegna il progetto (e i relativi job) come completato/consegnato non appena tutti i job sono stati pretradotti, anziché quando vengono consegnati. Questo porta i job allo stato «consegnato» senza eseguire l'esportazione verso Strings. Di conseguenza, il servizio di automazione non programma l'esportazione e le traduzioni non vengono inviate a Strings. |
Nelle impostazioni Automazione dello stato del progetto del modello di progetto, imposta l'opzione anziché su . Per i job creati manualmente, esporta il job in Strings e impostane lo stato su consegnato: l'esportazione manuale non aggiorna automaticamente lo stato. Quando tutti i job del progetto sono nello stato consegnato, il progetto viene automaticamente contrassegnato come completato. |