Contentful (TMS)

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

Доступно для

Планы Business и Enterprise (недоступны для планов LSP)

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

Доступно для

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

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

Примечание

Коннектор не поддерживает перевод объектов JSON.

Поддерживаемые методы локализации

Contentful поддерживает несколько методов локализации. Подробное описание см. в документации Contentful.

Коннектор Contentful 2.0 — это текущая и рекомендуемая интеграция, которая поддерживает локализацию на уровне полей. Он также предлагает:

Несколько пробелов
Псевдонимы окружения
Настройка URL для предварительного просмотра
Импортировать справочный файл
Фильтрация контента на основе тегов
Настройка предварительного просмотра в реальном времени

Локализация на уровне записи (устаревшая версия)

Использовать коннектор Contentful (Entry-Level).

Коннектор начального уровня работает только с типами контента, имеющими локализованные справочные поля (например, справочный файл под названием Localized, для которого включена локализация).

Локализация на уровне полей (Устаревшая версия)

Использовать коннектор Contentful (Field-Level).

Коннектор на уровне полей работает только с типами контента, имеющими переводимое поле (например, поле Текст или Форматированный текст с включенной локализацией) и, при необходимости, медиаактивы. Он импортирует связанные записи и их переводимые поля (если справочные поля локализованы).

Важно

Устаревшие версии коннекторов будут выведены из эксплуатации 30 ноября 2026 г.. Новые экземпляры этих коннекторов можно создавать до 17 августа 2026 г. Выполните миграцию на новый коннектор до даты прекращения поддержки.

Полное руководство по миграции см. в разделе Устаревшая версия коннектора: прекращение поддержки.

Варианты использования

Существует ряд вариантов использования коннектора:

Менеджеры проектов могут добавить файлы непосредственно в проекты из онлайн-хранилища. Контент доступен для поиска по Идентификатору записи.
Настройте портал отправителя, чтобы отправители могли добавлять файлы в запросы непосредственно из онлайн-хранилища. Контент доступен для поиска по Идентификатору записи.
Используйте службу автоматического создания проектов (APC) для автоматического создания новых проектов при обнаружении изменений в размере контента для отслеживаемых документов или папок.

Варианты использования приложения:

Редакторы контента могут напрямую отправить запись на локализацию из Contentful. Это позволяет редакторам или менеджерам контента полностью контролировать процесс локализации и получать обновления статуса в режиме реального времени при просмотре записи.

После того как запись будет окончательно оформлена:
- Выберите нужные языки перевода для локализации.
- Отправьте только запись с выбранными языками в Phrase TMS или используйте вкладку Выбор полей, чтобы выбрать поля.
  - Если поля не выбраны, все локализуемые поля отправляются на перевод.
  - Если выбрано нелокализуемое поле, это поле все равно не будет отправлено на перевод. Отправляются только локализуемые поля.
  - Если выбраны только некоторые локализуемые поля, на перевод будут отправлены только эти поля.
- На основе настроек службы автоматического создания проектов (APC) задания автоматически создаются из отправленного контента. Во время работы службы автоматического создания проектов (APC) для создания заданий выбираются только записи со статусом отправлено.
- После создания заданий из отправленной записи статус меняется на в ходе выполнения. Когда переводы отправляются обратно в Contentful, статус меняется на завершено.
- Ранее переведенные записи можно отправить повторно после внесения изменений в исходный текст.
Редакторы контента могут использовать главный экран Phrase TMS, чтобы:
- Отправлять записи массово.
- Указывать отдельные языки перевода при массовой отправке.
- Получать обзор активных заданий на перевод.

Настройки Contentful

При работе с приложением Phrase TMS:

Скачать приложение Phrase TMS из маркетплейса.
Установите приложение в текущий активный каталог и выберите модели контента, для которых требуется установка приложения.
Введите токен аутентификации Phrase TMS, полученный при создании коннектора в Phrase TMS.
Нажмите Отправить.

Необязательно — Запустить приложение (устарело в Contentful)

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

Установите приложение Launch от Contentful в один или несколько каталогов.

Примечание

Для каждого каталога можно создать только один рабочий процесс. Если в одном каталоге Contentful требуются разные подходы к типам контента, обратитесь к закрепленному за вами менеджеру по работе с клиентами.
Настройте требуемый рабочий процесс локализации.
Выберите тип или типы контента, которые следуют описанному рабочему процессу.

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

Отправленные задания можно отменить, что позволит повторно отправить контент после внесения изменений. Эти задания по-прежнему будут существовать в Phrase, и их должен будет удалить менеджер проекта.

Настройки Phrase TMS (Contentful 2.0)

Примечание

Приложение Contentful Launch не поддерживается в коннекторе 2.0.

Со страницы настроек прокрутите вниз раздел «Интеграции».
Нажмите на «Коннекторы».

Откроется страница коннекторов.
Нажмите «Новый коннектор».

Откроется страница «Создать коннектор».
Измените Тип на Contentful 2.0.
Укажите имя для коннектора.
Нажмите Connect to Contentful 2.0.

Откроется окно входа в Contentful.
Введите данные для входа и нажмите Log in (или используйте альтернативные способы входа). Окно входа закроется, и отобразится статус Connected.
При необходимости установите флажок Phrase Contentful App, если используете коннектор с приложением.
1. Нажмите Generate token.
  
  Откроется окно Generate Contentful Token.
2. Нажмите Generate token.
  
  Генерируется токен, который следует скопировать в буфер обмена или текстовый файл. Убедитесь, что токен скопирован перед закрытием окна, так как он больше не будет виден. Этот токен будет использоваться при подключении к приложению.
3. Закройте окно, и отобразится Токен сгенерирован.
Если для идентификации переводимый контент используются Теги Contentful, введите Идентификатор тега и нажмите Enter.

Идентификатор отображается, и можно добавить другие. Теги можно использовать для ограничения того, какой контент из Contentful виден для коннектора.
- Выбрать стратегию составления списка
  - Со всеми тегами
    
    Отображает контент в Contentful со всеми перечисленными тегами.
  - Как минимум с одним тегом
    
    Отображает контент из Contentful, содержащий хотя бы один из перечисленных тегов.
При необходимости выберите Включить медиафайлы.
При необходимости выберите Включить связанные записи (вложенный контент).

Отображаются настройки связанных записей. Примените нужные фильтры, чтобы более детально контролировать то, как система обрабатывает связи контента.
- Установите глубину импорта для связанных записей
  
  Ограничивает глубину перехода Phrase по связанным записям во время импорта.
  
  Значение по умолчанию — 10 000. При необходимости выберите другие значения или укажите Пользовательский целочисленный показатель.
- Тип контента
  
  Выбрать, останавливаться ли на записях, тип контента которых соответствует указанному списку, или переходить по ним.
- Тип контента родительского элемента
  
  Исключить записи, тип родительский элемент контента которых соответствует указанному списку.
- Теги
  
  Выбрать, останавливаться ли на записях, имеющих любой из указанных тегов контента, или переходить по ним.
- Идентификаторы поля
  
  Выбрать, следует ли останавливаться на записях, на которые ссылаются указанные Идентификаторы полей, или переходить по ним.
При необходимости Выбрать Include taxonomy.

Отображается поле Contentful Organization ID. Введите значение, чтобы Включить настройку таксономии.
- При выборе этой опции коннектор извлекает таксономии из Contentful и включает их в .XLIFF file. На панели контекстное примечание<2> в CAT Editor<4> будет представлен список значений таксономии Contentful для каждого сегмента.
- Если метаданные таксономии недоступны или коннектор не настроен для работы с ними, панель контекстное примечание<1> просто не отображается.
- Если для проекта не требуется контекст функции/экрана, рекомендуется оставить таксономию отключенной для оптимизации производительности при экспорте .XLIFF.
При необходимости Выбрать Follow aliases.

Идентификатор используется для всего мониторинга службы автоматического создания проектов (APC) и повторного импорта/экспорта заданий. Если в будущем перевод Идентификатора будет изменен, служба автоматического создания проектов (APC) будет отслеживать контент в новом переводе, а задания будут повторно импортироваться/экспортироваться из/в новый перевод Идентификатора.
- Отключено (по умолчанию и рекомендуется)
  
  Службы автоматического создания проектов (APC) и созданные задания привязаны к среде, на которую указывал Идентификатор во время создания задания/APC. Службы автоматического создания проектов (APC) отслеживают только эту среду и контент; задания экспортируются и повторно импортируются в нее.
- Включено
  
  Службы автоматического создания проектов (APC) и созданные задания привязаны к самому Идентификатору. Службы автоматического создания проектов (APC) отслеживают только этот Идентификатор и контент; задания экспортируются и повторно импортируются в него.
  
  Если перевод Идентификатора будет изменен, службы автоматического создания проектов (APC) будут отслеживать новый перевод Идентификатора (среду); задания теперь будут экспортироваться и повторно импортироваться в него.
Пользовательские роли Contentful требуют прямого доступа к конкретной базовой среде, на которую указывает Идентификатор, а не только к самому Идентификатору, иначе панель управления приложения Phrase TMS не загрузится. Добавить этот доступ в Contentful в разделе Contentful Space Settings/Roles, в подразделе Environments роли. Если Идентификатор позже будет перенаправлен на другую среду, добавьте доступ и к новой среде.
При необходимости укажите URL-адрес предварительного просмотра.

Это шаблон URL-адреса, ведущий к отрисованному контенту из Contentful. Поддерживаются следующие заполнители:
- {env_id}: Идентификатор среды
- {entry.id}: Идентификатор записи
- {space_id}: Идентификатор каталога
Шаблон URL-адреса может выглядеть так:

https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry_id}

Примечание

URL-адрес должен вести к развернутому приложению, которое отрисовывает контент Contentful. Чтобы использовать предварительный просмотр в реальном времени, Заменить contentfulapp.tld в шаблоне URL-адреса на фактическую отрасль приложения.

Дополнительные сведения о настройке предварительного просмотра контента см. в документации Contentful.

На данный момент языковой стандарт не поддерживается в качестве заполнителя. Чтобы использовать языковой стандарт в URL-адресе, укажите фиксированное значение и создайте несколько экземпляров коннектора.
При необходимости используйте Исключить переводимые поля, чтобы исключить определенные поля из импорта в Phrase. Укажите Идентификаторы контента, которые следует исключить из импорта.
Укажите Идентификатор каталога и токен для карты токенов предварительного просмотра каталога (обязательно).

Для интерфейса приложений API предварительного просмотра требуется токен доступа Contentful с названием Content Preview API – access token, который должен быть настроен в настройках интерфейса приложений API каталога Contentful.

Интеграция Contentful 2.0 использует этот интерфейс приложений API для импорта контента и отслеживания изменений (служба автоматического создания проектов (APC)).
- Выберите каждый каталог и среду для отслеживания/импорта из Contentful.
- Настройка и доступ управляются непосредственно в Contentful.
Нажмите «Сохранить».

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

Примечание

Мониторинг службы автоматического создания проектов (APC) повторно проверяет полный контент отслеживаемой записи и ее ссылки при каждом запуске, поскольку Contentful не сообщает, какой языковой стандарт был изменен. Из-за этого запись может быть повторно импортирована после получения перевода, даже если ее оригинал не изменился. В каталогах с большим объемом данных это может замедлить работу службы автоматического создания проектов (APC).

Чтобы сократить это:

Удалите тег перевода, как только запись будет готова, и добавьте его снова, только если требуется повторный перевод.
Ограничьте настройки справочных записей только теми записями, которые требуют перевода.
Используйте Phrase Contentful App, которое отслеживает только записи, отправленные через него.

Настройки Prase TMS

Важно

При доступе с Пользовательский отрасль (напр. mydomain.phrase.jp), откройте окно браузера в режиме инкогнито и войдите через cloud.memsource.com или us.cloud.memsource.com, чтобы применить аутентификация, необходимую для создания или сохранения коннектор. После сохранения коннектор можно получить доступ через Пользовательский отрасль.

Со страницы настроек прокрутите вниз раздел «Интеграции».
Нажмите на «Коннекторы».

Откроется страница коннекторов.
Нажмите «Новый коннектор».

Откроется страница «Создать коннектор».
Изменить Тип на либо Contentful (Entry-Level) или Contentful (Field-Level) и укажите имя для коннектор.
При необходимости установите флажок Phrase Contentful App, если используете коннектор с приложением.
- Токен приложения Contentful
  
  Сгенерируйте токен приложения, который нужно ввести в приложение Phrase TMS Contentful. Сохраните коннектор после генерации токена и копирования его в Phrase App.
Примечание

После сохранения токен нельзя изменить из Contentful. Чтобы обновить его, отзовите токен в настройках коннектора в Phrase TMS и сгенерируйте новый.
Настройте параметры, не зависящие от языка.
- Язык оригинала
  
  Выберите оригинал, чтобы перезаписать язык по умолчанию в Contentful. Коннектор будет подтягивать контент с языка, настроенного в конфигурации коннектора.
  
  Пример:
  
  Если EN-US установлен как язык по умолчанию в Contentful, но для локализации в конкретном каталоге или модели контента требуется DE-DE в качестве оригинала, конфигурацию можно изменить так, чтобы каталог (Remote folder) подтягивал контент из DE-DE вместо EN-US.
Примечание

Неприменимо при использовании приложения.
Выберите способ обработки вложенного контента через режим импорта записи. Контент может использовать справочный файл для ссылки на другой контент, что позволяет создавать иерархию сущностей.

Примечание

Неприменимо при использовании приложения.
- Contentful (Entry-Level)
  
  Коннектор начального уровня автоматически обходит всю иерархию вложенного контента.
- Contentful (на уровне полей)<1>
  
  Выберите, как коннектор уровня полей должен импортировать вложенный контент.
  - Только выбранная запись
    
    Контент, который был явно выбран при добавлении из хранилища, импортируется.
    
    Изменения, обнаруженные службой автоматического создания проектов (APC), импортируются для перевода.
  - Импортировать связанные записи
    
    Коннектор обходит всю иерархию вложенного контента и импортирует все переводимые поля для перевода.
Создайте список через запятую в Пропустить переводимые поля, чтобы исключить из импорта в Phrase TMS поля, для которых включена опция Включить локализацию этого поля. Используйте следующую структуру: contentTypeID:fieldID.
- Выберите Оставить пустые поля пустыми, если перечисленные поля должны оставаться пустыми. Эта настройка будет применяться ко всем указанным вводам.
- Выберите Копировать оригинал в перевод, если перечисленные поля должны содержать значения оригинала. Эта настройка будет применяться ко всем указанным вводам.
Выберите Использовать резервный язык, если для определенного поля в языке оригинала отсутствуют данные.

При необходимости выберите Резервный язык оригинала из выпадающего списка. Этот языковой стандарт будет использоваться в случае отсутствия данных.

Примечание

Между резервным языком Contentful и этим параметром нет никакой связи.
При необходимости укажите URL предварительного просмотра (BETA).

Это шаблон URL-адреса, ведущий к отрисованному контенту из Contentful. Поддерживаются следующие заполнители:
- {env_id}: Идентификатор среды
- {entry.sys.id}: Идентификатор записи
- {space_id}: Идентификатор каталога
Шаблон URL-адреса может выглядеть так:

https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}

Примечание

URL-адрес должен вести к развернутому приложению, которое отрисовывает контент Contentful. Чтобы использовать предварительный просмотр в реальном времени, Заменить contentfulapp.tld в шаблоне URL-адреса на фактическую отрасль приложения.

Дополнительные сведения о настройке предварительного просмотра контента см. в документации Contentful.

На данный момент языковой стандарт не поддерживается в качестве заполнителя. Чтобы использовать языковой стандарт в URL-адресе, укажите фиксированное значение и создайте несколько экземпляров коннектора.
Если служба технической поддержки Team запросила ведение журнала отладочной информации, выберите Записывать отладочную информацию.
Нажмите Подключиться к Contentful.

Если подключение прошло успешно, в настройка коннектора появится галочка. Красный восклицательный знак появится, если это не так. Наведите курсор на значок, чтобы увидеть дополнительные сведения.
Только Contentful (начальный уровень):

Установите язык оригинала.

Примечание

Этот язык должен соответствовать языковому стандарту по умолчанию каталога Contentful, настроенному в настройках языковых стандартов Contentful.
Нажмите «Сохранить».

Коннектор добавлен в список на странице «Коннекторы».
При необходимости отредактируйте коннектор, чтобы выбрать рабочие процессы Contentful.
- Переводить статьи из:
  
  Коннектор отслеживает статьи на выбранном этапе (например, «Перевод»). Автор может применить эту метку к статьям, когда они готовы к переводу.
При импорте из Contentful:
- Задать для исходных статей
  
  Коннектор переводит рабочий процесс на выбранный этап (например, «Ход выполнения перевода») при загрузке оригиналов статей.
При экспорте в Contentful:
- Задать для исходных статей
  
  Коннектор устанавливает этап рабочего процесса для оригиналов статей на выбранный этап (например, «Перевод завершен») при экспорте перевода.
Примечание

Поддержка рабочего процесса была прекращена Contentful 1 июня 2023 г.. Дальнейшее использование не поддерживается.

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

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

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

Откроется окно Удалить коннектор.
Введите «delete» и нажмите Удалить.

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

Примечание

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

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