Kontakt

Ansicht
Dokumentation

GOS_API_GET_ATTA_LIST - GOS API: Lesen einer Anlagenliste von Extern (via RFC)

GOS_API_GET_ATTA_LIST - GOS API: Lesen einer Anlagenliste von Extern (via RFC)

PERFORM Short Reference   rdisp/max_wprun_time - Maximum work process run time  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Zugriff auf die GOS Anlagenliste für externe Verwender. Wenn kein Zugriff über Systemgrenzen hinweg notwendig ist (Aufruf per RFC), verwenden Sie statt der Funktionsbausteine die Klasse CL_GOS_API

.

Der Funktionsbaustein GOS_API_GET_ATTA_LIST liefert die Daten der GOS Anlagenliste zu dem mitgegebenen Anwendungsobjekt. Anschliessend können einzelne Anlagen über die folgenden Bausteine bearbeitet werden:

  • GOS_API_GET_AL_ITEM zum Lesen der Daten einer einzelnen Anlage, inklusive Inhalt.
  • GOS_API_INSERT_AL_ITEM zum Anlegen einer neuen Anlage.
    Führt ein Commit Work aus.
  • GOS_API_UPDATE_AL_ITEM zum Ändern einer Anlage.
    Führt ein Commit Work aus.
  • GOS_API_DELETE_AL_ITEM zum Löschen einer Anlage.
    Führt ein Commit Work aus.

Beispiel

Lesen aller Anlagen zu einem Anwendungsobjekt


data ls_object  type gos_s_obj.
data lt_atta    type gos_t_atta.
data ls_atta    type gos_s_atta.
data ls_key     type gos_s_attkey.
data ls_content type gos_s_attcont.
data lv_commit  type sap_bool.
data lt_filter  type gos_t_rol.
data lv_rfc     type rfcdest.

ls_object-typeid = .
ls_object-instid = .
ls_object-catid  = .

call function 'GOS_API_GET_ATTA_LIST' destination lv_rfc
  exporting
    is_object             = ls_object
    it_filter             = lt_filter
  importing
    et_atta               = lt_atta
*   ES_RETURN             =
  exceptions
    error                 = 1
    system_failure        = 3
    communication_failure = 4
    others                = 2.
loop at lt_atta into ls_atta.
  move-corresponding ls_atta to ls_key.
  call function 'GOS_API_GET_AL_ITEM' destination lv_rfc
    exporting
      is_atta_key           = ls_key
    importing
      es_attcont            = ls_content
*     ES_RETURN             =
    exceptions
      error                 = 1
      system_failure        = 3
      communication_failure = 4
      others                = 2.
  if sy-subrc <> 0.
*   error handling
  endif.
endloop.

Hinweise

Beim Aufruf des Funktionsbausteins GOS_API_GET_ATTA_LIST wird eine Instanz der Klasse CL_GOS_API erzeugt. Die weiteren Zugriffe auf die einzelnen Anlagen werden über diese Instanz durchgeführt. Damit die Instanz erhalten bleibt, ist es notwendig, dass die nachfolgenden Aufrufe über dieselbe RFC Verbindung durchgeführt werden und die RFC Verbindung in dieser Zeit nicht geschlossen wird.

Weiterführende Informationen

Zum Thema "Lebensdauer einer RFC Verbindung" lesen Sie den Hinweis 568271. Beachten Sie insbesondere, dass beim Schließen der GOS API die RFC Verbindung über den Aufruf des Funktionsbausteins RFC_CONNECTION_CLOSE geschlossen werden muss, wenn Sie syncrone RFC Aufrufe verwendet haben.





Parameter

ES_RETURN
ET_ATTA
IS_OBJECT
IT_FILTER
IV_HANDLE

Ausnahmen

ERROR

Funktionsgruppe

GOS_API

General Data in Customer Master   Addresses (Business Address Services)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5024 Date: 20240603 Time: 222808     sap01-206 ( 47 ms )