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 bezhlavou infrastrukturu pro správu obsahu, která umožňuje vytváření, správu 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 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í adresy URL náhledu
Import referencí
Filtrování obsahu na základě štítků
Konfigurace živého náhledu

Lokalizace na úrovni záznamu (zastaralé)

Použijte konektor Contentful (úroveň záznamu).

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é má povolenou lokalizaci).

Lokalizace na úrovni polí (starší verze)

Použijte konektor Contentful (úroveň polí).

Konektor na úrovni polí 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é

Starší konektory budou ukončeny podpory 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ších konektorů.

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ílatelů, 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 přímo odeslat záznam k lokalizaci z prostředí Contentful. To umožňuje editorům obsahu nebo manažerům mít plnou kontrolu nad lokalizačním procesem a získávat aktuální informace o 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 pouze záznam s vybranými jazyky do Phrase TMS 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 jsou vybrána pouze některá lokalizovatelná pole, k překladu budou odeslána pouze tato pole.
- Na základě nastavení APC jsou úlohy z odeslaného obsahu vytvářeny automaticky. Během spuštění APC jsou pro vytvoření úlohy vybrány pouze záznamy ve stavu odesláno.
- Jakmile jsou úlohy z odeslaného záznamu vytvořeny, stav se změní na rozpracováno. Když jsou překlady odeslány zpět do Contentful, stav se změní na hotovo.
- Dříve přeložené záznamy lze po změnách v původním textu odeslat znovu.
Editoři obsahu mohou využít domovskou obrazovku Phrase TMS k:
- Odesílejte záznamy hromadně.
- Specifikujte jednotlivé cílové jazyky při hromadném odesílání.
- 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 autentizační token Phrase TMS získaný při vytváření konektoru v Phrase TMS.
Klikněte na Instalovat.

Volitelně – Spustit aplikaci (funkce již není podporována v 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 jedno 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 obsah znovu odeslat po provedení změn. Tyto úlohy budou v Phrase stále existovat a bude je muset odstranit 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 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 Vygenerovat token.
  
  Otevře se okno Vygenerovat token Contentful.
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. 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 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 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 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 obsahových štítků, 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 Zahrnout taxonomii.

Zobrazí se pole ID organizace Contentful. Zadejte hodnotu pro povolení nastavení taxonomie.
- Po výběru konektor načte taxonomie z Contentful a zahrne je do souboru .XLIFF. Podokno Kontextová poznámka v editoru CAT zobrazí hodnoty taxonomie Contentful pro každý segment.
- Pokud metadata taxonomie nejsou k dispozici nebo s nimi konektor není nakonfigurován, podokno Kontextová poznámka 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 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.
- Zakázáno (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 z něj reimportová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 z něj reimportovány.
  
  Pokud se cíl aliasu změní, 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 aliasu samotnému, jinak se řídicí panel aplikace Phrase TMS nenačte. Přidejte tento přístup v Contentful pod Contentful Space Settings/Roles, v sekci Environments dané role. Pokud bude 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 uveďte Preview URL.

Toto je šablona 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 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 živý náhled, nahraďte contentfulapp.tld v šabloně URL skutečnou doménou aplikace.

Další informace o nastavení content preview 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, specifikujte pevnou hodnotu a vytvořte více instancí konektoru.
V případě potřeby použijte Omit translatable fields k vyloučení konkrétních polí z importu do Phrase. Uveďte ContentID, která mají být z importu vynechána.
Uveďte Space ID a Token pro Space preview token map (vyžadováno).

Preview API vyžaduje přístupový token Contentful s názvem Content Preview API – access token, který musí být nastaven 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í, které chcete z Contentful 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 neoznamuje, u kterého locale došlo ke změně. Referencované záznamy jsou načítány jednotlivě, nikoli v dávkách, takže u prostorů 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 počtem záznamů to může zpomalit běhy APC a výrazně zvýšit využití Contentful API.

Chcete-li toto omezit:

Jakmile je záznam hotový, odstraňte překladový štítek a znovu jej přidejte pouze v případě, že vyžaduje opětovný překlad.
Omezte nastavení odkazovaných záznamů pouze na ty záznamy, které vyžadují překlad.
Použijte aplikaci Phrase Contentful, která monitoruje pouze záznamy 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ěření vyžadované pro vytvoření nebo uložení konektoru. Po uložení lze ke konektoru přistupovat prostřednictvím vlastní domény.

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ň záznamu) nebo Contentful (úroveň 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 aplikace Contentful v Phrase TMS. Po vygenerování tokenu a jeho zkopírování do aplikace Contentful uložte konektor.
Poznámka

Po uložení nelze token v rámci aplikace Contentful změnit. Chcete-li jej aktualizovat, odstraňte token v konfiguraci konektoru v systému Phrase TMS a vygenerujte nový.
Nakonfigurujte nastavení nezávislá na jazyce.
- Zdrojový jazyk
  
  Vyberte zdrojový jazyk, který přepíše výchozí jazyk v aplikaci Contentful. Konektor poté načte obsah z jazyka nastaveného v konfiguraci konektoru.
  
  Příklad:
  
  Pokud je v aplikaci Contentful jako výchozí jazyk nastaven EN-US, ale pro lokalizaci v konkrétním prostoru nebo datovém modelu je vyžadován jazyk DE-DE, lze konfiguraci upravit tak, aby prostor (vzdálená složka) načítal obsah z DE-DE namísto EN-US.
Poznámka

Při používání aplikace se nepoužije.
Vyberte způsob zpracování vnořeného obsahu prostřednictvím režimu importu záznamů. Obsah může využívat referenční pole k odkazování na jiný obsah, což umožňuje vytvářet hierarchii entit.

Poznámka

Při používání aplikace se nepoužije.
- Contentful (na úrovni položky)
  
  Konektor na úrovni záznamů 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
    
    Importuje se obsah, který je explicitně vybrán při přidávání z úložiště.
    
    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 Vynechat přeložitelná pole pro vynechání polí, která jsou zaškrtnuta pro Povolit lokalizaci tohoto pole, z importu do Phrase TMS. Použijte následující strukturu: contentTypeID:fieldID.
- Vyberte Ponechat vynechaná pole prázdná, pokud mají být uvedená pole ponechána prázdná. Toto nastavení bude použito u všech uvedených položek.
- Vyberte Kopírovat zdroj do cíle, pokud mají uvedená pole obsahovat zdrojové hodnoty. Toto nastavení bude použito u všech uvedených položek.
Vyberte Použít záložní jazyk, pokud u konkrétního pole ve zdrojovém jazyce chybí data.

V případě potřeby vyberte Záložní zdrojový jazyk z rozevíracího seznamu. Toto jazykové prostředí bude použito 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 URL živého náhledu (BETA).

Toto je šablona 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 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 živý náhled, nahraďte contentfulapp.tld v šabloně URL skutečnou doménou aplikace.

Další informace o nastavení content preview naleznete v dokumentaci Contentful.

Kód jazyka momentálně není podporován v podobě zástupných znaků. Chcete-li v URL použít jazykové prostředí, zadejte pevnou hodnotu a vytvořte více instancí konektoru.
Pokud technická podpora vyžaduje 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 (na úrovni záznamu):

Nastavte Zdrojový jazyk.

Poznámka

Tento jazyk by měl odpovídat výchozí lokalitě prostoru Contentful, která je nastavena v nastaveních lokalit v Contentful.
Klikněte na Uložit.

Konektor je přidán do seznamu na stránce Konektory.
Volitelně upravte konektor a vyberte Contentful workflows.
- 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.

Odstranit konektor

Postup odstranění konektoru:

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, které jsou 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í ú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.