Ansicht
Dokumentation

SO_ATTACHMENT_INSERT_API1 - SAPoffice: Anlegen einer Anlage für Externe (RFC)

rdisp/max_wprun_time - Maximum work process run time   General Material Data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dieser Funktion ermöglicht das Anlegen einer neuen Anlage zu einem bestehenden Dokument.

Importparameter

DOCUMENT_ID

ID eines Mappeneintrags des Dokuments, welches die Anlage erhalten soll. Sie beinhaltet die Verbindung zwischen dem Dokument und der Mappe, in der es liegt.

ATTACHMENT_TYPE

Typ der Anlage. Bis auf Mappen ('FOL') und Verteilerlisten ('DLI') sind alle Typen erlaubt.

ATTACHMENT_DATA

Diese Struktur muß die neuen Eigenschaften der zu neuen Anlage enthalten.

• OBJ_NAME

Name der Anlage.

• OBJ_DESCR

Titel (Kurze Beschreibung) der Anlage.

• OBJ_LANGU

Sprache der Anlage.

• ATT_SIZE

Größe der Anlage in Byte. Bei PC-Dokumenten sollte hier die Größe der jeweiligen Datei eingetragen werden, bei RAW- und SCR-Dokumenten berechnet sich die Größe durch "Länge der letzten Zeile" + "Anzahl der restlichen Zeilen multipliziert mit 255".

Exportparameter

ATTACHMENT_INFO

Diese Struktur enthält die vollständigen Eigenschaften der neu angelegten Anlage.

• ATTACH_ID

ID der Anlage. Diese beinhaltet die Verbindung zwischen der Anlage und dem Dokument, zu dem sie gehört.

• ATTACH_TYP

Typ der Anlage.

• ATT_NAME

Name der Anlage.

• ATT_DESCR

Titel (kurze Beschreibung) der Anlage.

• ATT_LANGU

Sprache der Anlage.

• ATT_SORT

Sortierfeld der Anlage. Nach diesem Begriff kann in der Attributsuche gesucht werden.

• OBJECT_ID

Objekt-ID der Anlage.

• CREATOR_ID

SAPoffice-ID des Erstellers der Anlage.

• CREAT_NAME

SAPoffice-Name des Erstellers der Anlage. Der SAPoffice-Name ist mandantenweit eindeutig.

• CREAT_FNAM

Vollständiger Name des Erstellers der Anlage aus der Adreßverwaltung.

• CREAT_DATE

Erstellungsdatum der Anlage.

• CREAT_TIME

Erstellungszeit der Anlage.

• CHANGE_ID

SAPoffice-ID des letzten Änderers der Anlage.

• CHANG_NAME

SAPoffice-Name des letzten Änderers der Anlage. Der SAPoffice-Name ist mandantenweit eindeutig.

• CHANG_FNAM

Vollständiger Name des letzten Änderers der Anlage aus der Adreßverwaltung.

• CHANG_DATE

Datum der letzten Änderung.

• CHANG_TIME

Uhrzeit der letzten Änderung.

• OWNER_ID

SAPoffice-ID des Besitzers der Anlage.

• OWNER_NAM

SAPoffice-Name des Besitzers der Anlage. Der SAPoffice-Name ist mandantenweit eindeutig.

• OWNER_FNAM

Vollständiger Name des Besitzers der Anlage aus der Adreßverwaltung.

• LAST_ACCES

Erstellungs-/Änderungsdatum der Anlage. Enthält den neueren der beiden Werte.

• OBJ_EXPDAT

Verfallsdatum des Dokuments, an dem die Anlage hängt. Das Dokument selbst kann nicht verfallen, bei jedem neuen Mappeneintrag des Dokuments wird jedoch dieses Datum als Vorlage für das Verfallsdatum des Eintrags (Feld EXPIRY_DAT) verwendet.

• SENSITIVTY

Sensitivität des Dokuments, an dem die Anlage hängt.

Ein persönliches Dokument kann folgende Sensitivität besitzen:

• 'O' : Standard, normale Sensitivität

• 'F' : Funktional, kann funktional weitergeleitet werden

• 'P' : Vertraulich, für Vertreter nicht sichtbar

Bei Dokumenten in der allgemeinen Ablage ist nur die Sensitivität 'O' zulässig.

• OBJ_PRIO

Empfängerpriorität des Dokuments, an dem die Anlage hängt. Das Dokument selbst besitzt keine Priorität, bei jedem neuen Mappeneintrag des Dokuments wird jedoch dieser Wert als Vorlage für die Empfängerpriorität des Eintrags (Feld PRIORITY) verwendet.

• NO_CHANGE

Wenn dieses Flag gesetzt ('X') wird, darf die Anlage in der allgemeinen Ablage nur vom Autor geändert werden. In der persönlichen Ablage ermöglicht es dem Autor, Änderungen auch nach dem Versenden noch durchzuführen.

• DOC_SIZE

Größe der Anlage in Byte. Bei PC-Anlagen sollte hier die Größe der jeweiligen Datei in eingetragen werden, bei RAW- und SCR-Anlagen berechnet sich die Größe durch "Länge der letzten Zeile" + "Anzahl der restlichen Zeilen multipliziert mit 255".

Tabellenparameter

ATTACHMENT_HEADER

Diese Tabelle muß die vom Typ der Anlage abhängigen Daten enthalten. SAPscript- Dokumente speichern hier z.B. Informationen über Formular und Stil, Excel-Listviewer-Dokumente u.a. die Anzahl der Zeilen und Spalten und PC-Dokumente ihren ursprünglichen Dateinamen.

• LINE

Benötigt zeilenweise die typabhängigen Informationen der Anlage.

ATTACHMENT_CONTENT

Diese Tabelle muß den eigentlich Inhalt der Anlage enthalten.

• LINE

Benötigt zeilenweise den Inhalt der Anlage.

Ausnahmen

DOCUMENT_NOT_EXIST

Der angegebene Mappeneintrag existiert nicht. Wahrscheinlich wurde entweder eine falsche ID übergeben oder der betroffene Mappeneintrag mittlerweile gelöscht.

ATTACHMENT_TYPE_NOT_EXIST

Der angegebene Typ der Anlage existiert nicht oder ist nicht zulässig. Es ist nicht möglich, Mappen ('FOL') oder Verteilerlisten ('DLI') als Anlagen zu haben.

OPERATION_NO_AUTHORIZATION

Die Anlage durfte nicht angelegt werden. Dies kann z.B. daran liegen, daß es sich bei dem von der Anlage betroffenen Dokument um das persönliche Dokument eines anderen Benutzers oder um ein Dokument in einer allgemeinen Mappe, für die der aktive Benutzer keine Änderungsberechtigung besitzt, handelt. Es ist außerdem in der Regel nicht möglich, an bereits versendete Dokumente eine Anlage anzuhängen.

PARAMETER_ERROR

Es wurde dem Funktionsbaustein eine unzulässige Kombination von Parameterwerten übergeben. Wahrscheinlich wurde in ein Feld der Struktur für die Eigenschaften der Anlage ein nicht erlaubter Wert eingetragen.

ENQUEUE_ERROR

Eine am Anlegevorgang beteiligte Sperre konnte nicht gesetzt werden. Wahrscheinlich findet gerade eine Bearbeitung durch einen anderen Benutzer statt.

Beispiel

Erstellen einer RAW-Anlage für das zuletzt angelegte Dokument im Ausgang des aktiven Benutzers. Zum Ermitteln der ID des Ausgangs wird der Funktionsbaustein SO_USER_READ_API1 verwendet, der Inhalt des Ausgangs wird über den Funktionsbaustein SO_FOLDER_READ_API1 erhalten.

DATA: FOL_CONT LIKE SOFOLENTI1 OCCURS 20 WITH HEADER LINE.

DATA: ATTHEAD LIKE SOLISTI1 OCCURS 0 WITH HEADER LINE.

DATA: ATTCONT LIKE SOLISTI1 OCCURS 5 WITH HEADER LINE.

DATA: USER_DATA LIKE SOUDATAI1.

DATA: ATT_CHNG LIKE SOATTCHGI1.

CALL FUNCTION 'SO_USER_READ_API1'

IMPORTING

USER_DATA = USER_DATA

EXCEPTIONS

OTHERS = 1.

IF SY-SUBRC <> 0.

WRITE: / 'Die Benutzerdaten konnten nicht gelesen werden !'.

EXIT.

ENDIF.

CALL FUNCTION 'SO_FOLDER_READ_API1'

EXPORTING

FOLDER_ID = USER_DATA-OUTBOXFOL

TABLES

FOLDER_CONTENT = FOL_CONT

EXCEPTIONS

OTHERS = 1.

IF SY-SUBRC <> 0.

WRITE: / 'Der Ausgang konnte nicht gelesen werden !'.

EXIT.

ENDIF.

SORT FOL_CONT BY CREAT_DATE DESCENDING CREAT_TIME DESCENDING.

READ FOL_CONT INDEX 1.

IF SY_SUBRC <> 0.

WRITE: / 'Keine Dokumente im Ausgang !'.

EXIT.

ENDIF.

ATT_CHNG-OBJ_NAME = 'ANLAGE'.

ATT_CHNG-OBJ_DESCR = 'Eine neue Anlage'.

ATT_CHNG-OBJ_LANGU = SY-LANGU.

ATTCONT = 'Zwar nur einzeilig, aber besser als überhaupt nichts !'.

APPEND ATTCONT.

ATT_CHNG-DOC_SIZE = STRLEN( ATTCONT ).

CALL FUNCTION 'SO_ATTACHMENT_INSERT_API1'

EXPORTING

DOCUMENT_ID = FOL_CONT-DOC_ID

ATTACHMENT_DATA = ATT_CHNG

ATTACHMENT_TYPE = 'RAW'

TABLES

ATTACHMENT_HEADER = ATTHEAD

ATTACHMENT_CONTENT = ATTCONT

EXCEPTIONS

PARAMETER_ERROR = 4

OTHERS = 99.

CASE SY-SUBRC.

WHEN 0.

WRITE: / 'Anlage zu', FOL_CONT-OBJ_DESCR, 'angelegt !'.

WHEN 4.

WRITE: / FOL_CONT-OBJ_DESCR, 'von Typ', FOL_CONT-OBJ_TYPE,

'- keine Anlage möglich !'.

WHEN OTHERS.

WRITE: / 'Anlage zu', FOL_CONT-OBJ_DESCR,

'konnte nicht erstellt werden !'.

ENDCASE.

Hinweise

Das Erstellen einer Anlage zu einem Dokument wird wie eine Änderung des Dokuments behandelt, d.h. nach dem Versenden ist das Anlegen, Ändern oder Löschen von Anlagen nicht mehr möglich. Außerdem wird nach dem Anlegen oder Ändern einer Anlage das letzte Änderungsdatum des Dokuments und aller allgemeinen Mappen, die das Dokument enthalten, aktualisisert.

Weiterführende Informationen

Informationen zum Aufruf der Funktionsbausteine SO_USER_READ_API1 und SO_FOLDER_READ_API1 finden sich in der Dokumentation der entsprechenden Funktionsbausteine.

Parameter

ATTACHMENT_CONTENT
ATTACHMENT_DATA
ATTACHMENT_HEADER
ATTACHMENT_INFO
ATTACHMENT_TYPE
CONTENTS_HEX
DOCUMENT_ID
ET_VSI_ERROR
IV_VSI_PROFILE

Ausnahmen

ATTACHMENT_TYPE_NOT_EXIST
DOCUMENT_NOT_EXIST
ENQUEUE_ERROR
OPERATION_NO_AUTHORIZATION
PARAMETER_ERROR
X_ERROR

Funktionsgruppe

SOI1

RFUMSV00 - Advance Return for Tax on Sales/Purchases   General Data in Customer Master  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 13108 Date: 20240523 Time: 112656     sap01-206 ( 149 ms )