You are viewing the documentation for Blueriq 15. Documentation for other versions is available in our documentation directory.
Description
The Customerdata Client Component provides the ability to store parts of a profile as an aggregate, perform basic CRUD operations on aggregates, as well as list the aggregates in a dynamic container.
The Customerdata Client (on Java) uses the Customerdata service [old] to store aggregates.
Requirements
For Java, this component needs the customerdata service. See configuring the customerdata service to enable it.
Installation
In order to use this component, the customerdata-client profile must be active. More information on how to configure the application using Spring Profiles can be found here : External application configuration with Spring Profiles.
Add the artifact with groupId com.blueriq
and artifactId blueriq-component-customerdata-client
as a dependency to your Blueriq runtime POM file if you want to depend on it.
Configuration
Please note that you need to add the following configuration. There are no default value for these properties, and the project does not run without setting these properties.
Message Keys
The Customerdata Client store component uses the below message keys. These can be added to the messages.properties file in the
spring.config.additional-location
Message Key | Example Value | Description |
---|---|---|
paging.page | Page {0} of {1} | Used for displaying the current page in an aggregate list. Parameter {0} is mandatory and will be replaced with a field where the user can enter the desired page number. Parameter {1} is optional. If present, it will be replaced with the total number of pages |
paging.feedback | Displaying entries {0} - {1} of {2} | Used for displaying feedback about the entries on the current page. All parameters are optional. Parameter {0} will be replaced with the index of the first displayed entry, parameter {1} will be replaced with the index of the last displayed entry and parameter {2} with the total number of entries. For example, if the page size is 10 and there are 100 total entries, then the paging feedback on page 2 would read "Displaying entries 11-20 of 100". |
paging.clear | Clear | The text displayed on the Clear button. This button clears all search filters currently active in an aggregate list. |
paging.limit.applied.feedback | There are too many results, showing only {0} entries | The message displayed when the total number of entries exceeds the soft limit, and the soft limit is applied.
|
paging.limit.applied.button | Show All | The caption of the "Show All" button when the soft limit is reached and applied. Clicking this button will cause the soft limit to be ignored. |
paging.limit.ignored.feedback | Showing all results | The message displayed when the total number of entries exceeds the soft limit and the hard limit is ignored. |
paging.limit.ignored.button | Show Less | The caption of the "Show Less" button when the soft limit is reached and ignored. Clicking this button wil cause the soft limit to be applied again. |
search.show.all | Show All | The label of the "Show All" checkbox in search popovers. |
search.show.unknown | Show Unknown | The label of the "Show Unknown" checkbox in search popovers. |
search.show.true | Show True | The label for the TRUE boolean value in boolean search popovers. This text is used as a fallback when there is no mask on the column. |
search.show.false | Show False | The label for the FALSE boolean value in boolean search popovers. This text is used as a fallback when there is no mask on the column. |
search.select.all | Select All | The label for the "Select All" checkbox is domain/value list search popovers. |
search.today | Today | The caption of the "Today" button in date search popovers. Clicking this button selects the current date. |
search.now | Now | The caption of the "Now" button in datetime search popovers. Clicking this button selects the current date and time. |
In the section below, the most common settings as mentioned above are listed.
Soft Limit
The Customerdata Client component allows an optional soft limit to be placed on all aggregate lists. The soft limit represents the highest number of aggregates that can be displayed in an aggregate list. When this limit is reached an informative message is displayed. The soft limit affects the reported total number of aggregates and total number of pages. The user has the ability to ignore the soft limit and choose to display all aggregates instead.
To enable the soft limit, place the following line in
spring.config.additional-location
application.properties
blueriq.customerdata-client.list.record.limit
1 Comment
Gerard Ohm
Correct link to the configuration of the customer data service is: Customerdata service.