Zum Hauptinhalt springen

​
Funktion

Fügt einem Dokument ein Seitenbild hinzu.
Auf die hinzugefügten Bilder kann erst nach ihrer Vorverarbeitung zugegriffen werden. Verwenden Sie die Methode ProcessBatch, um die Batch-Verarbeitung zu starten, nachdem Sie die Bilder hinzugefügt haben. Alternativ können Sie die Aufgabe mit der Methode CloseTask schließen und an die Stufe Import senden, wenn die Bilder zu den Dokumenten einer Aufgabe hinzugefügt wurden, die mit der Methode OpenTask geöffnet wurde.

​
Definition

int AddNewPage( int sessionId, int batchId, int documentId, int previousItemId, Page page, File file );

​
Parameter

sessionId

int

Die ID der Verbindung zum Application Server

batchId

int

Die ID des Batchs, der das Dokument enthält

documentId

int

Die ID des Dokuments, dem eine Seite hinzugefügt werden soll

previousItemId

int

Die ID, mit der sich die Position der neuen Seite im Set explizit festlegen lässt:

  • -1 - die neue Seite wird am Ende des Sets hinzugefügt
  • 0 - die neue Seite wird am Anfang des Sets hinzugefügt
  • Seiten-ID - die neue Seite wird nach der Seite mit dieser ID hinzugefügt
    Hinweis: Eine Seite mit dieser ID muss vorhanden sein.

page

Page

Eine Beschreibung der Seite. Es wird empfohlen, Seiten mit einem vordefinierten ID-Feld hinzuzufügen

file

File

Die Datei, die das Seitenbild enthält

Sie können auch einen POST-Request verwenden, um aus der Datei, die ein Bild enthält, eine neue Seite hinzuzufügen. Erstellen Sie dazu mit dieser Methode eine Seite mit einer leeren Datei: (file.Name = “FileName”, file.Bytes = new bytes [0]). Führen Sie anschließend einen POST-Request mit den folgenden Parametern aus:
  • Action = Save
  • objectType = 1
  • objectId = documentId, wobei documentId die ID des Dokuments darstellt, dem eine Seite hinzugefügt werden soll
  • version = 0
  • streamName = “Page 1”, wobei 1 die von der AddNewPage-Methode zurückgegebene Seiten-ID darstellt

​
Rückgabewert

TypBeschreibung
intDie ID der hinzugefügten Seite