Интеграции

Adobe Experience Manager — AEM (TMS)

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

Доступно для

  • План Enterprise

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

Доступно для

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

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

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

Плагин Phrase для 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 Web Editor, так и в CAT Desktop Editor.

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

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

  • Пройдите через корпоративный брандмауэр, чтобы получить доступ к локальной установке.

  • Выполните аутентификацию в среде разработки.

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

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

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

Примечание

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

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

Настройки Prase TMS

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

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

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

  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. Введите имя пользователя и пароль.

  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. Нажмите «Сохранить».

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

Примечание

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

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

Настроить рабочий процесс перевода

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

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

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

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

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

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

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

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

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

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

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

Локальная AEM

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

    Все конфигурации исчезнут из устаревшая версия Cloud Services > плагин Memsource Translation для AEM.

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

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

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

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

AEM как услуга облака

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

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

    <repositories>
    ...
      <repository>
        <id>project.local</id>
        <name>project</name>
        <url>file:${maven.multiModuleProjectDirectory}/repository</url>
      </repository>
    ...
    </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:

    ...
    <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. Добавьте плагин в локальное хранилище maven. Выполните следующую команду из корня проекта услуга AEM cloud, заменив заполнитель {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. В Инструменты, Общие перейдите в Браузер конфигураций.

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

  3. В Облачные услуги перейдите в Облачные услуги перевода.

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

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

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

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

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

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

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

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

      Важно

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

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

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

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

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

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

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

Настроить интеграция перевода

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

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

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

    • Убедитесь, что Translate Component Strings и Translate Tags не выбраны.

    • Установите Translate page assets в значение Do not translate.

    • На вкладка Assets установите рабочий процесс в значение Do not translate.

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

Применить интеграция к сайтам

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Adobe Experience Manager опрашивает статус обновления задания по расписанию, которое настраивается в Translation Platform Configuration, доступной через Web Console.

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

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

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

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

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

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

Разное

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

Локальная AEM

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

Сопоставление применяется как к оригиналу, так и к переводу.

  1. Open CRXDE (/crx/de/index.jsp).

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

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

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

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

    • Name: memsourceLanguage

    • Type: String

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

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

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

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 для расширения функциональности плагина.

Была ли эта статья полезной?

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.