Overview
Document Capture provides the capability to scan a document or form and acquire specific data from that printed material based on a defined template. It is part of NextGen SimulScan in DataWedge. The templates are generated from NG SimulScan Template Builder. This sample demonstrates how to use Document Capture with Anchor Barcode to capture an address and signature from a document or form based on the barcode scanned. The address and signature are captured as separate images. This is useful in situations such as delivery operations for proof of delivery.
This sample performs the following:
- Register a broadcast receiver to listen for DataWedge intents.
- Create a DataWedge profile "DocumentCaptureProfile" if it does not exist. The result is retrieved from the broadcast receiver. If the profile does not exist, it creates the profile with the following NextGen SimulScan configurations:
- Set scanning mode to Document Capture.
- Set the Intent Output action, category and delivery mechanism (broadcast).
- Enable content provider.
- Associate this sample application to the profile.
- When scanning, the address and signature fields from the document "AnchorBarcodeTemplate.pdf" are captured as separate images based on specifications in the "SignatureAndAddressSeparately.xml" template. The height and width of the image output is adjusted.
- Display the captured data (address and signature) as separate images.
This sample application is only intended for educational purposes, demonstrating the use of DataWedge intent API(s).
Requirements
- DataWedge 8.0 for NextGen SimulScan support
- For Zebra Professional series devices, such as TC21 and TC26, NextGen SimulScan requires a Mobility DNA Enterprise license
- NextGen SimulScan template "SignatureAndAddressSeparately.xml", supplied with the sample app
- Sample document to scan, "AnchorBarcodeTemplate.pdf", supplied with the sample app
APIs Used
| DataWedge API | App Functionality |
|---|---|
| Create Profile | Create the profile with specific parameters for Document Capture (see step 2 above). |
| Create Profile | Delete the profile if profile creation fails. |
| Get Profiles List | Get the list of DataWedge profiles on the device to check if a profile exists. |
| Set Config | Set the appropriate configurations specified. |
| Soft Scan Trigger | Start/stop or toggle the software scan trigger. |
Using This Sample
Download and build the sample app.
Copy and install the sample app to the device.
Follow instructions to import template "SignatureAndAddressSeparately.xml" to the device.
Launch the sample app.
- DataWedge profile “DocumentCaptureProfile” is created if it does not exist.
- If profile creation fails, the profile is deleted. Tap Re-create profile to attempt to recreate the profile.
Tap Start/Stop Scanning to start the scan.
Scan the document "AnchorBarcodeTemplate.pdf". If successful, decoded data is received by the broadcast receiver and processed based on the action given in the Intent Output, in this case Broadcast intent. A message appears indicating the data processed successfully.
Based on the sample template, the address and signature are captured and displayed as separate images.
Tap Clear Scan Data to clear the data displayed.
Related guides: