Bonita web pages sp

Contains Bonita Portal web pages.

Build

Requirements

• Java 11
• UI Designer is used to build the pages. It must be installed in your local maven repository prior to building bonita-web-pages
  • look at the build.gradle file to know which UI Designer is required to build the pages
  • install the UI Designer as described in the UI Designer repository

Gradle Tasks

The following tasks should be executed with the Gradle wrapper (gradlew(.bat)) to avoid version compatibility issues

Build artifacts

./gradlew build

Note: if an error occurs at phantomjs startup (especially when running on Ubuntu 24), disable openssl by setting an environment variable OPENSSL_CONF=/dev/null.

Run pages tests

./gradlew runTestChrome

IMPORTANT: Chrome tests currently assume that the language of the browser is set to English. If your machine is set to another language, you can set the language on Ubuntu by using LANG="en_US.UTF-8" or LC_ALL="en_US.ISO8859-1" environment variables. For example, by running LANG="en_US.UTF-8" ./gradlew runTestChrome

This is supposed to be configured in the cypress configuration, but it does not work for now. See the cypress configuration for more information and the Cypress documentation about Browser Launch Event.

UID pages development

You can start an UI Designer development environment using

./gradlew runUID

project properties can be used to specify where bonita is located and the credentials to log in with.

./gradlew runUID -PbonitaUrl=http://localhost:8080 -PbonitaUser=walter.bates -PbonitaPassword=bpm

Version

Version is declared in gradle.properties

To override the current version on build, use the parameter -Pversion like:

 ./gradlew -Pversion=7.9.3 <tasks>

Extra repositories

repositories can be added using comma separated list of repositories using property extraRepositories in format repo_name::repo_url

credentials can be passed using properties repo_nameUsername and repo_namePassword

it can be configured using -PextraRepositories= or gradle.properties file.

example of gradle properties set in ~/.gradle/gradle.properties

extraRepositories=releases::https://repo1/releases,snapshots::https://repo2/snapshots/
releasesUsername=username
releasesPassword=password
snapshotsUsername=username
snapshotsPassword=password

The same can be done for publishing repository (single repo) using property altDeploymentRepository