Table of Contents

Basic Setup

Richten Sie den NuGet-Zugang ein, installieren Sie die Projektvorlage und erstellen Sie ein Modulprojekt.

Voraussetzungen

  • .NET 10 SDK (für Module mit net8.0 genügt das .NET 8 SDK)
  • eine installierte BpNexT.NET-Runtime einschließlich Studio
  • eine C#-IDE mit Unterstützung für ausführbare Launchprofile
  • Zugriff auf den NuGet-Feed mit BpNexT.Templates und BpNexT.Actions.Sdk

Die Runtime lädt Module, führt deren Actions aus und verwaltet die Verbindung zu microtech ERP. Studio ist die Verwaltungsoberfläche zum Installieren von Modulen, Starten von Actions und Prüfen der Ergebnisse.

Das erste Beispiel verwendet COM. Zusätzlich benötigen Sie Windows, ein COM-Verbindungsprofil und die zur Runtime passende BpNexT.NET.Models.dll.

NuGet-Quelle einrichten

Richten Sie einmalig den gemeinsamen NuGet-Zugang ein.

Projektvorlage installieren

dotnet new install BpNexT.Templates
dotnet new list bpnext-module

Bei Paketfehlern prüfen Sie Feed-Adresse und Zugangsberechtigung.

Erstes Projekt erstellen

dotnet new bpnext-module -n Meinefirma.Beispiel -o Meinefirma.Beispiel --moduleId meinefirma.beispiel --displayName "Mein Modul"
cd Meinefirma.Beispiel

-n legt den Projektnamen fest, -o den Zielordner. --displayName bestimmt den später in Studio angezeigten Namen. --moduleId ist die dauerhafte Kennung im Format hersteller.modulname; Installationen, Berechtigungen und Routen beziehen sich darauf.

Die Vorlage erzeugt unter anderem:

Datei Aufgabe
Meinefirma.Beispiel.csproj Zielframework, SDK-Referenz und Build-Einstellungen
manifest.json Modul-ID, Name, Version und Einstiegsassembly
MainModule.cs Modulklasse mit Metadaten und einer Beispielmethode

Referenzen für die Beispiele ergänzen

Die Vorlage referenziert das Actions SDK. Konkrete microtech-ERP-Datensatztypen wie Artikel kommen aus der Modellassembly, die Sie für Ihre microtech-ERP-Instanz erzeugen. Legen Sie die passende BpNexT.NET.Models.dll im Unterordner lib ab und ergänzen Sie vor </Project>:

<ItemGroup>
  <FrameworkReference Include="Microsoft.AspNetCore.App" />
  <Reference Include="BpNexT.NET.Models">
    <HintPath>lib/BpNexT.NET.Models.dll</HintPath>
    <Private>false</Private>
  </Reference>
</ItemGroup>

Die Frameworkreferenz ergänzt Logging und Dependency Injection. Private=false verwendet die Modellassembly der Runtime, statt eine eigene Kopie mitzuliefern.

Die Vorlage verwendet net10.0-windows. Hinweise zu GraphQL-Modulen und deren Referenzen stehen unter Projekt, Manifest und Paket.

Build prüfen

dotnet build

Beim ersten Build entsteht Properties/launchSettings.json für das Debuggen mit der Runtime.