6. Installation guide - v4

To install the DCM foundation project, follow these steps:

Step 1: Download DCM Foundation

Download the correct version of the DCM foundation you want to use. The file can be downloaded here.

Step 2: Create a new repository

Step 3: Import DCM Foundation package

Open Blueriq studio and the branch of the DCM project you want to load the DCM foundation into.
Follow the steps listed in the guide import a package. When selecting the package to import, select the .zip package you have downloaded in step 1.
Import all projects suggested by studio.

Step 4: Importing libraries

Now we import the correct libraries. Import the AquimaLibraries.package using the steps of the guide import a library project.

Step 5: Changing projects into libraries

Some projects have to be transformed into libraries. This applies for all projects listed below:

Basis_Proces
Basis_Zaak
Basis_ZaakDomeinMetadata
Globals
AquimaTheme
(AquimaPresentationStyles)

For these projects, execute the steps in the guide create a library project.

Step 6: Set up Shortcut(s)

Now we set up the shortcuts to our project in the runtime. To do this first follow the steps in the guide create a shortcut and select the flow Start in the project ZaakType_A name the shortcut ZaakType_A.

Warning

To secure the shortcuts that are used within your application, please read Security: Shortcuts and AQ_GetRequestParameters carefully.

blueriq.production.shortcuts-only=true

blueriq.shortcut.MainDashboard.flow=Dashboard
blueriq.shortcut.MainDashboard.languageCode=nl-NL
blueriq.shortcut.MainDashboard.project=export-Main_Dashboard
blueriq.shortcut.MainDashboard.theme=bootstrap3
blueriq.shortcut.MainDashboard.ui=mvc
blueriq.shortcut.MainDashboard.version=0.0-Trunk

blueriq.shortcut.ZaakType_A.flow=Start
blueriq.shortcut.ZaakType_A.languageCode=nl-NL
blueriq.shortcut.ZaakType_A.project=export-ZaakType_A
blueriq.shortcut.ZaakType_A.theme=bootstrap3
blueriq.shortcut.ZaakType_A.ui=mvc
blueriq.shortcut.ZaakType_A.version=0.0-Trunk
blueriq.shortcut.ZaakType_A.privateAccess=true

Step 7: Authorization

When you start with the DCM Foundation two specific roles have already been taken into account for you. These roles are the Aanvrager and Behandelaar roles. These roles are introduced for specific authorization usage. The way to make use of this authorization is to have credentials for logging in as either one of these roles. You can add these in the runtime, as described on the dashboard settings page. Keep in mind that roles are case sensitive.

Now you can login with the credentials you just made.

Step 8: External data sources

The DCM Foundation requires database connections to store information that is created with the DCM Foundation project. Blueriq it self comes with an H2 database out of the box, however it is not recommended use an H2 database in production, therefor is recommended to configure the external datasources for you own databases. How to configure database can be found here.

#default h2 file based settings for external datasources profiles

blueriq.datasource.comments-sql-store.url=jdbc:h2:./target/comments-sql-store;AUTO_SERVER=TRUE
blueriq.datasource.comments-sql-store.username=sa
blueriq.datasource.comments-sql-store.password=
blueriq.datasource.comments-sql-store.driverClassName=org.h2.Driver
blueriq.hibernate.comments-sql-store.hbm2ddl.auto=create
blueriq.hibernate.comments-sql-store.dialect=org.hibernate.dialect.H2Dialect

blueriq.datasource.customerdata-sql-store.url=jdbc:h2:./target/customerdata-sql-store;AUTO_SERVER=TRUE
blueriq.datasource.customerdata-sql-store.username=sa
blueriq.datasource.customerdata-sql-store.password=
blueriq.datasource.customerdata-sql-store.driverClassName=org.h2.Driver
blueriq.hibernate.customerdata-sql-store.hbm2ddl.auto=create
blueriq.hibernate.customerdata-sql-store.dialect=org.hibernate.dialect.H2Dialect

blueriq.datasource.dossier.url=jdbc:h2:./target/dossier;AUTO_SERVER=TRUE
blueriq.datasource.dossier.username=sa
blueriq.datasource.dossier.password=
blueriq.datasource.dossier.driverClassName=org.h2.Driver
blueriq.hibernate.dossier.hbm2ddl.auto=create
blueriq.hibernate.dossier.dialect=org.hibernate.dialect.H2Dialect

blueriq.datasource.process-sql-store.url=jdbc:h2:./target/process-sql-store;AUTO_SERVER=TRUE
blueriq.datasource.process-sql-store.username=sa
blueriq.datasource.process-sql-store.password=
blueriq.datasource.process-sql-store.driverClassName=org.h2.Driver
blueriq.hibernate.process-sql-store.hbm2ddl.auto=create
blueriq.hibernate.process-sql-store.dialect=org.hibernate.dialect.H2Dialect

blueriq.datasource.trace-sql-store.url=jdbc:h2:./target/trace-sql-store;AUTO_SERVER=TRUE
blueriq.datasource.trace-sql-store.username=sa
blueriq.datasource.trace-sql-store.password=
blueriq.datasource.trace-sql-store.driverClassName=org.h2.Driver
blueriq.hibernate.trace-sql-store.hbm2ddl.auto=create
blueriq.hibernate.trace-sql-store.dialect=org.hibernate.dialect.H2Dialect

Step 9: Components

This DCM Foundation template uses the following components:

In order to use components, the component profile must be active. The following examples can be used to activate the components.

spring.profiles.active=native,externaldatasources,comments-sql-store,customerdata-client,dashboard,process-sql-store,trace-sql-store

spring.profiles.active=native,externaldatasources,comments-sql-store,customerdata-client,dashboard,process-sql-store,trace-sql-store,development-tools

More information on how to configure the application using Spring Profiles can be found here : Application configuration with Spring Profiles.

Step 10: Other settings

In order to use the Container type: AQ_File_Upload container a connection has to be defined in the application properties.

blueriq.connection.filesystemconnection.filesystem.path=C:/Blueriq/Uploads

Step 11: Start!

Everything is ready to start using the DCM foundation. To start the project in the runtime select the following parameters:

project Main_Dashboard in your repository,
branch Trunk,
Flow Dashboard
Language English
User interface mvc
Theme bootstrap3

Previous: 5. Process - v4

Space shortcuts

Page tree