Konektor Phrase Strings (synchronizace zakázek)

Obsah je strojově přeložen z angličtiny s použitím Phrase Language AI.

Integrace Phrase Strings (v rozhraní Strings nazývaná Job Sync) propojuje Phrase TMS a Phrase Strings. Integrace podporuje synchronizaci na úrovni zakázek i na úrovni projektů.

Synchronizace zakázek

Zakázky vytvořené a zahájené ve Strings ve stavu Probíhá lze importovat do TMS k překladu a po překladu odeslat zpět do Strings.

Doporučeno pro dávkové pracovní postupy s podrobným řízením.
Synchronizace na úrovni projektu

Všechny klíče ve vybraném projektu Strings jsou přeneseny do TMS, aniž by bylo nutné vytvářet zakázku. Nově přidané nebo aktualizované klíče se automaticky zpřístupní pro synchronizaci.

Doporučeno pro průběžné lokalizační pracovní postupy.

Předpoklady

Přístup k aplikacím TMS i Strings
Jazykové kódy použité v projektu TMS se musí shodovat s kódy národního prostředí v zakázce Strings.
Výchozí jazyk projektu Strings musí být stejný jako zdrojový jazyk definovaný v projektu TMS.

Důležité

Soubory Figma lze ve Strings zobrazit jako celé živé soubory, TMS však tuto funkci nepodporuje. Editor TMS CAT dokáže zobrazit přeložený obsah v konkrétním rámečku Figma pouze ve formátu SVG.

Ve výchozím nastavení se obsah odeslaný ze Strings do TMS importuje jako soubory XLIFF 2.0. Při použití APC musí být Typ souboru v nastavení importu souborů šablony projektu TMS nastaven na XLIFF 2.0 nebo Automaticky detekovat.

Stavy překladu klíčů ve Strings nejsou podporovány. Job Sync odešle cílový text aktuálně uložený ve Strings do TMS bez ohledu na to, zda je klíč ověřený, nebo neověřený. Klíče, které jsou před importem do TMS ve Strings označeny jako neověřené, mohou být v případě nezměněných cílových překladů vráceny do Strings jako ověřené.

Funkce Job Sync nepoužívá nastavení projektu Strings Použít záložní překlad pro neověřené překlady. K nahrazení záložním textem nedochází ani v jednom směru mezi Strings a TMS, takže text záložní lokalizace nenahrazuje neověřené překlady.

Počet segmentů vytvořených v TMS po importu zakázky Strings se může lišit od původního počtu klíčů v těchto případech:

Klíče jsou ve Strings označené jako vyloučené. Vyloučené klíče se neimportují.
Při vytváření zakázky v TMS byla v nastavení importu souboru pro XLIFF 2.0 povolena možnost Segment XLIFF. V tom případě může být počet segmentů vyšší než počet klíčů ve Strings.

Klíče Strings mohou obsahovat HTML entity. Při nastavování konektoru v TMS povolte volbu Uzavřít HTML obsah do CDATA, aby se zachovaly entity HTML a v TMS se místo nich nezobrazovaly odpovídající znaky.

Úvodní a koncové mezery přítomné ve zdrojovém textu klíče Strings se v editoru TMS CAT nezobrazují. Tyto mezery jsou zachovány ve skeletu a při synchronizaci zakázky zpět do Strings jsou znovu vloženy do zdrojového i cílového textu. To může ovlivnit validace limitu znaků nakonfigurované ve Strings, protože počet mezer není během překladu v editoru TMS zohledněn.

Pomocí konektoru lze v APC sledovat více projektů a souborů. Každý projekt vyžaduje individuální monitorování v rámci jednoho APC.

Když APC zpracovává spouštěč Job Sync, vytvoří v TMS jednu zakázku pro každou lokalizaci Strings. Pořadí importu těchto zakázek není zaručeno a nelze jej konfigurovat prostřednictvím šablony projektu přiřazené k pravidlu APC. V žádné fázi tohoto procesu není aplikován žádný mechanismus řazení. Chcete-li použít odlišné zpracování pro jednotlivé skupiny lokalizací, nakonfigurujte samostatná pravidla APC, z nichž každé odkazuje na jinou šablonu projektu.

Konektor používá anotace lokalizací zakázek k připojení metadat o odpovídajícím projektu Phrase TMS k zakázkám a lokalizacím zakázek ve Strings. Koncový bod API Phrase Strings pro výpis anotací lokalizací zakázek tato metadata načítá. Koncový bod pro výpis cílových lokalizací zakázek tato metadata zahrnuje také, pokud je parametr include_annotations nastaven na true. Anotované zakázky obsahují pole jako tms_project_id a tms_in_progress, která umožňují sledovat stav zakázky Strings v propojeném projektu Phrase TMS.

TMS nepodporuje použití stejné lokalizace pro zdrojový i cílový jazyk v projektu. Pokud například zakázka Strings používá en-US jako zdrojový i cílový jazyk, cílovou lokalizaci en-US nelze do TMS importovat a celou zakázku nelze označit jako dokončenou. Při vytváření zakázek ve Strings, které budou synchronizovány do TMS, nevybírejte zdrojovou lokalizaci jako cílovou lokalizaci.

Zprávy ICU a plurálové tvary CLDR

Při odesílání zakázek Strings obsahujících zprávy ICU nebo plurálové tvary do TMS k překladu povolte v nastavení importu souboru XLIFF 2.0 nebo v šablonách projektů TMS volbu Parsovat zprávy ICU.

Příklady použití

Konektor lze použít v několika případech:

Projektoví manažeři TMS mohou přidat soubory přímo do projektů TMS z online úložiště.
Nastavte portál zadavatele Phrase TMS tak, aby zadavatelé mohli přidat soubory k požadavkům přímo z Phrase Strings.
Použijte automatizované vytváření projektů (APC) TMS k automatickému vytváření nových projektů, jakmile se u sledovaných souborů nebo složky změní datum poslední změny.
- Pro synchronizaci na úrovni zakázek nakonfigurujte sledované umístění APC tak, aby odkazovalo na podsložku zakázek projektu (například All projects / [project name] / [branch] / jobs)).
- Pro synchronizaci na úrovni projektu nakonfigurujte sledované umístění APC tak, aby odkazovalo pouze na cestu k projektu a větvi, bez podsložky jobs (například All projects / [project name] / [branch]). Použijte monitorování založené na plánu namísto monitorování založeného na webhooku, protože synchronizace na úrovni projektu nespouští zakázku Strings a událost webhooku jobs:start se nikdy neaktivuje.
- U synchronizací zakázek se APC spouští následujícími aktualizacemi zakázek:
  - Nově přidané klíče nebo změny stávajících klíčů
  - Změna termín dodání zakázky ve Strings
  Poznámka
  
  Znovuotevřením zakázek se pro APC neaktualizuje.
- U synchronizací na úrovni projektu se APC spouští:
  - Nově přidané klíče
  - Změny stávajících klíčů
- Pokud je při nastavení APC vybrána možnost Vytvořit nový projekt, lze vzdálené online úložiště sledovat nejen z hlediska aktualizace zdroje, ale také cíle.
  
  Pokud se rozhodnete sledovat aktualizace cíle, všechny změny provedené v cílové kopii v online úložiště automaticky aktualizují překladovou paměť v Phrase TMS.
- Pokud je vybrána možnost Aktualizace cíle provedené ve vzdáleném subjektu se automatiky uloží do TM, změny textu klíčů v jazyce cíle Strings se automaticky aktualizují v překladových pamětech TMS použitých v příslušném projektu APC.
API konektoru v TMS lze použít k automatizaci kroků jinak prováděných ručně prostřednictvím uživatelského rozhraní. Pomocí webhooků mohou být systémy třetích stran informovány o určitých událostech (například když se změní stav zakázky). Webhooky lze aktivovat pro událost jobs:start u synchronizací na úrovni zakázky.

Stránka synchronizací zakázek

Stránka Job Syncs poskytuje centralizovaný přehled všech nastavení synchronizace zakázek (APC), která využívají konektor Phrase Strings. Zahrnuje jak synchronizace vytvořené přímo ve Strings, tak ty nakonfigurované v TMS, včetně příslušných informací.

Na stránce Job Syncs mohou uživatelé s rolí Administrator nebo Project Manager ve Strings konfigurovat nové synchronizace zakázek, upravovat stávající synchronizace zakázek (včetně jejich aktivního či neaktivního stavu) nebo je mazat.

Stávající synchronizace zakázek lze upravit nebo smazat pomocí příslušných možností v nabídce More More Menu . Všechny změny jsou synchronizovány mezi Strings a TMS. Smazání synchronizace zakázky odstraní odpovídající APC v TMS.

Stránka Job Syncs je přístupná z levé navigační nabídky Integrations i Jobs.

Konfigurace synchronizací zakázek ve Strings

Poznámka

Pokud jsou v TMS definována povinná vlastní pole, nastavení synchronizace zakázek ze Strings není podporováno.

Chcete-li nastavit novou synchronizaci zakázek mezi Strings a TMS se základní konfigurací, postupujte v uživatelském rozhraní Strings podle těchto kroků:

Na stránce Integrations vyberte Configure vedle integrace Job Sync.

Zobrazí se stránka Job Syncs.
Klikněte na + New Job Sync.

Zobrazí se okno Create new Job Sync.
Zadejte Sync Name a z rozbalovací nabídky Assigned Strings projects vyberte jeden nebo více projektů Strings, které se mají propojit s TMS.

Zahrnout lze pouze projekty se stejnými jazykovými kombinacemi.
Volitelně vyberte TMS project template, kterou chcete použít. Vybraná šablona projektu TMS musí odpovídat sadě jazyků definované v přiřazených projektech Strings.

Synchronizované zakázky budou přidány do projektu TMS vytvořeného z vybrané šablony.
- Pokud je vybrána možnost Default, šablona projektu TMS se automaticky vytvoří na základě vybraných projektů Strings.
Vyberte Type projektu, který se má v TMS vytvořit.
- Continuous project
  
  Výchozí možnost.
- Nový projekt
  
  Pokaždé, když jsou v zakázkách Strings zjištěny změny, vytvoří se nový projekt TMS.
V části Export back to Strings určete nastavení exportu do Strings, která řídí, jak se překlady z TMS exportují zpět do Strings.
- Přepsat existující překlady
  
  Aktualizuje stávající cílové překlady ve Strings.
- Označit zakázku jako dokončenou
  
  Automaticky označí zakázku ve Strings jako dokončenou.
- Ověřit nezměněné překlady ve Strings
  
  Klíče označené jako neověřené budou ve Strings automaticky ověřeny, pokud se cílové překlady nezměnily.
V případě potřeby klikněte na Advanced options a zobrazte další možnosti exportu.
- Označit jazyk jako dokončený
  
  Označí konkrétní jazykovou verzi jako dokončenou, jakmile se její překlady synchronizují zpět.
- Vytvořit nové a aktualizovat existující klíče
  
  Zajišťuje, že nové klíče z TMS jsou vytvořeny ve Strings a stávající jsou aktualizovány.
- Použít překlad jen v případě, že je zdroj totožný s uloženou verzí
  
  Zabraňuje přepsání překladů, pokud se zdrojový text ve Strings od exportu změnil.
Klikněte na Uložit.

Nová konfigurace synchronizace zakázek se přidá do seznamu TMS Job Syncs v neaktivním stavu. Pomocí přepínače ve sloupci Active povolte synchronizaci zakázek.

Tip

Pro pokročilejší konfigurace nastavte konektor pomocí nastavení Phrase TMS.

Pokud se používá vlastní mapování, je nutné případné změny provést v konfiguraci konektoru v TMS.

Vytvoření konektoru Strings v Phrase TMS automaticky nevytvoří APC pro automatizovaný import a export zakázek. APC musí být v TMS nakonfigurováno samostatně.

Nastavení Phrase TMS

Některé organizace již mají konektor Phrase Strings vytvořený automaticky pomocí identity organizace na platformě Phrase. Před ručním vytvořením konektoru zkontrolujte seznam konektorů na stránce Connectors. Automaticky vytvořený konektor se ověřuje na straně serveru pomocí identity přihlášeného uživatele, nikoli pomocí ručně zadaného přístupového tokenu.

Po vytvoření zobrazuje konektor během počáteční synchronizace stav Pending. Po jejím dokončení se jeho stav změní na Active. Konektor přejde do stavu Pending také při každé změně jeho konfigurace nebo při uložení stránky s jeho nastavením, a to i bez podstatných změn. Dokud konektor zobrazuje stav Pending, nelze jej v Phrase TMS použít jako zdroj pro vytváření zakázek. Než pomocí tohoto konektoru vytvoříte zakázky, počkejte, až se jeho stav změní na Active.

Na stránce Nastavení přejděte dolů do oddílu Integrace.
Klikněte na Konektory.

Otevře se stránka Konektory.
Klikněte na New connector.

Otevře se stránka Create connector.
Změňte Type na Phrase Strings a zadejte název konektoru.
Zadejte ID účtu a access token získaný ze Strings.
Klikněte na Zkouška spojení.
- Pokud je operace úspěšná, vedle tlačítka Test connection se zobrazí malé zaškrtnutí.
Vyberte položky k importu do TMS.

Pokud se cílové klíče neimportují, lze soubor XLIFF 2.0 dále segmentovat, je-li v nastavení File import settings pro soubory XLIFF 2.0 vybrána možnost Segment XLIFF.
- Podle potřeby povolte nebo zakažte pokročilé možnosti importu:
  - Při importu použijte zdrojový jazyk projektu TMS.
    
    Zdrojový jazyk projektu TMS se použije bez ohledu na výchozí jazyk v projektu Strings.
  - Vytvořit zakázku v TMS pro každý jazyk
    
    Povolte tuto možnost, abyste zabránili vytváření duplicitních zakázek v TMS pro jazykové verze, které se již zpracovávají. Pokud je tato možnost povolena, změny klíčů, které jsou již součástí aktivní zakázky v TMS, se znovu neimportují, dokud není původní zakázka dokončena. Doporučeno pro lepší kontrolu nad zakázkami s více jazyky.
  - Vložit HTML obsah do CDATA
    
    Tato možnost zajistí zachování HTML entit v CDATA při přenosu mezi Strings a TMS.
    
    Tato možnost umožňuje import obsahu kombinujícího syntaxi ICU a inline HTML elementy.
Vyberte režim stáhnout.
- Podle potřeby povolte nebo zakažte následující možnosti exportu:
  - Přepsat překlady
    
    Tuto možnost zakažte, pokud nechcete, aby se stávající překlady aktualizovaly obsahem souboru.
  - Vytvořit nové klíče nebo je aktualizovat
    
    Tuto možnost zakažte, pokud nechcete vytvářet nové klíče ani aktualizovat stávající.
  - Použít překlad pouze v případě, že zdroj odpovídá
    
    Překlady, které neodpovídají nejnovějšímu zdrojovému obsahu, jsou během synchronizace vyloučeny. To pomáhá udržovat konzistenci mezi zdrojovým textem a překlady a předcházet zastaralým nebo nesprávným překladům.
  - Ověřte jen v případě, že se překlad nezměnil.
    
    Klíče označené jako neověřené budou v systému Strings automaticky ověřeny v případě nezměněných cílových překladů. Pokud je tato možnost povolena, každý překlad vrácený ze systému TMS je v systému Strings označen jako ověřený, bez ohledu na to, zda byl text upraven nebo pouze vrácen beze změny. Vyloučeny jsou pouze klíče, jejichž zdrojový text se v systému Strings změnil v době, kdy byla zakázka otevřená, a ty zůstávají neověřené.
  - Označit jazyk jako dokončený
    
    Označí konkrétní jazykovou verzi jako dokončenou, jakmile jsou její překlady synchronizovány zpět.
  - Označit zakázku jako dokončenou
    
    Pokud je tato možnost vybrána, bude zakázka označena jako dokončená až po nahrání poslední jazykové verze.
Pokud je zadána, vyberte výchozí složku (možné pouze po uložení).
Ukáže se Mapování jazyků a lze ho v případě potřeby přizpůsobit. Zajistěte, aby každá jazyková verze ve Strings měla v konfiguraci konektoru pouze jeden záznam mapování na jednu jazykovou verzi v TMS. Změny v mapování jazyků neovlivní stávající zakázky.

Seznam se stránkuje po pěti projektech a projekty jsou řazeny abecedně; nejprve od A–Z (velká písmena) a poté od a–z (malá písmena).
Klikněte na Uložit.

Konektor je přidán do seznamu na stránce Konektory.

Integrace podporuje:

Šablony projektu TMS
Pracovní postupy TMS
Zadání zakázky (nelze použít při synchronizaci na úrovni projektu)
Termín dokončení zakázky (nelze použít při synchronizaci na úrovni projektu)

Termín dodání zadaný ve Strings aktualizuje termín dodání projektu v TMS. Pokud je termínů více, použije se na projekt TMS ten nejvzdálenější.

Převádí se ze Strings do TMS jako reference projektu:

Názvy klíčů

Převádí se ze Strings a zobrazují se jako kontextový klíč v podokně Kontextových poznámek TMS CAT editorů.

Popisy klíčů

Převádí se ze Strings a zobrazuje se jako kontextová poznámka v podokně Kontextových poznámek CAT editorů TMS.

Max. délka znaku klíče

Převádí se ze Strings a zobrazují se v podokně Kontextových poznámek CAT editorů TMS.

Snímky obrazovky

Chcete-li zobrazit snímky obrazovky ze Strings v podokně Context note editorů TMS CAT:
- V nastavení projektu TMS povolte v části Access and Security možnost Allow loading of external content in Phrase CAT editor.
- V podokně Context note vyberte textový formát Rich.
Vlastní metadata v podporovaných formátech souborů:
- .XLSX
- .CSV
- .XLIFF 2.0

Sledování úprav cíle provedených ve Strings prostřednictvím APC

Chcete-li sledovat aktualizace cíle provedené ve Strings pomocí APC, postupujte takto:

Při nastavení APC vyberte vždy vytvořit nový projekt.

To umožňuje sledovat online úložiště pro aktualizace cíle provedené ve Strings.
V části Automatizace v nastavení APC vyberte Aktualizace cíle provedené ve vzdáleném subjektu se automaticky uloží do TM.

Změny obsahu cílového jazyka ve Strings se po spuštění sledování APC automaticky uloží do překladové paměti Phrase TMS.

Aktualizaci překladové paměti je možné přepsat úpravou cílových segmentů v editoru Phrase TMS. Po dokončení zakázky Phrase TMS budou tyto aktualizace exportovány zpět do Strings.

Chování APC při odstranění klíče

Odstranění klíče ve Strings poté, co byl zahrnut do zakázky, nemá vliv na zakázku Phrase TMS vytvořenou jednorázovým ručním importem. Tato úloha zůstává nezměněna, dokud není ručně znovu importována.

Když je monitorování APC aktivní, Phrase porovnává hash obsahu při každém dotazování nebo spuštění webhooku a jakoukoli změnu, včetně odstranění klíče, považuje za aktualizaci, která spustí resynchronizaci.

V režimu průběžného projektu resynchronizace aktualizuje stávající projekt nebo úlohu Phrase TMS tak, aby odpovídaly aktuálnímu obsahu ve Strings, takže obsah odstraněného klíče je z této úlohy odebrán.
V režimu pokaždé vytvořit nový projekt resynchronizace vytvoří novou verzi úlohy Phrase TMS odrážející obsah po odstranění, zatímco dříve vytvořené verze této úlohy zůstávají nezměněny.

Řešení problémů se synchronizací zakázek

Následující tabulka uvádí běžné problémy, se kterými se uživatelé mohou při používání integrace se Strings setkat. Uvádí možné příčiny a řešení potíží.

Problém	Příčina(y)	Řešení
Varování týkající se `NMTOKEN` v zakázkách TMS	Názvy klíčů obsahují nežádoucí znaky (např. mezery)	Překladový obsah můžou uživatelé i přes varování exportovat zpět do Strings.
Klíče v TMS jsou prázdné	Zakázka obsahuje klíče bez zdrojového textu ve zdrojovém jazyce	Buď: Ignorujte segmenty. Odeberte klíče ze zakázky Strings a znovu importujte zdroj z online úložiště.
APC nevytváří projekty/nezpracovává nové zakázky	Neshoda kódů jazyků	Zkontrolujte shodu kódů jazyků ve Strings s kódy jazyků v projektu TMS. Pokud je APC nastaveno jako průběžný projekt, všechny změny provedené v šabloně projektu po vytvoření projektu se nepropíšou do stávajících projektů. Změny je proto třeba provádět přímo v průběžných projektech.
	APC považuje zakázku/kód jazyka za zpracovanou	Pokud dojde po zahájení zakázky ke změně nastavení šablony/APC projektu, lze zakázku v historii APC považovat za zpracovanou. Proto může být nutné zakázku aktualizovat, aby postoupila k další práci. Buď: Přidejte do zakázky nový klíč nebo aktualizujte stávající klíč zakázky Změňte termín dodání zakázky ve Strings
	Chyba `429 Příliš mnoho požadavků` (limit Strings API)	Snižte počet APC a snižte frekvenci sledování.
Stávající klíč v projektu Strings v úloze TMS chybí	Konkrétní klíč nebyl přidán do úlohy Strings	Přidejte klíč do úlohy Strings a znovu importujte úlohu z online úložiště v TMS
Při pokusu o import nebo export úloh se zobrazí chyba „Could not authenticate“ (Nelze ověřit).	Platnost přístupového tokenu u automaticky vytvořeného konektoru „created by Phrase Strings“ vypršela nebo byl token odvolán	Vytvořte v TMS nový konektor Phrase Strings, znovu propojte stávající APC s novým konektorem a spusťte monitorování.
Úlohu Strings nelze najít k importu ani opětovnému importu prostřednictvím APC ani ručně, přestože není označena jako dokončená.	Úloha již byla importována do projektu TMS, který byl později přesunut do koše, aniž by byl dokončen nebo vymazán. Protože je projekt technicky stále rozpracovaný, úloha není uvolněna pro opětovný import.	Před dalším řešením potíží zkontrolujte Anotace úlohy vedle jejího národního prostředí ve Strings, abyste ověřili, zda již byla importována do TMS. Pokud se propojený projekt nachází v koši, buď jej obnovte a pokračujte v práci přímo na něm, nebo pokud projekt není potřeba, zrušte úlohy a projekt, případně projekt trvale odstraňte přes API pomocí parametru `purge=true`, aby jej APC již nepovažovalo za aktivní verzi.
Uložení synchronizace úlohy selže s chybou „`Locales are not supported by Phrase TMS: x`“ (Národní prostředí nejsou podporována systémem Phrase TMS: x), i když má konektor TMS nakonfigurované vlastní mapování národního prostředí.	Synchronizace úlohy ověřuje cílová národní prostředí v projektu Strings přímo oproti seznamu národních prostředí nativně podporovaných systémem TMS v době uložení. Toto ověření nezohledňuje vlastní mapování národního prostředí konektoru.	U projektu Strings s cílovým národním prostředím, které není nativně podporováno systémem TMS, použijte konektor Strings přímo v TMS, nikoli ze Strings, a nakonfigurujte vlastní mapování jazyků.
Překlady nejsou exportovány zpět do Strings, i když úlohy vykazují v TMS stav doručeno.	Projekt nebo šablona má nastavení automatizace stavu projektu, které označí projekt (a jeho úlohy) jako dokončený/doručený, jakmile jsou všechny úlohy předpřeloženy, a nikoli až po jejich doručení. To vynutí stav doručeno u úloh bez provedení kroku exportu do Strings, takže automatizační služba nikdy nenaplánuje export a do Strings nejsou odeslány žádné překlady.	V nastavení Automatizace stavu projektu šablony projektu nastavte u možnosti Označit projekt jako „dokončený“, jakmile jsou všechny úlohy hodnotu „doručeny ve všech krocích pracovního postupu“ namísto „dokončeny ve všech krocích pracovního postupu“. U ručně vytvořených úloh exportujte úlohu ručně zpět do Strings a ručně změňte stav úlohy na doručeno, protože ruční exporty neaktualizují stav úlohy automaticky. Jakmile jsou všechny úlohy v projektu nastaveny na doručeno, projekt je automaticky označen jako dokončený.