Ansicht
Dokumentation
SO_DLI_READ_API1 - SAPoffice: Lesen einer Verteilerliste für Externe (RFC)
BAL Application Log Documentation Addresses (Business Address Services)Diese Dokumentation steht unter dem Copyright der SAP AG.
Funktionalität
Dieser Funktionsbaustein liefert alle Informationen zu einer Verteilerliste.
Dazu gehören:
- die Eigenschaften der Verteilerliste (z.B. Name, Beschreibung, Ersteller, Erstellungsdatum, Sensitivität usw.)
- die Einträge der Verteilerliste
Importparameter
- DLI_NAME
- Default = ' '
- Name der Verteilerliste. Der Name ist für die allgemeine Ablage bzw. für jede persönliche Ablage eindeutig. Werden sowohl Name als auch ID der Verteilerliste mitgegeben, wird der Name zur Bestimmung verwendet.
- DLI_ID
- Default = ' '
- Objekt-ID der Verteilerliste. Werden sowohl Name als auch ID der Verteilerliste mitgegeben, wird der Name zur Bestimmung verwendet.
- SHARED_DLI
- Default = ' '
- Wenn dieses Flag gesetzt ('X') wird, handelt es sich bei der zu zu lesenden Verteilerliste um eine allgemeine Verteilerliste, sonst wird von einer persönlichen Verteilerliste ausgegangen.
Exportparameter
- DLI_DATA
- Diese Struktur enthält die Eigenschaften der gelesenen Verteilerliste.
- OBJECT_ID
- Objekt-ID der Verteilerliste.
- OBJ_TYPE
- Typ des Dokuments ('DLI').
- OBJ_NAME
- Name der Verteilerliste.
- OBJ_DESCR
- Titel (kurze Beschreibung) der Verteilerliste.
- OBJ_LANGU
- Sprache der Verteilerliste.
- OBJ_SORT
- Sortierfeld der Verteilerliste. Nach diesem Begriff kann in der Attributsuche gesucht werden.
- CREATOR_ID
- SAPoffice-ID des Erstellers der Verteilerliste.
- CREAT_NAME
- SAPoffice-Name des Erstellers der Verteilerliste. Der SAPoffice-Name ist mandantenweit eindeutig.
- CREAT_FNAM
- Vollständiger Name des Erstellers der Verteilerliste aus der Adreßverwaltung.
- CREAT_DATE
- Erstellungsdatum der Verteilerliste.
- CREAT_TIME
- Erstellungszeit der Verteilerliste.
- CHANGER_ID
- SAPoffice-ID des letzten Änderers der Verteilerliste.
- CHANG_NAME
- SAPoffice-Name des letzten Änderers der Verteilerliste. Der SAPoffice-Name ist mandantenweit eindeutig.
- CHANG_FNAM
- Vollständiger Name des letzten Änderers der Verteilerliste aus der Adreßverwaltung.
- CHANG_DATE
- Datum der letzten Änderung.
- CHANG_TIME
- Uhrzeit der letzten Änderung.
- OWNER_ID
- SAPoffice-ID des Besitzers der Verteilerliste
- OWNER_NAM
- SAPoffice-Name des Besitzers der Verteilerliste. Der SAPoffice-Name ist mandantenweit eindeutig.
- OWNER_FNAM
- Vollständiger Name des Besitzers der Verteilerliste aus der Adreßverwaltung.
- LAST_ACCES
- Erstellungs-/Änderungsdatum der Verteilerliste. Enthält den neueren der beiden Werte.
- OBJ_EXPDAT
- Dieses Feld wird nicht verwendet.
- SENSITIVTY
- Sensitivität der Verteilerliste.
- Eine persönliche Verteilerliste kann folgende Sensitivität besitzen:
- 'O' : Standard, normale Sensitivität
- 'F' : Funktional, Angabe möglich, jedoch kein Unterschied zu Standard
- 'P' : Vertraulich, für Vertreter nicht sichtbar
- Bei allgemeinen Verteilerlisten ist nur die Sensitivität 'O' zulässig.
- OBJ_PRIO
- Dieses Feld wird nicht verwendet.
- NO_CHANGE
- Dieses Feld wird nicht verwendet.
- PROC_TYPE
- Dieses Feld wird nicht verwendet.
- PROC_NAME
- Dieses Feld wird nicht verwendet.
- PROC_SYST
- Dieses Feld wird nicht verwendet.
- PROC_CLIENT
- Dieses Feld wird nicht verwendet.
- SKIP_SCREEN
- Dieses Feld wird nicht verwendet.
- TO_DO_OUT
- Dieses Feld wird nicht verwendet.
- FREE_DEL
- Dieses Feld wird nicht verwendet.
- SUBSCRIPT
- Wenn dieses Flag gesetzt ('X') ist, handelt es sich bei der Verteilerliste um eine Subskriptionsliste. Da nur allgemeine Verteilerlisten Subskriptionslisten sein können, ist in diesem Fall auch das Flag SHARED_DLI gesetzt.
- SIZE
- Enthält die Anzahl der Einträge in der Verteilerliste.
- SHARED_DLI
- Wenn dieses Flag gesetzt ('X') ist, handelt es sich bei der Verteilerliste um eine allgemeine Verteilerliste.
- PRIORITY
- Dieses Feld wird nicht verwendet.
- EXPIRY_DAT
- Dieses Feld wird nicht verwendet.
Tabellenparameter
- DLI_ENTRIES
- Diese Tabelle enthält die Einträge der Verteilerliste.
- MEMBER_NAM
- Eindeutiger Name des Eintrags. Je nach Eintragstyp kann es sich hierbei um den SAPoffice-Namen eines Benutzers, den Namen einer persönlichen bzw. allgemeinen Verteilerliste oder den Namen zu der ID einer externen Adresse handeln.
- MEMBER_ID
- ID des Eintrags.
- MEMBER_TYP
- Typ des Eintrags.
- Es sind folgende Werte möglich:
- ' ' : interner Benutzer
- 'P' : persönliche Verteilerliste
- 'C' : allgemeine Verteilerliste
- 'A' : externe Adresse
- 'U' : Internetadresse
- 'X' : X.400-Adresse
- 'F' : Faxnummer
- 'R' : Remote SAP Name
- FULL_NAME
- Bezeichnender Name des Eintrags. Wenn es sich bei dem Eintrag um einen internen Benutzer handelt, wird hier der zugehörende Name aus der Adreßverwaltung verwendet. Bei externen Adressen wird eine möglichst genaue Beschreibung der Adresse eingefügt.
- MEMBER_ADR
- Wenn es sich bei dem Eintrag um eine externe Adresse handelt, dann ist sie in diesem Feld vollständig angegeben.
- Es sind folgende Adreßtypen möglich:
- eine Faxnummer in Form der Struktur SADRFD
- eine Internetadresse in Form der Struktur SADRUD
- eine SAP Remote Adresse in Form der Struktur SADR7D
- eine X.400-Adresse in Form der Struktur SADR8D
- Die Bedeutung des hier eingetragenen Wertes kann dem Feld MEMBER_TYP entnommen werden.
Ausnahmen
- DLI_NOT_EXIST
- Die angegebene Verteilerliste existiert nicht. Wahrscheinlich wurde entweder eine falsche ID bzw. Name übergeben oder die betroffene Verteilerliste mittlerweile gelöscht.
- OPERATION_NO_AUTHORIZATION
- Der aktive Benutzer hat keine Berechtigung, die angeforderte Verteilerliste zu lesen. Dies kann daran liegen, daß es sich um die persönliche Verteilerliste eines anderen Benutzers oder um eine Verteilerliste in einer allgemeinen Gruppenmappe, für die der aktive Benutzer keine Zugriffsberechtigung besitzt, handelt. Auf Verteilerlisten im allgemeinen Papierkorb darf nur der SAPoffice-Administrator zugreifen.
- PARAMETER_ERROR
- Es wurde dem Funktionsbaustein eine unzulässige Kombination von Parameterwerten übergeben. Wahrscheinlich wurde weder der Name noch die ID der zu lesenden Verteilerliste angegeben.
- X_ERROR
- Es ist ein interner Fehler oder eine Datenbankinkonsistenz aufgetreten.
Beispiel
Lesen einer Subskriptionsliste und Auswerten der darin enthaltenen Einträge.
- DATA: TAB_ENTRIES LIKE SODLIENTI1 OCCURS 10 WITH HEADER LINE.
- DATA: DLI_DATA LIKE SODLIDATI1.
- DATA: DLI_NAME LIKE SOOBJINFI1-OBJ_NAME.
- DLI_NAME = 'VORTRAG 042'.
- CALL FUNCTION 'SO_DLI_READ_API1'
- EXPORTING
- DLI_NAME = DLI_NAME
- SHARED_DLI = 'X'
- IMPORTING
- DLI_DATA = DLI_DATA
- TABLES
- DLI_ENTRIES = TAB_ENTRIES
- EXCEPTIONS
- DLI_NOT_EXIST = 1
- OPERATION_NO_AUTHORIZATION = 2.
- CASE SY-SUBRC.
- WHEN 1.
- WRITE: / 'Die Subskriptionsliste', DLI_NAME, 'existiert nicht !'.
- EXIT.
- WHEN 2.
- WRITE: / 'Keine Berechtigung zum Lesen der Subskriptionsliste',
- DLI_NAME, '!'.
- EXIT.
- ENDCASE.
- WRITE: / 'Zu dem Vortrag "Wildwuchs des weißen Wiesenwirsings"',
- 'haben sich bis jetzt', DLI_DATA-SIZE, 'Personen',
- 'eingetragen.'.
- LOOP AT TAB_ENTRIES.
- WRITE: / TAB_ENTRIES-FULL_NAME.
- ENDLOOP.
Hinweise
Zum Lesen von Mappen oder Dokumenten müssen die Funktionsbausteine SO_FOLDER_READ_API1 bzw. SO_DOCUMENT_READ_API1 verwendet werden.
Weiterführende Informationen
Parameter
DLI_DATADLI_ENTRIES
DLI_ID
DLI_NAME
SHARED_DLI
Ausnahmen
DLI_NOT_EXISTOPERATION_NO_AUTHORIZATION
PARAMETER_ERROR
X_ERROR
Funktionsgruppe
SOI1TXBHW - Original Tax Base Amount in Local Currency Fill RESBD Structure from EBP Component Structure
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 12483 Date: 20240523 Time: 110406 sap01-206 ( 112 ms )