Skip to content

WhitesteinTechnologies/lsps-simple-app

Repository files navigation

Custom LSPS Application

This is a customized LSPS Application, business application with GO-BPMN models based on the default LSPS Application.

The application has been customized based on the instructions in the custom application guide.

Quick Start

To further adjust the application and test it locally,

  1. Install Designer
  2. Import the sources to the IDE
  3. Run a local server with the application

Features

Custom Theme

Information on how to create a custom theme

Custom Objects

Information on how to create custom functions, task types, and form components

Build

To build the application, run mvn clean install in the root of the application.

Further information on building is available here.

Docker

When you run mvn clean install -Plsps.docker default docker image for the app is build.

project_name=$(printf 'ARTIFACT_ID=${project.artifactId}\n0\n' | mvn org.apache.maven.plugins:maven-help-plugin:2.1.1:evaluate | grep '^ARTIFACT_ID'|cut -d= -f2) It can be started by the command (replace variables): docker run --name=lsps -d -p 8080:8080 ${docker.tag.prefix}/${project.artifactId}:latest e.g. docker run --name=lsps -d -p 8080:8080 docker.k8s.whitestein.com/lsps/lsps-app:latest

Usefull docker commands: docker exec -it lsps bash enter the container docker logs lsps --follow see logs docker images list local images docker container ls -a list all local containers docker system prune remove not used resources

Deployment

To deploy your application:

  1. Set up the target environment
  2. Deploy the ear to the server.
  3. Export your modules with GO-BPMN export and upload them to the server.
  4. Run the models as applicable.

Make sure the underlying database tables (LSPS system tables, application's tables with business data, and tables of BAM and Scaffolding libraries) use correct structure (you might need to update the database tables if the structures have changed).

Instructions on database migration are available here.

Documentation

LSPS Documentation

For further information on LSPS and BPMN models refer to official LSPS documentation.