Contentful (TMS)

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

Доступно для

Тарифные планы Business и Enterprise (недоступны для тарифных планов LSP)

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

Доступно для

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

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

Примечание

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

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

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

Коннектор Contentful 2.0 — актуальный и рекомендуемый способ интеграции с поддержкой локализации на уровне полей. Он также предлагает:

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

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

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

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

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

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

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

Важно

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

Полное руководство по миграции см. в разделе Вывод из эксплуатации устаревших коннекторов.

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

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

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

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

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

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

Настройки Contentful

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

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

Необязательно — Launch App (объявлено устаревшим компанией Contentful)

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

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

Примечание

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

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

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

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

Примечание

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

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

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

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

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

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

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

Отображается поле Идентификатор организации Contentful. Введите значение, чтобы включить настройку таксономии.
- При выборе этой опции коннектор извлекает таксономии из Contentful и включает их в файл .XLIFF. На панели Контекстная заметка в редакторе CAT будут перечислены значения таксономии Contentful для каждого сегмента. Значения таксономии не являются контентом, подлежащим переводу. Значения таксономии нельзя отображать в списке, импортировать или экспортировать как отдельное задание — ни самостоятельно, ни вместе с записью.
- Если метаданные таксономии недоступны или коннектор не настроен для работы с ними, панель Контекстная заметка просто не отображается.
- Если проекту не требуется контекст функции/экрана, рекомендуется оставить таксономию отключенной для оптимизации производительности при экспорте .XLIFF.
При необходимости выберите Использовать псевдонимы.

Псевдоним используется для всего мониторинга APC и повторного импорта и экспорта заданий. Если в будущем целевой объект псевдонима изменится, APC будет отслеживать контент в новом целевом объекте, а задания будут повторно импортироваться из нового целевого объекта псевдонима и экспортироваться в него.

Параметр «Использовать псевдонимы» применяется при мониторинге APC, повторном импорте и экспорте заданий. Это также относится к записям, отправленным через приложение Phrase Contentful из URL-адреса псевдонима. Приложение записывает псевдоним при отправке, поэтому коннектор находит эти записи после изменения целевого объекта псевдонима. Записи, отправленные в то время, когда псевдоним указывал на более раннюю среду, остаются видимыми для коннектора. Каждая запись по-прежнему экспортируется и повторно импортируется в среду, из которой она была отправлена.

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

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

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

Примечание

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

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

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

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

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

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

Примечание

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

Чтобы снизить нагрузку:

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

Ранее переведенные записи можно отправить повторно после внесения изменений в исходный текст. При использовании приложения Phrase Contentful повторная отправка выполняется вручную: редактору нужно открыть запись в Contentful и боковую панель приложения Phrase, затем нажать Начать заново (или повторно отправить записи массово с панели управления приложения). Только после этого APC обнаружит запись и обновит исходный текст существующего задания. Это отличается от коннекторов для мониторинга файлов или папок, где APC автоматически обнаруживает изменения в исходном тексте без необходимости ручной повторной отправки.

Коннектор Contentful 2.0 принадлежит вашей организации, а не отдельному пользователю. Токен OAuth Contentful, который использует коннектор, привязан к пользователю, авторизовавшему коннектор.

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

Используя учетную запись Contentful, создавшую токен, откройте страницу токенов API для соответствующего пространства (https://app.contentful.com/spaces/{space_id}/api/cma_tokens).
Удалите токен с именем «Memsource Connector». Если несколько токенов имеют это имя, уточните, какой из них используется соответствующим коннектором, прежде чем удалять его.
После удаления токена коннектор деактивируется до тех пор, пока новый пользователь не авторизует его повторно в настройках коннектора в Phrase TMS.

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

Настройки Prase TMS

Важно

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

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

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

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

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

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

Примечание

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

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

Примечание

Между резервным языком Contentful и этим параметром нет никакой связи.
При необходимости укажите URL-адрес предварительного просмотра в реальном времени (БЕТА-ВЕРСИЯ).

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

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

Примечание

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

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

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

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

Установите Исходный язык.

Примечание

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

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

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