Quick Start
Was ist BpNexT.NET?
BpNexT.NET ist ein moderner und optimierter Wrapper um die alte COM Aktiv Schnittstelle von Büro+. Die Bibliothek abstrahiert komplexe Prozesse, bietet eine intuitive API und erleichtert die Entwicklung durch typisierten Zugriff auf die verschiedenen DataSets von Büro+.
Was ist BpNexT.NET nicht?
- BpNexT.NET bietet keine erweiterten Funktionen über die bestehende COM Schnittstelle hinaus.
- Es ersetzt nicht die COM Schnittstelle, sondern nutzt diese effizienter und strukturierter.
- Vieles ist optimiert, vereinfacht und besser strukturiert, aber es bleiben die gleichen Grundfunktionen erhalten.
Installation
BpNexT.NET wird über einen privaten NuGet Feed ausgeliefert.
NuGet-Feed hinzufügen
dotnet nuget add source "https://nuget.bpnext.net/v3/index.json" \
--name BpNexT.NET \
--username IHR_BENUTZERNAME \
--password IHR_PASSWORT
Paket installieren
dotnet add package BpNexT.NET
COM Schnittstelle einbinden
Ihr Projekt muss zusätzlich einen Verweis auf die Büro+ COM-Aktiv-Schnittstelle enthalten.
Dafür muss in Visual Studio unter "Projekt → COM Verweis hinzufügen" die BpNT Bibliothek ausgewählt werden.
Lizenz laden
using BpNexT.NET;
Licensing.LoadLicenseFromFile(@"C:\Pfad\zur\Lizenz\license.lic");
Login und Logout
Um mit BpNexT.NET arbeiten zu können, ist eine Anmeldung an der Büro+ Anwendung erforderlich.
Anmeldung an Büro+
Die Anmeldung erfolgt mit Benutzername und Passwort. Optional kann direkt ein Mandant ausgewählt werden.
using BpNexT.NET.Models.DataSets;
var bpApp = new BpApplication();
bpApp.Login("benutzername", "passwort", "MANDANTENNAME");
// Ohne direkte Mandantenauswahl
bpApp.Login("benutzername", "passwort");
// Mandanten wechseln
bpApp.SelectMandant("MANDANTENNAME");
bpApp.DeselectMandant();
Abmelden von Büro+
Nach Abschluss der Arbeiten sollte die Verbindung ordnungsgemäß geschlossen werden, dies schließt auch die unterliegende COM Verbindung.
bpApp.Logout();