Stand 19.02.2019
Dieser Artikel beschreibt das Vorgehen bei der Test-Inbetriebnahme einer Installation der eigenen WEBSERVICES-Anwendung für HERSTELLER.
Was Sie für die Installation benötigen:
- Aktuelle NightlyBuild WW2.xx, installiert und betriebsbereit.
- Zugangsdaten für SoftENGINE AppStore: Zugangsdaten App Store.txt
ACHTUNG! Ab Version 7.00.403.89739 ist der Zugang zum SoftENGINE Appstore (Abschnitt unten Punkt 3 und 4) zum Verwalten der Anwendung NICHT MEHR NOTWENDIG. Die Anwendungen können nun lokal verwaltet werden über den Designer > Extras > WEBSERVICE Anwendungen (hier werden beim ersten Aufruf auch SoftENGINE Standardanwendungen wie die SoftENGINE OfflineKasse eingespielt).
Es ist nur noch eine einmalige Registrierung notwendig, um Zugangsdaten für die WEBSERVICE Schnittstelle zu bekommen, um Benutzername und Passwort für den obigen Schritt zu erhalten (hier bitte sich an SoftENGINE wenden. Ansprechpartner Michael Pagler).
—–
Gehen Sie wie folgt vor:
- Eingabe der Anmeldeinformationen für SoftENGINE AppStore
Wechseln Sie in das System-Cockpit in den Bereich Installation
Installation ➜ System Konfiguration ➜ System Basis Konfiguration ➜ SEAS SoftENGINE AppStore
Nehmen Sie Ihre Anmeldeinformationen (welche Sie von SoftENGINE bekommen haben) und geben Sie diese für folgende 3 Parameter vor:
■ Name des WW-System’s im SE-AppStore (bitte Firma+Datumsangabe)
■ SE APP-STORE Benutzer
■ SE APP-STORE Passwort
- Registrieren Sie ihr WW-System (WWKIS) im SoftENGINE AppStore (SEAS)
Klicken Sie im Menü auf „Ihr WEBWARE System Registrieren“
Es wird ein Hinweisbildschirm angezeigt ob der Zugriff ok war. Dieser Hinweisbildschirm muss manuell beendet werden (per Klick). - Danach im Helpdesk/Appstore anmelden (gleiche URL wie Ticketsystem) in den Menübereich „SoftENGINE APPSTORE“ ➜ „Hersteller“.
Dort Ihre gewünschte Anwendung auswählen mit [ENTER].
Sollte noch keine vorhanden sein, eine Anwendung mit Taste [F3] anlegen und in Kartei 3 „Freigegebene Installationen“ Ihre Installation hinzufügen. - Stellen Sie sicher, dass mindestens
■ eine Version unter Kartei 2 angelegt ist.
■ eine Funktion auf Kartei 4 dieser Version zugeordnet ist.
■ eine Version freigegeben ist
■ (Kartei 4, Rechtsklick auf den Versions-Ast ➜ Version freigeben).
■ Ihre registrierte Installation der Anwendung zugeordnet ist
■ (Kartei 3, Allgemein -> Neue Zuordnung, dort Ihre WEBWARE Installation auswählen, die registriert wurde). - Aktivieren des WWSVC Sub-Systems in Ihrem WW-ServerWechseln Sie in den Konfigurations-Bereich des System-Cockpits
Konfiguration ➜ System-Konfiguration ➜ WWSVC WEBWARE Services
Aktivieren Sie hier den ersten Parameter „WW Service System Aktiv“
- Führen Sie einen Neustart des WW-Servers durchWechsel in WWS-Konsole (BLAU), [Leertaste], [ESC].
Dann „J“ für „Beenden“.
- Nun den WW-Server wieder neu starten:
c:\WW201_WWSVC\bin\wws\wws.exe console
oder über Batch-Datei. - Anlegen eines Service-Prozesses im Standard-PoolIm System-Cockpit in Bereich Konfiguration in folgendes aufrufen
Konfiguration ➜ System Konfiguration ➜ WWSVC WEBWARE Services ➜ STANDARD-POOL ➜ [ihr gewünschter Mandant]Dann auf „Erzeugen“ klicken und einen Datensatz anlegen.
- Nun das WWSVC System aktualisieren mit dem SoftENGINE AppStore.
Wichtig: Zuvor muss Ihre WWKIS (Punkt 5) mindestens einer Anwendung zugeordnet sein.
Dadurch werden die Ihrer WWKIS Anwendungen geladen.Dazu im System-Cockpit Konfiguration unter
Konfiguration ➜ WW SVC WEBWARE Services ➜ SoftENGINE App Store
den Befehl „Meine WEBWARE Instanz Aktualisieren“ ausführen.Das Hinweisfenster muss nach Abschluss manuell geschlossen werden.
Damit die Anwendung in der Tabelle erscheint:
Im Baum kurz auf anderen Pfad wechseln, und wieder zurück auf SoftENGINE AppStore.
Nun müssten die zuvor zugeordneten Anwendungen angezeigt werden. - Aus Anwendung eine Service Funktion generieren. Klicken Sie auf die gewünschte Anwendung und danach oben auf „Neue Anwendung konfigurieren“.
Hier können Sie nun z.B. festlegen, auf welchen Mandanten diese Anwendung Zugriff hat, in welchen Belegzeitraum diese startet und wie die Freigabe-Verwaltung durchgeführt werden soll. Bitte beachten Sie hierbei bei der Mandantenauswahl, dass ein Service-Prozess für diesen Mandanten existiert (Punkt 7)
Beim Klick auf „Beenden“ bekommt diese Anwendung eine Zugriffs-ID, die für das registrieren einer Fremd-Applikation notwendig ist.
Nun ist die WEBWARE Installation soweit vorbereitet, dass eine fremde Applikation darauf zugreifen kann (registrieren/Servicepass erstellen, Funktionen laden und Funktionen nutzen).
Für Details zur API bitte auf die aktuelle Dokumentation ( WW-WEBSERVICE-20161222 ) zurückgreifen.