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

> La méthode AddNewDocument de l’API Web Services ABBYY FlexiCapture ajoute à un lot un nouveau document à partir d’un fichier image et en contrôle l’assemblage et la position.

<div id="what-it-does">
  ## Ce qu’elle fait
</div>

Ajoute un nouveau document à partir d’un fichier image à un lot.

Pour créer un document sans image, laissez le paramètre file vide (file.Name = "", file.Bytes = new bytes \[0]).

Un nouveau document est créé avec l’indicateur **excludeFromAutomaticAssembling** défini sur **true**. Cet indicateur signifie que le document a déjà été assemblé et que les paramètres d’assemblage définis pour le type de lot ne lui seront pas appliqués.

<Warning>
  Les documents nouvellement ajoutés ne sont accessibles qu’après le prétraitement de leurs images. Utilisez la méthode [ProcessBatch](/fr/flexi-capture/api/methods/process-batch) pour lancer le traitement du lot après avoir ajouté de nouveaux documents.
</Warning>

<Note>
  Lorsqu’un nouveau document est ajouté au lot, le champ Id de l’objet correspondant ne doit pas être vide.
</Note>

Si vous ajoutez des documents PDF et souhaitez que le programme utilise le texte contenu dans leur calque de texte, assurez-vous que l’option Utiliser le calque de texte PDF au lieu de l’OCR est sélectionnée pour le projet dans lequel les documents seront traités (vous trouverez cette option dans l’onglet **Processing** de la boîte de dialogue **Propriétés de la page**).

<div id="definition">
  ## Définition
</div>

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

<div id="parameters">
  ## Paramètres
</div>

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

      <td>
        <p>
          <strong>Type</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>Description</strong>
        </p>
      </td>
    </tr>

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

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

      <td>
        <p>L’ID de la connexion au serveur d’applications</p>
      </td>
    </tr>

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

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

      <td>
        <p>Description du document en cours de création</p>
      </td>
    </tr>

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

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

      <td>
        <p>Le fichier qui contient l’image du document</p>
      </td>
    </tr>

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

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

      <td>
        <p>Un indicateur indiquant si le document est exclu de l’assemblage de documents :</p>

        <ul>
          <li>
            <strong>True</strong> - le document a déjà été assemblé et n’est pas inclus dans l’assemblage de documents ;
          </li>

          <li>
            <strong>False</strong> - le document sera assemblé conformément aux paramètres spécifiés pour le type de lot.
          </li>
        </ul>
      </td>
    </tr>

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

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

      <td>
        <p>L’ID qui spécifie explicitement la position du nouveau document dans le jeu :</p>

        <ul>
          <li>
            <strong>-1</strong> - le nouveau document sera ajouté à la fin du jeu
          </li>

          <li>
            <strong>0</strong> - le nouveau document sera ajouté au début du jeu
          </li>

          <li>
            <strong>ID du document</strong> - le nouveau document sera ajouté après le document ayant cet ID

            <br />

            <strong>Remarque : </strong> le document portant cet ID doit exister.
          </li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

<Note>
  Vous pouvez également utiliser une [requête POST](/fr/flexi-capture/api/files/files) pour ajouter l’image du document. Pour cela, créez un document avec un fichier vide à l’aide de cette méthode (file.Name = "FileName", file.Bytes = new bytes
  \[0]). Exécutez ensuite une requête POST avec les paramètres suivants :
</Note>

* Action = Save
* objectType = 0
* objectId = documentId, où documentId est l’ID du document renvoyé par la méthode AddNewDocument
* version = 0
* streamName = "C:\Temp\image.pdf", où image.pdf est le nom du fichier spécifié lors de l’appel de la méthode AddNewDocument

<div id="returned-value">
  ## Valeur de retour
</div>

| **Type** | **Description**       |
| -------- | --------------------- |
| int      | L’ID du document créé |