HVS32 Communication Manager
Der Communication Manager (fortan ComManager abgekürzt) ist ein Dienst der die Kommunikation zwischen HVS32 und Kunde oder
HVS32 und Frachtführer zentral Verwaltet und übernimmt. Gedacht ist der ComManager für Kommunikationen via FTP, SFTP oder SMTP.
Genau wie bei WinSCP wird dieser Dienst vom HVS32 angesteuert und versendet die Daten an den im Modul konfigurierten Zielserver.
Er soll nach und nach die Kommunikationen des HVS32 übernehmen und andere externe Übermittlungsprogramme wie zum Beispiel WinSCP ablösen.
Installation
Führen Sie an der gewünschten Station das Setup ComManager-1_X_X_X.exe aus und folgen Sie den Anweisungen.
Wählen Sie das Zielverzeichnis (HVS32 Installationsverzeichnis C:/Heidler) im entsprechenden Dialog aus und bestätigen Sie mit „Weiter“.
Im folgenden Dialog wählen Sie, welche Komponenten installiert werden sollen.
Konfiguration ohne HVS32
Starten Sie für die Inbetriebnahme den ComManager-Konfigurator mit Hilfe derComManager-Configurator.exe im Installationsverzeichnis.
Die Konfiguration ist unterteilt in Dienst Einstellungen und Konfigurationen von Modulen, Servern oder Proxys.
Dienst Einstellungen
| Hier werden die grundlegenden Einstellungen des ComManager Dienstes vorgenommen, die erforderlich sind um eine Verbindung zum Dienst aufzubauen.
Warnung: Die Konfigurationen, die Sie hier vornehmen werden erst nach einem Neustart des ComManager Dienstes übernommen!
Die URL ist dabei wie folgt aufgebaut: http:// 0.0.0.0:8080/hvs32com/ Protokoll(muss immer fix auf http:// stehen) IP Adresse des Servers oder Servername (Achtung: bei Verwendung des Servernamens kann es u.U. zu Geschwindigkeitseinbußen kommen, wenn somit die Verwendung eines DNS aktiviert wird) Port unter welchem der Server erreichbar ist (muss immer mit vorangestelltem Doppelpunkt angegeben werden und muss mit der Serverkonfiguration übereinstimmen) Pfad zum REST-Service (muss immer fix auf /hvs32com/ stehen) |
Datei:ComManager Diensteinstellungen.jpeg Konfigurationsfenster der Diensteinstellungen |
Module
Über die Module findet die Kommunikation zwischen HVS32 und dem angegebenen Server statt. Ein solcher Server kann entweder ein eigener SMTP Server (siehe Punkt 2.3.1) oder der Server eines Frachtführers sein.
Sie haben die Möglichkeit ein Modul über den Button „Modul bearbeiten“ bestehende Konfiguration zu ändern.
Mit einem Klick auf den Button „Modul kopieren“ können sie bestehende Konfigurationen unter Angabe einer neuen eindeutigen ModulID duplizieren.
Wollen Sie ein Modul Löschen so klicken Sie auf „Modul entfernen“ und bestätigen Sie dies nochmals mit „JA“
Um ein neues Modul für den ComManager zu konfigurieren klicken Sie bitte im Reiter Module auf „Modul hinzufügen“.
Im folgenden Dialog können Sie dann das Kommunikationsprotokoll für das Modul wählen.
Aktuell stehen FTP, SFTP und SMTP zur Auswahl.
Im darauffolgenden Dialog werden Sie aufgefordert eine eindeutige ModulID einzugeben.
Diese ID wird später im HVS32 und als Überschrift Ihrer Konfigurationsdialoges sichtbar sein und sollte nach Konvention wie folgt aufgebaut sein: Frachtführer_AuftraggeberID_Typ_Zähler
FTP Modul konfigurieren:
In der Überschrift sehen Sie die ModulID des zu konfigurierenden Moduls.
Tragen Sie Ihre Zugangsdaten für den entsprechenden FTP Server ein. Diese bestehen aus einem FTP Benutzer einem FTP Account (je nach Server) und dazugehörigem Passwort
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.
Bei einem Test versucht eine Verbindung zum Server auszubauen und der Zugriff auf das angegebene Verzeichnis geprüft. Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. |
Datei:ComManager FTPModulConf.jpeg FTP Modul Konfiguration |
SFTP Modul konfigurieren
In der Überschrift sehen Sie die ModulID des zu konfigurierenden Moduls.
Tragen Sie Ihre Zugangsdaten für den entsprechenden FTP Server ein. Diese bestehen aus einem SFTP Benutzer einem und dazugehörigem Passwort
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.
Bei einem Test versucht eine Verbindung zum Server auszubauen und der Zugriff auf das angegebene Verzeichnis geprüft. Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. |
Datei:ComManager SFTPModulConf.jpeg SFTP Modul Konfiguration |
SMTP Modul konfigurieren
In der Überschrift sehen Sie die ModulID des zu konfigurierenden Moduls
Die einzelnen Mailadressen innerhalb eines Empfängerfeldes werden durch ein Komma getrennt.
Der Test erfolgt bei SMTP Modulen über Testbutton im Konfigurationsdialog des entsprechenden Servers. Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. |
Datei:ComManager SMTPModulConf.jpeg SMTP Modul Konfiguration |
Server
Sie haben die Möglichkeit über den Button „Server bearbeiten“ bestehende Konfigurationen zu ändern.
Mit einem Klick auf den Button „Server kopieren“ können sie die Konfiguration unter Angabe einer neuen eindeutigen ServerID duplizieren.
Wollen Sie einen Server löschen so klicken Sie auf „Server entfernen“ und bestätigen Sie dies nochmals mit „JA“
Um einen neuen Server für den ComManager zu konfigurieren klicken Sie bitte im Reiter Server auf „Server hinzufügen“.
Im folgenden Dialog können Sie dann das Kommunikationsprotokoll für das Modul wählen.
Momentan steht nur SMTP zur Auswahl.
Im darauffolgenden Dialog werden Sie aufgefordert eine eindeutige ServerID einzugeben.
Diese ID wird später im Dropdownauswahlmenü und als Überschrift Ihrer Konfigurationsdialoges sichtbar sein.
SMTP Server konfigurieren
In der Überschrift sehen Sie die ModulID des zu konfigurierenden Servers
- Von Adresse
- Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails angezeigt, welche über den Server versendet werden.
- Von Name
- Dieser Name wird als Absendername angezeigt.
- SMTP Server
- IP Adresse oder Hostname unter dem der SMPT Server erreichbar ist.
- SMTP Authentifizierung
- Hier können Sie Ihre Zugangsdaten für den SMTP Server hinterlegen und die Authentifizierung aktivieren.
- SMTP Port
- Port unter dem der SMTP Server erreichbar ist (25, 465)
- SSL aktiviert
- gesendete Daten werden über Secure Sockets Layer verschlüsselt.
- TLS aktiviert
- gesendete Daten werden über Transport Layer Security verschlüsselt. Insofern der SMTP Server dies Unterstützt.
- TLS benötigt
- Es wird vom Server eine TLS Unterstützung angefordert
Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.
Proxys
Sie haben die Möglichkeit über den Button „Proxy bearbeiten“ bestehende Konfigurationen zu ändern.
Mit einem Klick auf den Button „Proxy kopieren“ können sie die Konfiguration unter angabe einer neuen eindeutigen ServerID duplizieren.
Wollen Sie einen Server löschen so klicken Sie auf „Server entfernen“ und bestätigen Sie dies nochmals mit „JA“
Um einen neuen Proxy für den ComManager zu konfigurieren klicken Sie bitte im Reiter Proxy auf „Proxy hinzufügen“.
Im folgenden Dialog können Sie dann das Kommunikationsprotokoll für das Modul wählen. Diese ID wird später im Dropdownauswahlmenü und als Überschrift Ihrer Konfigurationsdialoges sichtbar sein.
- PROXY Typ
- Bestimmt die Anwendungen, die der Proxy unterstützt.
- Auswahlmöglichkeiten: Direct, HTTP, HTTP Tunnel, FTP, SOCKS4, SOCKS4A, SOCKS5
- PROXY Server
- IP Adresse oder Hostname unter dem der Proxy Server erreichbar ist.
- PROXY Port
- Port unter dem der Proxy Server erreichbar ist
Tragen Sie Ihre Zugangsdaten für den entsprechenden PROXY Servers ein. Diese bestehen aus einem PROXY Benutzer einem und dazugehörigem Passwort
- PROXY STYLE
- Nur wählbar bei Typ FTP. Auswahlmöglichkeiten SITE und OPEN
Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.
Troubleshooting
| Fehlercode | Fehlerbeschreibung englisch | Fehlerbeschreibung deutsch |
| COM11C00100 | unknown error while processing send message job! response is null! | Unbekannter Fehler bei der Verarbeitung eines Send Message Jobs! Response ist NULL! |
| COM11C00200 | unknown error while processing upload job! response is null! | Unbekannter Fehler bei der Verarbeitung eines Upload Jobs! Response ist NULL! |
| COM21C00020 | failed to parse response to XML data - response is null | Fehler beim Konvertieren der Antwort in XML - Response ist NULL |
| COM21C00100 | failed to parse XML data for REST function uploadFile | Fehler beim Parsen der XML Daten in REST Funktion uploadFile |
| COM21C00110 | failed to create ModuleConfig for REST function uploadFile | Fehler beim Erstellen der Modul-Konfiguration für REST Funktion uploadFile |
| COM21C00120 | failed to parse response to XML data for REST function uploadFile | Fehler beim Konvertieren der Antwort in XML für REST Funktion uploadFile |
| COM21C00200 | failed to parse XML data for REST function downloadFile | Fehler beim Parsen der XML Daten in REST Funktion downloadFile |
| COM21C00210 | failed to create ModuleConfig for REST function downloadFile | Fehler beim Erstellen der Modul-Konfiguration für REST Funktion downloadFile |
| COM21C00220 | failed to parse response to XML data for REST function downloadFile | Fehler beim Konvertieren der Antwort in XML für REST Funktion downloadFile |
| COM21C00300 | failed to parse XML data for REST function sendMessage | Fehler beim Parsen der XML Daten in REST Funktion sendMessage |
| COM21C00320 | failed to parse response to XML data for REST function sendMessage | Fehler beim Konvertieren der Antwort in XML für REST Funktion sendMessage |
| COM21C00400 | failed to parse XML data for REST function queueUploadFile | Fehler beim Parsen der XML Daten in REST Funktion queueUploadFile |
| COM21C00410 | failed to create ModuleConfig for REST function queueUploadFile | Fehler beim Erstellen der Modul-Konfiguration für REST Funktion queueUploadFile |
| COM21C00420 | failed to parse response to XML data for REST function queueUploadFile | Fehler beim Konvertieren der Antwort in XML für REST Funktion queueUploadFile |
| COM21C00500 | failed to parse XML data for REST function queueDownloadFile | Fehler beim Parsen der XML Daten in REST Funktion queueDownloadFile |
| COM21C00510 | failed to create ModuleConfig for REST function queueDownloadFile | Fehler beim Erstellen der Modul-Konfiguration für REST Funktion queueDownloadFile |
| COM21C00520 | failed to parse response to XML data for REST function queueDownloadFile | Fehler beim Konvertieren der Antwort in XML für REST Funktion queueDownloadFile |
| COM21C00600 | failed to parse XML data for REST function queueSendMessage | Fehler beim Parsen der XML Daten in REST Funktion queueSendMessage |
| COM21C00620 | failed to parse response to XML data for REST function queueSendMessage | Fehler beim Konvertieren der Antwort in XML für REST Funktion queueSendMessage |
| COM21C00700 | failed to load main config for REST function getModuleList | Fehler beim Laden der Haupkonfiguration in REST Funktion getModuleList |
| COM21C00710 | failed to read moduleList from mainConfig for REST function getModuleList | Fehler beim Lesen der Haupkonfiguration in REST Funktion getModuleList |
| COM21C00720 | failed to parse response to XML data for REST function getModuleList | Fehler beim Konvertieren der Antwort in XML für REST Funktion getModuleList |
| COM21C00800 | failed to load main config for REST function getServerList | Fehler beim Laden der Haupkonfiguration in REST Funktion getServerList |
| COM21C00810 | failed to read serverList from mainConfig for REST function getServerList | Fehler beim Lesen der Haupkonfiguration in REST Funktion getServerList |
| COM21C00820 | failed to parse response to XML data for REST function getServerList | Fehler beim Konvertieren der Antwort in XML für REST Funktion getServerList |
| COM31E00100 | failed to initialize HVS32 database manager | Fehler bei Initialisierung des HVS32 Datenbank Managers |
| COM31E00200 | failed to initialize write connection to HVS32 databse | Fehler bei Initialisierung der Schreib-Verbindungen zur HVS32 Datenbank |
| COM31E00210 | failed to prepare statement to update FF-Datei in HVS32 database | Fehler bei Initialisierung des Prepared Statements zum Updaten der FF-Datei in der HVS32 Datenbank |
| COM31E00220 | error while updating FF-Datei | Fehler beim Updaten der FF Datei |
| COM31E00225 | updating FF-Datei failed - no result found | Fehler bei Update von FF-Datei - keine Resultate gefunden |
| COM31E00230 | failed to prepare statement to update WaWi-Datei in HVS32 database | Fehler bei Initialisierung des Prepared Statements zum Updaten der WaWi-Datei in der HVS32 Datenbank |
| COM31E00240 | error while updating WaWi-Datei | Fehler beim Updaten der WaWi-Datei |
| COM31E00245 | updating WaWi-Datei failed - no result found | Fehler bei Update von WaWi-Datei - keine Resultate gefunden |
| COM31E00300 | failed to initialize read connection to HVS32 databse | Fehler bei Initialisierung der Lese-Verbindungen zur HVS32 Datenbank |
| COM31E00310 | failed to prepare statement to read FF-Datei from HVS32 database | Fehler bei Initialisierung des Prepared Statements zum Lesen der FF-Datei in der HVS32 Datenbank |
| COM31E00320 | failed to read FF-Datei from HVS32 database | Fehler beim Lesen der FF-Datei aus der HVS32 Datenbank |
| COM31E00325 | FF-Datei not found in HVS32 database | FF Datei in HVS32 Datenbank nicht gefunden |
| COM31E00330 | failed to prepare statement to read WaWi-Datei from HVS32 database | Fehler bei Initialisierung des Prepared Statements zum Lesen der WaWi-Datei in der HVS32 Datenbank |
| COM31E00340 | failed to read WaWi-Datei from HVS32 database | Fehler beim Lesen der WaWi-Datei aus der HVS32 Datenbank |
| COM31E00345 | WaWi-Datei not found in HVS32 database | WaWi-Datei nicht in HVS32 Datenbank gefunden |
| COM50C01100 | error while creating module for upload | Fehler beim Instanziieren des Upload-Moduls |
| COM50C01150 | failed to create module for upload | Instanziieren des Upload-Moduls fehlgeschlagen |
| COM50C01200 | failed to initialize module for upload | Fehler beim Initialisieren des Upload-Moduls |
| COM50C02100 | error while creating module for download | Fehler beim Instanziieren des Download-Moduls |
| COM50C02150 | failed to create module for download | Instanziieren des Download-Moduls fehlgeschlagen |
| COM50C02200 | failed to initialize module for download | Fehler beim Initialisieren des Download-Moduls |
| COM50C03100 | error while creating module for send message | Fehler beim Instanziieren des SendMessage-Moduls |
| COM50C03150 | failed to create module for send message | Instanziieren des SendMessage-Moduls fehlgeschlagen |
| COM50C03200 | failed to initialize module for send message | Fehler beim Initialisieren des SendMessage-Moduls |
| COM51C00100 | failed to connect to FTP server | Fehler bei der Verbindung zum FTP Server |
| COM51C00200 | failed to login to FTP server | Fehler beim Login auf FTP Server |
| COM51C00300 | failed to change directory on FTP server | Fehler beim Wechseln des Verzeichnisses auf FTP Server |
| COM51C00400 | failed to upload file to FTP server | Fehler beim Hochladen der Datei auf FTP Server |
| COM51C99999 | unsupported function call on FTP module! | Aufruf einer nicht unterstützten Funktion im FTP Modul |
| COM52C00100 | failed to start session for SFTP | Fehler beim Starten der Session auf dem STFP Server |
| COM52C00200 | failed to open channel for SFTP | Fehler beim Öffnen des Kanals zum SFTP Server |
| COM52C00300 | failed to connect to SFTP server | Fehler bei der Verbindung zum SFTP Server |
| COM52C00400 | failed to change directory on SFTP server | Fehler beim Wechseln des Verzeichnisses auf SFTP Server |
| COM52C00500 | failed to upload file to SFTP server | Fehler beim Hochladen der Datei auf SFTP Server |
| COM52C99999 | unsupported function call on SFTP module! | Aufruf einer nicht unterstützten Funktion im SFTP Modul |
| COM53C00100 | SMTP configuration not found | SMTP Konfiguration nicht gefunden |
| COM53C00101 | illegal arguments in SMTP configuration - receiver address is empty! | Illegale Parameter in SMTP Konfiguration - Empfänger-Adresse ist leer! |
| COM53C00102 | illegal arguments in SMTP configuration - subject is empty! | Illegale Parameter in SMTP Konfiguration - Betreff ist leer! |
| COM53C00103 | illegal arguments in SMTP configuration - mail text is empty! | Illegale Parameter in SMTP Konfiguration - Mail-Text ist leer! |
| COM53C00110 | failed to set html mail content in SMTP module | Fehler beim Setzen des HTML Inhalts im SMTP Modul |
| COM53C00111 | failed to set plain mail content in SMTP module | Fehler beim Setzen des Text Inhalts im SMTP Modul |
| COM53C00120 | failed to attach file to mail at SMTP module | Fehler beim Anhängen der Datei im SMTP Modul |
| COM53C00130 | faild to set from address to mail in SMTP module | Fehler beim Setzen der VON-Adresse im SMTP Modul |
| COM53C00131 | faild to set to address to mail in SMTP module | Fehler beim Setzen der Empfänger-Adresse im SMTP Modul |
| COM53W00132 | faild to set cc address to mail in SMTP module | Fehler beim Setzen der CC-Adresse im SMTP Modul |
| COM53W00133 | faild to set bcc address to mail in SMTP module | Fehler beim Setzen der BCC-Adresse im SMTP Modul |
| COM53W00134 | faild to set reply address to mail in SMTP module | Fehler beim Setzen der Antwort-Adresse im SMTP Modul |
| COM53C00200 | SMTP values from HVS32 not found | Keine SMTP Daten von HVS32 gefunden |
| COM53C00201 | SMTP values from HVS32 not valid | SMTP Daten von HVS32 sind ungültig |
| COM53C00202 | illegal arguments in SMTP values from HVS32 - receiver address is empty | Illegale Parameter in SMTP Daten vom HVS32 - Empfänger-Adresse ist leer! |
| COM53C00203 | illegal arguments in SMTP values from HVS32 - subject is empty | Illegale Parameter in SMTP Daten vom HVS32 - Betreff ist leer! |
| COM53C00204 | illegal arguments in SMTP values from HVS32 - mail text is empty | Illegale Parameter in SMTP Daten vom HVS32 - Mail-Text ist leer! |
| COM53C00210 | failed to set html mail content in SMTP module | Fehler beim Setzen des HTML Inhalts im SMTP Modul |
| COM53C00211 | failed to set plain mail content in SMTP module | Fehler beim Setzen des Text Inhalts im SMTP Modul |
| COM53C00220 | failed to attach file to mail at SMTP module | Fehler beim Anhängen der Datei im SMTP Modul |
| COM53C00230 | faild to set from address to mail in SMTP module | Fehler beim Setzen der VON-Adresse im SMTP Modul |
| COM53C00231 | faild to set to address to mail in SMTP module | Fehler beim Setzen der Empfänger-Adresse im SMTP Modul |
| COM53W00232 | faild to set cc address to mail in SMTP module | Fehler beim Setzen der CC-Adresse im SMTP Modul |
| COM53W00233 | faild to set bcc address to mail in SMTP module | Fehler beim Setzen der BCC-Adresse im SMTP Modul |
| COM53W00234 | faild to set reply address to mail in SMTP module | Fehler beim Setzen der Antwort-Adresse im SMTP Modul |
| COM53C00300 | faild to send mail in SMTP module | Fehler beim Senden der Mail im SMTP Modul |
| COM53C00400 | faild to send mail in SMTP module | Fehler beim Senden der Mail im SMTP Modul |
| COM53C99999 | unsupported function call on SMTP module! | Aufruf einer nicht unterstützten Funktion im SMTP Modul |
| COM54C99999 | unsupported function call on PLD module! | Aufruf einer nicht unterstützten Funktion im PLD Modul |
| COM54W03005 | 3005 PLD Warning - file already submitted! | 3005 PLD Warnung - Datei bereits übertragen! |
| COM54W06930 | 6930 PLD Warning - file submitted with warnings! Please correct for next upload! | 6930 PLD Warnung - Daten wurden mit Warnungen hochgeladen. Bitte korrigieren Sie diese vor dem nächsten Upload! |
| COM54C06931 | 6931 PLD Error - Failed upload due to errors in the PLD data. | 6931 PLD Fehler - Upload aufgrund von Fehlern in den PLD Daten fehlgeschlagen. |
| COM54C06932 | 6932 PLD Severe Error - Failed upload due to errors in the input parameters. | 6932 Schwerer PLD Fehler - Upload aufgrund von Fehlern in den Input Parametern fehlgeschlagen. |
| COM54C06933 | unknown PLD Error - Failed upload due to unknown errors. | Unbekannter PLD Fehler - Upload aufgrund von unbekannten Fehlern fehlgeschlagen. |
| COM54C01000 | error in response - no status code found! | Fehler in Rückmeldung - kein Statuscode gefunden! |
| COM54C01100 | failed to parse response | Fehler beim Parsen der Rückmeldung |
| COM54W01200 | failed to save report file(s) | Fehler beim Speichern der Reportdatei(en) |
| COM54C02000 | HTTPS connection is not ready! | HTTPS Verbindung nicht bereit! |
| COM54C03000 | failed to read EDI file | Fehler beim Lesen der EDI Datei |
| COM54C04000 | failed to post data to UPS server | Fehler beim Übertragen der Daten an den UPS Server |