HVS32 SAP RFC Schnittstelle (Interaktiv)

Aus Wiki - Heidler Strichcode GmbH
Version vom 29. August 2022, 13:28 Uhr von Odelice (Diskussion | Beiträge)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springen Zur Suche springen


Voraussetzungen

DGS-Version 3.6.0.550 oder höher
DGS-Plugins HVS32Server, SAP RFC Client

Funktionsbeschreibung

Der DataGatewayServer (DGS) nutzt für die Verbindung über das RFC-Protokoll mit einem ABAP Applikations-Server die SAP Bibliothek "JCo". Bei interaktiver Verarbeitung werden Anfragen aus dem Versandsystem heraus an das SAP-System gestellt. Dabei agiert der DGS als RFC Client-Programm, welches sich explizit an einen bestimmten SAP-Applikationsserver zur Bearbeitung der Anfrage wendet.

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


Notwendige SAP-Komponenten/-Parameter

  • neueste Version 3 der SAP Bibliothek Java Connector "JCo" in 64Bit
    • Die Verwendung vom SAP JCo 3.1 setzt die Installation vom Microsoft Visual Studio 2013 C/C++ (64bit) voraus.
  • SAP GUI Installation auf dem HVS32 Server, auf welchem die Heidler Applikationen installiert sind
    • alternativ eine manuelle Anpassung der %SystemRoot%\system32\drivers\etc\services und %SystemRoot%\system32\drivers\etc\hosts
    • Die SAP GUI installiert unter anderem auch die Microsoft Visual Studio komponenente (nach Installation prüfen, ob für die korrekte Version für die eingesetzte SAP JCo vorhanden ist)


folgende Parameter werden vom DGS benötigt, um RFC Bausteine bei einem SAP System aufzurufen:

Parameter Beschreibung
jco.client.ashost SAP-Applikation-Server auf welchem sich die Struktur des RFC Bausteins befindet
jco.client.sysnr SAP System Nr
jco.client.client Mandanten ID (SAP)
jco.client.user SAP-Benutzer mit Rechten zum Ausführen von RFC
jco.client.passwd Passwort
RFCFunctions Liste aller RFC-Funktionsbausteinen, welche im SAP bereitgestellt werden


Verfügbare HVS32 Funktionen

Artikel-Daten und Gefahrgut-Informationen müssen im RFC Baustein als Table oder Struct definiert werden, da diese in einer 1:n Beziehung zu den Packstückdaten stehen.

Das HVS32 sendet die Daten in den Import-Parametern - alle Parameter, welche an das HVS32 übertragen werden sollen, müssen in die Export-Parameter geschrieben werden. Die Kommunikation ist bidirektional, d.h. die Rückmeldung von SAP erfolgt synchron in der gleichen Transaktion wie die Anfrage.


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

Verfügbare HVS32 Funktionen

Beispiele

Beispiel für eine RFC Baustein Struktur für die VersandDatenAnfrage
'ZHVSVERSANDDATENANFRAGE'.

IMPORTING
  REFERENCENO CHAR(40)

EXPORTING
  PACKSTUECK STRUCTURE
    KUNDENNR CHAR(20)
    ZIELADRNAME1 CHAR(50)
    ZIELADRNAME2 CHAR(50)
    ZIELADRNAME3 CHAR(50)
    ZIELADRSTRASSE CHAR(50)
    ZIELADRLKZ CHAR(5)
    ZIELADRPLZ CHAR(10)
    ZIELADRORT CHAR(50)
    ZIELADRREGION CHAR(20)
    ZIELADRBAHNHOF CHAR(30)
    AUFTRAGGEBERID CHAR(10)
    VERSANDARTID CHAR(10)
    LIEFERSCHEINNR CHAR(40)
    AUFTRAGNR CHAR(20)
    BESTELLNR CHAR(20)
    NEUTABSENDERNAME1 CHAR(30)
    NEUTABSENDERNAME2 CHAR(30)
    NEUTABSENDERNAME3 CHAR(30)
    NEUTABSENDERSTRASSE CHAR(30)
    NEUTABSENDERLKZ CHAR(3)
    NEUTABSENDERPLZ CHAR(10)
    NEUTABSENDERORT CHAR(30)
 
TABLE  DGPOSITIONS
    UNNR CHAR(4)
    KLASSE CHAR(6)
    VPG CHAR(5)
    KCODE CHAR(5)
    BEZEICHNUNG CHAR(110)
    MENGE CHAR(9)
    BEGRENZTEMENGE CHAR(1)
    VERPANZAHL CHAR(10)
    VERPACKUNGSART CHAR(8)
    NEBENGEFAHR CHAR(20)
    BUCHST640 CHAR(1)
    MENGENEINHEIT CHAR(2)
    BEFOERDKAT CHAR(10)
    FAKTOR CHAR(10)
    NETTOEXPLMASSE CHAR(9)
    TUNNELBCODE CHAR(10)
    FREIGESTMENGE CHAR(1)
    FFCODE CHAR(20)
Beispiel für eine RFC Baustein Struktur für die PaketscheinDruckMeldung
'ZHVSPAKETSCHEINDRUCKMELDUNG'.
IMPORTING
  PACKSTUECKRUECK STRUCTURE
  LIEFERSCHEINNR CHAR(40)
  PACKSTKGES CHAR(10)
  PACKSTKNR CHAR(10)
  GEWICHT CHAR(9)
  PACKSTUECKLAENGE CHAR(10)
  PACKSTUECKBREITE CHAR(10)
  PACKSTUECKHOEHE CHAR(10)
  TRACKINGNR CHAR(35)
  VERSANDSENDUNGSNR CHAR(20)
  DRUCKDATETIME CHAR(10)
  AUSGANGDATETIME CHAR(10)
  GEBUEHR CHAR(19)
  GEBUEHRWAEHRUNG CHAR(3)
EXPORTING
  FEHLERTEXT1 CHAR(200)
  FEHLERTEXT2 CHAR(200)
Beispiel für eine RFC Baustein Struktur für die AusgangslistenRueckMeldung
'ZHVSAusgangslistenRueckMeldung'.
IMPORTING
  AUSGANGSLISTENR (20)
  PACKSTUECKRUECK TABLE
    LIEFERSCHEINNR CHAR(40)  
    TRACKINGNR CHAR(35)  
    GEBUEHR CHAR(19)
    GEBUEHRWAEHRUNG CHAR(3)


oder


'ZHVSAusgangslistenRueckMeldung'.
IMPORTING
  AUSGANGSLISTENR (20)

TABLE PACKSTUECKRUECK
  LIEFERSCHEINNR CHAR(40)  
  TRACKINGNR CHAR(35)  
  GEBUEHR CHAR(19)
  GEBUEHRWAEHRUNG CHAR(3)

FAQ / Troubleshooting