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

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

 

Table of contents 

Description 

This component contains a process DAO implementation for storing the process engine data. It is used by the worklist container to display open tasks.

This worklist container implementation uses the ProcessCaseDao to query for process engine data in which filtering is already done in the database and therefore the performance of the worklist container is greatly improved in comparison with the default worklist. This container uses the same container parameters as the Worklist implementation of the Blueriq SDK.

This worklist implementation does NOT use the mapping from the Process module to the PCA module. This is done to increase performance.

Requirements

This component persists data in a database, that must be provided. See platform support for the supported databases.

Installation

Unzip the ProcessDao-Plugin-x.y.z.zip and copy the extracted folders to the runtime folder (make sure that the spring.config.additional-location folder is merged).

Make sure to put the ProcessCaseDao.dll file in the /bin directory of your .Net webapp installation.

Configuration

Database

Scripts to create the required database content are provided for the following databases:

 

For customers that are upgrading an existing version of Blueriq, database upgrade scripts are provided in the Upgrade Instructions when applicable.

 

Use the following steps to configure the component datasource:

  1. If necessary, create a new datasource. See Configuring database connections in the Java webapp for information on how to do this.
  2. Link the datasource to the process DAO plugin. This can be done by editing application.properties in spring.config.additional-location directly or by using the Development plugin. So, either:
    1. Set the following property in application.properties:

      process.dao.name=ProcessCaseDao|Memory
      #The following line is only required in case of the ProcessCaseDao
      process.dao.connection=processdao_datasource_name
    2. In the development plugin Settings page, go to Connections -> Process database and select the correct datasource.
  3. Additional properties files named processdao.hibernate.properties and bam.hibernate.properties can be used to set the Hibernate properties.

    Error rendering macro 'excerpt-include'

    No link could be created for '_HibernateProperties'.

     

This component uses database caching. The default cache configuration can be replaced by custom configuration. Please refer to the knowledge base article titled How to configure cache usage for database-related plugins for more information.

Configuring the database connection for the Process SQL store component in .Net is done by adding a connection configuration to the 

Unable to render {include} The included page could not be found.
 file.

.NET database configuration example
<hibernate-configuration>
  <session-factories>
    <session-factory name="ProcessCaseDao">
      <properties>
        <property name="connection.provider" value="NHibernate.Connection.DriverConnectionProvider" />
        <property name="dialect" value="NHibernate.Dialect.MsSqlCeDialect" />
        <property name="connection.driver_class" value="NHibernate.Driver.SqlServerCeDriver" />
        <property name="connection.connection_string" value="Data Source=D:\Databases\ProcessDB.sdf" />
        <property name="show_sql" value="false" />
        <property name="current_session_context_class" value="Aquima.WebApplication.WebPersistenceUtility.Session.CurrentHibernateSessionContext, WebPersistenceUtility" />
      </properties>
    </session-factory>
  </session-factories>
</hibernate-configuration>

For more information about configuring database connections, see Configuring database connections in .NET webapp.

The Process SQL store component looks for a database connection named "ProcessCaseDao" so make sure that this name is used in order to configure the Process DAO properly.

All necessary DLL files on which the Process SQL store component depends can be found in the Plugins/ProcessCaseDao/Lib directory of the webapp ZIP file.

  • No labels