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 edice

    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

    Překladový plugin Phrase pro Adobe Experience Manager následuje stejná období podpory produktu jako Adobe Experience Manager. 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. Instalátor bude k dispozici, ale nebudou implementována žádná další vylepšení ani opravy.

    • Plugin verze 2.X podporuje 6.5.

    • Plugin verze 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 v CAT Web Editoru i CAT Desktop Editoru.

    Tabulky, sloupce, různé grafiky, formátování a písma (pokud jsou uživateli nainstalována) jsou podporovány. 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:

    • Projděte přes Enterprise firewall pro přístup k on-premise instalaci.

    • Autentizujte se do autorského prostředí.

    Konfigurace firewallu pro on-premise instalaci:

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

    • Název doména musí být externě rozlišitelný.

    Poznámka

    Některé HTML tagy představují riziko a CAT Editor je při zobrazení náhledu z tohoto HTML odstraní. To slouží k zajištění ochrany osobních údajů a bezpečnosti uživatele.

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

    Nastavení Phrase TMS

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

    Tip

    Vytvořit nového uživatele s názvem phrase-preview a přidat uživatele do skupiny Autor.

    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 pro konektor.

    5. Zadejte Hostitel.

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

      Název doména musí být externě rozlišitelný (nikoliv doména intranetu).

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

      Systém jednotného přihlašování (SSO) a dvoufaktorové ověření (2FA) nejsou podporovány. Pokud je pro uživatelský účet Drupal vynuceno SSO nebo 2FA, použijte vyhrazený uživatelský účet služby, který je od obou osvobozen.

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

      Příklad:

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

      Odkazy v tagá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.

    Odstranit konektor

    Postup odstranění konektoru:

    1. Na stránce Integrace vyberte konektor, který chcete odstranit.

    2. Klikněte na Odstranit.

      Otevře se okno Odstranit konektor.

    3. Napište „odstranit“ 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 zakázkami v projektu, včetně zakázek 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í zakázky. Přejděte do nastavení/koš a vyprázdněte jej, abyste odebrali všechny zakázky, které jsou stále propojeny s konektorem. Zkuste konektor odstranit znovu.

    Poznámka

    Některé HTML tagy představují riziko a CAT Editor je při zobrazení náhledu z tohoto HTML odstraní. To slouží k zajištění ochrany osobních údajů a bezpečnosti uživatele.

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

    Konfigurovat pracovní postup překladu

    Chcete-li konfigurovat zpracování zakázek Adobe Experience Manager, vytvořte šablonu projektu nakonfigurovanou podle vašich potřeb:

    • V části přístup a zabezpečení aktivujte možnost Povolit načítání externího obsahu v Phrase CAT Editoru.

    Pokud používáte starší verze, bude nutné vytvořit a ověřit službu a portál zadavatele. Chcete-li konfiguraci ověřit, postupujte podle těchto kroků:

    1. Otevřete nedokončený projekt.

    2. Vyberte Stáhnout z nabídky dlaždice zakázka.

    3. Najděte soubor .XML, který obsahuje zdrojový text, ve staženém souboru zip.

    4. V Phrase přejděte na portály zadavatelů používané pro integraci a otevřete uvedený URL.

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

    6. Ověřte, že byl nový projekt vytvořen ze šablony projektu podle konfigurace.

    Konfigurace AEM

    Nainstalovat plugin

    On-premise AEM

    1. Pokud migrujete z verze 6.2 nebo 6.3 na 6.4 a vyšší, odeberte všechny konfigurace starších cloudových služeb z nástroje správce Classic UI (/miscadmin#/etc/cloudservices/memsource-translation)

      Všechny konfigurace zmizí ze starších cloudových služeb > Plugin Memsource Translation pro AEM.

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

    3. Odinstalujte předchozí verzi pluginu, pokud je to relevantní.

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

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

    AEM jako služba (Cloud Service)

    Pokud je plugin již nainstalován, přejděte na fázi 4.

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

      <repositories>
...
  <repository>
    <id>project.local</id>
    <name>project</name>
    <url>file:${maven.multiModuleProjectDirectory}/repository</url>
  </úložiště>
...
</repositories>

    2. Přidat 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řidat 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>
  <configuration>
  <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řidat plugin do místního úložiště maven. Spusťte následující příkaz z kořenového adresáře projektu AEM cloud služba a nahraďte zástupný znak {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>

    Konfigurace pluginu

    Jsou vyžadovány dvě konfigurace:

    • Informujte systém, že Phrase existuje, přidáním jako poskytovatel překladatelské služby a určením způsobu připojení k TMS.

    • Informujte Adobe Experience Manager, kdy a jak se má Phrase použít, konfigurací integrace překladu.

      Příklad:

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

    Přidat Phrase jako poskytovatel překladatelské služby

    Postupujte podle těchto kroků:

    1. V Nástroje, Obecné přejděte do Prohlížeč konfigurací.

    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 Cloudové služby přejděte do Cloudové služby překladu.

    4. Rozbalte adresář conf.

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

      • Název hostitele: Výchozí URL je https://cloud.memsource.com/web/, ale může se lišit, pokud vy nebo LSP používáte vlastní URL.

      • Uživatelské jméno a Heslo (musí být v roli PM s povolenou možností Upravit globální nastavení serveru v uživatelských právech).

      Klikněte na Připojit.

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

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

        Všechny překladové zakázky 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 v nastavení šablony projektu Phrase současně povoleny volby Set job to completed once pre-translated a Set project to completed once all jobs are completed.

      • Set Phrase job status to Delivered after import to AEM 

      • Vytvořit analýzu 

        Pokud je aktivní, po odeslání překladové zakázky se po importu souborů automaticky vygenerují analýzy. Analýzy jsou vždy generovány podle jazyka, bez ohledu na nastavení šablony projektu. 

      • Generate quotes 

        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ší verze budou vyžadovány také informace o služba a portál zadavatele.

    Nastavit integraci překladu

    Při použití pluginu Phrase Translation pro AEM jsou všechny soubory v překladových zakázkách odeslány k překladu a následně vráceny z Phrase. Použijte konfiguraci projektu integrace, abyste zabránili zahrnutí nepřekládaného textu nebo referencí do projektů.

    1. V Nástrojích přejděte na Cloud Services a klikněte na Translation Cloud Services.

    2. Vytvořte novou konfiguraci specificky pro překlad.

      • Ujistěte se, že Translate Component Strings a Translate Tags nejsou zaškrtnuty.

      • Nastavte Translate page assets na Do not translate.

      • Na záložce Assets nastavte pracovní postup na Do not translate.

    3. Pokud projekt stále obsahuje nepřekládaný text nebo reference, označte je a Odstranit přímo ve Phrase.

    Použít integraci na weby

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

    Chcete-li použít integrace překladu:

    • Na záložka Advanced Vybrat nově vytvořenou konfiguraci jako Cloud Configuration.

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

    odeslat obsah k překladu

    Chcete-li odeslat obsah (weby, prostředky) k překladu, vytvořit projekt překladu v Adobe Experience Manager. Projekt lze vytvořit ručně v sekci Projekt nebo použí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, Vybrat ji a otevřete References Panel.

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

    3. Vybrat cílové jazyky, volitelně zrušte zaškrtnutí Select all sub-pages.

    4. Vybrat Create Multi-language Translation Project.

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

    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.

      Pokud je vše správně nakonfigurováno, jsou odkazována nastavení vytvořená v krocích výše.

    8. Chcete-li odeslat zakázka, Vybrat Start z nabídky dlaždice zakázka.

      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 zakázky AEM je nastaven na Committed for translation.

      • Jakmile je zakázka přijata poskytovatelem, stav položky zakázky AEM se změní na Translation in progress.

      • Stav položky zakázky AEM se změní na Cancelled, pokud je zakázka odstraněna nebo zrušena.

      Tip

      Adobe Experience Manager dotazuje stav zakázky podle plánu, který je nakonfigurován v Translation Platform Configuration, ke kterému se přistupuje přes Web Console.

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

      Aktualizace stránky s podrobnostmi o projektu vynutí stažení.

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

    10. Pokud je zakázka zamítnuta, první fáze pracovního postupu zakázky je nastavena na Emailed a zbývající fáze pracovního postupu na New.

    11. Jakmile je položka zakázky AEM přijata, stav zakázky se aktualizuje na Delivered podle nastavení pluginu.

    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ý jazyk.

    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. Použijte kód jazyka Adobe Experience Manager jako Name (např. zh), ponechte Type: nepřekládaný text (NT):unstructured.

    5. Přidat vlastnost:

      • 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 jako služba (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í v 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 zakázka na překlad 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.

    Řešení potíží s AEM

    Problém

    Příčina(y)

    Řešení

    Cloud Manager hlásí výstrahu „Dotaz bez indexu“ pro dotaz na translationObjectID pod /content/projects

    Konektor Phrase AEM vyhledává uzly zakázky na překlad 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řidat vlastní definici indexu Oak/Lucene typu oak:QueryIndexDefinition, vymezenou na /content/projects, s indexem vlastnosti na translationObjectID. Nasaďte definici indexu 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úžením 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í AEM nastaví 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.