Skip to main content
Matrix42 Self-Service Help Center

Solution Builder Architecture

Overview

The Solution Builder is a module for building Web Applications based on the Matrix42 UUX platform using declarative approach. The whole application designed with the Solution Builder at the end is just a set of metadata stored in a database which could be easily extracted to a bunch of Schema Script files and be easily ported to another Application Server.

Administrators use the Solution Builder to design Business Applications by means of defining various Solution Builder artifacts, such as Applications(3), Navigation Items (1), Actions (4), Search Filters (2), Data Queries (5) and design various forms in Layout Designer for displaying set of Data (Dataset Views - 5), the way how the selected Object is displayed Preview Layout(6), or modified (Dialog). For designing forms Layout Designer offers set of controls, each of them is declared as Control Descriptor (7) 
Solution Builder provides flexible multi level security model, which allows easily configure different scenarios of the application behaviors and appearance  for different group of people. As an example, it the action “Set Audience” available for different Solution Builder objects, and restricts their visibility for users classified by different criteria. 

SolutionBuilderArtifacts4-17-2018 10-21-45.png

The Solution Builder App submits all changes to Solution Builder Web Services, and after validation and optimization, persists in Solution Builder Repository.

Layouts

The key area of the Solution Builder are Layouts, which regulates the way the various layouts throughout the whole UUX applications are displayed. The Solution Builder differentiates a few different kinds of Layouts, each of them are keen to solve a specific use cases

  1. Preview, describes Layouts which displays the selected object details in read-only mode
  2. Dialog, kind of Layout for designing forms for editing ot creation objects
  3. Dataset View, the layout regulates how the collection of data be displayed
  4. Landing Page (Mission control), describes arbitrary layout, which could be used for designing pages with Dashboards or other kind of widgets.
  5. Wizards, defines a wizard layout which could be invoked on Action execution
  6. Custom Control Descriptor, a layout for designing Control accessible on Layout Designer
  7. Email Descriptor, describes the layout for the Email

Principal

The principals of Layouts processing follows the wide spread  MVC (Model-View-Controller) architectural pattern for implementing user interfaces.

Model, is a central component, and it representing the data the layout operating with. The core element of the Model is specified on Layout creation (e.g. Configuration Item for Dialog Layout). The Model can be extended with additional Data Sources in Layout Designer Data Modeler. See mode details in Layout Designer Data Modeler
View, defines the appearance of the Layout. The result of Layout Designer is a Layout Template which represents the Layout View.
Controller defines the behavior of the Layout and setups the rules how the Model and the View react to each other. The type of the Layout (e.g. Dialog) defines the Controller.

 Layout Templates

Regardless from the type, each Layout has a single instance related Layout Templates, a special associated object which defines the appearance and behavior of a layout. For the editing of the Layout Template the Solution Builder deliverers a special component Layout Designer.  

LayoutTemplates.png

The Layout Templates consists from the following components:

  • Template Views
  • Data Model Extension
  • Data Model Customizations 
  • Localization Strings
  • Views Customizations and Personalizations

 

Template Views

List of Layout Markups, which have been designed with Layout Designer. The markups specifies the positioning and arrangement of the UI control,  values of their properties of UI. The markups are serialized to special document format (Layout Object Model) which is agnostic to any UI framework, and potentially could be rendered to different formats understandable by various clients (HTML XAML).
The Solution Builder differentiates System and non-System views. The System view is a View delivered out-of-the-box, the View which has been developed by Matrix42. To guarantee reliable Product Updates such views are not allowed to be changed, but only Customized, whereas the original of non-System views could be changed anytime without customization.

´Model: PDRContentWidgetTemplateClassView

 

Views Customizations and Personalizations

Dedicated area of Layout Template Model for storing customizations of the Views. Anytime the System Layout is changed by a Customer the corresponding changes are reflected in Views Customizations. The document is a list of operations which need to be applied to original Template View to achieve the customized View. Such an approach guarantees as the continuity of the Customization after the System Update, as the applying of the new features of the Product to customized layout.
The Solution Builder differentiates two kinds of Customer changes. Personalization, represents the individual changes of Layout. Any person with enough permissions is able to customize the Layout for his/her personal needs, and nobody in the Organization will see these changes in Layout.  This kind of adopting Layout is very handful for implementing new features on Production environments, as the feature author works in his own personal sandbox, and does not risk to corrupt Layout for the others. 
Each authorized user of the System can have his own Personalization document for any Layout Template View, and the Solution Builder in run-time  automatically applied it to displayed Layout in UUX.

Once the author of the Layout amendments publishes the Layout Template, the customizations become public, and everybody who is granted access to see the Layout immediately can see the published changes, and the "personalization" is considered as "customization". On contrary to Personalization,  the Customization document  has only one instance per Layout, and it is applied on run-time for anyone who opens the appropriate Layout.  

Model: PDRContentWidgetTemplateClassViewCustom

 

Data Model Extension

Defines Data Model structure for the Layout Template and keeps the declarations of Data Sources, which provides necessary data  for the layout, and the dependencies between data sources. See more Layout Data Model Designer

Model: PDRContentWidgetTemplateClassBase.DataModelExtention

 

Data Model Customization

Keeps extensions to original Data Model (delivered out of the box) added during the customization of the System Layout. Whereas the Data Model Extension property of the System Layout could be changed on any update of the Product, this area fully managed by the Customer, and never affected on the Product update. 
On run time, the Data Model Extension and Customization are merged together in one transparent Data Model descriptor, what guarantees the Update Security, - the customizations still valid even after update of the Layout.

Model: PDRContentWidgetTemplateClassViewCustom.DataModelExtentionDiff

 

Localizations

List of the localization strings which used in Layout Template, and translations of them to languages and sub-languages registered in the System.

Solution Builder differentiates Local string, which is accessible exceptionally in a scope of the Layout Template they have been declared, and Global Strings, can be reused in all Layout Templates. 

Model: PDRLocalizationStringClass, PDRLocalizationStringClass-CI

Customization and Personalization 

Any Layout can be changed to match for the specific Customer needs, and the System tracks and stores these changes in a way to guarantee the safe System updates afterwards, which from one side brings the Company updates to the modified Layouts, but from the other side preserves the Layout modifications previously done by customer. 

Depending on the ownership of the Layout, the System differentiates two kind of the Layouts Views:

  • System, the Layout view is created by the Matrix42 and delivered out-of-the-box. The company takes the whole responsibility for such layouts, and could constantly update them by adding new features or continuously improving.
  • Custom, the Layout View created and fully owned by the Customer. For multi-view layouts (e.g. Dialog) the Customer is allowed create any amount of Custom Views, even for Layouts (Dialogs) which have been delivered with the Product.

Personalization

By means the Layout Designer the existing View can be adopted to the expected state, and then on saving the Layout the Solution Builders considers the various context variables, and decides how the changes need to be saved. It the modified View, regardless Custom or System, has been Published previously, the Save operation causes the System to create a dedicated record in PDRContentWidgetTemplateClassViewCustom for current user (changes owner) which keeps the implemented changes of the Layout. Afterwards, the saved changes be visible in Layout Designer, as well as in UUX Application, only for the changes owner,  and nobody else. Each user of the System who is allowed to run Layout Designer is allowed to create his own modification of the Layout View, which becomes his personal, exactly for such specific, this kind of modification, is called Personalization.

Customization.

The Customization is process of modification of the System Layout View for the whole organization. Whereas the Personalization could be defined for every single user and be visible only for himself, the Customization, could be present only in single instance per View, and everybody in Company, opening the View, could see these modifications.

To make your the modification of the Layout View available for the whole Company, the action Publish in Layout Designer need to be used. In this case, the changes of the User who runs the Publish becomes publicly available, namely becomes Customization. If the Person keeps modifying the Layout after the Publish, he/she again start the new cycle, and creates his own Personalization available only for him, till the moment he publishes it again.

Revert Personalization and Customization

Using Layout Designer actions you can revert the modification you, or somebody else added to the Layout. These actions are context related, and available only for relevant Layouts, when either Personalization (then action Remove Personalization is available) or Customization (then action Revert to Origin) is present. 

Generate End-User Layouts

The Solution Builder on run-time transforms the declaration of the Layout to a format anticipated by the client. There are many variants influencing this process, like whether the Customization or Personalization for the requested Layout are present, or for which Browser or Platform the Layout is generated, or what is acceptable Language. The diagram below depicts the basic principal of that process:

LayoutTransformation.png

As shown on picture the Solution builder dynamically compose the Layout considering the present Customizations and Personalizations, and then localize them. Such an approach solves the problem of safes Product updates, as the Layout could be without risk updated any time, and as far the Customization and Personalizations are part of the independent schema, which never touched by Product update, they stay in Product, and applied to updated Layout during the run-time transformation. 

In case the Product Update delivers the deep rework of the Layout which been previously customized, it could cause the unexpected disarrangement in merged Layout, and appearance of the custom controls in wrong places. Opens the Layout Designer and provide necessary adjustments

Deployment

The figure below shows the high-level architecture of the Solution Builder:

Solution Builder architecture overview

Figure 1. Solution Builder architecture overview

The Solution Builder consists of three building blocks:

  • Web Services (Back-end)
  • Solution Builder App (Front-end)
  • UUX App with Solution Builder Agent

Front-End

The Solution Builder uses a special module “Solution Builder Agent” integrated into the UUX Shell platform to present the designed Business Application to the end user. The purpose of this module is to transform all kinds of Repository metadata to artifacts acceptable by the UUX application. 

Back-End

The Solution Builder back-end is a Web Application hosted on IIS or any other Web Server which supports OWIN middleware. It could be installed as a dedicated Web Application or be integrated as a module into another Web Application, like in Workspace Management product where Solution Builder modules are hosted in Business Application (M42Services).

Functionally back-end represents a set of stateless REST services which could be grouped into the following categories:

Managing Solution Builder Repository

A bunch of services for managing the state of the Solution Builder Repository and transformation of the Repository metadata to the format understandable by the client application.

Services: Action, Application, Audience, ContentWidget, DataQuery, Navigation, ControlDescriptor.

  • Was this article helpful?