Интеграции
    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, на уровне записей, на уровне полей)

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

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

    Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Важно

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

    Обратитесь к разделу Legacy Connector Deprecation для получения полного руководства по миграции.

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

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

    • Менеджеры проектов могут добавлять файлы непосредственно в проекты из онлайн-хранилища. Контент можно искать по идентификатору записи (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 требуются разные подходы к типам контента, обратитесь к своему менеджеру по работе с клиентами (Customer Success Manager).

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

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

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

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

      • Включено 

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

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

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

    14. При необходимости укажите Preview 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. Чтобы использовать live preview, замените contentfulapp.tld в шаблоне URL на фактический домен приложения.

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

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

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

    16. Укажите Space ID и Token для Space preview token map (обязательно).

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

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

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

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

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

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

    Примечание

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

    Чтобы снизить это:

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

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

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

    Настройки Prase TMS

    Важно

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

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

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

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

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

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

    4. Измените Тип на либо Contentful (на уровне записей), либо Contentful (на уровне полей) и укажите имя для коннектора.

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

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

        Создайте токен приложения, который нужно ввести в приложении Phrase TMS Contentful. Сохраните коннектор после создания токена и копирования его в приложение 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. Создайте список, разделенный запятыми, в поле Пропустить переводимые поля, чтобы исключить из импорта в Phrase TMS поля, для которых отмечен параметр Включить локализацию этого поля. Используйте следующую структуру: contentTypeID:fieldID.

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

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

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

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

      Примечание

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

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

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

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

    12. Нажмите Connect to Contentful.

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

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

      Установите Source language.

      Примечание

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

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

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

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

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

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

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

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

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

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

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

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

      Примечание

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

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

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

    1. На странице Integrations выберите коннектор, который нужно удалить.

    2. Нажмите Delete.

      Откроется окно Delete connector.

    3. Введите «delete» и нажмите Delete.

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

    Примечание

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

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

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

    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.