iPlus Framework Example Projects

These example projects serve to explain the most important programming concepts of the iplus framework. You can find the corresponding video on our homepage.

---

Learning Content

1. Add your own database model or reuse an existing database using the database-first approach that can be managed by the iplus runtime.
   Documentation: Database Model Documentation

2. Create software components (so-called business objects) that use the database model so that you can deploy transaction-based applications.
   Documentation: Business Objects Documentation

3. Create a user interface for business objects using the engineering environment.
   Documentation: User Interface Documentation

4. Exporting packages for distribution to other users or transport to another iplus installation.
   Documentation: Exporting Packages Documentation, Importing Packages Documentation

5. Creating server-side service components that are either static instances or dynamic instances used as part of workflows.
   Documentation: Service Components Documentation

6. Create controls to interact with these service components.

7. Use these service components on the client side without any network programming knowledge.

8. Creating workflows
   Documentation: Workflows Documentation

---

Download, Compilation, and Use

1. A common directory Make sure to clone this repository into the same root path as iplus-framework. So that our repositories are all in a common directory, so that the specified relative paths match.

   <root>/
   ├── iPlus/                  <- github.com/iplus-framework/iPlus
   ├── iPlusMES/               <- optional
   └── iPlus-Examples/
   

2. Choose a reference mode How the iPlus assemblies are resolved is controlled per example via Directory.Build.props. The three modes are mutually exclusive:

   Mode	Command	For whom
   NuGet packages (default)	dotnet build	No iPlus clone needed
   Source (ProjectReferences)	dotnet build -p:UseProjectReferences=true	iPlus/iPlusMES cloned as sibling folder
   Compiled binaries	dotnet build -p:UseIPlusPackages=false	Assemblies copied manually (paths in the .csproj files)

   # default: NuGet packages
   dotnet build 01_MyContextAndWF/gip.iplus.client.avui.Desktop/gip.iplus.client.avui.Desktop.csproj
   
   # compile against the iPlus source repos
   dotnet build 01_MyContextAndWF/gip.iplus.client.avui.Desktop/gip.iplus.client.avui.Desktop.csproj -p:UseProjectReferences=true
   
   # use compiled binaries from iPlus/bin
   dotnet build 01_MyContextAndWF/gip.iplus.client.avui.Desktop/gip.iplus.client.avui.Desktop.csproj -p:UseIPlusPackages=false

   Previously, compiling the release version of iplus-framework was mandatory because the examples used the compiled dll's from the bin directory. With the NuGet package mode this is no longer necessary — just build the example.

3. Unzip the database file from the database folder and restore the database on a SQL Server instance.

4. Adjust the connection string in the client project (ConnectionStrings.config) and set it as the startup project.

5. Compile the example and start the application. Login with "superuser":"superuser".

   Tip: After pulling a newer version, hold down the CTRL key while clicking the login button so that your local databases are updated. Otherwise, the application will not be able to start.

---

VS Code on Linux

Read this Guide

Footnotes