HVS32 Anbindung an SAP - Heidler Strichcode GmbH

eratung
planung
projektbetreuung
umsetzung
support
ein Versandsystem...
Anbindung
an SAP Systeme
www.heidler-strichcode.de
...das immer passt
benutzerfreundlich
multi-carrierfähig
modularer aufbau
flexibel

HVS 32 - Anbindung an SAP
Mit dem HVS32-Gateway des Heidler Versandsystems (HVS32) besteht die
Möglichkeit via Remote Function Call (RFC) mit einem SAP System zu kommunizieren.
Über einen solchen RFC können alle versandrelevanten Daten
ermittelt werden: z.B. Empfängerdaten, Frankaturen, Packstückdaten etc.,
sowie besteht die Möglichkeit auch Informationen wie Tracking-Nummer,
Gewicht, Gebühr, etc. an das SAP System zurückzumelden.
HVS32-Gateway:
Der SAP-Client ist ein Plugin des HVS32
Gateway, das zur Kommunikation mit
einem SAP – System via RFC (Remote
Function Call) dient.
Über einen RFC können folgende Aufga-
ben realisiert werden.
Datenanforderung: Lieferscheinkopf-
daten, Kundendaten, etc. diese werden
durch eine Referenznummer in der
Eingabemaske des HVS 32 Clients an-
gefordert.
Datenrückmeldung: TrackingNr, Gewicht,
Gebühr, etc. wird vom HVS32 an das
SAP-System zurück gemeldet.
SAP Client Plugin
Das HVS32 nutzt den SAP-Client für den
interaktiven Gatewaybetrieb. Daraus folgt,
dass der Funktionsaufruf immer durch das
Versandsystem angestoßen wird. Das
SAP-System kann bei diesem Plugin also
nicht der Auslöser für eine Verarbeitung
sein.
SAP Server Plugin
Für den Automatikpollingbetrieb besteht
die Möglichkeit das SAP-Server Plugin
einzusetzen. Dieses verfügt über die
Funktion sich am SAP-System zu registrie-
iren. Das SAP System hat nun die Möglich-
keit via RFC einen Paketschein zu erzeu-
gen.
Voraussetzungen
... ein Versandsystem das immer passt!
Der SAP-Client wurde mit Hilfe der RFC-Bibliothek von SAP realisiert und setzt deshalb
voraus, dass die dafür notwendigen SAP-Komponenten bereits auf dem PC installiert sind,
auf dem der Gateway zum Einsatz kommt. Ein SAP-GUI-Frontend bringt in der Regel
schon die notwendigen Komponenten mit sich und würde somit ausreichen.
SAP-Client
HVS32-Gateway
SAP-Server
Client
Seite 1

Das HVS32-Gateway wartet auf eine
Anfrage welches durch erfassen einer
Referenznummer z.B. Lieferscheinnum-
mer aktiv wird. Das SAP-Client Plugin des
Versandsystems untertützt diese Anfrage
am SAP System.
Für die Anfrage wird der dafür hinterlegte
RFC zunächst mit den Übergabepara-
metern laut der Schnittstellendefinition
befüllt (Für jede Art von Anfrage kann ein
separater RFC definiert werden).
Anschließend wird mit Hilfe der konfigu-
... ein Versandsystem das immer passt!
Funktionsweise des HVS32-Gateway
Das HVS32-Gateway befindet sich auf einem HVS32 Server welches mit dem SAP System per RFC
(remote function call) kommuniziert.
Anfrage
Suche im SAP System
via RFC
Packplatz
1,2,3,...n
Scannen der
LS Nummer
HVS32-Gateway
SAP / R3
rierten Logindaten eine Verbindung zum
SAP-System aufgebaut und die Funktion
mittels RFC aufgerufen.
Sobald das SAP-System mit der Ausfüh-
rung der Funktion fertig ist, werden die
Rückgabeparameter des RFC durch das
Gateway eingelesen und die Verbindung
zum SAP-System wieder geschlossen. Die
eingelesenen Parameter werden ab-
schließend an das HVS32 Versandsystem
weitergegeben, wo diese zum Beispiel als
Rückmeldung
Antwort aus SAP
Empfängeradresse angezeigt und weiter-
verarbeitet werden können.
Eine Musteranfrage vom Client zum
HVS32-Gateway ist unten als Beispielkon-
figuration dargestelt. In Zeile 7 wird die
Datei angegeben, in welcher sich die
vordefinierten Parameter des RFCs befin-
den.
Beispielkonfiguration
Konfiguration einer VersandDatenAnfrage zur Ermittlung von
Lieferscheindaten:
...
OFF
SAPClient
SapRfcVersandDatenAnfrage.xml
GatewayData
SAPClientGateway
...
Seite 2

RFC-Konfiguration
Für jede konfigurierte Gatewayfunktion muss eine XML-Datei vorhanden sein, in der
die Logindaten zum SAP-System und die Schnittstelle des RFC definiert ist. Folgend
ist der Dateiinhalt am Beispiel einer VersandDatenAnfrage.xml dargestellt, welche
über einen RFC Lieferscheinkopfdaten aus einem SAP-System ermittelt:
Beschreibung der Parameter
einer XML Datei:
destination
Schlüsselname für eine Verbindung, die in
der Datei saprfc.ini konfiguriert ist.
client
Client / Mandant im SAP-System mit dem
beim Aufruf gearbeitet wird.
user
Benutzer im SAP-System der für den Funktionsaufruf
verwendet wird. ACHTUNG:
Der verwendete Benutzer muss in der
Lage sein RFCs aufzurufen. Es gibt unterschiedliche
Arten von Benutzern, bei
denen unter Umständen kein RFC erlaubt
ist.
password
Passwort des zuvor genannten SAP-
Benutzers.
language
Sprache die auf Seite des SAP-System
verwendet wird. In der Regel wird hier E für
Englisch verwendet.
function
Name des Funktionsbausteins im SAP-
System, der via RFC aufgerufen wird.
trace
Mögliche Werte: 0 / 1
Deaktiviert/Aktiviert ein Tracelog der RFC-
Bibliothek. Näheres dazu befindet sich in
der Dokumentation des RFC-SDK.
exports
Unter exports werden die Parameter definiert,
die durch das Gateway an die SAP-
Funktion beim RFC übergeben werden.
... ein Versandsystem das immer passt!
HVS32TEST
110
RFC-HVS
heidler
E
ZBAPI_HEIDLER
1
imports
Hier sind die Parameter definiert, die durch
die SAP-Funktion an das HVS32-Gateway
zurückgeliefert werden.
parameter
Definiert einen Parameter innerhalb von
imports, exports, STRUCTURE-Parameter
oder einer table. Es können immer 1 bis n
Parameter hinterlegt werden.
Seite 3

RFC-Konfiguration
name
Durch das Attribut name wird der Name
festgelegt. Dieser muss mit dem jeweiligen
Feldnamen übereinstimmen, der aus oder
in das HVS32 gemeldet wird.
type
Zusätzlich muss über das Attribut typ: der
Datentyp des Parameters festgelegt sein.
Zur Auswahl stehen derzeit folgende
Datentypen:
CHAR = String mit fester Länge
NUMC = String mit ausschließlich
numerischen Zeichen
INT4 = 4 Byte numerische Ganzzahl
STRUCTURE = Struktur in der weitere
Parameter gekapselt sind. Bei der Definition
müssen diese als Unterknoten im XML
definiert sein. Die Parameter einer Struktur
werden im Gateway wie normale Felder
behandelt und können somit im HVS32 mit
Ihren Namen verwendet bzw.
angesprochen werden.
size
Bei den Datentypen CHAR und NUMC
muss außerdem über das Attribut size die
Länge des Parameters definiert sein.
table
Definiert eine Tabelle, die beim RFC
übertragen wird. Eine Tabelle kann 0 bis N
Datensätze enthalten. Die Felder der
Tabelle sind als “normale parameter” zu
definieren. Derzeit können Tabellen im
Gateway nur empfangen, nicht aber als
Übergabeparameter an eine SAP-
Funktion gesendet werden.
mapping
Über das Attribut mapping kann
festgelegt werden, wie die Daten der
Tabelle an das HVS32 weiterzuleiten
sind. Mögliche Werte sind:
first = Die Felder des ersten Datensatzes
werden wie normale Parameter
an das HVS32 übergeben.
Falls die Tabelle leer ist, sind die Felder
bei der Rückmeldung an das HVS32
definiert aber haben einen leeren Wert.
all = Für die Tabelle wird im
Rückmelde-XML an das HVS32 ein
Knoten eingefügt, der den Namen der
Tabelle trägt. Für jeden Datensatz der
Tabelle wird darunter ein RECORD-
Knoten geschrieben, der die einzelnen
Felder der Tabelle enthält.
... ein Versandsystem das immer passt!
saprfc.ini
In der saprfc.ini werden Parameter für
Verbindungen zu SAP-Systemen
konfiguriert. Diese Datei wird von der
SAP RFC-Bibliothek für den Verbindungsaufbau
benötigt. Nähere Informationen
zu dieser Datei sind der SAP-
Dokumentation zu entnehmen.
Beispiel für den Inhalt einer saprfc.ini:
DEST=HVS32TEST
TYPE=A
ASHOST=testsapserver
SYSNR=00
RFC_TRACE=0
ABAP_DEBUG=0
USE_SAPGUI=0
Debugprotokolle
SAPCG
Seite 4