HVS32 SAP RFC Interface (Interactive): Unterschied zwischen den Versionen
(Die Seite wurde neu angelegt: „de:HVS32_SAP_RFC_Schnittstelle_(Interaktiv)“) |
|||
Zeile 1: | Zeile 1: | ||
[[de:HVS32_SAP_RFC_Schnittstelle_(Interaktiv)]] | [[de:HVS32_SAP_RFC_Schnittstelle_(Interaktiv)]] | ||
+ | |||
+ | = Prerequisites = | ||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | | DGS-Version || 3.6.0.550 or higher | ||
+ | |- | ||
+ | | DGS-Plugins || HVS32Server, SAP RFC Client | ||
+ | |} | ||
+ | |||
+ | = Function description = | ||
+ | The DataGatewayServer (DGS) uses the SAP library "JCo" for the connection via RFC protocol with an ABAP application server. In case of interactive processing, requests are sent from the dispatch system to the SAP system. Here, the DGS acts as an RFC client program, which explicitly addresses a specific SAP application server for processing the request.<br> | ||
+ | |||
+ | The DGS is the central communication unit through which all data is exchanged between the shipping system and the SAP system. It runs in the form of a service on a Windows server.<br> | ||
+ | |||
+ | |||
+ | <gallery> | ||
+ | RFCClientSapServer.png|Architektur: DGS SAP/RFC Client | ||
+ | RFCClientSapServerGroup.png|Architektur: DGS SAP/RFC Client (Server Gruop) | ||
+ | </gallery> | ||
+ | |||
+ | = Required SAP components/parameters = | ||
+ | * latest version 3 of SAP library Java Connector "JCo" in 64Bit. | ||
+ | * SAP GUI installation on the server where the DataGatewayServer is installed - alternatively a manual adjustment of %SystemRoot%\system32\drivers\etc\services und %SystemRoot%\system32\drivers\etc\hosts | ||
+ | <br> | ||
+ | the following parameters are required by the DGS to call RFC modules on an SAP system: | ||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | ! 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 von RFC-Bausteinen, die vom DataGatewayServer aufgerufen werden sollen | ||
+ | |} | ||
+ | |||
+ | |||
+ | = 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.<br> | ||
+ | |||
+ | 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.<br><br> | ||
+ | |||
+ | |||
+ | 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.<br> | ||
+ | <br> | ||
+ | '''[[HVS32_Funktionen_Interaktiv|Verfügbare HVS32 Funktionen]]''' | ||
+ | |||
+ | = 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> | ||
+ | 'Z_HVS_VERSANDDATENANFRAGE'. | ||
+ | |||
+ | IMPORTING | ||
+ | REFERENCE_NO CHAR(40) | ||
+ | |||
+ | EXPORTING | ||
+ | PACKSTUECK STRUCTURE | ||
+ | KUNDEN_NR CHAR(20) | ||
+ | ZIEL_ADR_NAME1 CHAR(50) | ||
+ | ZIEL_ADR_NAME2 CHAR(50) | ||
+ | ZIEL_ADR_NAME3 CHAR(50) | ||
+ | ZIEL_ADR_STRASSE CHAR(50) | ||
+ | ZIEL_ADR_LKZ CHAR(5) | ||
+ | ZIEL_ADR_PLZ CHAR(10) | ||
+ | ZIEL_ADR_ORT CHAR(50) | ||
+ | ZIEL_ADR_REGION CHAR(20) | ||
+ | ZIEL_ADR_BAHNHOF CHAR(30) | ||
+ | AUFTRAGGEBER_ID CHAR(10) | ||
+ | VERSANDART_ID CHAR(10) | ||
+ | LIEFERSCHEIN_NR CHAR(40) | ||
+ | AUFTRAG_NR CHAR(20) | ||
+ | BESTELL_NR CHAR(20) | ||
+ | NEUTABSENDER_NAME1 CHAR(30) | ||
+ | NEUTABSENDER_NAME2 CHAR(30) | ||
+ | NEUTABSENDER_NAME3 CHAR(30) | ||
+ | NEUTABSENDER_STRASSE CHAR(30) | ||
+ | NEUTABSENDER_LKZ CHAR(3) | ||
+ | NEUTABSENDER_PLZ CHAR(10) | ||
+ | NEUTABSENDER_ORT CHAR(30) | ||
+ | |||
+ | TABLE DGPOSITIONS | ||
+ | UNNR CHAR(4) | ||
+ | KLASSE CHAR(6) | ||
+ | VPG CHAR(5) | ||
+ | K_CODE CHAR(5) | ||
+ | BEZEICHNUNG CHAR(110) | ||
+ | MENGE CHAR(9) | ||
+ | BEGRENZTE_MENGE CHAR(1) | ||
+ | VERP_ANZAHL CHAR(10) | ||
+ | VERPACKUNGSART CHAR(8) | ||
+ | NEBEN_GEFAHR CHAR(20) | ||
+ | BUCHST640 CHAR(1) | ||
+ | MENGEN_EINHEIT CHAR(2) | ||
+ | BEFOERD_KAT CHAR(10) | ||
+ | FAKTOR CHAR(10) | ||
+ | NETTO_EXPL_MASSE CHAR(9) | ||
+ | TUNNEL_B_CODE CHAR(10) | ||
+ | FREIGEST_MENGE CHAR(1) | ||
+ | FF_CODE CHAR(20) | ||
+ | </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> | ||
+ | 'Z_HVS_PAKETSCHEINDRUCKMELDUNG'. | ||
+ | IMPORTING | ||
+ | PACKSTUECKRUECK STRUCTURE | ||
+ | LIEFERSCHEIN_NR CHAR(40) | ||
+ | PACK_STK_GES CHAR(10) | ||
+ | PACK_STK_NR CHAR(10) | ||
+ | GEWICHT CHAR(9) | ||
+ | PACKSTUECK_LAENGE CHAR(10) | ||
+ | PACKSTUECK_BREITE CHAR(10) | ||
+ | PACKSTUECK_HOEHE CHAR(10) | ||
+ | TRACKING_NR CHAR(35) | ||
+ | VERSAND_SENDUNGS_NR CHAR(20) | ||
+ | DRUCK_DATE_TIME CHAR(10) | ||
+ | AUSGANG_DATE_TIME CHAR(10) | ||
+ | GEBUEHR CHAR(19) | ||
+ | GEBUEHR_WAEHRUNG CHAR(3) | ||
+ | EXPORTING | ||
+ | FEHLERTEXT1 CHAR(200) | ||
+ | FEHLERTEXT2 CHAR(200) | ||
+ | </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> | ||
+ | 'Z_HVS_AusgangslistenRueckMeldung'. | ||
+ | IMPORTING | ||
+ | AUSGANGSLISTENR (20) | ||
+ | PACKSTUECKRUECK TABLE | ||
+ | LIEFERSCHEIN_NR CHAR(40) | ||
+ | TRACKING_NR CHAR(35) | ||
+ | GEBUEHR CHAR(19) | ||
+ | GEBUEHR_WAEHRUNG CHAR(3) | ||
+ | |||
+ | |||
+ | oder | ||
+ | |||
+ | |||
+ | 'Z_HVS_AusgangslistenRueckMeldung'. | ||
+ | IMPORTING | ||
+ | AUSGANGSLISTENR (20) | ||
+ | |||
+ | TABLE PACKSTUECKRUECK | ||
+ | LIEFERSCHEIN_NR CHAR(40) | ||
+ | TRACKING_NR CHAR(35) | ||
+ | GEBUEHR CHAR(19) | ||
+ | GEBUEHR_WAEHRUNG CHAR(3) | ||
+ | </source> | ||
+ | </div></div> | ||
+ | |||
+ | = FAQ / Troubleshooting = |
Version vom 7. September 2021, 11:55 Uhr
Prerequisites
DGS-Version | 3.6.0.550 or higher |
DGS-Plugins | HVS32Server, SAP RFC Client |
Function description
The DataGatewayServer (DGS) uses the SAP library "JCo" for the connection via RFC protocol with an ABAP application server. In case of interactive processing, requests are sent from the dispatch system to the SAP system. Here, the DGS acts as an RFC client program, which explicitly addresses a specific SAP application server for processing the request.
The DGS is the central communication unit through which all data is exchanged between the shipping system and the SAP system. It runs in the form of a service on a Windows server.
Required SAP components/parameters
- latest version 3 of SAP library Java Connector "JCo" in 64Bit.
- SAP GUI installation on the server where the DataGatewayServer is installed - alternatively a manual adjustment of %SystemRoot%\system32\drivers\etc\services und %SystemRoot%\system32\drivers\etc\hosts
the following parameters are required by the DGS to call RFC modules on an SAP system:
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 von RFC-Bausteinen, die vom DataGatewayServer aufgerufen werden sollen |
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
'Z_HVS_VERSANDDATENANFRAGE'.
IMPORTING
REFERENCE_NO CHAR(40)
EXPORTING
PACKSTUECK STRUCTURE
KUNDEN_NR CHAR(20)
ZIEL_ADR_NAME1 CHAR(50)
ZIEL_ADR_NAME2 CHAR(50)
ZIEL_ADR_NAME3 CHAR(50)
ZIEL_ADR_STRASSE CHAR(50)
ZIEL_ADR_LKZ CHAR(5)
ZIEL_ADR_PLZ CHAR(10)
ZIEL_ADR_ORT CHAR(50)
ZIEL_ADR_REGION CHAR(20)
ZIEL_ADR_BAHNHOF CHAR(30)
AUFTRAGGEBER_ID CHAR(10)
VERSANDART_ID CHAR(10)
LIEFERSCHEIN_NR CHAR(40)
AUFTRAG_NR CHAR(20)
BESTELL_NR CHAR(20)
NEUTABSENDER_NAME1 CHAR(30)
NEUTABSENDER_NAME2 CHAR(30)
NEUTABSENDER_NAME3 CHAR(30)
NEUTABSENDER_STRASSE CHAR(30)
NEUTABSENDER_LKZ CHAR(3)
NEUTABSENDER_PLZ CHAR(10)
NEUTABSENDER_ORT CHAR(30)
TABLE DGPOSITIONS
UNNR CHAR(4)
KLASSE CHAR(6)
VPG CHAR(5)
K_CODE CHAR(5)
BEZEICHNUNG CHAR(110)
MENGE CHAR(9)
BEGRENZTE_MENGE CHAR(1)
VERP_ANZAHL CHAR(10)
VERPACKUNGSART CHAR(8)
NEBEN_GEFAHR CHAR(20)
BUCHST640 CHAR(1)
MENGEN_EINHEIT CHAR(2)
BEFOERD_KAT CHAR(10)
FAKTOR CHAR(10)
NETTO_EXPL_MASSE CHAR(9)
TUNNEL_B_CODE CHAR(10)
FREIGEST_MENGE CHAR(1)
FF_CODE CHAR(20)
'Z_HVS_PAKETSCHEINDRUCKMELDUNG'.
IMPORTING
PACKSTUECKRUECK STRUCTURE
LIEFERSCHEIN_NR CHAR(40)
PACK_STK_GES CHAR(10)
PACK_STK_NR CHAR(10)
GEWICHT CHAR(9)
PACKSTUECK_LAENGE CHAR(10)
PACKSTUECK_BREITE CHAR(10)
PACKSTUECK_HOEHE CHAR(10)
TRACKING_NR CHAR(35)
VERSAND_SENDUNGS_NR CHAR(20)
DRUCK_DATE_TIME CHAR(10)
AUSGANG_DATE_TIME CHAR(10)
GEBUEHR CHAR(19)
GEBUEHR_WAEHRUNG CHAR(3)
EXPORTING
FEHLERTEXT1 CHAR(200)
FEHLERTEXT2 CHAR(200)
'Z_HVS_AusgangslistenRueckMeldung'.
IMPORTING
AUSGANGSLISTENR (20)
PACKSTUECKRUECK TABLE
LIEFERSCHEIN_NR CHAR(40)
TRACKING_NR CHAR(35)
GEBUEHR CHAR(19)
GEBUEHR_WAEHRUNG CHAR(3)
oder
'Z_HVS_AusgangslistenRueckMeldung'.
IMPORTING
AUSGANGSLISTENR (20)
TABLE PACKSTUECKRUECK
LIEFERSCHEIN_NR CHAR(40)
TRACKING_NR CHAR(35)
GEBUEHR CHAR(19)
GEBUEHR_WAEHRUNG CHAR(3)