Ansicht
Dokumentation

SO_DLI_READ_API1 - SAPoffice: Lesen einer Verteilerliste für Externe (RFC)

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.
SAP E-Book

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_DATA
DLI_ENTRIES
DLI_ID
DLI_NAME
SHARED_DLI

Ausnahmen

DLI_NOT_EXIST
OPERATION_NO_AUTHORIZATION
PARAMETER_ERROR
X_ERROR

Funktionsgruppe

SOI1

TXBHW - 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 )