Ersteinrichtung zum Software-Developer-Kit

Funktionsumfang

Das Software-Developer-Kit ermöglicht es jedermann, easyWinArt ERP in der Programmiersprache .NET (vorzugsweise VB.NET) zu erweitern.
Wesentliche Bestandteile sind:

• Ordner 'SDK' im 'easyWinArt\Application'-Ordner mit einer Visual-Studio-Projektmappe
• Implementierung der SDK-Funktionalitäten im Originalcode von easyWinArt
• Dieses Online-Handbuch mit diversen Anleitungen und Beispielen
• Der Code-Generator im easyWinArt zum Erstellen eigener Menüfunktionen

Voraussetzungen

Für den Einsatz des Software-Developer-Kits zum Erstellen eigener Anpassungen und Modifikationen ist easyWinArt ERP in der Plus-Version erforderlich.

Notwendige Software

Microsoft Visual Studio

Das Visual Studio dient zum Programmieren und zum Design von Menüfunktionen, Registerkarten, Steuerelementen etc. Derzeit kann eine beliebige 2015er 2017er oder 2019er Version verwendet werden. Entsprechend ist der Einsatz der kostenlosen Community-Version ebenfalls möglich. Das Visual Studio kann bei Microsoft erworben werden, die kostenlose Version steht hier zum Download bereit:

• Info-Seite, Download: vs_community.exe (1,2 MB)

Einige hilfreiche Informationen für Programmier-Anfänger gibt es bei Microsoft hier.

Microsoft SQL Server Management Studio

Das Management Studio ist eine integrierte grafische Umgebung zum Konfigurieren, Verwalten und Entwickeln mit dem SQL Server. Auf einfache Art und Weise kann Einsicht in die Datenbank- und Tabellenstrukturen und Inhalte genommen werden, es können Daten ex- oder importiert, neue Tabellen oder spalten angelegt werden und mit Views (Sichten) ist die Abfrage beliebiger Daten möglich. Das Management Studio ist kostenlos erhältlich:

• Info-Seite, Download: SSMS-Setup-DEU.exe (838 MB)

Ersteinrichtung

Der schon bei der Installation von easyWinArt vorhandene Ordner 'SDK' im Ordner 'easyWinart/Application' enthält eine VisualStudio-Projektmappe, welche mit dem Microsoft Visual Studio bearbeitet werden kann. Dazu wird einfach die Datei 'easyWinArt-SDK.sln' geöffnet. Bevor zum ersten Mal mit der Programmierung begonnen werden kann, sollte ein Update durchgeführt werden, bei dem das SDK mit kompiliert wird. Starten Sie dazu easyWinArt und stellen Sie in der Mandanten-Konfiguration den Haken 'Nach Update automatisch SDK kompilieren' auf aktiviert. Führen Sie dann das automatische Update wie gewohnt aus. Wenn dieses erfolgreich durchläuft, können Sie anschließend mit eigenen Programmierungen beginnen und diese im Visual Studio kompilieren.

Einstellen der Version

Wenn Sie nicht wie oben beschrieben zuerst das Update durchführen, sondern direkt mit der Programmierung starten, so wird aufgrund des SDKs eine nicht mehr zur Datenbank passende Version verwendet und easyWinArt lässt sich mit einer entsprechenden Meldung nicht starten. Kopieren Sie in dem Fall die Datenbank-Version aus der Meldung und fügen diese in die Datei 'AssemblyInfo-SDK.vb' im Projekt '01-easyWinArt-SDK' ein, ersetzen Sie an beiden Stellen die enthaltene Version.

Hinweise

Aus lizenzrechtlichen Gründen lassen sich keine Druckvorgänge starten, wenn Sie easyWinArt debuggen, d.h. direkt aus dem Visual Studio starten. Für die Verwendung aller Funktionen, die mit der integrierten Reporting-Komponente zusammenhängen, starten Sie easyWinArt bitte nach dem Kompilieren über die originale easyWinArt.exe, d.h. Sie kompilieren die Projektmappe und verwenden die normale Desktop-Verknüpfung zum Programmstart.