Skip to main content

Customization

Overview​

The jadice web viewer is a ready-made product that can be used out of the box. However, additional classes can be dynamically loaded from a JAR file. This makes it possible, for example, to register custom DocumentDataProvider implementations.

Customer-specific extensions (Backend)​

Usage with a Container​

The JAR file is placed in a directory on the host, for example:
/my/local/folder/custom.jar

The container is then started as follows:

docker run -v /my/local/folder:/config artifacts.jadice.com/jadice-web-viewer-dist:0.9.2

Usage with a Runnable JAR​

In this case, the viewer JAR file must be located in the same directory as the customer-specific JAR file. The viewer can then be started as follows:

java -jar -Dloader.path=. jadice-web-viewer-dist-backend-0.9.2.jar

Providing a license​

The license usually looks like this:

jadice:
  licenseConfiguration:
    license: |
      ----BEGIN LICENSE----
      ABC...
      ----END LICENSE----
    fingerprint: abc
    publicKey: |
      -----BEGIN PUBLIC KEY-----
      ABC...
      -----END PUBLIC KEY-----

These values must be provided in the application.yml file (see below).

Configuration via application.yml​

As we are using Spring Boot, you can configure the viewer via application.yml. Your application.yml will be merged with the default configuration.

To provide your own configuration, you can proceed as follows:

Usage with a Container​

The application.yml file is placed in a directory on the host, for example:
/my/local/folder/custom.jar

The container is then started as follows:

docker run -v /my/local/folder:/config artifacts.jadice.com/jadice-web-viewer-dist:0.9.2

Usage with a Runnable JAR​

In this case, the viewer JAR file must be located in the same directory as the application.yml file. The viewer can then be started as follows:

java -jar -Dspring.config.additional-location=optional:/my/local/folder/application.yml jadice-web-viewer-dist-backend-0.9.2.jar

Usage with WAR-File​

For JBoss/Wildfly, add the following to the standalone.xml file:

<system-properties>
    <property name="jadicewebviewer.config.location" value="file:/Users/ABC/application-custom.yml"/>
</system-properties>
Last updated on by David Werth