You are here: Technical Overview > Migrating or Upgrading > Upgrading from SFWLink or ScanTools II Legacy Link

Upgrading from SFWLink Toolkit or ScanTools II Legacy Link Application Programs

If you are currently running a program written with the SFWLink Toolkit or ScanTools II Legacy Link, change your application to use either synchronous scanning or event-driven (asynchronous) scanning.

All your ScanTools application files (.sds), and profiles (.$cp, .$ep, .$sp) must be opened in ScanTools Plus software and saved in the new ScanTools Plus formats (.StxAppDef, .StxCnvPrf, StxEdtPrf , StxScrPrf, to be used with the new ScanTools Plus Link software. In addition, if you plan to use image clips you must turn on image header fields in your application definition.

We recommend that you use asynchronous (event driven) scanning when you migrate your SFWLink Toolkit 1.x or ScanTools II Legacy Link programs to ScanTools Plus Link. If you are only doing OMR scanning, you can use either synchronous or asynchronous scanning. However, if you are doing image capture, you must use asynchronous scanning with image header fields turned on in your application.

Event-Driven (Asynchronous) or Synchronous Scanning

The table below takes calls in the SFWLink12 API and tells you what you should do to achieve the same effect using the objects in ScanTools Plus Link for either event driven (asynchronous) or synchronous scanning. Additional information for synchronous scanning only is in the subsequent table.

SFWLink1.2 call

ScanTools Plus Link call

LoadSFW

Create an instance of the ScanningManager and SessionInfo objects.

See also Instantiate Creatable Objects

SetAppWindowHandle

SetClientWindowHandle

SetupSFW

Set following properties of SessionInfo

Application

EditProfile

ScoreProfile

ConversionProfile

RunNumber

BatchNumber

Starting_SerialNo

MarkThreshold

DiscriminationMargin

PrintPosition

PrintOption

Synchronous

GetSFW_Paths

There is no direct equivalent. ScanTools Plus Link allows you to access appdefs and profiles from any location.

Before a call to Scan the following properties of SessionInfo must be set to indicate ScanTools Plus paths:

Diagnose

Call Diagnose method of ScanningManager

ConfigSFW

ScanTools Plus Link allows you to automatically detect and configure scanners connected to your machine using AutoConfigureScanner.

Synchronous Scanning Only

The table below takes calls in the SFWLink12 API and tells you what you should do to achieve the same effect using the objects in ScanTools Plus Link for synchronous scanning only.

SFWLink1.2 call

ScanTools Plus Link call

SafeScanSFW("START",,,,)

Issue a call to Scan method of ScanningManager with SessionInfo as a parameter

SafeScanSFW(CONT,,,,,)

Issue a call to BlockForScannerEvent.

If BlockForScannerEvent returns L_EVENTTYPE_SHEETATPRINTHEAD then call GetSheetOutput to extract details of the sheet.

Call ModifyPrintString and ModifyStackerSelection if you need to alter the print string or output stacker

If BlockForScannerEvent returns L_EVENTTYPE_DOCCOMPLETE then call GetDocOutput to extract details of the document.

If BlockForScannerEvent returns L_EVENTTYPE_SESSIONCCOMPLETE the scanning loop is complete

SafeScanSFW(DONE)

Call Stop method of ScanningManager with L_WHENTOSTOP_EOFSHEET

CloseSFW

Quit

See also

Event Driven Scanning

Synchronous Scanning

Image Header Fields - ScanTools Plus Application Definition

 

 

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.