HVS32 JDBC Schnittstelle (Interaktiv)

From Wiki - Heidler Strichcode GmbH
Jump to navigation Jump to search


Voraussetzungen

DGS-Version 3.7.0.618 oder höher
DGS-Plugins HVS32Server, JDBC Client
JDBC Treiber neuste Version der JDBC Treiber (JDK15) für die eingesetzte Datenbank

Funktionsbeschreibung

Bei einer interaktiven Verarbeitung werden Anfragen aus dem Versandsystem heraus an mit Hilfe vom JDBC Treiber als SQL-Statement auf der konfigurierten Datenbank ausgeführt. Dadurch hat man zum Beispiel die Möglichkeit, aus dem HVS32 heraus Versanddaten zur einer Referenznummer (z.B. Lieferscheinnummer) anzufragen. Die Ihnen zur Verfügung stehenden Funktionalitäten können Sie unter Verfügbare HVS32 Funktionen entnehmen.

Der DataGatewayServer (DGS) ist die zentrale Kommunikationseinheit, über die sämtliche Daten zwischen dem Versandsystem und dem Hostsystem ausgetauscht werden. Er läuft in Form eines Dienstes auf einem Windows-Server.

Verfügbare HVS32 Funktionen

Artikel- und Gefahrgutdaten sollten jeweils in einer eigenen Tabelle mit 1:n relation zur Packstücktabelle realisiert werden.

Bitte beachten Sie, dass die Feld-Beschreibungen sich nur auf einen Standard beziehen, welcher als Vorschlag für die Schnittstelle dienen soll. Tabellennamen, Feldnamen /-längen /-formate können prinzipiell abweichen, müssen in diesem Fall jedoch individuell betrachtet/analysiert werden.

Verfügbare HVS32 Funktionen

Beispiele

Bitte beachten Sie, dass es sich bei den folgenden Scripten nur um eine Hilfestellung von unserer Seite handelt. Die Administration der Datenbank obliegt in der Verantwortung des Kunden.
Feldnamen /-längen /-formate oder auch Tabellennamen können prinzipiell abweichen, müssen in diesem Fall jedoch individuell betrachtet/analysiert werden.

MySQL
CREATE TABLE hvs32_interaktiv (
        -- Steuerungsteil
        ID bigint(20) unsigned NOT NULL auto_increment,
        -- Sendungsteil
        KundenNr varchar(20) default NULL,
        ZielAdrName1 varchar(50) NOT NULL,
        ZielAdrName2 varchar(50) default NULL,
        ZielAdrName3 varchar(50) default NULL,
        ZielAdrStrasse varchar(50) NOT NULL,
        ZielAdrLKZ varchar(5) NOT NULL,
        ZielAdrPLZ varchar(10) NOT NULL,
        ZielAdrOrt varchar(50) NOT NULL,
        ZielAdrRegion varchar(20) default NULL,
        ZielAdrBahnhof varchar(30) default NULL,
        Ansprechpartner varchar(20) default NULL,
        TelefonNr varchar(20) default NULL,
        FaxNr varchar(20) default NULL,
        UstIDNr varchar(20) default NULL,
        ILNNr varchar(20) default NULL,
        AuftraggeberID varchar(10) NOT NULL,
        VersandartID varchar(10) NOT NULL,
        AVISHinweis1 varchar(30) default NULL,
        AVISHinweis2 varchar(30) default NULL,
        AVISZusatz1 varchar(20) default NULL,
        AVISZusatz2 varchar(20) default NULL,
        LieferscheinNr varchar(40) NOT NULL,
        AuftragNr varchar(20) default NULL,
        BestellNr varchar(20) default NULL,
        Warenwert decimal(18,2) default NULL,
        WWWaehrung varchar(3) default NULL,
        Nachnahme decimal(18,2) default NULL,
        NNWaehrung varchar(3) default NULL,
        NNVermerk varchar(1) default NULL,
        NNVerwendung varchar(30) default NULL,
        Versicherungswert decimal(18,2) default NULL,
        VWWaehrung varchar(3) default NULL,
        FrankaturKennung varchar(10) default NULL,
        Zahlungsbedinung varchar(10) default NULL,
        ZBZoll varchar(1) default NULL,
        FrachtfuehrerKDNr varchar(10) default NULL,
        Sonderdienste varchar(30) default NULL,
        SendungsInhalt varchar(30) default NULL,
        TerminArt varchar(1) default NULL,
        TerminDatum varchar(10) default NULL,
        TerminZeit varchar(5) default NULL,
        NeutabsenderName1 varchar(30) default NULL,
        NeutabsenderName2 varchar(30) default NULL,
        NeutabsenderName3 varchar(30) default NULL,
        NeutabsenderStrasse varchar(30) default NULL,
        NeutabsenderLKZ varchar(3) default NULL,
        NeutabsenderPLZ varchar(10) default NULL,
        NeutabsenderOrt varchar(30) default NULL,
        RechnungsEmpfName1 varchar(50) default NULL,
        RechnungsEmpfName2 varchar(50) default NULL,
        RechnungsEmpfName3 varchar(50) default NULL,
        RechnungsEmpfStr varchar(50) default NULL,
        RechnungsEmpfLKZ varchar(5) default NULL,
        RechnungsEmpfPLZ varchar(10) default NULL,
        RechnungsEmpfOrt varchar(50) default NULL,
        PostLeitcode varchar(15) default NULL,
        PostZielFrachtzent varchar(5) default NULL,
        FrachtBrief varchar(20) default NULL,
        -- Packstueckteil
        Gewicht decimal(8,3) default NULL,
        NettoGewicht decimal(8,3) default NULL,
        Verpackungsart varchar(6) default NULL,
        PackstueckLaenge int(10) unsigned default NULL,
        PackstueckBreite int(10) unsigned default NULL,
        PackstueckHoehe int(10) unsigned default NULL,
        PackstueckID varchar(15) NOT NULL,
        -- Primärschlüssel
        PRIMARY KEY (ID)
) ENGINE=InnoDB DEFAULT CHARSET=latin1;



Rückmeldung
CREATE TABLE hvs32_interaktiv_rueckmeldung (
        -- Steuerungsteil
        ID bigint(20) unsigned NOT NULL auto_increment,
        HVS32Verarbeitet int(1) unsigned NOT NULL default 0,
        HVS32Fehler int(1) unsigned NOT NULL default 0,
        HVS32Fehlertext1 varchar(200) default NULL,
        HVS32Fehlertext2 varchar(200) default NULL,
        -- Sendungsteil
        AuftraggeberID varchar(10) NOT NULL,
        VersandartID varchar(10) NOT NULL,
        LieferscheinNr varchar(40) NOT NULL,
        FrankaturKennung varchar(10) default NULL,
        Sonderdienste varchar(30) default NULL,
        -- Packstueckteil
        Gewicht decimal(8,3) default NULL,
        PackStkGes int(10) unsigned default NULL,
        PackStkNr int(10) unsigned default NULL,
        Verpackungsart varchar(6) default NULL,
        Packplatz varchar(10) default NULL,
        PackstueckID varchar(15) NOT NULL,
        TrackingNr  varchar(35) default NULL,
        RetourTrackingNr  varchar(35) default NULL,
        VersandSendungsNr varchar(20) default NULL,
        DruckDateTime varchar(20) default NULL,
        AusgangDateTime varchar(10) default NULL,
        Gebuehr decimal(8,3) default NULL, 
        GebuehrWaehrung varchar(3) default NULL,
        -- Primärschlüssel
        PRIMARY KEY (ID)
) ENGINE=InnoDB DEFAULT CHARSET=latin1;


MSSQL
CREATE TABLE hvs32_interaktiv (
        -- Steuerungsteil
        ID bigINT IDENTITY(1,1) NOT NULL,
        HVS32Verarbeitet INT NOT NULL default 0,
        -- Sendungsteil
        KundenNr VARCHAR(20) default NULL,
        ZielAdrName1 VARCHAR(50) NOT NULL,
        ZielAdrName2 VARCHAR(50) default NULL,
        ZielAdrName3 VARCHAR(50) default NULL,
        ZielAdrStrasse VARCHAR(50) NOT NULL,
        ZielAdrLKZ VARCHAR(5) NOT NULL,
        ZielAdrPLZ VARCHAR(10) NOT NULL,
        ZielAdrOrt VARCHAR(50) NOT NULL,
        ZielAdrRegion VARCHAR(20) default NULL,
        ZielAdrBahnhof VARCHAR(30) default NULL,
        Ansprechpartner VARCHAR(20) default NULL,
        TelefonNr VARCHAR(20) default NULL,
        FaxNr VARCHAR(20) default NULL,
        UstIDNr VARCHAR(20) default NULL,
        ILNNr VARCHAR(20) default NULL,
        AuftraggeberID VARCHAR(10) NOT NULL,
        VersandartID VARCHAR(10) NOT NULL,
        AVISHinweis1 VARCHAR(30) default NULL,
        AVISHinweis2 VARCHAR(30) default NULL,
        AVISZusatz1 VARCHAR(20) default NULL,
        AVISZusatz2 VARCHAR(20) default NULL,
        LieferscheinNr VARCHAR(40) NOT NULL,
        AuftragNr VARCHAR(20) default NULL,
        BestellNr VARCHAR(20) default NULL,
        Warenwert NUMERIC(18,2) default NULL,
        WWWaehrung VARCHAR(3) default NULL,
        Nachnahme NUMERIC(18,2) default NULL,
        NNWaehrung VARCHAR(3) default NULL,
        NNVermerk VARCHAR(1) default NULL,
        NNVerwendung VARCHAR(30) default NULL,
        Versicherungswert NUMERIC(18,2) default NULL,
        VWWaehrung VARCHAR(3) default NULL,
        FrankaturKennung VARCHAR(10) default NULL,
        Zahlungsbedinung VARCHAR(10) default NULL,
        ZBZoll VARCHAR(1) default NULL,
        FrachtfuehrerKDNr VARCHAR(10) default NULL,
        Sonderdienste VARCHAR(30) default NULL,
        SendungsInhalt VARCHAR(30) default NULL,
        TerminArt VARCHAR(1) default NULL,
        TerminDatum VARCHAR(10) default NULL,
        TerminZeit VARCHAR(5) default NULL,
        NeutabsenderName1 VARCHAR(30) default NULL,
        NeutabsenderName2 VARCHAR(30) default NULL,
        NeutabsenderName3 VARCHAR(30) default NULL,
        NeutabsenderStrasse VARCHAR(30) default NULL,
        NeutabsenderLKZ VARCHAR(3) default NULL,
        NeutabsenderPLZ VARCHAR(10) default NULL,
        NeutabsenderOrt VARCHAR(30) default NULL,
        RechnungsEmpfName1 VARCHAR(50) default NULL,
        RechnungsEmpfName2 VARCHAR(50) default NULL,
        RechnungsEmpfName3 VARCHAR(50) default NULL,
        RechnungsEmpfStr VARCHAR(50) default NULL,
        RechnungsEmpfLKZ VARCHAR(5) default NULL,
        RechnungsEmpfPLZ VARCHAR(10) default NULL,
        RechnungsEmpfOrt VARCHAR(50) default NULL,
        PostLeitcode VARCHAR(15) default NULL,
        PostZielFrachtzent VARCHAR(5) default NULL,
        FrachtBrief VARCHAR(20) default NULL,
        -- Packstueckteil
        Gewicht NUMERIC(8,3) default NULL,
        NettoGewicht NUMERIC(8,3) default NULL,
        Verpackungsart VARCHAR(6) default NULL,
        PackstueckLaenge INT default NULL,
        PackstueckBreite INT default NULL,
        PackstueckHoehe INT default NULL,
        PackstueckID VARCHAR(15) NOT NULL
)



Rueckmeldung
CREATE TABLE hvs32_interaktiv_rueckmeldung (
        -- Steuerungsteil
        ID bigINT IDENTITY(1,1) NOT NULL,
        HVS32Verarbeitet INT NOT NULL default 0,
        HVS32Fehler INT NOT NULL default 0,
        HVS32Fehlertext1 VARCHAR(200) default NULL,
        HVS32Fehlertext2 VARCHAR(200) default NULL,
        -- Sendungsteil
        AuftraggeberID VARCHAR(10) NOT NULL,
        VersandartID VARCHAR(10) NOT NULL,
        LieferscheinNr VARCHAR(40) NOT NULL,
        FrankaturKennung VARCHAR(10) default NULL,
        Sonderdienste VARCHAR(30) default NULL,
        -- Packstueckteil
        Gewicht NUMERIC(8,3) default NULL,
        NettoGewicht NUMERIC(8,3) default NULL,
        Verpackungsart VARCHAR(6) default NULL,
        PackstueckLaenge INT default NULL,
        PackstueckBreite INT default NULL,
        PackstueckHoehe INT default NULL,
        PackstueckID VARCHAR(15) NOT NULL
        TrackingNr  VARCHAR(35) default NULL,
        RetourTrackingNr  varchar(35) default NULL,
        VersandSendungsNr VARCHAR(20) default NULL,
        DruckDateTime VARCHAR(10) default NULL,
        AusgangDateTime VARCHAR(10) default NULL,
        Gebuehr NUMERIC(8,3) default NULL, 
        GebuehrWaehrung VARCHAR(3) default NULL,
        AusgangslisteNr INT default NULL
)


FAQ / Troubleshooting