Füllen der Parametermap c vor dem Aufruf

Die Funktion erwartet Schlüssel-Werte-Paare in einer bestimmten Notation, damit sie dem jeweiligen Parametertyp im RFC zugewiesen werden können.

Enthält ein Wert in der Map eine Zeichenkette der Art @Variablenname@ wird nach einer Variable mit dem angegebenen Namen gesucht und - sofern vorhanden - der Platzhalter durch den Wert ersetzt. Existiert keine solche Variable, wird der Platzhalter unverändert als Parameter im Aufruf verwendet.

Zur Vereinfachung des Füllens der Parametermap c kann die Funktion fill-map-from-fields( map a, prefix b, index c, hidden d ) genutzt werden.

Bei Strukturen und Tabellen muss beachtet werden, dass die Komponenten (Feldnamen/Spaltennamen) nicht optional sind. Wenn bei einem Strukturtyp eine Komponente angegeben wird, müssen alle anderen Komponenten dieser Struktur ebenfalls definiert werden, gegebenenfalls mit leerem Wert oder dem Default 0 bei numerischen Typen. Bei Tabellen stellt jede Zeile einen Strukturwert dar. Demzufolge müssen auch dort alle Komponenten einer Zeile definiert sein. Bei Tabellen ist weiterhin zu beachten, dass die Zeilennummern lückenlos sein müssen, um einen vorfristigen Abbruch der Parameterliste zu vermeiden.
Falls die Parametermap c mit der Funktion fill-map-from-fields( map a, prefix b, index c, hidden d ) gefüllt wird, müssen in der Zielstruktur des Profils bei Strukturen und bei Tabellen alle Komponenten als Zielfeld definiert sein. Um auch das Einfügen leerer Felder zu erzwingen, muss dort zusätzlich mit der Processing Anweisung val:addempty gearbeitet werden, wie es in der Dokumentation dieser Funktion beschrieben ist.

Nach dem RFC-Aufruf werden im Ergebnis Felder, Strukturen und Tabellen in der gleichen Weise zurückgegeben, wie dies beim Aufruf des RFCs über den zeitgesteuerten Eingangsagenten des Typs SAP geschieht, wenn dort als Format FixRecord ausgewählt wurde. Ein Beispiel ist am Ende dieses Dokuments.

Ausgabefilterung durch Parameter e

Um nur einzelne Felder oder komplette Zeilen einer Tabelle in das Ergebnis aufzunehmen, reicht die Angabe des Feld- bzw. Tabellennamens, z. B. QUERY_TABLE,DATA als Parameter e. Will man nur einen Teil des jeweiligen Wertes, ist es möglich, Teiltextbereiche anzugeben, die für die Zusammensetzung der Ergebniszeile verwendet werden sollen. Diese sind im Format Name[Indexdefinition] oder Name[Indexdefinition} anzugeben, wobei der Zeilenanfang mit Index 1 repräsentiert wird. Geschweifte Klammer am Ende bewirkt ein Entfernen von nachfolgenden Leerzeichen nach dem Durchführen der Teiltextermittlung. Eine Indexdefinition folgt dem Format [vonIndex] oder [vonIndex+länge] oder [vonIndex-bisIndex]. Der bisIndex gilt exklusive, wird er weggelassen, wird das Ende der Zeile genommen. Mehrere Indexdefinitionen können mittels Slash / zusammengesetzt werden.

Im Folgenden seien Varianten von Angaben aufgezeigt. Alle beziehen sich auf eine beispielhafte Zeile (Leerzeichen wurden durch Unterstriche ersetzt).

Falls eine Liste in f angegeben wurde, wird das Ergebnis des erfolgreichen Funktionsaufrufs in gleicher Weise und Reihenfolge in dieser Named List gespeichert, sowie als Rückgabewert der Funktion geliefert. Im Rückgabewert sind die einzelnen Datensätze durch eine Zeilenschaltung getrennt, während in der Named List jeder Ergebnis-Datensatz ein einzelner List-Eintrag ist.

RFC_READ_TABLE

Füllen der Parametertabelle

Die Felder in den jeweiligen Knoten sind genauso benannt wie die Feldnamen in den jeweiligen Parameterelementen (hier Felder und Tabellen, alles was nach einem # im Namen folgt, wird ignoriert).

Ziel in diesem Beispiel ist die Menge der gelesenen Felder auf eine Teilmenge der möglichen zu reduzieren. Dies wird über eine Liste realisiert, die im Feld prepareFieldSelection vorbereitet wird.

Pro Durchlauf des Knotens fill_FIELDS wird dann das jeweils erste Element aus oben genannter Liste entfernt.

Im folgenden seien die Funktionen der einzelnen fill-Felder gezeigt.

In Feld fill_INPUT:

In Feld fill_option_table:

In Feld fill_fields_table:

dumpParamsKeys dient nur dem Zweck, die Parameter-Schlüssel und Werte im Log des Mappingtests auszugeben. Damit das im produktiven Lauf nicht geschieht, wird die System-Variable VAR_IS_TEST abgeprüft.

Das Feld callRFC enthält den eigentliche Funktion für den Aufruf des RFCs.

RFC-Aufruf

Beim Starten des Tests erscheint als Ergebnis der Funktionen in dumpParamKeys in diesem Fall folgende Meldung.

Aus technischen Gründen ist die Reihenfolge der Schlüssel-Wert-Paare nicht sortiert.

Der Aufruf der Funktion call-sap-rfc liefert folgende Ausgaben.

Da Parameter g fix auf true gestellt ist, werden Debug-Trace-Dateien angelegt, deren entsprechende Dateinamen angezeigt werden. Da eine Ausgabeliste angegeben ist, in der die Werte der Ausgabetabelle DATA geschrieben werden, kann der Rückgabewert der Funktion selbst - eine Fixedrecordausgabe der DATA-Tabelle getrost ignoriert bzw. für die Fehlersuche genutzt werden.

Ergebnisauswertung

Im vorliegenden Beispiel wurden die Werte aus der Ergebnistabelle DATA in die Liste outList geschrieben. Jedes Element in der Liste entspricht hierbei einer Zeile der Tabelle DATA. Die Werte der einzelnen Felder müssen hierbei selbst aus dem Text "extrahiert" werden.

Im Beispielprofil erfolgt dies im Knoten OUTPUT.

Damit der Knoten OUTPUT so oft betreten wird, wie es Einträge in der Liste gibt, wird im Feld readSize die Anzahl in eine Integer-Variable geschrieben und diese als Pfad im Knoten OUTPUT verwendet. Das Berechnungsfeld item entfernt immer den ersten Eintrag in der Liste outList mit der Funktion remove from list an Position 1, alle nachfolgenden Felder verwenden diesen Wert dann immer mittels "Zielwert: item". Wird unter Nutzung von Parameter e mehr als ein Feld oder eine Tabelle angegeben, die in die Antwort gepackt werden soll, muss zwischen den einzelnen Ergebniszeilen unterschieden werden. Daher ist - auch wenn dies im konkreten Beispiel nicht notwendig ist - eine Funktion auf den Knoten OUTPUT gelegt.

Ist die Bedingung erfüllt, wird der Knoten betreten und die Zeile im Berechnungsfeld data_item um 30 Zeichen von links gekürzt, um die eigentlichen Datenfelder ab Index 1 zu erreichen.

Alle nachfolgenden Felder holen sich erst den für sie relevanten Teilstring mittels substring( a, start [,length] ) und fahren dann unter Umständen mit weiteren Funktionen mit der Konvertierung der Daten fort, wie exemplarisch am Feld FLDATE gezeigt werden soll.

Ein beispielhaftes Ergebnis eines OUTPUT-Knotens kann wie folgt aussehen.