Creating a solution 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 DDD support 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 | Currently only available in combination with the solution type Custom Implementation Solution. |
Define solution master data
Finally, you can define the master data of the new application as follows:
| Property | Description |
| Acronym |
Application 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 image from. 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 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 UserSettings (<<link to user settings docu>>)
-
Defined Git token does not provide enough permissions to create a new repository (<< link to Minimum Git token requirements docu>>)
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