Recommended repository template for quickly starting the development of MORYX modules, plugins or entire applications. This template has the necessary package feeds, the basic projects for application projects and a launchable StartProject. The project can be configured in the graphic interface CommandCenter, where you can interact with modules and change their configuration. You can also configure, create and delete databases.
This template also uses the SDK project style for simplified project definition with a Directory.build.props and Directory.build.targets file to centralize project information and package versions in a single place. We recommend using the Directory.build.targets file to update MORYX packages and others instead of the standard NuGet Package Manager.
The empty project MyApplication is your projects root namespace. It may contain facade, interface and domain model definitions. Remove it, if you do not need cross project type definitions.
- MyApplication: Activities, Capabilities, ProductTypes...
- MyApplication.Resources: Contains Resources for your project
- MyApplication.MyModule: Your new Module (available only after adding it manually)
- MyApplication.Tests: Unit Tests
- MyApplicaten.Exe: Starts the application, contains references to all projects exept for tests
You can either use this repository as a template directly on GitLab or clone it like any other GIT repository.
- Visual Studio 2022
- PHOENIX CONTACT Activation Wizard
- Influx 1.x (optional)
- Grafana (for dashboards)
Open the solutions and run the application. Per default this will require access to port 5000, alternative you can configure a different port in the launchSettings.json within the Properties of the StartProject. While the server is running you can open the CommandCenter at https://localhost:5000/CommandCenter#/. Modules is used to interact and configure modules, while Databases lets you configure, create and delete databases for installed data models. Some modules like the ResourceManager require a database in order to start. You can choose between PostgreSQL und SQlite.
The modules entry class ModuleController is prepared for usage with or without a facade. Just (un)comment the necessary code blocks.
You can interact with the module through console or MaintenanceWeb. To invoke the SayHello-method you can type "exec MyModule hello Name" or "enter MyModule" followed by "hello Name". To remove the scoped mode type "bye".
If you run into problems with the template or MORYX development in general, feel free to join our Gitter channel, ask on StackOverflow using the moryx tag or open an issue. In case your back-end application closes directly after start, this is mostly caused by lack of rights, reserved ports or missing libraries. In general MORYX creates Logs, which can be accesses StartProjects execution directory in the folder Log.
If you have an idea to improve a template or can think of a new useful template, please make your changes based on one of the template branches and open a pull request. If you want to add a template, extend the branch list in one commit and the template definition in another. This way we can easily put your template into a separate branch.