Connector für SAP Business Suite - Entwicklerhandbuch Anhang

Verbindung zum SAP-System aufbauen

Verbindung zum SAP-System abbauen

BAPI/RFC-Funktion laden

BAPI/RFC-Funktion ausführen

BAPI/RFC-Funktion beenden

Import-Parameter in den Fokus nehmen

Import-Struktur in den Fokus nehmen

Import-Tabelle in den Fokus nehmen

Export-Parameter in den Fokus nehmen

Export-Struktur in den Fokus nehmen

Export-Tabelle in den Fokus

Tabelle aus Tabellenparameter in den Fokus nehmen

Feld aus der aktuellen Struktur in den Fokus nehmen

Feld aus der aktuellen Tabelle(nzeile) in den Fokus nehmen

Anzahl der Tabellenzeilen der aktuellen Tabelle ermitteln

Alle Tabellenzeile der aktuellen Tabelle als Menge

Setze den Fokus auf eine Zeile in der aktuellen Tabelle

Eine neue Zeile der aktuellen Tabelle hinzufügen

Setze den Wert des aktuellen Parameters/Feldes als String

Setze den Wert des aktuellen Parameters/Feldes als Double

Ermittle den Wert des aktuellen Parameters als String

Fehlermeldungen zurücksetzen

Letzte Fehlermeldung als String ermitteln

Prüfe eine existierende Verbindung zum SAP-System "p_instance" im Anmeldemodus "p_loginmode". Falls "p_connect = true" und noch nicht verbunden, wird eine Verbindung aufgebaut.

Eine Verbindung zum SAP-System "p_instance" schließen

Eine SAP Verbindung zum SAP System p_instance des Anwenders schließen

Eine Verbindung zum SAP-System "p_instance" aufbauen

Eine Benutzerverbindung zum SAP-System "p_instance" mit Benutzer/Passwort aufbauen

Die Anmeldeinformationen via Token für ein SAP-System manuell setzen. Das Token (z.B. SSO Ticket) enthält Parameter "p_token". Abhängig von der Art des Tokens muss der Parameter "p_method" gesetzt werden (z.B. "MYSAPSSO2" für SSO-Ticket)

Die Anmeldeinformationen Benutzer/Password für einen Benutzer der aktuellen Session manuell setzen

Die Anmeldeinformationen für einen Anwender zurücksetzen (z.B. SSO-Ticketinformationen, für Benutzerwechsel)

Das Einbinden dieser Funktion im Velocity ermöglicht das Verwenden von SAP-Oberflächen auf der verwendenden Seite. Es werden SSO-Initialisierungen durchgeführt und beispielsweise SSO-Javascript-Funktionen bereit gestellt. Der Parameter "p_request" erwartet die Übergabe des Velocity-$Request-Objektes. Durch das Flag "p_mapurl" wird das Mapping von SAP-URLs gesteuert.

Die Verwendung dieser Funktion im Velocity bindet eine SAP-Weboberfläche als iFrame ein. Der Aufruf setzt die Funktion "ssoPrepare" auf der gleichen Seite voraus, um die notwendigen Javascript-Funktionen (z.B. SAP-Ticket setzen, URL-Mapping initialisieren). Das URL-Mapping wird über das aktive Flag "p_mapurl" aktiviert.

Diese Funktion ermöglicht das Login ins Intrexx-Portal über eine Intrexx-Seite (anonym). Ist das Login erfolgreich, wird eine Session-ID zurück gegeben.

Startet die SAPGUI für die angegebene SAP-Datenquelle als Transaktion im gegebenen Loginmodus (meist "user"). Zusätzliche Parameter (z.B. zu füllende Felder) werden in "p_extra" mitgegeben. Mit "p_skip = "true"" kann der Startscreen übersprungen werden. Das Flag "p_url" steuert, ob eine Auswertung der Portal-URL notwendig ist (z.B. abweichende SAP-Router-Strings). Dazu musste die Seite aber mit "ssoPrepare" im Velocity initialisiert worden sein.

Wie function "biasap_start_transaction_url" ohne URL-Auswertung

Startet einen Report im angegebenen SAP-System mit oder ohne Variante. Das Flag "p_url" steuert das Anpassen des Pfades zum SAP-System über die Portal-URL.

Wie "biasap_start_report_url" ohne URL-Auswertung

Setze ein Cookie (z.B. für SSO)

Ermittle ein Cookie

Lösche ein Cookie

Setze das SSO Ticket für SAP-Weboberflächen. Ist die Ermittlung eines gültigen SSO-Tokens nicht möglich und eine Fehlermeldung über "p_message" verfügbar, wird diese Fehlermeldung angezeigt. Der Parameter "p_cancel_on_error" steuert, ob ein fehlerhaftes Ticket die Verarbeitung des Skripts und auch der Folgeskripte (z.B. bei Schaltflächen) abbrechen soll (Effekt: keine Anzeige der SAP Weboberfläche bei falschem Ticket).

Die Methode initialisiert die SAP-OCI Funktionen des Connectors für SAP Business Suite. Diese Methode ist zur Einbindung auf einer Ansichtsseite gedacht (Velocity). Übergeben werden die aktuelle Session und der Request. Der dritte Parameter legt das zu verwendende Autorisierungsverfahren fest. Voreingestellt ist "PlainAuth", das im Portal konfiguriert sein muss. Mit den übergebenen Parametern wird eine Anmeldung am Portal durchgeführt und die empfangenen Parameter auf Gültigkeit für SAP-OCI geprüft. Das Ergebnis ist boolean. Hat es den Wert "true", so war die Anmeldung erfolgreich. Mit dem Wert "false" war die Anmeldung entweder nicht korrekt oder die übergebenen Parameter sind für SAP-OCI nicht gültig.

Diese Funktion prüft, ob eine gültige SAP-OCI-Session aktiv ist. Verwenden Sie diese Funktion, um in der Applikation z.B. Sprungziele anzupassen, wenn die Applikation nicht nur für SAP-OCI-Szenarien verwendet wird.

Diese Funktion gibt einen HTML-Text zurück, der die aktuellen OCI-Informationen enthält. Verwendet werden kann die Funktion für die schnelle Darstellung der technische OCI-Informationen.

Mit dieser Funktion kann ein bestimmter Wert aus den OCI-Daten ermittelt werden. Mit "$!GSAP.ociGetInfo("vendor")" kann z.B. die Lieferantennummer ausgelesen und als Vorschlagswert für Eingabefelder verwendet werden. Mögliche Werte für "p_info" sind:

• sapuser
  

  Technischer Name des angemeldeten SAP Benutzers

• login
  

  Anmeldename am Portal

• domain
  

  Anmeldedomäne am Portal

• customer
  

  Kundennummer des Einkaufenden beim Lieferanten

• vendor
  

  Lieferantennummer beim Einkäufer

• oci_version
  

  OCI-Version

• opi_version
  

  OPI-Version

Setzt die Rücksprungadresse nach dem Senden. Es wird die Übergabe einer Schaltfläche erwartet.

Erzeugt die wichtigsten Transferdaten für eine Warenkorbposition (der Zeile "row")

Erzeugt weitere Daten für eine Warenkorbposition. In "name" wird der technische Name der OCI-Spezifikation erwartet (z.B. "VENDORMAT")

Erzeugt einen Langtext zur Position

Erzeugt ein sonstiges Transferfeld unter Angabe des technischen Namens

Zum Starten der SAPGUI aus dem Portal heraus

Diverse Javascripts mit Utility-Funktionen

Anpassung der Zeitzone für Zeitstempelfelder. SAP-Systeme laufen oft in der Zeitzone CET, Intrexx auf dem Server in UTC. Dadurch kommt es bei der Darstellung von Uhrzeiten zu Verschiebungen. Die Zeitzone sollte aber eher in der Konfiguration der Datenquelle vorgenommen werden (Attribut in der Datei sap.cfg).

Loginmodus für den SAP-Zugriff (<system>|<user>|<mixed>)

Handler für den SAP-Zugriff (z.B. "GENERIC_VIEW", "DEVELOPER_API")

Variante des SAP Handlers (z.B. "DEFAULT"). Kann für eine abweichende Ermittlung des SAP-Datenhandlers verwendet werden

Möglichkeit, steuerende Parameter an den SAP Handler zu übertragen. Die Werte stehen im SAP-Datahandler in der CONTROL-Struktur zur Verfügung.

Möglichkeit, das Debugging nur für die betreffende Fremddatengruppe zu aktivieren. "True" aktiviert das Debugging. Ein SAP-Debugging ist nur mögloch, wenn das Portal auf dem eigenen Rechner läuft und ein SAPGUI installiert ist.

Mit diesem Parameter (aktiv = "true") kann für Tabellenzugriffe gesteuert werden, dass keine Daten ermittelt werden, wenn kein Filter aktiv ist. Damit wird verhindert, dass bei ausgeblendeten Tabellen in Zusammenhang mit dynamischen Filtern ein Zugriff in das SAP-System erfolgt.

Aktiviert das Trace für diese Datengruppe. Dadurch finden sich hier erweiterte Meldungen in der Logdatei.

Enthält eine Angabe darüber, welche Version der Businesslogik vorausgesetzt wird, um vorab Fehler zu vermeiden (Nutzung neuer Features).

Bei SAP-Datengruppen mit komplexen Schlüssel (z.B. VBAP) wird hier vereinfacht nur eine Zählung von 1...n als Schlüssel verwendet. Ein Sprung auf eine Detailseite ist so nicht möglich. Allerdings kann diese Option den Zugriff auf die Zellen innerhalb von Frei gestalteten Ansichtstabellen vereinfachen.

Ist diese Option aktiviert, werden die Daten auf dem Server gecacht. Ändern sich die Daten im SAP-System, werden im Portal trotzdem nur die alten Daten angezeigt. Die Option eignet sich vor allem für Customizingtabellen, die als Referenzen verwendet werden (Performance). Der serverseitige Cache kann durch Trennen der Verbindung zum SAP zurückgesetzt werden.

Diese Option ist nur relevant in den Datahandlern der Developer-API. Bei neuen Datensätzen würde die SAP-API-Methode "Get_Detail" normalerweise nicht aufgerufen werden. Dies kann aber durch diese Option erzwungen werden, um Werte aus SAP vorzubelegen.

Diese Option ist ebenfalls nur relevant innerhalb der Developer-API. Neue Datensätze erhalten von Intrexx generell die ID -1. Durch diese Option wird dieser vorgegebene Schlüssel gelöscht. Im SAP wäre er damit mit "if iv_key eq space" abfragbar.

Diese Option aktiviert alternativ zur entsprechenden bia-variant, dass in SAP nicht automatisch die Texttabelle ermittelt wird. So können Problemfälle wie die Tabelle MARA mit vernünftigem Aufwand im Portal angezeigt werden.

Diese Option aktiviert, dass bestimmte Daten als HTML-Code übergeben werden statt als normaler Text. Dieses Option wird beispielsweise im Data Handler "Generic Report" verwendet, um einen SAP-Report in den SAP-typischen Farben zu übertragen.

Diese Option aktiviert die Übertragung von längeren Texten als Langtext statt in mehreren Zeilen. Verwendet wird diese Option im Datahandler "Generic Report". Der Report wird dann nicht mehr zeilweise übertragen und muss als frei gestaltete Tabelle dargestellt werden. Ein Stringfeld enthält mit dieser Option den gesamten Report.

Diese Option aktiviert ein automatisches Mapping bei SAP-typischen numerischen Schlüsseln. Über die mitgegebene Länge weiß die Logik des Connectors für SAP Business Suite, dass dieses Feld bei der Übertragung zu SAP automatisch um führende Nullen ergänzt werden muss (Ausnahme alphanumerische Schlüssel). Bei der Darstellung im Portal werden diese Felder ohne führende Nullen dargestellt. Wird diese Option auf Datengruppenebene eingesetzt, wird automatisch der Schlüssel als numerische SAP-ID behandelt.

Diese Option versucht das Problem zu lösen, dass im SAP meistens keine Zeitstempel, sondern getrennte Felder für Datum und Zeit verwendet werden. Intrexx hingegen verwendet Zeitstempel und kann diese zusätzlich als "nur Datum" oder "nur Zeit" darstellen. Über diese Option wird dem Datenfeld des SAP-Systems mitgeteilt, welches SAP-Feld die zugehörige Uhrzeit enthält. Das SAP-Datumsfeld wird dadurch zum Zeitstempel und kann auch so verwendet werden (z.B. in Kalenderkontrollen). Bei der Darstellung von Uhrzeiten kommt es oft zu Verschiebungen der Uhrzeit (z.B. 2h). Das liegt daran, dass SAP-Server und Portal in unterschiedlichen Zeitzonen laufen (CET vs UTC). Deshalb kann an der Datenquelle oder über bia-timezone die SAP-Zeitzone konfiguriert werden. Dieses Verhalten sollte auch umgekehrt (schreiben von Zeitstempeln in zwei getrennte SAP-Felder) funktionieren. Das Feld für das SAP-Datum ist hier wieder führend. Das zugehörige Zeitfeld muss aber evtl. (versteckt) auf den Seiten verfügbar sein.

In SAP-Systemen werden oft Kodierungen benutzt (typische Charakter 1...6 Felder; z.B. VBAK-VBTYP). Diese werden als Text – also als SAP-Code – übertragen und sind für die Anwender so nicht verwendbar. Es besteht natürlich die Möglichkeit, die entsprechenden Customizingtabellen sprachabhängig als Referenz anzubinden. Dadurch entsteht aber unter Umständen viel Aufwand. Eine einfache Möglichkeit stellt diese Option zur Verfügung: der Datahandler "Generic View" versucht hier, aus der konfigurierten Suchhilfe bzw. anderen SAP-Mechanismen, geeignete Texte zu ermitteln. Dieses Verfahren ist nicht überall möglich (z.B. komplexere Suchhilfen mit mehreren Schlüsseln).

Mit dieser Option können URLs unter Berücksichtigung der Portal-URL gemappt werden. Dies wird z.B. zum Verstecken der realen URL auf SAP-Systemen (Aufruf von Archivdokumenten) benötigt. Ein interner Zugriff kann so von "sapsystem.internesicht.net" auf "archiv.externesicht.com" gemappt werden, sobald der Anwender den externen Zugriff auf das Intrexx-Portal verwendet.

Wandelt den Wert in Großbuchstaben um. Einsatz in SAP-Matchcode-Feldern sinnvoll.

Data Browser: Anzeigen von Tabelleninhalten

Dictionary: Anzeigen von technischen Informationen zu Dictionary-Objekten (z.B. Tabellen, Views)

Implementierungsleitfaden: Zentrales SAP-Customizing

Tabellenpflege von Konfigurationstabellen

RFC-Destinationen pflegen: Zugriff auf externe Systeme konfigurieren

Internet Connectivity: freigegebene Services

Dumpanalyse: Fehlersuche nach Abbrüchen

Systemlog: Fehlersuche bei Systemproblemen

Anwendungslog: Protokolle bei vielen Anwendungen

Datenaustausch mit externen Systemen mit qRFC und tRFC

Benutzerpflege

Pflege der Berechtigungsobjekte: u.a. mit Funktion "SAP_ALL" generieren

Rollen und Berechtigungen

Berechtigungstrace

Angemeldete Benutzer

Angemeldete Remote Systeme

ABAP-Workbench: Zentrale Entwicklungstransaktion

ABAP-Reports: Entwicklung und Start

Funktionsbausteine/BAPI: Entwickeln, Testen

BAPI-Browser