Localization of tasklist, cockpit, admin for 7.2.0 - correct way of development process?

[Andrii Stesin]

Hello world,

I'm a business process analyst (not a software developer) and I'm trying to adopt Camunda BPM for creation of executable sketches of my BPMN 2.0 models.

What I need and I'll be glad to contribute is an addition of Ukrainian (and possibly russian) language to Camunda tasklist, cockpit and admin user interfaces.

Can anyone suggest a correct way to do this?

First of all I set up Linux, Java, mvn, Node.js, global npm, global grunt, global bower and Eclipse and learned how to build my own 7.2.0-SNAPSHOTS according to the GitHub instructions https://github.com/camunda/camunda-bpm-platform with plain `mvn clean install` from command line and no integration tests - it works! :)

(Question: how can I set up build process which will be 1) limited to MySQL DB and Tomcat support, 2) omit welcome application, 3) run also from Eclipse with Run As => Maven Install not only from CLI?) 

Now Ok I thought - I'll learn how to build https://github.com/camunda/camunda-bpm-webapp project and start with it I'll make my changes step by step and rebuild and redeploy and so it goes. Here my story began.

First of all, I tried the procedure with grunt https://github.com/camunda/camunda-bpm-webapp#setup-step

npm install worked

grunt setup only worked when I did it with root permissions because /usr/lib/node_modules aren't available for linking otherwise - but grunt failed with diagnostics 

npm ERR! EEXIST, open '/home/stesin/.npm/098f898f-sin-npm-lodash-2-4-1-package-tgz.lock'

File exists: /home/stesin/.npm/098f898f-sin-npm-lodash-2-4-1-package-tgz.lock

Move it away, and try again. 

npm ERR! System Linux 3.13.0-37-generic

npm ERR! command "/usr/bin/node" "/usr/bin/npm" "link"

npm ERR! cwd /home/stesin/eclipse-luna-workspace/camunda-bpm-sdk-js

npm ERR! node -v v0.10.32

npm ERR! npm -v 1.4.28

npm ERR! path /home/stesin/.npm/098f898f-sin-npm-lodash-2-4-1-package-tgz.lock

npm ERR! code EEXIST

npm ERR! errno 47

npm ERR! not ok code 0

npm ERR! EEXIST, open '/home/stesin/.npm/098f898f-sin-npm-lodash-2-4-1-package-tgz.lock'

There wasn't a file 098f898f-sin-npm-lodash-2-4-1-package-tgz.lock anywhere near. After some struggling with grunt I gave up, cleaned everything and started from very scratch doing staff by hand according to https://github.com/camunda/camunda-bpm-webapp#by-hands

First of all I was operating as root due to /usr/lib/node_modules access rights, and cleaned all camunda symlinks left in /usr/lib/node_modules from prefious failed attempts. A chain of npm link commands between component projects went Ok after that. I reverted workspace ownership back to mine than and left from root rights. Succeeded mvn clean install in camunda-cockpit-plugin-base made sure that port 8080 is free, went to ~/workspace/camunda-bpm-webapp/webapp and did mvn clean install jetty:run -Pdevelop,livereload

This failed - jetty won't start, it didn't find a directory:

[INFO] --- jetty-maven-plugin:8.1.14.v20131031:run (default-cli) @ camunda-webapp ---

[INFO] ------------------------------------------------------------------------

[INFO] BUILD FAILURE

[INFO] ------------------------------------------------------------------------

[INFO] Total time: 20.231s

[INFO] Finished at: Mon Oct 13 16:21:15 EEST 2014

[INFO] Final Memory: 39M/686M

[INFO] ------------------------------------------------------------------------

[ERROR] Failed to execute goal org.mortbay.jetty:jetty-maven-plugin:8.1.14.v20131031:run (default-cli) on project camunda-webapp: Unable to parse configuration of mojo org.mortbay.jetty:jetty-maven-plugin:8.1.14.v20131031:run for parameter webApp: Setter org.mortbay.jetty.plugin.JettyWebAppContext.setResourceBases( [Ljava.lang.String; ) threw exception when called with parameter '[Ljava.lang.String;@4549af55': file:/home/stesin/eclipse-luna-workspace/camunda-cockpit-ui/dist is not an existing directory. InvocationTargetException -> [Help 1]

Ok I thought and I went through subprojects directories running mvn clean install in each. camunda-tasklist-ui built Ok, while camunda-cockpit-ui failed:

     ...

     [exec] jquery.ui#1.10.4 client/bower_components/jquery.ui

     [exec] Loading "Gruntfile.js" tasks...ERROR

     [exec] >> Error: Cannot find module 'grunt-seleniuminstall/tasks/seleniuminstall'

     [exec] Warning: Task "build" not found. Use --force to continue.

     [exec] 

     [exec] Aborted due to warnings.

[INFO] ------------------------------------------------------------------------

[INFO] BUILD FAILURE

[INFO] ------------------------------------------------------------------------

[INFO] Total time: 20.589s

[INFO] Finished at: Mon Oct 13 16:46:43 EEST 2014

[INFO] Final Memory: 8M/303M

[INFO] ------------------------------------------------------------------------

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-antrun-plugin:1.3:run (generate-zip) on project camunda-cockpit-ui: An Ant BuildException has occured: exec returned: 3 -> [Help 1]

What's interesting is that selenium is already installed -g

Next time there was different failure:

[INFO] ------------------------------------------------------------------------

[INFO] Building camunda-cockpit-ui 7.2.0-SNAPSHOT

[INFO] ------------------------------------------------------------------------

...

[INFO] --- maven-antrun-plugin:1.3:run (generate-zip) @ camunda-cockpit-ui ---

[INFO] Executing tasks

     [exec] requirejs-an...@1.1.0 node_modules/requirejs-angular-define

     [exec] 

     [exec] grunt-sele...@0.0.1 node_modules/grunt-seleniuminstall

     [exec] ├── under...@1.6.0

     [exec] ├── as...@0.9.0

     [exec] ├── un...@0.1.11 (setimm...@1.0.2, pulls...@0.4.1, match-...@0.0.2, readabl...@1.0.33-1, fst...@0.1.31, bin...@0.3.0)

     [exec] └── protr...@0.22.0 (sauc...@0.1.1, q...@1.0.0, minijas...@0.4.0, adm...@0.4.4, opti...@0.6.1, lod...@2.4.1, gl...@3.2.11, selenium-...@2.41.0)

     [exec] Loading "Gruntfile.js" tasks...ERROR

     [exec] >> Error: Cannot find module 'grunt-seleniuminstall/tasks/seleniuminstall'

     [exec] Warning: Task "build" not found. Use --force to continue.

     [exec] 

     [exec] Aborted due to warnings.

[INFO] ------------------------------------------------------------------------

[INFO] BUILD FAILURE

[INFO] ------------------------------------------------------------------------

[INFO] Total time: 11.500s

[INFO] Finished at: Mon Oct 13 16:52:40 EEST 2014

[INFO] Final Memory: 8M/303M

[INFO] ------------------------------------------------------------------------

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-antrun-plugin:1.3:run (generate-zip) on project camunda-cockpit-ui: An Ant BuildException has occured: exec returned: 3 -> [Help 1]

camunda-admin-ui also failed to build:

     [exec] jquery#2.1.1 client/bower_components/jquery

     [exec] 

     [exec] jquery.ui#1.10.4 client/bower_components/jquery.ui

     [exec] 

     [exec] bootstrap#3.1.1 client/bower_components/bootstrap

     [exec] └── jquery#2.1.1

     [exec] Loading "Gruntfile.js" tasks...ERROR

     [exec] >> Error: Cannot find module 'grunt-seleniuminstall/tasks/seleniuminstall'

     [exec] Warning: Task "build" not found. Use --force to continue.

     [exec] 

     [exec] Aborted due to warnings.

[INFO] ------------------------------------------------------------------------

[INFO] BUILD FAILURE

[INFO] ------------------------------------------------------------------------

[INFO] Total time: 21.032s

[INFO] Finished at: Mon Oct 13 16:55:43 EEST 2014

[INFO] Final Memory: 8M/303M

[INFO] ------------------------------------------------------------------------

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-antrun-plugin:1.3:run (generate-zip) on project camunda-admin-ui: An Ant BuildException has occured: exec returned: 3 -> [Help 1]

But what is interesting - after all those failures, build in ~/workspace/camunda-bpm-webapp/webapp went Ok and I got my long awaited personally built camunda-webapp.war inside ~/workspace/camunda-bpm-webapp/webapp/target directory!

Now let's try to deploy it. Starting with clean (freshly built) Tomcat I put fresh new and hot  camunda-webapp.war into ~/camunda-bpm-tomcat-7.2.0-SNAPSHOT/server/apache-tomcat-7.0.50/webapps and start Tomcat.

All the stuff under http://localhost:8080/camunda/app/ works. So what with http://localhost:8080/camunda-webapp/ ?

http://localhost:8080/camunda-webapp/app/cockpit/default/ does not even offer login/password form.

http://localhost:8080/camunda-webapp/app/admin/default/#/login tells that Server Error: The server reported an internal error. Try to refresh the page or login and out of the application.

...login attempt...

Not found: A resource you requested could not be found.

Login Failed: Wrong credentials or missing access rights to application

http://localhost:8080/camunda-webapp/app/tasklist/default/#/login asked for login but said that Can not log in with those credentials.

So what is the correct way to start development of multilingual tasklist, admin and cockpit? What am I doing wrong?

Thanks in advance!

WBR,

Andrii

[Valentin Vago]

Hi Andrii,

for now, only the upcoming version of the Tasklist webapp will support internationalization.

Some odd things happend during your installation.

I am currently removing the references to protractor testing tools from the UI projects (causing seleniuminstall problems), 

this will be pushed within an hour.

In order to translate the interface elements from the Tasklist, I would recommend to proceed the following way:
The strings to be translated are located in directories of 2 projects: camunda-tasklist-ui and camunda-commons-ui.

You should copy and rename the "en.json" files into "ru.json" (for Russian language) and then edit their content.

An additional step has to be done in the camunda-tasklist-ui/client/scripts/config/translations.js file. You will need to edit this file to add the languages you want (see the commented code).

I hope it will help.

All the best,

Valentin

[Andrii Stesin]

Dear Valentin,

thank you for informative answer! Do you mean 7.2.0 release by "upcoming version of the Tasklist application"? I'm trying to master 7.2.0-SNAPSHOT just now roughly because I already discovered a possibility to localize Tasklist app in this branch (which you described below).

Do I need to clean everything (cloned sources etc.) and start build webapps from scratch after the changes you are going to make?

Thank you!

WBR,

Andrii

[Valentin Vago]

Hi again,

by upcoming of version of the tasklist, I mean, the tasklist who is bundled with the 7.2-SNAPSHOT, indeed.

Its actual state is very unstable and a huge refactoring is beeing made - on the tasklist - right now.

It is OK if you want to make yourself an idea of the localization mechanisms but definetly not if you want an overview of the other features.

Now that it is said.

What I would do try (from what I understand of the state of your setup) is:

1. remove the "node_modules" filders from the following projects:
   
1. camunda-tasklist-ui
2. camunda-cockpit-ui
3. camunda-admin-ui
4. camunda-commons-ui
2. pull the changes from those projects (normally, with the changes I made this morning, selenium and protractor should not annoy you anymore)
3. go the camunda-bpm-webapp directory
4. run `grunt parallel:linkFrom`
5. run `grunt parallel:bonerInstall` (no, it's not a typo... :) )
6. run `grunt parallel:linkTo`

Some of those operation may take ages to complete, but they are finished and they succeeded, you will be able to run `grunt` (without anything more).

All the best,

Valentin

PS: by the way, I would be really happy to have some feedback about the localization!

[Andrii Stesin]

Ok I got it.

Already pulled changes you did; thanks for the instructions. Got this:

stesin@Stesin-A:~/eclipse-luna-workspace/camunda-bpm-webapp$ grunt parallel:linkFrom

Will start the platform with command

mvn clean install jetty:run -DskipTests -Pdevelop,livereload -o

Running "parallel:linkFrom" (parallel) task

npm ERR! Error: EACCES, unlink '/usr/lib/node_modules/camunda-commons-ui'

npm ERR!  { [Error: EACCES, unlink '/usr/lib/node_modules/camunda-commons-ui']

npm ERR!   errno: 3,

npm ERR!   code: 'EACCES',

npm ERR!   path: '/usr/lib/node_modules/camunda-commons-ui' }

npm ERR! 

npm ERR! Please try running this command again as root/Administrator.

npm ERR! System Linux 3.13.0-37-generic

npm ERR! command "/usr/bin/node" "/usr/bin/npm" "link"

npm ERR! cwd /home/stesin/eclipse-luna-workspace/camunda-commons-ui

npm ERR! node -v v0.10.32

npm ERR! npm -v 1.4.28

npm ERR! path /usr/lib/node_modules/camunda-commons-ui

npm ERR! code EACCES

npm ERR! errno 3

npm ERR! stack Error: EACCES, unlink '/usr/lib/node_modules/camunda-commons-ui'

npm ERR! 

npm ERR! Additional logging details can be found in:

npm ERR!     /home/stesin/eclipse-luna-workspace/camunda-commons-ui/npm-debug.log

npm ERR! not ok code 0

    >> 

    Warning: Task "parallel:linkFrom" failed. Use --force to continue.

Aborted due to warnings.

stesin@Stesin-A:~/eclipse-luna-workspace/camunda-bpm-webapp$ npm ERR! Error: EACCES, unlink '/usr/lib/node_modules/camunda-admin-ui'

npm ERR!  { [Error: EACCES, unlink '/usr/lib/node_modules/camunda-admin-ui']

npm ERR!   errno: 3,

npm ERR!   code: 'EACCES',

npm ERR!   path: '/usr/lib/node_modules/camunda-admin-ui' }

npm ERR! 

npm ERR! Please try running this command again as root/Administrator.

npm ERR! System Linux 3.13.0-37-generic

npm npm ERR! Error: EACCES, unlink '/usr/lib/node_modules/camunda-bpm-sdk-js'

npm ERR!  { [Error: EACCES, unlink '/usr/lib/node_modules/camunda-bpm-sdk-js']

npmnpm  ERR! Error: EACCES, unlink '/usr/lib/node_modules/camunda-cockpit-ui'

ERR!   errno: 3,

npmnpm ERR!   code: 'EACCES',

npm ERR!   path: '/usr/lib/node_modules/camunda-bpm-sdk-js' }

 ERR!  { [Error: EACCES, unlink '/usr/lib/node_modules/camunda-cockpit-ui']

npm ERR!npm ERR!   errno: 3,

 

npm ERR!npm Please try running this command again as root/Administrator.

 

ERR!npm npm    code: 'EACCES',

ERR!ERR! Error: EACCES, unlink '/usr/lib/node_modules/camunda-tasklist-ui'

npm npmSystem  ERR! Linux 3.13.0-37-generic

  { [Error: EACCES, unlink '/usr/lib/node_modules/camunda-tasklist-ui']

npmERR! ERR!   errno: 3,

npm ERR!   code: 'EACCES',

npm ERR!   path: '/usr/lib/node_modules/camunda-cockpit-ui' }

   path: '/usr/lib/node_modules/camunda-tasklist-ui' }

npm npmnpm ERR!ERR!ERR!  

npm 

npm ERR! Please try running this command again as root/Administrator.

 

ERR! Please try running this command again as root/Administrator.

npm ERR! System Linux 3.13.0-37-generic

 command "/usr/bin/node" "/usr/bin/npm" "link"

npm ERR! npmcwd /home/stesin/eclipse-luna-workspace/camunda-admin-ui

 ERR! npm npm System Linux 3.13.0-37-generic

ERR! node -v v0.10.32

npm ERR! npm -v 1.4.28

npm npmERR! path /usr/lib/node_modules/camunda-admin-ui

npm ERR! code EACCES

 npm ERR! errno 3

ERR!npm ERR! stackERR! Error: EACCES, unlink '/usr/lib/node_modules/camunda-admin-ui'

 command "/usr/bin/node" "/usr/bin/npm" "link"

npm  ERR! cwd /home/stesin/eclipse-luna-workspace/camunda-tasklist-ui

commandnpm  "/usr/bin/node" "/usr/bin/npm" "link"

ERR! npm node -v v0.10.32

npm ERR!ERR! npm -v  1.4.28

ERR!npmcwd  /home/stesin/eclipse-luna-workspace/camunda-bpm-sdk-js

npm ERR!ERR! path /usr/lib/node_modules/camunda-tasklist-ui

 npm node -vERR! v0.10.32

npm ERR!  npm -v  1.4.28

commandcode EACCES

 "/usr/bin/node" "/usr/bin/npm" "link"

npmnpm  ERR! ERR!errno 3

 npmnpmpath  /usr/lib/node_modules/camunda-bpm-sdk-js

ERR!  ERR! npmstackcwd  /home/stesin/eclipse-luna-workspace/camunda-cockpit-ui

ERR! npmcode  EACCES

ERR! npmnode -v  v0.10.32

ERR!npm  Error: EACCES, unlink '/usr/lib/node_modules/camunda-tasklist-ui'

 ERR! npm -verrno 1.4.28

 3

npm npm ERR! ERR!stack path /usr/lib/node_modules/camunda-cockpit-ui

npm  Error: EACCES, unlink '/usr/lib/node_modules/camunda-bpm-sdk-js'

ERR! code EACCES

npm ERR! errno 3

npm ERR! stacknpm ERR! 

 Error: EACCES, unlink '/usr/lib/node_modules/camunda-cockpit-ui'

npm ERR! Additional logging details can be found in:

npm ERR!     /home/stesin/eclipse-luna-workspace/camunda-admin-ui/npm-debug.log

npm ERR! not ok code 0

npm ERR! 

npm ERR! Additional logging details can be found in:

npm ERR!     /home/stesin/eclipse-luna-workspace/camunda-tasklist-ui/npm-debug.log

npm ERR! not ok code 0

npm ERR! 

npm ERR!npm Additional logging details can be found in:

 ERR! 

npmnpm  ERR!ERR! Additional logging details can be found in:

npm ERR!     /home/stesin/eclipse-luna-workspace/camunda-cockpit-ui/npm-debug.log

     /home/stesin/eclipse-luna-workspace/camunda-bpm-sdk-js/npm-debug.log

npm npmERR! ERR!  not ok code 0

not ok code 0

stesin@Stesin-A:~/eclipse-luna-workspace/camunda-bpm-webapp$ 

As for feedback about the localization - as soon as I'll get my own localized build of Tasklist 7.2.0-SNAPSHOT I'll test it and report to you.

BTW what is suggested mechanism of changing UI language for the user? I guess that for now it relies on browser's preferred language setting, but is some explicit UI control for the language planned somewhere?

WBR,
Andrii

[Andrii Stesin]

Sorry, wrong copy-paste doubled the diagnostic output, my fault.

[Valentin Vago]

No problem.

the EACCESS errors are due to the install of node as root... actually a very common mistake.

I really recommend installing node using nvm (node version manager) and this, only with a "normal user".

Unfortunately, I have no other better hints than either removing manually the directories or completely uninstall node and reinstall it with nvm (please note that the first installation might already have messed your PATHs and environment variables... so.. no guarantee)

 

The language detection is, indeed, made on the browser language. A language switcher should not be a big problem but we are focused on other aspects of development for now.

All the best,

Valentin

[Andrii Stesin]

I'm not sure is installing node as root really is an "error" on multiuser system (which Unix is) but I got the point. Should I also note that global installation of node as root is exactly what original Node.js installation instruction suggests everyone? Being new to this, I just did what they told me to :)

see https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager#debian-and-ubuntu-based-linux-distributions

Got the idea, I'll wipe it all out and reinstall into userland from scratch.

Thank you!

WBR,

Andrii

[Valentin Vago]

I might not have had use the word "mistake"... But I saw that kind issues in so many places around the web and from my experiences (and I made quite a lot), the nvm way was always a good pick.

All the best and good luck!

Valentin 

[Andrii Stesin]

Got it. Ok, I purged old sources, purged nodejs from the system, got nvm and installed it, added nvm's `source...` line to ~/.bash_profile and restarted bash

Installed node 0.10.32 as a user (not root) locally.

Installed `npm install -g grunt-cli` - does this worth a notice in the installation instruction?

And now `grunt setup` in camunda-bpm-webapp runs but failed somewhere on the way with:

/home/stesin/.nvm/v0.10.32/lib/node_modules/camunda-admin-ui -> /home/stesin/eclipse-luna-workspace/camunda-admin-ui

    

npm ERR! EEXIST, open '/home/stesin/.npm/098f898f-sin-npm-lodash-2-4-1-package-tgz.lock'

File exists: /home/stesin/.npm/098f898f-sin-npm-lodash-2-4-1-package-tgz.lock

Move it away, and try again. 

npm ERR! System Linux 3.13.0-37-generic

npm ERR! command "/home/stesin/.nvm/v0.10.32/bin/node" "/home/stesin/.nvm/v0.10.32/bin/npm" "link"

npm ERR! cwd /home/stesin/eclipse-luna-workspace/camunda-cockpit-ui

npm ERR! node -v v0.10.32

npm ERR! npm -v 1.4.28

npm ERR! path /home/stesin/.npm/098f898f-sin-npm-lodash-2-4-1-package-tgz.lock

npm ERR! code EEXIST

npm ERR! errno 47

npm ERR! not ok code 0

    >> 

    Warning: Task "parallel:linkFrom" failed. Use --force to continue.

Aborted due to warnings.

npm ERR! not ok code 0pse-luna-workspace/camunda-bpm-webapp$ |

[Valentin Vago]

Hi Andrii,

The grunt install is actually mentioned (as well as my recommendation about the way to install node.js) in the README of camunda-bpm-webapp (https://github.com/camunda/camunda-bpm-webapp#prerequisite).

I made a little edit yesterday to make it clearer.

Now, with your last "npm issue"... I find it really odd and am a bit clueless about the way how to fix that.

I will have a look at it (I think lodash is a dependency of bpmn-js) and will keep you updated.

All the best,

Valentin

[Andrii Stesin]

Dear Valentin,

thank you for the patience. Somewhat I overcame that issue, as of today morning 2014.10.15 my disposition is as follows.

Terminal windows (total of 7) are open in project directories camunda-commons-ui, camunda-bpm-sdk-js, camunda-tasklist-ui, camunda-admin-ui, camunda-cockpit-ui, camunda-cockpit-plugin-base and camunda-bpm-webapp.

I started my morning with ^C for all `grunt auto-build` commands which were left running from yesterday, and did

$ git pull ; mvn clean install

in all windows but the last one. Obviously, where maven didn't know what to do (camunda-commons-ui and camunda-bpm-sdk-js) it predictably failed, Ok so far. All other builds were Ok. Then I started grunt auto-buid where applicable (4 windows: camunda-bpm-sdk-js, camunda-tasklist-ui, camunda-admin-ui, camunda-cockpit-ui) and it worked Ok and went to "Waiting..." state. Ok so far.

What I sholud mention: yesterday I completed my first edition of russian locale for tasklist (2 files ru.json which were mentioned), put them where they belong to and edited translations.js as follows:

define([
  'json!locales/en.json',
  'json!locales/de.json',
  'json!locales/fr.json',
  'json!locales/ru.json'
], function(
  en,
  de,
  ru,
  fr
) {
  'use strict';
  return [
    '$translateProvider',
  function(
    $translateProvider
  ) {
    // Simply register translation table as object hash
    $translateProvider
      .translations('en', en)
      .translations('ru', ru)
      // .translations('de', de)
      // .translations('fr', fr)

      .registerAvailableLanguageKeys([
        'en',
        'ru'
        // 'de',
        // 'fr'
      ])
      // .preferredLanguage('en')
      .preferredLanguage('ru')

      // using the determinePreferredLanguage()
      // would lead to use something like "en_US"
      // .determinePreferredLanguage()
      .fallbackLanguage('en')
    ;
  }];
});

When maven was building Tasklist it told me that

     [exec] Running "localescompile:prod" (localescompile) task
     [exec] Wrote "de" translations in dist/locales/de.json
     [exec] Wrote "en" translations in dist/locales/en.json
     [exec] Wrote "fr" translations in dist/locales/fr.json
     [exec] Wrote "ru" translations in dist/locales/ru.json

so it somewhat recognized my effort.

Then I went to camunda-bpm-webapp and also did `git pull` - it brought me your changes to README.md (as was expected) and nothing more. Then mvn clean install jetty:run -Pdevelop,livereload

and here the things started. http://localhost:8080/camunda/ brought me to cockpit page which refused to accept demo:demo authorisation. Now let's see what Tasklist does.

First of all it started talking to me with a mix of English and French :) after accepting demo:demo auth I got this:

Now scratching my head of where to go further. Probably I'll try just `mvn clean install` camunda-bpm-webapp then deploy it to tomcat and see what happens.

WBR,

Andrii

[Valentin Vago]

Hi again,

as mentioned, the tasklist is under heavy refactoring and this probably the reason why it does not initialize properly.

The only solution for now is to wait a bit until the code stabilizes (I'll post here something when it will be more stable).

But the language detection (and mix from languages) is something odd I will personaly have a look at. Thanks for pointing at it.

All the best and thanks for your comprehension and patience,

Valentin

[Andrii Stesin]

Valentin, thank you! I understand the situation, sure I'll wait and try/test it again and again. I'm looking forward for some news and ready for next attempt :)

WBR,

Andrii

[Andrii Stesin]

news as of now (git pull'ed everything)

~/workspace/camunda-bpm-webapp/webapp/ -- `mvn clean install jetty:run -Pdevelop,livereload` went Ok

browser has preferred languages in this order: 'uk', 'ru', 'en_US', 'en'

tasklist starts in english and does not seem to feel any localization; translations.json is this edition:

define([
  'json!locales/en.json',
  'json!locales/de.json',
  'json!locales/fr.json',
  'json!locales/ru.json',

  'json!locales/uk.json'
], function(
  en,
  uk,
  ru,
  de,

  fr
) {
  'use strict';
  return [
    '$translateProvider',
  function(
    $translateProvider
  ) {
    // Simply register translation table as object hash
    $translateProvider
      .translations('en', en)

      .translations('uk', uk)

      .translations('ru', ru)
      // .translations('de', de)
      // .translations('fr', fr)


      .registerAvailableLanguageKeys([
        'en',

        'uk',

        'ru'
        // 'de',
        // 'fr'
      ])
      // .preferredLanguage('en')

      // .preferredLanguage('uk')

      // using the determinePreferredLanguage()
      // would lead to use something like "en_US"

      .determinePreferredLanguage()
      .fallbackLanguage('en')
    ;
  }];
});

Ok I stopped all delopment-mode things, just went to ~/workspace/camunda-bpm-webapp/webapp/ and did `mvn clean install` - successful.

In ~/workspace/camunda-bpm-webapp/distro/tomcat/target/ took camunda-webapp.war and threw it into Tomcat's webapp directory and started Tomcat. As far as I understand and can observe, my WAR is deployed into http://localhost:8080/camunda-webapp/ and it works and Tasklist opens in English and it does not have any clue about any other language. What can I do and what information can I provide in order to make translation work? I'm ready to help with whatever I can. Thanks in advance!

WBR,

Andrii

p.s. I can provide you with my initial versions of ru.json & uk.json via email in case you need those.

[Andrii Stesin]

Yet another small question. I found translation scripts also in ~/workspace/camunda-tasklist-ui/client/scripts/filter/locales

Do I need to make translations here also?

[Andrii Stesin]

Also ~/workspace/camunda-tasklist-ui/client/scripts/controls/locales -- supposedly, yes?

[Valentin Vago]

Hi,

Absolutely, the translations are splitted into multiple files (not sure it will stay that way, this is alpha code).

[Andrii Stesin]

Ok. So I'll try to compile a complete list of localizeable location in webapps source tree. Am I correct, that

• "umbrella" project directory camunda-bpm-webapp has locales which are compiled from sources,
  
• whatever is taken from camunda-commons-ui is copied from there and should not be touched,
  

and the more-or-less complete list of locations for translations is:

./camunda-commons-ui/resources/locales
./camunda-commons-ui/lib/auth/locales
./camunda-tasklist-ui/client/scripts/task/locales
./camunda-tasklist-ui/client/scripts/controls/locales
./camunda-tasklist-ui/client/scripts/variable/locales
./camunda-tasklist-ui/client/scripts/user/locales
./camunda-tasklist-ui/client/scripts/navigation/locales
./camunda-tasklist-ui/client/scripts/filter/locales
./camunda-tasklist-ui/client/scripts/process/locales
./camunda-tasklist-ui/dist/app/tasklist/locales

and (for now) that's it? and probably will be this way at least until 7.2.0-Final?

As soon as I'll get those translated and working, do you want me to contribute the 'uk' and 'ru' translations to the project?

WBR,

Andrii

 

[Valentin Vago]

Hi again,

you are almost right.

Actually, the camunda-bpm-webapp consumes the builds of the camunda-tasklist-ui (as well as admin-ui and cockpit-ui) and the camunda-tasklist-ui project has dependencies on camunda-commons-ui (for some widgets).

This means for the translations, that when you build the camunda-tasklist-ui, a grunt task will read the content of locales from camunda-commons-ui and camunda-tasklist-ui and compile them into 1 file per language.

I asked around about the inclusion of your translations.
Of course we would be glad to have tem (and offer them to the other users) but as we can not correctly review them, we will probably have to find an other solution than directly include them.

Anyways, they are very welcome and we are thankful for them!

All the best and greetings from Berlin city,

Valentin

[Andrii Stesin]

Ok, agreed, as soon as I'll get my Ukrainian-speaking Tasklist up and running, I'll check the results and send you a pack of .json files. What do you mean by " we can not correctly review them"? As a community edition, you can just include them into 7.2.0 distribution and poke me in case of problems :) What can be that "other solution than directly include them" I wonder? :)

In case you want to have a trusted "official" translations for Enterprise edition, you probably may want to deal with your Ukrainian partners, if any?

I should mention that many key-value pairs are repeated in several different places each. Now I wonder, if I have some different translation for 1 single key, where I'll see which one? :)

WBR, Andrii

[Andrii Stesin]

Hi,

so fresh news as of just now. I made all the translations everywhere, did `git pull` everywhere, `mvn clean install` for each subproject, `grunt auto-build` inside 4 viable subprojects and `mvn clean install jetty:run -Pdevelop,livereload` inside "umbrella" project. (Noticed some changes you have made in the code with regard to task search, btw).

For my surprise, Tasklist at http://localhost:8080/camunda/app/tasklist/default/#/ rejects my wishes to see it speaking Ukrainian to me :) Chrome says that page encoding is not UTF-8, it offers ISO-8859-1 by default (change encodint to UTF-8 doesn't change anything).

Warm greetings from historical Syretz district of uncient Kyiv :)

WBR,

Andrii

[Andrii Stesin]

Further investigation gave the following. I started fiddling with ~/workspace/camunda-tasklist-ui/client/scripts/config/translations.js piece of code:

      // .preferredLanguage('en')
      .preferredLanguage('uk')

      // using the determinePreferredLanguage()
      // would lead to use something like "en_US"
      // .determinePreferredLanguage()

      .fallbackLanguage('ru')
      .fallbackLanguage('en')
    ;

If I leave uncommented the call for .fallbackLanguage('en') I get text labels from en.json throughout the Tasklist interface.

As soon as I comment the call for fallback to English, I start getting just keys instead of messages, i.e. a string "NO_MATCHING_TASK" instead of expected English string "No task matching filters found." (and instead of desired string "Не знайдено завдань, які відповідають умовам фільтру." in Ukrainian which is present inside ~/workspace/camunda-tasklist-ui/client/scripts/filter/locales/uk.json file).

So for some reason, my translations just don't get accepted by the library; may it be caused by UTF-8 encoding? Maybe the library is just not ready to accept it?

WBR,

Andrii

Четвер, 16 жовтня 2014 р. 12:55:40 UTC+3 користувач Andrii Stesin написав:

[Robert Gimbel]

Hi Andrii,

I am glad to hear to get a contribution from you in terms of translations. This is very helpful to the community.

Once you are ready, please contribute your translations so that we can make them available to other.

Note: We will not merge the translations into our core codebase. Why? Because this codebase is related to us being liable for support and we are unable to support a language non of us speaks. That is why we would make the translations available as some sort of community extension with a little guide explaining how to use them.

Cheers and Thanks!

Robert

[Andrii Stesin]

Dear Robert,

I already sent the current (alpha) edition of translations to Valentin via email, probably in his inbox already. (If not, I'll resend, no problem). Yes, I agree - your position is perfectly correct with regard to not adding those to the codebase, so feel free to  use it for your convenience and for testing purposes, no problem :)

WBR,

Andrii

[Andrii Stesin]

After severe torturing the code in translations.js I've found the combination of languages and their sequence which kinda of works (below), and Tasklist now speaks Ukrainian to me. Now it will take me some time to patch all that grammatical inconsistencies here and there.

define([
  'json!locales/en.json',
  // 'json!locales/de.json',
  // 'json!locales/fr.json',

  'json!locales/ru.json',
  'json!locales/uk.json'
], function(
  en,

  ru,
  uk
  // de,
  // fr

) {
  'use strict';
  return [
    '$translateProvider',
  function(
    $translateProvider
  ) {
    // Simply register translation table as object hash
    $translateProvider
      .translations('en', en)
      .translations('ru', ru)

      .translations('uk', uk)

      // .translations('de', de)
      // .translations('fr', fr)


      .registerAvailableLanguageKeys([
        'en',

        'ru',
        'uk'

        // 'de',
        // 'fr'
      ])
      // .preferredLanguage('en')

      .preferredLanguage('uk')

      // using the determinePreferredLanguage()
      // would lead to use something like "en_US"
      // .determinePreferredLanguage()

      .fallbackLanguage('ru')
      .fallbackLanguage('en')
    ;

  }];
});

[Bernd Rücker (camunda)]

> Tasklist now speaks Ukrainian to me

 

That is really GREAT to here! That’s a good proof that it works. Awesome!

--
You received this message because you are subscribed to the Google Groups "camunda BPM users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to camunda-bpm-us...@googlegroups.com.
To post to this group, send email to camunda-...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/camunda-bpm-users/c5cea85a-d26b-4bc2-8061-f25c2f0b2141%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[Robert Gimbel]

Thanks for the files, I have created an issue for it: https://app.camunda.com/jira/browse/CAM-2911

We will look at this once the 7.2 is out

[Andrii Stesin]

Dear Robert,

just one more question. I've build camunda-bpm-platform 7.2.0-SNAPSHOT today. TaskList which came with this build is not the one I'm building from sources. Is there a way to pass translations to those TaskList inside platform snapshot and convince it to speak Ukrainian with it's (older) TaskList?

Also I built camunda-webapp.war from sources where TaskList (development one) already speaks Ukrainian in development mode under jetty - while deployed to tomcat, this does not speak Ukrainian either. Which makes me wonder, what I'm doing wrong?

[Andrii Stesin]

In case my opinion matters - I vote for one single locales directory per application, with one single file for each language. This will prevent multiplication of identical keys among different locations.

Четвер, 16 жовтня 2014 р. 09:57:05 UTC+3 користувач Valentin Vago написав:

Hi,

[Robert Gimbel]

Hi Andrii,

with our next alpha6 release, the translation has become a lot easier. All text labels can be changed in one single file. See the English version attached.

Can I ask you a big favor. Can you provide your translations based on that single file. I think you can merge a lot of the translations which you have done already. 

How will we proceed?

Once we have your translations we will make them available as community extension (separate git repository, linked to from our docs, with credit to you and everyone else who is interested in providing further translations).

Thanks a lot!

Robert

[Andrii Stesin]

Hi Robert,

sorry for delay, I missed reading the group for some days, now I'm back. I'll provide you with translations ASAP, maybe today's evening.

WBR,

Andrii

[hassan....@gmail.com]

Hello Robert...
What about right to left languages? How easy it is to change the direction of the layout?

Thanks in advance..

[Valentin Vago]

Hi Hassan,

right to left languages would probably need some design customization as well. I suspect it would not be a big deal but it was not tried yet.

All the best,

Valentin

[Andrii Stesin]

I've sent the (alpha-quality) translations for uk_UA and ru_RU by mail today.

WBR,

Andrii

[Daniel Meyer]

Hi Andrii,

Thanks! Robert will have a look at them next week.

Daniel

[David Gautier]

Hi,

I'd like to know if there is anything planned to support french ? (Or if it's already done, i may have missed it).

And if nothing's planned, an update of the process to create a new supported language.

Thanks.

On Monday, October 13, 2014 at 4:15:29 PM UTC+2, Andrii Stesin wrote:

Hello world,

I'm a business process analyst (not a software developer) and I'm trying to adopt Camunda BPM for creation of executable sketches of my BPMN 2.0 models.

What I need and I'll be glad to contribute is an addition of Ukrainian (and possibly russian) language to Camunda tasklist, cockpit and admin user interfaces.

Can anyone suggest a correct way to do this?

First of all I set up Linux, Java, mvn, Node.js, global npm, global grunt, global bower and Eclipse and learned how to build my own 7.2.0-SNAPSHOTS according to the GitHub instructions https://github.com/camunda/camunda-bpm-platform with plain `mvn clean install` from command line and no integration tests - it works! :)

(Question: how can I set up build process which will be 1) limited to MySQL DB and Tomcat support, 2) omit welcome application, 3) run also from Eclipse with Run As => Maven Install not only from CLI?) 

Now Ok I thought - I'll learn how to build https://github.com/camunda/camunda-bpm-webapp project and start with it I'll make my changes step by step and rebuild and redeploy and so it goes. Here my story began.

First of all, I tried the procedure with grunt https://github.com/camunda/camunda-bpm-webapp#setup-step

npm install worked

grunt setup only worked when I did it with root permissions because /usr/lib/node_modules aren't available for linking otherwise - but grunt failed with diagnostics 

npm ERR! EEXIST, open '/home/stesin/.npm/098f898f-sin-npm-lodash-2-4-1-package-tgz.lock'

File exists: /home/stesin/.npm/098f898f-sin-npm-lodash-2-4-1-package-tgz.lock

Move it away, and try again. 

npm ERR! System Linux 3.13.0-37-generic

npm ERR! command "/usr/bin/node" "/usr/bin/npm" "link"

npm ERR! cwd /home/stesin/eclipse-luna-workspace/camunda-bpm-sdk-js

npm ERR! node -v v0.10.32

npm ERR! npm -v 1.4.28

npm ERR! path /home/stesin/.npm/098f898f-sin-npm-lodash-2-4-1-package-tgz.lock

npm ERR! code EEXIST

npm ERR! errno 47

npm ERR! not ok code 0

npm ERR! EEXIST, open '/home/stesin/.npm/098f898f-sin-npm-lodash-2-4-1-package-tgz.lock'

There wasn't a file 098f898f-sin-npm-lodash-2-4-1-package-tgz.lock anywhere near. After some struggling with grunt I gave up, cleaned everything and started from very scratch doing staff by hand according to https://github.com/camunda/camunda-bpm-webapp#by-hands

First of all I was operating as root due to /usr/lib/node_modules access rights, and cleaned all camunda symlinks left in /usr/lib/node_modules from prefious failed attempts. A chain of npm link commands between component projects went Ok after that. I reverted workspace ownership back to mine than and left from root rights. Succeeded mvn clean install in camunda-cockpit-plugin-base made sure that port 8080 is free, went to ~/workspace/camunda-bpm-webapp/webapp and did mvn clean install jetty:run -Pdevelop,livereload

This failed - jetty won't start, it didn't find a directory:

[INFO] --- jetty-maven-plugin:8.1.14.v20131031:run (default-cli) @ camunda-webapp ---

[INFO] ------------------------------------------------------------------------

[INFO] BUILD FAILURE

[INFO] ------------------------------------------------------------------------

[INFO] Total time: 20.231s

[INFO] Finished at: Mon Oct 13 16:21:15 EEST 2014

[INFO] Final Memory: 39M/686M

[INFO] ------------------------------------------------------------------------

[ERROR] Failed to execute goal org.mortbay.jetty:jetty-maven-plugin:8.1.14.v20131031:run (default-cli) on project camunda-webapp: Unable to parse configuration of mojo org.mortbay.jetty:jetty-maven-plugin:8.1.14.v20131031:run for parameter webApp: Setter org.mortbay.jetty.plugin.JettyWebAppContext.setResourceBases( [Ljava.lang.String; ) threw exception when called with parameter '[Ljava.lang.String;@4549af55': file:/home/stesin/eclipse-luna-workspace/camunda-cockpit-ui/dist is not an existing directory. InvocationTargetException -> [Help 1]

Ok I thought and I went through subprojects directories running mvn clean install in each. camunda-tasklist-ui built Ok, while camunda-cockpit-ui failed:

     ...

     [exec] jquery.ui#1.10.4 client/bower_components/jquery.ui

     [exec] Loading "Gruntfile.js" tasks...ERROR

     [exec] >> Error: Cannot find module 'grunt-seleniuminstall/tasks/seleniuminstall'

     [exec] Warning: Task "build" not found. Use --force to continue.

     [exec] 

     [exec] Aborted due to warnings.

[INFO] ------------------------------------------------------------------------

[INFO] BUILD FAILURE

[INFO] ------------------------------------------------------------------------

[INFO] Total time: 20.589s

[INFO] Finished at: Mon Oct 13 16:46:43 EEST 2014

[INFO] Final Memory: 8M/303M

[INFO] ------------------------------------------------------------------------

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-antrun-plugin:1.3:run (generate-zip) on project camunda-cockpit-ui: An Ant BuildException has occured: exec returned: 3 -> [Help 1]

What's interesting is that selenium is already installed -g

Next time there was different failure:

[INFO] ------------------------------------------------------------------------

[INFO] Building camunda-cockpit-ui 7.2.0-SNAPSHOT

[INFO] ------------------------------------------------------------------------

...

[INFO] --- maven-antrun-plugin:1.3:run (generate-zip) @ camunda-cockpit-ui ---

[INFO] Executing tasks

     [exec] requirejs-an...@1.1.0 node_modules/requirejs-angular-define

     [exec] 

     [exec] grunt-sele...@0.0.1 node_modules/grunt-seleniuminstall

     [exec] ├── under...@1.6.0

     [exec] ├── as...@0.9.0

     [exec] ├── un...@0.1.11 (setimm...@1.0.2, pulls...@0.4.1, match-...@0.0.2, readabl...@1.0.33-1, fst...@0.1.31, bin...@0.3.0)

     [exec] └── protr...@0.22.0 (sauc...@0.1.1, q...@1.0.0, minijas...@0.4.0, adm...@0.4.4, opti...@0.6.1, lod...@2.4.1, gl...@3.2.11, selenium-...@2.41.0)

     [exec] Loading "Gruntfile.js" tasks...ERROR

     [exec] >> Error: Cannot find module 'grunt-seleniuminstall/tasks/seleniuminstall'

     [exec] Warning: Task "build" not found. Use --force to continue.

     [exec] 

     [exec] Aborted due to warnings.

[INFO] ------------------------------------------------------------------------

[INFO] BUILD FAILURE

[INFO] ------------------------------------------------------------------------

[INFO] Total time: 11.500s

[INFO] Finished at: Mon Oct 13 16:52:40 EEST 2014

[INFO] Final Memory: 8M/303M

[INFO] ------------------------------------------------------------------------

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-antrun-plugin:1.3:run (generate-zip) on project camunda-cockpit-ui: An Ant BuildException has occured: exec returned: 3 -> [Help 1]

camunda-admin-ui also failed to build:

     [exec] jquery#2.1.1 client/bower_components/jquery

     [exec] 

     [exec] jquery.ui#1.10.4 client/bower_components/jquery.ui

     [exec] 

     [exec] bootstrap#3.1.1 client/bower_components/bootstrap

     [exec] └── jquery#2.1.1

     [exec] Loading "Gruntfile.js" tasks...ERROR

     [exec] >> Error: Cannot find module 'grunt-seleniuminstall/tasks/seleniuminstall'

     [exec] Warning: Task "build" not found. Use --force to continue.

     [exec] 

     [exec] Aborted due to warnings.

[INFO] ------------------------------------------------------------------------

[INFO] BUILD FAILURE

[INFO] ------------------------------------------------------------------------

[INFO] Total time: 21.032s

[INFO] Finished at: Mon Oct 13 16:55:43 EEST 2014

[INFO] Final Memory: 8M/303M

[INFO] ------------------------------------------------------------------------

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-antrun-plugin:1.3:run (generate-zip) on project camunda-admin-ui: An Ant BuildException has occured: exec returned: 3 -> [Help 1]

But what is interesting - after all those failures, build in ~/workspace/camunda-bpm-webapp/webapp went Ok and I got my long awaited personally built camunda-webapp.war inside ~/workspace/camunda-bpm-webapp/webapp/target directory!

Now let's try to deploy it. Starting with clean (freshly built) Tomcat I put fresh new and hot  camunda-webapp.war into ~/camunda-bpm-tomcat-7.2.0-SNAPSHOT/server/apache-tomcat-7.0.50/webapps and start Tomcat.

All the stuff under http://localhost:8080/camunda/app/ works. So what with http://localhost:8080/camunda-webapp/ ?

http://localhost:8080/camunda-webapp/app/cockpit/default/ does not even offer login/password form.

http://localhost:8080/camunda-webapp/app/admin/default/#/login tells that Server Error: The server reported an internal error. Try to refresh the page or login and out of the application.

...login attempt...

Not found: A resource you requested could not be found.

Login Failed: Wrong credentials or missing access rights to application

http://localhost:8080/camunda-webapp/app/tasklist/default/#/login asked for login but said that Can not log in with those credentials.

So what is the correct way to start development of multilingual tasklist, admin and cockpit? What am I doing wrong?

[Andrii Stesin]

Dear David,

it seems to me that nobody in the whole world will object against you plans of adding French to camunda :)

BTW I'm going to devote some time next week to refreshing the uk_UA and ru_RU support and update those at least to 7.4.0 (not sure about master branch, though).

The proper place to start is probably https://github.com/camunda/camunda-tasklist-translations

WBR,

Andrii

[Matthijs Burke]

Hi David,

currently there isn't anything planned to support the French language. However, as Andrii mentioned, we're pretty sure that nobody will object if you would like to contribute.

Fore more information, please check out our documentation about localization of Tasklist [1] and community extensions [2]. Also see the GitHub repo for the community extension "Camunda Tasklist Translations" [3].

I hope this helps!

Cheers,
Mat


[1]: https://docs.camunda.org/manual/7.4/webapps/tasklist/configuration/#localization
[2]: https://docs.camunda.org/manual/7.4/introduction/extensions/#community-extensions
[3]: https://github.com/camunda/camunda-tasklist-translations