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

    Contentful (TMS)

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

    Доступно для

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

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

    Доступно для

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

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

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

    Информацию об интеграции Contentful в Phrase Strings см. в разделе Contentful (Strings).

    Contentful предоставляет инфраструктуру управления контентом без интерфейса (headless) для создания, управления и распространения контента на любую платформу или устройство. Phrase интегрируется с Contentful двумя способами: 

    • Через специальный коннектор Contentful (2.0, Entry-Level, Field-Level)

      Коннектор Contentful 2.0 в настоящее время поддерживает аутентификацию только через центр обработки данных в США.

    • Через плагин Contentful Marketplace для индивидуальной настройки

    Примечание

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

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

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

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

    • Несколько пробелов

    • Псевдонимы сред

    • Настройка URL-адреса предварительного просмотра

    • Импорт ссылок

    • Фильтрация контента на основе тегов

    • Настройка предварительного просмотра в реальном времени

    Contentful (Entry-Level Localization) (устаревший метод)

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

    Коннектор 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:

    1. Загрузите приложение Phrase TMS из маркетплейса.

    2. Установите приложение в текущее активное пространство и выберите модели контента, в которых требуется установка приложения.

    3. Введите токен аутентификации Phrase TMS, полученный при создании коннектора в Phrase TMS.

    4. Нажмите Установить.

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

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

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

      Примечание

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

    2. Настройте требуемый рабочий процесс локализации.

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

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

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

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

    Примечание

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

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

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

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

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

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

    4. Измените Тип на Contentful 2.0.

    5. Укажите название для коннектора.

    6. Нажмите Подключиться к Contentful 2.0.

      Откроется окно входа в Contentful.

    7. Введите данные для входа и нажмите Войти (или используйте альтернативные способы входа). Окно входа закрывается, и отображается Connected.

    8. При необходимости установите флажок Приложение Phrase Contentful, если используете коннектор с этим приложением.

      1. Нажмите Создать токен.

        Откроется окно Generate Contentful Token.

      2. Нажмите Создать токен.

        Генерируется токен, который следует скопировать в буфер обмена или текстовый файл. Убедитесь, что токен скопирован перед закрытием окна, так как он больше не будет виден. Этот токен будет использоваться при подключении к приложению.

      3. Закройте окно, и отобразится Token generated.

    9. Если для идентификации переводимого контента используются Contentful Tags, введите ID тега и нажмите Enter.

      ID отображается, и можно добавить ещё. Теги можно использовать для ограничения контента из Contentful, видимого для коннектора.

      • Выберите стратегию отображения списка.

        • Со всеми тегами 

          Отображает контент в Contentful со всеми перечисленными тегами.

        • Как минимум с одним тегом 

          Отображает контент из Contentful как минимум с одним из перечисленных тегов.

    10. При необходимости выберите Include assets.

    11. При необходимости выберите Include referenced entries (вложенный контент).

      Отображаются Referenced entries settings. Примените нужные фильтры, чтобы более детально настроить то, как система обрабатывает связи контента.

      • Установите глубину импорта для связанных записей 

        Ограничивает глубину перехода Phrase по связанным записям во время импорта.

        Значение по умолчанию — 10,000. При необходимости выберите другие значения или укажите произвольное целое число.

      • Тип контента

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

      • Тип контента родительского элемента

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

      • Теги

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

      • Идентификаторы поля

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

    12. При необходимости выберите Include taxonomy.

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

      • При выборе этой опции коннектор извлекает таксономии из Contentful и включает их в .XLIFF file. Панель Context note в CAT editor будет содержать значения таксономии Contentful для каждого сегмента.

      • Если метаданные таксономии недоступны или коннектор не настроен для работы с ними, панель Context note просто не отображается.

      • Если для проекта не требуется контекст функции/экрана, рекомендуется оставить таксономию отключенной для оптимизации производительности при экспорте .XLIFF.

    13. При необходимости выберите Follow aliases.

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

      Функция «Follow aliases» применяется только к мониторингу APC, повторному импорту и экспорту заданий стандартного коннектора. Она не применяется к записям, отправленным через приложение Phrase Contentful. При использовании приложения запись остаётся привязанной к той среде, из которой она была отправлена. Это сохраняется, даже если эта среда впоследствии будет удалена или заменена за стабильным псевдонимом. Если исходная среда удалена или заменена, коннектор не подхватывает запись в новой среде, даже если включена функция Follow aliases. Повторно отправьте запись из Contentful, пока активна новая среда, чтобы коннектор мог ее обнаружить.

      • Disabled (по умолчанию и рекомендуется)

        APC и созданные задания привязаны к среде, на которую указывал псевдоним в момент создания задания/APC. APC только отслеживают эту среду и контент; задания экспортируются и повторно импортируются в нее.

      • Включено 

        APC и созданные задания привязаны к самому псевдониму. APC только отслеживают этот псевдоним и контент; задания экспортируются и повторно импортируются в него.

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

      Пользовательские роли Contentful требуют прямого доступа к конкретной базовой среде, на которую указывает псевдоним, а не только к самому псевдониму, иначе панель управления приложения Phrase TMS не загрузится. Добавьте этот доступ в Contentful в разделе Contentful Space Settings/Roles, в разделе Environments роли. Если псевдоним позже будет перенаправлен на другую среду, добавьте доступ также к новой среде.

    14. При необходимости укажите 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 для получения дополнительной информации о настройке предварительного просмотра контента.

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

    15. При необходимости используйте Omit translatable fields, чтобы исключить определённые поля из импорта в Phrase. Укажите ContentID, которые должны быть исключены из импорта.

    16. Укажите ID пространства и Токен для карты токенов предварительного просмотра пространства (обязательно).

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

      Интеграция Contentful 2.0 использует этот API для импорта контента и отслеживания изменений (APC).

      • Выберите каждое пространство и среду для мониторинга/импорта из Contentful.

      • Настройка и доступ управляются непосредственно в Contentful.

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

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

    Примечание

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

    Чтобы уменьшить это:

    • Удалите тег перевода после завершения работы с записью и добавьте его снова, только если требуется повторный перевод.

    • Сузьте настройки Referenced entries только до тех записей, которые требуют перевода.

    • Используйте приложение Phrase Contentful, которое отслеживает только записи, отправленные через него.

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

    Настройки Prase TMS

    Важно

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

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

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

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

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

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

    4. Измените Type на либо Contentful (Entry-Level), либо Contentful (Field-Level) и укажите имя для коннектора.

    5. При необходимости установите флажок Phrase Contentful App, если используете коннектор с приложением.

      • Токен приложения Contentful

        Сгенерируйте токен приложения, который нужно ввести в приложение Contentful Phrase TMS. Сохраните коннектор после создания токена и его копирования в приложение Contentful.

      Примечание

      После сохранения токен нельзя изменить из Contentful. Чтобы обновить его, отзовите токен в конфигурации коннектора в Phrase TMS и создайте новый.

    6. Настройте параметры, не зависящие от языка.

      • Язык оригинала

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

        Пример:

        Если EN-US установлен в качестве языка по умолчанию в Contentful, но для локализации в определенном пространстве или модели контента требуется DE-DE в качестве исходного языка, конфигурацию можно настроить так, чтобы пространство (удаленная папка) извлекало контент из DE-DE, а не из EN-US.

      Примечание

      Неприменимо при использовании приложения.

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

      Примечание

      Неприменимо при использовании приложения.

      • Contentful (начальный уровень)

        Коннектор на уровне записи автоматически проходит по всей иерархии вложенного контента.

      • Contentful (Field-Level)

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

        • Только выбранная запись

          • Импортируется контент, который был явно выбран при добавлении из репозитория.

          • Изменения, обнаруженные APC, импортируются для перевода.

        • Импортировать связанные записи

          • Коннектор проходит по всей иерархии вложенного контента и импортирует все переводимые поля для перевода.

    8. Создайте список через запятую в поле Omit translatable fields, чтобы исключить из импорта в Phrase TMS поля, для которых отмечена опция Enable localization of this field. Используйте следующую структуру: contentTypeID:fieldID.

      • Выберите Leave omitted fields empty, если указанные поля должны остаться пустыми. Эта настройка будет применяться ко всем указанным вводам.

      • Выберите Copy source to target, если указанные поля должны содержать исходные значения. Эта настройка будет применяться ко всем указанным вводам.

    9. Выберите Use fallback language, если для определенного поля на исходном языке отсутствуют данные.

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

      Примечание

      Между резервным языком Contentful и этим параметром нет никакой связи.

    10. При необходимости укажите URL-адрес предварительного просмотра в реальном времени (BETA).

      Это шаблон 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, укажите фиксированное значение и создайте несколько экземпляров коннектора.

    11. Если служба технической поддержки запрашивает ведение журнала отладочной информации, выберите Вести журнал отладочной информации.

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

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

    13. Только для Contentful (Entry-Level):

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

      Примечание

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

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

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

    15. При необходимости отредактируйте коннектор, чтобы выбрать Рабочие процессы Contentful.

      • Перевести статьи с

        Коннектор отслеживает статьи на выбранном этапе (например, «Перевод»). Автор может применить эту метку к статьям, когда они готовы к переводу.

      После импорта из коннектора Contentful

      • Задать для исходных статей

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

      После экспорта в коннектор Contentful

      • Задать для исходных статей

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

      Примечание

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

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

    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.