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

# AddNewPage

> Die AddNewPage-Methode in der ABBYY FlexiCapture Web Services API fügt einem Dokument an einer ausgewählten Position innerhalb des Sets ein Seitenbild und dessen Beschreibung hinzu.

<div id="what-it-does">
  ## Funktion
</div>

Fügt einem Dokument ein Seitenbild hinzu.

<Warning>
  Auf die hinzugefügten Bilder kann erst nach ihrer Vorverarbeitung zugegriffen werden. Verwenden Sie die Methode [ProcessBatch](/de/flexi-capture/api/methods/process-batch), um die Batch-Verarbeitung zu starten, nachdem Sie die Bilder hinzugefügt haben. Alternativ können Sie die Aufgabe mit der Methode [CloseTask](/de/flexi-capture/api/methods/close-task) schließen und an die Stufe **Import** senden, wenn die Bilder zu den Dokumenten einer Aufgabe hinzugefügt wurden, die mit der Methode [OpenTask](/de/flexi-capture/api/methods/open-task) geöffnet wurde.
</Warning>

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

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

<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>batchId</p>
      </td>

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

      <td>
        <p>Die ID des Batchs, der das Dokument enthält</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>documentId</p>
      </td>

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

      <td>
        <p>Die ID des Dokuments, dem eine Seite hinzugefügt werden soll</p>
      </td>
    </tr>

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

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

      <td>
        <p>Die ID, mit der sich die Position der neuen Seite im Set explizit festlegen lässt:</p>

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

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

          <li>
            <strong>Seiten-ID</strong> - die neue Seite wird nach der Seite mit dieser ID hinzugefügt

            <br />

            <strong>Hinweis: </strong>Eine Seite mit dieser ID muss vorhanden sein.
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>page</p>
      </td>

      <td>
        <p>
          <a href="/de/flexi-capture/api/structures/page">Page</a>
        </p>
      </td>

      <td>
        <p>Eine Beschreibung der Seite. Es wird empfohlen, Seiten mit einem vordefinierten ID-Feld hinzuzufügen</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 Seitenbild enthält</p>
      </td>
    </tr>
  </tbody>
</table>

<Note>
  Sie können auch einen [POST-Request](/de/flexi-capture/api/files/files) 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:
</Note>

* 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

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

| **Typ** | **Beschreibung**               |
| ------- | ------------------------------ |
| int     | Die ID der hinzugefügten Seite |