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

> Ajoute un document depuis un fichier image à un lot FlexiCapture à l’aide de la méthode AddNewDocumentEx de l’API Web Services.

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

Ajoute à un lot un nouveau document à partir d’un fichier image. Cette méthode remplace la méthode [AddNewDocument](/fr/flexi-capture/api/methods/add-new-document) de la version précédente de l’API Web Services.

Les documents ajoutés deviennent accessibles uniquement après le prétraitement de leurs images. Utilisez la méthode [ProcessBatch](/fr/flexi-capture/api/methods/process-batch) pour démarrer le prétraitement des images après avoir ajouté les documents.

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

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

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

| Nom                              | Type                                                       | Description                                                                                                                                                                                                                                                                                  |
| -------------------------------- | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sessionId`                      | `int`                                                      | ID de la connexion au serveur d’applications                                                                                                                                                                                                                                                 |
| `batchId`                        | `int`                                                      | ID du lot auquel un document doit être ajouté                                                                                                                                                                                                                                                |
| `document`                       | [DocumentEx](/fr/flexi-capture/api/structures/document-ex) | Description du document en cours de création                                                                                                                                                                                                                                                 |
| `file`                           | [File](/fr/flexi-capture/api/structures/file)              | Fichier contenant l’image du document. Pour créer un document vide, laissez le paramètre `file` vide (`file.Name = ""`, `file.Bytes = new bytes [0]`).                                                                                                                                       |
| `excludeFromAutomaticAssembling` | `bool`                                                     | Indicateur précisant si le document est exclu de l’assemblage des documents. Valeurs possibles : `True` (le document a déjà été assemblé et n’est pas inclus dans l’assemblage des documents), `False` (le document est assemblé conformément aux paramètres spécifiés pour le type de lot). |

<div id="add-a-document-image-with-a-post-request">
  ## Ajouter une image de document via une requête POST
</div>

Vous pouvez également utiliser une [requête POST](/fr/flexi-capture/api/files/files) pour ajouter une image de document. 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 :

* `Action = Save`
* `objectType = 0`
* `objectId = documentId`, où `documentId` est l’ID du document renvoyé par la méthode `AddNewDocumentEx`
* `version = 0`
* `streamName = "FileName"`, où `FileName` est le nom du fichier spécifié lors de l’appel de la méthode `AddNewDocumentEx`

<div id="returned-value">
  ## Valeur renvoyée
</div>

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