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 článku Contentful (Strings).

Contentful poskytuje infrastrukturu pro správu obsahu bez front-endu (headless) pro 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 dedikované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áznamů (starší verze)

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 polí (starší verze)

Použijte konektor Contentful (Field-Level).

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 případně také 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 označeny za zastaralé dne 30. listopadu 2026. Nové instance těchto konektorů lze vytvářet do 17. srpna 2026. Přejděte na nový konektor dříve, než budou starší konektory označeny za zastaralé.

Úplného průvodce migrací naleznete v části Legacy Connector Deprecation.

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 pro 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 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 editorům nebo manažerům obsahu umožňuje mít plnou kontrolu nad procesem lokalizace a při prohlížení záznamu získávat průběžné informace o jeho stavu.

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 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. Při 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 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 využít domovskou obrazovku Phrase TMS k:
- Hromadnému odesílání záznamů.
- 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 ú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 rámci Phrase TMS.
Klikněte na Instalovat.

Volitelné – aplikace Launch App (označená společností Contentful za zastaralou)

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 automatizovaného vytváření projektů (APC) vytvoří nové projekty vždy, když je u sledovaných článků nebo typů obsahu zjištěna změna kroků workflow.

Odeslané úlohy lze zrušit, což umožňuje obsah po provedení změn znovu odeslat. Tyto úlohy budou v systému Phrase nadá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 hodnotu pole 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 Phrase Contentful App, pokud konektor používáte s touto aplikací.
1. Klikněte na Generovat token.
  
  Otevře se okno Generovat token Contentful.
2. Klikněte na Generovat token.
  
  Vygenerovaný token zkopírujte do schránky nebo do textového souboru. Před zavřením okna token zkopírujte, protože se už znovu nezobrazí. Tento token se použije 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, který má všechny uvedené štítky.
  - S alespoň jedním tagem
    
    Zobrazí obsah z Contentful alespoň s jedním z uvedených štítků.
V případě potřeby vyberte Zahrnout mediální 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, abyste mohli podrobněji řídit, jak systém prochází vztahy mezi položkami 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
  
  Vyloučit záznamy, jejichž nadřazený typ obsahu odpovídá zadanému seznamu.
- Tagy
  
  Vyberte, zda se má u záznamů s některým ze zadaných štítků obsahu zastavit, nebo zda se mají dále 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 vypíše hodnoty taxonomie Contentful pro každý segment. Hodnoty taxonomie nejsou přeložitelným obsahem. Nelze je vypsat, importovat ani exportovat jako samostatnou úlohu, a to ani samostatně, ani společně se záznamem.
- Pokud metadata taxonomie nejsou k dispozici nebo s nimi konektor není nakonfigurován, podokno Kontextová poznámka se nezobrazí.
- 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.

Nastavení Sledovat aliasy se vztahuje na monitorování APC, opětovný import úloh a export úloh. Vztahuje se také na záznamy odeslané prostřednictvím aplikace Phrase Contentful z adresy URL aliasu. Aplikace zaznamená alias při odeslání, takže konektor tyto záznamy najde i po změně cíle aliasu. Záznamy odeslané v době, kdy alias odkazoval na dřívější prostředí, zůstávají pro konektor viditelné. Každý záznam se nadále exportuje do prostředí, ze kterého byl odeslán, a znovu se z něj importuje.

Konektor, který sleduje alias, nenajde záznamy odeslané z adresy URL konkrétního prostředí namísto adresy URL aliasu. Také nenajde záznamy odeslané prostřednictvím aplikace před přidáním podpory aliasů. Tyto záznamy odešlete znovu z Contentful prostřednictvím adresy URL 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 jeho obsah; úlohy se do něj exportují a znovu se z něj importují.
- Povoleno
  
  APC a vytvořené úlohy jsou vázány na samotný alias. APC monitorují pouze tento alias a jeho obsah; úlohy se přes něj exportují a znovu importují.
  
  Pokud se cíl aliasu změní, APC budou monitorovat nový cíl aliasu (prostředí); úlohy se nyní budou do tohoto prostředí exportovat a znovu se z něj importovat.
  
  U záznamů odeslaných prostřednictvím aplikace Phrase Contentful App se úlohy exportují do prostředí, ze kterého byl záznam odeslán, a znovu se z něj importují.
Vlastní role v 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. Tento přístup přidejte v Contentful v části Nastavení prostoru Contentful / Role, v sekci Prostředí dané role. Pokud je alias později přesměrován na jiné prostředí, přidejte přístup i k tomuto novému prostředí.
V případě potřeby zadejte 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 z 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 k Contentful.

Kód jazyka momentálně není podporován v podobě zástupných znaků. Chcete-li v adrese URL použít jazykové nastavení, zadejte pevnou hodnotu a vytvořte více instancí konektoru.
V případě potřeby použijte Vynechat překládatelná pole k vyloučení konkrétních polí z importu do Phrase. Uveďte identifikátory ContentID, které mají být z importu vynechány.
Uveďte ID prostoru a token pro mapování 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í, které chcete z Contentful monitorovat/importovat.
- Nastavení a přístup jsou spravovány přímo v rámci Contentful.
Klikněte na Uložit.

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

Poznámka

Monitorová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. Odkazované záznamy se načítají jednotlivě, nikoli v dávkách, takže v prostorech s mnoha odkazovanými záznamy může jedno spuštění vygenerovat velký 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ěhy APC a výrazně zvýšit využití rozhraní Contentful API.

Chcete-li tento dopad 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í Odkazované záznamy pouze na záznamy, které vyžadují překlad.
Použijte aplikaci Phrase Contentful, která monitoruje 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 Start over (nebo použít hromadné opětovné odeslání z řídicího panelu aplikace), než jej APC zachytí a aktualizuje zdrojový text stávající úlohy. To se liší od konektorů monitorujících soubory nebo složky, kde APC detekuje změny zdroje automaticky, aniž by vyžadovalo manuální opětovné odeslání.

Konektor Contentful 2.0 patří vaší organizaci, nikoli jednotlivému uživateli. Token OAuth pro Contentful, který konektor používá, je vázán na uživatele, který jej autorizoval.

Chcete-li propojit konektor s jiným uživatelem Contentful, musí být stávající token OAuth odstraněn, aby mohl jiný uživatel konektor znovu autorizovat:

Pomocí účtu Contentful, který vytvořil token, otevřete stránku API tokenů pro příslušný prostor (https://app.contentful.com/spaces/{space_id}/api/cma_tokens).
Odstraňte token s názvem „Memsource Connector“. Pokud má tento název více tokenů, před odstraněním ověřte, který z nich dotčený konektor používá.
Jakmile je token odstraněn, konektor je deaktivován, dokud jej nový uživatel znovu neautorizuje v nastavení konektoru v Phrase TMS.

Tyto kroky dokončete před odebráním přístupu původního uživatele k Contentful, jinak token již nemusí být viditelný.

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 provedli ověření potřebné k 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ň záznamů) nebo Contentful (úroveň polí) 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ý zadáte do aplikace Contentful pro Phrase TMS. Po vygenerování tokenu a jeho zkopírování do aplikace Contentful konektor uložte.
Poznámka

Jakmile je konektor uložen, nelze token v 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é načte obsah v jazyce nastaveném v konfiguraci konektoru.
  
  Příklad:
  
  Pokud je v Contentful jako výchozí jazyk nastavena jazyková varianta EN-US, ale pro lokalizaci v konkrétním prostoru nebo modelu obsahu je jako zdrojový jazyk vyžadována varianta DE-DE, lze konfiguraci upravit tak, aby prostor (vzdálená složka) načítal obsah ve variantě DE-DE místo EN-US.
Poznámka

Při používání aplikace se neuplatňuje.
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áření hierarchie entit.

Poznámka

Při používání aplikace se neuplatňuje.
- Contentful (úroveň záznamů)
  
  Konektor na úrovni záznamů automaticky prochází celou hierarchii vnořeného obsahu.
- Contentful (úroveň polí)
  
  Vyberte, jak má konektor na úrovni polí 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.
V poli Vynechat přeložitelná pole vytvořte čárkami oddělený seznam polí, u nichž je zaškrtnuta možnost Povolit lokalizaci tohoto pole a která se mají vynechat 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 rozevíracího seznamu Záložní zdrojový jazyk. V případě chybějících dat se použije tato jazyková varianta.

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).

Jedná se o šablonu adresy URL odkazující na vykreslený obsah ze služby 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 z 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 k Contentful.

Kód jazyka momentálně není podporován v podobě zástupných znaků. Chcete-li v adrese URL použít jazykovou variantu, 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í symbol zaškrtnutí. Pokud nebylo, zobrazí se červený vykřičník. Další podrobnosti zobrazíte, když najedete na ikonu.
Pouze Contentful (úroveň záznamů):

Nastavte Zdrojový jazyk.

Poznámka

Tento jazyk by měl odpovídat výchozí jazykové variantě prostoru Contentful nastavené v nastavení jazykových variant v 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.
Při 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.
Při exportu 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.