> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AddNewDocumentEx

> Fügt mithilfe der Methode AddNewDocumentEx der FlexiCapture Web Services API ein Dokument aus einer Bilddatei zu einem FlexiCapture-Batch hinzu.

<div id="what-it-does">
  ## Was die Methode macht
</div>

Fügt einem Batch ein neues Dokument aus einer Bilddatei hinzu. Diese Methode ersetzt die Methode [AddNewDocument](/de/flexi-capture/api/methods/add-new-document) aus der vorherigen Version der Web Services API.

Die hinzugefügten Dokumente sind erst verfügbar, nachdem ihre Bilder vorverarbeitet wurden. Verwenden Sie die Methode [ProcessBatch](/de/flexi-capture/api/methods/process-batch), um die Bildvorverarbeitung zu starten, nachdem Sie die Dokumente hinzugefügt haben.

<div id="definition">
  ## Definition
</div>

```csharp theme={null}
int AddNewDocumentEx(int sessionId, int batchId, DocumentEx document, File file, bool excludeFromAutomaticAssembling);
```

<div id="parameters">
  ## Parameter
</div>

| Name                             | Typ                                                        | Beschreibung                                                                                                                                                                                                                                                                                                                                  |
| -------------------------------- | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sessionId`                      | `int`                                                      | Die ID der Verbindung zum Application Server                                                                                                                                                                                                                                                                                                  |
| `batchId`                        | `int`                                                      | Die ID des Batches, zu dem ein Dokument hinzugefügt werden soll                                                                                                                                                                                                                                                                               |
| `document`                       | [DocumentEx](/de/flexi-capture/api/structures/document-ex) | Eine Beschreibung des zu erstellenden Dokuments                                                                                                                                                                                                                                                                                               |
| `file`                           | [File](/de/flexi-capture/api/structures/file)              | Die Datei, die das Dokumentbild enthält. Um ein leeres Dokument zu erstellen, lassen Sie den Parameter `file` leer (`file.Name = ""`, `file.Bytes = new bytes [0]`).                                                                                                                                                                          |
| `excludeFromAutomaticAssembling` | `bool`                                                     | Ein Flag, das angibt, ob das Dokument von der automatischen Dokumentzusammenstellung ausgeschlossen ist. Mögliche Werte: `True` (das Dokument wurde bereits zusammengestellt und wird nicht in die Dokumentzusammenstellung einbezogen), `False` (das Dokument wird gemäß den für den Batch-Typ festgelegten Einstellungen zusammengestellt). |

<div id="add-a-document-image-with-a-post-request">
  ## Ein Dokumentbild per POST-Anfrage hinzufügen
</div>

Sie können ein Dokumentbild auch per [POST-Anfrage](/de/flexi-capture/api/files/files) hinzufügen. Erstellen Sie dazu mithilfe dieser Methode ein Dokument mit einer leeren Datei (`file.Name = "FileName"`, `file.Bytes = new bytes [0]`).

Führen Sie anschließend eine POST-Anfrage mit den folgenden Parametern aus:

* `Action = Save`
* `objectType = 0`
* `objectId = documentId`, wobei `documentId` die von der Methode `AddNewDocumentEx` zurückgegebene Dokument-ID ist
* `version = 0`
* `streamName = "FileName"`, wobei `FileName` der Name der Datei ist, die beim Aufruf der Methode `AddNewDocumentEx` angegeben wurde

<div id="returned-value">
  ## Rückgabewert
</div>

| Typ   | Beschreibung                    |
| ----- | ------------------------------- |
| `int` | Die ID des erstellten Dokuments |