You are viewing the documentation for Blueriq 17. Documentation for other versions is available in our documentation directory.

Table of contents 

Description

This component is used to view and start projects that have been published to an environment database by the Publisher. The published projects are shown in the dashboard of the Development tools component. When the server is started, the Publisher clients loads the published projects from the configured environment database. A task runs in the background that checks periodically (by default every 60 seconds) whether projects are updated, added, or deleted. When there is a change, the the published projects are reloaded.

Requirements

The "publisher-client" and the "externaldatasources" or "jndidatasources" profile must be enabled.

Installation

In order to use this component, the publisher-client and either externaldatasources or jndidatasources profile must be active. More information on how to configure the application using Spring Profiles can be found here : Application configuration with Spring Profiles.


Configuration

The application-publisher-client.properties contains the configuration of the database that the plugin connects to. When you have configured an environment for the Publisher, you can copy the database configuration for this environment.

#blueriq.publisher-client.environmentName: The name of the environment (required). This MUST be the same name as the name of the environment in the Publisher configuration.
#blueriq.datasource.publisher-client.url=The URL on which to locate the database to connect to.
#blueriq.datasource.publisher-client.username=The username to use to connect to the database.
#blueriq.datasource.publisher-client.password=The password to use to connect to the database.
#blueriq.datasource.publisher-client.driverClassName=The vendor specific database driver classname.

#EXAMPLE
blueriq.publisher-client.environmentName=Dev
blueriq.datasource.publisher-client.url=jdbc:oracle:thin:@DB_HOST:1521:xe
blueriq.datasource.publisher-client.username=TheKey
blueriq.datasource.publisher-client.password=TheSecret
blueriq.datasource.publisher-client.driverClassName=oracle.jdbc.driver.OracleDriver
blueriq.hibernate.publisher-client.hbm2ddl.auto=validate

 

Supported hbm2ddl.auto values:

 

  • none
  • validate (only in combination with Publisher 4.0.0 and up in combination with Blueriq 10 or higher)

For JNDI configuration the jndidatasources profile has to be enabled, and the the application-publisher-client.properties  should contain the following settings:

#EXAMPLE
blueriq.publisher-client.environmentName=Dev
blueriq.hibernate.publisher-client.hbm2ddl.auto=validate
blueriq.datasource.publisher-client.jndiName=java:/comp/env/jdbc/publisher


Database

This component reads from one Publisher environment database, this database is managed by the Publisher.

Usage

Java

The publisher client will add a "Publisher Database" section to the "Start Flow" widget in the development dashboard. Here the published projects for the configured environment will be listed. These projects can be used like any other project (eg. from Studio or from an Export).