Anbindung von Server-Datenbanken an WinCan VX

Version 1.1
Datum: 27.03.2018

1 Grundlagen
1.1 Server mit MSSQL-Datenbank
1.2 Server mit ORACLE-Datenbank
2 SQL Server Setup
2.1 Speicherort der Daten
2.2 WinCan SQL-Benutzer
3 Installation
3.1 Aktivieren des lokalen Administratorkontos
3.2 Download und Installation von WinCan VX
4 Netzwerklizenzierung
5 WCSYS-Datenbank auf SQL-Server erstellen
6 Verbindung zur WCSYS-Datenbank auf dem SQL-Server
7 SQL-Server als Standard-Datenbanktyp einrichten
8 Neue SQL-Server-Projekte erstellen
9 Ein vorhandenes SQL-Projekt öffnen

Grundlagen

Die Software WinCan wurde ursprünglich für den Einsatz in TV-Fahrzeugen entwickelt. Unter Beachtung bestimmter Regeln lässt sich das Programm auch in einem Rechnernetzwerk unter Einbezug einer zentralen Datenbank betreiben. Die Verwaltung grosser Datenbestände wird dadurch wesentlich vereinfacht, was vor allem für den Unterhalt städtischer Kanalnetzwerke von Interesse sein kann.
Die vorliegende Dokumentation richtet sich an Netzwerkadministratoren und Wiederverkäufer. Sie beschreibt 2 praxiserprobte Modelle des Zugriffs auf eine zentrale Server-Datenbank mit Hilfe von WinCanVX innerhalb einer Netzwerkdomäne. Dies setzt eine Installation von WinCanVX auf den entsprechenden CLIENT-Rechnern sowie eine Netzwerklizenzierung der Software voraus.

Server mit MSSQL-Datenbank

Dieses Modell arbeitet mit einer zentralen MS-SQL-Serverdatenbank UND einem Dateiserver zur Ablage der Mediendateien (Fotos, Videos etc.). Beide Elemente können sich physisch entweder auf derselben oder auf verschiedenen Maschinen befinden.

Server mit ORACLE-Datenbank

Dieses Modell arbeitet mit einer zentralen ORACLE-Serverdatenbank UND einem Dateiserver zur Ablage der Mediendateien (Fotos, Videos etc.). Beide Elemente können sich physisch entweder auf derselben oder auf verschiedenen Maschinen befinden:

SQL Server Setup

Die nachfolgenden Schritte beschreiben das allgemeine Vorgehen bei der Einrichtung einer zentralen SQL-Datenbank, worauf sich mit der Anwendersoftware direkt zugreifen lässt:

Die MS-SQL Server-Software (d.h. SQL-Server 2005 und höher oder SQL-Express) muss von einem professionellen Server- Administrator installiert werden. Nehmen Sie im Falle von Problemen das Microsoft SQL-Installation Hilfedokument zur Hand.
Neben dem SQL-Server benötigt WinCan VX auch einen Datei-Server, worauf die Projekte für alle Benutzer zentral zugänglich sind und verwaltet werden können. Dieser Datei-Server kann sowohl auf der derselben Maschine mit dem bereits installierten SQL-Server als auch auf einer anderen Maschine eingerichtet werden.
Erstellen Sie entsprechende Serverinstanzen: [Servername]
[Instanz] or .
[Instanz] ("." bezeichnet die aktuelle Server-Maschine)

Eine Instanz beinhaltet mehrere Datenbanken, welche jedoch immer einem bestimmten Arbeitsbereich zugeordnet sind. Das Erstellen einer SQL-Server-Instanz ist zu bevorzugen, weil die Organisation der Datenbanken, Berechtigungen usw. einfacher ist und andere Anwendungen nicht stört:

SQL\Instanz1 -> Speicherung und Verwaltung von Rohrleitungsdaten
SQL\Instanz2 -> Speicherung und Verwaltung von Steuerdaten
SQL\Instanz3 -> Speicherung und Verwaltung von Einwohnerdaten

etc.
Jedes Projekt, welches der Benutzer in WinCanVX hinzufügt, wird als eigene Datenbank innerhalb der SQL Server-Instanz gespeichert und verwaltet.

Erstellen Sie verschiedene Benutzer und legen Sie für jeden Benutzer entsprechende Rechte für die Erstellung neuer oder den Zugriff auf bestehende SQL-Datenbanken fest.

Speicherort der Daten

WinCan VX speichert einerseits Stammdaten in der Projektdatenbank und andererseits Mediendaten als eigenständige Dateien. Die Datenbank selbst enthält folgende wichtige Tabellen:
PROJECT: Projekttabelle (Unterneher, Auftraggeber…)
SECTION: Haltungstabelle (Rohr Form, Material, Straße, Ort, Durchmesser…)
SECINSP: Inspectionstabelle (Untersucher, Wetter, Datum, Zeit…)
SECOBS: Beobachtungstabelle (Beobachtungscode, Beobachtungstext…)
NODE: Schachttabelle (Schachtdaten)
NODINSP: Schacht-Inspektionstabelle (Schachtinspektionsdaten)
NODOBS: Schacht-Beobachtungstabele (Schachtbeobachtungsdaten)
Auf dem Dateiserver befinden sich alle mit der WinCanVX-Datenbank verknüpften Dateien. Die wichtigsten Ordner/Dateitypen des WinCan-Projektverzeichnisses sind nachfolgend aufgeführt:

Unterordner Picture (*.jpg, *.gif, *.bmp), unterteilt in Unterordner Sec für Haltungsbilder und Unterorder Nod für Schachtbilder.
Unterordner Video (* .mpeg, * .mp2, * .mp4, * .avi), unterteilt in Unterordner Sec für Haltungsclips und Unterorder Nod für Schachtclips.
Unterordner Module\Inclination mit Neigungsdateien im Textformat (* .inc).
Unterordner Module\Scanex, mit spezifischer Ordner- und Dateistruktur, die von den unterschiedlichen Rohrscansystemen erstellt werden .

WinCan SQL-Benutzer

WinCan VX verlangt SQL Berechtigungen für folgende Benutzermanipulationen:

Verbindung zum Server
Datenbanken erstellen: Dies wird benötigt, um jede Datenbank, mit jedem WinCan-Projekt vom Benutzer erstellen zu lassen.
Neue Datensätze hinzuzufügen: Dies wird benötigt um innerhalb des Projektes neue Haltungen/Leitungen und/oder Beobachtungen erfassen zu können.
Datensätze löschen: Dies wird benötigt um in der WinCan Projektdatenbank Haltungen/Leitungen und/oder Beobachtungen löschen zu können. Tatsächlich werden Daten, die vom Benutzer ‚gelöscht' werden nur ‚gelöscht' markiert, aber nicht vollständig aus der Datenbank entfernt.
Datensätze aktualisieren: Dies wird benötigt um Datensätze zu verändern oder anzupassen. Diese Berechtigungen werden von dem Administrator, der die SQL-Datenbank installiert vergeben.

Die Berechtigungen können sowohl einzelnen SQL-Benutzern als auch einer SQL-Gruppe bestehend aus WinCan-Benutzern zugewiesen werden.
In dieser Dokumentation wird ein SQL-Benutzer mit dem Namen 'WinCan' erstellt. Sollten andere Authentifizierungsmethoden zur Anwendung gelangen, müssen diese - anders als bei der Auswahl der Methode SQL-Authentifizierung - ausdrücklich angegeben werden.

Installation

Wichtig:
WinCan VX sollte mit dem vordefinierten lokalen Administratorkonto auf dem Computer installiert werden. Dieses entspricht NICHT dem Benutzerkonto mit Administratorrechten oder dem vom IT-Personal oft verwendete Domänenadministratorkonto.
Ist die Installation mit einem lokalen Administratorkonto nicht möglich, lässt sich die Installation notfalls auch als Benutzer mit Administratorrechten durchführen.
WinCanVX kann auf jedem beliebigen Windows-Rechner installiert werden, auch wenn dieser über keine Lizenz verfügt. WinCanVX wird dann solange im 'Viewer-Modus' gestartet, bis eine gültige Lizenz aktiviert wird.
Der Viewer-Modus erlaubt es dem Benutzer, die auf lokalen oder auf Netzlaufwerken verfügbaren WinCanVX-Projekte zu öffnen und zu betrachten.
Findet die Software eine gültige Lizenz, lassen sich Projekte erstellen, bearbeiten sowie alle entsprechend lizenzierten Funktionen aufrufen.

Aktivieren des lokalen Administratorkontos

Im Rahmen der Installation von Windows 7 PRO, Windows 8/8.1 PRO oder Windows 10 PRO müssen Sie bereits ein Benutzerkonto mit Administratorrechten erstellen. Dabei handelt es sich jedoch NICHT um den Systemadministrator. Diesen müssen Sie in einem nächsten Schritt zusätzlich freischalten, um sämtliche Zugriffsrechte auf Systemkomponenten zu erhalten. Gehen Sie dazu wie folgt vor:

Klicken Sie auf dem Desktop mit der rechten Maustaste auf das Symbol Computer und wählen Sie den Kontextmenübefehl Verwalten:

Wechseln Sie im nachfolgenden Fenster in der Kategorie Lokale Benutzer und Gruppen zum Unterordner Benutzer und rufen Sie die Eigenschaften zum Benutzer Administrator (entspricht dem Systemadministrator!) auf:

Um den Systemadminstrator zu aktivieren, müssen Sie diese Option ausschalten

Legen Sie zuletzt ein Passwort für den Systemadministrator fest und bestätigen Sie dieses.
Schliessen Sie alle Dialogfenster und starten Sie den Rechner neu.

Von nun an besteht die Möglichkeit, sich als Systemadministrator anzumelden. Dies ist bei der Installation und Wartung der WinCan-Software und deren Programmmodule sowie der Installation von Treibern zu entsprechend unterstützten Geräten zwingend erforderlich.

Download und Installation von WinCan VX

Melden Sie sich nach der Aktivierung des Administratorkontos und einem Neustart des Rechners mit dem besagten Konto an.
Rufen Sie die Internetadresse www.wincan.com auf und wechseln Sie zum Register Support. Unterhalb des Downloads-Symbols befindet sich der Link Downloads für WinCanVX, der Sie direkt mit der Dowloadseite verbindet. Klicken Sie dort auf die Installationsdatei WinCan VX Setup und speichern Sie diese auf der lokalen Festplatte Ihres Rechners:

Starten Sie die Installation des Programms mit einem Doppelklick auf die Installationsdatei und befolgen Sie dabei die Anweisungen auf dem Bildschirm. Klicken Sie während des Installationsvorgangs mehrmals auf Weiter und betätigen Sie zuletzt die Schaltfläche Fertig stellen. Während der Installation müssen keine Optionen ausgewählt werden.
Klicken Sie nach der Installation auf das WinCanVX-Desktopsymbol, um die Software im Viewer-Modus zu verwenden. Wollen Sie eine Vielzahl weiterer Programmfunktionen nutzen, ist die Einrichtung einer lokalen oder einer Netzwerklizenz erforderlich.
Die Programminstallationsdateien zu WinCanVX befinden sich in folgenden Unterverzeichnissen:

C: \ Program Files (x86) \ CDLab
C: \ Users \ Öffentlich \ Öffentliche Dokumente \ CDLab

Netzwerklizenzierung

Ein Netzwerklizenz-Dongle (Netzwerk-Hardlock) gelangt zur Anwendung, wenn WinCan VX auf mehreren CLIENT-Rechner gleichzeitig laufen soll. Mit einer Netzwerk-Lizenz müssen keine Dongles zwischen einzelnen Rechner umgesteckt werden. Jeder Rechner, der Zugriff auf die Serverlizenz hat, kann WinCan VX im Bearbeitungsmodus verwenden.

Kopieren Sie die neueste Version des Hardlock-Treibers HASPUser_Setup.exe auf die Serverfestplatte und starten Sie die Installation mit einem Doppelklick.
Stecken Sie den roten Netzwerkdongle am Server ein:

Aktivieren Sie die Lizenzdatei auf dem Netzwerkdongle über den Dienst http://localhost:1947:

Öffnen Sie den Internetbrowser auf dem Server und geben Sie die Adresse {+}http://localhost:1947+ ein.
Wählen Sie die Kategorie Update/Attach
Klicken Sie auf die Schaltfläche Durchsuchen
Wechseln Sie auf der Serverfestplatte zum Speicherort, wo Sie die *.V2C-Lizenzdatei zuvor abgelegt haben und markieren Sie diese.
Klicken Sie im Windows-Dialogfenster auf die Schaltfläche Öffnen
Klicken Sie dann auf die Schaltfläche Apply File

Auf CLIENT-Rechnern, die sich im gleichen Subnetz wie der Server befinden, sind keine zusätzlichen Konfigurationsschritte notwendig. Wird WinCan VX auf dem CLIENT geöffnet, findet das Programm automatisch die Netzwerklizenzverwaltung über den Server und verwendet die verfügbare Lizenz.
Befindet sich ein CLIENT-Rechner nicht im gleichen Subnetz wie der Server, müssen auf einem solchen Rechner zusätzliche Konfigurationsschritte vorgenommen werden:

Öffnen Sie auf dem CLIENT-Rechner den Internet-Browser und geben Sie die Adresse http://localhost:1947 ein
Klicken Sie auf den Befehl Configuration.
Öffnen Sie die Registerseite Access to Remote License Managers.
Aktivieren Sie das Kontrollkästchen Allow Access to Remote Licenses.
Geben Sie im Textfeld neben der Bezeichnung Remote License Search Parameters den Servernamen oder die IP-Adresse des Servers ein, worauf die Serverlizenz läuft.
Klicken Sie auf den Befehl Submit.

Gleichzeitig muss auf dem CLIENT-Rechner der Sentinel-Lizenzdienst (Systemsteuerung > Administrative Werkzeuge > Dienste) im Hintergrund aktiviert sein:

WCSYS-Datenbank auf SQL-Server erstellen

WCSYS ist eine Datenbank, die verwendet wird, um die Projekte und Listenausgabe zu vereinheitlichen. Für eine SQL-Server-Implementierung in eine WCSYS-Datenbank ist es wichtig, dass alle Benutzer dieselben Zugriffsberechtigungen auf die SQL- sowie die WCSYS-Datenbank haben. Dadurch können sämtlich SQL-Datenbank-Benutzer auf die jeweiligen Projekte zugreifen und diese auch bearbeiten.
Um mit SQL-Projekten arbeiten zu können, muss WinCanVX zuerst auf einem CLIENT-Rechner installiert und gestartet werden. Anschliessend gehen Sie wie folgt vor:

Rufen Sie den Registerbefehl Projekte > Projektverwaltung auf, um den Projektmanager zu starten:

Aktivieren Sie innerhalb des Projektmanagers über den Befehl File> Expert Mode den Expertenmodus (4), worauf eine zusätzliche Schaltfläche mit der Bezeichnung Oracle SQL Server Setup auf der rechten Seite des Dialogfensters erscheint (5):

Erstellen Sie anschliessend eine neue WCSYS-Datenbank auf dem SQL-Server.

Klicken Sie im Oracle/SQL-Server-Installationsassistenten auf das Ordnersymbol (1) und wählen Sie die die WCSYS.sdf-Datenbank aus (2):

Bestätigen Sie ihre Auswahl über die Schaltfläche Öffnen (3) und klicken Sie dann auf Weiter (4). Es öffnet sich das Fenster zur Durchführung der Benutzer-Authentifizierung auf dem SQL-Server:

Wählen als Datenbanktyp den Eintrag Microsoft SQL Server 2005 oder höher.
Geben Sie unter Server name den Servernamen und die Instanz ein. Sie können auch die SQL-Datenbank über das Lupensymbol suchen lassen: Server und Instanz müssen in jedem Fall auffindbar sein. Bei Fragen wenden sie sich an ihren Administrator.
Unter Datenbankname ist standardmässig der Eintrag WCSYS hinterlegt. Dieser darf nicht geändert werden.
Unter Authentifizierung wählen Sie den Eintrag SQL-Server: Benutzername und Passwort.
Geben Sie unter Benutzername und Passwort den vom Netzwerk-Administrator vergebenen SQL-Benutzernamen sowie das dazugehörige SQL Passwort ein.
Klicken Sie zuletzt auf die Schaltfläche Verbindung testen.

Ein erfolgreicher Verbindungsaufbau zum Server wird mit unten stehender Meldung bestätigt:

Anschliessend können Sie auf Weiter klicken und die zuvor getätigten Eingaben in der Zusammenfassung nochmals überprüfen. Klicken Sie zuletzt auf Weiter:

Wurde die Systemdatenbank erfolgreich erstellt, erscheint eine entsprechende Bestätigung. Ein Klick auf Beenden schliesst den Oracle-/SQL-Server-Installationsassistenten:

Installieren Sie nun WinCanVX auf weiteren CLIENT-Rechnern (ein Netzwerk-Lizenzpaket umfasst 10 Lizenzen und lässt sich beliebig erweitern).

Verbindung zur WCSYS-Datenbank auf dem SQL-Server

Sobald die WCSYS-Systemdatenbank auf dem SQL-Server eingerichtet/kopiert wurde, muss sich WinCanVX inskünftig immer über diese WCSYS anmelden. Klicken Sie dazu auf das Register Allgemein (1) und danach auf den Befehl Anmeldung (2):

Aktivieren Sie im unten stehenden Dialogfenster den Expertenmodus (2)

Im Feld Connection wählen Sie über die Listenauswahl den Eintrag (neue Verbindung…)(3).
Im nachfolgenden Dialogfenster müssen Sie die erforderlichen Informationen wie unten aufgelistet eingeben:

Wählen Sie den Eintrag Microsoft SQL Server 2005 oder höher.
Legen Sie für die Benutzer-Authentifizierung den Eintrag SQL Server Benutzer und Passwort fest.
Betätigen Sie die Ordner-Schaltfläche, um nach dem jeweiligen SQL-Server bwz. Server-Instanz zu suchen. Diese Information wird im nebenstehenden Textfeld automatisch eingetragen.
Als Datenbankname müssen Sie die Systemdatenbank WCSYS eingegeben!
Geben Sie unter Serverbenutzername / Serverpasswort die Ihnen vom Administrator zugewiesenen Benutzerkontodaten ein.
Klicken Sie auf diese Schaltfläche, um die Verbindung zu testen und zu speichern.
Bestätigen Sie abschliessend alle Eingaben über die OK-Schaltfläche.

Sie befinden sich nun wieder im vorherigen Dialogfenster. Aktivieren Sie nun zusätzlich die Option Use this connection as default. Somit kann sich der Benutzer von nun an immer automatisch mit den neuen Einstellungen anmelden.

SQL-Server als Standard-Datenbanktyp einrichten

WinCan VX ist in der Lage, Standardeinstellungen für die Projekterstellung zu verwenden. Diese Einstellungen sind auch im Rahmen einer SQL-Datenbank-Implementierung nützlich.
Um diese Einstellung vorzunehmen, klicken Sie auf 'Allgemein' (1) und dann auf den Befehl 'Einstellungen' (2):

Wählen Sie im nachfolgenden Dialogfenster die Kategorie Voreinstellungen (1):

Wählen Sie dann im rechten Bereich im Listenfeld Datenbank den Eintrag MS SQL Server (2), um Projekte standardmässig in Form von SQL-Serverdatenbanken zu erstellen.
Tragen Sie im Feld Projekthauptverzeichnis (3) den UNC-Pfad zum Dateiserver ein (Beispiel: \\WinCan-FileServer\ProjektFiles (file://WinCan-FileServer/ProjektFiles)). Dadurch werden die Mediendateien (Fotos, Videos) immer von der entsprechend freigegebenen Netzwerkressource aus geladen und auch dorthin abgespeichert.
Achten Sie zudem auf den zu verwendenden Schadenskatalog und die Projektvorlage und wählen Sie den passenden Eintrag aus. Bei der Erstellung neuer Projekte müssen Sie diese Angaben somit nicht jedes Mal neu eingegeben.

Neue SQL-Server-Projekte erstellen

SQL-Server-Projekte werden genauso erstellt wie normale Projekte. Es ist dafür nur ein weiterer Schritt notwendig. Darüber hinaus kann diese Einstellung als Standardeinstellung definiert werden.

Starten Sie im den WinCan VX Projektassistent über den Registerbefehl Projekte > Neues Projekt.
Geben Sie anschliessend wie gewöhnlich einen Projektnamen wie (3). Ändern sie jedoch im Feld Datenbanktyp den Eintrag auf Microsoft SQL Server 2005 oder höher (4) und klicken Sie dann auf Weiter. Der Projektassistenten startet nun ein zusätzliches Dialogfenster, welches den Zugriff auf den SQL-Server regelt:

Stellen Sie sicher, dass der Projektpfad stimmt (1) oder behalten Sie den Standardeintrag.
Suchen Sie über die Lupen-Schaltfläche ihre SQL-Serverinstanz (2) oder tragen Sie die entsprechende Instanz manuell ein.
(3) Ändern Sie die Authentifizierung auf „"SQL-Server Benutzername und Passwort".Geben Sie im entsprechenden Feld den SQL-Benutzernamen (4) und das SQL-Passwort (5) ein.
Es besteht wieder über den „Test Connection"-Button zu testen, ob der SQL-Server verbunden wird. Klicken Sie bei erfolgreicher Verbindungsmeldung auf „Weiter".

Es wird zunächst eine Zusammenfassung angezeigt und bei einem erneuten Klick auf den Button „Weiter" wird das Projekt erstellt.

Ein Klick auf Beenden erstellt nun ein neues WinCanVX SQL-Projekt mit der üblichen Verzeichnisstruktur, das Sie genauso wie lokale Projekte bearbeiten können:

Dieses Verzeichnis enthält die Videoclips, worauf in der Datenbank verwiesen wird.Dieses Verzeichnis enthält die Bilder, worauf in der Datenbank verwiesen wird.Dieses Verzeichnis ist leer, da das Projekt direkt auf die SQL-Datenbank zugreift.Test_DE_2016_06_04

Ein vorhandenes SQL-Projekt öffnen

Vorhandene SQL Server-Projekte können nur über den Projektmanager geöffnet werden und lassen sich nicht direkt über den Registerbefehl Projekt > Projekt öffnen aufrufen.

Klicken Sie im Register Projekte (1) auf die Schaltfläche Projekteverwaltung (2). Betätigen Sie darauf im Projektmanager den Knopf Bestehendes Projekt hinzufügen. Im folgenden Fenster ändern Sie den Datenbanktyp auf Microsoft SQL Server 2005 oder höher und klicken auf Weiter.

Geben Sie die SQL-Authentifizierungsinformationen für Ihre Netzwerkumgebung ein und klicken Sie wieder auf Weiter.

Bestätigen Sie in den folgenden Fenstern Ihre Auswahl jeweils mit der Schaltfläche Weiter und schliessen Sie den Verbindungsvorgang über die Schaltfläche Beenden ab.

Service & Support

09_WincanVX_SERVER_Database_DE