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 dostupné 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 bezhlavou infrastrukturu pro správu obsahu k vytvář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časné době 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 najdete 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í adresy URL náhledu
Import referencí
Filtrování obsahu na základě štítků
Konfigurace živého náhledu

Lokalizace na úrovni záznamů (zastaralé)

Použijte konektor Contentful (Entry-Level).

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

Lokalizace na úrovni pole (zastaralé)

Použijte konektor Contentful (Field-Level).

Konektor na úrovni pole funguje pouze s typy obsahu, které mají přeložitelné pole (např. pole Text nebo Rich Text s povolenou lokalizací) a volitelně mediální prostředky. Importuje odkazované záznamy a jejich přeložitelná pole (pokud jsou referenční pole lokalizována).

Důležité

Zastaralé konektory budou označeny jako zastaralé 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.

Podívejte se do části Legacy Connector Deprecation pro úplný průvodce migrací.

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 záznamu.
Nastavte portál odesílatele, aby odesílatelé mohli přidávat soubory k požadavkům přímo z online úložiště. Obsah lze vyhledávat podle ID záznamu.
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 odeslat záznam k lokalizaci přímo z prostředí Contentful. To umožňuje editorům obsahu nebo manažerům mít plnou kontrolu nad procesem lokalizace a okamžitě dostávat aktualizace stavu v reálném čase při prohlížení záznamu.

Jakmile je záznam dokončen:
- Vyberte požadované cílové jazyky pro lokalizaci.
- Odešlete do Phrase TMS pouze záznam s vybranými jazyky nebo použijte kartu Výběr polí 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 je vybráno pouze několik lokalizovatelných polí, k překladu budou odeslána pouze tato pole.
- Na základě nastavení APC jsou úlohy automaticky vytvářeny z odeslaného obsahu. Během běhů APC jsou pro vytvoření úlohy vybrány pouze záznamy ve stavu odesláno.
- Jakmile jsou vytvořeny úlohy z odeslaného záznamu, stav se změní na probíhá. Když jsou překlady odeslány zpět do Contentful, stav se změní na dokončeno.
- Dříve přeložené záznamy lze po změnách v původním textu znovu odeslat.
Editoři obsahu mohou používat domovskou obrazovku Phrase TMS k:
- Odesílejte záznamy hromadně.
- Při hromadném odesílání určete jednotlivé cílové jazyky.
- Získejte přehled o aktivních překladových úlohá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 prostoru a vyberte modely obsahu, do kterých je třeba aplikaci nainstalovat.
Zadejte Phrase TMS Auth token získaný při vytváření konektoru v rámci Phrase TMS.
Klikněte na Instalovat.

Volitelné – Spustit aplikaci (zastaralé podle Contentful)

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

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

Poznámka

V každém prostoru lze vytvořit pouze jeden workflow. Pokud jsou v rámci jednoho prostoru Contentful vyžadovány různé přístupy pro typy obsahu, kontaktujte svého přiděleného Customer Success Managera.
Nastavte požadované lokalizační workflow.
Vyberte typ nebo typy obsahu, které se řídí popsaným workflow.

Pokud jsou v konektoru nastavena workflow, funkce Automatické vytváření projektů (APC) automaticky vytvoří nové projekty, jakmile je u sledovaných článků nebo typů obsahu zjištěna změna v krocích workflow.

Odeslané úlohy lze zrušit, což umožňuje opětovné odeslání obsahu po provedení změn. Tyto úlohy budou ve Phrase stále existovat a bude je muset smazat projektový manažer.

Nastavení Phrase TMS (Contentful 2.0)

Poznámka

Aplikace Contentful Launch App 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 konektoru.
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 touto aplikací.
1. Klikněte na Generovat token.
  
  Otevře se okno Generovat Contentful token.
2. Klikněte na Generovat token.
  
  Vygeneruje se token, který by měl být zkopírován do schránky nebo textového souboru. Před zavřením okna se ujistěte, že je token zkopírován, 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řeložitelného obsahu používají Štítky Contentful, zadejte ID štítku a stiskněte Enter.

ID se zobrazí a lze přidat další. Štítky lze použít k omezení toho, který obsah z Contentful je pro konektor viditelný.
- Vyberte strategii výpisu
  - Se všemi tagy
    
    Zobrazí obsah v rámci Contentful se všemi uvedenými štítky.
  - S alespoň jedním tagem
    
    Zobrazí obsah z Contentful s alespoň jedním z uvedených štítků.
V případě potřeby vyberte Zahrnout soubory.
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 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 sledovat.
- Hlavní typ obsahu
  
  Vylučte záznamy, jejichž nadřazený typ obsahu odpovídá zadanému seznamu.
- Tagy
  
  Vyberte, zda se má zastavit u záznamů, které mají některý ze zadaných štítků obsahu, nebo je následovat.
- Field IDs
  
  Vyberte, zda se má zastavit u záznamů, na které odkazují zadaná ID polí, nebo je následovat.
V případě potřeby vyberte Zahrnout taxonomii.

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 souboru .XLIFF. Podokno Context note v CAT editor vypíše hodnoty 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, aby se optimalizoval výkon při exportu .XLIFF.
V případě potřeby vyberte Sledovat aliasy.

alias se používá pro veškeré monitorování APC a opětovné importy/exporty úloh. Pokud se cíl aliasu v budoucnu změní, APC bude monitorovat obsah v novém cíli a úlohy budou znovu importovány/exportovány z/do nového cíle aliasu.

Sledovat aliasy se vztahuje pouze na monitorování APC standardního konektoru, opětovný import úloh a export úloh. Nevztahuje se na záznamy odeslané prostřednictvím aplikace Phrase Contentful. Při použití aplikace záznam zůstává vázán na konkrétní prostředí, ze kterého byl odeslán. To platí i v případě, že je toto prostředí později odstraněno nebo nahrazeno za stabilním aliasem. Pokud je původní prostředí odstraněno nebo nahrazeno, konektor nezachytí záznam v novém prostředí, a to ani se zapnutou funkcí Sledovat aliasy. Znovu odešlete záznam z Contentful, zatímco je nové prostředí aktivní, aby jej konektor mohl detekovat.
- Disabled (výchozí a doporučené)
  
  APC a vytvořené úlohy jsou vázány na prostředí, na které alias odkazoval v době vytvoření úlohy/APC. APC monitorují pouze toto prostředí a obsah; úlohy jsou do něj exportovány a znovu importovány.
- Povoleno
  
  APC a vytvořené úlohy jsou vázány na samotný alias. APC monitorují pouze tento alias a obsah; úlohy jsou do něj exportovány a znovu importovány.
  
  Pokud se změní cíl aliasu, APC budou monitorovat nový cíl aliasu (prostředí); úlohy 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 odkazuje, nikoli pouze k samotnému aliasu, jinak se řídicí panel aplikace Phrase TMS nenačte. Tento přístup přidejte v Contentful v části Contentful Space Settings/Roles, v sekci Environments dané role. Pokud je alias později přesměrován na jiné prostředí, přidejte přístup i k novému prostředí.
V případě potřeby zadejte Adresu URL náhledu.

Toto je šablona adresy URL vedoucí k vykreslenému obsahu z Contentful. Podporovány jsou následující zástupné znaky:
- env_id: Environment ID
- Entry ID Entry ID
- Space ID Space ID
Šablona adresy URL může vypadat takto:

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

Poznámka

Adresa URL musí vést k nasazené aplikaci, která vykresluje obsah Contentful. Chcete-li použít živý náhled, nahraďte contentfulapp.tld v šabloně adresy URL skutečnou doménou aplikace.

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

Kód jazyka momentálně není podporován v podobě zástupných znaků. Chcete-li v URL použít locale, zadejte pevnou hodnotu a vytvořte více instancí konektoru.
V případě potřeby použijte Vynechat přeložitelná pole k vyloučení konkrétních polí z importu do Phrase. Uveďte ContentID, která mají být z importu vynechána.
Zadejte ID prostoru a Token pro mapu tokenů náhledu prostoru (povinné).

Rozhraní Preview API 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 prostoru Contentful.

Integrace Contentful 2.0 používá toto API pro import obsahu a sledování změn (APC).
- Vyberte každý prostor a prostředí, ze kterých chcete obsah sledovat/importovat.
- 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 při každém spuštění znovu kontroluje celý obsah sledovaného záznamu a jeho referencí, protože Contentful nehlásí, která jazyková verze se změnila. Referencované záznamy jsou načítány jednotlivě, nikoli v dávkách, takže v prostorech s mnoha referencovanými záznamy může jedno spuštění vygenerovat vysoký počet požadavků na Contentful Preview API a Content API. Z tohoto důvodu může být záznam znovu importován po obdržení překladu, i když se jeho zdroj nezměnil. U prostorů s velkým objemem dat to může zpomalit běh APC a výrazně zvýšit využití Contentful API.

Chcete-li to omezit:

Odstraňte překladový štítek, jakmile je záznam hotový, a znovu jej přidejte pouze v případě, že vyžaduje opětovný překlad.
Omezte nastavení Referencované záznamy pouze na záznamy, které vyžadují překlad.
Použijte aplikaci Phrase Contentful, která sleduje pouze záznamy odeslané jejím prostřednictvím.

Dříve přeložené záznamy lze po změnách v původním textu znovu odeslat. Při použití aplikace Phrase Contentful je opětovné odeslání manuální: editor musí otevřít záznam v Contentful, otevřít postranní panel aplikace Phrase a kliknout na Začít znovu (nebo použít hromadné opětovné odeslání z řídicího panelu aplikace), než jej APC zachytí a aktualizuje zdroj stávající úlohy. To se liší od konektorů pro sledování souborů nebo složek, kde APC detekuje změny zdroje automaticky bez nutnosti manuálního opětovného odeslání.

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

Po uložení již 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ý má přepsat výchozí jazyk Contentful. Konektor poté stáhne obsah z jazyka nastaveného v konfiguraci konektoru.
  
  Příklad:
  
  Pokud je EN-US nastaven jako výchozí jazyk v Contentful, ale DE-DE je vyžadován jako zdrojový jazyk pro lokalizaci v konkrétním prostoru nebo modelu obsahu, lze konfiguraci upravit tak, aby prostor (vzdálená složka) stahoval obsah z DE-DE namísto EN-US.
Poznámka

Nepoužitelné při použití aplikace.
Vyberte způsob zpracování vnořeného obsahu prostřednictvím Entry import mode. Obsah může používat referenční pole k odkazování na jiný obsah, což umožňuje vytváření hierarchie entit.

Poznámka

Nepoužitelné při použití aplikace.
- Contentful (na úrovni položky)
  
  Konektor na úrovni záznamu automaticky prochází celou hierarchii vnořeného obsahu.
- Contentful (na úrovni pole)
  
  Vyberte, jak má konektor na úrovni pole importovat vnořený obsah.
  - Pouze vybraná položka
    
    Obsah, který je výslovně 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é záznamy
    
    Konektor prochází celou hierarchii vnořeného obsahu a importuje všechna přeložitelná pole k překladu.
Vytvořte čárkami oddělený seznam 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 ve zdrojovém jazyce chybí data pro konkrétní pole.

V případě potřeby vyberte Source language fallback z rozevíracího seznamu. Tato jazyková lokalizace bude použita v případě chybějících dat.

Poznámka

Mezi záložním jazykem Contentful a tímto nastavením neexistuje žádný vztah.
V případě potřeby zadejte URL živého náhledu (BETA).

Toto je šablona adresy URL vedoucí k vykreslenému obsahu z Contentful. Podporovány jsou následující zástupné znaky:
- env_id: Environment ID
- entry.sys.id: Entry ID
- Space ID Space ID
Šablona adresy URL může vypadat takto:

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

Poznámka

Adresa URL musí vést k nasazené aplikaci, která vykresluje obsah Contentful. Chcete-li použít živý náhled, nahraďte contentfulapp.tld v šabloně adresy URL skutečnou doménou aplikace.

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

Kód jazyka momentálně není podporován v podobě zástupných znaků. Chcete-li v URL použít locale, určete pevnou hodnotu a vytvořte více instancí konektoru.
Pokud technická podpora vyžádá protokolování ladicích informací, vyberte Protokolovat ladicí informace.
Klikněte na Připojit k 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 (úroveň záznamu):

Nastavte Zdrojový jazyk.

Poznámka

Tento jazyk by měl odpovídat výchozí jazykové lokalizaci prostoru Contentful, která je nakonfigurována v nastavení lokalizací Contentful.
Klikněte na Uložit.

Konektor je přidán do seznamu na stránce Konektory.
Volitelně upravte konektor a vyberte pracovní postupy Contentful.
- Přeložit články z
  
  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.
Po importu z Contentful
- Nastavit zdrojové články jako
  
  Konektor posune pracovní postup do vybrané fáze (např. Probíhá překlad), jakmile jsou zdrojové články staženy.
Po stažení do Contentful
- Nastavit zdrojové články jako
  
  Konektor nastaví fázi pracovního postupu zdrojových článků na vybranou fázi (např. Překlady dokončeny), jakmile je překlad exportován.
Poznámka

Podpora pracovních postupů byla společností Contentful ukončena dne 1. června 2023. Další používání není podporováno.