Konektor Phrase Strings (synchronizace úloh)

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 úloh 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. Ve výchozím nastavení jsou úlohy 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ázku. Nově přidané nebo aktualizované klíče se stanou dostupnými pro synchronizaci automaticky.

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

Předpoklady

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

Důležité

Soubory Figma lze v aplikaci Strings zobrazit jako celý živý soubor, v TMS to však není podporováno. Editor CAT v TMS 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ěřené, mohou být do Strings vráceny jako ověřené 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 ve Strings se v editoru CAT v TMS nezobrazují. Tyto mezery jsou zachovány v kostře a znovu vloženy do zdrojového i cílového souboru při synchronizaci zakázky zpět do Strings. To může ovlivnit validace limitu znaků nakonfigurované ve Strings, protože počet mezer se během překladu v editoru TMS neprojeví.

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ěč synchronizace úloh, vytvoří jednu úlohu TMS pro každou jazykovou verzi Strings. Pořadí importu těchto úloh není zaručeno a nelze jej konfigurovat prostřednictvím šablony projektu přiřazené k pravidlu APC. V žádné fázi tohoto procesu se nepoužívá žádný mechanismus řazení. Chcete-li použít odlišné zpracování pro každou skupinu národních prostředí, nakonfigurujte samostatná pravidla APC, z nichž každé odkazuje na jinou šablonu projektu.

Konektor používá anotace národního prostředí úlohy k připojení metadat o odpovídajícím projektu Phrase TMS k zakázkám a jazykovým mutacím úloh ve Strings. Koncový bod API Phrase Strings pro výpis anotací národního prostředí úlohy tato metadata načítá. Koncový bod pro výpis cílových národních prostředí úlohy tato metadata také zahrnuje, pokud je parametr include_annotations nastaven na true. Anotované úlohy obsahují pole jako tms_project_id a tms_in_progress, která umožňují sledování stavu úlohy Strings v propojeném projektu Phrase TMS.

TMS nepodporuje použití stejného národního prostředí jako zdrojového i cílového jazyka v projektu. Pokud například úloha ve Strings používá en-US jako zdrojový i cílový jazyk, cílovou jazykovou verzi en-US nelze importovat do TMS a celou úlohu nelze označit jako dokončenou. Při vytváření úloh ve Strings, které budou synchronizovány do TMS, nevybírejte zdrojovou jazykovou verzi jako cílovou.

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 synchronizaci na úrovni úlohy i projektu musí být cesta sledovaného projektu vybrána až ke složce jobs (např. space/project/main/jobs).
- U synchronizací úloh se APC spouští následujícími aktualizacemi úloh:
  - 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).

Stránka synchronizací úloh

Stránka Job Syncs poskytuje centralizovaný přehled všech nastavení synchronizace úloh (APC), která využívají konektor Phrase Strings. Zahrnuje jak synchronizace úloh 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í Administrátor a Projektový manažer ve Strings pomocí možnosti vytvářet nové synchronizace úloh, upravovat stávající (včetně jejich aktivního či neaktivního stavu) nebo je mazat.

Stávající synchronizace úloh lze upravit nebo odstranit pomocí příslušných možností v nabídce Více Nabídka Více . Všechny změny jsou synchronizovány mezi Strings a TMS. Odstranění synchronizace úloh odstraní odpovídající APC v TMS.

Stránka Synchronizace úloh je přístupná z levé navigační nabídky Integrace i Úlohy.

Konfigurace synchronizace úloh ve Strings

Poznámka

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

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

Na stránce Integrace vyberte Konfigurovat vedle integrace Synchronizace úloh.

Zobrazí se stránka Synchronizace úloh.
Klikněte na + Nová synchronizace úloh.

Zobrazí se okno Vytvořit novou synchronizaci úloh.
Zadejte Název synchronizace a z rozbalovací nabídky Přiřazené projekty Strings vyberte projekt(y) Strings, které chcete propojit s TMS.

Zahrnout lze pouze projekty se stejnými jazykovými kombinacemi.
Volitelně vyberte šablonu projektu TMS, kterou chcete použít. Vybraná šablona projektu TMS se musí shodovat se sadou jazyků definovanou v přiřazeném projektu (projektech) Strings.

Synchronizované úlohy budou přidány do projektu TMS vytvořeného z vybrané šablony.
- Pokud je vybráno Výchozí, automaticky se vytvoří šablona projektu TMS na základě vybraných projektů Strings.
Vyberte Typ projektu, který se má v TMS vytvořit.
- Průběžný projekt
  
  Výchozí možnost.
- Nový projekt
  
  Nový projekt TMS se vytvoří pokaždé, když jsou zjištěny změny v úlohách Strings.
V sekci Export back to Strings určete nastavení exportu Strings pro kontrolu způsobu, jakým jsou překlady z TMS exportovány 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čí úlohu jako dokončenou ve Strings.
- Ověřit nezměněné překlady ve Strings
  
  Klíče označené jako neověřené 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í lokalizaci jako dokončenou, jakmile jsou její 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 synchronizace úloh je přidána do seznamu TMS Job Syncs s neaktivním stavem. Použijte přepínač ve sloupci Active k aktivaci synchronizace úloh.

Tip

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

Kdykoli je použito vlastní mapování, pokud je potřeba jakákoli změna, musí být aplikována na konektor v TMS.

Vytvoření konektoru Strings ve Phrase TMS automaticky nevytvoří APC pro automatizovaný import/export úloh. APC musí být nakonfigurováno samostatně v TMS.

Nastavení Phrase TMS

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

Konektor zobrazuje stav Pending, dokud po vytvoření nedokončí počáteční synchronizaci, poté se změní na Active. Stav Pending se také spustí vždy, když je provedena jakákoli změna v konfiguraci konektoru nebo když je uložena stránka nastavení konektoru, a to i bez smysluplných změn. Zatímco konektor zobrazuje stav Pending, nelze jej v Phrase TMS použít jako zdroj pro vytváření úloh. Před vytvořením úloh 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 Typ na Phrase Strings a zadejte název konektoru.
Zadejte ID účtu a přístupový token získaný ze Strings.
Klikněte na Zkouška spojení.
- Pokud je test úspěšný, vedle tlačítka Test připojení se zobrazí malé zaškrtnutí.
Vyberte položky pro import do TMS.

Pokud nejsou naimportovány cílové klíče, může být soubor XLIFF 2.0 dále segmentován, pokud je vybrána možnost Segmentovat XLIFF v nastavení importu souborů pro soubory XLIFF 2.0.
- Povolit nebo zakázat 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 úloh TMS pro lokalizace, u kterých již probíhá zpracování. Pokud je tato možnost povolena, změny klíčů, které jsou již součástí aktivní úlohy TMS, se znovu neimportují, dokud není původní úloha 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é nejsou v souladu s nejnovějším zdrojovým obsahem, 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 případě nezměněných cílových překladů automaticky ověřeny v aplikaci Strings. Je-li tato možnost povolena, každý překlad vrácený ze systému TMS je v aplikaci Strings označen jako ověřený, bez ohledu na to, zda byl text upraven, nebo vrácen beze změny. Vyloučeny jsou pouze klíče, jejichž zdrojový text se v aplikaci Strings změnil v době, kdy byla úloha otevřená, a ty zůstávají neověřené.
  - Označit jazyk jako dokončený
    
    Označí konkrétní lokalitu jako dokončenou, jakmile se její překlady synchronizují zpět.
  - Označit zakázku jako dokončenou
    
    Pokud je tato možnost vybrána, bude úloha označena jako dokončená až po nahrání poslední lokality.
Je-li 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. Zajistěte, aby každá lokalita ve Strings měla v konfiguraci konektoru pouze jeden záznam mapování na jednu lokalitu 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é a-z (malá písmena).
Klikněte na Uložit.

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

Odstraňte konektor

Chcete-li odstranit konektor:

Na stránce Integrace 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 úlohami v projektu, včetně úloh v koši. Při pokusu o odstranění takového konektoru se zobrazí chyba „Failed to delete connector“ (Odstranění konektoru se nezdařilo).

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

Integrace podporuje:

Šablony projektu TMS
Pracovní postupy TMS
Zadání zakázky (neplatí při použití synchronizace na úrovni projektu)
Termín dokončení úlohy (nepoužije se 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

Zobrazení snímků obrazovky ze Strings v podokně Kontextová poznámka editorů TMS CAT:
- Povolte možnost Povolit načítání externího obsahu v editoru Phrase CAT v části Přístup a zabezpečení nastavení projektu TMS.
- V podokně Kontextová poznámka vyberte 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í při odstranění klíče pomocí APC

Odstranění klíče ve Strings poté, co byl zahrnut do úlohy, nemá vliv na úlohu Phrase TMS, která byla vytvořena prostřednictvím jednorázového ručního importu. Tato úloha zůstává beze změny, dokud není ručně znovu importována.

Když je monitorování APC aktivní, Phrase porovnává hash obsahu při každém dotazu 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ý projekt resynchronizace aktualizuje existující projekt nebo úlohu Phrase TMS tak, aby odpovídala aktuálnímu obsahu ve Strings, takže obsah odstraněného klíče je z dané úlohy odebrán.
V režimu vytvořit pokaždé nový projekt vytvoří resynchronizace novou verzi úlohy Phrase TMS, která odráží obsah po odstranění, zatímco dříve vytvořené verze úlohy zůstávají beze změ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í.
Existující klíč v projektu Strings v úloze TMS chybí	Konkrétní klíč nebyl do úlohy Strings přidán	Přidejte klíč do úlohy Strings a znovu importujte úlohu z online úložiště v TMS
Při pokusu o import/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 existující APC s novým konektorem a spusťte monitorování.
Úlohu Strings nelze pro import nebo opětovný import prostřednictvím APC nebo ručně najít, i když není zobrazena 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 v procesu, úloha není uvolněna pro opětovný import.	Před dalším řešením potíží zkontrolujte Anotace úlohy (Anotace) vedle její lokality ve Strings, abyste ověřili, zda již byla do TMS importována. 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 ú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.
Synchronizace úloh se neuloží s chybou „`Locales are not supported by Phrase TMS: x`“, i když má konektor TMS nakonfigurované vlastní mapování lokalit.	Synchronizace úloh ověřuje cílová locale v projektu Strings přímo proti seznamu lokalit, které TMS nativně podporuje při ukládání. Toto ověření nebere v úvahu vlastní mapování locale konektoru.	Pro projekt Strings s cílovým locale, které TMS nativně nepodporuje, použijte konektor Strings přímo v TMS místo použití ze Strings a nakonfigurujte vlastní mapování jazyka.
Překlady se neexportují zpět do Strings, i když úlohy vykazují v TMS stav delivered.	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, namísto toho, aby se tak stalo až po jejich doručení. Tímto jsou úlohy nastaveny do stavu 'delivered' bez spuštění exportního kroku do Strings, takže automatizační služba nikdy nenaplanuje export a žádné překlady nejsou odeslány zpět do Strings.	V nastavení Project status automation šablony projektu nastavte Mark project as 'completed' once all jobs are" to "delivered in all their workflow steps namísto completed in all their workflow steps. U úloh vytvořených ručně proveďte ruční export úlohy zpět do Strings a ručně změňte stav úlohy na delivered, protože ruční exporty automaticky neaktualizují stav úlohy. Jakmile jsou všechny úlohy v projektu nastaveny na delivered, projekt je automaticky označen jako completed.