Passer au contenu principal

Ce qu’elle fait

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.
Les documents nouvellement ajoutés ne sont accessibles qu’après le prétraitement de leurs images. Utilisez la méthode ProcessBatch pour lancer le traitement du lot après avoir ajouté de nouveaux documents.
Lorsqu’un nouveau document est ajouté au lot, le champ Id de l’objet correspondant ne doit pas être vide.
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).

Définition

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

Paramètres

sessionId

int

L’ID de la connexion au serveur d’applications

document

Document

Description du document en cours de création

file

File

Le fichier qui contient l’image du document

excludeFromAutomaticAssembling

bool

Un indicateur indiquant si le document est exclu de l’assemblage de documents :

  • True - le document a déjà été assemblé et n’est pas inclus dans l’assemblage de documents ;
  • False - le document sera assemblé conformément aux paramètres spécifiés pour le type de lot.

previousItemId

int

L’ID qui spécifie explicitement la position du nouveau document dans le jeu :

  • -1 - le nouveau document sera ajouté à la fin du jeu
  • 0 - le nouveau document sera ajouté au début du jeu
  • Document ID - le nouveau document sera ajouté après le document ayant cet ID
    Remarque : le document portant cet ID doit exister.
Vous pouvez également utiliser une requête POST 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 :
  • 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

Valeur de retour

TypeDescription
intL’ID du document créé