L'integrazione Phrase Strings (chiamata 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 lavoro creati e avviati in Strings con stato In avanzamento possono essere importati in TMS per la traduzione e rimandati a Strings dopo la traduzione. Per impostazione predefinita, i lavoro inviati da Strings a TMS vengono importati come file XLIFF 2.0.
Consigliato per flussi di lavoro basati su batch con controllo granulare.
-
Sincronizzazione a livello di progetto
Tutte le chiave in un progetto Strings selezionato vengono trasferite a TMS, senza richiedere la creazione di un lavoro. Le chiave appena aggiunte o aggiornate diventano disponibili per la sincronizzazione automaticamente.
Consigliato per flussi di lavoro di localizzazione continua.
Prerequisiti
-
È necessario accedere sia alle applicazioni TMS che Strings
-
I codici lingua utilizzati nel progetto TMS devono corrispondere ai codici delle impostazioni locali nel lavoro Strings.
-
La lingua predefinita del progetto Strings deve essere la stessa della lingua di origine definita nel progetto TMS.
Importante
I file Figma possono essere visualizzati in Strings come un intero file live, ma non sono supportati in TMS. Il CAT Editor di TMS può visualizzare solo il contenuto tradotto in uno specifico frame Figma in formato SVG.
Gli stati di traduzione delle chiave Strings non sono supportati. Le chiave contrassegnate come in Strings prima dell'importazione in TMS possono essere restituite a Strings come in caso di traduzioni di destinazione invariate.
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 Segmento XLIFF è stata abilitata nelle impostazioni Importa file per 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 si configura 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 nel CAT Editor di TMS. Questi spazi vengono conservati nello scheletro e reinseriti sia nell'origine che nella destinazione quando il lavoro viene sincronizzato nuovamente in Strings. Ciò può influire sulle convalide del limite di carattere configurate in Strings, poiché il conteggio dello spazio non viene riflesso 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.
Il connettore utilizza le annotazioni delle impostazioni locali del lavoro per allegare metadati sul progetto Phrase TMS corrispondente ai lavori e alle impostazioni locali del lavoro di Strings. L'endpoint API di Phrase Strings per elencare le annotazioni delle impostazioni locali del lavoro recupera questi metadati. L'endpoint per elencare le impostazioni locali di destinazione del lavoro include anche 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 di Strings nel suo progetto Phrase TMS collegato.
TMS non supporta l'utilizzo della stessa impostazione locale sia come lingua di origine che di destinazione in un progetto. Ad esempio, se un lavoro di Strings utilizza en-US sia come lingua di origine che di destinazione, la destinazione en-US non può essere importata in TMS e il lavoro complessivo non può essere contrassegnato come completato. Non selezionare l'impostazione locale di origine come impostazione locale di destinazione durante la creazione di lavori in Strings che verranno sincronizzati con TMS.
Messaggi ICU e forme plurali CLDR
Quando si inviano lavori di Strings contenenti messaggi ICU o forme plurali a TMS per la traduzione, abilita l'opzione nelle impostazioni per importare 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.
-
Sia per le sincronizzazioni a livello di lavoro che a livello di progetto, il percorso del progetto monitorato deve essere selezionato fino alla cartella lavori (ad esempio spazio/progetto/principale/lavori).
-
Per i Job Sync, APC viene attivato dai seguenti aggiornamenti del lavoro:
-
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 aggiunte di recente
-
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).
La pagina fornisce una vista centralizzata di tutte le configurazioni di sincronizzazione del lavoro (APC) che utilizzano il connettore Phrase Strings. Include sia le sincronizzazioni create direttamente in Strings che quelle configurate in TMS, con le relative informazioni.
Dalla pagina , gli utenti amministratore e project manager in Strings possono configurare nuovi Job Sync, modificare i Job Sync esistenti (incluso il loro stato attivo/inattivo) o eliminarli.
I Job Sync esistenti possono essere modificati o eliminati utilizzando le opzioni pertinenti nel menu . Tutte le modifiche vengono sincronizzate tra Strings e TMS. L'eliminazione di un Job Sync rimuove il corrispondente APC in TMS.
La pagina è accessibile sia dal menu di navigazione a sinistra che da .
Nota
Se in TMS sono definiti campi Personalizzato obbligatori, non è supportato configurare un Job Sync da Strings.
Per configurare un nuovo Job Sync tra Strings e TMS con una configurazione di base, seguire questi passaggi nell'interfaccia utente di Strings:
-
Nella pagina , selezionare Configure accanto all'integrazione .
Viene visualizzata la pagina .
-
Fare clic su + New Job Sync.
Viene visualizzata la finestra .
-
Fornire un e selezionare il/i progetto/i Strings da connettere a TMS dal menu a discesa .
Possono essere inclusi solo progetti con le stesse combinazioni di lingua.
-
Facoltativamente, selezionare il di progetto TMS da usare. Il modello di progetto TMS selezionato deve avere corrispondenza con l'insieme di lingue definite nel progetto Strings assegnato.
I lavori sincronizzati verranno aggiunti al progetto TMS creato dal modello selezionato.
-
Se viene selezionato , viene creato automaticamente un modello di progetto TMS basato sui progetti Strings selezionati.
-
-
Selezionare il di progetto da creare in TMS.
-
Opzione predefinita.
-
Un nuovo progetto TMS viene creato ogni volta che vengono rilevate modifiche nei lavori Strings.
-
-
Nella sezione , specificare le impostazioni di esportare Strings per controllare come le traduzioni da TMS vengono esportate di nuovo in Strings.
-
Aggiorna le traduzioni di destinazione esistenti in Strings.
-
Contrassegna automaticamente il lavoro come completato in Strings.
-
Le chiavi contrassegnate come non verificato saranno automaticamente verificate in Strings in caso di traduzioni di destinazione invariate.
-
-
Se necessario, fare clic su Opzioni avanzate per visualizzare opzioni di esportare aggiuntive.
-
Contrassegna una specifica impostazioni locali come completata una volta che le sue traduzioni sono state sincronizzate.
-
Assicura che le nuove chiavi da TMS siano create in Strings e che quelle esistenti vengano aggiornate.
-
Impedisce la sovrascrittura delle traduzioni se il testo di origine è stato modificato in Strings dall'esportare.
-
-
Fai clic su Salva.
La nuova configurazione Job Sync viene aggiunta all'elenco con stato inattivo. Usare l'interruttore sotto la colonna per Abilita il Job Sync.
Consiglio
Per configurazioni più avanzate, configurare il connettore usando le Impostazioni Phrase TMS.
Ogni volta che viene usata una mappatura Personalizzato, se è necessaria una qualsiasi modificare, questa deve essere applicata al connettore in TMS.
Alcune organizzazioni hanno già un connettore Phrase Strings creato automaticamente, usando l'identità Phrase Platform dell'organizzazione. Controllare l'elenco connettore nella pagina prima di crearne uno manualmente. Il connettore creato automaticamente autentica lato server usando l'identità dell'utente connesso, non un token di accesso inserito manualmente.
Il connettore mostra lo stato mentre completa la sua sincronizzazione iniziale dopo la creazione, quindi cambia in . Lo stato viene attivato anche ogni volta che viene apportata una qualsiasi modificare alla configurazione del connettore o quando la pagina impostazioni del connettore viene salvata, anche senza modifiche significative. Mentre un connettore mostra , non può essere usato come origine per la creazione di lavoro in Phrase TMS. Attendere che lo stato cambi in prima di creare lavori con quel connettore.
-
Dalla pagina
Impostazioni, scorri verso il basso fino alla sezione .
-
Fai clic su Connettori.
Si apre la pagina .
-
Fare clic su Nuovo connettore.
Si apre la pagina .
-
Modificare il Tipo in e fornire un nome per il connettore.
-
Inserire l'ID account e il token di accesso ottenuti da Strings.
-
Fai clic su Test connessione.
-
Se l'operazione ha esito positivo, un piccolo segno di spunta appare accanto al Test connection.
-
-
Selezionare gli elementi da importare in TMS.
Se le chiavi di destinazione non sono importate, il file XLIFF 2.0 può essere ulteriormente segmentato se il segmento XLIFF è selezionato nelle per i file XLIFF 2.0.
-
Abilitare o disabilitare le opzioni di importazione avanzate come richiesto:
-
La lingua di origine del progetto TMS viene applicata indipendentemente dalla lingua predefinita nel progetto Strings.
-
Abilitare questa opzione per evitare la creazione di lavori TMS duplicati per le impostazioni locali già in corso. Quando abilitato, le modifiche alle chiavi già parte di un lavoro TMS attivo non vengono reimportate finché il lavoro originale non viene 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.
-
Abilitare o disabilitare le seguenti opzioni di esportazione come richiesto:
-
Disabilitare per impedire che le traduzioni esistenti vengano aggiornate con il contenuto del file.
-
Disabilitare per impedire la creazione di nuove chiavi e gli aggiornamenti a quelle esistenti.
-
Le traduzioni che non sono allineate con il contenuto di origine più recente vengono escluse durante la sincronizzazione. Ciò aiuta a mantenere la coerenza tra il testo di origine e le traduzioni, evitando traduzioni obsolete o errate.
-
Le chiavi contrassegnate come verranno automaticamente verificate in Strings in caso di traduzioni di destinazione invariate. Quando abilitato, 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 di origine è cambiato in Strings mentre il lavoro era aperto vengono escluse e rimangono .
-
Contrassegna una specifica impostazioni locali come completata una volta che le sue traduzioni sono state sincronizzate.
-
Se selezionato, il lavoro viene contrassegnato come completato solamente quando viene caricato l’ultimo file locale.
-
-
-
Se specificato, selezionare una cartella predefinita (possibile solo dopo il salvataggio).
-
La viene presentata e può essere personalizzata, se necessario. Assicurarsi che ogni impostazioni locali di Strings abbia solo una voce di mappatura verso una singola impostazioni locali di TMS nella configurazione del connettore. Le modifiche nella mappatura della lingua non influiranno sui lavori esistenti.
L'elenco impagina cinque progetti alla volta, con i progetti ordinati alfabeticamente; prima dalla A alla Z (maiuscole) e poi dalla a alla z (minuscole).
-
Fai clic su Salva.
Il connettore viene aggiunto all'elenco nella pagina .
Eliminare un connettore
Per eliminare un connettore:
-
Dalla pagina , selezionare il connettore da eliminare.
-
Fare clic su Elimina.
Si apre la finestra .
-
Digitare \"delete\" e fare clic su Elimina.
Il connettore viene eliminato e viene visualizzato l'elenco dei connettori.
Nota
Un connettore non può essere eliminato mentre è ancora collegato a lavori incompleti in un progetto, inclusi i lavori presenti nel cestino. Il tentativo di eliminare un tale connettore restituisce un errore \"Impossibile eliminare il connettore\".
Risoluzione: Aprire il progetto associato al connettore e completare o eliminare eventuali lavori rimanenti. Andare su e svuotarlo per rimuovere eventuali lavori ancora collegati al connettore. Riprovare a eliminare il connettore.
L’integrazione supporta:
-
Modelli di progetto di TMS
-
Flussi di lavoro di TMS
-
Briefing del lavoro (non applicabile quando si utilizza la sincronizzazione a livello di progetto)
-
Data di scadenza del lavoro (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 da Strings nel riquadro degli editor CAT di TMS:
-
Abilitare l'opzione nella sezione Accesso e sicurezza delle impostazioni del progetto TMS.
-
Selezionare 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 della chiave con APC
L'eliminazione di una chiave in Strings dopo che è stata inclusa in un lavoro non influisce su un lavoro di Phrase TMS creato tramite un importare manuale una tantum. Quel lavoro rimane invariato finché non viene reimportato manualmente.
Quando il monitoraggio APC è attivo, Phrase confronta un hash del contenuto a ogni polling o trigger webhook e tratta qualsiasi modificare, inclusa l'eliminazione di una chiave, come un aggiornamento che attiva una risincronizzazione.
-
Nella modalità , la risincronizzazione aggiorna il progetto o lavoro Phrase TMS esistente per corrispondere al contenuto corrente in Strings, quindi il contenuto della chiave eliminata viene rimosso da quel lavoro.
-
Nella modalità , la risincronizzazione crea una nuova versione del lavoro Phrase TMS che riflette il contenuto post-eliminazione, mentre le versioni del lavoro 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. |
|
|
La chiave esistente nel progetto Strings manca nel lavoro TMS |
La chiave specifica non è stata aggiunta al lavoro Strings |
Aggiungere la chiave al lavoro Strings e reimportare il lavoro dall'archivio online in TMS |
|
L'errore \"Could not authenticate\" appare quando si tenta di importare/esportare lavori. |
Token di access scaduto o revocato sul connettore creato automaticamente \"created by Phrase Strings\" |
Creare un nuovo connettore Phrase Strings in TMS, ricollegare gli APC esistenti al nuovo connettore e attivare il monitoraggio. |
|
Il lavoro Strings non può essere trovato per l'importazione o la reimportazione tramite APC o manualmente, anche se non viene mostrato come 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 avanzamento, il lavoro non viene rilasciato per la reimportazione. |
Controllare le del lavoro accanto alle sue impostazioni locali in Strings per verificare se è già stato importato in TMS prima di procedere con ulteriori risoluzioni dei problemi. Se il progetto collegato si trova nel cestino, ripristinare il progetto e continuare a lavorarci direttamente oppure, se il progetto non è necessario, annullare i lavori e il progetto, o eliminare definitivamente il progetto tramite l'API utilizzando il parametro |
|
Job Sync non riesce a Salva, con 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 Salva. Questa convalida non tiene conto delle mappature delle impostazioni locali del connettore Personalizzato. |
Per un progetto Strings con una impostazione locale di destinazione non supportata nativamente da TMS, usare il connettore Strings direttamente in TMS invece che da Strings e configurare la mappatura della lingua Personalizzato. |