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

  • Podnikový tarif

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 se řídí stejnými obdobími podpory produktů 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, společnost 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 kontextového náhledu

Funkce kontextového náhledu 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 nepředstavuje dokonalou reprezentaci 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řístup a zabezpečení.

Požadavky Phrase:

  • Projděte podnikovým firewallem pro přístup k místní instalaci.

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

Konfigurace brány firewall pro místní instalaci:

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

  • Název domény musí být zvenčí vyřešitelný.

Poznámka

Některé značky HTML představují riziko a editor CAT je při zobrazení náhledu z tohoto HTML odstraní. To slouží k zajištění soukromí a bezpečnosti uživatelských dat.

Příklady odstraněných značek zahrnují FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT nebo vlastnosti CSS 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í nepublikovaných stránek.

Tip

Vytvořte nového uživatele s názvem phrase-preview a přidejte jej do skupiny Autoři.

  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. Volitelně povolte Vynutit zabezpečené připojení.

  6. 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ény musí být dostupný zvenčí (nikoli intranetová doména).

  7. Zadejte Uživatelské jméno pro živý náhled a Heslo pro živý náhled.

  8. 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 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 jej /$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.

  9. Klikněte na Uložit.

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

Poznámka

Některé značky HTML představují riziko a editor CAT je při zobrazení náhledu z tohoto HTML odstraní. To slouží k zajištění soukromí a bezpečnosti uživatelských dat.

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 v 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 editoru Phrase CAT.

Pokud používáte starší verze, bude nutné vytvořit a ověřit službu a portál odesílatele. Pro ověření konfigurace postupujte podle těchto kroků:

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

  2. Vyberte Export v nabídce dlaždice Úloha.

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

  4. Ve službě 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 ze šablony projektu podle konfigurace.

Konfigurace AEM

Instalace pluginu

Stáhněte si nejnovější balíček pluginu ze stránky Phrase Ecosystem v systému Phrase pomocí tlačítka Stáhnout. Plugin je dostupný 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 části Nástroje, Nasazení přejděte na Balíčky.

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

  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 v cloudu

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

  1. Přidejte lokální maven repozitář založený na souborovém systému do kořenového adresáře projektu AEM cloud service pom.xml:

    repositories {
    
      Repozitář
        <id>project.local</id>
        <name>project</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>moje_balíčky</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 místního Maven repozitáře. 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>
    

Konfigurujte plugin

Jsou vyžadována dvě nastavení:

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

  • Informujte Adobe Experience Manager, kdy a jak se má Phrase používat, prostřednictvím konfigurace integrace překladů.

    Příklad:

    Používejte Phrase pro vysoce viditelný obsah, ale pro komunitní obsah použijte poskytovatele strojového překladu.

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

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 pouze pro strojový překlad).

  3. V Cloudové služby přejděte do Cloudové překladatelské služby.

  4. Rozbalte adresář conf.

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

    • Název hostitele: 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.

    • Uživatelské jméno a Heslo (musí mít 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.

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

      Všechny překladové úlohy v rámci jednoho projektu AEM budou vytvořeny také 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 možnosti 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 „Doručeno“ po importu do AEM 

    • Vytvořit analýzu 

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

    • Generovat 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žívání 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 Cloudové služby a klikněte na Cloudové služby překladu.

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

    Poznámka

    Vytvořte konfiguraci v conf. Položky v /libs jsou výchozí hodnoty Adobe určené pouze pro čtení.

    • Zajistěte, aby Translate Component Strings a Translate Tags nebyly zaškrtnuty.

    • Nastavte Translate page assets na Do not translate.

    • Na kartě Assets nastavte Translation Workflow na Do not translate.

  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žít integraci překladu na weby

Nakonfigurujte výchozího poskytovatele překladu 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í u uzlu, který by měl používat jinou konfiguraci poskytovatele (např. celý web používá lidský překlad, ale sekce komunity používá strojový překlad).

Pro použití 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.

Odeslat obsah k překladu

Chcete-li odeslat obsah (stránky, soubory) k překladu, vytvořte projekt překladu v Adobe Experience Manager. Projekty lze vytvářet ručně v sekci Projekty nebo lze 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 podle těchto kroků:

  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 lišty.

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

  4. Vyberte Create Multi-language Translation Project.

    Pokud existuje více cílových jazyků, pro každý jazyk bude vytvořen 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. Klikněte na ikonu tří teček na první dlaždici a otevřete pokročilé nastavení projektu.

    Pokud jsou správně nakonfigurovány, jsou odkazovány konfigurace vytvořené v krocích výše.

  8. Chcete-li odeslat úlohu, vyberte Start z nabídky dlaždice úlohy.

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

    • Při importu jsou přiřazeni poskytovatelé 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ě kontroluje stav úlohy podle plánu, který je nakonfigurován v Translation Platform Configuration, přístupné přes Web Console.

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

    Obnovení stránky s podrobnostmi projektu vynutí aktualizaci.

  9. Ve službě 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 zamítnuta, první krok pracovního postupu úlohy 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í pluginu.

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

Různé

Vlastní mapování jazyků

On-premise AEM

Chcete-li mapovat jazyky Adobe Experience Manager na jiné 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. Použijte kód jazyka Adobe Experience Manager jako Název (např. zh), ponechte Typ: nt:unstructured.

  5. Přidejte vlastnost:

    • Název: memsourceLanguage

    • Typ řetěz|ec

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

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

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

AEM jako služba v cloudu

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 překladová úloha odeslána, ID projektu a UID se uloží do /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ů AEM

Problém

Příčina(y)

Řešení

Cloud Manager hlásí upozornění „Query Without Index“ 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 definovaná vlastnost úložiště, takže jej AEM as a Cloud Service nemůže předem indexovat a vrací se k úplnému průchodu, což Cloud Manager označuje.

Přidejte definici vlastního 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 pokud možno jej zúžte na konkrétní složky projektu namísto indexování celého /content/projects, protože příliš široce vymezený index může mít negativní dopad na výkon. Po nasazení nastaví AEM vlastnost reindex definice indexu na false, jakmile je reindexace dokončena, což potvrzuje, že reindexace proběhla bez chyb a nevyžaduje žádnou další akci.

Sestavení Maven selže s validačními chybami filevault-package-maven-plugin, jako jsou „Package of type ‘APPLICATION’ is not supposed to contain any sub packages“ nebo „Package of type ‘APPLICATION’ is not supposed to contain OSGi bundles or configurations“.

Ve verzích pluginu 3.1.18.6 a starších jsou OSGi bundly a konfigurační soubory zabaleny uvnitř balíčku typu aplikace, což validace AEM as a Cloud Service odmítá.

Aktualizujte na verzi pluginu 3.1.18.7 nebo novější. Odstraňte skipSubPackageValidation z konfigurace Maven, pokud byla přidána jako dočasné řešení.

Fráze chybí v seznamu pod /libs v Translation Cloud Services.

Položky pod /libs jsou výchozí hodnoty Adobe určené pouze pro čtení. Plugin ukládá svou konfiguraci pod /conf, /apps/aem-memsource-plugin a /var/memsource-tms.

Vytvořte konfiguraci integrace překladu pod conf. Připojení k serveru je uloženo samostatně v /conf/global/settings/cloudconfigs/translation/memsource-translation.

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.