Einführung
Das Business Navigator-System kann Logik hinzufügen, die auf Anwendungsebene nicht definiert werden kann. Zu diesem Zweck wird die Bibliothek Navigator.Extensions.dll verwendet. Dank dessen können wir Aktionen für bestimmte Aktivitäten in Business Navigator ausführen, z. B. das Speichern eines Dokuments oder das Akzeptieren eines Workflow-Schritts. Bei einer größeren Anzahl von Umgebungen (Produktion, Test) sollte jede von ihnen ein eigenes Projekt haben.
Zugriff auf Navigator.Extension
Das an die Anwendung angehängte Projekt wird vom Versionskontrollsystem abgedeckt. Standardmäßig sollte es in den Anwendungsdateien sein. Wenn der Ordner in den Anwendungsdateien fehlt, wenden Sie sich an den Umgebungsleiter.
Navigator.Extension Struktur
Die gesamte Anleitung besteht aus zwei Projekten: Navigator.Extensions – die Zielbibliothek und Start – ein Projekt, mit dem Methoden aufgerufen und getestet werden. Der Schlüssel besteht darin, die entsprechende Navigator.Model-Bibliothek zu verbinden.
Die Bibliothek befindet sich im Ordner mit den Anwendungsdateien im Ordner bin
Navigator.Extension
Die Navigator.Extensions-Bibliothekslogik ist in der Main-Methode der ExtendTran.cs-Klasse enthalten.
Parameter aufrufen:
- Navigator.Model.Global.Database.SqlManager sql – Dies ist ein Parameter, der mit der mit der Anwendung verbundenen Datenbank kommuniziert
- Navigator.Model.Database.ETable table – Informationen zu der Tabelle, an der wir arbeiten. Dokumente – An, Auftragnehmer – Was usw. (Tabellenabkürzungen finden Sie in der Business Navigator-Datenbankdokumentation)
- string objectIds – Durch Kommas getrennte Objektkennungen. Wenn Sie beispielsweise die Operation für zwei Dokumente ausführen, geben Sie „1521, 1522“ ein.
- Navigator.Model.DataBase.EType typ – Informationen zu der für das Objekt ausgeführten Operation. Mögliche Operationen:
- U – Update
- A – Hinzufügen
- D – Delete – Die Aktion wird ausgeführt, nachdem das Objekt gelöscht wurde
- C – Click – Die Aktion wird nach Drücken der Taste ausgeführt
- SA – SaveAdd – Die Aktion wird nach dem ersten Speichern ausgeführt
- SU – SaveUpdate – Die Aktion wird nach jedem Speichern ausgeführt
- WU – WorkflowUpdate – Die Aktion wird nach dem Workflow schritt ausgeführt
- M – Menu – Die Aktion wird ausgeführt, nachdem die Taste auf Menüebene gedrückt wurde
- AC – AddCopy – Die Aktion wird ausgeführt, nachdem das Objekt kopiert wurde
- BD – BeforeDelete – tDie Aktion wird ausgeführt, bevor das Objekt gelöscht wird
- WAU – WorkflowAfterUndo – Die Aktion wird ausgeführt, nachdem der Workflow-Schritt rückgängig gemacht wurde
- AO – AfterOCR – Die Aktionen werden beim OCRing des Dokuments ausgeführt
- int? buttonId – Kennzeichnung der Schaltfläche, deren Aktionen aufgerufen werden
- int userId – ID des Benutzers, der die Aktionen ausführt
Der Ausgabeparameter der Main-Methode ist ein Zeichenfolgenwert, mit dem Nachrichten nach Abschluss der Aktion angezeigt werden. Die Ausgabezeichenfolge wird von der Navigator.Model.Global.Message-Klasse abgeleitet. Es gibt 3 Arten von Nachrichten:
- Erfolgsmeldung
- message = new Message („The data has been saved“)
- Warnmeldung
- Message = new Message („The task is probably damaged“, EMessageType.Alert)
- Fehlermeldung
- Message = new Message („Attension! The amount do not match“, EMessageType.Error)
Es ist auch möglich, eine vom Programm ausgeführte Aktion zu unterbrechen und beispielsweise das Speichern eines Dokuments zu verhindern. Sie müssen dann eine Ausnahme auslösen:
- throw new Exception („The operation has falled“);
Anfang
Verwenden Sie das Projekt Start, um die Softwarelösung in Navigator.Extenions frei zu verwenden und zu testen. Stellen Sie zum Konfigurieren die entsprechende Verbindung zur Basis in der Datei App.config im Abschnitt connectionStrings ein. Sie müssen Server- und Datenbankdaten bereitstellen.
Die Program.cs-Klasse wurde erstellt, um Navigator.Extensions zu unterstützen
Beispielanrufe
- ExtendTran.Main(sql, ETable.Do, „1“, EType.SU, null, 1);
- Aktivierung der Aktion in der Do-Tabelle (Dokumente) auf der Objektkennung 1 mit dem Speichervorgangstyp (SaveUpdate) durch den Benutzer mit der Kennung 1
- ExtendTran.Main(sql, ETable.Co ,“8545″, EType.BD, null, 119);
- Aktion, die die Co-Tabelle (Auftragnehmer), die Objektkennung 8545 mit der Art der Operation vor dem Löschen (BeforeDelete) durch den Benutzer mit der Kennung 119 aufruft
- ExtendTran.Main(sql, ETable.Do ,“10816″, EType.C, 1845, 1);
- Aktionsaufruf in der Tabelle Do (Dokumente) auf der Objektkennung 10816 mit dem Operationstyp: Klicken ( Click ) auf die Schaltfläche mit der Schaltflächenkennung 1845 durch den Benutzer mit der Kennung 1
Verbinden von Navigator.Extension mit der Business Navigator-Anwendung
Sie müssen sich daran erinnern, dass beim Hochladen der Navigator.Extensions-Bibliothek alle Benutzer von der Anwendung abgemeldet werden. Daher wird empfohlen, das Hochladen außerhalb der Arbeitszeit von Mitarbeitern durchzuführen. Zum Hochladen müssen Sie: ein Projekt erstellen und dann seinen Speicherort öffnen.
Die hochzuladende Bibliothek befindet sich im Ordner bin -> Debug
Kopieren Sie die Bibliothek in den Ordner mit der Anwendung. Navigator.Web -> bin Ordner
Damit die Bibliothek während des Versionsaktualisierungsvorgangs automatisch in die Anwendung geladen wird, sollte die Bibliothek in den Ordner FilesToCopy geworfen werden.
Business Navigator API
Die Navigator.Model-Bibliothek verfügt über eine API (Navigator.Model.API), mit der Sie im System enthaltene Daten herunterladen, speichern und ändern können. Zum Schreiben neuer Lösungen wird empfohlen, nur die in der API enthaltenen Methoden zu verwenden.