Contentful (TMS)

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

K dispozici pro

Plány Business a Enterprise (nejsou k dispozici pro plány LSP)

S dotazy ohledně licencí se obraťte na prodejní oddělení.

K dispozici pro

Edice Enterprise (starší)

S dotazy ohledně licencí se obraťte na prodejní oddělení.

Tip

Informace o integraci Contentful v Phrase Strings naleznete v Contentful (Strings).

Contentful poskytuje headless infrastrukturu pro správu obsahu k vytvoření, správě a distribuci obsahu na jakoukoli platformu nebo zařízení. Phrase se integruje s Contentful dvěma způsoby:

Prostřednictvím vyhrazeného konektoru Contentful (2.0, Entry-Level, Field-Level)

Konektor Contentful 2.0 v současnosti podporuje ověřování pouze prostřednictvím datového centra v USA.
Prostřednictvím pluginu Contentful Marketplace pro přizpůsobené prostředí

Poznámka

Konektor nepodporuje překlad objektů JSON.

Podporované metody lokalizace

Contentful podporuje několik metod lokalizace. Podrobný popis naleznete v dokumentaci Contentful.

Konektor Contentful 2.0 je aktuální a preferovaná integrace, která podporuje lokalizaci na úrovni polí. Nabízí také:

Vícenásobné mezery
Aliasy prostředí
Nastavení URL pro náhled
Import reference
Filtrování obsahu na základě tagů
Konfigurace živého náhledu

Lokalizace na úrovni položky (starší)

Použijte konektor Contentful (úroveň položky).

Konektor na úrovni položky funguje pouze s typy obsahu, které mají lokalizovaná referenční pole (např. reference pole s názvem Localized, které je povoleno pro lokalizaci).

Lokalizace na úrovni pole (starší)

Použijte konektor Contentful (úroveň pole).

Konektor na úrovni pole funguje pouze s typy obsahu, které mají překládaný text (např. pole Text nebo Rich Text s povolenou lokalizací) a volitelně mediální prostředky. Importuje referencované položky a jejich překládaný text (pokud jsou referenční pole lokalizována).

Důležité

Starší konektory budou ukončeny dne 30. listopadu 2026. Nové instance těchto konektorů lze vytvářet do 17. srpna 2026. Před datem ukončení podpory migrujte na nový konektor.

Úplného průvodce migrací naleznete v části Ukončení podpory staršího konektoru.

Příklady použití

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

Projektoví manažeři mohou přidat soubory přímo do projektů z online úložiště. Obsah lze vyhledávat podle ID položky.
Nastavte portál zadavatele, aby zadavatelé mohli přidávat soubory k požadavkům přímo z online úložiště. Obsah lze vyhledávat podle ID položky.
Použijte automatizované vytváření projektů (APC) k automatickému vytváření nových projektů, jakmile se u sledovaných dokumentů nebo složky změní velikost obsahu.

Případy použití pro aplikaci:

Editoři obsahu mohou přímo odeslat položku k lokalizaci přímo z Contentful. To umožňuje editorům nebo manažerům obsahu mít plnou kontrolu nad procesem lokalizace a mít aktuální stavové aktualizace při prohlížení položky.

Jakmile je položka dokončena:
- Vyberte požadované cílové jazyky pro lokalizaci.
- Odešlete pouze položku s vybranými jazyky do Phrase TMS nebo použijte záložku Výběr pole k výběru polí.
  - Pokud nejsou vybrána žádná pole, k překladu se odešlou všechna lokalizovatelná pole.
  - Pokud je vybráno pole, které nelze lokalizovat, toto pole nebude k překladu odesláno. Odesílají se pouze lokalizovatelná pole.
  - Pokud jsou vybrána pouze některá lokalizovatelná pole, k překladu budou odeslána pouze tato pole.
- Na základě nastavení APC jsou ze zaslaného obsah automaticky vytvářeny zakázky. Během běhů APC jsou pro vytvoření zakázky vybrány pouze položky ve stavu submitted.
- Jakmile jsou vytvořeny zakázky z odeslané položky, stav se změní na in progress. Když jsou překlady odeslány zpět do Contentful, stav se změní na completed.
- Dříve přeložené položky lze po změnách v původním textu znovu odeslat.
Editoři obsahu mohou použít hlavní stránku Phrase TMS k:
- Hromadnému odesílání položek.
- Určení jednotlivých cílových jazyků při hromadném odesílání.
- Získání přehledu o aktivních překladových zakázkách.

nastavení Contentful

Při práci s aplikací Phrase TMS:

Stáhněte si aplikaci Phrase TMS z marketplace.
Nainstalujte aplikaci do aktuálního aktivního Space a vyberte modely obsah, u kterých aplikace vyžaduje instalaci.
Zadejte token Phrase TMS Auth získaný při vytváření konektoru v rámci Phrase TMS.
Klikněte na Install.

Volitelné – Spustit aplikaci (zastaralé podle Contentful)

Pokud používáte podporu pracovního postupu prostřednictvím aplikace Launch App od Contentful, postupujte podle těchto kroků:

Nainstalujte aplikaci Launch od Contentful do jednoho nebo více Space.

Poznámka

V každém Space lze vytvořit pouze jeden pracovní postup. Pokud jsou v rámci jednoho Space Contentful vyžadovány různé přístupy pro typy obsah, kontaktujte svého zákazník Success Managera.
Nastavit požadovaný lokalizační pracovní postup.
Vybrat typ obsah nebo typy, které následují popsaný pracovní postup.

Pokud jsou v konektor nastaveny pracovní postupy, Automatické Vytvořit projekt (APC) automaticky vytvoří nové projekt, když je zjištěna změnit v krocích pracovní postup pro monitorované články nebo typy obsah.

Odeslané úlohy lze zrušit, což umožňuje znovu odeslat obsah po provedení změnit. Tyto úlohy budou v Phrase stále existovat a bude je muset smazat projektový manažer.

Nastavení Phrase TMS (Contentful 2.0)

Poznámka

Aplikace Contentful Launch není v konektoru 2.0 podporována.

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 Contentful 2.0.
Zadejte název pro konektor.
Klikněte na Připojit k Contentful 2.0.

Otevře se přihlašovací okno Contentful.
Zadejte přihlašovací údaje a klikněte na Přihlásit se (nebo použijte alternativní metody přihlášení). Přihlašovací okno se zavře a zobrazí se Připojeno.
Volitelně zaškrtněte políčko Aplikace Phrase Contentful, pokud konektor používáte s aplikací.
1. Klikněte na Vygenerovat token.
  
  Otevře se okno Vygenerovat Contentful token.
2. Klikněte na Vygenerovat token.
  
  Vygeneruje se token, který by měl být zkopírován do schránky nebo textového souboru. Ujistěte se, že je token zkopírován před zavřením okna, protože již nebude znovu viditelný. Tento token bude použit při připojování k aplikaci.
3. Zavřete okno a zobrazí se Token vygenerován.
Pokud se k identifikaci překládaný text obsahu používají Contentful tagy, zadejte ID tagu a stiskněte Enter.

Zobrazí se ID a lze přidat další. Tagy lze použít k omezení toho, který obsah z Contentful je viditelný pro konektor.
- Vybrat strategii výpisu
  - Se všemi tagy
    
    Zobrazí obsah v Contentful se všemi uvedenými tagy.
  - S alespoň jedním tagem
    
    Zobrazí obsah z Contentful alespoň s jedním z uvedených tagů.
V případě potřeby vyberte Zahrnout assety.
V případě potřeby vyberte Zahrnout odkazované záznamy (vnořený obsah).

Zobrazí se Nastavení odkazovaných záznamů. Použijte požadované filtry pro nastavení podrobnější kontroly nad tím, jak systém prochází vztahy obsahu.
- Nastavte hloubku pro import propojených položek
  
  Omezuje, jak hluboko Phrase následuje odkazované záznamy během importu.
  
  Výchozí hodnota je 10 000. V případě potřeby vyberte jiné hodnoty nebo zadejte Vlastní celočíselnou hodnotu.
- Typ obsahu
  
  Vyberte, zda se má zastavit u záznamů, jejichž typ obsahu odpovídá zadanému seznamu, nebo je následovat.
- Hlavní typ obsahu
  
  Vyloučit záznamy, jejichž hlavní typ obsahu odpovídá zadanému seznamu.
- Tagy
  
  Vyberte, zda se má zastavit u záznamů, které mají některý ze zadaných tagů obsahu, nebo je sledovat.
- Field IDs
  
  Vyberte, zda se má zastavit u záznamů, na které odkazují zadaná ID polí, nebo je sledovat.
V případě potřeby vyberte Include taxonomy.

Zobrazí se pole Contentful Organization ID. Zadejte hodnotu pro povolení nastavení taxonomie.
- Po výběru konektor načte taxonomie z Contentful a zahrne je do .XLIFF file. Podokno Context note v CAT editor zobrazí seznam hodnot taxonomie Contentful pro každý segment.
- Pokud metadata taxonomie nejsou k dispozici nebo s nimi konektor není nakonfigurován, podokno Context note se jednoduše vynechá.
- Pokud projekt nevyžaduje kontext funkce/obrazovky, doporučuje se nechat taxonomii zakázanou pro optimalizaci výkonu při exportu .XLIFF.
V případě potřeby vyberte Follow aliases.

Alias<1> se používá pro veškeré monitorování APC a opětovné importy/exporty zakázek. Pokud se cíl aliasu v budoucnu změní, APC bude monitorovat obsah v novém cíli a zakázky budou znovu importovány/exportovány z/do nového cíle aliasu.
- Disabled<1> (výchozí a doporučené)
  
  APC a vytvořené zakázky jsou vázány na prostředí, na které alias ukazoval v době vytvoření zakázky/APC. APC monitorují pouze toto prostředí a obsah; zakázky jsou do něj exportovány a z něj znovu importovány.
- Povoleno
  
  APC a vytvořené zakázky jsou vázány na samotný alias. APC monitorují pouze tento alias a obsah; zakázky jsou do něj exportovány a z něj znovu importovány.
  
  Pokud se cíl aliasu změní, APC budou monitorovat nový cíl aliasu (prostředí); zakázky se nyní budou exportovat a znovu importovat do něj.
Vlastní role Contentful vyžadují přímý přístup ke konkrétnímu podkladovému prostředí, na které alias ukazuje, nikoli pouze k aliasu samotnému, jinak se hlavní panel aplikace Phrase TMS nenačte. Přidat tento přístup v Contentful pod Contentful Space Settings/Roles, v sekci Environments dané role. Pokud je alias později přesměrován na jiné prostředí, přidat přístup i k novému prostředí.
V případě potřeby zadejte Preview URL.

Toto je šablona URL vedoucí k vykreslenému obsah z Contentful. Podporovány jsou následující zástupné znaky:
- {env_id}: ID prostředí
- {entry.id}: ID položka
- {space_id}: ID Space
Šablona URL může vypadat takto:

https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry_id}

Poznámka

URL musí vést k nasazené aplikaci, která vykresluje obsah Contentful. Chcete-li použít náhled, Nahradit contentfulapp.tld v šablona URL skutečnou doména aplikace.

Další informace o nastavení náhled obsahu naleznete v dokumentaci Contentful.

Kód jazyka momentálně není podporován v podobě zástupných znaků. Chcete-li použít kód jazyka v URL, zadejte pevnou hodnotu a Vytvořit více instancí konektor.
V případě potřeby použít Omit translatable fields pro Vyloučit konkrétní pole z import do Phrase. Zadejte ID obsahu, které mají být vynechány z import.
Zadejte Space ID a token pro Space preview token map (povinné).

API pro náhled vyžaduje přístupový token Contentful s názvem Content Preview API – access token, který by měl být nakonfigurován v nastavení API pro Space v Contentful.

Integrace Contentful 2.0 používá toto API pro import obsah a sledování změn (APC).
- vybrat každý Space a prostředí, které chcete sledovat/import z Contentful.
- nastavení a přístup se spravují přímo v Contentful.
Klikněte na Uložit.

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

Poznámka

Sledování APC znovu kontroluje úplný obsah sledované položka a jejích odkazů při každém spuštění, protože Contentful nehlásí, který kód jazyka se změnil. Z tohoto důvodu lze položku znovu importovat po obdržení překladu, i když se její zdroj nezměnil. U Space s velkým objemem to může zpomalit běhy APC.

Pro omezení tohoto:

Jakmile je položka hotová, odeberte překladový tag a znovu jej přidejte pouze v případě, že vyžaduje opětovný překlad.
Zúžit nastavení Referencované položky pouze na položky, které vyžadují překlad.
Použijte aplikaci Phrase Contentful, která monitoruje pouze položky odeslané jejím prostřednictvím.

Nastavení Phrase TMS

Důležité

Pokud přistupujete z Vlastní domény (např. mydomain.phrase.jp), otevřete okno prohlížeče v režimu inkognito a přihlaste se přes cloud.memsource.com nebo us.cloud.memsource.com, abyste použili ověřování vyžadované pro vytvoření nebo uložení konektoru. Po uložení lze ke konektoru přistupovat přes Vlastní doménu.

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 buď Contentful (úroveň položky) nebo Contentful (úroveň pole) a zadejte název konektoru.
Volitelně zaškrtněte políčko Aplikace Phrase Contentful, pokud konektor používáte s aplikací.
- Token aplikace Contentful
  
  Vygenerujte token aplikace, který se zadá do aplikace Contentful v Phrase TMS. Po vygenerování tokenu a jeho zkopírování do aplikace Contentful konektor uložte.
Poznámka

Po uložení nelze token v rámci Contentful změnit. Chcete-li jej aktualizovat, zrušte platnost tokenu v konfiguraci konektoru v Phrase TMS a vygenerujte nový.
Nakonfigurujte nastavení nezávislá na jazyce.
- Zdrojový jazyk
  
  Vyberte zdrojový jazyk, který přepíše výchozí jazyk Contentful. Konektor poté stáhne obsah z jazyka nastaveného v konfiguraci konektoru.
  
  Příklad:
  
  Pokud je v Contentful jako výchozí jazyk nastaven EN-US, ale pro lokalizaci v konkrétním Space nebo modelu obsahu je vyžadován DE-DE jako zdrojový jazyk, lze konfiguraci upravit tak, aby Space (Remote složka) stahoval obsah z DE-DE namísto EN-US.
Poznámka

Při použití aplikace se nepoužije.
Vyberte způsob zpracování vnořeného obsahu prostřednictvím režimu importu položky. Obsah může použít referenční pole k odkazu na jiný obsah, což umožňuje vytvořit hierarchii entit.

Poznámka

Při použití aplikace se nepoužije.
- Contentful (Entry-Level)
  
  Konektor na úrovni položky automaticky prochází celou hierarchii vnořeného obsahu.
- Contentful (Field-Level)
  
  Vyberte, jak má konektor na úrovni pole importovat vnořený obsah.
  - Pouze vybraná položka
    
    Obsah, který je explicitně vybrán při přidávání z úložiště, je importován.
    
    Změny zjištěné pomocí APC jsou importovány k překladu.
  - Importovat odkazované položky
    
    Konektor prochází celou hierarchii vnořeného obsahu a importuje veškerý překládaný text pro překlad.
Vytvořte seznam oddělený čárkami v Omit translatable fields pro vynechání polí, která jsou zaškrtnuta pro Enable localization of this field z importu do Phrase TMS. Použijte následující strukturu: contentTypeID:fieldID.
- Vyberte Leave omitted fields empty, pokud mají být uvedená pole ponechána prázdná. Toto nastavení bude použito u všech uvedených položek.
- Vyberte Copy source to target, pokud mají uvedená pole obsahovat zdrojové hodnoty. Toto nastavení bude použito u všech uvedených položek.
Vyberte Use fallback language, pokud v cílovém jazyce chybí data pro konkrétní pole.

V případě potřeby vyberte Source language fallback z rozevíracího seznamu. Tento kód jazyka bude použit v případě chybějících dat.

Poznámka

Mezi záložním jazykem Contentful a tímto nastavením není žádný vztah.
V případě potřeby zadejte Live preview URL (BETA).

Toto je šablona URL vedoucí k vykreslenému obsah z Contentful. Podporovány jsou následující zástupné znaky:
- {env_id}: ID prostředí
- {entry.sys.id}: ID položky
- {space_id}: ID Space
Šablona URL může vypadat takto:

https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}

Poznámka

URL musí vést k nasazené aplikaci, která vykresluje obsah Contentful. Chcete-li použít náhled, Nahradit contentfulapp.tld v šablona URL skutečnou doména aplikace.

Další informace o nastavení náhled obsahu naleznete v dokumentaci Contentful.

Kód jazyka momentálně není podporován v podobě zástupných znaků. Chcete-li použít kód jazyka v URL, zadejte pevnou hodnotu a Vytvořit více instancí konektor.
Pokud technický Team podpory vyžádá protokolování ladicích informací, vyberte Log debug information.
Klikněte na Connect to Contentful.

Pokud bylo připojení úspěšné, v nastavení konektoru se zobrazí zaškrtnutí. Pokud nebylo, zobrazí se červený vykřičník. Další podrobnosti zobrazíte, když najedete na ikonu.
Pouze Contentful (Entry-Level):

Nastavte Source language.

Poznámka

Tento jazyk by měl odpovídat kódu jazyka výchozího Space v Contentful, který je nakonfigurován v nastavení Locales v Contentful.
Klikněte na Uložit.

Konektor je přidán do seznamu na stránce Konektory.
Volitelně můžete Upravit konektor a Vybrat Contentful workflows.
- Translate articles from:
  
  Konektor sleduje články ve vybrané fázi (např. Přeložit). Autor může tento štítek použít u článků připravených k překladu.
Upon import from Contentful:
- Nastavit zdrojové články jako
  
  Konektor posune pracovní postup do vybrané fáze (např. Translation in Progress), jakmile jsou zdrojové články staženy.
Upon export to Contentful:
- Nastavit zdrojové články jako
  
  Konektor nastaví pracovní postup zdrojových článků na vybranou fázi (např. Translations Completed), jakmile je překlad exportován.
Poznámka

Podpora pracovního postupu byla společností Contentful ukončena dne June 1, 2023. Další používání není podporováno.

Odstranit konektor

Postup odstranění konektoru:

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

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

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. Pokus o odstranění takového konektoru vrátí chybu „Failed to delete connector“.

Ř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 odebrali všechny úlohy, které jsou stále propojeny s konektorem. Zkuste konektor odstranit znovu.