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).