REUNICO | Разработка и сопровождение ПО: Локализация Camunda Tasklist

Локализация Camunda Tasklist

Эта статья будет полезна для тех, кто использует Camunda Standalone Engine совместно с веб-приложением Tasklist.

Локализация Camunda Tasklist

Что такое Camunda Tasklist?


Tasklist - Это веб-приложение, позволяющее участнику процесса-человеку выполнять пользовательские задачи (User Task).

User Task

Когда выполнение процесса достигает элемента User Task, в списке задач пользователя (или пользователей) или группы (групп), назначенных этой задаче, создается новая задача.

Если ваш процесс содержит пользовательские задачи, а процессное приложение не имеет собственного пользовательского интерфейса, единственно возможный способ выполнения пользовательских задач - Camunda Tasklist.

Зачем вообще его нужно локализовывать?

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

Например, нам необходима поддержка русского языка

Поддерживаемые локали размещены в каталоге:

$CAMUNDA_HOME/server/apache-tomcat-*/webapps/camunda/app/tasklist/locales

"Из коробки" предоставляется только англоязычный перевод. Он содержится в файле en.json. Это файл в формате JSON, где ключом является метка (label) пользовательского интерфейса, а значением - перевод.

Вы можете либо подготовить требуемый перевод самостоятельно (скопировав en.jsom, например в kz.json и заменив значения на переведенные), либо воспользоваться ресурсами проекта Camunda Webapp Translations.

Этот проект содержит расширения для Camunda от open-source сообщества, предоставляющие переводы для веб-приложений Camunda: Tasklist, Cockpit и Admin. Проект поддерживается энтузиастами но, к сожалению, актуальность части переводов оставляет желать лучшего.

Также, вы можете воспользоваться файлом ru.json, предоставляемым компанией Реюнико. Последняя версия файла обеспечивает поддержку русского языка для Camunda Tasklist 7.12

Для подключения локализации скопируйте полученный файл в каталог locales и внесите изменения в конфигурационный файл $CAMUNDA_HOME/server/apache-tomcat-*/webapps/camunda/app/tasklist/scripts/config.js:

"locales": {
  "availableLocales": ["en", "ru"],
  "fallbackLocale": "en"
}