You are here: Programmers Reference > Programmer's Reference > DataService > OpenAsync

DataService OpenAsync

This method opens a session with the ScanTools Plus Link runtime. The method validates the license key and returns immediately. The specified metadata is downloaded as necessary in the background. At the same time, the method also looks for the scanner connected to the PC: you can monitor the ScannerSearch, ScannerFound and ScannerSearchComplete events and update the User Interface. It finally invokes the OpenCompleted callback at which point, your solution can determine the result of the download operation. You can also acquire a reference to the scanning engine and start scanning, provided a scanner was configured.

The OpenAsync method is designed to be called anytime. Calling it while the web page is loading can potentially provide the best user experience. By the time the page is loaded, the data session is ready to scan.

Prototype

OpenAsync (clientContext, clientCallback)

Parameters

For a scanning session, you need to handle at least one ScanningManager event so that you can take receipt of the scanned data.

If you are programming a correction-only web session, you do not need to access or handle any events from ScanningManager.

See ClientCallback Object for more information

Exceptions

License not specified in the client context

License is invalid: URL services not licensed or browser hosted services not licensed

OpenCompleted member is missing in the client callback object

 

 

See Help on Help for additional information on using this help file.

See Scantron Technical Support for additional information on technical support and training options.

See the ScanTools Suite System Requirements for further details on hardware and software requirements.

ScanTools is a suite of products; the specific information you want may appear in the help for a different module. If you don't find what you're looking for here, try one of the following:

 

Scantron Corporation

Customer Service (forms, products, and services):

1-800-SCANTRON (722-6876)

www.scantron.com

Technical Support:

1-800-445-3141

[email protected]

Copyright © 1998-2012 Scantron Corporation. All rights reserved. Use permitted only under license. www.scantron.com. No part of the Help or user guides may be reproduced in any form, or by any means, without express permission from Scantron Corporation.

LINKS TO THIRD PARTY SITES

This help system may contain links to third party websites ("Linked Sites"). The Linked Sites are not under the control of Scantron and Scantron is not responsible for the content of any Linked Site, including without limitation any link contained in a Linked Site or any changes or modifications to a Linked Site. Scantron is not responsible for web casting or any other form of transmission received from any Linked Site. Scantron provides Users with the ability to link the Assessment System to the Linked Sites as a convenience to you, and the inclusion of any link does not imply endorsement by Scantron of the Linked Site or any association with its operators.