HVS32 SAP RFC Schnittstelle (Automatik-Polling): Unterschied zwischen den Versionen
(7 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
Zeile 32: | Zeile 32: | ||
= Notwendige SAP-Komponenten/-Parameter = | = Notwendige SAP-Komponenten/-Parameter = | ||
− | * neueste Version 3 der SAP Bibliothek Java Connector "JCo" in 64Bit | + | * neueste Version 3 der SAP Bibliothek Java Connector "JCo" in '''64Bit''' (sapjco3.jar + sapjco3.dll) |
− | * 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) | ||
* eine definierte Destination mit Verbindungstyp T (TCP/IP-Verbindung) im SAP-System über die Transaktion SM59 ([[#Destination_.C3.BCber_SM59_definieren|siehe Destination über SM59 definieren]]) | * eine definierte Destination mit Verbindungstyp T (TCP/IP-Verbindung) im SAP-System über die Transaktion SM59 ([[#Destination_.C3.BCber_SM59_definieren|siehe Destination über SM59 definieren]]) | ||
<br> | <br> | ||
Zeile 41: | Zeile 44: | ||
! Parameter !! Beschreibung | ! Parameter !! Beschreibung | ||
|- | |- | ||
− | | jco.server.gwhost || SAP-Gateway an welchem die Funktionsbausteine registriert werden | + | | jco.server.gwhost || SAP-Gateway (Servername / IP) an welchem die Funktionsbausteine registriert werden |
|- | |- | ||
| jco.server.gwserv || SAP-Gateway-Service (Port) der genutzt wird (z.B. sapgw00) | | jco.server.gwserv || SAP-Gateway-Service (Port) der genutzt wird (z.B. sapgw00) | ||
Zeile 49: | Zeile 52: | ||
| jco.server.connection_count || Anzahl gleichzeitiger Verbindungen, die später von SAP zum Aufruf genutzt werden können | | jco.server.connection_count || Anzahl gleichzeitiger Verbindungen, die später von SAP zum Aufruf genutzt werden können | ||
|- | |- | ||
− | | jco.client.ashost || SAP-Applikation-Server auf welchem sich die Struktur des RFC Bausteins befindet | + | | jco.client.ashost || SAP-Applikation-Server (Servername / IP) auf welchem sich die Struktur des RFC Bausteins befindet |
|- | |- | ||
− | | jco.client.sysnr || SAP System Nr | + | | jco.client.sysnr || SAP System Nr (Zweistellig nummerisch) |
|- | |- | ||
| jco.client.client || Mandanten ID (SAP) | | jco.client.client || Mandanten ID (SAP) | ||
Zeile 59: | Zeile 62: | ||
| jco.client.passwd || Passwort | | jco.client.passwd || Passwort | ||
|- | |- | ||
− | | rfcfunctions || Liste | + | | rfcfunctions || Liste aller RFC-Funktionsbausteinen, welche im SAP bereitgestellt werden |
|} | |} | ||
Falls für clientseitige RFC-Aufrufe eine Lastverteilung (SAP Message Server) auf Seiten von SAP genutzt wird, muss anstelle der Parameter ashost und sysnr folgendes konfiguriert werden: | Falls für clientseitige RFC-Aufrufe eine Lastverteilung (SAP Message Server) auf Seiten von SAP genutzt wird, muss anstelle der Parameter ashost und sysnr folgendes konfiguriert werden: | ||
Zeile 86: | Zeile 89: | ||
<div class="mw-collapsible-content"> | <div class="mw-collapsible-content"> | ||
<source> | <source> | ||
− | ' | + | 'ZHVSVERSANDDATENANFRAGE' |
IMPORTING | IMPORTING | ||
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) | |
ANSPRECHPARTNER CHAR(20) | ANSPRECHPARTNER CHAR(20) | ||
− | + | TELEFONNR CHAR(20) | |
− | + | FAXNR CHAR(20) | |
− | + | USTIDNR CHAR(20) | |
− | + | ILNNR CHAR(20) | |
− | + | AUFTRAGGEBERID CHAR(10) | |
− | + | VERSANDARTID CHAR(10) | |
− | + | AVISHINWEIS1 CHAR(30) | |
− | + | AVISHINWEIS2 CHAR(30) | |
− | + | AVISZUSATZ1 CHAR(20) | |
− | + | AVISZUSATZ2 CHAR(20) | |
− | + | LIEFERSCHEINNR CHAR(40) | |
− | + | AUFTRAGNR CHAR(20) | |
− | + | BESTELLNR CHAR(20) | |
WARENWERT CHAR(19) | WARENWERT CHAR(19) | ||
− | + | WWWAEHRUNG CHAR(3) | |
NACHNAHME CHAR(19) | NACHNAHME CHAR(19) | ||
− | + | NNWAEHRUNG CHAR(3) | |
− | + | NNVERMERK CHAR(1) | |
− | + | NNVERWENDUNG CHAR(30) | |
VERSICHERUNGSWERT CHAR(19) | VERSICHERUNGSWERT CHAR(19) | ||
− | + | VWWAEHRUNG CHAR(3) | |
− | + | FRANKATURKENNUNG CHAR(10) | |
ZAHLUNGSBEDIGNUNG CHAR(10) | ZAHLUNGSBEDIGNUNG CHAR(10) | ||
− | + | ZBZOLL CHAR(1) | |
− | + | FRACHTFUEHRERKDNR CHAR(10) | |
SONDERDIENSTE CHAR(30) | SONDERDIENSTE CHAR(30) | ||
− | + | SENDUNGSINHALT CHAR(30) | |
− | + | TERMINART CHAR(1) | |
− | + | TERMINDATUM CHAR(10) | |
− | + | TERMINZEIT CHAR(5) | |
− | + | NEUTABSENDERNAME1 CHAR(30) | |
− | + | NEUTABSENDERNAME2 CHAR(30) | |
− | + | NEUTABSENDERNAME3 CHAR(30) | |
− | + | NEUTABSENDERSTRASSE CHAR(30) | |
− | + | NEUTABSENDERLKZ CHAR(3) | |
− | + | NEUTABSENDERPLZ CHAR(10) | |
− | + | NEUTABSENDERORT CHAR(30) | |
− | + | RECHNUNGSEMPFNAME1 CHAR(50) | |
− | + | RECHNUNGSEMPFNAME2 CHAR(50) | |
− | + | RECHNUNGSEMPFNAME3 CHAR(50) | |
− | + | RECHNUNGSEMPFSTRASSE CHAR(50) | |
− | + | RECHNUNGSEMPFLKZ CHAR(5) | |
− | + | RECHNUNGSEMPFPLZ CHAR(10) | |
− | + | RECHNUNGSEMPFORT CHAR(50) | |
− | + | POSTLEITCODE CHAR(15) | |
− | + | POSTZIELFRACHTZENT CHAR(5) | |
− | + | FRACHTBRIEF CHAR(20) | |
GEWICHT CHAR(9) | GEWICHT CHAR(9) | ||
− | + | NETTOGEWICHT CHAR(9) | |
− | + | PACKSTKGES CHAR(10) | |
− | + | PACKSTKNR CHAR(10) | |
VERPACKUNGSART CHAR(6) | VERPACKUNGSART CHAR(6) | ||
− | + | PACKSTUECKLAENGE CHAR(10) | |
− | + | PACKSTUECKBREITE CHAR(10) | |
− | + | PACKSTUECKHOEHE CHAR(10) | |
PACKPLATZ CHAR(10) | PACKPLATZ CHAR(10) | ||
− | + | PACKSTUECKID CHAR(15) | |
− | + | ANZAHLARTIKEL CHAR(10) | |
− | + | ZUSATZZEILE1 CHAR(150) | |
− | + | ZUSATZZEILE2 CHAR(150) | |
− | + | FREIAVIS1 CHAR(62) | |
− | + | FREIAVIS2 CHAR(62) | |
− | + | HVELEKTRONIKARTIKEL CHAR(1) | |
− | + | EMPFEMAILADRESSE CHAR(100) | |
KOSTENSTELLE CHAR(30) | KOSTENSTELLE CHAR(30) | ||
DRUCKERNAME CHAR(30) | DRUCKERNAME CHAR(30) | ||
DGPOSITIONS STRUCTURE | DGPOSITIONS STRUCTURE | ||
− | + | GEFAHRGUTUNNR CHAR(4) | |
− | + | GEFAHRGUTKLASSE CHAR(6) | |
− | + | GEFAHRGUTVPG CHAR(5) | |
− | + | GEFAHRGUTKCODE CHAR(5) | |
− | + | GEFAHRGUTBEZEICHNUNG CHAR(110) | |
− | + | GEFAHRGUTMENGE CHAR(9) | |
− | + | GEFAHRGUTBEGRENZTEMENGE CHAR(1) | |
− | + | GEFAHRGUTVERPANZAHL CHAR(10) | |
− | + | GEFAHRGUTVERPACKUNGSART CHAR(8) | |
− | + | GEFAHRGUTNEBENGEFAHR CHAR(20) | |
− | + | GEFAHRGUTBUCHST640 CHAR(1) | |
− | + | GEFAHRGUTMENGENEINHEIT CHAR(2) | |
− | + | GEFAHRGUTBEFOERDKAT CHAR(10) | |
− | + | GEFAHRGUTFAKTOR CHAR(10) | |
− | + | GEFAHRGUTNETTOEXPLMASSE CHAR(9) | |
− | + | GEFAHRGUTTUNNELBCODE CHAR(10) | |
− | + | GEFAHRGUTFREIGESTMENGE CHAR(1) | |
− | + | GEFAHRGUTFFCODE CHAR(20) | |
DELIVERYPOSITIONS STRUCTURE | DELIVERYPOSITIONS STRUCTURE | ||
ANZAHLPOSETIKETTEN CHAR() | ANZAHLPOSETIKETTEN CHAR() | ||
Zeile 215: | Zeile 218: | ||
EXPORTING | EXPORTING | ||
PACKSTUECKRUECK STRUCTURE | PACKSTUECKRUECK STRUCTURE | ||
− | + | TRACKINGNR CHAR(35) | |
− | + | VERSANDSENDUNGSNR CHAR(20) | |
− | + | DRUCKDATETIME CHAR(10) | |
− | + | AUSGANGDATETIME CHAR(10) | |
GEBUEHR CHAR(19) | GEBUEHR CHAR(19) | ||
− | + | GEBUEHRWAEHRUNG CHAR(3) | |
FEHLERTEXT1 CHAR(200) | FEHLERTEXT1 CHAR(200) | ||
FEHLERTEXT2 CHAR(200) | FEHLERTEXT2 CHAR(200) |
Aktuelle Version vom 27. Mai 2024, 10:33 Uhr
Voraussetzungen
DGS-Version | 3.6.0.550 oder höher |
DGS-Plugins | HVS32Client, SAP RFC Server |
Funktionsbeschreibung
Der DataGatewayServer (DGS) nutzt für die Kommunikation mit einem SAP System die SAP Bibliothek "JCo" und agiert beim Automatik Polling als JCo Server-Programm.
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.
Es können beliebige RFC Funktionen im DGS implementiert werden, welche von einem RFC-Client (SAP) aus aufgerufen werden.
Je HVS32 Funktion muss ein separater RFC Baustein genutzt werden. Die Struktur des RFC-Bausteins (Felder, Tabellen, Strukturen) ohne Implementierung muss im SAP System auf einem Applikationsserver für den DGS verfügbar sein - da die Metadaten der RFC Bausteine bei Systemstart abgerufen werden.
Der DGS registriert sich selbst unter einer Programm-ID an einem SAP Gateway (nicht für ein spezifisches SAP-System) und wartet auf eingehende RFC-Aufrufe.
Wenn ein RFC-Aufruf von einem beliebigen SAP-System an dieses SAP Gateway mit der Option "Verbindung mit einem bereits registrierten Programm" (mit der selben Programm-ID) übermittelt wird, findet die Verbindung mit dem DGS statt.
Nach dem Ausführen einer RFC-Funktion wartet der DGS auf weitere RFC-Aufrufe vom selben oder einem anderen SAP-System.
Im Falle einer unterbrochenen oder beendeten RFC-Verbindung registriert sich der DGS automatisch wieder am selben SAP Gateway unter der selben Programm-ID.
Notwendige SAP-Komponenten/-Parameter
- neueste Version 3 der SAP Bibliothek Java Connector "JCo" in 64Bit (sapjco3.jar + sapjco3.dll)
- 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)
- eine definierte Destination mit Verbindungstyp T (TCP/IP-Verbindung) im SAP-System über die Transaktion SM59 (siehe Destination über SM59 definieren)
folgende Parameter werden vom DGS benötigt, um sich mit einer Programm-ID an einem SAP Gateway zu registrieren:
Parameter | Beschreibung |
---|---|
jco.server.gwhost | SAP-Gateway (Servername / IP) an welchem die Funktionsbausteine registriert werden |
jco.server.gwserv | SAP-Gateway-Service (Port) der genutzt wird (z.B. sapgw00) |
jco.server.progid | Programm-ID aus der SM59 unter welcher die Registrierung stattfindet |
jco.server.connection_count | Anzahl gleichzeitiger Verbindungen, die später von SAP zum Aufruf genutzt werden können |
jco.client.ashost | SAP-Applikation-Server (Servername / IP) auf welchem sich die Struktur des RFC Bausteins befindet |
jco.client.sysnr | SAP System Nr (Zweistellig nummerisch) |
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 |
Falls für clientseitige RFC-Aufrufe eine Lastverteilung (SAP Message Server) auf Seiten von SAP genutzt wird, muss anstelle der Parameter ashost und sysnr folgendes konfiguriert werden:
Parameter | Beschreibung |
---|---|
jco.client.mshost | IP oder Name des SAP Message Server |
jco.client.r3name | System ID des SAP-Systems |
jco.client.group | Name der SAP-Servergruppe |
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.
Alle Parameter, welche an das HVS32 gesendet werden sollen, müssen in die Import-Parameter geschrieben werden. Die Rückmeldung aus dem HVS32 erfolgt in den Export-Parametern. Die Kommunikation ist bidirektional, d.h. die Rückmeldung 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
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)
ANSPRECHPARTNER CHAR(20)
TELEFONNR CHAR(20)
FAXNR CHAR(20)
USTIDNR CHAR(20)
ILNNR CHAR(20)
AUFTRAGGEBERID CHAR(10)
VERSANDARTID CHAR(10)
AVISHINWEIS1 CHAR(30)
AVISHINWEIS2 CHAR(30)
AVISZUSATZ1 CHAR(20)
AVISZUSATZ2 CHAR(20)
LIEFERSCHEINNR CHAR(40)
AUFTRAGNR CHAR(20)
BESTELLNR CHAR(20)
WARENWERT CHAR(19)
WWWAEHRUNG CHAR(3)
NACHNAHME CHAR(19)
NNWAEHRUNG CHAR(3)
NNVERMERK CHAR(1)
NNVERWENDUNG CHAR(30)
VERSICHERUNGSWERT CHAR(19)
VWWAEHRUNG CHAR(3)
FRANKATURKENNUNG CHAR(10)
ZAHLUNGSBEDIGNUNG CHAR(10)
ZBZOLL CHAR(1)
FRACHTFUEHRERKDNR CHAR(10)
SONDERDIENSTE CHAR(30)
SENDUNGSINHALT CHAR(30)
TERMINART CHAR(1)
TERMINDATUM CHAR(10)
TERMINZEIT CHAR(5)
NEUTABSENDERNAME1 CHAR(30)
NEUTABSENDERNAME2 CHAR(30)
NEUTABSENDERNAME3 CHAR(30)
NEUTABSENDERSTRASSE CHAR(30)
NEUTABSENDERLKZ CHAR(3)
NEUTABSENDERPLZ CHAR(10)
NEUTABSENDERORT CHAR(30)
RECHNUNGSEMPFNAME1 CHAR(50)
RECHNUNGSEMPFNAME2 CHAR(50)
RECHNUNGSEMPFNAME3 CHAR(50)
RECHNUNGSEMPFSTRASSE CHAR(50)
RECHNUNGSEMPFLKZ CHAR(5)
RECHNUNGSEMPFPLZ CHAR(10)
RECHNUNGSEMPFORT CHAR(50)
POSTLEITCODE CHAR(15)
POSTZIELFRACHTZENT CHAR(5)
FRACHTBRIEF CHAR(20)
GEWICHT CHAR(9)
NETTOGEWICHT CHAR(9)
PACKSTKGES CHAR(10)
PACKSTKNR CHAR(10)
VERPACKUNGSART CHAR(6)
PACKSTUECKLAENGE CHAR(10)
PACKSTUECKBREITE CHAR(10)
PACKSTUECKHOEHE CHAR(10)
PACKPLATZ CHAR(10)
PACKSTUECKID CHAR(15)
ANZAHLARTIKEL CHAR(10)
ZUSATZZEILE1 CHAR(150)
ZUSATZZEILE2 CHAR(150)
FREIAVIS1 CHAR(62)
FREIAVIS2 CHAR(62)
HVELEKTRONIKARTIKEL CHAR(1)
EMPFEMAILADRESSE CHAR(100)
KOSTENSTELLE CHAR(30)
DRUCKERNAME CHAR(30)
DGPOSITIONS STRUCTURE
GEFAHRGUTUNNR CHAR(4)
GEFAHRGUTKLASSE CHAR(6)
GEFAHRGUTVPG CHAR(5)
GEFAHRGUTKCODE CHAR(5)
GEFAHRGUTBEZEICHNUNG CHAR(110)
GEFAHRGUTMENGE CHAR(9)
GEFAHRGUTBEGRENZTEMENGE CHAR(1)
GEFAHRGUTVERPANZAHL CHAR(10)
GEFAHRGUTVERPACKUNGSART CHAR(8)
GEFAHRGUTNEBENGEFAHR CHAR(20)
GEFAHRGUTBUCHST640 CHAR(1)
GEFAHRGUTMENGENEINHEIT CHAR(2)
GEFAHRGUTBEFOERDKAT CHAR(10)
GEFAHRGUTFAKTOR CHAR(10)
GEFAHRGUTNETTOEXPLMASSE CHAR(9)
GEFAHRGUTTUNNELBCODE CHAR(10)
GEFAHRGUTFREIGESTMENGE CHAR(1)
GEFAHRGUTFFCODE CHAR(20)
DELIVERYPOSITIONS STRUCTURE
ANZAHLPOSETIKETTEN CHAR()
ARTIKELBTNNR CHAR(25)
ARTIKELEAN CHAR(20)
ARTIKELEINHEIT CHAR(10)
ARTIKELGEWICHT CHAR(9)
ARTIKELMENGE CHAR(9)
ARTIKELSOLLMENGE CHAR(9)
ARTIKELTEXT1 CHAR(100)
ARTIKELTEXT2 CHAR(100)
ARTIKELTEXT3 CHAR(100)
ARTIKELTEXT4 CHAR(100)
ARTIKELWAEHRUNG CHAR(3)
ARTIKELWERT CHAR(9)
CHARGEFLAG CHAR(1)
KUNDENARTIKELNR CHAR(50)
KUNDENBESTELLNR CHAR(50)
POSAUFTRAGNR CHAR(50)
POSITIONNR CHAR(40)
POSLIEFERNR CHAR(40)
SERIENNR CHAR(30)
URSPRUNGLAND CHAR(2)
ARTIKELGRUPPE CHAR(50)
ARTIKELSERVICES CHAR(100)
ARTIKELVOLUMEN CHAR(9)
EXPORTING
PACKSTUECKRUECK STRUCTURE
TRACKINGNR CHAR(35)
VERSANDSENDUNGSNR CHAR(20)
DRUCKDATETIME CHAR(10)
AUSGANGDATETIME CHAR(10)
GEBUEHR CHAR(19)
GEBUEHRWAEHRUNG CHAR(3)
FEHLERTEXT1 CHAR(200)
FEHLERTEXT2 CHAR(200)
}
FAQ / Troubleshooting
Destination über SM59 definieren
Zur Einrichtung einer RFC-Verbindung im SAP, welche für die Anbindung des HVS32 Versandsystems gedacht ist, gehen Sie bitte wie folgt vor:
- Wechseln Sie zur Transaktion sm59
- Wählen Sie den Typ T (TCP/IP connections) [Abb.1]
- Erstellen Sie mit dem Button "create" eine neue Verbindung
- Geben Sie eine RFC Destination an (z.B. "RFC_HVS32")
- Stellen Sie den Aktivierungstyp auf "Registriertes Serverprogramm"
- Legen Sie eine Programm ID fest (z.B. "HVS32") [Abb.2]
- Öffnen Sie den Reiter "MDMP & Unicode"
- Stellen Sie dort die Art der Kommunikation auf "Unicode" [Abb.3]
- Speichern Sie die Einstellungen
- Sie können die Verbindung über "Connection Test" prüfen, sobald auf dem Zielsystem der DataGatewayServer installiert und als Dienst gestartet ist [Abb.4]