Allgemeines
Zur Verwendung der mobilen Applikationen benötigen Sie einen Webservice, der die Daten für die mobilen Endgeräte (iOS und Android) zur Verfügung stellt. Zusätzlich müssen Ports für den Datenzugriff freigegeben werden.
Der Webservice wird in Verbindung mit einem IIS Express in das Datenverzeichnis installiert. Zusätzlich wird im Startmenü eine Programmverknüpfung angelegt. Zur Aktivierung des Daten-zugriffes müssen Sie lediglich die Programmverknüpfung ausführen.
Wenn Sie den Webservice auf einen vorhandenen IIS installieren möchten, müssen Sie die Datei TKService.svc aus dem Verzeichnis {Datenverzeichnis}\TKService für den Einsatz mit IIS konfigurieren. Weitere Informationen zur Einrichtung entnehmen Sie bitte der Herstellerbeschreibung für den IIS.
Installation TKService
Zur Installation des Webservice führen Sie auf der CD in dem Verzeichnis {CD-ROM}:\TKService die Setup.exe aus. Klicken Sie im "Willkommen-Bildschirm" auf "Weiter".
In dem folgenden Dialog müssen Sie die Ports für den Datenzugriff angeben. Diese sind vorbelegt und können in dem Dialog entsprechend Ihrer Konfiguration angepasst werden.
Wichtig: Notieren Sie sich die Angabe des Ports für https. Diesen benötigen Sie später bei der Einrichtung der App TK Adressen.
Klicken Sie nun auf "Weiter". Nach Bestätigung der Zusammenfassung wird die Installation ausgeführt.
Vorbereitung TopKontor Handwerk
Jeder Benutzer muss für den Zugriff per Webservice freigegeben werden. Öffnen Sie dazu die Benutzerverwaltung in TopKontor und legen Sie zum Testen des Webservices den Benutzer "SERVICE" mit dem Kennwort "bss" an. Weisen Sie dem Benutzer das Recht "mobile Apps" zu. Dieser Benutzer kann nach erfolgreicher Einrichtung des Webservices wieder gelöscht werden.
Kontrolle des Webservice
Damit Sie eine Funktionsüberprüfung anhand dieser Beschreibung durchführen können, müssen Sie die Schritte „Vorbereitung TopKontor Handwerk“ unbedingt vorher durchgeführt haben!
Nach erfolgreicher Installation finden Sie im Startmenü den Eintrag „TopKontor mobile services V1 starten“. Klicken Sie nun auf den Eintrag, um den WebService zu aktivieren. Nachfolgendes Fenster sollte nun auf Ihren Bildschirm erscheinen.
Starten Sie Ihren Webbrowser und geben folgende Adresse ein:
https://localhost:44300 (der Port 44300 entspricht dem https-Port aus der Installation. Diesen müssen Sie gemäß Ihren Angaben u. U. ändern.)
Wenn der Service ordnungsgemäß funktioniert, werden in Ihrem Browser alle angelegten Mandanten angezeigt.
Einrichtung "TK-Adressen"
Wenn die Installation erfolgreich war, können Sie nun die Einrichtung auf Ihrem mobilen Gerät vornehmen. Beachten Sie, dass Ihr Gerät in Ihrem internen Netz registriert sein muss (z. B. WLAN). Wenn Sie auch außerhalb Ihres Netzwerks auf Ihre Daten zugreifen wollen, muss Ihr Server im Internet entsprechend freigegeben werden. Wenden Sie sich dazu bitte an Ihren Sys-tembetreuer.
Klicken Sie auf "Einstellungen". Deaktivieren Sie den Schalter "Demozugang".
Tragen Sie folgende Information ein:
URL: https://IhrPC:Port
Ersetzen Sie "IhrPC" durch die IP-Adresse des PCs, auf den Sie die Webservice in-stalliert haben. Zusätzlich tragen Sie den https-Port aus der Installation ein.
Beispiel: https://192.168.0.1:44300
Benutzer: SERVICE
(Diese Angabe können Sie nach erfolgreicher Einrichtung durch den richtigen
Benutzer ersetzen)
Kennwort: bss
(Diese Angabe können Sie nach erfolgreicher Einrichtung durch den
entsprechende Benutzer-Kennwort ersetzen)
Klicken Sie nun auf "Mandanten". Wenn Ihre Konfiguration Ihre Angaben korrekt sind, öffnet sich die Mandantenauswahl. Wählen Sie den gewünschten Mandanten aus und speichern Sie die Änderungen. Die App "TKAdressen" kann nun verwendet werden.
