Использование API для создания проектов непрерывной локализации

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

Обычно проект будет следовать этим состояниям в Бюро работ:

1. PREPARING - состояние проекта, когда вы все еще можете добавить файлы в проект
2. PENDING - это означает, что проект был проанализирован и структура затрат может быть присоединена
3. APPROVED - проект отправляется в производство - файлы больше не могут быть добавлены
4. DELIVERED - окончательное состояние, это хорошо для производства
5. INVOICED - Проект находится в дебиторской задолженности

Непрерывный проект, как правило, запустить этот путь, в вышеупомянутой последовательности. Это означает, что вы можете вытащить файлы из любого из этих состояний (при условии, что они существуют), но содержание будет меняться. Например, в состоянии PREPARING, работа, скорее всего, будет сочетание машинного перевода, если включено, и перевод Воспоминания прилагается к проекту - и это здорово! Однако, если вам нужны производственные строки, вам нужно будет выйти из состояния DELIVERED.

Эта статья предполагает, что вас устраивает механизм проверки подлинности в API.

Создание проектов и загрузка файлов

Вызов следующей конечной точки:

POST https://<SUB>.bureau.works/api/pub/v1/project/async/continuous/<TAG>

Замените <SUB для> вашей ручки Bureau Works и <TAG с> значимым представлением вашего проекта, такого как, ios,, android, Windows и, т.д.

Эта конечная точка получает форму данных в качестве ввода, со следующими параметрами:

• файл - многопартийный файл
• ссылка - что-то для вашей ссылки
• языки - список/массив с кодами языков Bureau Works (пожалуйста, обратитесь кhttps://dev.bureau.works/#languages)

Если параметры языков не будут проинформированы, Bureau Works возьмет на себя языки по умолчанию, установленные в профиле Клиента. Если никто не может быть найден, то эта конечная точка будет бросать ошибку.

В случае успеха вы получите 200 сообщение, с телом, как это:

 "id": "9999999-3333-4555-2223-964c1e52cb88",
 "статус": "NEW",
 "данные":
 "projectId": 999999,
 "fileName": "Ресурс.resx",
 "fileHash": "867423243877g24dgg9gs2gg2sg23gs239gsg",
 "productTag":
 "отправка"
 

Эта конечная точка, если вызвать в последовательности с различными файлами, добавит файлы в тот же проект, идентифицированный <TAG>.

Проекты, созданные с помощью этого метода, как правило, обнаруживаются и доступ в Бюро работ веб-интерфейс, https://<SUB>.bureau.works.

Загрузка файлов из проектов непрерывной локализации

Для загрузки файлов используйте следующую конечную точку:

GET https://<SUB>.bureau.works/api/pub/v1/project/continuous/<TAG /><FILENAME>/

Эта конечная точка имеет дополнительный параметр запроса:

• статус - при условии, будет пытаться найти желаемое состояние из списка выше

При загрузке файлов состояние будет следовать механизму возврата. Например, если проект PREPARING не найден, он автоматически попытается получить проект с тем же тегом в состоянии PENDING. Если никто не найден, он будет отыкать DELIVERED, и так далее.

Ответ этой конечной точки может быть сохранен локально в качестве файла zip, содержащего все переводы для всех языков, настраиваемых в проекте.

Для каждого тега можно создать конфигурацию в профиле Клиента, определяя структуру каталога для каждого из них. Таким образом, становится легко загрузить пакеты, готовые к развертыванию в структуре каждого проекта. Если таковые не предусмотрены, структура застежки-молнии будет:

• /
  • lang1
    • file.xml
    • file2.json
  • lang2
    • file.xml
    • file2.json
  • lang3
    • file.xml
    • file2.json