BpNexT.NET Actions SDK

Mit dem Actions SDK entwickeln Sie C#-Module, die microtech ERP um eigene Abläufe und Oberflächen erweitern. Die Runtime übernimmt Verbindungen, Ausführung und Protokollierung; Studio und App-Portal stellen die Verwaltungs- und Benutzeroberflächen bereit.

microtech-ERP-Datenzugriff mit dem BpNexT.NET SDK

Das Actions SDK baut auf dem BpNexT.NET SDK auf und stellt dessen Datenzugriff weitgehend unverändert bereit. LINQ-Abfragen, Datensätze, verschachtelte Datensätze und Funktionen wie Vorgänge oder Lagerbuchungen verwenden Sie wie im SDK des jeweiligen Zugangs.

Statt einer eigenen BpApplication oder BpQlApplication erhalten Sie eine bereits angemeldete Sitzung: IBpSession für COM oder IBpQlSession für GraphQL. SDK verwenden beschreibt die Verwendung der SDK-Beispiele und die von der Runtime übernommene Verbindungsverwaltung.

Basic Setup

Entwicklungsumgebung einrichten: NuGet-Quelle konfigurieren, Projektvorlage installieren und das erste Projekt erstellen und bauen.

Module Setup

• Metadaten, erste Action und Logging: Modulklasse verstehen, Artikel zählen und eine Ausführung protokollieren
• Dependency Injection: eingebaute Dienste verwenden und eigene Abhängigkeiten registrieren
• SDK verwenden: Datenzugriff und Unterschiede zum BpNexT.NET SDK
• OnChanged: auf neue oder geänderte Datensätze reagieren
• Cron und Every: Actions nach Zeitplan starten
• Eingaben und Ergebnisse: Parameter, Validierung, Rückgabewerte und Abbruch
• Redaction: sensible Eingaben und Ergebnisse aus der Historie ausschließen
• Services: dauerhaft auf externe Ereignisse warten

Module UI

• App-Portal: Anmeldung mit microtech ERP oder LDAP und Freigabe von Apps
• Generierte Formulare: Eingabefelder, Validierung und dynamische Auswahllisten
• ModuleSettingsPage: Einstellungen erfassen und im Modul lesen
• BpPage am Beispiel eines Adressbuchs: Suche, Tabellen und Detailansichten
• UI-Bausteine: Karten, Kennzahlen, Diagrammreihen und Layouts
• Eigene Frontends: React- oder andere Weboberflächen mit eigenen Datenendpunkten einbinden

Integration Addon

• HTTP-Endpunkte: API-Schlüssel, Parameterbindung, Fehlerantworten, Controller und OpenAPI
• Webhooks: Ereignisse, Abonnements, Zustellversuche und Signaturen

Referenz

• Projekt, Manifest und Paket: Referenzen, Zielframework, Debugprofil, Paketbau und Ladeprüfungen
• API-Referenz: Typen, Attribute und Dienste des SDK

Studio

Wie die fertigen Module installiert, konfiguriert und überwacht werden, beschreibt die Studio-Dokumentation.