HVS32 SAP RFC Schnittstelle (Interaktiv): Unterschied zwischen den Versionen
(10 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
+ | [[en:HVS32_SAP_RFC_Interface_(Interactive)]] | ||
+ | |||
= Voraussetzungen = | = Voraussetzungen = | ||
{| class="wikitable" | {| class="wikitable" | ||
Zeile 4: | Zeile 6: | ||
| DGS-Version || 3.6.0.550 oder höher | | DGS-Version || 3.6.0.550 oder höher | ||
|- | |- | ||
− | | DGS-Plugins || | + | | DGS-Plugins || HVS32Server, SAP RFC Client |
|} | |} | ||
− | |||
= Funktionsbeschreibung = | = Funktionsbeschreibung = | ||
Zeile 12: | Zeile 13: | ||
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.<br> | 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.<br> | ||
− | |||
− | |||
Zeile 22: | Zeile 21: | ||
= Notwendige SAP-Komponenten/-Parameter = | = Notwendige SAP-Komponenten/-Parameter = | ||
− | * neueste Version 3 der SAP Bibliothek Java Connector "JCo" in | + | * neueste Version 3 der SAP Bibliothek Java Connector "JCo" in 64Bit |
− | * SAP GUI Installation auf dem Server, auf welchem | + | ** 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) | ||
<br> | <br> | ||
folgende Parameter werden vom DGS benötigt, um RFC Bausteine bei einem SAP System aufzurufen: | folgende Parameter werden vom DGS benötigt, um RFC Bausteine bei einem SAP System aufzurufen: | ||
Zeile 40: | Zeile 42: | ||
| jco.client.passwd || Passwort | | jco.client.passwd || Passwort | ||
|- | |- | ||
− | | RFCFunctions || Liste | + | | RFCFunctions || Liste aller RFC-Funktionsbausteinen, welche im SAP bereitgestellt werden |
|} | |} | ||
Zeile 55: | Zeile 57: | ||
= Beispiele = | = Beispiele = | ||
+ | |||
+ | <div class="toccolours mw-collapsible mw-collapsed" style="width:60%; overflow:auto;"> | ||
+ | <div style="font-weight:bold;line-height:1.6;">Beispiel für eine RFC Baustein Struktur für die VersandDatenAnfrage</div> | ||
+ | <div class="mw-collapsible-content"> | ||
<source> | <source> | ||
− | ' | + | 'ZHVSVERSANDDATENANFRAGE'. |
IMPORTING | IMPORTING | ||
− | + | REFERENCENO CHAR(40) | |
EXPORTING | EXPORTING | ||
PACKSTUECK STRUCTURE | 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 | TABLE DGPOSITIONS | ||
Zeile 90: | Zeile 96: | ||
KLASSE CHAR(6) | KLASSE CHAR(6) | ||
VPG CHAR(5) | VPG CHAR(5) | ||
− | + | KCODE CHAR(5) | |
BEZEICHNUNG CHAR(110) | BEZEICHNUNG CHAR(110) | ||
MENGE CHAR(9) | MENGE CHAR(9) | ||
− | + | BEGRENZTEMENGE CHAR(1) | |
− | + | VERPANZAHL CHAR(10) | |
VERPACKUNGSART CHAR(8) | VERPACKUNGSART CHAR(8) | ||
− | + | NEBENGEFAHR CHAR(20) | |
BUCHST640 CHAR(1) | BUCHST640 CHAR(1) | ||
− | + | MENGENEINHEIT CHAR(2) | |
− | + | BEFOERDKAT CHAR(10) | |
FAKTOR CHAR(10) | FAKTOR CHAR(10) | ||
− | + | NETTOEXPLMASSE CHAR(9) | |
− | + | TUNNELBCODE CHAR(10) | |
− | + | FREIGESTMENGE CHAR(1) | |
− | + | FFCODE CHAR(20) | |
</source> | </source> | ||
+ | </div></div> | ||
+ | |||
+ | <div class="toccolours mw-collapsible mw-collapsed" style="width:60%; overflow:auto;"> | ||
+ | <div style="font-weight:bold;line-height:1.6;">Beispiel für eine RFC Baustein Struktur für die PaketscheinDruckMeldung</div> | ||
+ | <div class="mw-collapsible-content"> | ||
<source> | <source> | ||
− | ' | + | 'ZHVSPAKETSCHEINDRUCKMELDUNG'. |
IMPORTING | IMPORTING | ||
PACKSTUECKRUECK STRUCTURE | PACKSTUECKRUECK STRUCTURE | ||
− | + | LIEFERSCHEINNR CHAR(40) | |
− | + | PACKSTKGES CHAR(10) | |
− | + | PACKSTKNR CHAR(10) | |
GEWICHT CHAR(9) | 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) | GEBUEHR CHAR(19) | ||
− | + | GEBUEHRWAEHRUNG CHAR(3) | |
EXPORTING | EXPORTING | ||
FEHLERTEXT1 CHAR(200) | FEHLERTEXT1 CHAR(200) | ||
FEHLERTEXT2 CHAR(200) | FEHLERTEXT2 CHAR(200) | ||
</source> | </source> | ||
+ | </div></div> | ||
+ | |||
+ | <div class="toccolours mw-collapsible mw-collapsed" style="width:60%; overflow:auto;"> | ||
+ | <div style="font-weight:bold;line-height:1.6;">Beispiel für eine RFC Baustein Struktur für die AusgangslistenRueckMeldung</div> | ||
+ | <div class="mw-collapsible-content"> | ||
+ | <source> | ||
+ | '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) | ||
+ | </source> | ||
+ | </div></div> | ||
= FAQ / Troubleshooting = | = FAQ / Troubleshooting = |
Aktuelle Version vom 29. August 2022, 13:28 Uhr
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
'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)
'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)
'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)