a

SAP-Alias.

b

RFC-Name.

c

(optional) Name der Map, die die Eingangsparameter enthält. Default: default. Siehe Unterabschnitt Füllen der Parametermap c vor dem Aufruf.

d

(optional) Zeit in Sekunden, auf die auf eine Antwort gewartet wird. Zeiten kleiner drei Sekunden werden ignoriert. Default: 60

e

(optional) Kommaseparierte Liste der Feld- und Tabellennamen und optionalen Indizes, auf die die Rückgabe der Funktion beschränkt sein soll. Default: Keine Ausgabefilterung. Siehe Unterabschnitte Ausgabefilterung durch Parameter e (es können auch ABAP-Exceptions bzw. die gesamte Response im Format SAPXML ausgegeben werden).

f

(optional) Mit diesem Parameter können die Antwortwerte zusätzlich (zum Rückgabewert der Funktion) in eine Named List oder ein XML-Objekt geschrieben werden. Bleibt der Parameter leer, wird beides nicht getan.

Um zusätzlich in eine Liste zu schreiben, geben Sie hier einfach deren Namen an. Die Liste wird dann automatisch erzeugt (bzw. geleert, falls schon vorhanden). Die Ergebniszeilen werden in das Listen-Objekt eingefügt. Dabei wird auch der Filter e angewendet. Der Rückgabe-Zeilen der Funktion und der Inhalt der Liste sind also gleich.

Um zusätzlich in ein XML-Objekt zu schreiben, verwenden Sie vor dem Namen bitte das Präfix :xml: (exakt so geschrieben und ohne Leerzeichen zwischen Präfix und Namen). Das XML-Objekt wird automatisch erzeugt und enthält die gesamte Response des RFCs. Filter e wird dabei nicht angewendet! Die Auswertung der RFC-Response im XML-Objekt können Sie mit den Funktionen select nodes from XML/DOM to List( a, b, c, d, e ) und get value from XML( a, b, c, d, e ) durchführen. Hinweis: Die XML-Struktur im XML-Objekt ist mit der XML-Struktur der Debug-Datei *_debug_RfcOut.xml identisch, die unter Verwendung des Parameters g als lokale Debug-Datei geschrieben werden kann.

g

(optional) true, wenn ein Trace des Aufrufs erstellt werden soll. Default: false. Die Namen der erzeugten Tracedateien werden im Log von Lobster_data hinterlegt. Dateinamen-Format: <Jobnummer>_<Timestamp>_debug_<RFC-Name>_<In|Out>.xml, wobei bei einem Mappingtest statt der Jobnummer der Wert T verwendet wird. Die Dateien landen im Ordner ./debug/sap. Wichtiger Hinweis: Selbst wenn der Parameter auf true gesetzt wird, erfolgt das Tracing nur in einem Mapping-Test oder wenn das Tracing für Phase 3 des Profils (oder systemweit) aktiviert wurde. Will man die Debug-Dateien immer schreiben (z. B. in der Probephase als Nachweis für das SAP-Team), also auch in einem normalen Job-Lauf und ohne das Tracing in Phase 3 (mit entsprechendem Overhead), kann man auch den Wert always angeben. Warnung: Diese Dateien werden nicht automatisch gelöscht, es liegt also in der Verantwortung des Benutzers diesen Ordner zu überwachen und Dateien manuell zu löschen, um einen Festplattenüberlauf zu verhindern. Beachten Sie bitte auch, das eine hohe Anzahl von Dateien in diesem Ordner die Performance beeinträchtigen kann.

h

(optional) Token-Liste (Trennzeichen Semikolon) der ABAP-Exceptions, die ignoriert werden sollen.

i

(optional) Rückgabewert bei einer ignorierten Exception (siehe h).

j

(optional) Die zu verwendende RFC-Queue. Wird der Parameter leer gelassen, wird die Default-Queue verwendet.

Warnung: Wird ein JCoContext verwendet (siehe Parameter k), wird eine definierte Queue ignoriert!

k

(optional) JCoContext erzeugen (true/false). Default: <empty>. Einschränkung: Der JCoContext steht nur für Verbindungen mit JCo-Version 3 zur Verfügung. Für Aliase mit JCo-Version 2.x erfolgt ein Fehlerabbruch, wenn k=true gilt.

Wenn ein Aufruf mit k=true erfolgt, wird für den Alias a ein JCoContext erzeugt, der bis zum Ende der Phase 3 dieses Profil-Jobs (oder bis zu einem Fehlerabbruch) besteht. Lediglich mit explizitem k=false kann man einen weiteren Aufruf aus einem bestehenden JCoContext herausnehmen (ein leerer Parameter k beendet den Kontext nicht!). Solch ein Kontext wird für (stateful) BAPI-Aufrufe (Business Objects in SAP) benötigt. Alle BAPI-Aufrufe müssen im selben JCoContext erfolgen, weil sie zusammenhängend sind. Alle Aufrufe zusammen werden dann am Ende committed (BAPI_TRANSACTION_COMMIT). Wenn kein Commit ausgeführt wird bis zum Ende des JCoContexts, werden die innerhalb des JCoContexts an SAP geschriebenen BAPI-Daten verworfen.

Normale RFC-Aufrufe müssen nicht committed werden, daher hat dort der JCoContext keine Bedeutung und sollte auch nur für sequenzielle BAPI-Aufrufe erzeugt werden, da er sehr ressourcen-aufwendig ist. Allerdings können Sie in einem bestehenden JCoContext auch normale RFCs aufrufen werden. Beachten Sie dann aber, dass diese nicht zurückgerollt werden bei einem nicht erfolgten Commit, weil sie auch ohne diesen funktionieren!

Warnung: Wenn der JCoContext erzeugt wird, wird eine eventuell in Parameter j definierte Queue ignoriert!

Hinweis: Im ersten Funktionsaufruf kann der Wert true auch in Großbuchstaben geschrieben werden (TRUE). Dann wird die JCoDestination für diesen Job geclont und zum Beginn ein RFC_PING zum Test der Verbindung ausgeführt.