Bonita portal js

Part of bonita portal written using AngularJs

Requirements

• Java 17
• Node 18

Install node tools

Node tools are installed during the maven build using the maven-frontend-plugin. To honor the tool version specify in the pom.xml make sure no yarnrc.yml exists in your home directory. Run ./mvnw clean install to install the yarn version required for this project.

Development tasks

Please run ./node/yarn/dist/bin/yarn install and ./node/yarn/dist/bin/yarn build at least once before launching any of the following tasks

Launch project in development mode

Before running project in development mode, you need to launch a Bonita backend available on URL http://localhost:8080/ Then launch:

./node/yarn/dist/bin/yarn start

Project should be running at URL http://localhost:9000/bonita/portaljs/.

For instance, if you want to run the application-list page in development mode, with live update, you can do the following steps:

• Open the application list from the Admin app: http://localhost:8080/bonita/apps/adminAppEEBonita/admin-application-list/
• Open the Frame from the page context menu (install the "Open Frame" Chrome extension if needed)
• Replace http://localhost:8080/bonita/portal.js by http://localhost:9000/bonita/portaljs/ in the URL.

Now, you are running the application-list page in development mode, with live update!

Launch unit tests

./node/yarn/dist/bin/yarn run test

Launch unit tests in watch mode

./node/yarn/dist/bin/yarn run test:watch

Launch end to end tests

./node/yarn/dist/bin/yarn run e2e

You can run specific e2e class test with this command line.

./node/yarn/dist/bin/yarn run e2eOnly --specs=path_to_file.e2e.js

Launch end to end tests in headless mode

./node/yarn/dist/bin/yarn run e2e:headless

Launch end to end tests in headless mode

./node/yarn/dist/bin/yarn run e2e:headless

Build project

./node/yarn/dist/bin/yarn run build

Localization

Localization keys can be extracted from source files to an .pot output file (./target/portal-js.pot). To do so, run the following command

ya./node/yarn/dist/bin/yarnrn run pot

Maven build

Project can also be built using maven

./mvnw clean package [-Pe2e]

This will build the project, package it in a zip file and, run end to end test if e2e profile is activated