Integrace
    1. Phrase
    2. Phrase TMS
    3. Integrace

    Adobe Experience Manager – AEM (TMS)

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

    K dispozici pro

    • Enterprise plán

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

    Podporované verze

    Plugin Phrase Translation pro Adobe Experience Manager dodržuje stejná období podpory produktů jako Adobe Experience Manager. Další informace o obdobích podpory naleznete na https://helpx.adobe.com/support/programs/eol-matrix.html.

    Jakmile verze Adobe Experience Manager dosáhne konce základní podpory, Phrase již plugin neudržuje. Instalační program bude k dispozici, ale nebudou implementována žádná další vylepšení ani opravy.

    • Verze pluginu 2.x podporuje 6.5.

    • Verze pluginu 3.x podporuje AEM as a Cloud Service.

    Poznámky k vydání pluginu

    Konfigurace Phrase

    Konfigurace náhledu v kontextu

    Funkce náhledu v kontextu nabízí náhled původního nebo přeloženého textu v reálném čase, a to jak ve webovém editoru CAT, tak v desktopovém editoru CAT.

    Podporovány jsou tabulky, sloupce, různé grafiky, formátování a písma (pokud jsou uživateli nainstalována). Tato funkce má poskytnout kontext při překladu a není dokonalým zobrazením původního nebo dokončeného dokumentu; lze očekávat určité vizuální rozdíly. Může být také ovlivněna povolením/zakázáním možnosti Povolit načítání externího obsahu v editorech v nastavení přístupu a zabezpečení.

    Požadavky Phrase:

    • Pro vstup do on-premise instalace projděte podnikovým firewallem.

    • Autentizujte se v autorském prostředí.

    Konfigurace firewallu pro on-premise instalaci:

    • Instalace musí být přístupná z IP adres serverů Phrase. Aktuální seznam naleznete v IP adresách serverů Phrase.

    • Název domény musí být možné vyřešit z vnější sítě.

    Poznámka

    Některé značky HTML představují riziko a editor CAT je při zobrazení náhledu z tohoto HTML odstraňuje. To slouží k zajištění ochrany soukromí a bezpečnosti údajů uživatele.

    Příklady odstraněných značek zahrnují FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT nebo CSS vlastnosti background-image.

    Nastavení Phrase TMS

    Předpoklad: Vytvořte uživatele Adobe Experience Manager s minimálními oprávněními potřebnými k zobrazení nezveřejněných stránek.

    Tip

    Vytvořte nového uživatele pojmenovaného phrase-preview a přidejte jej do skupiny Authors.

    1. Na stránce Nastavení Setup_gear.png přejděte dolů do oddílu Integrace.

    2. Klikněte na Konektory.

      Otevře se stránka Konektory.

    3. Klikněte na Nový konektor.

      Otevře se stránka Vytvořit konektor.

    4. Změňte Typ na Adobe Experience Manager Live Preview a zadejte název konektoru.

    5. Zadejte Host.

      Použijte adresu hostitele instalace Adobe Experience Manager (např. https://aem-author.example.org/ nebo https://author-X-Y.adobeaemcloud.com/).

      Název domény musí být možné vyřešit z vnější sítě (nikoli intranetová doména).

    6. Zadejte uživatelské jméno a heslo.

      Jednotné přihlašování (SSO) a dvoufaktorové ověřování (2FA) nejsou podporovány. Pokud je u účtu Drupal vynuceno SSO nebo 2FA, použijte vyhrazený servisní účet, který je od obou osvobozen.

    7. Chcete-li upravit odkazy obsažené v HTML stránky, zadejte pravidlo pro přepisování URL pomocí regex.

      Příklad:

      Chcete-li nahradit úplný kód národního prostředí pouze kódem jazyka v https://example.org/en-us/images/sample.jpg, vyhledejte /([a-z]{2})-[a-z]{2}/ a nahraďte ho /$1/.

      Odkazy ve značkách <img src=\"\" data-lazy-src=\"\", <link href=\"\", <script src=\"\", <iframe src=\"\" a odkazy ve stylech CSS a odkazovaných souborech CSS (url: ('')) budou přepsány.

    8. Klikněte na Uložit.

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

    Smažte konektor

    Chcete-li smazat konektor:

    1. Na stránce Integrations vyberte konektor, který chcete smazat.

    2. Klikněte na Delete.

      Otevře se okno Delete connector.

    3. Napište „delete“ a klikněte na Delete.

      Konektor je smazán a zobrazí se seznam konektorů.

    Poznámka

    Konektor nelze smazat, pokud je stále propojen s nedokončenými úlohami v projektu, včetně úloh v koši. Pokus o smazá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 smažte všechny zbývající úlohy. Přejděte do Settings/Recycle bin a vyprázdněte jej, abyste odstranili všechny úlohy, které jsou stále propojeny s konektorem. Zkuste konektor smazat znovu.

    Poznámka

    Některé značky HTML představují riziko a editor CAT je při zobrazení náhledu z tohoto HTML odstraňuje. To slouží k zajištění ochrany údajů uživatele a jeho bezpečnosti.

    Příklady odstraněných značek zahrnují FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT nebo vlastnosti CSS background-image.

    Konfigurujte překladový workflow

    Pro konfiguraci zpracování úloh Adobe Experience Manager vytvořte šablonu projektu nakonfigurovanou podle vašich potřeb:

    • V části Access and Security aktivujte možnost Allow loading of external content in Phrase CAT editor.

    Pokud používáte starší verze, bude nutné vytvořit a ověřit service a submitter portal. Pro ověření konfigurace postupujte podle těchto kroků:

    1. Otevřete nedokončený překladový projekt.

    2. V nabídce dlaždice Úloha vyberte Export.

    3. Ve staženém souboru zip vyhledejte soubor .XML, který obsahuje zdrojový text.

    4. V systému Phrase přejděte na Portály odesílatelů používané pro integraci a otevřete uvedenou adresu URL.

    5. Vyplňte formulář SP, nahrajte soubor .XML, ověřte e-mail a odešlete.

    6. Ověřte, zda byl nový projekt vytvořen z šablony projektu podle konfigurace.

    Konfigurace AEM

    Nainstalujte plugin

    Stáhněte si nejnovější balíček pluginu ze stránky Ekosystém Phrase ve Phrase pomocí tlačítka Stáhnout. Plugin je k dispozici pouze organizacím, které si jej zakoupily.

    On-premise AEM

    1. Pokud migrujete z verze 6.2 nebo 6.3 na verzi 6.4 a vyšší, odstraňte všechny konfigurace Legacy Cloud Services z nástroje Classic UI Admin (/miscadmin#/etc/cloudservices/memsource-translation).

      Všechny konfigurace zmizí z Legacy Cloud Services > Memsource Translation Plugin for AEM.

    2. V Nástroje, Nasazení, přejděte na Balíčky.

    3. Odinstalujte předchozí verzi pluginu, je-li to možné.

    4. Vyberte Nahrát balíček a nahrajte instalační soubor.

    5. Zaškrtněte Vynutit nahrání a odešlete.

    AEM as a Cloud Service

    Pokud je plugin již nainstalován, přejděte ke kroku 4.

    1. Přidejte do kořenového adresáře projektu AEM cloud service pom.xml úložiště maven založené na místním souborovém systému:

      repositories {

  Repozitář
    <id>project.local</id>
    <name>projekt</name>
    <url>file:${maven.multiModuleProjectDirectory}/repository</url>
  Repozitář

repositories {

    2. Přidejte závislost pluginu do all/pom.xml:

      <dependency>
  <groupId>com.memsource</groupId>
  <artifactId>aem-memsource-plugin.all</artifactId>
  <version>X.X.X</version>
  <type>zip</type>
</dependency>

    3. Přidejte vložený blok do konfigurace all/pom.xml -> filevault-package-maven-plugin:

      plugin
  <groupId>org.apache.jackrabbit</groupId>
  <artifactId>filevault-package-maven-plugin</artifactId>
  <extensions>true</extensions>
  Konfigurace
  <group>my_packages</group>
  <embeddeds>
   <embedded>
     <groupId>com.memsource</groupId>
     <artifactId>aem-memsource-plugin.all</artifactId>
     <type>zip</type>
     <target>/apps/aem-memsource-plugin-packages/application/install</target>
   </embedded>

    4. Přidejte plugin do lokálního úložiště maven. Spusťte následující příkaz z kořenového adresáře projektu AEM cloud service a nahraďte zástupný symbol {memsource.plugin.path} cestou k pluginu (např. /tmp/aem-memsource-plugin.all-3.0.1.zip):

      mvn org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file -Dfile={memsource.plugin.path} -DlocalRepositoryPath=./repository/ -Dpackaging=zip

    5. Nastavte správnou verzi pluginu v all/pom.xml (např. 3.0.1):

      <dependency>
  <groupId>com.memsource</groupId>
  <artifactId>aem-memsource-plugin.all</artifactId>
  <version>3.0.1</version>
  <type>zip</type>
</dependency>

    Nakonfigurujte plugin

    Jsou vyžadovány dvě konfigurace:

    • Informujte systém o existenci Phrase přidáním jako poskytovatele překladatelských služeb a specifikujte způsob připojení k TMS.

    • Informujte Adobe Experience Manager, kdy a jak se má Phrase používat, prostřednictvím konfigurace integrace překladu (Translation Integration Configuration).

      Příklad:

      Používejte Phrase pro obsah s vysokou viditelností, ale pro komunitní obsah využijte poskytovatele strojového překladu.

    Přidání Phrase jako poskytovatele překladatelských služeb

    Postupujte podle těchto kroků:

    1. V Tools, General přejděte do Configuration Browser.

    2. Vytvořte konfigurační kontejner pro každou službu Phrase (např. jednu konfiguraci pro lidský překlad a samostatnou konfiguraci pro strojový překlad).

    3. V Cloud Services přejděte do Translation Cloud Services.

    4. Rozbalte adresář conf.

    5. Vytvořte novou konfiguraci a zadejte následující informace:

      • Hostname: Výchozí adresa URL je https://cloud.memsource.com/web/, ale může se lišit, pokud vy nebo poskytovatel jazykových služeb (LSP) používáte vlastní adresu URL.

      • Username a Password (musí mít roli PM s povolenou možností Modify global server settings v uživatelských právech).

      Klikněte na Connect.

    6. Vyberte další možnosti a zavřete konfiguraci.

      • Seskupte všechny překladové úlohy do jednoho projektu Phrase 

        Všechny překladové úlohy v rámci jednoho projektu AEM budou také vytvořeny v rámci jednoho projektu Phrase.

        Důležité

        Tato možnost nefunguje správně, pokud jsou současně v nastavení šablony projektu Phrase povoleny volby Nastavit úlohu jako dokončenou po předpřekladu a Nastavit projekt jako dokončený po dokončení všech úloh.

      • Nastavit stav úlohy Phrase na Dodáno po importu do AEM 

      • Vytvořit analýzu 

        Pokud je tato možnost aktivní, po odeslání překladové úlohy se při importu souborů automaticky vygenerují analýzy. Analýzy se vždy generují podle jazyka, bez ohledu na nastavení šablony projektu. 

      • Vygenerujte cenové nabídky 

        Pokud je aktivováno automatické generování analýz, lze na základě těchto analýz generovat cenové nabídky.

    Při použití starších verzí budou vyžadovány také informace o službě a portálu odesílatele.

    Nastavte integraci překladů

    Při používání doplňku Phrase Translation Plugin pro AEM jsou všechny soubory v překladových úlohách odeslány k překladu a následně vráceny z Phrase. Použijte konfiguraci projektu Integrace překladů, abyste zabránili zahrnutí nepřeložitelných prostředků nebo referenčních materiálů do projektů.

    1. V nabídce Nástroje přejděte na Cloud Services a klikněte na Translation Cloud Services.

    2. Vytvořte novou konfiguraci speciálně pro překlad.

      • Ujistěte se, že Přeložit řetězce komponent a Přeložit štítky nejsou zaškrtnuty.

      • Nastavte Přeložit prostředky stránky na Nepřekládat.

      • Na kartě Prostředky nastavte Překladový pracovní postup na Nepřekládat.

    3. Pokud projekt stále obsahuje nepřeložitelné prostředky nebo referenční materiály, označte je a odstraňte přímo ve Phrase.

    Použijte integraci překladů na weby

    Nakonfigurujte výchozího poskytovatele překladů Phrase s různými částmi taxonomie webu. Nakonfigurujte poskytovatele v kořenovém uzlu webu. Všechny podřízené stránky toto nastavení zdědí. Přepište nastavení v uzlu, který by měl používat jinou konfiguraci poskytovatele (např. celý web používá lidský překlad, ale komunitní sekce používá strojový překlad).

    Pro aplikaci integrace překladu:

    • Na kartě Advanced vyberte nově vytvořenou konfiguraci jako Cloud Configuration.

    Při přidávání obsahu z těchto stránek bude přidán pouze přeložitelný obsah. Pokud je projekt vytvořen z References Panel, bude automaticky nastaven tak, aby používal cloudovou konfiguraci přidruženou ke kořenové stránce.

    Odešlete obsah k překladu

    Chcete-li odeslat obsah (Sites, Assets) k překladu, vytvořte projekt překladu v Adobe Experience Manager. Projekty lze vytvářet ručně v sekci Projekty nebo lze využít vestavěné pracovní postupy pro minimalizaci úsilí.

    Chcete-li připravit projekt k odeslání prostřednictvím vestavěných pracovních postupů, postupujte takto:

    1. V zobrazení Sites přejděte na stránku, vyberte ji a otevřete References Panel.

    2. Klikněte na Language Copies a rozbalte sekci Create & Translate v dolní části panelu.

    3. Vyberte cílové jazyky, případně zrušte zaškrtnutí Select all sub-pages.

    4. Vyberte Create Multi-language Translation Project.

      Pokud existuje více cílových jazyků, vytvoří se pro každý jazyk samostatný projekt.

    5. Zadejte název projektu a klikněte na Create.

    6. Přejděte k projektu v sekci Projects a otevřete jej.

    7. Kliknutím na tři tečky na první dlaždici otevřete pokročilé nastavení projektu.

      Při správné konfiguraci jsou využity konfigurace vytvořené v předchozích krocích.

    8. Pro odeslání úlohy vyberte Start z nabídky dlaždice úlohy.

      Nový projekt bude vytvořen během několika minut.

      • Při importu jsou poskytovatelé přiřazeni ze šablony projektu a stav položky úlohy AEM je nastaven na Committed for translation.

      • Jakmile poskytovatel úlohu přijme, stav položky úlohy AEM se změní na Translation in progress.

      • Stav položky úlohy AEM se změní na Cancelled, pokud je úloha odstraněna nebo zrušena.

      Tip

      Adobe Experience Manager pravidelně zjišťuje stav úlohy podle plánu, který je nakonfigurován v Translation Platform Configuration přístupné prostřednictvím Web Console.

      Nastavení vlastnosti Scheduler Cron na časté spouštění (např. 0 0/5 * * * ? * spustí obnovení stavu překladové úlohy každých 5 minut).

      Obnovení stránky podrobností projektu vynutí stažení aktualizací.

    9. V Phrase přeložte úlohy projektu a nastavte jejich stav na Completed. Po dokončení jsou úlohy importovány zpět do AEM.

    10. Pokud je úloha zamítnuta, první krok pracovního postupu je nastaven na Emailed a zbývající kroky pracovního postupu na New.

    11. Jakmile je položka úlohy AEM přijata, stav úlohy se aktualizuje na Delivered podle konfigurace v nastavení zásuvného modulu.

    Další podrobnosti o vytváření překladových projektů pomocí panelu odkazů naleznete v dokumentaci Adobe.

    Různé

    Vlastní mapování jazyků

    On-premise AEM

    Chcete-li mapovat jazyky Adobe Experience Manager na různé jazyky v Phrase (např. zh na zh_tw), postupujte podle těchto kroků.

    Mapování se vztahuje na zdrojové i cílové jazyky.

    1. Otevřete CRXDE (/crx/de/index.jsp).

    2. Přejděte do složky /apps/memsource-connector/language-mapping/.

    3. Vytvořte nový uzel.

    4. Jako Název použijte kód jazyka Adobe Experience Manager (např. zh), ponechte Typ: nt:unstructured.

    5. Přidání vlastnosti:

      • Název: memsourceLanguage

      • Typ Řetězec

      • Hodnota: kód jazyka (např. zh_tw)

    6. Klikněte na Uložit vše.

    Nepřiřazené kódy jazyků jsou odeslány tak, jak jsou.

    AEM as a Cloud Service

    Chcete-li přidat mapování jazyků v AEM Cloud Services, postupujte podle těchto kroků:

    1. Vytvořte soubor .content.xml ve složce /conf/aem-memsource-plugin/language-mapping/.

    2. Otevřete vytvořený soubor a zkopírujte do něj následující:

      <?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0"
    jcr:primaryType="sling:Folder"/>

    3. Vytvořte soubor .content.xml ve složce /conf/aem-memsource-plugin/language-mapping/zh-cn.

    4. Otevřete vytvořený soubor a zkopírujte do něj následující:

      <?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0"
          jcr:primaryType="nt:unstructured"
          memsourceLanguage="zh_cn">
</jcr:root>

    5. Přidejte cesty vytvořené v předchozích krocích do souboru filter.xml, který se nachází na ui.content/src/main/content/META-INF/vault/filter.xml:

      <?xml version="1.0" encoding="UTF-8"?>
<workspaceFilter version="1.0">

    <filter root="/conf/aem-memsource-plugin" mode="update"/>
    <filter root="/conf/aem-memsource-plugin/language-mapping" mode="update"/>
</workspaceFilter>

    ID projektů

    Jakmile je překladová úloha odeslána, ID projektu a UID jsou uloženy v /content/projects/project-name/jcr:content/dashboard/gadgets/translationjob jako vlastnosti PROPERTY_MEMSOURCE_PROJECT_ID a PROPERTY_MEMSOURCE_PROJECT_UID.

    Použijte tato ID pro zobrazení v prostředí AEM nebo v rozhraních API k rozšíření funkcionality pluginu.

    Odstraňování problémů v AEM

    Problém

    Příčina(y)

    Řešení

    Cloud Manager hlásí upozornění „Query Without Index“ (Dotaz bez indexu) pro dotaz na translationObjectID pod /content/projects

    Konektor Phrase AEM vyhledává uzly překladových úloh pomocí translationObjectID přiřazeného za běhu. Tento identifikátor neexistuje jako předem vytvořená vlastnost úložiště, takže AEM as a Cloud Service jej nemůže předem indexovat a vrací se k úplnému průchodu, což Cloud Manager označuje.

    Přidejte vlastní definici indexu Oak/Lucene typu oak:QueryIndexDefinition, vymezenou na /content/projects, s indexem vlastnosti na translationObjectID. Definici indexu nasaďte prostřednictvím kanálu kódu namísto jejího vytváření za běhu a před nasazením do produkce ji ověřte v neprodukčním prostředí. Omezte index na strukturu složek projektu v instanci AEM a zúžte jej na konkrétní složky projektu, kde je to možné, namísto indexování celého /content/projects, protože příliš široce vymezený index může mít vlastní dopad na výkon. Po nasazení nastaví AEM vlastnost reindex definice indexu na false, jakmile se přeindexování dokončí, což potvrzuje, že přeindexování proběhlo bez chyb a nevyžaduje žádnou další akci.
    Byl pro vás tento článek užitečný?
    ★ ★ ★ ★ ★

    Sorry about that! In what way was it not helpful?

    The article didn’t address my problem.
    I couldn’t understand the article.
    The feature doesn’t do what I need.
    Other reason.

    Note that feedback is provided anonymously so we aren't able to reply to questions.
    If you'd like to ask a question, submit a request to our Support team.
    Thank you for your feedback.