Customization Guide

Web UI Customization

The fscd-adapter-web module provides a UI built with Vaadin and Linkki. The UI consists of several views (think "pages") that can be customized using the ViewCustomizer interface.

View Customization

Views can be extended or modified by implementing the ViewCustomizer<T> interface where T is the view type to customize.

To add custom UI components to an existing view:

PolicyDocumentViewCustomizer.java
@Component
public class PolicyDocumentViewCustomizer implements ViewCustomizer<PolicyDocumentView> {

    @Override
    public void postCreateContent(PolicyDocumentView view, BeforeEnterEvent event) {
        var layout = (VerticalLayout) view.getComponentAt(0);
        layout.add(new MyCustomSection());
    }
}
See the fscd-adapter-web module for the available views.

Customization Scope and Limitations

The ViewCustomizer pattern allows:

  • Removing and reordering existing components within a view

  • Adding custom components to a view

  • Modifying properties of existing components (text, styling, visibility)

  • Adding event listeners to trigger custom logic

  • Integrating custom services via dependency injection

The pattern does not support replacing the entire view implementation.

In case view customizers are not suitable for your requirements, please contact the Faktor Zehn product development.