SDK verwenden
Für die Kommunikation mit microtech ERP verwenden Sie im Actions SDK weitgehend dieselbe API
wie im BpNexT.NET SDK. IBpSession (COM) und IBpQlSession (GraphQL) reichen die
bereitgestellten Datenzugriffe an das SDK weiter. Datensatztypen, LINQ-Abfragen und
Operationen wie Speichern, Wandeln oder Lagerbuchungen bleiben die des jeweiligen SDK-Zugangs.
Fordern Sie die Sitzung über den Konstruktor an. Die Verbindung wählen Sie über ein Verbindungsprofil.
In den SDK-Beispielen ersetzen Sie bpApp beziehungsweise qlApp durch die bereitgestellte
Sitzung. Abfragen, Änderungen und fachliche Operationen sind in der SDK-Dokumentation beschrieben:
- Datensätze: COM · GraphQL
- Indizes und Transaktionen
- Vorgänge: COM · GraphQL
- Archiv: COM · GraphQL
- Lager, Dokumente und Bilder
- Verschachtelte Datensätze: COM · GraphQL
- GraphQL-Schreiboptionen
Unterschiede zum SDK
Die wesentliche Abgrenzung ist die Lebensdauer der Verbindung: Aufbau, Anmeldung, Mandantenauswahl, Abmeldung und Freigabe übernimmt die Runtime, ebenso die Lizenzierung. Die folgenden Funktionen der SDK-Anwendungsobjekte stehen an den Modulsitzungen nicht zur Verfügung:
| Bereich | SDK-Funktionen |
|---|---|
| COM-Anmeldung und Mandant | Login, Logout, SelectMandant, DeselectMandant, GetLoginException |
| COM-Verbindungsverwaltung | IsLoggedIn, GetMandantState, RequiresReLogin, RecreateApplication, InstanceId |
| COM-Verbindungseinstellungen | RequestRetryCount, RequestTimeOut, SetRetryTimeout, SetSolutionPartnerCredentials, ClearSolutionPartnerCredentials |
| Natives COM-Anwendungsobjekt | Get() |
| COM-Meldungsbehandlung | SubscribeToNotifications |
| GraphQL-Anmeldung | Konstruktoren und Anmeldefunktionen von BpQlApplication, etwa LoginWithBrowserAsync |
| Verbindung freigeben | Dispose() |
Die Sitzungen behalten Sie nur für die laufende Ausführung.
Für lang laufende Services verwenden Sie IBpSessions.
Den verfügbaren Umfang zeigen die API-Referenzen von
IBpSession und
IBpQlSession.