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

    Contentful (TMS)

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

    Доступно для

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

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

    Доступно для

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

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

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

    Для получения информации о интеграции Contentful в Phrase Strings обратитесь к Contentful (Strings).

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

    • Через специальный коннектор Contentful (2.0, начальный уровень, уровень поля)

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

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

    Примечание

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

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

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

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

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

    • Псевдонимы окружения

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

    • Импорт справочного файла

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

    • Конфигурация живого предварительного просмотра

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

    Используйте коннектор Contentful (начальный уровень).

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

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

    Используйте коннектор Contentful (на уровне поля).

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

    Примечание

    Устаревшие коннекторы больше не поддерживаются, но остаются работоспособными.

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

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

    • Менеджеры проектов могут добавлять файлы непосредственно в проекты из онлайн-хранилища. Контент можно искать по идентификатору записи.

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

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

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

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

      После того как запись будет завершена:

      • Выберите желаемые целевые языки для локализации.

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

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

        • Если выбрано нелокализуемое поле, это поле все равно не будет отправлено на перевод. Отправляются только локализуемые поля.

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

      • На основе настроек APC задания автоматически создаются из отправленного контента. Во время выполнения APC выбираются только записи со статусом отправлено для создания заданий.

      • После создания заданий из отправленной записи статус изменяется на в процессе. Когда переводы возвращаются в Contentful, статус изменяется на завершено.

      • Ранее переведенные записи могут быть повторно отправлены после изменений в оригинальном тексте.

    • Редакторы контента могут использовать главный экран Phrase TMS для:

      • Массовой отправки записей.

      • Указания отдельных целевых языков при массовой отправке.

      • Обзора активных переводческих заданий.

    Настройки Contentful

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

    1. Скачайте приложение Фраза TMS из магазина приложений.

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

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

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

    Дополнительно - Запустить приложение (устарело в Contentful)

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

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

      Примечание

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

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

    3. Выберите тип или типы контента, которые следуют описанному рабочему процессу.

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

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

    Настройки Фразы TMS (Contentful 2.0)

    Примечание

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

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

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

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

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

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

    4. Измените Тип на Контентный 2.0.

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

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

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

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

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

      1. Нажмите Сгенерировать токен.

        Откроется окно Сгенерировать токен Contentful.

      2. Нажмите Сгенерировать токен.

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

      3. Закройте окно, и будет отображено Токен сгенерирован.

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

      Идентификатор представлен, и можно добавить больше.

      • Выберите стратегию листинга

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

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

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

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

    10. При необходимости выберите Включить ресурсы.

    11. При необходимости выберите Включить упомянутые записи (вложенный контент).

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

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

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

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

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

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

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

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

      • Теги

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

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

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

    12. При необходимости выберите Включить таксономию.

      Отображается поле Идентификатор организации Contentful. Введите значение для включения настройки таксономии.

      • При выборе коннектор извлекает таксономии из Contentful и включает их в .XLIFF файл. Панель Контекстное примечание редактора CAT Editor будет перечислять значения таксономии Contentful для каждого сегмента.

      • Если метаданные таксономии недоступны или коннектор не настроен с ними, панель Контекстное примечание просто опускается.

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

    13. Если необходимо, выберите Следовать за псевдонимами.

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

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

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

      • Включено 

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

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

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

    15. При необходимости предоставьте идентификаторы контента, которые следует исключить из импорта в Phrase.

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

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

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

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

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

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

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

    Настройки Phrase TMS

    Важно

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

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

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

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

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

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

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

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

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

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

      Примечание

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

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

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

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

        Пример:

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

      Примечание

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

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

      Примечание

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

      • Contentful (уровень записи)

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

      • Contentful (уровень поля)

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

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

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

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

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

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

    8. Создайте список, разделенный запятыми, в Омить переводимые поля, чтобы исключить поля, которые проверяются для Включить локализацию этого поля из импорта в Phrase TMS. Используйте следующую структуру: contentTypeID:fieldID.

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

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

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

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

      Примечание

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

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

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

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

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

    13. Contentful (уровень записи) только:

      Установите Язык источника.

      Примечание

      Этот язык должен соответствовать стандарту локализации по умолчанию пространства 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.