Интеграции
    1. Phrase
    2. Phrase TMS
    3. Интеграции

    Adobe Experience Manager — AEM (TMS)

    Контент автоматически переведен с английского языка с помощью Phrase Language AI.

    Доступно для

    • План Enterprise

    Свяжитесь с отделом продаж по вопросам лицензирования.

    Доступно для

    • План Enterprise (Устаревшая версия)

    Свяжитесь с отделом продаж по вопросам лицензирования.

    Поддерживаемые версии

    Плагин Phrase Translation для Adobe Experience Manager придерживается тех же периодов поддержки продуктов, что и Adobe Experience Manager. Информацию о периодах поддержки см. на странице https://helpx.adobe.com/support/programs/eol-matrix.html.

    Как только версия Adobe Experience Manager достигает конца основной поддержки, компания Phrase прекращает поддержку плагина. Установщик останется доступным, однако дальнейшие улучшения и исправления не будут реализованы.

    • Версия плагина 2.x поддерживает 6.5.

    • Версия плагина 3.x поддерживает AEM as a Cloud Service.

    Примечания к выпуску плагина

    Конфигурация Phrase

    Настройка контекстного предварительного просмотра

    Функция контекстного предварительного просмотра обеспечивает просмотр исходного или переведенного текста в режиме реального времени как в веб-редакторе CAT, так и в настольном редакторе CAT.

    Поддерживаются таблицы, столбцы, различные графические элементы, форматирование и шрифты (если они установлены пользователями). Эта функция предназначена для обеспечения контекста при переводе и не является идеальным отображением исходного или готового документа; возможны некоторые визуальные различия. На нее также может влиять включение/отключение параметра Разрешить загрузку внешнего контента в редакторах в настройках доступа и безопасности.

    Требования Phrase:

    • Обеспечьте прохождение трафика через корпоративный брандмауэр для доступа к локальной установке.

    • Авторизуйтесь в среде авторинга.

    Конфигурация брандмауэра для локальной установки:

    • Установка должна быть доступна с IP-адресов сервера Phrase. Обратитесь к разделу IP-адреса серверов Phrase для получения актуального списка.

    • Доменное имя должно разрешаться извне.

    Примечание

    Некоторые HTML-теги представляют риск, поэтому редактор CAT удаляет их из этого HTML при отображении предварительного просмотра. Это необходимо для обеспечения конфиденциальности и безопасности данных пользователя.

    Примеры удаляемых тегов: FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT или свойства CSS background-image.

    Настройки Prase TMS

    Предварительное условие: Создайте пользователя Adobe Experience Manager с минимальными правами, необходимыми для просмотра неопубликованных страниц.

    Рекомендации

    Создайте нового пользователя с именем phrase-preview и добавьте его в группу Authors.

    1. Со страницы настроек Setup_gear.png прокрутите вниз до раздела Интеграции.

    2. Нажмите на «Коннекторы».

      Откроется страница коннекторов.

    3. Нажмите «Новый коннектор».

      Откроется страница «Создать коннектор».

    4. Измените Тип на Adobe Experience Manager Live Preview и укажите имя для коннектора.

    5. Введите Хост.

      Используйте адрес хоста установки Adobe Experience Manager (например, https://aem-author.example.org/ или https://author-X-Y.adobeaemcloud.com/).

      Доменное имя должно разрешаться извне (не интранет-домен).

    6. Введите имя пользователя и пароль.

      Единый вход (SSO) и двухфакторная аутентификация (2FA) не поддерживаются. Если для учетной записи Drupal принудительно используются SSO или 2FA, используйте выделенную сервисную учетную запись, для которой они не требуются.

    7. Чтобы изменить ссылки, содержащиеся в HTML страницы, укажите правило перезаписи URL в формате regex.

      Например:

      Чтобы заменить полный код локали только кодом языка в https://example.org/en-us/images/sample.jpg, найдите /([a-z]\{2\})-[a-z]\{2\}/ и замените его на /$1/.

      Ссылки в тегах <img src="" data-lazy-src="", <link href="", <script src="", <iframe src="" а также ссылки в стилях CSS и ссылочных файлах CSS (url: ('')) будут перезаписаны.

    8. Нажмите «Сохранить».

      Коннектор добавлен в список на странице «Коннекторы».

    Удалить коннектор

    Чтобы удалить коннектор:

    1. На странице Интеграции выберите коннектор, который нужно удалить.

    2. Нажмите Удалить.

      Откроется окно Удаление коннектора.

    3. Введите «delete» и нажмите Удалить.

      Коннектор удалён, и отображается список коннекторов.

    Примечание

    Коннектор нельзя удалить, пока он связан с незавершенными заданиями в проекте, включая задания, находящиеся в корзине. Попытка удаления такого коннектора приведет к ошибке «Не удалось удалить коннектор».

    Решение: Откройте проект, связанный с коннектором, и завершите или удалите все оставшиеся задания. Перейдите в Настройки/Корзина и очистите ее, чтобы удалить все задания, которые все еще связаны с коннектором. Повторите попытку удаления коннектора.

    Примечание

    Некоторые HTML-теги представляют риск, поэтому редактор CAT удаляет их из этого HTML при отображении предварительного просмотра. Это необходимо для обеспечения конфиденциальности и безопасности данных пользователя.

    Примеры удаляемых тегов: FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT или свойства CSS background-image.

    Настройка рабочего процесса перевода

    Чтобы настроить обработку заданий Adobe Experience Manager, создайте шаблон проекта, настроенный в соответствии с вашими потребностями:

    • В разделе Доступ и безопасность активируйте параметр Разрешить загрузку внешнего контента в редакторе Phrase CAT.

    При использовании устаревших версий необходимо создать и проверить службу и портал отправителя. Чтобы проверить конфигурацию, выполните следующие действия:

    1. Откройте незавершенный проект перевода.

    2. В меню плитки Задание выберите Экспорт.

    3. Найдите файл .XML, содержащий исходный текст, в загруженном ZIP-файле.

    4. В Phrase перейдите на порталы отправителей, используемые для интеграции, и откройте указанный URL-адрес.

    5. Заполните форму SP, загрузите файл .XML, подтвердите адрес электронной почты и отправьте.

    6. Убедитесь, что новый проект был создан на основе шаблона проекта в соответствии с конфигурацией.

    Конфигурация AEM

    Установка плагина

    Загрузите последнюю версию пакета плагина со страницы Phrase Ecosystem в Phrase, используя кнопку Download. Плагин доступен только организациям, которые его приобрели.

    Локальная версия AEM (On-premise)

    1. При миграции с версии 6.2 или 6.3 на 6.4 и выше удалите все конфигурации Legacy Cloud Services из инструмента Classic UI Admin (/miscadmin#/etc/cloudservices/memsource-translation)

      Все конфигурации исчезнут из Legacy Cloud Services > Memsource Translation Plugin for AEM.

    2. В Tools, Deployment перейдите в Packages.

    3. Удалите предыдущую версию плагина, если применимо.

    4. Выберите Upload package и загрузите установочный файл.

    5. Установите флажок Force Upload и отправьте.

    AEM as a Cloud Service

    Если плагин уже установлен, перейдите к шагу 4.

    1. Добавьте локальный репозиторий maven на основе файловой системы в корень проекта облачной службы AEM pom.xml:

      repositories {

  хранилище
    <id>project.local</id>
    <name>project</name>
    <url>file:${maven.multiModuleProjectDirectory}/repository</url>
  хранилище

repositories {

    2. Добавьте зависимость плагина в all/pom.xml:

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

    3. Добавьте встроенный блок в конфигурацию all/pom.xml -> filevault-package-maven-plugin:

      плагин
  <groupId>org.apache.jackrabbit</groupId>
  <artifactId>filevault-package-maven-plugin</artifactId>
  <extensions>true</extensions>
  Конфигурация
  <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. Добавьте плагин в локальный репозиторий Maven. Выполните следующую команду из корневого каталога проекта AEM cloud service, заменив заполнитель {memsource.plugin.path} на путь к плагину (например, /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. Установите правильную версию плагина в all/pom.xml (например, 3.0.1):

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

    Настройте плагин

    Требуются две конфигурации:

    • Сообщите системе о существовании Phrase, добавив его в качестве поставщика услуг перевода и указав способ подключения к TMS.

    • Сообщите Adobe Experience Manager, когда и как использовать Phrase, настроив конфигурацию интеграции перевода.

      Пример:

      Используйте Phrase для важного контента, а поставщика машинного перевода — для контента сообщества.

    Добавьте Phrase в качестве поставщика услуг перевода

    Выполните следующие действия:

    1. В разделе Tools, General перейдите к Configuration Browser.

    2. Создайте контейнер конфигурации для каждой службы Phrase (например, одну конфигурацию для перевода человеком и отдельную конфигурацию только для машинного перевода).

    3. В разделе Cloud Services перейдите к Translation Cloud Services.

    4. Разверните каталог conf.

    5. Создайте новую конфигурацию и введите следующую информацию:

      • Hostname: URL-адрес по умолчанию — https://cloud.memsource.com/web/, но он может отличаться, если вы или LSP используете пользовательский URL-адрес.

      • Username и Password (должны быть в роли PM с включённой опцией Modify global server settings в правах пользователя).

      Нажмите Connect.

    6. Выберите другие параметры и закройте конфигурацию.

      • Группировать все задания на перевод в одном проекте Phrase 

        Все задания на перевод в рамках одного проекта AEM также будут созданы в рамках одного проекта Phrase.

        Важно

        Эта опция работает некорректно, если в настройках шаблона проекта Phrase одновременно включены параметры Set job to completed once pre-translated и Set project to completed once all jobs are completed.

      • Установите статус задания Phrase на Delivered после импорта в AEM 

      • Сгенерировать анализ 

        Если этот параметр активен, то после отправки задания на перевод анализы создаются автоматически при импорте файлов. Анализы всегда создаются по языкам, независимо от настроек шаблона проекта. 

      • Создать расценки 

        Если активировано автоматическое создание анализов, на их основе можно создавать расценки.

    При использовании устаревших версий также потребуется информация о службе и портале отправителя.

    Настройте интеграцию перевода

    При использовании плагина Phrase Translation для AEM все файлы в заданиях на перевод отправляются на перевод и, таким образом, возвращаются из Phrase. Используйте конфигурацию Интеграция перевода проекта, чтобы предотвратить включение в проекты ресурсов или справочных материалов, не подлежащих переводу.

    1. В разделе «Инструменты» перейдите в Cloud Services, нажмите Translation Cloud Services.

    2. Создайте новую конфигурацию специально для перевода.

      • Убедитесь, что параметры Переводить строки компонентов и Переводить теги не выбраны.

      • Установите для параметра Переводить ресурсы страницы значение Не переводить.

      • На вкладке Ресурсы установите для параметра Рабочий процесс перевода значение Не переводить.

    3. Если в проекте все еще содержатся непереводимые ресурсы или справочные материалы, отметьте и удалите их непосредственно в Phrase.

    Примените интеграцию перевода к сайтам

    Настройте поставщика перевода Phrase по умолчанию для различных частей таксономии сайта. Настройте поставщика в корневом узле сайта. Все дочерние страницы унаследуют этот параметр. Переопределите параметр в узле, для которого требуется использовать другую конфигурацию поставщика (например, для всего сайта используется перевод человеком, а для раздела сообщества — машинный перевод).

    Чтобы применить интеграцию перевода:

    • На вкладке Дополнительно выберите созданную конфигурацию в качестве облачной конфигурации.

    При добавлении контента с этих страниц будет добавлен только переводимый контент. Если проект создан на Панели ссылок, он будет автоматически настроен на использование облачной конфигурации, связанной с корневой страницей.

    Отправить контент на перевод

    Чтобы отправить контент (сайты, ресурсы) на перевод, создайте проект перевода в Adobe Experience Manager. Проекты можно создавать вручную в разделе «Проекты» или использовать встроенные рабочие процессы для минимизации усилий.

    Чтобы подготовить проект к отправке через встроенные рабочие процессы, выполните следующие действия:

    1. В представлении Сайты перейдите на страницу, выберите ее и откройте Панель ссылок.

    2. Нажмите Языковые копии и разверните раздел Создать и перевести в нижней части панели.

    3. Выберите целевые языки, при необходимости снимите флажок Выбрать все подстраницы.

    4. Выберите Создать многоязычный проект перевода.

      Если выбрано несколько целевых языков, для каждого языка будет создан отдельный проект.

    5. Введите название проекта и нажмите Создать.

    6. Перейдите к проекту в разделе Проекты и откройте его.

    7. Нажмите на многоточие на первой плитке, чтобы открыть дополнительные параметры проекта.

      При правильной настройке будут использоваться конфигурации, созданные на предыдущих шагах.

    8. Чтобы отправить задание, выберите Начать в меню плитки задания.

      Новый проект будет создан в течение нескольких минут.

      • После импорта поставщики назначаются из шаблона проекта, а для элемента задания AEM устанавливается статус Передано на перевод.

      • Как только задание принимается провайдером, статус элемента задания AEM меняется на Перевод в процессе.

      • Статус элемента задания AEM меняется на Отмена, если задание удалено или отменено.

      Рекомендации

      Adobe Experience Manager опрашивает обновление статуса задания по расписанию, которое настраивается в Конфигурации платформы перевода, доступной через веб-консоль.

      Установка свойства Scheduler Cron для частого запуска (например, 0 0/5 * * * ? * запускает обновление статуса задания перевода каждые 5 минут).

      Обновление страницы сведений о проекте принудительно вызывает извлечение.

    9. В Phrase переведите задания проекта и установите для них статус Завершено. После завершения задания импортируются обратно в AEM.

    10. В случае отклонения первый этап рабочего процесса задания устанавливается на Отправлено, а остальные этапы рабочего процесса — на Новое.

    11. Как только элемент задания AEM принят, статус задания обновляется до Доставлено, как настроено в параметрах плагина.

    Более подробную информацию о создании проектов перевода с помощью панели ссылок см. в документации Adobe.

    Разное

    Пользовательское сопоставление языков

    Локальная версия AEM (On-premise)

    Чтобы сопоставить языки Adobe Experience Manager с другими языками в Phrase (например, zh с zh_tw), выполните следующие действия.

    Сопоставление применяется как к исходным, так и к целевым языкам.

    1. Откройте CRXDE (/crx/de/index.jsp).

    2. Перейдите в папку /apps/memsource-connector/language-mapping/.

    3. Создайте новый узел.

    4. Используйте код языка Adobe Experience Manager в качестве имени (например, zh), сохраните Тип: nt:unstructured.

    5. Добавьте свойство:

      • Имя: memsourceLanguage

      • Тип Строка

      • Значение: код языка (например, zh_tw)

    6. Нажмите Сохранить все.

    Несопоставленные коды языков отправляются в исходном виде.

    AEM as a Cloud Service

    Чтобы добавить сопоставление языков в AEM Cloud Services, выполните следующие действия:

    1. Создайте файл .content.xml в папке /conf/aem-memsource-plugin/language-mapping/.

    2. Откройте созданный файл и скопируйте в него следующее:

      <?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. Создайте файл .content.xml в папке /conf/aem-memsource-plugin/language-mapping/zh-cn.

    4. Откройте созданный файл и скопируйте в него следующее:

      <?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. Добавьте пути, созданные на предыдущих шагах, в файл filter.xml, расположенный по адресу 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>

    Идентификаторы проектов

    После отправки задания на перевод идентификатор проекта и UID сохраняются в /content/projects/project-name/jcr:content/dashboard/gadgets/translationjob в качестве свойств PROPERTY_MEMSOURCE_PROJECT_ID и PROPERTY_MEMSOURCE_PROJECT_UID.

    Используйте эти идентификаторы для отображения в среде AEM или в API для расширения функциональности плагина.

    Устранение неполадок AEM

    Проблема

    Причина(-ы)

    Решение

    Cloud Manager сообщает о предупреждении «Query Without Index» для запроса по translationObjectID в /content/projects

    Коннектор Phrase AEM находит узлы заданий на перевод по translationObjectID, назначенному во время выполнения. Этот идентификатор не существует в качестве заранее определенного свойства репозитория, поэтому AEM as a Cloud Service не может проиндексировать его заранее и переходит к полному обходу, что и отмечает Cloud Manager.

    Добавьте определение пользовательского индекса Oak/Lucene типа oak:QueryIndexDefinition, ограниченное областью /content/projects, с индексом свойства по translationObjectID. Разверните определение индекса через конвейер кода, а не создавайте его во время выполнения, и проверьте его в непроизводственной среде перед развертыванием в продуктивной среде. Ограничьте область индекса структурой папок проекта в экземпляре AEM, по возможности сужая ее до конкретных папок проекта вместо индексации всего /content/projects, так как слишком широкий индекс может создать собственное влияние на производительность. После развертывания AEM устанавливает для свойства reindex определения индекса значение false по завершении переиндексации, что подтверждает, что переиндексация завершилась без ошибок и не требует дальнейших действий.
    Была ли эта статья полезной?
    ★ ★ ★ ★ ★

    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.