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

    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. Обратитесь к Phrase Servers IP Addresses для получения текущего список.

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

    Примечание

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

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

    Настройки Prase TMS

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

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

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

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

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

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

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

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

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

    5. Введите Host.

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

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

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

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

    7. Чтобы изменить ссылки, содержащиеся в HTML страницы, укажите URL rewrite rule в 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. На странице Integrations Выбрать коннектор, который нужно Удалить.

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

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

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

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

    Примечание

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

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

    Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

      Все конфигурации исчезают из устаревшая версия Услуги в облаке > Плагин перевода Memsource для 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 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. В Инструменты, Общие, перейдите в Браузер конфигураций.

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

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

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

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

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

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

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

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

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

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

        Важно

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

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

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

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

      • Создать коммерческие предложения 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    2. Нажмите Language Copies и разверните раздел Create & Translate в нижней части панели.

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

    4. Выбрать Create Multi-language Translation Project.

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

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

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

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

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

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

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

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

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

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

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

      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.

    Разное

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

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

    Устранение неполадок 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.