HVS32 Quickstart Guide

Hier finden Sie Allgemeine Informationen zu HVS32 Komponenten, welche je nach Projekt relevant sind.

Dieser Guide soll eine schnelle Übersicht über die HVS32 Komponenten/Dienste und deren Funktionsweisen sowie Voraussetzungen für einen erste Testphase mit dem HVS32 dienen.

HVS32-Versandsystem

Das HVS32 Versandsystem ist die zentrale Komponente, welche mit nachfolgenden Diensten/Schnittstellen erweitert werden kann.

Je nach Projektumfang finden Sie entsprechend auch installierte Dienste in Ihren Windowsdiensten wieder.

Der Standard Installationspfad ist C:\Heidler, darunter finden Sie alle Komponenten. Allgemeine Systemvoraussetzungen für den Betrieb des HVS32 finden Sie hier: Systemvoraussetzungen

Pro Arbeitsplatz muss eine sog. Versandstation angelegt werden, welche dann Ihre Stationsbezogenen Einstellungen bzgl Drucker etc hat. Anleitung zur Konfiguration einer neuen Versandstation: Neue Versandstation anlegen

Inhaltliche Konfiguration HVS32

Zur initialen Konfiguration des HVS32 gehören folgende wichtigste Parts:

- Definition der AuftraggeberID's
Pro Auftraggeber / Mandant muss eine sog. AuftraggeberID definiert werden, mit welcher im Druckdatensatz dann über die Schnittstelle der richtige Mandant im HVS32 angesteuert wird.
Ein Auftraggeber wird dann im HVS32 pro Frachtführermodul mit seinen Vertragsparametern (Kundennummer, Nummernkreise...) konfiguriert.

- Definition der Versandarten
Pro anzusprechende Frachtführer/Service Kombination muss eine VersandartID definiert werden (zb "DPD10" für DPD Express 10Uhr), diese Auflistung muss von Ihnen bereitgestellt werden und wird dann im HVS32 konfiguriert.
Die Konfiguration der Versandarten findet ist hier beschrieben: Versandarten anlegen

- Vorbereitung der Frachtführermodul-Konfiguration
Zu Beginn des Projektes senden wir Ihnen pro bestelltem Frachtführer ein entsprechendes Formular (sog. Modulvorbereitungsblätter), in welchem wir alle notwendigen Betriebsparameter abfragen welche wir für die Vorbereitung der HVS32 Konfiguration von Ihnen benötigen.
Diese Formulare müssen Sie von Ihren Frachtführern ausfüllen lassen und an uns in die entsprechenden Projekttickets senden, damit die Vorbereitung Ihres Systems erfolgen kann.
Ohne die in den Formularen abgefragten Daten ist eine Konfiguration des Frachtführermodules nicht möglich!

Der Ablauf des Abnahmeprozesses ist hier beschrieben: Leitfaden zur Integration neuer Frachtführer

- Druckerinstallation (bei zentralem Polling)
Bei Projekten mit zentralem Polling (Hintergrundbetrieb via "HVS32 Monitoring Dienst") müssen die LAN Drucker zuvor auf dem HVS32 Server installiert sein.
Bei interaktiver Verarbeitung am Packplatz muss die Druckerinstallation entsprechend an diesem durchgeführt werden sodass eine Zuweisung im HVS32 erfolgen kann.

Die Drucker werden wie nachfolgend beschrieben im HVS32 hinterlegt: Konfigurator: Ausgabekanäle

HVS32 Komponenten / Dienste

Nachfolgend eine Übersicht mit jeweiliger Funktionsbeschreibung und wichtigen Hinweisen zu den möglichen (und wichtigsten) HVS32 Komponenten / Dienste, welche je nach System im Einsatz sein können.
Welche Dienste Sie installiert haben sehen Sie u.a. in den Windowsdiensten Ihres HVS32 Servers.

Firebird Server - DefaultInstance

Wichtige Hinweise

• zentraler Datenbankdienst für das HVS32
• muss immer gestartet sein
• Haupt-Datenbank liegt unter ...HVS32\Database\hvs32.fdb
• Bei Einsatz von Backupsoftware sinnvoll u.a. auch diesen Dienst vor Durchführung des Backups zu stoppen (Achtung: Abhängigkeiten beachten, vorher HVS32-Monitoringdienste etc beenden)
• wenn der Dienst gestoppt ist, kann kein HVS32 gestartet werden (meist Fehlercode .....721)

HVS32-Monitoring

Das HVS32-Monitoring ist eine Software, welche HVS32 Versandstationen mit unterschiedlichen Funktionalitäten aufrufen kann und überwacht. In einem "zentralen Polling" System finden Sie den HVS32 Monitoring Dienst auf Ihrem HVS32 Server.
Der Dienst startet im Hintergrund eine Konfigurierte HVS32 Versandstation (meist "Auto01") und nimmt über die Schnittstelle (Dienst "DataGatewayServer") die Druckdaten entgegen un sendet diese an die zentral installierten LAN Drucker.
Eine detaillierte Beschreibung finden Sie unter Beschreibung HVS32 Monitoring

Wichtige Hinweise

• Wird als Windowsdienst installiert. In der Regel unter dem Namen "HVS32Monitoring" oder "HVS32Monitoring_Versandstationsname", falls mehrere Monitoring Dienste im Einsatz sind.
• Für den Windowsdienst muss ein Windowsuser hinterlegt werden, welche folgende Eigenschaften hat:
  • Administrative Berechtigungen
  • Zugang zu den Druckertreibern
• Das HVS32-Monitoring startet und überwacht einen HVS32 Packplatz. Dieser wird als Hintergrundprozess gestartet.
  • Falls der entsprechende HVS32 Packplatz gestartet werden muss, um z.B. Konfigurationseinstellungen vorzunehmen, muss der Monitoring Dienst unbedingt beendet werden.
  • Falls für die Testphase der HVS32 Packplatz nicht über den HVS32-Monitoring gestartet werden soll, muss der Port im Konfigurator angepasst werden. In der Regel wird in diesem Fall der Port "5034" benötigt.
• Der Packplatz, welcher über das Monitoring gestartet wird, benötigt eine HVS32 Workstation Lizenz.

DataGatewayServer (DGS) V2 (ODBC)

Der DataGatewayServer V2 wird für die Bereitstellung der Schnittstelle über ODBC verwendet.
Es handel sich dabei um einen Windowsdienst. Der DGS v2 wurde Anfang 2021 vom DGS v3 abgelöst.

Wichtige Hinweise

• Es werden die Windowsdienste "DataGatewayServer" und "DataGatewayGuardian" installiert.
  • Der Guardian ist für die Überwachung vom "DataGatewayServer" zuständig.
• Die Konfiguration vom DGS ist im Hauptverzeichnis in der Datei "settings.xml" gespeichert.
  • Bei Support Anfragen, bzw. Erweiterungswünschen sollte diese Datei zusätzlich per Mail an support [at] heidler-strichcode.de gesendet werden.

Allgemeines zu den Logs

• HVS32ClientGateway.log (Wird bei Automatik-Polling verwendet)
  • Informationen, welche vom DGS an den HVS32 Packplatz gesendet werden.
• ODBCSG.log (Wird bei Automatik-Polling verwendet)
  • Informationen, welche Daten von der ODBC-Datenquelle ans DGS gesendet werden.
• HVS32SG.log (Bei interaktive Verarbeitung über Lieferschein-Daten oder Adress-Stamm)
  • Informationen, welche vom HVS32 ans DGS gesendet werden.

DataGatewayServer (DGS) V3 (SOAP, SAP, E+P, JDBC)

Der Dienst DataGatewayServer V3 wird für die Schnittstelle über SOAP, SAP, E+P und JDBC verwendet.

Wichtige Hinweise

• Wird als Windowsdienst "DataGatewayServer" installiert.
• Die Konfiguration vom DGS ist im Hauptverzeichnis im Ordner "config" gespeichert.
  • Bei Support Anfragen, bzw. Erweiterungswünschen sollte dieser Ordner (als ZIP) zusätzlich per Mail an support[at]heidler-strichcode.de gesendet werden.
    

Allgemeines zu den Logs
Logs mit dem Namen "server". Z.B. "sapserver.log"

• Anfragen, welche das DGS über die entsprechende Schnittstelle erhält. Bei Verarbeitungen über Automatik-Polling ist das Hostsystem der "Server". Z.B. "sapserver.log". Bei interaktive Verarbeitung über Lieferschein-Daten oder Adress-Stamm ist das HVS32 der "Server" -> "hvs32server.log".

Logs mit dem Namen "client". Z.B. "hvs32client.log"

• Anfragen welche das DGS erhalten hat und entsprechend weiter leiten soll. Bei Verarbeitung über Automatik-Polling ist das HVS32 der Client -> "hvs32client.log". Bei interaktive Verarbeitung über Lieferschein-Daten oder Adress-Stamm ist das Hostsystem der "client" -> "sapclient.log".

Heidler ComManager

Der Dienst Heidler ComManager ist verantwortlich für sämtliche Verbindungen zu externen Servern wie zB für die Uploads bei den Tagesabschlüssen.
Somit wird eine Internetverbindung für Tagesabschlüsse lediglich vom HVS32 Server benötigt.

Wichtige Hinweise

• Wird als Windowsdienst "Heidler ComManager" installiert.
• Die Konfiguration erfolgt über ...\HVS32\ComManager\ComManager-Configurator.exe
• Verbindung zwischen HVS32 Clients und Server erfolgt via Port 9009
• Alle Ports für die verwendeten Uploadarten müssen am HVS32 freigegeben sein (FTP 21, SFTP 22, HTTPS 443...). Alle Ports Infos finden Sie in den Systemvoraussetzungen

Datensicherung HVS32 Server

Wichtige Hinweise in Bezug auf Backupprozesse für den HVS32 Server finden Sie hier: HVS32_Backup:_Grundlegende_Empfehlungen

Support HVS32

Im Rahmen eines aktiven Softwaresupport-Vertrages können Sie Mo-Fr zwischen 8-17Uhr unseren Softwaresupport über die im Vertrag ausgewiesene Rufnummer oder über unser Ticketsystem unter support [at] heidler-strichcode.de erreichen.

• Dabei bitte immer eine aktuelle Systeminformation mitsenden, diese erzeugen Sie im HVS32 unter Setup > Systeminformation (HVS32)