Kontakt

Ansicht
Dokumentation

DP_CREATE_URL - Erzeugt einen temporären URL der auf eine interne Tabelle zeigt

DP_CREATE_URL - Erzeugt einen temporären URL der auf eine interne Tabelle zeigt

Fill RESBD Structure from EBP Component Structure   TXBHW - Original Tax Base Amount in Local Currency  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Erzeugt einen temporären URL mit Namensraum SAPR3:// für den Zugriff auf eine interne Tabelle. Der URL kann nur innerhalb des Prozeßraums des SAPGUI aufgelöst werden und in einem WebBrowser Control welches über URL Moniker arbeitet oder über den DataProvider angesprochen werden.

Parameter :

  • Size ist die Größe des BLOBs in Byte. Wird dieser Parameter nicht angegeben, wird die Größe aus der Anzahl der Zeilen * Breite der Tab. berechnet.
  • Url ist der Url unter dem die Daten vom DataProvider Objekt am Client erreicht werden können (vergl. DataProvider.SetDataFromUrl)
  • Date und Time haben noch keine Bedeutung.
  • Description hat keine Bedeutung
  • LifeTime steuert die Lebendauer der URL am CLient. Gültige Werte sind der Dokumentation des Parameters zu entnehmen.
  • Data ist eine interne Tabelle, welche die eigentlichen Daten enthält.
  • Fields und Properties sind nur für den internen Gebrauch.

Zusätzlich wird DP_CREATE_URL immer verwendet um Daten des DataProvider an den Client zu senden. Diese Daten können sowohl typisierte als auch nicht typisierte, BLOB artige Tabellen sein. Die ensprechenden Tabellen sind danach am Client ausschließich über ein DataProvider Objekt erreichbar. Diese From sollte allerdings nur in Ausnahemfällen verwendet werden. Ansonsten stehen andere Funktinsbausteine zur Verfügung (vergl. DP_SEND_STREAM, DP_CONTROL_ASSIGN_STREAM, DP_SEND_TABLE, DP_CONTROL_ASSIGN_TABLE).

Parameter :

  • Fields enthält eine interne Tabelle vom Type RFC_FIELDS. Diese beschreibt die Struktur der Tabelle DATA. FIELDS ist nur notwendig, wennDATA eine typisierte Tabelle ist. Wird keine FIELDS übergeben, werden die Daten als BLOB interpretiert. Sämtliche Strukturinformation der Tabelle geht dann am Client verloren. Um die Tabelle FIELDS zu füllen, kann der FB DP_GET_FIELDS_FROM_TABLE verwendet werden. Dieser analysiert die Tabelle und füllt FIELDS. Feldnamen und der Tabellenname gehen dabei allerdings verloren.
  • Properties enthält ein Propertybag vom Type DP_PROPS. Dieses Propertybag kann zusätzlich Attribute des Datenobjekts transportieren.

Beispiel

data : html_ctrl type cntl_handle.

data : url(256).

data: begin of tab occurs 0,

text(256),

end of tab.

perform create_html_control using html_ctrl.

...

perform create_html_page using tab.

...

CALL FUNCTION 'DP_CREATE_URL'

EXPORTING

TYPE = 'text' SUBTYPE = 'html'

TABLES

DATA = html_table

CHANGING

URL = URL

EXCEPTIONS

DP_INVALID_PARAMETER = 1 DP_ERROR_PUT_TABLE = 2 OTHERS = 3.

IF SY-SUBRC EQ 0.

CALL FUNCTION 'CONTROL_CALL_METHOD'

EXPORTING

H_CONTROL = html_ctrl METHOD = 'Navigate' P_COUNT = 1 P1 = url.

Hinweise

Für alle Controls, die nur über URLs arbeiten und damit eine einheitliche Schnittstelle sowohl für R/3 basierte Daten als auch andere Datenquellen (http:, ftp: file:) zur Verfügung stellen, sollten auch eine Methode implementieren, um den Aufruf von DP_CREATE_URL zu verschalen. Dieser FB ist sehr generisch und träg in den meisten Fällen zuviele Parameter für ein spezielles Anwendungsszenario.





Parameter

CACHEABLE
COLUMNS_TO_STRETCH
DATA
DATE
DESCRIPTION
FIELDS
FIELDS_FROM_APP
LIFETIME
PROPERTIES
SEND_DATA_AS_STRING
SIZE
SUBTYPE
TIME
TYPE
URL

Ausnahmen

DP_ERROR_GENERAL
DP_ERROR_PUT_TABLE
DP_INVALID_PARAMETER

Funktionsgruppe

CNDP

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   Fill RESBD Structure from EBP Component Structure  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 6181 Date: 20240523 Time: 141045     sap01-206 ( 97 ms )