A Worked Out Example of Managing with abbyyR

Overview of abbyyR

Gaurav Sood

2017-04-12

2018-05-30

Tasks

Tasks are a way to bundle images that need to be processed with same parameters. Say for instance, one task may have images that have been taken by a mobile phone and which you want OCRd to a text file. Another may have all scanned images that you want exported to XML. There are a variety of functions to help you manage the tasks.

List Tasks

listTasks lists all the tasks in the application. You can specify a date range and whether or not you want to include deleted tasks. The function prints Total number of tasks, Task IDs, and No. of Finished Tasks. The function returns a data.frame with the following columns: id (task id), registrationTime, statusChangeTime, status (Submitted, Queued, InProgress, Completed, ProcessingFailed, Deleted, NotEnoughCredits), filesCount (No. of files), credits, resultUrl (URL for the processed file). For additional details about how Abbyy FineReader implements listTasks, see the reference for the function.

listTasks(fromDate="yyyy-mm-ddThh:mm:ssZ",toDate="yyyy-mm-ddThh:mm:ssZ")

List Finished Tasks

List all the finished tasks in the application. “The tasks are ordered by the time of the end of processing. No more than 100 tasks can be returned at one method call.” (From Abbyy FineReader). The function returns a data.frame with the following columns: id (task id), registrationTime, statusChangeTime, status (Submitted, Queued, InProgress, Completed, ProcessingFailed, Deleted, NotEnoughCredits), filesCount (No. of files), credits, resultUrl (URL for the processed file). For additional details about how Abbyy FineReader implements listFinishedTasks, see the reference for the function.

You can download the results of the OCR project from all the FinishedTasks using the getResults function.

listFinishedTasks()

Get Task Status

The function gets task status for a particular task ID. The function prints the status of the task by default. The function returns a data.frame with all the task details: id (task id), registrationTime, statusChangeTime, status (Submitted, Queued, InProgress, Completed, ProcessingFailed, Deleted, NotEnoughCredits), filesCount (No. of files), credits, resultUrl (URL for the processed file if applicable).

For additional details about how Abbyy FineReader implements getTaskStatus, see the reference for the function.

getTaskStatus(taskId="task_id")

Delete a Task

This function deletes a particular task and associated data. From Abbyy “If you try to delete the task that has already been deleted, the successful response is returned.” The function by default prints the status of the task you are trying to delete. It will show up as ‘deleted’ if successful. The function returns a data.frame with all the details of the task you are trying to delete: id (task id), registrationTime, statusChangeTime, status (Submitted, Queued, InProgress, Completed, ProcessingFailed, Deleted, NotEnoughCredits), filesCount (No. of files), credits, resultUrl (URL for the processed file if applicable)

For additional details about how Abbyy FineReader implements deleteTask, see the reference for the function.

    deleteTask(taskId="task_id")

List Tasks

`listTasks` lists all the tasks in the application. You can specify a date range and whether or not you want to include deleted tasks. The function prints Total number of tasks, Task IDs, and No. of Finished Tasks. The function returns a data.frame with the following columns: id (task id), registrationTime, statusChangeTime, [status](http://ocrsdk.com/documentation/specifications/task-statuses/) (Submitted, Queued, InProgress, Completed, ProcessingFailed, Deleted, NotEnoughCredits), filesCount (No. of files), credits, resultUrl (URL for the processed file). For additional details about how Abbyy FineReader implements `listTasks`, see the [reference](http://ocrsdk.com/documentation/apireference/listTasks/) for the function. + + +```r +listTasks(fromDate="yyyy-mm-ddThh:mm:ssZ",toDate="yyyy-mm-ddThh:mm:ssZ") +```

List Finished Tasks

List all the finished tasks in the application. "The tasks are ordered by the time of the end of processing. No more than 100 tasks can be returned at one method call." (From Abbyy FineReader). The function returns a data.frame with the following columns: id (task id), registrationTime, statusChangeTime, [status](http://ocrsdk.com/documentation/specifications/task-statuses/) (Submitted, Queued, InProgress, Completed, ProcessingFailed, Deleted, NotEnoughCredits), filesCount (No. of files), credits, resultUrl (URL for the processed file). For additional details about how Abbyy FineReader implements `listFinishedTasks`, see the [reference](http://ocrsdk.com/documentation/apireference/listFinishedTasks/) for the function. + +You can download the results of the OCR project from all the FinishedTasks using the `getResults` function. + + +```r +listFinishedTasks() +```

Get Task Status

The function gets task status for a particular task ID. The function prints the status of the task by default. The function returns a data.frame with all the task details: id (task id), registrationTime, statusChangeTime, [status](http://ocrsdk.com/documentation/specifications/task-statuses/) (Submitted, Queued, InProgress, Completed, ProcessingFailed, Deleted, NotEnoughCredits), filesCount (No. of files), credits, resultUrl (URL for the processed file if applicable). + +For additional details about how Abbyy FineReader implements `getTaskStatus`, see the [reference](http://ocrsdk.com/documentation/apireference/getTaskStatus/) for the function. + + +```r +getTaskStatus(taskId="task_id") +```

Delete a Task

This function deletes a particular task and associated data. From Abbyy "If you try to delete the task that has already been deleted, the successful response is returned." The function by default prints the status of the task you are trying to delete. It will show up as 'deleted' if successful. The function returns a data.frame with all the details of the task you are trying to delete: id (task id), registrationTime, statusChangeTime, [status](http://ocrsdk.com/documentation/specifications/task-statuses/) (Submitted, Queued, InProgress, Completed, ProcessingFailed, Deleted, NotEnoughCredits), filesCount (No. of files), credits, resultUrl (URL for the processed file if applicable) + +For additional details about how Abbyy FineReader implements `deleteTask`, see the [reference](http://ocrsdk.com/documentation/apireference/deleteTask/) for the function. + + +```r + deleteTask(taskId="task_id") +```

OCR

Till now we have covered tools to manage the workflow. Now we cover details about how to submit images, barcode fields, business cards etc. for OCR. Abbyy conveniently provides separate functions for submitting different types of documents. The argument that we can pass depending on the kind of the document we are processing. Abbyy provides a way to process a single image, and a bundle of images (bundled under one task) using the same set of parameters. The function below either submit documents to Abbyy or trigger processing of documents (separate steps). To download images that have been processed, use the getResults function.

Submit an Image for Processing
-
Adds image to the existing task or creates a new task for the uploaded image. The new task isn’t processed till processDocument or processFields is called (via Abbyy FineReader). The function takes two optional arguments, taskId (assigns image to the task ID specified. If empty string is passed, a new task is created) and pdfPassword (If the pdf is password protected). The function returns a data.frame with all the details of the submitted image: id (task id), registrationTime, statusChangeTime, status (Submitted, Queued, InProgress, Completed, ProcessingFailed, Deleted, NotEnoughCredits), filesCount (No. of files), credits, estimatedProcessingTime
-
For additional details about how Abbyy FineReader implements submitImage, see the reference for the function.
-
```
submitImage(file_path="file_path", taskId="task_id", pdfPassword="")
```
Process Image
-
Adds image to the existing task or creates a new task for the uploaded image. The new task isn’t processed till processDocument or processFields is called (via Abbyy FineReader). The function takes two optional arguments, taskId (assigns image to the task ID specified. If an empty string is passed, a new task is created) and pdfPassword (If the pdf is password protected). The function returns a data.frame with all the details of the submitted image: id (task id), registrationTime, statusChangeTime, status (Submitted, Queued, InProgress, Completed, ProcessingFailed, Deleted, NotEnoughCredits), filesCount (No. of files), credits
-
For supported file formats, see Supported File Formats. For additional details about how Abbyy FineReader implements processImage, see the reference for the function.
-
```
processImage(file_path="file_path", language="English", profile="documentConversion")
```
Process a Remote Image
-
Same as processImage except the function takes image url as a required argument.
-
For supported file formats, see Supported File Formats. For additional details about how Abbyy FineReader implements processImage, see the reference for the function.
-
```
processRemoteImage(img_url="img_url", language="English", profile="documentConversion")
```
Process Document
-
This function processes several images for the same task and results in a multi-page document. For instance, upload pages of the book individually via submitImage to the same task. And then process it via ProcessDocument to get a multi-page pdf.
-
For additional details about how Abbyy FineReader implements processDocument, see the reference for the function.
-
```
processDocument(task_id="task_id")
```
Process Business Card
-
For additional details about how Abbyy FineReader implements processBusinessCard, see the reference for the function.
-
```
processBusinessCard(file_path="file_path")
```
Process Text Field
-
For additional details about how Abbyy FineReader implements processTextField, see the reference for the function.
-
```
processTextField(file_path="file_path")
```
Process Barcode Field
-
For additional details about how Abbyy FineReader implements processBarcodeField, see the reference for the function.
-
```
processBarcodeField(file_path="file_path")
```
Process Checkmark Field
-
For additional details about how Abbyy FineReader implements processCheckmarkField, see the reference for the function.
-
```
processCheckmarkField(file_path="file_path")
```
Process Fields
-
For additional details about how Abbyy FineReader implements processFields, see the reference for the function.
-
```
processFields(file_path="file_path")
```
Process MRZ
-
Extract data from Machine Readable Zone.
-
Output may contain the following fields: MrzType, Line1, Line2, Line3, DocumentType, DocumentSubtype, IssuingCountry, LastName, GivenName, DocumentNumber, DocumentNumberVerified, DocumentNumberCheck, Nationality, BirthDate, BirthDateVerified
-
For supported file formats, see Supported File Formats. For additional details about how Abbyy FineReader implements processMRZ, see the reference for the function.
-
```
processMRZ(file_path="file_path")
```
Process Photo ID
-
Extract data from a Photo ID.
-
For additional details about how Abbyy FineReader implements processMRZ, see the reference for the function.
-
```
processPhotoId(file_path="file_path")
```
Submit an Image for Processing

Adds image to the existing task or creates a new task for the uploaded image. The new task isn't processed till processDocument or processFields is called (via Abbyy FineReader). The function takes two optional arguments, taskId (assigns image to the task ID specified. If empty string is passed, a new task is created) and pdfPassword (If the pdf is password protected). The function returns a data.frame with all the details of the submitted image: id (task id), registrationTime, statusChangeTime, [status](http://ocrsdk.com/documentation/specifications/task-statuses/) (Submitted, Queued, InProgress, Completed, ProcessingFailed, Deleted, NotEnoughCredits), filesCount (No. of files), credits,  estimatedProcessingTime
+
+For additional details about how Abbyy FineReader implements `submitImage`, see the [reference](http://ocrsdk.com/documentation/apireference/submitImage/) for the function.
+
+
+```r
+submitImage(file_path="file_path", taskId="task_id", pdfPassword="")
+```

Process Image

Adds image to the existing task or creates a new task for the uploaded image. The new task isn't processed till processDocument or processFields is called (via Abbyy FineReader). The function takes two optional arguments, taskId (assigns image to the task ID specified. If an empty string is passed, a new task is created) and pdfPassword (If the pdf is password protected). The function returns a data.frame with all the details of the submitted image: id (task id), registrationTime, statusChangeTime, [status](http://ocrsdk.com/documentation/specifications/task-statuses/) (Submitted, Queued, InProgress, Completed, ProcessingFailed, Deleted, NotEnoughCredits), filesCount (No. of files), credits
+
+For supported file formats, see [Supported File Formats](http://ocrsdk.com/documentation/specifications/image-formats/). For additional details about how Abbyy FineReader implements `processImage`, see the [reference](http://ocrsdk.com/documentation/apireference/processImage/) for the function.
+
+
+```r
+processImage(file_path="file_path", language="English", profile="documentConversion")
+```

Process a Remote Image

Same as processImage except the function takes image url as a required argument.
+
+For supported file formats, see [Supported File Formats](http://ocrsdk.com/documentation/specifications/image-formats/). For additional details about how Abbyy FineReader implements `processImage`, see the [reference](http://ocrsdk.com/documentation/apireference/processRemoteImage/) for the function.
+
+
+```r
+processRemoteImage(img_url="img_url", language="English", profile="documentConversion")
+```

Process Document

This function processes several images for the same task and results in a multi-page document. For instance, upload pages of the book individually via submitImage to the same task. And then process it via ProcessDocument to get a multi-page pdf.
+
+For additional details about how Abbyy FineReader implements `processDocument`, see the [reference](http://ocrsdk.com/documentation/apireference/processDocument/) for the function.
+
+
+```r
+processDocument(task_id="task_id")
+```

Process Business Card

For additional details about how Abbyy FineReader implements `processBusinessCard`, see the [reference](http://ocrsdk.com/documentation/apireference/processBusinessCard/) for the function.
+
+
+```r
+processBusinessCard(file_path="file_path")
+```

Process Text Field

For additional details about how Abbyy FineReader implements `processTextField`, see the [reference](http://ocrsdk.com/documentation/apireference/processTextField/) for the function.
+
+
+```r
+processTextField(file_path="file_path")
+```

Process Barcode Field

For additional details about how Abbyy FineReader implements `processBarcodeField`, see the [reference](http://ocrsdk.com/documentation/apireference/processBarcodeField/) for the function.
+
+
+```r
+processBarcodeField(file_path="file_path")
+```

Process Checkmark Field

For additional details about how Abbyy FineReader implements `processCheckmarkField`, see the [reference](http://ocrsdk.com/documentation/apireference/processCheckmarkField/) for the function.
+
+
+```r
+processCheckmarkField(file_path="file_path")
+```

Process Fields

For additional details about how Abbyy FineReader implements `processFields`, see the [reference](http://ocrsdk.com/documentation/apireference/processFields/) for the function.
+
+
+```r
+processFields(file_path="file_path")
+```

Process MRZ

Extract data from Machine Readable Zone.
+
+Output may contain the following fields: MrzType, Line1, Line2, Line3, DocumentType, DocumentSubtype, IssuingCountry, LastName, GivenName, DocumentNumber, DocumentNumberVerified, DocumentNumberCheck, Nationality, BirthDate, BirthDateVerified
+
+For supported file formats, see [Supported File Formats](http://ocrsdk.com/documentation/specifications/image-formats/). For additional details about how Abbyy FineReader implements `processMRZ`, see the [reference](http://ocrsdk.com/documentation/apireference/processMRZ/) for the function.
+
+
+```r
+processMRZ(file_path="file_path")
+```

Process Photo ID

Extract data from a Photo ID.
+
+For additional details about how Abbyy FineReader implements `processMRZ`, see the [reference](http://ocrsdk.com/documentation/apireference/processMRZ/) for the function.
+
+
+```r
+processPhotoId(file_path="file_path")
+```

Getting Text from Wisconsin Ads Storyboards Using abbyyR