Document

What it does

The Document data type stores information about a document.

Fields

Name Type Description
Id int

The ID of a document.

The only way to set an ID for a document is to use the GetBatchIdsRange method, which allows reserving IDs for new documents. We recommend that you set an ID for a document before you add the document to a batch.  

A document ID will be generated automatically if you set its value to -1.

BatchId int The ID of the batch
ParentId int

The ID of the parent document of the set.

If a new document should be part of a set, this field should be assigned the value of the parent document of the set.

If a new document should not be part of any set, set the value of the field to 0.

Important! The parent document must be created before child documents are created.

ChildrenOrder ChildrenOrder []

A set of child documents enabling the sorting of  documents in the set.

When data are read from the server, the field is filled out automatically.

If this field is empty, the documents in the set will be arranged in the order in which they were added.

DocIndex int Document index
TemplateName string The name of the Document Definition
ProcessingStageType int The type of the processing stage; values come from ProcessingStageType
Comment string Comment
Pages Page[] The set of pages in the document
IsProcessed bool A flag that shows whether the document has been processed or not
HasProcessingErrors bool A flag that shows whether there were processing errors
HasDocumentErrors bool A flag that shows whether there are errors in the document (e.g. format errors, rules errors, assembly errors)
ErrorText string A description of the document processing errors
ExternalId string The external ID of the document
Properties RegistrationProperty[] The set of registration parameters for the document
Priority Priority[] Document priority
FileVersion int The version of the document file on the server
OwnerId int The ID of the user or group who owns the project
StageExternalId int The ID of the processing stage in which the task was created (unique within the batch type)
TaskId int The ID of the task the document belongs to
UncertainSymbols int The number of uncertain characters
VerificationSymbols int The number of verified characters
TotalSymbols int The total number of characters in the document
HasErrors bool A flag that shows whether there are any validation rule errors
HasWarnings bool A flag that shows whether there are any validation rule warnings
HasAssemblingErrors bool A flag that shows whether there were assembling errors
HasAttachments bool A flag that shows whether the document has attachments
Flags int

A set of flags that describe the status of the document. The value of a field is a combination of the values of the flags, which include:

  • BIF_IsAnalyzed = 0x100 shows that the document is analysed;
  • BIF_IsRecognized = 0x200 shows that the document is recognized;
  • BIF_IsVerified = 0x400 shows that the document is verified;
  • BIF_IsExported = 0x800 shows that the document is exported;
  • BIF_HasRuleErrors = 0x10000 shows that the document contains rule execution errors;
  • BIF_HasRuleWarnings = 0x20000 - shows that the document contains rule execution warnings;
  • BIF_HasMergeVersionErrors = 0x80000 - shows that the document contains errors of merging double verification results (verification results do not match);;
  • BIF_HasUserAttachments = 0x100000 - shows that the document has attachments;
  • BIF_HasUnmatchedFieldErrors = 0x200000 - shows that the document contains unmatched fields;
  • BIF_NeedsPreprocessing = 0x800000 - shows that the document needs preprocessing;
  • BIF_IsManuallyCreated = 0x1000000 - shows that the document was created manually;
  • BIF_IsExcludedFromAutomaticAssembling = 0x2000000 - shows that the document is excluded from automatic assembly;
  • BIF_IsSourceImageAttached = 0x4000000 - shows that a source image file is attached to the document.

Note: Only those flags are listed which are useful when working with the tasks and methods of the Web Services API.

25.05.2023 7:55:02

Please leave your feedback about this article

Usage of Cookies. In order to optimize the website functionality and improve your online experience ABBYY uses cookies. You agree to the usage of cookies when you continue using this site. Further details can be found in our Privacy Notice.