ABBYY Vantage Library Objects

The functions in this section are exposed in the Business Entities > Library Types > ABBYY Vantage from the Direct.Shared.Library.dll.

To view the ABBYY Vantage library objects:

  1. Verify that the Direct.Shared.Library.dll file is installed in Real-Time Designer installation folder.

  2. Edit (as an admin) C:\Users\<user>\AppData\Roaming\Nice_Systems\Real-Time\RTClient.exe.config file and in the <configSections> ensure that the following appears: <section name="VantageUrlConfigurator" type="Direct.Shared.ABBYYVantageConfigurator, Direct.Shared.Library" />

  3. In Real-Time Designer, select Project > References > Library References > Direct.Shared.Library.

  4. From the Type dropdown list, select ABBYY Vantage.

ABBYY Vantage Properties

Property

Description

Type

Client Id

The ABBYY Vantage API application identifier.

This should be created by a user with the Tenant Administrator role in ABBYY Vantage. See the ABBYY Vantage Administrators Guide.

Text
Client Secret

The ABBYY Vantage client secret.

This should be created by a user with the Tenant Administrator role in ABBYY Vantage. The client secret value is only available when it is being created. Store it in a secure location. See the ABBYY Vantage Administrators Guide.

Text
Error Stores any errors returned by ABBYY Vantage (Detail, Instance, Status, Title, and Type). Error Details
Exception The exception event.  
Password The ABBYY Vantage password. Text
Response

The API call response from the following functions:

  • Connect: The ABBYY Vantage access token.

  • Get Skills: The list of skills.

  • Create Empty Transaction: The transaction id.

  • Monitor Transaction: The transaction id, the status, the resultFiles including the fileId (required to download the results), and more.

  • Download Result: The ABBYY Vantage results.

Text
ResponseCode

The API call response code:

  • 200 for successful.

  • 201 for an error.

  • 404 for no document with id found.

Number
Status The API call status. Completed once done. Text
URL The ABBYY Vantage URL. https://vantage-eu.abbyy.com/ Text
User Name The ABBYY Vantage user name. Text

Functions

Function

Description

RETURN

Add file to transaction Adds a file to an ABBYY Vantage transaction. None
Connect Connects to the ABBYY Vantage API. Boolean
Create Empty Transaction Creates an empty ABBYY Vantage transaction. Text
Create transaction & process file Create an ABBYY Vantage transaction and processes the file. Text
Download Result Downloads the result of the file processing from ABBYY Vantage. Boolean
Get Skills Gets a list of skills from ABBYY Vantage. List of Vantage Skills
Get Transaction Status Gets the transaction status. Transaction Status
Start processing transaction Starts processing an ABBY Vantage transaction. None

Transaction Response

PROPERTY

Description

Id The ID of the transaction.
SkillId The ID of the applied skill.
SkillName The name of the applied skill.
Documents

The list of the Documents objects, together with the processing results.

  • Id: The documents ID.

  • ExtractedData: Information about the extracted fields. This structure includes the RawValue of each of the Fields.

  • Pages: Information about the pages of the source document.

For more information, refer to the JSON schema on the ABBYY Vantage Developer's Guide.

CreationTime The time of the transaction.
SourceFiles

The list of SourceFile objects, together with information about the source files submitted for processing. ABBYY Vantage currently only supports one file per transaction.

  • Id: The source file ID.

  • Name: The source file name.

   

The following is a sample response for the Get Transaction Status function. Use the fileId from this response as an input parameter for the Download Result function.


Copy
{
   "id":"6def39bb-dddd-4241-9623-23e98d67b991",
   "status":"Processed",
   "documents":[
      {
         "id":"67d66822-9e3e-4475-a82b-dbe868ae6da8",
         "resultFiles":[
            {
               "fileId":"5c3822ac-4329-43b5-9d30-04e157f5797d",
               "fileName":"FuelSkill.json",
               "type":"Json"
            }
         ],
         "businessRulesErrors":[
            
         ]
      }
   ],
   "sourceFiles":[
      {
         "id":"107c2b57-c684-4c28-804c-ca1b8fdbed62",
         "name":"New doc 11-03-2021 09.25.53 am.jpg"
      }
   ]
}

The following is a sample response for the Download Result function.


Copy
{
  "Transaction": {
    "Id": "6def39bb-dddd-4241-9623-23e98d67b991",
    "SkillId": "ceea8eae-0323-476f-ae28-fb6f9e3b6605",
    "SkillName": "FuelSkill",
    "Documents": [
      {
        "Id": "67d66822-9e3e-4475-a82b-dbe868ae6da8",
        "ExtractedData": {
          "DocumentDefinition": {
            "RootConcept": {
              "Id": "root",
              "Name": "Empty",
              "Fields": [
                {
                  "Id": "5ecf509b-3e8a-4ae8-a133-c29a415f6caa",
                  "Name": "New Field",
                  "Type": "String",
                  "Cardinality": {
                    "Min": 0,
                    "Max": 1
                  }
                },
                {
                  "Id": "3cea23c5-46da-46bf-8596-630e6288861a",
                  "Name": "New Field 2",
                  "Type": "String",
                  "Cardinality": {
                    "Min": 0,
                    "Max": 1
                  }
                },
                {
                  "Id": "10366775-f6c9-4e04-a715-e7fc36c4b663",
                  "Name": "New Field 3",
                  "Type": "String",
                  "Cardinality": {
                    "Min": 0,
                    "Max": 1
                  }
                }
              ]
            }
          },
          "RootObject": {
            "Id": "root",
            "Concept": "Empty",
            "Fields": [
              {
                "Name": "New Field",
                "List": [
                  {
                    "Id": "71517cd0-d96b-4a1f-82ed-3aff563b6238",
                    "Annotations": [
                      {
                        "Source": "Image",
                        "ImageRegions": [
                          {
                            "Page": "e3c2ea3e-cd90-46d4-9ed3-2ca4a6d26a29",
                            "Rects": [
                              [
                                606,
                                600,
                                794,
                                652
                              ]
                            ]
                          }
                        ],
                        "RawValue": "80209",
                        "Confidence": 1,
                        "SuspiciousSymbols": []
                      }
                    ],
                    "Value": "80209"
                  }
                ]
              },
              {
                "Name": "New Field 2",
                "List": [
                  {
                    "Id": "f058e5aa-7212-4b65-9011-6b673d5e0685",
                    "Annotations": [
                      {
                        "Source": "Image",
                        "ImageRegions": [
                          {
                            "Page": "e3c2ea3e-cd90-46d4-9ed3-2ca4a6d26a29",
                            "Rects": [
                              [
                                567,
                                782,
                                792,
                                825
                              ]
                            ]
                          }
                        ],
                        "RawValue": "Petrol",
                        "Confidence": 1,
                        "SuspiciousSymbols": [
                          2
                        ]
                      }
                    ],
                    "Value": "Petrol"
                  }
                ]
              },
              {
                "Name": "New Field 3",
                "List": [
                  {
                    "Id": "cbd571bf-4c52-4332-bada-1109ba87d2d2",
                    "Annotations": [
                      {
                        "Source": "Image",
                        "ImageRegions": [
                          {
                            "Page": "e3c2ea3e-cd90-46d4-9ed3-2ca4a6d26a29",
                            "Rects": [
                              [
                                567,
                                736,
                                640,
                                775
                              ]
                            ]
                          }
                        ],
                        "RawValue": "04",
                        "Confidence": 1,
                        "SuspiciousSymbols": []
                      }
                    ],
                    "Value": "04"
                  }
                ]
              }
            ]
          }
        },
        "Pages": [
          {
            "Id": "e3c2ea3e-cd90-46d4-9ed3-2ca4a6d26a29",
            "SourceFile": "New doc 11-03-2021 09.25.53 am.jpg",
            "SourceImagePageIndex": 0
          }
        ]
      }
    ],
    "CreationTime": "2021-09-25T18:51:39.4425611+00:00",
    "SourceFiles": [
      {
        "Id": "107c2b57-c684-4c28-804c-ca1b8fdbed62",
        "Name": "New doc 11-03-2021 09.25.53 am.jpg"
      }
    ]
  },
  "Version": "2.1"
}