Services

LoadFile

LoadFile
Main
History-Relevant
Rückgabewert
ByteArray
RET
JUNK_FILE_BYTE_ARRAY
  
Parameterliste
FileId
IN
LONG_NUMERIC_IDENTIFIER
>FILE.FILEID
StartAtByte
IN
long
  
MaxBytes
IN
Int
  
FileTransferFromDmsState
OUT
Enum: FileTransferFromDmsState
  
MediaFileId
IN
String
  
Kurzbeschreibung:
Dieser Service retourniert eine Datei welche in der Tabelle FILE über den Key (fileId) beschrieben wird. Alternativ dazu ist es möglich, OnRequest-Dateien unter Angabe der MediaFileId anzufordern.
Fehlerhandling/Plausibilisierung:
Generell gelten die Regeln (PK, AK, FK, Unique, NotNull) der Datenbank. Die zusätzlichen Fehler sind:
  • Aufgrund von Validator-Prüfungen (VD)
  • Wenn das File über die FileId nicht gefunden wird (1)
  • Wenn kein physikalisches File vorhanden ist (2)
  • Wenn der Signierungsprozess noch in Abeit ist (3)
  • Wenn die MediaFileId nicht korrekt ist (4)
  • Wenn das AdHoc-File nicht vorhanden ist (5)
  • Wenn für die Erzeugung der AdHoc-Datei die Konvertierungsbasis fehlt! (6)
  • Wenn die gewünschte Grösse des JunkFiles 0 Byte beträgt (7)
  • Wenn die gewünschte Grösse des JunkFiles die maximale Grösse übersteigt (8)
  • Wenn der FileAccess nicht registriert ist (9)
  • Der StorageDirectorAndProtector im FileAccess nicht registriert ist (10)
  • Wenn das Lesen der Datei aufgrund des geschlossenen StorageDirectors blockiert wurde (11)
  • Wenn das Schreiben der Datei aufgrund des geschlossenen StorageDirectors blockiert wurde (12)
  • Wenn das Schreiben der Datei aufgrund des ReadOnly-StorageDirectors blockiert wurde (13)
  • Wenn die Konvertierung nicht korrekt durchgeführt werden konnte! (14)
  • Die Datei kleiner als der gewünschte Offset ist (15)
Bemerkungen:
VD: siehe Validator-Fehler
(1): GetFileNEx
(2): LoadFileNEx
(3): LoadFileSigInProgress
(4): LoadAdHocFileInvMdaFileId
(5): LoadAdHocFileNEx
(6): LoadAdHocFileConvBaseMs
(7): ValMinJunkFileSizeVio
(8): ValMaxJunkFileSizeVio
(9): EnvFileAccNReg
(10): EnvStrgDirAndProtNReg
(11): EnvStrgDirAndProtReadBlkClosedStrg
(12): EnvStrgDirAndProtWriteBlkClosedStrg
(13): EnvStrgDirAndProtWriteBlkReadOnlyStrg
(14): ConversionFailedWithNoChangeToRecover
(15): EnvFileAccOfstFileSizeExd
File vom DMS beziehen:
Das File wird über die FileId adressiert. Anhand des Parameters StartAtByte wird in der Datei der Offset gesetzt und eine ByteArray der Grösse MaxBytes retourniert. MaxBytes muss dabei grösser 0 und darf maximal MAX_JUNK_FILE_IN_KB sein.
Nach dem ersten Aufruf steht im Out-Parameter FileTransferFromDmsState FILE_TRANSFER_COMPLETE sofern die Datei bereits vollständig übertragen wurde, ansonsten FILE_TRANSFER_IN_PROGRESS. Werden weitere Aufrufe benötigt um den Rest abzuholen, muss der Offset StartAtByte entsprechend angepasst werden.