Ansicht
Dokumentation

SDOK_PHIOS_CHECKOUT - Check-out von physischen Dokumenten aus dem Knowledge Provider

BAL_S_LOG - Application Log: Log header data   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dieser Funktionsbaustein checkt die angegebenen physischen Dokumente aus.

Der Inhalt der physischen Dokumente wird auf das Filesystem des Frontend-Rechners kopiert, und die Dokumente werden gegen weiteres Auschecken gesperrt.

Beim Aufruf wird in der Tabelle OBJECT_FILE_INFORMATIONS pro physischem Dokument ein Eintrag vorgenommen, in dem neben der Dokumentklasse und Dokument-Id das Zielverzeichnis auf dem Frontend-Rechner angegeben wird. Die Dateinamen der Dokumente sind beim Return der Funktion als Exportparameter aus der Tabelle zu entnehmen. Da einzelne Dokumente möglicherweise aus mehreren Dateien bestehen können, sind beim Return pro Dokument gegebenenfalls mehrere Einträge in der Tabelle. Die Zuordnung von mehreren Dateien zu einem Dokument ist dann durch die identischen Dokument-IDs der Tabelleneinträge gegeben.
Der Check-out wird pro Dokument vollständig oder gar nicht ausgeführt. Kann der Check-out bei einzelnen Dokumenten nicht ausgeführt werden, so werden diese Dokumente mit der Fehlerursache in der Tabelle BAD_OBJECTS aufgeführt. Mögliche Fehlercodes sind:

,,0:,,bad class:,,,,,,keine bekannte Klasse für physische Dokumente

,,1:,,not_existing:,,,,Dokument existiert nicht

,,2:,,not_allowed:,,,,Operation kann nicht ausgeführt werden.
,,,,,,,,,,,,,,Mögliche Ursachen:
,,,,,,,,,,,,,,-,,Dokument ist bereits ausgecheckt
,,,,,,,,,,,,,,-,,Dokument ist durch anderen Benutzer
,,,,,,,,,,,,,,,,reserviert

,,,,,,,,,,,,,,-,,Dokument ist im Status "geschützt"

,,3:,,missing_directory:,,kein Zielverzeichnis angegeben

,,5:,,transfer_error:,,,,Fehler beim Datentransfer

,,6:,,not_authorized:,,,,Keine Berechtigung

,,7:,,connection_error:,,Verbindung zur Datenablage kann
,,,,,,,,,,,,,,nicht hergestellt werden

,,8:,,bad_storage_category:,,Die Speicherkategorie, die am
,,,,,,,,,,,,,,,,physischen Dokument eingetragen ist,
,,,,,,,,,,,,,,,,ist nicht bekannt

Beispiel

Hinweise

• Ein Kopieren auf das Filesystem des Applikationsservers oder eine Übergabe des Inhalts in Form einer internen Tabelle ist derzeit nicht implementiert.

• Werden von der Anwendung in kurzer Zeit weitere Aufrufe des Bausteins erfolgen und werden Datentransfers per FTP ausgeführt, so kann durch Setzen des Flags FTP_KEEP_OPEN_FLAG eine Wiederverwendung der FTP-Verbindung veranlasst werden.

• Wenn sich die Anwendung über die Unterschiedlichkeit der Dateinamen der Dokumente nicht sicher ist, muss sie pro Dokument ein Verzeichnis angeben, um Namenskonflikte zu vermeiden. Dies ist z.B. insbesondere bei HTML-Dokumenten mit referenzierten GIF-Dateien der Fall.

Weiterführende Informationen

Parameter

BAD_OBJECTS
CLIENT
COMPONENTS
FTP_KEEP_OPEN_FLAG
OBJECT_FILE_INFORMATIONS
SUPPRESS_TRANSFER

Ausnahmen

Funktionsgruppe

SDCL

ROGBILLS - Synchronize billing plans   CPI1466 during Backup  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 3357 Date: 20240523 Time: 130236     sap01-206 ( 59 ms )