Konektor Phrase Strings (Job Sync)

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 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. Ve výchozím nastavení jsou zakázky odeslané ze Strings do TMS importovány jako soubory XLIFF 2.0.

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ázky. Nově přidané nebo aktualizované klíče jsou automaticky zpřístupněny pro synchronizaci.

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

Předpoklady

Přístup k aplikacím TMS i Strings
Kódy jazyků použité v projektu TMS se musí shodovat s kódy jazyka 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 celek v živém náhledu, ale v TMS to není podporováno. TMS CAT editor dokáže zobrazit přeložený obsah pouze v konkrétním rámečku Figma ve formátu SVG.

Stavy překladu klíčů ve Strings nejsou podporovány. Klíče, které jsou ve Strings před importem do TMS označeny jako neověřeno, mohou být do Strings vráceny jako ověřeno v případě nezměněných cílových překladů.

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 povolena možnost Segment XLIFF v nastavení importu souboru pro XLIFF 2.0. 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 s cílem zachovat HTML entity namísto zobrazení odpovídajících znaků v TMS.

Úvodní a koncové mezery přítomné ve zdrojovém textu klíče Strings se v CAT Editoru TMS nezobrazují. Tyto mezery jsou zachovány v kostře a po synchronizaci zakázky zpět do Strings jsou znovu vloženy do zdroje i cíle. To může ovlivnit validace limitu znaků nakonfigurované ve Strings, protože počet mezer není v editoru TMS během překladu 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.

Konektor využívá anotace jazykových lokalit zakázky pro přiřazení metadat o odpovídajícím projektu Phrase TMS ke zakázkám ve Strings a jejich jazykovým nastavením. Koncový bod API Phrase Strings pro výpis anotací kódů jazyka zakázek tato metadata načítá. Koncový bod pro výpis cílových kódů jazyka zakázek také zahrnuje tato metadata, pokud je parametr include_annotations nastaven na true. Anotované zakázky obsahují pole jako tms_project_id a tms_in_progress, která umožňují sledování stavu zakázky Strings v jejím propojeném projektu Phrase TMS.

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ě projektu TMS volbu Extrahovat 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 synchronizace na úrovni zakázky i na úrovni projektu musí být cesta sledovaného projektu vybrána až ke složce zakázek (např. Space/projekt/hlavní/zakazky).
- Pro Job Syncs 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.
- Pro synchronizace 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).

Stránka synchronizace zakázek

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

Ze stránky Job Syncs mohou uživatelé s rolí správce a projektového manažera ve Strings konfigurovat nové Job Syncs, upravit stávající Job Syncs (včetně jejich stavu aktivní/neaktivní) nebo je odstranit.

Stávající Job Syncs lze upravit nebo odstranit pomocí příslušných možností v nabídce Více More Menu . Všechny změny jsou synchronizovány mezi Strings a TMS. Odstraněním Job Sync se odebere odpovídající APC v TMS.

Stránka Job Syncs je přístupná jak z levé navigační nabídky Integrace, tak Zakázky.

Konfigurovat Job Syncs ve Strings

Poznámka

Pokud jsou v TMS definována požadovaná vlastní pole, nastavení Job Sync ze Strings není podporováno.

Pro nastavení nové Job Sync se základní konfigurací mezi Strings a TMS postupujte podle těchto kroků v uživatelském rozhraní Strings:

Na stránce Integrace vyberte Konfigurovat vedle integrace Job Sync.

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

Zobrazí se okno Vytvořit nový Job Sync.
Zadejte Název synchronizace a z rozbalovací nabídky Přiřazené projekty Strings vyberte projekt(y) Strings, ke kterým se má připojit TMS.

Zahrnout lze pouze projekty se stejnými jazykovými kombinacemi.
Volitelně vyberte šablonu projektu TMS, kterou chcete použít. Vybraná šablona projektu TMS musí odpovídat sadě jazyků definovaných 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áno Default, šablona projektu TMS se automaticky vytvoří na základě vybraných projektů Strings.
Vyberte Type projektu, který chcete vytvořit v TMS.
- Průběžný projekt
  
  Výchozí možnost.
- Nový projekt
  
  Nový projekt TMS se vytvoří pokaždé, když jsou v zakázkách Strings zjištěny změny.
V sekci Exportovat zpět do Strings zadejte nastavení exportu Strings, abyste určili, 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ěřeno budou ve Strings automaticky ověřeny v případě nezměněných cílových překladů.
V případě potřeby klikněte na Pokročilé možnosti pro zobrazení dalších možností exportu.
- Označit jazyk jako dokončený
  
  Označí konkrétní jazyk jako dokončený, jakmile jsou jeho překlady synchronizovány 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 Job Syncs je přidána do seznamu TMS Job Syncs se stavem neaktivní. Použijte přepínač ve sloupci Active k povolení Job Syncs.

Tip

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

Nastavení Phrase TMS

Některé organizace již mají konektor Phrase Strings vytvořený automaticky, a to pomocí identity platformy Phrase. Před ručním vytvořením konektoru zkontrolujte seznam konektorů na stránce Connectors. Automaticky vytvořený konektor se autentizuje na straně serveru pomocí přihlášené identity, nikoli ručně zadaným tokenem pro přístup.

Konektor zobrazuje stav Pending, dokud po vytvoření nedokončí počáteční synchronizaci, poté se změní na Active. Stav Pending je také aktivován při každé změně konfigurace konektoru nebo při uložení stránky nastavení konektoru, a to i bez provedení smysluplných změn. Dokud konektor zobrazuje Pending, nelze jej použít jako zdroj pro vytvoření zakázky v Phrase TMS. Před vytvořením zakázek s tímto konektorem počkejte, až se 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 Nový konektor.

Otevře se stránka Vytvořit konektor.
Změňte Type na Phrase Strings a zadejte název pro konektor.
Zadejte ID účtu a přístupový 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 nejsou naimportovány cílové klíče, může být soubor XLIFF 2.0 dále segmentován, pokud je v nastavení importu souborů pro soubory XLIFF 2.0 vybrána možnost Segmentovat XLIFF.
- Povolte nebo zakažte pokročilé možnosti importu podle potřeby:
  - 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 TMS pro jazykové verze, které jsou již zpracovávány. Pokud je povoleno, změny klíčů, které jsou již součástí aktivní zakázky 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.
- Povolte nebo zakažte následující možnosti exportu podle potřeby:
  - Přepsat překlady
    
    Zakažte, abyste zabránili aktualizaci stávajících překladů obsahem souboru.
  - Vytvořit nové klíče nebo je aktualizovat
    
    Zakažte, abyste zabránili vytváření nových klíčů a aktualizacím stávajících klíčů.
  - Použít překlad pouze v případě, že zdroj odpovídá
    
    Překlady, které neodpovídají nejnovějšímu obsahu zdroje, 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ěřeno budou v Strings automaticky ověřeny v případě nezměněných cílových překladů.
  - Označit jazyk jako dokončený
    
    Označí konkrétní kód jazyka jako dokončený, jakmile jsou jeho překlady synchronizovány zpět.
  - Označit zakázku jako dokončenou
    
    Pokud je vybráno, bude zakázka označena jako dokončená až po nahrání posledního jazyka.
Pokud je zadáno, vyberte výchozí složku (možné až po uložení).
Ukáže se Mapování jazyků a lze ho v případě potřeby přizpůsobit. Změny v mapování jazyků neovlivní stávající zakázky.

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

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

Odstranit konektor

K odstranění konektoru:

Na stránce Integrations vyberte konektor, který chcete odstranit.
Klikněte na Odstranit.

Otevře se okno Odstranit konektor.
Napište „delete“ a klikněte na Odstranit.

Konektor je odstraněn a zobrazí se seznam konektorů.

Poznámka

Konektor nelze odstranit, pokud je stále propojen s nedokončenými zakázkami v projektu, včetně zakázek v koši. Pokus o odstranění takového konektoru vrátí chybu „Nepodařilo se odstranit konektor“.

Řešení: Otevřete projekt přidružený ke konektoru a dokončete nebo odstraňte všechny zbývající zakázky. Přejděte do Nastavení/Recycle bin a vyprázdněte jej, abyste odstranili všechny zakázky, které jsou stále propojené s konektorem. Zkuste konektor odstranit znovu.

Integrace podporuje:

Šablony projektu TMS
Pracovní postupy TMS
Briefing zakázky (neplatí při použití synchronizace na úrovni projektu)
Zakázka due date (neplatí při použití synchronizace 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 CAT editorů TMS:
- Povolte možnost Allow loading of external content in Phrase CAT editor v sekci Access and Security nastavení projektu TMS.
- Vyberte formát Rich textu v podokně Context note.
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í při odstranění klíče s APC

Odstranění klíče ve Strings poté, co byl zahrnut do zakázky, neovlivní zakázku Phrase TMS, která byla vytvořena prostřednictvím jednorázového manuálního importu. Tato zakázka zůstává nezměněna, dokud není ručně znovu importována.

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

V režimu průběžný projekt resynchronizace aktualizuje stávající projekt nebo zakázku Phrase TMS tak, aby odpovídaly aktuálnímu obsahu ve Strings, takže obsah odstraněného klíče je z této zakázky odebrán.
V režimu create a new project everytime resynchronizace vytvoří novou verzi zakázky Phrase TMS, která odráží obsah po odstranění, zatímco dříve vytvořené verze zakázky zůstanou 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 chybí v zakázce TMS	Konkrétní klíč nebyl přidán do zakázky Strings	Přidejte klíč do zakázky Strings a poté znovu importujte zakázku z online úložiště v TMS.
Při pokusu o import/export zakázek se zobrazí chyba „Could not authenticate“.	Expirovaný nebo odvolaný přístupový token u automaticky vytvořeného konektoru "created by Phrase Strings"	Vytvořte nový konektor Phrase Strings v TMS, znovu propojte stávající APC s novým konektorem a spusťte monitor.
Zakázku Strings nelze najít pro import nebo re-import přes APC nebo ručně, i když není zobrazena jako dokončená.	Zakázka již byla importována do projektu TMS, který byl později přesunut do koše, aniž by byl dokončen nebo vyčištěn. Protože je projekt technicky stále v průběhu, zakázka není uvolněna pro re-import.	Zkontrolujte Annotations zakázky vedle jejího kódu jazyka ve Strings, abyste ověřili, zda již byla importována do TMS, než budete pokračovat v řešení potíží. Pokud se propojený projekt nachází v koši, buď projekt obnovte a pokračujte v práci přímo na něm, nebo pokud projekt není potřeba, zrušte zakázky a projekt, případně projekt trvale odstraňte přes API pomocí parametru `purge=true`, aby jej APC již nepovažovalo za aktivní verzi.
Job Sync se nedaří uložit, s chybou „`Locales are not supported by Phrase TMS: x`“, i když má konektor TMS nakonfigurováno vlastní mapování jazyků.	Job Sync validuje cílové kódy jazyka v projektu Strings přímo oproti seznamu locales natively supported by TMS v době uložení. Tato validace nebere v úvahu Vlastní mapování kódů jazyka konektoru.	Pro projekt Strings s cílovým kódem jazyka, který není nativně podporován v TMS, použijte konektor Strings přímo v TMS místo prostřednictvím Strings a nakonfigurujte vlastní mapování jazyků.