> ## 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.

# AddNewDocument

> Die Methode AddNewDocument in der ABBYY FlexiCapture Web Services API fügt einem Batch ein neues Dokument aus einer Bilddatei hinzu und steuert dessen Zusammenstellung und Position.

<div id="what-it-does">
  ## Was diese Methode bewirkt
</div>

Fügt einem Batch ein neues Dokument aus einer Bilddatei hinzu.

Um ein Dokument ohne Bild zu erstellen, lassen Sie den Parameter file leer (file.Name = "", file.Bytes = new bytes \[0]).

Ein neues Dokument wird mit dem Flag **excludeFromAutomaticAssembling** erstellt, das auf **true** gesetzt ist. Dieses Flag gibt an, dass das Dokument bereits zusammengestellt wurde und die für den Batch-Typ festgelegten Einstellungen für die Zusammenstellung nicht auf dieses Dokument angewendet werden.

<Warning>
  Neu hinzugefügte Dokumente sind erst verfügbar, nachdem ihre Bilder vorverarbeitet wurden. Verwenden Sie die Methode [ProcessBatch](/de/flexi-capture/api/methods/process-batch), um die Batch-Verarbeitung nach dem Hinzufügen neuer Dokumente zu starten.
</Warning>

<Note>
  Wenn dem Batch ein neues Dokument hinzugefügt wird, darf das Feld Id des entsprechenden Objekts nicht leer sein.
</Note>

Wenn Sie PDF-Dokumente hinzufügen und möchten, dass das Programm den in ihrer Textebene gespeicherten Text verwendet, stellen Sie sicher, dass für das Projekt, in dem die Dokumente verarbeitet werden, die Option PDF-Textebene anstelle von OCR verwenden ausgewählt ist (Sie finden diese Option auf der Registerkarte **Verarbeitung** des Dialogfelds **Seiteneigenschaft**).

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

```
int AddNewDocument( int sessionId, Document document, File file, bool excludeFromAutomaticAssembling, int previousItemId );
```

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

<table width="100%">
  <tbody>
    <tr>
      <td>
        <p>
          <strong>Name</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>Typ</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>Beschreibung</strong>
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>sessionId</p>
      </td>

      <td>
        <p>int</p>
      </td>

      <td>
        <p>Die ID der Verbindung zum Application Server</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>document</p>
      </td>

      <td>
        <p>
          <a href="/de/flexi-capture/api/structures/document">Document</a>
        </p>
      </td>

      <td>
        <p>Eine Beschreibung des Dokuments, das erstellt wird</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>file</p>
      </td>

      <td>
        <p>
          <a href="/de/flexi-capture/api/structures/file">File</a>
        </p>
      </td>

      <td>
        <p>Die Datei, die das Dokumentbild enthält</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>excludeFromAutomaticAssembling</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>Ein Flag, das angibt, ob das Dokument von der Dokumentzusammenstellung ausgeschlossen ist:</p>

        <ul>
          <li>
            <strong>True</strong> - das Dokument wurde bereits zusammengestellt und wird nicht in die Dokumentzusammenstellung einbezogen;
          </li>

          <li>
            <strong>False</strong> - das Dokument wird gemäß den für den Batch-Typ angegebenen Einstellungen zusammengestellt.
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>previousItemId</p>
      </td>

      <td>
        <p>int</p>
      </td>

      <td>
        <p>Die ID, die die Position des neuen Dokuments im Set explizit angibt:</p>

        <ul>
          <li>
            <strong>-1</strong> - das neue Dokument wird am Ende des Sets hinzugefügt
          </li>

          <li>
            <strong>0</strong> - das neue Dokument wird am Anfang des Sets hinzugefügt
          </li>

          <li>
            <strong>Document ID</strong> - das neue Dokument wird nach dem Dokument mit dieser ID hinzugefügt

            <br />

            <strong>Hinweis: </strong>Ein Dokument mit dieser ID muss vorhanden sein.
          </li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

<Note>
  Sie können auch eine [POST-Anforderung](/de/flexi-capture/api/files/files) verwenden, um ein Dokumentbild hinzuzufügen. Erstellen Sie dazu mit dieser Methode ein Dokument mit einer leeren Datei (file.Name = "FileName", file.Bytes = new bytes
  \[0]). Führen Sie dann eine POST-Anforderung mit den folgenden Parametern aus:
</Note>

* Action = Save
* objectType = 0
* objectId = documentId, wobei documentId die von der Methode AddNewDocument zurückgegebene Dokument-ID ist
* version = 0
* streamName = "C:\Temp\image.pdf", wobei image.pdf der Name der Datei ist, die beim Aufruf der Methode AddNewDocument angegeben wurde

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

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