Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

ElementHow can you model Master Data with it
Value listsEach value of the Master Data is entered in studio as possible value of the value list. You can place the value list on an attribute and the end user can select a possible value.
External Value listsYou can create a piece of code that is determining the possible values of a value list for you. How the piece of code does that is entirely up to you. You can place the external value list on an attribute and the end user can select a possible value.

Static instancesinstance

Each value (or set of values) of the Master Data is entered in studio as a static instance. You then model an Container type: AQ_InstanceLinker, Container type: AQ_InstanceList, or a repeat expression to let the end user select a possible value (instance).
Service call type: AQ_CsvConnectivityServiceYou store the master data in a CSV file outside Blueriq. Using this service, you load the data into the session as instances, one instance per row. You then model an Container type: AQ_InstanceLinker, Container type: AQ_InstanceList, or a repeat expression to let the end user select a possible value (instance).
Data rules and CSV wizardruleYou store the master data in a CSV file outside Blueriq. Using the data rule, you load the data that matches your rule into the session as instances, one instance per row. You then model an Container type: AQ_InstanceLinker, Container type: AQ_InstanceList, or a repeat expression to let the end user select a possible value (instance).
Web ServicesYou model a AQ_WebServiceClient service to call an externa Service call type: AQ_SoapServiceClient or Service call type: AQ_RestServiceClient to call an external web service that supplies the master data. The data enters the profile as intstancesinstances. You then model an Container type: AQ_InstanceLinker, Container type: AQ_InstanceList, or a repeat expression to let the end user select a possible value (instance).

...

If you own the data, then you usually choose a concept that is easy to implement and to maintain yourself, such as a Value lists. You can choose Service call type: AQ_CsvConnectivityService and Data rules and CSV wizardrule in both cases, irrespective if you are the owner or not.

...

 Traverse DTAPServer RestartLive Update
Value listsExternal Value listsWeb Services
Static instancesinstance

Service call type: AQ_CsvConnectivityService

Data rules and CSV wizardrule

Value lists and static instance are part of your model. As your model has changed, customers usually require a new traversal of the DTAP street. The External Value lists is loaded into memory when starting the server. So this can be updated during a maintenance window.

Web Services and external Value lists can lists can retrieve their value from some external source, of which the updates you do not control. You have to take these changes into account when modeling the application. You should always have a default fallback option in case an unexpected value is retrieved. If having such a fallback option is not feasible in the business context of the application, then a different option should be chosen.

...

Small (<=50)Medium (50-250)Large (>=250)
Value listsService call type: AQ_CsvConnectivityServiceExternal Value lists
Static instancesinstanceData rules and CSV wizardrule

Web Services
UI Text Box
typeinfo

The chosen ranges for Small, Medium and Large are a rule of thumb and should be evaluated on a case-by-case base.


When the size is small, then you can easily create and maintain the data inside your model. When the numbers increase, you usually want to place the maintenance outside your application. The Service call type: AQ_CsvConnectivityService, Data rules and CSV wizardrule and Web Services create instances in your profile for each possible value. With a large number of values this may lead to performance problems (think of long running COLLECT statements). For large numbers we advice to use External Value lists. Such a long value list can be easily searched by the end user using Valuelistsearch  Presentation style.