Коннектор Phrase Strings (Job Sync)

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

Интеграция Phrase Strings (называемая Job Sync в интерфейсе Strings) соединяет Phrase TMS и Phrase Strings. Интеграция поддерживает синхронизацию как на уровне задания, так и на уровне проекта.

Синхронизация заданий

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

Рекомендуется для пакетных рабочих процессов с детальным контролем.
Синхронизация на уровне проекта

Все ключи в выбранном проекте Strings проект передаются в TMS без необходимости создания задания. Вновь добавленные или обновленные ключи становятся доступными для синхронизации автоматически.

Рекомендуется для рабочих процессов непрерывной локализации.

Предварительные требования

Доступ к приложениям TMS и Strings.
Коды языков, используемые в проекте TMS, должны совпадать с кодами языковых стандартов в задании Strings.
Язык по умолчанию для проекта Strings должен совпадать с языком источника, определенным в проекте TMS.

Важно

Файлы Figma могут отображаться в Strings как цельные интерактивные файлы, но не поддерживаются в TMS. CAT Editor в TMS может отображать переведенный контент только в определенном фрейме Figma в формате SVG.

Статусы перевода ключей в Strings не поддерживаются. Ключи с пометкой «не проверено» в Strings до импорта в TMS, могут быть возвращены в Strings с пометкой «подтверждено», если целевой перевод не был изменен.

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

Ключи помечаются в Strings как исключенные. Исключенные ключи не импортируются.
Опция «Сегмент XLIFF» включена в настройках импорта файлов для XLIFF 2.0 при создании задания в TMS. В этом случае количество сегментов может быть больше, чем количество ключей в Strings.

Ключи Strings могут содержать сущности HTML. При настройке коннектора в TMS включите опцию «Поместить HTML-контент в CDATA» для сохранения сущностей HTML вместо отображения соответствующих символов в TMS.

Начальные и конечные пробелы, присутствующие в оригинале ключа Strings, не отображаются в CAT Editor в TMS. Эти пробелы сохраняются в скелете и повторно вставляются как в оригинал, так и в перевод при синхронизации задания обратно в Strings. Это может повлиять на проверки ограничения количества символов, настроенные в Strings, поскольку количество пробелов не учитывается в редакторе TMS во время перевода.

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

Коннектор использует аннотации языкового стандарта задания для прикрепления метаданных о соответствующем проекте Phrase TMS к заданиям и языковым стандартам заданий в Strings. Конечная точка интерфейса приложений API Phrase Strings для перечисления аннотаций языкового стандарта задания извлекает эти метаданные. Конечная точка для перечисления целевых языковых стандартов задания также включает эти метаданные, если для параметра include_annotations установлено значение true. Аннотированные задания содержат такие поля, как tms_project_id и tms_in_progress, которые позволяют отслеживать статус задания Strings в связанном с ним проекте Phrase TMS.

Сообщения ICU и формы множественного числа CLDR

Отправляя на перевод в TMS задания Strings, содержащие сообщения ICU или формы множественного числа, включите опцию Разобрать сообщения ICU в настройках импорта файлов XLIFF 2.0 или в шаблонах проектов TMS.

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

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

Менеджеры проектов TMS могут добавить файлы непосредственно в проекты TMS из онлайн-хранилища.
Настройте портал отправителя Phrase TMS, чтобы позволить отправителям добавлять файлы к запросам непосредственно из Phrase Strings.
Используйте службу автоматического создания проектов (APC) TMS для автоматического создания новых проектов при обнаружении изменений в дате последнего изменения для отслеживаемых файлов или папок.
- Как для синхронизации на уровне задания, так и на уровне проекта, путь отслеживаемого проекта должен быть выбран вплоть до папки заданий (например, каталог/проект/основной/задания).
- Для синхронизации заданий служба автоматического создания проектов (APC) запускается следующими обновлениями заданий:
  - Добавление новых ключей или изменения в существующих ключах
  - Изменение срока выполнения задания в Strings
  Примечание
  
  Повторное открытие заданий не считается обновлением для службы автоматического создания проектов (APC).
- Для синхронизации на уровне проекта служба автоматического создания проектов (APC) запускается:
  - Недавно добавленные ключи
  - Изменения существующих ключей
- Если при настройке службы автоматического создания проектов (APC) будет выбрано «каждый раз создать новый проект», удаленное онлайн-хранилище можно будет отслеживать не только на предмет обновлений оригинала, но и обновлений перевода
  
  При выборе функции отслеживания обновлений перевода любые изменения, внесенные в копию перевода в онлайн-хранилище, автоматически обновят память переводов в Phrase TMS.
- Если выбрана опция «обновления перевода, сделанные на удаленном объекте, автоматически сохраняются в памяти переводов (TM)», изменения текста ключей на языке перевода Strings автоматически обновляются в памяти переводов TMS, используемой соответствующей службой автоматического создания проектов (APC).
Коннектор интерфейса приложений API в TMS можно использовать для автоматизации действий, выполняемых вручную через пользовательский интерфейс. Вебхуки можно использовать для уведомления сторонних систем об определенных событиях (например, изменении статуса задания).

Страница синхронизации заданий

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

Со страницы синхронизации заданий администраторы и менеджеры проектов в Strings могут настроить новые синхронизации, редактировать существующие (включая их статус) или удалять их.

Существующие синхронизации заданий можно редактировать или удалять, используя соответствующие параметры в меню «Дополнительно» More Menu . Все изменения синхронизируются между Strings и TMS. При удалении синхронизации задания в TMS удаляется соответствующая служба APC.

Страница синхронизации заданий доступна как из меню «Интеграции», так и из меню «Задания» слева.

Настройка синхронизации заданий в Strings

Примечание

Если необходимые пользовательские поля определены в TMS, настройка синхронизации задания из Strings не поддерживается.

Чтобы настроить новую синхронизацию задания между Strings и TMS с базовой конфигурацией, выполните следующие шаги в интерфейсе Strings:

На странице «Интеграции» выберите «Настроить» рядом с интеграцией «Синхронизация заданий».

Откроется страница синхронизации заданий.
Нажмите «+ Создать синхронизацию».

Откроется окно создания синхронизации заданий.
Укажите название синхронизации и выберите проект(ы) Strings для подключения к TMS из выпадающего списка «Назначенные проекты Strings».

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

Синхронизированные задания будут добавлены в проект TMS, созданный на основе выбранного шаблона.
- Если выбрано «По умолчанию», шаблон проекта TMS автоматически создается на основе выбранных проектов Strings.
Выберите тип проекта, который нужно создать в TMS.
- Непрерывный проект
  
  Опция по умолчанию.
- Новый проект
  
  Новый проект TMS создается каждый раз, когда в заданиях Strings обнаруживаются изменения.
В разделе «Экспортировать в Strings» укажите опции экспорта строк, чтобы контролировать, как переводы из TMS экспортируются в Strings.
- Заменить существующий перевод
  
  Обновляет существующие целевые переводы в Strings.
- Отметить задание как завершенное
  
  Автоматически помечает задание как завершенное в Strings.
- Подтвердить неизмененный перевод в Strings
  
  Ключи с пометкой «не проверено» будут автоматически подтверждены в Strings, если целевой перевод не был изменен.
При необходимости откройте «Расширенные параметры», чтобы отобразить дополнительные параметры экспорта.
- Отметить язык как завершенный
  
  Помечает конкретный язык как завершенный, как только переводы на нем синхронизированы.
- Создать новые ключи и обновить существующие
  
  Обеспечивает создание новых ключей из TMS в Strings и обновление существующих.
- Использовать перевод только в том случае, если оригинал совпадает с сохраненной версией
  
  Предотвращает перезапись переводов, если исходный текст изменился в Strings с момента экспорта.
Нажмите «Сохранить».

Новая конфигурация синхронизации добавляется в список синхронизаций заданий TMS с неактивным статусом. Используйте переключатель в столбце «Активные», чтобы включить синхронизацию заданий.

Настройки Prase TMS

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

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

Откроется страница «Создать коннектор».
Измените тип на Phrase Strings и укажите название для коннектора.
Введите Идентификатор учетной записи и токен доступа, полученные из Strings.
Нажмите «Проверить подключение».
- В случае успеха рядом с кнопкой Проверить соединение появится небольшая галочка.
Выберите элементы для импорта в TMS.

Если ключи на перевод не импортируются, файл XLIFF 2.0 может быть сегментирован далее, если сегмент XLIFF выбран в настройках импорта файлов для XLIFF 2.0.
- Включите или отключите дополнительные параметры импорта по мере необходимости:
  - Использовать язык оригинала проекта TMS при импорте.
    
    Язык оригинала проекта TMS применяется независимо от языка по умолчанию в проекте Strings.
  - Создать задание в TMS для каждого языка
    
    Включите эту опцию, чтобы предотвращать дублирование заданий TMS для языков, для которых работа уже выполняется. Рекомендуется для дополнительного контроля при работе с несколькими языками.
  - Поместить HTML-контент в CDATA
    
    Опция обеспечивает заворачивание сущностей HTML в CDATA для сохранения при передаче между Strings и TMS.
    
    Опция позволяет импортировать контент, сочетающий синтаксис ICU и встроенные элементы HTML.
Выберите режим экспорта.
- Включите или отключите следующие параметры экспорта по мере необходимости:
  - Перезаписать переводы
    
    Отключите, чтобы предотвратить обновление существующих переводов содержимым файла.
  - Создать новые ключи или обновить их
    
    Отключите, чтобы предотвратить создание новых ключей и обновление существующих ключей.
  - Использовать перевод только если совпадает оригинал
    
    Переводы, не соответствующие последней версии оригинала, не включаются в синхронизацию. Это помогает поддерживать согласованность между исходным текстом и переводами, избегая устаревших или неправильных переводов.
  - Подтвердить только если перевод не был изменен
    
    Ключи с пометкой «не проверено» будут автоматически проверены в Strings, если целевой перевод не был изменен.
  - Отметить язык как завершенный
    
    Помечает конкретный язык как завершенный, как только переводы на нем синхронизированы.
  - Отметить задание как завершенное
    
    При выборе этого параметра задание будет отмечено как выполненное только после загрузки последнего языкового стандарта.
Если указано, выберите папку по умолчанию (возможно только после сохранения).
Представлено сопоставление языков, которое при необходимости можно настроить. Изменения в сопоставлении языков не отразятся на существующих заданиях.

Список разбивает на страницы пять проектов за раз, при этом проекты сортируются в алфавитном порядке; сначала от A-Z (с прописной буквы), а затем a-z (со строчной буквы).
Нажмите «Сохранить».

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

Поддерживаются в интеграции:

Шаблоны проектов TMS
Рабочие процессы TMS
Инструктаж к заданию (неприменимо при использовании синхронизации на уровне проекта)
Срок выполнения задания (неприменимо при использовании синхронизации на уровне проекта)

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

Перенесено из Strings в TMS в качестве справочного файла проекта:

Имена ключей

Перенесено из Strings и отображается как контекстный ключ на панели контекстных примечаний редакторов CAT TMS.

Описания ключей

Перенесено из Strings и отображается как контекстное примечание на панели контекстных примечаний редакторов CAT TMS.

Максимальная длина символов ключа

Перенесено из Strings и отображается на панели контекстных примечаний редакторов CAT TMS.

Скриншоты

Чтобы отображать скриншоты из Strings на панели контекстного примечания редакторов TMS CAT:
- Включите опцию «Разрешить загрузку внешнего контента в редакторе Phrase CAT» в разделе настроек проекта TMS «Доступ и безопасность».
- Выберите расширенный формат текста на панели контекстного примечания.
Пользовательские метаданные поддерживаемых форматов файлов:
- .XLSX
- .CSV
- .XLIFF 2.0

Отслеживание обновлений перевода в Strings при помощи службы автоматического создания проектов (APC)

Для отслеживания обновлений перевода в Strings при помощи службы автоматического создания проектов (APC) выполните следующие действия:

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

Это позволяет отслеживать онлайн-хранилище на предмет обновлений перевода, сделанных в Strings.
В разделе «Автоматизация» настроек APC выберите «Обновления переводов, внесенные в удаленном хранилище, будут автоматически сохранены в памяти переводов».

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

Возможна перезапись обновлений памяти переводов путем изменения сегментов перевода в редакторе Phrase TMS. Эти обновления будут экспортированы обратно в Strings, когда задание Phrase TMS завершится.

Поведение при удалении ключа с помощью службы автоматического создания проектов (APC)

Удаление ключа в Strings после того, как он был включен в задание, не влияет на задание Phrase TMS, которое было создано посредством разового ручного импорта. Это задание остается без изменений до тех пор, пока оно не будет вручную импортировано повторно.

Когда мониторинг APC активен, Phrase сравнивает хеш контента при каждом опросе или срабатывании вебхука и рассматривает любое изменение, включая удаление ключа, как обновление, которое запускает повторную синхронизацию.

В режиме непрерывный проект повторная синхронизация обновляет существующий проект или задание Phrase TMS в соответствии с текущим контентом в Strings, поэтому контент удаленного ключа удаляется из этого задания.
В режиме create a new project every time повторная синхронизацию создает новую версию задания Phrase TMS, отражающую контент после удаления, в то время как ранее созданные версии задания остаются без изменений.

Синхронизация заданий — устранение неполадок

В таблице ниже описаны распространенные проблемы, с которыми могут столкнуться пользователи при использовании интеграции Strings. Она содержит возможные причины и решения для устранения неполадок.

Проблема	Причина(-ы)	Решение
Сообщение предупреждения о `NMTOKEN` в заданиях TMS	Имена ключей содержат нежелательные символы (например, пробелы)	Пользователи по-прежнему могут работать с контентом перевода и экспортировать его обратно в Strings, несмотря на сообщение с предупреждением.
Ключи в TMS пусты	Задание содержит ключи без текста оригинала на языке оригинала	Либо: Пропустите сегменты. Удалите ключи из задания Strings и повторно импортируйте оригинал из онлайн-хранилища.
Служба автоматического создания проектов (APC) не создает проекты/не обрабатывает новые задания	Несоответствие кодов языка	Убедитесь в совпадении кодов языков в Strings с кодами в проекте TMS. Если служба автоматического создания проектов (APC) задана как непрерывный проект, любые изменения, внесенные в шаблон проекта после создания проекта, не будут применяться к существующим проектам. Следовательно, изменения должны вноситься непосредственно в непрерывные проекы.
	Служба автоматического создания проектов (APC) считает задание/языковой стандарт обработанным	Если после начала задания настройки шаблона проекта/службы автоматического создания проектов (APC) изменены, то оно может считаться обработанным в истории службы автоматического создания проектов (APC). В таком случае для перехода на следующую итерацию может потребоваться обновить задание. Либо: Добавьте новый ключ к заданию или обновите существующий ключ задания Измените срок выполнения задания в Strings
	`429 Слишком много запросов` (предел интерфейса приложений API Strings)	Сократите количество APC и снизьте частоту мониторинга.
Существующий ключ в проекте Strings отсутствует в задании TMS	Конкретный ключ не был добавлен в задание Strings	Добавить ключ в задание Strings и повторно импортировать задание из онлайн-хранилища в TMS
Ошибка «Could not authenticate» появляется при попытке импортировать/экспортировать задания.	Истекший или отозванный токен доступа на автоматически созданном коннекторе «created by Phrase Strings».	Создайте новый коннектор Phrase Strings в TMS, повторно привяжите существующие APC к новому коннектору и запустите монитор.
Завершенное задание Phrase TMS не синхронизирует свои переводы обратно в Phrase Strings. Затронутые локали в Phrase Strings по-прежнему показывают слова как не переведено, несмотря на то, что Phrase TMS сообщает о завершении задания.	Переводы завершенного задания не были правильно синхронизированы обратно в Phrase Strings для затронутых локалей.	В Strings повторно откройте задание, затем отметьте затронутые локали как незавершенные. В TMS выберите задание и нажмите Reimport from online repository. Повторно запустите экспорт затронутых локалей из TMS.