'EDB' - Externe Datenbanken
Allgemeine Beschreibung
Die Verwaltung der externen Datenbanken kann sinnvoll in Kombination mit dem Software-Developer-Kit (SDK) verwendet werden. Mit dem Begriff 'Datenbanken' sind an dieser Stelle die konkreten mit Datenbanken im Datenbanksystem 'SQL Server' gemeint, welche Tabellen und letztendlich die eigentlichen Daten enthalten. In dieser Verwaltung werden lediglich die Informationen angelegt, wie die externen Datenbanken zu erreichen sind, es werden an dieser Stelle keine neuen Datenbanken erzeugt.
Als interne Datenbanken werden die Datenbanken bezeichnet, mit denen der aktuell geöffnete Mandant direkt zu tun hat, d.h. die Daten-Datenbank, die Config-Datenbank sowie die Lizenz-Datenbank. Z.B. könnten diese konkret lauten für den Mandanten 'Stahl GmbH': easyWinArtStahl, easyWinArtStahlConfig und easyWinArt.
Externe Datenbanken können die Datenbanken anderer easyWinArt-Mandanten sein, aber auch Datenbanken, die nicht direkt zu easyWinArt gehören, z.B. eigens erstellte oder zu anderer Software zugehörige Datenbanken. Diese externen Datenbanken können in der gleichen oder auch in einer anderen SQL Server-Instanz, eventuell auch auf einem anderen Computer vorliegen.
Werden in dieser Verwaltung Informationen über externe Datenbanken angelegt, so hat man im SDK leichten Zugriff auf diese, wie weiter unten beschrieben. Ein Vorteil der Verwendung dieser Verwaltung ist das sichere und verschlüsselte Speichern des Passwortes sowie die Verwaltbarkeit über die easyWinArt-Oberfläche.
Wichtig ist bei Datenbanken anderer easyWinArt-Mandanten die Verwendung des Datenbank-Users 'ewa' für die Anmeldung, da ansonsten das Schema 'ewa' beim Abfragen von Daten immer mit angegeben werden müsste. Das Standard-Passwort dazu lautet '$easy4'.
Anlegen einer externen Datenbank
Beim Hinterlegen eines neuen Zugriffs auf eine externe Datenbank ist zunächst eine Datenbank-Kennung anzugeben. Diese kann frei gewählt werden und wird später für den Zugriff im SDK angegeben.
Für den Mandant ist der Alias-Name des aktuellen Mandanten anzugeben (siehe Mandanten-Verwaltung), aus dem heraus der Zugriff erfolgen soll, andernfalls steht diese externe Datenbank im SDK nicht zur Verfügung.
Als Server ist der Ausdruck für den Zugriff auf die gewünschte SQL Server-Instanz anzugeben, meist eine Kombination aus Computername und Name der Instanz, oder nur der Computername, sofern es sich um eine unbenannte Standardinstanz handelt.
Als Datenbank wird der Name der Ziel-Datenbank angegeben, wie er im SQL Server vorliegt, z.B. 'easyWinArtHolzwaren'.
Im Feld Benutzername wird der Datenbank-User eingetragen, bei easyWinArt-Datenbanken in der Regel 'ewa' aus oben genannten Gründen.
Es darf nicht vergessern werden, das zum Datenbank-User passende Passwort zu hinterlegen, für 'ewa' ist dies im Auslieferungszustand '$easy4'.
Da die hier eingetragenen externen Datenbanken beim Start von easyWinArt in die globale Variable 'GV.ExterneDatenbankenHT' eingetragen werden, ist nach der Neuanlage ein Neustart von easyWinArt für die Verwendung notwendig.
Verwendung im Software-Developer-Kit
Im unteren Beispiel wird einmal der Zugriff auf eine interne Datenbank sowie darunter der Zugriff auf eine externe Datenbank dargestellt. Anschließend wird testweise ein Wert aus der externen Datenbank geholt mit Hilfe einer entsprechenden easyWinArt-Funktion.
VB.NET SDK-Programmcode
'>>> Deklaration und Initialisierung des SQL-Server-Zugriffs auf die Daten-Datenbank des aktuellen Mandanten
Dim internDBZ As SQLServerZugriff = Datenbank.DatenDB
'>>> Deklaration und Initialisierung des SQL-Server-Zugriffs auf die externe Datenbank mit der Kennung 'TESTDB'
Dim externDBZ As SQLServerZugriff = Datenbank.ExterneDB("TESTDB")
'>>> Testweise holen der GUID des Artikels mit der Artikelnummer 'ABCDEFG'
MsgBox(C.ToStringX(externDBZ.HoleFeld(TBL.Artikel.GUID, TBL.Artikel.TBL, TBL.Artikel.ArtikelNummerVC, "ABCDEFG")))
