Table of Contents

Quick Start

Was ist BpNexT.NET?

BpNexT.NET ist ein .NET SDK für microtech ERP und arbeitet wahlweise über die COM-Aktiv- oder die GraphQL-Schnittstelle. Es bietet typisierten Zugriff auf Datensätze, Abfragen mit LINQ und fertige Abläufe für Vorgänge, Lagerbuchungen, Archiv, Dokumente und Bilder.

Was ist BpNexT.NET nicht?

  • BpNexT.NET ersetzt die microtech-ERP-Schnittstellen nicht, sondern macht sie in C# einfacher nutzbar.
  • Es ergänzt keine microtech-ERP-Funktionen, die die jeweilige Schnittstelle nicht bereitstellt.
  • COM und GraphQL haben einen unterschiedlichen Funktionsumfang. Eine Funktion der COM-Schnittstelle ist deshalb nicht automatisch auch über GraphQL verfügbar.

Installation

NuGet-Feed hinzufügen

Die Pakete werden über den privaten BpNexT.NET-Feed ausgeliefert:

dotnet nuget add source "https://nuget.bpnext.net/v3/index.json" `
  --name BpNexT.NET `
  --username IHR_BENUTZERNAME `
  --password IHR_PASSWORT

Ersetzen Sie IHR_BENUTZERNAME und IHR_PASSWORT durch Ihre NuGet-Zugangsdaten.

Paket installieren

Für die COM-Schnittstelle unter Windows mit lokaler microtech-ERP-Installation:

dotnet add package BpNexT.NET

Für die plattformunabhängige GraphQL-Schnittstelle:

dotnet add package BpNexT.NET.GraphQL

Die Modellassembly mit Datensatztypen wie Artikel (COM) oder Products (GraphQL) erzeugen Sie für Ihre microtech-ERP-Instanz.

Lizenz laden

Laden Sie die Lizenz mit LoadLicenseFromFile vor dem Aufbau der Verbindung:

Licensing.LoadLicenseFromFile(@"C:\Lizenzen\license.lic");

COM: Anmeldung und Mandant

Fügen Sie Ihrem Projekt einen COM-Verweis auf die BpNT Bibliothek hinzu. Die Verbindung stellt BpApplication her, Login meldet an und liefert bei Misserfolg false; den Grund nennt GetLoginException.

using var bpApp = new BpApplication();

if (!bpApp.Login("benutzername", "passwort", "MANDANT"))
    throw new InvalidOperationException("Anmeldung fehlgeschlagen.", bpApp.GetLoginException());

Sie können sich auch zunächst ohne Mandant anmelden und ihn anschließend auswählen:

bpApp.Login("benutzername", "passwort");
bpApp.SelectMandant("MANDANT");

Mit SelectMandant wechseln Sie den Mandanten, mit DeselectMandant() heben Sie die Auswahl auf. Logout() meldet die Verbindung ab.

GraphQL: Verbindung herstellen

Übergeben Sie dem BpQlApplication-Konstruktor den GraphQL-Endpunkt, die Token-URL und die Zugangsdaten Ihres OAuth-Clients:

using var qlApp = new BpQlApplication(
    "https://<host>/microtech/erp/<tenant>/graphql/v1",
    "https://<host>/microtech/erp/<tenant>/token",
    "<client-id>",
    "<client-secret>");

Die Anmeldung mit microtech-ERP-Benutzer, Browser oder Refresh-Token ist unter GraphQL-Authentifizierung beschrieben.

Daten abfragen

COM:

var artikel = bpApp.QueryDataSet<Artikel>()
    .FirstOrDefault(a => a.ArtNr == "10000");

GraphQL:

var artikel = qlApp.QueryDataSet<Products>()
    .FirstOrDefault(a => a.ArtNr == "10000");

Nächste Schritte