Creating Solutions From Scratch

To create a new solution, please select the Create capability in the overview area of the Solution Designer.

Select Solution Category

Select the category of solution to be created: the following categories are supported:

Value Description
Experience API Experience APIs refer to a solution that will be connected to an external channel. For example a mobile or a web-based application.
Domain Service Domain services encapsulate the core business logic of a business domain.
System API Refers to solutions that will be integrated to other solutions in order to enhance the functionality of the later.

All options work basically as a flag expressing the overall purpose of the application.

The idea is that, while all of these could easily be incorporated in one big monolith, this would be considered a bad design as any small change would affect the entire solution. In other words, by putting each solution in the corresponding layer, it allows for a modular design where a small change will affect only the altered solution.

Select Solution Type

Select the type of solution to be created: the following types are supported:

Value Description
Low Code Solution In this case you get support for Domain Driven Design to model the domain logic as well as the APIs and the integration.
Custom Implementation Solution

Select Implementation Language

Select the implementation language of solution to be created: the following implementation languages are supported:

Value Description
Typescript

Low-Code implementation with pre-genereated code based on the modeled business logic. Currently only available in combination with the solution type Low-Code Solution

Java Available for both Low-Code Solutions and Custom Implementation Solutions. Currently, only API namespaces are supported for Java Low-Code Solutions.

Define Solution Master Data

Finally, you can define the master data of the new application as follows:

Property Description
Acronym

Solution acronym. The acronym must be unique and must not contain more than 8 characters in capital letters and numbers without special characters.

Mandatory information.

Name

Name of the solution.

Mandatory information.

Git provider A list of all Git providers for which you have an access token.

Mandatory information.

Repository group All repository groups in the specified Git provider for which you have at least "read" rights.

Mandatory information.

Domains

Tags to group the solutions in the Overview page.

Optional Information.

Icon

Name of the icon used on the Overview page.

Mandatory information.

Description

Description of the solution. Shown in the Overview page.

Optional information.

Confirming the entries completes the new creation. The system then creates a new solution.

The state of the creation process is shown in the solution overview. It shows “Processing” while the solution is created. In this state you can open the solution, but you cannot proceed any action. In case of an error, it is also shown on the solution in the overview. In this case you can open the solution in order to delete it.

If a solution was created successfully it is stated as “New” for the first 24 hours after creation.

If a solution is in state “Error” after creation or import, it means that the creation or initialization of the solution on the remote Git repository failed. In this case it cannot be guaranteed, that the solution is now ready to work.

Possible reasons for this are:

  • Remote Git is not available at the moment

  • Invalid Git username and Git token combination defined in Manage Git Tokens

  • Defined Git token does not provide enough permissions to create a new repository

Recommendation:

  • Ensure that the above mentioned points are set up correctly

  • Delete the solution in the Solution Designer

  • Ensure that the remote repository was deleted as well – If necessary, delete it by hand

  • Try to re-create the solution using the Solution Designer. If it still fails, please contact your administrator

Note: The user who created a solution has the possibility to read it while the solution is in the state "processing" or "error"
Attention: In order to hide your solution, make sure to set your solution to private in the Git repository.