11.3 Installation

ADVOKAT WSDL-Server ist eine Anwendung von AdvoAll, es muss daher vor der Installation AdvoAll eingerichtet sein, siehe Kapitel AdvoAll.
Erinnerung: Das AdvoAll-Benutzerkonto (üblicherweise “Domäne\svc_advokat”) benötigt permanent lokale administrative Rechte für diese AdvoAll-Anwendung.

Anleitung

1. Nach der Einrichtung von AdvoAll wird die Anwendung "ADVOKAT_WSDL_Datenaustausch" per Menüpunkt "Bearbeiten" > "Neu" hinzugefügt.

   • Beachten Sie, dass für den erfolgreichen Betrieb lokale administrative Rechte benötigt werden, wie im Kapitel Voraussetzungen, Punkt 2 und 3 im Absatz "Software" beschrieben.

   • Achten Sie beim Feld “Parameter” darauf, dass unter anderem der Wert -advoall eingetragen ist.

     Open

     

      

2. Schließen Sie das Fenster laut Schritt 2 per Klick auf "OK". Markieren Sie die Anwendung "ADVOKAT_WSDL_Datenaustausch" und wählen per Rechtsklick > "Advokat Update auf dem Ziel-Rechner ausführen".

   • Dadurch werden die Datei "AdvWSDLServer.exe" und der Ordner "WSDL-XSD" samt XSD-Dateien unter "C:\Program Files (x86)\Advokat" automatisch eingespielt.

   • Warten Sie bis der Vorgang abgeschlossen ist, also das AdvoAll-Fenster wieder erscheint. In der Regel dauert dieser Vorgang 1-2 Minuten.
      

3. Retour im Fenster "AdvoAll" markieren Sie den Listeneintrag und wählen Menüpunkt "Bearbeiten" > "Konfiguration bearbeiten."

   • Im Fenster "Xml-Einstellungen bearbeiten" muss die Angabe der Parameter und zugehöriger Werte erfolgen.

     <WSDLServerConfig SB="ADM" SERVERURL="http://datenbankserver:3000/AdvWSDLServer" LOGLEVEL="2" WSDL="False" DEBUGINFO="True"/>

     • Beim Parameter "SB" muss jener Benutzer angegeben sein, welcher am Gerät bei Start des ADVOKAT Client (Frontend) rechts unten angezeigt wird.

       • Ist das ADVOKAT Modul "Security" im Einsatz, so muss dieser Benutzer in ADVOKAT unter "Programme" > "Tabellen warten" > "Benutzer und Gruppen" ein Mitglied der Gruppe "Administratoren" sein.

     • Beim Parameter “SERVERURL” wird der Servername und verwendete Port in folgender Form angegeben: http://Servername:Port/AdvWSDLServer

       • Der gewählte Port muss größer als 1024 sein. Niedrigere Ports (1-1023) werden seitens ADVOKAT nicht unterstützt.

     • Beim Parameter “WSDL” geben Sie immer den Wert “False” ein und beim Parameter “DEBUGINFO” immer den Wert “True”, wie im Beispiel ersichtlich.
       
       

4. Navigieren Sie zur Windows Firewall mit erweiterter Sicherheit. Setzen Sie eine eingehende Regel für den zuvor definierten Port.

   • Protokolle und Ports: TCP

   • Aktion: Verbindung zulassen

   • Profil: Domäne, Privat und Öffentlich

   • Name: ADVOKAT WSDL-Server TCP
     
     

5. Prüfen Sie im Fenster von AdvoAll, ob bei der Anwendung "ADVOKAT_WSDL_Datenaustausch" der Status als "Aktiv" angezeigt wird. Trifft dies zu, dann ist der WebService sofort per URL erreichbar.

   • Öffnen Sie am AdvoAll-Gerät einen Internet Browser und rufen Sie folgende URL auf: http://Servername:Port/AdvWSDLServer

     • Beispiel: http://datenbankserver:3000/AdvWSDLServer

     • Anmerkung: Es wird automatisch an die URL der Suffix “/Service.svc” angehängt, dieser muss nicht angegeben werden.

   • Erscheint eine Website, dann funktioniert der WSDL-Server bereits. Erscheint eine HTTP-Fehlermeldung (4xx, 5xx, etc.) dann wechseln Sie retour zu Schritt 3 und 4.
     
     

6. Wechseln Sie zum Kapitel Konfigurationsmöglichkeiten, falls die Schnittstelle nicht per HTTP sondern HTTPS betrieben werden soll.