IDocument
What it does
Represents a document.
Note. Some methods and properties of this object are not available on the Web Verification Station for checking rules locally. The methods and properties that are not supported are marked with an asterisk (*).
Methods
| Definition | Description |
|---|---|
| AddFileToExportResults( sourceFile : string, destinationName : string, replaceIfExists : bool ) * |
Adds a user file to document export results. In the sourceFile parameter, specify the address of the user file to be added.
In the destinationName parameter, specify an export destination. Set the replaceIfExists parameter to true if you want to overwrite any existing file with the same name in the destination. Set the replaceIfExists parameter to false if you want to keep any existing file with the same name in the destination and add an error message to the log. |
| CheckRules( ) * | Checks all rules in the document. Write permissions for the document are required. |
| Field( name : string ) : IField * |
Gets access to a document field by the full path to the field. Full paths are used. Is an internal** field. Cannot be used in rules. |
| HasField( name : string ) : bool * |
Checks whether a field with the specified path exists. Relative paths are used. Is an internal** field. Cannot be used in rules. |
| IndexedItemValue( name : string ) : VARIANT * | Retrieves the field value by the name or the path to the field. Available from external fields of documents and pages. Both a field name and a full path to the field can be used. Cannot be used in rules. |
| IndexedItemValues( name : string ) : IVARIANTArray * | Retrieves a set of index values corresponding to a field in the Document Definition by the name or the path to the field. If a field is marked as an index field in the recurring section, the method returns all values of the field from all sections. Available from external fields of documents and pages. Both a field name and a full path to the field can be used. Cannot be used in rules. |
| Property( name : string ) : VARIANT |
Retrieves the value of a specified property by its name. The returned value can be in the form of a string, a number or time. Properties names and returned values:
|
| SaveAs( filename : string, [optional] options : IExportImageSavingOptions ) * | Saves the image of a one-page or multi-page document. If no saving format is specified in the saving options, the image is saved in a *.tif file. This is an internal** field. |
| SaveAsStream( [optional] options: IExportImageSavingOptions) : byte[] * |
Saves the document to a memory stream and returns it as a byte array (COM SafeArray).
|
| SaveXmlToFile( filename : string ) * | Saves the XML file with the description of the document without preprocessing to the specified location to be used in the Web Verification Station. |
| SaveXmlToFileStorage() * | Saves the XML file with the description of the document without preprocessing to the file storage to be used in the Web Verification Station. |
Important! The Property method should not be confused with the Properties collection which contains document properties specified by the user.
Properties
| Name | Type | Access | Description |
|---|---|---|---|
| Action * | IActionResult | Read-only | Is effective in export and post export scripts only. |
| AsBatchItem * | IBatchItem | Read-only | Converts the document into an IBatchItem object. |
| AssemblingErrors | IAssemblingErrors | Read-only | A collection of assembly errors. Access to the collection is always read-only. |
| Attachments | IUserAttachments | Read-only | User attachments |
| Batch | IBatch | Read-only | The batch. Irrespective of permissions of the script for the document, access to the batch is read-only and internal** fields of documents and pages are unavailable. |
| BatchName | string | Read-only | The batch name. |
| Children * | IFields | Read-only |
Child fields (document sections). Unlike the property Sections, section order corresponds to their order in Document Definition. Recurring sections are represented as one item and the instances are available through the Items method of that item. Is an internal** field. Cannot be used in rules. |
| Comment | string | Read/write | A comment of the document. |
| DefinitionName | string | Read-only |
The name of the Document Definition. For unprocessed and unrecognized documents, the property returns an empty string. |
| DocumentDefinition | IDocumentDefinitionInfo | Read-only | Detailed information about the Document Definition which is matched on the document. |
| HasErrors | bool | Read-only | Specifies whether the document has single-field or multi-field errors. |
| HasUnpreparedImages | bool | Read-only | Specifies whether the document contains un-preprocessed pages. |
| HasWarnings | bool | Read-only | Specifies whether the document has rule or format warnings. |
| Id | string | Read-only | Document identifier (External Id). The value starts with 1 and is unique only within one batch. |
| Index | int | Read-only | The index of the document in the batch. The value starts with 0 and is unique only within one task. |
| IsAnalyzed | bool | Read-only | Specifies whether the document is analyzed. The document is considered analyzed if all pages of the document are analyzed. |
| IsAssembled | bool | Read-only | Specifies whether the document is assembled. |
| IsExcludedFromAutomaticAssembling | bool | Read/write | Checks if the document is included into automatic assembly. |
| IsExported | bool | Read-only | Specifies whether the document is exported. |
| IsRecognized | bool | Read-only | Specifies whether the document is recognized. The document is considered recognized if each page of the document is either recognized or this is an annex page. |
| IsUsedForTraining | bool | Read/write | Specifies whether the document is used for training. |
| IsVerified | bool | Read-only | Specifies whether the document is verified. |
| Pages | IPages | Read-only | Document pages. |
| PreviousStageInfo * | IStageInfo | Read-only | Returns the IStageInfo object, i.e. the processing stage of the document. The TaskId and PrincipalId fields are not used. |
| Priority | TProcessingPriority | Read-only | A priority of the document. |
| ProcessingErrors * | string | Read-only | Processing errors divided by line breaks. |
| ProcessingWarnings * | string | Read-only | Processing warnings divided by line breaks. |
| ProhibitedUserId * | int | Read-only | A task created from the document will not be available to the user with the given identifier. By default the value is "0" which means that the task is available to all users. |
| Properties | IProperties | Read-only | Registration parameters of the document. |
| RecognizedSymbolsCount * | int | Read-only | The number of recognized symbols. |
| RuleErrors * | IRuleErrors | Read-only |
A collection of document errors (format errors, rule errors, errors of merging double verification results).
|
| Sections * | IFields | Read-only |
A flat list of document sections. If there is a recurring section, the list contains all replications of the section. Sections in the list go in the same order as the first pages of the document sections. Sections without pages close the list. Is an internal** field. Cannot be used in rules. |
| StageInfo | IStageInfo | Read-only | Information about the processing stage on the application server. |
| SymbolsForVerificationCount | int | Read-only | The number of symbols that need verification. |
| TotalSymbolsCount | int | Read-only | The total number of symbols. |
| UncertainSymbolsCount | int | Read-only | The number of uncertain symbols. |
** - The internal field requires loading the object into memory.
12.04.2024 18:16:02