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

Compare with Current View Page History

« Previous Version 12 Next »

Properties

Property

Description

Decouple category

Database decoupling (2)

Complexity

Medium

Related patterns/solutions

 

Summary

Value lists are filled from master data. These value lists contains all possible values within a domain. This domain can easily read from a source and apply within the domain layer. The list is managed and determined outside of the application. For example, country lists, occupation codes, municipalities, etc.

Context

Within applications, lists in the form of a value list are used regularly. The content of a value list could be defined design-time or run-time. In this document solution will be shown to fill a value or instance list. Every solution has it's own pros and cons.

The table below mentions the most critical considerations regarding the implementation of instance or value lists within Blueriq.

 

 PropertyDescription
KnowledgeDesign-time validatieVisual Studio (design-time) provides design-time validation when a value is assigned to the active value of a value list.
Run-time validatieValidation during application execution occurs.
Version management list content?Is version management of the value list content possible.
Implementation propertyRead from external sourceValue content is read from an external source . E.g. CSV file, database of webservice.
Refresh value listMoment in time when the content of a value list will be initialized/freshed.
Deployment needed/no design-time changes neededValue list content can be updated by using a deployment or by modifying the external value list content only (e.g. CSV file, database of webservice).
MaintainabilityMaintainability of content of a value list.
Out of the boxSolution can be implemented by means of OOTB functionality.

 

Problem

Content of a value list changes more often compared to the application which uses the value list. Seperating application behaviour from maintenance of value list content which could be depend on external resources.

Solution

The solution takes into account the features that are named in the table in paragraph "Context".

There are several solutions that can be realized to a greater or lesser degree by the above characteristics. In each case, the best solution should be chosen. The table below shows the most important features and how each solution scores.

 PropertyValue list (static)Value list
(dynamic)
Instance list
(static)
Instance list
(dynamic)
KnowledgeDesign-time validation(green star)(red star)(green star)(red star)
Run-time validation(green star)(green star)(green star)(green star)
Version management list content?(red star)(red star)(red star)(red star)
Implementation propertiesRead from external source(red star)(green star)(red star)(green star)
Refresh value listdesign timestart applicatiedesign timesession time
Deployment needed/no design-time changes needed(red star)(green star)(red star)(green star)
Maintainability(green star)/(red star)3(star)(star)/(red star)3(star)
Out of the box(green star)(star)1(green star)(red star)2

1External source check mark property of Value List and configuration. BE work.

2Maatwerk for inlezen bron en creeren van instanties. TE werk.

3Depends on number of values/instances in the list.

Hieronder worden per oplossing in het kort de verschillen in de implementatie beschreven. Voor de realisatie van de daadwerkelijke oplossing wordt verwezen naar het desbetreffende patroon en wordt een concreet voorbeeld beschreven.

 

Solutions:

  • Value list static
  • Value list dynamic
  • Instance list static
  • Instance list dynamic

Value list static

Eenmalig in Studio de value list definiëren. Deze waarde veranderd run-time niet meer.

Wijizigen van de value list vereist een model aanpassing en deployment.

Bij value list met < 10 is onderhoudbaarheid goed, bij 100+ is deze slecht.

Example

Het vullen van een value list binnen Blueriq wordt beschreven in MyBlueriq.

 

Value list dynamic

Met een external rule kunnen ook bedrijfsregels worden geïmplementeerd en worden ontsloten. In vergelijking met de Functie is het met een external rule niet mogelijk om autonomie te waarborgen. Een external rule maakt gebruikt van attributen binnen hetzelfde domein als de applicatie zodat ongewenste vermenging mogelijk is. Daarnaast is de onderhoudbaar laag doordat een external rule een regel is die in code wordt geïmplementeerd. Bedrijfsregels wil je niet in code implementeren maar in Blueriq vanwege de onderhoudbaarheid.

Example

Het vullen van een value list binnen Blueriq wordt beschreven in MyBlueriq.

Instance list static

Instances should be created design-time and show instances by using an instance linker. Define a relation attribute to catch the instances.

Example

The implementation of an static instance list will be described in MyBlueriq.

Instance list dynamic

Some custom code is needed to implement dynamic instance list. An external resource must provide the values for the instance list and instances should be created run-time.

Example

No example available. Too bad joh.

Issues and considerations

Value lists die regelmatig wijzigen via een external value list. Value lists die constant zijn, bijvoorbeeld geslacht, ja/nee/onbekend, die realiseren d.m.v. een value list design time. Bij een external value list heb je niet de mogelijkheid om design-time model validatie toe te passen. In een expressie kan een value gebruikt worden die run-time niet mogelijk blijkt te zijn. Dit wordt run-time pas geconstateerd.

Related patterns and articles

 

  • No labels