Show TOC

Dokumentation zur KomponenteGUI_DOWNLOAD Dieses Dokument in der Navigationsstruktur finden

 

Lädt eine Datei auf den Client-Rechner herunter.

Argumente

[IMPORTING] bin_filesize TYPE I

Menge der übertragenen Daten. Diese Information muss angegeben werden, wenn die Daten im Binärformat übertragen werden.

Dies ist ein optionaler Parameter. Mögliche Werte:

  • >= 0

[IMPORTING] filename TYPE STRING

Name der Datei, in der Daten abgelegt werden sollen. Wenn kein Verzeichnisname angegeben wird, wird die Datei im aktuellen Verzeichnis abgelegt, d.h. in dem Verzeichnis, das in der letzten Dateioperation, die abgeschlossen wurde, verwendet wurde (-> siehe Hinweis 622128).

[IMPORTING] filetype TYPE CHAR10

Format, in dem die Daten übertragen werden sollen.

Mögliche Werte:

  • ASC

    Die Daten sollen als ASCII-Text übertragen werden. Die Daten werden nach Bedarf konvertiert

  • BIN

    Die Daten sollen unkonvertiert in Binärform übertragen werden

  • DAT

    Die Daten sollen unkonvertiert als ASCII-Text transportiert werden, wobei die verschiedenen Spalten durch Tabulatoren voneinander getrennt sind

  • DBF

    Die Daten sollen im dBase-Format übertragen werden, in dem die Datentypen der Daten in den verschiedenen Spalten in den gesendeten Daten enthalten sind

  • IBM

    Die Daten sollen als ASCII-Text in Codepage 1103 übertragen werden

  • VSS

    Die Daten sollen im ASCII-Format übertragen werden. Jede Zeile hat zwei Spalten, wobei die erste Spalte ein Längenfeld für den Text der zweiten Spalte darstellt

  • WK1

    Die Daten sollen im Lotus-1-2-3-Format übertragen werden

[IMPORTING] append TYPE CHAR01

Kennzeichen, das anzeigt, ob die Daten an eine vorhandene Datei angehängt werden sollen.

Mögliche Werte:

  • ' '

    Die Daten sollen nicht an eine vorhandene Datei angehängt werden Wenn eine Datei mit dem angegebenen Namen vorhanden ist, werden die Daten in dieser Datei überschrieben

  • 'X'

    Die Daten sollen an die Daten einer vorhandenen Datei angehängt werden Es wird eine neue Datei angelegt, wenn keine Datei mit diesem Namen vorhanden ist

[IMPORTING] write_field_separator TYPE CHAR01

Zeigt an, ob ein Tabulatorzeichen zwischen den Spalten der übertragenen Daten eingefügt werden soll. Dieses Kennzeichen kann zusammen mit den ASCII-Übertragungsarten ASC, DAT und IBM verwendet werden. Dieses Kennzeichen wird mit der Übertragungsart DAT implizit gesetzt.

Mögliche Werte:

  • ' '

    Tabulatorzeichen sollen nicht zwischen Spalten eingefügt werden. Dies ist der Standard für alle Übertragungsarten, außer für DAT

  • 'X'

    Tabulatorzeichen sollen zwischen Spalten eingefügt werden. Dies wird automatisch durchgeführt, wenn die Übertragungsart DAT ist

[IMPORTING] header TYPE XSTRING

Eine hexadezimale Zeichenfolge, die den übertragenen Daten vorangestellt ist. Die Länge dieser Zeichenfolge darf 1023 Zeichen nicht überschreiten.

[IMPORTING] trunc_trailing_blanks TYPE CHAR01

Kennzeichen, das anzeigt, ob schließende Leerzeichen aus den übertragenen Daten entfernt werden sollen. Diese Option ist nur für die ASCII-Text-Übertragungsarten ASC, DAT und IBM relevant.

Mögliche Werte:

  • ' '

    Schließende Leerzeichen sollen unverändert bleiben

  • 'X'

    Schließende Leerzeichen sollen entfernt werden

[IMPORTING] write_lf TYPE CHAR01

Zeigt an, ob am Ende jeder Tabellenzeile ein Zeilenvorschub eingebunden werden soll.

Mögliche Werte:

  • ' '

    Am Ende der Tabellenzeile sollen keine Zeilenvorschübe hinzugefügt werden

  • 'X'

    Ein Zeilenvorschub soll an jede Zeile der Datentabelle angehängt werden

[IMPORTING] col_select TYPE CHAR01

Dieses Kennzeichen zeigt an, ob nur bestimmte Spalten einer Tabelle den Daten hinzugefügt werden sollen, die an den Client übertragen werden.

Diese Option ist nur für die Übertragungsarten DAT und DBF relevant.

Mögliche Werte:

  • ' '

    Alle Spalten sollen übertragen werden

  • 'X'

    Nur die in der Auswahlmaske 'col_select_mask' angegebenen Spalten sollen übertragen werden

[IMPORTING] col_select_mask TYPE CHAR255

In col_select_mask können die Spalten, die an den Client übertragen werden sollen, angegeben werden. Um eine zu übertragende Spalte auszuwählen, muss 'X' an der entsprechenden Stelle der Auswahlmaske eingegeben werden. Spalten, die nicht hinzugefügt werden sollen, werden mit '' markiert.

[IMPORTING] dat_mode TYPE CHAR01

Wenn dieses Kennzeichen gesetzt ist, werden Spalten, wie bei der Übertragungsart DAT, durch Tabulatoren voneinander getrennt. Anders als in der Übertragungsart DAT, werden schließende Leerzeichen nicht entfernt. Konvertierungs-Exits werden nicht ausgeführt.

Mögliche Werte:

  • ' '

    Spalten sollen nicht durch Tabulatoren getrennt und in einer anderen Übertragungsart als DAT übertragen werden

  • 'X'

    Spalten sollen durch Tabulatoren voneinander getrennt übertragen werden

[IMPORTING] confirm_overwrite TYPE CHAR01

Wenn diese Option aktiviert ist, wird der Benutzer gefragt, ob eine vorhandene Datei überschrieben werden soll. Andernfalls wird die Datei überschrieben, ohne den Benutzer zu fragen.

Mögliche Werte:

  • ' '

    Eine vorhandene Datei soll in jedem Fall überschrieben werden

  • 'X'

    Der Benutzer soll gefragt werden, ob eine vorhandene Datei überschrieben werden soll

[IMPORTING] no_auth_check TYPE CHAR01

Diese Option ermöglicht das Aktivieren/Deaktivieren der Überprüfung des Autorisierungsobjekts S_GUI vor dem Ausführen dieser Operation.

Mögliche Werte:

  • ' '

    Die Überprüfung des Autorisierungsobjekts soll deaktiviert werden

  • 'X'

    Die Überprüfung des Autorisierungsobjekts soll vor dem Ausführen der Operation vorgenommen werden

[IMPORTING] codepage TYPE ABAP_ENCODING

Kodierung, in der die Daten übertragen werden sollen. Dies ist die gewünschte SAP-Codepage. Wird stattdessen ein Leerzeichen angegeben, wird die Codepage verwendet, in der die SAP GUI mit dem Server kommuniziert.

[IMPORTING] ignore_cerr TYPE ABAP_BOOL

Kennzeichen, das anzeigt, ob Fehler in der Konvertierung der Daten ignoriert werden sollen.

Mögliche Werte:

  • ABAP_FALSE

    Konvertierungsfehler sollen nicht ignoriert werden

  • ABAP_TRUE

    Konvertierungsfehler sollen ignoriert werden

[IMPORTING] replacement TYPE ABAP_REPL

Ein Zeichen für Zeichen, die nicht konvertiert werden können, d.h. die nicht in der angegebenen Kodierung dargestellt werden können.

[IMPORTING] write_bom TYPE ABAP_BOOL

Wenn dieses Kennzeichen auf ABAP_TRUE gesetzt ist, wird den zum GUI übertragenen Daten eine Byte-Reihenfolge-Markierung hinzugefügt, falls die Daten in Unicode kodiert sind, d.h. UTF-8 oder UTF-16 Big Endian/Little Endian.

Mögliche Werte:

  • ABAP_FALSE

    Den Daten soll keine Byte-Reihenfolge-Markierung vorangestellt werden

  • ABAP_TRUE

    Den zu übertragenden Daten soll eine Byte-Reihenfolge-Markierung hinzugefügt werden

[IMPORTING] trunc_trailing_blanks_eol TYPE CHAR01

Kennzeichen, das anzeigt, ob die schließenden Leerzeichen in einer Zeile entfernt werden sollen. Dies betrifft nur die letzte Spalte einer Zeile.

Mögliche Werte:

  • ' '

    Schließende Leerzeichen sollen nicht entfernt werden

  • 'X'

    Schließende Leerzeichen sollen gelöscht werden

[IMPORTING] wk1_n_format TYPE C

Gibt an, wie numerische Spalten für Übertragungsart WK1 gehandhabt werden.

Mögliche Werte:

  • ' ' oder '0'

    Das Standardformat soll verwendet werden

  • "1<x>"

    Numerische Spalten sollen als Dezimalwerte interpretiert werden, wobei "1<x>" mit der gewünschten Anzahl an Stellen hinter dem Dezimalzeichen ersetzt werden muss

  • "2<x>"

    Numerische Spalten sollen als Währungswert mit <x> Dezimalstellen interpretiert werden

[IMPORTING] wk1_n_size TYPE C

Spaltenbreite für numerische Werte für Übertragungsart WK1.

Mögliche Werte:

  • >= 0

[IMPORTING] wk1_t_format TYPE C

Gibt die Textausrichtung in Zellen an, die Text für Übertragungsart WK1 enthalten.

Mögliche Werte:

  • '0'

    Der Text soll links ausgerichtet werden

  • '1'

    Der Text soll rechts ausgerichtet werden

  • '2'

    Der Text soll zentriert werden

[IMPORTING] wk1_t_size TYPE C

Breite von Textspalten für Übertragungsart WK1.

Mögliche Werte:

  • [0, 240]

[IMPORTING] show_transfer_status TYPE CHAR01

Kennzeichen, das anzeigt, ob Statusnachrichten zur Menge der übertragenen Daten und zur verwendeten Codepage in der Statusleiste angezeigt werden sollen.

Mögliche Werte:

  • ' '

    Es sollen keine Statusnachrichten angezeigt werden

  • 'X'

    Es sollen Statusnachrichten angezeigt werden

[EXPORTING] filelength TYPE I

Menge der an den Client übertragenen Bytes.

Mögliche Werte:

  • >= 0

[CHANGING] data_tab TYPE STANDARD TABLE

Tabelle mit Daten, die an den Client übertragen werden soll.

Hinweis Hinweis

Dieser Parameter sollte als Importparameter definiert worden sein, da der Inhalt, der der Methode übergeben wird, nicht geändert wird.

Ende des Hinweises.

[IMPORTING] write_lf_after_last_line TYPE ABAP_BOOL

Kennzeichen, das anzeigt, ob ein Zeilenvorschubszeichen nach der letzten Zeile geschrieben werden soll. Mögliche Werte:

Mögliche Werte:

  • ABAP_TRUE

    Nach der letzten Zeile soll ein Zeilenvorschubszeichen eingefügt werden

  • ABAP_FALSE

    Am Ende der letzten Zeile soll kein Zeilenvorschubszeichen eingefügt werden

Ausnahmen

ACCESS_DENIED

Ausgegeben, wenn der Benutzer das Überschreiben einer vorhandenen Datei ablehnt

CONTROL_FLUSH_ERROR

Ausgegeben, wenn die Operation auf dem Control nicht ausgeführt werden konnte.

DATAPROVIDER_EXCEPTION

Diese Ausnahme wird ausgegeben, wenn eine nicht spezifizierte Ausnahme im Daten-Provider aufgetreten ist.

DISK_FULL

Ausgegeben, wenn nicht genügend Platz im Speicher des Client-Systems vorhanden ist, um die Daten abzulegen.

DP_ERROR_CREATE

Ausgegeben, wenn der Daten-Provider nicht instanziiert werden konnte.

DP_ERROR_SEND

Ausgegeben, wenn ein Fehler während der Übertragung der Daten mittels Daten-Provider aufgetreten ist.

DP_ERROR_WRITE

Diese Ausnahme wird ausgegeben, wenn die mittels Daten-Provider übertragenen Daten nicht auf den Speicher des Client-Systems geschrieben werden können.

DP_OUT_OF_MEMORY

Wird zurzeit nicht verwendet.

DP_TIMEOUT

Wird zurzeit nicht verwendet.

ERROR_NO_GUI

Wird zurzeit nicht verwendet.

FILE_NOT_FOUND

Wird zurzeit nicht verwendet.

FILE_WRITE_ERROR

Diese Ausnahme wird ausgegeben, wenn während des Schreibens der Datei in das Web GUI ein Fehler aufgetreten ist.

FILESIZE_NOT_ALLOWED

Ausgegeben, wenn für eine andere Übertragungsart als BIN eine Dateigröße angegeben wurde.

GUI_REFUSE_FILETRANSFER

Diese Ausnahme wird ausgegeben, wenn die Daten nicht an das Web GUI übertragen werden konnten.

HEADER_NOT_ALLOWED

Ausgegeben, wenn der Parameterkopf Daten enthält und eine andere Übertragungsart als die binäre Übertragungsart als BIN angegeben wurde oder die Option für das Anhängen von Daten nicht für die Übertragungsart BIN definiert wurde und der Header Daten enthält.

HEADER_TOO_LONG

Wenn der angegebene Header die erlaubte Maximallänge überschreitet, wird diese Ausnahme ausgegeben.

INVALID_TYPE

Diese Ausnahme wird ausgegeben, wenn eine ungültige Übertragungsart angegeben wurde.

NO_BATCH

Wird zurzeit nicht verwendet.

NO_AUTHORITY

Ausgegeben, wenn der Benutzer nicht über die Berechtigung zur Ausführung dieser Operation verfügt.

NOT_SUPPORTED_BY_GUI

Wird zurzeit nicht verwendet.

SEPARATOR_NOT_ALLOWED

Ausgegeben, wenn für eine andere Übertragungsart als BIN ein Trennzeichen angegeben wurde.

UNKNOWN_DP_ERROR

Ausgegeben bei nicht identifiziertem Daten-Provider-Fehler.

UNKNOWN_ERROR

Ausgegeben, wenn ein Fehler während der Konvertierung von Daten, die zur angegebenen Kodierung übertragen werden sollen, oder während der Dateiübertragung auftritt.