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 как минимум с одним из перечисленных тегов.
При необходимости выберите Включить активы.
При необходимости выберите Включить связанные записи (вложенный контент).

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

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

alias<1> используется для всего мониторинга службы автоматического создания проектов (APC) и повторного импорта/экспорта заданий. Если в будущем перевод псевдонима будет изменен, служба автоматического создания проектов (APC) будет отслеживать контент в новом переводе, а задания будут повторно импортироваться/экспортироваться из/в новый перевод псевдонима.
- Disabled (по умолчанию и рекомендуется)
  
  Службы автоматического создания проектов (APC) и созданные задания привязаны к среде, на которую указывал псевдоним во время создания задания/службы автоматического создания проектов (APC). Службы автоматического создания проектов (APC) отслеживают только эту среду и контент; задания экспортируются и повторно импортируются в нее.
- Включено
  
  Службы автоматического создания проектов (APC) и созданные задания привязаны к самому псевдониму. Службы автоматического создания проектов (APC) отслеживают только этот псевдоним и контент; задания экспортируются и повторно импортируются в него.
  
  Если перевод псевдонима изменен, службы автоматического создания проектов (APC) отслеживают новый перевод псевдонима (среду); задания теперь будут экспортироваться и повторно импортироваться в него.
При необходимости укажите Preview URL.

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

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

Примечание

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

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

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

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

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

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

Настройки Prase TMS

Важно

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

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

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

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

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

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

Примечание

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

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

Примечание

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

Это шаблон URL, ведущий к визуализированному контенту из Contentful. Поддерживаются следующие заполнители:
- {env_id}: Идентификатор среды
- {entry.sys.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 г.. Дальнейшее использование не поддерживается.