GUI Customization Sample

Introduction

This sample shows you how to customize the Business console using GUI customization sample in a container environment.

Running this sample in Decision Center

1) Prerequisites

Before you begin, ensure you have at least Docker 24.0.x (and optionally Kubernetes 1.25+).

2) Building the Decision Center extension JAR

To use the sample in Decision Center, you need to build a JAR.

Retrieve ODM libraries:

Navigate to the source directory of the GUI Customization sample:
```
cd decisioncenter/guicustomization/guicustomization-source
```
Install ODM for Developer :
```
docker-compose -f compose-odm-dev.yml up odm &
```
Download the decision-center-client-api.zip file :
```
wget http://localhost:9060/decisioncenter/assets/decision-center-client-api.zip
```
Then, unzip decision-center-client-api.zip on the lib directory :
```
unzip decision-center-client-api.zip -d "lib"
```
Uninstall the ODM for Developer instance to avoid a port usage conflict if you continue this tutorial on Docker :
```
docker-compose -f compose-odm-dev.yml down
```
Build the JAR

The instructions below enable to build the JAR using a Docker container featuring Maven and a JDK version 17.

Run the command below in the decisioncenter/guicustomization/guicustomization-source directory:
```
docker run --rm \
      -v "$(pwd)":/usr/src/sample \
      -w /usr/src/sample \
      maven:3.8.5-openjdk-17 \
      mvn clean install
```
The guicustomization-1.0.jar file is generated in the target directory.

3) Instructions to use the sample in Decision Center

Click one of the links below:

In Kubernetes.
In Docker.