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

> El método AddNewPage de la API de servicios web de ABBYY FlexiCapture agrega una imagen de página y su descripción a un documento en la posición elegida dentro del conjunto.

<div id="what-it-does">
  ## Qué hace
</div>

Agrega la imagen de una página a un documento.

<Warning>
  Las imágenes agregadas solo estarán accesibles después de su preprocesamiento. Use el método [ProcessBatch](/es/flexi-capture/api/methods/process-batch) para iniciar el procesamiento por lotes después de agregar las imágenes. Otra opción es usar el método [CloseTask](/es/flexi-capture/api/methods/close-task) para cerrar la tarea y enviarla en la etapa de **Import**, si las imágenes se agregaron a los documentos de una tarea que se abrió con el método [OpenTask](/es/flexi-capture/api/methods/open-task).
</Warning>

<div id="definition">
  ## Definición
</div>

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

<div id="parameters">
  ## Parámetros
</div>

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

      <td>
        <p>
          <strong>Tipo</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>Descripción</strong>
        </p>
      </td>
    </tr>

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

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

      <td>
        <p>El ID de la conexión con el servidor de aplicaciones</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>batchId</p>
      </td>

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

      <td>
        <p>El ID del lote que contiene el documento</p>
      </td>
    </tr>

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

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

      <td>
        <p>El ID del documento al que se agregará una página</p>
      </td>
    </tr>

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

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

      <td>
        <p>El ID que permite especificar explícitamente la posición de la nueva página en el conjunto:</p>

        <ul>
          <li>
            <strong>-1</strong> - la nueva página se agregará al final del conjunto
          </li>

          <li>
            <strong>0</strong> - la nueva página se agregará al principio del conjunto
          </li>

          <li>
            <strong>ID de página</strong> - la nueva página se agregará después de la página con este ID

            <br />

            <strong>Nota: </strong>Debe existir una página con este ID.
          </li>
        </ul>
      </td>
    </tr>

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

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

      <td>
        <p>Descripción de la página. Se recomienda agregar páginas con un campo ID predefinido</p>
      </td>
    </tr>

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

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

      <td>
        <p>El archivo que contiene la imagen de la página</p>
      </td>
    </tr>
  </tbody>
</table>

<Note>
  También puede usar una [solicitud POST](/es/flexi-capture/api/files/files) para agregar una nueva página a partir del archivo que contiene una imagen. Para ello, cree una página con un archivo vacío mediante este método: (file.Name =
  "FileName", file.Bytes = new bytes \[0]). A continuación, realice una solicitud POST con los siguientes parámetros:
</Note>

* Action = Save
* objectType = 1
* objectId = documentId, donde documentId representa el ID del documento al que se debe agregar una página
* version = 0
* streamName = "Page 1", donde 1 representa el ID de la página devuelto por el método AddNewPage

<div id="returned-value">
  ## Valor devuelto
</div>

| **Tipo** | **Descripción**            |
| -------- | -------------------------- |
| int      | El ID de la página añadida |