Интеграции
    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. При необходимости включите Принудительное безопасное соединение.

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

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

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

    7. Введите Имя пользователя Live preview и Пароль Live preview.

    8. Чтобы изменить ссылки, содержащиеся в 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: ('')) будут перезаписаны.

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

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

    Примечание

    Некоторые 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 в Phrase, используя кнопку Загрузить. Плагин доступен только организациям, которые его приобрели.

    Локальная версия AEM

    1. При миграции с версий 6.2 или 6.3 на 6.4 и выше удалите все конфигурации устаревших облачных служб из инструмента администрирования Classic UI (/miscadmin#/etc/cloudservices/memsource-translation).

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

    2. В разделе Инструменты, Развертывание перейдите к Пакетам.

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

    4. Выберите Загрузить пакет и загрузите установочный файл.

    5. Установите флажок Принудительная загрузка и отправьте.

    AEM в облаке

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

    1. Добавьте локальный репозиторий maven на основе файловой системы в корень проекта AEM cloud service 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, заменив заполнитель {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-адрес.

      • Имя пользователя и Пароль (необходимо наличие роли PM с включенной опцией Изменение глобальных настроек сервера в правах пользователя).

      Нажмите Подключить.

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

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

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

        Важно

        Эта опция работает некорректно, если в настройках шаблона проекта Phrase одновременно включены Устанавливать статус задания «Выполнено» после предварительного перевода и Устанавливать статус проекта «Выполнено» после завершения всех заданий.

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

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

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

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

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

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

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

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

    1. В разделе «Инструменты» перейдите в Облачные службы и нажмите Облачные службы перевода.

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

      Примечание

      Создайте конфигурацию в conf. Записи в /libs являются стандартными элементами Adobe, доступными только для чтения.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Разное

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

    Локальная версия AEM

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

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

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

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

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

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

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

      • Name: memsourceLanguage

      • Тип строка

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

    6. Нажмите Save All.

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

    AEM как облачный сервис

    Чтобы добавить сопоставление языков в 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 после завершения переиндексации, что подтверждает, что переиндексация завершилась без ошибок и не требует дальнейших действий.

    Сборка Maven завершается с ошибками проверки filevault-package-maven-plugin, такими как «Package of type ‘APPLICATION’ is not supposed to contain any sub packages» или «Package of type ‘APPLICATION’ is not supposed to contain OSGi bundles or configurations».

    В версиях плагина 3.1.18.6 и более ранних пакеты OSGi и файлы конфигурации упаковываются внутри пакета типа application, что отклоняется проверкой AEM as a Cloud Service.

    Обновите плагин до версии 3.1.18.7 или более поздней. Удалите skipSubPackageValidation из конфигурации Maven, если он был добавлен в качестве временного решения.

    Phrase отсутствует в списке под /libs в Translation Cloud Services.

    Записи в разделе /libs являются стандартными настройками Adobe, доступными только для чтения. Плагин хранит свою конфигурацию в /conf, /apps/aem-memsource-plugin и /var/memsource-tms.

    Создайте конфигурацию Translation Integration в разделе conf. Подключение к серверу хранится отдельно по адресу /conf/global/settings/cloudconfigs/translation/memsource-translation.
    Была ли эта статья полезной?
    ★ ★ ★ ★ ★

    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.